@ai-sdk/harness-deepagents 1.0.63 → 1.0.65

package/src/deepagents-bridge-protocol.ts

@@ -11,7 +11,11 @@ export const outboundMessageSchema = harnessV1BridgeOutboundMessageSchema;
 export type OutboundMessage = z.infer<typeof outboundMessageSchema>;
 
 export const startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
-  // Prepended to the first user message (createDeepAgent takes no instructions param).
+  mcpServers: z.record(z.string(), z.unknown()).optional(),
+  /*
+   * Appended to Deep Agents's native system prompt when the bridge constructs
+   * the session's agent.
+   */
   instructions: z.string().optional(),
   // In-backend skills source dirs ($HOME and <workDir>), passed to createDeepAgent({ skills }).
   skillsPaths: z.array(z.string()).optional(),

package/src/deepagents-harness.ts

@@ -96,11 +96,21 @@ export type DeepAgentsHarnessSettings = {
   readonly port?: number;
   /** Maximum milliseconds to wait for the bridge to advertise its port. Defaults to 120000. */
   readonly startupTimeoutMs?: number;
+  /**
+   * Creates the authentication token used by the sandbox bridge. Defaults to
+   * a random 32-byte hexadecimal token.
+   */
+  readonly mintBridgeToken?: (sandboxId: string) => string;
   /**
    * Maximum LangGraph super-steps per turn before it errors.
    * When omitted, the Deep Agents default applies.
    */
   readonly recursionLimit?: number;
+  /**
+   * MCP server definitions keyed by server name. Each definition uses the
+   * underlying runtime's native MCP server configuration format.
+   */
+  readonly mcpServers?: Record<string, unknown>;
 };
 
 // Every model-callable DeepAgents built-in, keyed by what the bridge emits (commonName ?? nativeName); all must be listed or AI SDK throws AI_NoSuchToolError.
@@ -278,6 +288,7 @@ export function createDeepAgents(
             permissionMode,
             builtinToolFiltering: startOpts.builtinToolFiltering,
             recursionLimit: settings.recursionLimit,
+            mcpServers: settings.mcpServers,
           });
         } catch {
           // Bridge no longer reachable — recover by respawning below.
@@ -285,7 +296,10 @@ export function createDeepAgents(
       }
 
       const port = resolveBridgePort(sandboxSession, settings.port);
-      const token = randomBytes(32).toString('hex');
+      const token =
+        settings.mintBridgeToken == null
+          ? randomBytes(32).toString('hex')
+          : settings.mintBridgeToken(sandboxId);
 
       // Always discover repo-provided skills under <workDir>/.agents/skills (e.g. a cloned repo); a missing dir is tolerated by deepagents.
       // Absolute paths: LocalShellBackend (non-virtual) treats a leading-slash path as a real fs path.
@@ -393,6 +407,7 @@ export function createDeepAgents(
         permissionMode,
         builtinToolFiltering: startOpts.builtinToolFiltering,
         recursionLimit: settings.recursionLimit,
+        mcpServers: settings.mcpServers,
       });
     },
   };
@@ -490,6 +505,7 @@ function createSession({
   permissionMode,
   builtinToolFiltering,
   recursionLimit,
+  mcpServers,
 }: {
   sessionId: string;
   channel: DeepAgentsChannel;
@@ -508,6 +524,7 @@ function createSession({
   permissionMode?: HarnessV1PermissionMode;
   builtinToolFiltering?: HarnessV1BuiltinToolFiltering;
   recursionLimit?: number;
+  mcpServers?: Record<string, unknown>;
 }): HarnessV1Session {
   let stopped = false;
   let instructionsApplied = attached;
@@ -665,6 +682,7 @@ function createSession({
         ...(permissionMode ? { permissionMode } : {}),
         ...(builtinToolFiltering ? { builtinToolFiltering } : {}),
         ...(recursionLimit != null ? { recursionLimit } : {}),
+        ...(mcpServers == null ? {} : { mcpServers }),
       });
 
       return control;