@agenticc/core 1.0.0

package/dist/types/config.js

@@ -0,0 +1,120 @@
+/**
+ * Configuration Type Definitions
+ *
+ * Defines the configuration interfaces for the Agent, LLM providers,
+ * and other system components.
+ */
+/**
+ * All LLM task types as a constant array
+ */
+export const LLM_TASKS = [
+    'intent_parsing',
+    'knowledge_retrieval',
+    'tool_calling',
+    'response_generation',
+];
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    knowledge: {
+        embedding: {
+            model: 'text-embedding-ada-002',
+            dimension: 1536,
+        },
+        search: {
+            defaultTopK: 5,
+            minScore: 0.7,
+            defaultMethod: 'hybrid',
+        },
+    },
+    behavior: {
+        timeoutMs: 30000,
+        maxIterations: 10,
+        requireConfirmation: true,
+        confidenceThreshold: 0.8,
+    },
+};
+/**
+ * Validates an LLMProviderConfig
+ */
+export function validateLLMProviderConfig(config) {
+    const errors = [];
+    if (!config.provider) {
+        errors.push('LLM provider is required');
+    }
+    if (!config.apiKey) {
+        errors.push('API key is required');
+    }
+    if (!config.model) {
+        errors.push('Model is required');
+    }
+    if (config.temperature !== undefined && (config.temperature < 0 || config.temperature > 2)) {
+        errors.push('Temperature must be between 0 and 2');
+    }
+    if (config.maxTokens !== undefined && config.maxTokens < 1) {
+        errors.push('Max tokens must be at least 1');
+    }
+    return errors;
+}
+/**
+ * Validates an LLMConfig
+ */
+export function validateLLMConfig(config) {
+    const errors = [];
+    if (!config.mode) {
+        errors.push('LLM mode is required');
+    }
+    if (!config.default) {
+        errors.push('Default LLM configuration is required');
+    }
+    else {
+        errors.push(...validateLLMProviderConfig(config.default).map((e) => `default: ${e}`));
+    }
+    if (config.fallback) {
+        errors.push(...validateLLMProviderConfig(config.fallback).map((e) => `fallback: ${e}`));
+    }
+    if (config.mode === 'multi' && config.taskAssignment) {
+        for (const [task, taskConfig] of Object.entries(config.taskAssignment)) {
+            if (taskConfig) {
+                errors.push(...validateLLMProviderConfig(taskConfig).map((e) => `${task}: ${e}`));
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Validates a complete AgentConfig
+ */
+export function validateAgentConfig(config) {
+    const errors = [];
+    if (!config.llm) {
+        errors.push('LLM configuration is required');
+    }
+    else {
+        errors.push(...validateLLMConfig(config.llm).map((e) => `llm.${e}`));
+    }
+    // Database is now optional (deprecated)
+    if (config.database && !config.database.url) {
+        errors.push('Database URL is required if database config is provided');
+    }
+    return errors;
+}
+/**
+ * Gets the LLM configuration for a specific task
+ */
+export function getLLMConfigForTask(config, task) {
+    if (config.mode === 'single') {
+        return config.default;
+    }
+    // Multi-LLM mode: check task assignment
+    const taskConfig = config.taskAssignment?.[task === 'intent_parsing'
+        ? 'intentParsing'
+        : task === 'knowledge_retrieval'
+            ? 'knowledgeRetrieval'
+            : task === 'tool_calling'
+                ? 'toolCalling'
+                : 'responseGeneration'];
+    return taskConfig ?? config.default;
+}
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

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

package/dist/types/knowledge.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Knowledge System Type Definitions
+ *
+ * Defines the interfaces for the knowledge base and retrieval system.
+ */
+/**
+ * Document input for adding to knowledge base
+ */
+export interface DocumentInput {
+    /** Category for organizing documents */
+    category: string;
+    /** Optional title */
+    title?: string;
+    /** Document content */
+    content: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Stored document with ID and timestamps
+ */
+export interface Document {
+    /** Unique document ID */
+    id: string;
+    /** Category for organizing documents */
+    category: string;
+    /** Optional title */
+    title?: string;
+    /** Document content */
+    content: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+}
+/**
+ * Search options for knowledge retrieval
+ */
+export interface SearchOptions {
+    /** Filter by category */
+    category?: string;
+    /** Number of results to return */
+    topK?: number;
+    /** Search method */
+    method?: 'keyword' | 'semantic' | 'hybrid';
+    /** Minimum similarity score */
+    minScore?: number;
+}
+/**
+ * Search result with relevance score
+ */
+export interface SearchResult {
+    /** The matched document */
+    document: Document;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Confidence level */
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Knowledge assessment result
+ */
+export interface KnowledgeAssessment {
+    /** Whether knowledge is sufficient */
+    status: 'sufficient' | 'insufficient' | 'ambiguous';
+    /** Confidence in the assessment */
+    confidence: number;
+    /** Topic that's missing (if insufficient) */
+    missingTopic?: string;
+    /** Alternative interpretations (if ambiguous) */
+    alternatives?: Array<{
+        interpretation: string;
+        confidence: number;
+    }>;
+}
+/**
+ * Knowledge base interface
+ */
+export interface KnowledgeBase {
+    /** Add a document to the knowledge base */
+    addDocument(doc: DocumentInput): Promise<string>;
+    /** Get a document by ID */
+    getDocument(id: string): Promise<Document | null>;
+    /** Delete a document */
+    deleteDocument(id: string): Promise<boolean>;
+    /** Search the knowledge base */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /** List all categories */
+    listCategories(): Promise<string[]>;
+    /** Get documents by category */
+    getDocumentsByCategory(category: string): Promise<Document[]>;
+}
+//# sourceMappingURL=knowledge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/types/knowledge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC3C,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;IACpD,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,2BAA2B;IAC3B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAClD,wBAAwB;IACxB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,gCAAgC;IAChC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACxE,0BAA0B;IAC1B,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,gCAAgC;IAChC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC/D"}

package/dist/types/knowledge.js

@@ -0,0 +1,7 @@
+/**
+ * Knowledge System Type Definitions
+ *
+ * Defines the interfaces for the knowledge base and retrieval system.
+ */
+export {};
+//# sourceMappingURL=knowledge.js.map

package/dist/types/knowledge.js.map

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

package/dist/types/loop.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Agentic Loop Type Definitions
+ *
+ * Defines the interfaces for the Agent's agentic loop execution system.
+ * The agentic loop allows LLM to autonomously decide tool calls and iterate until task completion.
+ */
+import type { ToolResult } from './tool.js';
+import type { StreamEvent } from './streaming.js';
+/**
+ * Configuration for the agentic loop
+ */
+export interface LoopConfig {
+    /**
+     * Maximum number of iterations before forcing termination
+     * Default: 10
+     */
+    maxIterations: number;
+    /**
+     * Timeout for each iteration in milliseconds
+     * Default: 30000 (30 seconds)
+     */
+    iterationTimeout: number;
+    /**
+     * Whether to allow parallel tool calls when LLM requests multiple tools
+     * Default: true
+     */
+    parallelToolCalls: boolean;
+    /**
+     * Whether to continue on tool execution errors
+     * If true, error results are fed back to LLM for recovery
+     * Default: true
+     */
+    continueOnError: boolean;
+}
+/**
+ * Default loop configuration
+ */
+export declare const DEFAULT_LOOP_CONFIG: LoopConfig;
+/**
+ * Status of the agentic loop
+ */
+export type LoopStatus = 'running' | 'completed' | 'max_iterations' | 'timeout' | 'error' | 'cancelled';
+/**
+ * Record of a tool call made during the loop
+ */
+export interface ToolCallRecord {
+    /** Unique ID for this tool call */
+    id: string;
+    /** Name of the tool called */
+    toolName: string;
+    /** Arguments passed to the tool */
+    arguments: Record<string, unknown>;
+    /** Result of the tool execution */
+    result: ToolResult;
+    /** Timestamp when the call was made */
+    timestamp: Date;
+    /** Duration of the call in milliseconds */
+    duration: number;
+}
+/**
+ * Message in the loop conversation
+ */
+export interface LoopMessage {
+    /** Role of the message sender */
+    role: 'user' | 'assistant' | 'tool' | 'system';
+    /** Message content */
+    content: string;
+    /** Tool calls requested by assistant (if any) */
+    toolCalls?: LLMToolCall[];
+    /** Tool call ID this message responds to (for tool role) */
+    toolCallId?: string;
+}
+/**
+ * Tool call requested by LLM
+ */
+export interface LLMToolCall {
+    /** Unique ID for this tool call */
+    id: string;
+    /** Type of the call (always 'function' for now) */
+    type: 'function';
+    /** Function details */
+    function: {
+        /** Name of the function to call */
+        name: string;
+        /** JSON string of arguments */
+        arguments: string;
+    };
+}
+/**
+ * Current state of the agentic loop
+ */
+export interface LoopState {
+    /** Current iteration number (0-indexed) */
+    iteration: number;
+    /** All messages in the conversation */
+    messages: LoopMessage[];
+    /** All tool calls made during the loop */
+    toolCalls: ToolCallRecord[];
+    /** Current status */
+    status: LoopStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Start time of the loop */
+    startTime: Date;
+    /** End time of the loop (if completed) */
+    endTime?: Date;
+}
+/**
+ * Result of the agentic loop execution
+ */
+export interface LoopResult {
+    /** Final status of the loop */
+    status: LoopStatus;
+    /** Final response content from LLM */
+    content: string;
+    /** All tool calls made during execution */
+    toolCalls: ToolCallRecord[];
+    /** Number of iterations executed */
+    iterations: number;
+    /** Total duration in milliseconds */
+    duration: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Options for a single loop run
+ */
+export interface LoopRunOptions {
+    /** Override max iterations for this run */
+    maxIterations?: number;
+    /** Override timeout for this run */
+    timeout?: number;
+    /** System prompt to prepend */
+    systemPrompt?: string;
+    /** Abort signal for cancellation */
+    abortSignal?: AbortSignal;
+    /** Callback for streaming events */
+    onEvent?: (event: StreamEvent) => void;
+    /** Session ID for streaming events */
+    sessionId?: string;
+    /**
+     * Historical messages to inject before current user message.
+     * Used for stateless operation where history is loaded from database.
+     * Messages are injected after system prompt, before current user message.
+     */
+    history?: LoopMessage[];
+}
+//# sourceMappingURL=loop.d.ts.map

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

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

package/dist/types/loop.js

@@ -0,0 +1,16 @@
+/**
+ * Agentic Loop Type Definitions
+ *
+ * Defines the interfaces for the Agent's agentic loop execution system.
+ * The agentic loop allows LLM to autonomously decide tool calls and iterate until task completion.
+ */
+/**
+ * Default loop configuration
+ */
+export const DEFAULT_LOOP_CONFIG = {
+    maxIterations: 10,
+    iterationTimeout: 30000,
+    parallelToolCalls: true,
+    continueOnError: true,
+};
+//# sourceMappingURL=loop.js.map

package/dist/types/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/types/loop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmCH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;CACtB,CAAC"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Plugin System Type Definitions
+ *
+ * Defines the interfaces for the Agent's plugin-based tool extension system.
+ * Plugins provide a modular way to extend Agent capabilities with dependency injection.
+ */
+import type { Tool, ToolLogger } from './tool.js';
+import type { KnowledgeBase } from './knowledge.js';
+/**
+ * Plugin context for dependency injection
+ * Provides access to shared services and resources
+ */
+export interface PluginContext {
+    /** Logger for plugin operations */
+    logger: ToolLogger;
+    /** Knowledge base access */
+    knowledgeBase: KnowledgeBase;
+    /** Application configuration */
+    config: AppConfig;
+    /** Custom services injected by the host application */
+    services: Record<string, unknown>;
+}
+/**
+ * Application configuration available to plugins
+ */
+export interface AppConfig {
+    /** Environment (development, production, test) */
+    env: string;
+    /** Debug mode flag */
+    debug: boolean;
+    /** Custom configuration values */
+    [key: string]: unknown;
+}
+/**
+ * Plugin definition interface
+ * Plugins provide tools and optional lifecycle hooks
+ */
+export interface AgentPlugin {
+    /** Unique plugin identifier */
+    name: string;
+    /** Plugin version (semver format) */
+    version: string;
+    /** Human-readable description */
+    description: string;
+    /** Namespace for tool names (e.g., 'boss' -> 'boss_get_stats') */
+    namespace?: string;
+    /** Plugin dependencies (names of other plugins that must be loaded first) */
+    dependencies?: string[];
+    /** Tools provided by this plugin */
+    tools: Tool[];
+    /**
+     * Called when the plugin is loaded (before tools are registered)
+     * Use for initialization, resource allocation, etc.
+     * @alias initialize
+     */
+    onLoad?(context: PluginContext): Promise<void>;
+    /**
+     * Called when the plugin is loaded (before tools are registered)
+     * Use for initialization, resource allocation, etc.
+     * @alias onLoad
+     */
+    initialize?(context: PluginContext): Promise<void>;
+    /**
+     * Called when the plugin is unloaded (after tools are unregistered)
+     * Use for cleanup, resource release, etc.
+     * @alias cleanup
+     */
+    onUnload?(): Promise<void>;
+    /**
+     * Called when the plugin is unloaded (after tools are unregistered)
+     * Use for cleanup, resource release, etc.
+     * @alias onUnload
+     */
+    cleanup?(): Promise<void>;
+    /**
+     * Optional health check for the plugin
+     * Returns true if the plugin is functioning correctly
+     */
+    healthCheck?(): Promise<boolean>;
+}
+/**
+ * Plugin factory function type
+ * Recommended pattern for creating plugins with dependency injection
+ */
+export type PluginFactory<TDeps = unknown> = (deps: TDeps) => AgentPlugin;
+/**
+ * Plugin status information
+ */
+export type PluginStatus = 'loaded' | 'loading' | 'error' | 'unloaded';
+/**
+ * Plugin information returned by listPlugins
+ */
+export interface PluginInfo {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Plugin description */
+    description: string;
+    /** Plugin namespace */
+    namespace?: string;
+    /** Number of tools provided */
+    toolCount: number;
+    /** Tool names (with namespace prefix if applicable) */
+    toolNames: string[];
+    /** Current status */
+    status: PluginStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+}
+/**
+ * Options for plugin manager behavior
+ */
+export interface PluginManagerOptions {
+    /**
+     * Strategy for handling tool name conflicts
+     * - 'error': Throw an error (default)
+     * - 'replace': Replace existing tool
+     * - 'skip': Skip the conflicting tool
+     */
+    conflictStrategy: 'error' | 'replace' | 'skip';
+    /**
+     * Whether to automatically add namespace prefix to tool names
+     * Default: true
+     */
+    autoNamespace: boolean;
+    /**
+     * Whether to validate plugin definitions strictly
+     * Default: true
+     */
+    strictValidation: boolean;
+}
+/**
+ * Default plugin manager options
+ */
+export declare const DEFAULT_PLUGIN_MANAGER_OPTIONS: PluginManagerOptions;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,4BAA4B;IAC5B,aAAa,EAAE,aAAa,CAAC;IAC7B,gCAAgC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,oCAAoC;IACpC,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd;;;;OAIG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;OAIG;IACH,UAAU,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,WAAW,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,gBAAgB,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAE/C;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,oBAI5C,CAAC"}

package/dist/types/plugin.js

@@ -0,0 +1,15 @@
+/**
+ * Plugin System Type Definitions
+ *
+ * Defines the interfaces for the Agent's plugin-based tool extension system.
+ * Plugins provide a modular way to extend Agent capabilities with dependency injection.
+ */
+/**
+ * Default plugin manager options
+ */
+export const DEFAULT_PLUGIN_MANAGER_OPTIONS = {
+    conflictStrategy: 'error',
+    autoNamespace: true,
+    strictValidation: true,
+};
+//# sourceMappingURL=plugin.js.map

package/dist/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgJH;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IAClE,gBAAgB,EAAE,OAAO;IACzB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,IAAI;CACvB,CAAC"}