@windagency/valora 2.0.1

package/dist/types/idempotency.types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Idempotency Types
+ *
+ * Type definitions for idempotency support in tool execution.
+ */
+/**
+ * Idempotency record stored for each executed operation
+ */
+export interface IdempotencyRecord {
+    /** Unique idempotency key (hash of tool call parameters) */
+    key: string;
+    /** Tool name that was executed */
+    tool_name: string;
+    /** Cached result from the execution */
+    result: IdempotencyResult;
+    /** When the record was created */
+    created_at: string;
+    /** When the record expires (TTL) */
+    expires_at: string;
+    /** Hash of the input arguments for verification */
+    args_hash: string;
+    /** Optional session ID for scoping */
+    session_id?: string;
+}
+/**
+ * Cached result from an idempotent operation
+ */
+export interface IdempotencyResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** The output from the tool execution */
+    output: string;
+    /** Error message if the operation failed */
+    error?: string;
+}
+/**
+ * Options for idempotency store operations
+ */
+export interface IdempotencyOptions {
+    /** Time-to-live in milliseconds (default: 1 hour) */
+    ttl_ms?: number;
+    /** Session ID to scope the idempotency key */
+    session_id?: string;
+    /** Whether to force execution even if cached result exists */
+    force_execute?: boolean;
+}
+/**
+ * Result of checking idempotency
+ */
+export interface IdempotencyCheckResult {
+    /** Whether a cached result was found */
+    found: boolean;
+    /** The cached record if found */
+    record?: IdempotencyRecord;
+    /** The generated idempotency key */
+    key: string;
+}
+/**
+ * Configuration for the idempotency store
+ */
+export interface IdempotencyStoreConfig {
+    /** Directory to store idempotency records */
+    store_dir: string;
+    /** Default TTL in milliseconds */
+    default_ttl_ms: number;
+    /** Maximum number of records to keep */
+    max_records: number;
+    /** Interval for cleanup in milliseconds */
+    cleanup_interval_ms: number;
+}
+/**
+ * Tools that should be idempotent (state-changing operations)
+ */
+export declare const IDEMPOTENT_TOOLS: readonly ["write", "search_replace", "delete_file", "run_terminal_cmd"];
+export type IdempotentTool = (typeof IDEMPOTENT_TOOLS)[number];
+/**
+ * Check if a tool should be idempotent
+ */
+export declare function isIdempotentTool(toolName: string): toolName is IdempotentTool;
+//# sourceMappingURL=idempotency.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.types.d.ts","sourceRoot":"","sources":["../../src/types/idempotency.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,mBAAmB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,yEAA0E,CAAC;AAExG,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,cAAc,CAE7E"}

package/dist/types/idempotency.types.js

@@ -0,0 +1,16 @@
+/**
+ * Idempotency Types
+ *
+ * Type definitions for idempotency support in tool execution.
+ */
+/**
+ * Tools that should be idempotent (state-changing operations)
+ */
+export const IDEMPOTENT_TOOLS = ['write', 'search_replace', 'delete_file', 'run_terminal_cmd'];
+/**
+ * Check if a tool should be idempotent
+ */
+export function isIdempotentTool(toolName) {
+    return IDEMPOTENT_TOOLS.includes(toolName);
+}
+//# sourceMappingURL=idempotency.types.js.map

package/dist/types/idempotency.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.types.js","sourceRoot":"","sources":["../../src/types/idempotency.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,CAAU,CAAC;AAIxG;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAChD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,QAA0B,CAAC,CAAC;AAC9D,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Central exports for all types
+ */
+export * from './agent.types.js';
+export * from './cli.types.js';
+export * from './command.types.js';
+export * from './common.types.js';
+export * from './config.types.js';
+export * from './diagnostics.types.js';
+export * from './document.types.js';
+export * from './error.types.js';
+export * from './escalation.types.js';
+export * from './exploration.types.js';
+export * from './hook.types.js';
+export * from './llm.types.js';
+export * from './logger.types.js';
+export * from './mcp-client.types.js';
+export * from './mcp.types.js';
+export * from './prompt.types.js';
+export * from './provider-names.types.js';
+export * from './provider.types.js';
+export * from './session.types.js';
+export * from './ui.types.js';
+export * from './workflow.types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,25 @@
+/**
+ * Central exports for all types
+ */
+export * from './agent.types.js';
+export * from './cli.types.js';
+export * from './command.types.js';
+export * from './common.types.js';
+export * from './config.types.js';
+export * from './diagnostics.types.js';
+export * from './document.types.js';
+export * from './error.types.js';
+export * from './escalation.types.js';
+export * from './exploration.types.js';
+export * from './hook.types.js';
+export * from './llm.types.js';
+export * from './logger.types.js';
+export * from './mcp-client.types.js';
+export * from './mcp.types.js';
+export * from './prompt.types.js';
+export * from './provider-names.types.js';
+export * from './provider.types.js';
+export * from './session.types.js';
+export * from './ui.types.js';
+export * from './workflow.types.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dist/types/llm.types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * LLM Provider type definitions
+ */
+import type { GuidedMode } from './provider.types.js';
+export interface LLMCompletionOptions {
+    max_tokens?: number;
+    messages: LLMMessage[];
+    mode?: string;
+    model?: string;
+    stop?: string[];
+    stream?: boolean;
+    temperature?: number;
+    tools?: LLMToolDefinition[];
+    top_p?: number;
+}
+export interface LLMCompletionResult {
+    content: string;
+    finish_reason?: string;
+    role: LLMRole;
+    tool_calls?: LLMToolCall[];
+    usage?: LLMUsage;
+    guidedCompletion?: {
+        context: Record<string, unknown>;
+        expectedOutputSchema?: Record<string, unknown>;
+        instruction: string;
+        mode: GuidedMode;
+        systemPrompt: string;
+        userPrompt: string;
+    };
+}
+export interface LLMMessage {
+    content: string;
+    name?: string;
+    role: LLMRole;
+    /**
+     * Tool calls made by the assistant (only for role='assistant')
+     * Required by Anthropic API when sending tool_result messages back
+     */
+    tool_calls?: LLMToolCall[];
+}
+export interface LLMProvider {
+    complete(options: LLMCompletionOptions): Promise<LLMCompletionResult>;
+    getAlternativeModels(currentModel?: string): string[];
+    isConfigured(): boolean;
+    name: string;
+    streamComplete(options: LLMCompletionOptions, onChunk: (chunk: string) => void): Promise<LLMCompletionResult>;
+    validateModel(modelName: string): Promise<boolean>;
+}
+export type LLMRole = 'assistant' | 'system' | 'tool' | 'user';
+export interface LLMToolCall {
+    arguments: Record<string, unknown>;
+    id: string;
+    name: string;
+}
+export interface LLMToolDefinition {
+    description: string;
+    name: string;
+    parameters: Record<string, unknown>;
+}
+export interface LLMToolResult {
+    output: string;
+    tool_call_id: string;
+}
+export interface LLMUsage {
+    completion_tokens: number;
+    prompt_tokens: number;
+    total_tokens: number;
+}
+export interface ProviderFactory {
+    createProvider(providerName: string, config: Record<string, unknown>): LLMProvider;
+    getAvailableProviders(): string[];
+}
+//# sourceMappingURL=llm.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.d.ts","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB,gBAAgB,CAAC,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,UAAU,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC;CACF;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtE,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtD,YAAY,IAAI,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9G,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;IACnF,qBAAqB,IAAI,MAAM,EAAE,CAAC;CAClC"}

package/dist/types/llm.types.js

@@ -0,0 +1,5 @@
+/**
+ * LLM Provider type definitions
+ */
+export {};
+//# sourceMappingURL=llm.types.js.map

package/dist/types/llm.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.js","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/logger.types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Logger-related type definitions
+ *
+ * These types are extracted from the logger implementation to prevent
+ * circular dependencies. Types layer must remain independent of
+ * implementation layers.
+ */
+import type { LogLevel } from './common.types.js';
+export type { LogLevel };
+/**
+ * Structured log entry
+ */
+export interface LogEntry {
+    data?: Record<string, unknown>;
+    error?: Error;
+    level: LogLevel;
+    message: string;
+    requestId?: string;
+    timestamp: string;
+}
+//# sourceMappingURL=logger.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.types.d.ts","sourceRoot":"","sources":["../../src/types/logger.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/logger.types.js

@@ -0,0 +1,9 @@
+/**
+ * Logger-related type definitions
+ *
+ * These types are extracted from the logger implementation to prevent
+ * circular dependencies. Types layer must remain independent of
+ * implementation layers.
+ */
+export {};
+//# sourceMappingURL=logger.types.js.map

package/dist/types/logger.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.types.js","sourceRoot":"","sources":["../../src/types/logger.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types/mcp-client.types.d.ts

@@ -0,0 +1,232 @@
+/**
+ * External MCP Client Type Definitions
+ *
+ * Types for connecting to external MCP servers (Playwright, Fetch, etc.)
+ * with user approval workflows.
+ */
+/**
+ * Connection types for external MCP servers
+ */
+export type MCPConnectionType = 'sse' | 'stdio' | 'websocket';
+/**
+ * Risk levels for security assessment
+ */
+export type MCPRiskLevel = 'critical' | 'high' | 'low' | 'medium';
+/**
+ * Approval memory options
+ */
+export type MCPApprovalMemory = 'always_ask' | 'persistent' | 'session';
+/**
+ * Capability types that an MCP server can have
+ */
+export type MCPCapability = 'browser_automation' | 'code_execution' | 'database_access' | 'file_system' | 'network_requests' | 'process_spawn' | 'screen_capture' | 'system_access';
+/**
+ * Connection configuration for an external MCP server
+ */
+export interface MCPConnectionConfig {
+    /** Arguments for the command (for stdio type) */
+    args?: string[];
+    /** Command to execute (for stdio type) */
+    command?: string;
+    /** Environment variables to set */
+    env?: Record<string, string>;
+    /** Headers for connection (for sse/websocket types) */
+    headers?: Record<string, string>;
+    /** Connection type */
+    type: MCPConnectionType;
+    /** URL for connection (for sse/websocket types) */
+    url?: string;
+    /** Working directory for the command */
+    workingDirectory?: string;
+}
+/**
+ * Security configuration for an external MCP server
+ */
+export interface MCPSecurityConfig {
+    /** Whether audit logging is enabled */
+    audit_logging: boolean;
+    /** Capabilities this server has */
+    capabilities: MCPCapability[];
+    /** Maximum execution time in milliseconds */
+    max_execution_ms?: number;
+    /** Risk level assessment */
+    risk_level: MCPRiskLevel;
+    /** Allowed tool names (if empty, all tools allowed) */
+    tool_allowlist?: string[];
+    /** Blocked tool names */
+    tool_blocklist?: string[];
+}
+/**
+ * Configuration for an external MCP server
+ */
+export interface ExternalMCPServerConfig {
+    /** Connection configuration */
+    connection: MCPConnectionConfig;
+    /** Server description */
+    description: string;
+    /** Whether this server is enabled */
+    enabled?: boolean;
+    /** Unique server identifier */
+    id: string;
+    /** Human-readable server name */
+    name: string;
+    /** How long to remember approval decisions */
+    remember_approval: MCPApprovalMemory;
+    /** Whether approval is required before connecting */
+    requires_approval: boolean;
+    /** Security configuration */
+    security: MCPSecurityConfig;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Version of the server configuration */
+    version?: string;
+}
+/**
+ * Registry of available external MCP servers
+ */
+export interface ExternalMCPRegistry {
+    /** Registry schema version */
+    schema_version: string;
+    /** Available servers */
+    servers: ExternalMCPServerConfig[];
+}
+/**
+ * Request for accessing an external MCP server
+ */
+export interface MCPAccessRequest {
+    /** Reason for requesting access */
+    reason: string;
+    /** ID of the server being requested */
+    serverId: string;
+    /** Name of the agent/stage requesting access */
+    requestedBy: string;
+    /** Specific tools being requested (empty means all available) */
+    requestedTools?: string[];
+    /** Timestamp of the request */
+    timestamp: Date;
+}
+/**
+ * Result of an MCP approval decision
+ */
+export interface MCPApprovalResult {
+    /** List of tools allowed (if filtered) */
+    allowedTools?: string[];
+    /** Whether the connection was approved */
+    approved: boolean;
+    /** User's decision type */
+    decision: 'approve' | 'configure' | 'deny' | 'session';
+    /** Additional notes from user */
+    notes?: string;
+    /** Whether to remember this decision */
+    remember: boolean;
+    /** Timestamp of the decision */
+    timestamp: Date;
+}
+/**
+ * Cached approval entry
+ */
+export interface MCPApprovalCacheEntry {
+    /** List of allowed tools */
+    allowedTools?: string[];
+    /** Whether approved */
+    approved: boolean;
+    /** When the approval expires */
+    expiresAt?: Date;
+    /** Server ID */
+    serverId: string;
+    /** When the approval was granted */
+    timestamp: Date;
+}
+/**
+ * External MCP requirement for commands
+ */
+export interface ExternalMCPRequirement {
+    /** Whether this MCP is optional (command can proceed without it) */
+    optional?: boolean;
+    /** Reason for requiring this MCP */
+    reason: string;
+    /** Required tools from this MCP */
+    requiredTools?: string[];
+    /** Server ID from the registry */
+    serverId: string;
+}
+/**
+ * Tool definition from an external MCP server
+ */
+export interface ExternalMCPTool {
+    /** Tool description */
+    description: string;
+    /** Input schema (JSON Schema) */
+    inputSchema: Record<string, unknown>;
+    /** Tool name */
+    name: string;
+    /** Server ID this tool belongs to */
+    serverId: string;
+}
+/**
+ * Connected MCP server instance
+ */
+export interface ConnectedMCPServer {
+    /** Available tools from this server */
+    availableTools: ExternalMCPTool[];
+    /** When the connection was established */
+    connectedAt: Date;
+    /** Server configuration */
+    config: ExternalMCPServerConfig;
+    /** Whether currently connected */
+    isConnected: boolean;
+    /** Server ID */
+    serverId: string;
+}
+/**
+ * Audit log entry for MCP operations
+ */
+export interface MCPAuditLogEntry {
+    /** Additional details */
+    details?: Record<string, unknown>;
+    /** Duration in milliseconds (for tool calls) */
+    duration_ms?: number;
+    /** Error message if operation failed */
+    error?: string;
+    /** Type of operation */
+    operation: 'approval' | 'connect' | 'disconnect' | 'error' | 'tool_call';
+    /** Server ID */
+    serverId: string;
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Timestamp of the operation */
+    timestamp: Date;
+    /** Tool name (for tool_call operations) */
+    toolName?: string;
+}
+/**
+ * Tool call request to an external MCP
+ */
+export interface ExternalMCPToolCallRequest {
+    /** Tool arguments */
+    args: Record<string, unknown>;
+    /** Request ID for tracking */
+    requestId: string;
+    /** Server ID */
+    serverId: string;
+    /** Timeout in milliseconds */
+    timeout_ms?: number;
+    /** Tool name */
+    toolName: string;
+}
+/**
+ * Tool call result from an external MCP
+ */
+export interface ExternalMCPToolCallResult {
+    /** Result content */
+    content: unknown;
+    /** Duration in milliseconds */
+    duration_ms: number;
+    /** Error if failed */
+    error?: string;
+    /** Request ID */
+    requestId: string;
+    /** Whether the call succeeded */
+    success: boolean;
+}
+//# sourceMappingURL=mcp-client.types.d.ts.map

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

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

package/dist/types/mcp-client.types.js

@@ -0,0 +1,8 @@
+/**
+ * External MCP Client Type Definitions
+ *
+ * Types for connecting to external MCP servers (Playwright, Fetch, etc.)
+ * with user approval workflows.
+ */
+export {};
+//# sourceMappingURL=mcp-client.types.js.map

package/dist/types/mcp-client.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.types.js","sourceRoot":"","sources":["../../src/types/mcp-client.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/mcp-registry.types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * MCP Registry Types
+ *
+ * Types derived from the external-mcp.json registry file.
+ * This ensures the MCPTool type stays in sync with the registry.
+ */
+/**
+ * Known MCP server IDs from the registry
+ * When adding a new MCP server, add its ID here and to external-mcp.json
+ */
+export type MCPServerId = 'browserstack' | 'chrome-devtools' | 'context7' | 'deep-research' | 'elastic' | 'figma' | 'firebase' | 'gcloud' | 'github' | 'grafana' | 'mongodb' | 'playwright' | 'serena' | 'storybook' | 'terraform';
+/**
+ * Convert hyphenated server ID to underscore format for tool names
+ * e.g., "chrome-devtools" -> "chrome_devtools"
+ */
+type HyphenToUnderscore<S extends string> = S extends `${infer L}-${infer R}` ? `${L}_${HyphenToUnderscore<R>}` : S;
+/**
+ * MCP Tool type derived from registry server IDs
+ * Format: mcp_<server-id-with-underscores>
+ * e.g., "mcp_playwright" | "mcp_chrome_devtools" | ...
+ */
+export type MCPTool = `mcp_${HyphenToUnderscore<MCPServerId>}`;
+/**
+ * All server IDs from the registry (runtime values)
+ */
+export declare const MCP_SERVER_IDS: MCPServerId[];
+/**
+ * Map of server ID to MCP tool name
+ */
+export declare const SERVER_ID_TO_TOOL: Record<MCPServerId, MCPTool>;
+/**
+ * Map of MCP tool name to server ID
+ */
+export declare const TOOL_TO_SERVER_ID: Record<MCPTool, MCPServerId>;
+/**
+ * Check if a string is a valid MCP tool name
+ */
+export declare function isValidMCPTool(tool: string): tool is MCPTool;
+/**
+ * Get server ID from MCP tool name
+ * Returns undefined if not a valid MCP tool
+ */
+export declare function getServerIdFromTool(tool: string): MCPServerId | undefined;
+/**
+ * Get MCP tool name from server ID
+ */
+export declare function getToolFromServerId(serverId: MCPServerId): MCPTool;
+export {};
+//# sourceMappingURL=mcp-registry.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.types.d.ts","sourceRoot":"","sources":["../../src/types/mcp-registry.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8CH;;;GAGG;AACH,MAAM,MAAM,WAAW,GACpB,cAAc,GACd,iBAAiB,GACjB,UAAU,GACV,eAAe,GACf,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;AAEf;;;GAGG;AACH,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAEpH;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,EAEvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAE1B,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,CAK1B,CAAC;AAElC;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,OAAO,CAE5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAIzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAElE"}