@agent-native/core 0.209.0-nightly-20261014153330 → 0.209.0

package/dist/observability/routes.d.ts

@@ -27,43 +27,43 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
-    ok?: undefined;
     error: string;
     message: string;
     summary?: undefined;
     spans?: undefined;
-} | {
-    error?: undefined;
     ok?: undefined;
+} | {
     message?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
-} | {
     error?: undefined;
     ok?: undefined;
+} | {
     message?: undefined;
     summary?: undefined;
     spans?: undefined;
     traceMissing: true;
     id: string;
-} | {
     error?: undefined;
     ok?: undefined;
+} | {
     message?: undefined;
     summary?: undefined;
     spans?: undefined;
     traceMissing?: undefined;
     id: string;
-} | {
+    error?: undefined;
     ok?: undefined;
+} | {
     message?: undefined;
     summary?: undefined;
     spans?: undefined;
     error: any;
+    ok?: undefined;
 } | {
-    error?: undefined;
     message?: undefined;
     summary?: undefined;
     spans?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;

package/dist/observability/traces.js

@@ -523,7 +523,7 @@ export async function instrumentAgentLoop(opts) {
             finishOtelModelSpan(tripIndex, {
                 status: modelCallFailed ? "error" : "success",
                 errorMessage: modelErrorMessage,
-                errorCode: finalErrorCode,
+                errorCode: trip?.errorCode ?? finalErrorCode,
                 attributes: modelSpanAttributes(tripIndex),
                 endTime: modelRoundTrips[tripIndex]?.end,
             });
@@ -646,6 +646,8 @@ export async function instrumentAgentLoop(opts) {
                         trip.end = end;
                         if (event.reason)
                             trip.stopReason = event.reason;
+                        if (event.errorCode)
+                            trip.errorCode = event.errorCode;
                     }
                     if (event.reason === undefined || event.reason === "error") {
                         modelSpansAwaitingFinalError.add(tripIndex);
@@ -1362,6 +1364,11 @@ export async function instrumentAgentLoop(opts) {
                         failed: tripIndex === interruptedModelRoundTrip ||
                             !trip.stopReason ||
                             trip.stopReason === "error",
+                        // Only the last call's failure can be the one that ended the run.
+                        errorCode: trip.errorCode ??
+                            (tripIndex === modelRoundTrips.length - 1
+                                ? runTerminalCode
+                                : undefined),
                         inputTokens: trip.usage?.inputTokens,
                         outputTokens: trip.usage?.outputTokens,
                     });

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

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

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

@@ -311,10 +311,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
+        message?: undefined;
         id?: undefined;
         deleted?: undefined;
-        message?: undefined;
-        found?: undefined;
         providers: {
             id: string;
             label: string;
@@ -326,44 +325,45 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         }[];
         count: number;
         provider?: undefined;
+        found?: undefined;
         registered?: undefined;
         label?: undefined;
     } | {
+        message?: undefined;
         id?: undefined;
         deleted?: undefined;
-        count?: undefined;
-        message?: undefined;
         providers?: undefined;
+        count?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
         label?: undefined;
     } | {
-        deleted?: undefined;
-        count?: undefined;
         message?: undefined;
+        deleted?: undefined;
         providers?: undefined;
+        count?: undefined;
         provider?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
     } | {
-        count?: undefined;
         message?: undefined;
-        found?: undefined;
         providers?: undefined;
+        count?: undefined;
         provider?: undefined;
+        found?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
     } | {
         deleted?: undefined;
-        count?: undefined;
-        found?: undefined;
         providers?: undefined;
+        count?: undefined;
         provider?: undefined;
+        found?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/resources/handlers.d.ts

@@ -39,8 +39,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
     error: string;
 }>;
 export declare function handleDeleteResource(event: any): Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/secrets/routes.d.ts

@@ -57,39 +57,39 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
 } | {
     error: string;
     errorCode?: undefined;
-    ok?: undefined;
     status?: undefined;
+    ok?: undefined;
 } | {
     error: string;
     errorCode: string;
-    ok?: undefined;
     status?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     errorCode?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
-    ok?: undefined;
     error: string;
     removed?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 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;
@@ -117,11 +117,11 @@ export declare function createAdHocSecretHandler(): import("h3").EventHandlerWit
 } | {
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;

package/dist/server/agent-chat/additional-actions.d.ts

@@ -0,0 +1,45 @@
+import type { ActionEntry } from "../../agent/production-agent.js";
+/**
+ * The agent loop a request runs on: interactive chat (production or dev), an
+ * A2A task, or an MCP `ask_app` call.
+ */
+export type AgentChatAdditionalActionsSurface = "chat" | "a2a" | "mcp";
+/** Surfaces an app must opt into before its additional actions reach them. */
+export type AgentChatAdditionalActionsExternalSurface = Exclude<AgentChatAdditionalActionsSurface, "chat">;
+export interface AgentChatAdditionalActionsDetails {
+    surface: AgentChatAdditionalActionsSurface;
+    /** The H3 event. Absent for `mcp`, which runs outside a chat handler. */
+    event?: any;
+    ownerEmail: string;
+    orgId: string | null;
+}
+export type ResolveAgentChatAdditionalActions = (details: AgentChatAdditionalActionsDetails) => Record<string, ActionEntry> | Promise<Record<string, ActionEntry>>;
+export interface AppAdditionalActionsConfig {
+    resolver: ResolveAgentChatAdditionalActions | undefined;
+    /** Surfaces besides chat the app opted into. */
+    externalSurfaces: readonly AgentChatAdditionalActionsExternalSurface[];
+    /**
+     * True for every name any surface can dispatch to a framework, template, or
+     * dev implementation, including names the current surface leaves out.
+     */
+    isReservedName: (name: string) => boolean;
+}
+export declare function normalizeAdditionalActionSurfaces(surfaces: readonly string[] | undefined): AgentChatAdditionalActionsExternalSurface[];
+/**
+ * Runs the app's `resolveAdditionalActions` once for one request and returns
+ * the entries that may join that request's registry.
+ *
+ * Everything the app returns is untrusted: it may carry names, descriptions,
+ * and schemas a user registered. An entry is dropped (and reported once) when
+ * its name is malformed or reserved, when it is an `mcp__` name this caller
+ * cannot see, or when its tool definition is unusable. Each kept entry is bound
+ * to the caller it was resolved for and its `run` is wrapped so every call,
+ * from any dispatcher, rechecks that caller, enforces the entry's `access`
+ * policy, and validates the arguments against its schema without coercion.
+ */
+export declare function resolveAppAdditionalActions(config: AppAdditionalActionsConfig, details: {
+    surface: AgentChatAdditionalActionsSurface;
+    event?: any;
+    ownerEmail: string | null | undefined;
+    orgId: string | null | undefined;
+}, registered: Record<string, ActionEntry>): Promise<Record<string, ActionEntry>>;