npm - veryfront - Versions diffs - 0.1.1073 → 0.1.1076 - Mend

veryfront 0.1.1073 → 0.1.1076

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (92) hide show

package/esm/cli/templates/manifest.js CHANGED Viewed

@@ -51,7 +51,7 @@ export default {
                 "app/api/ag-ui/route.ts": "import { createAgUiHandler } from \"veryfront/agent\";\nimport { store } from \"../../../store.ts\";\n\nexport const POST = createAgUiHandler(\"rag\", {\n  beforeStream: async ({ lastUserText }) => {\n    const query = lastUserText.trim();\n    if (!query) return;\n\n    try {\n      const results = await store.search(query, { topK: 5 });\n      if (results.length === 0) return;\n\n      const contextBlock = results\n        .map(\n          (result) =>\n            `[${result.title}] (score: ${\n              result.score.toFixed(2)\n            })\\n${result.text}`,\n        )\n        .join(\"\\n\\n---\\n\\n\");\n\n      return {\n        prepend: [\n          {\n            role: \"system\",\n            parts: [\n              {\n                type: \"text\",\n                text:\n                  `Here are relevant documents retrieved for your question:\\n\\n${contextBlock}\\n\\n` +\n                  \"Use these documents to answer. Cite the document title when referencing information.\",\n              },\n            ],\n          },\n        ],\n      };\n    } catch (e) {\n      console.error(\"[RAG] Retrieval failed:\", e);\n      return;\n    }\n  },\n});\n",
                 "app/api/ingest/route.ts": "import { store } from \"../../../store.ts\";\n\nexport async function POST() {\n  await store.indexContentDir();\n  return Response.json({ ok: true });\n}\n",
                 "app/api/uploads/route.ts": "import { createUploadHandler } from \"veryfront/embedding\";\nimport { store } from \"../../../store.ts\";\n\nexport const { POST, GET, DELETE } = createUploadHandler(store, {\n  auth: { type: \"none\", allowUnauthenticated: true },\n});\n",
-                "app/layout.tsx": "'use client'\n\nimport \"../globals.css\";\nimport {\n  AppShell,\n  ChatSidebar,\n  ChatThemeScope,\n  ConversationsProvider,\n  Tabs,\n  TabsItem,\n} from \"veryfront/chat\";\nimport { Head } from \"veryfront/head\";\nimport { useRouter } from \"veryfront/router\";\n\nexport default function RootLayout({ children }: { children: React.ReactNode }): React.ReactNode {\n  const router = useRouter();\n  const activeTab = router.pathname.startsWith(\"/uploads\") ? \"uploads\" : \"chat\";\n\n  return (\n    <>\n      <Head><title>Docs Agent</title></Head>\n      <ChatThemeScope className=\"flex flex-col h-screen\">\n        <ConversationsProvider storageKey=\"rag-conversations\">\n          <AppShell className=\"flex-1 min-h-0\">\n            <AppShell.Sidebar side=\"left\" className=\"border-r border-[var(--outline-border)]\">\n              <AppShell.SidebarContent className=\"p-0\">\n                <ChatSidebar fill />\n              </AppShell.SidebarContent>\n            </AppShell.Sidebar>\n            <AppShell.Main>\n              <AppShell.Header border className=\"h-16 gap-3 px-3\">\n                <AppShell.Trigger side=\"left\" />\n                <div className=\"flex flex-1 justify-center\">\n                  <Tabs\n                    value={activeTab}\n                    onValueChange={(value) => router.push(value === \"uploads\" ? \"/uploads\" : \"/\")}\n                  >\n                    <TabsItem value=\"chat\">Chat</TabsItem>\n                    <TabsItem value=\"uploads\">Uploads</TabsItem>\n                  </Tabs>\n                </div>\n              </AppShell.Header>\n              <AppShell.Content className=\"flex flex-col min-h-0 pt-3\">\n                {children}\n              </AppShell.Content>\n            </AppShell.Main>\n          </AppShell>\n        </ConversationsProvider>\n      </ChatThemeScope>\n    </>\n  );\n}\n",
+                "app/layout.tsx": "'use client'\n\nimport \"../globals.css\";\nimport {\n  AppShell,\n  ChatSidebar,\n  ChatThemeScope,\n  ConversationsProvider,\n  Tabs,\n  TabsItem,\n} from \"veryfront/chat\";\nimport { Head } from \"veryfront/head\";\nimport { useRouter } from \"veryfront/router\";\n\nexport default function RootLayout({ children }: { children: React.ReactNode }): React.ReactNode {\n  const router = useRouter();\n  const activeTab = router.pathname.startsWith(\"/uploads\") ? \"uploads\" : \"chat\";\n\n  return (\n    <>\n      <Head><title>Docs Agent</title></Head>\n      <ChatThemeScope className=\"flex flex-col h-screen\">\n        <ConversationsProvider storageKey=\"rag-conversations\">\n          <AppShell className=\"flex-1 min-h-0\">\n            <AppShell.Sidebar side=\"left\" className=\"border-r border-[var(--outline-border)]\">\n              <AppShell.SidebarContent className=\"p-0\">\n                <ChatSidebar.Root>\n                  <ChatSidebar.NewButton />\n                  <ChatSidebar.List />\n                </ChatSidebar.Root>\n              </AppShell.SidebarContent>\n            </AppShell.Sidebar>\n            <AppShell.Main>\n              <AppShell.Header border className=\"h-16 gap-3 px-3\">\n                <AppShell.Trigger side=\"left\" />\n                <div className=\"flex flex-1 justify-center\">\n                  <Tabs\n                    value={activeTab}\n                    onValueChange={(value) => router.push(value === \"uploads\" ? \"/uploads\" : \"/\")}\n                  >\n                    <TabsItem value=\"chat\">Chat</TabsItem>\n                    <TabsItem value=\"uploads\">Uploads</TabsItem>\n                  </Tabs>\n                </div>\n              </AppShell.Header>\n              <AppShell.Content className=\"flex flex-col min-h-0 pt-3\">\n                {children}\n              </AppShell.Content>\n            </AppShell.Main>\n          </AppShell>\n        </ConversationsProvider>\n      </ChatThemeScope>\n    </>\n  );\n}\n",
                 "app/page.tsx": "'use client'\n\nimport { Chat } from 'veryfront/chat'\n\nconst ACCEPT = '.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.csv,.txt,.md,.mdx,.html,.rtf,.epub,.json,.xml'\n\nexport default function DocsChat() {\n  return (\n    <Chat\n      agentId=\"rag\"\n      api=\"/api/ag-ui\"\n      uploadApi=\"/api/uploads\"\n      attachAccept={ACCEPT}\n      className=\"flex-1 min-h-0\"\n      placeholder=\"Ask anything about your documents...\"\n    />\n  )\n}\n",
                 "app/uploads/page.tsx": "'use client'\n\nimport { AttachmentsPanel, useUploadsRegistry } from 'veryfront/chat'\n\nconst UPLOAD_API = '/api/uploads'\nconst ACCEPT = '.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.csv,.txt,.md,.mdx,.html,.rtf,.epub,.json,.xml'\n\nexport default function UploadsPage(): React.JSX.Element {\n  const uploads = useUploadsRegistry({ url: UPLOAD_API, storageKey: 'rag-uploads' })\n\n  return (\n    <AttachmentsPanel\n      uploads={uploads.items}\n      loading={uploads.isLoading}\n      onAttach={uploads.upload}\n      onRemoveUpload={uploads.remove}\n      attachAccept={ACCEPT}\n      className=\"flex-1 min-h-0\"\n    />\n  )\n}\n",
                 "content/architecture.md": "# Architecture\n\nAcme Platform uses a modular, event-driven architecture.\n\n## Core Components\n\n### API Gateway\nRoutes incoming requests to the appropriate microservice. Handles authentication, rate limiting, and request validation.\n\n### Event Bus\nAsynchronous message broker connecting all services. Supports pub/sub and point-to-point messaging patterns.\n\n### Data Layer\nMulti-tenant data storage with automatic sharding. Supports PostgreSQL for relational data and Redis for caching.\n\n## Request Flow\n\n1. Client sends request to API Gateway\n2. Gateway validates authentication token\n3. Request is routed to the target service\n4. Service processes request and publishes events\n5. Response is returned through the gateway\n\n## Scaling\n\nEach component scales independently. The API Gateway uses horizontal scaling with load balancing. Services auto-scale based on queue depth and CPU utilization.\n\n## Security\n\n- All inter-service communication uses mTLS\n- API tokens are rotated every 24 hours\n- Data at rest is encrypted with AES-256\n- Audit logs are retained for 90 days\n",

package/esm/deno.js CHANGED Viewed

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1073",
+    "version": "0.1.1076",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/agent/hosted/chat-runtime-tool-assembly.d.ts CHANGED Viewed

@@ -6,6 +6,7 @@ import { type HostedProjectRemoteToolSourceMutationHandler, type HostedProjectRe
 import { type RuntimeClientProfile } from "../runtime/client-profile.js";
 import { type HostedRuntimeAllowedToolNames } from "./runtime-essential-tools.js";
 import type { HostedSubmittedFormInputResult } from "./chat-runtime-contract.js";
+import type { RuntimeToolDiscoveryContext } from "../runtime/tool-discovery-context.js";
 /** Context for hosted chat runtime tool assembly. */
 export type HostedChatRuntimeToolAssemblyContext = DefaultResearchArtifactContext & {
     authToken: string;
@@ -56,6 +57,13 @@ export type PrepareHostedChatRuntimeToolAssemblyInput<TTraceAttributes extends H
     onSteeringMutation?: HostedProjectRemoteToolSourceMutationHandler;
     onStudioProjectSwitch?: HostedProjectRemoteToolSourceProjectSwitchHandler;
     preloadLatestConversationUserText?: boolean;
+    /**
+     * Per-run tool discovery context. When provided, its `activatedRemoteToolNames`
+     * Set is passed (by reference) to every remote tool source as the live
+     * execution gate. The same Set is mutated by `load_tools`, so newly activated
+     * tools become executable without re-creating the sources.
+     */
+    toolDiscoveryContext?: RuntimeToolDiscoveryContext;
 };
 /** Filter hosted chat runtime local tools. */
 export declare function filterHostedChatRuntimeLocalTools(input: {

package/esm/src/agent/hosted/chat-runtime-tool-assembly.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"chat-runtime-tool-assembly.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/chat-runtime-tool-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAE5B,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,OAAO,EAEZ,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,8BAA8B,EAGpC,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EAEL,KAAK,4CAA4C,EACjD,KAAK,6CAA6C,EAClD,KAAK,iDAAiD,EACtD,KAAK,wCAAwC,EAC9C,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAIzE,OAAO,EACL,KAAK,6BAA6B,EAGnC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;~~AAEjF~~,qDAAqD;AACrD,MAAM,MAAM,oCAAoC,GAAG,8BAA8B,GAAG;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wBAAwB,CAAC,EAAE,8BAA8B,CAAC;CAC3D,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,iCAAiC,GAAG,6BAA6B,CAAC;AAE9E,8DAA8D;AAC9D,MAAM,MAAM,mCAAmC,GAAG;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,yCAAyC,CACnD,gBAAgB,SAAS,uBAAuB,GAAG,uBAAuB,IACxE;IACF,WAAW,EAAE,oCAAoC,CAAC;IAClD,YAAY,EAAE,MAAM,GAAG,SAAS,iBAAiB,EAAE,CAAC;IACpD,UAAU,EAAE,WAAW,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,iCAAiC,CAAC;IACrD,wBAAwB,CAAC,EAAE,iCAAiC,CAAC;IAC7D,qCAAqC,CAAC,EAAE,OAAO,CAAC;IAChD,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;IAChE,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,gBAAgB,CAAC;IACjF,eAAe,CAAC,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,sBAAsB,CAAC,EAAE,6CAA6C,CAAC;IACvE,yBAAyB,CAAC,EAAE,wCAAwC,CAAC;IACrE,kBAAkB,CAAC,EAAE,4CAA4C,CAAC;IAClE,qBAAqB,CAAC,EAAE,iDAAiD,CAAC;IAC1E,iCAAiC,CAAC,EAAE,OAAO,CAAC;~~CAC7C~~,CAAC;AA2EF,8CAA8C;AAC9C,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB,CAAC,EAAE,iCAAiC,CAAC;IACrD,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,GAAG,WAAW,CAOd;AAED,iDAAiD;AACjD,wBAAsB,oCAAoC,CACxD,gBAAgB,SAAS,uBAAuB,GAAG,uBAAuB,EAE1E,KAAK,EAAE,yCAAyC,CAAC,gBAAgB,CAAC,GACjE,OAAO,CAAC,mCAAmC,CAAC,~~CAqG9C~~"}
1	+ {"version":3,"file":"chat-runtime-tool-assembly.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/chat-runtime-tool-assembly.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/hosted/chat-runtime-tool-assembly.js CHANGED Viewed

@@ -87,6 +87,9 @@ export async function prepareHostedChatRuntimeToolAssembly(input) {
         getActiveBranchId: input.getActiveBranchId ?? (() => activeBranchId(input.taskContext)),
         conversationId: input.conversationId,
         allowedToolNames,
+        ...(input.toolDiscoveryContext?.activatedRemoteToolNames !== undefined
+            ? { activatedRemoteToolNames: input.toolDiscoveryContext.activatedRemoteToolNames }
+            : {}),
         projectScopedRemoteToolOptions: input.projectScopedRemoteToolOptions,
         prepareToolInput: input.prepareRemoteToolInput,
         shouldRetryWithTool: input.shouldRetryWithRemoteTool,
@@ -108,7 +111,12 @@ export async function prepareHostedChatRuntimeToolAssembly(input) {
                 ? allowedToolNames.has(toolName)
                 : sourceProviderToolNames.has(toolName)));
     const localToolNames = Object.keys(localHostTools);
-    const availableToolNames = selectProviderCompatibleToolNames([...new Set([...localToolNames, ...remoteToolNames, ...providerToolNames])].sort(), {
+    // Initial inventory = configured-binding remote tools + local + provider-native.
+    // The full MCP catalog does not flood the union: remoteToolNames is already
+    // filtered by the agent's configured binding (allowedToolNames), so only the
+    // explicitly selected subset reaches the provider cap. On-demand activation
+    // via load_tools extends this set at runtime beyond what the binding pre-loads.
+    const availableToolNames = selectProviderCompatibleToolNames([...new Set([...localToolNames, ...providerToolNames, ...remoteToolNames])].sort(), {
         model: input.taskContext.model,
         requiredToolNames: localToolNames,
     });

package/esm/src/agent/hosted/child-fork-step-message-preparation.d.ts CHANGED Viewed

@@ -11,11 +11,29 @@ export type PrepareHostedChildForkRuntimeStepMessagesInput = {
     buildInstructions: () => string;
     forkToolNames: readonly string[];
     resolveSystem?: HostedChildForkRuntimeStepSystemResolver;
+    /**
+     * Pinned tool names (local/essential) that are always present.
+     * Required when `getActivatedToolNames` is provided.
+     */
+    pinnedToolNames?: readonly string[];
+    /**
+     * When provided, returns the current activated remote tool names from the
+     * live run context. The result is merged with `pinnedToolNames` and returned
+     * as `forkToolNames` in the step preparation result, enabling per-step tool
+     * schema refresh without mutating the caller's fixed forkToolNames array.
+     */
+    getActivatedToolNames?: () => readonly string[];
 };
 /** Public API contract for hosted child fork runtime step messages. */
 export type HostedChildForkRuntimeStepMessages = {
     messages: AgentMessage[];
     system: string;
+    /**
+     * Present only when `getActivatedToolNames` was provided in the input.
+     * Contains the live `pinned ∪ activated` set the caller should use for the
+     * current step instead of its fixed forkToolNames.
+     */
+    forkToolNames?: readonly string[];
 };
 /** Convert compacted provider messages to child fork runtime messages. */
 export declare function convertCompactedProviderMessagesToChildForkRuntimeMessages(compactedMessages: readonly ProviderModelMessage[]): AgentMessage[];

package/esm/src/agent/hosted/child-fork-step-message-preparation.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"child-fork-step-message-preparation.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-fork-step-message-preparation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAUhE,OAAO,KAAK,EAAE,OAAO,IAAI,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAEhF,8EAA8E;AAC9E,MAAM,MAAM,wCAAwC,GAAG,CAAC,KAAK,EAAE;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhC,yEAAyE;AACzE,MAAM,MAAM,8CAA8C,GAAG;IAC3D,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,aAAa,CAAC,EAAE,wCAAwC,CAAC;~~CAC1D~~,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;~~CAChB~~,CAAC;AA+CF,0EAA0E;AAC1E,wBAAgB,0DAA0D,CACxE,iBAAiB,EAAE,SAAS,oBAAoB,EAAE,GACjD,YAAY,EAAE,CAOhB;AAED,uDAAuD;AACvD,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,8CAA8C,GACpD,kCAAkC,~~CA0BpC~~"}
1	+ {"version":3,"file":"child-fork-step-message-preparation.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/child-fork-step-message-preparation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAUhE,OAAO,KAAK,EAAE,OAAO,IAAI,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAEhF,8EAA8E;AAC9E,MAAM,MAAM,wCAAwC,GAAG,CAAC,KAAK,EAAE;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhC,yEAAyE;AACzE,MAAM,MAAM,8CAA8C,GAAG;IAC3D,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,aAAa,CAAC,EAAE,wCAAwC,CAAC;IACzD;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CACjD,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CAAC;AA+CF,0EAA0E;AAC1E,wBAAgB,0DAA0D,CACxE,iBAAiB,EAAE,SAAS,oBAAoB,EAAE,GACjD,YAAY,EAAE,CAOhB;AAED,uDAAuD;AACvD,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,8CAA8C,GACpD,kCAAkC,CAuCpC"}

package/esm/src/agent/hosted/child-fork-step-message-preparation.js CHANGED Viewed

@@ -52,8 +52,20 @@ export function prepareHostedChildForkRuntimeStepMessages(input) {
         system: currentInstructions,
         compactedMessages,
     });
+    // Compute live forkToolNames = pinned ∪ activated when the caller supplies
+    // a getActivatedToolNames getter. This allows each step to see newly
+    // activated tool schemas without the caller mutating its fixed array.
+    const liveForkToolNames = input.getActivatedToolNames
+        ? [
+            ...new Set([
+                ...(input.pinnedToolNames ?? []),
+                ...input.getActivatedToolNames(),
+            ]),
+        ].sort()
+        : undefined;
     return {
         messages: convertCompactedProviderMessagesToChildForkRuntimeMessages(compactedMessages),
         system: typeof resolvedSystem === "string" ? resolvedSystem : currentInstructions,
+        ...(liveForkToolNames !== undefined ? { forkToolNames: liveForkToolNames } : {}),
     };
 }

package/esm/src/agent/hosted/default-chat-runtime.d.ts CHANGED Viewed

@@ -67,7 +67,8 @@ export type DefaultHostedChatRuntimeProjectSwitchInput = {
 export type CreateDefaultHostedChatRuntimeOptions = {
     options: DefaultHostedChatRuntimeCreationOptions;
     config: DefaultHostedChatRuntimeConfig;
-    buildLocalTools: (taskContext: DefaultHostedChatRuntimeTaskContext) => HostToolSet;
+    buildLocalTools: (taskContext: DefaultHostedChatRuntimeTaskContext) => HostToolSet | Promise<HostToolSet>;
+    cleanup?: () => Promise<void>;
     createTaskContext?: (input: CreateDefaultHostedChatRuntimeContextInput) => DefaultHostedChatRuntimeTaskContext;
     refreshSystem?: (input: DefaultHostedChatRuntimeSystemRefreshInput) => Promise<string> | string;
     onSteeringMutation?: (input: DefaultHostedChatRuntimeSteeringMutationInput) => Promise<void> | void;

package/esm/src/agent/hosted/default-chat-runtime.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"default-chat-runtime.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/default-chat-runtime.ts"],"names":[],"mappings":"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~~CAAC~~,WAAW,EAAE,mCAAmC,~~KAAK~~,WAAW,CAAC;~~IACnF~~,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,0CAA0C,KAC9C,mCAAmC,CAAC;IACzC,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,0CAA0C,KAC9C,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,CACnB,KAAK,EAAE,6CAA6C,KACjD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,qBAAqB,CAAC,EAAE,CACtB,KAAK,EAAE,0CAA0C,KAC9C,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChC,8BAA8B,CAAC,EAC7B,yCAAyC,CAAC,gCAAgC,CAAC,CAAC;IAC9E,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,gBAAgB,CAAC;IACjF,eAAe,CAAC,EAAE,yCAAyC,CAAC,iBAAiB,CAAC,CAAC;IAC/E,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,MAAM,CAAC,EAAE,8BAA8B,CAAC;CACzC,CAAC;AA4KF,0CAA0C;AAC1C,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,qCAAqC,GAC3C,OAAO,CAAC,+BAA+B,CAAC,~~CAyD1C~~"}
1	+ {"version":3,"file":"default-chat-runtime.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/default-chat-runtime.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/hosted/default-chat-runtime.js CHANGED Viewed

@@ -36,7 +36,7 @@ async function buildToolAssembly(input) {
     return prepareHostedChatRuntimeToolAssembly({
         taskContext: input.taskContext,
         instructions: input.options.instructions,
-        localTools: input.buildLocalTools(input.taskContext),
+        localTools: await input.buildLocalTools(input.taskContext),
         apiUrl: input.config.apiUrl,
         apiMcpUrl: input.config.apiMcpUrl,
         studioMcpUrl: input.config.studioMcpUrl,
@@ -147,7 +147,7 @@ export async function createDefaultHostedChatRuntime(input) {
     const taskContext = input.createTaskContext
         ? input.createTaskContext({ options: input.options, modelId })
         : createDefaultTaskContext({ options: input.options, modelId });
-    const cleanup = () => Promise.resolve();
+    const cleanup = input.cleanup ?? (() => Promise.resolve());
     try {
         const toolAssembly = await buildToolAssembly({
             ...input,
@@ -187,7 +187,14 @@ export async function createDefaultHostedChatRuntime(input) {
         };
     }
     catch (error) {
-        await cleanup();
+        try {
+            await cleanup();
+        }
+        catch (cleanupError) {
+            input.logger?.warn("Hosted chat runtime cleanup failed after setup error", {
+                error: cleanupError instanceof Error ? cleanupError.message : String(cleanupError),
+            });
+        }
         throw error;
     }
 }

package/esm/src/agent/hosted/project-remote-tool-source.d.ts CHANGED Viewed

@@ -26,6 +26,14 @@ export type CreateHostedProjectRemoteToolSourceInput = {
     defaultProjectId?: ProjectScopedRemoteToolDefaultProjectId;
     getActiveBranchId?: () => string | null | undefined;
     allowedToolNames?: ReadonlySet<string> | null;
+    /**
+     * Live activated remote tool names from the discovery context.
+     * When provided, this Set (passed by reference) is used as the execution
+     * gate for the remote tool catalog instead of `allowedToolNames`. Because
+     * the same Set is mutated by `load_tools`, newly activated tools become
+     * executable without any catalog re-creation.
+     */
+    activatedRemoteToolNames?: ReadonlySet<string> | null;
     projectScopedRemoteToolOptions?: ProjectScopedRemoteToolOptions;
     filterToolDefinitions?: ProjectScopedRemoteToolCatalogOptions["filterToolDefinitions"];
     prepareToolInput?: HostedProjectRemoteToolSourcePrepareToolInput;

package/esm/src/agent/hosted/project-remote-tool-source.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"project-remote-tool-source.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/project-remote-tool-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qCAAqC,EAC1C,KAAK,uCAAuC,EAC5C,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,2BAA2B,EAGjC,MAAM,iCAAiC,CAAC;AAGzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AAGzC,8DAA8D;AAC9D,MAAM,MAAM,4CAA4C,GAAG,CACzD,QAAQ,EAAE,6BAA6B,KACpC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,oEAAoE;AACpE,MAAM,MAAM,iDAAiD,GAAG,CAC9D,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,wEAAwE;AACxE,MAAM,MAAM,6CAA6C,GAAG,CAAC,KAAK,EAAE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9B,8EAA8E;AAC9E,MAAM,MAAM,wCAAwC,GAAG,CAAC,KAAK,EAAE;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;CAChB,KAAK,OAAO,CAAC;AAEd,kEAAkE;AAClE,MAAM,MAAM,wCAAwC,GAAG;IACrD,MAAM,EAAE,gBAAgB,CAAC;IACzB,gBAAgB,CAAC,EAAE,uCAAuC,CAAC;IAC3D,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;IAChE,qBAAqB,CAAC,EAAE,qCAAqC,CAAC,uBAAuB,CAAC,CAAC;IACvF,gBAAgB,CAAC,EAAE,6CAA6C,CAAC;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,wCAAwC,CAAC;IAC/D,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,eAAe,CAAC,EAAE,iDAAiD,CAAC;IACpE,kBAAkB,CAAC,EAAE,4CAA4C,CAAC;CACnE,CAAC;AAQF,gDAAgD;AAChD,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wCAAwC,GAC9C,gBAAgB,~~CAmHlB~~;AAED,mEAAmE;AACnE,MAAM,MAAM,yCAAyC,GACjD,IAAI,CACJ,wCAAwC,EACxC,QAAQ,GAAG,iBAAiB,CAC7B,GACC;IACA,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACpD,aAAa,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,gBAAgB,CAAC;IACjF,qBAAqB,CAAC,EAAE,iDAAiD,CAAC;CAC3E,CAAC;~~AAsGJ~~,iDAAiD;AACjD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yCAAyC,GAC/C,gBAAgB,EAAE,CA8BpB"}
1	+ {"version":3,"file":"project-remote-tool-source.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/project-remote-tool-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qCAAqC,EAC1C,KAAK,uCAAuC,EAC5C,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,2BAA2B,EAGjC,MAAM,iCAAiC,CAAC;AAGzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AAGzC,8DAA8D;AAC9D,MAAM,MAAM,4CAA4C,GAAG,CACzD,QAAQ,EAAE,6BAA6B,KACpC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,oEAAoE;AACpE,MAAM,MAAM,iDAAiD,GAAG,CAC9D,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,wEAAwE;AACxE,MAAM,MAAM,6CAA6C,GAAG,CAAC,KAAK,EAAE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9B,8EAA8E;AAC9E,MAAM,MAAM,wCAAwC,GAAG,CAAC,KAAK,EAAE;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;CAChB,KAAK,OAAO,CAAC;AAEd,kEAAkE;AAClE,MAAM,MAAM,wCAAwC,GAAG;IACrD,MAAM,EAAE,gBAAgB,CAAC;IACzB,gBAAgB,CAAC,EAAE,uCAAuC,CAAC;IAC3D,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACtD,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;IAChE,qBAAqB,CAAC,EAAE,qCAAqC,CAAC,uBAAuB,CAAC,CAAC;IACvF,gBAAgB,CAAC,EAAE,6CAA6C,CAAC;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,wCAAwC,CAAC;IAC/D,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,eAAe,CAAC,EAAE,iDAAiD,CAAC;IACpE,kBAAkB,CAAC,EAAE,4CAA4C,CAAC;CACnE,CAAC;AAQF,gDAAgD;AAChD,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wCAAwC,GAC9C,gBAAgB,CAyHlB;AAED,mEAAmE;AACnE,MAAM,MAAM,yCAAyC,GACjD,IAAI,CACJ,wCAAwC,EACxC,QAAQ,GAAG,iBAAiB,CAC7B,GACC;IACA,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACpD,aAAa,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,gBAAgB,CAAC;IACjF,qBAAqB,CAAC,EAAE,iDAAiD,CAAC;CAC3E,CAAC;AAyGJ,iDAAiD;AACjD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yCAAyC,GAC/C,gBAAgB,EAAE,CA8BpB"}

package/esm/src/agent/hosted/project-remote-tool-source.js CHANGED Viewed

@@ -9,10 +9,16 @@ function resolveActiveBranchId(getActiveBranchId) {
 }
 /** Create hosted project remote tool source. */
 export function createHostedProjectRemoteToolSource(input) {
+    // When `activatedRemoteToolNames` is provided, it acts as the live execution
+    // gate: only tools in this Set (which grows as load_tools activates them)
+    // can be listed or executed. Falls back to `allowedToolNames` when absent.
+    const catalogAllowedToolNames = input.activatedRemoteToolNames !== undefined
+        ? input.activatedRemoteToolNames
+        : input.allowedToolNames;
     const toolCatalog = createProjectScopedRemoteToolCatalog({
         source: input.source,
         defaultProjectId: input.defaultProjectId,
-        allowedToolNames: input.allowedToolNames,
+        allowedToolNames: catalogAllowedToolNames,
         projectScopedRemoteToolOptions: input.projectScopedRemoteToolOptions,
         filterToolDefinitions: input.filterToolDefinitions,
     });
@@ -116,6 +122,9 @@ function createHostedProjectRemoteToolSourceFromConfig(input, server, source, on
             ? { getActiveBranchId: input.getActiveBranchId }
             : {}),
         ...(input.allowedToolNames !== undefined ? { allowedToolNames: input.allowedToolNames } : {}),
+        ...(input.activatedRemoteToolNames !== undefined
+            ? { activatedRemoteToolNames: input.activatedRemoteToolNames }
+            : {}),
         ...(input.projectScopedRemoteToolOptions !== undefined
             ? { projectScopedRemoteToolOptions: input.projectScopedRemoteToolOptions }
             : {}),

package/esm/src/agent/hosted/root-sandbox-tool-source.d.ts ADDED Viewed

@@ -0,0 +1,29 @@
+import { type AgentServiceSandboxToolsOptions, type AgentServiceSandboxToolsResult } from "../../sandbox/index.js";
+import type { HostToolSet } from "../../tool/index.js";
+import type { DefaultHostedChatRuntimeTaskContext } from "./default-chat-runtime.js";
+type CreateAgentServiceSandboxTools = (input: AgentServiceSandboxToolsOptions) => Promise<Pick<AgentServiceSandboxToolsResult, "tools" | "closeSandbox">>;
+/** Input used to prepare the hosted root sandbox tool source. */
+export type PrepareHostedRootSandboxToolSourceInput = AgentServiceSandboxToolsOptions & {
+    allowedToolNames: readonly string[] | undefined;
+    createAgentServiceSandboxTools?: CreateAgentServiceSandboxTools;
+};
+/** Tool source and cleanup returned for a hosted root sandbox. */
+export type HostedRootSandboxToolSource = {
+    tools: HostToolSet;
+    closeRuntime?: () => Promise<void>;
+};
+/** Input used to create the hosted root local tool lifecycle. */
+export type CreateHostedRootLocalToolRuntimeInput = Omit<PrepareHostedRootSandboxToolSourceInput, "getProjectId"> & {
+    buildBaseTools: (taskContext: DefaultHostedChatRuntimeTaskContext) => HostToolSet;
+};
+/** Hosted root local tool builder and runtime cleanup. */
+export type HostedRootLocalToolRuntime = {
+    buildLocalTools: (taskContext: DefaultHostedChatRuntimeTaskContext) => Promise<HostToolSet>;
+    cleanup: () => Promise<void>;
+};
+/** Prepare sandbox tools only when the effective root selection includes a sandbox tool. */
+export declare function prepareHostedRootSandboxToolSource(input: PrepareHostedRootSandboxToolSourceInput): Promise<HostedRootSandboxToolSource>;
+/** Create the hosted root local tool builder with sandbox lifecycle ownership. */
+export declare function createHostedRootLocalToolRuntime(input: CreateHostedRootLocalToolRuntimeInput): HostedRootLocalToolRuntime;
+export {};
+//# sourceMappingURL=root-sandbox-tool-source.d.ts.map

package/esm/src/agent/hosted/root-sandbox-tool-source.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"root-sandbox-tool-source.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/root-sandbox-tool-source.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EAEpC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,2BAA2B,CAAC;AAYrF,KAAK,8BAA8B,GAAG,CACpC,KAAK,EAAE,+BAA+B,KACnC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC;AAE7E,iEAAiE;AACjE,MAAM,MAAM,uCAAuC,GAAG,+BAA+B,GAAG;IACtF,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;CACjE,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,qCAAqC,GAC7C,IAAI,CACJ,uCAAuC,EACvC,cAAc,CACf,GACC;IACA,cAAc,EAAE,CAAC,WAAW,EAAE,mCAAmC,KAAK,WAAW,CAAC;CACnF,CAAC;AAEJ,0DAA0D;AAC1D,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,EAAE,CAAC,WAAW,EAAE,mCAAmC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5F,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,4FAA4F;AAC5F,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,2BAA2B,CAAC,CAmBtC;AAED,kFAAkF;AAClF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,GAC3C,0BAA0B,CAmC5B"}

package/esm/src/agent/hosted/root-sandbox-tool-source.js ADDED Viewed

@@ -0,0 +1,61 @@
+import { createAgentServiceSandboxTools, } from "../../sandbox/index.js";
+const HOSTED_ROOT_SANDBOX_TOOL_NAMES = new Set([
+    "bash",
+    "sandbox_read_file",
+    "sandbox_write_file",
+    "start_background_command",
+    "get_background_command",
+    "get_background_command_output",
+    "cancel_background_command",
+]);
+/** Prepare sandbox tools only when the effective root selection includes a sandbox tool. */
+export async function prepareHostedRootSandboxToolSource(input) {
+    const { allowedToolNames, createAgentServiceSandboxTools: createSandboxToolsOverride, ...sandboxInput } = input;
+    if (allowedToolNames !== undefined &&
+        !allowedToolNames.some((toolName) => HOSTED_ROOT_SANDBOX_TOOL_NAMES.has(toolName))) {
+        return { tools: {} };
+    }
+    const createSandboxTools = createSandboxToolsOverride ?? createAgentServiceSandboxTools;
+    const sandboxResult = await createSandboxTools(sandboxInput);
+    return {
+        tools: sandboxResult.tools,
+        closeRuntime: sandboxResult.closeSandbox,
+    };
+}
+/** Create the hosted root local tool builder with sandbox lifecycle ownership. */
+export function createHostedRootLocalToolRuntime(input) {
+    let closeRuntime;
+    let localToolsPromise;
+    let cleanupPromise;
+    const { buildBaseTools, ...sandboxInput } = input;
+    return {
+        buildLocalTools(taskContext) {
+            localToolsPromise ??= (async () => {
+                const baseTools = buildBaseTools(taskContext);
+                const sandboxSource = await prepareHostedRootSandboxToolSource({
+                    ...sandboxInput,
+                    getProjectId: () => taskContext.projectId,
+                });
+                closeRuntime = sandboxSource.closeRuntime;
+                return {
+                    ...baseTools,
+                    ...sandboxSource.tools,
+                };
+            })();
+            return localToolsPromise;
+        },
+        cleanup() {
+            cleanupPromise ??= (async () => {
+                try {
+                    await localToolsPromise;
+                }
+                catch {
+                    // Setup errors remain owned by the caller; cleanup only releases any
+                    // handle that setup managed to establish before failing.
+                }
+                await closeRuntime?.();
+            })();
+            return cleanupPromise;
+        },
+    };
+}

package/esm/src/agent/hosted/runtime-essential-tools.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"runtime-essential-tools.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/runtime-essential-tools.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,MAAM,6BAA6B,GAAG,SAAS,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAE3F,gEAAgE;AAChE,MAAM,MAAM,yCAAyC,GAAG;IACtD,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IACjD,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,gGAAgG;IAChG,qCAAqC,CAAC,EAAE,OAAO,CAAC;CACjD,CAAC;~~AAKF~~,8CAA8C;AAC9C,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,6BAA6B,GAAG,SAAS,GACnD,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAM5B;AAED,iFAAiF;AACjF,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yCAAyC,GAC/C,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,~~CA6B5B~~"}
1	+ {"version":3,"file":"runtime-essential-tools.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/runtime-essential-tools.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,MAAM,6BAA6B,GAAG,SAAS,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAE3F,gEAAgE;AAChE,MAAM,MAAM,yCAAyC,GAAG;IACtD,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IACjD,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,gGAAgG;IAChG,qCAAqC,CAAC,EAAE,OAAO,CAAC;CACjD,CAAC;AAWF,8CAA8C;AAC9C,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,6BAA6B,GAAG,SAAS,GACnD,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAM5B;AAED,iFAAiF;AACjF,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yCAAyC,GAC/C,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CA0C5B"}

package/esm/src/agent/hosted/runtime-essential-tools.js CHANGED Viewed

@@ -1,5 +1,10 @@
 const SKILL_RUNTIME_TOOL_NAMES = ["load_skill", "load_skill_reference"];
 const SKILL_DELEGATION_TOOL_NAMES = ["invoke_agent"];
+/**
+ * Tool discovery tools are unconditionally essential: they must never be
+ * truncated by the provider cap, regardless of skill availability.
+ */
+const TOOL_DISCOVERY_TOOL_NAMES = ["search_tools", "load_tools"];
 /** Normalize hosted runtime allowed tools. */
 export function normalizeHostedRuntimeAllowedToolNames(toolNames) {
     if (!toolNames) {
@@ -14,11 +19,23 @@ export function resolveHostedRuntimeAllowedToolNames(input) {
         (allowedToolNames.size === 0 && !input.includeRuntimeEssentialToolsWhenEmpty)) {
         return allowedToolNames;
     }
-    if (!input.availableSkillIds?.length) {
-        return allowedToolNames;
-    }
     const localToolNames = new Set(input.localToolNames);
     const resolvedToolNames = new Set(allowedToolNames);
+    // Tool discovery is essential only when the agent already has at least one
+    // tool in its resolved set. Under deny-all (empty allowedToolNames), discovery
+    // tools are intentionally excluded: activating new tools is a broader
+    // capability than running pre-configured skills (load_skill), so the two are
+    // treated asymmetrically when allowedToolNames is empty.
+    if (resolvedToolNames.size > 0) {
+        for (const toolName of TOOL_DISCOVERY_TOOL_NAMES) {
+            if (localToolNames.has(toolName)) {
+                resolvedToolNames.add(toolName);
+            }
+        }
+    }
+    if (!input.availableSkillIds?.length) {
+        return resolvedToolNames;
+    }
     for (const toolName of SKILL_RUNTIME_TOOL_NAMES) {
         if (localToolNames.has(toolName)) {
             resolvedToolNames.add(toolName);

package/esm/src/agent/hosted/veryfront-cloud-agent-service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"veryfront-cloud-agent-service.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/veryfront-cloud-agent-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAqB9E,OAAO,EAGL,KAAK,WAAW,EAIjB,MAAM,qBAAqB,CAAC;AAqB7B,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;~~AAmBzE~~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~~AAqeD~~,yDAAyD;AACzD,wBAAsB,2CAA2C,CAC/D,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,yBAAyB,CAAC,+CAA+C,CAAC,CAAC,CAKrF;AAED,iDAAiD;AACjD,wBAAsB,mCAAmC,CACvD,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,2BAA2B,CAAC,+CAA+C,CAAC,CAAC,CAgBvF;AAED,4BAA4B;AAC5B,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,IAAI,CAAC,CAiDf"}
1	+ {"version":3,"file":"veryfront-cloud-agent-service.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/hosted/veryfront-cloud-agent-service.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/hosted/veryfront-cloud-agent-service.js CHANGED Viewed

@@ -25,6 +25,7 @@ import { createHostedWebFetchTool } from "./web-fetch-tool.js";
 import { createHostedAgentProjectSteering, } from "./agent-project-steering.js";
 import { createLiveStudioMcpTools } from "../project/live-studio-mcp-tools.js";
 import { createDefaultHostedChatRuntime, } from "./default-chat-runtime.js";
+import { createHostedRootLocalToolRuntime } from "./root-sandbox-tool-source.js";
 import { createVeryfrontCloudContextSummaryGenerator } from "./context-summary-generator.js";
 import { createDefaultHostedInvokeAgentTool } from "./default-invoke-agent-tool.js";
 import { createDefaultHostedProjectSteeringRefresh, fetchDefaultHostedProjectSteering, } from "./default-project-steering-refresh.js";
@@ -421,6 +422,13 @@ function createProjectSteeringRefresh(context) {
 function createAgentRuntime(context, options) {
     const config = context.infrastructure.getConfig();
     const refreshSystem = createProjectSteeringRefresh(context);
+    const localToolRuntime = createHostedRootLocalToolRuntime({
+        allowedToolNames: options.allowedTools,
+        apiUrl: config.VERYFRONT_API_URL,
+        authToken: options.authToken,
+        createBashTool: context.options.createBashTool,
+        buildBaseTools: (taskContext) => buildLocalTools(context, options, taskContext),
+    });
     return createDefaultHostedChatRuntime({
         options,
         config: {
@@ -429,7 +437,8 @@ function createAgentRuntime(context, options) {
             studioMcpUrl: config.VERYFRONT_STUDIO_MCP_URL,
             mcpServers: resolveMcpServers(context.options),
         },
-        buildLocalTools: (taskContext) => buildLocalTools(context, options, taskContext),
+        buildLocalTools: localToolRuntime.buildLocalTools,
+        cleanup: localToolRuntime.cleanup,
         refreshSystem,
         onSteeringMutation: async ({ mutation, taskContext }) => {
             if (mutation.skillsChanged) {

package/esm/src/agent/react/index.d.ts CHANGED Viewed

@@ -4,11 +4,11 @@
  * @module agent/react
  */
 export { useChat } from "./use-chat/index.js";
-export type { BranchInfo, ChatDynamicToolPart, ChatFilePart, ChatFinishReason, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatStreamEvent, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./use-chat/index.js";
+export type { BranchInfo, ChatDynamicToolPart, ChatFilePart, ChatFinishReason, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStatus, ChatStepPart, ChatStreamEvent, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./use-chat/index.js";
 export { useAgent } from "./use-agent.js";
 export type { UseAgentOptions, UseAgentResult } from "./use-agent.js";
-export { getAgentPromptSuggestions, normalizeAgentMetadata, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
-export type { AgentMetadata, AgentMetadataPromptSuggestion, AgentMetadataSuggestion, AgentMetadataSuggestions, AgentMetadataTaskSuggestion, UseAgentMetadataResult, } from "./use-agent-metadata.js";
+export { getAgentPromptSuggestionItems, getAgentPromptSuggestions, normalizeAgentMetadata, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
+export type { AgentMetadata, AgentMetadataPromptSuggestion, AgentMetadataSuggestion, AgentMetadataSuggestions, AgentMetadataTaskSuggestion, PromptSuggestion, UseAgentMetadataResult, } from "./use-agent-metadata.js";
 export { normalizeAgentsListResponse, useAgents } from "./use-agents.js";
 export type { UseAgentsOptions, UseAgentsResult } from "./use-agents.js";
 export { useCompletion } from "./use-completion.js";

package/esm/src/agent/react/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,8BAA8B,EAC9B,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,sBAAsB,EACtB,8BAA8B,EAC9B,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/agent/react/index.js CHANGED Viewed

@@ -5,7 +5,7 @@
  */
 export { useChat } from "./use-chat/index.js";
 export { useAgent } from "./use-agent.js";
-export { getAgentPromptSuggestions, normalizeAgentMetadata, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
+export { getAgentPromptSuggestionItems, getAgentPromptSuggestions, normalizeAgentMetadata, normalizeAgentMetadataResponse, useAgentMetadata, } from "./use-agent-metadata.js";
 export { normalizeAgentsListResponse, useAgents } from "./use-agents.js";
 export { useCompletion } from "./use-completion.js";
 export { useStreaming } from "./use-streaming.js";

package/esm/src/agent/react/use-agent-metadata.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /** Source-defined prompt suggestion shown by chat surfaces. */
 export type AgentMetadataPromptSuggestion = {
     type: "prompt";
-    title: string;
+    title?: string;
     prompt: string;
 } | {
     id: string;
@@ -42,6 +42,23 @@ export declare function normalizeAgentMetadata(value: unknown): AgentMetadata;
 export declare function normalizeAgentMetadataResponse(value: unknown): AgentMetadata;
 /** Return prompt text suggestions that the current Chat component can render. */
 export declare function getAgentPromptSuggestions(agent: AgentMetadata | null): string[];
+/**
+ * A prompt suggestion normalized for rendering: the short `label` shown on the
+ * chip and the full `prompt` sent when it is clicked.
+ */
+export interface PromptSuggestion {
+    /** Short chip label — the agent's `title`, falling back to the prompt. */
+    label: string;
+    /** Full text sent to the agent when the chip is clicked. */
+    prompt: string;
+}
+/**
+ * Normalize an agent's prompt suggestions to `{ label, prompt }[]`, ready to
+ * render — the chip shows the short `title` while the click sends the full
+ * `prompt`. Saves consumers from flat-mapping `agent.suggestions.suggestions`
+ * and reconciling the `title`/`prompt` fields themselves.
+ */
+export declare function getAgentPromptSuggestionItems(agent: AgentMetadata | null): PromptSuggestion[];
 /** React hook for browser-safe source-defined agent metadata. */
 export declare function useAgentMetadata(agentId: string | null | undefined): UseAgentMetadataResult;
 //# sourceMappingURL=use-agent-metadata.d.ts.map

package/esm/src/agent/react/use-agent-metadata.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"use-agent-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/use-agent-metadata.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,GACrC;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;~~IACd~~,MAAM,EAAE,MAAM,CAAC;CAChB,GACC;IACA,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEJ,6DAA6D;AAC7D,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,GAAG,2BAA2B,CAAC;AAElG,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AA2ED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAYpE;AAED,wDAAwD;AACxD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAK5E;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,EAAE,CAK/E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAkD3F"}
1	+ {"version":3,"file":"use-agent-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/use-agent-metadata.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,GACrC;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACC;IACA,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEJ,6DAA6D;AAC7D,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,GAAG,2BAA2B,CAAC;AAElG,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AA2ED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAYpE;AAED,wDAAwD;AACxD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAK5E;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,EAAE,CAK/E;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,aAAa,GAAG,IAAI,GAC1B,gBAAgB,EAAE,CAWpB;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAkD3F"}

package/esm/src/agent/react/use-agent-metadata.js CHANGED Viewed

@@ -93,6 +93,25 @@ export function getAgentPromptSuggestions(agent) {
         return [suggestion.prompt];
     }) ?? [];
 }
+/**
+ * Normalize an agent's prompt suggestions to `{ label, prompt }[]`, ready to
+ * render — the chip shows the short `title` while the click sends the full
+ * `prompt`. Saves consumers from flat-mapping `agent.suggestions.suggestions`
+ * and reconciling the `title`/`prompt` fields themselves.
+ */
+export function getAgentPromptSuggestionItems(agent) {
+    const list = agent?.suggestions?.suggestions;
+    if (!Array.isArray(list))
+        return [];
+    return list.flatMap((suggestion) => {
+        if (suggestion.type !== "prompt" || !("prompt" in suggestion) || !suggestion.prompt) {
+            return [];
+        }
+        const title = suggestion.title;
+        const label = typeof title === "string" && title.length > 0 ? title : suggestion.prompt;
+        return [{ label, prompt: suggestion.prompt }];
+    });
+}
 /** React hook for browser-safe source-defined agent metadata. */
 export function useAgentMetadata(agentId) {
     const [agent, setAgent] = useState(null);

package/esm/src/agent/react/use-chat/index.d.ts CHANGED Viewed

@@ -5,6 +5,6 @@
  * Build any interface you want.
  */
 export { useChat } from "./use-chat.js";
-export type { BranchInfo, ChatDynamicToolPart, ChatFilePart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./types.js";
+export type { BranchInfo, ChatDynamicToolPart, ChatFilePart, ChatMessage, ChatMessagePart, ChatReasoningPart, ChatStatus, ChatStepPart, ChatTextPart, ChatToolPart, ChatToolResultPart, ChatToolState, InferenceMode, OnToolCallArg, ToolOutput, UseChatOptions, UseChatResult, } from "./types.js";
 export type { ChatFinishReason, ChatStreamEvent, } from "./stream-protocol.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/agent/react/use-chat/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}