@burdenoff/fe-libs 2026.1024.4 → 2026.1027.1

package/dist/shared/agent-tools/useAgentTools.d.ts

@@ -0,0 +1,14 @@
+import { AnyDefinedAgentTool } from './types';
+/**
+ * Offer `tools` to agents for as long as the calling component is mounted.
+ *
+ * Call it in the component that owns the state the tools act on — a route's
+ * page for page tools, the builder for canvas tools — so a tool exists exactly
+ * when it can work. Registration is synchronous and removal is by token
+ * (`registry.ts`), so React Strict Mode's mount → unmount → mount and a route
+ * transition's overlapping mount/unmount both end with one registration each.
+ *
+ * `tools` should be stable (module constants, or memoised): a new array
+ * re-registers every tool.
+ */
+export declare function useAgentTools(tools: readonly AnyDefinedAgentTool[], enabled?: boolean): void;

package/dist/shared/agent-tools/useAgentTools.js

@@ -0,0 +1,14 @@
+import { registerAgentTool as e } from "./registry.js";
+import { useEffect as t } from "react";
+//#region src/shared/agent-tools/useAgentTools.ts
+function n(n, r = !0) {
+	t(() => {
+		if (!r) return;
+		let t = n.map((t) => e(t));
+		return () => {
+			for (let e of t) e();
+		};
+	}, [n, r]);
+}
+//#endregion
+export { n as useAgentTools };

package/dist/shared/assistant/api.d.ts

@@ -1,4 +1,5 @@
 import { AssistantUiCatalogue } from './uiActions/uiCatalogue';
+import { ClientToolManifestEntry } from '../agent-tools/adapters/assistant';
 import { AssistantMode, AssistantPromptPart, AssistantRawMessage, AssistantTokenUsage, AssistantSandboxAuthContext, AssistantArtifact, AssistantSessionInfo, DownloadedAssistantArtifact, StreamAccess } from './types';
 import { SandboxWriteCapabilities, WriteApprovalMode, WriteExecutionState } from './writeProposals';
 import { WriteReplyKind, WriteReplyOrigin } from './writeReplyBinder';
@@ -439,6 +440,8 @@ export declare function buildPromptRequestBody(args: {
     writeReply?: AssistantPromptWriteReply | null;
     /** ★ BOFF-8060 (N1b, dormant): the pages this person may be sent to. Absent unless a product opts in. */
     uiCatalogue?: AssistantUiCatalogue | null;
+    /** ★ BOFF-9786: the page's browser tools. Absent unless the sandbox runs them and the page registers some. */
+    clientTools?: readonly ClientToolManifestEntry[] | null;
 }): Record<string, unknown>;
 export interface AssistantPromptGatewayRequest {
     sandboxId: string;
@@ -455,6 +458,8 @@ export interface AssistantPromptGatewayRequest {
     writeReply?: AssistantPromptWriteReply | null;
     /** The navigable pages (BOFF-8060 N1b, dormant). */
     uiCatalogue?: AssistantUiCatalogue | null;
+    /** The page's browser tools (BOFF-9786). */
+    clientTools?: readonly ClientToolManifestEntry[] | null;
 }
 /** The actual unbatched GraphQL body, including context and forwarded-token overhead. */
 export declare function buildPromptGatewayRequest(args: AssistantPromptGatewayRequest): {
@@ -473,6 +478,7 @@ options?: {
     conversationId?: string | null;
     writeReply?: AssistantPromptWriteReply | null;
     uiCatalogue?: AssistantUiCatalogue | null;
+    clientTools?: readonly ClientToolManifestEntry[] | null;
 }): Promise<{
     messageID?: string;
 }>;
@@ -502,7 +508,19 @@ export declare function getAssistantMessages(sandboxId: string, workspaceId: str
      * break the read: an offer is a suggestion, the turn is not.
      */
     surfaceUiOffers?: (offers: unknown, serverNow: number) => void;
+    /**
+     * ★ BOFF-9786: hand the answer's `clientToolRequests` (unparsed) to the
+     * turn's browser-tool runner. Only the panel's turn poller passes it, and
+     * never allowed to break the read.
+     */
+    surfaceClientToolRequests?: (requests: unknown) => void;
 }): Promise<AssistantRawMessage[]>;
+/**
+ * ★ BOFF-9786: answer one browser-tool call with the page's result. The
+ * sandbox accepts it only from the person the call is bound to; a call it has
+ * already ended answers 409, which is not an error worth retrying.
+ */
+export declare function postClientToolResult(sandboxId: string, workspaceId: string, sessionId: string, callId: string, result: unknown, mode: AssistantMode, authContext: AssistantSandboxAuthContext): Promise<void>;
 /**
  * Ask the svc to mint a signed SSE stream URL. Returns null when unavailable
  * (older backend / preview data plane off) → caller falls back to polling.