@agent-native/core 0.186.0 → 0.187.0-nightly-20260923203303

package/dist/integrations/integration-durable-dispatch-config.js

@@ -1,3 +1,4 @@
+import { getAppConfig } from "../app-config/index.js";
 export const INTEGRATION_DURABLE_DISPATCH_ENV = "AGENT_INTEGRATION_DURABLE_DISPATCH";
 export const INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV = "AGENT_INTEGRATION_DURABLE_DISPATCH_SCOPES";
 export const INTEGRATION_PROCESS_TASK_PATH = "/_agent-native/integrations/process-task";
@@ -8,12 +9,5 @@ export function isInIntegrationRecoveryRuntime() {
     return (globalThis[INTEGRATION_RECOVERY_RUNTIME_MARKER] === true);
 }
 export function isIntegrationDurableDispatchConfigured() {
-    const value = process.env.AGENT_INTEGRATION_DURABLE_DISPATCH;
-    if (!value)
-        return false;
-    const normalized = value.trim().toLowerCase();
-    return (normalized === "1" ||
-        normalized === "true" ||
-        normalized === "yes" ||
-        normalized === "on");
+    return getAppConfig().integrations.durableDispatch === true;
 }

package/dist/integrations/integration-durable-dispatch.d.ts

@@ -14,6 +14,8 @@ export interface IntegrationDurableDispatchScope {
 export declare function integrationDispatchScopeValue(task: IntegrationDispatchTaskScope): string | null;
 export declare function configuredIntegrationDurableDispatchScopes(): IntegrationDurableDispatchScope[] | null;
 export declare function isIntegrationDurableDispatchEnabledForTask(task: IntegrationDispatchTaskScope): boolean;
+export declare function isIntegrationDurableDispatchExplicitlyDisabledForTask(task: IntegrationDispatchTaskScope): boolean;
+export declare function integrationDurableDispatchRuntimeUnavailableReasons(): string[];
 export declare function dispatchPendingIntegrationTask(input: {
     taskId: string;
     task: IntegrationDispatchTaskScope;

package/dist/integrations/integration-durable-dispatch.js

@@ -1,5 +1,6 @@
 import { hasConfiguredA2ASecret } from "../a2a/auth-policy.js";
 import { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_INTEGRATION, dispatchPathTargetsNetlifyBackgroundFunction, resolveDurableBackgroundDispatchPath, } from "../agent/durable-background.js";
+import { getAppConfig } from "../app-config/index.js";
 import { fireInternalDispatch } from "../server/self-dispatch.js";
 import { INTEGRATION_DURABLE_DISPATCH_ENV, INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV, INTEGRATION_PROCESS_TASK_PATH, INTEGRATION_RECOVERY_RUNTIME_MARKER, INTEGRATION_RETRY_SWEEP_PATH, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, isInIntegrationRecoveryRuntime, isIntegrationDurableDispatchConfigured, } from "./integration-durable-dispatch-config.js";
 import { recordPendingTaskDispatchAttempt } from "./pending-tasks-store.js";
@@ -45,15 +46,30 @@ function taskScopeCandidates(task) {
 export function isIntegrationDurableDispatchEnabledForTask(task) {
     if (!isIntegrationDurableDispatchConfigured())
         return false;
-    const scopes = configuredIntegrationDurableDispatchScopes();
-    if (scopes &&
-        !taskScopeCandidates(task).some((candidate) => scopes.some((scope) => `${scope.platform}:${scope.value}` === candidate))) {
+    if (isIntegrationDurableDispatchExplicitlyDisabledForTask(task))
         return false;
-    }
     const path = resolveDurableBackgroundDispatchPath(INTEGRATION_PROCESS_TASK_PATH);
     return (dispatchPathTargetsNetlifyBackgroundFunction(path) &&
         hasConfiguredA2ASecret());
 }
+export function isIntegrationDurableDispatchExplicitlyDisabledForTask(task) {
+    if (getAppConfig().integrations.durableDispatch === false)
+        return true;
+    const scopes = configuredIntegrationDurableDispatchScopes();
+    return Boolean(scopes &&
+        !taskScopeCandidates(task).some((candidate) => scopes.some((scope) => `${scope.platform}:${scope.value}` === candidate)));
+}
+export function integrationDurableDispatchRuntimeUnavailableReasons() {
+    const reasons = [];
+    if (!isIntegrationDurableDispatchConfigured())
+        reasons.push("flag-unavailable");
+    if (!dispatchPathTargetsNetlifyBackgroundFunction(resolveDurableBackgroundDispatchPath(INTEGRATION_PROCESS_TASK_PATH))) {
+        reasons.push("background-route-unavailable");
+    }
+    if (!hasConfiguredA2ASecret())
+        reasons.push("a2a-secret-unavailable");
+    return reasons;
+}
 async function recordDispatch(taskId, outcome) {
     try {
         await recordPendingTaskDispatchAttempt(taskId, outcome);

package/dist/integrations/plugin.js

@@ -36,7 +36,7 @@ import { IntegrationIdentityDeclinedError, resolveDefaultIntegrationExecutionCon
 import { disconnectIntegrationInstallation, listIntegrationInstallations, resolveIntegrationTokenBundle, updateIntegrationInstallation, upsertIntegrationInstallation, } from "./installations-store.js";
 import { recoverDueIntegrationCampaigns } from "./integration-campaign-recovery.js";
 import { claimIntegrationCampaignDeliveryForTask, completeIntegrationCampaignTaskAfterA2A, completeIntegrationCampaignTask, failIntegrationCampaignTaskDeliveryContainment, failDisabledIntegrationCampaignTask, failIntegrationCampaign, refreshIntegrationCampaignTaskA2AReceiptRetry, terminalizeIntegrationCampaignForTask, transitionIntegrationCampaignTaskToA2AReceiptRetry, transitionIntegrationCampaignTaskToDeliveryRetry, waitForA2AIntegrationCampaign, } from "./integration-campaigns-store.js";
-import { dispatchPendingIntegrationTask, INTEGRATION_CAMPAIGN_PROCESSOR_FIELD, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, integrationDispatchScopeValue, isInIntegrationRecoveryRuntime, isIntegrationDurableDispatchEnabledForTask, } from "./integration-durable-dispatch.js";
+import { dispatchPendingIntegrationTask, INTEGRATION_CAMPAIGN_PROCESSOR_FIELD, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, integrationDispatchScopeValue, isInIntegrationRecoveryRuntime, isIntegrationDurableDispatchEnabledForTask, isIntegrationDurableDispatchExplicitlyDisabledForTask, } from "./integration-durable-dispatch.js";
 import { forgetIntegrationMemory, integrationMemoryActions, listIntegrationMemory, rememberForIntegrationScope, } from "./integration-memory.js";
 import { extractBearerToken, verifyInternalToken } from "./internal-token.js";
 import { retryStuckPendingTasks, startPendingTasksRetryJob, } from "./pending-tasks-retry-job.js";
@@ -1576,6 +1576,16 @@ export function createIntegrationsPlugin(options) {
             if (campaignContinuation &&
                 !durableCampaignEnabled &&
                 !confirmedDeliveryProof) {
+                if (!isIntegrationDurableDispatchExplicitlyDisabledForTask({
+                    platform: task.platform,
+                    externalThreadId: task.externalThreadId,
+                    platformContext: task.dispatchScope
+                        ? { channelId: task.dispatchScope }
+                        : undefined,
+                })) {
+                    setResponseStatus(event, 202);
+                    return { ok: true, paused: "durable-runtime-unavailable" };
+                }
                 await failDisabledIntegrationCampaignTask(task.id);
                 const nextTask = await getNextPendingTaskForThread(task.platform, task.externalThreadId);
                 if (nextTask) {

package/dist/mcp/screen-memory-stdio.d.ts

@@ -137,13 +137,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -159,7 +159,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
-            count?: undefined;
             query: {
                 type: string;
                 description: string;
@@ -175,6 +174,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -190,7 +190,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
-            count?: undefined;
             minutes: {
                 type: string;
                 description: string;
@@ -200,6 +199,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -216,7 +216,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query: {
                 type: string;
                 description: string;
@@ -235,6 +234,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             };
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -250,7 +250,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
@@ -264,6 +263,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
                 description: string;
             };
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             includeMicrophone?: undefined;
@@ -314,13 +314,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt: {
                 type: string;
                 description: string;
@@ -349,13 +349,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;

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/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

@@ -60,17 +60,17 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
     ok?: undefined;
     status?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     status: string;
-    error?: undefined;
 } | {
     ok?: undefined;
     error: string;
     removed?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     removed: boolean;
-    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — validate an optional candidate value
@@ -81,13 +81,13 @@ export declare function createTestSecretHandler(): import("h3").EventHandlerWith
     error: string;
     note?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     note?: undefined;
-    error?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     note: string;
-    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -119,11 +119,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;
 } | {
+    error?: undefined;
     ok: boolean;
     removed: boolean;
-    error?: undefined;
 }>>;

package/dist/server/agent-chat/prompt-resources.d.ts

@@ -83,6 +83,7 @@ export declare function resourceScopeForOwner(owner: string, currentOwner?: stri
 export declare function preloadJevContextForPrompt(options: {
     request: string;
     apiKey?: string;
+    personalApiKey?: string;
     builderAuth?: BuilderGatewayAuth | null;
     compact?: boolean;
     maxChars?: number;

package/dist/server/agent-chat/prompt-resources.js

@@ -641,13 +641,17 @@ async function collectJevPromptCandidates() {
 export async function preloadJevContextForPrompt(options) {
     const request = options.request.trim();
     const apiKey = options.apiKey?.trim();
-    if (!request || (!apiKey && !options.builderAuth) || options.maxChars === 0) {
+    const personalApiKey = options.personalApiKey?.trim();
+    if (!request ||
+        (!apiKey && !personalApiKey && !options.builderAuth) ||
+        options.maxChars === 0) {
         return "";
     }
     const candidates = await collectJevPromptCandidates();
     const selectedIds = await rankJevCandidates({
         request,
         apiKey,
+        personalApiKey,
         builderAuth: options.builderAuth,
         candidates,
         candidateStateKey: "candidate_context",

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

@@ -56,10 +56,10 @@ export declare function createAgentEngineApiKeyHandler(): import("h3").EventHand
     ok: boolean;
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};

package/dist/server/agent-engine-ollama-models-route.d.ts

@@ -9,7 +9,7 @@ export declare function createAgentEngineOllamaModelsHandler(): import("h3").Eve
     error: string;
     models?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     models: string[];
-    error?: undefined;
 }>>;

package/dist/server/credential-provider.d.ts

@@ -281,7 +281,7 @@ export declare function resolveHasBuilderGatewayCredential(): Promise<boolean>;
  * needs reconnect) reports "not configured" rather than falling through to a
  * key-based credential that could belong to a different Builder identity.
  */
-export declare function resolveBuilderGatewayAuth(): Promise<BuilderGatewayAuth | null>;
+export declare function resolveBuilderGatewayAuth(identity?: BuilderCredentialLookupIdentity): Promise<BuilderGatewayAuth | null>;
 /**
  * Stale markers expire so a rejected model or a transient gateway failure
  * cannot pin a signed-in user to "Builder not connected" forever. Only a

package/dist/server/credential-provider.js

@@ -869,9 +869,10 @@ export async function resolveHasBuilderGatewayCredential() {
  * needs reconnect) reports "not configured" rather than falling through to a
  * key-based credential that could belong to a different Builder identity.
  */
-export async function resolveBuilderGatewayAuth() {
-    const ownerEmail = getRequestUserEmail();
-    const orgId = getRequestOrgId() ?? null;
+export async function resolveBuilderGatewayAuth(identity) {
+    const ownerEmail = identity?.userEmail?.trim() || getRequestUserEmail();
+    // undefined resolves the owner's org; null deliberately pins the lookup to Personal.
+    const orgId = identity === undefined ? (getRequestOrgId() ?? null) : identity.orgId;
     if (ownerEmail && (await hasBuilderOAuthSession(ownerEmail, orgId))) {
         try {
             const session = await getBuilderOAuthSession(ownerEmail, orgId, BUILDER_OAUTH_SCOPE);

package/dist/server/index.d.ts

@@ -19,7 +19,8 @@ export { verifyCaptcha, type CaptchaVerifyResult } from "./captcha.js";
 export { getLocaleInitScript, parseAcceptLanguage, resolveLocaleFromRequest, type LocaleInitScriptOptions, type ResolveLocaleFromRequestOptions, type ResolvedRequestLocale, } from "../localization/server.js";
 export { createProductionAgentHandler, type ActionEntry, type ScriptEntry, type ProductionAgentOptions, type AgentActionSurface, type DefaultAgentActionSurface, type AgentActionSurfaceResolution, type AgentActionSurfaceDetails, type ActionTool, type ScriptTool, type AgentMessage, type AgentChatRequest, type AgentChatEvent, type AgentChatAttachment, type AgentChatReference, type MentionProvider, type MentionItemMedia, type MentionProviderItem, type AgentLoopFinalResponseGuard, type AgentLoopFinalResponseGuardContext, type AgentLoopFinalResponseGuardResult, type AgentLoopToolCallSummary, type AgentLoopToolResultSummary, } from "../agent/index.js";
 export type { AgentActionScope } from "../agent/types.js";
-export { actionsToEngineTools, executeAgentToolCall, getOwnerActiveApiKey, getOwnerApiKeyForEngine, resolveOwnerEngineApiKey, runAgentLoop, type AgentToolCallExecutionResult, type ExecuteAgentToolCallOptions, type ResolvedOwnerApiKey, } from "../agent/production-agent.js";
+export { actionsToEngineTools, executeAgentToolCall, getJevContextCredentials, getOwnerActiveApiKey, getOwnerApiKeyForEngine, resolveOwnerEngineApiKey, runAgentLoop, type AgentToolCallExecutionResult, type ExecuteAgentToolCallOptions, type JevContextCredentials, type ResolvedOwnerApiKey, } from "../agent/production-agent.js";
+export { isJevEnabled, requestJevThroughBuilder, type JevResponse, } from "../agent/jev-tool-prefetch.js";
 export { getRunStatus, getRunTurnRef } from "../agent/run-store.js";
 export { getActiveRunForThreadAsync } from "../agent/run-manager.js";
 export { mountRealtimeVoiceRoutes, realtimeVoiceSafetyIdentifier, REALTIME_VOICE_MAX_SDP_BYTES, REALTIME_VOICE_MAX_TOOL_BODY_BYTES, REALTIME_VOICE_MAX_TOOL_OUTPUT_CHARS, REALTIME_VOICE_SESSION_PATH, REALTIME_VOICE_TOOL_PATH, type MountRealtimeVoiceRoutesOptions, type RealtimeVoiceRequestContext, type RealtimeVoiceToolExecutionRequest, type RealtimeVoiceToolExecutionResult, } from "./realtime-voice.js";

package/dist/server/index.js

@@ -18,7 +18,8 @@ export { assertCurrentRequestUserIsOrgAdmin, currentRequestUserIsOrgAdmin, } fro
 export { verifyCaptcha } from "./captcha.js";
 export { getLocaleInitScript, parseAcceptLanguage, resolveLocaleFromRequest, } from "../localization/server.js";
 export { createProductionAgentHandler, } from "../agent/index.js";
-export { actionsToEngineTools, executeAgentToolCall, getOwnerActiveApiKey, getOwnerApiKeyForEngine, resolveOwnerEngineApiKey, runAgentLoop, } from "../agent/production-agent.js";
+export { actionsToEngineTools, executeAgentToolCall, getJevContextCredentials, getOwnerActiveApiKey, getOwnerApiKeyForEngine, resolveOwnerEngineApiKey, runAgentLoop, } from "../agent/production-agent.js";
+export { isJevEnabled, requestJevThroughBuilder, } from "../agent/jev-tool-prefetch.js";
 export { getRunStatus, getRunTurnRef } from "../agent/run-store.js";
 export { getActiveRunForThreadAsync } from "../agent/run-manager.js";
 export { mountRealtimeVoiceRoutes, realtimeVoiceSafetyIdentifier, REALTIME_VOICE_MAX_SDP_BYTES, REALTIME_VOICE_MAX_TOOL_BODY_BYTES, REALTIME_VOICE_MAX_TOOL_OUTPUT_CHARS, REALTIME_VOICE_SESSION_PATH, REALTIME_VOICE_TOOL_PATH, } from "./realtime-voice.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.186.0",
+  "version": "0.187.0-nightly-20260923203303",
   "description": "The agentic application framework for building autonomous agents with intuitive UIs",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -498,8 +498,8 @@
     "yjs": "^13.6.32",
     "zod": "^4.3.6",
     "@agent-native/agentkit": "^0.2.8",
-    "@agent-native/recap-cli": "0.5.38",
-    "@agent-native/toolkit": "^0.20.8"
+    "@agent-native/toolkit": "^0.20.8",
+    "@agent-native/recap-cli": "0.5.38"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",