@robota-sdk/agent-core 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/hooks/hook-runner.js

@@ -0,0 +1,95 @@
+/**
+ * Hook runner — executes shell command hooks for lifecycle events.
+ *
+ * Hooks receive JSON input on stdin and communicate results via exit codes:
+ * - 0: allow/proceed
+ * - 2: block/deny (stderr contains reason)
+ * - other: proceed (logged as warning)
+ */
+import { spawn } from 'node:child_process';
+const HOOK_TIMEOUT_MS = 10_000;
+/** Execute a single shell command with JSON input on stdin. */
+function runCommand(command, input) {
+    return new Promise((resolve) => {
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let settled = false;
+        const child = spawn('sh', ['-c', command], {
+            cwd: process.cwd(),
+            env: { ...process.env },
+        });
+        child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+        // Write input to stdin
+        child.stdin.write(input);
+        child.stdin.end();
+        const timer = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                child.kill('SIGTERM');
+                resolve({ exitCode: 1, stdout: '', stderr: 'Hook timed out' });
+            }
+        }, HOOK_TIMEOUT_MS);
+        child.on('close', (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({
+                exitCode: code ?? 1,
+                stdout: Buffer.concat(stdoutChunks).toString('utf8'),
+                stderr: Buffer.concat(stderrChunks).toString('utf8'),
+            });
+        });
+        child.on('error', (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ exitCode: 1, stdout: '', stderr: err.message });
+        });
+    });
+}
+/** Check if a tool name matches a hook group's matcher pattern. */
+function matchesGroup(group, toolName) {
+    // Empty matcher = match everything
+    if (!group.matcher)
+        return true;
+    if (!toolName)
+        return false;
+    try {
+        return new RegExp(group.matcher).test(toolName);
+    }
+    catch {
+        return group.matcher === toolName;
+    }
+}
+/**
+ * Run all hooks for a given event.
+ *
+ * For PreToolUse: if any hook returns exit code 2, the tool call is blocked.
+ * Returns { blocked: true, reason: string } if blocked, { blocked: false } otherwise.
+ */
+export async function runHooks(config, event, input) {
+    if (!config)
+        return { blocked: false };
+    const groups = config[event];
+    if (!groups || groups.length === 0)
+        return { blocked: false };
+    const inputJson = JSON.stringify(input);
+    for (const group of groups) {
+        if (!matchesGroup(group, input.tool_name))
+            continue;
+        for (const hook of group.hooks) {
+            if (hook.type !== 'command')
+                continue;
+            const result = await runCommand(hook.command, inputJson);
+            // Exit code 2 = block/deny
+            if (result.exitCode === 2) {
+                return { blocked: true, reason: result.stderr || 'Blocked by hook' };
+            }
+        }
+    }
+    return { blocked: false };
+}
+//# sourceMappingURL=hook-runner.js.map

package/dist/hooks/hook-runner.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { runHooks } from './hook-runner.js';
+export type { THookEvent, THooksConfig, IHookGroup, IHookDefinition, IHookInput, IHookResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,3 @@
+// Hooks module
+export { runHooks } from './hook-runner.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Hook system types — Claude Code compatible event/hook model.
+ */
+/** Hook lifecycle events */
+export type THookEvent = 'PreToolUse' | 'PostToolUse' | 'SessionStart' | 'Stop' | 'PreCompact' | 'PostCompact';
+/** A single hook definition */
+export interface IHookDefinition {
+    /** Shell command to execute */
+    type: 'command';
+    command: string;
+}
+/** A hook group — matcher + array of hook definitions */
+export interface IHookGroup {
+    /** Regex pattern to match tool name (empty string = match all) */
+    matcher: string;
+    hooks: IHookDefinition[];
+}
+/** Complete hooks configuration: event → array of hook groups */
+export type THooksConfig = Partial<Record<THookEvent, IHookGroup[]>>;
+/** Input passed to hook commands via stdin */
+export interface IHookInput {
+    session_id: string;
+    cwd: string;
+    hook_event_name: THookEvent;
+    tool_name?: string;
+    tool_input?: Record<string, string | number | boolean | object>;
+    tool_output?: string;
+    /** Compaction trigger source (PreCompact/PostCompact only) */
+    trigger?: 'auto' | 'manual';
+    /** Compaction summary text (PostCompact only) */
+    compact_summary?: string;
+}
+/** Hook execution result */
+export interface IHookResult {
+    /** 0 = allow/proceed, 2 = block/deny, other = proceed with warning */
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,aAAa,GACb,cAAc,GACd,MAAM,GACN,YAAY,GACZ,aAAa,CAAC;AAElB,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AAErE,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,UAAU,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/hooks/types.js

@@ -0,0 +1,5 @@
+/**
+ * Hook system types — Claude Code compatible event/hook model.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

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

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * 🎯 Centralized node type management: domain-neutral workflow node type system
  *
- * The `@robota-sdk/agents` package provides a complete AI agent framework with support for
+ * The `@robota-sdk/agent-core` package provides a complete AI agent framework with support for
  * multiple AI providers, tool calling, plugin systems, and streaming responses. This package
  * provides a modern, modular architecture for building powerful AI applications.
  *
@@ -20,8 +20,8 @@
  * ## Quick Start
  *
  * ```typescript
- * import { Robota } from '@robota-sdk/agents';
- * import { OpenAIProvider } from '@robota-sdk/openai';
+ * import { Robota } from '@robota-sdk/agent-core';
+ * import { OpenAIProvider } from '@robota-sdk/agent-provider-openai';
  *
  * const robota = new Robota({
  *   name: 'MyAgent',
@@ -85,14 +85,15 @@ export * from './utils';
  *
  * @public
  */
-export type { IToolSchema, IProviderOptions, IChatOptions, IAIProvider } from './interfaces/provider';
+export type { IToolSchema, IProviderOptions, IChatOptions, TTextDeltaCallback, IAIProvider, IMediaOutputRef, IProviderMediaError, TProviderMediaResult, IInlineImageInputSource, IUriImageInputSource, TImageInputSource, IImageGenerationRequest, IImageEditRequest, IImageComposeRequest, IImageGenerationResult, IImageGenerationProvider, IVideoGenerationRequest, IVideoJobAccepted, IVideoJobSnapshot, IVideoGenerationProvider, } from './interfaces';
+export { isImageGenerationProvider, isVideoGenerationProvider } from './interfaces/media-provider';
 /**
  * Message type definitions for conversation management.
  * Supports all message types including tool calls and responses.
  *
  * @public
  */
-export type { IToolCall, IUserMessage, ISystemMessage, IToolMessage, } from './interfaces/agent';
+export type { IToolCall, IUserMessage, ISystemMessage, IToolMessage } from './interfaces/agent';
 /**
  * Tool contract types used across tools and integrations.
  *
@@ -105,13 +106,13 @@ export type { TToolParameters, IToolResult, IToolExecutionContext } from './inte
  *
  * @public
  */
-export type { TUniversalMessage, IAssistantMessage, TUniversalMessageMetadata } from './interfaces/messages';
+export type { TUniversalMessage, IAssistantMessage, TUniversalMessageMetadata, ITextMessagePart, IInlineImageMessagePart, IUriImageMessagePart, TUniversalMessagePart, } from './interfaces/messages';
 /**
  * Type guards for the canonical TUniversalMessage union.
  *
  * @public
  */
-export { isUserMessage, isAssistantMessage, isSystemMessage, isToolMessage } from './interfaces/messages';
+export { isUserMessage, isAssistantMessage, isSystemMessage, isToolMessage, } from './interfaces/messages';
 /**
  * Provider request/response types (raw provider boundary).
  *
@@ -139,47 +140,25 @@ export type { IExecutor, IChatExecutionRequest, IStreamExecutionRequest, ILocalE
  *
  * @public
  */
-export { logger, SilentLogger, type ILogger } from './utils/logger';
+export { logger, SilentLogger, createLogger, type ILogger } from './utils/logger';
 /**
- * Core plugins providing essential functionality through lifecycle hooks.
- * These plugins can be combined to create powerful, extensible agent behaviors.
- *
- * ## Available Plugins:
- * - **ConversationHistoryPlugin**: Persistent conversation storage
- * - **LoggingPlugin**: Configurable logging with multiple strategies
- * - **UsagePlugin**: Token usage and cost tracking
- * - **PerformancePlugin**: Performance metrics and monitoring
- * - **ExecutionPlugin**: Execution analytics and insights
- * - **ErrorHandlingPlugin**: Error recovery and retry logic
- * - **LimitsPlugin**: Rate limiting and resource control
- * - **EventEmitterPlugin**: Event-driven plugin communication
- * - **WebhookPlugin**: External system notifications
+ * EventEmitterPlugin and related types.
+ * The plugin implementation for event-driven communication between plugins.
  *
- * @public
- */
-export * from './plugins/conversation-history';
-export * from './plugins/logging';
-export * from './plugins/usage';
-export * from './plugins/performance';
-export * from './plugins/execution';
-export { ErrorHandlingPlugin, TErrorHandlingStrategy, IErrorHandlingPluginOptions } from './plugins/error-handling/index';
-/**
- * Additional specialized plugins for advanced use cases.
+ * NOTE: ConversationHistoryPlugin, LoggingPlugin, UsagePlugin, PerformancePlugin,
+ * ExecutionAnalyticsPlugin, ErrorHandlingPlugin, LimitsPlugin, WebhookPlugin have been
+ * moved to their own packages (@robota-sdk/plugin-*).
  *
  * @public
  */
-export { LimitsPlugin } from './plugins/limits-plugin';
-export type { TLimitsStrategy, ILimitsPluginOptions } from './plugins/limits-plugin';
-export { EventEmitterPlugin, TEventName, IEventEmitterEventData, TEventEmitterListener, IEventEmitterPluginOptions, IEventEmitterHierarchicalEventData } from './plugins/event-emitter-plugin';
-export { WebhookPlugin } from './plugins/webhook';
-export type { TWebhookEventName, IWebhookPayload, IWebhookEndpoint, IWebhookPluginOptions } from './plugins/webhook';
+export { EventEmitterPlugin, type TEventName, type IEventEmitterEventData, type TEventEmitterListener, type IEventEmitterPluginOptions, type IEventEmitterHierarchicalEventData, } from './plugins/event-emitter-plugin';
 /**
  * The Robota agent class.
  * This is the primary entry point for creating AI agents.
  *
  * @example Basic Usage
  * ```typescript
- * import { Robota, type TAgentConfig } from '@robota-sdk/agents';
+ * import { Robota, type TAgentConfig } from '@robota-sdk/agent-core';
  *
  * const config: AgentConfig = {
  *   name: 'Assistant',
@@ -200,15 +179,15 @@ export { Robota } from './core/robota';
  * **Important**: Provider implementations are no longer re-exported to prevent circular dependencies.
  *
  * Import AI providers directly from their respective packages:
- * - `OpenAIProvider` from `@robota-sdk/openai`
- * - `AnthropicProvider` from `@robota-sdk/anthropic`
- * - `GoogleProvider` from `@robota-sdk/google`
+ * - `OpenAIProvider` from `@robota-sdk/agent-provider-openai`
+ * - `AnthropicProvider` from `@robota-sdk/agent-provider-anthropic`
+ * - `GoogleProvider` from `@robota-sdk/agent-provider-google`
  *
  * @example
  * ```typescript
- * import { OpenAIProvider } from '@robota-sdk/openai';
- * import { AnthropicProvider } from '@robota-sdk/anthropic';
- * import { GoogleProvider } from '@robota-sdk/google';
+ * import { OpenAIProvider } from '@robota-sdk/agent-provider-openai';
+ * import { AnthropicProvider } from '@robota-sdk/agent-provider-anthropic';
+ * import { GoogleProvider } from '@robota-sdk/agent-provider-google';
  * ```
  */
 /**
@@ -217,58 +196,53 @@ export { Robota } from './core/robota';
  *
  * @public
  */
-export { AgentFactory, type IAgentFactoryOptions, type IAgentCreationStats, type IAgentLifecycleEvents } from './managers/agent-factory';
+export { AgentFactory, type IAgentFactoryOptions, type IAgentCreationStats, type IAgentLifecycleEvents, } from './managers/agent-factory';
 export { AgentTemplates, type ITemplateApplicationResult } from './managers/agent-templates';
 export { ConversationHistory, ConversationSession } from './managers/conversation-history-manager';
 /**
- * Tool management and function calling infrastructure.
- * Provides schema-based validation and execution for AI tool calls.
+ * Core type definitions for agent configuration and templates.
+ * These types provide modern TypeScript support for agent creation.
  *
  * @public
  */
-export { ToolRegistry } from './tools/registry/tool-registry';
-export { FunctionTool, createFunctionTool, createZodFunctionTool } from './tools/implementations/function-tool';
+export type { IAgent, IAgentConfig, IAgentTemplate, IRunOptions } from './interfaces/agent';
 /**
- * Core type definitions for agent configuration and templates.
- * These types provide modern TypeScript support for agent creation.
+ * Event history module contracts (optional service).
  *
  * @public
  */
-export type { IAgent, IAgentConfig, IAgentTemplate, IRunOptions } from './interfaces/agent';
+export type { IEventHistoryModule, IEventHistoryRecord, IEventHistorySnapshot, } from './interfaces/history-module';
+export { EventHistoryModule } from './services/history-module';
+export { EVENT_EMITTER_EVENTS } from './plugins/event-emitter/types';
+export type { IEventEmitterPlugin, TExecutionEventName } from './plugins/event-emitter/types';
+export { InMemoryEventEmitterMetrics } from './plugins/event-emitter/metrics';
+export type { IEventEmitterMetrics, IEventEmitterMetricsSnapshot, } from './plugins/event-emitter/metrics';
+export { EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX } from './services/execution-service';
+export { TOOL_EVENTS, TOOL_EVENT_PREFIX } from './services/tool-execution-service';
+export { AGENT_EVENTS, AGENT_EVENT_PREFIX } from './agents/constants';
+export type { IWorkflowConverter, IWorkflowConversionOptions, IWorkflowConversionResult, IWorkflowData, IWorkflowConfig, IWorkflowMetadata, } from './interfaces/workflow-converter';
+export type { IWorkflowValidator, IValidationOptions, IValidationResult, IValidationIssue, ValidationSeverity, } from './interfaces/workflow-validator';
+export { ExecutionProxy, createExecutionProxy, withEventEmission } from './utils/execution-proxy';
 /**
- * Tool provider types for function calling integration.
- * Provides type safety for tool implementations and schema validation.
+ * Permission system — Claude Code compatible permission evaluation.
  *
  * @public
  */
-export type { IToolSchema as IFunctionSchema } from './interfaces/provider';
+export type { TPermissionMode, TTrustLevel, TPermissionDecision, TToolArgs, IPermissionLists, TKnownToolName, } from './permissions/index.js';
+export { TRUST_TO_MODE, evaluatePermission, MODE_POLICY, UNKNOWN_TOOL_FALLBACK, } from './permissions/index.js';
 /**
- * Event history module contracts (optional service).
+ * Context window tracking types — token usage and context state.
  *
  * @public
  */
-export type { IEventHistoryModule, IEventHistoryRecord, IEventHistorySnapshot } from './interfaces/history-module';
-export { EventHistoryModule } from './services/history-module';
+export type { IContextTokenUsage, IContextWindowState } from './context/index.js';
+export type { IModelDefinition } from './context/index.js';
+export { CLAUDE_MODELS, DEFAULT_CONTEXT_WINDOW, getModelContextWindow, getModelName, formatTokenCount } from './context/index.js';
 /**
- * EventService - Unified event emission system for Team/Agent/Tool integration.
- * Provides single event handler architecture for complete execution tracking.
+ * Hook system — Claude Code compatible lifecycle hooks.
  *
  * @public
  */
-export { IEventContext, IOwnerPathSegment, AbstractEventService, DEFAULT_ABSTRACT_EVENT_SERVICE, isDefaultEventService, bindEventServiceOwner, bindWithOwnerPath, DefaultEventService, StructuredEventService, ObservableEventService, composeEventName, } from './services/event-service';
-export type { IEventService, TEventListener } from './services/event-service';
-export type { IBaseEventData } from './services/event-service';
-export { RelayMcpTool, type IRelayMcpOptions, type IRelayMcpContext } from './tools/implementations/relay-mcp-tool';
-export { EVENT_EMITTER_EVENTS } from './plugins/event-emitter/types';
-export type { IEventEmitterPlugin } from './plugins/event-emitter/types';
-export { InMemoryEventEmitterMetrics } from './plugins/event-emitter/metrics';
-export type { IEventEmitterMetrics, IEventEmitterMetricsSnapshot } from './plugins/event-emitter/metrics';
-export { EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX } from './services/execution-service';
-export { TOOL_EVENTS, TOOL_EVENT_PREFIX } from './services/tool-execution-service';
-export { AGENT_EVENTS, AGENT_EVENT_PREFIX } from './agents/constants';
-export { TASK_EVENTS, TASK_EVENT_PREFIX } from './services/task-events';
-export { USER_EVENTS, USER_EVENT_PREFIX } from './services/user-events';
-export type { IWorkflowConverter, IWorkflowConversionOptions, IWorkflowConversionResult, IWorkflowData, IWorkflowConfig, IWorkflowMetadata } from './interfaces/workflow-converter';
-export type { IWorkflowValidator, IValidationOptions, IValidationResult, IValidationIssue, ValidationSeverity } from './interfaces/workflow-validator';
-export { ExecutionProxy, createExecutionProxy, withEventEmission } from './utils/execution-proxy';
+export type { THookEvent, THooksConfig, IHookGroup, IHookDefinition, IHookInput, IHookResult, } from './hooks/index.js';
+export { runHooks } from './hooks/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -3,7 +3,7 @@
  *
  * 🎯 Centralized node type management: domain-neutral workflow node type system
  *
- * The `@robota-sdk/agents` package provides a complete AI agent framework with support for
+ * The `@robota-sdk/agent-core` package provides a complete AI agent framework with support for
  * multiple AI providers, tool calling, plugin systems, and streaming responses. This package
  * provides a modern, modular architecture for building powerful AI applications.
  *
@@ -20,8 +20,8 @@
  * ## Quick Start
  *
  * ```typescript
- * import { Robota } from '@robota-sdk/agents';
- * import { OpenAIProvider } from '@robota-sdk/openai';
+ * import { Robota } from '@robota-sdk/agent-core';
+ * import { OpenAIProvider } from '@robota-sdk/agent-provider-openai';
  *
  * const robota = new Robota({
  *   name: 'MyAgent',
@@ -80,12 +80,13 @@ export * from './abstracts';
  * @public
  */
 export * from './utils';
+export { isImageGenerationProvider, isVideoGenerationProvider } from './interfaces/media-provider';
 /**
  * Type guards for the canonical TUniversalMessage union.
  *
  * @public
  */
-export { isUserMessage, isAssistantMessage, isSystemMessage, isToolMessage } from './interfaces/messages';
+export { isUserMessage, isAssistantMessage, isSystemMessage, isToolMessage, } from './interfaces/messages';
 /**
  * Abstract AI provider implementation that all AI providers must extend.
  * Provides common functionality for message conversion, error handling, and execution.
@@ -106,39 +107,19 @@ export { AbstractExecutor } from './abstracts/abstract-executor';
  *
  * @public
  */
-export { logger, SilentLogger } from './utils/logger';
+export { logger, SilentLogger, createLogger } from './utils/logger';
 // ===== PLUGIN SYSTEM EXPORTS =====
 /**
- * Core plugins providing essential functionality through lifecycle hooks.
- * These plugins can be combined to create powerful, extensible agent behaviors.
- *
- * ## Available Plugins:
- * - **ConversationHistoryPlugin**: Persistent conversation storage
- * - **LoggingPlugin**: Configurable logging with multiple strategies
- * - **UsagePlugin**: Token usage and cost tracking
- * - **PerformancePlugin**: Performance metrics and monitoring
- * - **ExecutionPlugin**: Execution analytics and insights
- * - **ErrorHandlingPlugin**: Error recovery and retry logic
- * - **LimitsPlugin**: Rate limiting and resource control
- * - **EventEmitterPlugin**: Event-driven plugin communication
- * - **WebhookPlugin**: External system notifications
+ * EventEmitterPlugin and related types.
+ * The plugin implementation for event-driven communication between plugins.
  *
- * @public
- */
-export * from './plugins/conversation-history';
-export * from './plugins/logging';
-export * from './plugins/usage';
-export * from './plugins/performance';
-export * from './plugins/execution';
-export { ErrorHandlingPlugin } from './plugins/error-handling/index';
-/**
- * Additional specialized plugins for advanced use cases.
+ * NOTE: ConversationHistoryPlugin, LoggingPlugin, UsagePlugin, PerformancePlugin,
+ * ExecutionAnalyticsPlugin, ErrorHandlingPlugin, LimitsPlugin, WebhookPlugin have been
+ * moved to their own packages (@robota-sdk/plugin-*).
  *
  * @public
  */
-export { LimitsPlugin } from './plugins/limits-plugin';
-export { EventEmitterPlugin } from './plugins/event-emitter-plugin';
-export { WebhookPlugin } from './plugins/webhook';
+export { EventEmitterPlugin, } from './plugins/event-emitter-plugin';
 // ===== CORE AGENT EXPORTS =====
 /**
  * The Robota agent class.
@@ -146,7 +127,7 @@ export { WebhookPlugin } from './plugins/webhook';
  *
  * @example Basic Usage
  * ```typescript
- * import { Robota, type TAgentConfig } from '@robota-sdk/agents';
+ * import { Robota, type TAgentConfig } from '@robota-sdk/agent-core';
  *
  * const config: AgentConfig = {
  *   name: 'Assistant',
@@ -168,15 +149,15 @@ export { Robota } from './core/robota';
  * **Important**: Provider implementations are no longer re-exported to prevent circular dependencies.
  *
  * Import AI providers directly from their respective packages:
- * - `OpenAIProvider` from `@robota-sdk/openai`
- * - `AnthropicProvider` from `@robota-sdk/anthropic`
- * - `GoogleProvider` from `@robota-sdk/google`
+ * - `OpenAIProvider` from `@robota-sdk/agent-provider-openai`
+ * - `AnthropicProvider` from `@robota-sdk/agent-provider-anthropic`
+ * - `GoogleProvider` from `@robota-sdk/agent-provider-google`
  *
  * @example
  * ```typescript
- * import { OpenAIProvider } from '@robota-sdk/openai';
- * import { AnthropicProvider } from '@robota-sdk/anthropic';
- * import { GoogleProvider } from '@robota-sdk/google';
+ * import { OpenAIProvider } from '@robota-sdk/agent-provider-openai';
+ * import { AnthropicProvider } from '@robota-sdk/agent-provider-anthropic';
+ * import { GoogleProvider } from '@robota-sdk/agent-provider-google';
  * ```
  */
 // ===== MANAGER EXPORTS =====
@@ -186,28 +167,11 @@ export { Robota } from './core/robota';
  *
  * @public
  */
-export { AgentFactory } from './managers/agent-factory';
+export { AgentFactory, } from './managers/agent-factory';
 export { AgentTemplates } from './managers/agent-templates';
 export { ConversationHistory, ConversationSession } from './managers/conversation-history-manager';
-// ===== TOOL SYSTEM EXPORTS =====
-/**
- * Tool management and function calling infrastructure.
- * Provides schema-based validation and execution for AI tool calls.
- *
- * @public
- */
-export { ToolRegistry } from './tools/registry/tool-registry';
-export { FunctionTool, createFunctionTool, createZodFunctionTool } from './tools/implementations/function-tool';
 export { EventHistoryModule } from './services/history-module';
-// ===== EVENT SERVICE EXPORTS =====
-/**
- * EventService - Unified event emission system for Team/Agent/Tool integration.
- * Provides single event handler architecture for complete execution tracking.
- *
- * @public
- */
-export { AbstractEventService, DEFAULT_ABSTRACT_EVENT_SERVICE, isDefaultEventService, bindEventServiceOwner, bindWithOwnerPath, DefaultEventService, StructuredEventService, ObservableEventService, composeEventName, } from './services/event-service';
-export { RelayMcpTool } from './tools/implementations/relay-mcp-tool';
+// NOTE: RelayMcpTool, IRelayMcpOptions, IRelayMcpContext moved to @robota-sdk/agent-tool-mcp
 // ===== EVENT EMITTER (PLUGIN) EXPORTS =====
 export { EVENT_EMITTER_EVENTS } from './plugins/event-emitter/types';
 export { InMemoryEventEmitterMetrics } from './plugins/event-emitter/metrics';
@@ -216,20 +180,11 @@ export { InMemoryEventEmitterMetrics } from './plugins/event-emitter/metrics';
 export { EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX } from './services/execution-service';
 export { TOOL_EVENTS, TOOL_EVENT_PREFIX } from './services/tool-execution-service';
 export { AGENT_EVENTS, AGENT_EVENT_PREFIX } from './agents/constants';
-export { TASK_EVENTS, TASK_EVENT_PREFIX } from './services/task-events';
-export { USER_EVENTS, USER_EVENT_PREFIX } from './services/user-events';
-// NOTE: Universal workflow conversion/validation/layout/visualization exports were removed from @robota-sdk/agents.
-// Ownership is @robota-sdk/workflow. Agents must not depend on workflow to avoid circular package dependencies.
+// NOTE: Universal workflow conversion/validation/layout/visualization exports were removed from @robota-sdk/agent-core.
+// Keep workflow concerns outside of the agents package to avoid cross-domain coupling.
 // EventServiceHookFactory removed - simplified architecture
 export { ExecutionProxy, createExecutionProxy, withEventEmission } from './utils/execution-proxy';
-// ExecutionHierarchyTracker removed
-// ================================
-// Real-Time System (Phase 3)
-// ================================
-// Real-Time React-Flow Generator - MOVED to apps/web/src/lib/workflow-visualization
-// These exports have been moved to maintain clean architecture separation
-// Real-Time Event Integration - MOVED to apps/web due to React-Flow dependencies
-// Performance Optimizer - MOVED to apps/web/src/lib/workflow-visualization
-// These exports have been moved to maintain clean architecture separation
-// Real-Time System Integration Test - MOVED to apps/web due to React-Flow dependencies
+export { TRUST_TO_MODE, evaluatePermission, MODE_POLICY, UNKNOWN_TOOL_FALLBACK, } from './permissions/index.js';
+export { CLAUDE_MODELS, DEFAULT_CONTEXT_WINDOW, getModelContextWindow, getModelName, formatTokenCount } from './context/index.js';
+export { runHooks } from './hooks/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,4CAA4C;AAC5C;;;;;GAKG;AACH,cAAc,cAAc,CAAC;AAE7B;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,cAAc,aAAa,CAAC;AAE5B;;;;;GAKG;AACH,cAAc,SAAS,CAAC;AAgCxB,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAiCnG;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAS/B;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAA4B,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAWjE;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAElF,oCAAoC;AACpC;;;;;;;;;GASG;AACH,OAAO,EACL,kBAAkB,GAMnB,MAAM,gCAAgC,CAAC;AAExC,iCAAiC;AACjC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,4CAA4C;AAC5C;;;;;;;;;;;;;;GAcG;AAEH,8BAA8B;AAC9B;;;;;GAKG;AACH,OAAO,EACL,YAAY,GAIb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAmC,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AA0BnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,6FAA6F;AAE7F,6CAA6C;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAM9E,8CAA8C;AAC9C,uFAAuF;AACvF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAuBtE,wHAAwH;AACxH,uFAAuF;AAEvF,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAgClG,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAUhC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAgBlI,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/interfaces/agent.d.ts

@@ -4,9 +4,9 @@ import type { IModule } from '../abstracts/abstract-module';
 import type { IToolWithEventService } from '../abstracts/abstract-tool';
 import type { TUtilLogLevel } from '../utils/logger';
 import type { TMetadata, TConfigValue } from './types';
-import type { IEventService } from '../services/event-service';
-import type { IOwnerPathSegment } from '../services/event-service';
+import type { IEventService, IOwnerPathSegment } from '../interfaces/event-service';
 import type { TUniversalMessageMetadata, TUniversalMessage } from './messages';
+import type { ICacheOptions } from './cache';
 export type { TUniversalMessage, TUniversalMessageMetadata, IBaseMessage, IUserMessage, IAssistantMessage, ISystemMessage, IToolMessage, IToolCall, TUniversalMessageRole, } from './messages';
 /**
  * IExecutionContextInjection
@@ -92,6 +92,7 @@ export interface IAgentConfig {
     };
     eventService?: IEventService;
     executionContext?: IExecutionContextInjection;
+    cache?: ICacheOptions;
 }
 /**
  * Agent template interface