erosolar-cli 1.7.439 → 1.7.441

package/dist/runtime/agentController.js

@@ -0,0 +1,353 @@
+import { createNodeRuntime } from './node.js';
+import { AGENT_CONTRACT_VERSION } from '../contracts/v1/agent.js';
+class EventStream {
+    queue = [];
+    pending = null;
+    closed = false;
+    failure = null;
+    push(value) {
+        if (this.closed || this.failure) {
+            return;
+        }
+        if (this.pending) {
+            this.pending.resolve({ value, done: false });
+            this.pending = null;
+            return;
+        }
+        this.queue.push(value);
+    }
+    close() {
+        if (this.closed || this.failure) {
+            return;
+        }
+        this.closed = true;
+        if (this.pending) {
+            this.pending.resolve({ value: undefined, done: true });
+            this.pending = null;
+        }
+    }
+    fail(error) {
+        if (this.closed || this.failure) {
+            return;
+        }
+        this.failure = error;
+        if (this.pending) {
+            this.pending.reject(error);
+            this.pending = null;
+        }
+    }
+    next() {
+        if (this.queue.length) {
+            const value = this.queue.shift();
+            return Promise.resolve({ value, done: false });
+        }
+        if (this.failure) {
+            const error = this.failure;
+            this.failure = null;
+            return Promise.reject(error);
+        }
+        if (this.closed) {
+            return Promise.resolve({ value: undefined, done: true });
+        }
+        return new Promise((resolve, reject) => {
+            this.pending = { resolve, reject };
+        });
+    }
+    return() {
+        this.close();
+        return Promise.resolve({ value: undefined, done: true });
+    }
+    throw(error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        this.fail(err);
+        return Promise.reject(err);
+    }
+    [Symbol.asyncIterator]() {
+        return this;
+    }
+}
+function mergeToolObservers(primary, secondary) {
+    if (!secondary) {
+        return primary;
+    }
+    return {
+        onToolStart(call) {
+            primary.onToolStart?.(call);
+            secondary.onToolStart?.(call);
+        },
+        onToolResult(call, output) {
+            primary.onToolResult?.(call, output);
+            secondary.onToolResult?.(call, output);
+        },
+        onToolProgress(call, progress) {
+            primary.onToolProgress?.(call, progress);
+            secondary.onToolProgress?.(call, progress);
+        },
+        onToolError(call, error) {
+            primary.onToolError?.(call, error);
+            secondary.onToolError?.(call, error);
+        },
+        onCacheHit(call) {
+            primary.onCacheHit?.(call);
+            secondary.onCacheHit?.(call);
+        },
+        onToolWarning(call, warning) {
+            primary.onToolWarning?.(call, warning);
+            secondary.onToolWarning?.(call, warning);
+        },
+    };
+}
+function createControllerToolObserver(ref) {
+    const emit = (event) => {
+        ref.current?.push(event);
+    };
+    const timestamp = () => Date.now();
+    return {
+        onToolStart(call) {
+            emit({
+                type: 'tool.start',
+                timestamp: timestamp(),
+                toolName: call.name,
+                toolCallId: call.id,
+                parameters: { ...call.arguments },
+            });
+        },
+        onToolResult(call, output) {
+            emit({
+                type: 'tool.complete',
+                timestamp: timestamp(),
+                toolName: call.name,
+                toolCallId: call.id,
+                result: output,
+            });
+        },
+        onToolError(call, error) {
+            emit({
+                type: 'tool.error',
+                timestamp: timestamp(),
+                toolName: call.name,
+                toolCallId: call.id,
+                error,
+            });
+        },
+    };
+}
+export async function createAgentController(options, additionalObserver) {
+    const sinkRef = { current: null };
+    const observer = createControllerToolObserver(sinkRef);
+    const runtime = await createNodeRuntime({
+        profile: options.profile,
+        workspaceContext: options.workspaceContext,
+        workingDir: options.workingDir,
+        env: options.env,
+        toolObserver: mergeToolObservers(observer, additionalObserver),
+        additionalModules: options.modules,
+        adapterOptions: options.adapterOptions,
+    });
+    return new AgentController({ runtime, sinkRef, externalCallbacks: options.callbacks });
+}
+export class AgentController {
+    session;
+    sinkRef;
+    externalCallbacks;
+    activeSink = null;
+    agent = null;
+    cachedHistory = [];
+    selection;
+    constructor(dependencies) {
+        this.session = dependencies.runtime.session;
+        this.sinkRef = dependencies.sinkRef;
+        this.externalCallbacks = dependencies.externalCallbacks;
+        this.selection = this.buildInitialSelection();
+    }
+    buildInitialSelection() {
+        const config = this.session.profileConfig;
+        return {
+            provider: config.provider,
+            model: config.model,
+            temperature: config.temperature,
+            maxTokens: config.maxTokens,
+            systemPrompt: config.systemPrompt,
+        };
+    }
+    ensureAgent() {
+        if (this.agent) {
+            return this.agent;
+        }
+        const agent = this.session.createAgent(this.selection, this.createAgentCallbacks());
+        if (this.cachedHistory.length) {
+            agent.loadHistory(this.cachedHistory);
+        }
+        this.agent = agent;
+        return agent;
+    }
+    createAgentCallbacks() {
+        return {
+            onAssistantMessage: (content, metadata) => {
+                this.handleAssistantMessage(content, metadata);
+                this.externalCallbacks?.onAssistantMessage?.(content, metadata);
+            },
+            onStreamChunk: (chunk) => {
+                this.emitDelta(chunk, false);
+                this.externalCallbacks?.onStreamChunk?.(chunk);
+            },
+            onContextPruned: (removedCount, stats) => {
+                this.externalCallbacks?.onContextPruned?.(removedCount, stats);
+            },
+            onContextSquishing: (message) => {
+                this.externalCallbacks?.onContextSquishing?.(message);
+            },
+            onContextRecovery: (attempt, maxAttempts, message) => {
+                this.externalCallbacks?.onContextRecovery?.(attempt, maxAttempts, message);
+            },
+            onContinueAfterRecovery: () => {
+                this.externalCallbacks?.onContinueAfterRecovery?.();
+            },
+            onAutoContinue: (attempt, maxAttempts, message) => {
+                this.externalCallbacks?.onAutoContinue?.(attempt, maxAttempts, message);
+            },
+            onMultilinePaste: (summary, metadata) => {
+                this.externalCallbacks?.onMultilinePaste?.(summary, metadata);
+            },
+        };
+    }
+    emitDelta(content, isFinal) {
+        if (!content?.trim()) {
+            return;
+        }
+        this.activeSink?.push({
+            type: 'message.delta',
+            timestamp: Date.now(),
+            content,
+            isFinal,
+        });
+    }
+    emitError(message) {
+        this.activeSink?.push({
+            type: 'error',
+            timestamp: Date.now(),
+            error: message,
+        });
+    }
+    emitUsage(usage) {
+        if (!usage) {
+            return;
+        }
+        this.activeSink?.push({
+            type: 'usage',
+            timestamp: Date.now(),
+            inputTokens: usage.inputTokens,
+            outputTokens: usage.outputTokens,
+            totalTokens: usage.totalTokens,
+        });
+    }
+    handleAssistantMessage(content, metadata) {
+        if (!this.activeSink) {
+            return;
+        }
+        if (!metadata.isFinal) {
+            this.emitDelta(content, false);
+            return;
+        }
+        const elapsedMs = metadata.elapsedMs ?? 0;
+        this.activeSink.push({
+            type: 'message.complete',
+            timestamp: Date.now(),
+            content,
+            elapsedMs,
+        });
+        this.emitUsage(metadata.usage ?? null);
+    }
+    updateCachedHistory() {
+        if (this.agent) {
+            this.cachedHistory = this.agent.getHistory();
+        }
+    }
+    async *send(message) {
+        if (this.activeSink) {
+            throw new Error('Agent runtime is already processing a message. Please wait for the current run to finish.');
+        }
+        const agent = this.ensureAgent();
+        const sink = new EventStream();
+        this.activeSink = sink;
+        this.sinkRef.current = sink;
+        sink.push({ type: 'message.start', timestamp: Date.now() });
+        const run = agent
+            .send(message, true)
+            .then(() => {
+            this.updateCachedHistory();
+            sink.close();
+        })
+            .catch((error) => {
+            const messageText = error instanceof Error ? error.message : String(error);
+            this.emitError(messageText);
+            sink.fail(error instanceof Error ? error : new Error(messageText));
+        })
+            .finally(() => {
+            if (this.activeSink === sink) {
+                this.activeSink = null;
+                this.sinkRef.current = null;
+            }
+        });
+        try {
+            for await (const event of sink) {
+                yield event;
+            }
+        }
+        finally {
+            await run;
+        }
+    }
+    async switchModel(config) {
+        this.updateCachedHistory();
+        this.agent = null;
+        this.selection = {
+            provider: config.provider,
+            model: config.model,
+            temperature: config.temperature,
+            maxTokens: config.maxTokens,
+            systemPrompt: this.selection.systemPrompt,
+        };
+        this.session.updateToolContext(this.selection);
+    }
+    getCapabilities() {
+        const tools = this.session.toolRuntime.listProviderTools();
+        const manifestTools = tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            category: 'general',
+        }));
+        return {
+            contractVersion: AGENT_CONTRACT_VERSION,
+            profile: this.session.profile,
+            model: this.toModelConfig(this.selection),
+            tools: manifestTools,
+            features: ['streaming', 'tool-calls'],
+        };
+    }
+    registerToolSuite(suiteId, suite) {
+        this.session.toolRuntime.registerSuite({ ...suite, id: suiteId });
+    }
+    unregisterToolSuite(suiteId) {
+        this.session.toolRuntime.unregisterSuite(suiteId);
+    }
+    getHistory() {
+        if (this.agent) {
+            return this.agent.getHistory();
+        }
+        return [...this.cachedHistory];
+    }
+    clearHistory() {
+        this.cachedHistory = [];
+        this.agent?.clearHistory();
+    }
+    toModelConfig(selection) {
+        return {
+            provider: selection.provider,
+            model: selection.model,
+            temperature: selection.temperature,
+            maxTokens: selection.maxTokens,
+        };
+    }
+}
+//# sourceMappingURL=agentController.js.map

package/dist/runtime/agentController.js.map

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

package/dist/runtime/agentHost.d.ts

@@ -0,0 +1,61 @@
+import type { ProfileName } from '../config.js';
+import { AgentSession } from './agentSession.js';
+import { type ToolRuntimeObserver, type ToolSuite } from '../core/toolRuntime.js';
+export interface CapabilityContext {
+    profile: ProfileName;
+    workspaceContext: string | null;
+    workingDir: string;
+    env: NodeJS.ProcessEnv;
+}
+export interface CapabilityContribution {
+    id: string;
+    description?: string;
+    toolSuite?: ToolSuite;
+    toolSuites?: ToolSuite[];
+    metadata?: Record<string, unknown>;
+    dispose?(): void | Promise<void>;
+}
+export interface CapabilityModule {
+    id: string;
+    description?: string;
+    create(context: CapabilityContext): CapabilityContribution | CapabilityContribution[] | null | undefined | Promise<CapabilityContribution | CapabilityContribution[] | null | undefined>;
+}
+export interface CapabilityManifestEntry {
+    id: string;
+    moduleId: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentHostOptions {
+    profile: ProfileName;
+    workspaceContext: string | null;
+    workingDir: string;
+    modules?: CapabilityModule[];
+    toolObserver?: ToolRuntimeObserver;
+    env?: NodeJS.ProcessEnv;
+}
+export declare class AgentHost {
+    private readonly context;
+    private readonly toolObserver?;
+    private readonly modules;
+    private readonly contributions;
+    private readonly contributionOwners;
+    private readonly moduleContributions;
+    private session;
+    private disposed;
+    constructor(options: AgentHostOptions);
+    get profile(): ProfileName;
+    get workspaceContext(): string | null;
+    get workingDir(): string;
+    refreshWorkspaceContext(workspaceContext: string | null): void;
+    loadModules(modules: CapabilityModule[]): Promise<void>;
+    registerModule(module: CapabilityModule): Promise<void>;
+    getSession(): Promise<AgentSession>;
+    describeCapabilities(): CapabilityManifestEntry[];
+    dispose(): Promise<void>;
+    private collectToolSuites;
+    private validateContribution;
+    private assertMutable;
+    private removeModuleContributions;
+}
+//# sourceMappingURL=agentHost.d.ts.map

package/dist/runtime/agentHost.d.ts.map

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

package/dist/runtime/agentHost.js

@@ -0,0 +1,156 @@
+import { AgentSession } from './agentSession.js';
+export class AgentHost {
+    context;
+    toolObserver;
+    modules = new Map();
+    contributions = [];
+    contributionOwners = new Map();
+    moduleContributions = new Map();
+    session = null;
+    disposed = false;
+    constructor(options) {
+        this.context = {
+            profile: options.profile,
+            workspaceContext: options.workspaceContext,
+            workingDir: options.workingDir,
+            env: options.env ? { ...options.env } : { ...process.env },
+        };
+        this.toolObserver = options.toolObserver;
+    }
+    get profile() {
+        return this.context.profile;
+    }
+    get workspaceContext() {
+        return this.context.workspaceContext ?? null;
+    }
+    get workingDir() {
+        return this.context.workingDir;
+    }
+    refreshWorkspaceContext(workspaceContext) {
+        this.context.workspaceContext = workspaceContext;
+        this.session?.refreshWorkspaceContext(workspaceContext);
+    }
+    async loadModules(modules) {
+        for (const module of modules) {
+            await this.registerModule(module);
+        }
+    }
+    async registerModule(module) {
+        this.assertMutable();
+        this.removeModuleContributions(module.id);
+        this.modules.set(module.id, module);
+        const result = await module.create(this.context);
+        const normalized = normalizeContributions(result);
+        for (const contribution of normalized) {
+            this.validateContribution(contribution, module.id);
+            this.contributions.push(contribution);
+            this.contributionOwners.set(contribution.id, module.id);
+            const contributionSet = this.moduleContributions.get(module.id) ?? new Set();
+            contributionSet.add(contribution.id);
+            this.moduleContributions.set(module.id, contributionSet);
+        }
+    }
+    async getSession() {
+        if (this.session) {
+            return this.session;
+        }
+        const toolSuites = this.collectToolSuites();
+        this.session = new AgentSession({
+            profile: this.context.profile,
+            workspaceContext: this.context.workspaceContext,
+            toolSuites,
+            toolObserver: this.toolObserver,
+        });
+        return this.session;
+    }
+    describeCapabilities() {
+        return this.contributions.map((contribution) => ({
+            id: contribution.id,
+            moduleId: this.contributionOwners.get(contribution.id) ?? 'unknown',
+            description: contribution.description,
+            metadata: contribution.metadata ?? undefined,
+        }));
+    }
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        const tasks = this.contributions
+            .map((contribution) => contribution.dispose)
+            .filter((fn) => typeof fn === 'function')
+            .map(async (dispose) => {
+            try {
+                await dispose();
+            }
+            catch {
+            }
+        });
+        await Promise.all(tasks);
+    }
+    collectToolSuites() {
+        const suites = [];
+        const seen = new Set();
+        for (const contribution of this.contributions) {
+            const records = normalizeSuites(contribution);
+            for (const suite of records) {
+                if (seen.has(suite.id)) {
+                    throw new Error(`Duplicate tool suite id "${suite.id}" detected while composing capabilities. ` +
+                        'Ensure every capability module emits unique suite identifiers.');
+                }
+                suites.push(suite);
+                seen.add(suite.id);
+            }
+        }
+        return suites;
+    }
+    validateContribution(contribution, moduleId) {
+        if (!contribution?.id?.trim()) {
+            throw new Error(`Capability module "${moduleId}" emitted a contribution without an id.`);
+        }
+        const suites = normalizeSuites(contribution);
+        for (const suite of suites) {
+            if (!suite?.id?.trim()) {
+                throw new Error(`Capability contribution "${contribution.id}" from module "${moduleId}" ` +
+                    'emitted a tool suite without an id.');
+            }
+        }
+    }
+    assertMutable() {
+        if (this.session) {
+            throw new Error('Cannot register an additional capability module after the runtime session has been created. ' +
+                'Instantiate AgentHost earlier in the boot sequence or create a new host instance.');
+        }
+    }
+    removeModuleContributions(moduleId) {
+        const ids = this.moduleContributions.get(moduleId);
+        if (!ids?.size) {
+            return;
+        }
+        this.moduleContributions.delete(moduleId);
+        for (const id of ids) {
+            const index = this.contributions.findIndex((entry) => entry.id === id);
+            if (index >= 0) {
+                this.contributions.splice(index, 1);
+            }
+            this.contributionOwners.delete(id);
+        }
+    }
+}
+function normalizeContributions(value) {
+    if (!value) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+function normalizeSuites(contribution) {
+    const suites = [];
+    if (contribution.toolSuite) {
+        suites.push(contribution.toolSuite);
+    }
+    if (contribution.toolSuites?.length) {
+        suites.push(...contribution.toolSuites);
+    }
+    return suites;
+}
+//# sourceMappingURL=agentHost.js.map

package/dist/runtime/agentHost.js.map

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

package/dist/runtime/agentSession.d.ts

@@ -0,0 +1,40 @@
+import { type ProfileName, type ResolvedProfileConfig } from '../config.js';
+import { type ToolExecutionContext, type ToolRuntime, type IToolRuntime, type ToolRuntimeObserver, type ToolSuite } from '../core/toolRuntime.js';
+import type { ProviderId, ReasoningEffortLevel, TextVerbosityLevel } from '../core/types.js';
+import { AgentRuntime, type AgentCallbacks } from '../core/agent.js';
+import { ContextManager } from '../core/contextManager.js';
+export interface AgentSessionOptions {
+    profile: ProfileName;
+    workspaceContext: string | null;
+    toolSuites?: ToolSuite[];
+    toolObserver?: ToolRuntimeObserver;
+}
+export interface ModelSelection {
+    provider: ProviderId;
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+    reasoningEffort?: ReasoningEffortLevel;
+    textVerbosity?: TextVerbosityLevel;
+    /** Enable auto-continuation when model expresses intent but doesn't act */
+    autoContinue?: boolean;
+}
+export declare class AgentSession {
+    private readonly state;
+    constructor(options: AgentSessionOptions);
+    /**
+     * Creates a context manager with LLM-based summarization support
+     */
+    private createContextManagerWithSummarization;
+    get profile(): ProfileName;
+    get profileConfig(): ResolvedProfileConfig;
+    get workspaceContext(): string | null;
+    get toolRuntime(): ToolRuntime;
+    get toolContext(): ToolExecutionContext;
+    createAgent(selection: ModelSelection, callbacks?: AgentCallbacks, toolRuntimeOverride?: IToolRuntime): AgentRuntime;
+    updateToolContext(selection: ModelSelection): void;
+    refreshWorkspaceContext(workspaceContext: string | null): ResolvedProfileConfig;
+    get contextManager(): ContextManager;
+}
+//# sourceMappingURL=agentSession.d.ts.map

package/dist/runtime/agentSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentSession.d.ts","sourceRoot":"","sources":["../../src/runtime/agentSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAElH,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAA+B,cAAc,EAA8B,MAAM,2BAA2B,CAAC;AAYpH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAE9B,OAAO,EAAE,mBAAmB;IAmCxC;;OAEG;IACH,OAAO,CAAC,qCAAqC;IA6D7C,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED,IAAI,aAAa,IAAI,qBAAqB,CAEzC;IAED,IAAI,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEpC;IAED,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED,IAAI,WAAW,IAAI,oBAAoB,CAEtC;IAED,WAAW,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,cAAc,EAAE,mBAAmB,CAAC,EAAE,YAAY,GAAG,YAAY;IAepH,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IASlD,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB;IAwB/E,IAAI,cAAc,IAAI,cAAc,CAEnC;CACF"}