agent-world 0.11.1 → 0.12.0

package/dist/core/index.js

@@ -0,0 +1,70 @@
+/**
+ * Core Module - Curated Public API
+ *
+ * Features:
+ * - Essential world/agent/chat management functions for client applications
+ * - Event-driven messaging with clean subscription interface
+ * - Category-based logging system
+ * - Core types and utility functions
+ *
+ * Architecture:
+ * - Public API limited to client-facing functionality (~25 exports vs previous 60+)
+ * - Internal implementation details kept private
+ * - Clear separation between public and private interfaces
+ * - Tests can import from internal modules directly
+ *
+ * Public API Categories:
+ * - World Management: createWorld, getWorld, updateWorld, deleteWorld, listWorlds, getWorldConfig, exportWorldToMarkdown
+ * - Agent Management: getAgent, updateAgent, deleteAgent, listAgents, clearAgentMemory
+ * - Chat Management: createChatData, getChatData, restoreWorldChat
+ * - Event System: publishMessage, enableStreaming, disableStreaming
+ * - Core Types: World, Agent, AgentMessage, WorldChat, ChatData, WorldInfo, LLMProvider, LoggerConfig, LogLevel
+ * - Utilities: logger, createCategoryLogger, loggers, generateId, toKebabCase
+ * - Subscription System: subscribeWorld, ClientConnection (for server API)
+ *
+ * Private APIs (not exported):
+ * - Internal agent functions: createAgent (via world instance), updateAgentMemory, loadAgentsIntoWorld, syncWorldAgents, etc.
+ * - Internal chat functions: createChat, getChat, createWorldChat
+ * - Internal event functions: subscribeAgentToMessages, processAgentMessage, SSE functions
+ * - Parameter types: CreateAgentParams, UpdateAgentParams, etc.
+ * - Storage implementation: StorageAPI, storage factory functions
+ * - Internal utilities: initializeLogger, getCategoryLogLevel
+ *
+ * Recent Changes:
+ * - 2026-02-14: Exported generic HITL option request/response APIs for world-scoped user approval flows.
+ * - 2026-02-14: Exported `waitForInitialSkillSync` to allow callers to await startup skill-registry auto-sync completion.
+ * - 2026-02-13: Exported chat-scoped stop-message processing controls for Electron IPC stop action.
+ * - 2026-02-08: Exported LLM provider configuration helpers for npm core library consumers
+ *
+ * Version: 3.1.0
+ */
+// === WORLD MANAGEMENT ===
+export { createWorld, getWorld, updateWorld, setWorldVariablesText, getWorldVariablesText, getWorldEnvMap, getWorldEnvValue, deleteWorld, listWorlds, getMemory, migrateMessageIds, removeMessagesFrom, editUserMessage, logEditError, getEditErrors } from './managers.js';
+export { exportWorldToMarkdown, exportChatToMarkdown, } from './export.js';
+// === AGENT MANAGEMENT ===
+export { createAgent, getAgent, updateAgent, deleteAgent, listAgents, clearAgentMemory, } from './managers.js';
+// === MCP MANAGEMENT ===
+export { clearToolsCache } from './mcp-server-registry.js';
+export { skillRegistry, syncSkills, waitForInitialSkillSync, getSkills, getSkillsForSystemPrompt, getSkill, getSkillSourceScope, clearSkillsForTests, } from './skill-registry.js';
+export { requestWorldOption, submitWorldOptionResponse, clearHitlStateForTests, } from './hitl.js';
+// === SHELL COMMAND TOOL ===
+export { executeShellCommand, getExecutionHistory, clearExecutionHistory, stopShellCommandsForChat, getProcessExecution, listProcessExecutions, cancelProcessExecution, deleteProcessExecution, subscribeProcessExecutionStatus, clearProcessExecutionStateForTests } from './shell-cmd-tool.js';
+export { stopMessageProcessing } from './message-processing-control.js';
+// === CHAT MANAGEMENT ===
+export { newChat, branchChatFromMessage, listChats, updateChat, deleteChat, restoreChat } from './managers.js';
+// === EVENT SYSTEM ===
+export { enableStreaming, disableStreaming, publishMessage, publishMessageWithId, } from './events/index.js';
+export { beginWorldActivity, trackWorldActivity, } from './activity-tracker.js';
+// LLM Provider enum (needed for agent configuration)
+export { LLMProvider, EventType } from './types.js';
+// === LLM PROVIDER CONFIGURATION ===
+export { configureLLMProvider, validateProviderConfig, isProviderConfigured, getConfiguredProviders, clearAllConfiguration, getConfigurationStatus, } from './llm-config.js';
+// === LOGGER ===
+export { logger, createCategoryLogger, loggers, addLogStreamCallback } from './logger.js';
+// === SUBSCRIPTION SYSTEM ===
+export { subscribeWorld } from './subscription.js';
+export { getDefaultRootPath } from './storage/storage-factory.js';
+// === MIGRATION SYSTEM (for advanced usage) ===
+export { runMigrations, getMigrationStatus, needsMigration } from './storage/migration-runner.js';
+export const VERSION = '0.5.0';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,2BAA2B;AAC3B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,yBAAyB;AACzB,OAAO,EACL,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,aAAa,EACb,UAAU,EACV,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EACxB,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,GAMpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,GAIvB,MAAM,WAAW,CAAC;AAEnB,6BAA6B;AAC7B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,+BAA+B,EAC/B,kCAAkC,EAEnC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EAEtB,MAAM,iCAAiC,CAAC;AAEzC,0BAA0B;AAC1B,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,uBAAuB;AACvB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAGnB,MAAM,uBAAuB,CAAC;AAE/B,qDAAqD;AACrD,OAAO,EAA+F,WAAW,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AAEnK,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,GAWvB,MAAM,iBAAiB,CAAC;AAEzB,iBAAiB;AACjB,OAAO,EAAoC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE5H,8BAA8B;AAC9B,OAAO,EAAyB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,gDAAgD;AAChD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,cAAc,EAGf,MAAM,+BAA+B,CAAC;AAEvC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/core/llm-config.d.ts

@@ -0,0 +1,128 @@
+/**
+ * LLM Configuration Module - Browser-Safe Provider Configuration Management
+ *
+ * Features:
+ * - Browser-safe configuration storage for all LLM providers
+ * - Type-safe configuration interfaces for each provider
+ * - Configuration injection and validation functions
+ * - Clear error messages for missing configuration
+ * - Zero Node.js dependencies for browser compatibility
+ *
+ * Provider Configuration Support:
+ * - OpenAI: API key configuration
+ * - Anthropic: API key configuration
+ * - Google: API key configuration
+ * - Azure: API key, resource name, and deployment configuration (API version optional)
+ * - XAI: API key configuration
+ * - OpenAI-Compatible: API key and base URL configuration
+ * - Ollama: Base URL configuration
+ *
+ * Usage:
+ * - configureLLMProvider: Set configuration for a specific provider
+ * - getLLMProviderConfig: Get configuration for a specific provider
+ * - validateProviderConfig: Validate that required configuration is present
+ * - clearAllConfiguration: Clear all provider configurations (for testing)
+ *
+ * Implementation Details:
+ * - Global configuration store with provider-specific sections
+ * - Type-safe interfaces prevent configuration errors
+ * - Validation functions ensure required settings are present
+ * - No external dependencies for maximum browser compatibility
+ * - Clear error messages guide users to correct configuration issues
+ *
+ * Recent Changes:
+ * - Initial implementation with all provider configuration interfaces
+ * - Added configuration injection and validation functions
+ * - Implemented browser-safe global configuration store
+ * - Added comprehensive error handling and validation
+ */
+import { LLMProvider } from './types.js';
+/**
+ * Provider-specific configuration interfaces - Enhanced with TypeScript Utility Types
+ */
+/**
+ * Base configuration interface for all providers
+ */
+export interface BaseLLMConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    endpoint?: string;
+    deployment?: string;
+    apiVersion?: string;
+}
+/**
+ * OpenAI configuration - requires only API key
+ */
+export type OpenAIConfig = Required<Pick<BaseLLMConfig, 'apiKey'>>;
+/**
+ * Anthropic configuration - requires only API key
+ */
+export type AnthropicConfig = Required<Pick<BaseLLMConfig, 'apiKey'>>;
+/**
+ * Google configuration - requires only API key
+ */
+export type GoogleConfig = Required<Pick<BaseLLMConfig, 'apiKey'>>;
+/**
+ * Azure configuration - requires API key, resource name, and deployment; optionally API version
+ */
+export type AzureConfig = Required<Pick<BaseLLMConfig, 'apiKey' | 'deployment'>> & {
+    resourceName: string;
+    apiVersion?: string;
+};
+/**
+ * XAI configuration - requires only API key
+ */
+export type XAIConfig = Required<Pick<BaseLLMConfig, 'apiKey'>>;
+/**
+ * OpenAI-Compatible configuration - requires API key and base URL
+ */
+export type OpenAICompatibleConfig = Required<Pick<BaseLLMConfig, 'apiKey' | 'baseUrl'>>;
+/**
+ * Ollama configuration - requires only base URL
+ */
+export type OllamaConfig = Required<Pick<BaseLLMConfig, 'baseUrl'>>;
+/**
+ * Provider configuration mapping for type-safe access
+ */
+export type ProviderConfigMap = {
+    [LLMProvider.OPENAI]: OpenAIConfig;
+    [LLMProvider.ANTHROPIC]: AnthropicConfig;
+    [LLMProvider.GOOGLE]: GoogleConfig;
+    [LLMProvider.AZURE]: AzureConfig;
+    [LLMProvider.XAI]: XAIConfig;
+    [LLMProvider.OPENAI_COMPATIBLE]: OpenAICompatibleConfig;
+    [LLMProvider.OLLAMA]: OllamaConfig;
+};
+/**
+ * Union type for all provider configurations
+ */
+export type ProviderConfig = ProviderConfigMap[keyof ProviderConfigMap];
+/**
+ * Configure a specific LLM provider with type-safe configuration
+ */
+export declare function configureLLMProvider<T extends LLMProvider>(provider: T, config: ProviderConfigMap[T]): void;
+/**
+ * Get configuration for a specific provider
+ */
+export declare function getLLMProviderConfig<T extends LLMProvider>(provider: T): ProviderConfigMap[T];
+/**
+ * Validate provider configuration
+ */
+export declare function validateProviderConfig(provider: LLMProvider, config: any): void;
+/**
+ * Check if a provider is configured
+ */
+export declare function isProviderConfigured(provider: LLMProvider): boolean;
+/**
+ * Get list of all configured providers
+ */
+export declare function getConfiguredProviders(): LLMProvider[];
+/**
+ * Clear all provider configurations (useful for testing)
+ */
+export declare function clearAllConfiguration(): void;
+/**
+ * Get configuration status for debugging
+ */
+export declare function getConfigurationStatus(): Record<LLMProvider, boolean>;
+//# sourceMappingURL=llm-config.d.ts.map

package/dist/core/llm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-config.d.ts","sourceRoot":"","sources":["../../core/llm-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC,GAAG;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IACnC,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACzC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IACnC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IACjC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;IAC7B,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IACxD,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,iBAAiB,CAAC,CAAC;AA8BxE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,WAAW,EACxD,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC3B,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,WAAW,EACxD,QAAQ,EAAE,CAAC,GACV,iBAAiB,CAAC,CAAC,CAAC,CAYtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAwD/E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAUrE"}

package/dist/core/llm-config.js

@@ -0,0 +1,164 @@
+/**
+ * LLM Configuration Module - Browser-Safe Provider Configuration Management
+ *
+ * Features:
+ * - Browser-safe configuration storage for all LLM providers
+ * - Type-safe configuration interfaces for each provider
+ * - Configuration injection and validation functions
+ * - Clear error messages for missing configuration
+ * - Zero Node.js dependencies for browser compatibility
+ *
+ * Provider Configuration Support:
+ * - OpenAI: API key configuration
+ * - Anthropic: API key configuration
+ * - Google: API key configuration
+ * - Azure: API key, resource name, and deployment configuration (API version optional)
+ * - XAI: API key configuration
+ * - OpenAI-Compatible: API key and base URL configuration
+ * - Ollama: Base URL configuration
+ *
+ * Usage:
+ * - configureLLMProvider: Set configuration for a specific provider
+ * - getLLMProviderConfig: Get configuration for a specific provider
+ * - validateProviderConfig: Validate that required configuration is present
+ * - clearAllConfiguration: Clear all provider configurations (for testing)
+ *
+ * Implementation Details:
+ * - Global configuration store with provider-specific sections
+ * - Type-safe interfaces prevent configuration errors
+ * - Validation functions ensure required settings are present
+ * - No external dependencies for maximum browser compatibility
+ * - Clear error messages guide users to correct configuration issues
+ *
+ * Recent Changes:
+ * - Initial implementation with all provider configuration interfaces
+ * - Added configuration injection and validation functions
+ * - Implemented browser-safe global configuration store
+ * - Added comprehensive error handling and validation
+ */
+import { LLMProvider } from './types.js';
+/**
+ * Global configuration store instance
+ */
+let providerConfigs = {};
+/**
+ * Initialize default configuration - configure Ollama with default URL if no providers configured
+ */
+function initializeDefaultConfiguration() {
+    // Only initialize if no providers are configured yet
+    if (Object.keys(providerConfigs).length === 0) {
+        // Configure Ollama with default URL as fallback (OpenAI-compatible endpoint)
+        configureLLMProvider(LLMProvider.OLLAMA, {
+            baseUrl: 'http://localhost:11434/v1'
+        });
+    }
+}
+// Initialize default configuration on module load
+initializeDefaultConfiguration();
+/**
+ * Configure a specific LLM provider with type-safe configuration
+ */
+export function configureLLMProvider(provider, config) {
+    // Validate configuration before storing
+    validateProviderConfig(provider, config);
+    // Store configuration
+    providerConfigs[provider] = config;
+}
+/**
+ * Get configuration for a specific provider
+ */
+export function getLLMProviderConfig(provider) {
+    const config = providerConfigs[provider];
+    if (!config) {
+        throw new Error(`No configuration found for ${provider} provider. ` +
+            `Please ensure the provider is configured before making LLM calls. ` +
+            `Configuration should be set via configureLLMProvider() function.`);
+    }
+    return config;
+}
+/**
+ * Validate provider configuration
+ */
+export function validateProviderConfig(provider, config) {
+    switch (provider) {
+        case LLMProvider.OPENAI:
+            if (!config.apiKey || typeof config.apiKey !== 'string') {
+                throw new Error('OpenAI provider requires apiKey (string)');
+            }
+            break;
+        case LLMProvider.ANTHROPIC:
+            if (!config.apiKey || typeof config.apiKey !== 'string') {
+                throw new Error('Anthropic provider requires apiKey (string)');
+            }
+            break;
+        case LLMProvider.GOOGLE:
+            if (!config.apiKey || typeof config.apiKey !== 'string') {
+                throw new Error('Google provider requires apiKey (string)');
+            }
+            break;
+        case LLMProvider.AZURE:
+            if (!config.apiKey || typeof config.apiKey !== 'string') {
+                throw new Error('Azure provider requires apiKey (string)');
+            }
+            if (!config.resourceName || typeof config.resourceName !== 'string') {
+                throw new Error('Azure provider requires resourceName (string)');
+            }
+            if (!config.deployment || typeof config.deployment !== 'string') {
+                throw new Error('Azure provider requires deployment (string)');
+            }
+            break;
+        case LLMProvider.XAI:
+            if (!config.apiKey || typeof config.apiKey !== 'string') {
+                throw new Error('XAI provider requires apiKey (string)');
+            }
+            break;
+        case LLMProvider.OPENAI_COMPATIBLE:
+            if (!config.apiKey || typeof config.apiKey !== 'string') {
+                throw new Error('OpenAI-Compatible provider requires apiKey (string)');
+            }
+            if (!config.baseUrl || typeof config.baseUrl !== 'string') {
+                throw new Error('OpenAI-Compatible provider requires baseUrl (string)');
+            }
+            break;
+        case LLMProvider.OLLAMA:
+            if (!config.baseUrl || typeof config.baseUrl !== 'string') {
+                throw new Error('Ollama provider requires baseUrl (string)');
+            }
+            break;
+        default:
+            throw new Error(`Unsupported provider: ${provider}`);
+    }
+}
+/**
+ * Check if a provider is configured
+ */
+export function isProviderConfigured(provider) {
+    return !!providerConfigs[provider];
+}
+/**
+ * Get list of all configured providers
+ */
+export function getConfiguredProviders() {
+    return Object.keys(providerConfigs);
+}
+/**
+ * Clear all provider configurations (useful for testing)
+ */
+export function clearAllConfiguration() {
+    providerConfigs = {};
+}
+/**
+ * Get configuration status for debugging
+ */
+export function getConfigurationStatus() {
+    return {
+        [LLMProvider.OPENAI]: isProviderConfigured(LLMProvider.OPENAI),
+        [LLMProvider.ANTHROPIC]: isProviderConfigured(LLMProvider.ANTHROPIC),
+        [LLMProvider.GOOGLE]: isProviderConfigured(LLMProvider.GOOGLE),
+        [LLMProvider.AZURE]: isProviderConfigured(LLMProvider.AZURE),
+        [LLMProvider.XAI]: isProviderConfigured(LLMProvider.XAI),
+        [LLMProvider.OPENAI_COMPATIBLE]: isProviderConfigured(LLMProvider.OPENAI_COMPATIBLE),
+        [LLMProvider.OLLAMA]: isProviderConfigured(LLMProvider.OLLAMA),
+    };
+}
+//# sourceMappingURL=llm-config.js.map

package/dist/core/llm-config.js.map

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

package/dist/core/llm-manager.d.ts

@@ -0,0 +1,163 @@
+/**
+ * LLM Manager Module - Pure Orchestration Layer (LLM Provider Refactoring Phase 5)
+ *
+ * Features:
+ * - Browser-safe LLM integration using direct provider SDKs (OpenAI, Anthropic, Google)
+ * - Streaming responses with SSE events via World.eventEmitter specifically
+ * - Support for all major LLM providers (OpenAI, Anthropic, Google, Azure, XAI, OpenAI-Compatible, Ollama)
+ * - Agent activity tracking and token usage monitoring with automatic state persistence
+ * - Error handling with SSE error events via world's eventEmitter and timeout management
+ * - World-aware event publishing using world.eventEmitter for proper event isolation
+ * - Conversation history support with message preparation and context management
+ * - Global LLM call queue to ensure serialized execution (one LLM call at a time)
+ * - Configuration injection from external sources (CLI/server) for browser compatibility
+ * - Automatic MCP tool integration for worlds with mcpConfig
+ * - All providers return LLMResponse with unified structure
+ * - Granular function-based logging for detailed debugging control
+ *
+ * Core Functions:
+ * - streamAgentResponse: Streaming LLM calls with SSE events via world.eventEmitter (queued)
+ * - generateAgentResponse: Non-streaming LLM calls with automatic state management (queued)
+ * - loadLLMProvider: Provider loading logic using injected configuration
+ * - getLLMQueueStatus: Monitor queue status for debugging and administration
+ * - clearLLMQueue: Emergency queue clearing for administrative purposes
+ *
+ * Provider Support:
+ * - OpenAI: Direct OpenAI package integration (bypasses AI SDK bug)
+ * - Azure: Direct OpenAI package integration with Azure endpoints (bypasses AI SDK bug)
+ * - OpenAI-Compatible: Direct OpenAI package integration (bypasses AI SDK bug)
+ * - XAI: Direct OpenAI package integration with XAI endpoints (bypasses AI SDK bug)
+ * - Ollama: Direct OpenAI package integration with OpenAI-compatible endpoint (better function calling)
+ * - Anthropic: Direct Anthropic SDK integration (improved tool calling support)
+ * - Google: Direct Google Generative AI SDK integration (improved tool calling support)
+ *
+ * Granular Logging Categories:
+ * - llm.queue: Queue operations (add, process, complete, errors)
+ * - llm.streaming: Streaming response operations (start, chunks, finish, errors)
+ * - llm.generation: Non-streaming response operations (start, finish, errors)
+ * - llm.provider: Provider loading, configuration, and validation
+ * - llm.mcp: Comprehensive MCP tool integration and execution tracking
+ * - llm.util: Utility functions and helper operations
+ *
+ * Environment Variable Control:
+ * - LOG_LLM_QUEUE=debug: Enable queue operation debugging
+ * - LOG_LLM_STREAMING=debug: Enable streaming operation debugging
+ * - LOG_LLM_GENERATION=debug: Enable generation operation debugging
+ * - LOG_LLM_PROVIDER=debug: Enable provider operation debugging
+ * - LOG_LLM_MCP=debug: Enable comprehensive MCP tool debugging (consolidates all MCP logging)
+ * - LOG_LLM_UTIL=debug: Enable utility function debugging
+ *
+ * MCP Tool Logging Features (LOG_LLM_MCP=debug):
+ * - Tool call sequence tracking with unique sequence IDs
+ * - Tool execution performance metrics (duration in milliseconds)
+ * - Tool result content analysis (size, type, preview)
+ * - Tool call success/failure status with detailed error information
+ * - Tool call dependencies and parent-child relationships
+ * - Tool argument validation and presence checking
+ * - Streaming vs non-streaming execution path differentiation
+ * - Complete tool call lifecycle from start to completion
+ * - Server-side tool execution via direct MCP server registry calls
+ * - AI SDK tool conversion execution tracking
+ * - Tool result processing and content type identification
+ *
+ * LLM Queue Implementation:
+ * - Global singleton queue prevents concurrent LLM calls across all agents and worlds
+ * - FIFO (First In, First Out) processing ensures fair agent response ordering
+ * - Maximum queue size of 100 items prevents memory overflow issues
+ * - 15-minute timeout per LLM call supports long-running tool executions (configurable)
+ * - Warning logs at 50% timeout threshold for debugging long-running operations
+ * - Queue status monitoring available for debugging and performance analysis
+ * - Emergency clear function allows administrative queue reset when needed
+ * - Proper error handling with promise rejection for failed calls
+ * - Automatic queue processing with safety measures for edge cases
+ * - Timeout cleanup on promise resolution prevents resource leaks and Jest hanging
+ * - Configurable timeout via setProcessingTimeout() for different use cases
+ *
+ * Browser Safety Implementation:
+ * - Zero process.env dependencies for browser compatibility
+ * - Configuration injection via llm-config module
+ * - All provider settings supplied externally by CLI/server components
+ * - Type-safe configuration interfaces prevent runtime errors
+ * - Clear error messages when configuration is missing
+ *
+ * Implementation Details:
+ * - Uses direct OpenAI package for OpenAI providers to avoid AI SDK schema corruption bug
+ * - Uses direct Anthropic SDK for Anthropic provider to fix tool calling issues
+ * - Uses direct Google Generative AI SDK for Google provider to fix tool calling issues
+ * - Publishes SSE events via world.eventEmitter.emit('sse', event) for proper isolation
+ * - Updates agent activity metrics and LLM call counts automatically
+ * - Zero dependencies on Node.js environment variables or legacy event systems
+ * - Complete provider support with externally injected configuration
+ * - All events scoped to specific world instance preventing cross-world interference
+ * - Full LLM provider support with configuration validation and error handling
+ * - Timeout handling with configurable limits and proper error recovery
+ * - Queue-based serialization prevents API rate limits and resource conflicts
+ *
+ * Recent Changes:
+ * - 2026-02-13: Reclassified stop-triggered aborts as cancellation/info logs (not errors) in queue and non-streaming paths.
+ * - 2026-02-13: Added merged external+queue abort-signal support so chat stop requests can cancel follow-up continuation calls.
+ * - 2026-02-13: Added chat-scoped LLM cancellation controls so Electron stop requests can abort active and queued calls by `worldId` + `chatId`.
+ * - 2026-02-08: Removed stale manual tool-intervention terminology from internal comments
+ * - 2025-11-09: Phase 5 - Updated to expect LLMResponse from all providers
+ * - Removed old manual tool decision return type handling
+ * - All providers now return unified LLMResponse interface with type discriminator
+ * - Updated logging to handle LLMResponse structure (type, content, tool_calls)
+ * - Providers are now pure clients - no tool execution, only API calls
+ * - NO type checking for string vs object - always LLMResponse
+ * - Tool orchestration will be handled by events.ts (Phase 6)
+ * - Simplified tool usage guidance: minimal system prompt patch for tool availability
+ * - Increased LLM queue timeout from 2 minutes to 15 minutes for long-running tool executions
+ * - Replaced AI SDK with direct OpenAI, Anthropic, and Google integrations
+ * - Implemented granular function-based logging for detailed debugging control
+ * - Tool-specific guidance moved to individual tool descriptions (proper separation)
+ */
+import { World, Agent, AgentMessage, LLMProvider, WorldSSEEvent, LLMResponse } from './types.js';
+/**
+ * LLM configuration interface
+ */
+export interface LLMConfig {
+    provider: LLMProvider;
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    temperature?: number;
+    maxTokens?: number;
+    ollamaBaseUrl?: string;
+}
+/**
+ * Streaming agent response with SSE events via world's eventEmitter (queued)
+ */
+export declare function streamAgentResponse(world: World, agent: Agent, messages: AgentMessage[], publishSSE: (world: World, data: Partial<WorldSSEEvent>) => void, chatId?: string | null, abortSignal?: AbortSignal): Promise<{
+    response: LLMResponse;
+    messageId: string;
+}>;
+/**
+ * Non-streaming LLM call (queued)
+ */
+export declare function generateAgentResponse(world: World, agent: Agent, messages: AgentMessage[], _publishSSE?: (world: World, data: Partial<WorldSSEEvent>) => void, skipTools?: boolean, chatId?: string | null, abortSignal?: AbortSignal): Promise<{
+    response: LLMResponse;
+    messageId: string;
+}>;
+/**
+ * Get current LLM queue status for monitoring and debugging
+ */
+export declare function getLLMQueueStatus(): {
+    queueLength: number;
+    processing: boolean;
+    nextAgent?: string;
+    nextWorld?: string;
+    maxQueueSize: number;
+};
+/**
+ * Emergency function to clear the LLM queue (for debugging/admin use)
+ * Returns the number of items that were cleared
+ */
+export declare function clearLLMQueue(): number;
+/**
+ * Cancel active and pending LLM calls for a specific world/chat session.
+ */
+export declare function cancelLLMCallsForChat(worldId: string, chatId: string | null): {
+    canceledPending: number;
+    abortedActive: number;
+};
+//# sourceMappingURL=llm-manager.d.ts.map

package/dist/core/llm-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-manager.d.ts","sourceRoot":"","sources":["../../core/llm-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgHG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAe,WAAW,EAAE,MAAM,YAAY,CAAC;AA8S9G;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA8CD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EAAE,EACxB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,EAChE,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBvD;AAmJD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EAAE,EACxB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,EAClE,SAAS,CAAC,EAAE,OAAO,EACnB,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBvD;AA2JD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAEA;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAEpD"}