@agent-native/core 0.122.3 → 0.123.0

package/dist/server/agent-chat/framework-prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"framework-prompts.js","sourceRoot":"","sources":["../../../src/server/agent-chat/framework-prompts.ts"],"names":[],"mappings":"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","sourcesContent":["import nodePath from \"node:path\";\n\nimport type { ActionEntry } from \"../../agent/production-agent.js\";\nimport type { DatabaseToolsOption } from \"../../scripts/db/tool-mode.js\";\nimport {\n  buildFrameworkCore,\n  buildFrameworkCoreCompact,\n  type PromptExamples,\n} from \"../prompts/index.js\";\nimport { getRequestOrgId } from \"../request-context.js\";\nimport { loadSchemaPromptBlock } from \"../schema-prompt.js\";\nimport { resolveInitialToolNames } from \"./action-filters-a2a.js\";\nimport {\n  createDataWidgetActionEntries,\n  FRAMEWORK_CONTEXT_SECTIONS,\n} from \"./context-tools.js\";\nimport { lazyFs } from \"./lazy-fs.js\";\n\n// ---------------------------------------------------------------------------\n// Framework-level system prompt assembly (production/dev, full/compact),\n// the \"Available Actions\" and corpus-tools prompt sections, the SQL schema\n// block, and the codebase file-tree walker used by a few dev-mode tools.\n// ---------------------------------------------------------------------------\n\n/**\n * Framework-level instructions injected into every agent's system prompt.\n * Prompt text lives in packages/core/src/server/prompts/ so this file stays\n * focused on routing and assembly logic.\n *\n * buildFrameworkPrompts() is called once per plugin instantiation (not per\n * request) with the template's promptExamples, producing the four assembled\n * prompt strings used at request time.\n */\nexport function buildFrameworkPrompts(\n  examples?: PromptExamples,\n  options?: { databaseTools?: DatabaseToolsOption; extensionTools?: boolean },\n): {\n  FRAMEWORK_CORE: string;\n  FRAMEWORK_CORE_COMPACT: string;\n  PROD_FRAMEWORK_PROMPT: string;\n  DEV_FRAMEWORK_PROMPT: string;\n  PROD_FRAMEWORK_PROMPT_COMPACT: string;\n  DEV_FRAMEWORK_PROMPT_COMPACT: string;\n} {\n  const FRAMEWORK_CORE = buildFrameworkCore(examples, options);\n  const FRAMEWORK_CORE_COMPACT = buildFrameworkCoreCompact(examples, options);\n  const extensionToolsEnabled = options?.extensionTools !== false;\n  const planModeArtifactList = extensionToolsEnabled\n    ? \"source-code handoffs and app-created artifacts such as extensions, widgets, dashboards, calculators, mini-apps, documents, designs, slides, or videos\"\n    : \"source-code handoffs and app-created artifacts such as documents, designs, slides, or videos\";\n  const planModeBlockedTools = extensionToolsEnabled\n    ? \"`render-inline-extension`, `create-extension`, `update-extension`, `connect-builder`, or any action that creates, updates, deletes, sends, publishes, or persists data\"\n    : \"`connect-builder`, or any action that creates, updates, deletes, sends, publishes, or persists data\";\n  const extensionConnectBuilderGuard = extensionToolsEnabled\n    ? \"If the complete request can be satisfied by a self-contained extension or an existing named slot, use `render-inline-extension`, `create-extension`, `show-extension-inline`, or `update-extension` instead. If the exact placement or behavior requires changing the host UI or no suitable slot exists, continue with the normal `connect-builder` source-change flow even if the user called it an extension; never stop at saying extensions cannot do it.\"\n    : \"Because extension tools are disabled, do NOT invent an extension workflow. Only use `connect-builder` when the request genuinely requires changing the host app's source code.\";\n  const extensionInstructionsFull = extensionToolsEnabled\n    ? `### Generative UI and Extensions (Mini-Apps)\n\nIn Act mode, if the user asks for generated interactive UI in chat, choose the smallest extension action for the lifetime: \\`render-inline-extension\\` (one-off, chat-only), \\`create-extension\\` (saved/reusable), \\`show-extension-inline\\` (reopen a saved one), or \\`update-extension\\` (edit an existing one) — call the right one directly, without a \"let me build…\" preamble. Each tool's own description covers its exact use case, arguments, and available helpers (appAction, dbQuery, extensionData, agentNative.ui.output, etc.). Extensions are sandboxed mini-apps, not source-code changes, and never go through \\`connect-builder\\`.\n\nIf the app exposes native actions or instructions for dashboards, reports, analyses, charts, documents, decks, or other domain artifacts, use those app-native actions first. Choose an extension only when the user explicitly asks for an extension/custom mini-app, or when the app's native artifact format cannot faithfully express the requested interaction.\n\nEditing an existing extension (fix, restyle, rename, add behavior) is a SQL data update — call \\`update-extension\\` directly using the extensionId from \\`<current-screen>\\`/\\`<current-url>\\` when present; never call \\`connect-builder\\` for it.\n\nExtensions render only on their own page or inside an existing named slot; they cannot inject UI into arbitrary native components. If an extension could only approximate the request in a different location, do not silently downgrade the requirement and do not end with \"extensions cannot do that.\" Briefly explain the boundary, then follow the normal source-code handoff so the app can still be customized fully.\n\nFor helper APIs, Alpine.js patterns, the extension-vs-code-change boundary, and worked examples, read the \\`extensions\\` and \\`generative-ui\\` skills.`\n    : `### Extensions Disabled\n\nExtension creation and management tools are disabled for this app. Do not claim you can create, edit, hide, or delete Agent-Native extensions unless the template exposes its own typed action for that workflow. For requests that would otherwise be handled as an extension/widget/dashboard/calculator mini-app, explain that this app has disabled extension tools and use the app's available actions instead.`;\n  const extensionInstructionsCompact = extensionToolsEnabled\n    ? `### Generative UI and Extensions (Mini-Apps)\n\nIn Act mode, choose the smallest extension action for the lifetime: \\`render-inline-extension\\` (one-off, chat-only), \\`create-extension\\` (saved/reusable), \\`show-extension-inline\\` (reopen a saved one), or \\`update-extension\\` (edit an existing one) — each tool's own description covers its use case and helpers. These are sandboxed mini-apps, not code changes; never route them through \\`connect-builder\\`. Do not preface with \"let me build…\" — just call the right extension action.\n\nUse app-native artifact actions first when they exist for dashboards, reports, analyses, charts, documents, decks, or similar domain artifacts. Pick \\`create-extension\\` only for explicit extension/custom mini-app requests or for behavior the native artifact format cannot support.\n\nEditing an existing extension is a data update — call \\`update-extension\\` directly using the extensionId from \\`<current-screen>\\`/\\`<current-url>\\` when present; never \\`connect-builder\\`.\n\nExtensions can render only on their own page or in an existing named slot; they cannot inject UI into arbitrary native components. If the exact request changes host chrome, native components, layout, styles, routes, business logic, or needs placement where no slot exists, treat it as a source-code change and use the normal \\`connect-builder\\` flow even if the user called it an extension. Never stop at \"extensions cannot do that\" or silently offer a different placement; explain the boundary briefly and continue the code-change handoff.\n\nSee the \\`extensions\\` and \\`generative-ui\\` skills for helper APIs, Alpine.js patterns, and worked examples.`\n    : `### Extensions Disabled\n\nExtension creation and management tools are disabled for this app. Do not claim you can create, edit, hide, or delete Agent-Native extensions unless the template exposes its own typed action for that workflow.`;\n\n  const PROD_FRAMEWORK_PROMPT = `## Agent-Native Framework — Production Mode\n\nYou are an AI agent in an agent-native application, running in **production mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via your tools, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In production mode, you operate through registered actions exposed as tools.** These are your capabilities — use them to read data, take actions, and help the user. You cannot edit source code or access the filesystem directly. Your tools are the app's API.\n\n### Plan Mode\n\nIf the current turn is in Plan mode, plan before anything gets written. This applies to ${planModeArtifactList}. Use only read-only tools, clarify the goal when needed, and return a concrete plan for approval. Do not call ${planModeBlockedTools} until the user switches back to Act mode.\n\n${extensionInstructionsFull}\n\n### Code Changes Not Available — Call \\`connect-builder\\` Immediately\n\n${extensionConnectBuilderGuard}\n\nIn Act mode, when the user asks you to change the UI, modify code, add a feature, fix a bug in the app itself, change styles, add a hook, create a component, add a route, add an integration, or anything else that requires editing source files — you MUST take exactly these steps, in order:\n\n1. Briefly acknowledge the user's specific request in their own terms — one short clause naming what they asked for (e.g. \"Got it — wider subject lines in the email list.\"). Do NOT restate the request verbatim, do NOT add a generic preamble, and do NOT promise outcomes. Skip this step entirely if the user already knows you're handing off (e.g. they said \"send this to Builder\").\n2. Call the \\`connect-builder\\` tool, passing the user's full request verbatim as the \\`prompt\\` argument. This renders an inline card. The returned \\`builderEnabled\\` flag is authoritative: \\`true\\` means Builder Cloud Agents can take the code-change handoff; \\`false\\` means this still requires a code change, but no Builder Cloud Agent can run from this workspace. If Builder is connected and \\`builderEnabled\\` is true, the card hands the prompt off to Builder's cloud agent on one click and returns a branch URL. If Builder is not connected and \\`builderEnabled\\` is true, it shows the Connect Builder flow. If \\`builderEnabled\\` is false, it still shows the card, but as a code-change fallback instead of a runnable cloud handoff.\n3. After the card renders, inspect the tool result and write one sentence that frames the next click around what the user just asked — not as a Builder pitch. If \\`builderEnabled\\` is true and the card can send, say something like \"Click Send to Builder and it'll wire that up for you.\" If the user needs to connect first, say something like \"Connect Builder once and it'll handle this and future changes.\" If \\`builderEnabled\\` is false, say: \"This requires a code change. Edit locally or use Builder.io to edit this code in the cloud and continue customizing the app any way you like.\" Do NOT say \"click Send to Builder\", mention a branch URL, say the card is pre-loaded, or imply a Builder Cloud Agent can run when \\`builderEnabled\\` is false.\n\nWhen \\`builderEnabled\\` is false, Builder Cloud Agents are not self-serve from Builder org settings. Do NOT tell the user to go to Builder org settings, beta features, \"Cloud Agents\", or \"AI Agents\" to enable them. The only allowed guidance is the card's code-change fallback: edit locally, use Agent Native Desktop, or use Builder.io to edit this code in the cloud and continue customizing the app any way you like.\n\n**Act-mode handoff — do exactly this:** The moment a code change is requested, call \\`connect-builder\\` with the user's verbatim request, then write one sentence framing the next click. That is the whole job: Builder plans and edits in its own sandbox, so the planning, file-mapping, and code all happen there, not here. Keep your turn to the call plus that one sentence — skip code exploration, implementation plans, \\`resources\\` writes of specs, and sub-agents (they have no code-editing tools either). You don't need filesystem access to recommend Builder, so don't reach for it or list tools you lack.\n\nBuilder Cloud Agents are the recommended path when \\`builderEnabled\\` is true because they are one-click and run in the cloud. Local dev, Agent Native Desktop, and Builder.io cloud editing are the fallback when \\`builderEnabled\\` is false.\n${FRAMEWORK_CORE}`;\n\n  const DEV_FRAMEWORK_PROMPT = `## Agent-Native Framework — Development Mode\n\nYou are an AI agent in an agent-native application, running in **development mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via tools/scripts, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In development mode, you have full local access — use it with senior-engineer judgment** (read before you edit, keep changes scoped, verify before you claim done):\n- Run any shell command via the \\`bash\\` tool (node, curl, pnpm, rg, git, etc.), including arbitrary code: \\`bash({ command: 'node -e \"console.log(1+1)\"' })\\`\n- Read and write any file on the filesystem; edit source, install packages, modify the app\n- Query and modify the database\n- Call external APIs (via bash with curl, or via scripts)\n\nWhen no dedicated tool/action exists for what you need, reach for \\`bash\\` — e.g. \\`bash({ command: 'curl -s https://api.example.com/data' })\\`.\n\n**Template-specific actions are invoked via bash, NOT as direct tools.** In dev mode, the only tools registered as native tool calls are framework-level utilities (bash, read, edit, write, database, resources, chat, teams, jobs). Anything from the template's \\`actions/\\` directory must be run through bash: \\`bash({ command: 'pnpm action <name> --arg value' })\\`. The \"Available Actions\" section below shows the exact CLI syntax for each one — copy that command verbatim and pass it to \\`bash\\`. Do not try to call template actions by name as if they were tools; they will not appear in your tool list.\n\nWhen editing code, follow the agent-native architecture:\n- Every feature needs all four areas: UI + scripts + skills/instructions + application-state sync\n- All SQL must be dialect-agnostic (works on SQLite and Postgres)\n- No Node.js-specific APIs in server routes (must work on Cloudflare Workers, etc.)\n- Use shadcn/ui components and Tabler Icons for all UI work\n${FRAMEWORK_CORE}`;\n\n  const PROD_FRAMEWORK_PROMPT_COMPACT = `## Agent-Native Framework — Production Mode\n\nYou are an AI agent in an agent-native application, running in **production mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via your tools, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In production mode, you operate through registered actions exposed as tools.** These are your capabilities — use them to read data, take actions, and help the user. You cannot edit source code or access the filesystem directly. Your tools are the app's API.\n\n### Plan Mode\n\nIf the turn is in Plan mode, plan before anything gets written — including ${planModeArtifactList}. Use read-only tools only and do not call ${planModeBlockedTools} until the user switches back to Act mode.\n\n${extensionInstructionsCompact}\n\n### Code Changes — Call \\`connect-builder\\`\n\nIn Act mode, when a request genuinely needs a source-code edit (per the rules above), do this in order: (1) briefly acknowledge the user's specific ask in their own terms — one short clause, no preamble — then (2) call \\`connect-builder\\` with the user's request as the \\`prompt\\`, then (3) inspect \\`builderEnabled\\` in the result and write one sentence framing the next click around what they asked for, not a Builder pitch. When \\`builderEnabled\\` is true, Builder Cloud Agents can take the handoff; when \\`builderEnabled\\` is false, say this requires a code change and they can edit locally or use Builder.io to edit this code in the cloud and continue customizing the app any way they like. Do NOT write code, list files, make plans, or spawn sub-agents. Mention \\`npx agent-native create <app-name>\\`, Agent Native Desktop, or the code-change fallback when Builder Cloud Agents aren't available. Never tell users to enable Builder Cloud Agents from Builder org settings, beta features, \"Cloud Agents\", or \"AI Agents\"; they are not self-serve there.\n${FRAMEWORK_CORE_COMPACT}`;\n\n  const DEV_FRAMEWORK_PROMPT_COMPACT = `## Agent-Native Framework — Development Mode\n\nYou are an AI agent in an agent-native application, running in **development mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via tools/scripts, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In development mode, you have full local access** — shell, filesystem, database, external APIs, source edits, and package installs. Use it with senior-engineer judgment: read before you edit, keep changes scoped, verify before you claim done.\n\n**Template-specific actions are invoked via bash, NOT as direct tools.** Run them with: \\`bash({ command: 'pnpm action <name> --arg value' })\\`. See the \"Available Actions\" section below for CLI syntax.\n\nWhen editing code, follow the agent-native architecture:\n- Every feature needs all four areas: UI + scripts + skills/instructions + application-state sync\n- All SQL must be dialect-agnostic (works on SQLite and Postgres)\n- No Node.js-specific APIs in server routes (must work on Cloudflare Workers, etc.)\n- Use shadcn/ui components and Tabler Icons for all UI work\n${FRAMEWORK_CORE_COMPACT}`;\n\n  return {\n    FRAMEWORK_CORE,\n    FRAMEWORK_CORE_COMPACT,\n    PROD_FRAMEWORK_PROMPT,\n    DEV_FRAMEWORK_PROMPT,\n    PROD_FRAMEWORK_PROMPT_COMPACT,\n    DEV_FRAMEWORK_PROMPT_COMPACT,\n  };\n}\n\nexport const _agentChatPromptSectionsForTests = (() => {\n  // Built with default (no template-specific) examples for test stability.\n  const {\n    FRAMEWORK_CORE: frameworkCore,\n    FRAMEWORK_CORE_COMPACT: frameworkCoreCompact,\n  } = buildFrameworkPrompts();\n  return {\n    frameworkCore,\n    frameworkCoreCompact,\n    frameworkContextSections: FRAMEWORK_CONTEXT_SECTIONS,\n    buildFrameworkPrompts,\n    generateActionsPrompt,\n    resolveInitialToolNames,\n    createDataWidgetActionEntries,\n  };\n})();\n\n/**\n * Build the per-request SQL-schema context block. Reads AGENT_ORG_ID live\n * from the environment so scheduler/A2A/HTTP call sites all see whatever\n * org was just resolved for this request.\n */\nexport async function buildSchemaBlock(\n  owner: string,\n  databaseTools: DatabaseToolsOption = \"read\",\n): Promise<string> {\n  try {\n    return await loadSchemaPromptBlock({\n      owner,\n      orgId: getRequestOrgId() ?? null,\n      databaseTools,\n    });\n  } catch {\n    return \"\";\n  }\n}\n\n/**\n * Generates a system prompt section describing registered template actions.\n *\n * Two output modes:\n *\n *   - `\"tool\"` — used in production, where template actions are registered\n *     as native Anthropic tools. The native tool schema already carries each\n *     action's name, full description, and parameters, so this mode does NOT\n *     re-list every action — it only surfaces what the tool list can't:\n *     native-chat-widget annotations and a `tool-search` pointer for actions\n *     omitted from the initial tool set.\n *   - `\"cli\"` — used in dev, where template actions are NOT registered as\n *     native tools and must be invoked via `bash(command=\"pnpm action ...\")`.\n *     This listing is load-bearing here (there is no tool schema to fall\n *     back on), so it still emits the full\n *     `pnpm action name --arg <type> [--opt <type>] — desc` line per action.\n */\nexport function generateActionsPrompt(\n  registry: Record<string, ActionEntry>,\n  mode: \"cli\" | \"tool\" = \"tool\",\n  initialToolNames?: string[],\n): string {\n  if (!registry || Object.keys(registry).length === 0) return \"\";\n\n  const allActionEntries = Object.entries(registry);\n  const initialNames = initialToolNames ? new Set(initialToolNames) : undefined;\n  const actionEntries = initialNames\n    ? allActionEntries.filter(([name]) => initialNames.has(name))\n    : allActionEntries;\n  const omittedActionCount = allActionEntries.length - actionEntries.length;\n  const nativeWidgetNote = (entry: ActionEntry) =>\n    entry.chatUI && typeof entry.chatUI.renderer === \"string\"\n      ? ` Native chat widget: \\`${entry.chatUI.renderer}\\`.`\n      : \"\";\n\n  if (mode === \"tool\") {\n    // Native tool schemas already carry name + full description + params\n    // for every action, so this section only needs to surface what the tool\n    // list itself can't: which actions render a native chat widget, and\n    // which actions exist but aren't loaded as initial tools yet.\n    const widgetLines = actionEntries\n      .filter(([, entry]) => typeof entry.chatUI?.renderer === \"string\")\n      .map(\n        ([name, entry]) =>\n          `- \\`${name}\\` — Native chat widget: \\`${entry.chatUI?.renderer ?? \"\"}\\`.`,\n      );\n\n    const sections: string[] = [];\n    if (widgetLines.length > 0) {\n      sections.push(\n        `**Actions that render a native chat widget** — call these directly for their table/chart/insights view instead of recreating it in prose:\\n\\n${widgetLines.join(\"\\n\")}`,\n      );\n    }\n    if (omittedActionCount > 0) {\n      sections.push(\n        `${omittedActionCount} less-common app action${omittedActionCount === 1 ? \" is\" : \"s are\"} available on demand. Use \\`tool-search\\` with a specific capability query to load the matching schemas when needed.`,\n      );\n    }\n    if (sections.length === 0) return \"\";\n\n    return `\\n\\n## Available Actions\\n\\n${sections.join(\"\\n\\n\")}`;\n  }\n\n  const lines = actionEntries.map(([name, entry]) => {\n    const desc = entry.tool.description;\n    const params = entry.tool.parameters?.properties;\n    const requiredFields = new Set(entry.tool.parameters?.required ?? []);\n\n    // CLI mode: emit `pnpm action <name> --required <type> [--optional <type>]`\n    if (!params || Object.keys(params).length === 0) {\n      return `- \\`pnpm action ${name}\\` — ${desc}${nativeWidgetNote(entry)}`;\n    }\n    const entries = Object.entries(params);\n    // Required first (alphabetical), then optional (alphabetical)\n    entries.sort(([a], [b]) => {\n      const ar = requiredFields.has(a) ? 0 : 1;\n      const br = requiredFields.has(b) ? 0 : 1;\n      if (ar !== br) return ar - br;\n      return a.localeCompare(b);\n    });\n    const required: string[] = [];\n    const optional: string[] = [];\n    const requiredNames: string[] = [];\n    for (const [k, v] of entries) {\n      const type = (v as { type?: string }).type ?? \"any\";\n      const flag = `--${k} <${type}>`;\n      if (requiredFields.has(k)) {\n        required.push(flag);\n        requiredNames.push(`--${k}`);\n      } else {\n        optional.push(`[${flag}]`);\n      }\n    }\n    const cmd = [\"pnpm action \" + name, ...required, ...optional].join(\" \");\n    const requiredNote =\n      requiredNames.length > 0 ? ` Required: ${requiredNames.join(\", \")}.` : \"\";\n    return `- \\`${cmd}\\` — ${desc}.${requiredNote}${nativeWidgetNote(entry)}`;\n  });\n\n  return `\\n\\n## Available Actions\n\n**These template actions are NOT exposed as direct tools in dev mode. To run any of them, use the \\`bash\\` tool with the exact command shown below.** Example: \\`bash(command=\"pnpm action add-slide --deckId abc --content 'Hello'\")\\`.\n\nDo NOT try to call these by name as if they were tools — they will not exist in your tool list. Always go through \\`bash\\`.\n\n${lines.join(\"\\n\")}`;\n}\n\n/**\n * Tool names `generateCorpusToolsPrompt` teaches BY NAME, in the same order\n * it lists them. Exported so callers that build a request's initial\n * engine-tool set can fold in exactly the subset present in a given\n * registry — keeping \"what the prompt just told the model exists\" and\n * \"what tools are actually callable on the first request\" in sync. See the\n * corpus-prompt/initial-tools note at this function's call site in\n * agent-chat-plugin.ts.\n */\nconst CORPUS_TOOL_NAMES = [\n  \"provider-api-catalog\",\n  \"provider-api-docs\",\n  \"provider-api-request\",\n  \"provider-corpus-job\",\n  \"query-staged-dataset\",\n  \"run-code\",\n] as const;\n\nexport function corpusToolNamesTaughtByPrompt(\n  registry: Record<string, ActionEntry>,\n): string[] {\n  return CORPUS_TOOL_NAMES.filter((name) => name in registry);\n}\n\nexport function generateCorpusToolsPrompt(\n  registry: Record<string, ActionEntry>,\n): string {\n  const hasProviderApi = \"provider-api-request\" in registry;\n  const hasProviderCorpusJob = \"provider-corpus-job\" in registry;\n  const providerDiscoveryTools = [\n    \"provider-api-catalog\" in registry ? \"`provider-api-catalog`\" : null,\n    \"provider-api-docs\" in registry ? \"`provider-api-docs`\" : null,\n  ].filter(Boolean);\n  const hasRunCode = \"run-code\" in registry;\n  const hasStagedDataset = \"query-staged-dataset\" in registry;\n  if (\n    !hasProviderApi &&\n    !hasProviderCorpusJob &&\n    !hasRunCode &&\n    !hasStagedDataset\n  )\n    return \"\";\n\n  const available = [\n    ...providerDiscoveryTools,\n    hasProviderApi ? \"`provider-api-request`\" : null,\n    hasProviderCorpusJob ? \"`provider-corpus-job`\" : null,\n    hasStagedDataset ? \"`query-staged-dataset`\" : null,\n    hasRunCode ? \"`run-code`\" : null,\n  ].filter(Boolean);\n\n  return `\\n\\n## Broad Provider And Corpus Workflows\n\nAvailable corpus-capable tools: ${available.join(\", \")}.\n\nThis workflow does not apply to ordinary structured lookups, bounded aggregates, or counts grouped over one known source. For those requests, use the single most directly authoritative source, run one bounded query, and answer as soon as it succeeds. Do not cross-check or expand into a corpus workflow unless the user asks for multiple sources, exhaustive unstructured-record coverage, or an absence claim.\n\nFor broad provider searches, raw API access, multi-page cohorts, cross-source joins, classification over unstructured records, or absence-sensitive answers, do not stop at a bounded shortcut action. Use the provider's broad API/search/list surface, fetch every relevant page or an explicit bounded cohort, stage/save large responses when needed, and reduce the corpus with durable corpus jobs, staged-dataset queries, or code execution.\n\nWhen \\`provider-corpus-job\\` is available, prefer it for transcript/message/ticket/issue/document scans that may exceed one turn, need provider-side backoff, or need a defensible \"not found\" conclusion. Use operation=\"start\" with mode=\"paginated-search\" for any paginated provider endpoint, or mode=\"batch-search\" when a prior cohort of ids/records must feed a second provider endpoint. Continue paused jobs with operation=\"continue\" until status is completed or quota_wait, then read operation=\"results\". In run-code, prefer providerFetchAll() for short cursor/page/offset pagination and providerRequest() when response status, headers, or truncation metadata matters. Report source, filters, row counts, pagination/truncation, failed pages, quota_wait times, and remaining gaps.`;\n}\n\n/**\n * Walks the local filesystem (dev mode only) to build a bounded file/folder\n * tree, used by a couple of dev-mode workspace-inspection tools.\n */\nexport async function collectFiles(\n  dir: string,\n  prefix: string,\n  depth: number,\n  results: Array<{ path: string; name: string; type: \"file\" | \"folder\" }>,\n): Promise<void> {\n  if (depth > 4 || results.length >= 500) return;\n  const skip = new Set([\n    \"node_modules\",\n    \".git\",\n    \".next\",\n    \".output\",\n    \"dist\",\n    \".cache\",\n    \".turbo\",\n    \"data\",\n  ]);\n  let entries: import(\"fs\").Dirent[];\n  try {\n    const fs = await lazyFs();\n    entries = fs.readdirSync(dir, { withFileTypes: true });\n  } catch {\n    return;\n  }\n  for (const entry of entries) {\n    if (results.length >= 500) return;\n    if (skip.has(entry.name) || entry.name.startsWith(\".\")) continue;\n    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;\n    const isDir = entry.isDirectory();\n    results.push({\n      path: relPath,\n      name: entry.name,\n      type: isDir ? \"folder\" : \"file\",\n    });\n    if (isDir)\n      await collectFiles(\n        nodePath.join(dir, entry.name),\n        relPath,\n        depth + 1,\n        results,\n      );\n  }\n}\n"]}
+{"version":3,"file":"framework-prompts.js","sourceRoot":"","sources":["../../../src/server/agent-chat/framework-prompts.ts"],"names":[],"mappings":"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","sourcesContent":["import nodePath from \"node:path\";\n\nimport type { ActionEntry } from \"../../agent/production-agent.js\";\nimport type { DatabaseToolsOption } from \"../../scripts/db/tool-mode.js\";\nimport {\n  buildFrameworkCore,\n  buildFrameworkCoreCompact,\n  type PromptExamples,\n} from \"../prompts/index.js\";\nimport { getRequestOrgId } from \"../request-context.js\";\nimport { loadSchemaPromptBlock } from \"../schema-prompt.js\";\nimport { resolveInitialToolNames } from \"./action-filters-a2a.js\";\nimport {\n  createDataWidgetActionEntries,\n  FRAMEWORK_CONTEXT_SECTIONS,\n} from \"./context-tools.js\";\nimport { lazyFs } from \"./lazy-fs.js\";\n\n// ---------------------------------------------------------------------------\n// Framework-level system prompt assembly (production/dev, full/compact),\n// the \"Available Actions\" and corpus-tools prompt sections, the SQL schema\n// block, and the codebase file-tree walker used by a few dev-mode tools.\n// ---------------------------------------------------------------------------\n\n/**\n * Framework-level instructions injected into every agent's system prompt.\n * Prompt text lives in packages/core/src/server/prompts/ so this file stays\n * focused on routing and assembly logic.\n *\n * buildFrameworkPrompts() is called once per plugin instantiation (not per\n * request) with the template's promptExamples, producing the four assembled\n * prompt strings used at request time.\n */\nexport function buildFrameworkPrompts(\n  examples?: PromptExamples,\n  options?: { databaseTools?: DatabaseToolsOption; extensionTools?: boolean },\n): {\n  FRAMEWORK_CORE: string;\n  FRAMEWORK_CORE_COMPACT: string;\n  PROD_FRAMEWORK_PROMPT: string;\n  DEV_FRAMEWORK_PROMPT: string;\n  PROD_FRAMEWORK_PROMPT_COMPACT: string;\n  DEV_FRAMEWORK_PROMPT_COMPACT: string;\n} {\n  const FRAMEWORK_CORE = buildFrameworkCore(examples, options);\n  const FRAMEWORK_CORE_COMPACT = buildFrameworkCoreCompact(examples, options);\n  const extensionToolsEnabled = options?.extensionTools !== false;\n  const planModeArtifactList = extensionToolsEnabled\n    ? \"source-code handoffs and app-created artifacts such as extensions, widgets, dashboards, calculators, mini-apps, documents, designs, slides, or videos\"\n    : \"source-code handoffs and app-created artifacts such as documents, designs, slides, or videos\";\n  const planModeBlockedTools = extensionToolsEnabled\n    ? \"`render-inline-extension`, `create-extension`, `update-extension`, `connect-builder`, or any action that creates, updates, deletes, sends, publishes, or persists data\"\n    : \"`connect-builder`, or any action that creates, updates, deletes, sends, publishes, or persists data\";\n  const extensionConnectBuilderGuard = extensionToolsEnabled\n    ? \"If the complete request can be satisfied by a self-contained extension or an existing named slot, use `render-inline-extension`, `create-extension`, `show-extension-inline`, or `update-extension` instead. If the exact placement or behavior requires changing the host UI or no suitable slot exists, continue with the normal `connect-builder` source-change flow even if the user called it an extension; never stop at saying extensions cannot do it.\"\n    : \"Because extension tools are disabled, do NOT invent an extension workflow. Only use `connect-builder` when the request genuinely requires changing the host app's source code.\";\n  const extensionInstructionsFull = extensionToolsEnabled\n    ? `### Generative UI and Extensions (Mini-Apps)\n\nIn Act mode, if the user asks for generated interactive UI in chat, choose the smallest extension action for the lifetime: \\`render-inline-extension\\` (one-off, chat-only), \\`create-extension\\` (saved/reusable), \\`show-extension-inline\\` (reopen a saved one), or \\`update-extension\\` (edit an existing one) — call the right one directly, without a \"let me build…\" preamble. Each tool's own description covers its exact use case, arguments, and available helpers (appAction, dbQuery, extensionData, agentNative.ui.output, etc.). Extensions are sandboxed mini-apps, not source-code changes, and never go through \\`connect-builder\\`.\n\nIf the app exposes native actions or instructions for dashboards, reports, analyses, charts, documents, decks, or other domain artifacts, use those app-native actions first. Choose an extension only when the user explicitly asks for an extension/custom mini-app, or when the app's native artifact format cannot faithfully express the requested interaction.\n\nEditing an existing extension (fix, restyle, rename, add behavior) is a SQL data update — call \\`update-extension\\` directly using the extensionId from \\`<current-screen>\\`/\\`<current-url>\\` when present; never call \\`connect-builder\\` for it.\n\nExtensions render only on their own page or inside an existing named slot; they cannot inject UI into arbitrary native components. If an extension could only approximate the request in a different location, do not silently downgrade the requirement and do not end with \"extensions cannot do that.\" Briefly explain the boundary, then follow the normal source-code handoff so the app can still be customized fully.\n\nFor helper APIs, Alpine.js patterns, the extension-vs-code-change boundary, and worked examples, read the \\`extensions\\` and \\`generative-ui\\` skills.`\n    : `### Extensions Disabled\n\nExtension creation and management tools are disabled for this app. Do not claim you can create, edit, hide, or delete Agent-Native extensions unless the template exposes its own typed action for that workflow. For requests that would otherwise be handled as an extension/widget/dashboard/calculator mini-app, explain that this app has disabled extension tools and use the app's available actions instead.`;\n  const extensionInstructionsCompact = extensionToolsEnabled\n    ? `### Generative UI and Extensions (Mini-Apps)\n\nIn Act mode, choose the smallest extension action for the lifetime: \\`render-inline-extension\\` (one-off, chat-only), \\`create-extension\\` (saved/reusable), \\`show-extension-inline\\` (reopen a saved one), or \\`update-extension\\` (edit an existing one) — each tool's own description covers its use case and helpers. These are sandboxed mini-apps, not code changes; never route them through \\`connect-builder\\`. Do not preface with \"let me build…\" — just call the right extension action.\n\nUse app-native artifact actions first when they exist for dashboards, reports, analyses, charts, documents, decks, or similar domain artifacts. Pick \\`create-extension\\` only for explicit extension/custom mini-app requests or for behavior the native artifact format cannot support.\n\nEditing an existing extension is a data update — call \\`update-extension\\` directly using the extensionId from \\`<current-screen>\\`/\\`<current-url>\\` when present; never \\`connect-builder\\`.\n\nExtensions can render only on their own page or in an existing named slot; they cannot inject UI into arbitrary native components. If the exact request changes host chrome, native components, layout, styles, routes, business logic, or needs placement where no slot exists, treat it as a source-code change and use the normal \\`connect-builder\\` flow even if the user called it an extension. Never stop at \"extensions cannot do that\" or silently offer a different placement; explain the boundary briefly and continue the code-change handoff.\n\nSee the \\`extensions\\` and \\`generative-ui\\` skills for helper APIs, Alpine.js patterns, and worked examples.`\n    : `### Extensions Disabled\n\nExtension creation and management tools are disabled for this app. Do not claim you can create, edit, hide, or delete Agent-Native extensions unless the template exposes its own typed action for that workflow.`;\n\n  const PROD_FRAMEWORK_PROMPT = `## Agent-Native Framework — Production Mode\n\nYou are an AI agent in an agent-native application, running in **production mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via your tools, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In production mode, you operate through registered actions exposed as tools.** These are your capabilities — use them to read data, take actions, and help the user. You cannot edit source code or access the filesystem directly. Your tools are the app's API.\n\n### Plan Mode\n\nIf the current turn is in Plan mode, plan before anything gets written. This applies to ${planModeArtifactList}. Use only read-only tools, clarify the goal when needed, and return a concrete plan for approval. Do not call ${planModeBlockedTools} until the user switches back to Act mode.\n\n${extensionInstructionsFull}\n\n### Code Changes — Hand Off With \\`connect-builder\\`\n\n${extensionConnectBuilderGuard}\n\nIn Act mode, a request that needs source-file edits — the UI chrome, a component, a route, styles, a hook, an integration, or a bug in the app itself — is a handoff, not a task you plan. Builder plans and edits in its own sandbox, so the exploration, file-mapping, and code all happen there rather than here.\n\nKeep the whole turn to three beats:\n\n1. One short clause acknowledging what they asked for in their own terms (\"Got it — wider subject lines in the email list.\"), skipped entirely when they already know you're handing off. No generic preamble, no promised outcomes.\n2. The \\`connect-builder\\` call, with the user's request verbatim as \\`prompt\\`.\n3. One sentence framing the next click around what they asked for rather than pitching Builder. Read \\`builderEnabled\\` from the result first; the tool's own description defines what each value lets you claim and offer.\n\nNothing else belongs in that turn: no code exploration, no implementation plan, no \\`resources\\` write of a spec, and no sub-agents (they have no code-editing tools either). You don't need filesystem access to hand off, so don't reach for it or list tools you lack.\n${FRAMEWORK_CORE}`;\n\n  const DEV_FRAMEWORK_PROMPT = `## Agent-Native Framework — Development Mode\n\nYou are an AI agent in an agent-native application, running in **development mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via tools/scripts, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In development mode, you have full local access — use it with senior-engineer judgment** (read before you edit, keep changes scoped, verify before you claim done):\n- Run any shell command via the \\`bash\\` tool (node, curl, pnpm, rg, git, etc.), including arbitrary code\n- Read and write any file on the filesystem; edit source, install packages, modify the app\n- Query and modify the database\n- Call external APIs (via bash with curl, or via scripts)\n\nWhen no dedicated tool/action exists for what you need, reach for \\`bash\\`.\n\n**Template-specific actions are invoked via bash, NOT as direct tools.** In dev mode, the only tools registered as native tool calls are framework-level utilities (bash, read, edit, write, database, resources, chat, teams, jobs). Anything from the template's \\`actions/\\` directory must be run through bash: \\`bash({ command: 'pnpm action <name> --arg value' })\\`. The \"Available Actions\" section below shows the exact CLI syntax for each one — copy that command verbatim and pass it to \\`bash\\`. Do not try to call template actions by name as if they were tools; they will not appear in your tool list.\n\nWhen editing code, follow the agent-native architecture:\n- Every feature needs all four areas: UI + scripts + skills/instructions + application-state sync\n- All SQL must be dialect-agnostic (works on SQLite and Postgres)\n- No Node.js-specific APIs in server routes (must work on Cloudflare Workers, etc.)\n- Use shadcn/ui components and Tabler Icons for all UI work\n${FRAMEWORK_CORE}`;\n\n  const PROD_FRAMEWORK_PROMPT_COMPACT = `## Agent-Native Framework — Production Mode\n\nYou are an AI agent in an agent-native application, running in **production mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via your tools, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In production mode, you operate through registered actions exposed as tools.** These are your capabilities — use them to read data, take actions, and help the user. You cannot edit source code or access the filesystem directly. Your tools are the app's API.\n\n### Plan Mode\n\nIf the turn is in Plan mode, plan before anything gets written — including ${planModeArtifactList}. Use read-only tools only and do not call ${planModeBlockedTools} until the user switches back to Act mode.\n\n${extensionInstructionsCompact}\n\n### Code Changes — Hand Off With \\`connect-builder\\`\n\nIn Act mode, a request that genuinely needs a source-code edit (per the rules above) is a handoff, not a task you plan. Keep the turn to three beats: (1) one short clause acknowledging their specific ask in their own terms, no preamble; (2) the \\`connect-builder\\` call with their request verbatim as \\`prompt\\`; (3) one sentence framing the next click around what they asked for, not a Builder pitch — read \\`builderEnabled\\` from the result first, and let the tool's own description tell you what each value lets you claim. Nothing else belongs in that turn: no code, no file lists, no plans, no sub-agents.\n${FRAMEWORK_CORE_COMPACT}`;\n\n  const DEV_FRAMEWORK_PROMPT_COMPACT = `## Agent-Native Framework — Development Mode\n\nYou are an AI agent in an agent-native application, running in **development mode**.\n\nThe agent and the UI are equal partners — everything the UI can do, you can do via tools/scripts, and vice versa. They share the same SQL database and stay in sync automatically.\n\n**In development mode, you have full local access** — shell, filesystem, database, external APIs, source edits, and package installs. Use it with senior-engineer judgment: read before you edit, keep changes scoped, verify before you claim done.\n\n**Template-specific actions are invoked via bash, NOT as direct tools.** Run them with: \\`bash({ command: 'pnpm action <name> --arg value' })\\`. See the \"Available Actions\" section below for CLI syntax.\n\nWhen editing code, follow the agent-native architecture:\n- Every feature needs all four areas: UI + scripts + skills/instructions + application-state sync\n- All SQL must be dialect-agnostic (works on SQLite and Postgres)\n- No Node.js-specific APIs in server routes (must work on Cloudflare Workers, etc.)\n- Use shadcn/ui components and Tabler Icons for all UI work\n${FRAMEWORK_CORE_COMPACT}`;\n\n  return {\n    FRAMEWORK_CORE,\n    FRAMEWORK_CORE_COMPACT,\n    PROD_FRAMEWORK_PROMPT,\n    DEV_FRAMEWORK_PROMPT,\n    PROD_FRAMEWORK_PROMPT_COMPACT,\n    DEV_FRAMEWORK_PROMPT_COMPACT,\n  };\n}\n\nexport const _agentChatPromptSectionsForTests = (() => {\n  // Built with default (no template-specific) examples for test stability.\n  const {\n    FRAMEWORK_CORE: frameworkCore,\n    FRAMEWORK_CORE_COMPACT: frameworkCoreCompact,\n  } = buildFrameworkPrompts();\n  return {\n    frameworkCore,\n    frameworkCoreCompact,\n    frameworkContextSections: FRAMEWORK_CONTEXT_SECTIONS,\n    buildFrameworkPrompts,\n    generateActionsPrompt,\n    resolveInitialToolNames,\n    createDataWidgetActionEntries,\n  };\n})();\n\n/**\n * Build the per-request SQL-schema context block. Reads AGENT_ORG_ID live\n * from the environment so scheduler/A2A/HTTP call sites all see whatever\n * org was just resolved for this request.\n */\nexport async function buildSchemaBlock(\n  owner: string,\n  databaseTools: DatabaseToolsOption = \"read\",\n): Promise<string> {\n  try {\n    return await loadSchemaPromptBlock({\n      owner,\n      orgId: getRequestOrgId() ?? null,\n      databaseTools,\n    });\n  } catch {\n    return \"\";\n  }\n}\n\n/**\n * Generates a system prompt section describing registered template actions.\n *\n * Two output modes:\n *\n *   - `\"tool\"` — used in production, where template actions are registered\n *     as native Anthropic tools. The native tool schema already carries each\n *     action's name, full description, and parameters, so this mode does NOT\n *     re-list every action — it only surfaces what the tool list can't:\n *     native-chat-widget annotations and a `tool-search` pointer for actions\n *     omitted from the initial tool set.\n *   - `\"cli\"` — used in dev, where template actions are NOT registered as\n *     native tools and must be invoked via `bash(command=\"pnpm action ...\")`.\n *     This listing is load-bearing here (there is no tool schema to fall\n *     back on), so it still emits the full\n *     `pnpm action name --arg <type> [--opt <type>] — desc` line per action.\n */\nexport function generateActionsPrompt(\n  registry: Record<string, ActionEntry>,\n  mode: \"cli\" | \"tool\" = \"tool\",\n  initialToolNames?: string[],\n): string {\n  if (!registry || Object.keys(registry).length === 0) return \"\";\n\n  const allActionEntries = Object.entries(registry);\n  const initialNames = initialToolNames ? new Set(initialToolNames) : undefined;\n  const actionEntries = initialNames\n    ? allActionEntries.filter(([name]) => initialNames.has(name))\n    : allActionEntries;\n  const omittedActionCount = allActionEntries.length - actionEntries.length;\n  const nativeWidgetNote = (entry: ActionEntry) =>\n    entry.chatUI && typeof entry.chatUI.renderer === \"string\"\n      ? ` Native chat widget: \\`${entry.chatUI.renderer}\\`.`\n      : \"\";\n\n  if (mode === \"tool\") {\n    // Native tool schemas already carry name + full description + params\n    // for every action, so this section only needs to surface what the tool\n    // list itself can't: which actions render a native chat widget, and\n    // which actions exist but aren't loaded as initial tools yet.\n    const widgetLines = actionEntries\n      .filter(([, entry]) => typeof entry.chatUI?.renderer === \"string\")\n      .map(\n        ([name, entry]) =>\n          `- \\`${name}\\` — Native chat widget: \\`${entry.chatUI?.renderer ?? \"\"}\\`.`,\n      );\n\n    const sections: string[] = [];\n    if (widgetLines.length > 0) {\n      sections.push(\n        `**Actions that render a native chat widget** — call these directly for their table/chart/insights view instead of recreating it in prose:\\n\\n${widgetLines.join(\"\\n\")}`,\n      );\n    }\n    if (omittedActionCount > 0) {\n      sections.push(\n        `${omittedActionCount} less-common app action${omittedActionCount === 1 ? \" is\" : \"s are\"} available on demand. Use \\`tool-search\\` with a specific capability query to load the matching schemas when needed.`,\n      );\n    }\n    if (sections.length === 0) return \"\";\n\n    return `\\n\\n## Available Actions\\n\\n${sections.join(\"\\n\\n\")}`;\n  }\n\n  const lines = actionEntries.map(([name, entry]) => {\n    const desc = entry.tool.description;\n    const params = entry.tool.parameters?.properties;\n    const requiredFields = new Set(entry.tool.parameters?.required ?? []);\n\n    // CLI mode: emit `pnpm action <name> --required <type> [--optional <type>]`\n    if (!params || Object.keys(params).length === 0) {\n      return `- \\`pnpm action ${name}\\` — ${desc}${nativeWidgetNote(entry)}`;\n    }\n    const entries = Object.entries(params);\n    // Required first (alphabetical), then optional (alphabetical)\n    entries.sort(([a], [b]) => {\n      const ar = requiredFields.has(a) ? 0 : 1;\n      const br = requiredFields.has(b) ? 0 : 1;\n      if (ar !== br) return ar - br;\n      return a.localeCompare(b);\n    });\n    const required: string[] = [];\n    const optional: string[] = [];\n    const requiredNames: string[] = [];\n    for (const [k, v] of entries) {\n      const type = (v as { type?: string }).type ?? \"any\";\n      const flag = `--${k} <${type}>`;\n      if (requiredFields.has(k)) {\n        required.push(flag);\n        requiredNames.push(`--${k}`);\n      } else {\n        optional.push(`[${flag}]`);\n      }\n    }\n    const cmd = [\"pnpm action \" + name, ...required, ...optional].join(\" \");\n    const requiredNote =\n      requiredNames.length > 0 ? ` Required: ${requiredNames.join(\", \")}.` : \"\";\n    return `- \\`${cmd}\\` — ${desc}.${requiredNote}${nativeWidgetNote(entry)}`;\n  });\n\n  return `\\n\\n## Available Actions\n\n**These template actions are NOT exposed as direct tools in dev mode. To run any of them, use the \\`bash\\` tool with the exact command shown below.** Example: \\`bash(command=\"pnpm action add-slide --deckId abc --content 'Hello'\")\\`.\n\nDo NOT try to call these by name as if they were tools — they will not exist in your tool list. Always go through \\`bash\\`.\n\n${lines.join(\"\\n\")}`;\n}\n\n/**\n * Tool names `generateCorpusToolsPrompt` teaches BY NAME, in the same order\n * it lists them. Exported so callers that build a request's initial\n * engine-tool set can fold in exactly the subset present in a given\n * registry — keeping \"what the prompt just told the model exists\" and\n * \"what tools are actually callable on the first request\" in sync. See the\n * corpus-prompt/initial-tools note at this function's call site in\n * agent-chat-plugin.ts.\n */\nconst CORPUS_TOOL_NAMES = [\n  \"provider-api-catalog\",\n  \"provider-api-docs\",\n  \"provider-api-request\",\n  \"provider-corpus-job\",\n  \"query-staged-dataset\",\n  \"run-code\",\n] as const;\n\nexport function corpusToolNamesTaughtByPrompt(\n  registry: Record<string, ActionEntry>,\n): string[] {\n  return CORPUS_TOOL_NAMES.filter((name) => name in registry);\n}\n\nexport function generateCorpusToolsPrompt(\n  registry: Record<string, ActionEntry>,\n): string {\n  const hasProviderApi = \"provider-api-request\" in registry;\n  const hasProviderCorpusJob = \"provider-corpus-job\" in registry;\n  const providerDiscoveryTools = [\n    \"provider-api-catalog\" in registry ? \"`provider-api-catalog`\" : null,\n    \"provider-api-docs\" in registry ? \"`provider-api-docs`\" : null,\n  ].filter(Boolean);\n  const hasRunCode = \"run-code\" in registry;\n  const hasStagedDataset = \"query-staged-dataset\" in registry;\n  if (\n    !hasProviderApi &&\n    !hasProviderCorpusJob &&\n    !hasRunCode &&\n    !hasStagedDataset\n  )\n    return \"\";\n\n  const available = [\n    ...providerDiscoveryTools,\n    hasProviderApi ? \"`provider-api-request`\" : null,\n    hasProviderCorpusJob ? \"`provider-corpus-job`\" : null,\n    hasStagedDataset ? \"`query-staged-dataset`\" : null,\n    hasRunCode ? \"`run-code`\" : null,\n  ].filter(Boolean);\n\n  return `\\n\\n## Broad Provider And Corpus Workflows\n\nAvailable corpus-capable tools: ${available.join(\", \")}.\n\nThis workflow does not apply to ordinary structured lookups, bounded aggregates, or counts grouped over one known source. For those requests, use the single most directly authoritative source, run one bounded query, and answer as soon as it succeeds. Do not cross-check or expand into a corpus workflow unless the user asks for multiple sources, exhaustive unstructured-record coverage, or an absence claim.\n\nFor broad provider searches, raw API access, multi-page cohorts, cross-source joins, classification over unstructured records, or absence-sensitive answers, do not stop at a bounded shortcut action. Use the provider's broad API/search/list surface, fetch every relevant page or an explicit bounded cohort, stage/save large responses when needed, and reduce the corpus with durable corpus jobs, staged-dataset queries, or code execution.\n\nWhen \\`provider-corpus-job\\` is available, prefer it for transcript/message/ticket/issue/document scans that may exceed one turn, need provider-side backoff, or need a defensible \"not found\" conclusion. Use operation=\"start\" with mode=\"paginated-search\" for any paginated provider endpoint, or mode=\"batch-search\" when a prior cohort of ids/records must feed a second provider endpoint. Continue paused jobs with operation=\"continue\" until status is completed or quota_wait, then read operation=\"results\". In run-code, prefer providerFetchAll() for short cursor/page/offset pagination and providerRequest() when response status, headers, or truncation metadata matters. Report source, filters, row counts, pagination/truncation, failed pages, quota_wait times, and remaining gaps.`;\n}\n\n/**\n * Walks the local filesystem (dev mode only) to build a bounded file/folder\n * tree, used by a couple of dev-mode workspace-inspection tools.\n */\nexport async function collectFiles(\n  dir: string,\n  prefix: string,\n  depth: number,\n  results: Array<{ path: string; name: string; type: \"file\" | \"folder\" }>,\n): Promise<void> {\n  if (depth > 4 || results.length >= 500) return;\n  const skip = new Set([\n    \"node_modules\",\n    \".git\",\n    \".next\",\n    \".output\",\n    \"dist\",\n    \".cache\",\n    \".turbo\",\n    \"data\",\n  ]);\n  let entries: import(\"fs\").Dirent[];\n  try {\n    const fs = await lazyFs();\n    entries = fs.readdirSync(dir, { withFileTypes: true });\n  } catch {\n    return;\n  }\n  for (const entry of entries) {\n    if (results.length >= 500) return;\n    if (skip.has(entry.name) || entry.name.startsWith(\".\")) continue;\n    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;\n    const isDir = entry.isDirectory();\n    results.push({\n      path: relPath,\n      name: entry.name,\n      type: isDir ? \"folder\" : \"file\",\n    });\n    if (isDir)\n      await collectFiles(\n        nodePath.join(dir, entry.name),\n        relPath,\n        depth + 1,\n        results,\n      );\n  }\n}\n"]}

package/dist/server/agent-chat/prompt-resources.d.ts

@@ -33,6 +33,38 @@ export interface PromptResourceManifestSection {
  * is persisted; this helper never writes or returns the full manifest.
  */
 export declare function promptResourceManifestSections(prompt: string): PromptResourceManifestSection[];
+/**
+ * One assembled startup-context block plus the governance tier the context
+ * manifest reports for it (`ContextGovernanceTier`). `required` is the tier
+ * that already meant "not opt-out-able" in the manifest; the budget fitter
+ * honours it as "reserve before anything else competes".
+ */
+export interface PromptSection {
+    content: string;
+    governance: ContextGovernanceTier;
+}
+export interface SkippedPromptSection {
+    label: string;
+    chars: number;
+}
+export interface PromptSectionBudgetResult {
+    sections: string[];
+    skipped: SkippedPromptSection[];
+    /** Chars by which required sections alone exceeded `maxChars`, else 0. */
+    overflowChars: number;
+}
+/**
+ * Fits assembled startup context into `maxChars`, reserving `required`
+ * sections before discretionary ones compete for the remainder, and reporting
+ * every omission so an over-budget request is never silent.
+ *
+ * Required sections are never truncated and never dropped: a half-rendered
+ * list of workspace apps or governance rules reads to the model as a complete
+ * one, which is worse than an explicit note that a section is missing. If they
+ * alone exceed the budget, the budget is exceeded deliberately, every
+ * discretionary section is dropped, and `overflowChars` reports by how much.
+ */
+export declare function selectPromptSectionsWithinBudget(sections: PromptSection[], maxChars: number): PromptSectionBudgetResult;
 export declare function resourceScopeForOwner(owner: string, currentOwner?: string): string;
 /**
  * Pre-load the agent's context: AGENTS.md (workspace/template/runtime

package/dist/server/agent-chat/prompt-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-resources.d.ts","sourceRoot":"","sources":["../../../src/server/agent-chat/prompt-resources.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AAatC,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAIvD,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CACF,OAAO,EAAE,4BAA4B,GAEnC,OAAO,CAAC,iCAAiC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC7D,iCAAiC,GACjC,IAAI,GACJ,SAAS,CAAC;CACf;AAID,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CAcZ;AA6CD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzE;AAOD,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,uBAAuB,CAAC;IACpC,UAAU,EAAE,qBAAqB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAyDD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb,6BAA6B,EAAE,CA+IjC;AA2ID,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAOR;AAiND;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,UAAQ,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,GAAE,MAAM,GAAG,IAAgC,GAC/C,OAAO,CAAC,MAAM,CAAC,CA0QjB"}
+{"version":3,"file":"prompt-resources.d.ts","sourceRoot":"","sources":["../../../src/server/agent-chat/prompt-resources.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AAatC,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAIvD,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CACF,OAAO,EAAE,4BAA4B,GAEnC,OAAO,CAAC,iCAAiC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC7D,iCAAiC,GACjC,IAAI,GACJ,SAAS,CAAC;CACf;AAID,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CAcZ;AA6CD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzE;AAOD,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,uBAAuB,CAAC;IACpC,UAAU,EAAE,qBAAqB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAyDD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb,6BAA6B,EAAE,CA+IjC;AAqED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;CACvB;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,EAAE,MAAM,GACf,yBAAyB,CAoD3B;AAgDD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAOR;AAiND;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,UAAQ,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,GAAE,MAAM,GAAG,IAAgC,GAC/C,OAAO,CAAC,MAAM,CAAC,CA4SjB"}

package/dist/server/agent-chat/prompt-resources.js

@@ -292,25 +292,77 @@ function promptResourceBlock(input) {
         : "";
     return `<resource name="${escapeXmlAttribute(input.name)}" scope="${escapeXmlAttribute(input.scope)}"${pathAttr}>\n${content}\n</resource>`;
 }
-function selectPromptSectionsWithinBudget(sections, maxChars) {
-    const omissionNote = `<context-budget-note>Some startup context sections were omitted to keep the first model request responsive. Use \`resources\` with \`action: "list"\` or \`"read"\`, \`docs-search\`, and \`tool-search\` to retrieve relevant depth on demand.</context-budget-note>`;
-    const contentBudget = Math.max(0, maxChars - omissionNote.length - 2);
-    const selected = [];
-    let used = 0;
-    let omitted = 0;
-    for (const section of sections) {
-        const separatorChars = selected.length > 0 ? 2 : 0;
-        if (used + separatorChars + section.length <= contentBudget) {
-            selected.push(section);
-            used += separatorChars + section.length;
+const PROMPT_SECTION_SEPARATOR = "\n\n";
+const TRIM_NOTE_LABELS_MAX_CHARS = 300;
+const TRIM_NOTE_MAX_CHARS = 700;
+function promptSectionLabel(content) {
+    const open = /^<([a-z][a-z0-9-]*)\b([^>]*)>/i.exec(content.trimStart());
+    if (!open)
+        return "unlabelled context section";
+    const attrs = open[2] ?? "";
+    const name = xmlAttribute(attrs, "name") ?? xmlAttribute(attrs, "id");
+    const scope = xmlAttribute(attrs, "scope");
+    if (name)
+        return scope ? `${name} (${scope})` : name;
+    return scope ? `${open[1]} (${scope})` : (open[1] ?? "context section");
+}
+function promptBudgetTrimNote(skipped, maxChars) {
+    const labels = compactPromptLine(skipped.map((section) => section.label).join(", "), TRIM_NOTE_LABELS_MAX_CHARS);
+    return `<context-budget-note>Your startup context was trimmed: ${skipped.length} section(s) did not fit the ${maxChars.toLocaleString()}-character first-request budget and were omitted (${labels}). Treat them as unread, not as absent — use \`resources\` with \`action: "list"\` or \`"read"\`, \`docs-search\`, and \`tool-search\` before telling the user something does not exist.</context-budget-note>`;
+}
+/**
+ * Fits assembled startup context into `maxChars`, reserving `required`
+ * sections before discretionary ones compete for the remainder, and reporting
+ * every omission so an over-budget request is never silent.
+ *
+ * Required sections are never truncated and never dropped: a half-rendered
+ * list of workspace apps or governance rules reads to the model as a complete
+ * one, which is worse than an explicit note that a section is missing. If they
+ * alone exceed the budget, the budget is exceeded deliberately, every
+ * discretionary section is dropped, and `overflowChars` reports by how much.
+ */
+export function selectPromptSectionsWithinBudget(sections, maxChars) {
+    const required = sections.filter((section) => section.governance === "required");
+    const keep = new Set();
+    const skipped = [];
+    let used = required.reduce((total, section) => total + section.content.length, 0);
+    let count = required.length;
+    const requiredFit = used + count * PROMPT_SECTION_SEPARATOR.length + TRIM_NOTE_MAX_CHARS <=
+        maxChars;
+    for (const [index, section] of sections.entries()) {
+        if (section.governance === "required") {
+            keep.add(index);
+            continue;
+        }
+        const projected = used +
+            section.content.length +
+            (count + 1) * PROMPT_SECTION_SEPARATOR.length +
+            TRIM_NOTE_MAX_CHARS;
+        if (requiredFit && projected <= maxChars) {
+            keep.add(index);
+            used += section.content.length;
+            count++;
         }
         else {
-            omitted++;
+            skipped.push({
+                label: promptSectionLabel(section.content),
+                chars: section.content.length,
+            });
         }
     }
-    if (omitted > 0)
-        selected.push(omissionNote);
-    return selected;
+    const selected = sections
+        .filter((_section, index) => keep.has(index))
+        .map((section) => section.content);
+    if (skipped.length > 0) {
+        selected.push(promptBudgetTrimNote(skipped, maxChars));
+    }
+    const totalChars = selected.reduce((total, section) => total + section.length, 0) +
+        Math.max(0, selected.length - 1) * PROMPT_SECTION_SEPARATOR.length;
+    return {
+        sections: selected,
+        skipped,
+        overflowChars: requiredFit ? 0 : Math.max(0, totalChars - maxChars),
+    };
 }
 function isAutoLoadedInstructionPath(path) {
     const normalized = normalizeResourcePathForPrompt(path);
@@ -551,6 +603,14 @@ async function loadResourceIndexForPrompt(owner, scope) {
 export async function loadResourcesForPrompt(owner, compact = false, selfAppId, orgId = getRequestOrgId() ?? null) {
     await ensurePersonalDefaults(owner);
     const sections = [];
+    const addSection = (content, governance = "inherited") => {
+        if (content?.trim())
+            sections.push({ content, governance });
+    };
+    const addSections = (blocks, governance = "inherited") => {
+        for (const block of blocks)
+            addSection(block, governance);
+    };
     const promptResourceMaxChars = compact
         ? COMPACT_PROMPT_RESOURCE_MAX_CHARS
         : SHARED_PROMPT_RESOURCE_MAX_CHARS;
@@ -568,8 +628,7 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
                 maxChars: promptResourceMaxChars,
                 readHint: 'Use docs-search --slug "agents-workspace" to read the full workspace AGENTS.md.',
             });
-            if (block)
-                sections.push(block);
+            addSection(block, "required");
         }
         // 2. Template AGENTS.md — always included (critical template instructions).
         if (bundle.agentsMd.trim()) {
@@ -581,8 +640,7 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
                 maxChars: promptResourceMaxChars,
                 readHint: 'Use docs-search --slug "agents-template" to read the full template AGENTS.md.',
             });
-            if (block)
-                sections.push(block);
+            addSection(block);
         }
         // In compact mode, skip the full skills block — the agent can use
         // `docs-search` to find skills when it needs them. Either way, `scope: dev`
@@ -590,8 +648,7 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
         const runtimeSkills = getRuntimeSkills(bundle);
         if (!compact) {
             const skillsBlock = generateSkillsPromptBlock(bundle);
-            if (skillsBlock)
-                sections.push(skillsBlock);
+            addSection(skillsBlock);
         }
         else if (runtimeSkills.length > 0) {
             const listedSkills = runtimeSkills.slice(0, PROMPT_SKILL_SUMMARY_LIMIT);
@@ -604,7 +661,7 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
             if (runtimeSkills.length > listedSkills.length) {
                 lines.push(`- ...${runtimeSkills.length - listedSkills.length} more codebase skills. Use \`docs-search --query "<topic>"\` to discover the relevant one.`);
             }
-            sections.push(`<skills-summary>\nCodebase skills bundled from \`.agents/skills/\` (or legacy \`.agent/skills/\`) are available as docs-search pages. Do not use MCP resource reads for these skills.\n\n${lines.join("\n")}\n</skills-summary>`);
+            addSection(`<skills-summary>\nCodebase skills bundled from \`.agents/skills/\` (or legacy \`.agent/skills/\`) are available as docs-search pages. Do not use MCP resource reads for these skills.\n\n${lines.join("\n")}\n</skills-summary>`);
         }
     }
     catch { }
@@ -612,38 +669,33 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
     // every app in the workspace, not copied into app scopes. They may come from
     // SQL, Dispatch, or local file mode.
     const workspaceAgents = await loadAgentsResourceForPrompt(WORKSPACE_OWNER, "workspace", promptResourceMaxChars);
-    if (workspaceAgents)
-        sections.push(workspaceAgents);
-    sections.push(...(await loadInstructionResourcesForPrompt(WORKSPACE_OWNER, "workspace-instruction", promptResourceMaxChars, compact)));
+    addSection(workspaceAgents);
+    addSections(await loadInstructionResourcesForPrompt(WORKSPACE_OWNER, "workspace-instruction", promptResourceMaxChars, compact));
     const organizationOwner = sharedResourceOwner(orgId);
     // 4. Legacy app-wide defaults. Existing deployments keep their seeded
     // shared guidance as an inherited fallback; organization writes never
     // mutate this owner.
     const appDefaultAgents = await loadAgentsResourceForPrompt(SHARED_OWNER, organizationOwner === SHARED_OWNER ? "shared" : "app-default", promptResourceMaxChars);
-    if (appDefaultAgents)
-        sections.push(appDefaultAgents);
-    sections.push(...(await loadInstructionResourcesForPrompt(SHARED_OWNER, organizationOwner === SHARED_OWNER
+    addSection(appDefaultAgents);
+    addSections(await loadInstructionResourcesForPrompt(SHARED_OWNER, organizationOwner === SHARED_OWNER
         ? "shared-instruction"
-        : "app-default-instruction", promptResourceMaxChars, compact)));
+        : "app-default-instruction", promptResourceMaxChars, compact));
     // 5. Active organization resources. These are the durable team rules and
     // learnings that Slack/integration runs share with interactive app chat.
     if (organizationOwner !== SHARED_OWNER) {
         const organizationAgents = await loadAgentsResourceForPrompt(organizationOwner, "organization", promptResourceMaxChars);
-        if (organizationAgents)
-            sections.push(organizationAgents);
-        sections.push(...(await loadInstructionResourcesForPrompt(organizationOwner, "organization-instruction", promptResourceMaxChars, compact)));
+        addSection(organizationAgents);
+        addSections(await loadInstructionResourcesForPrompt(organizationOwner, "organization-instruction", promptResourceMaxChars, compact));
     }
     // 6. Personal SQL resources. These come last in the instruction stack so a
     // user can narrow or override organization/app and workspace defaults.
     if (owner !== SHARED_OWNER && owner !== WORKSPACE_OWNER) {
         const personalAgents = await loadAgentsResourceForPrompt(owner, "personal", promptResourceMaxChars);
-        if (personalAgents)
-            sections.push(personalAgents);
-        sections.push(...(await loadInstructionResourcesForPrompt(owner, "personal-instruction", promptResourceMaxChars, compact)));
+        addSection(personalAgents, "user");
+        addSections(await loadInstructionResourcesForPrompt(owner, "personal-instruction", promptResourceMaxChars, compact), "user");
     }
     const resourceSkillsBlock = await loadResourceSkillsPromptBlock(owner, orgId);
-    if (resourceSkillsBlock)
-        sections.push(resourceSkillsBlock);
+    addSection(resourceSkillsBlock);
     let sharedLearnings = null;
     try {
         sharedLearnings =
@@ -666,10 +718,11 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
                 content: sharedLearnings.content,
                 maxChars: COMPACT_PROMPT_RESOURCE_MAX_CHARS,
             });
-            if (block)
-                sections.push(block);
+            addSection(block);
         }
-        sections.push(`<context-note>Organization learnings above and your personal memory (memory/MEMORY.md) are available via the \`resources\` tool. Save durable team facts and routing conventions to shared LEARNINGS.md; keep personal preferences in save-memory.</context-note>`);
+        // The pointer to on-demand learnings/memory must survive trimming: without
+        // it the agent has no way to learn those scopes exist at all.
+        addSection(`<context-note>Organization learnings above and your personal memory (memory/MEMORY.md) are available via the \`resources\` tool. Save durable team facts and routing conventions to shared LEARNINGS.md; keep personal preferences in save-memory.</context-note>`, "required");
     }
     else {
         // LEARNINGS.md from SQL (template-level instructions are in AGENTS.md
@@ -683,8 +736,7 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
                 content: sharedLearnings.content,
                 maxChars: SHARED_PROMPT_RESOURCE_MAX_CHARS,
             });
-            if (block)
-                sections.push(block);
+            addSection(block);
         }
         // 3. Personal memory index (skip if owner is the shared sentinel).
         // Same cap as LEARNINGS.md — a large personal MEMORY.md index must not
@@ -701,35 +753,34 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
                         content: memoryIndex.content,
                         maxChars: SHARED_PROMPT_RESOURCE_MAX_CHARS,
                     });
-                    if (block)
-                        sections.push(block);
+                    addSection(block, "user");
                 }
             }
             catch { }
         }
     }
     const workspaceResourceIndex = await loadResourceIndexForPrompt(WORKSPACE_OWNER, "workspace");
-    if (workspaceResourceIndex)
-        sections.push(workspaceResourceIndex);
+    addSection(workspaceResourceIndex);
     const appDefaultResourceIndex = await loadResourceIndexForPrompt(SHARED_OWNER, "shared");
-    if (appDefaultResourceIndex)
-        sections.push(appDefaultResourceIndex);
+    addSection(appDefaultResourceIndex);
     if (organizationOwner !== SHARED_OWNER) {
         const organizationResourceIndex = await loadResourceIndexForPrompt(organizationOwner, "shared");
-        if (organizationResourceIndex)
-            sections.push(organizationResourceIndex);
+        addSection(organizationResourceIndex);
     }
-    sections.push(...(await loadPromptContextProviderBlocks({
+    addSections(await loadPromptContextProviderBlocks({
         owner,
         compact,
         selfAppId,
         orgId,
-    })));
+    }));
     try {
         const agents = (await discoverAgents(selfAppId)).slice(0, 30);
         if (agents.length > 0) {
             const lines = agents.map((agent) => `- ${agent.name} (${agent.id}) — ${agent.description || "Connected A2A app"}`);
-            sections.push(`<available-apps>\nWorkspace apps available over A2A/call-agent:\n${lines.join("\n")}\n\nUse \`call-agent\` with the app id when another app owns the work or data. Use tool-search or app-specific actions for details only when needed.\n</available-apps>`);
+            // Nothing else in the prompt or the initial tool surface tells the agent
+            // which peer apps exist, so this block is not droppable: without it the
+            // agent reports cross-app work as impossible instead of delegating.
+            addSection(`<available-apps>\nWorkspace apps available over A2A/call-agent:\n${lines.join("\n")}\n\nUse \`call-agent\` with the app id when another app owns the work or data. Use tool-search or app-specific actions for details only when needed.\n\nThese one-liners are the only cross-app detail in this prompt. Before building a capability another app may already own, before telling the user what is or is not possible across apps, and whenever the user asks which app to use, call \`describe-workspace-apps\` — it reads each peer's live agent card and returns their exact callable actions. Never hand-maintain a list of workspace apps in code or docs; it goes stale silently.\n</available-apps>`, "required");
         }
     }
     catch {
@@ -737,9 +788,19 @@ export async function loadResourcesForPrompt(owner, compact = false, selfAppId,
     }
     if (sections.length === 0)
         return "";
-    const selectedSections = compact
-        ? selectPromptSectionsWithinBudget(sections, COMPACT_PROMPT_RESOURCES_TOTAL_MAX_CHARS)
-        : sections;
+    let selectedSections = sections.map((section) => section.content);
+    if (compact) {
+        const budget = selectPromptSectionsWithinBudget(sections, COMPACT_PROMPT_RESOURCES_TOTAL_MAX_CHARS);
+        selectedSections = budget.sections;
+        if (budget.skipped.length > 0) {
+            console.warn(`[agent-native] startup context exceeded the ${COMPACT_PROMPT_RESOURCES_TOTAL_MAX_CHARS.toLocaleString()}-character compact budget for ${selfAppId ?? "app"}; omitted ${budget.skipped.length} discretionary section(s): ${budget.skipped
+                .map((section) => `${section.label} (${section.chars} chars)`)
+                .join(", ")}`);
+        }
+        if (budget.overflowChars > 0) {
+            console.warn(`[agent-native] required startup context alone exceeds the compact budget by ${budget.overflowChars.toLocaleString()} characters for ${selfAppId ?? "app"}; sending it over budget rather than truncating required context. Shrink workspace-core AGENTS.md or reduce discovered workspace apps.`);
+        }
+    }
     return ("\n\nThe following resources contain template-specific instructions and user context. Use the information in them to help the user.\n\n" +
         selectedSections.join("\n\n"));
 }