@agent-native/core 0.8.0 → 0.8.2

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

@@ -1,12 +1,41 @@
+function isInternalContinuationError(event) {
+    const code = String(event.errorCode ?? "").toLowerCase();
+    const msg = event.error.toLowerCase();
+    return (event.recoverable === true ||
+        code === "builder_gateway_timeout" ||
+        code === "stale_run" ||
+        code === "timeout" ||
+        code === "timeout_error" ||
+        code === "http_408" ||
+        code === "http_429" ||
+        code === "http_500" ||
+        code === "http_502" ||
+        code === "http_503" ||
+        code === "http_504" ||
+        code === "rate_limited" ||
+        code === "too_many_concurrent_requests" ||
+        code === "overloaded_error" ||
+        msg.includes("timeout") ||
+        msg.includes("gateway timeout") ||
+        msg.includes("inactivity timeout") ||
+        msg.includes("stream ended") ||
+        msg.includes("stream closed") ||
+        msg.includes("temporarily unavailable") ||
+        msg.includes("502") ||
+        msg.includes("503") ||
+        msg.includes("504") ||
+        msg.includes("529"));
+}
 /**
  * Reconstruct an assistant-ui message from raw agent run events.
  * Mirrors the client-side processEvent logic so the server can persist
  * the assistant's response even if the frontend is disconnected.
  */
-export function buildAssistantMessage(events, runId) {
+export function buildAssistantMessage(events, runId, options = {}) {
     const content = [];
     let toolCallCounter = 0;
     let runError = null;
+    let endedAtInternalContinuationBoundary = false;
     const appendText = (text) => {
         const last = content[content.length - 1];
         if (last && last.type === "text") {
@@ -53,12 +82,23 @@ export function buildAssistantMessage(events, runId) {
         if (event.type === "loop_limit") {
             // Older servers emitted this as a user-visible terminal event. Treat it
             // as an internal continuation boundary when rebuilding persisted turns.
+            if (options.suppressInternalContinuation) {
+                endedAtInternalContinuationBoundary = true;
+            }
             continue;
         }
         if (event.type === "auto_continue") {
+            if (options.suppressInternalContinuation) {
+                endedAtInternalContinuationBoundary = true;
+            }
             continue;
         }
         if (event.type === "error") {
+            if (options.suppressInternalContinuation &&
+                isInternalContinuationError(event)) {
+                endedAtInternalContinuationBoundary = true;
+                continue;
+            }
             if (event.errorCode === "run_timeout" && event.recoverable) {
                 continue;
             }
@@ -73,7 +113,7 @@ export function buildAssistantMessage(events, runId) {
         }
         // done, missing_api_key — terminal signals, not content
     }
-    if (content.length === 0)
+    if (content.length === 0 || endedAtInternalContinuationBoundary)
         return null;
     const metadata = {};
     if (runId)

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:\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\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      continue;\n    }\n\n    if (event.type === \"auto_continue\") {\n      continue;\n    }\n\n    if (event.type === \"error\") {\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) 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":"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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"]}

package/dist/cli/create.d.ts

@@ -56,7 +56,7 @@ export declare function detectWorkspace(startDir: string): {
 } | null;
 export { parseWorkspaceScope };
 /** @internal — exported for E2E tests */
-export { scaffoldWorkspaceRoot as _scaffoldWorkspaceRoot, scaffoldAppTemplate as _scaffoldAppTemplate, scaffoldRequiredPackages as _scaffoldRequiredPackages, postProcessStandalone as _postProcessStandalone, loadCatalog as _loadCatalog, fixPackageJsonName as _fixPackageJsonName, renameGitignore as _renameGitignore, rewriteNetlifyToml as _rewriteNetlifyToml, getCoreDependencyVersion as _getCoreDependencyVersion, getGitHubTemplateRef as _getGitHubTemplateRef, shouldSkipScaffoldEntry as _shouldSkipScaffoldEntry, };
+export { scaffoldWorkspaceRoot as _scaffoldWorkspaceRoot, scaffoldAppTemplate as _scaffoldAppTemplate, scaffoldRequiredPackages as _scaffoldRequiredPackages, postProcessStandalone as _postProcessStandalone, loadCatalog as _loadCatalog, fixPackageJsonName as _fixPackageJsonName, renameGitignore as _renameGitignore, rewriteNetlifyToml as _rewriteNetlifyToml, getCoreDependencyVersion as _getCoreDependencyVersion, getGitHubTemplateRef as _getGitHubTemplateRef, getGitHubTemplateRefCandidates as _getGitHubTemplateRefCandidates, shouldSkipScaffoldEntry as _shouldSkipScaffoldEntry, };
 /**
  * Load the pnpm workspace catalog.
  * First tries the build-time snapshot at dist/catalog.json (works when
@@ -66,6 +66,22 @@ export { scaffoldWorkspaceRoot as _scaffoldWorkspaceRoot, scaffoldAppTemplate as
 declare function loadCatalog(): Record<string, string>;
 declare function fixPackageJsonName(appDir: string, name: string, templateName?: string): void;
 declare function getCoreDependencyVersion(): string;
+/**
+ * Git refs to try, in priority order, when downloading templates from the
+ * framework repo. The release tag scheme has shifted over time:
+ *
+ *   - ≤ 0.7.83: single repo-wide tag `v<version>` (legacy).
+ *   - ≥ 0.8.0:  changesets per-package tags
+ *               `@agent-native/core@<version>` (current).
+ *
+ * `main` is the final fallback so dev builds and brand-new releases (where
+ * the tag has not propagated yet) still work — at the cost of pulling
+ * potentially newer template code than the running CLI was built against.
+ */
+declare function getGitHubTemplateRefCandidates(): string[];
+/** @deprecated Kept for backward-compatible test imports. Returns the
+ *  highest-priority candidate; callers that need the full fallback list
+ *  should use `getGitHubTemplateRefCandidates()`. */
 declare function getGitHubTemplateRef(): string;
 declare function rewriteNetlifyToml(appDir: string, appName: string, mode: "standalone" | "workspace"): void;
 declare function renameGitignore(dir: string): void;

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,uBAAuB,IAAI,wBAAwB,GACpD,CAAC;AAkEF;;;;;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,iBAAS,oBAAoB,IAAI,MAAM,CAMtC;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;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"}

package/dist/cli/create.js

@@ -707,7 +707,7 @@ export function detectWorkspace(startDir) {
 }
 export { parseWorkspaceScope };
 /** @internal — exported for E2E tests */
-export { scaffoldWorkspaceRoot as _scaffoldWorkspaceRoot, scaffoldAppTemplate as _scaffoldAppTemplate, scaffoldRequiredPackages as _scaffoldRequiredPackages, postProcessStandalone as _postProcessStandalone, loadCatalog as _loadCatalog, fixPackageJsonName as _fixPackageJsonName, renameGitignore as _renameGitignore, rewriteNetlifyToml as _rewriteNetlifyToml, getCoreDependencyVersion as _getCoreDependencyVersion, getGitHubTemplateRef as _getGitHubTemplateRef, shouldSkipScaffoldEntry as _shouldSkipScaffoldEntry, };
+export { scaffoldWorkspaceRoot as _scaffoldWorkspaceRoot, scaffoldAppTemplate as _scaffoldAppTemplate, scaffoldRequiredPackages as _scaffoldRequiredPackages, postProcessStandalone as _postProcessStandalone, loadCatalog as _loadCatalog, fixPackageJsonName as _fixPackageJsonName, renameGitignore as _renameGitignore, rewriteNetlifyToml as _rewriteNetlifyToml, getCoreDependencyVersion as _getCoreDependencyVersion, getGitHubTemplateRef as _getGitHubTemplateRef, getGitHubTemplateRefCandidates as _getGitHubTemplateRefCandidates, shouldSkipScaffoldEntry as _shouldSkipScaffoldEntry, };
 /* ─────────────────────────────────────────────────────────────────────────
  * Download / copy helpers
  * ───────────────────────────────────────────────────────────────────────── */
@@ -718,7 +718,10 @@ function validateRepoName(repo) {
 }
 function downloadAndExtract(url, destDir) {
     fs.mkdirSync(destDir, { recursive: true });
-    const tarball = execFileSync("curl", ["-sL", url], {
+    // --fail-with-body so curl exits non-zero on HTTP 4xx/5xx instead of writing
+    // the error body (HTML/JSON) to disk where tar then fails with the opaque
+    // "Unrecognized archive format" message.
+    const tarball = execFileSync("curl", ["--fail-with-body", "-sL", url], {
         maxBuffer: 100 * 1024 * 1024,
     });
     const tarPath = path.join(destDir, ".download.tar.gz");
@@ -732,20 +735,28 @@ function downloadAndExtract(url, destDir) {
 }
 async function downloadGitHubSubdir(repo, subdir, targetDir) {
     validateRepoName(repo);
-    const ref = getGitHubTemplateRef();
-    const tarUrl = `https://api.github.com/repos/${repo}/tarball/${encodeURIComponent(ref)}`;
-    const tmpDir = path.join(targetDir, "..", `.agent-native-tmp-${Date.now()}`);
-    try {
-        downloadAndExtract(tarUrl, tmpDir);
-        const srcDir = path.join(tmpDir, subdir);
-        if (!fs.existsSync(srcDir)) {
-            throw new Error(`Template directory "${subdir}" not found in ${repo}.`);
+    const refs = getGitHubTemplateRefCandidates();
+    const errors = [];
+    for (const ref of refs) {
+        const tarUrl = `https://api.github.com/repos/${repo}/tarball/${encodeURIComponent(ref)}`;
+        const tmpDir = path.join(targetDir, "..", `.agent-native-tmp-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+        try {
+            downloadAndExtract(tarUrl, tmpDir);
+            const srcDir = path.join(tmpDir, subdir);
+            if (!fs.existsSync(srcDir)) {
+                throw new Error(`Template directory "${subdir}" not found at ref "${ref}".`);
+            }
+            copyDir(srcDir, targetDir);
+            return;
+        }
+        catch (err) {
+            errors.push(`  ${ref}: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`);
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
         }
-        copyDir(srcDir, targetDir);
-    }
-    finally {
-        fs.rmSync(tmpDir, { recursive: true, force: true });
     }
+    throw new Error(`Failed to download templates from ${repo}. Tried refs:\n${errors.join("\n")}`);
 }
 async function downloadGitHubRepo(repo, targetDir) {
     validateRepoName(repo);
@@ -842,12 +853,33 @@ function getCorePackageVersion() {
         return undefined;
     }
 }
-function getGitHubTemplateRef() {
+/**
+ * Git refs to try, in priority order, when downloading templates from the
+ * framework repo. The release tag scheme has shifted over time:
+ *
+ *   - ≤ 0.7.83: single repo-wide tag `v<version>` (legacy).
+ *   - ≥ 0.8.0:  changesets per-package tags
+ *               `@agent-native/core@<version>` (current).
+ *
+ * `main` is the final fallback so dev builds and brand-new releases (where
+ * the tag has not propagated yet) still work — at the cost of pulling
+ * potentially newer template code than the running CLI was built against.
+ */
+function getGitHubTemplateRefCandidates() {
     const version = getCorePackageVersion();
+    const candidates = [];
     if (version && /^\d+\.\d+\.\d+(?:-.+)?$/.test(version)) {
-        return `v${version}`;
+        candidates.push(`@agent-native/core@${version}`);
+        candidates.push(`v${version}`);
     }
-    return "main";
+    candidates.push("main");
+    return candidates;
+}
+/** @deprecated Kept for backward-compatible test imports. Returns the
+ *  highest-priority candidate; callers that need the full fallback list
+ *  should use `getGitHubTemplateRefCandidates()`. */
+function getGitHubTemplateRef() {
+    return getGitHubTemplateRefCandidates()[0];
 }
 function rewriteCoreDependencyVersions(projectDir) {
     const pkgPath = path.join(projectDir, "package.json");