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

package/dist/server/http-response-telemetry.js

@@ -1,10 +1,10 @@
 import { randomUUID } from "node:crypto";
 import { getHeader, getMethod, getResponseStatus, setResponseHeader, setServerTiming, } from "h3";
+import { getAppConfig } from "../app-config/index.js";
 import { claimStartupDatabaseTelemetry, createDatabaseRequestTelemetry, enterDatabaseRequestTelemetry, } from "../db/request-telemetry.js";
 import { getDatabaseRuntimeFingerprint } from "../db/runtime-diagnostics.js";
 import { isMcpPublicPath } from "../mcp/route-paths.js";
 import { track } from "../tracking/index.js";
-import { getAppName } from "./app-name.js";
 const TELEMETRY_EVENT_NAME = "http.response";
 const REQUEST_ID_HEADER = "x-agent-native-request-id";
 // Provider delivery posts back to these collectors. Recording the collector
@@ -182,8 +182,8 @@ function emitTelemetry(event, state, response) {
         const db = getDatabaseRuntimeFingerprint();
         track(TELEMETRY_EVENT_NAME, {
             source: "server",
-            app: getAppName(),
-            template: envValue("AGENT_NATIVE_TEMPLATE") ?? getAppName(),
+            app: getAppConfig().app.name,
+            template: envValue("AGENT_NATIVE_TEMPLATE") ?? getAppConfig().app.name,
             organization: organizationForHost(host),
             method: getMethod(event),
             path: normalizeHttpTelemetryPath(pathname),
@@ -330,7 +330,7 @@ function logSlowRequest(event, state, response, durationMs, pathname) {
         return;
     console.log(JSON.stringify({
         event: SLOW_REQUEST_LOG_EVENT,
-        app: getAppName(),
+        app: getAppConfig().app.name,
         method: getMethod(event),
         path: normalizeHttpTelemetryPath(pathname),
         status: responseStatusCode(event, response),

package/dist/server/identity-sso.js

@@ -18,7 +18,6 @@ import * as jose from "jose";
 import { getAppConfig } from "../app-config/index.js";
 import { GOOGLE_AUTH_REQUIRED_MESSAGE, isGoogleSignInRequiredForEmail, } from "../org/auth-policy.js";
 import { SIGN_IN_ENTRY_PATH } from "../shared/sign-in-journey.js";
-import { getAppName } from "./app-name.js";
 import { addSignupAttributionHeader, signupAttributionContextFromCookieHeader, } from "./attribution.js";
 import { getSession, isExpectedAuthFailure, safeReturnPath } from "./auth.js";
 import { getBetterAuth, getBetterAuthInternalAdapter, } from "./better-auth-instance.js";
@@ -108,7 +107,7 @@ function resolveAppId(event) {
     const configured = app.id ?? app.workspaceId;
     if (configured)
         return configured;
-    const name = getAppName();
+    const name = getAppConfig().app.name;
     if (name && name !== "app")
         return name;
     try {

package/dist/server/index.d.ts

@@ -41,6 +41,7 @@ export { configureAgentNativeEmbeddedEnvironment, createAgentNativeEmbeddedAuthO
 export { createThread, getThread, listThreads, updateThreadData, deleteThread, setThreadArchived, setThreadPinned, setThreadScope, type ChatThread, type ChatThreadScope, type ChatThreadSummary, type ListThreadsOptions, } from "../chat-threads/store.js";
 export { createResourcesPlugin, defaultResourcesPlugin, } from "./resources-plugin.js";
 export { createCoreRoutesPlugin, defaultCoreRoutesPlugin, FRAMEWORK_ROUTE_PREFIX, type CoreRoutesPluginOptions, } from "./core-routes-plugin.js";
+export type { CoreRoutesMcpOptions } from "./core-routes/mcp-connect-options.js";
 export { buildRuntimeConfigPrompt, formatRuntimeConfigReport, getRuntimeConfigReport, parseRuntimeConfigReport, runtimeConfigRequirementsFromSearchParams, type RuntimeConfigEnvironment, type RuntimeConfigIssue, type RuntimeConfigIssueCode, type RuntimeConfigIssueSeverity, type RuntimeConfigPhase, type RuntimeConfigReport, type RuntimeConfigRequirements, } from "../shared/runtime-config.js";
 export { AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL, AGENT_NATIVE_OG_IMAGE_HEIGHT, AGENT_NATIVE_OG_IMAGE_NETLIFY_CACHE_CONTROL, AGENT_NATIVE_OG_IMAGE_WIDTH, agentNativeOgImageResponseHeaders, createAgentNativeOgImageHandler, renderAgentNativeOgImagePng, renderAgentNativeOgImageSvg, type AgentNativeOgImageInput, } from "./social-og-image.js";
 export { OG_FONT_FAMILY, resolveOgFontFiles } from "./og-fonts.js";

package/dist/server/realtime-token.d.ts

@@ -26,8 +26,8 @@ export declare function createRealtimeTokenHandler(): import("h3").EventHandlerW
     expiresAt?: undefined;
     ttlSeconds?: undefined;
 } | {
+    error?: undefined;
     token: string;
     expiresAt: string;
     ttlSeconds: number;
-    error?: undefined;
 }>>;

package/dist/server/social-og-image.js

@@ -1,5 +1,5 @@
 import { defineEventHandler, getHeader, getMethod, getQuery, getRequestURL, } from "h3";
-import { getAppName } from "./app-name.js";
+import { getAppConfig } from "../app-config/index.js";
 import { resolveBuiltInAuthMarketing, resolveBuiltInAuthMarketingByName, } from "./auth-marketing.js";
 import { OG_ARABIC_FONT_FAMILY, OG_FONT_FAMILY, resolveOgFontFiles, } from "./og-fonts.js";
 export const AGENT_NATIVE_OG_IMAGE_WIDTH = 1200;
@@ -174,7 +174,7 @@ export function resolveAgentNativeOgImageAppName(event) {
     })?.appName;
     if (builtInAppName)
         return builtInAppName;
-    const appName = getAppName();
+    const appName = getAppConfig().app.name;
     if (appName) {
         return resolveBuiltInAuthMarketingByName(appName)?.appName ?? appName;
     }

package/docs/content/observability.mdx

@@ -152,11 +152,14 @@ Five deterministic scorers run after every agent run:
 Enable sampled LLM-based evaluation by setting `evalSampleRate`:
 
 ```ts
-import { putSetting } from "@agent-native/core/settings";
-
-await putSetting("observability-config", {
-  enabled: true,
-  evalSampleRate: 0.05, // 5% of runs
+// server/plugins/config.ts
+import { defineAppConfig } from "@agent-native/core/server";
+
+export default defineAppConfig({
+  observability: {
+    enabled: true,
+    evalSampleRate: 0.05, // 5%
+  },
 });
 ```
 
@@ -248,18 +251,22 @@ Use the real model identifiers your engine accepts in place of `<your-model-id>`
 
 ## Configuration {#config}
 
-All settings are stored in the `observability-config` key:
+Set from a server plugin with `defineAppConfig()`. Every field also has a deployment environment variable alias — see the declared configuration reference.
 
 ```ts
-{
-  enabled: true,           // Master switch
-  capturePrompts: false,   // Store prompt content in traces
-  captureToolArgs: false,  // Store action input arguments
-  captureToolResults: false, // Store action results
-  captureLlmSpans: true,   // Emit one $ai_span per tool call to PostHog
-  evalSampleRate: 0,       // 0-1, fraction of runs to LLM-judge
-  exporters: []            // OTLP export targets
-}
+// server/plugins/config.ts
+import { defineAppConfig } from "@agent-native/core/server";
+
+export default defineAppConfig({
+  observability: {
+    enabled: true, // Master switch
+    capturePrompts: false, // Store prompt content in traces
+    captureToolArgs: false, // Store action input arguments
+    captureToolResults: false, // Store action results
+    captureLlmSpans: true, // Emit one $ai_span per tool call to PostHog
+    evalSampleRate: 0, // 0-1, fraction of runs to LLM-judge
+  },
+});
 ```
 
 <Callout id="doc-block-1xvsimn" tone="info">
@@ -360,26 +367,13 @@ response, and a thumbs-down stays marked incomplete until its follow-up arrives.
 
 ## Export to external platforms {#export}
 
-Send traces to Langfuse, Datadog, Grafana, or any OTel-compatible backend:
-
-```ts
-await putSetting("observability-config", {
-  enabled: true,
-  exporters: [
-    {
-      type: "otlp",
-      endpoint: "https://cloud.langfuse.com/api/public/otel",
-      headers: { Authorization: "Bearer sk-..." },
-    },
-  ],
-});
-```
+Send traces to Langfuse, Datadog, Grafana, or any OTel-compatible backend by registering an OpenTelemetry provider in your own app — see [OpenTelemetry spans](#otel) below. The framework emits `gen_ai.*` semantic convention spans compatible with the OpenTelemetry GenAI spec, and your provider owns the exporter and its credentials.
 
-The framework emits `gen_ai.*` semantic convention spans compatible with the OpenTelemetry GenAI spec.
+Core deliberately ships no exporter and holds no export endpoint or token, so a backend credential lives in your provider wiring (and the vault), never in framework configuration.
 
 ## OpenTelemetry spans {#otel}
 
-Separate from the `exporters` config above (which ships the in-house traces to an OTLP endpoint), the agent loop can also emit **live OpenTelemetry spans** for every run, model call, and tool call — so a host that already runs an OTel collector sees agent activity alongside the rest of its distributed traces.
+The agent loop emits **live OpenTelemetry spans** for every run, model call, and tool call — so a host that already runs an OTel collector sees agent activity alongside the rest of its distributed traces.
 
 This layer is **optional and no-op by default**:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.173.2-nightly-20260825163448",
+  "version": "0.174.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -429,8 +429,8 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.32",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.10",
-    "@agent-native/toolkit": "^0.16.13"
+    "@agent-native/recap-cli": "0.5.11",
+    "@agent-native/toolkit": "^0.16.14"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",

package/dist/server/app-name.d.ts

@@ -1,33 +0,0 @@
-/**
- * Resolve the user-facing name of this app — used in transactional emails,
- * page titles, and anywhere the framework needs to refer to "this app" by
- * name (e.g. "John invited you to Acme on Forms").
- *
- * Resolution order:
- *   1. `APP_NAME` env var — explicit override (recommended for prod)
- *   2. `displayName` from the app's package.json
- *   3. Titlecased `name` from package.json (only if it matches a known
- *      first-party template — on serverless runtimes `process.cwd()` may
- *      point at a bundler-generated package.json with a bogus name)
- *   4. First-party template label matched by package.json name
- *   5. `undefined` — caller should degrade gracefully
- */
-export declare function getAppName(): string | undefined;
-/**
- * Resolve the app's slug — the machine-readable identifier used for the
- * per-app transactional email sender (e.g. `clips@agent-native.com`).
- *
- * Only a first-party template name matched by package.json qualifies. A slug
- * derived from an arbitrary `APP_NAME` must not mint a mailbox on the
- * agent-native.com domain: a custom app would then send as
- * `<its-name>@agent-native.com` and route replies to the Builder mailbox.
- * Returns `undefined` for anything unrecognized, which leaves the deployment's
- * configured sender in place.
- */
-export declare function getAppSlug(): string | undefined;
-/**
- * One-line description of the app, used to tailor transactional email bodies
- * so recipients recognize which app they signed up for. Sourced from the
- * first-party template metadata; `undefined` for unknown apps.
- */
-export declare function getAppDescription(): string | undefined;

package/dist/server/app-name.js

@@ -1,82 +0,0 @@
-/**
- * Resolve the user-facing name of this app — used in transactional emails,
- * page titles, and anywhere the framework needs to refer to "this app" by
- * name (e.g. "John invited you to Acme on Forms").
- *
- * Resolution order:
- *   1. `APP_NAME` env var — explicit override (recommended for prod)
- *   2. `displayName` from the app's package.json
- *   3. Titlecased `name` from package.json (only if it matches a known
- *      first-party template — on serverless runtimes `process.cwd()` may
- *      point at a bundler-generated package.json with a bogus name)
- *   4. First-party template label matched by package.json name
- *   5. `undefined` — caller should degrade gracefully
- */
-import fs from "node:fs";
-import path from "node:path";
-import { TEMPLATES } from "../cli/templates-meta.js";
-let cachedFromPkg = null;
-function readPkg() {
-    try {
-        const pkgPath = path.join(process.cwd(), "package.json");
-        return JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-    }
-    catch {
-        return null;
-    }
-}
-function titlecase(s) {
-    return s
-        .split(/[-_\s]+/)
-        .filter(Boolean)
-        .map((w) => w[0].toUpperCase() + w.slice(1))
-        .join(" ");
-}
-export function getAppName() {
-    if (process.env.APP_NAME)
-        return process.env.APP_NAME;
-    if (cachedFromPkg !== null)
-        return cachedFromPkg ?? undefined;
-    const pkg = readPkg();
-    let name;
-    if (pkg?.displayName) {
-        name = pkg.displayName;
-    }
-    else if (pkg?.name) {
-        const tmpl = TEMPLATES.find((t) => t.name === pkg.name);
-        name = tmpl ? tmpl.label || titlecase(tmpl.name) : undefined;
-    }
-    cachedFromPkg = name ?? undefined;
-    return name;
-}
-/**
- * Resolve the app's slug — the machine-readable identifier used for the
- * per-app transactional email sender (e.g. `clips@agent-native.com`).
- *
- * Only a first-party template name matched by package.json qualifies. A slug
- * derived from an arbitrary `APP_NAME` must not mint a mailbox on the
- * agent-native.com domain: a custom app would then send as
- * `<its-name>@agent-native.com` and route replies to the Builder mailbox.
- * Returns `undefined` for anything unrecognized, which leaves the deployment's
- * configured sender in place.
- */
-export function getAppSlug() {
-    const pkg = readPkg();
-    if (!pkg?.name)
-        return undefined;
-    return TEMPLATES.find((t) => t.name === pkg.name)?.name;
-}
-/**
- * One-line description of the app, used to tailor transactional email bodies
- * so recipients recognize which app they signed up for. Sourced from the
- * first-party template metadata; `undefined` for unknown apps.
- */
-export function getAppDescription() {
-    const pkg = readPkg();
-    if (pkg?.name) {
-        const tmpl = TEMPLATES.find((t) => t.name === pkg.name);
-        if (tmpl)
-            return tmpl.hint;
-    }
-    return undefined;
-}