@devxiyang/agent-kernel 0.0.2

package/dist/core/agent/agent.js

@@ -0,0 +1,301 @@
+/**
+ * Agent — stateful wrapper around kernel + runLoop.
+ *
+ * Owns:
+ *   - AbortController lifecycle (per-prompt)
+ *   - Steering / follow-up message queues
+ *   - Event fan-out to subscribers
+ *   - Mutable config (stream, tools, maxSteps)
+ *   - Runtime state (streaming message, pending tool calls, error)
+ *
+ * Does not own:
+ *   - Kernel lifecycle (caller creates and passes in)
+ *   - Conversation log (kernel handles both kernel.jsonl and log.jsonl)
+ *   - Compaction decisions (caller checks kernel.contextSize and calls kernel.compact())
+ */
+import { createKernel } from '../kernel';
+import { runLoop } from './loop';
+// ─── Agent ───────────────────────────────────────────────────────────────────
+/**
+ * High-level stateful agent.
+ *
+ * Owns the AbortController lifecycle, steering/follow-up queues, event fan-out
+ * to subscribers, and mutable config. The underlying kernel (conversation store)
+ * is created externally and injected — the Agent never touches persistence directly.
+ */
+export class Agent {
+    _kernel;
+    _stream;
+    _tools;
+    _maxSteps;
+    _transformContext;
+    _onStepEnd;
+    _steeringMode;
+    _followUpMode;
+    _parallelTools;
+    _onContextFull;
+    _toolTimeout;
+    _retryOnError;
+    _abortController = null;
+    _runningPromise = null;
+    _steeringQueue = [];
+    _followUpQueue = [];
+    _listeners = new Set();
+    // ── Runtime state ──────────────────────────────────────────────────────
+    _streamEntry = null;
+    _streamText = '';
+    _streamReasoning = '';
+    _streamToolCalls = [];
+    _pendingToolCalls = new Set();
+    _error = null;
+    constructor(kernel, options) {
+        this._kernel = kernel;
+        this._stream = options.stream;
+        this._tools = options.tools;
+        this._maxSteps = options.maxSteps;
+        this._transformContext = options.transformContext;
+        this._onStepEnd = options.onStepEnd;
+        this._steeringMode = options.steeringMode ?? 'one-at-a-time';
+        this._followUpMode = options.followUpMode ?? 'one-at-a-time';
+        this._parallelTools = options.parallelTools;
+        this._onContextFull = options.onContextFull;
+        this._toolTimeout = options.toolTimeout;
+        this._retryOnError = options.retryOnError;
+    }
+    // ── State ──────────────────────────────────────────────────────────────
+    /** The underlying kernel that owns conversation history and persistence. */
+    get kernel() { return this._kernel; }
+    /** Snapshot of the current runtime state (read-only). */
+    get state() {
+        return {
+            isRunning: this._abortController !== null,
+            streamEntry: this._streamEntry,
+            pendingToolCalls: this._pendingToolCalls,
+            error: this._error,
+        };
+    }
+    // ── Mutators ─────────────────────────────────────────────────────────────
+    /** Replace the LLM streaming function (takes effect on the next run). */
+    setStream(stream) { this._stream = stream; }
+    /** Replace the tool set (takes effect on the next run). */
+    setTools(tools) { this._tools = tools; }
+    /** Update the maximum number of loop steps (takes effect on the next run). */
+    setMaxSteps(maxSteps) { this._maxSteps = maxSteps; }
+    /** Change how many steering messages are dequeued per check. */
+    setSteeringMode(mode) { this._steeringMode = mode; }
+    /** Change how many follow-up messages are dequeued per check. */
+    setFollowUpMode(mode) { this._followUpMode = mode; }
+    // ── Event subscription ──────────────────────────────────────────────────
+    /**
+     * Register a listener for all agent events.
+     * Returns an unsubscribe function — call it to stop receiving events.
+     */
+    subscribe(fn) {
+        this._listeners.add(fn);
+        return () => { this._listeners.delete(fn); };
+    }
+    // ── Prompt ──────────────────────────────────────────────────────────────
+    /**
+     * Append one or more user entries to the kernel and start a new agent run.
+     * Throws if the agent is already running — use steer() or followUp() instead.
+     */
+    prompt(entries) {
+        if (this.state.isRunning) {
+            throw new Error('Agent is already running. Use steer() or followUp() to queue messages.');
+        }
+        for (const entry of Array.isArray(entries) ? entries : [entries]) {
+            this._kernel.append(entry);
+        }
+        this._error = null;
+        this._run();
+    }
+    /**
+     * Resume execution after an error, abort, or when steering/follow-up messages
+     * are queued but the loop has already exited.
+     * Throws if already running or if there is nothing to continue from.
+     */
+    continue() {
+        if (this.state.isRunning) {
+            throw new Error('Agent is already running.');
+        }
+        const lastEntry = this._kernel.peek();
+        if (!lastEntry) {
+            throw new Error('No conversation to continue from. Use prompt() to start.');
+        }
+        const hasQueued = this._steeringQueue.length > 0 || this._followUpQueue.length > 0;
+        if (lastEntry.type === 'assistant') {
+            const { stopReason } = lastEntry.payload;
+            const isRetriable = stopReason === 'error' || stopReason === 'aborted';
+            if (!isRetriable && !hasQueued) {
+                throw new Error('Nothing to continue from. Use prompt() to start a new turn.');
+            }
+        }
+        this._error = null;
+        this._run();
+    }
+    // ── Steering / Follow-up ────────────────────────────────────────────────
+    /**
+     * Queue a steering message that interrupts the current run between tool calls.
+     * Safe to call while the agent is running. The loop picks it up on the next
+     * steering check and skips any remaining tool calls in the current batch.
+     */
+    steer(entries) {
+        this._steeringQueue.push(...(Array.isArray(entries) ? entries : [entries]));
+    }
+    /**
+     * Queue a follow-up message to be processed after the current run completes.
+     * Causes the outer loop to continue rather than stop when the agent would
+     * otherwise go idle.
+     */
+    followUp(entries) {
+        this._followUpQueue.push(...(Array.isArray(entries) ? entries : [entries]));
+    }
+    // ── Abort ───────────────────────────────────────────────────────────────
+    /** Cancel the current run. No-op if not running. */
+    abort() {
+        this._abortController?.abort();
+    }
+    // ── Reset ────────────────────────────────────────────────────────────────
+    /**
+     * Clear all queues and transient runtime state (stream entry, pending tool calls, error).
+     * Does NOT touch the kernel or conversation history.
+     * Throws if called while running — abort() first.
+     */
+    reset() {
+        if (this.state.isRunning) {
+            throw new Error('Cannot reset while running. Call abort() first.');
+        }
+        this._steeringQueue.splice(0);
+        this._followUpQueue.splice(0);
+        this._streamEntry = null;
+        this._streamText = '';
+        this._streamReasoning = '';
+        this._streamToolCalls = [];
+        this._pendingToolCalls = new Set();
+        this._error = null;
+    }
+    // ── Wait ────────────────────────────────────────────────────────────────
+    /** Resolves when the agent finishes its current run (or immediately if idle). */
+    async waitForIdle() {
+        if (this._runningPromise) {
+            try {
+                await this._runningPromise;
+            }
+            catch { /* caller handles errors via subscribe */ }
+        }
+    }
+    // ── Private ─────────────────────────────────────────────────────────────
+    _run() {
+        this._abortController = new AbortController();
+        const eventStream = runLoop(this._kernel, {
+            stream: this._stream,
+            tools: this._tools,
+            maxSteps: this._maxSteps,
+            signal: this._abortController.signal,
+            transformContext: this._transformContext,
+            onStepEnd: this._onStepEnd,
+            getSteeringMessages: () => this._drainSteering(),
+            getFollowUpMessages: () => this._drainFollowUp(),
+            parallelTools: this._parallelTools,
+            onContextFull: this._onContextFull,
+            toolTimeout: this._toolTimeout,
+            retryOnError: this._retryOnError,
+        });
+        this._runningPromise = this._consume(eventStream);
+    }
+    async _consume(stream) {
+        try {
+            for await (const event of stream) {
+                this._handleEvent(event);
+                for (const fn of this._listeners) {
+                    fn(event);
+                }
+            }
+            return await stream.result();
+        }
+        catch {
+            return undefined;
+        }
+        finally {
+            this._abortController = null;
+            this._runningPromise = null;
+        }
+    }
+    _handleEvent(event) {
+        switch (event.type) {
+            case 'turn_start':
+                this._streamText = '';
+                this._streamReasoning = '';
+                this._streamToolCalls = [];
+                this._streamEntry = null;
+                break;
+            case 'text_delta':
+                this._streamText += event.delta;
+                this._updateStreamEntry();
+                break;
+            case 'reasoning_delta':
+                this._streamReasoning += event.delta;
+                this._updateStreamEntry();
+                break;
+            case 'tool_call':
+                this._streamToolCalls.push({
+                    toolCallId: event.toolCallId,
+                    toolName: event.toolName,
+                    input: event.input,
+                });
+                this._pendingToolCalls.add(event.toolCallId);
+                this._updateStreamEntry();
+                break;
+            case 'tool_result':
+                this._pendingToolCalls.delete(event.toolCallId);
+                break;
+            case 'message_end':
+                this._streamEntry = null;
+                break;
+            case 'turn_end':
+                this._streamEntry = null;
+                break;
+            case 'agent_end':
+                this._streamEntry = null;
+                this._pendingToolCalls = new Set();
+                if (event.error) {
+                    this._error = event.error;
+                }
+                break;
+        }
+    }
+    _updateStreamEntry() {
+        this._streamEntry = {
+            type: 'assistant',
+            payload: {
+                text: this._streamText,
+                reasoning: this._streamReasoning || undefined,
+                toolCalls: this._streamToolCalls,
+            },
+        };
+    }
+    async _drainSteering() {
+        if (this._steeringQueue.length === 0)
+            return [];
+        return this._steeringMode === 'one-at-a-time'
+            ? this._steeringQueue.splice(0, 1)
+            : this._steeringQueue.splice(0);
+    }
+    async _drainFollowUp() {
+        if (this._followUpQueue.length === 0)
+            return [];
+        return this._followUpMode === 'one-at-a-time'
+            ? this._followUpQueue.splice(0, 1)
+            : this._followUpQueue.splice(0);
+    }
+}
+/**
+ * Convenience factory that creates a kernel (optionally with persistence) and
+ * wraps it in an Agent. Prefer this over constructing Agent directly.
+ */
+export function createAgent(options) {
+    const { session, ...agentOptions } = options;
+    const kernel = createKernel(session);
+    return new Agent(kernel, agentOptions);
+}
+//# sourceMappingURL=agent.js.map

package/dist/core/agent/agent.js.map

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

package/dist/core/agent/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module agent-kernel/agent
+ *
+ * Public surface of the Agent module. Exports all types, the Agent class,
+ * the createAgent factory, the low-level runLoop function, and the wrapTool helper.
+ */
+export type { Usage, AgentEntry, AgentMessage, StopReason, ToolCallInfo, } from '../kernel';
+export type { ToolContent, ToolResult, ToolResultInfo, LLMStreamEvent, LLMStopReason, LLMStepResult, StreamFn, AgentTool, AgentConfig, AgentEvent, AgentResult, AgentOptions, QueueMode, BlockResult, BeforeToolCallResult, BeforeToolCallHook, AfterToolCallResult, AfterToolCallHook, ToolWrapHooks, } from './types';
+export { Agent, createAgent } from './agent';
+export type { AgentState, AgentSessionOptions } from './agent';
+export { runLoop } from './loop';
+export { wrapTool } from './wrap-tool';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,KAAK,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC5C,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA"}

package/dist/core/agent/index.js

@@ -0,0 +1,10 @@
+/**
+ * @module agent-kernel/agent
+ *
+ * Public surface of the Agent module. Exports all types, the Agent class,
+ * the createAgent factory, the low-level runLoop function, and the wrapTool helper.
+ */
+export { Agent, createAgent } from './agent';
+export { runLoop } from './loop';
+export { wrapTool } from './wrap-tool';
+//# sourceMappingURL=index.js.map

package/dist/core/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA"}

package/dist/core/agent/loop.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent loop — the "userspace shell" around the kernel.
+ *
+ * Design:
+ *   - No dependency on any LLM provider (AI SDK, OpenAI, etc.).
+ *   - Provider is injected as StreamFn; tools are injected as AgentTool[].
+ *   - The kernel is the single source of truth for conversation history.
+ *   - Nested loop pattern: inner loop handles tool calls
+ *     and steering; outer loop handles follow-up messages.
+ *
+ * Each inner iteration (one turn):
+ *   1. Write pending entries to kernel.
+ *   2. Emit turn_start.
+ *   3. buildContext → transformContext? → AgentMessage[]
+ *   4. stream(messages) → LLMStepResult, emitting LLMStreamEvents to UI.
+ *   5. Write assistant entry to kernel.
+ *   6. Execute tool calls (write each result to kernel, check steering between calls).
+ *   7. Emit turn_end { toolResults }.
+ *   8. If tool calls were made → repeat from 1 (LLM processes results).
+ *   9. Else → check for follow-up messages (outer loop) or stop.
+ */
+import { EventStream } from '../../event-stream';
+import type { AgentKernel } from '../kernel';
+import type { AgentConfig, AgentEvent, AgentResult } from './types';
+/**
+ * Start the agent loop. Returns an EventStream immediately.
+ * Consumer iterates events with `for await` and awaits stream.result().
+ */
+export declare function runLoop(kernel: AgentKernel, config: AgentConfig): EventStream<AgentEvent, AgentResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/core/agent/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/core/agent/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,WAAW,EAOZ,MAAM,SAAS,CAAA;AAIhB;;;GAGG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAClB,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAItC"}