@agent-native/core 0.153.2 → 0.153.5

package/dist/client/resources/mcp-integration-catalog.js

@@ -675,6 +675,16 @@ export const DEFAULT_MCP_INTEGRATIONS = [
         docsUrl: "https://developer.box.com/guides/box-mcp",
         setupNoteKey: "mcpIntegrations.catalog.box.setupNote",
         keywords: ["files", "folders", "documents", "enterprise content"],
+        // "Box" alone collides with everyday nouns (text box, checkbox, bounding
+        // box), so require a qualified phrase before suggesting the connection.
+        promptAliases: [
+            "Box.com",
+            "Box file",
+            "Box files",
+            "Box folder",
+            "Box folders",
+            "Box drive",
+        ],
     },
     {
         id: "builder-cms",
@@ -947,7 +957,10 @@ export function findMcpIntegrationForText(text, integrations = getDefaultMcpInte
         isMcpConnectionFailureText(normalizedText);
     if (!hasResourceIntent)
         return null;
-    const matchesCanonicalName = (integration) => [integration.name, ...(integration.brandAliases ?? [])].some((alias) => textContainsTerm(normalizedText, alias));
+    const matchesCanonicalName = (integration) => [
+        ...(integration.promptAliases ?? [integration.name]),
+        ...(integration.brandAliases ?? []),
+    ].some((alias) => textContainsTerm(normalizedText, alias));
     const canonicalMatch = integrations.find(matchesCanonicalName);
     if (canonicalMatch)
         return canonicalMatch;

package/dist/client/settings/AgentsSection.js

@@ -165,12 +165,20 @@ function AgentAddPopover({ initialName = "", initialUrl = "", initialDescription
         if (!trimmedName || !trimmedUrl)
             return;
         const trimmedDescription = description.trim();
-        const ok = await onAdd(trimmedName, trimmedUrl, trimmedDescription);
-        if (ok) {
-            setAdded({
-                name: trimmedName,
-                url: trimmedUrl,
-                description: trimmedDescription,
+        try {
+            const ok = await onAdd(trimmedName, trimmedUrl, trimmedDescription);
+            if (ok) {
+                setAdded({
+                    name: trimmedName,
+                    url: trimmedUrl,
+                    description: trimmedDescription,
+                });
+            }
+        }
+        catch (error) {
+            setCheck({
+                status: "error",
+                message: error instanceof Error ? error.message : "Could not add agent",
             });
         }
     };
@@ -236,8 +244,12 @@ export function AgentsSection() {
     const [showAdd, setShowAdd] = useState(false);
     const [prefill, setPrefill] = useState(null);
     const [probeById, setProbeById] = useState(null);
-    const { data: org } = useOrg();
+    const orgQuery = useOrg();
+    const { data: org } = orgQuery;
     const syncSecret = useSyncA2ASecret();
+    const canManageSharedAgents = !orgQuery.isLoading &&
+        !orgQuery.isError &&
+        (!org?.orgId || org.role === "owner" || org.role === "admin");
     // Landing from a peer's "register back" deep link (see
     // buildPeerRegisterBackLink): the open route only echoes `f_*` params onto
     // the redirect URL, so read those here and open the Add popover prefilled.
@@ -343,26 +355,30 @@ export function AgentsSection() {
             url,
             color: "#6B7280",
         }, null, 2);
-        try {
-            const res = await fetch(agentNativePath("/_agent-native/resources"), {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({
-                    path: remoteAgentResourcePath(id),
-                    content: agentJson,
-                    shared: true,
-                }),
-            });
-            // Deliberately don't close the popover here — a successful add shows a
-            // follow-up state (registration is one-way; the peer doesn't know
-            // about us yet) that the user dismisses explicitly.
-            if (res.ok)
-                fetchAgents();
-            return res.ok;
-        }
-        catch {
-            return false;
+        const res = await fetch(agentNativePath("/_agent-native/resources"), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                path: remoteAgentResourcePath(id),
+                content: agentJson,
+                shared: true,
+            }),
+        });
+        if (!res.ok) {
+            let body;
+            try {
+                body = (await res.json());
+            }
+            catch {
+                throw new Error(`Add failed (${res.status})`);
+            }
+            throw new Error(body?.error ?? body?.message ?? `Add failed (${res.status})`);
         }
+        // Deliberately don't close the popover here — a successful add shows a
+        // follow-up state (registration is one-way; the peer doesn't know
+        // about us yet) that the user dismisses explicitly.
+        fetchAgents();
+        return true;
     };
     const handleSave = async (agent) => {
         const agentJson = JSON.stringify({
@@ -398,13 +414,13 @@ export function AgentsSection() {
         }
         catch { }
     };
-    return (_jsxs("div", { children: [_jsx("div", { className: "mb-3 flex flex-wrap items-center justify-end gap-3", children: _jsxs("div", { className: "relative", children: [_jsxs("button", { onClick: () => {
+    return (_jsxs("div", { children: [_jsx("div", { className: "mb-3 flex flex-wrap items-center justify-end gap-3", children: canManageSharedAgents ? (_jsxs("div", { className: "relative", children: [_jsxs("button", { onClick: () => {
                                 setShowAdd(!showAdd);
                                 setEditingAgent(null);
                             }, className: "inline-flex items-center gap-1.5 rounded-md border border-border px-3 py-1.5 text-xs font-medium text-foreground hover:bg-accent", children: [showAdd ? _jsx(IconX, { size: 13 }) : _jsx(IconPlus, { size: 13 }), showAdd ? "Cancel" : "Connect agent"] }), showAdd && (_jsx(AgentAddPopover, { initialName: prefill?.name, initialUrl: prefill?.url, initialDescription: prefill?.description, secretSet: org?.a2aSecretSet, syncSecret: syncSecret, onAdd: handleAdd, onClose: () => {
                                 setShowAdd(false);
                                 setPrefill(null);
-                            } }))] }) }), _jsx(A2ASecretStatusRow, { org: org, syncSecret: syncSecret }), loading ? (_jsxs("div", { className: "space-y-1.5", role: "status", "aria-busy": "true", "aria-label": "Loading connected agents", children: [_jsx(Skeleton, { className: "h-6 w-full bg-muted/50" }), _jsx(Skeleton, { className: "h-6 w-3/4 bg-muted/50" })] })) : agents.length === 0 ? (_jsxs("div", { className: "flex flex-col items-center rounded-xl border border-border/70 bg-card px-5 py-8 text-center", children: [_jsx("span", { className: "mb-2 flex size-9 items-center justify-center rounded-full bg-muted text-muted-foreground", children: _jsx(IconTopologyRing2, { size: 17 }) }), _jsx("p", { className: "text-sm font-medium text-foreground", children: "No connected agents yet" }), _jsx("p", { className: "mt-1 max-w-sm text-xs leading-5 text-muted-foreground", children: "Connect an A2A agent to delegate work from chat." }), _jsxs("button", { onClick: () => setShowAdd(true), className: "mt-4 inline-flex items-center gap-1.5 rounded-md border border-border px-3 py-1.5 text-xs font-medium text-foreground hover:bg-accent", children: [_jsx(IconPlus, { size: 13 }), "Connect agent"] })] })) : (_jsx("div", { className: "overflow-hidden rounded-xl border border-border/70 bg-card text-card-foreground", children: _jsx("div", { className: "divide-y divide-border/60 px-4", children: agents.map((agent) => {
+                            } }))] })) : !orgQuery.isLoading ? (_jsx("span", { className: "text-[10px] text-muted-foreground", children: "Only workspace owners and admins can connect agents." })) : null }), _jsx(A2ASecretStatusRow, { org: org, syncSecret: syncSecret }), loading ? (_jsxs("div", { className: "space-y-1.5", role: "status", "aria-busy": "true", "aria-label": "Loading connected agents", children: [_jsx(Skeleton, { className: "h-6 w-full bg-muted/50" }), _jsx(Skeleton, { className: "h-6 w-3/4 bg-muted/50" })] })) : agents.length === 0 ? (_jsxs("div", { className: "flex flex-col items-center rounded-xl border border-border/70 bg-card px-5 py-8 text-center", children: [_jsx("span", { className: "mb-2 flex size-9 items-center justify-center rounded-full bg-muted text-muted-foreground", children: _jsx(IconTopologyRing2, { size: 17 }) }), _jsx("p", { className: "text-sm font-medium text-foreground", children: "No connected agents yet" }), _jsx("p", { className: "mt-1 max-w-sm text-xs leading-5 text-muted-foreground", children: "Connect an A2A agent to delegate work from chat." }), canManageSharedAgents ? (_jsxs("button", { onClick: () => setShowAdd(true), className: "mt-4 inline-flex items-center gap-1.5 rounded-md border border-border px-3 py-1.5 text-xs font-medium text-foreground hover:bg-accent", children: [_jsx(IconPlus, { size: 13 }), "Connect agent"] })) : !orgQuery.isLoading ? (_jsx("p", { className: "mt-4 text-xs text-muted-foreground", children: "Ask a workspace owner or admin to connect an agent." })) : null] })) : (_jsx("div", { className: "overflow-hidden rounded-xl border border-border/70 bg-card text-card-foreground", children: _jsx("div", { className: "divide-y divide-border/60 px-4", children: agents.map((agent) => {
                         const probe = probeById?.get(getRemoteAgentIdFromPath(agent.path).toLowerCase());
                         const dotState = !probe
                             ? null
@@ -413,9 +429,9 @@ export function AgentsSection() {
                                 : "warn";
                         return (_jsxs("div", { className: "group relative", children: [_jsxs("div", { className: "flex w-full items-center gap-3 py-4", children: [_jsx("span", { className: "flex size-8 shrink-0 items-center justify-center rounded-lg border border-border bg-background text-muted-foreground", children: _jsx(IconTopologyRing2, { size: 15 }) }), dotState ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("span", { className: `h-1.5 w-1.5 shrink-0 rounded-full ${dotState === "ok"
                                                             ? "bg-primary"
-                                                            : "bg-destructive"}` }) }), _jsx(TooltipContent, { children: probe && describeProbeTooltip(probe) })] })) : (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-transparent" })), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-sm font-medium text-foreground", children: agent.name }), _jsx("span", { className: "mt-0.5 block truncate text-xs text-muted-foreground", children: agent.url })] }), _jsx("button", { onClick: () => {
+                                                            : "bg-destructive"}` }) }), _jsx(TooltipContent, { children: probe && describeProbeTooltip(probe) })] })) : (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-transparent" })), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-sm font-medium text-foreground", children: agent.name }), _jsx("span", { className: "mt-0.5 block truncate text-xs text-muted-foreground", children: agent.url })] }), canManageSharedAgents ? (_jsx("button", { onClick: () => {
                                                 setEditingAgent(editingAgent === agent.id ? null : agent.id);
                                                 setShowAdd(false);
-                                            }, className: "shrink-0 rounded-md border border-border px-2.5 py-1.5 text-xs font-medium text-foreground hover:bg-accent", children: "Manage" })] }), editingAgent === agent.id && (_jsx(AgentEditPopover, { agent: agent, onSave: handleSave, onDelete: handleDelete, onClose: () => setEditingAgent(null) }))] }, agent.id));
+                                            }, className: "shrink-0 rounded-md border border-border px-2.5 py-1.5 text-xs font-medium text-foreground hover:bg-accent", children: "Manage" })) : null] }), canManageSharedAgents && editingAgent === agent.id && (_jsx(AgentEditPopover, { agent: agent, onSave: handleSave, onDelete: handleDelete, onClose: () => setEditingAgent(null) }))] }, agent.id));
                     }) }) }))] }));
 }

package/dist/client/sse-event-processor.d.ts

@@ -110,6 +110,13 @@ export interface AgentAutoContinueErrorInfo {
     recoverable?: boolean;
     upgradeUrl?: string;
 }
+/**
+ * Kept verbatim in sync with `INTERRUPTED_TOOL_RESULT_MARKER`
+ * (agent/production-agent.ts): the server matches this substring in replayed
+ * history to count how many times a write tool was interrupted, which is the
+ * only thing that tells "we do not know if it landed" apart from "it failed".
+ */
+export declare const INTERRUPTED_TOOL_RESULT = "Interrupted before this tool returned a result.";
 export declare function settleInterruptedToolCalls(content: ContentPart[], result?: string, options?: {
     includeActivity?: boolean;
     activityResult?: string;

package/dist/client/sse-event-processor.js

@@ -2,7 +2,13 @@ import { LLM_MISSING_CREDENTIALS_ERROR_CODE, LLM_MISSING_CREDENTIALS_MESSAGE, }
 import { emitChatFirstOpenApp } from "./chat-first.js";
 import { formatChatErrorText, normalizeChatError } from "./error-format.js";
 import { humanizeToolLabelText, humanizeToolName, runningToolLabel, } from "./tool-display.js";
-const INTERRUPTED_TOOL_RESULT = "Interrupted before this tool returned a result.";
+/**
+ * Kept verbatim in sync with `INTERRUPTED_TOOL_RESULT_MARKER`
+ * (agent/production-agent.ts): the server matches this substring in replayed
+ * history to count how many times a write tool was interrupted, which is the
+ * only thing that tells "we do not know if it landed" apart from "it failed".
+ */
+export const INTERRUPTED_TOOL_RESULT = "Interrupted before this tool returned a result.";
 const INTERRUPTED_ACTIVITY_RESULT = "Stopped before this action started.";
 /**
  * Maximum number of assistant-ui repository updates we deliver in one browser
@@ -1542,11 +1548,25 @@ export function processEvent(ev, content, toolCallCounter, tabId, state) {
     }
     return { action: "continue" };
 }
+/**
+ * Drop the draft the server is about to re-emit — the narration since the last
+ * completed tool, not the whole turn. A `clear` arrives on a final-answer-guard
+ * retry or a continuation, both of which resume AFTER the last completed tool
+ * call, so anything before that boundary is settled multi-step narration the
+ * retry will never re-send. Wiping it read to users as "it deleted its reply
+ * and started over", and `thread-data-builder` replays this same scoping on
+ * rebuild, so the loss survived a reload.
+ */
 function clearAssistantDraftContent(content) {
     for (let index = content.length - 1; index >= 0; index--) {
         const part = content[index];
         if (!part)
             continue;
+        if (part.type === "tool-call" &&
+            part.activity !== true &&
+            part.result !== undefined) {
+            return;
+        }
         if (part.type === "text" || part.type === "reasoning") {
             content.splice(index, 1);
             continue;

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
-    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
+    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

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/notifications/routes.d.ts

@@ -28,6 +28,6 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
 } | {
     count?: undefined;
     updated?: undefined;
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;

package/dist/observability/routes.d.ts

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

package/dist/provider-api/actions/github-repo-files.js

@@ -130,6 +130,7 @@ export function createGitHubRepoFilesAction(runtime, options = {}) {
         needsApproval: requireApprovalForWrites
             ? (args) => args.operation === "write" || args.operation === "delete"
             : false,
+        grounding: true,
         run: async (args) => {
             if (args.operation === "list") {
                 return runtime.listGitHubRepositoryFiles({

package/dist/provider-api/actions/provider-api.js

@@ -231,6 +231,7 @@ export function createProviderApiRequestAction(runtime, options = {}) {
             }),
             summary: (args) => buildProviderApiAuditSummary(args),
         },
+        grounding: true,
         run: async (rawArgs) => {
             const args = rawArgs;
             if (args.stageAs) {

package/dist/provider-api/actions/staged-datasets.js

@@ -120,6 +120,7 @@ export function createQueryStagedDatasetAction(options = {}) {
         schema,
         http: options.http ?? false,
         readOnly: true,
+        grounding: true,
         run: async (rawArgs) => {
             const args = rawArgs;
             const scope = resolveScope("query-staged-dataset", args, options);

package/dist/provider-api/corpus-jobs.js

@@ -205,6 +205,7 @@ export function createProviderCorpusJobAction(options) {
             "When status is paused or quota_wait, call operation=continue with the jobId after the indicated time/budget. Report coverage counts, paginationComplete, and any remaining gaps; a max-pages stop is not exhaustive.",
         schema: ProviderCorpusJobSchema,
         http: false,
+        grounding: true,
         run: async (args) => runProviderCorpusJobAction(args, options),
     });
 }

package/dist/server/action-discovery.js

@@ -168,6 +168,8 @@ function preserveActionFlags(entry) {
     }
     if (typeof entry.readOnly === "boolean")
         out.readOnly = entry.readOnly;
+    if (typeof entry.grounding === "boolean")
+        out.grounding = entry.grounding;
     if (typeof entry.allowInPlanMode === "boolean") {
         out.allowInPlanMode = entry.allowInPlanMode;
     }

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

@@ -2285,6 +2285,7 @@ export function createAgentChatPlugin(options) {
             const leanActionEntries = {
                 ...templateScripts,
                 ...resourceScripts,
+                ...workspaceFileActions,
                 ...refreshScreenTool,
                 ...urlTools,
                 ...chatScripts,

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/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/transcribe-voice.d.ts

@@ -20,6 +20,6 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    error?: undefined;
     text: string;
+    error?: undefined;
 }>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.153.2",
+  "version": "0.153.5",
   "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": {
@@ -421,8 +421,8 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.4",
-    "@agent-native/toolkit": "^0.14.1"
+    "@agent-native/toolkit": "^0.14.1",
+    "@agent-native/recap-cli": "0.5.4"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",