@agent-native/core 0.8.2 → 0.10.0

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

@@ -136,6 +136,102 @@ export function buildAssistantMessage(events, runId, options = {}) {
         metadata,
     };
 }
+function getStoredMessage(entry) {
+    return entry?.message ?? entry;
+}
+function getMessageRunId(message) {
+    const meta = message?.metadata;
+    const direct = meta?.runId;
+    const custom = meta?.custom?.runId;
+    const errorRun = meta?.custom?.runError?.runId ?? meta?.runError?.runId;
+    if (typeof direct === "string")
+        return direct;
+    if (typeof custom === "string")
+        return custom;
+    if (typeof errorRun === "string")
+        return errorRun;
+    return undefined;
+}
+function messageContentIsEmpty(content) {
+    if (Array.isArray(content))
+        return content.length === 0;
+    return content == null || content === "";
+}
+function messageText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((part) => part?.type === "text" && typeof part.text === "string")
+        .map((part) => part.text)
+        .join("");
+}
+function isTerminalAssistantStatus(status) {
+    const type = status?.type;
+    return type === "complete" || type === "incomplete";
+}
+function shouldReplaceLastAssistant(lastMessage, assistantMsg) {
+    const lastContent = lastMessage?.content;
+    if (messageContentIsEmpty(lastContent))
+        return true;
+    const lastRunId = getMessageRunId(lastMessage);
+    const nextRunId = getMessageRunId(assistantMsg);
+    if (lastRunId && nextRunId && lastRunId === nextRunId)
+        return true;
+    const lastStatus = lastMessage?.status;
+    if (lastStatus && !isTerminalAssistantStatus(lastStatus))
+        return true;
+    try {
+        if (JSON.stringify(lastContent) === JSON.stringify(assistantMsg.content)) {
+            return true;
+        }
+    }
+    catch {
+        // Fall through to the text-prefix check.
+    }
+    const lastText = messageText(lastContent).trim();
+    const nextText = messageText(assistantMsg.content).trim();
+    return Boolean(lastText && nextText && nextText.startsWith(lastText));
+}
+/**
+ * Merge the server-reconstructed assistant message into persisted
+ * assistant-ui thread data.
+ *
+ * The browser periodically saves thread data while a run is still streaming.
+ * That can leave the last assistant message non-empty but partial/pending.
+ * Completion must replace that same-run partial message instead of treating
+ * any assistant content as proof that the frontend already saved the final
+ * turn.
+ */
+export function upsertAssistantMessage(repo, assistantMsg) {
+    const nextRepo = repo && typeof repo === "object" ? repo : {};
+    if (!Array.isArray(nextRepo.messages))
+        nextRepo.messages = [];
+    const lastIndex = nextRepo.messages.length - 1;
+    const lastEntry = lastIndex >= 0 ? nextRepo.messages[lastIndex] : undefined;
+    const lastMsg = getStoredMessage(lastEntry);
+    const lastRole = lastMsg?.role;
+    const isWrapped = Boolean(lastEntry && "message" in lastEntry);
+    if (lastRole === "assistant" &&
+        shouldReplaceLastAssistant(lastMsg, assistantMsg)) {
+        nextRepo.messages[lastIndex] = isWrapped
+            ? { ...lastEntry, message: assistantMsg }
+            : assistantMsg;
+        return nextRepo;
+    }
+    if (isWrapped) {
+        const parentId = nextRepo.messages.length > 0
+            ? (getStoredMessage(nextRepo.messages[nextRepo.messages.length - 1])
+                ?.id ?? null)
+            : null;
+        nextRepo.messages.push({ message: assistantMsg, parentId });
+    }
+    else {
+        nextRepo.messages.push(assistantMsg);
+    }
+    return nextRepo;
+}
 /**
  * Extract title and preview from a thread runtime export.
  * Isomorphic — works on both server and client.

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\ninterface BuildAssistantMessageOptions {\n  suppressInternalContinuation?: boolean;\n}\n\nfunction isInternalContinuationError(event: {\n  error: string;\n  errorCode?: string;\n  recoverable?: boolean;\n}): boolean {\n  const code = String(event.errorCode ?? \"\").toLowerCase();\n  const msg = event.error.toLowerCase();\n  return (\n    event.recoverable === true ||\n    code === \"builder_gateway_timeout\" ||\n    code === \"stale_run\" ||\n    code === \"timeout\" ||\n    code === \"timeout_error\" ||\n    code === \"http_408\" ||\n    code === \"http_429\" ||\n    code === \"http_500\" ||\n    code === \"http_502\" ||\n    code === \"http_503\" ||\n    code === \"http_504\" ||\n    code === \"rate_limited\" ||\n    code === \"too_many_concurrent_requests\" ||\n    code === \"overloaded_error\" ||\n    msg.includes(\"timeout\") ||\n    msg.includes(\"gateway timeout\") ||\n    msg.includes(\"inactivity timeout\") ||\n    msg.includes(\"stream ended\") ||\n    msg.includes(\"stream closed\") ||\n    msg.includes(\"temporarily unavailable\") ||\n    msg.includes(\"502\") ||\n    msg.includes(\"503\") ||\n    msg.includes(\"504\") ||\n    msg.includes(\"529\")\n  );\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  options: BuildAssistantMessageOptions = {},\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 runError: {\n    message: string;\n    errorCode?: string;\n    details?: string;\n    recoverable?: boolean;\n  } | null = null;\n  let endedAtInternalContinuationBoundary = false;\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      // Older servers emitted this as a user-visible terminal event. Treat it\n      // as an internal continuation boundary when rebuilding persisted turns.\n      if (options.suppressInternalContinuation) {\n        endedAtInternalContinuationBoundary = true;\n      }\n      continue;\n    }\n\n    if (event.type === \"auto_continue\") {\n      if (options.suppressInternalContinuation) {\n        endedAtInternalContinuationBoundary = true;\n      }\n      continue;\n    }\n\n    if (event.type === \"error\") {\n      if (\n        options.suppressInternalContinuation &&\n        isInternalContinuationError(event)\n      ) {\n        endedAtInternalContinuationBoundary = true;\n        continue;\n      }\n      if (event.errorCode === \"run_timeout\" && event.recoverable) {\n        continue;\n      }\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 || endedAtInternalContinuationBoundary) return null;\n\n  const metadata: Record<string, unknown> = {};\n  if (runId) metadata.runId = runId;\n  if (runError) {\n    metadata.custom = {\n      runError: {\n        ...runError,\n        ...(runId ? { runId } : {}),\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"]}
+{"version":3,"file":"thread-data-builder.js","sourceRoot":"","sources":["../../src/agent/thread-data-builder.ts"],"names":[],"mappings":"AAkBA,SAAS,2BAA2B,CAAC,KAIpC;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACL,KAAK,CAAC,WAAW,KAAK,IAAI;QAC1B,IAAI,KAAK,yBAAyB;QAClC,IAAI,KAAK,WAAW;QACpB,IAAI,KAAK,SAAS;QAClB,IAAI,KAAK,eAAe;QACxB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,cAAc;QACvB,IAAI,KAAK,8BAA8B;QACvC,IAAI,KAAK,kBAAkB;QAC3B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;QACvB,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAClC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC5B,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC7B,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACvC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CACpB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAkB,EAClB,KAAc,EACd,UAAwC,EAAE;IAU1C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,QAAQ,GAKD,IAAI,CAAC;IAChB,IAAI,mCAAmC,GAAG,KAAK,CAAC;IAEhD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,eAAe,GAAG,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,MAAM,EAAE,eAAe,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA2B,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,WAAW;gBACjB,UAAU;gBACV,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS;gBACjC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC9B,IAAI;aACL,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxB,IACE,IAAI,CAAC,IAAI,KAAK,WAAW;oBACzB,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,IAAI;oBAC5B,IAAI,CAAC,MAAM,KAAK,SAAS,EACzB,CAAC;oBACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;oBACjC,MAAM;gBACR,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,wEAAwE;YACxE,wEAAwE;YACxE,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC;gBACzC,mCAAmC,GAAG,IAAI,CAAC;YAC7C,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC;gBACzC,mCAAmC,GAAG,IAAI,CAAC;YAC7C,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,IACE,OAAO,CAAC,4BAA4B;gBACpC,2BAA2B,CAAC,KAAK,CAAC,EAClC,CAAC;gBACD,mCAAmC,GAAG,IAAI,CAAC;gBAC3C,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,KAAK,aAAa,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC3D,SAAS;YACX,CAAC;YACD,QAAQ,GAAG;gBACT,OAAO,EAAE,KAAK,CAAC,KAAK;gBACpB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC;YACF,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACvE,SAAS;QACX,CAAC;QAED,wDAAwD;IAC1D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,mCAAmC;QAAE,OAAO,IAAI,CAAC;IAE7E,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,IAAI,KAAK;QAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IAClC,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,MAAM,GAAG;YAChB,QAAQ,EAAE;gBACR,GAAG,QAAQ;gBACX,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5B;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,UAAU,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QACnC,IAAI,EAAE,WAAW;QACjB,OAAO;QACP,MAAM,EAAE,QAAQ;YACd,CAAC,CAAC,EAAE,IAAI,EAAE,YAAqB,EAAE,MAAM,EAAE,OAAgB,EAAE;YAC3D,CAAC,CAAC,EAAE,IAAI,EAAE,UAAmB,EAAE,MAAM,EAAE,MAAe,EAAE;QAC1D,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAU;IAClC,OAAO,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CAAC,OAAY;IACnC,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC;IACxE,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;IACxD,OAAO,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,OAAgB;IACnC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,OAAO;SACX,MAAM,CACL,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CACtE;SACA,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SAC7B,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAe;IAChD,MAAM,IAAI,GAAI,MAAyC,EAAE,IAAI,CAAC;IAC9D,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,CAAC;AACtD,CAAC;AAED,SAAS,0BAA0B,CACjC,WAAgB,EAChB,YAA8B;IAE9B,MAAM,WAAW,GAAG,WAAW,EAAE,OAAO,CAAC;IACzC,IAAI,qBAAqB,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpD,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,SAAS,IAAI,SAAS,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEnE,MAAM,UAAU,GAAG,WAAW,EAAE,MAAM,CAAC;IACvC,IAAI,UAAU,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtE,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,OAAO,CAAC,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAS,EACT,YAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,QAAQ,CAAC,QAAQ,GAAG,EAAE,CAAC;IAE9D,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,CAAC;IAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,SAAS,IAAI,SAAS,CAAC,CAAC;IAE/D,IACE,QAAQ,KAAK,WAAW;QACxB,0BAA0B,CAAC,OAAO,EAAE,YAAY,CAAC,EACjD,CAAC;QACD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS;YACtC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE;YACzC,CAAC,CAAC,YAAY,CAAC;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GACZ,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAChE,EAAE,EAAE,IAAI,IAAI,CAAC;YACjB,CAAC,CAAC,IAAI,CAAC;QACX,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAS;IAIzC,MAAM,IAAI,GAAG,IAAI,EAAE,QAAQ,CAAC;IAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAC3C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAEpC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,6FAA6F;QAC7F,MAAM,GAAG,GAAG,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAC1C,CAAC,CAAC,GAAG,CAAC,OAAO;iBACR,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;iBACrC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBACvB,IAAI,CAAC,GAAG,CAAC;YACd,CAAC,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;gBAC/B,CAAC,CAAC,GAAG,CAAC,OAAO;gBACb,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK;gBAAE,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClD,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC","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\ninterface BuildAssistantMessageOptions {\n  suppressInternalContinuation?: boolean;\n}\n\ntype AssistantMessage = NonNullable<ReturnType<typeof buildAssistantMessage>>;\n\nfunction isInternalContinuationError(event: {\n  error: string;\n  errorCode?: string;\n  recoverable?: boolean;\n}): boolean {\n  const code = String(event.errorCode ?? \"\").toLowerCase();\n  const msg = event.error.toLowerCase();\n  return (\n    event.recoverable === true ||\n    code === \"builder_gateway_timeout\" ||\n    code === \"stale_run\" ||\n    code === \"timeout\" ||\n    code === \"timeout_error\" ||\n    code === \"http_408\" ||\n    code === \"http_429\" ||\n    code === \"http_500\" ||\n    code === \"http_502\" ||\n    code === \"http_503\" ||\n    code === \"http_504\" ||\n    code === \"rate_limited\" ||\n    code === \"too_many_concurrent_requests\" ||\n    code === \"overloaded_error\" ||\n    msg.includes(\"timeout\") ||\n    msg.includes(\"gateway timeout\") ||\n    msg.includes(\"inactivity timeout\") ||\n    msg.includes(\"stream ended\") ||\n    msg.includes(\"stream closed\") ||\n    msg.includes(\"temporarily unavailable\") ||\n    msg.includes(\"502\") ||\n    msg.includes(\"503\") ||\n    msg.includes(\"504\") ||\n    msg.includes(\"529\")\n  );\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  options: BuildAssistantMessageOptions = {},\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 runError: {\n    message: string;\n    errorCode?: string;\n    details?: string;\n    recoverable?: boolean;\n  } | null = null;\n  let endedAtInternalContinuationBoundary = false;\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      // Older servers emitted this as a user-visible terminal event. Treat it\n      // as an internal continuation boundary when rebuilding persisted turns.\n      if (options.suppressInternalContinuation) {\n        endedAtInternalContinuationBoundary = true;\n      }\n      continue;\n    }\n\n    if (event.type === \"auto_continue\") {\n      if (options.suppressInternalContinuation) {\n        endedAtInternalContinuationBoundary = true;\n      }\n      continue;\n    }\n\n    if (event.type === \"error\") {\n      if (\n        options.suppressInternalContinuation &&\n        isInternalContinuationError(event)\n      ) {\n        endedAtInternalContinuationBoundary = true;\n        continue;\n      }\n      if (event.errorCode === \"run_timeout\" && event.recoverable) {\n        continue;\n      }\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 || endedAtInternalContinuationBoundary) return null;\n\n  const metadata: Record<string, unknown> = {};\n  if (runId) metadata.runId = runId;\n  if (runError) {\n    metadata.custom = {\n      runError: {\n        ...runError,\n        ...(runId ? { runId } : {}),\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\nfunction getStoredMessage(entry: any): any {\n  return entry?.message ?? entry;\n}\n\nfunction getMessageRunId(message: any): string | undefined {\n  const meta = message?.metadata;\n  const direct = meta?.runId;\n  const custom = meta?.custom?.runId;\n  const errorRun = meta?.custom?.runError?.runId ?? meta?.runError?.runId;\n  if (typeof direct === \"string\") return direct;\n  if (typeof custom === \"string\") return custom;\n  if (typeof errorRun === \"string\") return errorRun;\n  return undefined;\n}\n\nfunction messageContentIsEmpty(content: unknown): boolean {\n  if (Array.isArray(content)) return content.length === 0;\n  return content == null || content === \"\";\n}\n\nfunction messageText(content: unknown): string {\n  if (typeof content === \"string\") return content;\n  if (!Array.isArray(content)) return \"\";\n  return content\n    .filter(\n      (part: any) => part?.type === \"text\" && typeof part.text === \"string\",\n    )\n    .map((part: any) => part.text)\n    .join(\"\");\n}\n\nfunction isTerminalAssistantStatus(status: unknown): boolean {\n  const type = (status as { type?: unknown } | undefined)?.type;\n  return type === \"complete\" || type === \"incomplete\";\n}\n\nfunction shouldReplaceLastAssistant(\n  lastMessage: any,\n  assistantMsg: AssistantMessage,\n): boolean {\n  const lastContent = lastMessage?.content;\n  if (messageContentIsEmpty(lastContent)) return true;\n\n  const lastRunId = getMessageRunId(lastMessage);\n  const nextRunId = getMessageRunId(assistantMsg);\n  if (lastRunId && nextRunId && lastRunId === nextRunId) return true;\n\n  const lastStatus = lastMessage?.status;\n  if (lastStatus && !isTerminalAssistantStatus(lastStatus)) return true;\n\n  try {\n    if (JSON.stringify(lastContent) === JSON.stringify(assistantMsg.content)) {\n      return true;\n    }\n  } catch {\n    // Fall through to the text-prefix check.\n  }\n\n  const lastText = messageText(lastContent).trim();\n  const nextText = messageText(assistantMsg.content).trim();\n  return Boolean(lastText && nextText && nextText.startsWith(lastText));\n}\n\n/**\n * Merge the server-reconstructed assistant message into persisted\n * assistant-ui thread data.\n *\n * The browser periodically saves thread data while a run is still streaming.\n * That can leave the last assistant message non-empty but partial/pending.\n * Completion must replace that same-run partial message instead of treating\n * any assistant content as proof that the frontend already saved the final\n * turn.\n */\nexport function upsertAssistantMessage(\n  repo: any,\n  assistantMsg: AssistantMessage,\n): any {\n  const nextRepo = repo && typeof repo === \"object\" ? repo : {};\n  if (!Array.isArray(nextRepo.messages)) nextRepo.messages = [];\n\n  const lastIndex = nextRepo.messages.length - 1;\n  const lastEntry = lastIndex >= 0 ? nextRepo.messages[lastIndex] : undefined;\n  const lastMsg = getStoredMessage(lastEntry);\n  const lastRole = lastMsg?.role;\n  const isWrapped = Boolean(lastEntry && \"message\" in lastEntry);\n\n  if (\n    lastRole === \"assistant\" &&\n    shouldReplaceLastAssistant(lastMsg, assistantMsg)\n  ) {\n    nextRepo.messages[lastIndex] = isWrapped\n      ? { ...lastEntry, message: assistantMsg }\n      : assistantMsg;\n    return nextRepo;\n  }\n\n  if (isWrapped) {\n    const parentId =\n      nextRepo.messages.length > 0\n        ? (getStoredMessage(nextRepo.messages[nextRepo.messages.length - 1])\n            ?.id ?? null)\n        : null;\n    nextRepo.messages.push({ message: assistantMsg, parentId });\n  } else {\n    nextRepo.messages.push(assistantMsg);\n  }\n  return nextRepo;\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/cli/create.d.ts

@@ -1,4 +1,13 @@
 import { parseWorkspaceScope } from "./workspacify.js";
+/**
+ * Tagged error for input that fails CLI-level validation (repo names, app
+ * names, etc.). The Sentry `beforeSend` hook in cli/index.ts drops events
+ * whose top-level exception type is `ValidationError` so we don't pollute
+ * Sentry with expected user-input rejections.
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
 export interface CreateAppOptions {
     /** Pre-select these templates in the picker. Comma-separated string or array. */
     template?: string;

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;AA+CvE,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;AAmJD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAwCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAsCf;AAgID;;;;;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,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAqEN;AA2HD;;;;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,kBAAkB,IAAI,mBAAmB,EACzC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,EAC7C,8BAA8B,IAAI,+BAA+B,EACjE,uBAAuB,IAAI,wBAAwB,GACpD,CAAC;AAsFF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAeN;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAW1C;AAcD;;;;;;;;;;;GAWG;AACH,iBAAS,8BAA8B,IAAI,MAAM,EAAE,CASlD;AAED;;qDAEqD;AACrD,iBAAS,oBAAoB,IAAI,MAAM,CAEtC;AAgID,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,IAAI,CA0CN;AAqED,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAyED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CA0BxE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAmBvE;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AA8BD,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;AAqJD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAwCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAsCf;AAoID;;;;;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,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAqEN;AA2HD;;;;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,kBAAkB,IAAI,mBAAmB,EACzC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,EAC7C,8BAA8B,IAAI,+BAA+B,EACjE,uBAAuB,IAAI,wBAAwB,GACpD,CAAC;AAsFF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAeN;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAW1C;AAcD;;;;;;;;;;;GAWG;AACH,iBAAS,8BAA8B,IAAI,MAAM,EAAE,CASlD;AAED;;qDAEqD;AACrD,iBAAS,oBAAoB,IAAI,MAAM,CAEtC;AAoID,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,IAAI,CA0CN;AAqED,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAyED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CA0BxE"}

package/dist/cli/create.js

@@ -11,6 +11,18 @@ const __dirname = path.dirname(__filename);
 const REPO = "BuilderIO/agent-native";
 const TEMPLATES_DIR = "templates";
 const POSTGRES_DEPENDENCY_VERSION = "^3.4.9";
+/**
+ * Tagged error for input that fails CLI-level validation (repo names, app
+ * names, etc.). The Sentry `beforeSend` hook in cli/index.ts drops events
+ * whose top-level exception type is `ValidationError` so we don't pollute
+ * Sentry with expected user-input rejections.
+ */
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ValidationError";
+    }
+}
 /**
  * Move "starter" to the top of the list so it lines up with clack's default
  * highlight on the first option — otherwise users have to scroll to see that
@@ -88,14 +100,14 @@ async function createWorkspaceInteractive(name, opts, clack) {
             ]
             : [
                 "Dispatch is recommended for most workspaces. You can add it later",
-                "with `agent-native add-app --template=dispatch` if you skip it now.",
+                "with `npx @agent-native/core add-app --template=dispatch` if you skip it now.",
             ];
     clack.note([
         `You're creating a workspace named "${name}". A workspace is a monorepo`,
         "container — it isn't an app itself. Inside it you pick one or more apps",
         "(below), and each app gets its own route, agent, and UI. Apps in the",
         "same workspace share auth, database, and the agent chat. Add more apps",
-        "later with `agent-native add-app`. Starter is a minimal scaffold —",
+        "later with `npx @agent-native/core add-app`. Starter is a minimal scaffold —",
         "useful as a blank app to build from scratch alongside the others.",
         ...dispatchRecommendation,
     ].join("\n"), "About workspaces");
@@ -118,7 +130,7 @@ async function createWorkspaceInteractive(name, opts, clack) {
         process.exit(1);
     }
     const s = clack.spinner();
-    s.start(`Scaffolding workspace with ${templates.length} app(s)...`);
+    s.start(`Preparing env... scaffolding workspace with ${templates.length} app(s).`);
     const firstApp = templates[0];
     try {
         await scaffoldWorkspaceRoot(targetDir, name);
@@ -182,8 +194,8 @@ async function createWorkspaceInteractive(name, opts, clack) {
         ``,
         ...dispatchNextStep,
         ``,
-        `Add another app later:        agent-native add-app`,
-        `Deploy the whole workspace:   agent-native deploy`,
+        `Add another app later:        npx @agent-native/core add-app`,
+        `Deploy the whole workspace:   pnpm exec agent-native deploy`,
     ].join("\n"));
 }
 async function scaffoldWorkspaceRoot(targetDir, name) {
@@ -263,7 +275,11 @@ export async function addAppToWorkspace(name, opts) {
     }
 }
 async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, clack) {
-    validateWorkspaceAppName(appName, clack);
+    // Dispatch is the one reserved-route exception: the canonical workspace
+    // control-plane app intentionally owns /dispatch.
+    validateWorkspaceAppName(appName, clack, {
+        allowDispatch: appName === "dispatch" && templateName === "dispatch",
+    });
     const appsDir = path.join(workspace.workspaceRoot, "apps");
     fs.mkdirSync(appsDir, { recursive: true });
     const appDir = path.join(appsDir, appName);
@@ -272,7 +288,7 @@ async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, cla
         process.exit(1);
     }
     const s = clack.spinner();
-    s.start(`Scaffolding apps/${appName} from ${templateName}...`);
+    s.start(`Preparing env... scaffolding apps/${appName} from ${templateName}.`);
     try {
         await scaffoldAppTemplate(appDir, templateName);
         replacePlaceholders(appDir, appName, titleCase(appName), path.basename(workspace.workspaceRoot));
@@ -342,7 +358,7 @@ async function createStandaloneApp(name, opts, clack) {
         template = picked;
     }
     const s = clack.spinner();
-    s.start("Scaffolding your app...");
+    s.start("Preparing env... scaffolding your app.");
     try {
         await scaffoldAppTemplate(targetDir, template);
         postProcessStandalone(name, targetDir, template);
@@ -713,7 +729,7 @@ export { scaffoldWorkspaceRoot as _scaffoldWorkspaceRoot, scaffoldAppTemplate as
  * ───────────────────────────────────────────────────────────────────────── */
 function validateRepoName(repo) {
     if (!/^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/.test(repo)) {
-        throw new Error(`Invalid repository name "${repo}". Expected format: user/repo`);
+        throw new ValidationError(`Invalid repository name "${repo}". Expected format: user/repo`);
     }
 }
 function downloadAndExtract(url, destDir) {
@@ -901,8 +917,10 @@ function rewriteCoreDependencyVersions(projectDir) {
     }
     catch { }
 }
-function validateWorkspaceAppName(appName, clack) {
-    const error = getWorkspaceAppIdValidationError(appName);
+function validateWorkspaceAppName(appName, clack, opts) {
+    const error = opts?.allowDispatch && appName === "dispatch"
+        ? null
+        : getWorkspaceAppIdValidationError(appName);
     if (error) {
         clack.cancel(error);
         process.exit(1);