@agent-harness-experimental/adapter-claude-code 0.0.0 → 0.0.1

package/LICENSE

@@ -0,0 +1 @@
+Copyright Vercel Inc. Pre-release. Not licensed as OSS yet.

package/README.md

@@ -1,3 +1,103 @@
-# @agent-harness-experimental/adapter-claude-code
+# `@agent-harness-experimental/adapter-claude-code`
 
-Placeholder package.
+Adapter for running [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+as an agent inside `agent-harness-experimental`.
+
+## Install
+
+```bash
+npm install agent-harness-experimental @agent-harness-experimental/adapter-claude-code
+```
+
+## Usage
+
+```ts
+import { createAgentSession } from "agent-harness-experimental";
+import { claudeCode } from "@agent-harness-experimental/adapter-claude-code";
+
+const agent = createAgentSession({
+  adapter: claudeCode(),
+});
+
+const result = await agent.generate("Create a hello world Express server");
+console.log(result.text);
+await agent.close("stop");
+```
+
+## Configuration
+
+```ts
+claudeCode({
+  // Claude model to use
+  model: "claude-sonnet-4",
+
+  // Maximum conversation turns
+  maxTurns: 20,
+
+  // Extended thinking mode
+  thinking: "adaptive", // or 'disabled' or { budgetTokens: 10000 }
+
+  // Reasoning effort level
+  effort: "high", // 'low' | 'medium' | 'high' | 'max'
+});
+```
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `model` | `string` | — | Claude model ID |
+| `maxTurns` | `number` | — | Max conversation turns |
+| `thinking` | `'adaptive' \| 'disabled' \| { budgetTokens }` | — | Extended thinking mode |
+| `effort` | `'low' \| 'medium' \| 'high' \| 'max'` | — | Reasoning effort |
+| `auth` | `object` | — | Optional per-adapter auth override (`gateway` or `anthropic`) |
+
+Sandbox runtime options such as `template`, `timeoutMs`, and `httpHandler`
+belong on `createAgentSession({ sandbox })`.
+
+```ts
+const agent = createAgentSession({
+  adapter: claudeCode({ model: "claude-sonnet-4" }),
+  sandbox: {
+    template: "snap_abc123",
+    timeoutMs: 60000,
+    httpHandler: async (request: Request) => fetch(request),
+  },
+});
+```
+
+## Auth
+
+`auth` is optional. If you omit it, Claude Code keeps the existing
+gateway-first fallback.
+
+```ts
+claudeCode({
+  model: "claude-sonnet-4",
+  auth: {
+    anthropic: {
+      apiKey: { env: "ANTHROPIC_TEAM_B_API_KEY" },
+    },
+  },
+});
+```
+
+## Built-in Tools
+
+Claude Code exposes standardized builtin names through `agent-harness-experimental`. The native runtime names are shown for reference:
+
+| Tool | Native Tool | Description |
+| --- | --- | --- |
+| `read` | `Read` | Read file contents |
+| `write` | `Write` | Write content to a file |
+| `edit` | `Edit` | Edit a file by replacing text |
+| `bash` | `Bash` | Execute a shell command |
+| `glob` | `Glob` | Find files matching a glob pattern |
+| `grep` | `Grep` | Search file contents with regex |
+
+## Features
+
+- **Tool interception**: Built-in tools can be intercepted for approval via the
+  `permissions` option on `createAgentSession`
+- **Skills**: Written to `.claude/skills/{name}.md` with YAML frontmatter
+- **Subagents**: Full support for delegating to named subagents
+- **Token-level streaming**: Real-time text and reasoning deltas
+- **Session resume**: Persistent sandbox sessions across restarts

package/dist/adapter.d.ts

@@ -0,0 +1,29 @@
+import type { AgentAdapter, AdapterContext, AnthropicAuthOptions, GatewayAuthOptions } from 'agent-harness-experimental';
+export declare const CLAUDE_CODE_BUILTIN_TOOLS: {
+    name: string;
+    inputSchema: import("agent-harness-experimental").JsonSchema;
+    nativeName?: string | undefined;
+    description?: string | undefined;
+}[], CLAUDE_CODE_BUILTIN_TOOL_MAPPINGS: Pick<{
+    name: string;
+    inputSchema: import("agent-harness-experimental").JsonSchema;
+    nativeName?: string | undefined;
+    description?: string | undefined;
+}, "name" | "nativeName">[], CLAUDE_CODE_PERMISSION_TOOL_CATEGORIES: import("agent-harness-experimental").PermissionToolCategories;
+export interface ClaudeCodeAdapterOptions {
+    model?: string;
+    maxTurns?: number;
+    /** Thinking mode: 'adaptive' (default), 'enabled' with budget, or 'disabled' */
+    thinking?: 'adaptive' | 'disabled' | {
+        budgetTokens: number;
+    };
+    /** Reasoning effort level */
+    effort?: 'low' | 'medium' | 'high' | 'max';
+    auth?: {
+        gateway?: GatewayAuthOptions;
+        anthropic?: AnthropicAuthOptions;
+    };
+}
+export declare function setupClaudeCodeEnv(ctx: AdapterContext, options?: ClaudeCodeAdapterOptions, env?: NodeJS.ProcessEnv): void;
+export declare function claudeCode(options?: ClaudeCodeAdapterOptions): AgentAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,4BAA4B,CAAC;AAqBpC,eAAO,MACE,yBAAyB;;;;;KACtB,iCAAiC;;;;;6BACjB,sCAAsC,+DAYhE,CAAC;AAEH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,6BAA6B;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IAC3C,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,kBAAkB,CAAC;QAC7B,SAAS,CAAC,EAAE,oBAAoB,CAAC;KAClC,CAAC;CACH;AAqFD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,wBAAwB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAoCtI;AAED,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,YAAY,CAoG3E"}

package/dist/adapter.js

@@ -0,0 +1,215 @@
+import { normalizeAdapterError, defineAdapterBuiltinTools, detachSandboxRuntime, getSandboxRuntimeLayout, hasHttpPathRuleForBaseUrl, promptSandboxRuntime, resolveAnthropicHeaders, resolveBearerHeaders, resolveSecretInput, resolveUrlHost, selectConfiguredAuthBag, startSandboxRuntime, stopSandboxRuntime, toSandboxPlaceholderSecret, } from 'agent-harness-experimental';
+import { getSandboxImageName, withVercelSandboxBackend } from '@agent-harness-experimental/sandbox-vercel';
+import { CLAUDE_CODE_DEFAULT_CONTEXT_WINDOW, getClaudeCodeSandboxSetup } from './setup.js';
+export const { tools: CLAUDE_CODE_BUILTIN_TOOLS, mappings: CLAUDE_CODE_BUILTIN_TOOL_MAPPINGS, permissionToolCategories: CLAUDE_CODE_PERMISSION_TOOL_CATEGORIES, } = defineAdapterBuiltinTools([
+    { name: 'read', nativeName: 'Read' },
+    { name: 'write', nativeName: 'Write' },
+    { name: 'edit', nativeName: 'Edit' },
+    { name: 'bash', nativeName: 'Bash' },
+    { name: 'glob', nativeName: 'Glob' },
+    {
+        name: 'grep',
+        nativeName: 'Grep',
+        description: 'Search file contents with regex',
+    },
+]);
+function setEnvValue(target, name, value) {
+    if (value !== undefined) {
+        target[name] = value;
+    }
+}
+function resolveClaudeCodeErrorProvider(options) {
+    const selectedAuth = selectConfiguredAuthBag(options?.auth, ['anthropic', 'gateway']);
+    if (selectedAuth === 'anthropic') {
+        return 'anthropic';
+    }
+    if (selectedAuth === 'gateway') {
+        return 'ai-gateway';
+    }
+    return undefined;
+}
+function resolveClaudeCodeCoreSandboxAccess(options, sandboxConfig, env = process.env) {
+    const selectedAuth = selectConfiguredAuthBag(options?.auth, ['anthropic', 'gateway']);
+    const forceProxy = Boolean(sandboxConfig?.httpHandler);
+    if (selectedAuth === 'anthropic') {
+        const auth = options?.auth?.anthropic;
+        const apiKey = resolveSecretInput(auth?.apiKey, env) ?? env.ANTHROPIC_API_KEY;
+        const authToken = resolveSecretInput(auth?.authToken, env) ?? env.ANTHROPIC_AUTH_TOKEN;
+        const baseUrl = auth?.baseURL ?? env.ANTHROPIC_BASE_URL;
+        const host = resolveUrlHost(baseUrl, 'https://api.anthropic.com');
+        if (!host) {
+            return undefined;
+        }
+        if (forceProxy || hasHttpPathRuleForBaseUrl(sandboxConfig?.network?.deny?.urlPrefixes, baseUrl, 'https://api.anthropic.com')) {
+            return {
+                proxiedHosts: [host],
+                injectedHeaders: [{ domain: host, headers: resolveAnthropicHeaders({ apiKey, authToken, headers: auth?.headers }) }],
+            };
+        }
+        return {
+            directHosts: [host],
+            injectedHeaders: [{ domain: host, headers: resolveAnthropicHeaders({ apiKey, authToken, headers: auth?.headers }) }],
+        };
+    }
+    if (selectedAuth === 'gateway') {
+        const auth = options?.auth?.gateway;
+        const gatewayKey = resolveSecretInput(auth?.apiKey, env) ?? env.AI_GATEWAY_API_KEY;
+        const host = resolveUrlHost(auth?.baseURL ?? env.AI_GATEWAY_BASE_URL ?? 'https://ai-gateway.vercel.sh', 'https://ai-gateway.vercel.sh');
+        return {
+            ...(forceProxy ? { proxiedHosts: host ? [host] : [] } : { directHosts: host ? [host] : [] }),
+            injectedHeaders: host ? [{ domain: host, headers: resolveBearerHeaders(gatewayKey, auth?.headers) }] : [],
+        };
+    }
+    const gatewayKey = env.AI_GATEWAY_API_KEY || '';
+    if (gatewayKey) {
+        const host = resolveUrlHost(env.AI_GATEWAY_BASE_URL ?? env.ANTHROPIC_BASE_URL, 'https://ai-gateway.vercel.sh');
+        return {
+            ...(forceProxy ? { proxiedHosts: host ? [host] : [] } : { directHosts: host ? [host] : [] }),
+            injectedHeaders: host ? [{ domain: host, headers: resolveBearerHeaders(gatewayKey) }] : [],
+        };
+    }
+    const host = resolveUrlHost(env.ANTHROPIC_BASE_URL, 'https://api.anthropic.com');
+    const apiKey = env.ANTHROPIC_API_KEY;
+    const authToken = env.ANTHROPIC_AUTH_TOKEN;
+    if (!host) {
+        return undefined;
+    }
+    if (forceProxy || hasHttpPathRuleForBaseUrl(sandboxConfig?.network?.deny?.urlPrefixes, env.ANTHROPIC_BASE_URL, 'https://api.anthropic.com')) {
+        return {
+            proxiedHosts: [host],
+            injectedHeaders: [{ domain: host, headers: resolveAnthropicHeaders({ apiKey, authToken }) }],
+        };
+    }
+    return {
+        directHosts: [host],
+        injectedHeaders: [{ domain: host, headers: resolveAnthropicHeaders({ apiKey, authToken }) }],
+    };
+}
+export function setupClaudeCodeEnv(ctx, options, env = process.env) {
+    const selectedAuth = selectConfiguredAuthBag(options?.auth, ['anthropic', 'gateway']);
+    if (selectedAuth === 'anthropic') {
+        const auth = options?.auth?.anthropic;
+        const apiKey = resolveSecretInput(auth?.apiKey, env) ?? env.ANTHROPIC_API_KEY;
+        const authToken = resolveSecretInput(auth?.authToken, env) ?? env.ANTHROPIC_AUTH_TOKEN;
+        setEnvValue(ctx.env, 'ANTHROPIC_API_KEY', toSandboxPlaceholderSecret(apiKey));
+        setEnvValue(ctx.env, 'ANTHROPIC_AUTH_TOKEN', toSandboxPlaceholderSecret(authToken));
+        setEnvValue(ctx.env, 'ANTHROPIC_BASE_URL', auth?.baseURL ?? env.ANTHROPIC_BASE_URL);
+    }
+    else if (selectedAuth === 'gateway') {
+        const auth = options?.auth?.gateway;
+        const gatewayKey = resolveSecretInput(auth?.apiKey, env) ?? env.AI_GATEWAY_API_KEY;
+        setEnvValue(ctx.env, 'AI_GATEWAY_API_KEY', toSandboxPlaceholderSecret(gatewayKey));
+        setEnvValue(ctx.env, 'ANTHROPIC_BASE_URL', auth?.baseURL ?? env.AI_GATEWAY_BASE_URL ?? 'https://ai-gateway.vercel.sh');
+        setEnvValue(ctx.env, 'ANTHROPIC_AUTH_TOKEN', toSandboxPlaceholderSecret(gatewayKey));
+        setEnvValue(ctx.env, 'ANTHROPIC_API_KEY', toSandboxPlaceholderSecret(gatewayKey));
+    }
+    else {
+        const gatewayKey = env.AI_GATEWAY_API_KEY || '';
+        if (gatewayKey) {
+            ctx.env.ANTHROPIC_BASE_URL = env.ANTHROPIC_BASE_URL || 'https://ai-gateway.vercel.sh';
+            ctx.env.ANTHROPIC_AUTH_TOKEN = toSandboxPlaceholderSecret(env.ANTHROPIC_AUTH_TOKEN || gatewayKey) ?? '';
+            ctx.env.ANTHROPIC_API_KEY = toSandboxPlaceholderSecret(gatewayKey) ?? '';
+        }
+        else if (env.ANTHROPIC_API_KEY || env.ANTHROPIC_AUTH_TOKEN) {
+            if (env.ANTHROPIC_API_KEY) {
+                ctx.env.ANTHROPIC_API_KEY = toSandboxPlaceholderSecret(env.ANTHROPIC_API_KEY) ?? '';
+            }
+            if (env.ANTHROPIC_AUTH_TOKEN) {
+                ctx.env.ANTHROPIC_AUTH_TOKEN = toSandboxPlaceholderSecret(env.ANTHROPIC_AUTH_TOKEN) ?? '';
+            }
+        }
+    }
+    if (ctx.agentTelemetry !== 'allow') {
+        ctx.env.CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = '1';
+    }
+}
+export function claudeCode(options) {
+    let state = null;
+    const sandboxSetup = getClaudeCodeSandboxSetup();
+    const sandboxImageName = getSandboxImageName('claude-code', sandboxSetup);
+    return {
+        name: 'claude-code',
+        supportsToolInterception: true,
+        supportsHostAccessRequests: true,
+        prepareStepSupport: 'continuation',
+        normalizeError(error) {
+            return normalizeAdapterError(error, {
+                adapter: 'claude-code',
+                provider: resolveClaudeCodeErrorProvider(options),
+                model: options?.model,
+            });
+        },
+        builtinTools: CLAUDE_CODE_BUILTIN_TOOLS,
+        defaultContextWindow: CLAUDE_CODE_DEFAULT_CONTEXT_WINDOW,
+        permissionToolCategories: CLAUDE_CODE_PERMISSION_TOOL_CATEGORIES,
+        getBridgeFiles: () => sandboxSetup.getBridgeFiles(),
+        getSandboxFiles: (ctx) => sandboxSetup.getSandboxFiles(ctx),
+        resolveSandboxConfig: (sandboxConfig) => withVercelSandboxBackend(sandboxConfig),
+        async start(ctx) {
+            const sandboxConfig = withVercelSandboxBackend(ctx.sandboxConfig);
+            const { workDir } = getSandboxRuntimeLayout('claude-code', ctx.sessionId, sandboxConfig);
+            state = await startSandboxRuntime(ctx, {
+                adapterName: 'claude-code',
+                sessionId: ctx.sessionId,
+                deps: sandboxSetup.deps,
+                lockfile: sandboxSetup.lockfile,
+                bridgeFiles: sandboxSetup.getBridgeFiles(),
+                sandboxFiles: sandboxSetup.getSandboxFiles({
+                    workDir,
+                    skills: ctx.skills,
+                    agents: ctx.agents,
+                    instructions: ctx.instructions,
+                }),
+                postInstallCommands: sandboxSetup.postInstallCommands,
+                setupEnv(innerCtx) {
+                    setupClaudeCodeEnv(innerCtx, options);
+                },
+                buildConfig: () => ({
+                    model: options?.model,
+                    maxTurns: options?.maxTurns,
+                    activeTools: ctx.activeTools,
+                    interceptBuiltinTools: ctx.interceptBuiltinTools,
+                    builtinToolMappings: CLAUDE_CODE_BUILTIN_TOOL_MAPPINGS,
+                    thinking: options?.thinking,
+                    effort: options?.effort,
+                    agents: ctx.agents,
+                }),
+                imageName: sandboxImageName,
+                sandboxConfig,
+                coreAccess: resolveClaudeCodeCoreSandboxAccess(options, sandboxConfig),
+            });
+        },
+        async prompt(message, ctx) {
+            if (!state)
+                throw new Error('Adapter not started');
+            await promptSandboxRuntime(state, ctx, message, ctx.registeredTools, {
+                model: options?.model,
+                maxTurns: options?.maxTurns,
+                activeTools: ctx.activeTools,
+                interceptBuiltinTools: ctx.interceptBuiltinTools,
+                builtinToolMappings: CLAUDE_CODE_BUILTIN_TOOL_MAPPINGS,
+                thinking: options?.thinking,
+                effort: options?.effort,
+                contextWindow: ctx.contextWindow,
+                toolSearchMode: ctx.toolSearchMode,
+                traceContext: ctx.traceContext,
+                agents: ctx.agents,
+            }, { instructions: ctx.instructions });
+        },
+        async registerTools(tools, ctx) {
+            ctx.registeredTools = tools;
+        },
+        async stop() {
+            if (state) {
+                await stopSandboxRuntime(state);
+                state = null;
+            }
+        },
+        async detach() {
+            if (state) {
+                await detachSandboxRuntime(state);
+            }
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/bridge-continuation.mts

@@ -0,0 +1 @@
+export * from '@agent-harness-experimental/bridge/bridge-continuation';

package/dist/bridge-delegation.mts

@@ -0,0 +1 @@
+export * from '@agent-harness-experimental/bridge/bridge-delegation';

package/dist/bridge-helpers.mts

@@ -0,0 +1,122 @@
+import { isToolAllowed, shouldObserveBuiltinTool, toStandardBuiltinToolName } from './bridge-tool-policy.mts';
+import type { emit } from './bridge-ws-server.mts';
+import { msg as protocolMessage } from '@agent-harness-experimental/protocol';
+
+type ClaudeBridgeConfig = {
+  workDir?: string;
+  interceptBuiltinTools?: boolean | string[];
+  activeTools?: string[];
+  builtinToolMappings?: Array<{
+    name: string;
+    nativeName?: string;
+  }>;
+  model?: string;
+  maxTurns?: number;
+  executableArgs?: string[];
+  instructions?: string;
+  thinking?: 'adaptive' | 'disabled' | Record<string, unknown>;
+  effort?: string;
+  agents?: Record<string, unknown>;
+};
+
+type ToolDecision = {
+  approved: boolean;
+  reason?: string;
+};
+
+type ToolDecisionRequester = (requestId: string) => Promise<ToolDecision>;
+type BridgeEmitter = typeof emit;
+
+type ClaudeQueryToolDecision =
+  | { behavior: 'allow'; updatedInput: Record<string, unknown> }
+  | {
+      behavior: 'deny';
+      message: string;
+    };
+
+type ClaudeQueryToolOptions = {
+  permissionMode: 'default' | 'bypassPermissions';
+  allowDangerouslySkipPermissions: boolean;
+  canUseTool?: (toolName: string, input: Record<string, unknown>, opts: { toolUseID: string }) => Promise<ClaudeQueryToolDecision>;
+};
+
+export function createClaudeQueryToolOptions(
+  config: ClaudeBridgeConfig,
+  emit: BridgeEmitter,
+  requestToolDecision: ToolDecisionRequester,
+  allowedTools?: string[],
+): ClaudeQueryToolOptions {
+  if (!config.interceptBuiltinTools && !allowedTools?.length) {
+    return {
+      permissionMode: 'bypassPermissions',
+      allowDangerouslySkipPermissions: true,
+    };
+  }
+
+  return {
+    permissionMode: 'default',
+    allowDangerouslySkipPermissions: false,
+    async canUseTool(toolName, input, opts) {
+      const requestId = opts.toolUseID;
+      const standardToolName = toStandardBuiltinToolName(config, toolName);
+      if (!isToolAllowed(standardToolName, allowedTools) || !isToolAllowed(standardToolName, config.activeTools)) {
+        return { behavior: 'deny', message: `Tool "${standardToolName}" is not allowed for this run` };
+      }
+      if (shouldObserveBuiltinTool(config, toolName)) {
+        emit(protocolMessage.toolCall({ requestId, toolName: standardToolName, toolCallId: requestId, input, observeOnly: true }));
+        return { behavior: 'allow', updatedInput: input };
+      }
+
+      emit(protocolMessage.toolCall({ requestId, toolName: standardToolName, toolCallId: requestId, input }));
+      const decision = await requestToolDecision(requestId);
+      return decision.approved ? { behavior: 'allow', updatedInput: input } : { behavior: 'deny', message: decision.reason || 'Denied' };
+    },
+  };
+}
+
+function extractSubagentName(input: unknown): string | null {
+  if (!input || typeof input !== 'object') {
+    return null;
+  }
+
+  for (const key of ['agent', 'name', 'subagent', 'agentName', 'subagent_type', 'subagentType', 'agent_type', 'agentType']) {
+    const value = (input as Record<string, unknown>)[key];
+    if (typeof value === 'string' && value.length > 0) {
+      return value;
+    }
+  }
+
+  return null;
+}
+
+export function recordClaudeSubagentStart(
+  activeSubagents: Map<string, string>,
+  emit: BridgeEmitter,
+  toolName: string,
+  toolUseId: string,
+  input: unknown,
+): string | null {
+  if (toolName !== 'Agent' && toolName !== 'Task') {
+    return null;
+  }
+
+  const agentName = extractSubagentName(input);
+  if (!agentName) {
+    return null;
+  }
+
+  activeSubagents.set(toolUseId, agentName);
+  emit(protocolMessage.subagentStart({ agentName, parentToolCallId: toolUseId }));
+  return agentName;
+}
+
+export function recordClaudeSubagentFinish(activeSubagents: Map<string, string>, emit: BridgeEmitter, toolUseId: string, output?: unknown): string | null {
+  const agentName = activeSubagents.get(toolUseId);
+  if (!agentName) {
+    return null;
+  }
+
+  activeSubagents.delete(toolUseId);
+  emit(protocolMessage.subagentFinish({ agentName, parentToolCallId: toolUseId, ...(output !== undefined ? { output } : {}) }));
+  return agentName;
+}

package/dist/bridge-tool-policy.mts

@@ -0,0 +1 @@
+export * from '@agent-harness-experimental/bridge/bridge-tool-policy';

package/dist/bridge-ws-server.mts

@@ -0,0 +1 @@
+export * from '@agent-harness-experimental/bridge/bridge-ws-server';