@lambdacurry/arbor 0.20.16 → 0.20.18

package/dist/arbor.js

@@ -17802,21 +17802,14 @@ var MCP_OUTPUT_SCHEMAS = {
     replayed: exports_external.boolean()
   }),
   computer_stop: exports_external.looseObject({ checkpoint, stopped: jsonObject }),
-  code_symbols: exports_external.looseObject({
-    computerSessionId: id,
-    path: exports_external.string(),
+  code_symbols: exports_external.object({
     symbols: exports_external.array(codeSymbol)
   }),
-  code_find_symbol: exports_external.looseObject({
-    computerSessionId: id,
-    namePath: exports_external.string(),
+  code_find_symbol: exports_external.object({
     symbols: exports_external.array(codeSymbol)
   }),
-  code_references: exports_external.looseObject({
-    computerSessionId: id,
-    namePath: exports_external.string(),
-    path: exports_external.string(),
-    references: exports_external.array(exports_external.looseObject({
+  code_references: exports_external.object({
+    references: exports_external.array(exports_external.object({
       path: exports_external.string(),
       namePath: exports_external.string().optional(),
       startLine: exports_external.number().optional(),
@@ -17824,16 +17817,11 @@ var MCP_OUTPUT_SCHEMAS = {
     })),
     truncated: exports_external.boolean()
   }),
-  code_implementations: exports_external.looseObject({
-    computerSessionId: id,
-    namePath: exports_external.string(),
-    path: exports_external.string(),
+  code_implementations: exports_external.object({
     symbols: exports_external.array(codeSymbol)
   }),
-  code_diagnostics: exports_external.looseObject({
-    computerSessionId: id,
-    path: exports_external.string(),
-    diagnostics: exports_external.array(exports_external.looseObject({
+  code_diagnostics: exports_external.object({
+    diagnostics: exports_external.array(exports_external.object({
       severity: exports_external.enum(["error", "warning", "information", "hint"]),
       message: exports_external.string(),
       path: exports_external.string(),
@@ -18713,8 +18701,8 @@ var ACTION_DEFINITIONS = [
     title: "Outline a file's symbols",
     description: "READ ONLY: Outline real declarations in a file or directory when you need structure without reading or searching the whole source. Uses the language server to return symbols and kinds, distinguishing declarations from textual matches.",
     inputSchema: {
-      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
-      runId: exports_external.string().optional().describe("route this semantic read according to this Run execution placement, run_…"),
+      computerSessionId: exports_external.string().optional().describe("parent Computer target; optional when runId is supplied, otherwise required; if both are supplied they must agree"),
+      runId: exports_external.string().optional().describe("Run target that resolves its owning Computer session, run_…"),
       path: exports_external.string().max(512).describe("file or directory, absolute under /workspace or workspace-relative")
     },
     surfaces: ["computer-mcp", "computer-cli"],
@@ -18726,8 +18714,8 @@ var ACTION_DEFINITIONS = [
     title: "Find a symbol by name path",
     description: "READ ONLY: Locate a declaration by name path when you need the definition rather than text matches. Uses the language server and can include the symbol body and bounded child depth.",
     inputSchema: {
-      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
-      runId: exports_external.string().optional().describe("route this semantic read according to this Run execution placement, run_…"),
+      computerSessionId: exports_external.string().optional().describe("parent Computer target; optional when runId is supplied, otherwise required; if both are supplied they must agree"),
+      runId: exports_external.string().optional().describe("Run target that resolves its owning Computer session, run_…"),
       namePath: exports_external.string().min(1).max(200).describe("symbol name path within a file, e.g. MyClass/myMethod"),
       path: exports_external.string().max(512).optional().describe("optional file or directory to restrict the search to"),
       includeBody: exports_external.boolean().optional().describe("include each symbol's source body"),
@@ -18742,8 +18730,8 @@ var ACTION_DEFINITIONS = [
     title: "Find what references a symbol",
     description: "READ ONLY: Find semantic references to a declaration when you need to know what actually depends on it before a change. Uses the language server to return resolved references with snippets, excluding unrelated textual matches.",
     inputSchema: {
-      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
-      runId: exports_external.string().optional().describe("route this semantic read according to this Run execution placement, run_…"),
+      computerSessionId: exports_external.string().optional().describe("parent Computer target; optional when runId is supplied, otherwise required; if both are supplied they must agree"),
+      runId: exports_external.string().optional().describe("Run target that resolves its owning Computer session, run_…"),
       namePath: exports_external.string().min(1).max(200).describe("name path of the symbol to trace"),
       path: exports_external.string().max(512).describe("the file declaring that symbol, absolute under /workspace or workspace-relative")
     },
@@ -18756,8 +18744,8 @@ var ACTION_DEFINITIONS = [
     title: "Find implementations of a symbol",
     description: "READ ONLY: Find concrete implementations or subtypes of an interface, abstract type, or method. Uses the language server to resolve type relationships that text search cannot follow.",
     inputSchema: {
-      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
-      runId: exports_external.string().optional().describe("route this semantic read according to this Run execution placement, run_…"),
+      computerSessionId: exports_external.string().optional().describe("parent Computer target; optional when runId is supplied, otherwise required; if both are supplied they must agree"),
+      runId: exports_external.string().optional().describe("Run target that resolves its owning Computer session, run_…"),
       namePath: exports_external.string().min(1).max(200).describe("name path of the interface, type, or method"),
       path: exports_external.string().max(512).describe("the file declaring that symbol, absolute under /workspace or workspace-relative")
     },
@@ -18770,8 +18758,8 @@ var ACTION_DEFINITIONS = [
     title: "Read language-server diagnostics for a file",
     description: "READ ONLY: Check live language-server errors and warnings for one file, especially after an edit. Returns diagnostics mapped to symbols for fast local feedback; it does not replace a whole-project build or typecheck.",
     inputSchema: {
-      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
-      runId: exports_external.string().optional().describe("route this semantic read according to this Run execution placement, run_…"),
+      computerSessionId: exports_external.string().optional().describe("parent Computer target; optional when runId is supplied, otherwise required; if both are supplied they must agree"),
+      runId: exports_external.string().optional().describe("Run target that resolves its owning Computer session, run_…"),
       path: exports_external.string().max(512).describe("the file to inspect, absolute under /workspace or workspace-relative")
     },
     surfaces: ["computer-mcp", "computer-cli"],
@@ -20822,7 +20810,13 @@ var BY_COMMAND = new Map(CLI_ACTIONS.map((a) => [commandWords(a), a]));
 var MAX_WORDS = Math.max(1, ...CLI_ACTIONS.map((a) => commandWords(a).split(" ").length));
 var POSITIONAL_FIELDS = {
   app_fetch: ["appId", "path"],
-  app_request: ["appId", "path"]
+  app_request: ["appId", "path"],
+  computer_run_start: ["computerSessionId", "mode"],
+  code_symbols: ["path"],
+  code_find_symbol: ["namePath", "path"],
+  code_references: ["namePath", "path"],
+  code_implementations: ["namePath", "path"],
+  code_diagnostics: ["path"]
 };
 function positionalSpecs(action) {
   const fields = POSITIONAL_FIELDS[action.name];
@@ -20891,7 +20885,7 @@ function toolNameAlias(action) {
 function helpLine(action) {
   const positionals = positionalSpecs(action);
   const positionalFlags = new Set(positionals.map((spec) => spec.flag));
-  const args = positionals.map((spec) => ` <${spec.field}>`).join("");
+  const args = positionals.map((spec) => spec.required ? ` <${spec.field}>` : ` [<${spec.field}>]`).join("");
   const flags = flagsForSchema(action.inputSchema).filter((spec) => !positionalFlags.has(spec.flag)).map((f) => {
     const token = f.kind === "boolean" ? `--${f.flag}` : `--${f.flag} <>`;
     return f.required ? token : `[${token}]`;
@@ -20916,7 +20910,7 @@ function commandHelp(positionals) {
     const token = f.kind === "boolean" ? `--${f.flag}` : `--${f.flag} <${f.kind}>`;
     return f.required ? token : `[${token}]`;
   }).join(" ");
-  const explicitArgs = explicitPositionals.map((spec) => ` <${spec.field}>`).join("");
+  const explicitArgs = explicitPositionals.map((spec) => spec.required ? ` <${spec.field}>` : ` [<${spec.field}>]`).join("");
   const usage = `Usage: arbor ${commandWords(action)}${explicitArgs}${primary ? ` [<${primary.field}>]` : ""}${usageFlags ? ` ${usageFlags}` : ""}`;
   const lines = specs.map((f) => {
     const req = f.required ? "required" : "optional";
@@ -20960,6 +20954,25 @@ function commandCatalog() {
     }))
   }));
 }
+function applyPositionals(action, extras, flags) {
+  if (extras.length === 0)
+    return;
+  const explicitPositionals = positionalSpecs(action);
+  const positionalTargets = explicitPositionals.length > 0 ? explicitPositionals : [primaryPositionalField(action.inputSchema)].filter((spec) => spec !== undefined);
+  if (positionalTargets.length === 0) {
+    throw new UsageError(`unexpected argument: ${extras[0]} (\`${commandWords(action)}\` takes no positional — use flags)`);
+  }
+  if (extras.length > positionalTargets.length) {
+    throw new UsageError(`too many arguments: \`${commandWords(action)}\` takes ${positionalTargets.length === 1 ? "one positional" : `${positionalTargets.length} positionals`}; pass the rest as flags`);
+  }
+  for (const [index2, value] of extras.entries()) {
+    const target = positionalTargets[index2];
+    if (flags[target.flag] !== undefined || flags[`${target.flag}-file`] !== undefined) {
+      throw new UsageError(`pass --${target.flag} either as a flag or as the positional argument, not both`);
+    }
+    flags[target.flag] = value;
+  }
+}
 async function runObjectVerb(positionals, flags, ctx) {
   const match = matchCommand(positionals);
   if (!match) {
@@ -20967,24 +20980,7 @@ async function runObjectVerb(positionals, flags, ctx) {
     throw new UsageError(`unknown command: ${typed} — ${suggestCommand(positionals)}`);
   }
   const { action, words } = match;
-  const extras = positionals.slice(words);
-  if (extras.length > 0) {
-    const explicitPositionals = positionalSpecs(action);
-    const positionalTargets = explicitPositionals.length > 0 ? explicitPositionals : [primaryPositionalField(action.inputSchema)].filter((spec) => spec !== undefined);
-    if (positionalTargets.length === 0) {
-      throw new UsageError(`unexpected argument: ${extras[0]} (\`${commandWords(action)}\` takes no positional — use flags)`);
-    }
-    if (extras.length > positionalTargets.length) {
-      throw new UsageError(`too many arguments: \`${commandWords(action)}\` takes ${positionalTargets.length === 1 ? "one positional" : `${positionalTargets.length} positionals`}; pass the rest as flags`);
-    }
-    for (const [index2, value2] of extras.entries()) {
-      const target = positionalTargets[index2];
-      if (flags[target.flag] !== undefined || flags[`${target.flag}-file`] !== undefined) {
-        throw new UsageError(`pass --${target.flag} either as a flag or as the positional argument, not both`);
-      }
-      flags[target.flag] = value2;
-    }
-  }
+  applyPositionals(action, positionals.slice(words), flags);
   const accepted = acceptedFlags(action.inputSchema);
   const unknown2 = Object.keys(flags).filter((f) => !accepted.has(f) && !RESERVED_FLAGS.has(f));
   if (unknown2.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.20.16",
+  "version": "0.20.18",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "keywords": [
     "agents",