@robota-sdk/agent-core 3.0.0-beta.15 → 3.0.0-beta.16

package/dist/context/index.d.ts

@@ -0,0 +1,4 @@
+export type { IContextTokenUsage, IContextWindowState } from './types.js';
+export type { IModelDefinition } from './models.js';
+export { CLAUDE_MODELS, DEFAULT_CONTEXT_WINDOW, getModelContextWindow, getModelName, formatTokenCount } from './models.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAG1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,2 @@
+export { CLAUDE_MODELS, DEFAULT_CONTEXT_WINDOW, getModelContextWindow, getModelName, formatTokenCount } from './models.js';
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/context/models.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Claude model definitions — SSOT for model metadata.
+ * Source: https://platform.claude.com/docs/en/about-claude/models/overview
+ */
+export interface IModelDefinition {
+    /** Human-readable model name */
+    name: string;
+    /** API model identifier */
+    id: string;
+    /** Context window size in tokens */
+    contextWindow: number;
+    /** Maximum output tokens */
+    maxOutput: number;
+}
+/**
+ * Known Claude models (4.5+).
+ * Keyed by API model ID for fast lookup.
+ */
+export declare const CLAUDE_MODELS: Record<string, IModelDefinition>;
+export declare const DEFAULT_CONTEXT_WINDOW = 200000;
+/** Get context window size for a model ID. Falls back to DEFAULT_CONTEXT_WINDOW. */
+export declare function getModelContextWindow(modelId: string): number;
+/** Get human-readable model name for a model ID. Falls back to the ID itself. */
+export declare function getModelName(modelId: string): string;
+/** Format token count as human-readable (e.g., 200K, 1M) */
+export declare function formatTokenCount(tokens: number): string;
+//# sourceMappingURL=models.d.ts.map

package/dist/context/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/context/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAiD1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/dist/context/models.js

@@ -0,0 +1,76 @@
+/**
+ * Claude model definitions — SSOT for model metadata.
+ * Source: https://platform.claude.com/docs/en/about-claude/models/overview
+ */
+/**
+ * Known Claude models (4.5+).
+ * Keyed by API model ID for fast lookup.
+ */
+export const CLAUDE_MODELS = {
+    'claude-opus-4-6': {
+        name: 'Claude Opus 4.6',
+        id: 'claude-opus-4-6',
+        contextWindow: 1_000_000,
+        maxOutput: 128_000,
+    },
+    'claude-sonnet-4-6': {
+        name: 'Claude Sonnet 4.6',
+        id: 'claude-sonnet-4-6',
+        contextWindow: 1_000_000,
+        maxOutput: 64_000,
+    },
+    'claude-haiku-4-5': {
+        name: 'Claude Haiku 4.5',
+        id: 'claude-haiku-4-5',
+        contextWindow: 200_000,
+        maxOutput: 64_000,
+    },
+    'claude-haiku-4-5-20251001': {
+        name: 'Claude Haiku 4.5',
+        id: 'claude-haiku-4-5-20251001',
+        contextWindow: 200_000,
+        maxOutput: 64_000,
+    },
+    'claude-sonnet-4-5': {
+        name: 'Claude Sonnet 4.5',
+        id: 'claude-sonnet-4-5',
+        contextWindow: 200_000,
+        maxOutput: 64_000,
+    },
+    'claude-sonnet-4-5-20250929': {
+        name: 'Claude Sonnet 4.5',
+        id: 'claude-sonnet-4-5-20250929',
+        contextWindow: 200_000,
+        maxOutput: 64_000,
+    },
+    'claude-opus-4-5': {
+        name: 'Claude Opus 4.5',
+        id: 'claude-opus-4-5',
+        contextWindow: 200_000,
+        maxOutput: 64_000,
+    },
+    'claude-opus-4-5-20251101': {
+        name: 'Claude Opus 4.5',
+        id: 'claude-opus-4-5-20251101',
+        contextWindow: 200_000,
+        maxOutput: 64_000,
+    },
+};
+export const DEFAULT_CONTEXT_WINDOW = 200_000;
+/** Get context window size for a model ID. Falls back to DEFAULT_CONTEXT_WINDOW. */
+export function getModelContextWindow(modelId) {
+    return CLAUDE_MODELS[modelId]?.contextWindow ?? DEFAULT_CONTEXT_WINDOW;
+}
+/** Get human-readable model name for a model ID. Falls back to the ID itself. */
+export function getModelName(modelId) {
+    return CLAUDE_MODELS[modelId]?.name ?? modelId;
+}
+/** Format token count as human-readable (e.g., 200K, 1M) */
+export function formatTokenCount(tokens) {
+    if (tokens >= 1_000_000)
+        return `${tokens / 1_000_000}M`;
+    if (tokens >= 1_000)
+        return `${tokens / 1_000}K`;
+    return String(tokens);
+}
+//# sourceMappingURL=models.js.map

package/dist/context/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/context/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAqC;IAC7D,iBAAiB,EAAE;QACjB,IAAI,EAAE,iBAAiB;QACvB,EAAE,EAAE,iBAAiB;QACrB,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,OAAO;KACnB;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,mBAAmB;QACzB,EAAE,EAAE,mBAAmB;QACvB,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,MAAM;KAClB;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,kBAAkB;QACxB,EAAE,EAAE,kBAAkB;QACtB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,MAAM;KAClB;IACD,2BAA2B,EAAE;QAC3B,IAAI,EAAE,kBAAkB;QACxB,EAAE,EAAE,2BAA2B;QAC/B,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,MAAM;KAClB;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,mBAAmB;QACzB,EAAE,EAAE,mBAAmB;QACvB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,MAAM;KAClB;IACD,4BAA4B,EAAE;QAC5B,IAAI,EAAE,mBAAmB;QACzB,EAAE,EAAE,4BAA4B;QAChC,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,MAAM;KAClB;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,iBAAiB;QACvB,EAAE,EAAE,iBAAiB;QACrB,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,MAAM;KAClB;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,iBAAiB;QACvB,EAAE,EAAE,0BAA0B;QAC9B,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,MAAM;KAClB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,oFAAoF;AACpF,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,IAAI,sBAAsB,CAAC;AACzE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,OAAO,CAAC;AACjD,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,MAAM,IAAI,SAAS;QAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,CAAC;IACzD,IAAI,MAAM,IAAI,KAAK;QAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,CAAC;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC"}

package/dist/context/models.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.test.d.ts.map

package/dist/context/models.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.test.d.ts","sourceRoot":"","sources":["../../src/context/models.test.ts"],"names":[],"mappings":""}

package/dist/context/models.test.js

@@ -0,0 +1,51 @@
+import { describe, it, expect } from 'vitest';
+import { CLAUDE_MODELS, DEFAULT_CONTEXT_WINDOW, getModelContextWindow, getModelName, formatTokenCount, } from './models.js';
+describe('CLAUDE_MODELS registry', () => {
+    it('contains known model IDs', () => {
+        expect(CLAUDE_MODELS['claude-opus-4-6']).toBeDefined();
+        expect(CLAUDE_MODELS['claude-sonnet-4-6']).toBeDefined();
+        expect(CLAUDE_MODELS['claude-haiku-4-5']).toBeDefined();
+    });
+    it('each entry has required fields', () => {
+        for (const [id, model] of Object.entries(CLAUDE_MODELS)) {
+            expect(model.id).toBe(id);
+            expect(model.name).toBeTruthy();
+            expect(model.contextWindow).toBeGreaterThan(0);
+            expect(model.maxOutput).toBeGreaterThan(0);
+        }
+    });
+});
+describe('getModelContextWindow', () => {
+    it('returns context window for known model', () => {
+        expect(getModelContextWindow('claude-opus-4-6')).toBe(1_000_000);
+        expect(getModelContextWindow('claude-haiku-4-5')).toBe(200_000);
+    });
+    it('returns DEFAULT_CONTEXT_WINDOW for unknown model', () => {
+        expect(getModelContextWindow('unknown-model')).toBe(DEFAULT_CONTEXT_WINDOW);
+    });
+});
+describe('getModelName', () => {
+    it('returns human-readable name for known model', () => {
+        expect(getModelName('claude-opus-4-6')).toBe('Claude Opus 4.6');
+        expect(getModelName('claude-sonnet-4-6')).toBe('Claude Sonnet 4.6');
+    });
+    it('returns model ID as fallback for unknown model', () => {
+        expect(getModelName('unknown-model')).toBe('unknown-model');
+    });
+});
+describe('formatTokenCount', () => {
+    it('formats millions with uppercase M', () => {
+        expect(formatTokenCount(1_000_000)).toBe('1M');
+        expect(formatTokenCount(2_000_000)).toBe('2M');
+    });
+    it('formats thousands with uppercase K', () => {
+        expect(formatTokenCount(1_000)).toBe('1K');
+        expect(formatTokenCount(200_000)).toBe('200K');
+        expect(formatTokenCount(90_000)).toBe('90K');
+    });
+    it('returns raw number below 1000', () => {
+        expect(formatTokenCount(500)).toBe('500');
+        expect(formatTokenCount(0)).toBe('0');
+    });
+});
+//# sourceMappingURL=models.test.js.map

package/dist/context/models.test.js.map

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

package/dist/context/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Context window tracking types.
+ *
+ * These types are used by agent-sessions (and downstream packages) to
+ * track token usage and context window state across conversation turns.
+ */
+/** Token usage from a single API call (Anthropic-style granularity) */
+export interface IContextTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+}
+/** Context window state snapshot */
+export interface IContextWindowState {
+    /** Max tokens for the current model */
+    maxTokens: number;
+    /** Current estimated token usage (input + cache, excludes output) */
+    usedTokens: number;
+    /** Usage percentage (0-100) */
+    usedPercentage: number;
+    /** Remaining percentage (0-100) */
+    remainingPercentage: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,oCAAoC;AACpC,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,CAAC;CAC7B"}

package/dist/context/types.js

@@ -0,0 +1,8 @@
+/**
+ * Context window tracking types.
+ *
+ * These types are used by agent-sessions (and downstream packages) to
+ * track token usage and context window state across conversation turns.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/context/types.js.map

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

package/dist/core/robota-config-manager.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Configuration and tool management delegate for the Robota agent.
+ *
+ * Extracted from robota.ts to keep the main class under 300 lines.
+ */
+import type { IAgentConfig } from '../interfaces/agent';
+import type { IToolWithEventService } from '../abstracts/abstract-tool';
+import type { AbstractTool } from '../abstracts/abstract-tool';
+import type { AIProviders } from '../managers/ai-provider-manager';
+import type { Tools } from '../managers/tool-manager';
+import type { IEventService } from '../interfaces/event-service';
+import type { ILogger } from '../utils/logger';
+/** Agent statistics metadata type */
+export type TAgentStatsMetadata = Record<string, string | number | boolean | Date | string[]>;
+/**
+ * Validates the agent configuration format.
+ * @internal
+ */
+export declare function validateAgentConfig(config: IAgentConfig): void;
+/**
+ * Manages model/tool/config updates on behalf of a Robota instance.
+ * @internal
+ */
+export declare class RobotaConfigManager {
+    private readonly logger;
+    private readonly getAIProviders;
+    private readonly getTools;
+    private readonly getEventService;
+    private readonly isReady;
+    private readonly ensureReady;
+    private readonly getConfig;
+    private readonly setConfig;
+    private readonly getConfigVersion;
+    private readonly bumpConfigVersion;
+    private readonly getConfigUpdatedAt;
+    private readonly setConfigUpdatedAt;
+    private readonly emitAgentEvent;
+    constructor(logger: ILogger, getAIProviders: () => AIProviders, getTools: () => Tools, getEventService: () => IEventService | undefined, isReady: () => boolean, ensureReady: () => Promise<void>, getConfig: () => IAgentConfig, setConfig: (c: IAgentConfig) => void, getConfigVersion: () => number, bumpConfigVersion: () => number, getConfigUpdatedAt: () => number, setConfigUpdatedAt: (t: number) => void, emitAgentEvent: (eventType: string, data: Record<string, unknown>) => void);
+    /** Update tools for this agent instance. */
+    updateTools(next: Array<IToolWithEventService>): Promise<{
+        version: number;
+    }>;
+    /** Update configuration partially. Currently supports tools. */
+    updateConfiguration(patch: Partial<IAgentConfig>): Promise<{
+        version: number;
+    }>;
+    /** Read-only configuration overview for UI. */
+    getConfiguration(): Promise<{
+        version: number;
+        tools: Array<{
+            name: string;
+            parameters?: string[];
+        }>;
+        updatedAt: number;
+        metadata?: TAgentStatsMetadata;
+    }>;
+    /** Set the current model configuration (complete replacement). */
+    setModel(modelConfig: {
+        provider: string;
+        model: string;
+        temperature?: number;
+        maxTokens?: number;
+        topP?: number;
+        systemMessage?: string;
+    }): void;
+    /** Get the current model configuration. */
+    getModel(): {
+        provider: string;
+        model: string;
+        temperature?: number;
+        maxTokens?: number;
+        topP?: number;
+        systemMessage?: string;
+    };
+    /** Register a new tool for function calling. */
+    registerTool(tool: AbstractTool, tools: Tools): void;
+}
+//# sourceMappingURL=robota-config-manager.d.ts.map

package/dist/core/robota-config-manager.d.ts.map

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

package/dist/core/robota-config-manager.js

@@ -0,0 +1,216 @@
+import { ConfigurationError } from '../utils/errors';
+import { AGENT_EVENTS } from '../agents/constants';
+/**
+ * Validates the agent configuration format.
+ * @internal
+ */
+export function validateAgentConfig(config) {
+    if (!config.name) {
+        throw new ConfigurationError('Agent name is required', { component: 'Robota' });
+    }
+    if (!config.aiProviders || config.aiProviders.length === 0) {
+        throw new ConfigurationError('At least one AI provider is required', { component: 'Robota' });
+    }
+    if (!config.defaultModel) {
+        throw new ConfigurationError('Default model configuration is required', {
+            component: 'Robota',
+        });
+    }
+    if (!config.defaultModel.provider || !config.defaultModel.model) {
+        throw new ConfigurationError('Default model must specify both provider and model', {
+            component: 'Robota',
+        });
+    }
+    const providerNames = config.aiProviders.map((p) => p.name);
+    const duplicates = providerNames.filter((name, index) => providerNames.indexOf(name) !== index);
+    if (duplicates.length > 0) {
+        throw new ConfigurationError(`Duplicate AI provider names: ${duplicates.join(', ')}`, {
+            component: 'Robota',
+            duplicates,
+        });
+    }
+    if (!providerNames.includes(config.defaultModel.provider)) {
+        throw new ConfigurationError(`Default provider '${config.defaultModel.provider}' not found in AI providers list. Available: ${providerNames.join(', ')}`, {
+            component: 'Robota',
+            defaultProvider: config.defaultModel.provider,
+            availableProviders: providerNames,
+        });
+    }
+}
+/**
+ * Manages model/tool/config updates on behalf of a Robota instance.
+ * @internal
+ */
+export class RobotaConfigManager {
+    logger;
+    getAIProviders;
+    getTools;
+    getEventService;
+    isReady;
+    ensureReady;
+    getConfig;
+    setConfig;
+    getConfigVersion;
+    bumpConfigVersion;
+    getConfigUpdatedAt;
+    setConfigUpdatedAt;
+    emitAgentEvent;
+    constructor(logger, getAIProviders, getTools, getEventService, isReady, ensureReady, getConfig, setConfig, getConfigVersion, bumpConfigVersion, getConfigUpdatedAt, setConfigUpdatedAt, emitAgentEvent) {
+        this.logger = logger;
+        this.getAIProviders = getAIProviders;
+        this.getTools = getTools;
+        this.getEventService = getEventService;
+        this.isReady = isReady;
+        this.ensureReady = ensureReady;
+        this.getConfig = getConfig;
+        this.setConfig = setConfig;
+        this.getConfigVersion = getConfigVersion;
+        this.bumpConfigVersion = bumpConfigVersion;
+        this.getConfigUpdatedAt = getConfigUpdatedAt;
+        this.setConfigUpdatedAt = setConfigUpdatedAt;
+        this.emitAgentEvent = emitAgentEvent;
+    }
+    /** Update tools for this agent instance. */
+    async updateTools(next) {
+        await this.ensureReady();
+        if (!Array.isArray(next)) {
+            throw new ConfigurationError('updateTools: next must be an array of tools');
+        }
+        const registry = this.getTools().getRegistry();
+        registry.clear();
+        const toolNames = [];
+        const eventService = this.getEventService();
+        for (const tool of next) {
+            if (eventService) {
+                tool.setEventService(eventService);
+            }
+            const toolExecutor = async (parameters, context) => {
+                if (!context) {
+                    throw new Error('[ROBOTA] Missing ToolExecutionContext for tool execution');
+                }
+                const result = await tool.execute(parameters, context);
+                return result.data;
+            };
+            this.getTools().addTool(tool.schema, toolExecutor);
+            const nm = tool.schema.name;
+            if (typeof nm === 'string' && nm.length > 0)
+                toolNames.push(nm);
+        }
+        const config = this.getConfig();
+        config.tools = next;
+        this.setConfig(config);
+        const version = this.bumpConfigVersion();
+        this.setConfigUpdatedAt(Date.now());
+        this.emitAgentEvent(AGENT_EVENTS.CONFIG_UPDATED, {
+            parameters: {
+                tools: toolNames,
+                systemMessage: config.defaultModel.systemMessage,
+                provider: config.defaultModel.provider,
+                model: config.defaultModel.model,
+                temperature: config.defaultModel.temperature,
+                maxTokens: config.defaultModel.maxTokens,
+            },
+            metadata: { version },
+        });
+        return { version };
+    }
+    /** Update configuration partially. Currently supports tools. */
+    async updateConfiguration(patch) {
+        if (patch.tools) {
+            return this.updateTools(patch.tools);
+        }
+        throw new ConfigurationError('updateConfiguration: only tools patch is supported at this time');
+    }
+    /** Read-only configuration overview for UI. */
+    async getConfiguration() {
+        await this.ensureReady();
+        const schemas = this.getTools().getTools();
+        const tools = schemas.map((s) => ({
+            name: s.name,
+            parameters: (() => {
+                const params = s.parameters;
+                const props = params?.properties;
+                return props && typeof props === 'object' ? Object.keys(props) : undefined;
+            })(),
+        }));
+        return {
+            version: this.getConfigVersion(),
+            tools,
+            updatedAt: this.getConfigUpdatedAt(),
+            metadata: undefined,
+        };
+    }
+    /** Set the current model configuration (complete replacement). */
+    setModel(modelConfig) {
+        if (!modelConfig.provider || !modelConfig.model) {
+            throw new ConfigurationError('Both provider and model are required', { component: 'Robota' });
+        }
+        if (!this.isReady()) {
+            throw new ConfigurationError('Agent must be fully initialized before changing model configuration', { component: 'Robota' });
+        }
+        const aiProviders = this.getAIProviders();
+        const availableProviders = aiProviders.getProviderNames();
+        if (!availableProviders.includes(modelConfig.provider)) {
+            throw new ConfigurationError(`AI Provider '${modelConfig.provider}' not found. Available: ${availableProviders.join(', ')}`, { component: 'Robota', provider: modelConfig.provider, availableProviders });
+        }
+        aiProviders.setCurrentProvider(modelConfig.provider, modelConfig.model);
+        const config = this.getConfig();
+        this.setConfig({
+            ...config,
+            defaultModel: {
+                ...config.defaultModel,
+                provider: modelConfig.provider,
+                model: modelConfig.model,
+                ...(modelConfig.temperature !== undefined && { temperature: modelConfig.temperature }),
+                ...(modelConfig.maxTokens !== undefined && { maxTokens: modelConfig.maxTokens }),
+                ...(modelConfig.topP !== undefined && { topP: modelConfig.topP }),
+                ...(modelConfig.systemMessage !== undefined && {
+                    systemMessage: modelConfig.systemMessage,
+                }),
+            },
+        });
+        this.logger.debug('Model configuration updated', modelConfig);
+    }
+    /** Get the current model configuration. */
+    getModel() {
+        if (!this.isReady()) {
+            throw new ConfigurationError('Agent must be fully initialized before getting model configuration', { component: 'Robota' });
+        }
+        const currentProviderInfo = this.getAIProviders().getCurrentProvider();
+        if (!currentProviderInfo) {
+            throw new ConfigurationError('No provider is currently set', { component: 'Robota' });
+        }
+        const config = this.getConfig();
+        return {
+            provider: currentProviderInfo.provider,
+            model: currentProviderInfo.model,
+            ...(config.defaultModel.temperature !== undefined && {
+                temperature: config.defaultModel.temperature,
+            }),
+            ...(config.defaultModel.maxTokens !== undefined && {
+                maxTokens: config.defaultModel.maxTokens,
+            }),
+            ...(config.defaultModel.topP !== undefined && { topP: config.defaultModel.topP }),
+            ...(config.defaultModel.systemMessage !== undefined && {
+                systemMessage: config.defaultModel.systemMessage,
+            }),
+        };
+    }
+    /** Register a new tool for function calling. */
+    registerTool(tool, tools) {
+        if (tools.hasTool(tool.schema.name)) {
+            throw new Error(`[STRICT-POLICY][EMITTER-CONTRACT] Duplicate tool registration attempted: ${tool.schema.name}. ` +
+                `Tool registration flow must provide a single authoritative registration path.`);
+        }
+        const toolExecutor = async (parameters, context) => {
+            if (!context) {
+                throw new Error('[ROBOTA] Missing ToolExecutionContext for tool execution');
+            }
+            const result = await tool.execute(parameters, context);
+            return result.data;
+        };
+        tools.addTool(tool.schema, toolExecutor);
+        this.logger.debug('Tool registered', { toolName: tool.schema.name });
+    }
+}
+//# sourceMappingURL=robota-config-manager.js.map

package/dist/core/robota-config-manager.js.map

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

package/dist/core/robota-execution.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Execution methods (run, runStream) for the Robota agent.
+ *
+ * Extracted from robota.ts to keep the main class under 300 lines.
+ */
+import type { TUniversalMessage, IAgentConfig, IRunOptions } from '../interfaces/agent';
+import type { ExecutionService } from '../services/execution-service';
+import type { ILogger } from '../utils/logger';
+import type { IAgentEventData } from '../interfaces/event-service';
+/** Dependencies required by the execution helpers. @internal */
+export interface IRobotaExecutionDeps {
+    readonly conversationId: string;
+    readonly config: IAgentConfig;
+    readonly logger: ILogger;
+    getHistory(): TUniversalMessage[];
+    getExecutionService(): ExecutionService;
+    emitAgentEvent(eventType: string, data: Omit<IAgentEventData, 'timestamp'>): void;
+}
+/** Execute a single conversation turn. @internal */
+export declare function robotaRun(deps: IRobotaExecutionDeps, input: string, options?: IRunOptions): Promise<string>;
+/** Execute a streaming conversation turn. @internal */
+export declare function robotaRunStream(deps: IRobotaExecutionDeps, input: string, options?: IRunOptions): AsyncGenerator<string, void, undefined>;
+//# sourceMappingURL=robota-execution.d.ts.map

package/dist/core/robota-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robota-execution.d.ts","sourceRoot":"","sources":["../../src/core/robota-execution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAClC,mBAAmB,IAAI,gBAAgB,CAAC;IACxC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;CACnF;AAED,oDAAoD;AACpD,wBAAsB,SAAS,CAC7B,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED,uDAAuD;AACvD,wBAAuB,eAAe,CACpC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAqCzC"}