@agent-native/core 0.161.7 → 0.161.9

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/observability/routes.d.ts

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

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/provider-api.d.ts

@@ -311,9 +311,10 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
-        deleted?: undefined;
         id?: undefined;
+        deleted?: undefined;
         provider?: undefined;
+        message?: undefined;
         providers: {
             id: string;
             label: string;
@@ -327,29 +328,29 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         found?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        deleted?: 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;
     } | {
         deleted?: undefined;
         provider?: undefined;
+        message?: undefined;
         providers?: undefined;
         count?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
         provider?: undefined;
+        message?: undefined;
         providers?: undefined;
         count?: undefined;
         found?: undefined;
@@ -357,7 +358,6 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
         deleted?: undefined;
         provider?: undefined;

package/dist/scripts/call-agent.js

@@ -37,7 +37,7 @@ function trackA2AInvocation(args) {
         // Tracking must never affect delegation.
     }
 }
-function buildDelegationCorrelation(context, selfAppId, invocationId) {
+function buildDelegationCorrelation(context, selfAppId, invocationId, selectedReceiverApp) {
     const self = normalizeAppHandle(selfAppId);
     const inheritedVisited = Array.isArray(context?.visitedApps)
         ? context.visitedApps.map(normalizeAppHandle).filter(Boolean)
@@ -54,6 +54,7 @@ function buildDelegationCorrelation(context, selfAppId, invocationId) {
     const callerModel = getRequestRunContext()?.model?.trim();
     return {
         ...(selfAppId?.trim() ? { callerApp: selfAppId.trim() } : {}),
+        ...(selectedReceiverApp ? { selectedReceiverApp } : {}),
         ...(callerModel ? { callerModel } : {}),
         ...(context?.threadId ? { callerThreadId: context.threadId } : {}),
         ...(context?.runId ? { parentRunId: context.runId } : {}),
@@ -320,14 +321,14 @@ export async function run(args, context, selfAppId) {
                 `The request already visited ${[...visited].join(" -> ")}.`);
         }
     }
-    const correlation = buildDelegationCorrelation(context, selfAppId);
-    const idempotencyKey = message && !taskId
-        ? buildMessageIdempotencyKey(context?.turnId, agent.url, message)
-        : undefined;
     const targetApp = normalizeAppHandle(agent.id) ||
         normalizeAppHandle(agent.name) ||
         normalizeAppHandle(agentIdOrName) ||
         "unknown";
+    const correlation = buildDelegationCorrelation(context, selfAppId, undefined, taskId ? undefined : targetApp);
+    const idempotencyKey = message && !taskId
+        ? buildMessageIdempotencyKey(context?.turnId, agent.url, message)
+        : undefined;
     if (action) {
         const agentCallId = randomUUID();
         const startedAt = Date.now();

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/agent-chat/action-filters-a2a.d.ts

@@ -126,10 +126,15 @@ export declare function runMCPAgentLoop(runOptions: Parameters<A2AAgentLoopRunne
  * complete registry is supplied separately so the run loop can load a matched
  * schema after a tool-search result.
  */
-export declare function createA2AEngineToolSurface(availableTools: EngineTool[], initialToolNames?: string[]): {
+export declare function createA2AEngineToolSurface(availableTools: EngineTool[], initialToolNames?: string[], options?: {
+    receiverOwnsObjective?: boolean;
+    localCapabilityNames?: string[];
+}): {
     tools: EngineTool[];
     availableTools: EngineTool[];
 };
+export declare function isSelectedA2AReceiver(selectedReceiverApp: string | undefined, appId: string | undefined): boolean;
+export declare function buildSelectedA2AReceiverContext(appId: string): string;
 /**
  * The first-request tool catalog: an explicit `initialToolNames` verbatim, or
  * the app's OWN actions by default.

package/dist/server/agent-chat/action-filters-a2a.js

@@ -421,12 +421,39 @@ export function runMCPAgentLoop(runOptions, pluginOptions, timeoutOptions, optio
  * complete registry is supplied separately so the run loop can load a matched
  * schema after a tool-search result.
  */
-export function createA2AEngineToolSurface(availableTools, initialToolNames) {
+export function createA2AEngineToolSurface(availableTools, initialToolNames, options = {}) {
+    const selectedInitialNames = options.receiverOwnsObjective
+        ? [
+            ...new Set([
+                ...(initialToolNames ?? []),
+                ...(options.localCapabilityNames ?? []),
+            ]),
+        ]
+        : initialToolNames;
+    const initialTools = filterInitialEngineTools(availableTools, selectedInitialNames);
     return {
-        tools: filterInitialEngineTools(availableTools, initialToolNames),
+        tools: options.receiverOwnsObjective
+            ? initialTools.filter((tool) => tool.name !== "describe-workspace-apps" &&
+                tool.name !== "call-agent")
+            : initialTools,
         availableTools,
     };
 }
+export function isSelectedA2AReceiver(selectedReceiverApp, appId) {
+    const normalize = (value) => value
+        ?.trim()
+        .toLowerCase()
+        .replace(/^agent-native-/, "") ?? "";
+    const selected = normalize(selectedReceiverApp);
+    return selected.length > 0 && selected === normalize(appId);
+}
+export function buildSelectedA2AReceiverContext(appId) {
+    return `
+<selected-a2a-receiver>
+selectedApp: ${appId}
+The caller already selected this app to own the current objective. Start with this app's declared local capabilities and use tool-search for another local action when needed. A resource name that resembles a different app is not a routing decision. Delegate again only for a genuinely separate subtask; do not substitute another app for loading this app's own actions.
+</selected-a2a-receiver>`;
+}
 /**
  * The first-request tool catalog: an explicit `initialToolNames` verbatim, or
  * the app's OWN actions by default.

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 { FeatureFlagDefinition } from "../../feature-flags/registry.js";
 import type { FrameworkToolsConfig } from "../../framework-tools.js";
 import type { ExternalAgentPolicy } from "../../mcp/external-agent-policy.js";
 import type { DatabaseToolsOption } from "../../scripts/db/tool-mode.js";
@@ -363,6 +364,11 @@ export interface AgentChatPluginOptions {
      * cycle safety does not depend on removing the tool.
      */
     a2aAgentDelegation?: boolean;
+    /**
+     * Default-off app-owned rollout for binding a delegated objective to this
+     * selected receiver before it considers another cross-app delegation.
+     */
+    a2aReceiverOwnershipFlag?: FeatureFlagDefinition;
     /**
      * Resource budget for delegated A2A/MCP agent turns. Defaults are stricter
      * than interactive chat because every retained tool result is re-sent on

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

@@ -4,7 +4,7 @@ import type { ResolvedKeyReference } from "../secrets/substitution.js";
 import { handleSharedThreadRequest, type SharedThreadRouteDependencies } from "./agent-chat/shared-thread.js";
 export { handleSharedThreadRequest };
 export type { SharedThreadRouteDependencies };
-import { createA2AEngineToolSurface, DEFAULT_DELEGATED_MAX_ITERATIONS, DEFAULT_DELEGATED_MAX_RUN_INPUT_TOKENS, DEFAULT_DELEGATED_MAX_TOOL_RESULT_CHARS, runA2AAgentLoop, runMCPAgentLoop, assembleA2AFinalResponse, buildPublicAgentA2ASkills } from "./agent-chat/action-filters-a2a.js";
+import { buildSelectedA2AReceiverContext, createA2AEngineToolSurface, DEFAULT_DELEGATED_MAX_ITERATIONS, DEFAULT_DELEGATED_MAX_RUN_INPUT_TOKENS, DEFAULT_DELEGATED_MAX_TOOL_RESULT_CHARS, isSelectedA2AReceiver, runA2AAgentLoop, runMCPAgentLoop, assembleA2AFinalResponse, buildPublicAgentA2ASkills } from "./agent-chat/action-filters-a2a.js";
 import { _agentChatPromptSectionsForTests } from "./agent-chat/framework-prompts.js";
 import { type AgentChatPluginOptions, type NitroPluginDef } from "./agent-chat/plugin-options.js";
 import { finalizeClaimedAgentChatProcessRunFailure } from "./agent-chat/process-run-failure.js";
@@ -29,6 +29,7 @@ export type { AgentChatPluginOptions };
 export { runA2AAgentLoop };
 export { runMCPAgentLoop };
 export { createA2AEngineToolSurface };
+export { buildSelectedA2AReceiverContext, isSelectedA2AReceiver };
 export { DEFAULT_DELEGATED_MAX_ITERATIONS, DEFAULT_DELEGATED_MAX_RUN_INPUT_TOKENS, DEFAULT_DELEGATED_MAX_TOOL_RESULT_CHARS, };
 export { shouldBlockInProductCodeEditingSurface };
 export { loadRunCodeToolEntries };

package/dist/server/agent-chat-plugin.js

@@ -27,6 +27,7 @@ import { adoptThreadScopeIfUnscoped, createThread, forkThread, getThread, regist
 import { isCheckpointRestorePath } from "../checkpoints/route-match.js";
 import { createDbAdminAgentTools } from "../db-admin/agent-tools.js";
 import { isProductionServerlessFunctionRuntime, isTransientDatabaseError, } from "../db/client.js";
+import { isFeatureFlagEnabled } from "../feature-flags/index.js";
 import { filterFrameworkToolGroups, resolveFrameworkTools, } from "../framework-tools.js";
 import { verifyInternalToken, extractBearerToken, } from "../integrations/internal-token.js";
 import { RECURRING_JOBS_SWEEP_PATH, RECURRING_JOBS_SWEEP_TOKEN_SUBJECT, } from "../jobs/scheduler-dispatch.js";
@@ -111,7 +112,7 @@ import { buildSystemManifestSections, setContextXraySystemSections, } from "../a
 // the ones that were already part of the public surface) so
 // `createAgentChatPlugin` below stays a thinner orchestrator.
 // ---------------------------------------------------------------------------
-import { createA2AEngineToolSurface, DEFAULT_DELEGATED_MAX_ITERATIONS, DEFAULT_DELEGATED_MAX_RUN_INPUT_TOKENS, DEFAULT_DELEGATED_MAX_TOOL_RESULT_CHARS, filterAgentTools, filterPublicAgentActions, filterDirectA2AActions, filterReadOnlyActions, resolveInitialToolNames, runA2AAgentLoop, runMCPAgentLoop, assembleA2AFinalResponse, buildPublicAgentA2ASkills, buildAuthenticatedAgentA2ASkills, resolveArtifactBaseUrl, } from "./agent-chat/action-filters-a2a.js";
+import { buildSelectedA2AReceiverContext, createA2AEngineToolSurface, DEFAULT_DELEGATED_MAX_ITERATIONS, DEFAULT_DELEGATED_MAX_RUN_INPUT_TOKENS, DEFAULT_DELEGATED_MAX_TOOL_RESULT_CHARS, filterAgentTools, filterPublicAgentActions, filterDirectA2AActions, filterReadOnlyActions, isSelectedA2AReceiver, resolveInitialToolNames, runA2AAgentLoop, runMCPAgentLoop, assembleA2AFinalResponse, buildPublicAgentA2ASkills, buildAuthenticatedAgentA2ASkills, resolveArtifactBaseUrl, } from "./agent-chat/action-filters-a2a.js";
 import { createBuilderBrowserTool, createTeamTools, } from "./agent-chat/browser-team-tools.js";
 import { createDataWidgetActionEntries, createFrameworkContextEntry, createRefreshScreenEntry, createUrlTools, } from "./agent-chat/context-tools.js";
 import { _agentChatPromptSectionsForTests, buildFrameworkPrompts, buildSchemaBlock, collectFiles, corpusToolNamesTaughtByPrompt, generateActionsPrompt, generateCorpusToolsPrompt, } from "./agent-chat/framework-prompts.js";
@@ -141,6 +142,7 @@ export function buildLeanSystemPrompt(input) {
 export { runA2AAgentLoop };
 export { runMCPAgentLoop };
 export { createA2AEngineToolSurface };
+export { buildSelectedA2AReceiverContext, isSelectedA2AReceiver };
 export { DEFAULT_DELEGATED_MAX_ITERATIONS, DEFAULT_DELEGATED_MAX_RUN_INPUT_TOKENS, DEFAULT_DELEGATED_MAX_TOOL_RESULT_CHARS, };
 export { shouldBlockInProductCodeEditingSurface };
 export { loadRunCodeToolEntries };
@@ -1384,13 +1386,21 @@ export function createAgentChatPlugin(options) {
                         ? ""
                         : await buildSchemaBlock(owner, databaseToolsMode);
                     const extra = await resolveExtraContext(context.event, owner);
+                    const correlation = sanitizeA2ACorrelationMetadata(context.metadata);
+                    const receiverOwnsObjective = isSelectedA2AReceiver(correlation.selectedReceiverApp, options?.appId) &&
+                        !!options?.a2aReceiverOwnershipFlag &&
+                        (await isFeatureFlagEnabled(options.a2aReceiverOwnershipFlag, {
+                            userEmail,
+                            userKey: userEmail,
+                            orgId: getRequestOrgId() ?? undefined,
+                        }));
                     const a2aStoredModel = await getStoredModelForEngine(a2aEngine, {
                         appId: options?.appId,
                     });
                     // Preference only, and last before the default: an app that pinned
                     // a model keeps it. Read separately from the correlation sanitizer
                     // below so it stays out of every identity/access path.
-                    const a2aCallerModelHint = sanitizeA2ACorrelationMetadata(context.metadata).callerModel;
+                    const a2aCallerModelHint = correlation.callerModel;
                     const model = resolveDelegatedRunModel(a2aEngine, {
                         explicitModel: options?.model,
                         storedModel: a2aStoredModel,
@@ -1429,6 +1439,9 @@ export function createAgentChatPlugin(options) {
                     // a day rollover (or the resources/extra content changing) only
                     // invalidates the cached prompt prefix as late as possible.
                     const runtimeContext = runtimeContextForEvent(context.event);
+                    const selectedReceiverContext = receiverOwnsObjective && options?.appId
+                        ? buildSelectedA2AReceiverContext(options.appId)
+                        : "";
                     // Delegated turns use native template actions in every environment,
                     // so they must also receive the native-tool prompt. The interactive
                     // dev prompt teaches `pnpm action` and would send this receiver back
@@ -1439,6 +1452,7 @@ export function createAgentChatPlugin(options) {
                         schemaBlock +
                         extra +
                         modelOverlay +
+                        selectedReceiverContext +
                         runtimeContext;
                     if (a2aRunContext)
                         a2aRunContext.systemPrompt = systemPrompt;
@@ -1502,7 +1516,10 @@ export function createAgentChatPlugin(options) {
                             ...(resolvedProdCodeExec !== "off" ? runCodeTool : {}),
                             ...prodCodingTools,
                         });
-                    const a2aToolSurface = createA2AEngineToolSurface(actionsToEngineTools(a2aActions), effectiveInitialToolNames);
+                    const a2aToolSurface = createA2AEngineToolSurface(actionsToEngineTools(a2aActions), effectiveInitialToolNames, {
+                        receiverOwnsObjective,
+                        localCapabilityNames: mcpOptions.connectorCatalog,
+                    });
                     // Precise current time rides the user message (not the cached
                     // system-prompt prefix) — same pattern as the interactive handler.
                     const a2aMessages = [
@@ -1546,7 +1563,6 @@ export function createAgentChatPlugin(options) {
                         recoverableArtifactStatusWriter.enqueue(activityStatusMessage());
                     };
                     const controller = new AbortController();
-                    const correlation = sanitizeA2ACorrelationMetadata(context.metadata);
                     const telemetryThreadId = sanitizeA2ACorrelationId(context.contextId) ??
                         correlation.callerThreadId ??
                         context.taskId;

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,10 +27,10 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.161.7",
+  "version": "0.161.9",
   "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": {