@agent-native/core 0.7.19 → 0.7.21

package/dist/agent/thread-data-builder.js

@@ -6,6 +6,17 @@
 export function buildAssistantMessage(events, runId) {
     const content = [];
     let toolCallCounter = 0;
+    let loopLimit = null;
+    let runError = null;
+    const appendText = (text) => {
+        const last = content[content.length - 1];
+        if (last && last.type === "text") {
+            last.text = (last.text ?? "") + text;
+        }
+        else {
+            content.push({ type: "text", text });
+        }
+    };
     for (const { event } of events) {
         if (event.type === "clear") {
             content.length = 0;
@@ -13,13 +24,7 @@ export function buildAssistantMessage(events, runId) {
             continue;
         }
         if (event.type === "text") {
-            const last = content[content.length - 1];
-            if (last && last.type === "text") {
-                last.text = (last.text ?? "") + (event.text ?? "");
-            }
-            else {
-                content.push({ type: "text", text: event.text ?? "" });
-            }
+            appendText(event.text ?? "");
             continue;
         }
         if (event.type === "tool_start") {
@@ -46,16 +51,53 @@ export function buildAssistantMessage(events, runId) {
             }
             continue;
         }
-        // done, error, missing_api_key, loop_limit — terminal signals, not content
+        if (event.type === "loop_limit") {
+            loopLimit = {
+                ...(event.maxIterations ? { maxIterations: event.maxIterations } : {}),
+            };
+            appendText(`${content.length > 0 ? "\n\n" : ""}${event.maxIterations
+                ? `I reached the ${event.maxIterations}-step limit before finishing.`
+                : "I reached the step limit before finishing."}`);
+            continue;
+        }
+        if (event.type === "error") {
+            runError = {
+                message: event.error,
+                ...(event.errorCode ? { errorCode: event.errorCode } : {}),
+                ...(event.details ? { details: event.details } : {}),
+                ...(event.recoverable ? { recoverable: event.recoverable } : {}),
+            };
+            appendText(`${content.length > 0 ? "\n\n" : ""}Error: ${event.error}`);
+            continue;
+        }
+        // done, missing_api_key — terminal signals, not content
     }
     if (content.length === 0)
         return null;
+    const metadata = {};
+    if (runId)
+        metadata.runId = runId;
+    if (loopLimit || runError) {
+        metadata.custom = {
+            ...(loopLimit ? { loopLimit } : {}),
+            ...(runError
+                ? {
+                    runError: {
+                        ...runError,
+                        ...(runId ? { runId } : {}),
+                    },
+                }
+                : {}),
+        };
+    }
     return {
         id: `server-${runId ?? Date.now()}`,
         role: "assistant",
         content,
-        status: { type: "complete", reason: "stop" },
-        metadata: runId ? { runId } : {},
+        status: runError
+            ? { type: "incomplete", reason: "error" }
+            : { type: "complete", reason: "stop" },
+        metadata,
     };
 }
 /**

package/dist/agent/thread-data-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"thread-data-builder.js","sourceRoot":"","sources":["../../src/agent/thread-data-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RunEvent } from \"./types.js\";\n\ninterface ContentPart {\n  type: string;\n  text?: string;\n  toolCallId?: string;\n  toolName?: string;\n  argsText?: string;\n  args?: Record<string, string>;\n  result?: string;\n}\n\n/**\n * Reconstruct an assistant-ui message from raw agent run events.\n * Mirrors the client-side processEvent logic so the server can persist\n * the assistant's response even if the frontend is disconnected.\n */\nexport function buildAssistantMessage(\n  events: RunEvent[],\n  runId?: string,\n): {\n  id: string;\n  role: \"assistant\";\n  content: ContentPart[];\n  status: { type: \"complete\"; reason: \"stop\" };\n  metadata: Record<string, unknown>;\n} | null {\n  const content: ContentPart[] = [];\n  let toolCallCounter = 0;\n\n  for (const { event } of events) {\n    if (event.type === \"clear\") {\n      content.length = 0;\n      toolCallCounter = 0;\n      continue;\n    }\n\n    if (event.type === \"text\") {\n      const last = content[content.length - 1];\n      if (last && last.type === \"text\") {\n        last.text = (last.text ?? \"\") + (event.text ?? \"\");\n      } else {\n        content.push({ type: \"text\", text: event.text ?? \"\" });\n      }\n      continue;\n    }\n\n    if (event.type === \"tool_start\") {\n      const toolCallId = `tc_${++toolCallCounter}`;\n      const args = (event.input ?? {}) as Record<string, string>;\n      content.push({\n        type: \"tool-call\",\n        toolCallId,\n        toolName: event.tool ?? \"unknown\",\n        argsText: JSON.stringify(args),\n        args,\n      });\n      continue;\n    }\n\n    if (event.type === \"tool_done\") {\n      for (let i = content.length - 1; i >= 0; i--) {\n        const part = content[i];\n        if (\n          part.type === \"tool-call\" &&\n          part.toolName === event.tool &&\n          part.result === undefined\n        ) {\n          part.result = event.result ?? \"\";\n          break;\n        }\n      }\n      continue;\n    }\n\n    // done, error, missing_api_key, loop_limit — terminal signals, not content\n  }\n\n  if (content.length === 0) return null;\n\n  return {\n    id: `server-${runId ?? Date.now()}`,\n    role: \"assistant\",\n    content,\n    status: { type: \"complete\" as const, reason: \"stop\" as const },\n    metadata: runId ? { runId } : {},\n  };\n}\n\n/**\n * Extract title and preview from a thread runtime export.\n * Isomorphic — works on both server and client.\n */\nexport function extractThreadMeta(repo: any): {\n  title: string;\n  preview: string;\n} {\n  const msgs = repo?.messages;\n  if (!Array.isArray(msgs) || msgs.length === 0)\n    return { title: \"\", preview: \"\" };\n\n  let title = \"\";\n  let preview = \"\";\n  for (const entry of msgs) {\n    // Support both wrapped ({ message: { role, content } }) and flat ({ role, content }) formats\n    const msg = entry?.message ?? entry;\n    if (msg.role !== \"user\") continue;\n    const textParts = Array.isArray(msg.content)\n      ? msg.content\n          .filter((p: any) => p.type === \"text\")\n          .map((p: any) => p.text)\n          .join(\" \")\n      : typeof msg.content === \"string\"\n        ? msg.content\n        : \"\";\n    if (textParts.trim()) {\n      if (!title) title = textParts.trim().slice(0, 80);\n      preview = textParts.trim().slice(0, 120);\n    }\n  }\n  return { title, preview };\n}\n"]}
+{"version":3,"file":"thread-data-builder.js","sourceRoot":"","sources":["../../src/agent/thread-data-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RunEvent } from \"./types.js\";\n\ninterface ContentPart {\n  type: string;\n  text?: string;\n  toolCallId?: string;\n  toolName?: string;\n  argsText?: string;\n  args?: Record<string, string>;\n  result?: string;\n}\n\n/**\n * Reconstruct an assistant-ui message from raw agent run events.\n * Mirrors the client-side processEvent logic so the server can persist\n * the assistant's response even if the frontend is disconnected.\n */\nexport function buildAssistantMessage(\n  events: RunEvent[],\n  runId?: string,\n): {\n  id: string;\n  role: \"assistant\";\n  content: ContentPart[];\n  status:\n    | { type: \"complete\"; reason: \"stop\" }\n    | { type: \"incomplete\"; reason: \"error\" };\n  metadata: Record<string, unknown>;\n} | null {\n  const content: ContentPart[] = [];\n  let toolCallCounter = 0;\n  let loopLimit: { maxIterations?: number } | null = null;\n  let runError: {\n    message: string;\n    errorCode?: string;\n    details?: string;\n    recoverable?: boolean;\n  } | null = null;\n\n  const appendText = (text: string) => {\n    const last = content[content.length - 1];\n    if (last && last.type === \"text\") {\n      last.text = (last.text ?? \"\") + text;\n    } else {\n      content.push({ type: \"text\", text });\n    }\n  };\n\n  for (const { event } of events) {\n    if (event.type === \"clear\") {\n      content.length = 0;\n      toolCallCounter = 0;\n      continue;\n    }\n\n    if (event.type === \"text\") {\n      appendText(event.text ?? \"\");\n      continue;\n    }\n\n    if (event.type === \"tool_start\") {\n      const toolCallId = `tc_${++toolCallCounter}`;\n      const args = (event.input ?? {}) as Record<string, string>;\n      content.push({\n        type: \"tool-call\",\n        toolCallId,\n        toolName: event.tool ?? \"unknown\",\n        argsText: JSON.stringify(args),\n        args,\n      });\n      continue;\n    }\n\n    if (event.type === \"tool_done\") {\n      for (let i = content.length - 1; i >= 0; i--) {\n        const part = content[i];\n        if (\n          part.type === \"tool-call\" &&\n          part.toolName === event.tool &&\n          part.result === undefined\n        ) {\n          part.result = event.result ?? \"\";\n          break;\n        }\n      }\n      continue;\n    }\n\n    if (event.type === \"loop_limit\") {\n      loopLimit = {\n        ...(event.maxIterations ? { maxIterations: event.maxIterations } : {}),\n      };\n      appendText(\n        `${content.length > 0 ? \"\\n\\n\" : \"\"}${\n          event.maxIterations\n            ? `I reached the ${event.maxIterations}-step limit before finishing.`\n            : \"I reached the step limit before finishing.\"\n        }`,\n      );\n      continue;\n    }\n\n    if (event.type === \"error\") {\n      runError = {\n        message: event.error,\n        ...(event.errorCode ? { errorCode: event.errorCode } : {}),\n        ...(event.details ? { details: event.details } : {}),\n        ...(event.recoverable ? { recoverable: event.recoverable } : {}),\n      };\n      appendText(`${content.length > 0 ? \"\\n\\n\" : \"\"}Error: ${event.error}`);\n      continue;\n    }\n\n    // done, missing_api_key — terminal signals, not content\n  }\n\n  if (content.length === 0) return null;\n\n  const metadata: Record<string, unknown> = {};\n  if (runId) metadata.runId = runId;\n  if (loopLimit || runError) {\n    metadata.custom = {\n      ...(loopLimit ? { loopLimit } : {}),\n      ...(runError\n        ? {\n            runError: {\n              ...runError,\n              ...(runId ? { runId } : {}),\n            },\n          }\n        : {}),\n    };\n  }\n\n  return {\n    id: `server-${runId ?? Date.now()}`,\n    role: \"assistant\",\n    content,\n    status: runError\n      ? { type: \"incomplete\" as const, reason: \"error\" as const }\n      : { type: \"complete\" as const, reason: \"stop\" as const },\n    metadata,\n  };\n}\n\n/**\n * Extract title and preview from a thread runtime export.\n * Isomorphic — works on both server and client.\n */\nexport function extractThreadMeta(repo: any): {\n  title: string;\n  preview: string;\n} {\n  const msgs = repo?.messages;\n  if (!Array.isArray(msgs) || msgs.length === 0)\n    return { title: \"\", preview: \"\" };\n\n  let title = \"\";\n  let preview = \"\";\n  for (const entry of msgs) {\n    // Support both wrapped ({ message: { role, content } }) and flat ({ role, content }) formats\n    const msg = entry?.message ?? entry;\n    if (msg.role !== \"user\") continue;\n    const textParts = Array.isArray(msg.content)\n      ? msg.content\n          .filter((p: any) => p.type === \"text\")\n          .map((p: any) => p.text)\n          .join(\" \")\n      : typeof msg.content === \"string\"\n        ? msg.content\n        : \"\";\n    if (textParts.trim()) {\n      if (!title) title = textParts.trim().slice(0, 80);\n      preview = textParts.trim().slice(0, 120);\n    }\n  }\n  return { title, preview };\n}\n"]}

package/dist/agent/tool-search.d.ts

@@ -0,0 +1,37 @@
+import type { ActionEntry } from "./production-agent.js";
+export declare const TOOL_SEARCH_ACTION_NAME = "tool-search";
+type ToolSearchArgs = {
+    query?: unknown;
+    limit?: unknown;
+    includeSchemas?: unknown;
+};
+type ToolParameterSummary = {
+    name: string;
+    type?: string;
+    required: boolean;
+    description?: string;
+    enum?: string[];
+};
+type ToolSearchResult = {
+    name: string;
+    kind: "action" | "mcp";
+    source?: string;
+    description: string;
+    score: number;
+    parameters: ToolParameterSummary[];
+    inputSchema?: unknown;
+};
+type ToolSearchOptions = {
+    defaultLimit?: number;
+    maxLimit?: number;
+};
+export declare function createToolSearchEntry(getRegistry: () => Record<string, ActionEntry>, options?: ToolSearchOptions): ActionEntry;
+export declare function attachToolSearch(registry: Record<string, ActionEntry>, options?: ToolSearchOptions): Record<string, ActionEntry>;
+export declare function searchToolRegistry(registry: Record<string, ActionEntry>, args?: ToolSearchArgs, options?: ToolSearchOptions): {
+    query: string;
+    totalTools: number;
+    count: number;
+    results: ToolSearchResult[];
+};
+export {};
+//# sourceMappingURL=tool-search.d.ts.map

package/dist/agent/tool-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAKF,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC9C,OAAO,GAAE,iBAAsB,GAC9B,WAAW,CA+Bb;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrC,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM7B;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrC,IAAI,GAAE,cAAmB,EACzB,OAAO,GAAE,iBAAsB,GAC9B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B,CA2DA"}

package/dist/agent/tool-search.js

@@ -0,0 +1,201 @@
+import { parseMcpToolName } from "../mcp-client/manager.js";
+import { isMcpToolAllowedForRequest } from "../mcp-client/visibility.js";
+export const TOOL_SEARCH_ACTION_NAME = "tool-search";
+const DEFAULT_LIMIT = 8;
+const MAX_LIMIT = 25;
+export function createToolSearchEntry(getRegistry, options = {}) {
+    return {
+        tool: {
+            description: "Search the live registry of callable tools/actions, including connected MCP server tools named `mcp__<server>__<tool>`. Use this when you need a capability but are not sure which tool to call, especially after users connect new MCP servers. Returns exact tool names and parameter summaries so you can call the matching tool directly.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "What capability to find, e.g. `send slack message`, `create calendar event`, `zapier gmail`, or `browser screenshot`.",
+                    },
+                    limit: {
+                        type: "number",
+                        description: `Maximum results to return. Defaults to ${options.defaultLimit ?? DEFAULT_LIMIT}.`,
+                    },
+                    includeSchemas: {
+                        type: "boolean",
+                        description: "When true, include each matching tool's full input schema. Default false.",
+                    },
+                },
+                required: ["query"],
+            },
+        },
+        http: false,
+        readOnly: true,
+        run: async (args) => searchToolRegistry(getRegistry(), args, options),
+    };
+}
+export function attachToolSearch(registry, options = {}) {
+    registry[TOOL_SEARCH_ACTION_NAME] = createToolSearchEntry(() => registry, options);
+    return registry;
+}
+export function searchToolRegistry(registry, args = {}, options = {}) {
+    const query = String(args.query ?? "").trim();
+    const includeSchemas = parseBoolean(args.includeSchemas);
+    const limit = parseLimit(args.limit, options.defaultLimit ?? DEFAULT_LIMIT, options.maxLimit ?? MAX_LIMIT);
+    const queryTokens = tokenize(query);
+    const candidates = [];
+    let totalTools = 0;
+    for (const [name, entry] of Object.entries(registry)) {
+        if (!entry?.tool || name === TOOL_SEARCH_ACTION_NAME)
+            continue;
+        if (name.startsWith("mcp__") && !isMcpToolAllowedForRequest(name)) {
+            continue;
+        }
+        totalTools++;
+        const description = normalizeWhitespace(entry.tool.description ?? "");
+        const parameters = summarizeParameters(entry.tool.parameters);
+        const parsedMcp = parseMcpToolName(name);
+        const kind = parsedMcp ? "mcp" : "action";
+        const source = parsedMcp?.serverId;
+        const score = scoreTool({
+            query,
+            queryTokens,
+            name,
+            source,
+            description,
+            parameters,
+            kind,
+        });
+        if (queryTokens.length > 0 && score <= 0)
+            continue;
+        candidates.push({
+            name,
+            kind,
+            ...(source ? { source } : {}),
+            description,
+            score,
+            parameters,
+            ...(includeSchemas ? { inputSchema: entry.tool.parameters ?? {} } : {}),
+        });
+    }
+    candidates.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return a.name.localeCompare(b.name);
+    });
+    return {
+        query,
+        totalTools,
+        count: Math.min(candidates.length, limit),
+        results: candidates.slice(0, limit),
+    };
+}
+function parseLimit(value, fallback, max) {
+    const n = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim()
+            ? Number(value)
+            : fallback;
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return Math.max(1, Math.min(max, Math.floor(n)));
+}
+function parseBoolean(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value !== "string")
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "true" || normalized === "1" || normalized === "yes";
+}
+function summarizeParameters(schema) {
+    if (!schema || typeof schema !== "object")
+        return [];
+    const obj = schema;
+    const properties = obj.properties;
+    if (!properties || typeof properties !== "object")
+        return [];
+    const required = new Set(Array.isArray(obj.required)
+        ? obj.required.filter((value) => typeof value === "string")
+        : []);
+    return Object.entries(properties).map(([name, raw]) => {
+        const prop = raw && typeof raw === "object" ? raw : {};
+        const enumValues = Array.isArray(prop.enum)
+            ? prop.enum.map((value) => String(value)).slice(0, 20)
+            : undefined;
+        return {
+            name,
+            type: summarizeType(prop.type),
+            required: required.has(name),
+            description: typeof prop.description === "string"
+                ? normalizeWhitespace(prop.description)
+                : undefined,
+            ...(enumValues && enumValues.length > 0 ? { enum: enumValues } : {}),
+        };
+    });
+}
+function summarizeType(value) {
+    if (typeof value === "string")
+        return value;
+    if (Array.isArray(value)) {
+        const parts = value.filter((v) => typeof v === "string");
+        return parts.length > 0 ? parts.join(" | ") : undefined;
+    }
+    return undefined;
+}
+function scoreTool(input) {
+    if (input.queryTokens.length === 0)
+        return 1;
+    const name = searchableText(input.name);
+    const source = searchableText(input.source ?? "");
+    const description = searchableText(input.description);
+    const params = searchableText(input.parameters
+        .map((p) => `${p.name} ${p.type ?? ""} ${p.description ?? ""}`)
+        .join(" "));
+    const all = `${name} ${source} ${description} ${params} ${input.kind}`;
+    const phrase = searchableText(input.query);
+    let score = 0;
+    if (name.includes(phrase))
+        score += 14;
+    if (source && source.includes(phrase))
+        score += 10;
+    if (description.includes(phrase))
+        score += 8;
+    if (params.includes(phrase))
+        score += 5;
+    for (const token of input.queryTokens) {
+        if (name.split(" ").includes(token))
+            score += 9;
+        else if (name.includes(token))
+            score += 6;
+        if (source) {
+            if (source.split(" ").includes(token))
+                score += 6;
+            else if (source.includes(token))
+                score += 3;
+        }
+        if (description.includes(token))
+            score += 3;
+        if (params.includes(token))
+            score += 2;
+        if (all.includes(token))
+            score += 1;
+    }
+    return score;
+}
+function tokenize(value) {
+    const seen = new Set();
+    for (const token of searchableText(value).split(" ")) {
+        if (token.length > 0)
+            seen.add(token);
+    }
+    return Array.from(seen);
+}
+function searchableText(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+function normalizeWhitespace(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=tool-search.js.map

package/dist/agent/tool-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionEntry } from \"./production-agent.js\";\nimport { parseMcpToolName } from \"../mcp-client/manager.js\";\nimport { isMcpToolAllowedForRequest } from \"../mcp-client/visibility.js\";\n\nexport const TOOL_SEARCH_ACTION_NAME = \"tool-search\";\n\ntype ToolSearchArgs = {\n  query?: unknown;\n  limit?: unknown;\n  includeSchemas?: unknown;\n};\n\ntype ToolParameterSummary = {\n  name: string;\n  type?: string;\n  required: boolean;\n  description?: string;\n  enum?: string[];\n};\n\ntype ToolSearchResult = {\n  name: string;\n  kind: \"action\" | \"mcp\";\n  source?: string;\n  description: string;\n  score: number;\n  parameters: ToolParameterSummary[];\n  inputSchema?: unknown;\n};\n\ntype ToolSearchOptions = {\n  defaultLimit?: number;\n  maxLimit?: number;\n};\n\nconst DEFAULT_LIMIT = 8;\nconst MAX_LIMIT = 25;\n\nexport function createToolSearchEntry(\n  getRegistry: () => Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): ActionEntry {\n  return {\n    tool: {\n      description:\n        \"Search the live registry of callable tools/actions, including connected MCP server tools named `mcp__<server>__<tool>`. Use this when you need a capability but are not sure which tool to call, especially after users connect new MCP servers. Returns exact tool names and parameter summaries so you can call the matching tool directly.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          query: {\n            type: \"string\",\n            description:\n              \"What capability to find, e.g. `send slack message`, `create calendar event`, `zapier gmail`, or `browser screenshot`.\",\n          },\n          limit: {\n            type: \"number\",\n            description: `Maximum results to return. Defaults to ${options.defaultLimit ?? DEFAULT_LIMIT}.`,\n          } as any,\n          includeSchemas: {\n            type: \"boolean\",\n            description:\n              \"When true, include each matching tool's full input schema. Default false.\",\n          } as any,\n        },\n        required: [\"query\"],\n      },\n    },\n    http: false,\n    readOnly: true,\n    run: async (args: Record<string, string>) =>\n      searchToolRegistry(getRegistry(), args, options),\n  };\n}\n\nexport function attachToolSearch(\n  registry: Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): Record<string, ActionEntry> {\n  registry[TOOL_SEARCH_ACTION_NAME] = createToolSearchEntry(\n    () => registry,\n    options,\n  );\n  return registry;\n}\n\nexport function searchToolRegistry(\n  registry: Record<string, ActionEntry>,\n  args: ToolSearchArgs = {},\n  options: ToolSearchOptions = {},\n): {\n  query: string;\n  totalTools: number;\n  count: number;\n  results: ToolSearchResult[];\n} {\n  const query = String(args.query ?? \"\").trim();\n  const includeSchemas = parseBoolean(args.includeSchemas);\n  const limit = parseLimit(\n    args.limit,\n    options.defaultLimit ?? DEFAULT_LIMIT,\n    options.maxLimit ?? MAX_LIMIT,\n  );\n  const queryTokens = tokenize(query);\n\n  const candidates: ToolSearchResult[] = [];\n  let totalTools = 0;\n\n  for (const [name, entry] of Object.entries(registry)) {\n    if (!entry?.tool || name === TOOL_SEARCH_ACTION_NAME) continue;\n    if (name.startsWith(\"mcp__\") && !isMcpToolAllowedForRequest(name)) {\n      continue;\n    }\n\n    totalTools++;\n    const description = normalizeWhitespace(entry.tool.description ?? \"\");\n    const parameters = summarizeParameters(entry.tool.parameters);\n    const parsedMcp = parseMcpToolName(name);\n    const kind = parsedMcp ? \"mcp\" : \"action\";\n    const source = parsedMcp?.serverId;\n    const score = scoreTool({\n      query,\n      queryTokens,\n      name,\n      source,\n      description,\n      parameters,\n      kind,\n    });\n\n    if (queryTokens.length > 0 && score <= 0) continue;\n\n    candidates.push({\n      name,\n      kind,\n      ...(source ? { source } : {}),\n      description,\n      score,\n      parameters,\n      ...(includeSchemas ? { inputSchema: entry.tool.parameters ?? {} } : {}),\n    });\n  }\n\n  candidates.sort((a, b) => {\n    if (b.score !== a.score) return b.score - a.score;\n    return a.name.localeCompare(b.name);\n  });\n\n  return {\n    query,\n    totalTools,\n    count: Math.min(candidates.length, limit),\n    results: candidates.slice(0, limit),\n  };\n}\n\nfunction parseLimit(value: unknown, fallback: number, max: number): number {\n  const n =\n    typeof value === \"number\"\n      ? value\n      : typeof value === \"string\" && value.trim()\n        ? Number(value)\n        : fallback;\n  if (!Number.isFinite(n) || n <= 0) return fallback;\n  return Math.max(1, Math.min(max, Math.floor(n)));\n}\n\nfunction parseBoolean(value: unknown): boolean {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value !== \"string\") return false;\n  const normalized = value.trim().toLowerCase();\n  return normalized === \"true\" || normalized === \"1\" || normalized === \"yes\";\n}\n\nfunction summarizeParameters(schema: unknown): ToolParameterSummary[] {\n  if (!schema || typeof schema !== \"object\") return [];\n  const obj = schema as {\n    properties?: Record<string, unknown>;\n    required?: unknown;\n  };\n  const properties = obj.properties;\n  if (!properties || typeof properties !== \"object\") return [];\n  const required = new Set(\n    Array.isArray(obj.required)\n      ? obj.required.filter(\n          (value): value is string => typeof value === \"string\",\n        )\n      : [],\n  );\n\n  return Object.entries(properties).map(([name, raw]) => {\n    const prop =\n      raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n    const enumValues = Array.isArray(prop.enum)\n      ? prop.enum.map((value) => String(value)).slice(0, 20)\n      : undefined;\n    return {\n      name,\n      type: summarizeType(prop.type),\n      required: required.has(name),\n      description:\n        typeof prop.description === \"string\"\n          ? normalizeWhitespace(prop.description)\n          : undefined,\n      ...(enumValues && enumValues.length > 0 ? { enum: enumValues } : {}),\n    };\n  });\n}\n\nfunction summarizeType(value: unknown): string | undefined {\n  if (typeof value === \"string\") return value;\n  if (Array.isArray(value)) {\n    const parts = value.filter((v): v is string => typeof v === \"string\");\n    return parts.length > 0 ? parts.join(\" | \") : undefined;\n  }\n  return undefined;\n}\n\nfunction scoreTool(input: {\n  query: string;\n  queryTokens: string[];\n  name: string;\n  source?: string;\n  description: string;\n  parameters: ToolParameterSummary[];\n  kind: \"action\" | \"mcp\";\n}): number {\n  if (input.queryTokens.length === 0) return 1;\n\n  const name = searchableText(input.name);\n  const source = searchableText(input.source ?? \"\");\n  const description = searchableText(input.description);\n  const params = searchableText(\n    input.parameters\n      .map((p) => `${p.name} ${p.type ?? \"\"} ${p.description ?? \"\"}`)\n      .join(\" \"),\n  );\n  const all = `${name} ${source} ${description} ${params} ${input.kind}`;\n  const phrase = searchableText(input.query);\n\n  let score = 0;\n  if (name.includes(phrase)) score += 14;\n  if (source && source.includes(phrase)) score += 10;\n  if (description.includes(phrase)) score += 8;\n  if (params.includes(phrase)) score += 5;\n\n  for (const token of input.queryTokens) {\n    if (name.split(\" \").includes(token)) score += 9;\n    else if (name.includes(token)) score += 6;\n\n    if (source) {\n      if (source.split(\" \").includes(token)) score += 6;\n      else if (source.includes(token)) score += 3;\n    }\n\n    if (description.includes(token)) score += 3;\n    if (params.includes(token)) score += 2;\n    if (all.includes(token)) score += 1;\n  }\n\n  return score;\n}\n\nfunction tokenize(value: string): string[] {\n  const seen = new Set<string>();\n  for (const token of searchableText(value).split(\" \")) {\n    if (token.length > 0) seen.add(token);\n  }\n  return Array.from(seen);\n}\n\nfunction searchableText(value: string): string {\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .trim();\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/g, \" \").trim();\n}\n"]}

package/dist/agent/types.d.ts

@@ -53,6 +53,8 @@ export interface AgentChatRequest {
     references?: AgentChatReference[];
     threadId?: string;
     attachments?: AgentChatAttachment[];
+    /** Execution mode for this turn. Plan mode is read-only and proposes before acting. */
+    mode?: "act" | "plan";
     /** Per-request model override (ephemeral, from the composer model picker). */
     model?: string;
     /** Per-request engine override (sent alongside model for cross-provider switches). */
@@ -107,10 +109,15 @@ export type AgentChatEvent = {
     errorCode?: string;
     /** Optional link paired with errorCode — e.g. Builder billing page. */
     upgradeUrl?: string;
+    /** Optional details for expandable UI/debugging. */
+    details?: string;
+    /** True when the user can reasonably continue/retry from partial work. */
+    recoverable?: boolean;
 } | {
     type: "missing_api_key";
 } | {
     type: "loop_limit";
+    maxIterations?: number;
 } | {
     type: "clear";
 };
@@ -118,5 +125,5 @@ export interface RunEvent {
     seq: number;
     event: AgentChatEvent;
 }
-export type RunStatus = "running" | "completed" | "errored";
+export type RunStatus = "running" | "completed" | "errored" | "aborted";
 //# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface ActionTool {\n  description: string;\n  parameters?: {\n    type: \"object\";\n    properties: Record<\n      string,\n      {\n        type: string;\n        description?: string;\n        enum?: string[];\n      }\n    >;\n    required?: string[];\n  };\n}\n\n/** @deprecated Use `ActionTool` instead */\nexport type ScriptTool = ActionTool;\n\nexport interface AgentMessage {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface AgentChatReference {\n  type: \"file\" | \"skill\" | \"mention\" | \"agent\" | \"custom-agent\";\n  path: string;\n  name: string;\n  source: string;\n  refType?: string;\n  refId?: string;\n}\n\nexport interface MentionProviderItem {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  refType: string;\n  refId?: string;\n  refPath?: string;\n}\n\nexport interface MentionProvider {\n  label: string;\n  icon?: string;\n  search: (\n    query: string,\n    /** The H3 event for the current request — use to make internal API calls */\n    event?: any,\n  ) => MentionProviderItem[] | Promise<MentionProviderItem[]>;\n}\n\nexport interface AgentChatAttachment {\n  type: string;\n  name: string;\n  data?: string;\n  contentType?: string;\n  text?: string;\n}\n\nexport interface AgentChatRequest {\n  message: string;\n  history?: AgentMessage[];\n  references?: AgentChatReference[];\n  threadId?: string;\n  attachments?: AgentChatAttachment[];\n  /** Per-request model override (ephemeral, from the composer model picker). */\n  model?: string;\n  /** Per-request engine override (sent alongside model for cross-provider switches). */\n  engine?: string;\n  /** Usage-tracking label for this call (e.g. \"chat\", \"summarize\"). Default: \"chat\". */\n  usageLabel?: string;\n}\n\nexport type AgentChatEvent =\n  | { type: \"text\"; text: string }\n  | { type: \"tool_start\"; tool: string; input: Record<string, string> }\n  | { type: \"tool_done\"; tool: string; result: string }\n  | {\n      type: \"agent_call\";\n      agent: string;\n      status: \"start\" | \"done\" | \"error\";\n    }\n  | { type: \"agent_call_text\"; agent: string; text: string }\n  | {\n      type: \"agent_task\";\n      taskId: string;\n      threadId: string;\n      description: string;\n      status: \"running\" | \"completed\" | \"errored\";\n    }\n  | {\n      type: \"agent_task_update\";\n      taskId: string;\n      preview: string;\n      currentStep?: string;\n    }\n  | {\n      type: \"agent_task_complete\";\n      taskId: string;\n      summary: string;\n    }\n  | { type: \"done\" }\n  | {\n      type: \"error\";\n      error: string;\n      /**\n       * Optional machine-readable error code. Builder gateway uses codes\n       * like \"credits-limit-monthly\" / \"unauthorized\" / \"gateway_not_enabled\"\n       * so the chat UI can render a structured CTA (e.g. upgrade button).\n       */\n      errorCode?: string;\n      /** Optional link paired with errorCode — e.g. Builder billing page. */\n      upgradeUrl?: string;\n    }\n  | { type: \"missing_api_key\" }\n  | { type: \"loop_limit\" }\n  | { type: \"clear\" };\n\nexport interface RunEvent {\n  seq: number;\n  event: AgentChatEvent;\n}\n\nexport type RunStatus = \"running\" | \"completed\" | \"errored\";\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface ActionTool {\n  description: string;\n  parameters?: {\n    type: \"object\";\n    properties: Record<\n      string,\n      {\n        type: string;\n        description?: string;\n        enum?: string[];\n      }\n    >;\n    required?: string[];\n  };\n}\n\n/** @deprecated Use `ActionTool` instead */\nexport type ScriptTool = ActionTool;\n\nexport interface AgentMessage {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface AgentChatReference {\n  type: \"file\" | \"skill\" | \"mention\" | \"agent\" | \"custom-agent\";\n  path: string;\n  name: string;\n  source: string;\n  refType?: string;\n  refId?: string;\n}\n\nexport interface MentionProviderItem {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  refType: string;\n  refId?: string;\n  refPath?: string;\n}\n\nexport interface MentionProvider {\n  label: string;\n  icon?: string;\n  search: (\n    query: string,\n    /** The H3 event for the current request — use to make internal API calls */\n    event?: any,\n  ) => MentionProviderItem[] | Promise<MentionProviderItem[]>;\n}\n\nexport interface AgentChatAttachment {\n  type: string;\n  name: string;\n  data?: string;\n  contentType?: string;\n  text?: string;\n}\n\nexport interface AgentChatRequest {\n  message: string;\n  history?: AgentMessage[];\n  references?: AgentChatReference[];\n  threadId?: string;\n  attachments?: AgentChatAttachment[];\n  /** Execution mode for this turn. Plan mode is read-only and proposes before acting. */\n  mode?: \"act\" | \"plan\";\n  /** Per-request model override (ephemeral, from the composer model picker). */\n  model?: string;\n  /** Per-request engine override (sent alongside model for cross-provider switches). */\n  engine?: string;\n  /** Usage-tracking label for this call (e.g. \"chat\", \"summarize\"). Default: \"chat\". */\n  usageLabel?: string;\n}\n\nexport type AgentChatEvent =\n  | { type: \"text\"; text: string }\n  | { type: \"tool_start\"; tool: string; input: Record<string, string> }\n  | { type: \"tool_done\"; tool: string; result: string }\n  | {\n      type: \"agent_call\";\n      agent: string;\n      status: \"start\" | \"done\" | \"error\";\n    }\n  | { type: \"agent_call_text\"; agent: string; text: string }\n  | {\n      type: \"agent_task\";\n      taskId: string;\n      threadId: string;\n      description: string;\n      status: \"running\" | \"completed\" | \"errored\";\n    }\n  | {\n      type: \"agent_task_update\";\n      taskId: string;\n      preview: string;\n      currentStep?: string;\n    }\n  | {\n      type: \"agent_task_complete\";\n      taskId: string;\n      summary: string;\n    }\n  | { type: \"done\" }\n  | {\n      type: \"error\";\n      error: string;\n      /**\n       * Optional machine-readable error code. Builder gateway uses codes\n       * like \"credits-limit-monthly\" / \"unauthorized\" / \"gateway_not_enabled\"\n       * so the chat UI can render a structured CTA (e.g. upgrade button).\n       */\n      errorCode?: string;\n      /** Optional link paired with errorCode — e.g. Builder billing page. */\n      upgradeUrl?: string;\n      /** Optional details for expandable UI/debugging. */\n      details?: string;\n      /** True when the user can reasonably continue/retry from partial work. */\n      recoverable?: boolean;\n    }\n  | { type: \"missing_api_key\" }\n  | { type: \"loop_limit\"; maxIterations?: number }\n  | { type: \"clear\" };\n\nexport interface RunEvent {\n  seq: number;\n  event: AgentChatEvent;\n}\n\nexport type RunStatus = \"running\" | \"completed\" | \"errored\" | \"aborted\";\n"]}

package/dist/cli/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAgCvE,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AA+FD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAmHD;;;;;GAKG;AACH,iBAAe,mBAAmB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf;AAsCD;;;;GAIG;AACH,iBAAe,wBAAwB,CACrC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAgEpE;AAwGD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,yCAAyC;AACzC,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,mBAAmB,IAAI,oBAAoB,EAC3C,wBAAwB,IAAI,yBAAyB,EACrD,qBAAqB,IAAI,sBAAsB,EAC/C,WAAW,IAAI,YAAY,EAC3B,kBAAkB,IAAI,mBAAmB,EACzC,eAAe,IAAI,gBAAgB,EACnC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,GAC9C,CAAC;AAkEF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAc1C;AAcD,iBAAS,oBAAoB,IAAI,MAAM,CAMtC;AA4DD,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAgCvE,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAmGD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAkCf;AA8HD;;;;;GAKG;AACH,iBAAe,mBAAmB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf;AAsCD;;;;GAIG;AACH,iBAAe,wBAAwB,CACrC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAiEpE;AAgHD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,yCAAyC;AACzC,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,mBAAmB,IAAI,oBAAoB,EAC3C,wBAAwB,IAAI,yBAAyB,EACrD,qBAAqB,IAAI,sBAAsB,EAC/C,WAAW,IAAI,YAAY,EAC3B,kBAAkB,IAAI,mBAAmB,EACzC,eAAe,IAAI,gBAAgB,EACnC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,GAC9C,CAAC;AAkEF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAc1C;AAcD,iBAAS,oBAAoB,IAAI,MAAM,CAMtC;AA0FD,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C"}

package/dist/cli/create.js

@@ -78,7 +78,9 @@ async function createWorkspaceInteractive(name, opts, clack) {
     const preselected = parseTemplateList(opts?.template);
     const templates = preselected.length > 0
         ? preselected
-        : await promptTemplatePicker(preselected, clack);
+        : await promptTemplatePicker(preselected, clack, {
+            defaultTemplates: ["starter", "dispatch"],
+        });
     if (templates.length === 0) {
         clack.cancel("No apps selected. Cancelled.");
         process.exit(0);
@@ -94,7 +96,7 @@ async function createWorkspaceInteractive(name, opts, clack) {
     try {
         await scaffoldWorkspaceRoot(targetDir, name);
         const workspaceCoreName = `@${name}/core-module`;
-        updateWorkspaceDevScript(targetDir, firstApp);
+        ensureWorkspaceGatewayDevScript(targetDir);
         for (const t of templates) {
             const appDir = path.join(targetDir, "apps", t);
             await scaffoldAppTemplate(appDir, t);
@@ -102,11 +104,13 @@ async function createWorkspaceInteractive(name, opts, clack) {
             workspacifyApp({
                 appDir,
                 appName: t,
+                templateName: t,
                 workspaceRoot: targetDir,
                 workspaceCoreName,
                 coreDependencyVersion: getCoreDependencyVersion(),
             });
             fixPackageJsonName(appDir, t);
+            rewriteNetlifyToml(appDir, t, "workspace");
             renameGitignore(appDir);
             // Each app owns its own .claude / .agents symlinks.
             setupAgentSymlinks(appDir);
@@ -125,7 +129,7 @@ async function createWorkspaceInteractive(name, opts, clack) {
         ``,
         `  cd ${name}`,
         `  pnpm install`,
-        `  pnpm --filter ${firstApp} dev`,
+        `  pnpm dev`,
         ``,
         `Add another app later:  agent-native add-app`,
         `Deploy the whole workspace:  agent-native deploy`,
@@ -216,11 +220,13 @@ async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, cla
         workspacifyApp({
             appDir,
             appName,
+            templateName,
             workspaceRoot: workspace.workspaceRoot,
             workspaceCoreName: workspace.workspaceCoreName,
             coreDependencyVersion: getCoreDependencyVersion(),
         });
         fixPackageJsonName(appDir, appName);
+        rewriteNetlifyToml(appDir, appName, "workspace");
         renameGitignore(appDir);
         setupAgentSymlinks(appDir);
         await scaffoldRequiredPackages([templateName], workspace.workspaceRoot);
@@ -231,7 +237,14 @@ async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, cla
         clack.cancel(err?.message ?? String(err));
         process.exit(1);
     }
-    clack.outro(`Done!\n\n  pnpm install\n  pnpm --filter ${appName} dev`);
+    clack.outro([
+        `Done!`,
+        ``,
+        `  pnpm install`,
+        `  pnpm dev`,
+        ``,
+        `The workspace gateway will detect apps/${appName} and serve it at /${appName}.`,
+    ].join("\n"));
 }
 /* ─────────────────────────────────────────────────────────────────────────
  * Standalone creation (escape hatch)
@@ -449,6 +462,7 @@ function postProcessStandalone(name, targetDir) {
     const appTitle = titleCase(name);
     replacePlaceholders(targetDir, name, appTitle);
     fixPackageJsonName(targetDir, name);
+    rewriteNetlifyToml(targetDir, name, "standalone");
     for (const base of ["learnings"]) {
         const defaultsFile = path.join(targetDir, `${base}.defaults.md`);
         const targetFile = path.join(targetDir, `${base}.md`);
@@ -556,9 +570,11 @@ async function promptTemplatePicker(preselected, clack, opts) {
     // back to "starter" when that's available and nothing else is pre-picked.
     const defaults = preselected.length > 0
         ? preselected.filter((p) => options.some((o) => o.value === p))
-        : options.some((o) => o.value === "starter")
-            ? ["starter"]
-            : [];
+        : opts?.defaultTemplates
+            ? opts.defaultTemplates.filter((p) => options.some((o) => o.value === p))
+            : options.some((o) => o.value === "starter")
+                ? ["starter"]
+                : [];
     const baseMessage = opts?.message ?? "Which apps would you like to include?";
     const result = await clack.multiselect({
         message: `${baseMessage}\n  (↑/↓ move · space to toggle · enter to confirm)`,
@@ -777,18 +793,37 @@ function rewriteCoreDependencyVersions(projectDir) {
     }
     catch { }
 }
-function updateWorkspaceDevScript(workspaceRoot, appName) {
+function ensureWorkspaceGatewayDevScript(workspaceRoot) {
     const pkgPath = path.join(workspaceRoot, "package.json");
     if (!fs.existsSync(pkgPath))
         return;
     try {
         const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
         pkg.scripts = pkg.scripts ?? {};
-        pkg.scripts.dev = `pnpm --filter ${appName} dev`;
+        pkg.scripts.dev = "tsx scripts/workspace-dev.ts";
         fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
     }
     catch { }
 }
+function rewriteNetlifyToml(appDir, appName, mode) {
+    const netlifyPath = path.join(appDir, "netlify.toml");
+    if (!fs.existsSync(netlifyPath))
+        return;
+    try {
+        let content = fs.readFileSync(netlifyPath, "utf-8");
+        const buildCommand = mode === "workspace" ? `pnpm --filter ${appName} build` : "pnpm build";
+        const publishPath = mode === "workspace" ? `apps/${appName}/dist` : "dist";
+        const functionsPath = mode === "workspace"
+            ? `apps/${appName}/.netlify/functions-internal`
+            : ".netlify/functions-internal";
+        content = content
+            .replace(/pnpm --filter [^ ]+ build/g, buildCommand)
+            .replace(/publish = "templates\/[^"]+\/dist"/g, `publish = "${publishPath}"`)
+            .replace(/functions = "templates\/[^"]+\/\.netlify\/functions-internal"/g, `functions = "${functionsPath}"`);
+        fs.writeFileSync(netlifyPath, content);
+    }
+    catch { }
+}
 function tryGitInit(dir) {
     try {
         execFileSync("git", ["init"], { cwd: dir, stdio: "pipe" });