harn-hostlib 0.9.21

Opt-in code-intelligence and deterministic-tool host builtins for the Harn VM
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://harnlang.com/schemas/hostlib/ast/apply_node.response.json",
  "title": "ast.apply_node response",
  "description": "Tagged-union response for ast.apply_node. `result` discriminates success (`applied`) from the failure modes; `applied` mirrors `result == \"applied\"` for ergonomic callers.",
  "type": "object",
  "properties": {
    "result": {
      "type": "string",
      "enum": [
        "applied",
        "no_match",
        "ambiguous",
        "invalid_query",
        "unsupported_language",
        "syntax_error"
      ]
    },
    "applied": {
      "type": "boolean",
      "description": "True iff `result == \"applied\"`."
    },
    "path": {
      "type": "string"
    },
    "dry_run": {
      "type": "boolean",
      "description": "Echoes the `dry_run` request flag (set only when `result == \"applied\"`)."
    },
    "match_count": {
      "type": "integer",
      "minimum": 0
    },
    "edits": {
      "type": "array",
      "description": "Per-edit metadata, in document order. Set only when `result == \"applied\"`.",
      "items": {
        "type": "object",
        "properties": {
          "start_byte": { "type": "integer", "minimum": 0 },
          "end_byte": { "type": "integer", "minimum": 0 },
          "start_row": { "type": "integer", "minimum": 0 },
          "start_col": { "type": "integer", "minimum": 0 },
          "end_row": { "type": "integer", "minimum": 0 },
          "end_col": { "type": "integer", "minimum": 0 },
          "original": { "type": "string" },
          "replacement": { "type": "string" }
        },
        "required": ["start_byte", "end_byte", "original", "replacement"],
        "additionalProperties": false
      }
    },
    "spans": {
      "type": "array",
      "description": "Per-match span metadata when `result == \"ambiguous\"`.",
      "items": {
        "type": "object",
        "properties": {
          "start_byte": { "type": "integer", "minimum": 0 },
          "end_byte": { "type": "integer", "minimum": 0 },
          "start_row": { "type": "integer", "minimum": 0 },
          "start_col": { "type": "integer", "minimum": 0 },
          "end_row": { "type": "integer", "minimum": 0 },
          "end_col": { "type": "integer", "minimum": 0 },
          "text": { "type": "string" }
        },
        "required": ["start_byte", "end_byte", "text"],
        "additionalProperties": false
      }
    },
    "before_sha256": {
      "type": "string",
      "description": "Hex sha256 of the original source. Set only when `result == \"applied\"`."
    },
    "after_sha256": {
      "type": "string",
      "description": "Hex sha256 of the post-splice source. Set only when `result == \"applied\"`."
    },
    "preview": {
      "type": "string",
      "description": "Post-splice source text. Always set when `result == \"applied\"`; also surfaced on `syntax_error` so callers can inspect the rejected output."
    },
    "query": {
      "type": "string",
      "description": "Echoes the original query; set on `no_match` and `invalid_query` for ergonomic diagnostics."
    },
    "target_capture": {
      "type": "string",
      "description": "Capture name used to drive replacement; set on `no_match`."
    },
    "details": {
      "type": "string",
      "description": "Short human-readable diagnostic; set on every non-`applied` result."
    },
    "error_row": {
      "type": "integer",
      "minimum": 0,
      "description": "Tree-sitter query error row when `result == \"invalid_query\"`."
    },
    "error_column": {
      "type": "integer",
      "minimum": 0,
      "description": "Tree-sitter query error column when `result == \"invalid_query\"`."
    },
    "fallback_suggestion": {
      "type": "string",
      "description": "Text-edit degradation path; set when `result == \"unsupported_language\"`."
    }
  },
  "required": ["result", "applied"],
  "additionalProperties": false
}