@agent-native/core 0.145.5 → 0.145.6

package/dist/templates/workspace-core/.agents/skills/delegate-to-agent/SKILL.md

@@ -14,11 +14,21 @@ metadata:
 
 ## Rule
 
-The UI never calls an LLM directly. Product workflows are delegated to the
-agent through the chat bridge so users can see, steer, and audit the work.
-Server-side one-shot model calls are an explicit escape hatch for narrow text
-transforms only; use `completeText()` from `@agent-native/core/server` when the
-work intentionally does not need tools, chat history, or run state.
+The app's default AI surface is the agent chat. Any user-facing work that asks
+the model to research, analyze, generate, recommend, synthesize, or reason over
+multiple steps must start or continue in the AgentSidebar so users can see,
+steer, and audit the work. UI buttons use `sendToAgentChat()` with
+`openSidebar: true`, and follow-up or revision text belongs in that same thread
+instead of a second app-local textbox.
+
+Actions are tools, not alternate AI runtimes. Keep them deterministic and
+focused: provider reads, validation, deterministic transforms, CRUD, and
+persistence are good action work. Let the agent orchestrate several such tools
+when the workflow is AI-shaped or user-steerable. Server-side one-shot model
+calls are a rare escape hatch for narrow text transforms only; use
+`completeText()` from `@agent-native/core/server` only when the work
+intentionally does not need tools, chat history, run state, side effects, or
+user steering.
 
 ## Why
 
@@ -35,6 +45,7 @@ sendToAgentChat({
   message: "Generate a summary of this document",
   context: documentContent, // optional hidden context (not shown in chat UI)
   submit: true, // auto-submit to the agent
+  openSidebar: true,
 });
 ```
 
@@ -56,6 +67,10 @@ sendToAgentChat({
 This is still a full agent run: tools, actions, thread state, and run tracking
 all remain active. It simply does not focus or open the sidebar.
 
+Use this silent form only for explicitly background or system-initiated work.
+It is not the default for a user clicking an AI-labeled button; visible work
+should open the sidebar so the user can follow and redirect the run.
+
 **From scripts (Node):**
 
 ```ts
@@ -77,8 +92,9 @@ const result = await completeText({
 });
 ```
 
-Wrap user-facing uses in actions so the UI and agent share the same operation.
-Do not call provider SDKs directly.
+If the narrow exception is exposed to the UI, wrap it in an action so the UI
+and agent share the same operation. Keep it clearly non-conversational and do
+not call provider SDKs directly.
 
 **From the UI, detecting when agent is done:**
 
@@ -97,9 +113,9 @@ The `submit` option controls whether the message is sent automatically or placed
 
 | `submit` value | Behavior                                | Use when                                                                            |
 | -------------- | --------------------------------------- | ----------------------------------------------------------------------------------- |
-| `true`         | Auto-submits to the agent immediately   | Routine operations the user has already approved                                    |
-| `false`        | Prefills the chat input for user review | High-stakes operations (deleting data, modifying code, API calls with side effects) |
-| omitted        | Uses the project's default setting      | General-purpose delegation                                                          |
+| `true`         | Auto-submits to the agent immediately   | Routine operations with clear intent; keep `openSidebar: true` for visible work |
+| `false`        | Prefills the AgentSidebar composer      | Review, edit, or add detail before the run; use the existing sidebar thread   |
+| omitted        | Uses the project's default setting      | General-purpose delegation                                                       |
 
 ```ts
 // Auto-submit: routine operation
@@ -109,61 +125,43 @@ sendToAgentChat({ message: "Update the project summary", submit: true });
 sendToAgentChat({
   message: "Delete all projects older than 30 days",
   submit: false,
+  openSidebar: true,
 });
 ```
 
-## Capture user input first when generating from a prompt
-
-Buttons that produce new content ("New Design", "Create Dashboard", "Make Deck", "Generate Form") need the user's prompt as input. **Never hardcode a generic message** — the result will be a generic generation the user didn't actually ask for.
+## Capture user input in the sidebar
 
-**Bad** — auto-submits a placeholder message; the user never said what they wanted:
+The AgentSidebar composer is the default prompt surface. When a button needs
+the user to describe what to create, prefill that same composer and let the
+user edit or complete it:
 
 ```tsx
 <Button
   onClick={() =>
-    sendToAgentChat({ message: "make a design", submit: true })
+    sendToAgentChat({
+      message: "Help me create a research report from this brief:",
+      context: researchBrief,
+      submit: false,
+      openSidebar: true,
+    })
   }
 >
-  New Design
+  Start in agent
 </Button>
 ```
 
-**Good** — Popover anchored to the button captures the prompt, then submits it:
-
-```tsx
-<Popover open={open} onOpenChange={setOpen}>
-  <PopoverTrigger asChild>
-    <Button>New Design</Button>
-  </PopoverTrigger>
-  <PopoverContent className="w-96">
-    <Textarea
-      autoFocus
-      value={prompt}
-      onChange={(e) => setPrompt(e.target.value)}
-      placeholder="What do you want to design?"
-    />
-    <Button
-      onClick={() => {
-        sendToAgentChat({ message: prompt, submit: true });
-        setOpen(false);
-        setPrompt("");
-      }}
-    >
-      Create
-    </Button>
-  </PopoverContent>
-</Popover>
-```
-
-**Always ask for input first when** the output depends on a prompt the user must provide — "design what?", "deck about what?", "dashboard for which metric?", "form for which use case?".
-
-**Auto-submit without input is fine when intent is unambiguous:**
+Never auto-submit a generic creative prompt when the user has not said what
+they want. Auto-submit without additional input is fine when intent is
+unambiguous:
 
 - "Try to fix" on a tool error — submits the error details with a clear fix instruction
 - "Retry the last operation" after a transient failure
 - Single-purpose buttons where there is nothing meaningful for the user to add
 
-If you find yourself writing `submit: true` with a hardcoded creative verb (`"design a..."`, `"write a..."`, `"build a..."`), stop and add a Popover.
+Use a Popover only for compact, structured parameters the UI must validate,
+such as a date range, target, or approval choice. Do not add a second freeform
+prompt or follow-up textbox for an AI workflow; keep the conversation and
+revisions in the AgentSidebar thread.
 
 ## Delegating to a Sub-Agent (Agent Teams)
 

package/dist/templates/workspace-core/.agents/skills/frontend-design/SKILL.md

@@ -130,6 +130,7 @@ passed this requirement yet.
 - Do not build custom dropdowns, menus, popovers, modals, or confirmations with manual absolute positioning and click-outside effects.
 - Never use browser dialogs (`window.alert`, `window.confirm`, `window.prompt`). Use `AlertDialog`, `Dialog`, or app-specific confirmation UI.
 - Use Tabler icons for all first-party UI icons. Do not add Lucide, Heroicons, inline SVG icon sets, or emoji icons.
+- Keep inline help/info glyphs next to labels at `size-3` (12px) or smaller than the adjacent text. Preserve a larger hit area on the trigger, not the glyph. Use `guard:allow-large-help-icon` only for deliberate heading documentation or menu action exceptions.
 - Use `useActionQuery` and `useActionMutation` from `@agent-native/core/client` for action-backed UI. Standard CRUD should go through actions, not custom `/api/` routes.
 - Keep UI optimistic where possible: update cache and navigation immediately, then reconcile or roll back on mutation result.
 - Custom styles belong in Tailwind classes, component CSS, or the existing global CSS theme file; avoid inline styles.

package/dist/templates/workspace-core/.agents/skills/turn-into-app/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: turn-into-app
 description: >-
-  Turn a proven thread, skill, or workflow into a runnable Agent-Native app
-  with simple buttons, visible agent steps, preview, and deployment handoff.
-  Use when a user invokes `/turn-into-app` or asks to make a workflow into an
-  app.
+  Turn visible project context, a proven thread, skill, or workflow into a
+  runnable Agent-Native app with simple buttons, visible agent steps, preview,
+  and deployment handoff. Use when a user invokes `/turn-into-app` or asks to
+  make a workflow into an app.
 user-invocable: true
 scope: both
 metadata:
@@ -17,34 +17,72 @@ metadata:
 
 This is an end-to-end build skill, not a request for an app proposal.
 
-- With no argument, use the current thread as the source. This is the normal
-  invocation at the end of a successful workflow.
+- With no argument, choose the source in this order: visible project context,
+  then the current thread. A fresh Claude or ChatGPT Project is a valid source
+  on its first turn. Treat its visible project instructions, knowledge files,
+  and supplied past runs as the source; a completed thread is not required.
+  Treat the current turn as a request or configuration unless it contains a
+  concrete repeatable workflow.
 - With a named skill or local workflow, read that source and package it
   immediately, even at the beginning of a thread. For example,
   `/turn-into-app /some-skill` means “turn `/some-skill` into an app.”
 - With an attachment or path, read the supplied artifact as the source.
 - Do not ask the user to restate context that is already in the thread.
-- When invoked from an Agent-Native app, keep the current thread as the source
-  and use the available workspace/coding-agent handoff when the current runtime
-  cannot edit files. Do not claim the app exists without an actual path and
-  verification result.
+- When invoked from an Agent-Native app, use its visible project context first,
+  then the current thread, and use the available workspace/coding-agent
+  handoff when the current runtime cannot edit files. Do not claim the app
+  exists without an actual path and verification result.
 
 ## Source support
 
-Supported source paths today are the current Codex thread, a named skill, or a
-local workflow/transcript supplied as a path or attachment. An exported
-ChatGPT or Claude transcript can use the same local-file path today.
+Supported source paths today are visible Claude or ChatGPT Project context, the
+current Codex or host thread, a named skill, or a local workflow/transcript
+supplied as a path or attachment. An exported ChatGPT or Claude transcript can
+use the same local-file path today.
 
-ChatGPT shared-conversation import and Claude web conversation/project import
-are **coming soon**. Do not claim private web access, invent an importer, add
-fake OAuth, or scrape a logged-in page without an explicit supported adapter.
-If a user gives one of those URLs before an adapter exists, ask for an export or
-transcript instead and treat it as imported source material.
+Claude and ChatGPT Project context is supported only when the host supplies it
+to the model in the current context. The MCP connector does not read hidden
+project chats, private URLs, account settings, or credentials. Do not claim
+private web access, invent an importer, add fake OAuth, or scrape a logged-in
+page. If the needed context is not visible, ask for an export, transcript, or
+attachment and treat that artifact as imported source material.
 
 Deliver a fresh app in a new directory, implement the repeatable workflow with
 buttons and agent handoffs, start its dev server, verify the main path, and
 continue through build/deployment handoff. Do not stop at a plan.
 
+## Fresh project context mode
+
+When the source is a fresh Claude or ChatGPT Project, build a short source brief
+before creating the app. Read the host-provided context in this order:
+
+1. Project instructions and configuration: goal, audience, constraints, output
+   standards, approved tools, and integration expectations. Treat these as
+   product configuration, not as a transcript.
+2. Knowledge files and attachments: read the relevant files fully, preserve
+   their provenance, and reduce them to bounded references, IDs, URLs, or
+   summaries for the new app. Do not copy secrets or large raw payloads into
+   prompts or SQL.
+3. Past runs or examples that are actually visible in the context: select at
+   most 1-3 successful, representative runs. Extract repeatable decisions and
+   review criteria. Treat one-off answers and private data as examples, not as
+   product behavior. If no runs are supplied, proceed from the instructions
+   and knowledge files and say that examples were not available.
+4. The current turn: use it for the requested app boundary, target workspace,
+   naming, and any explicit corrections.
+
+Record the brief with these headings before handoff: source and provenance,
+project goal, configuration and constraints, knowledge sources, repeatable
+workflow, inputs and outputs, judgment and review points, representative runs,
+integrations and permissions, and unknowns. This is the compact contract for
+the app. It keeps the new app useful without pretending that hidden Project
+history was imported. See [the fresh Project reference](references/fresh-project.md)
+for the host setup and brief template.
+
+If the visible Project context has no concrete repeatable job, ask for one
+focused clarification or a representative artifact. Do not fall back to a
+generic “what app do you want to make?” builder.
+
 ## Source selection guard
 
 The generated app must implement the concrete workflow found in the source. It
@@ -151,6 +189,14 @@ pnpm exec agent-native add-app <slug> --template=chat
 Do not use `create` for an existing workspace; it scaffolds a new standalone
 workspace rather than adding an app to the current one.
 
+When the source came from a fresh external Project and the target is a Builder
+workspace, prefer the available Dispatch MCP workspace handoff after writing
+the source brief. Call `start-workspace-app-creation` with a concise prompt,
+the inferred app id, and the brief's repeatable workflow. Pass selected
+workspace resource IDs when they are available, rather than pasting entire
+knowledge files. Continue from the returned workspace path or Builder handoff
+and report the actual verification result.
+
 Use a first-party template only when it materially fits the workflow. Keep the
 new app independent from the source thread's working tree unless the user
 explicitly asks to extend an existing app.
@@ -167,13 +213,20 @@ should make the repeated path obvious without hiding the agent's judgment:
 - Give each important repeated moment a clear button, such as “Analyze,”
   “Suggest options,” “Draft,” “Review,” or “Publish.” Use the source's actual
   vocabulary when it is clear.
-- Put deterministic reads, writes, approvals, and publishing in `actions/`
-  with `defineAction`. The UI and agent must call the same action surface.
+- Put deterministic reads, writes, approvals, provider fetches, and publishing
+  in focused `actions/` with `defineAction`. The UI and agent must call the
+  same action surface.
+- If a workflow is framed as research, analysis, generation, recommendation,
+  or synthesis, start it in the AgentSidebar and let the agent orchestrate
+  those actions. Do not hide an AI-shaped multi-step workflow behind one
+  opaque action just because the implementation is deterministic.
 - Use application state for the current screen, selected item, and focused
   object so the agent can see where the user is.
-- Use `sendToAgentChat({ message, context, submit: true })` for intentional
-  button-triggered agent work. Use `submit: false` when the user should review
-  or edit the proposed prompt first.
+- Use `sendToAgentChat({ message, context, submit: true, openSidebar: true })`
+  for intentional button-triggered agent work. Use `submit: false` when the
+  user should review or edit the proposed prompt in the AgentSidebar first.
+  Keep follow-up and revision prompts in that same thread; do not add a second
+  freeform textbox beside the result.
 - Pass IDs, URLs, and bounded summaries in context. Do not paste large provider
   dumps into prompts, call an LLM directly from the browser, or invent fake
   progress.

package/dist/templates/workspace-core/.agents/skills/turn-into-app/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Turn Into App"
-  short_description: "Turn a thread or skill into a runnable app"
-  default_prompt: "Scan the current thread, turn the workflow into a new Agent-Native app with clear buttons, run it locally, verify it, and complete the deployment handoff."
+  short_description: "Turn project context or a workflow into a runnable app"
+  default_prompt: "Use the visible project context first, then any supplied workflow. Turn the instructions, knowledge files, and selected successful runs into a new Agent-Native app with clear buttons, run it locally, verify it, and complete the deployment handoff."

package/dist/templates/workspace-core/.agents/skills/turn-into-app/references/fresh-project.md

@@ -0,0 +1,64 @@
+# Fresh Project source guide
+
+Use this guide when `/turn-into-app` is invoked in a new Claude or ChatGPT
+Project rather than after a completed thread.
+
+## What the host can provide
+
+The source is whatever the host put in the model's current context:
+
+- Project instructions: the job, audience, constraints, quality bar, and
+  approved tools or integrations.
+- Knowledge files and attachments: reference material, templates, examples,
+  and links that the app should use.
+- Past runs: only conversations or outputs the host actually supplied. They
+  are examples and evaluation material, not an automatic import of every
+  private Project conversation.
+- The current request: the app boundary, target workspace, name, and explicit
+  corrections.
+
+Do not infer hidden system prompts, account settings, private history, API keys,
+or credentials. The Dispatch MCP connector can start a workspace app creation,
+but it cannot unlock or scrape private Project content.
+
+## Source brief
+
+Write a compact brief before starting the app:
+
+```text
+Source: host-provided Claude/ChatGPT Project context
+Provenance: project instructions, selected knowledge files, and visible runs
+Project goal:
+Configuration and constraints:
+Knowledge sources:
+Repeatable workflow:
+Inputs and outputs:
+Judgment and review points:
+Representative runs: none, or 1-3 selected examples
+Integrations and permissions:
+Unknowns and follow-up:
+```
+
+Keep source references bounded. Prefer a file name, URL, resource ID, or short
+summary over a large pasted document. Do not put secrets or raw customer data
+in the brief.
+
+## Fresh-box setup
+
+Install the exported `turn-into-app` skill in the host when the host supports
+skills. For a ChatGPT Project or any host that exposes only the MCP connector,
+also place the skill instructions or this reference in the Project
+instructions/knowledge files. Then add and authenticate the Dispatch MCP
+connector from the packaged `adapters/chatgpt-mcp/connector.json`.
+
+In a new Project chat, say:
+
+```text
+Turn this project into an app. Use the visible Project instructions,
+knowledge files, and any selected successful runs as the source. Create the
+app in the connected Agent-Native workspace, keep the source brief bounded,
+and report the real path and verification result.
+```
+
+If the host does not show the Project instructions or files to the model, stop
+and request an export or attachment. Do not claim that the Project was read.

package/dist/templates/workspace-core/.agents/skills/workspace-conventions/SKILL.md

@@ -48,6 +48,10 @@ Preview before `--apply`, commit `agent-native.ejections.json`, and never edit
   must not call model providers, AI SDK `generateText()` / `streamText()`, or
   other inline LLM APIs directly. Use `sendToAgentChat()` for local app-agent
   work, including hidden `context` and `submit: false` prefill/review flows.
+  Keep actions deterministic and focused. If a workflow is framed as research,
+  analysis, generation, recommendation, or synthesis, let the agent
+  orchestrate provider/data actions in the open AgentSidebar instead of hiding
+  the work in one opaque action or a separate follow-up textbox.
   Only use `useAgentChatContext`, `setAgentChatContextItem`,
   `listAgentChatContext`, `removeAgentChatContextItem`, and
   `clearAgentChatContext` when UI needs two-way sync with staged context chips.

package/dist/templates/workspace-core/.agents/skills/writing-agent-instructions/SKILL.md

@@ -117,6 +117,14 @@ contract:
 - Do not create pass-through routes whose main job is to call, repackage, or
   re-export an action.
 
+Generated guidance must also distinguish deterministic tools from AI-shaped
+workflows. Provider reads, validation, deterministic transforms, CRUD, and
+persistence belong in focused actions. Research, analysis, generation,
+recommendation, synthesis, and other user-steerable multi-step work should
+start in the AgentSidebar and let the agent orchestrate those actions. State
+that `sendToAgentChat({ openSidebar: true })` is the default handoff and that
+follow-ups stay in the same thread; do not add a second freeform prompt box.
+
 ## Budget the first model request
 
 Treat the initial prompt and tool catalog as a latency budget. The agent should

package/dist/templates/workspace-core/AGENTS.md

@@ -31,8 +31,13 @@ agent should know.
 
 - All AI/LLM behavior goes through the app's agent chat. UI and server code must
   not call model providers or AI SDK `generateText()` / `streamText()` directly;
-  use `sendToAgentChat()`. Read `.agents/skills/delegate-to-agent/SKILL.md`
-  before building agent-driven UI or "AI" features.
+  use `sendToAgentChat()`. Keep actions deterministic and focused. If a
+  workflow is framed as research, analysis, generation, recommendation, or
+  synthesis, use `sendToAgentChat({ openSidebar: true })` to open the
+  AgentSidebar and let the agent orchestrate its provider/data actions. Keep
+  follow-ups in the same thread, not a second freeform textbox. Read
+  `.agents/skills/delegate-to-agent/SKILL.md` before building agent-driven UI or
+  "AI" features.
 - Keep domain workflows on named routes and preserve the scaffold's full-page
   chat route. Use the right `AgentSidebar` for contextual AI and open it when a
   domain button hands work to the agent.

package/dist/templates/workspace-root/AGENTS.md

@@ -50,6 +50,11 @@ refreshes framework-provided shared skills and repairs `CLAUDE.md` /
   must not call model providers, AI SDK `generateText()` / `streamText()`, or
   other inline LLM APIs directly. Use `sendToAgentChat()` for local app-agent
   work, including hidden `context` and `submit: false` prefill/review flows.
+  Keep actions deterministic and focused. If a workflow is framed as research,
+  analysis, generation, recommendation, or synthesis, use
+  `sendToAgentChat({ openSidebar: true })` to open the AgentSidebar and let the
+  agent orchestrate its provider/data actions. Keep follow-ups in the same
+  thread, not a second freeform textbox.
   Only use `useAgentChatContext`, `setAgentChatContextItem`,
   `listAgentChatContext`, `removeAgentChatContextItem`, and
   `clearAgentChatContext` when UI needs two-way sync with staged context chips.

package/dist/vite/client.d.ts

@@ -1,5 +1,5 @@
 import { type DesignSystemTheme } from "@agent-native/toolkit/design-system/theme";
-import type { Plugin, UserConfig } from "vite";
+import { type Plugin, type UserConfig } from "vite";
 import { type AgentNativeConfigInput } from "../config.js";
 import { type McpIntegrationsConfigInput } from "../shared/mcp-integration-config.js";
 import { type AgentNativeRouteWarmupConfigInput } from "../shared/route-warmup-config.js";
@@ -117,8 +117,8 @@ export interface ClientConfigOptions {
     define?: UserConfig["define"];
     /**
      * Public app behavior from `agent-native.json` or an optional typed
-     * `agent-native.config.ts` file. Explicit Vite options win over the JSON
-     * file, while the file remains the default project-level source of truth.
+     * `agent-native.ts` file. Explicit Vite options win over the JSON file,
+     * while the file remains the default project-level source of truth.
      */
     agentNativeConfig?: AgentNativeConfigInput;
     /**

package/dist/vite/client.js

@@ -4,6 +4,7 @@ import { createRequire, syncBuiltinESMExports } from "module";
 import path from "path";
 import { fileURLToPath, pathToFileURL } from "url";
 import { renderDesignSystemThemeCss, } from "@agent-native/toolkit/design-system/theme";
+import { loadEnv, } from "vite";
 import { mergePendingChangelog, parsePendingEntry, } from "../changelog/parse.js";
 import { getViteDevRecoveryScript } from "../client/vite-dev-recovery-script.js";
 import { mergeAgentNativeConfigs, normalizeAgentNativeConfig, resolveAgentNativeConfig, } from "../config.js";
@@ -14,11 +15,13 @@ import { EMBED_SESSION_COOKIE, EMBED_TOKEN_QUERY_PARAM, MCP_APP_CHAT_BRIDGE_QUER
 import { isMcpEmbedCorsOrigin, MCP_EMBED_CORS_ALLOW_HEADERS, MCP_EMBED_STATIC_ASSET_HEADERS, mcpEmbedStaticAssetRouteRules, shouldAllowMcpEmbedCredentials, } from "../shared/mcp-embed-headers.js";
 import { normalizeMcpIntegrationsConfig, } from "../shared/mcp-integration-config.js";
 import { normalizeAgentNativeRouteWarmupConfig, } from "../shared/route-warmup-config.js";
+import { formatRuntimeConfigReport, getRuntimeConfigReport, } from "../shared/runtime-config.js";
 import { actionTypesPlugin } from "./action-types-plugin.js";
 import { agentsBundlePlugin } from "./agents-bundle-plugin.js";
 const require = createRequire(import.meta.url);
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 let nitroFsWatchGuardInstalled = false;
+const emittedRuntimeConfigDiagnostics = new Set();
 function isFileWatchLimitError(error) {
     return error?.code === "EMFILE" || error?.code === "ENOSPC";
 }
@@ -2632,7 +2635,12 @@ function readAgentNativeJsonConfig(cwd) {
     return normalizeAgentNativeConfig(parsed, configPath);
 }
 async function loadAgentNativeConfigFile(cwd) {
-    const candidates = ["agent-native.config.ts", "agent-native.config.mts"];
+    const candidates = [
+        "agent-native.ts",
+        "agent-native.mts",
+        "agent-native.config.ts",
+        "agent-native.config.mts",
+    ];
     const configPath = candidates
         .map((filename) => path.join(cwd, filename))
         .find((candidate) => fs.existsSync(candidate));
@@ -2650,6 +2658,36 @@ async function loadAgentNativeConfigFile(cwd) {
         throw new Error(`Could not load ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+function reportRuntimeConfigDiagnostics(appConfig, context, mode, env = process.env) {
+    const production = mode === "production" || process.env.NODE_ENV === "production";
+    if (!production)
+        return;
+    const report = getRuntimeConfigReport(env, {
+        authEnabled: appConfig.runtime?.auth?.enabled,
+        databaseRequired: appConfig.runtime?.database?.required,
+        requiredEnv: appConfig.runtime?.environment?.required,
+    }, {
+        environment: "production",
+        phase: context.isBuild ? "build" : "runtime",
+        appName: process.env.APP_NAME,
+    });
+    if (report.issues.length === 0)
+        return;
+    const key = [
+        process.cwd(),
+        context.command,
+        mode,
+        report.issues.map((issue) => `${issue.code}:${issue.severity}`).join(","),
+    ].join("|");
+    if (emittedRuntimeConfigDiagnostics.has(key))
+        return;
+    emittedRuntimeConfigDiagnostics.add(key);
+    const message = formatRuntimeConfigReport(report);
+    if (context.isBuild && appConfig.diagnostics?.failOnBuild === true) {
+        throw new Error(message);
+    }
+    console.warn(message);
+}
 function createAgentNativeConfig(options = {}, command, userConfig = {}, mode = process.env.NODE_ENV === "production" ? "production" : "development", projectConfig) {
     const cwd = process.cwd();
     const configContext = createAgentNativeConfigContext(command, mode);
@@ -2684,6 +2722,14 @@ function createAgentNativeConfig(options = {}, command, userConfig = {}, mode =
         }
         catch { }
     }
+    const runtimeEnv = {
+        ...(workspaceRoot && workspaceRoot !== cwd
+            ? loadEnv(mode, workspaceRoot, "")
+            : {}),
+        ...loadEnv(mode, cwd, ""),
+        ...process.env,
+    };
+    reportRuntimeConfigDiagnostics(appConfig, configContext, mode, runtimeEnv);
     const { base } = getConfiguredAppBasePath();
     const isWorkspaceChild = process.env.AGENT_NATIVE_WORKSPACE === "1";
     const monorepoPackageAllow = [

package/dist/vite/index.d.ts

@@ -1,5 +1,5 @@
 export { agentNative, defineConfig, type AgentNativeVitePluginOptions, type ClientConfigOptions, type NitroOptions, } from "./client.js";
-export { defineAgentNativeConfig, type AgentNativeConfig, type AgentNativeConfigContext, type AgentNativeConfigFactory, type AgentNativeConfigInput, type AgentNativeFirstRunOnboardingMode, type AgentNativeFirstRunOnboardingSetting, } from "../config.js";
+export { defineAgentNativeConfig, type AgentNativeConfig, type AgentNativeConfigContext, type AgentNativeConfigFactory, type AgentNativeConfigInput, type AgentNativeDiagnosticsConfig, type AgentNativeFirstRunOnboardingMode, type AgentNativeFirstRunOnboardingSetting, type AgentNativeRuntimeAuthConfig, type AgentNativeRuntimeConfig, type AgentNativeRuntimeDatabaseConfig, type AgentNativeRuntimeEnvironmentConfig, } from "../config.js";
 export type { AgentNativeRouteWarmupConfigInput, AgentNativeRouteWarmupResolvedConfig, AgentNativeRouteWarmupStrategy, } from "../shared/route-warmup-config.js";
 export { actionTypesPlugin, generateActionRegistryForProject, } from "./action-types-plugin.js";
 export { agentsBundlePlugin } from "./agents-bundle-plugin.js";