@intella/sdk 0.0.7 → 0.0.9

package/dist/session/execution-store.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Execution History Module
+ *
+ * Handles persisting execution records (task requests and responses) to:
+ * 1. File-based storage (always)
+ * 2. Redis (when REDIS_URL is set)
+ *
+ * This is separate from app segments - it's a local record of what was
+ * executed for sync-back and context restoration.
+ */
+import type { ExecutionRecord } from '../types.js';
+/**
+ * Get the execution history file path for a session
+ */
+export declare function getExecutionHistoryPath(sessionId: string): string;
+/**
+ * Append an execution record to the file-based history
+ * Uses NDJSON format (one JSON object per line) for append-only writes
+ */
+export declare function appendExecutionToFile(record: ExecutionRecord): void;
+/**
+ * Read all execution records from file for a session
+ */
+export declare function readExecutionsFromFile(sessionId: string): ExecutionRecord[];
+/**
+ * Get the last N execution records from file
+ */
+export declare function getLastExecutions(sessionId: string, limit?: number): ExecutionRecord[];
+/**
+ * Append an execution record to Redis
+ * Uses RPUSH to append to a list: session:{sessionId}:executions
+ */
+export declare function appendExecutionToRedis(record: ExecutionRecord, redisUrl?: string): Promise<void>;
+/**
+ * Read execution records from Redis for a session
+ */
+export declare function readExecutionsFromRedis(sessionId: string, redisUrl?: string): Promise<ExecutionRecord[]>;
+/**
+ * Sync execution history from Redis to local file
+ * Used when a new sandbox needs to restore session context
+ */
+export declare function syncExecutionsFromRedis(sessionId: string, redisUrl?: string): Promise<ExecutionRecord[]>;
+/**
+ * Append an execution record to both file and Redis (if configured)
+ * This is the main function to call when an execution completes
+ */
+export declare function appendExecution(record: ExecutionRecord, redisUrl?: string): Promise<void>;
+/**
+ * Generate a unique execution ID
+ */
+export declare function generateExecutionId(): string;
+/**
+ * Build an ExecutionRecord from agent execution data
+ */
+export declare function buildExecutionRecord(params: {
+    sessionId: string;
+    prompt?: string;
+    systemPrompt?: string;
+    agentType?: string;
+    model?: string;
+    response: string;
+    chunks?: Array<{
+        text: string;
+        timestamp: number;
+    }>;
+    startedAt: number;
+    completedAt: number;
+    commandId?: string;
+    segmentId?: string;
+}): ExecutionRecord;
+//# sourceMappingURL=execution-store.d.ts.map

package/dist/session/execution-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-store.d.ts","sourceRoot":"","sources":["../../src/session/execution-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAYD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAMnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CAe3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,eAAe,EAAE,CAG1F;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAc5B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAc5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,CAiBlB"}

package/dist/session/execution-store.js

@@ -0,0 +1,156 @@
+/**
+ * Execution History Module
+ *
+ * Handles persisting execution records (task requests and responses) to:
+ * 1. File-based storage (always)
+ * 2. Redis (when REDIS_URL is set)
+ *
+ * This is separate from app segments - it's a local record of what was
+ * executed for sync-back and context restoration.
+ */
+import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { getRedisClient } from '../utils/redis/client.js';
+import { getSessionsDir } from './manager.js';
+/**
+ * Get the execution history file path for a session
+ */
+export function getExecutionHistoryPath(sessionId) {
+    return join(getSessionsDir(), sessionId, 'executions.jsonl');
+}
+/**
+ * Ensure the session directory exists
+ */
+function ensureSessionDir(sessionId) {
+    const sessionDir = join(getSessionsDir(), sessionId);
+    if (!existsSync(sessionDir)) {
+        mkdirSync(sessionDir, { recursive: true });
+    }
+}
+/**
+ * Append an execution record to the file-based history
+ * Uses NDJSON format (one JSON object per line) for append-only writes
+ */
+export function appendExecutionToFile(record) {
+    ensureSessionDir(record.sessionId);
+    const historyPath = getExecutionHistoryPath(record.sessionId);
+    const line = JSON.stringify(record) + '\n';
+    appendFileSync(historyPath, line, 'utf-8');
+}
+/**
+ * Read all execution records from file for a session
+ */
+export function readExecutionsFromFile(sessionId) {
+    const historyPath = getExecutionHistoryPath(sessionId);
+    if (!existsSync(historyPath)) {
+        return [];
+    }
+    try {
+        const content = readFileSync(historyPath, 'utf-8');
+        const lines = content.trim().split('\n').filter(line => line.trim());
+        return lines.map(line => JSON.parse(line));
+    }
+    catch (error) {
+        console.error('Error reading execution history:', error);
+        return [];
+    }
+}
+/**
+ * Get the last N execution records from file
+ */
+export function getLastExecutions(sessionId, limit = 10) {
+    const all = readExecutionsFromFile(sessionId);
+    return all.slice(-limit);
+}
+/**
+ * Append an execution record to Redis
+ * Uses RPUSH to append to a list: session:{sessionId}:executions
+ */
+export async function appendExecutionToRedis(record, redisUrl) {
+    const client = await getRedisClient(redisUrl);
+    if (!client) {
+        return;
+    }
+    try {
+        const key = `session:${record.sessionId}:executions`;
+        const value = JSON.stringify(record);
+        await client.rPush(key, value);
+        const ttl = await client.ttl(key);
+        if (ttl === -1) {
+            await client.expire(key, 7 * 24 * 60 * 60);
+        }
+        await client.lTrim(key, -100, -1);
+    }
+    catch (error) {
+        console.error('Error appending execution to Redis:', error);
+    }
+}
+/**
+ * Read execution records from Redis for a session
+ */
+export async function readExecutionsFromRedis(sessionId, redisUrl) {
+    const client = await getRedisClient(redisUrl);
+    if (!client) {
+        return [];
+    }
+    try {
+        const key = `session:${sessionId}:executions`;
+        const values = await client.lRange(key, 0, -1);
+        return values.map((v) => JSON.parse(v));
+    }
+    catch (error) {
+        console.error('Error reading executions from Redis:', error);
+        return [];
+    }
+}
+/**
+ * Sync execution history from Redis to local file
+ * Used when a new sandbox needs to restore session context
+ */
+export async function syncExecutionsFromRedis(sessionId, redisUrl) {
+    const records = await readExecutionsFromRedis(sessionId, redisUrl);
+    if (records.length === 0) {
+        return [];
+    }
+    ensureSessionDir(sessionId);
+    const historyPath = getExecutionHistoryPath(sessionId);
+    const content = records.map(r => JSON.stringify(r)).join('\n') + '\n';
+    writeFileSync(historyPath, content, 'utf-8');
+    return records;
+}
+/**
+ * Append an execution record to both file and Redis (if configured)
+ * This is the main function to call when an execution completes
+ */
+export async function appendExecution(record, redisUrl) {
+    appendExecutionToFile(record);
+    await appendExecutionToRedis(record, redisUrl);
+}
+/**
+ * Generate a unique execution ID
+ */
+export function generateExecutionId() {
+    return `exec-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Build an ExecutionRecord from agent execution data
+ */
+export function buildExecutionRecord(params) {
+    return {
+        id: generateExecutionId(),
+        sessionId: params.sessionId,
+        taskRequest: {
+            prompt: params.prompt,
+            systemPrompt: params.systemPrompt,
+            agentType: params.agentType,
+            model: params.model,
+        },
+        response: params.response,
+        chunks: params.chunks,
+        startedAt: params.startedAt,
+        completedAt: params.completedAt,
+        commandId: params.commandId,
+        segmentId: params.segmentId,
+    };
+}
+//# sourceMappingURL=execution-store.js.map

package/dist/session/execution-store.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Session Module
+ *
+ * Provides session management for both local and sandbox modes.
+ */
+export { SessionManager } from './manager.js';
+export type { CreateLocalSessionOptions } from './types.js';
+export type { CreateRemoteSessionOptions } from './types.js';
+export type { ListSessionsOptions } from './types.js';
+export type { EndSessionOptions } from './types.js';
+export { createSession, endSession, createLocalSession, endLocalSession, getSession, updateSession, deleteSession, listSessions, getActiveSession, getSessionsDir, getSessionWorkspaceDir, } from './manager.js';
+export { saveSessionToRedis, getSessionFromRedis, deleteSessionFromRedis } from './store.js';
+export { getExecutionHistoryPath, appendExecutionToFile, readExecutionsFromFile, getLastExecutions, appendExecutionToRedis, readExecutionsFromRedis, syncExecutionsFromRedis, appendExecution, generateExecutionId, buildExecutionRecord, } from './execution-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,YAAY,EACV,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAEL,aAAa,EACb,UAAU,EAGV,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGhB,cAAc,EACd,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG7F,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,20 @@
+/**
+ * Session Module
+ *
+ * Provides session management for both local and sandbox modes.
+ */
+// Export the SessionManager class
+export { SessionManager } from './manager.js';
+// Export standalone functions (for backward compatibility)
+export { 
+// Main API (multi-mode)
+createSession, endSession, 
+// Local session management
+createLocalSession, endLocalSession, getSession, updateSession, deleteSession, listSessions, getActiveSession, 
+// Directory utilities
+getSessionsDir, getSessionWorkspaceDir, } from './manager.js';
+// Session Redis store (for restore/sync)
+export { saveSessionToRedis, getSessionFromRedis, deleteSessionFromRedis } from './store.js';
+// Execution history (task requests and responses)
+export { getExecutionHistoryPath, appendExecutionToFile, readExecutionsFromFile, getLastExecutions, appendExecutionToRedis, readExecutionsFromRedis, syncExecutionsFromRedis, appendExecution, generateExecutionId, buildExecutionRecord, } from './execution-store.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kCAAkC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAS9C,2DAA2D;AAC3D,OAAO;AACL,wBAAwB;AACxB,aAAa,EACb,UAAU;AAEV,2BAA2B;AAC3B,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB;AAEhB,sBAAsB;AACtB,cAAc,EACd,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,yCAAyC;AACzC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE7F,kDAAkD;AAClD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/session/manager.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Session Manager
+ *
+ * Provides session management for both local and sandbox modes.
+ * Local mode: Creates and manages sessions on the current machine.
+ * Sandbox mode: Publishes session:init commands to an already-running sandbox daemon.
+ */
+import type { SessionMetadata, CreateSessionOptions, CreateSessionResult } from '../types.js';
+import { CreateLocalSessionOptions, ListSessionsOptions, CreateRemoteSessionOptions, EndSessionOptions } from './types.js';
+/**
+ * Get the sessions directory path
+ */
+export declare function getSessionsDir(): string;
+/**
+ * Get the workspace directory path for a specific session
+ */
+export declare function getSessionWorkspaceDir(sessionId: string): string;
+/**
+ * SessionManager class for managing sessions locally and remotely.
+ *
+ * @example
+ * ```typescript
+ * const manager = new SessionManager();
+ *
+ * // Create a local session
+ * const session = manager.createLocal({ agentType: AgentType.CLAUDE });
+ *
+ * // Get a session
+ * const retrieved = manager.get(session.id);
+ *
+ * // List active sessions
+ * const sessions = manager.list({ status: 'active' });
+ *
+ * // End a session
+ * manager.end(session.id);
+ * ```
+ */
+export declare class SessionManager {
+    /**
+     * Create a new SessionManager instance
+     */
+    constructor();
+    /**
+     * Create a local session
+     */
+    createLocal(options: CreateLocalSessionOptions): Promise<SessionMetadata>;
+    /**
+     * Get a session by ID.
+     * Tries local file first; if not found, checks Redis.
+     */
+    get(sessionId: string): Promise<SessionMetadata | null>;
+    /**
+     * Update a session
+     */
+    update(sessionId: string, updates: Partial<SessionMetadata>): Promise<SessionMetadata | null>;
+    /**
+     * End a local session (mark as ended)
+     */
+    endLocal(sessionId: string): Promise<SessionMetadata | null>;
+    /**
+     * Delete a session completely (file and workspace)
+     */
+    delete(sessionId: string): Promise<boolean>;
+    /**
+     * List all sessions
+     */
+    list(options?: ListSessionsOptions): SessionMetadata[];
+    /**
+     * Get the active session (most recent active session)
+     */
+    getActive(): SessionMetadata | null;
+    /**
+     * Create a remote session by publishing session:init to a sandbox daemon.
+     *
+     * This method sends a session:init command to a running sandbox daemon,
+     * which will create the session locally within the sandbox and optionally
+     * run setup steps (git clone, npm install, etc.).
+     *
+     * @param options - Remote session creation options
+     * @returns Session and command ID
+     *
+     * @example
+     * ```typescript
+     * const result = await sessionManager.createRemote({
+     *   sandboxId: 'sandbox-123',
+     *   agentType: AgentType.CLAUDE,
+     *   model: 'sonnet',
+     *   sandboxProvider: SandboxProviderType.E2B,
+     *   setup: {
+     *     gitClone: [{ url: 'https://github.com/user/repo.git' }],
+     *   },
+     * });
+     * console.log('Session created:', result.session.id);
+     * ```
+     */
+    createRemote(options: CreateRemoteSessionOptions): Promise<CreateSessionResult>;
+    /**
+     * End a remote session by publishing session:end to a sandbox daemon.
+     *
+     * @param sandboxId - Sandbox ID where the session is running
+     * @param sessionId - Session ID to end
+     * @param timeout - Timeout for waiting (in ms, default: 30 seconds)
+     */
+    endRemote(sandboxId: string, sessionId: string, timeout?: number): Promise<SessionMetadata | null>;
+    /**
+     * Create a session with the specified mode
+     *
+     * @param options - Session creation options
+     * @returns Session and optional command ID (for sandbox mode)
+     */
+    create(options: CreateSessionOptions): Promise<CreateSessionResult>;
+    /**
+     * End a session (local or sandbox mode)
+     *
+     * @param sessionId - Session ID to end
+     * @param options - Optional sandbox config for remote session end
+     */
+    end(sessionId: string, options?: EndSessionOptions): Promise<SessionMetadata | null>;
+    /**
+     * Get the workspace directory for a session
+     */
+    getWorkspaceDir(sessionId: string): string;
+    /**
+     * Get the sessions directory
+     */
+    getSessionsDir(): string;
+}
+/**
+ * Create a local session
+ */
+export declare function createLocalSession(options: CreateLocalSessionOptions): Promise<SessionMetadata>;
+/**
+ * Get a session by ID
+ */
+export declare function getSession(sessionId: string): Promise<SessionMetadata | null>;
+/**
+ * Update a session
+ */
+export declare function updateSession(sessionId: string, updates: Partial<SessionMetadata>): Promise<SessionMetadata | null>;
+/**
+ * End a local session
+ */
+export declare function endLocalSession(sessionId: string): Promise<SessionMetadata | null>;
+/**
+ * Delete a session
+ */
+export declare function deleteSession(sessionId: string): Promise<boolean>;
+/**
+ * List sessions
+ */
+export declare function listSessions(options?: ListSessionsOptions): SessionMetadata[];
+/**
+ * Get the active session
+ */
+export declare function getActiveSession(): SessionMetadata | null;
+/**
+ * Create a session (multi-mode)
+ */
+export declare function createSession(options: CreateSessionOptions): Promise<CreateSessionResult>;
+/**
+ * End a session (multi-mode)
+ */
+export declare function endSession(sessionId: string, options?: EndSessionOptions): Promise<SessionMetadata | null>;
+//# sourceMappingURL=manager.d.ts.map

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

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