arborkit 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.1.0 — 2026-07-05
+
+- **New patch op: `edit`** — exact-substring surgery on string-valued nodes:
+  `patch(ref, { op: "edit", old, new, replaceAll?, ifVersion? })`. `old` must occur
+  exactly once in the node's string value (or set `replaceAll`); on a miss or an
+  ambiguous match the op fails with a structured `INVALID_OP` that reports the
+  occurrence count, so an agent can re-quote a larger fragment and retry.
+  Replacement is literal (no `$&`-style pattern expansion). Scope and `ifVersion`
+  are enforced *before* any content inspection — out-of-scope probes get an
+  identical `SCOPE_VIOLATION` whether or not `old` matches, leaking nothing.
+- Under the hood `edit` is pure sugar over `set`: the event log records an ordinary
+  `set` with full before/after, so replay, revert, delta persistence, and the AG-UI
+  adapter need no changes.
+- Motivation: output tokens are ~5× input price on current Claude models. An agent
+  quoting `old`/`new` fragments (~100 output tokens) instead of regenerating a whole
+  block (~1500) is the dominant cost lever for agent-driven editing. Pattern: `get`
+  the node first, quote `old` from the live value — the Claude Code `Edit`-tool
+  semantics.
+
 ## 1.0.1 — 2026-07-03
 
 - **Fix: cross-entry `instanceof` breakage.** 1.0.0 was built without code splitting, so every

package/README.md

@@ -44,6 +44,14 @@ const home = await tools.get({ path: "/pages/home" }); // home.value.content ===
 const refused = await tools.patch({ path: "/plan" }, { op: "set", value: "hacked" });
 // refused.ok === false — out of scope; violations are returned, never thrown
 
+// Agent edits — surgical substring replacement instead of regenerating a block:
+// get the node first, quote `old` from the live value (Claude Code Edit semantics).
+await tools.patch({ path: "/pages/home" }, { op: "set", value: { title: "Home", html: "<p>Bonus: 100% do 2000 PLN</p>" } });
+const edited = await tools.patch(
+  { path: "/pages/home/html" },
+  { op: "edit", old: "100% do 2000 PLN", new: "150% do 3000 PLN" },
+); // unique-or-fail: an ambiguous `old` returns INVALID_OP with the occurrence count
+
 // Semantic search — mutations only mark nodes stale; reindex() embeds:
 await arbor.index!.reindex();
 const found = await arbor.index!.search("home page"); // { results, staleCount }

package/dist/arbor.js

@@ -1,8 +1,8 @@
 import {
   createArbor,
   restoreArbor
-} from "./chunk-IUV6LML6.js";
-import "./chunk-5RUBU72S.js";
+} from "./chunk-WEO5KBRI.js";
+import "./chunk-ZDANDXJ6.js";
 import "./chunk-6DOI4FNX.js";
 import "./chunk-OZCCBVUV.js";
 import "./chunk-QRGDUGY6.js";

package/dist/{chunk-IUV6LML6.js → chunk-WEO5KBRI.js}

@@ -1,6 +1,6 @@
 import {
   makeToolset
-} from "./chunk-5RUBU72S.js";
+} from "./chunk-ZDANDXJ6.js";
 import {
   typeAwareDecision
 } from "./chunk-6DOI4FNX.js";
@@ -145,4 +145,4 @@ export {
   createArbor,
   restoreArbor
 };
-//# sourceMappingURL=chunk-IUV6LML6.js.map
+//# sourceMappingURL=chunk-WEO5KBRI.js.map

package/dist/{chunk-5RUBU72S.js → chunk-ZDANDXJ6.js}

@@ -8,7 +8,8 @@ import {
   ArborError,
   InvalidOpError,
   NodeNotFoundError,
-  ScopeViolationError
+  ScopeViolationError,
+  StaleVersionError
 } from "./chunk-V3HDDWER.js";
 
 // src/toolset.ts
@@ -91,6 +92,36 @@ function makeToolset(deps, binding = {}) {
           deps.mutator.move(ref, op.to, op.key, common);
           return { id: node.id, path: addressing.pathOf(node.id), version: node.meta.version };
         }
+        case "edit": {
+          const node = resolve(ref);
+          const path = addressing.pathOf(node.id);
+          if (binding.writeScope !== void 0 && !isWithin(path, binding.writeScope)) {
+            throw new ScopeViolationError(path, binding.writeScope);
+          }
+          if (op.ifVersion !== void 0 && node.meta.version !== op.ifVersion) {
+            throw new StaleVersionError(node.id, op.ifVersion, node.meta.version);
+          }
+          const value = tree.toJson(node.id);
+          if (typeof value !== "string") {
+            const kind = value === null ? "null" : Array.isArray(value) ? "an array" : typeof value === "object" ? "an object" : `a ${typeof value}`;
+            throw new InvalidOpError(
+              `edit targets string values; ${path} is ${kind} \u2014 target a string field inside it`
+            );
+          }
+          if (op.old === "") throw new InvalidOpError("edit: old must be non-empty");
+          if (op.old === op.new) throw new InvalidOpError("edit: old and new are identical");
+          const count = value.split(op.old).length - 1;
+          if (count === 0) throw new InvalidOpError(`edit: old string not found in ${path}`);
+          if (count > 1 && !op.replaceAll) {
+            throw new InvalidOpError(
+              `edit: old string occurs ${count} times in ${path} \u2014 quote a larger unique fragment or set replaceAll`
+            );
+          }
+          const next = value.split(op.old).join(op.new);
+          deps.mutator.set(ref, next, common);
+          const after = resolve(ref);
+          return { id: after.id, path: addressing.pathOf(after.id), version: after.meta.version };
+        }
       }
     }),
     history: (ref, opts = {}) => run(() => {
@@ -114,4 +145,4 @@ function makeToolset(deps, binding = {}) {
 export {
   makeToolset
 };
-//# sourceMappingURL=chunk-5RUBU72S.js.map
+//# sourceMappingURL=chunk-ZDANDXJ6.js.map

package/dist/chunk-ZDANDXJ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toolset.ts"],"sourcesContent":["import type { ArtifactTree } from \"./artifact-tree\";\r\nimport type { Addressing } from \"./addressing\";\r\nimport type { EventLog, MutationEvent } from \"./event-log\";\r\nimport type { Mutator } from \"./mutator\";\r\nimport type { SemanticIndex } from \"./semantic-index\";\r\nimport {\r\n  Navigator,\r\n  type DescribeOpts,\r\n  type DescribeResult,\r\n  type GetOpts,\r\n  type GetResult,\r\n  type FindSelector,\r\n  type FindOpts,\r\n  type FindResult,\r\n} from \"./navigator\";\r\nimport type { SearchOpts, SearchResult } from \"./semantic-index\";\r\nimport {\r\n  type Ref,\r\n  ArborError,\r\n  ScopeViolationError,\r\n  StaleVersionError,\r\n  InvalidOpError,\r\n  NodeNotFoundError,\r\n} from \"./errors\";\r\nimport { isWithin } from \"./jsonpointer\";\r\nimport type { Json, NodeId } from \"./types\";\r\n\r\n/** Every toolset call returns this — errors are structured, never thrown across the agent boundary. */\r\nexport type ToolResult<T> = { ok: true; value: T } | { ok: false; error: { code: string; message: string } };\r\n\r\n/** `edit` is exact-substring surgery on a string leaf — pure sugar over `set`: the event\r\n *  log records a plain `set` with the full before/after value, so history/revert/replay/\r\n *  AG-UI need nothing new. `old` must match the live value exactly (and uniquely, unless\r\n *  `replaceAll`) — `get` the node first and quote `old` from what it returns. */\r\nexport type PatchOp =\r\n  | { op: \"set\"; value: Json; ifVersion?: number }\r\n  | { op: \"insert\"; key: string | number; value: Json; ifVersion?: number }\r\n  | { op: \"remove\"; ifVersion?: number }\r\n  | { op: \"move\"; to: Ref; key: string | number; ifVersion?: number }\r\n  | { op: \"edit\"; old: string; new: string; replaceAll?: boolean; ifVersion?: number };\r\n\r\nexport interface ToolsetDeps {\r\n  tree: ArtifactTree;\r\n  addressing: Addressing;\r\n  log: EventLog;\r\n  mutator: Mutator;\r\n  index?: SemanticIndex;\r\n}\r\n\r\nexport interface ToolsetBinding {\r\n  owner?: string;\r\n  /** JSON Pointer prefix: writes must be at or under it (enforced by the Mutator). */\r\n  writeScope?: string;\r\n  /** JSON Pointer prefix: reads are confined to it. */\r\n  readScope?: string;\r\n}\r\n\r\nexport interface PatchResult {\r\n  id: NodeId;\r\n  path: string;\r\n  /** The affected node's version AFTER the op (remove: the parent's). Feed into the next ifVersion. */\r\n  version: number;\r\n}\r\n\r\nexport interface Toolset {\r\n  describe(ref?: Ref, opts?: DescribeOpts): Promise<ToolResult<DescribeResult>>;\r\n  get(ref: Ref, opts?: GetOpts): Promise<ToolResult<GetResult>>;\r\n  find(selector: FindSelector, opts?: FindOpts): Promise<ToolResult<FindResult>>;\r\n  search(query: string, opts?: SearchOpts): Promise<ToolResult<SearchResult>>;\r\n  patch(ref: Ref, op: PatchOp): Promise<ToolResult<PatchResult>>;\r\n  history(ref?: Ref, opts?: { limit?: number }): Promise<ToolResult<MutationEvent[]>>;\r\n}\r\n\r\n/** An event is within scope if any of its recorded paths is within scope. */\r\nfunction eventWithinScope(e: MutationEvent, scope: string): boolean {\r\n  if (e.path !== undefined && isWithin(e.path, scope)) return true;\r\n  if (e.toPath !== undefined && isWithin(e.toPath, scope)) return true;\r\n  if (e.fromPath !== undefined && isWithin(e.fromPath, scope)) return true;\r\n  return false;\r\n}\r\n\r\n/** Run a tool body, converting thrown errors into a structured ToolResult. */\r\nasync function run<T>(fn: () => T | Promise<T>): Promise<ToolResult<T>> {\r\n  try {\r\n    return { ok: true, value: await fn() };\r\n  } catch (e) {\r\n    if (e instanceof ArborError) return { ok: false, error: { code: e.code, message: e.message } };\r\n    const message = e instanceof Error ? e.message : String(e);\r\n    return { ok: false, error: { code: \"ERROR\", message } };\r\n  }\r\n}\r\n\r\n/** A scoped, agent-facing bundle of tools returning structured results. */\r\nexport function makeToolset(deps: ToolsetDeps, binding: ToolsetBinding = {}): Toolset {\r\n  const { tree, addressing } = deps;\r\n  const navigator = new Navigator(tree, addressing);\r\n\r\n  return {\r\n    describe: (ref, opts) =>\r\n      run(() => {\r\n        const target: Ref = ref ?? (binding.readScope !== undefined ? { path: binding.readScope } : { path: \"\" });\r\n        const r = navigator.describe(target, opts);\r\n        if (!isWithin(r.node.path, binding.readScope)) {\r\n          throw new ScopeViolationError(r.node.path, binding.readScope!);\r\n        }\r\n        return r;\r\n      }),\r\n\r\n    get: (ref, opts) =>\r\n      run(() => {\r\n        const r = navigator.get(ref, opts);\r\n        if (!isWithin(r.path, binding.readScope)) {\r\n          throw new ScopeViolationError(r.path, binding.readScope!);\r\n        }\r\n        // Deep-clone the WHOLE result: `content` (and `meta`) come from the live\r\n        // tree by reference; handing them across the agent boundary would let a\r\n        // caller mutate the artifact without an event, bypassing write-scope.\r\n        return structuredClone(r);\r\n      }),\r\n\r\n    find: (selector, opts) =>\r\n      run(() => {\r\n        if (binding.readScope !== undefined && opts?.within !== undefined && !isWithin(opts.within, binding.readScope)) {\r\n          throw new ScopeViolationError(opts.within, binding.readScope);\r\n        }\r\n        return navigator.find(selector, { ...opts, within: opts?.within ?? binding.readScope });\r\n      }),\r\n\r\n    search: (query, opts = {}) =>\r\n      run(async () => {\r\n        if (!deps.index) throw new InvalidOpError(\"no semantic index configured for this toolset\");\r\n        if (binding.readScope !== undefined && opts.under !== undefined && !isWithin(opts.under, binding.readScope)) {\r\n          throw new ScopeViolationError(opts.under, binding.readScope);\r\n        }\r\n        const under = opts.under ?? binding.readScope;\r\n        return deps.index.search(query, { ...opts, under });\r\n      }),\r\n\r\n    patch: (ref, op) =>\r\n      run<PatchResult>(() => {\r\n        const common = { owner: binding.owner, writeScope: binding.writeScope, ifVersion: op.ifVersion };\r\n        const resolve = (r: Ref) => {\r\n          const node = \"id\" in r ? addressing.byId(r.id) : addressing.byPath(r.path);\r\n          if (!node) throw new NodeNotFoundError(r);\r\n          return node;\r\n        };\r\n        switch (op.op) {\r\n          case \"set\": {\r\n            deps.mutator.set(ref, op.value, common);\r\n            const node = resolve(ref);\r\n            return { id: node.id, path: addressing.pathOf(node.id), version: node.meta.version };\r\n          }\r\n          case \"insert\": {\r\n            const id = deps.mutator.insert(ref, op.key, op.value, common);\r\n            const node = tree.get(id)!;\r\n            return { id, path: addressing.pathOf(id), version: node.meta.version };\r\n          }\r\n          case \"remove\": {\r\n            const node = resolve(ref);\r\n            const removed = { id: node.id, path: addressing.pathOf(node.id) };\r\n            const parentId = node.parentId;\r\n            deps.mutator.remove(ref, common);\r\n            const parent = parentId !== null ? tree.get(parentId) : undefined;\r\n            return { id: removed.id, path: removed.path, version: parent?.meta.version ?? 0 };\r\n          }\r\n          case \"move\": {\r\n            const node = resolve(ref);\r\n            deps.mutator.move(ref, op.to, op.key, common);\r\n            return { id: node.id, path: addressing.pathOf(node.id), version: node.meta.version };\r\n          }\r\n          case \"edit\": {\r\n            const node = resolve(ref);\r\n            const path = addressing.pathOf(node.id);\r\n            // Scope, then version, then content — the Mutator's own ordering. The\r\n            // content checks below read the live value, so they must not run first:\r\n            // \"not found\" vs SCOPE_VIOLATION would be a binary-search oracle on\r\n            // out-of-scope content, and INVALID_OP on a stale read sends the agent\r\n            // chasing a \"wrong quote\" instead of re-getting.\r\n            if (binding.writeScope !== undefined && !isWithin(path, binding.writeScope)) {\r\n              throw new ScopeViolationError(path, binding.writeScope);\r\n            }\r\n            if (op.ifVersion !== undefined && node.meta.version !== op.ifVersion) {\r\n              throw new StaleVersionError(node.id, op.ifVersion, node.meta.version);\r\n            }\r\n            const value = tree.toJson(node.id);\r\n            if (typeof value !== \"string\") {\r\n              const kind =\r\n                value === null\r\n                  ? \"null\"\r\n                  : Array.isArray(value)\r\n                    ? \"an array\"\r\n                    : typeof value === \"object\"\r\n                      ? \"an object\"\r\n                      : `a ${typeof value}`;\r\n              throw new InvalidOpError(\r\n                `edit targets string values; ${path} is ${kind} — target a string field inside it`,\r\n              );\r\n            }\r\n            if (op.old === \"\") throw new InvalidOpError(\"edit: old must be non-empty\");\r\n            if (op.old === op.new) throw new InvalidOpError(\"edit: old and new are identical\");\r\n            const count = value.split(op.old).length - 1;\r\n            if (count === 0) throw new InvalidOpError(`edit: old string not found in ${path}`);\r\n            if (count > 1 && !op.replaceAll) {\r\n              throw new InvalidOpError(\r\n                `edit: old string occurs ${count} times in ${path} — quote a larger unique fragment or set replaceAll`,\r\n              );\r\n            }\r\n            // split/join instead of String.replace: replace() interprets `$&` etc. in the\r\n            // replacement string, which would corrupt an exact-substring edit. When count\r\n            // is 1 the two are equivalent anyway.\r\n            const next = value.split(op.old).join(op.new);\r\n            deps.mutator.set(ref, next, common);\r\n            const after = resolve(ref);\r\n            return { id: after.id, path: addressing.pathOf(after.id), version: after.meta.version };\r\n          }\r\n        }\r\n      }),\r\n\r\n    history: (ref, opts = {}) =>\r\n      run(() => {\r\n        let events = [...deps.log.entries()];\r\n        if (ref !== undefined) {\r\n          const node = \"id\" in ref ? addressing.byId(ref.id) : addressing.byPath(ref.path);\r\n          if (!node) throw new NodeNotFoundError(ref);\r\n          const path = addressing.pathOf(node.id);\r\n          if (!isWithin(path, binding.readScope)) throw new ScopeViolationError(path, binding.readScope!);\r\n          const id = node.id;\r\n          events = events.filter((e) => e.targetId === id);\r\n        } else if (binding.readScope !== undefined) {\r\n          const scope = binding.readScope;\r\n          events = events.filter((e) => eventWithinScope(e, scope));\r\n        }\r\n        return structuredClone(opts.limit !== undefined ? events.slice(-opts.limit) : events);\r\n      }),\r\n  };\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -16,10 +16,10 @@ import {
 import {
   createArbor,
   restoreArbor
-} from "./chunk-IUV6LML6.js";
+} from "./chunk-WEO5KBRI.js";
 import {
   makeToolset
-} from "./chunk-5RUBU72S.js";
+} from "./chunk-ZDANDXJ6.js";
 import {
   typeAwareDecision
 } from "./chunk-6DOI4FNX.js";

package/dist/toolset.d.ts

@@ -24,6 +24,10 @@ type ToolResult<T> = {
         message: string;
     };
 };
+/** `edit` is exact-substring surgery on a string leaf — pure sugar over `set`: the event
+ *  log records a plain `set` with the full before/after value, so history/revert/replay/
+ *  AG-UI need nothing new. `old` must match the live value exactly (and uniquely, unless
+ *  `replaceAll`) — `get` the node first and quote `old` from what it returns. */
 type PatchOp = {
     op: "set";
     value: Json;
@@ -41,6 +45,12 @@ type PatchOp = {
     to: Ref;
     key: string | number;
     ifVersion?: number;
+} | {
+    op: "edit";
+    old: string;
+    new: string;
+    replaceAll?: boolean;
+    ifVersion?: number;
 };
 interface ToolsetDeps {
     tree: ArtifactTree;

package/dist/toolset.js

@@ -1,6 +1,6 @@
 import {
   makeToolset
-} from "./chunk-5RUBU72S.js";
+} from "./chunk-ZDANDXJ6.js";
 import "./chunk-QRGDUGY6.js";
 import "./chunk-ZBBMJMLG.js";
 import "./chunk-VG5BEOBI.js";

package/package.json

@@ -1,170 +1,170 @@
-{
-  "name": "arborkit",
-  "version": "1.0.1",
-  "description": "Arbor — a shared, typed, versioned JSON artifact tree for multi-agent systems: lazy navigation, scoped agent tools, exact + semantic indexing, reversible event log with time-travel, snapshot + delta persistence.",
-  "keywords": [
-    "agents",
-    "multi-agent",
-    "shared-state",
-    "artifact",
-    "json-tree",
-    "event-sourcing",
-    "time-travel",
-    "semantic-search",
-    "blackboard",
-    "llm"
-  ],
-  "author": "D. A. Pominov <d.a.pominov@gmail.com>",
-  "license": "MIT",
-  "type": "module",
-  "engines": {
-    "node": ">=20.6"
-  },
-  "sideEffects": false,
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./addressing": {
-      "types": "./dist/addressing.d.ts",
-      "import": "./dist/addressing.js"
-    },
-    "./ag-ui": {
-      "types": "./dist/ag-ui.d.ts",
-      "import": "./dist/ag-ui.js"
-    },
-    "./arbor": {
-      "types": "./dist/arbor.d.ts",
-      "import": "./dist/arbor.js"
-    },
-    "./artifact-tree": {
-      "types": "./dist/artifact-tree.d.ts",
-      "import": "./dist/artifact-tree.js"
-    },
-    "./clock": {
-      "types": "./dist/clock.d.ts",
-      "import": "./dist/clock.js"
-    },
-    "./decompose": {
-      "types": "./dist/decompose.d.ts",
-      "import": "./dist/decompose.js"
-    },
-    "./delta-storage": {
-      "types": "./dist/delta-storage.d.ts",
-      "import": "./dist/delta-storage.js"
-    },
-    "./delta": {
-      "types": "./dist/delta.d.ts",
-      "import": "./dist/delta.js"
-    },
-    "./embedding-port": {
-      "types": "./dist/embedding-port.d.ts",
-      "import": "./dist/embedding-port.js"
-    },
-    "./embedding-text": {
-      "types": "./dist/embedding-text.d.ts",
-      "import": "./dist/embedding-text.js"
-    },
-    "./errors": {
-      "types": "./dist/errors.d.ts",
-      "import": "./dist/errors.js"
-    },
-    "./event-log": {
-      "types": "./dist/event-log.d.ts",
-      "import": "./dist/event-log.js"
-    },
-    "./file-storage": {
-      "types": "./dist/file-storage.d.ts",
-      "import": "./dist/file-storage.js"
-    },
-    "./ids": {
-      "types": "./dist/ids.d.ts",
-      "import": "./dist/ids.js"
-    },
-    "./json-edit": {
-      "types": "./dist/json-edit.d.ts",
-      "import": "./dist/json-edit.js"
-    },
-    "./jsonpointer": {
-      "types": "./dist/jsonpointer.d.ts",
-      "import": "./dist/jsonpointer.js"
-    },
-    "./mutator": {
-      "types": "./dist/mutator.d.ts",
-      "import": "./dist/mutator.js"
-    },
-    "./navigator": {
-      "types": "./dist/navigator.d.ts",
-      "import": "./dist/navigator.js"
-    },
-    "./path-glob": {
-      "types": "./dist/path-glob.d.ts",
-      "import": "./dist/path-glob.js"
-    },
-    "./registry-validator": {
-      "types": "./dist/registry-validator.d.ts",
-      "import": "./dist/registry-validator.js"
-    },
-    "./replay": {
-      "types": "./dist/replay.d.ts",
-      "import": "./dist/replay.js"
-    },
-    "./semantic-index": {
-      "types": "./dist/semantic-index.d.ts",
-      "import": "./dist/semantic-index.js"
-    },
-    "./storage": {
-      "types": "./dist/storage.d.ts",
-      "import": "./dist/storage.js"
-    },
-    "./toolset": {
-      "types": "./dist/toolset.d.ts",
-      "import": "./dist/toolset.js"
-    },
-    "./type-aware-decision": {
-      "types": "./dist/type-aware-decision.d.ts",
-      "import": "./dist/type-aware-decision.js"
-    },
-    "./type-registry": {
-      "types": "./dist/type-registry.d.ts",
-      "import": "./dist/type-registry.js"
-    },
-    "./types": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/types.js"
-    },
-    "./vector-index-port": {
-      "types": "./dist/vector-index-port.d.ts",
-      "import": "./dist/vector-index-port.js"
-    },
-    "./zod-adapter": {
-      "types": "./dist/zod-adapter.d.ts",
-      "import": "./dist/zod-adapter.js"
-    }
-  },
-  "files": [
-    "dist",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "prepack": "npm run build",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "bench": "tsx bench/bench.ts",
-    "example": "tsx examples/content-site.ts"
-  },
-  "devDependencies": {
-    "@types/node": "^20.14.0",
-    "tsup": "^8.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.8",
-    "zod": "^3.24.0"
-  }
-}
+{
+  "name": "arborkit",
+  "version": "1.1.0",
+  "description": "Arbor — a shared, typed, versioned JSON artifact tree for multi-agent systems: lazy navigation, scoped agent tools, exact + semantic indexing, reversible event log with time-travel, snapshot + delta persistence.",
+  "keywords": [
+    "agents",
+    "multi-agent",
+    "shared-state",
+    "artifact",
+    "json-tree",
+    "event-sourcing",
+    "time-travel",
+    "semantic-search",
+    "blackboard",
+    "llm"
+  ],
+  "author": "D. A. Pominov <d.a.pominov@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.6"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./addressing": {
+      "types": "./dist/addressing.d.ts",
+      "import": "./dist/addressing.js"
+    },
+    "./ag-ui": {
+      "types": "./dist/ag-ui.d.ts",
+      "import": "./dist/ag-ui.js"
+    },
+    "./arbor": {
+      "types": "./dist/arbor.d.ts",
+      "import": "./dist/arbor.js"
+    },
+    "./artifact-tree": {
+      "types": "./dist/artifact-tree.d.ts",
+      "import": "./dist/artifact-tree.js"
+    },
+    "./clock": {
+      "types": "./dist/clock.d.ts",
+      "import": "./dist/clock.js"
+    },
+    "./decompose": {
+      "types": "./dist/decompose.d.ts",
+      "import": "./dist/decompose.js"
+    },
+    "./delta-storage": {
+      "types": "./dist/delta-storage.d.ts",
+      "import": "./dist/delta-storage.js"
+    },
+    "./delta": {
+      "types": "./dist/delta.d.ts",
+      "import": "./dist/delta.js"
+    },
+    "./embedding-port": {
+      "types": "./dist/embedding-port.d.ts",
+      "import": "./dist/embedding-port.js"
+    },
+    "./embedding-text": {
+      "types": "./dist/embedding-text.d.ts",
+      "import": "./dist/embedding-text.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
+    },
+    "./event-log": {
+      "types": "./dist/event-log.d.ts",
+      "import": "./dist/event-log.js"
+    },
+    "./file-storage": {
+      "types": "./dist/file-storage.d.ts",
+      "import": "./dist/file-storage.js"
+    },
+    "./ids": {
+      "types": "./dist/ids.d.ts",
+      "import": "./dist/ids.js"
+    },
+    "./json-edit": {
+      "types": "./dist/json-edit.d.ts",
+      "import": "./dist/json-edit.js"
+    },
+    "./jsonpointer": {
+      "types": "./dist/jsonpointer.d.ts",
+      "import": "./dist/jsonpointer.js"
+    },
+    "./mutator": {
+      "types": "./dist/mutator.d.ts",
+      "import": "./dist/mutator.js"
+    },
+    "./navigator": {
+      "types": "./dist/navigator.d.ts",
+      "import": "./dist/navigator.js"
+    },
+    "./path-glob": {
+      "types": "./dist/path-glob.d.ts",
+      "import": "./dist/path-glob.js"
+    },
+    "./registry-validator": {
+      "types": "./dist/registry-validator.d.ts",
+      "import": "./dist/registry-validator.js"
+    },
+    "./replay": {
+      "types": "./dist/replay.d.ts",
+      "import": "./dist/replay.js"
+    },
+    "./semantic-index": {
+      "types": "./dist/semantic-index.d.ts",
+      "import": "./dist/semantic-index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage.d.ts",
+      "import": "./dist/storage.js"
+    },
+    "./toolset": {
+      "types": "./dist/toolset.d.ts",
+      "import": "./dist/toolset.js"
+    },
+    "./type-aware-decision": {
+      "types": "./dist/type-aware-decision.d.ts",
+      "import": "./dist/type-aware-decision.js"
+    },
+    "./type-registry": {
+      "types": "./dist/type-registry.d.ts",
+      "import": "./dist/type-registry.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./vector-index-port": {
+      "types": "./dist/vector-index-port.d.ts",
+      "import": "./dist/vector-index-port.js"
+    },
+    "./zod-adapter": {
+      "types": "./dist/zod-adapter.d.ts",
+      "import": "./dist/zod-adapter.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "bench": "tsx bench/bench.ts",
+    "example": "tsx examples/content-site.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8",
+    "zod": "^3.24.0"
+  }
+}

package/dist/chunk-5RUBU72S.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toolset.ts"],"sourcesContent":["import type { ArtifactTree } from \"./artifact-tree\";\r\nimport type { Addressing } from \"./addressing\";\r\nimport type { EventLog, MutationEvent } from \"./event-log\";\r\nimport type { Mutator } from \"./mutator\";\r\nimport type { SemanticIndex } from \"./semantic-index\";\r\nimport {\r\n  Navigator,\r\n  type DescribeOpts,\r\n  type DescribeResult,\r\n  type GetOpts,\r\n  type GetResult,\r\n  type FindSelector,\r\n  type FindOpts,\r\n  type FindResult,\r\n} from \"./navigator\";\r\nimport type { SearchOpts, SearchResult } from \"./semantic-index\";\r\nimport { type Ref, ArborError, ScopeViolationError, InvalidOpError, NodeNotFoundError } from \"./errors\";\r\nimport { isWithin } from \"./jsonpointer\";\r\nimport type { Json, NodeId } from \"./types\";\r\n\r\n/** Every toolset call returns this — errors are structured, never thrown across the agent boundary. */\r\nexport type ToolResult<T> = { ok: true; value: T } | { ok: false; error: { code: string; message: string } };\r\n\r\nexport type PatchOp =\r\n  | { op: \"set\"; value: Json; ifVersion?: number }\r\n  | { op: \"insert\"; key: string | number; value: Json; ifVersion?: number }\r\n  | { op: \"remove\"; ifVersion?: number }\r\n  | { op: \"move\"; to: Ref; key: string | number; ifVersion?: number };\r\n\r\nexport interface ToolsetDeps {\r\n  tree: ArtifactTree;\r\n  addressing: Addressing;\r\n  log: EventLog;\r\n  mutator: Mutator;\r\n  index?: SemanticIndex;\r\n}\r\n\r\nexport interface ToolsetBinding {\r\n  owner?: string;\r\n  /** JSON Pointer prefix: writes must be at or under it (enforced by the Mutator). */\r\n  writeScope?: string;\r\n  /** JSON Pointer prefix: reads are confined to it. */\r\n  readScope?: string;\r\n}\r\n\r\nexport interface PatchResult {\r\n  id: NodeId;\r\n  path: string;\r\n  /** The affected node's version AFTER the op (remove: the parent's). Feed into the next ifVersion. */\r\n  version: number;\r\n}\r\n\r\nexport interface Toolset {\r\n  describe(ref?: Ref, opts?: DescribeOpts): Promise<ToolResult<DescribeResult>>;\r\n  get(ref: Ref, opts?: GetOpts): Promise<ToolResult<GetResult>>;\r\n  find(selector: FindSelector, opts?: FindOpts): Promise<ToolResult<FindResult>>;\r\n  search(query: string, opts?: SearchOpts): Promise<ToolResult<SearchResult>>;\r\n  patch(ref: Ref, op: PatchOp): Promise<ToolResult<PatchResult>>;\r\n  history(ref?: Ref, opts?: { limit?: number }): Promise<ToolResult<MutationEvent[]>>;\r\n}\r\n\r\n/** An event is within scope if any of its recorded paths is within scope. */\r\nfunction eventWithinScope(e: MutationEvent, scope: string): boolean {\r\n  if (e.path !== undefined && isWithin(e.path, scope)) return true;\r\n  if (e.toPath !== undefined && isWithin(e.toPath, scope)) return true;\r\n  if (e.fromPath !== undefined && isWithin(e.fromPath, scope)) return true;\r\n  return false;\r\n}\r\n\r\n/** Run a tool body, converting thrown errors into a structured ToolResult. */\r\nasync function run<T>(fn: () => T | Promise<T>): Promise<ToolResult<T>> {\r\n  try {\r\n    return { ok: true, value: await fn() };\r\n  } catch (e) {\r\n    if (e instanceof ArborError) return { ok: false, error: { code: e.code, message: e.message } };\r\n    const message = e instanceof Error ? e.message : String(e);\r\n    return { ok: false, error: { code: \"ERROR\", message } };\r\n  }\r\n}\r\n\r\n/** A scoped, agent-facing bundle of tools returning structured results. */\r\nexport function makeToolset(deps: ToolsetDeps, binding: ToolsetBinding = {}): Toolset {\r\n  const { tree, addressing } = deps;\r\n  const navigator = new Navigator(tree, addressing);\r\n\r\n  return {\r\n    describe: (ref, opts) =>\r\n      run(() => {\r\n        const target: Ref = ref ?? (binding.readScope !== undefined ? { path: binding.readScope } : { path: \"\" });\r\n        const r = navigator.describe(target, opts);\r\n        if (!isWithin(r.node.path, binding.readScope)) {\r\n          throw new ScopeViolationError(r.node.path, binding.readScope!);\r\n        }\r\n        return r;\r\n      }),\r\n\r\n    get: (ref, opts) =>\r\n      run(() => {\r\n        const r = navigator.get(ref, opts);\r\n        if (!isWithin(r.path, binding.readScope)) {\r\n          throw new ScopeViolationError(r.path, binding.readScope!);\r\n        }\r\n        // Deep-clone the WHOLE result: `content` (and `meta`) come from the live\r\n        // tree by reference; handing them across the agent boundary would let a\r\n        // caller mutate the artifact without an event, bypassing write-scope.\r\n        return structuredClone(r);\r\n      }),\r\n\r\n    find: (selector, opts) =>\r\n      run(() => {\r\n        if (binding.readScope !== undefined && opts?.within !== undefined && !isWithin(opts.within, binding.readScope)) {\r\n          throw new ScopeViolationError(opts.within, binding.readScope);\r\n        }\r\n        return navigator.find(selector, { ...opts, within: opts?.within ?? binding.readScope });\r\n      }),\r\n\r\n    search: (query, opts = {}) =>\r\n      run(async () => {\r\n        if (!deps.index) throw new InvalidOpError(\"no semantic index configured for this toolset\");\r\n        if (binding.readScope !== undefined && opts.under !== undefined && !isWithin(opts.under, binding.readScope)) {\r\n          throw new ScopeViolationError(opts.under, binding.readScope);\r\n        }\r\n        const under = opts.under ?? binding.readScope;\r\n        return deps.index.search(query, { ...opts, under });\r\n      }),\r\n\r\n    patch: (ref, op) =>\r\n      run<PatchResult>(() => {\r\n        const common = { owner: binding.owner, writeScope: binding.writeScope, ifVersion: op.ifVersion };\r\n        const resolve = (r: Ref) => {\r\n          const node = \"id\" in r ? addressing.byId(r.id) : addressing.byPath(r.path);\r\n          if (!node) throw new NodeNotFoundError(r);\r\n          return node;\r\n        };\r\n        switch (op.op) {\r\n          case \"set\": {\r\n            deps.mutator.set(ref, op.value, common);\r\n            const node = resolve(ref);\r\n            return { id: node.id, path: addressing.pathOf(node.id), version: node.meta.version };\r\n          }\r\n          case \"insert\": {\r\n            const id = deps.mutator.insert(ref, op.key, op.value, common);\r\n            const node = tree.get(id)!;\r\n            return { id, path: addressing.pathOf(id), version: node.meta.version };\r\n          }\r\n          case \"remove\": {\r\n            const node = resolve(ref);\r\n            const removed = { id: node.id, path: addressing.pathOf(node.id) };\r\n            const parentId = node.parentId;\r\n            deps.mutator.remove(ref, common);\r\n            const parent = parentId !== null ? tree.get(parentId) : undefined;\r\n            return { id: removed.id, path: removed.path, version: parent?.meta.version ?? 0 };\r\n          }\r\n          case \"move\": {\r\n            const node = resolve(ref);\r\n            deps.mutator.move(ref, op.to, op.key, common);\r\n            return { id: node.id, path: addressing.pathOf(node.id), version: node.meta.version };\r\n          }\r\n        }\r\n      }),\r\n\r\n    history: (ref, opts = {}) =>\r\n      run(() => {\r\n        let events = [...deps.log.entries()];\r\n        if (ref !== undefined) {\r\n          const node = \"id\" in ref ? addressing.byId(ref.id) : addressing.byPath(ref.path);\r\n          if (!node) throw new NodeNotFoundError(ref);\r\n          const path = addressing.pathOf(node.id);\r\n          if (!isWithin(path, binding.readScope)) throw new ScopeViolationError(path, binding.readScope!);\r\n          const id = node.id;\r\n          events = events.filter((e) => e.targetId === id);\r\n        } else if (binding.readScope !== undefined) {\r\n          const scope = binding.readScope;\r\n          events = events.filter((e) => eventWithinScope(e, scope));\r\n        }\r\n        return structuredClone(opts.limit !== undefined ? events.slice(-opts.limit) : events);\r\n      }),\r\n  };\r\n}\r\n"],"mappings":"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","names":[]}