@lambdacurry/arbor 0.16.0 → 0.16.2

package/dist/arbor.js

@@ -16727,6 +16727,27 @@ var computerProfile = exports_external.looseObject({
   tools: exports_external.array(exports_external.string()),
   recommendedEditingPrimitive: exports_external.string()
 });
+var computerCapabilityCard = exports_external.looseObject({
+  capabilities: exports_external.array(exports_external.looseObject({
+    id: exports_external.string(),
+    state: exports_external.enum(["ready", "available"]),
+    surface: exports_external.array(exports_external.string()),
+    hint: exports_external.string().optional()
+  })),
+  diagnostics: exports_external.looseObject({
+    backend: exports_external.enum(["worker-shell", "container"]),
+    containerProfile: nullableString,
+    runtimeActive: exports_external.boolean()
+  })
+});
+var codeSymbol = exports_external.looseObject({
+  namePath: exports_external.string(),
+  kind: exports_external.string(),
+  path: exports_external.string(),
+  startLine: exports_external.number().optional(),
+  endLine: exports_external.number().optional(),
+  body: exports_external.string().optional()
+});
 var appBundleSourceProvenance = exports_external.looseObject({
   entryPath: exports_external.string(),
   artifactVersionSha256: exports_external.string(),
@@ -17311,6 +17332,10 @@ var MCP_OUTPUT_SCHEMAS = {
     profile: computerProfile.nullable(),
     startingSnapshot: snapshot.nullable(),
     materialized: checkpoint.nullable(),
+    workspaceRoot: exports_external.string(),
+    repositories: exports_external.array(exports_external.looseObject({ repository: exports_external.string(), path: exports_external.string() })),
+    defaultCwd: exports_external.string(),
+    capabilities: computerCapabilityCard,
     runtime: jsonObject
   }),
   computer_reprovision: exports_external.looseObject({
@@ -17332,14 +17357,17 @@ var MCP_OUTPUT_SCHEMAS = {
     exitCode: exports_external.number().optional(),
     jobId: exports_external.string().optional(),
     status: exports_external.string().optional(),
+    cwd: exports_external.string(),
     strict: exports_external.boolean()
   }),
   computer_status: exports_external.looseObject({
-    ok: exports_external.boolean().optional(),
-    status: exports_external.string().optional(),
-    backend: exports_external.string().optional(),
-    processes: exports_external.array(jsonObject).optional(),
-    profile: computerProfile.nullable()
+    computerSessionId: id,
+    computerId: id,
+    status: exports_external.enum(["running", "dormant"]),
+    backend: exports_external.enum(["worker-shell", "container"]),
+    profile: computerProfile.nullable(),
+    capabilities: computerCapabilityCard,
+    runtime: jsonObject
   }),
   computer_verify: exports_external.looseObject({
     passed: exports_external.literal(true),
@@ -17407,7 +17435,11 @@ var MCP_OUTPUT_SCHEMAS = {
     before: exports_external.string().optional(),
     after: exports_external.string().optional(),
     fetchHead: exports_external.string().optional(),
-    refs: exports_external.array(exports_external.string()).optional()
+    refs: exports_external.array(exports_external.string()).optional(),
+    remoteTracking: exports_external.union([
+      exports_external.looseObject({ updated: exports_external.literal(true), ref: exports_external.string(), head: exports_external.string() }),
+      exports_external.looseObject({ updated: exports_external.literal(false), reason: exports_external.literal("untracked_workspace") })
+    ])
   }),
   computer_push: exports_external.looseObject({
     ok: exports_external.literal(true),
@@ -17446,7 +17478,47 @@ var MCP_OUTPUT_SCHEMAS = {
     warnings: exports_external.array(exports_external.string()),
     replayed: exports_external.boolean()
   }),
-  computer_stop: exports_external.looseObject({ checkpoint, stopped: jsonObject })
+  computer_stop: exports_external.looseObject({ checkpoint, stopped: jsonObject }),
+  code_symbols: exports_external.looseObject({
+    computerSessionId: id,
+    path: exports_external.string(),
+    symbols: exports_external.array(codeSymbol)
+  }),
+  code_find_symbol: exports_external.looseObject({
+    computerSessionId: id,
+    namePath: exports_external.string(),
+    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({
+      path: exports_external.string(),
+      namePath: exports_external.string().optional(),
+      startLine: exports_external.number().optional(),
+      snippet: exports_external.string().optional()
+    })),
+    truncated: exports_external.boolean()
+  }),
+  code_implementations: exports_external.looseObject({
+    computerSessionId: id,
+    namePath: exports_external.string(),
+    path: exports_external.string(),
+    symbols: exports_external.array(codeSymbol)
+  }),
+  code_diagnostics: exports_external.looseObject({
+    computerSessionId: id,
+    path: exports_external.string(),
+    diagnostics: exports_external.array(exports_external.looseObject({
+      severity: exports_external.enum(["error", "warning", "information", "hint"]),
+      message: exports_external.string(),
+      path: exports_external.string(),
+      startLine: exports_external.number().optional(),
+      namePath: exports_external.string().optional()
+    })),
+    truncated: exports_external.boolean()
+  })
 };
 function outputSchemaFor(actionName) {
   return MCP_OUTPUT_SCHEMAS[actionName];
@@ -17576,6 +17648,11 @@ var MCP_TOOL_ANNOTATIONS = {
   computer_reprovision: destructiveIdempotent,
   computer_exec: destructiveOpenWorld,
   computer_status: readOnly,
+  code_symbols: readOnly,
+  code_find_symbol: readOnly,
+  code_references: readOnly,
+  code_implementations: readOnly,
+  code_diagnostics: readOnly,
   computer_verify: openWorld,
   computer_read: readOnly,
   computer_export: idempotent,
@@ -17949,7 +18026,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_open",
     title: "Open a Thread computer",
-    description: "Open or resume this Thread's project environment for filesystem or command work. Every configured repository is re-authorized through its explicit GitHub connection; a fresh reusable base clones it with a request-scoped contents:read credential before strict setup runs, while a restore receives no credential. Returns computerSessionId and the selected profile contract; pass the session id unchanged to later Computer tools and cited work.",
+    description: "Open or resume this Thread's project environment for filesystem or command work. Every configured repository is re-authorized through its explicit GitHub connection; a fresh reusable base clones it with a request-scoped contents:read credential before strict setup runs, while a restore receives no credential. Returns computerSessionId — pass it unchanged to later Computer tools and cited work — plus the selected profile contract, a resolved capabilities card, workspaceRoot, each materialized repositories[].path, and defaultCwd. Omitted computer_exec.cwd uses defaultCwd: the single checkout when exactly one repository is configured, workspaceRoot otherwise.",
     inputSchema: {
       threadId: exports_external.string().describe("the Arbor Thread whose stable computer to open, thr_…"),
       vcpus: exports_external.number().int().min(1).max(4).optional().describe("optional container vCPU request"),
@@ -17975,7 +18052,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_exec",
     title: "Run a command",
-    description: "Run one bounded logical operation in an opened Thread computer, normally from /workspace. Strict Bash semantics are ON by default: an early command failure or failed pipeline makes the execution nonzero, while explicit handling such as `cmd || fallback` still works. Set strict=false only for an intentional best-effort script. Use background only for the container backend; worker-shell deliberately serializes mutations and rejects long-lived processes.",
+    description: "Run one bounded logical operation in an opened Thread computer. Omitting cwd runs from the Computer's defaultCwd — the one materialized checkout when the recipe has exactly one repository, otherwise the workspace root — and the receipt echoes the cwd it ran in; pass cwd explicitly to override it. Strict Bash semantics are ON by default: an early command failure or failed pipeline makes the execution nonzero, while explicit handling such as `cmd || fallback` still works. Set strict=false only for an intentional best-effort script. Use background only for the container backend; worker-shell deliberately serializes mutations and rejects long-lived processes.",
     inputSchema: {
       computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
       command: exports_external.string().min(1).describe("the shell command to run"),
@@ -17991,7 +18068,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_status",
     title: "Inspect a computer",
-    description: "READ ONLY: Read live Currybox process/runtime status and the declared container profile contract for an opened computer. This cannot modify files, processes, checkpoints, or Thread state; use get_computer on the Arbor surface for durable config and snapshot lineage.",
+    description: "READ ONLY: Read what this computer can do right now — the same resolved capabilities card computer_open returns, each entry ready or available — plus live Currybox process/runtime status and the declared container profile contract. Reach for it when you are unsure whether a capability — background processes, semantic code intelligence, Preview publication — is usable on this session. This cannot modify files, processes, checkpoints, or Thread state; use get_computer on the Arbor surface for durable config and snapshot lineage.",
     inputSchema: {
       computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…")
     },
@@ -18011,6 +18088,71 @@ var ACTION_DEFINITIONS = [
     toolset: "loop",
     run: forward("computer_runtime.verify")
   },
+  {
+    name: "code_symbols",
+    title: "Outline a file's symbols",
+    description: "Outline the symbols a file or directory defines, resolved by the project's language server. Reach for this before reading a large unfamiliar file — unlike a grep through `computer_exec`, it returns the real declarations with their kinds rather than every textual match. Needs the semantic-code capability shown on the computer_status card.",
+    inputSchema: {
+      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
+      path: exports_external.string().max(512).describe("file or directory, absolute under /workspace or workspace-relative")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_code.symbols")
+  },
+  {
+    name: "code_find_symbol",
+    title: "Find a symbol by name path",
+    description: "Locate a declaration by its name path (`ClassName/methodName`) and optionally return its body. Use it instead of a `computer_exec` grep when you want THE definition rather than every line mentioning the name; the language server distinguishes the declaration from its call sites and its string occurrences. Needs the semantic-code capability shown on the computer_status card.",
+    inputSchema: {
+      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
+      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"),
+      depth: exports_external.number().int().min(0).max(3).optional().describe("how many levels of children to include (default 0)")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_code.find_symbol")
+  },
+  {
+    name: "code_references",
+    title: "Find what references a symbol",
+    description: 'List the places that actually reference a symbol, each with a short snippet. This is the operation `computer_exec` cannot do: a text search finds the same identifier in comments, unrelated modules, and shadowed scopes, while the language server resolves real references — so it answers "is this safe to change". Needs the semantic-code capability shown on the computer_status card.',
+    inputSchema: {
+      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
+      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")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_code.references")
+  },
+  {
+    name: "code_implementations",
+    title: "Find implementations of a symbol",
+    description: "List the concrete implementations or subtypes of an interface, abstract type, or method. A `computer_exec` search cannot follow a type relationship — only the language server knows which declarations satisfy this one. Needs the semantic-code capability shown on the computer_status card.",
+    inputSchema: {
+      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
+      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")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_code.implementations")
+  },
+  {
+    name: "code_diagnostics",
+    title: "Read language-server diagnostics for a file",
+    description: "Return the language server's live errors and warnings for one file, mapped to symbols. Reach for it on a file you just edited: it answers in seconds without the whole-project build a `computer_exec` typecheck runs, though a green result here is not a substitute for that build. Needs the semantic-code capability shown on the computer_status card.",
+    inputSchema: {
+      computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
+      path: exports_external.string().max(512).describe("the file to inspect, absolute under /workspace or workspace-relative")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_code.diagnostics")
+  },
   {
     name: "computer_read",
     title: "Read a project file",
@@ -18097,7 +18239,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_pull",
     title: "Fast-forward an allowed repository",
-    description: "Fetch and fast-forward the checked-out branch of a cloned recipe repository; divergent history, a dirty working tree, and anything needing a merge are rejected rather than forced. OMIT githubToken and Arbor pulls with its own managed recipe credential after rechecking the repository connection — the way a restored computer reaches current history. Supply githubToken instead to pull as the collaborator. Neither credential is stored or returned.",
+    description: "Fetch and fast-forward the checked-out branch of a cloned recipe repository; divergent history, a dirty working tree, and anything needing a merge are rejected rather than forced. A returned pull also PROVES the branch's remote-tracking ref reached the fetched tip and reports it as remoteTracking, so ordinary `git status` and `git log origin/<branch>` stay true instead of showing a level checkout as ahead; if that cannot be proven the call fails as retryable with the landed fast-forward attached, rather than reporting a truthful pull it did not verify. remoteTracking.updated is false only when the checked-out branch does not track this repository at all. OMIT githubToken and Arbor pulls with its own managed recipe credential after rechecking the repository connection — the way a restored computer reaches current history. Supply githubToken instead to pull as the collaborator. Neither credential is stored or returned.",
     inputSchema: {
       computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
       repository: exports_external.string().describe("allowed owner/repository slug already cloned"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "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",