Harness spec 1.2.0: the library's tools fit both projects; the CLI implements it
The CLI's facts in memory, notes_search, note_manage, skills_list, skill_view and skill_manage are `variables` now, filled with the CLI's own values (src/tool/spec-vars.ts): every description and parameter list the CLI sends is word for word what 1.1.0 said, except note and document ids, which are strings on both sides (a number is still taken). Descriptions are filled by the prompt texts' rules, parameter descriptions too. `narrow` says what a project offers of a shared tool's parameters. Memory's changes are one pure function (applyOps). Conformance: fill, narrow, memory. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
23 files changed
+1398
-88
No files matched your search
+30
-7
@@ -15,7 +15,7 @@ page [Harness-parity](https://git.houmeres.sk/LLeMbas/LLeMbas-CLI/wiki/Harness-p
|
||||
|---|---|
|
||||
| `VERSION` | The spec's own version, apart from LLeMbas CLI's |
|
||||
| `purpose.json` | The `purpose` argument added to a tool whose calls say what they are for |
|
||||
| `tools/<name>.json` | One tool each: name, `scope`, `risk`, `exclusive`, `block` (how a call is shown: `shell`, `edit`, `read`, `search`, `web`, `task`, `plan` — not drawn, the plan card refreshes — `hidden`, `tool`), `purpose`, former names (`aliases`, per project), renamed arguments, the description and the JSON Schema of its parameters — exactly what a model is sent |
|
||||
| `tools/<name>.json` | One tool each: name, `scope`, `risk`, `exclusive`, `block` (how a call is shown: `shell`, `edit`, `read`, `search`, `web`, `task`, `plan` — not drawn, the plan card refreshes — `hidden`, `tool`), `purpose`, former names (`aliases`, per project), renamed arguments, `variables`, what a project offers of the parameters (`narrow`, per project), the description and the JSON Schema of its parameters — exactly what a model is sent |
|
||||
| `prompts/` | The prompt texts; `prompts/index.json` says which are shared, which LLeMbas fragment each one is, and what each `{{variable}}` in a text means. `prompts/personality/` holds the personality presets both offer |
|
||||
| `permission/hardline.json` | The floor: commands refused in every mode, protected paths, and how a command is spelled plainly before it is checked again |
|
||||
| `permission/arity.json` | How much of a command an "always allow" covers |
|
||||
@@ -46,6 +46,18 @@ page [Harness-parity](https://git.houmeres.sk/LLeMbas/LLeMbas-CLI/wiki/Harness-p
|
||||
every mode; `plan_submit` only in plan mode, where it is the approval. Their permission key is
|
||||
`plan` (`permission/defaults.json`), which a rule written for the former `todo` key still reaches.
|
||||
|
||||
## 1.2.0
|
||||
|
||||
The library's tools fit both projects: `memory`, `notes_search`, `note_view`, `note_manage`,
|
||||
`skills_list`, `skill_view` and `skill_manage` say the CLI's facts (files, projects, supporting files,
|
||||
sessions) through `variables`, so LLeMbas sends the same tools with its own facts; filled with the
|
||||
CLI's values, every description is word for word what 1.1.0 said. Tool descriptions are filled by
|
||||
the prompt texts' rules, including the descriptions inside the parameters. A tool's `narrow` says
|
||||
what a project offers of its parameters where it offers less (LLeMbas: one memory target, no note
|
||||
scope, no skill categories, supporting files or project skills). Note and knowledge-document ids are
|
||||
strings on both sides. Three conformance areas: `fill`, `narrow`, `memory` (one change or a batch,
|
||||
applied together, against the size limit).
|
||||
|
||||
## 1.1.0
|
||||
|
||||
Planning as one shared structure: `plan_write` and `plan_update` (new, shared, in every mode) and
|
||||
@@ -75,13 +87,24 @@ feature beyond protocol 1 gated on its capability string).
|
||||
## Variables in a description, and in a prompt text
|
||||
|
||||
A description may hold `{{name}}` where the two projects differ in a fact, not in design — a
|
||||
timeout's default, whether commands may run in the background, which subagents exist. The tool's
|
||||
`variables` says what each one means; each project fills them before sending the description, and
|
||||
none may reach a model unfilled.
|
||||
timeout's default, whether commands may run in the background, which subagents exist, where a
|
||||
skill's supporting files are. The tool's `variables` says what each one means; each project fills
|
||||
them before sending the description — and the `description` of every parameter, which may hold
|
||||
them too — and none may reach a model unfilled.
|
||||
|
||||
A prompt text may hold them too, declared in `prompts/index.json` under its entry. The same rule,
|
||||
and one more: **a line that is nothing but a bullet and a variable (`- {{name}}`) disappears when the
|
||||
variable is empty**, so one text serves a project that has the fact and one that does not.
|
||||
A prompt text may hold them too, declared in `prompts/index.json` under its entry. The same rules
|
||||
for both, and one more: **a line that is nothing but a bullet and a variable (`- {{name}}`)
|
||||
disappears when the variable is empty**, so one text serves a project that has the fact and one that
|
||||
does not (`conformance/fill.json`).
|
||||
|
||||
## Offering less of a shared tool
|
||||
|
||||
A project that does not have part of a shared tool says so in the tool's `narrow.<project>` rather
|
||||
than in a different tool: `drop` leaves out optional properties, `enum` keeps some of a property's
|
||||
values (`a.b` is b inside a; `a[].b` is b inside the items of the array a). It offers a subset and
|
||||
nothing else — never a property the spec does not have, never another type — so a call valid for the
|
||||
narrower tool is valid for the whole one (`conformance/narrow.json`). The description says the
|
||||
narrower tool's facts through its `variables`.
|
||||
|
||||
## Changing it
|
||||
|
||||
|
||||
+1
-1
@@ -1 +1 @@
|
||||
1.1.0
|
||||
1.2.0
|
||||
@@ -0,0 +1,88 @@
|
||||
{
|
||||
"about": "A tool description's or a prompt text's `{{variables}}` filled in (`vars`): a value replaces its variable where it stands; a line that is nothing but a bullet and a variable (`- {{name}}`) disappears when the value is empty or blank; a variable with no value at all is an error naming every one missing (`missing`, sorted). Applied to a tool's description and to every `description` inside its parameters. LLeMbas: services/harness_spec.py fill; CLI: prompt/fill.ts fillPrompt.",
|
||||
"cases": [
|
||||
{
|
||||
"text": "Read a page{{files}}",
|
||||
"vars": {
|
||||
"files": "."
|
||||
},
|
||||
"expect": {
|
||||
"text": "Read a page."
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "Kept across sessions{{kept}}.",
|
||||
"vars": {
|
||||
"kept": ""
|
||||
},
|
||||
"expect": {
|
||||
"text": "Kept across sessions."
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "- create: one.\n- {{files}}\n- delete: two.",
|
||||
"vars": {
|
||||
"files": ""
|
||||
},
|
||||
"expect": {
|
||||
"text": "- create: one.\n- delete: two."
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "- create: one.\n- {{files}}\n- delete: two.",
|
||||
"vars": {
|
||||
"files": " "
|
||||
},
|
||||
"expect": {
|
||||
"text": "- create: one.\n- delete: two."
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "- create: one.\n * {{files}}\n- delete: two.",
|
||||
"vars": {
|
||||
"files": "write_file."
|
||||
},
|
||||
"expect": {
|
||||
"text": "- create: one.\n * write_file.\n- delete: two."
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "A {{a}} and a {{b}} and {{a}} again",
|
||||
"vars": {
|
||||
"a": "x",
|
||||
"b": "y"
|
||||
},
|
||||
"expect": {
|
||||
"text": "A x and a y and x again"
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "Only {{a}} and {{c}} and {{b}}",
|
||||
"vars": {
|
||||
"a": "x"
|
||||
},
|
||||
"expect": {
|
||||
"missing": [
|
||||
"b",
|
||||
"c"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "No variables at all.",
|
||||
"vars": {},
|
||||
"expect": {
|
||||
"text": "No variables at all."
|
||||
}
|
||||
},
|
||||
{
|
||||
"text": "- not only {{a}} on this line",
|
||||
"vars": {
|
||||
"a": ""
|
||||
},
|
||||
"expect": {
|
||||
"text": "- not only on this line"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,499 @@
|
||||
{
|
||||
"about": "The memory tool's changes to one target's entries (`entries`, in order) with a size limit (`limit`, characters of the entries joined by \"\\n§\\n\"): one change or a list (`ops`, each `action` add/replace/remove with `content` — or `new_text` — and `old_text`), applied together or not at all; the limit is checked on the result only, and a change that does not grow the entries always goes through. An entry is one fact, at most 400 characters; `old_text` finds an exact entry first, else the one entry containing it. `ok`, the entries after, `message`, `usage`, and `shown` — whether the entries as they were are shown with a refusal, so the model can consolidate. LLeMbas: services/library/memories.py apply_ops; CLI: memory/store.ts applyOps.",
|
||||
"cases": [
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": "Prefers tea."
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Prefers tea."
|
||||
],
|
||||
"message": "Entry added.",
|
||||
"usage": "0% — 12/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": " Prefers tea. "
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "That entry already exists; nothing added.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "memory",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 2200,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"new_text": "Uses Debian."
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín.",
|
||||
"Uses Debian."
|
||||
],
|
||||
"message": "Entry added.",
|
||||
"usage": "3% — 75/2,200 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "an entry is one fact, under 400 characters; this one is 401. Split it into facts, or keep only what will still matter.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": "one\n§\ntwo"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "a line holding only \"§\" separates entries; it cannot be inside one.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": " "
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "add needs content.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "replace",
|
||||
"old_text": "Rust",
|
||||
"content": "Works in Rust, Python and Go."
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust, Python and Go.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "Entry replaced.",
|
||||
"usage": "4% — 64/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "replace",
|
||||
"old_text": "in",
|
||||
"content": "x"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "\"in\" matches more than one entry — use a longer, unique part.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "remove",
|
||||
"old_text": "coffee"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "no entry contains \"coffee\".",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "remove"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "remove needs old_text: a short unique part of the entry to remove.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "replace",
|
||||
"old_text": "tea",
|
||||
"content": ""
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "replace needs content — the complete new entry.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"coffee",
|
||||
"Drinks coffee black."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "remove",
|
||||
"old_text": "coffee"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Drinks coffee black."
|
||||
],
|
||||
"message": "Entry removed.",
|
||||
"usage": "1% — 20/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 60,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": "Has two cats."
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "The user profile would be 76/60 chars. Consolidate in the same call: replace overlapping entries with one shorter entry, or remove stale ones, together with the add.",
|
||||
"usage": "100% — 60/60 chars",
|
||||
"shown": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "memory",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 60,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": "Has two cats."
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "Memory would be 76/60 chars. Consolidate in the same call: replace overlapping entries with one shorter entry, or remove stale ones, together with the add.",
|
||||
"usage": "100% — 60/60 chars",
|
||||
"shown": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 60,
|
||||
"ops": [
|
||||
{
|
||||
"action": "remove",
|
||||
"old_text": "Rust"
|
||||
},
|
||||
{
|
||||
"action": "add",
|
||||
"content": "Has two cats."
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Lives in Trenčín.",
|
||||
"Has two cats."
|
||||
],
|
||||
"message": "Applied 2 operations.",
|
||||
"usage": "80% — 48/60 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 30,
|
||||
"ops": [
|
||||
{
|
||||
"action": "remove",
|
||||
"old_text": "tea"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "Entry removed.",
|
||||
"usage": "100% — 45/30 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "add",
|
||||
"content": "Has two cats."
|
||||
},
|
||||
{
|
||||
"action": "remove",
|
||||
"old_text": "coffee"
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "operation 2: no entry contains \"coffee\". Nothing was changed (the operations go together or not at all).",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [],
|
||||
"expect": {
|
||||
"ok": false,
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"message": "Nothing to do: give action (with content and/or old_text), or operations.",
|
||||
"usage": "4% — 60/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
},
|
||||
{
|
||||
"target": "user",
|
||||
"entries": [
|
||||
"Prefers tea.",
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín."
|
||||
],
|
||||
"limit": 1375,
|
||||
"ops": [
|
||||
{
|
||||
"action": "remove",
|
||||
"old_text": "Prefers tea."
|
||||
},
|
||||
{
|
||||
"action": "add",
|
||||
"content": "Prefers green tea."
|
||||
}
|
||||
],
|
||||
"expect": {
|
||||
"ok": true,
|
||||
"entries": [
|
||||
"Works in Rust and Python.",
|
||||
"Lives in Trenčín.",
|
||||
"Prefers green tea."
|
||||
],
|
||||
"message": "Applied 2 operations.",
|
||||
"usage": "4% — 66/1,375 chars",
|
||||
"shown": false
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,455 @@
|
||||
{
|
||||
"about": "A shared tool's parameters as one project offers them (`narrow`, the tool's `narrow.<project>`): a project may offer a subset and nothing else — `drop` removes optional properties, `enum` keeps some of a property's values. A path names a property; `a.b` is b inside a, `a[].b` is b inside a's array items. Never adds, never retypes. Refused, with `error`: dropping a required property (`required`), a path that is not there (`unknown`), values that are not all among the property's own (`not_subset`). LLeMbas: services/harness_spec.py narrow; CLI: harness.ts narrowParameters.",
|
||||
"cases": [
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {},
|
||||
"expect": {
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"drop": [
|
||||
"scope"
|
||||
]
|
||||
},
|
||||
"expect": {
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"enum": {
|
||||
"action": [
|
||||
"create",
|
||||
"delete"
|
||||
]
|
||||
}
|
||||
},
|
||||
"expect": {
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"operations": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"patch",
|
||||
"write_file",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"file_path": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action",
|
||||
"name"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"operations"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"drop": [
|
||||
"operations[].file_path"
|
||||
],
|
||||
"enum": {
|
||||
"operations[].action": [
|
||||
"create",
|
||||
"patch",
|
||||
"delete"
|
||||
]
|
||||
}
|
||||
},
|
||||
"expect": {
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"operations": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"patch",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action",
|
||||
"name"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"operations"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"drop": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"expect": {
|
||||
"error": "required"
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"drop": [
|
||||
"nope"
|
||||
]
|
||||
},
|
||||
"expect": {
|
||||
"error": "unknown"
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"operations": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"patch",
|
||||
"write_file",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"file_path": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action",
|
||||
"name"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"operations"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"drop": [
|
||||
"operations[].nope"
|
||||
]
|
||||
},
|
||||
"expect": {
|
||||
"error": "unknown"
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"enum": {
|
||||
"action": [
|
||||
"create",
|
||||
"rename"
|
||||
]
|
||||
}
|
||||
},
|
||||
"expect": {
|
||||
"error": "not_subset"
|
||||
}
|
||||
},
|
||||
{
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"action": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"create",
|
||||
"edit",
|
||||
"delete"
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"scope": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"project",
|
||||
"global"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"enum": {
|
||||
"id": [
|
||||
"a"
|
||||
]
|
||||
}
|
||||
},
|
||||
"expect": {
|
||||
"error": "not_subset"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -14,7 +14,7 @@
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "integer"
|
||||
"type": "string"
|
||||
},
|
||||
"offset": {
|
||||
"description": "Characters to skip: to read past what the first call returned",
|
||||
|
||||
@@ -12,7 +12,14 @@
|
||||
"memory_forget"
|
||||
]
|
||||
},
|
||||
"description": "Save durable facts to persistent memory that survives across sessions. Memory goes into the system prompt of every future session, so keep entries short and worth their place.\n\nHOW: make all your changes in ONE call with an `operations` list ({action, content?, old_text?}). The list is applied together and the size limit is checked only on the result, so one call can remove or shorten stale entries AND add new ones. One call finishes the update; do not repeat it. Use the single action/content/old_text fields only for one lone change.\n\nWHEN: only for facts that hold in EVERY session, whatever the task: who the user is, stable facts about their machines and environment, standing conventions with no better home. How to do a kind of task — procedures, pitfalls, the user's corrections about that work — belongs in a skill (skill_manage), which loads only when relevant. Anything about this project belongs in its AGENTS.md or the project's decision log, not here.\n\nTARGETS: 'user' — who the user is: name, role, preferences, how they like to work. 'memory' — your own notes: environment, conventions, tool quirks, lessons.\n\nIF FULL: an add is refused and the current entries are shown. Send one call that removes or shortens enough stale entries and adds the new one.\n\nSKIP: the obvious, what is easy to find again, raw data, task progress, logs of finished work, temporary state (session_search finds past work).\n\nWhat you save now is in the files at once but appears in your system prompt only from the next session.",
|
||||
"variables": {
|
||||
"project_home": "where facts about the current project belong instead, as a sentence after the WHEN paragraph's last one (\" Anything about this project belongs in its AGENTS.md or the project's decision log, not here.\"), or empty",
|
||||
"targets": "the targets this project offers and what each is for",
|
||||
"past_work": "how past work is found again, in parentheses after the SKIP list (\" (session_search finds past work)\"), or empty",
|
||||
"when_seen": "when a saved entry reaches the model's instructions",
|
||||
"target_values": "the `target` parameter's values and what each holds"
|
||||
},
|
||||
"description": "Save durable facts to persistent memory that survives across sessions. Memory goes into the system prompt of every future session, so keep entries short and worth their place.\n\nHOW: make all your changes in ONE call with an `operations` list ({action, content?, old_text?}). The list is applied together and the size limit is checked only on the result, so one call can remove or shorten stale entries AND add new ones. One call finishes the update; do not repeat it. Use the single action/content/old_text fields only for one lone change.\n\nWHEN: only for facts that hold in EVERY session, whatever the task: who the user is, stable facts about their machines and environment, standing conventions with no better home. How to do a kind of task — procedures, pitfalls, the user's corrections about that work — belongs in a skill (skill_manage), which loads only when relevant.{{project_home}}\n\nTARGETS: {{targets}}\n\nIF FULL: an add is refused and the current entries are shown. Send one call that removes or shortens enough stale entries and adds the new one.\n\nSKIP: the obvious, what is easy to find again, raw data, task progress, logs of finished work, temporary state{{past_work}}.\n\n{{when_seen}}",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -23,7 +30,7 @@
|
||||
"user",
|
||||
"project"
|
||||
],
|
||||
"description": "'memory' for your notes, 'user' for the user profile, 'project' for facts about this project only (kept in its .agent/local, never committed)."
|
||||
"description": "{{target_values}}"
|
||||
},
|
||||
"action": {
|
||||
"description": "A single change. Omit when using operations.",
|
||||
@@ -82,5 +89,14 @@
|
||||
"required": [
|
||||
"target"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"llembas": {
|
||||
"enum": {
|
||||
"target": [
|
||||
"user"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -15,7 +15,12 @@
|
||||
"notes_delete"
|
||||
]
|
||||
},
|
||||
"description": "Write your notes: things worth keeping that are longer than a memory entry and not a skill — findings, a design worked out with the user, a list to come back to.\n\n- create (title, body, scope); edit (id, title and/or body — body replaces the whole text); delete (id).\n- scope: \"project\" (default, when there is a project) or \"global\".\n- Not for facts that hold in every session (memory), procedures (skills), or the project's own records (tasks, decisions).",
|
||||
"variables": {
|
||||
"create_scope": "\", scope\" where notes have a scope, or empty",
|
||||
"scope": "what `scope` means (\"scope: \\\"project\\\" (default, when there is a project) or \\\"global\\\".\"), or empty — the line goes",
|
||||
"records": "other records a note is not for (\", or the project's own records (tasks, decisions)\"), or empty"
|
||||
},
|
||||
"description": "Write your notes: things worth keeping that are longer than a memory entry and not a skill — findings, a design worked out with the user, a list to come back to.\n\n- create (title, body{{create_scope}}); edit (id, title and/or body — body replaces the whole text); delete (id).\n- {{scope}}\n- Not for facts that hold in every session (memory), procedures (skills){{records}}.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -28,7 +33,7 @@
|
||||
]
|
||||
},
|
||||
"id": {
|
||||
"type": "integer"
|
||||
"type": "string"
|
||||
},
|
||||
"title": {
|
||||
"type": "string",
|
||||
@@ -48,5 +53,12 @@
|
||||
"required": [
|
||||
"action"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"llembas": {
|
||||
"drop": [
|
||||
"scope"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -18,7 +18,7 @@
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "integer"
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
|
||||
@@ -11,7 +11,10 @@
|
||||
],
|
||||
"llembas": []
|
||||
},
|
||||
"description": "Search your notes: things worth keeping that are longer than a memory entry and not a skill — findings, a design worked out with the user, a list to come back to. Kept across sessions, global or this project's; both are searched. An empty query lists the newest. Read one with note_view; write with note_manage.",
|
||||
"variables": {
|
||||
"kept": "where notes are kept and which are searched (\", global or this project's; both are searched\"), or empty"
|
||||
},
|
||||
"description": "Search your notes: things worth keeping that are longer than a memory entry and not a skill — findings, a design worked out with the user, a list to come back to. Kept across sessions{{kept}}. An empty query lists the newest. Read one with note_view; write with note_manage.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
|
||||
@@ -12,7 +12,13 @@
|
||||
"skill_edit"
|
||||
]
|
||||
},
|
||||
"description": "Create, change or delete skills — your procedural memory for kinds of task that come back. Send a list of operations; they apply together, and if one fails none is kept.\n\n- create: a new skill from description + instructions (or content: a whole SKILL.md). Global unless where: project.\n- patch: fix part of a skill with old_string/new_string (read it with skill_view first) — preferred over rewriting.\n- write_file / remove_file: supporting files under references/, templates/, scripts/ or assets/.\n- delete: remove a skill (alone in its call).\n- revert: put back the skill as it was before its last change (a deleted one too); the version it replaces is kept, so a second revert undoes the first. Alone in its call.\n\nWrite the description as its trigger, in about 60 characters — only that much shows in the skills list: \"Use when <situation>. <what it does>.\" Write lessons, not logs: an instruction and why, no dates or incident stories.",
|
||||
"variables": {
|
||||
"create_where": "where a new skill goes (\" Global unless where: project.\"), or empty",
|
||||
"files": "the supporting-file actions (\"write_file / remove_file: supporting files under references/, templates/, scripts/ or assets/.\"), or empty — the line goes",
|
||||
"revert_deleted": "\" (a deleted one too)\" where a deleted skill can be reverted, or empty",
|
||||
"index_cut": "why the description is kept short (\" — only that much shows in the skills list\"), or empty"
|
||||
},
|
||||
"description": "Create, change or delete skills — your procedural memory for kinds of task that come back. Send a list of operations; they apply together, and if one fails none is kept.\n\n- create: a new skill from description + instructions (or content: a whole SKILL.md).{{create_where}}\n- patch: fix part of a skill with old_string/new_string (read it with skill_view first) — preferred over rewriting.\n- {{files}}\n- delete: remove a skill (alone in its call).\n- revert: put back the skill as it was before its last change{{revert_deleted}}; the version it replaces is kept, so a second revert undoes the first. Alone in its call.\n\nWrite the description as its trigger, in about 60 characters{{index_cut}}: \"Use when <situation>. <what it does>.\" Write lessons, not logs: an instruction and why, no dates or incident stories.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -93,5 +99,23 @@
|
||||
"required": [
|
||||
"operations"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"llembas": {
|
||||
"drop": [
|
||||
"operations[].category",
|
||||
"operations[].where",
|
||||
"operations[].file_path",
|
||||
"operations[].file_content"
|
||||
],
|
||||
"enum": {
|
||||
"operations[].action": [
|
||||
"create",
|
||||
"patch",
|
||||
"delete",
|
||||
"revert"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -11,7 +11,10 @@
|
||||
"skill_get"
|
||||
]
|
||||
},
|
||||
"description": "Load a skill: its full instructions, and the list of its supporting files (references, templates, scripts, assets). To read one of those, call again with file_path.",
|
||||
"variables": {
|
||||
"files": "what else a skill carries and how to read it (\", and the list of its supporting files (references, templates, scripts, assets). To read one of those, call again with file_path.\"), or \".\""
|
||||
},
|
||||
"description": "Load a skill: its full instructions{{files}}",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -27,5 +30,12 @@
|
||||
"required": [
|
||||
"name"
|
||||
]
|
||||
},
|
||||
"narrow": {
|
||||
"llembas": {
|
||||
"drop": [
|
||||
"file_path"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -9,7 +9,10 @@
|
||||
"cli": [],
|
||||
"llembas": []
|
||||
},
|
||||
"description": "List the available skills (name, category, description). Load one with skill_view(name).",
|
||||
"variables": {
|
||||
"category": "\", category\" where skills have categories, or empty"
|
||||
},
|
||||
"description": "List the available skills (name{{category}}, description). Load one with skill_view(name).",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -18,5 +21,12 @@
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"narrow": {
|
||||
"llembas": {
|
||||
"drop": [
|
||||
"category"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user