open-agent-sdk 0.1.0-alpha.0

package/dist/mcp/server-registry.js

@@ -0,0 +1,121 @@
+/**
+ * MCP Server Registry
+ * Manages registration of MCP tools to SDK ToolRegistry
+ */
+import { McpToolAdapter } from './tool-adapter.js';
+/**
+ * Manages registration of MCP server tools to SDK ToolRegistry
+ */
+export class McpServerRegistry {
+    toolRegistry;
+    registeredTools = new Map(); // serverName -> Set of tool names
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+    }
+    /**
+     * Register all tools from an MCP server
+     * Returns list of registered tool names (with prefixes)
+     */
+    async registerServer(name, client) {
+        const adapter = new McpToolAdapter(name, client);
+        const registeredNames = [];
+        try {
+            // Fetch tools from MCP server
+            const response = await client.listTools();
+            const tools = response.tools || [];
+            // Track tools for this server
+            const serverTools = new Set();
+            for (const tool of tools) {
+                // Convert to SDK tool format
+                const sdkTool = adapter.toSdkTool(tool);
+                // Register with ToolRegistry
+                this.toolRegistry.register(sdkTool);
+                // Track the registered tool
+                serverTools.add(sdkTool.name);
+                registeredNames.push(sdkTool.name);
+            }
+            // Store tracking info
+            this.registeredTools.set(name, serverTools);
+            return registeredNames;
+        }
+        catch (error) {
+            console.warn(`Failed to register MCP server "${name}" tools:`, error);
+            return [];
+        }
+    }
+    /**
+     * Unregister all tools from a server
+     */
+    unregisterServer(name) {
+        const serverTools = this.registeredTools.get(name);
+        if (!serverTools) {
+            return; // Server not registered
+        }
+        // Unregister each tool from ToolRegistry
+        for (const toolName of serverTools) {
+            this.toolRegistry.unregister(toolName);
+        }
+        // Remove tracking
+        this.registeredTools.delete(name);
+    }
+    /**
+     * Check if a tool name is an MCP tool
+     */
+    isMcpTool(toolName) {
+        // Check if it's in our tracking
+        for (const serverTools of this.registeredTools.values()) {
+            if (serverTools.has(toolName)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Parse MCP tool name to extract server and tool name
+     * Format: mcp_<server>_<tool>
+     */
+    parseMcpToolName(prefixedName) {
+        if (!prefixedName.startsWith('mcp_')) {
+            return null;
+        }
+        const parts = prefixedName.slice(4).split('_'); // Remove 'mcp_' prefix
+        if (parts.length < 2) {
+            return null; // Need at least server name and tool name
+        }
+        const serverName = parts[0];
+        const toolName = parts.slice(1).join('_');
+        if (!serverName || !toolName) {
+            return null;
+        }
+        return { serverName, toolName };
+    }
+    /**
+     * Get server name for a registered MCP tool
+     */
+    getServerForTool(toolName) {
+        const parsed = this.parseMcpToolName(toolName);
+        if (!parsed) {
+            return null;
+        }
+        // Verify it's actually registered
+        const serverTools = this.registeredTools.get(parsed.serverName);
+        if (serverTools && serverTools.has(toolName)) {
+            return parsed.serverName;
+        }
+        return null;
+    }
+    /**
+     * Get all registered server names
+     */
+    getRegisteredServers() {
+        return Array.from(this.registeredTools.keys());
+    }
+    /**
+     * Get tools registered for a specific server
+     */
+    getServerTools(serverName) {
+        const tools = this.registeredTools.get(serverName);
+        return tools ? Array.from(tools) : [];
+    }
+}
+//# sourceMappingURL=server-registry.js.map

package/dist/mcp/server-registry.js.map

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

package/dist/mcp/tool-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * MCP Tool Adapter
+ * Converts MCP tool format to Open Agent SDK tool format
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { McpTool } from './types.js';
+import type { Tool } from '../types/tools.js';
+/**
+ * Adapts MCP tools to SDK tool format
+ */
+export declare class McpToolAdapter {
+    private serverName;
+    private client;
+    private prefixSeparator;
+    constructor(serverName: string, client: Client);
+    /**
+     * Generate prefixed tool name to avoid conflicts
+     * Format: mcp_<server>_<tool>
+     */
+    getPrefixedName(toolName: string): string;
+    /**
+     * Convert MCP tool to SDK Tool format
+     */
+    toSdkTool(mcpTool: McpTool): Tool;
+    /**
+     * Create tool execution handler
+     */
+    private createHandler;
+    /**
+     * Convert JSON schema to SDK JSONSchema format
+     */
+    private convertSchema;
+    /**
+     * Get server name
+     */
+    getServerName(): string;
+    /**
+     * Get client
+     */
+    getClient(): Client;
+}
+//# sourceMappingURL=tool-adapter.d.ts.map

package/dist/mcp/tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,mBAAmB,CAAC;AAEvE;;GAEG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,eAAe,CAAO;gBAGpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;IAGxB;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIzC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAiBjC;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB"}

package/dist/mcp/tool-adapter.js

@@ -0,0 +1,89 @@
+/**
+ * MCP Tool Adapter
+ * Converts MCP tool format to Open Agent SDK tool format
+ */
+/**
+ * Adapts MCP tools to SDK tool format
+ */
+export class McpToolAdapter {
+    serverName;
+    client;
+    prefixSeparator = '_';
+    constructor(serverName, client) {
+        this.serverName = serverName;
+        this.client = client;
+    }
+    /**
+     * Generate prefixed tool name to avoid conflicts
+     * Format: mcp_<server>_<tool>
+     */
+    getPrefixedName(toolName) {
+        return `mcp${this.prefixSeparator}${this.serverName}${this.prefixSeparator}${toolName}`;
+    }
+    /**
+     * Convert MCP tool to SDK Tool format
+     */
+    toSdkTool(mcpTool) {
+        const prefixedName = this.getPrefixedName(mcpTool.name);
+        const description = `[MCP:${this.serverName}] ${mcpTool.description || ''}`;
+        // Convert JSON schema to SDK format
+        const parameters = mcpTool.inputSchema
+            ? this.convertSchema(mcpTool.inputSchema)
+            : { type: 'object', properties: {} };
+        return {
+            name: prefixedName,
+            description,
+            parameters,
+            handler: this.createHandler(mcpTool.name),
+        };
+    }
+    /**
+     * Create tool execution handler
+     */
+    createHandler(originalToolName) {
+        return async (input, _context) => {
+            const result = await this.client.callTool({
+                name: originalToolName,
+                arguments: input,
+            });
+            return result;
+        };
+    }
+    /**
+     * Convert JSON schema to SDK JSONSchema format
+     */
+    convertSchema(schema) {
+        // Default schema if conversion fails
+        const defaultSchema = {
+            type: 'object',
+            properties: {},
+        };
+        if (!schema || typeof schema !== 'object') {
+            return defaultSchema;
+        }
+        const s = schema;
+        // Ensure type is 'object'
+        if (s.type !== 'object') {
+            return defaultSchema;
+        }
+        return {
+            type: 'object',
+            properties: s.properties || {},
+            required: Array.isArray(s.required) ? s.required : undefined,
+            additionalProperties: s.additionalProperties,
+        };
+    }
+    /**
+     * Get server name
+     */
+    getServerName() {
+        return this.serverName;
+    }
+    /**
+     * Get client
+     */
+    getClient() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=tool-adapter.js.map

package/dist/mcp/tool-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.js","sourceRoot":"","sources":["../../src/mcp/tool-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,OAAO,cAAc;IAIf;IACA;IAJF,eAAe,GAAG,GAAG,CAAC;IAE9B,YACU,UAAkB,EAClB,MAAc;QADd,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAQ;IACrB,CAAC;IAEJ;;;OAGG;IACH,eAAe,CAAC,QAAgB;QAC9B,OAAO,MAAM,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,GAAG,QAAQ,EAAE,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAgB;QACxB,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,WAAW,GAAG,QAAQ,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QAE5E,oCAAoC;QACpC,MAAM,UAAU,GAAe,OAAO,CAAC,WAAW;YAChD,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC;YACzC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAEvC,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,WAAW;YACX,UAAU;YACV,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,gBAAwB;QAC5C,OAAO,KAAK,EAAE,KAAc,EAAE,QAAqB,EAA0B,EAAE;YAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACxC,IAAI,EAAE,gBAAgB;gBACtB,SAAS,EAAE,KAAgC;aAC5C,CAAC,CAAC;YAEH,OAAO,MAAuB,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,MAAe;QACnC,qCAAqC;QACrC,MAAM,aAAa,GAAe;YAChC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf,CAAC;QAEF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,MAAM,CAAC,GAAG,MAAiC,CAAC;QAE5C,0BAA0B;QAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAG,CAAC,CAAC,UAAsC,IAAI,EAAE;YAC3D,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YAC5D,oBAAoB,EAAE,CAAC,CAAC,oBAA2C;SACpE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * MCP (Model Context Protocol) type definitions
+ * Aligned with Claude Agent SDK
+ */
+/** stdio transport configuration */
+export interface McpStdioServerConfig {
+    type: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/** HTTP transport configuration */
+export interface McpHttpServerConfig {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+}
+/** SSE transport configuration */
+export interface McpSSEServerConfig {
+    type: 'sse';
+    url: string;
+    headers?: Record<string, string>;
+}
+/** SDK transport configuration (direct instance) */
+export interface McpSdkServerConfig {
+    type: 'sdk';
+    name: string;
+    instance: any;
+}
+/** Union type for all MCP server configurations */
+export type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig | McpSSEServerConfig | McpSdkServerConfig;
+/** Configuration map for multiple MCP servers */
+export type McpServersConfig = Record<string, McpServerConfig>;
+/** MCP Server status */
+export interface McpServerStatus {
+    name: string;
+    status: 'connected' | 'failed' | 'needs-auth' | 'pending';
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+    tools: string[];
+    error?: string;
+}
+/** MCP Tool definition from server */
+export interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema?: any;
+}
+/** MCP Tool call result */
+export interface McpToolResult {
+    content: Array<{
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: any;
+        mimeType?: string;
+        resource?: {
+            uri: string;
+            mimeType?: string;
+            data: any;
+        };
+    }>;
+    isError?: boolean;
+}
+/** Type guard for stdio config */
+export declare function isStdioConfig(config: McpServerConfig): config is McpStdioServerConfig;
+/** Type guard for HTTP config */
+export declare function isHttpConfig(config: McpServerConfig): config is McpHttpServerConfig;
+/** Type guard for SSE config */
+export declare function isSseConfig(config: McpServerConfig): config is McpSSEServerConfig;
+/** Type guard for SDK config */
+export declare function isSdkConfig(config: McpServerConfig): config is McpSdkServerConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oCAAoC;AACpC,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,GAAG,CAAC;CACf;AAED,mDAAmD;AACnD,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE/D,wBAAwB;AACxB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IAC1D,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;QACpC,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE;YACT,GAAG,EAAE,MAAM,CAAC;YACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;YAElB,IAAI,EAAE,GAAG,CAAC;SACX,CAAC;KACH,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,kCAAkC;AAClC,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,oBAAoB,CAErF;AAED,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,mBAAmB,CAEnF;AAED,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,kBAAkB,CAEjF;AAED,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,kBAAkB,CAEjF"}

package/dist/mcp/types.js

@@ -0,0 +1,21 @@
+/**
+ * MCP (Model Context Protocol) type definitions
+ * Aligned with Claude Agent SDK
+ */
+/** Type guard for stdio config */
+export function isStdioConfig(config) {
+    return config.type === 'stdio';
+}
+/** Type guard for HTTP config */
+export function isHttpConfig(config) {
+    return config.type === 'http';
+}
+/** Type guard for SSE config */
+export function isSseConfig(config) {
+    return config.type === 'sse';
+}
+/** Type guard for SDK config */
+export function isSdkConfig(config) {
+    return config.type === 'sdk';
+}
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgFH,kCAAkC;AAClC,MAAM,UAAU,aAAa,CAAC,MAAuB;IACnD,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;AACjC,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAChC,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,WAAW,CAAC,MAAuB;IACjD,OAAO,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC;AAC/B,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,WAAW,CAAC,MAAuB;IACjD,OAAO,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC;AAC/B,CAAC"}

package/dist/permissions/index.d.ts

@@ -0,0 +1,3 @@
+export { PermissionManager } from './manager';
+export { type PermissionMode, type PermissionOptions, type PermissionResult, type CanUseTool, type PermissionCheckResult, type PlanLogEntry, SENSITIVE_TOOLS, EDIT_TOOLS, isSensitiveTool, isEditTool, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/permissions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/permissions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,eAAe,EACf,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/permissions/index.js

@@ -0,0 +1,4 @@
+// Permission system exports
+export { PermissionManager } from './manager';
+export { SENSITIVE_TOOLS, EDIT_TOOLS, isSensitiveTool, isEditTool, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/permissions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/permissions/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAOL,eAAe,EACf,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/permissions/manager.d.ts

@@ -0,0 +1,40 @@
+import { PermissionMode, PermissionOptions, PermissionCheckResult, PlanLogEntry } from './types';
+/**
+ * Manages permission checks for tool execution
+ * Aligned with Claude Agent SDK behavior
+ */
+export declare class PermissionManager {
+    private mode;
+    private allowDangerouslySkipPermissions;
+    private canUseTool?;
+    private planLog;
+    constructor(options: PermissionOptions);
+    /**
+     * Check if a tool is permitted to execute
+     * Aligned with Claude Agent SDK
+     */
+    checkPermission(toolName: string, input: Record<string, unknown>, options: {
+        signal: AbortSignal;
+    }): Promise<PermissionCheckResult>;
+    /**
+     * Get current permission mode
+     */
+    getMode(): PermissionMode;
+    /**
+     * Set permission mode
+     */
+    setMode(mode: PermissionMode): void;
+    /**
+     * Get plan log (only used in plan mode)
+     */
+    getPlanLog(): PlanLogEntry[];
+    /**
+     * Clear plan log
+     */
+    clearPlanLog(): void;
+    /**
+     * Resolve a PermissionResult to PermissionCheckResult
+     */
+    private resolvePermissionResult;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/permissions/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/permissions/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EAGrB,YAAY,EAGb,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,+BAA+B,CAAU;IACjD,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,EAAE,iBAAiB;IAatC;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IAoDjC;;OAEG;IACH,OAAO,IAAI,cAAc;IAIzB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAUnC;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAahC"}

package/dist/permissions/manager.js

@@ -0,0 +1,115 @@
+import { isSensitiveTool, isEditTool, } from './types';
+/**
+ * Manages permission checks for tool execution
+ * Aligned with Claude Agent SDK behavior
+ */
+export class PermissionManager {
+    mode;
+    allowDangerouslySkipPermissions;
+    canUseTool;
+    planLog = [];
+    constructor(options) {
+        this.mode = options.mode;
+        this.allowDangerouslySkipPermissions = options.allowDangerouslySkipPermissions ?? false;
+        this.canUseTool = options.canUseTool;
+        // Validate bypassPermissions mode
+        if (this.mode === 'bypassPermissions' && !this.allowDangerouslySkipPermissions) {
+            throw new Error('allowDangerouslySkipPermissions must be true to use bypassPermissions mode');
+        }
+    }
+    /**
+     * Check if a tool is permitted to execute
+     * Aligned with Claude Agent SDK
+     */
+    async checkPermission(toolName, input, options) {
+        switch (this.mode) {
+            case 'bypassPermissions':
+                return { approved: true };
+            case 'plan':
+                // Record tool call to plan log
+                this.planLog.push({
+                    toolName,
+                    input,
+                    timestamp: Date.now(),
+                });
+                return {
+                    approved: false,
+                    error: 'Tool execution blocked in plan mode',
+                };
+            case 'acceptEdits':
+                // Auto-approve edit tools
+                if (isEditTool(toolName)) {
+                    return { approved: true };
+                }
+                // Fall through to default behavior for non-edit tools
+                break;
+            case 'default':
+                // Continue to default behavior
+                break;
+        }
+        // Default behavior: check if tool is sensitive
+        if (isSensitiveTool(toolName)) {
+            // If canUseTool callback is provided, use it
+            if (this.canUseTool) {
+                const result = await this.canUseTool(toolName, input, {
+                    signal: options.signal,
+                    suggestions: [], // Could be populated based on context
+                });
+                return this.resolvePermissionResult(result);
+            }
+            // No callback provided, deny sensitive tools
+            return {
+                approved: false,
+                error: `Permission denied: ${toolName}`,
+            };
+        }
+        // Non-sensitive tools are auto-approved
+        return { approved: true };
+    }
+    /**
+     * Get current permission mode
+     */
+    getMode() {
+        return this.mode;
+    }
+    /**
+     * Set permission mode
+     */
+    setMode(mode) {
+        // Validate bypassPermissions mode
+        if (mode === 'bypassPermissions' && !this.allowDangerouslySkipPermissions) {
+            throw new Error('allowDangerouslySkipPermissions must be true to use bypassPermissions mode');
+        }
+        this.mode = mode;
+    }
+    /**
+     * Get plan log (only used in plan mode)
+     */
+    getPlanLog() {
+        return [...this.planLog];
+    }
+    /**
+     * Clear plan log
+     */
+    clearPlanLog() {
+        this.planLog = [];
+    }
+    /**
+     * Resolve a PermissionResult to PermissionCheckResult
+     */
+    resolvePermissionResult(result) {
+        if (result.behavior === 'allow') {
+            return {
+                approved: true,
+                updatedInput: result.updatedInput,
+            };
+        }
+        else {
+            return {
+                approved: false,
+                error: result.message,
+            };
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/permissions/manager.js.map

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