@contractspec/lib.ai-agent 5.0.4 → 6.0.0

package/dist/node/exporters/claude-agent-exporter.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }
@@ -2211,7 +2222,7 @@ class ClaudeAgentExporter {
   }
   buildConfig(spec, tools, options) {
     const config = {
-      model: options.model ?? "claude-sonnet-4-20250514",
+      model: options.model ?? "claude-sonnet-4-6",
       system: this.buildSystemPrompt(spec, options),
       tools,
       max_turns: spec.maxSteps ?? 10

package/dist/node/exporters/index.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }
@@ -2497,7 +2508,7 @@ class ClaudeAgentExporter {
   }
   buildConfig(spec, tools, options) {
     const config = {
-      model: options.model ?? "claude-sonnet-4-20250514",
+      model: options.model ?? "claude-sonnet-4-6",
       system: this.buildSystemPrompt(spec, options),
       tools,
       max_turns: spec.maxSteps ?? 10

package/dist/node/exporters/opencode-exporter.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/index.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/interop/index.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }
@@ -2678,6 +2689,17 @@ function createSingleSpecConsumer(spec, options) {
 init_tool_bridge();
 init_tool_bridge2();
 init_i18n();
+async function resolveToolResult(result) {
+  const resolved = await result;
+  if (typeof resolved === "object" && resolved !== null && typeof resolved.next === "function" && typeof resolved[Symbol.asyncIterator] === "function") {
+    let last;
+    for await (const value of resolved) {
+      last = value;
+    }
+    return typeof last === "string" ? last : JSON.stringify(last ?? "");
+  }
+  return typeof resolved === "string" ? resolved : JSON.stringify(resolved ?? "");
+}
 
 class MCPToolServer {
   tools;
@@ -2738,7 +2760,7 @@ class MCPToolServer {
       metadata: context?.metadata,
       signal: context?.signal
     };
-    return await tool.handler(args, fullContext);
+    return resolveToolResult(tool.handler(args, fullContext));
   }
   getMCPToolDefinitions() {
     const definitions = [];
@@ -2853,7 +2875,7 @@ class ContractSpecToolConsumer {
       metadata: context?.metadata,
       signal: context?.signal
     };
-    return await tool.handler(args, fullContext);
+    return resolveToolResult(tool.handler(args, fullContext));
   }
   addTool(config, handler) {
     this.tools.set(config.name, { config, handler });

package/dist/node/interop/spec-consumer.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/interop/tool-consumer.js

@@ -2357,6 +2357,17 @@ var init_tool_bridge2 = __esm(() => {
 init_tool_bridge();
 init_tool_bridge2();
 init_i18n();
+async function resolveToolResult(result) {
+  const resolved = await result;
+  if (typeof resolved === "object" && resolved !== null && typeof resolved.next === "function" && typeof resolved[Symbol.asyncIterator] === "function") {
+    let last;
+    for await (const value of resolved) {
+      last = value;
+    }
+    return typeof last === "string" ? last : JSON.stringify(last ?? "");
+  }
+  return typeof resolved === "string" ? resolved : JSON.stringify(resolved ?? "");
+}
 
 class MCPToolServer {
   tools;
@@ -2417,7 +2428,7 @@ class MCPToolServer {
       metadata: context?.metadata,
       signal: context?.signal
     };
-    return await tool.handler(args, fullContext);
+    return resolveToolResult(tool.handler(args, fullContext));
   }
   getMCPToolDefinitions() {
     const definitions = [];
@@ -2532,7 +2543,7 @@ class ContractSpecToolConsumer {
       metadata: context?.metadata,
       signal: context?.signal
     };
-    return await tool.handler(args, fullContext);
+    return resolveToolResult(tool.handler(args, fullContext));
   }
   addTool(config, handler) {
     this.tools.set(config.name, { config, handler });

package/dist/node/providers/claude-agent-sdk/adapter.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/providers/claude-agent-sdk/index.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/providers/index.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/providers/opencode-sdk/adapter.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/providers/opencode-sdk/index.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/spec/index.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/spec/spec.js

@@ -2156,6 +2156,17 @@ function defineAgent(spec) {
       }));
     }
     toolNames.add(tool.name);
+    if (tool.subagentRef && tool.operationRef) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" cannot have both subagentRef and operationRef. Use one.`);
+    }
+    const outputRefCount = [
+      tool.outputPresentation,
+      tool.outputForm,
+      tool.outputDataView
+    ].filter(Boolean).length;
+    if (outputRefCount > 1) {
+      throw new Error(`Agent ${spec.meta.key} tool "${tool.name}" has multiple output refs (outputPresentation, outputForm, outputDataView). Use at most one.`);
+    }
   }
   return Object.freeze(spec);
 }

package/dist/node/tools/agent-memory-store.js

@@ -0,0 +1,24 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/tools/agent-memory-store.ts
+function validateMemoryPath(path) {
+  const normalized = path.replace(/\\/g, "/").replace(/\/+/g, "/");
+  if (!normalized.startsWith("/memories") || normalized.includes("..") || normalized === "/memories/.." || normalized.startsWith("/memories/../")) {
+    throw new Error(`Invalid memory path: ${path}. Path must be under /memories and cannot contain traversal sequences.`);
+  }
+}
+export {
+  validateMemoryPath
+};

package/dist/node/tools/in-memory-agent-memory-store.js

@@ -0,0 +1,236 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/tools/agent-memory-store.ts
+function validateMemoryPath(path) {
+  const normalized = path.replace(/\\/g, "/").replace(/\/+/g, "/");
+  if (!normalized.startsWith("/memories") || normalized.includes("..") || normalized === "/memories/.." || normalized.startsWith("/memories/../")) {
+    throw new Error(`Invalid memory path: ${path}. Path must be under /memories and cannot contain traversal sequences.`);
+  }
+}
+
+// src/tools/in-memory-agent-memory-store.ts
+function formatSize(bytes) {
+  if (bytes < 1024)
+    return `${bytes}B`;
+  if (bytes < 1024 * 1024)
+    return `${(bytes / 1024).toFixed(1)}K`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+}
+
+class InMemoryAgentMemoryStore {
+  store = new Map;
+  async view(path, viewRange) {
+    validateMemoryPath(path);
+    const normalized = path.replace(/\/+/g, "/").replace(/\/$/, "") || "/memories";
+    if (this.isDirectory(normalized)) {
+      return this.listDirectory(normalized);
+    }
+    const content = this.store.get(normalized);
+    if (content === undefined) {
+      return `The path ${path} does not exist. Please provide a valid path.`;
+    }
+    const lines = content.split(`
+`);
+    if (lines.length > 999999) {
+      return `File ${path} exceeds maximum line limit of 999,999 lines.`;
+    }
+    const [start, end] = viewRange ?? [1, lines.length];
+    const from = Math.max(0, start - 1);
+    const to = Math.min(lines.length, end);
+    const selected = lines.slice(from, to);
+    const numbered = selected.map((line, i) => {
+      const num = from + i + 1;
+      return `${String(num).padStart(6)}	${line}`;
+    }).join(`
+`);
+    return `Here's the content of ${path} with line numbers:
+${numbered}`;
+  }
+  async create(path, fileText) {
+    validateMemoryPath(path);
+    const normalized = path.replace(/\/+/g, "/");
+    if (this.store.has(normalized)) {
+      return `Error: File ${path} already exists`;
+    }
+    this.ensureParentDir(normalized);
+    this.store.set(normalized, fileText);
+    return `File created successfully at: ${path}`;
+  }
+  async strReplace(path, oldStr, newStr) {
+    validateMemoryPath(path);
+    const normalized = path.replace(/\/+/g, "/");
+    const content = this.store.get(normalized);
+    if (content === undefined) {
+      return `Error: The path ${path} does not exist. Please provide a valid path.`;
+    }
+    const count = (content.match(new RegExp(escapeRegex(oldStr), "g")) ?? []).length;
+    if (count > 1) {
+      const lines = content.split(`
+`);
+      const lineNums = [];
+      lines.forEach((line, i) => {
+        if (line.includes(oldStr))
+          lineNums.push(i + 1);
+      });
+      return `No replacement was performed. Multiple occurrences of old_str \`${oldStr}\` in lines: ${lineNums.join(", ")}. Please ensure it is unique`;
+    }
+    if (count === 0) {
+      return `No replacement was performed, old_str \`${oldStr}\` did not appear verbatim in ${path}.`;
+    }
+    const newContent = content.replace(oldStr, newStr);
+    this.store.set(normalized, newContent);
+    const snippet = newContent.split(`
+`).slice(0, 5);
+    const numbered = snippet.map((line, i) => `${String(i + 1).padStart(6)}	${line}`).join(`
+`);
+    return `The memory file has been edited.
+${numbered}`;
+  }
+  async insert(path, insertLine, insertText) {
+    validateMemoryPath(path);
+    const normalized = path.replace(/\/+/g, "/");
+    const content = this.store.get(normalized);
+    if (content === undefined) {
+      return `Error: The path ${path} does not exist`;
+    }
+    const lines = content.split(`
+`);
+    const n = lines.length;
+    if (insertLine < 0 || insertLine > n) {
+      return `Error: Invalid \`insert_line\` parameter: ${insertLine}. It should be within the range of lines of the file: [0, ${n}]`;
+    }
+    lines.splice(insertLine, 0, insertText.replace(/\n$/, ""));
+    this.store.set(normalized, lines.join(`
+`));
+    return `The file ${path} has been edited.`;
+  }
+  async delete(path) {
+    validateMemoryPath(path);
+    const normalized = path.replace(/\/+/g, "/");
+    if (this.isDirectory(normalized)) {
+      const prefix = normalized === "/memories" ? "/memories/" : `${normalized}/`;
+      for (const key of this.store.keys()) {
+        if (key.startsWith(prefix) || key === normalized) {
+          this.store.delete(key);
+        }
+      }
+    } else {
+      if (!this.store.has(normalized)) {
+        return `Error: The path ${path} does not exist`;
+      }
+      this.store.delete(normalized);
+    }
+    return `Successfully deleted ${path}`;
+  }
+  async rename(oldPath, newPath) {
+    validateMemoryPath(oldPath);
+    validateMemoryPath(newPath);
+    const oldNorm = oldPath.replace(/\/+/g, "/");
+    const newNorm = newPath.replace(/\/+/g, "/");
+    if (this.store.has(newNorm) || this.hasAnyChild(newNorm)) {
+      return `Error: The destination ${newPath} already exists`;
+    }
+    if (this.isDirectory(oldNorm)) {
+      const oldPrefix = `${oldNorm}/`;
+      const entries = Array.from(this.store.entries()).filter(([k]) => k.startsWith(oldPrefix) || k === oldNorm);
+      const newPrefix = `${newNorm}/`;
+      for (const [k, v] of entries) {
+        this.store.delete(k);
+        const newKey = k === oldNorm ? newNorm : newPrefix + k.slice(oldPrefix.length);
+        this.store.set(newKey, v);
+      }
+    } else {
+      const content = this.store.get(oldNorm);
+      if (content === undefined) {
+        return `Error: The path ${oldPath} does not exist`;
+      }
+      this.store.delete(oldNorm);
+      this.ensureParentDir(newNorm);
+      this.store.set(newNorm, content);
+    }
+    return `Successfully renamed ${oldPath} to ${newPath}`;
+  }
+  isDirectory(path) {
+    if (path === "/memories")
+      return true;
+    for (const key of this.store.keys()) {
+      if (key.startsWith(path + "/"))
+        return true;
+    }
+    return false;
+  }
+  hasAnyChild(path) {
+    const prefix = path.endsWith("/") ? path : `${path}/`;
+    for (const key of this.store.keys()) {
+      if (key.startsWith(prefix))
+        return true;
+    }
+    return false;
+  }
+  ensureParentDir(path) {
+    const parts = path.split("/").filter(Boolean);
+    parts.pop();
+    for (let i = 1;i <= parts.length; i++) {
+      const p = "/" + parts.slice(0, i).join("/");
+      if (!this.store.has(p)) {
+        this.store.set(p, "");
+      }
+    }
+  }
+  listDirectory(path) {
+    const prefix = path === "/memories" ? "/memories/" : `${path}/`;
+    const seen = new Set;
+    const entries = [];
+    if (path === "/memories") {
+      entries.push({
+        path: "/memories",
+        size: Array.from(this.store.keys()).filter((k) => k.startsWith("/memories/")).reduce((acc, k) => acc + (this.store.get(k)?.length ?? 0), 0)
+      });
+    }
+    for (const key of this.store.keys()) {
+      if (!key.startsWith(prefix) && key !== path)
+        continue;
+      const rel = key.slice(prefix.length);
+      const first = rel.split("/")[0];
+      if (!first || first.startsWith(".") || first === "node_modules")
+        continue;
+      const fullPath = path === "/memories" ? `/memories/${first}` : `${path}/${first}`;
+      if (seen.has(fullPath))
+        continue;
+      seen.add(fullPath);
+      let size = 0;
+      if (this.store.has(key)) {
+        size = (this.store.get(key) ?? "").length;
+      } else {
+        for (const k of this.store.keys()) {
+          if (k.startsWith(fullPath + "/") || k === fullPath) {
+            size += (this.store.get(k) ?? "").length;
+          }
+        }
+      }
+      entries.push({ path: fullPath, size });
+    }
+    const lines = entries.slice(0, 50).map((e) => `${formatSize(e.size)}	${e.path}`).join(`
+`);
+    return `Here're the files and directories up to 2 levels deep in ${path}, excluding hidden items and node_modules:
+${lines}`;
+  }
+}
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export {
+  InMemoryAgentMemoryStore
+};