@agent-native/core 0.173.2-nightly-20260825163448 → 0.174.0

package/dist/app-config/store.js

@@ -1,3 +1,4 @@
+import { deriveAppIdentity } from "./app-identity.js";
 import { readEnvConfigLayer } from "./env-layer.js";
 import { assertRunLifecycleInvariants } from "./run-lifecycle-invariants.js";
 import { appConfigSchema, } from "./schema.js";
@@ -54,6 +55,9 @@ function resolve(envLayer) {
     // Defaults go through here too — the pair that shipped violated was a pair of
     // defaults.
     assertRunLifecycleInvariants(parsed.agent);
+    // After parsing, not as a layer: it derives from `packageName`, which the
+    // layers above have to have resolved first.
+    parsed.app = deriveAppIdentity(parsed.app);
     return parsed;
 }
 /**
@@ -92,12 +96,23 @@ export function setAppConfigLayer(layer, config) {
 /**
  * Sets this app's server configuration.
  *
- * Call it from a server plugin. Values given here beat any environment
- * variable aliased to the same field. Calling it more than once merges, so an
- * app can split its configuration by domain across plugin files.
+ * Values given here beat any environment variable aliased to the same field.
+ * Calling it more than once merges, so an app can split its configuration by
+ * domain across plugin files.
+ *
+ * Returns a Nitro plugin so the canonical home is `server/plugins/config.ts`
+ * with `export default defineAppConfig({ … })` — the same shape as every other
+ * framework plugin an app already writes. Before that, the docs said "call it
+ * from a server plugin" without saying what such a file looks like, and no app
+ * in this repo ever did.
+ *
+ * The layer is applied here, at module load, not when the returned plugin runs:
+ * configuration has to be resolved before another plugin reads it, and plugin
+ * invocation order is not something an app should have to reason about.
  */
 export function defineAppConfig(config) {
     setAppConfigLayer("app", config);
+    return () => { };
 }
 /**
  * The resolved configuration, with declared defaults applied.

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
+    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
-    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
+    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
-    error?: undefined;
 }>>;

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/email-catalog/actions/list-email-log.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { defineAction } from "../../action.js";
-import { getAppSlug } from "../../server/app-name.js";
+import { getAppConfig } from "../../app-config/index.js";
 import { getRequestOrgId } from "../../server/request-context.js";
 import { authorizeTransactionalEmailRead } from "../authorize.js";
 import { listEmailLog } from "../log.js";
@@ -15,7 +15,7 @@ export default defineAction({
     run: async ({ templateId, limit }) => ({
         entries: await listEmailLog({
             orgId: getRequestOrgId() ?? "",
-            app: getAppSlug() ?? "unknown",
+            app: getAppConfig().app.slug ?? "unknown",
             templateId,
             limit,
         }),

package/dist/email-catalog/actions/list-transactional-emails.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { defineAction } from "../../action.js";
-import { getAppSlug } from "../../server/app-name.js";
+import { getAppConfig } from "../../app-config/index.js";
 import { getRequestOrgId } from "../../server/request-context.js";
 import { authorizeTransactionalEmailRead } from "../authorize.js";
 import { getEmailSendStats } from "../log.js";
@@ -23,7 +23,7 @@ export default defineAction({
     run: async ({ windowDays }) => {
         registerCoreSystemEmails();
         const since = Date.now() - windowDays * 24 * 60 * 60 * 1000;
-        const app = getAppSlug() ?? "unknown";
+        const app = getAppConfig().app.slug ?? "unknown";
         const orgId = getRequestOrgId();
         const definitions = listTransactionalEmails();
         // A failed stats read must not masquerade as "no email ever sent" — the

package/dist/email-catalog/registry.js

@@ -21,12 +21,12 @@
  * The `id` doubles as the SendGrid category `sendEmail` tags the message with,
  * which is how per-email delivery and open metrics are attributed later.
  */
-import { getAppSlug } from "../server/app-name.js";
+import { getAppConfig } from "../app-config/index.js";
 const registry = new Map();
 function resolveDefinition(definition) {
     return {
         ...definition,
-        app: definition.app ?? getAppSlug() ?? "unknown",
+        app: definition.app ?? getAppConfig().app.slug ?? "unknown",
     };
 }
 function assertCanRegister(resolved, existing) {
@@ -84,7 +84,7 @@ export function defineTransactionalEmails(definitions) {
 }
 /** Replace one app-owned catalog snapshot after validating the full replacement. */
 export function replaceTransactionalEmails(ownerApp, idPrefix, definitions) {
-    const runtimeApp = getAppSlug();
+    const runtimeApp = getAppConfig().app.slug;
     if (!ownerApp || ownerApp.includes(".") || idPrefix !== `${ownerApp}.`) {
         throw new Error("Transactional email replacement requires an owner app and its exact namespace prefix.");
     }

package/dist/mcp/connect-route.js

@@ -29,6 +29,7 @@
 import { randomUUID } from "node:crypto";
 import { getMethod, getHeader } from "h3";
 import { signA2AToken } from "../a2a/client.js";
+import { getAppConfig } from "../app-config/index.js";
 import { getOrgDomain } from "../org/context.js";
 import { getSession, getConfiguredLoginHtml, isLoopbackRequest, } from "../server/auth.js";
 import { readBody } from "../server/h3-helpers.js";
@@ -91,9 +92,21 @@ function joinAppPath(basePath, path) {
         return basePath;
     return `${basePath}${path.startsWith("/") ? path : `/${path}`}`;
 }
+/**
+ * Which app this deployment is, for naming its MCP server.
+ *
+ * The hostname is the LAST resort, not the first: every beta deployment is
+ * `beta.<app>.agent-native.com`, so the leading label is `beta` for all of
+ * them and every beta app advertised itself as `agent-native-beta`. A client
+ * keys its config by that name, so connecting a second beta app overwrote the
+ * first. Declared identity comes first now, and `app.slug` covers every
+ * first-party template with no configuration at all.
+ */
 function appLabel(origin, options) {
-    if (options.appId)
-        return options.appId;
+    const app = getAppConfig().app;
+    const declared = options.appId ?? app.id ?? app.template ?? app.slug;
+    if (declared)
+        return declared;
     try {
         const h = new URL(origin).hostname;
         return h.split(".")[0] || h;

package/dist/notifications/routes.d.ts

@@ -16,18 +16,18 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
     error?: undefined;
     ok?: undefined;
 } | {
-    count?: undefined;
     updated: number;
     error?: undefined;
     ok?: undefined;
-} | {
     count?: undefined;
+} | {
     updated?: undefined;
     error: string;
     ok?: undefined;
-} | {
     count?: undefined;
+} | {
     updated?: undefined;
     error?: undefined;
     ok: boolean;
+    count?: undefined;
 }>>;

package/dist/observability/index.d.ts

@@ -1,5 +1,4 @@
-export type { SpanType, SpanStatus, TraceSpan, TraceSummary, FeedbackType, FeedbackEntry, SatisfactionScore, EvalType, EvalResult, EvalDataset, EvalTestCase, EvalCriteria, ExperimentStatus, ExperimentVariant, Experiment, ExperimentAssignment, ExperimentMetricResult, ObservabilityConfig, ObservabilityExporterConfig, } from "./types.js";
-export { DEFAULT_OBSERVABILITY_CONFIG } from "./types.js";
+export type { SpanType, SpanStatus, TraceSpan, TraceSummary, FeedbackType, FeedbackEntry, SatisfactionScore, EvalType, EvalResult, EvalDataset, EvalTestCase, EvalCriteria, ExperimentStatus, ExperimentVariant, Experiment, ExperimentAssignment, ExperimentMetricResult, ObservabilityConfig, } from "./types.js";
 export { ensureObservabilityTables, insertTraceSpan, upsertTraceSummary, getTraceSpansForRun, getTraceSummaries, getTraceSummary, deleteOldTraceData, insertFeedback, getFeedback, getFeedbackStats, upsertSatisfactionScore, getSatisfactionScores, insertEvalResult, getEvalsForRun, getEvalStats, insertEvalDataset, listEvalDatasets, getEvalDataset, updateEvalDataset, insertExperiment, updateExperiment, listExperiments, getExperiment, upsertAssignment, getAssignment, insertExperimentResult, getExperimentResults, getObservabilityOverview, } from "./store.js";
 export { createObservabilityPlugin } from "./plugin.js";
 export { createObservabilityHandler } from "./routes.js";

package/dist/observability/index.js

@@ -1,4 +1,3 @@
-export { DEFAULT_OBSERVABILITY_CONFIG } from "./types.js";
 export { ensureObservabilityTables, insertTraceSpan, upsertTraceSummary, getTraceSpansForRun, getTraceSummaries, getTraceSummary, deleteOldTraceData, insertFeedback, getFeedback, getFeedbackStats, upsertSatisfactionScore, getSatisfactionScores, insertEvalResult, getEvalsForRun, getEvalStats, insertEvalDataset, listEvalDatasets, getEvalDataset, updateEvalDataset, insertExperiment, updateExperiment, listExperiments, getExperiment, upsertAssignment, getAssignment, insertExperimentResult, getExperimentResults, getObservabilityOverview, } from "./store.js";
 export { createObservabilityPlugin } from "./plugin.js";
 export { createObservabilityHandler } from "./routes.js";

package/dist/observability/posthog-ai.js

@@ -117,9 +117,17 @@ export function boundAiContent(value) {
         // What was ASKED is the one thing worth rescuing from an oversized
         // transcript: the rest is context the thread itself still holds, and
         // keeping as much of it as fits just ships the ceiling on every event.
-        const lastUser = value.findLast((entry) => !!entry &&
-            typeof entry === "object" &&
-            entry.role === "user");
+        // `findLast` is ES2023; this package compiles with lib ES2022.
+        let lastUser;
+        for (let i = value.length - 1; i >= 0; i -= 1) {
+            const entry = value[i];
+            if (!!entry &&
+                typeof entry === "object" &&
+                entry.role === "user") {
+                lastUser = entry;
+                break;
+            }
+        }
         const kept = lastUser !== undefined &&
             utf8Bytes(JSON.stringify(lastUser) ?? "null") <=
                 MAX_AI_CONTENT_BYTES - OMISSION_MARKER_BYTES

package/dist/observability/sentiment.d.ts

@@ -1,6 +1,5 @@
 import type { AgentEngine } from "../agent/engine/types.js";
 import type { ObservabilityConfig } from "./types.js";
-export declare const DEFAULT_INFERRED_SENTIMENT_MODEL = "gpt-5-6-luna";
 export declare const HOSTED_INFERRED_SENTIMENT_SAMPLE_RATE = 1;
 export declare const INFERRED_SENTIMENT_MAX_CHARS = 2000;
 export declare const INFERRED_SENTIMENT_TIMEOUT_MS = 5000;

package/dist/observability/sentiment.js

@@ -1,6 +1,11 @@
+import { observabilityConfig } from "../app-config/observability.js";
 import { trackingIdentityProperties } from "./tracking-identity.js";
-import { DEFAULT_OBSERVABILITY_CONFIG } from "./types.js";
-export const DEFAULT_INFERRED_SENTIMENT_MODEL = "gpt-5-6-luna";
+/**
+ * The schema owns this value; read it back rather than restating it. Reachable
+ * only when a caller passes a partial config — `getObservabilityConfig` always
+ * hands over a parsed one, where the declared default has already applied.
+ */
+const DEFAULT_INFERRED_SENTIMENT_MODEL = observabilityConfig.shape.inferredSentimentModel.parse(undefined);
 export const HOSTED_INFERRED_SENTIMENT_SAMPLE_RATE = 1;
 export const INFERRED_SENTIMENT_MAX_CHARS = 2_000;
 export const INFERRED_SENTIMENT_TIMEOUT_MS = 5_000;
@@ -71,9 +76,7 @@ export function resolveInferredSentimentConfig(stored, env = process.env) {
         inferredSentimentSampleRate: envRate ??
             storedRate ??
             (hosted ? HOSTED_INFERRED_SENTIMENT_SAMPLE_RATE : 0),
-        inferredSentimentModel: envModel ||
-            storedModel ||
-            DEFAULT_OBSERVABILITY_CONFIG.inferredSentimentModel,
+        inferredSentimentModel: envModel || storedModel || DEFAULT_INFERRED_SENTIMENT_MODEL,
     };
 }
 /** Stable deterministic sampling keeps retries for the same run consistent. */

package/dist/observability/traces.js

@@ -3,7 +3,6 @@ import { getRequestContext } from "../server/request-context.js";
 import { MAX_AI_CONTENT_BYTES, MAX_AI_SPANS_PER_RUN, boundAiContent, emitAiSpanEvent, emitAiTraceEvent, resolveAiError, toAiErrorDetail, toPostHogMessages, } from "./posthog-ai.js";
 import { endAgentSpan, startAgentSpan } from "./tracing.js";
 import { trackingIdentityProperties } from "./tracking-identity.js";
-import { DEFAULT_OBSERVABILITY_CONFIG } from "./types.js";
 function spanId() {
     return `span-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
@@ -342,18 +341,13 @@ function redactWalk(value, seen) {
     return out;
 }
 export async function getObservabilityConfig() {
-    let stored = null;
-    try {
-        const { getSetting } = await import("../settings/store.js");
-        stored = (await getSetting("observability-config"));
-    }
-    catch { }
+    const { getAppConfig } = await import("../app-config/store.js");
+    const config = getAppConfig().observability;
     const { resolveInferredSentimentConfig } = await import("./sentiment.js");
-    return {
-        ...DEFAULT_OBSERVABILITY_CONFIG,
-        ...(stored ?? {}),
-        ...resolveInferredSentimentConfig(stored),
-    };
+    // Sentiment keeps its own resolver as the top layer: it derives a default
+    // from whether this is a first-party hosted deployment, which no declared
+    // default can express.
+    return { ...config, ...resolveInferredSentimentConfig(config) };
 }
 export async function instrumentAgentLoop(opts) {
     const { runAgentLoop, loopOpts, runId, threadId, userId, config } = opts;

package/dist/observability/types.d.ts

@@ -175,11 +175,4 @@ export interface ObservabilityConfig {
     inferredSentimentSampleRate: number;
     /** Model used by the managed Builder classifier. */
     inferredSentimentModel: string;
-    exporters: ObservabilityExporterConfig[];
 }
-export interface ObservabilityExporterConfig {
-    type: "otlp" | "console" | "custom";
-    endpoint?: string;
-    headers?: Record<string, string>;
-}
-export declare const DEFAULT_OBSERVABILITY_CONFIG: ObservabilityConfig;

package/dist/observability/types.js

@@ -5,15 +5,4 @@
  * Each domain module imports from here so the data model is consistent
  * across the entire observability stack.
  */
-export const DEFAULT_OBSERVABILITY_CONFIG = {
-    enabled: true,
-    capturePrompts: false,
-    captureToolArgs: false,
-    captureToolResults: false,
-    captureLlmSpans: true,
-    evalSampleRate: 0,
-    inferredSentimentEnabled: false,
-    inferredSentimentSampleRate: 0,
-    inferredSentimentModel: "gpt-5-6-luna",
-    exporters: [],
-};
+export {};

package/dist/progress/routes.d.ts

@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -93,29 +93,29 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     id?: undefined;
     deleted?: undefined;
     providers?: undefined;
-    count?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
-    count?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     provider?: undefined;
     providers?: undefined;
-    count?: undefined;
     found?: undefined;
     deleted: boolean;
     id: string;
@@ -123,10 +123,10 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
-    count?: undefined;
     found?: undefined;
     registered: boolean;
     id: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -312,6 +312,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         scope?: "org" | "user" | undefined;
     }, {
         id?: undefined;
+        message?: undefined;
+        deleted?: undefined;
         providers: {
             id: string;
             label: string;
@@ -324,31 +326,30 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         count: number;
         provider?: undefined;
         found?: undefined;
-        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
         id?: undefined;
+        message?: undefined;
+        deleted?: undefined;
         providers?: undefined;
         count?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
-        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        message?: undefined;
+        deleted?: undefined;
         providers?: undefined;
         count?: undefined;
         provider?: undefined;
         found: boolean;
         id: string;
-        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        message?: undefined;
         providers?: undefined;
         count?: undefined;
         provider?: undefined;
@@ -357,13 +358,12 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        deleted?: undefined;
         providers?: undefined;
         count?: undefined;
         provider?: undefined;
         found?: undefined;
-        deleted?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/resources/handlers.d.ts

@@ -48,8 +48,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/secrets/routes.d.ts

@@ -34,16 +34,16 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 /** POST /_agent-native/secrets/:key — write a secret. */
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    ok?: undefined;
     status?: undefined;
+    ok?: undefined;
 } | {
     ok: boolean;
     status: string;
     error?: undefined;
 } | {
-    ok?: undefined;
     error: string;
     removed?: undefined;
+    ok?: undefined;
 } | {
     ok: boolean;
     removed: boolean;
@@ -54,9 +54,9 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
  * or the current stored value without changing anything.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
     note?: undefined;
+    ok?: undefined;
 } | {
     ok: boolean;
     note?: undefined;

package/dist/server/agent-chat/plugin-options.d.ts

@@ -18,7 +18,14 @@ export interface AgentChatPluginOptions {
     systemPrompt?: string;
     /** Additional system prompt prepended in dev mode */
     devSystemPrompt?: string;
-    /** Model to use. Defaults to the resolved engine's default model. */
+    /**
+     * Model to use. Defaults to the resolved engine's default model.
+     *
+     * @deprecated Set `agent.model` in `defineAppConfig()` (env alias
+     * `AGENT_MODEL`) instead. This option stays the top layer of that field, so
+     * passing it still wins; it exists only for mounts that need a different
+     * model from the rest of the process, which no first-party app does.
+     */
     model?: string;
     /** Optional per-app agent run chunk budget in milliseconds. Defaults to
      * AGENT_RUN_SOFT_TIMEOUT_MS when set, otherwise no framework-imposed
@@ -33,6 +40,15 @@ export interface AgentChatPluginOptions {
      * Netlify build also emits the background function. Set this to `false` to
      * explicitly disable a stale deploy-wide `AGENT_CHAT_DURABLE_BACKGROUND`
      * flag for this app.
+     *
+     * @deprecated Passing `true` is redundant on Netlify, where
+     * `isAgentChatDurableBackgroundEnabled` already defaults on unless
+     * `AGENT_CHAT_DURABLE_BACKGROUND` is explicitly falsy. It still matters in
+     * two cases, so it is not inert: `false` is a hard veto over a stale
+     * deploy-wide flag, and `true` is the only way a non-Netlify hosted runtime
+     * with a workspace background-function path opts in. Prefer setting
+     * `AGENT_CHAT_DURABLE_BACKGROUND`, which the deploy-time emit gate in
+     * `deploy/build.ts` can also see — this option is invisible to it.
      */
     durableBackgroundRuns?: boolean;
     /** Anthropic API key. Falls back to ANTHROPIC_API_KEY env var */

package/dist/server/agent-chat-plugin.d.ts

@@ -38,6 +38,16 @@ export { resolveRecurringJobsBuildMarker };
 export { scheduledTriggerAvailability };
 export { shouldDisableRecurringJobsRuntime };
 export { finalizeClaimedAgentChatProcessRunFailure };
+/**
+ * The model this mount runs with, when the caller does not pass one per request.
+ *
+ * The plugin option is the top layer because it is per-mount; `agent.model`
+ * (`AGENT_MODEL`) is the declared layer below it, so a deployment can pin a
+ * model without editing app source. Read through here rather than off
+ * `options` directly — every raw `options?.model` site is a place the declared
+ * field silently does nothing.
+ */
+export declare function resolveConfiguredAgentModel(options?: Pick<AgentChatPluginOptions, "model">): string | undefined;
 export declare function resolveInteractiveAgentRunOptions(options?: Pick<AgentChatPluginOptions, "runSoftTimeoutMs" | "runNoProgressTimeoutMs" | "durableBackgroundRuns">): {
     runSoftTimeoutMs: number;
     runNoProgressTimeoutMs: number;