@agent-native/core 0.176.1 → 0.176.2-nightly-20260831184159

package/dist/observability/routes.js

@@ -19,7 +19,7 @@
  *   POST   /experiments/:id/results    — compute experiment results
  *   GET    /experiments/:id/results    — get experiment results
  */
-import { defineEventHandler, getMethod, getQuery, setResponseStatus, } from "h3";
+import { defineEventHandler, getHeader, getMethod, getQuery, setResponseStatus, } from "h3";
 import { getSession } from "../server/auth.js";
 import { readBody } from "../server/h3-helpers.js";
 import { getRequestContext } from "../server/request-context.js";
@@ -164,16 +164,22 @@ export function createObservabilityHandler() {
                     ? JSON.stringify(rawValue)
                     : String(rawValue);
             const id = nanoid();
-            await insertFeedback({
+            const idempotencyKey = feedbackType === "text"
+                ? getHeader(event, "idempotency-key")?.trim() || null
+                : null;
+            const inserted = await insertFeedback({
                 id,
                 runId: body.runId ? String(body.runId) : null,
                 threadId: body.threadId ? String(body.threadId) : null,
                 messageSeq: typeof body.messageSeq === "number" ? body.messageSeq : null,
                 feedbackType,
                 value,
+                idempotencyKey,
                 userId: owner,
                 createdAt: Date.now(),
             });
+            if (!inserted)
+                return { id };
             {
                 const runId = body.runId ? String(body.runId) : null;
                 const threadId = body.threadId ? String(body.threadId) : null;

package/dist/observability/store.d.ts

@@ -34,7 +34,7 @@ export declare function getLatestTraceSummaryForThread(threadId: string, opts: {
     userId: string;
     excludeRunId: string;
 }): Promise<TraceSummary | null>;
-export declare function insertFeedback(entry: FeedbackEntry): Promise<void>;
+export declare function insertFeedback(entry: FeedbackEntry): Promise<boolean>;
 export declare function getFeedback(opts: {
     threadId?: string;
     sinceMs?: number;

package/dist/observability/store.js

@@ -95,6 +95,7 @@ export async function ensureObservabilityTables() {
           message_seq ${intType()},
           feedback_type TEXT NOT NULL,
           value TEXT NOT NULL DEFAULT '',
+          idempotency_key TEXT,
           user_id TEXT,
           created_at ${intType()} NOT NULL
         )
@@ -187,6 +188,7 @@ export async function ensureObservabilityTables() {
                 for (const table of USER_SCOPED_TABLES) {
                     await ensureColumnExists(table, "user_id", `ALTER TABLE ${table} ADD COLUMN IF NOT EXISTS user_id TEXT`);
                 }
+                await ensureColumnExists("agent_feedback", "idempotency_key", `ALTER TABLE agent_feedback ADD COLUMN IF NOT EXISTS idempotency_key TEXT`);
                 await ensureIndexExists("idx_trace_spans_run", `CREATE INDEX IF NOT EXISTS idx_trace_spans_run ON agent_trace_spans (run_id)`);
                 await ensureIndexExists("idx_trace_spans_thread", `CREATE INDEX IF NOT EXISTS idx_trace_spans_thread ON agent_trace_spans (thread_id)`);
                 await ensureIndexExists("idx_trace_spans_created", `CREATE INDEX IF NOT EXISTS idx_trace_spans_created ON agent_trace_spans (created_at)`);
@@ -198,6 +200,7 @@ export async function ensureObservabilityTables() {
                 await ensureIndexExists("idx_feedback_created", `CREATE INDEX IF NOT EXISTS idx_feedback_created ON agent_feedback (created_at)`);
                 await ensureIndexExists("idx_feedback_user", `CREATE INDEX IF NOT EXISTS idx_feedback_user ON agent_feedback (user_id, created_at)`);
                 await ensureIndexExists("idx_feedback_type_created", `CREATE INDEX IF NOT EXISTS idx_feedback_type_created ON agent_feedback (feedback_type, created_at)`);
+                await ensureIndexExists("idx_feedback_idempotency", `CREATE UNIQUE INDEX IF NOT EXISTS idx_feedback_idempotency ON agent_feedback (user_id, idempotency_key)`);
                 await ensureIndexExists("idx_satisfaction_thread", `CREATE INDEX IF NOT EXISTS idx_satisfaction_thread ON agent_satisfaction_scores (thread_id)`);
                 await ensureIndexExists("idx_satisfaction_user", `CREATE INDEX IF NOT EXISTS idx_satisfaction_user ON agent_satisfaction_scores (user_id, computed_at)`);
                 await ensureIndexExists("idx_evals_run", `CREATE INDEX IF NOT EXISTS idx_evals_run ON agent_evals (run_id)`);
@@ -241,6 +244,13 @@ export async function ensureObservabilityTables() {
                     throw err;
                 }
             }
+            try {
+                await client.execute(`ALTER TABLE agent_feedback ADD COLUMN idempotency_key TEXT`);
+            }
+            catch (err) {
+                if (!isDuplicateColumnError(err))
+                    throw err;
+            }
             // Indexes for common query patterns
             const indexes = [
                 `CREATE INDEX IF NOT EXISTS idx_trace_spans_run ON agent_trace_spans (run_id)`,
@@ -254,6 +264,7 @@ export async function ensureObservabilityTables() {
                 `CREATE INDEX IF NOT EXISTS idx_feedback_created ON agent_feedback (created_at)`,
                 `CREATE INDEX IF NOT EXISTS idx_feedback_user ON agent_feedback (user_id, created_at)`,
                 `CREATE INDEX IF NOT EXISTS idx_feedback_type_created ON agent_feedback (feedback_type, created_at)`,
+                `CREATE UNIQUE INDEX IF NOT EXISTS idx_feedback_idempotency ON agent_feedback (user_id, idempotency_key)`,
                 `CREATE INDEX IF NOT EXISTS idx_satisfaction_thread ON agent_satisfaction_scores (thread_id)`,
                 `CREATE INDEX IF NOT EXISTS idx_satisfaction_user ON agent_satisfaction_scores (user_id, computed_at)`,
                 `CREATE INDEX IF NOT EXISTS idx_evals_run ON agent_evals (run_id)`,
@@ -478,10 +489,11 @@ export async function getLatestTraceSummaryForThread(threadId, opts) {
 export async function insertFeedback(entry) {
     await ensureObservabilityTables();
     const client = getDbExec();
-    await client.execute({
+    const result = await client.execute({
         sql: `INSERT INTO agent_feedback
-      (id, run_id, thread_id, message_seq, feedback_type, value, user_id, created_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      (id, run_id, thread_id, message_seq, feedback_type, value, idempotency_key, user_id, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT DO NOTHING`,
         args: [
             entry.id,
             entry.runId,
@@ -489,10 +501,12 @@ export async function insertFeedback(entry) {
             entry.messageSeq,
             entry.feedbackType,
             entry.value,
+            entry.idempotencyKey,
             entry.userId,
             entry.createdAt,
         ],
     });
+    return result.rowsAffected > 0;
 }
 export async function getFeedback(opts) {
     await ensureObservabilityTables();
@@ -1019,6 +1033,7 @@ function rowToFeedback(row) {
         messageSeq: row.message_seq != null ? Number(row.message_seq) : null,
         feedbackType: row.feedback_type,
         value: String(row.value ?? ""),
+        idempotencyKey: row.idempotency_key ? String(row.idempotency_key) : null,
         userId: row.user_id ? String(row.user_id) : null,
         createdAt: Number(row.created_at),
     };

package/dist/observability/types.d.ts

@@ -54,6 +54,7 @@ export interface FeedbackEntry {
     messageSeq: number | null;
     feedbackType: FeedbackType;
     value: string;
+    idempotencyKey?: string | null;
     userId: string | null;
     createdAt: number;
 }

package/dist/onboarding/plugin.js

@@ -13,7 +13,7 @@
 import { deleteCookie, defineEventHandler, getCookie, getMethod, getQuery, readBody, setResponseStatus, } from "h3";
 import { appStateGet, appStatePut } from "../application-state/store.js";
 import { getOrgContext } from "../org/context.js";
-import { getSession } from "../server/auth.js";
+import { cookieDomainAttrs, crossSiteCookieAttrs, getSession, } from "../server/auth.js";
 import { CredentialStoreUnavailableError } from "../server/credential-provider.js";
 import { awaitBootstrap, getH3App, markDefaultPluginProvided, } from "../server/framework-request-handler.js";
 import { runWithRequestContext } from "../server/request-context.js";
@@ -219,7 +219,11 @@ export function createOnboardingPlugin(options = {}) {
             return withOnboardingRequestContext(context, async () => {
                 const completed = await appStateGet(context.sessionId, FIRST_RUN_ONBOARDING_COMPLETED_KEY);
                 if (completed?.completed === true) {
-                    deleteCookie(event, FIRST_RUN_ONBOARDING_COOKIE, { path: "/" });
+                    deleteCookie(event, FIRST_RUN_ONBOARDING_COOKIE, {
+                        ...crossSiteCookieAttrs(event),
+                        ...cookieDomainAttrs(),
+                        path: "/",
+                    });
                     return { firstRun: false };
                 }
                 // Signup alone is not enough to qualify. Resolve the real org path
@@ -230,7 +234,11 @@ export function createOnboardingPlugin(options = {}) {
                 const eligible = await appStateGet(context.sessionId, FIRST_RUN_ONBOARDING_ELIGIBLE_KEY);
                 const firstRun = orgContext.orgId !== null && eligible?.orgId === orgContext.orgId;
                 if (!firstRun) {
-                    deleteCookie(event, FIRST_RUN_ONBOARDING_COOKIE, { path: "/" });
+                    deleteCookie(event, FIRST_RUN_ONBOARDING_COOKIE, {
+                        ...crossSiteCookieAttrs(event),
+                        ...cookieDomainAttrs(),
+                        path: "/",
+                    });
                 }
                 return {
                     firstRun,
@@ -272,7 +280,11 @@ export function createOnboardingPlugin(options = {}) {
                 return { error: "Authentication required" };
             }
             await appStatePut(context.sessionId, FIRST_RUN_ONBOARDING_COMPLETED_KEY, { completed: true, at: new Date().toISOString() }, { requestSource: "agent" });
-            deleteCookie(event, FIRST_RUN_ONBOARDING_COOKIE, { path: "/" });
+            deleteCookie(event, FIRST_RUN_ONBOARDING_COOKIE, {
+                ...crossSiteCookieAttrs(event),
+                ...cookieDomainAttrs(),
+                path: "/",
+            });
             return { ok: true };
         }));
     };

package/dist/progress/routes.d.ts

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

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

@@ -75,10 +75,9 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         user: "user";
     }>>;
 }, z.core.$strip>>, {
-    deleted?: undefined;
-    found?: undefined;
     id?: undefined;
-    message?: undefined;
+    provider?: undefined;
+    deleted?: undefined;
     providers: {
         id: string;
         label: string;
@@ -89,45 +88,46 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         updatedAt: number;
     }[];
     count: number;
-    provider?: undefined;
+    found?: undefined;
     registered?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
-    deleted?: undefined;
+    count?: undefined;
     id?: undefined;
-    message?: undefined;
+    deleted?: undefined;
     providers?: undefined;
-    count?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
     label?: undefined;
-} | {
-    deleted?: undefined;
     message?: undefined;
-    providers?: undefined;
+} | {
     count?: undefined;
     provider?: undefined;
+    deleted?: undefined;
+    providers?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
-} | {
-    found?: undefined;
     message?: undefined;
-    providers?: undefined;
+} | {
     count?: undefined;
     provider?: undefined;
+    providers?: undefined;
+    found?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
-    deleted?: undefined;
-    found?: undefined;
-    providers?: undefined;
     count?: undefined;
     provider?: undefined;
+    deleted?: undefined;
+    providers?: undefined;
+    found?: undefined;
     registered: boolean;
     id: string;
     label: string;

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

@@ -312,9 +312,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         scope?: "org" | "user" | undefined;
     }, {
         id?: undefined;
-        provider?: undefined;
         deleted?: undefined;
-        found?: undefined;
+        message?: undefined;
         providers: {
             id: string;
             label: string;
@@ -325,45 +324,46 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
+        provider?: undefined;
+        found?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        count?: undefined;
         id?: undefined;
         deleted?: undefined;
+        message?: 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;
+        message?: undefined;
         providers?: undefined;
+        count?: undefined;
+        provider?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        message?: undefined;
+        providers?: undefined;
         count?: undefined;
         provider?: undefined;
         found?: undefined;
-        providers?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
+        deleted?: undefined;
+        providers?: undefined;
         count?: undefined;
         provider?: undefined;
-        deleted?: undefined;
         found?: undefined;
-        providers?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/resources/handlers.d.ts

@@ -51,8 +51,8 @@ export declare function handleDeleteResource(event: any): Promise<{
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>;
 /** POST /_agent-native/resources/upload — upload a file as a resource */
 export declare function handleUploadResource(event: any): Promise<import("./store.js").Resource | {
@@ -73,10 +73,10 @@ export declare function handleUploadResource(event: any): Promise<import("./stor
     runId: string | null;
     expiresAt: number | null;
     metadata: string | null;
+    error?: undefined;
     url: string;
     provider: string;
     storageSetupRequired?: undefined;
-    error?: undefined;
 } | {
     error: string;
     storageSetupRequired: boolean;

package/dist/secrets/routes.d.ts

@@ -34,37 +34,37 @@ 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;
 } | {
-    error?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
-    ok?: undefined;
     error: string;
     removed?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — validate an optional candidate value
  * 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;
 } | {
-    error?: undefined;
     ok: boolean;
     note?: undefined;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     note: string;
+    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -95,11 +95,11 @@ export interface AdHocSecretPayload {
 export declare function createAdHocSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<AdHocSecretPayload[] | {
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;

package/dist/server/action-routes.d.ts

@@ -60,10 +60,5 @@ export interface MountActionRoutesOptions {
      */
     actionRouteAuth?: ActionRouteAuthAdapter;
 }
-/**
- * Mount discovered actions as HTTP endpoints.
- *
- * Only actions from `autoDiscoverActions` (template actions) are mounted.
- * Built-in actions (resource-*, chat-*, shell, etc.) are NOT passed here.
- */
 export declare function mountActionRoutes(nitroApp: any, actions: Record<string, ActionEntry>, options?: MountActionRoutesOptions): void;
+export declare function mountWebMcpActionRoutes(nitroApp: any, actions: Record<string, ActionEntry>, options?: MountActionRoutesOptions): void;

package/dist/server/action-routes.js

@@ -9,7 +9,7 @@ import { readBody } from "../server/h3-helpers.js";
 import { EMBED_TARGET_HEADER } from "../shared/embed-auth.js";
 import { isMcpEmbedCorsOrigin, MCP_EMBED_CORS_ALLOW_HEADERS, shouldAllowMcpEmbedCredentials, } from "../shared/mcp-embed-headers.js";
 import { actionCallIsReadOnly, notifyActionChange } from "./action-change.js";
-import { readBrowserSessionIdHeader, readAnalyticsClientPlatformHeader, seedAgentRunOwnerContext, } from "./agent-run-context.js";
+import { readBrowserSessionIdHeader, readAnalyticsClientPlatformHeader, readSyntheticTrafficHeader, seedAgentRunOwnerContext, } from "./agent-run-context.js";
 import { captureError } from "./capture-error.js";
 import { getAllowedCorsOrigin as resolveAllowedCorsOrigin, readCorsAllowedOrigins, } from "./cors-origins.js";
 import { resolveEmbedSessionFromRequest, resolvedEmbedCapabilityScope, } from "./embed-session.js";
@@ -240,21 +240,23 @@ async function resolveRequestAuthCapability(event) {
  * Only actions from `autoDiscoverActions` (template actions) are mounted.
  * Built-in actions (resource-*, chat-*, shell, etc.) are NOT passed here.
  */
-export function mountActionRoutes(nitroApp, actions, options) {
+function mountActionRoutesInternal(nitroApp, actions, options) {
     const mounted = [];
     const app = getH3App(nitroApp);
     for (const [name, entry] of Object.entries(actions)) {
         // Skip agent-only actions
-        if (entry.http === false)
+        if (entry.http === false && !options?.includeAgentOnly)
             continue;
-        const method = entry.http?.method ?? "POST";
-        const path = entry.http?.path ?? name;
-        const routePath = `${ROUTE_PREFIX}/${path}`;
+        const http = entry.http || undefined;
+        const method = options?.forcePost ? "POST" : (http?.method ?? "POST");
+        const path = options?.forcePost ? name : (http?.path ?? name);
+        const routePath = `${options?.routePrefix ?? ROUTE_PREFIX}/${path}`;
         // These two actions authenticate with a scoped A2A bearer rather than a
         // browser session. Let that verifier see the request before the cookie
         // auth guard rejects it; the action route still fails closed on invalid
         // or missing credentials.
-        if (name === "list-feature-flags" || name === "set-feature-flag") {
+        if (!options?.caller &&
+            (name === "list-feature-flags" || name === "set-feature-flag")) {
             registerAuthPublicPaths([routePath], app);
         }
         app.use(routePath, defineEventHandler(async (event) => {
@@ -329,7 +331,7 @@ export function mountActionRoutes(nitroApp, actions, options) {
             // through, so a live same-origin session cookie can't silently execute
             // the request as the logged-in user.
             let resolvedCaller = null;
-            {
+            if (options?.allowDelegatedCaller !== false) {
                 let caller;
                 try {
                     caller = options?.actionRouteAuth?.resolveCaller
@@ -403,6 +405,7 @@ export function mountActionRoutes(nitroApp, actions, options) {
             const timezone = readTimezoneHeader(event);
             const browserSessionId = readBrowserSessionIdHeader(event);
             const clientPlatform = readAnalyticsClientPlatformHeader(event);
+            const isSyntheticTraffic = readSyntheticTrafficHeader(event);
             return runWithRequestContext({
                 userEmail,
                 userName,
@@ -411,6 +414,7 @@ export function mountActionRoutes(nitroApp, actions, options) {
                 timezone,
                 browserSessionId,
                 clientPlatform,
+                ...(isSyntheticTraffic ? { isSyntheticTraffic: true } : {}),
                 requestOrigin: getForwardedRequestOrigin(event),
                 // Captured here because this is the last layer that still holds
                 // the h3 event; everything below reads it off the request store.
@@ -468,11 +472,12 @@ export function mountActionRoutes(nitroApp, actions, options) {
                 // userEmail / orgId mirror the request context resolved above (do
                 // NOT inject a dev identity — leave undefined when unauthenticated).
                 try {
-                    const caller = resolvedCaller
-                        ? "a2a"
-                        : isFrontendActionRequest(event)
-                            ? "frontend"
-                            : "http";
+                    const caller = options?.caller ??
+                        (resolvedCaller
+                            ? "a2a"
+                            : isFrontendActionRequest(event)
+                                ? "frontend"
+                                : "http");
                     const result = await entry.run(params, {
                         userEmail,
                         orgId: orgId ?? null,
@@ -574,11 +579,12 @@ export function mountActionRoutes(nitroApp, actions, options) {
                         method: reqMethod,
                         tags: {
                             action: name,
-                            caller: resolvedCaller
-                                ? "a2a"
-                                : isFrontendActionRequest(event)
-                                    ? "frontend"
-                                    : "http",
+                            caller: options?.caller ??
+                                (resolvedCaller
+                                    ? "a2a"
+                                    : isFrontendActionRequest(event)
+                                        ? "frontend"
+                                        : "http"),
                             status_code: String(status),
                         },
                         ...(requestId ? { extra: { request_id: requestId } } : {}),
@@ -598,3 +604,40 @@ export function mountActionRoutes(nitroApp, actions, options) {
     if (mounted.length > 0 && process.env.DEBUG)
         console.log(`[action-routes] Mounted ${mounted.length} action route(s): ${mounted.join(", ")}`);
 }
+export function mountActionRoutes(nitroApp, actions, options) {
+    mountActionRoutesInternal(nitroApp, actions, options);
+}
+export function mountWebMcpActionRoutes(nitroApp, actions, options) {
+    const eligible = Object.fromEntries(Object.entries(actions).filter(([name, entry]) => /^[A-Za-z0-9_.-]{1,128}$/.test(name) &&
+        entry.agentTool !== false &&
+        entry.needsApproval === undefined));
+    if (Object.keys(eligible).length === 0)
+        return;
+    const app = getH3App(nitroApp);
+    app.use("/_agent-native/webmcp/manifest", defineEventHandler(async (event) => {
+        if (getMethod(event) !== "GET") {
+            setResponseStatus(event, 405);
+            return { error: "Method not allowed. Use GET." };
+        }
+        if (!options?.getOwnerFromEvent) {
+            throw createError({ statusCode: 401, statusMessage: "Unauthorized" });
+        }
+        await options.getOwnerFromEvent(event);
+        setResponseHeader(event, "Cache-Control", "no-store");
+        return Object.entries(eligible).map(([name, entry]) => ({
+            name,
+            description: entry.tool.description,
+            inputSchema: entry.tool.parameters,
+            readOnly: entry.readOnly === true,
+        }));
+    }));
+    mountActionRoutesInternal(nitroApp, eligible, {
+        ...options,
+        routePrefix: "/_agent-native/webmcp/actions",
+        includeAgentOnly: true,
+        forcePost: true,
+        caller: "webmcp",
+        actionRouteAuth: undefined,
+        allowDelegatedCaller: false,
+    });
+}

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

@@ -1,5 +1,6 @@
 import type { ActionEntry, AgentLoopFinalResponseGuard, ProductionAgentOptions } from "../../agent/production-agent.js";
-import type { AgentChatAttachment, AgentChatReference, MentionProvider } from "../../agent/types.js";
+import type { ActiveRun } from "../../agent/run-manager.js";
+import type { AgentChatAttachment, AgentChatReference, AgentChatScope, MentionProvider } from "../../agent/types.js";
 import type { FeatureFlagDefinition } from "../../feature-flags/registry.js";
 import type { FrameworkToolsConfig } from "../../framework-tools.js";
 import type { McpActionEntryOptions } from "../../mcp-client/index.js";
@@ -11,6 +12,12 @@ import type { AgentChatMcpIcon, AgentChatMcpOptions } from "./mcp-options.js";
  * startup and may register routes/hooks synchronously or asynchronously. */
 export type NitroPluginDef = (nitroApp: any) => void | Promise<void>;
 export interface AgentChatPluginOptions {
+    /**
+     * Best-effort app autosave hook. It runs after the chat thread has been
+     * persisted and only when the run completed a side effect. Errors are
+     * reported by the framework without failing the completed chat turn.
+     */
+    onAgentTurnComplete?: (scope: AgentChatScope, run: ActiveRun) => void | Promise<void>;
     /** Template-specific actions (email ops, booking ops, etc.) */
     actions?: Record<string, ActionEntry> | (() => Record<string, ActionEntry> | Promise<Record<string, ActionEntry>>);
     /** @deprecated Use `actions` instead */

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

@@ -1,5 +1,7 @@
 import type { Message as A2AMessage } from "../a2a/types.js";
 import { type ActionEntry } from "../agent/production-agent.js";
+import type { ActiveRun } from "../agent/run-manager.js";
+import type { AgentChatScope } from "../agent/types.js";
 import type { ResolvedKeyReference } from "../secrets/substitution.js";
 import { handleSharedThreadRequest, type SharedThreadRouteDependencies } from "./agent-chat/shared-thread.js";
 export { handleSharedThreadRequest };
@@ -38,6 +40,7 @@ export { resolveRecurringJobsBuildMarker };
 export { scheduledTriggerAvailability };
 export { shouldDisableRecurringJobsRuntime };
 export { finalizeClaimedAgentChatProcessRunFailure };
+export declare function runPostAgentTurnAutosave(callback: AgentChatPluginOptions["onAgentTurnComplete"] | undefined, scope: AgentChatScope | null | undefined, run: ActiveRun): Promise<void>;
 /**
  * The model this mount runs with, when the caller does not pass one per request.
  *