open-agent-sdk 0.1.0-alpha.0

package/dist/session/session.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Session class for managing conversation state
+ * Provides a stateful interface for multi-turn interactions
+ */
+import type { ReActLoop } from '../agent/react-loop';
+import type { SDKMessage } from '../types/messages';
+import type { SessionStorage } from './storage';
+/** Session states following a state machine pattern */
+export declare enum SessionState {
+    IDLE = "idle",
+    READY = "ready",
+    RUNNING = "running",
+    ERROR = "error",
+    CLOSED = "closed"
+}
+/** Base error class for session-related errors */
+export declare class SessionError extends Error {
+    constructor(message: string);
+}
+/** Error thrown when send() is called but session is not in IDLE state */
+export declare class SessionNotIdleError extends SessionError {
+    constructor();
+}
+/** Error thrown when stream() is called but session is not in READY state */
+export declare class SessionNotReadyError extends SessionError {
+    constructor();
+}
+/** Error thrown when stream() is called while another stream is active */
+export declare class SessionAlreadyStreamingError extends SessionError {
+    constructor();
+}
+/** Error thrown when any operation is called on a closed session */
+export declare class SessionClosedError extends SessionError {
+    constructor();
+}
+/** Options for creating a new Session */
+export interface SessionOptions {
+    /** Model identifier */
+    model: string;
+    /** Provider name */
+    provider: string;
+    /** Optional session ID (generated if not provided) */
+    id?: string;
+    /** Parent session ID if this session was forked */
+    parentSessionId?: string;
+    /** Timestamp when this session was forked */
+    forkedAt?: number;
+}
+/**
+ * Session class for managing conversation state
+ *
+ * State machine:
+ *   [idle] --send()--> [ready]
+ *     ▲                  │
+ *     │                  ▼
+ *   [closed]          [running] --stream结束--> [idle]
+ *                        │
+ *                        ▼
+ *                     [error] --> [idle]
+ *
+ * Constraints:
+ * - send() can only be called in IDLE state
+ * - stream() can only be called in READY state
+ * - Only one stream can be active at a time
+ * - close() can be called in any state
+ */
+export declare class Session {
+    readonly id: string;
+    readonly model: string;
+    readonly provider: string;
+    readonly createdAt: number;
+    readonly parentSessionId?: string;
+    readonly forkedAt?: number;
+    private _state;
+    private loop;
+    private messages;
+    private isStreaming;
+    private storage?;
+    private updatedAt;
+    constructor(loop: ReActLoop, options: SessionOptions, storage?: SessionStorage);
+    /**
+     * Load a session from storage by ID
+     * @param id - Session ID to load
+     * @param storage - Storage implementation to use
+     * @param loop - ReActLoop instance for the session
+     * @returns Session instance or null if not found
+     */
+    static loadFromStorage(id: string, storage: SessionStorage, loop: ReActLoop): Promise<Session | null>;
+    /**
+     * Save session data to storage
+     * @private
+     */
+    private saveToStorage;
+    /** Current state of the session */
+    get state(): SessionState;
+    /**
+     * Send a user message to the session
+     * Transitions state from IDLE to READY
+     *
+     * @param message - User's message
+     * @throws {SessionNotIdleError} If session is not in IDLE state
+     * @throws {SessionClosedError} If session is closed
+     */
+    send(message: string): Promise<void>;
+    /**
+     * Stream the agent's response
+     * Transitions state from READY to RUNNING, then back to IDLE
+     *
+     * @returns AsyncGenerator yielding SDK messages
+     * @throws {SessionNotReadyError} If session is not in READY state
+     * @throws {SessionAlreadyStreamingError} If another stream is active
+     * @throws {SessionClosedError} If session is closed
+     */
+    stream(): AsyncGenerator<SDKMessage>;
+    /**
+     * Get a readonly copy of the message history
+     *
+     * @returns Readonly array of SDK messages
+     */
+    getMessages(): readonly SDKMessage[];
+    /**
+     * Close the session
+     * Can be called from any state
+     */
+    close(): Promise<void>;
+    /**
+     * Support for async dispose pattern (await using)
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Compact the conversation history to reduce token usage.
+     * Generates a summary of older messages and preserves recent rounds.
+     *
+     * @returns Result of the compaction operation
+     * @throws {SessionClosedError} If session is closed
+     */
+    compact(): Promise<{
+        success: boolean;
+        preTokens?: number;
+        preservedRounds?: number;
+        reason?: string;
+    }>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session/session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,WAAW,CAAC;AAI7D,uDAAuD;AACvD,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,kDAAkD;AAClD,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,0EAA0E;AAC1E,qBAAa,mBAAoB,SAAQ,YAAY;;CAKpD;AAED,6EAA6E;AAC7E,qBAAa,oBAAqB,SAAQ,YAAY;;CAKrD;AAED,0EAA0E;AAC1E,qBAAa,4BAA6B,SAAQ,YAAY;;CAK7D;AAED,oEAAoE;AACpE,qBAAa,kBAAmB,SAAQ,YAAY;;CAKnD;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc;IAe9E;;;;;;OAMG;WACU,eAAe,CAC1B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAuB1B;;;OAGG;YACW,aAAa;IAyB3B,mCAAmC;IACnC,IAAI,KAAK,IAAI,YAAY,CAExB;IAED;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1C;;;;;;;;OAQG;IACI,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAwE3C;;;;OAIG;IACH,WAAW,IAAI,SAAS,UAAU,EAAE;IAIpC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CAgDH"}

package/dist/session/session.js

@@ -0,0 +1,319 @@
+/**
+ * Session class for managing conversation state
+ * Provides a stateful interface for multi-turn interactions
+ */
+import { logger } from '../utils/logger';
+import { generateUUID } from '../utils/uuid';
+/** Session states following a state machine pattern */
+export var SessionState;
+(function (SessionState) {
+    SessionState["IDLE"] = "idle";
+    SessionState["READY"] = "ready";
+    SessionState["RUNNING"] = "running";
+    SessionState["ERROR"] = "error";
+    SessionState["CLOSED"] = "closed";
+})(SessionState || (SessionState = {}));
+/** Base error class for session-related errors */
+export class SessionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SessionError';
+    }
+}
+/** Error thrown when send() is called but session is not in IDLE state */
+export class SessionNotIdleError extends SessionError {
+    constructor() {
+        super('Cannot send message: session is not in idle state');
+        this.name = 'SessionNotIdleError';
+    }
+}
+/** Error thrown when stream() is called but session is not in READY state */
+export class SessionNotReadyError extends SessionError {
+    constructor() {
+        super('Cannot start stream: session is not in ready state. Call send() first.');
+        this.name = 'SessionNotReadyError';
+    }
+}
+/** Error thrown when stream() is called while another stream is active */
+export class SessionAlreadyStreamingError extends SessionError {
+    constructor() {
+        super('Cannot start stream: another stream is already active');
+        this.name = 'SessionAlreadyStreamingError';
+    }
+}
+/** Error thrown when any operation is called on a closed session */
+export class SessionClosedError extends SessionError {
+    constructor() {
+        super('Session is closed');
+        this.name = 'SessionClosedError';
+    }
+}
+/**
+ * Session class for managing conversation state
+ *
+ * State machine:
+ *   [idle] --send()--> [ready]
+ *     ▲                  │
+ *     │                  ▼
+ *   [closed]          [running] --stream结束--> [idle]
+ *                        │
+ *                        ▼
+ *                     [error] --> [idle]
+ *
+ * Constraints:
+ * - send() can only be called in IDLE state
+ * - stream() can only be called in READY state
+ * - Only one stream can be active at a time
+ * - close() can be called in any state
+ */
+export class Session {
+    id;
+    model;
+    provider;
+    createdAt;
+    parentSessionId;
+    forkedAt;
+    _state;
+    loop;
+    messages;
+    isStreaming;
+    storage;
+    updatedAt;
+    constructor(loop, options, storage) {
+        this.id = options.id ?? generateUUID();
+        this.model = options.model;
+        this.provider = options.provider;
+        this.createdAt = Date.now();
+        this.updatedAt = this.createdAt;
+        this.parentSessionId = options.parentSessionId;
+        this.forkedAt = options.forkedAt;
+        this.loop = loop;
+        this.messages = [];
+        this._state = SessionState.IDLE;
+        this.isStreaming = false;
+        this.storage = storage;
+    }
+    /**
+     * Load a session from storage by ID
+     * @param id - Session ID to load
+     * @param storage - Storage implementation to use
+     * @param loop - ReActLoop instance for the session
+     * @returns Session instance or null if not found
+     */
+    static async loadFromStorage(id, storage, loop) {
+        const data = await storage.load(id);
+        if (!data) {
+            return null;
+        }
+        // Create session with loaded data including fork metadata
+        const session = new Session(loop, {
+            id: data.id,
+            model: data.model,
+            provider: data.provider,
+            parentSessionId: data.parentSessionId,
+            forkedAt: data.forkedAt,
+        }, storage);
+        // Restore message history and timestamps
+        session.messages = [...data.messages];
+        session.createdAt = data.createdAt;
+        session.updatedAt = data.updatedAt;
+        return session;
+    }
+    /**
+     * Save session data to storage
+     * @private
+     */
+    async saveToStorage() {
+        if (!this.storage) {
+            return;
+        }
+        this.updatedAt = Date.now();
+        const sessionData = {
+            id: this.id,
+            model: this.model,
+            provider: this.provider,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+            messages: [...this.messages],
+            options: {
+                model: this.model,
+                provider: this.provider,
+            },
+            parentSessionId: this.parentSessionId,
+            forkedAt: this.forkedAt,
+        };
+        await this.storage.save(sessionData);
+    }
+    /** Current state of the session */
+    get state() {
+        return this._state;
+    }
+    /**
+     * Send a user message to the session
+     * Transitions state from IDLE to READY
+     *
+     * @param message - User's message
+     * @throws {SessionNotIdleError} If session is not in IDLE state
+     * @throws {SessionClosedError} If session is closed
+     */
+    async send(message) {
+        if (this._state === SessionState.CLOSED) {
+            throw new SessionClosedError();
+        }
+        if (this._state !== SessionState.IDLE) {
+            throw new SessionNotIdleError();
+        }
+        // Create user message and add to history
+        const userMessage = {
+            type: 'user',
+            uuid: generateUUID(),
+            session_id: this.id,
+            message: { role: 'user', content: message },
+            parent_tool_use_id: null,
+        };
+        this.messages.push(userMessage);
+        this._state = SessionState.READY;
+    }
+    /**
+     * Stream the agent's response
+     * Transitions state from READY to RUNNING, then back to IDLE
+     *
+     * @returns AsyncGenerator yielding SDK messages
+     * @throws {SessionNotReadyError} If session is not in READY state
+     * @throws {SessionAlreadyStreamingError} If another stream is active
+     * @throws {SessionClosedError} If session is closed
+     */
+    async *stream() {
+        if (this._state === SessionState.CLOSED) {
+            throw new SessionClosedError();
+        }
+        if (this.isStreaming) {
+            throw new SessionAlreadyStreamingError();
+        }
+        if (this._state !== SessionState.READY) {
+            throw new SessionNotReadyError();
+        }
+        this._state = SessionState.RUNNING;
+        this.isStreaming = true;
+        try {
+            // Get the last user message
+            const lastUserMessage = this.messages[this.messages.length - 1];
+            if (lastUserMessage.type !== 'user') {
+                throw new SessionError('Expected last message to be from user');
+            }
+            const userPrompt = lastUserMessage.message.content;
+            // Pass history messages (excluding the current user message which will be added by runStream)
+            const historyMessages = this.messages.slice(0, -1);
+            logger.debug('[Session] historyMessages count:', historyMessages.length);
+            logger.debug('[Session] historyMessages:', JSON.stringify(historyMessages, null, 2));
+            // Run the ReAct loop and yield messages
+            for await (const event of this.loop.runStream(userPrompt, historyMessages)) {
+                switch (event.type) {
+                    case 'assistant':
+                        this.messages.push(event.message);
+                        yield event.message;
+                        break;
+                    case 'tool_result':
+                        this.messages.push(event.message);
+                        yield event.message;
+                        break;
+                    case 'usage':
+                        // Usage stats are tracked but not yielded as SDK messages
+                        break;
+                    case 'done':
+                        // Stream completed
+                        break;
+                }
+            }
+            this._state = SessionState.IDLE;
+        }
+        catch (error) {
+            this._state = SessionState.ERROR;
+            throw error;
+        }
+        finally {
+            this.isStreaming = false;
+            // If we were in ERROR state, transition back to IDLE for recovery
+            if (this._state === SessionState.ERROR) {
+                this._state = SessionState.IDLE;
+            }
+            // Save to storage after stream completes
+            if (this.storage) {
+                await this.saveToStorage();
+            }
+        }
+    }
+    /**
+     * Get a readonly copy of the message history
+     *
+     * @returns Readonly array of SDK messages
+     */
+    getMessages() {
+        return Object.freeze([...this.messages]);
+    }
+    /**
+     * Close the session
+     * Can be called from any state
+     */
+    async close() {
+        this._state = SessionState.CLOSED;
+        this.isStreaming = false;
+    }
+    /**
+     * Support for async dispose pattern (await using)
+     */
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+    /**
+     * Compact the conversation history to reduce token usage.
+     * Generates a summary of older messages and preserves recent rounds.
+     *
+     * @returns Result of the compaction operation
+     * @throws {SessionClosedError} If session is closed
+     */
+    async compact() {
+        if (this._state === SessionState.CLOSED) {
+            throw new SessionClosedError();
+        }
+        // Estimate token count (rough approximation)
+        const estimatedTokens = this.messages.reduce((total, msg) => {
+            if ('message' in msg && msg.message) {
+                if ('content' in msg.message) {
+                    if (typeof msg.message.content === 'string') {
+                        return total + msg.message.content.length / 4; // Rough estimate: 4 chars per token
+                    }
+                    else if (Array.isArray(msg.message.content)) {
+                        return total + msg.message.content.reduce((sum, c) => {
+                            if (c.type === 'text')
+                                return sum + c.text.length / 4;
+                            return sum + 50; // Tool calls estimate
+                        }, 0);
+                    }
+                }
+            }
+            return total + 50; // Default estimate for system/tool messages
+        }, 0);
+        const preTokens = Math.floor(estimatedTokens);
+        // Call the loop's compact method
+        const result = await this.loop.compact(this.messages, 'manual', preTokens);
+        if (!result.summaryGenerated) {
+            return {
+                success: false,
+                reason: 'nothing_to_compact',
+            };
+        }
+        // Update session messages with compacted version
+        this.messages = result.messages;
+        // Save to storage
+        if (this.storage) {
+            await this.saveToStorage();
+        }
+        return {
+            success: true,
+            preTokens: result.preTokens,
+            preservedRounds: result.preservedRounds,
+        };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

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

package/dist/session/storage.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Session storage interfaces and implementations
+ * Supports in-memory (default) and file-based persistence
+ */
+import type { SDKMessage } from '../types/messages';
+import type { PermissionMode } from '../permissions/types';
+import type { HooksConfig } from '../hooks/types';
+/** Session data structure for storage */
+export interface SessionData {
+    /** Unique session identifier */
+    id: string;
+    /** Model identifier (e.g., 'gpt-4o') */
+    model: string;
+    /** Provider identifier (e.g., 'openai') */
+    provider: string;
+    /** Session creation timestamp */
+    createdAt: number;
+    /** Last update timestamp */
+    updatedAt: number;
+    /** Message history */
+    messages: SDKMessage[];
+    /** Session options (excluding storage to avoid circular reference) */
+    options: Omit<SessionOptions, 'storage'>;
+    /** Parent session ID if this session was forked */
+    parentSessionId?: string;
+    /** Timestamp when this session was forked */
+    forkedAt?: number;
+}
+/** Session configuration options */
+export interface SessionOptions {
+    /** Model identifier (required) */
+    model: string;
+    /** Provider identifier (optional, defaults to auto-detect) */
+    provider?: string;
+    /** API key (optional, can use env var) */
+    apiKey?: string;
+    /** Maximum number of turns (optional) */
+    maxTurns?: number;
+    /** Allowed tool names (optional, defaults to all) */
+    allowedTools?: string[];
+    /** System prompt (optional) */
+    systemPrompt?: string;
+    /** Working directory (optional) */
+    cwd?: string;
+    /** Environment variables (optional) */
+    env?: Record<string, string>;
+    /** AbortController for cancellation (optional) */
+    abortController?: AbortController;
+    /** Storage implementation (optional, defaults to InMemoryStorage) */
+    storage?: SessionStorage;
+    /** Permission mode for the session (optional, default: 'default') */
+    permissionMode?: PermissionMode;
+    /** Required to be true when using bypassPermissions mode (optional) */
+    allowDangerouslySkipPermissions?: boolean;
+    /** MCP servers configuration (optional) */
+    mcpServers?: Record<string, unknown>;
+    /** Hooks configuration (optional) */
+    hooks?: HooksConfig;
+}
+/** Storage interface for session persistence */
+export interface SessionStorage {
+    /** Save session data */
+    save(data: SessionData): Promise<void>;
+    /** Load session by ID, returns null if not found */
+    load(id: string): Promise<SessionData | null>;
+    /** Delete session by ID */
+    delete(id: string): Promise<void>;
+    /** List all session IDs */
+    list(): Promise<string[]>;
+    /** Check if session exists */
+    exists(id: string): Promise<boolean>;
+}
+/** File storage options */
+export interface FileStorageOptions {
+    /** Directory path for session files (default: ~/.open-agent/sessions) */
+    directory?: string;
+}
+/**
+ * In-memory storage implementation (default)
+ * Data is lost when process exits
+ */
+export declare class InMemoryStorage implements SessionStorage {
+    private sessions;
+    save(data: SessionData): Promise<void>;
+    load(id: string): Promise<SessionData | null>;
+    delete(id: string): Promise<void>;
+    list(): Promise<string[]>;
+    exists(id: string): Promise<boolean>;
+}
+/**
+ * File-based storage implementation
+ * Persists sessions to JSON files
+ */
+export declare class FileStorage implements SessionStorage {
+    private directory;
+    constructor(options?: FileStorageOptions);
+    private getFilePath;
+    save(data: SessionData): Promise<void>;
+    load(id: string): Promise<SessionData | null>;
+    delete(id: string): Promise<void>;
+    list(): Promise<string[]>;
+    exists(id: string): Promise<boolean>;
+    private ensureDir;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/session/storage.d.ts.map

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