@ai-sdk/harness-acp 1.0.24 → 1.0.25

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ai-sdk/harness-acp
 
+## 1.0.25
+
+### Patch Changes
+
+- 79186d1: Allow pinned OpenCode and Grok Build install scripts during pnpm 11 sandbox bootstrap.
+- b6396ff: feat(harness-acp): support `title` and `toolUseKind` for ACP tools
+- 8a15038: feat(harness): add `credentialForwarding` setting to bridge backed harness adapters for granular control
+- Updated dependencies [8a15038]
+  - @ai-sdk/harness@1.0.87
+  - @ai-sdk/provider-utils@5.0.30
+
 ## 1.0.24
 
 ### Patch Changes

package/dist/bridge/host-tool-mcp.mjs

@@ -12,7 +12,7 @@ import {
   ListToolsRequestSchema,
   McpError
 } from "@modelcontextprotocol/sdk/types.js";
-var VERSION = true ? "1.0.24" : "0.0.0-test";
+var VERSION = true ? "1.0.25" : "0.0.0-test";
 function createHostToolMCPServer({
   tools: tools2,
   revision = 1,

package/dist/bridge/index.mjs

@@ -1116,6 +1116,11 @@ function createACPStreamTranslator({
       const builtin = resolveBuiltinTool({
         programmaticName,
         metadata: state.values._meta,
+        title: getStringProperty2({
+          value: state.values,
+          property: "title"
+        }),
+        kind: isACPToolKind(state.values.kind) ? state.values.kind : void 0,
         rawInput: state.values.rawInput,
         builtinTools,
         builtinToolsByName
@@ -1323,6 +1328,8 @@ function addBuiltinToolMatch({
 function resolveBuiltinTool({
   programmaticName,
   metadata,
+  title,
+  kind,
   rawInput,
   builtinTools,
   builtinToolsByName
@@ -1337,11 +1344,49 @@ function resolveBuiltinTool({
   if (metadataMatch.hasProgrammaticName) {
     return metadataMatch.matches.length === 1 ? metadataMatch.matches[0] : void 0;
   }
+  const titleMatch = findBuiltinToolByTitle({
+    title,
+    kind,
+    builtinTools
+  });
+  if (titleMatch != null) return titleMatch;
   const schemaMatches = builtinTools.filter(
     (tool) => matchesBuiltinToolInput({ rawInput, inputSchema: tool.inputSchema })
   );
   return schemaMatches.length === 1 ? schemaMatches[0] : void 0;
 }
+function findBuiltinToolByTitle({
+  title,
+  kind,
+  builtinTools
+}) {
+  if (title == null) return void 0;
+  const matches = builtinTools.filter(
+    (tool) => tool.title != null && title.startsWith(tool.title) && isCompatibleToolKind({ toolUseKind: tool.toolUseKind, kind })
+  );
+  if (matches.length === 0) return void 0;
+  const longestPrefixLength = Math.max(
+    ...matches.map((tool) => tool.title.length)
+  );
+  const longestMatches = matches.filter(
+    (tool) => tool.title.length === longestPrefixLength
+  );
+  return longestMatches.length === 1 ? longestMatches[0] : void 0;
+}
+function isCompatibleToolKind({
+  toolUseKind,
+  kind
+}) {
+  if (toolUseKind == null || kind == null) return true;
+  switch (toolUseKind) {
+    case "readonly":
+      return kind === "read" || kind === "search" || kind === "fetch" || kind === "think";
+    case "edit":
+      return kind === "edit" || kind === "delete" || kind === "move";
+    case "bash":
+      return kind === "execute";
+  }
+}
 function findBuiltinToolsInMetadata({
   metadata,
   builtinToolsByName
@@ -2589,6 +2634,21 @@ var RelayRequestError = class extends Error {
 };
 
 // src/v1/bridge/refresh-host-tool-catalog.ts
+async function promptAndRefreshInitialHostToolCatalog({
+  startPrompt,
+  relay,
+  tools,
+  harnessId,
+  timeoutMs
+}) {
+  void startPrompt();
+  await refreshHostToolCatalog({
+    relay,
+    tools,
+    harnessId,
+    timeoutMs
+  });
+}
 async function refreshHostToolCatalog({
   relay,
   tools,
@@ -3063,8 +3123,12 @@ await runBridge({
   }
 });
 async function runTurn(start, turn) {
+  let initialHostToolCatalogRefreshRequired;
   try {
-    await ensureSession({ start, turn });
+    ({ initialHostToolCatalogRefreshRequired } = await ensureSession({
+      start,
+      turn
+    }));
   } catch (error) {
     if (HarnessBridgeCapabilityUnsupportedError.isInstance(error)) throw error;
     throw createACPBridgeError({
@@ -3082,6 +3146,10 @@ async function runTurn(start, turn) {
       "ACP session initialization did not start stderr monitoring."
     );
   }
+  const activeHostToolRelay = hostToolRelay;
+  if (activeHostToolRelay == null) {
+    throw new Error("The host tool MCP relay is unavailable.");
+  }
   if (start.recoveryMode?.type === "lossy-rerun") {
     const marker = {
       type: "acp-recovery",
@@ -3189,15 +3257,34 @@ async function runTurn(start, turn) {
     registerCorrelationInvocation: emitStreamEvent.registerHostToolCorrelationInvocation,
     removeCorrelationInvocation: emitStreamEvent.removeHostToolCorrelationInvocation
   };
-  hostToolRelay?.bindTurn({ turn: relayTurn });
+  activeHostToolRelay.bindTurn({ turn: relayTurn });
   try {
     const promptMeta = createOutputSchemaPromptMeta({ start });
-    void promptActiveSession({
+    const startPrompt = () => promptActiveSession({
       session: activeSession,
       agent: connection.agent,
       prompt: start.prompt,
       meta: promptMeta
     });
+    if (initialHostToolCatalogRefreshRequired) {
+      try {
+        await promptAndRefreshInitialHostToolCatalog({
+          startPrompt,
+          relay: activeHostToolRelay,
+          tools: start.tools ?? [],
+          harnessId: bridgeType,
+          timeoutMs: CATALOG_REFRESH_TIMEOUT_MS
+        });
+      } catch (error) {
+        if (HarnessBridgeCapabilityUnsupportedError.isInstance(error)) {
+          catalogRefreshError = error;
+        }
+        sessionConfigurationFailure = { error };
+        throw error;
+      }
+    } else {
+      void startPrompt();
+    }
     if (turn.abortSignal.aborted) {
       await cancel();
     } else {
@@ -3245,7 +3332,7 @@ async function runTurn(start, turn) {
   } finally {
     permissionController.cancelAll();
     activePermissionController = void 0;
-    hostToolRelay?.unbindTurn({ turn: relayTurn });
+    activeHostToolRelay.unbindTurn({ turn: relayTurn });
   }
 }
 async function ensureSession({
@@ -3289,7 +3376,7 @@ async function ensureSession({
       }
       throw error;
     }
-    return;
+    return { initialHostToolCatalogRefreshRequired: false };
   }
   const clientApp = resolveClientApp();
   const authentication = bridgeConfiguration.authentication;
@@ -3452,12 +3539,6 @@ async function ensureSession({
     }).start();
   }
   try {
-    await refreshHostToolCatalog({
-      relay: hostToolRelay,
-      tools,
-      harnessId: bridgeType,
-      timeoutMs: CATALOG_REFRESH_TIMEOUT_MS
-    });
     if (start.permissionModeMapping != null) {
       await configureACPPermissionMode({
         agent: connection.agent,
@@ -3482,6 +3563,7 @@ async function ensureSession({
     sessionId: createdSession.sessionId
   });
   sessionConfigurationFingerprint = fingerprint;
+  return { initialHostToolCatalogRefreshRequired: tools.length > 0 };
 }
 function createExternalMcpServers({
   mcpServers,