@nyte-ai/host 0.0.25-beta.1 → 0.0.25-nightly.20261025.2

package/THIRD-PARTY-NOTICES.md

@@ -55,6 +55,11 @@ SOFTWARE.
   `@earendil-works/pi-codemode` 1.0.0 supply the MCP client and QuickJS
   executor. Tool discovery and code-mode integration are adapted from commit
   `86dfceec402ad77e563bf4feab5f26c42d5f5db6`.
+- BM25 tool search (`tool_search`, `searchTools()`), tool namespaces with
+  `describeNamespace()`, the budgeted codemode listing and the one-line MCP
+  server summary (`packages/plugin/src/tool-search.ts`,
+  `packages/plugin/src/codemode.ts`, `packages/core/src/builtins/mcp.ts`) are
+  ported from commit `d5b3de22d0e24a3e9c38a9410d3329b099717283`.
 - Transcript reconciliation, checkpoint instruction snapshots, provider system
   updates, and cache warming are ported from the 1.0.0 release commit
   `a13d35a742c6ef8462812a28fbe1d8c8b7431c32`.
@@ -312,11 +317,14 @@ Copyright 2025 OpenAI
   front of the queue (`packages/tui/src/model/interactions.ts`) is its
   `onEmptySubmit`. The rename
   plugin's context construction, prompt, model fallback, and output cleanup
-  (`packages/plugin/src/rename.ts`) port OpenCode v2. The web-search
-  plugin set (`packages/plugin/src/web-search.ts`) ports its Exa, Firecrawl,
-  Parallel, and Tavily adapters, its stateless MCP `tools/call` transport and
-  response bounds, its result and error vocabulary, and its arrangement of one
-  plugin per provider from OpenCode v2.
+  (`packages/plugin/src/rename.ts`) port OpenCode v2. The web plugin
+  (`packages/plugin/src/web/`) ports OpenCode v2's web search and fetch tools:
+  the search provider registry any plugin can add to (`searchProviders` in
+  `packages/core/src/contract/plugin.ts`), its Exa, Firecrawl, Parallel, and
+  Tavily adapters, their stateless MCP `tools/call` transport and response
+  bounds, the result and error vocabulary, `web_fetch`'s Accept headers,
+  Cloudflare-challenge retry and size limits, and the streaming HTML-to-Markdown
+  and HTML-to-text converters (`packages/plugin/src/web/html-markdown.ts`).
 - Core's ripgrep resolver and search adapter (`packages/core/src/ripgrep.ts`,
   `packages/core/src/ripgrep/binary.ts`) and filename search
   (`packages/core/src/file-search.ts`) adapt OpenCode v2's core implementation.

package/dist/chunks/{canvas-preview-gh7c9831.js → canvas-preview-27v3zkz4.js}

@@ -21,7 +21,7 @@ import {
   checkToolSchemas2,
   TracingMcpClient2,
   bridgeTools2
-} from "./canvas-preview-vaatfznm.js";
+} from "./canvas-preview-ez9zdfq4.js";
 
 // src/mcp/hub.ts
 import { join } from "node:path";
@@ -206,7 +206,11 @@ function hub(input) {
       state: () => state,
       brief: () => ({
         name: entry.name,
+        description: link.entry.description,
         instructions: listed?.instructions ?? null,
+        exposures: [
+          ...new Set([link.entry.exposure, ...link.entry.toolExposure.map((pair) => pair[1])])
+        ],
         unavailable: listed === null && (state.kind === "failed" || state.kind === "needs-sign-in") ? state.kind : null
       }),
       challenge: () => challenge,
@@ -217,7 +221,7 @@ function hub(input) {
           bridged = {
             entry: link.entry,
             listed,
-            tools: bridgeTools2(link.entry, listed.tools, call)
+            tools: bridgeTools2(link.entry, listed, call)
           };
         return bridged.tools;
       },

package/dist/chunks/{canvas-preview-dt89p9pm.js → canvas-preview-3kmevzjy.js}

@@ -12,7 +12,7 @@ import {
 } from "./canvas-preview-8xc0vn7v.js";
 import {
   localProvider2
-} from "./canvas-preview-9bxhwjrh.js";
+} from "./canvas-preview-dr46h8mm.js";
 import {
   importLegacyTrust2
 } from "./canvas-preview-9aqczacs.js";
@@ -21,13 +21,13 @@ import {
 } from "./canvas-preview-4e0pxa32.js";
 import {
   listen2
-} from "./canvas-preview-8sv3j0vt.js";
+} from "./canvas-preview-sdvgxnpf.js";
 import {
   nodeImages2
 } from "./canvas-preview-y5y6ghaw.js";
 import {
   createMcpHub2
-} from "./canvas-preview-gh7c9831.js";
+} from "./canvas-preview-27v3zkz4.js";
 import {
   loadPluginDirectory2,
   pluginLoader2
@@ -65,12 +65,14 @@ import openaiAstraContext from "@nyte-ai/plugin/core/openai-astra-context";
 import { openaiCompaction } from "@nyte-ai/plugin/core/openai-compaction";
 import question from "@nyte-ai/plugin/core/question";
 import rename from "@nyte-ai/plugin/core/rename";
+import subagents from "@nyte-ai/plugin/core/subagents";
 import telemetry from "@nyte-ai/plugin/core/telemetry";
-import webSearch from "@nyte-ai/plugin/core/web-search";
+import toolSearch from "@nyte-ai/plugin/core/tool-search";
+import web from "@nyte-ai/plugin/core/web";
 // package.json
 var package_default = {
   name: "@nyte-ai/host",
-  version: "0.0.25-beta.1",
+  version: "0.0.25-nightly.20261025.2",
   private: false,
   license: "MIT",
   repository: {
@@ -251,9 +253,11 @@ async function composeOpen(options, input) {
     approvals,
     question,
     rename,
+    subagents,
     bashDescription,
-    webSearch,
+    web,
     codemode,
+    toolSearch,
     openaiCompaction(models),
     openaiAstraContext,
     telemetry,

package/dist/chunks/{canvas-preview-da6dwy05.js → canvas-preview-4rstzyd7.js}

@@ -1,6 +1,6 @@
 import {
   createHandler2
-} from "./canvas-preview-1r9sgbj3.js";
+} from "./canvas-preview-75bmwhsr.js";
 
 // src/listen-fetch.ts
 import { SdkError } from "@nyte-ai/schema";

package/dist/chunks/{canvas-preview-1r9sgbj3.js → canvas-preview-75bmwhsr.js}

@@ -1,6 +1,6 @@
 import {
   bindConnection2
-} from "./canvas-preview-2yzyt077.js";
+} from "./canvas-preview-tq7ny7fm.js";
 import {
   createStreamChannels2
 } from "./canvas-preview-rp4x6y1h.js";

package/dist/chunks/{canvas-preview-9bxhwjrh.js → canvas-preview-dr46h8mm.js}

@@ -21,7 +21,7 @@ import {
 } from "./canvas-preview-crmzxxt8.js";
 import {
   localWorktrees2
-} from "./canvas-preview-bg63k8n7.js";
+} from "./canvas-preview-z2xdr07w.js";
 
 // src/local/provider.ts
 import { constants, realpathSync } from "node:fs";

package/dist/chunks/{canvas-preview-vaatfznm.js → canvas-preview-ez9zdfq4.js}

@@ -59,13 +59,21 @@ class TracingMcpClient2 extends McpClient {
     return super.request(method, traceparent === null || params?._meta !== undefined ? params : { ...params, _meta: { traceparent } }, options);
   }
 }
-function bridgeTools2(entry, tools, call) {
-  const names = tools.map((tool) => toolName(entry.name, tool.name));
+function bridgeTools2(entry, listed, call) {
+  const names = listed.tools.map((tool) => toolName(entry.name, tool.name));
   const counts = Map.groupBy(names, (name) => name);
-  return tools.map((tool, index) => {
+  const description = entry.description?.trim() ?? "";
+  const instructions = listed.instructions?.trim() ?? "";
+  const namespace = {
+    name: `mcp__${entry.name}`.replace(/[^A-Za-z0-9_]/g, "_"),
+    aliases: [entry.name],
+    ...description === "" ? {} : { description },
+    ...instructions === "" ? {} : { instructions }
+  };
+  return listed.tools.map((tool, index) => {
     const name = names[index];
     const unique = (counts.get(name)?.length ?? 0) > 1 ? hashed(name, tool.name) : name;
-    return bridge(entry, tool, call, unique);
+    return bridge(entry, tool, call, unique, namespace);
   });
 }
 function toolName(server, tool) {
@@ -82,14 +90,15 @@ function globMatches(pattern, value) {
   const source = pattern.split("*").map((part) => part.replace(/[.+?^${}()|[\]\\]/g, "\\$&")).join(".*");
   return new RegExp(`^${source}$`).test(value);
 }
-function bridge(entry, tool, call, name) {
+function bridge(entry, tool, call, name, namespace) {
   const output = tool.outputSchema;
+  const exposure = toolExposure2(entry, tool.name);
   const definition = {
     name,
-    namespace: `mcp/${entry.name}`,
+    namespace,
     description: tool.description ?? tool.title ?? tool.name,
     parameters: passthrough(tool.inputSchema),
-    exposure: toolExposure2(entry, tool.name),
+    exposure: exposure === "code" ? "deferred" : exposure,
     class: () => ({ kind: "custom", label: `${entry.name}: ${tool.title ?? tool.name}` }),
     effects: tool.annotations?.readOnlyHint === true ? "none" : "workspace",
     replay: tool.annotations?.readOnlyHint === true || tool.annotations?.idempotentHint === true ? "safe" : "never",

package/dist/chunks/{canvas-preview-8sv3j0vt.js → canvas-preview-sdvgxnpf.js}

@@ -1,6 +1,6 @@
 import {
   listenFetch2
-} from "./canvas-preview-da6dwy05.js";
+} from "./canvas-preview-4rstzyd7.js";
 
 // src/listen.ts
 import { createServer } from "node:http";

package/dist/chunks/{canvas-preview-2yzyt077.js → canvas-preview-tq7ny7fm.js}

@@ -116,6 +116,7 @@ function bindConnection2(connection, options) {
     "workspaces.inspect": ({ target }) => connection.workspaces.inspect(target),
     "workspaces.add": ({ target, options }) => connection.workspaces.add(target, options),
     "workspaces.forget": ({ id }) => connection.workspaces.forget(id),
+    "workspaces.cleanWorktrees": () => connection.workspaces.cleanWorktrees(),
     "sessions.watch": async (input) => sessionsFrames(connection.sessions.watch(input)),
     "sessions.start": async (input) => {
       const { session, receipt } = await connection.sessions.start(input);

package/dist/chunks/{canvas-preview-bg63k8n7.js → canvas-preview-z2xdr07w.js}

@@ -53,6 +53,21 @@ var TYPE_WORDS = new Set([
   "revert",
   "update"
 ]);
+var REGENERABLE = new Set([
+  "node_modules",
+  ".turbo",
+  ".next",
+  ".nuxt",
+  ".svelte-kit",
+  ".vite",
+  ".parcel-cache",
+  "dist",
+  "build",
+  "coverage",
+  "target",
+  ".venv",
+  "__pycache__"
+]);
 var MAX_ATTEMPTS = 100;
 function gitCommand(binary = "git") {
   return async (cwd, args, env) => {
@@ -115,8 +130,8 @@ function localWorktrees2(options) {
   };
   const claimBranch = async (root, parent, listed, input, head) => {
     for (let attempt = 1;attempt <= MAX_ATTEMPTS; attempt++) {
-      const branch = branchName(input.title, attempt);
-      const folder = join(parent, branch);
+      const branch = `${input.prefix ?? ""}${branchName(input.title, attempt)}`;
+      const folder = join(parent, branch.replaceAll("/", "-"));
       if (listed.some((worktree) => worktree.path === folder) || await stat(folder).catch(() => null) !== null)
         continue;
       const [created] = await Promise.allSettled([
@@ -168,7 +183,7 @@ function localWorktrees2(options) {
       const realParent = await realpath(parent);
       const branch = claimed ?? await claimBranch(repo.root, realParent, listed, input, head);
       const base = claimed === null ? head : await commitAt(repo.root, `refs/heads/${claimed}`) ?? head;
-      const folder = join(realParent, branch);
+      const folder = join(realParent, branch.replaceAll("/", "-"));
       const tree = await workingTree(repo);
       await addWorktree2(repo.root, { path: folder, branch }, options);
       if (tree !== (await git(folder, ["rev-parse", "HEAD^{tree}"])).trim()) {
@@ -196,6 +211,25 @@ function localWorktrees2(options) {
         return { folder: "removed", branch: "kept" };
       await git(common, ["branch", "-D", worktree.branch]);
       return { folder: "removed", branch: "deleted" };
+    },
+    async clean(target) {
+      const path = "path" in target ? target.path : null;
+      if (path === null || await stat(path).catch(() => null) === null)
+        return false;
+      const root = (await git(path, ["rev-parse", "--show-toplevel"])).trim();
+      const within = await realpath(folders).catch(() => null);
+      if (within === null || !root.startsWith(`${within}/`))
+        return false;
+      const status = await git(root, [
+        "status",
+        "--porcelain",
+        "--ignored=traditional",
+        "--untracked-files=normal",
+        "-z"
+      ]);
+      const regenerable = status.split("\x00").filter((entry) => entry.startsWith("!! ") && entry.endsWith("/")).map((entry) => entry.slice(3, -1)).filter((folder) => REGENERABLE.has(basename(folder)));
+      await Promise.all(regenerable.map((folder) => rm(join(root, folder), { recursive: true, force: true })));
+      return regenerable.length > 0;
     }
   };
 }

package/dist/src/index.js

@@ -11,15 +11,15 @@ import"../chunks/canvas-preview-wg80rbc2.js";
 import {
   identitySigner2
 } from "../chunks/canvas-preview-5mex725c.js";
-import"../chunks/canvas-preview-2yzyt077.js";
+import"../chunks/canvas-preview-tq7ny7fm.js";
 import"../chunks/canvas-preview-rp4x6y1h.js";
-import"../chunks/canvas-preview-1r9sgbj3.js";
+import"../chunks/canvas-preview-75bmwhsr.js";
 import {
   listenFetch2
-} from "../chunks/canvas-preview-da6dwy05.js";
+} from "../chunks/canvas-preview-4rstzyd7.js";
 import {
   listen2
-} from "../chunks/canvas-preview-8sv3j0vt.js";
+} from "../chunks/canvas-preview-sdvgxnpf.js";
 import"../chunks/canvas-preview-0nq75h9k.js";
 import"../chunks/canvas-preview-bxnqt8cd.js";
 import"../chunks/canvas-preview-yjz0f7n4.js";
@@ -51,17 +51,17 @@ import {
   addWorktree2,
   hasBranch2,
   localWorktrees2
-} from "../chunks/canvas-preview-bg63k8n7.js";
+} from "../chunks/canvas-preview-z2xdr07w.js";
 import {
   localProvider2
-} from "../chunks/canvas-preview-9bxhwjrh.js";
+} from "../chunks/canvas-preview-dr46h8mm.js";
 import"../chunks/canvas-preview-kdqgrstc.js";
 import"../chunks/canvas-preview-5z63am63.js";
 import"../chunks/canvas-preview-pkzqg96v.js";
-import"../chunks/canvas-preview-vaatfznm.js";
+import"../chunks/canvas-preview-ez9zdfq4.js";
 import {
   createMcpHub2
-} from "../chunks/canvas-preview-gh7c9831.js";
+} from "../chunks/canvas-preview-27v3zkz4.js";
 import"../chunks/canvas-preview-9aqczacs.js";
 import"../chunks/canvas-preview-4e0pxa32.js";
 import"../chunks/canvas-preview-befkjea2.js";
@@ -84,7 +84,7 @@ import {
 } from "../chunks/canvas-preview-mstbvwz3.js";
 import {
   openHost2
-} from "../chunks/canvas-preview-dt89p9pm.js";
+} from "../chunks/canvas-preview-3kmevzjy.js";
 import {
   postgresStore2
 } from "../chunks/canvas-preview-4b6sayhg.js";

package/dist/src/listen-fetch.js

@@ -1,8 +1,8 @@
 import {
   listenFetch2
-} from "../chunks/canvas-preview-da6dwy05.js";
-import"../chunks/canvas-preview-1r9sgbj3.js";
-import"../chunks/canvas-preview-2yzyt077.js";
+} from "../chunks/canvas-preview-4rstzyd7.js";
+import"../chunks/canvas-preview-75bmwhsr.js";
+import"../chunks/canvas-preview-tq7ny7fm.js";
 import"../chunks/canvas-preview-rp4x6y1h.js";
 export {
   listenFetch2 as listenFetch

package/dist/src/listen.js

@@ -1,9 +1,9 @@
 import {
   listen2
-} from "../chunks/canvas-preview-8sv3j0vt.js";
-import"../chunks/canvas-preview-da6dwy05.js";
-import"../chunks/canvas-preview-1r9sgbj3.js";
-import"../chunks/canvas-preview-2yzyt077.js";
+} from "../chunks/canvas-preview-sdvgxnpf.js";
+import"../chunks/canvas-preview-4rstzyd7.js";
+import"../chunks/canvas-preview-75bmwhsr.js";
+import"../chunks/canvas-preview-tq7ny7fm.js";
 import"../chunks/canvas-preview-rp4x6y1h.js";
 export {
   listen2 as listen

package/dist/src/local/provider.js

@@ -1,7 +1,7 @@
 import {
   localProvider2
-} from "../../chunks/canvas-preview-9bxhwjrh.js";
-import"../../chunks/canvas-preview-bg63k8n7.js";
+} from "../../chunks/canvas-preview-dr46h8mm.js";
+import"../../chunks/canvas-preview-z2xdr07w.js";
 import"../../chunks/canvas-preview-5ekjx6sw.js";
 import"../../chunks/canvas-preview-8xc0vn7v.js";
 import"../../chunks/canvas-preview-1sq7z9jq.js";

package/dist/src/local/worktrees.js

@@ -3,7 +3,7 @@ import {
   addWorktree2,
   hasBranch2,
   localWorktrees2
-} from "../../chunks/canvas-preview-bg63k8n7.js";
+} from "../../chunks/canvas-preview-z2xdr07w.js";
 import"../../chunks/canvas-preview-bxnqt8cd.js";
 export {
   addWorktree2 as addWorktree,

package/dist/src/mcp/hub.js

@@ -1,9 +1,9 @@
 import {
   createMcpHub2
-} from "../../chunks/canvas-preview-gh7c9831.js";
+} from "../../chunks/canvas-preview-27v3zkz4.js";
 import"../../chunks/canvas-preview-pkzqg96v.js";
 import"../../chunks/canvas-preview-5z63am63.js";
-import"../../chunks/canvas-preview-vaatfznm.js";
+import"../../chunks/canvas-preview-ez9zdfq4.js";
 import"../../chunks/canvas-preview-kdqgrstc.js";
 import"../../chunks/canvas-preview-mgcx2b2p.js";
 export {

package/dist/src/mcp/tools.d.ts

@@ -25,5 +25,12 @@ export type McpCall = (name: string, args: Record<string, unknown>, options: Mcp
 export declare class TracingMcpClient extends McpClient {
     request<Result = unknown>(method: string, params?: Record<string, unknown>, options?: McpRequestOptions): Promise<Result>;
 }
-/** Turns a server's listed tools into session tools named `mcp__<server>__<tool>`. */
-export declare function bridgeTools(entry: McpServerEntry, tools: readonly Tool[], call: McpCall): ToolDefinition[];
+/**
+ * Turns a server's listed tools into session tools named
+ * `mcp__<server>__<tool>`, in the namespace `mcp__<server>` (alias
+ * `<server>`) that carries the server's description and instructions.
+ */
+export declare function bridgeTools(entry: McpServerEntry, listed: {
+    readonly tools: readonly Tool[];
+    readonly instructions: string | null;
+}, call: McpCall): ToolDefinition[];

package/dist/src/mcp/tools.js

@@ -3,7 +3,7 @@ import {
   checkToolSchemas2,
   TracingMcpClient2,
   bridgeTools2
-} from "../../chunks/canvas-preview-vaatfznm.js";
+} from "../../chunks/canvas-preview-ez9zdfq4.js";
 export {
   TracingMcpClient2 as TracingMcpClient,
   bridgeTools2 as bridgeTools,

package/dist/src/open.js

@@ -1,23 +1,23 @@
 import {
   openHost2
-} from "../chunks/canvas-preview-dt89p9pm.js";
+} from "../chunks/canvas-preview-3kmevzjy.js";
 import"../chunks/canvas-preview-4e0pxa32.js";
 import"../chunks/canvas-preview-y5y6ghaw.js";
 import"../chunks/canvas-preview-ec2mt7es.js";
 import"../chunks/canvas-preview-befkjea2.js";
 import"../chunks/canvas-preview-9aqczacs.js";
-import"../chunks/canvas-preview-9bxhwjrh.js";
-import"../chunks/canvas-preview-bg63k8n7.js";
+import"../chunks/canvas-preview-dr46h8mm.js";
+import"../chunks/canvas-preview-z2xdr07w.js";
 import"../chunks/canvas-preview-5ekjx6sw.js";
 import"../chunks/canvas-preview-8xc0vn7v.js";
 import"../chunks/canvas-preview-1sq7z9jq.js";
 import"../chunks/canvas-preview-vm9zdp2t.js";
 import"../chunks/canvas-preview-crmzxxt8.js";
 import"../chunks/canvas-preview-tjhabynd.js";
-import"../chunks/canvas-preview-gh7c9831.js";
+import"../chunks/canvas-preview-27v3zkz4.js";
 import"../chunks/canvas-preview-pkzqg96v.js";
 import"../chunks/canvas-preview-5z63am63.js";
-import"../chunks/canvas-preview-vaatfznm.js";
+import"../chunks/canvas-preview-ez9zdfq4.js";
 import"../chunks/canvas-preview-drctegz4.js";
 import"../chunks/canvas-preview-kn7kvbfj.js";
 import"../chunks/canvas-preview-yjz0f7n4.js";
@@ -26,10 +26,10 @@ import"../chunks/canvas-preview-s94ebwf5.js";
 import"../chunks/canvas-preview-kdqgrstc.js";
 import"../chunks/canvas-preview-mstbvwz3.js";
 import"../chunks/canvas-preview-zaaj99wd.js";
-import"../chunks/canvas-preview-8sv3j0vt.js";
-import"../chunks/canvas-preview-da6dwy05.js";
-import"../chunks/canvas-preview-1r9sgbj3.js";
-import"../chunks/canvas-preview-2yzyt077.js";
+import"../chunks/canvas-preview-sdvgxnpf.js";
+import"../chunks/canvas-preview-4rstzyd7.js";
+import"../chunks/canvas-preview-75bmwhsr.js";
+import"../chunks/canvas-preview-tq7ny7fm.js";
 import"../chunks/canvas-preview-rp4x6y1h.js";
 import"../chunks/canvas-preview-skzwvw4d.js";
 import"../chunks/canvas-preview-bxnqt8cd.js";

package/dist/src/serve/binding.js

@@ -1,6 +1,6 @@
 import {
   bindConnection2
-} from "../../chunks/canvas-preview-2yzyt077.js";
+} from "../../chunks/canvas-preview-tq7ny7fm.js";
 export {
   bindConnection2 as bindConnection
 };

package/dist/src/serve/handler.js

@@ -1,7 +1,7 @@
 import {
   createHandler2
-} from "../../chunks/canvas-preview-1r9sgbj3.js";
-import"../../chunks/canvas-preview-2yzyt077.js";
+} from "../../chunks/canvas-preview-75bmwhsr.js";
+import"../../chunks/canvas-preview-tq7ny7fm.js";
 import"../../chunks/canvas-preview-rp4x6y1h.js";
 export {
   createHandler2 as createHandler

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nyte-ai/host",
-  "version": "0.0.25-beta.1",
+  "version": "0.0.25-nightly.20261025.2",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -88,11 +88,11 @@
   "dependencies": {
     "@earendil-works/pi-mcp": "^1.3.0",
     "@lydell/node-pty": "^1.2.0-beta.15",
-    "@nyte-ai/ai": "0.0.25-beta.1",
-    "@nyte-ai/core": "0.0.25-beta.1",
-    "@nyte-ai/plugin": "0.0.25-beta.1",
-    "@nyte-ai/protocol": "0.0.25-beta.1",
-    "@nyte-ai/schema": "0.0.25-beta.1",
+    "@nyte-ai/ai": "0.0.25-nightly.20261025.2",
+    "@nyte-ai/core": "0.0.25-nightly.20261025.2",
+    "@nyte-ai/plugin": "0.0.25-nightly.20261025.2",
+    "@nyte-ai/protocol": "0.0.25-nightly.20261025.2",
+    "@nyte-ai/schema": "0.0.25-nightly.20261025.2",
     "@silvia-odwyer/photon": "^0.3.3",
     "fflate": "^0.8.3",
     "ignore": "^7.0.13",

package/src/local/worktrees.ts

@@ -57,6 +57,22 @@ const TYPE_WORDS = new Set([
   "update",
 ]);
 
+const REGENERABLE = new Set([
+  "node_modules",
+  ".turbo",
+  ".next",
+  ".nuxt",
+  ".svelte-kit",
+  ".vite",
+  ".parcel-cache",
+  "dist",
+  "build",
+  "coverage",
+  "target",
+  ".venv",
+  "__pycache__",
+]);
+
 /** How many names `create` tries before giving up: `<words>`, then `<two words>-2` up to this. */
 const MAX_ATTEMPTS = 100;
 
@@ -207,12 +223,12 @@ export function localWorktrees(options?: {
     root: string,
     parent: string,
     listed: readonly ListedWorktree[],
-    input: { readonly name: string; readonly title: string | null },
+    input: { readonly name: string; readonly title: string | null; readonly prefix?: string },
     head: string,
   ): Promise<string> => {
     for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
-      const branch = branchName(input.title, attempt);
-      const folder = join(parent, branch);
+      const branch = `${input.prefix ?? ""}${branchName(input.title, attempt)}`;
+      const folder = join(parent, branch.replaceAll("/", "-"));
 
       if (
         listed.some((worktree) => worktree.path === folder) ||
@@ -292,7 +308,7 @@ export function localWorktrees(options?: {
       const base =
         claimed === null ? head : ((await commitAt(repo.root, `refs/heads/${claimed}`)) ?? head);
 
-      const folder = join(realParent, branch);
+      const folder = join(realParent, branch.replaceAll("/", "-"));
       const tree = await workingTree(repo);
 
       await addWorktree(repo.root, { path: folder, branch }, options);
@@ -334,6 +350,35 @@ export function localWorktrees(options?: {
 
       return { folder: "removed", branch: "deleted" };
     },
+    async clean(target) {
+      const path = "path" in target ? target.path : null;
+
+      if (path === null || (await stat(path).catch(() => null)) === null) return false;
+      const root = (await git(path, ["rev-parse", "--show-toplevel"])).trim();
+      const within = await realpath(folders).catch(() => null);
+
+      if (within === null || !root.startsWith(`${within}/`)) return false;
+
+      const status = await git(root, [
+        "status",
+        "--porcelain",
+        "--ignored=traditional",
+        "--untracked-files=normal",
+        "-z",
+      ]);
+
+      const regenerable = status
+        .split("\0")
+        .filter((entry) => entry.startsWith("!! ") && entry.endsWith("/"))
+        .map((entry) => entry.slice(3, -1))
+        .filter((folder) => REGENERABLE.has(basename(folder)));
+
+      await Promise.all(
+        regenerable.map((folder) => rm(join(root, folder), { recursive: true, force: true })),
+      );
+
+      return regenerable.length > 0;
+    },
   };
 }
 

package/src/mcp/hub.ts

@@ -303,7 +303,11 @@ function hub(input: {
       state: () => state,
       brief: () => ({
         name: entry.name,
+        description: link.entry.description,
         instructions: listed?.instructions ?? null,
+        exposures: [
+          ...new Set([link.entry.exposure, ...link.entry.toolExposure.map((pair) => pair[1])]),
+        ],
         unavailable:
           listed === null && (state.kind === "failed" || state.kind === "needs-sign-in")
             ? state.kind
@@ -317,7 +321,7 @@ function hub(input: {
           bridged = {
             entry: link.entry,
             listed,
-            tools: bridgeTools(link.entry, listed.tools, call),
+            tools: bridgeTools(link.entry, listed, call),
           };
 
         return bridged.tools;

package/src/mcp/tools.ts

@@ -7,7 +7,7 @@ import type {
   Tool,
 } from "@earendil-works/pi-mcp";
 import { followedTrace, startSpan, traceparent } from "@nyte-ai/core";
-import type { ExecutionEnv, ToolDefinition } from "@nyte-ai/core";
+import type { ExecutionEnv, ToolDefinition, ToolNamespace } from "@nyte-ai/core";
 import { isJson, isJsonObject } from "@nyte-ai/schema";
 import type {
   Json,
@@ -142,20 +142,33 @@ export class TracingMcpClient extends McpClient {
   }
 }
 
-/** Turns a server's listed tools into session tools named `mcp__<server>__<tool>`. */
+/**
+ * Turns a server's listed tools into session tools named
+ * `mcp__<server>__<tool>`, in the namespace `mcp__<server>` (alias
+ * `<server>`) that carries the server's description and instructions.
+ */
 export function bridgeTools(
   entry: McpServerEntry,
-  tools: readonly Tool[],
+  listed: { readonly tools: readonly Tool[]; readonly instructions: string | null },
   call: McpCall,
 ): ToolDefinition[] {
-  const names = tools.map((tool) => toolName(entry.name, tool.name));
+  const names = listed.tools.map((tool) => toolName(entry.name, tool.name));
   const counts = Map.groupBy(names, (name) => name);
+  const description = entry.description?.trim() ?? "";
+  const instructions = listed.instructions?.trim() ?? "";
+
+  const namespace: ToolNamespace = {
+    name: `mcp__${entry.name}`.replace(/[^A-Za-z0-9_]/g, "_"),
+    aliases: [entry.name],
+    ...(description === "" ? {} : { description }),
+    ...(instructions === "" ? {} : { instructions }),
+  };
 
-  return tools.map((tool, index) => {
+  return listed.tools.map((tool, index) => {
     const name = names[index];
     const unique = (counts.get(name)?.length ?? 0) > 1 ? hashed(name, tool.name) : name;
 
-    return bridge(entry, tool, call, unique);
+    return bridge(entry, tool, call, unique, namespace);
   });
 }
 
@@ -182,20 +195,23 @@ function globMatches(pattern: string, value: string): boolean {
   return new RegExp(`^${source}$`).test(value);
 }
 
+/** One listed tool as a session tool. Codemode's go unlisted like `deferred` ones; the session's prompt names their server instead. */
 function bridge(
   entry: McpServerEntry,
   tool: Tool,
   call: McpCall,
   name: string,
+  namespace: ToolNamespace,
 ): ToolDefinition<JsonObject> {
   const output = tool.outputSchema;
+  const exposure = toolExposure(entry, tool.name);
 
   const definition: ToolDefinition<JsonObject> = {
     name,
-    namespace: `mcp/${entry.name}`,
+    namespace,
     description: tool.description ?? tool.title ?? tool.name,
     parameters: passthrough(tool.inputSchema),
-    exposure: toolExposure(entry, tool.name),
+    exposure: exposure === "code" ? "deferred" : exposure,
     class: () => ({ kind: "custom", label: `${entry.name}: ${tool.title ?? tool.name}` }),
     effects: tool.annotations?.readOnlyHint === true ? "none" : "workspace",
     replay:

package/src/open.ts

@@ -32,8 +32,10 @@ import openaiAstraContext from "@nyte-ai/plugin/core/openai-astra-context";
 import { openaiCompaction } from "@nyte-ai/plugin/core/openai-compaction";
 import question from "@nyte-ai/plugin/core/question";
 import rename from "@nyte-ai/plugin/core/rename";
+import subagents from "@nyte-ai/plugin/core/subagents";
 import telemetry from "@nyte-ai/plugin/core/telemetry";
-import webSearch from "@nyte-ai/plugin/core/web-search";
+import toolSearch from "@nyte-ai/plugin/core/tool-search";
+import web from "@nyte-ai/plugin/core/web";
 import manifest from "../package.json" with { type: "json" };
 import { credentialStore } from "./credentials.ts";
 import { identitySigner } from "./identity-key.ts";
@@ -125,9 +127,11 @@ async function composeOpen(
     approvals,
     question,
     rename,
+    subagents,
     bashDescription,
-    webSearch,
+    web,
     codemode,
+    toolSearch,
     openaiCompaction(models),
     openaiAstraContext,
     telemetry,

package/src/serve/binding.ts

@@ -255,6 +255,7 @@ export function bindConnection(connection: Connection, options: BindingOptions):
     "workspaces.inspect": ({ target }) => connection.workspaces.inspect(target),
     "workspaces.add": ({ target, options }) => connection.workspaces.add(target, options),
     "workspaces.forget": ({ id }) => connection.workspaces.forget(id),
+    "workspaces.cleanWorktrees": () => connection.workspaces.cleanWorktrees(),
 
     "sessions.watch": async (input) => sessionsFrames(connection.sessions.watch(input)),
     "sessions.start": async (input) => {