agent-world 0.11.1 → 0.12.0

package/dist/core/openai-direct.js

@@ -0,0 +1,374 @@
+/**
+ * OpenAI Direct Integration Module - Pure Client (LLM Provider Refactoring Phase 2)
+ *
+ * Features:
+ * - Direct OpenAI API integration bypassing AI SDK schema corruption bug
+ * - Support for OpenAI, Azure OpenAI, and OpenAI-compatible providers
+ * - Streaming and non-streaming responses returning LLMResponse
+ * - Function/tool calling detection (NO execution)
+ * - Proper error handling and retry logic
+ * - Browser-safe configuration injection
+ * - Pure client: only calls APIs and returns structured data
+ *
+ * Provider Support:
+ * - OpenAI: Direct integration with OpenAI API
+ * - Azure OpenAI: Direct integration with Azure OpenAI endpoints
+ * - OpenAI-Compatible: Direct integration with custom OpenAI-compatible APIs
+ * - XAI: Direct integration using OpenAI package with custom base URL
+ * - Ollama: Direct integration using OpenAI package with Ollama's OpenAI-compatible endpoint
+ *
+ * Implementation Details:
+ * - Uses official OpenAI package for reliable API access
+ * - Converts AI SDK message format to OpenAI format
+ * - Returns LLMResponse with type='text' or type='tool_calls'
+ * - Streaming support with chunk-by-chunk processing via onChunk callback
+ * - Error handling with descriptive messages
+ * - Configuration injection from llm-config module
+ * - NO event emission, NO storage, NO tool execution
+ *
+ * Recent Changes:
+ * - 2026-02-16: Fixed streaming tool-call chunk merge to preserve delayed tool `id`/`name` fields across deltas.
+ * - 2026-02-13: Added abort-signal support for streaming and non-streaming calls to enable chat stop cancellation.
+ * - 2026-02-10: Added env-flagged Ollama tool attachment support via ENABLE_OLLAMA_TOOLS
+ * - 2026-02-07: Disabled tool definitions for Ollama provider requests
+ * - 2025-11-09: Phase 2 - Removed ALL tool execution logic (~200 lines)
+ * - Provider is now a pure client - only API calls and data transformation
+ * - Returns LLMResponse interface with type discriminator
+ * - Filters invalid tool calls (empty/missing names) and logs warnings
+ * - Includes usage tracking (prompt_tokens, completion_tokens) for non-streaming
+ * - 2025-11-08: Removed ALL event emission from provider (publishToolEvent, publishSSE)
+ * - Streaming uses onChunk callback instead of publishSSE
+ * - Initial implementation with full OpenAI package integration
+ */
+import OpenAI from 'openai';
+import { createCategoryLogger } from './logger.js';
+import { generateFallbackId } from './tool-utils.js';
+const logger = createCategoryLogger('openai');
+const mcpLogger = createCategoryLogger('mcp.execution');
+/**
+ * OpenAI client factory for standard OpenAI API
+ */
+export function createOpenAIClient(config) {
+    return new OpenAI({
+        apiKey: config.apiKey,
+    });
+}
+/**
+ * OpenAI client factory for Azure OpenAI
+ */
+export function createAzureOpenAIClient(config) {
+    const endpoint = `https://${config.resourceName}.openai.azure.com`;
+    const apiVersion = config.apiVersion || '2024-10-21-preview';
+    return new OpenAI({
+        apiKey: config.apiKey,
+        baseURL: `${endpoint}/openai/deployments/${config.deployment}`,
+        defaultQuery: { 'api-version': apiVersion },
+        defaultHeaders: {
+            'api-key': config.apiKey,
+        },
+    });
+}
+/**
+ * OpenAI client factory for OpenAI-compatible APIs
+ */
+export function createOpenAICompatibleClient(config) {
+    return new OpenAI({
+        apiKey: config.apiKey,
+        baseURL: config.baseUrl,
+    });
+}
+/**
+ * OpenAI client factory for XAI
+ */
+export function createXAIClient(config) {
+    return new OpenAI({
+        apiKey: config.apiKey,
+        baseURL: 'https://api.x.ai/v1',
+    });
+}
+/**
+ * OpenAI client factory for Ollama (OpenAI-compatible endpoint)
+ */
+export function createOllamaClient(config) {
+    return new OpenAI({
+        apiKey: 'ollama', // Required but unused for local Ollama
+        baseURL: config.baseUrl,
+    });
+}
+function convertMessagesToOpenAI(messages) {
+    return messages.map(message => {
+        switch (message.role) {
+            case 'system':
+                return {
+                    role: 'system',
+                    content: message.content,
+                };
+            case 'user':
+                return {
+                    role: 'user',
+                    content: message.content,
+                };
+            case 'assistant':
+                return {
+                    role: 'assistant',
+                    content: message.content,
+                    ...(message.tool_calls && { tool_calls: message.tool_calls }),
+                };
+            case 'tool':
+                return {
+                    role: 'tool',
+                    content: message.content,
+                    tool_call_id: message.tool_call_id,
+                };
+            default:
+                throw new Error(`Unsupported message role: ${message.role}`);
+        }
+    });
+}
+/**
+ * Convert MCP tools from AI SDK format to OpenAI format
+ */
+function convertMCPToolsToOpenAI(mcpTools) {
+    return Object.entries(mcpTools).map(([name, tool]) => ({
+        type: 'function',
+        function: {
+            name,
+            description: tool.description || '',
+            parameters: tool.parameters || {},
+        },
+    }));
+}
+function isTruthyEnvValue(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+}
+function shouldAttachTools(provider) {
+    if (provider !== 'ollama') {
+        return true;
+    }
+    // Ollama frequently behaves better without OpenAI-style tool definitions attached.
+    // Opt-in override: ENABLE_OLLAMA_TOOLS=true|1|yes|on
+    return isTruthyEnvValue(process.env.ENABLE_OLLAMA_TOOLS);
+}
+/**
+ * Streaming OpenAI response handler - Pure client (no tool execution)
+ * Returns LLMResponse with type='text' or type='tool_calls'
+ */
+export async function streamOpenAIResponse(client, model, messages, agent, mcpTools, world, onChunk, messageId, abortSignal) {
+    const openaiMessages = convertMessagesToOpenAI(messages);
+    const openaiTools = shouldAttachTools(agent.provider) && Object.keys(mcpTools).length > 0
+        ? convertMCPToolsToOpenAI(mcpTools)
+        : undefined;
+    const requestParams = {
+        model,
+        messages: openaiMessages,
+        stream: true,
+        temperature: agent.temperature,
+        max_completion_tokens: agent.maxTokens,
+        ...(openaiTools && { tools: openaiTools }),
+    };
+    logger.debug(`OpenAI Direct: Starting streaming request for agent=${agent.id}, model=${model}`, {
+        messageCount: messages.length,
+        hasTools: !!openaiTools,
+        toolCount: openaiTools?.length || 0,
+    });
+    const stream = await client.chat.completions.create(requestParams, abortSignal ? { signal: abortSignal } : undefined);
+    let fullResponse = '';
+    let functionCalls = [];
+    try {
+        for await (const chunk of stream) {
+            if (abortSignal?.aborted) {
+                throw new DOMException('OpenAI stream aborted', 'AbortError');
+            }
+            const delta = chunk.choices[0]?.delta;
+            if (delta?.content) {
+                fullResponse += delta.content;
+                onChunk(delta.content);
+            }
+            // Handle function calls
+            if (delta?.tool_calls) {
+                for (const toolCall of delta.tool_calls) {
+                    if (toolCall.index !== undefined) {
+                        if (!functionCalls[toolCall.index]) {
+                            functionCalls[toolCall.index] = {
+                                id: toolCall.id,
+                                type: 'function',
+                                function: { name: toolCall.function?.name || '', arguments: '' },
+                            };
+                        }
+                        if (!functionCalls[toolCall.index].id && toolCall.id) {
+                            functionCalls[toolCall.index].id = toolCall.id;
+                        }
+                        if (toolCall.function?.name
+                            && toolCall.function.name.trim() !== ''
+                            && !functionCalls[toolCall.index].function.name) {
+                            functionCalls[toolCall.index].function.name = toolCall.function.name;
+                        }
+                        if (toolCall.function?.arguments) {
+                            functionCalls[toolCall.index].function.arguments += toolCall.function.arguments;
+                        }
+                    }
+                }
+            }
+        }
+        // Return LLMResponse based on whether we have tool calls or text
+        if (functionCalls.length > 0) {
+            // Filter out invalid tool calls (empty or missing names)
+            const validCalls = functionCalls.filter(fc => fc.function?.name && fc.function.name.trim() !== '');
+            const invalidCalls = functionCalls.filter(fc => !fc.function?.name || fc.function.name.trim() === '');
+            if (invalidCalls.length > 0) {
+                logger.warn(`OpenAI Direct: Filtered ${invalidCalls.length} invalid tool calls (streaming)`, {
+                    agentId: agent.id,
+                    invalidCallIds: invalidCalls.map(fc => fc.id || 'no-id')
+                });
+            }
+            logger.debug(`OpenAI Direct: Completed streaming request with tool calls for agent=${agent.id}`, {
+                toolCount: validCalls.length,
+                toolNames: validCalls.map(fc => fc.function?.name)
+            });
+            const toolCallsFormatted = validCalls.map(fc => ({
+                id: fc.id || generateFallbackId(),
+                type: 'function',
+                function: {
+                    name: fc.function.name,
+                    arguments: fc.function.arguments || '{}',
+                },
+            }));
+            return {
+                type: 'tool_calls',
+                content: fullResponse,
+                tool_calls: toolCallsFormatted,
+                assistantMessage: {
+                    role: 'assistant',
+                    content: fullResponse || '',
+                    tool_calls: toolCallsFormatted,
+                },
+                usage: undefined, // OpenAI streaming doesn't provide usage in final chunk
+            };
+        }
+        logger.debug(`OpenAI Direct: Completed streaming request for agent=${agent.id}, responseLength=${fullResponse.length}`);
+        return {
+            type: 'text',
+            content: fullResponse,
+            assistantMessage: {
+                role: 'assistant',
+                content: fullResponse,
+            },
+            usage: undefined, // OpenAI streaming doesn't provide usage in final chunk
+        };
+    }
+    catch (error) {
+        logger.error(`OpenAI Direct: Streaming error for agent=${agent.id}:`, error);
+        throw error;
+    }
+}
+/**
+ * Non-streaming OpenAI response handler - Pure client (no tool execution)
+ * Returns LLMResponse with type='text' or type='tool_calls'
+ */
+export async function generateOpenAIResponse(client, model, messages, agent, mcpTools, world, abortSignal) {
+    const openaiMessages = convertMessagesToOpenAI(messages);
+    const openaiTools = shouldAttachTools(agent.provider) && Object.keys(mcpTools).length > 0
+        ? convertMCPToolsToOpenAI(mcpTools)
+        : undefined;
+    const requestParams = {
+        model,
+        messages: openaiMessages,
+        temperature: agent.temperature,
+        max_completion_tokens: agent.maxTokens,
+        ...(openaiTools && { tools: openaiTools }),
+    };
+    logger.debug(`OpenAI Direct: Starting non-streaming request for agent=${agent.id}, model=${model}`, {
+        messageCount: messages.length,
+        hasTools: !!openaiTools,
+        toolCount: openaiTools?.length || 0,
+    });
+    try {
+        const response = await client.chat.completions.create(requestParams, abortSignal ? { signal: abortSignal } : undefined);
+        const message = response.choices[0]?.message;
+        if (!message) {
+            throw new Error('No response message received from OpenAI');
+        }
+        let content = message.content || '';
+        // Return LLMResponse based on whether we have tool calls or text
+        if (message.tool_calls && message.tool_calls.length > 0) {
+            // Filter out invalid tool calls (empty or missing names)
+            const validToolCalls = message.tool_calls.filter(tc => tc.type === 'function' && tc.function?.name && tc.function.name.trim() !== '');
+            const invalidToolCalls = message.tool_calls.filter(tc => tc.type !== 'function' || !tc.function?.name || tc.function.name.trim() === '');
+            if (invalidToolCalls.length > 0) {
+                logger.warn(`OpenAI Direct: Filtered ${invalidToolCalls.length} invalid tool calls (non-streaming)`, {
+                    agentId: agent.id,
+                    invalidCallIds: invalidToolCalls.map(tc => tc.id || 'no-id')
+                });
+            }
+            logger.debug(`OpenAI Direct: Completed non-streaming request with tool calls for agent=${agent.id}`, {
+                toolCount: validToolCalls.length,
+                toolNames: validToolCalls.map(tc => tc.type === 'function' ? tc.function.name : 'unknown')
+            });
+            const toolCallsFormatted = validToolCalls.map(tc => {
+                const funcCall = tc;
+                return {
+                    id: tc.id || generateFallbackId(),
+                    type: 'function',
+                    function: {
+                        name: funcCall.function.name,
+                        arguments: funcCall.function.arguments || '{}',
+                    },
+                };
+            });
+            return {
+                type: 'tool_calls',
+                content: content,
+                tool_calls: toolCallsFormatted,
+                assistantMessage: {
+                    role: 'assistant',
+                    content: content,
+                    tool_calls: toolCallsFormatted,
+                },
+                usage: response.usage ? {
+                    inputTokens: response.usage.prompt_tokens,
+                    outputTokens: response.usage.completion_tokens,
+                } : undefined,
+            };
+        }
+        logger.debug(`OpenAI Direct: Completed non-streaming request for agent=${agent.id}, responseLength=${content.length}`);
+        return {
+            type: 'text',
+            content: content,
+            assistantMessage: {
+                role: 'assistant',
+                content: content,
+            },
+            usage: response.usage ? {
+                inputTokens: response.usage.prompt_tokens,
+                outputTokens: response.usage.completion_tokens,
+            } : undefined,
+        };
+    }
+    catch (error) {
+        logger.error(`OpenAI Direct: Generation error for agent=${agent.id}:`, error);
+        throw error;
+    }
+}
+/**
+ * Factory function to create appropriate OpenAI client based on provider type
+ */
+export function createClientForProvider(providerType, config) {
+    switch (providerType) {
+        case 'openai':
+            return createOpenAIClient(config);
+        case 'azure':
+            return createAzureOpenAIClient(config);
+        case 'openai-compatible':
+            return createOpenAICompatibleClient(config);
+        case 'xai':
+            return createXAIClient(config);
+        case 'ollama':
+            return createOllamaClient(config);
+        default:
+            throw new Error(`Unsupported OpenAI provider type: ${providerType}`);
+    }
+}
+//# sourceMappingURL=openai-direct.js.map

package/dist/core/openai-direct.js.map

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

package/dist/core/shell-cmd-tool.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Shell Command Tool Module - Built-in LLM tool for executing shell commands
+ *
+ * Features:
+ * - Execute shell commands in child processes with parameter support
+ * - Capture stdout and stderr output
+ * - Persist command execution history (command, parameters, results, exceptions)
+ * - Return results to LLM for further processing
+ * - Error handling and exception tracking
+ * - Long-running command support with 10-minute default timeout
+ * - Trusted working-directory enforcement from world/tool context
+ * - Explicit rejection when LLM-supplied directory conflicts with trusted working directory
+ * - Graceful error handling for invalid tool calls
+ * - Universal parameter validation for consistent execution
+ * - Explicit execution safety configuration using structured metadata
+ *
+ * Implementation Details:
+ * - Uses Node.js child_process.spawn for command execution
+ * - Executes commands through shell for PATH resolution and shell features
+ * - Stores execution history in-memory (can be extended to persistent storage)
+ * - Provides MCP-compatible tool interface for LLM integration
+ * - Timeout support to prevent hanging processes (default: 10 minutes)
+ * - Resource cleanup on process completion
+ * - Resolves command cwd from trusted world/tool context, not LLM args
+ * - Rejects directory mismatch instead of silently overriding requested path
+ * - Returns error results instead of throwing to prevent agent crashes
+ * - Uses universal validation framework for consistent parameter checking
+ *
+ * Recent Changes:
+ * - 2026-02-15: Moved core cwd-boundary enforcement into `executeShellCommand` via optional `trustedWorkingDirectory` execution option.
+ * - 2026-02-15: Added optional `output_format=json` for machine-readable command results.
+ * - 2026-02-15: Added optional `artifact_paths` support with SHA-256 hashing and byte-size metadata for files within trusted scope.
+ * - 2026-02-14: Default trusted cwd now falls back to shared core default working directory (user home by default) instead of `./` when world variable is unset.
+ * - 2026-02-14: Added inline-script execution guard (e.g. `sh -c`, `node -e`) to prevent embedded path bypass outside trusted cwd.
+ * - 2026-02-14: Hardened cwd containment checks by canonicalizing absolute paths and validating additional path argument forms (`./`, `../`, and `--flag=/path`).
+ * - 2026-02-13: Updated directory-request validation to allow requested folders inside world working_directory and reject only outside paths.
+ * - 2026-02-13: Added command/parameter path scope validation so shell_cmd rejects path targets outside trusted world working_directory.
+ * - 2026-02-13: Added strict directory-mismatch guard for shell_cmd; mismatched LLM directory requests now fail with explicit error.
+ * - 2026-02-13: Fixed validation error result typing by including `executionId` when formatting failed shell_cmd calls.
+ * - 2026-02-13: Stopped trusting LLM-provided `directory`; shell commands now resolve working directory from trusted world/tool context only.
+ * - 2026-02-13: Added explicit command-cancellation detection and AbortError propagation in tool execution to prevent post-stop continuation.
+ * - 2026-02-13: Added chat-scoped shell process tracking and stop controls for Electron stop-message support.
+ * - 2026-02-08: Added streaming callback support for real-time output
+ *   * Added onStdout and onStderr callbacks to executeShellCommand options
+ *   * Callbacks invoked in real-time as data arrives from child process
+ *   * Maintains backwards compatibility - callbacks are optional
+ *   * Full output still accumulated and returned in CommandExecutionResult
+ * - 2026-02-06: Removed legacy manual tool-decision metadata
+ * - 2025-11-11: CRITICAL FIX - Quote parameters for shell execution
+ *   * Parameters with spaces/tabs/newlines now properly quoted before spawn
+ *   * Prevents shell from splitting multi-word parameters
+ *   * Applied to both execution AND display formatting
+ * - 2025-11-10: Fixed shell execution - enabled shell: true to support PATH resolution and installed commands
+ * - Integrated universal parameter validation for consistent tool execution
+ * - Enhanced validation to check required parameters and auto-correct types
+ * - Replaced custom validation with standardized validation framework
+ * - Added graceful error handling for empty commands to prevent agent crashes
+ * - Changed validation to return error results instead of throwing exceptions
+ * - Updated tests to expect error results rather than thrown errors
+ * - Added LLM guidance to ask user for directory when not provided
+ * - Made directory parameter required for shell command execution
+ * - Increased default timeout from 30s to 10 minutes (600000ms) for long-running commands
+ * - Initial implementation for shell_cmd LLM tool
+ */
+import { type ShellProcessExecutionRecord, type ShellProcessStatusEvent, type ListShellProcessExecutionsOptions, type CancelShellProcessResult, type DeleteShellProcessResult } from './shell-process-registry.js';
+/**
+ * Command execution result
+ */
+export interface CommandExecutionResult {
+    executionId: string;
+    command: string;
+    parameters: string[];
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: string | null;
+    error?: string;
+    canceled?: boolean;
+    timedOut?: boolean;
+    executedAt: Date;
+    duration: number;
+}
+export interface CommandExecutionArtifact {
+    path: string;
+    sha256: string;
+    bytes: number;
+}
+export interface StructuredCommandExecutionResult {
+    exit_code: number | null;
+    stdout: string;
+    stderr: string;
+    timed_out: boolean;
+    duration_ms: number;
+    artifacts: CommandExecutionArtifact[];
+    stdout_truncated?: boolean;
+    stderr_truncated?: boolean;
+}
+interface OutputFormattingOptions {
+    detail?: 'minimal' | 'full';
+    maxOutputChars?: number;
+}
+export declare function resolveTrustedShellWorkingDirectory(context?: {
+    world?: {
+        variables?: string;
+    };
+    workingDirectory?: string;
+}): string;
+export declare function validateShellDirectoryRequest(requestedDirectory: unknown, trustedWorkingDirectory: string): {
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+};
+export declare function validateShellCommandScope(command: unknown, parameters: unknown, trustedWorkingDirectory: string): {
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+};
+export declare function stopShellCommandsForChat(worldId: string, chatId: string): {
+    killed: number;
+};
+export declare function isCommandExecutionCanceled(result: CommandExecutionResult): boolean;
+/**
+ * Execute a shell command with parameters and capture output
+ *
+ * @param command - The shell command to execute (e.g., 'ls', 'echo', 'cat')
+ * @param parameters - Array of parameters for the command (e.g., ['-la', '/tmp'])
+ * @param directory - Working directory for command execution (required)
+ * @param options - Execution options
+ * @returns Promise<CommandExecutionResult> - Execution result with output and metadata
+ */
+export declare function executeShellCommand(command: string, parameters: string[] | undefined, directory: string, options?: {
+    timeout?: number;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+    abortSignal?: AbortSignal;
+    worldId?: string;
+    chatId?: string;
+    onStatusChange?: (event: ShellProcessStatusEvent) => void;
+    trustedWorkingDirectory?: string;
+}): Promise<CommandExecutionResult>;
+export interface DeleteExecutionHistoryResult {
+    executionId: string;
+    outcome: DeleteShellProcessResult['outcome'];
+    removedHistoryEntries: number;
+}
+export declare function getProcessExecution(executionId: string): ShellProcessExecutionRecord | null;
+export declare function listProcessExecutions(options?: ListShellProcessExecutionsOptions): ShellProcessExecutionRecord[];
+export declare function cancelProcessExecution(executionId: string): CancelShellProcessResult;
+export declare function deleteProcessExecution(executionId: string): DeleteExecutionHistoryResult;
+export declare function subscribeProcessExecutionStatus(listener: (event: ShellProcessStatusEvent) => void): () => void;
+export declare function clearProcessExecutionStateForTests(): {
+    historyCleared: number;
+    registryExecutionCount: number;
+    registryActiveCount: number;
+};
+/**
+ * Get command execution history
+ *
+ * @param limit - Maximum number of results to return (default: 100)
+ * @returns Array of command execution results, most recent first
+ */
+export declare function getExecutionHistory(limit?: number): CommandExecutionResult[];
+/**
+ * Clear execution history
+ * Useful for testing or memory management
+ *
+ * @returns Number of entries cleared
+ */
+export declare function clearExecutionHistory(): number;
+export declare function formatStructuredResult(result: CommandExecutionResult, artifacts?: CommandExecutionArtifact[], options?: OutputFormattingOptions): StructuredCommandExecutionResult;
+/**
+ * Format command execution result for LLM consumption
+ * Provides a human-readable summary of the execution with improved markdown formatting
+ *
+ * @param result - Command execution result
+ * @returns Formatted markdown string suitable for LLM and display
+ */
+export declare function formatResultForLLM(result: CommandExecutionResult, options?: OutputFormattingOptions): string;
+/**
+ * Create MCP-compatible tool definition for shell_cmd
+ * This tool can be registered with the MCP system for LLM use
+ *
+ * @returns MCP tool definition object
+ */
+export declare function createShellCmdToolDefinition(): {
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            command: {
+                type: string;
+                description: string;
+            };
+            parameters: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            directory: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+            output_format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            output_detail: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            artifact_paths: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    execute: (args: any, sequenceId?: string, parentToolCall?: string, context?: any) => Promise<string>;
+};
+export {};
+//# sourceMappingURL=shell-cmd-tool.d.ts.map

package/dist/core/shell-cmd-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-cmd-tool.d.ts","sourceRoot":"","sources":["../../core/shell-cmd-tool.ts"],"names":[],"mappings":"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"}