@agent-native/core 0.51.4 → 0.51.6

package/dist/cli/templates-meta.js

@@ -31,7 +31,7 @@ export const TEMPLATES = [
     {
         name: "content",
         label: "Content",
-        hint: "Agent-native Notion/Google Docs — write and organize with agent assistance",
+        hint: "Open-source Obsidian for MDX — edit local docs with agent assistance",
         icon: "FileText",
         color: "#10B981",
         colorRgb: "16 185 129",

package/dist/cli/templates-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates-meta.js","sourceRoot":"","sources":["../../src/cli/templates-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAqCH,MAAM,CAAC,MAAM,SAAS,GAAmB;IACvC;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,wEAAwE;QAC9E,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EAAE,MAAM;QACnB,gBAAgB,EAAE,CAAC,YAAY,CAAC;QAChC,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,4EAA4E;QAClF,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,uGAAuG;QAC7G,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,+BAA+B;QACxC,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,oEAAoE;QAC1E,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EAAE,MAAM;QACnB,gBAAgB,EAAE,CAAC,UAAU,CAAC;QAC9B,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,0CAA0C;QAChD,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EAAE,MAAM;QACnB,gBAAgB,EAAE,CAAC,UAAU,CAAC;KAC/B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,2EAA2E;QACjF,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,oCAAoC;QAC7C,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,8EAA8E;QACpF,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,+BAA+B;QACxC,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,gFAAgF;QACtF,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,4DAA4D;QAClE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,qEAAqE;QAC3E,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,MAAM;QACnB,eAAe,EAAE,IAAI;QACrB,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;KACb;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,oEAAoE;QAC1E,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,0EAA0E;QAChF,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,iFAAiF;QACvF,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EAAE,MAAM;QACnB,gBAAgB,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;QAC3C,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,2FAA2F;QACjG,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,IAAI;KACX;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,0CAA0C;QAChD,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,iCAAiC;QAC1C,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,KAAK;KACnB;CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,qCAAqC;IACrC,IAAI,IAAI,KAAK,OAAO;QAAE,IAAI,GAAG,QAAQ,CAAC;IACtC,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9D,IAAI,GAAG,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc;QAAE,IAAI,GAAG,MAAM,CAAC;IACnE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC","sourcesContent":["/**\n * First-party template metadata used by the `agent-native` CLI.\n *\n * This file is intentionally inlined here (rather than imported from a\n * separate workspace package) so that the published `@agent-native/core`\n * has no `workspace:*` runtime dependencies. Without this inlining, `npx\n * @agent-native/core create ...` fails on a fresh machine with:\n *\n *   npm error code EUNSUPPORTEDPROTOCOL\n *   npm error Unsupported URL Type \"workspace:\": workspace:*\n *\n * Keep this list in sync with `packages/shared-app-config/templates.ts`,\n * which serves the same metadata to the desktop / mobile / frame packages\n * that always run inside the workspace. Duplication is intentional: the\n * CLI must remain installable outside the monorepo.\n */\n\nexport interface TemplateMeta {\n  /** Directory name under templates/ and package name */\n  name: string;\n  /** Display name in pickers */\n  label: string;\n  /** One-line description shown in the picker */\n  hint: string;\n  /** Longer description (optional) */\n  description?: string;\n  /** Tabler icon name used in the desktop sidebar */\n  icon: string;\n  /** Hex accent color */\n  color: string;\n  /** CSS-safe RGB triplet (e.g. \"59 130 246\") */\n  colorRgb: string;\n  /** Dev server port for desktop `pnpm dev` */\n  devPort: number;\n  /** Production URL when running as a first-party app on agent-native.com */\n  prodUrl?: string;\n  /** Default URL path when deployed in a workspace (defaults to \"/<name>\") */\n  prodPath?: string;\n  /** Default mode when added to desktop app */\n  defaultMode?: \"dev\" | \"prod\";\n  /** Hide from pickers but still scaffoldable via explicit --template */\n  hidden?: boolean;\n  /** Include as a built-in connected A2A agent even when hidden from pickers */\n  defaultAgent?: boolean;\n  /** Always scaffold without prompting (e.g. starter as fallback) */\n  alwaysAvailable?: boolean;\n  /** Internal workspace packages this template depends on (e.g. \"scheduling\") */\n  requiredPackages?: string[];\n  /** Core app — featured in the CLI picker, homepage, and docs gallery */\n  core?: boolean;\n}\n\nexport const TEMPLATES: TemplateMeta[] = [\n  {\n    name: \"calendar\",\n    label: \"Calendar\",\n    hint: \"Agent-native Google Calendar — manage events, sync, and public booking\",\n    icon: \"CalendarDays\",\n    color: \"#00B5FF\",\n    colorRgb: \"0 181 255\",\n    devPort: 8082,\n    prodUrl: \"https://calendar.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"scheduling\"],\n    core: true,\n  },\n  {\n    name: \"content\",\n    label: \"Content\",\n    hint: \"Agent-native Notion/Google Docs — write and organize with agent assistance\",\n    icon: \"FileText\",\n    color: \"#10B981\",\n    colorRgb: \"16 185 129\",\n    devPort: 8083,\n    prodUrl: \"https://content.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"plan\",\n    label: \"Plan\",\n    hint: \"Structured visual plans and PR recaps with diagrams, wireframes, prototypes, annotations, and sharing\",\n    icon: \"FileText\",\n    color: \"#52525B\",\n    colorRgb: \"82 82 91\",\n    devPort: 8105,\n    prodUrl: \"https://plan.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"slides\",\n    label: \"Slides\",\n    hint: \"Agent-native Google Slides — generate and edit React presentations\",\n    icon: \"GalleryHorizontal\",\n    color: \"#EC4899\",\n    colorRgb: \"236 72 153\",\n    devPort: 8086,\n    prodUrl: \"https://slides.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"pinpoint\"],\n    core: true,\n  },\n  {\n    name: \"videos\",\n    label: \"Video\",\n    hint: \"Agent-native video editing with Remotion\",\n    icon: \"Video\",\n    color: \"#EF4444\",\n    colorRgb: \"239 68 68\",\n    devPort: 8087,\n    prodUrl: \"https://videos.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"pinpoint\"],\n  },\n  {\n    name: \"analytics\",\n    label: \"Analytics\",\n    hint: \"Agent-native Amplitude/Mixpanel — connect data sources, prompt for charts\",\n    icon: \"BarChart2\",\n    color: \"#F59E0B\",\n    colorRgb: \"245 158 11\",\n    devPort: 8088,\n    prodUrl: \"https://analytics.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"mail\",\n    label: \"Mail\",\n    hint: \"Agent-native Superhuman — email client with keyboard shortcuts and AI triage\",\n    icon: \"Mail\",\n    color: \"#3B82F6\",\n    colorRgb: \"59 130 246\",\n    devPort: 8085,\n    prodUrl: \"https://mail.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"dispatch\",\n    label: \"Dispatch\",\n    hint: \"Central Slack/Telegram router with jobs, memory, approvals, and A2A delegation\",\n    icon: \"MessageCircle\",\n    color: \"#14B8A6\",\n    colorRgb: \"20 184 166\",\n    devPort: 8092,\n    prodUrl: \"https://dispatch.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"forms\",\n    label: \"Forms\",\n    hint: \"Agent-native form builder — create, edit, and manage forms\",\n    icon: \"ClipboardList\",\n    color: \"#06B6D4\",\n    colorRgb: \"6 182 212\",\n    devPort: 8084,\n    prodUrl: \"https://forms.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"starter\",\n    label: \"Starter\",\n    hint: \"Minimal scaffold with the agent chat and core architecture wired up\",\n    icon: \"Code\",\n    color: \"#71717A\",\n    colorRgb: \"113 113 122\",\n    devPort: 8089,\n    prodUrl: \"https://starter.agent-native.com\",\n    defaultMode: \"prod\",\n    alwaysAvailable: true,\n    core: true,\n    hidden: true,\n  },\n  {\n    name: \"clips\",\n    label: \"Clips\",\n    hint: \"Screen recording, meeting notes, and voice dictation — all with AI\",\n    icon: \"ScreenShare\",\n    color: \"#0EA5E9\",\n    colorRgb: \"14 165 233\",\n    devPort: 8094,\n    prodUrl: \"https://clips.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"brain\",\n    label: \"Brain\",\n    hint: \"Cited company knowledge from Slack, meetings, transcripts, and decisions\",\n    icon: \"Brain\",\n    color: \"#8B5CF6\",\n    colorRgb: \"139 92 246\",\n    devPort: 8102,\n    prodUrl: \"https://brain.agent-native.com\",\n    defaultMode: \"prod\",\n    defaultAgent: true,\n    core: true,\n  },\n  {\n    name: \"design\",\n    label: \"Design\",\n    hint: \"Agent-native design tool — create and edit visual designs with agent assistance\",\n    icon: \"Brush\",\n    color: \"#F472B6\",\n    colorRgb: \"244 114 182\",\n    devPort: 8099,\n    prodUrl: \"https://design.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"pinpoint\", \"embedding\"],\n    core: true,\n  },\n  {\n    name: \"assets\",\n    label: \"Assets\",\n    hint: \"Digital asset manager — upload, organize, search, and generate on-brand images and videos\",\n    icon: \"Photo\",\n    color: \"#0F766E\",\n    colorRgb: \"15 118 110\",\n    devPort: 8100,\n    prodUrl: \"https://assets.agent-native.com\",\n    defaultMode: \"prod\",\n    defaultAgent: true,\n    core: true,\n  },\n  {\n    name: \"macros\",\n    label: \"Macros\",\n    hint: \"Internal template — not shown in pickers\",\n    icon: \"Code\",\n    color: \"#71717A\",\n    colorRgb: \"113 113 122\",\n    devPort: 8093,\n    prodUrl: \"https://macros.agent-native.com\",\n    hidden: true,\n    defaultMode: \"dev\",\n  },\n];\n\n/** Return templates visible in user-facing pickers (excludes hidden). */\nexport function visibleTemplates(): TemplateMeta[] {\n  return TEMPLATES.filter((t) => !t.hidden);\n}\n\n/** Return core templates — the featured set shown in CLI pickers by default. */\nexport function coreTemplates(): TemplateMeta[] {\n  return TEMPLATES.filter((t) => t.core);\n}\n\n/** Lookup by name. Returns undefined for unknown names. */\nexport function getTemplate(name: string): TemplateMeta | undefined {\n  // Tolerate legacy / renamed aliases.\n  if (name === \"video\") name = \"videos\";\n  if (name === \"image\" || name === \"images\" || name === \"asset\") {\n    name = \"assets\";\n  }\n  if (name === \"contracts\" || name === \"visual-plans\") name = \"plan\";\n  return TEMPLATES.find((t) => t.name === name);\n}\n\n/** Names of all templates (including hidden) for validation. */\nexport function allTemplateNames(): string[] {\n  return TEMPLATES.map((t) => t.name);\n}\n"]}
+{"version":3,"file":"templates-meta.js","sourceRoot":"","sources":["../../src/cli/templates-meta.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * First-party template metadata used by the `agent-native` CLI.\n *\n * This file is intentionally inlined here (rather than imported from a\n * separate workspace package) so that the published `@agent-native/core`\n * has no `workspace:*` runtime dependencies. Without this inlining, `npx\n * @agent-native/core create ...` fails on a fresh machine with:\n *\n *   npm error code EUNSUPPORTEDPROTOCOL\n *   npm error Unsupported URL Type \"workspace:\": workspace:*\n *\n * Keep this list in sync with `packages/shared-app-config/templates.ts`,\n * which serves the same metadata to the desktop / mobile / frame packages\n * that always run inside the workspace. Duplication is intentional: the\n * CLI must remain installable outside the monorepo.\n */\n\nexport interface TemplateMeta {\n  /** Directory name under templates/ and package name */\n  name: string;\n  /** Display name in pickers */\n  label: string;\n  /** One-line description shown in the picker */\n  hint: string;\n  /** Longer description (optional) */\n  description?: string;\n  /** Tabler icon name used in the desktop sidebar */\n  icon: string;\n  /** Hex accent color */\n  color: string;\n  /** CSS-safe RGB triplet (e.g. \"59 130 246\") */\n  colorRgb: string;\n  /** Dev server port for desktop `pnpm dev` */\n  devPort: number;\n  /** Production URL when running as a first-party app on agent-native.com */\n  prodUrl?: string;\n  /** Default URL path when deployed in a workspace (defaults to \"/<name>\") */\n  prodPath?: string;\n  /** Default mode when added to desktop app */\n  defaultMode?: \"dev\" | \"prod\";\n  /** Hide from pickers but still scaffoldable via explicit --template */\n  hidden?: boolean;\n  /** Include as a built-in connected A2A agent even when hidden from pickers */\n  defaultAgent?: boolean;\n  /** Always scaffold without prompting (e.g. starter as fallback) */\n  alwaysAvailable?: boolean;\n  /** Internal workspace packages this template depends on (e.g. \"scheduling\") */\n  requiredPackages?: string[];\n  /** Core app — featured in the CLI picker, homepage, and docs gallery */\n  core?: boolean;\n}\n\nexport const TEMPLATES: TemplateMeta[] = [\n  {\n    name: \"calendar\",\n    label: \"Calendar\",\n    hint: \"Agent-native Google Calendar — manage events, sync, and public booking\",\n    icon: \"CalendarDays\",\n    color: \"#00B5FF\",\n    colorRgb: \"0 181 255\",\n    devPort: 8082,\n    prodUrl: \"https://calendar.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"scheduling\"],\n    core: true,\n  },\n  {\n    name: \"content\",\n    label: \"Content\",\n    hint: \"Open-source Obsidian for MDX — edit local docs with agent assistance\",\n    icon: \"FileText\",\n    color: \"#10B981\",\n    colorRgb: \"16 185 129\",\n    devPort: 8083,\n    prodUrl: \"https://content.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"plan\",\n    label: \"Plan\",\n    hint: \"Structured visual plans and PR recaps with diagrams, wireframes, prototypes, annotations, and sharing\",\n    icon: \"FileText\",\n    color: \"#52525B\",\n    colorRgb: \"82 82 91\",\n    devPort: 8105,\n    prodUrl: \"https://plan.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"slides\",\n    label: \"Slides\",\n    hint: \"Agent-native Google Slides — generate and edit React presentations\",\n    icon: \"GalleryHorizontal\",\n    color: \"#EC4899\",\n    colorRgb: \"236 72 153\",\n    devPort: 8086,\n    prodUrl: \"https://slides.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"pinpoint\"],\n    core: true,\n  },\n  {\n    name: \"videos\",\n    label: \"Video\",\n    hint: \"Agent-native video editing with Remotion\",\n    icon: \"Video\",\n    color: \"#EF4444\",\n    colorRgb: \"239 68 68\",\n    devPort: 8087,\n    prodUrl: \"https://videos.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"pinpoint\"],\n  },\n  {\n    name: \"analytics\",\n    label: \"Analytics\",\n    hint: \"Agent-native Amplitude/Mixpanel — connect data sources, prompt for charts\",\n    icon: \"BarChart2\",\n    color: \"#F59E0B\",\n    colorRgb: \"245 158 11\",\n    devPort: 8088,\n    prodUrl: \"https://analytics.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"mail\",\n    label: \"Mail\",\n    hint: \"Agent-native Superhuman — email client with keyboard shortcuts and AI triage\",\n    icon: \"Mail\",\n    color: \"#3B82F6\",\n    colorRgb: \"59 130 246\",\n    devPort: 8085,\n    prodUrl: \"https://mail.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"dispatch\",\n    label: \"Dispatch\",\n    hint: \"Central Slack/Telegram router with jobs, memory, approvals, and A2A delegation\",\n    icon: \"MessageCircle\",\n    color: \"#14B8A6\",\n    colorRgb: \"20 184 166\",\n    devPort: 8092,\n    prodUrl: \"https://dispatch.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"forms\",\n    label: \"Forms\",\n    hint: \"Agent-native form builder — create, edit, and manage forms\",\n    icon: \"ClipboardList\",\n    color: \"#06B6D4\",\n    colorRgb: \"6 182 212\",\n    devPort: 8084,\n    prodUrl: \"https://forms.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"starter\",\n    label: \"Starter\",\n    hint: \"Minimal scaffold with the agent chat and core architecture wired up\",\n    icon: \"Code\",\n    color: \"#71717A\",\n    colorRgb: \"113 113 122\",\n    devPort: 8089,\n    prodUrl: \"https://starter.agent-native.com\",\n    defaultMode: \"prod\",\n    alwaysAvailable: true,\n    core: true,\n    hidden: true,\n  },\n  {\n    name: \"clips\",\n    label: \"Clips\",\n    hint: \"Screen recording, meeting notes, and voice dictation — all with AI\",\n    icon: \"ScreenShare\",\n    color: \"#0EA5E9\",\n    colorRgb: \"14 165 233\",\n    devPort: 8094,\n    prodUrl: \"https://clips.agent-native.com\",\n    defaultMode: \"prod\",\n    core: true,\n  },\n  {\n    name: \"brain\",\n    label: \"Brain\",\n    hint: \"Cited company knowledge from Slack, meetings, transcripts, and decisions\",\n    icon: \"Brain\",\n    color: \"#8B5CF6\",\n    colorRgb: \"139 92 246\",\n    devPort: 8102,\n    prodUrl: \"https://brain.agent-native.com\",\n    defaultMode: \"prod\",\n    defaultAgent: true,\n    core: true,\n  },\n  {\n    name: \"design\",\n    label: \"Design\",\n    hint: \"Agent-native design tool — create and edit visual designs with agent assistance\",\n    icon: \"Brush\",\n    color: \"#F472B6\",\n    colorRgb: \"244 114 182\",\n    devPort: 8099,\n    prodUrl: \"https://design.agent-native.com\",\n    defaultMode: \"prod\",\n    requiredPackages: [\"pinpoint\", \"embedding\"],\n    core: true,\n  },\n  {\n    name: \"assets\",\n    label: \"Assets\",\n    hint: \"Digital asset manager — upload, organize, search, and generate on-brand images and videos\",\n    icon: \"Photo\",\n    color: \"#0F766E\",\n    colorRgb: \"15 118 110\",\n    devPort: 8100,\n    prodUrl: \"https://assets.agent-native.com\",\n    defaultMode: \"prod\",\n    defaultAgent: true,\n    core: true,\n  },\n  {\n    name: \"macros\",\n    label: \"Macros\",\n    hint: \"Internal template — not shown in pickers\",\n    icon: \"Code\",\n    color: \"#71717A\",\n    colorRgb: \"113 113 122\",\n    devPort: 8093,\n    prodUrl: \"https://macros.agent-native.com\",\n    hidden: true,\n    defaultMode: \"dev\",\n  },\n];\n\n/** Return templates visible in user-facing pickers (excludes hidden). */\nexport function visibleTemplates(): TemplateMeta[] {\n  return TEMPLATES.filter((t) => !t.hidden);\n}\n\n/** Return core templates — the featured set shown in CLI pickers by default. */\nexport function coreTemplates(): TemplateMeta[] {\n  return TEMPLATES.filter((t) => t.core);\n}\n\n/** Lookup by name. Returns undefined for unknown names. */\nexport function getTemplate(name: string): TemplateMeta | undefined {\n  // Tolerate legacy / renamed aliases.\n  if (name === \"video\") name = \"videos\";\n  if (name === \"image\" || name === \"images\" || name === \"asset\") {\n    name = \"assets\";\n  }\n  if (name === \"contracts\" || name === \"visual-plans\") name = \"plan\";\n  return TEMPLATES.find((t) => t.name === name);\n}\n\n/** Names of all templates (including hidden) for validation. */\nexport function allTemplateNames(): string[] {\n  return TEMPLATES.map((t) => t.name);\n}\n"]}

package/dist/coding-tools/run-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-code.d.ts","sourceRoot":"","sources":["../../src/coding-tools/run-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA8DhE,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC7C,IAAI,GAAE,cAAmB,GACxB,WAAW,CA2Mb"}
+{"version":3,"file":"run-code.d.ts","sourceRoot":"","sources":["../../src/coding-tools/run-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA8DhE,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC7C,IAAI,GAAE,cAAmB,GACxB,WAAW,CA4Mb"}

package/dist/coding-tools/run-code.js

@@ -110,6 +110,7 @@ export function createRunCodeEntry(getActions, opts = {}) {
                 "    Example: `const data = await providerFetch('<provider-id>', '/records', { query: { limit: 100 } });`",
                 "  - `providerRequest(provider, path, init?)` — same authenticated call, but returns the full provider-api envelope with request, response status/headers, truncation, and body metadata.",
                 "  - `providerFetchAll(provider, path, init?)` — generic pagination helper for cursor, page, and offset APIs. Pass `pagination: { itemsPath, cursorPath or nextCursorPath, cursorParam or cursorBodyPath, pageParam, offsetParam, pageSize, maxPages }`. Returns `{ items, pages, pageCount, itemCount, hasMore, lastCursor, stoppedReason }`.",
+                "  - `providerSearchAll(provider, path, init?, options?)` — streaming search helper for broad provider corpora such as transcripts, messages, tickets, issues, notes, events, or documents. Use this before hand-written loops when searching many provider records for terms/phrases/regexes or proving absence. Pass the same `pagination` config as `providerFetchAll`, plus options like `{ query, queries, terms, regex, textPaths, idPaths, metadataPaths, maxHits }`. Returns structured hits with item ids, paths, snippets, page/item indexes, and coverage fields (`pageCount`, `itemCount`, `hasMore`, `stoppedReason`).",
                 "  - `webFetch(url, init?)` — outbound HTTP request via the web-request action.",
                 "    Returns `{ status, body }` where body is the response text.",
                 "    Example: `const { body } = await webFetch('https://api.example.com/data');`",
@@ -376,8 +377,8 @@ function handleBridgeRequest(rawBody, actions, context, defaultTools, extraTools
 // ---------------------------------------------------------------------------
 /**
  * Wrap the user's code in an ESM module that:
- *  1. Defines `providerFetch`, `providerRequest`, `providerFetchAll`, and
- *     `webFetch` helpers via the bridge.
+ *  1. Defines `providerFetch`, `providerRequest`, `providerFetchAll`,
+ *     `providerSearchAll`, and `webFetch` helpers via the bridge.
  *  2. Runs the user's code as top-level await in an async IIFE.
  */
 function buildSandboxModule(userCode, bridgePort, bridgeToken) {
@@ -524,7 +525,7 @@ function _extractItems(page, itemsPath) {
   }
   if (Array.isArray(page)) return page;
   if (!page || typeof page !== "object") return [];
-  for (const key of ["data", "results", "items", "records", "rows", "calls", "messages", "tickets", "issues", "deals"]) {
+  for (const key of ["data", "results", "items", "records", "rows", "calls", "callTranscripts", "transcripts", "messages", "tickets", "issues", "deals", "events", "notes", "documents", "entries", "objects"]) {
     if (Array.isArray(page[key])) return page[key];
   }
   return [];
@@ -542,6 +543,437 @@ function _withoutProviderFetchAllOptions(init) {
   return rest;
 }
 
+function _asArray(value) {
+  if (value === undefined || value === null) return [];
+  return Array.isArray(value) ? value : [value];
+}
+
+function _stringifySearchValue(value) {
+  if (typeof value === "string") return value;
+  if (value === undefined || value === null) return "";
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+
+function _collectStrings(value, basePath = "", out = [], limit = 5000) {
+  if (out.length >= limit || value === undefined || value === null) return out;
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    out.push({ path: basePath || "$", text: String(value) });
+    return out;
+  }
+  if (Array.isArray(value)) {
+    for (let i = 0; i < value.length && out.length < limit; i++) {
+      _collectStrings(value[i], basePath ? basePath + "[" + i + "]" : "[" + i + "]", out, limit);
+    }
+    return out;
+  }
+  if (typeof value === "object") {
+    for (const key of Object.keys(value)) {
+      if (out.length >= limit) break;
+      _collectStrings(value[key], basePath ? basePath + "." + key : key, out, limit);
+    }
+  }
+  return out;
+}
+
+function _collectSearchStrings(item, textPaths, maxFieldsPerItem) {
+  const paths = _asArray(textPaths).filter((path) => typeof path === "string" && path.trim());
+  if (!paths.length) return _collectStrings(item, "", [], maxFieldsPerItem);
+  const out = [];
+  for (const path of paths) {
+    const value = _getByPath(item, path);
+    if (value !== undefined) _collectStrings(value, path, out, maxFieldsPerItem);
+    if (out.length >= maxFieldsPerItem) break;
+  }
+  return out;
+}
+
+function _firstValueByPath(value, paths) {
+  for (const path of paths) {
+    const found = _getByPath(value, path);
+    if (found !== undefined && found !== null && String(found) !== "") {
+      return { path, value: found };
+    }
+  }
+  return null;
+}
+
+const _DEFAULT_ID_PATHS = [
+  "id",
+  "callId",
+  "callID",
+  "call_id",
+  "call.id",
+  "call.metaData.id",
+  "metaData.id",
+  "metadata.id",
+  "recordId",
+  "record_id",
+  "objectId",
+  "object_id",
+  "ticketId",
+  "ticket_id",
+  "issueId",
+  "issue_id",
+  "messageId",
+  "message_id",
+  "conversationId",
+  "conversation_id",
+  "eventId",
+  "event_id",
+  "documentId",
+  "document_id",
+  "url",
+  "webUrl",
+  "permalink",
+];
+
+function _extractItemIdentity(item, idPaths) {
+  const paths = [
+    ..._asArray(idPaths).filter((path) => typeof path === "string" && path.trim()),
+    ..._DEFAULT_ID_PATHS,
+  ];
+  const found = _firstValueByPath(item, paths);
+  if (!found) return { id: null, idPath: null };
+  return { id: _stringifySearchValue(found.value), idPath: found.path };
+}
+
+function _extractMetadata(item, metadataPaths) {
+  const metadata = {};
+  for (const path of _asArray(metadataPaths)) {
+    if (typeof path !== "string" || !path.trim()) continue;
+    const value = _getByPath(item, path);
+    if (value !== undefined) metadata[path] = value;
+  }
+  return metadata;
+}
+
+function _makeSnippet(text, index, contextChars) {
+  const source = String(text);
+  const context = Math.max(20, Math.min(Number(contextChars) || 180, 1000));
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, Math.max(index, 0) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  return (prefix + source.slice(start, end) + suffix).replace(/\\s+/g, " ").trim();
+}
+
+function _normalizeFlags(flags, caseSensitive) {
+  const raw = typeof flags === "string" ? flags : "";
+  const allowed = raw.replace(/[^dgimsuvy]/g, "");
+  const withoutGlobalOrSticky = allowed.replace(/[gy]/g, "");
+  const withCase =
+    caseSensitive || /i/.test(withoutGlobalOrSticky)
+      ? withoutGlobalOrSticky
+      : withoutGlobalOrSticky + "i";
+  return withCase + "g";
+}
+
+function _normalizedSearchTerms(options) {
+  const explicitTerms = _asArray(options.terms)
+    .map((term) => String(term).trim())
+    .filter(Boolean);
+  if (explicitTerms.length) return explicitTerms;
+  if (options.matchMode === "allTerms" && typeof options.query === "string") {
+    return options.query
+      .split(/\\s+/)
+      .map((term) => term.trim())
+      .filter(Boolean);
+  }
+  return [];
+}
+
+function _findItemWideTermMatch(fields, options) {
+  const terms = _normalizedSearchTerms(options);
+  if (!terms.length || options.matchMode === "anyTerm") return null;
+  const caseSensitive = Boolean(options.caseSensitive);
+  const normalizedFields = fields.map((field) => ({
+    field,
+    haystack: caseSensitive ? String(field.text) : String(field.text).toLowerCase(),
+  }));
+  const termHits = terms.map((term) => {
+    const searchTerm = caseSensitive ? term : term.toLowerCase();
+    for (const entry of normalizedFields) {
+      const index = entry.haystack.indexOf(searchTerm);
+      if (index >= 0) return { term, field: entry.field, index };
+    }
+    return { term, field: null, index: -1 };
+  });
+  if (termHits.some((hit) => hit.index < 0 || !hit.field)) return null;
+  const first = termHits
+    .filter((hit) => hit.field)
+    .sort((a, b) => {
+      const fieldOrder = fields.indexOf(a.field) - fields.indexOf(b.field);
+      return fieldOrder || a.index - b.index;
+    })[0];
+  return {
+    field: first.field,
+    match: {
+      kind: "allTerms",
+      query: terms.join(" "),
+      index: first.index,
+      match: first.term,
+    },
+  };
+}
+
+function _findSearchMatches(text, options, includeTerms = true) {
+  const source = String(text);
+  const caseSensitive = Boolean(options.caseSensitive);
+  const haystack = caseSensitive ? source : source.toLowerCase();
+  const maxMatchesPerField = _boundedNumber(options.maxMatchesPerField, 1000, 1, 100000);
+  const matches = [];
+
+  const addSubstring = (needle, label, kind) => {
+    if (needle === undefined || needle === null) return;
+    const rawNeedle = String(needle);
+    if (!rawNeedle) return;
+    const searchNeedle = caseSensitive ? rawNeedle : rawNeedle.toLowerCase();
+    let from = 0;
+    while (from <= haystack.length) {
+      const index = haystack.indexOf(searchNeedle, from);
+      if (index < 0) break;
+      matches.push({ kind, query: label ?? rawNeedle, index, match: source.slice(index, index + rawNeedle.length) });
+      from = index + Math.max(1, searchNeedle.length);
+      if (matches.length >= maxMatchesPerField) break;
+    }
+  };
+
+  if (options.regex) {
+    try {
+      const regex = new RegExp(String(options.regex), _normalizeFlags(options.regexFlags, caseSensitive));
+      let match;
+      while ((match = regex.exec(source)) && typeof match.index === "number") {
+        matches.push({ kind: "regex", query: String(options.regex), index: match.index, match: match[0] });
+        if (matches.length >= maxMatchesPerField) break;
+        if (match[0] === "") regex.lastIndex += 1;
+      }
+    } catch (err) {
+      throw new Error("providerSearchAll invalid regex: " + (err?.message || err));
+    }
+  }
+
+  for (const query of _asArray(options.query).concat(_asArray(options.queries))) {
+    addSubstring(query, String(query), "query");
+  }
+
+  const terms = includeTerms ? _normalizedSearchTerms(options) : [];
+  if (terms.length) {
+    const termHits = terms
+      .map((term) => {
+        const searchTerm = caseSensitive ? term : term.toLowerCase();
+        const index = haystack.indexOf(searchTerm);
+        return { term, index };
+      })
+      .filter((hit) => hit.index >= 0);
+    const mode = options.matchMode === "anyTerm" ? "anyTerm" : "allTerms";
+    if ((mode === "allTerms" && termHits.length === terms.length) || (mode === "anyTerm" && termHits.length > 0)) {
+      const first = termHits.sort((a, b) => a.index - b.index)[0];
+      matches.push({ kind: mode, query: terms.join(" "), index: first.index, match: first.term });
+    }
+  }
+
+  return matches.sort((a, b) => a.index - b.index);
+}
+
+function _boundedNumber(value, defaultValue, min, max) {
+  const parsed = Number(value);
+  const finite = Number.isFinite(parsed) ? parsed : defaultValue;
+  return Math.max(min, Math.min(finite, max));
+}
+
+function _hitKey(identity, path, query, index, pageIndex, pageItemIndex) {
+  const itemKey =
+    identity.id !== null && identity.id !== undefined
+      ? "id:" + identity.id
+      : "page:" + String(pageIndex) + ":" + String(pageItemIndex);
+  return [itemKey, path ?? "", query ?? "", String(index ?? "")].join("\\n");
+}
+
+/**
+ * Stream pages from a provider API and search item text structurally. This is
+ * for broad mention searches and absence checks where keeping every raw page
+ * in memory or hand-parsing JSON strings is brittle.
+ */
+async function providerSearchAll(provider, apiPath, init = {}, options = {}) {
+  const pagination = init.pagination || init.fetchAllPages || {};
+  const itemsPath = pagination.itemsPath || init.itemsPath || options.itemsPath;
+  const cursorPath = pagination.nextCursorPath || pagination.cursorPath;
+  const maxPagesRaw = Number(pagination.maxPages || init.maxPages || options.maxPages || 100);
+  const maxPages = Math.max(1, Math.min(Number.isFinite(maxPagesRaw) ? maxPagesRaw : 100, 500));
+  const maxHits = _boundedNumber(options.maxHits, 100, 1, 5000);
+  const maxHitsPerItem = _boundedNumber(options.maxHitsPerItem, 3, 1, 100);
+  const maxFieldsPerItem = _boundedNumber(options.maxFieldsPerItem, 5000, 1, 50000);
+  const contextChars = options.contextChars ?? options.snippetChars ?? 180;
+  const baseInit = _withoutProviderFetchAllOptions(init);
+  let query = _cloneJson(init.query || {});
+  let body = _cloneJson(init.body);
+  let pageNumber = Number(pagination.startPage || 1);
+  let offset = Number(pagination.startOffset || 0);
+  let lastCursor = null;
+  let stoppedReason = "completed";
+  let itemCount = 0;
+  let matchedItemCount = 0;
+  let totalHitCount = 0;
+  const hits = [];
+  const seenHitKeys = new Set();
+  let pageIndex = 0;
+
+  for (; pageIndex < maxPages; pageIndex++) {
+    if (pagination.pageParam) query = { ...(query || {}), [pagination.pageParam]: pageNumber };
+    if (pagination.offsetParam) query = { ...(query || {}), [pagination.offsetParam]: offset };
+
+    const page = await providerFetch(provider, apiPath, {
+      ...baseInit,
+      query,
+      ...(body !== undefined ? { body } : {}),
+    });
+    const nextCursor = cursorPath ? _getByPath(page, cursorPath) : undefined;
+    const hasNextCursor =
+      nextCursor !== undefined && nextCursor !== null && String(nextCursor) !== "";
+    if (hasNextCursor && lastCursor !== null && String(nextCursor) === String(lastCursor)) {
+      stoppedReason = "repeated-cursor";
+      break;
+    }
+
+    const pageItems = _extractItems(page, itemsPath);
+    itemCount += pageItems.length;
+
+    for (let pageItemIndex = 0; pageItemIndex < pageItems.length; pageItemIndex++) {
+      const item = pageItems[pageItemIndex];
+      const identity = _extractItemIdentity(item, options.idPaths);
+      const metadata = _extractMetadata(item, options.metadataPaths);
+      const fields = _collectSearchStrings(item, options.textPaths, maxFieldsPerItem);
+      let storedItemHitCount = 0;
+      let itemMatched = false;
+
+      const addHit = (field, match) => {
+        const key = _hitKey(identity, field.path, match.query, match.index, pageIndex, pageItemIndex);
+        if (seenHitKeys.has(key)) return false;
+        seenHitKeys.add(key);
+        totalHitCount += 1;
+        if (!itemMatched) {
+          matchedItemCount += 1;
+          itemMatched = true;
+        }
+        if (hits.length < maxHits && storedItemHitCount < maxHitsPerItem) {
+          storedItemHitCount += 1;
+          hits.push({
+            id: identity.id,
+            idPath: identity.idPath,
+            pageIndex,
+            pageItemIndex,
+            itemIndex: itemCount - pageItems.length + pageItemIndex,
+            path: field.path,
+            kind: match.kind,
+            query: match.query,
+            match: match.match,
+            snippet: _makeSnippet(field.text, match.index, contextChars),
+            ...(Object.keys(metadata).length ? { metadata } : {}),
+          });
+        }
+        return true;
+      };
+
+      const itemWideTermMatch = _findItemWideTermMatch(fields, options);
+      if (itemWideTermMatch) {
+        addHit(itemWideTermMatch.field, itemWideTermMatch.match);
+      }
+
+      for (const field of fields) {
+        const fieldMatches = _findSearchMatches(field.text, options, !itemWideTermMatch);
+        for (const match of fieldMatches) {
+          addHit(field, match);
+        }
+      }
+    }
+
+    if (hasNextCursor) {
+      lastCursor = nextCursor;
+      if (pagination.cursorBodyPath) {
+        body = _setByPath(body || {}, pagination.cursorBodyPath, nextCursor);
+      } else if (pagination.cursorParam) {
+        query = { ...(query || {}), [pagination.cursorParam]: nextCursor };
+      } else {
+        stoppedReason = "cursor-found-without-destination";
+        break;
+      }
+      continue;
+    }
+
+    lastCursor = null;
+    if (pagination.pageParam) {
+      if (pageItems.length === 0) {
+        stoppedReason = "empty-page";
+        break;
+      }
+      pageNumber += 1;
+      continue;
+    }
+    if (pagination.offsetParam) {
+      if (pageItems.length === 0) {
+        stoppedReason = "empty-page";
+        break;
+      }
+      const step = Number(pagination.pageSize || pageItems.length);
+      if (!Number.isFinite(step) || step <= 0) {
+        stoppedReason = "invalid-page-size";
+        break;
+      }
+      offset += step;
+      if (pagination.pageSize && pageItems.length < Number(pagination.pageSize)) {
+        stoppedReason = "short-page";
+        break;
+      }
+      continue;
+    }
+
+    break;
+  }
+
+  const pageCount = pageIndex + (pageIndex < maxPages ? 1 : 0);
+  const hitPageOrOffsetLimit =
+    Boolean(pagination.pageParam || pagination.offsetParam) &&
+    stoppedReason === "completed" &&
+    pageCount >= maxPages;
+  const hasMore =
+    stoppedReason === "cursor-found-without-destination" ||
+    (lastCursor !== null && pageCount >= maxPages) || hitPageOrOffsetLimit;
+  if (hasMore && stoppedReason === "completed") stoppedReason = "max-pages";
+
+  return {
+    hits,
+    hitCount: hits.length,
+    totalHitCount,
+    truncatedHits: totalHitCount > hits.length,
+    matchedItemCount,
+    itemCount,
+    pageCount,
+    hasMore,
+    lastCursor,
+    stoppedReason,
+    searched: {
+      provider,
+      path: apiPath,
+      itemsPath: itemsPath || null,
+      textPaths: _asArray(options.textPaths),
+      idPaths: _asArray(options.idPaths),
+      query: options.query ?? null,
+      queries: _asArray(options.queries),
+      terms: _asArray(options.terms),
+      regex: options.regex ?? null,
+      matchMode: options.matchMode || (options.terms ? "allTerms" : "query"),
+      caseSensitive: Boolean(options.caseSensitive),
+    },
+  };
+}
+
 /**
  * Fetch every page from a provider API using generic cursor, page-number, or
  * offset pagination. Prefer this inside run-code when the answer depends on a