@yolo-labs/core-agent-service 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,178 @@
+import { AIProvider, ToolRegistry, SandboxContext, GenerationRequest, SessionEvent, SessionStore, Message, GenerationSession } from '@yolo-labs/core-types';
+
+/**
+ * Configuration for retry behavior on transient AI provider errors.
+ *
+ * @remarks
+ * Uses exponential backoff: delay = `backoffMs * backoffMultiplier^(attempt-1)`.
+ * The optional `retryableErrors` array restricts which error codes trigger retries.
+ */
+interface RetryPolicy {
+    maxRetries: number;
+    backoffMs: number;
+    backoffMultiplier: number;
+    retryableErrors?: string[];
+}
+/**
+ * Top-level configuration for the agent service.
+ *
+ * @remarks
+ * Controls the agent loop's behavior: `maxTurns` prevents infinite loops,
+ * `maxTokens` caps each AI request, `timeout` sets a per-request deadline,
+ * and `retryPolicy` governs retries on transient errors. Optional
+ * `eventFilters` can restrict which event types are emitted.
+ */
+interface AgentServiceConfig {
+    maxTurns: number;
+    maxTokens: number;
+    timeout: number;
+    retryPolicy: RetryPolicy;
+    eventFilters?: string[];
+}
+/**
+ * Default agent service configuration.
+ *
+ * @remarks
+ * maxTurns: 25, maxTokens: 4096, timeout: 120 s, retries: 2 with exponential backoff.
+ */
+declare const defaultConfig: AgentServiceConfig;
+
+/**
+ * Configuration options for the agent loop.
+ *
+ * @remarks
+ * At minimum, a `provider` must be supplied. Provide `toolRegistry` and
+ * `sandboxContext` to enable tool execution during the agentic loop.
+ * The optional `config` merges with {@link defaultConfig} defaults.
+ * Pass an `AbortSignal` to enable external cancellation of the loop.
+ */
+interface AgentLoopOptions {
+    provider: AIProvider;
+    toolRegistry?: ToolRegistry;
+    sandboxContext?: SandboxContext;
+    config?: Partial<AgentServiceConfig>;
+    /** Optional signal to abort the agent loop externally (e.g. on interrupt). */
+    signal?: AbortSignal;
+}
+/**
+ * Core agentic loop that orchestrates AI calls, tool execution, and event streaming.
+ *
+ * @param request - The generation request containing the user prompt and settings.
+ * @param options - Provider, tool registry, sandbox context, and config overrides.
+ * @returns An async generator yielding {@link SessionEvent} objects as the agent works.
+ *
+ * @remarks
+ * The loop calls the AI provider, streams content deltas, detects tool use blocks,
+ * executes tools via the registry, feeds results back, and repeats until the AI
+ * signals `end_turn` or the configured `maxTurns` is reached. Errors are emitted
+ * as `error` events and the loop terminates with an `agent_complete` event.
+ *
+ * @example
+ * ```ts
+ * for await (const event of agentLoop(request, options)) {
+ *   if (event.type === 'text_delta') process.stdout.write(event.text);
+ * }
+ * ```
+ */
+declare function agentLoop(request: GenerationRequest, options: AgentLoopOptions): AsyncGenerator<SessionEvent>;
+
+/**
+ * Options for constructing a SessionManager.
+ *
+ * @remarks
+ * The `maxHistoryLength` controls when truncation kicks in (default 100).
+ * Supply `onTruncate` for custom summarization; otherwise oldest messages
+ * are dropped.
+ */
+interface SessionManagerOptions {
+    store: SessionStore;
+    maxHistoryLength?: number;
+    onTruncate?: (messages: Message[]) => Promise<Message[]>;
+}
+/**
+ * Manages session lifecycle, event logging, and conversation history.
+ *
+ * @remarks
+ * Wraps a {@link SessionStore} implementation to provide higher-level
+ * operations: session creation from a request, event append, session
+ * resumption, and automatic history truncation.
+ */
+declare class SessionManager {
+    private store;
+    private maxHistoryLength;
+    private onTruncate?;
+    constructor(options: SessionManagerOptions);
+    /**
+     * Creates a new session from a generation request.
+     *
+     * @param request - The generation request to create a session for.
+     * @param userId - Optional user ID to associate with the session.
+     * @returns The newly created {@link GenerationSession}.
+     */
+    createSession(request: GenerationRequest, userId?: string): Promise<GenerationSession>;
+    /**
+     * Appends a session event to the session's event log.
+     *
+     * @param sessionId - The session to append the event to.
+     * @param event - The {@link SessionEvent} to record.
+     */
+    appendEvent(sessionId: string, event: SessionEvent): Promise<void>;
+    /**
+     * Resumes an existing session, returning the session and events emitted since a given point.
+     *
+     * @param sessionId - The session to resume.
+     * @param sinceEventId - Optional event ID to replay from. Returns all events if omitted.
+     * @returns The session object and the events since the specified event ID.
+     * @throws Error if the session does not exist.
+     */
+    resumeSession(sessionId: string, sinceEventId?: string): Promise<{
+        session: GenerationSession;
+        events: SessionEvent[];
+    }>;
+    /** Retrieves the conversation history for a given session. */
+    getConversationHistory(sessionId: string): Promise<Message[]>;
+    /**
+     * Updates conversation history, applying truncation if it exceeds the configured max length.
+     *
+     * @param sessionId - The session to update.
+     * @param messages - The full updated conversation history.
+     *
+     * @remarks
+     * If the history exceeds `maxHistoryLength`, the custom `onTruncate` hook
+     * is called if provided; otherwise the oldest messages are dropped.
+     */
+    updateConversationHistory(sessionId: string, messages: Message[]): Promise<void>;
+    /** Retrieves a session by ID, or undefined if not found. */
+    getSession(sessionId: string): Promise<GenerationSession | undefined>;
+    /** Deletes a session and its associated data from the store. */
+    deleteSession(sessionId: string): Promise<void>;
+}
+
+/**
+ * In-memory implementation of {@link SessionStore} using Maps.
+ *
+ * @remarks
+ * Suitable for development, testing, and single-process deployments.
+ * All data is lost when the process exits. For persistent storage,
+ * implement a custom {@link SessionStore} backed by a database.
+ */
+declare class InMemorySessionStore implements SessionStore {
+    private sessions;
+    private events;
+    /** Creates a new session with a generated ID and timestamps. */
+    create(session: Omit<GenerationSession, 'id' | 'createdAt' | 'updatedAt'>): Promise<GenerationSession>;
+    /** Retrieves a session by ID, or undefined if not found. */
+    get(id: string): Promise<GenerationSession | undefined>;
+    /** Merges partial updates into an existing session, preserving ID and createdAt. */
+    update(id: string, updates: Partial<GenerationSession>): Promise<GenerationSession>;
+    /** Deletes a session and its associated events. */
+    delete(id: string): Promise<void>;
+    /** Lists all sessions belonging to a given user. */
+    listByUser(userId: string): Promise<GenerationSession[]>;
+    /** Appends an event to the session's event log. */
+    appendEvent(sessionId: string, event: SessionEvent): Promise<void>;
+    /** Returns events for a session, optionally starting from a given event index. */
+    getEventsSince(sessionId: string, eventId?: string): Promise<SessionEvent[]>;
+}
+
+export { type AgentLoopOptions, type AgentServiceConfig, InMemorySessionStore, type RetryPolicy, SessionManager, type SessionManagerOptions, agentLoop, defaultConfig };

package/dist/index.js

@@ -0,0 +1,613 @@
+// src/config.ts
+var defaultConfig = {
+  maxTurns: 25,
+  maxTokens: 4096,
+  timeout: 12e4,
+  retryPolicy: {
+    maxRetries: 2,
+    backoffMs: 1e3,
+    backoffMultiplier: 2
+  }
+};
+
+// src/agent-loop.ts
+async function* agentLoop(request, options) {
+  const config = { ...defaultConfig, ...options.config };
+  const { provider, toolRegistry, sandboxContext, signal } = options;
+  const sessionId = request.sessionId ?? crypto.randomUUID();
+  yield {
+    type: "agent_start",
+    sessionId,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const messages = [];
+  if (request.context?.conversationHistory) {
+    messages.push(...request.context.conversationHistory);
+  }
+  messages.push({ role: "user", content: request.prompt });
+  const tools = toolRegistry?.toAIToolDefinitions() ?? request.tools ?? [];
+  let turn = 0;
+  let totalInputTokens = 0;
+  let totalOutputTokens = 0;
+  try {
+    while (turn < config.maxTurns) {
+      turn++;
+      if (signal?.aborted) {
+        yield {
+          type: "error",
+          error: "Agent loop aborted",
+          code: "ABORTED",
+          recoverable: false
+        };
+        yield {
+          type: "agent_complete",
+          sessionId,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+        };
+        return;
+      }
+      const params = {
+        model: request.model ?? "claude-sonnet-4-20250514",
+        messages,
+        system: request.system,
+        tools: tools.length > 0 ? tools : void 0,
+        maxTokens: request.maxTokens ?? config.maxTokens,
+        temperature: request.temperature,
+        metadata: request.metadata
+      };
+      const assistantContentBlocks = [];
+      const pendingToolCalls = [];
+      let currentBlockType = null;
+      let currentBlockId;
+      let currentBlockName;
+      let currentInputJson = "";
+      let stopReason = null;
+      let requestRetries = 0;
+      let stream;
+      while (true) {
+        try {
+          stream = provider.createMessage(params);
+          break;
+        } catch (err) {
+          if (requestRetries >= config.retryPolicy.maxRetries) {
+            yield {
+              type: "error",
+              error: err instanceof Error ? err.message : String(err),
+              code: "AI_REQUEST_FAILED",
+              recoverable: false
+            };
+            yield {
+              type: "agent_complete",
+              sessionId,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+            };
+            return;
+          }
+          requestRetries++;
+          const delay = config.retryPolicy.backoffMs * Math.pow(config.retryPolicy.backoffMultiplier, requestRetries - 1);
+          await sleep(delay);
+        }
+      }
+      let streamRetries = 0;
+      let streamSuccess = false;
+      while (!streamSuccess) {
+        assistantContentBlocks.length = 0;
+        pendingToolCalls.length = 0;
+        currentBlockType = null;
+        currentBlockId = void 0;
+        currentBlockName = void 0;
+        currentInputJson = "";
+        stopReason = null;
+        try {
+          const streamIterable = streamRetries > 0 ? provider.createMessage(params) : stream;
+          const timedStream = config.timeout > 0 ? withTimeout(streamIterable, config.timeout, signal) : streamIterable;
+          for await (const event of timedStream) {
+            if (signal?.aborted) {
+              yield {
+                type: "error",
+                error: "Agent loop aborted",
+                code: "ABORTED",
+                recoverable: false
+              };
+              yield {
+                type: "agent_complete",
+                sessionId,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+              };
+              return;
+            }
+            switch (event.type) {
+              case "content_block_start": {
+                currentBlockType = event.contentBlock.type;
+                currentBlockId = event.contentBlock.id;
+                currentBlockName = event.contentBlock.name;
+                currentInputJson = "";
+                if (currentBlockType === "tool_use" && currentBlockId && currentBlockName) {
+                }
+                break;
+              }
+              case "content_block_delta": {
+                if (event.delta.type === "text_delta") {
+                  yield { type: "text_delta", text: event.delta.text };
+                  const lastBlock = assistantContentBlocks[assistantContentBlocks.length - 1];
+                  if (lastBlock && lastBlock.type === "text") {
+                    lastBlock.text += event.delta.text;
+                  } else {
+                    assistantContentBlocks.push({ type: "text", text: event.delta.text });
+                  }
+                } else if (event.delta.type === "thinking_delta") {
+                  yield { type: "thought_delta", text: event.delta.thinking };
+                } else if (event.delta.type === "input_json_delta") {
+                  currentInputJson += event.delta.partial_json;
+                  yield {
+                    type: "tool_input_delta",
+                    toolCallId: currentBlockId ?? "",
+                    partialInput: event.delta.partial_json
+                  };
+                }
+                break;
+              }
+              case "content_block_stop": {
+                if (currentBlockType === "tool_use" && currentBlockId) {
+                  pendingToolCalls.push({
+                    id: currentBlockId,
+                    name: currentBlockName ?? "",
+                    inputJson: currentInputJson
+                  });
+                }
+                currentBlockType = null;
+                currentBlockId = void 0;
+                currentBlockName = void 0;
+                currentInputJson = "";
+                break;
+              }
+              case "message_delta": {
+                stopReason = event.delta.stop_reason;
+                if (event.usage) {
+                  totalOutputTokens += event.usage.output_tokens;
+                }
+                break;
+              }
+              case "message_start": {
+                if (event.message.usage) {
+                  totalInputTokens += event.message.usage.input_tokens;
+                }
+                break;
+              }
+              case "message_stop":
+                break;
+              case "error": {
+                yield {
+                  type: "error",
+                  error: event.error.message,
+                  code: event.error.type,
+                  recoverable: false
+                };
+                break;
+              }
+            }
+          }
+          streamSuccess = true;
+        } catch (err) {
+          const errMsg = err instanceof Error ? err.message : String(err);
+          const isTimeout = errMsg === "TIMEOUT";
+          const isAbort = signal?.aborted;
+          if (isAbort) {
+            yield {
+              type: "error",
+              error: "Agent loop aborted",
+              code: "ABORTED",
+              recoverable: false
+            };
+            yield {
+              type: "agent_complete",
+              sessionId,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+            };
+            return;
+          }
+          if (isTimeout) {
+            yield {
+              type: "error",
+              error: `Request timed out after ${config.timeout}ms`,
+              code: "TIMEOUT",
+              recoverable: false
+            };
+            yield {
+              type: "agent_complete",
+              sessionId,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+            };
+            return;
+          }
+          if (streamRetries < config.retryPolicy.maxRetries) {
+            streamRetries++;
+            const delay = config.retryPolicy.backoffMs * Math.pow(config.retryPolicy.backoffMultiplier, streamRetries - 1);
+            yield {
+              type: "error",
+              error: errMsg,
+              code: "STREAM_ERROR",
+              recoverable: true
+            };
+            await sleep(delay);
+            continue;
+          }
+          yield {
+            type: "error",
+            error: errMsg,
+            code: "STREAM_ERROR",
+            recoverable: false
+          };
+          yield {
+            type: "agent_complete",
+            sessionId,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+            usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+          };
+          return;
+        }
+      }
+      const fullAssistantContent = [...assistantContentBlocks];
+      for (const tc of pendingToolCalls) {
+        let parsedInput = {};
+        try {
+          parsedInput = tc.inputJson ? JSON.parse(tc.inputJson) : {};
+        } catch {
+        }
+        const toolUseBlock = {
+          type: "tool_use",
+          id: tc.id,
+          name: tc.name,
+          input: parsedInput
+        };
+        fullAssistantContent.push(toolUseBlock);
+      }
+      if (fullAssistantContent.length > 0) {
+        messages.push({ role: "assistant", content: fullAssistantContent });
+      }
+      if (signal?.aborted) {
+        yield {
+          type: "error",
+          error: "Agent loop aborted",
+          code: "ABORTED",
+          recoverable: false
+        };
+        yield {
+          type: "agent_complete",
+          sessionId,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+        };
+        return;
+      }
+      if (pendingToolCalls.length > 0 && toolRegistry && sandboxContext) {
+        const toolResults = [];
+        for (const tc of pendingToolCalls) {
+          if (signal?.aborted) {
+            break;
+          }
+          let parsedInput = {};
+          try {
+            parsedInput = tc.inputJson ? JSON.parse(tc.inputJson) : {};
+          } catch {
+            yield {
+              type: "error",
+              error: `Failed to parse tool input JSON for ${tc.name}`,
+              code: "TOOL_INPUT_PARSE_ERROR",
+              recoverable: true
+            };
+            toolResults.push({
+              content: JSON.stringify({ error: "Failed to parse tool input JSON" }),
+              isError: true
+            });
+            continue;
+          }
+          yield {
+            type: "tool_call",
+            toolCallId: tc.id,
+            name: tc.name,
+            input: parsedInput
+          };
+          const tool = toolRegistry.get(tc.name);
+          if (!tool) {
+            const errorResult = {
+              type: "tool_result",
+              toolCallId: tc.id,
+              name: tc.name,
+              success: false,
+              output: null,
+              error: `Tool '${tc.name}' not found in registry`
+            };
+            yield errorResult;
+            toolResults.push({
+              content: JSON.stringify({ error: `Tool '${tc.name}' not found` }),
+              isError: true
+            });
+            continue;
+          }
+          try {
+            const result = await tool.execute(
+              parsedInput,
+              sandboxContext,
+              (progress) => {
+              }
+            );
+            yield {
+              type: "tool_result",
+              toolCallId: tc.id,
+              name: tc.name,
+              success: result.success,
+              output: result.output,
+              error: result.error
+            };
+            toolResults.push({
+              content: typeof result.output === "string" ? result.output : JSON.stringify(result.output),
+              isError: false
+            });
+          } catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            yield {
+              type: "tool_result",
+              toolCallId: tc.id,
+              name: tc.name,
+              success: false,
+              output: null,
+              error: errorMsg
+            };
+            toolResults.push({
+              content: JSON.stringify({ error: errorMsg }),
+              isError: true
+            });
+          }
+        }
+        const toolResultBlocks = toolResults.map((r, i) => ({
+          type: "tool_result",
+          tool_use_id: pendingToolCalls[i].id,
+          content: r.content,
+          ...r.isError ? { is_error: true } : {}
+        }));
+        messages.push({ role: "user", content: toolResultBlocks });
+        continue;
+      }
+      if (stopReason === "end_turn" || stopReason === "stop" || pendingToolCalls.length === 0) {
+        yield {
+          type: "agent_complete",
+          sessionId,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+        };
+        return;
+      }
+    }
+    yield {
+      type: "error",
+      error: `Max turns (${config.maxTurns}) exceeded`,
+      code: "MAX_TURNS_EXCEEDED",
+      recoverable: false
+    };
+    yield {
+      type: "agent_complete",
+      sessionId,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+    };
+  } catch (err) {
+    yield {
+      type: "error",
+      error: err instanceof Error ? err.message : String(err),
+      code: "AGENT_LOOP_ERROR",
+      recoverable: false
+    };
+    yield {
+      type: "agent_complete",
+      sessionId,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn }
+    };
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function* withTimeout(iterable, timeoutMs, signal) {
+  const iterator = iterable[Symbol.asyncIterator]();
+  const timeoutError = new Error("TIMEOUT");
+  while (true) {
+    const timeoutPromise = new Promise((_, reject) => {
+      const timer = setTimeout(() => reject(timeoutError), timeoutMs);
+      if (signal) {
+        const onAbort = () => {
+          clearTimeout(timer);
+          reject(new Error("ABORTED"));
+        };
+        if (signal.aborted) {
+          clearTimeout(timer);
+          reject(new Error("ABORTED"));
+        } else {
+          signal.addEventListener("abort", onAbort, { once: true });
+        }
+      }
+    });
+    const result = await Promise.race([
+      iterator.next(),
+      timeoutPromise
+    ]);
+    if (result.done) break;
+    yield result.value;
+  }
+}
+
+// src/session-manager.ts
+var SessionManager = class {
+  store;
+  maxHistoryLength;
+  onTruncate;
+  constructor(options) {
+    this.store = options.store;
+    this.maxHistoryLength = options.maxHistoryLength ?? 100;
+    this.onTruncate = options.onTruncate;
+  }
+  /**
+   * Creates a new session from a generation request.
+   *
+   * @param request - The generation request to create a session for.
+   * @param userId - Optional user ID to associate with the session.
+   * @returns The newly created {@link GenerationSession}.
+   */
+  async createSession(request, userId) {
+    return this.store.create({
+      userId,
+      conversationHistory: [],
+      toolCallLog: [],
+      metadata: request.metadata ?? {}
+    });
+  }
+  /**
+   * Appends a session event to the session's event log.
+   *
+   * @param sessionId - The session to append the event to.
+   * @param event - The {@link SessionEvent} to record.
+   */
+  async appendEvent(sessionId, event) {
+    await this.store.appendEvent(sessionId, event);
+  }
+  /**
+   * Resumes an existing session, returning the session and events emitted since a given point.
+   *
+   * @param sessionId - The session to resume.
+   * @param sinceEventId - Optional event ID to replay from. Returns all events if omitted.
+   * @returns The session object and the events since the specified event ID.
+   * @throws Error if the session does not exist.
+   */
+  async resumeSession(sessionId, sinceEventId) {
+    const session = await this.store.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const events = await this.store.getEventsSince(sessionId, sinceEventId);
+    return { session, events };
+  }
+  /** Retrieves the conversation history for a given session. */
+  async getConversationHistory(sessionId) {
+    const session = await this.store.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    return session.conversationHistory;
+  }
+  /**
+   * Updates conversation history, applying truncation if it exceeds the configured max length.
+   *
+   * @param sessionId - The session to update.
+   * @param messages - The full updated conversation history.
+   *
+   * @remarks
+   * If the history exceeds `maxHistoryLength`, the custom `onTruncate` hook
+   * is called if provided; otherwise the oldest messages are dropped.
+   */
+  async updateConversationHistory(sessionId, messages) {
+    let history = messages;
+    if (history.length > this.maxHistoryLength) {
+      if (this.onTruncate) {
+        history = await this.onTruncate(history);
+      } else {
+        history = history.slice(-this.maxHistoryLength);
+      }
+    }
+    await this.store.update(sessionId, { conversationHistory: history });
+  }
+  /** Retrieves a session by ID, or undefined if not found. */
+  async getSession(sessionId) {
+    return this.store.get(sessionId);
+  }
+  /** Deletes a session and its associated data from the store. */
+  async deleteSession(sessionId) {
+    await this.store.delete(sessionId);
+  }
+};
+
+// src/in-memory-session-store.ts
+var InMemorySessionStore = class {
+  sessions = /* @__PURE__ */ new Map();
+  events = /* @__PURE__ */ new Map();
+  /** Creates a new session with a generated ID and timestamps. */
+  async create(session) {
+    const id = crypto.randomUUID();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const full = {
+      ...session,
+      id,
+      createdAt: now,
+      updatedAt: now
+    };
+    this.sessions.set(id, full);
+    this.events.set(id, []);
+    return full;
+  }
+  /** Retrieves a session by ID, or undefined if not found. */
+  async get(id) {
+    return this.sessions.get(id);
+  }
+  /** Merges partial updates into an existing session, preserving ID and createdAt. */
+  async update(id, updates) {
+    const existing = this.sessions.get(id);
+    if (!existing) {
+      throw new Error(`Session not found: ${id}`);
+    }
+    const updated = {
+      ...existing,
+      ...updates,
+      id: existing.id,
+      createdAt: existing.createdAt,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.sessions.set(id, updated);
+    return updated;
+  }
+  /** Deletes a session and its associated events. */
+  async delete(id) {
+    this.sessions.delete(id);
+    this.events.delete(id);
+  }
+  /** Lists all sessions belonging to a given user. */
+  async listByUser(userId) {
+    return Array.from(this.sessions.values()).filter(
+      (s) => s.userId === userId
+    );
+  }
+  /** Appends an event to the session's event log. */
+  async appendEvent(sessionId, event) {
+    const events = this.events.get(sessionId);
+    if (!events) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    events.push(event);
+  }
+  /** Returns events for a session, optionally starting from a given event index. */
+  async getEventsSince(sessionId, eventId) {
+    const events = this.events.get(sessionId);
+    if (!events) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    if (!eventId) {
+      return [...events];
+    }
+    const index = parseInt(eventId, 10);
+    if (isNaN(index)) {
+      return [...events];
+    }
+    return events.slice(index);
+  }
+};
+export {
+  InMemorySessionStore,
+  SessionManager,
+  agentLoop,
+  defaultConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/agent-loop.ts","../src/session-manager.ts","../src/in-memory-session-store.ts"],"sourcesContent":["// Task 23: AgentServiceConfig\n\n/**\n * Configuration for retry behavior on transient AI provider errors.\n *\n * @remarks\n * Uses exponential backoff: delay = `backoffMs * backoffMultiplier^(attempt-1)`.\n * The optional `retryableErrors` array restricts which error codes trigger retries.\n */\nexport interface RetryPolicy {\n  maxRetries: number;\n  backoffMs: number;\n  backoffMultiplier: number;\n  retryableErrors?: string[];\n}\n\n/**\n * Top-level configuration for the agent service.\n *\n * @remarks\n * Controls the agent loop's behavior: `maxTurns` prevents infinite loops,\n * `maxTokens` caps each AI request, `timeout` sets a per-request deadline,\n * and `retryPolicy` governs retries on transient errors. Optional\n * `eventFilters` can restrict which event types are emitted.\n */\nexport interface AgentServiceConfig {\n  maxTurns: number;\n  maxTokens: number;\n  timeout: number;\n  retryPolicy: RetryPolicy;\n  eventFilters?: string[];\n}\n\n/**\n * Default agent service configuration.\n *\n * @remarks\n * maxTurns: 25, maxTokens: 4096, timeout: 120 s, retries: 2 with exponential backoff.\n */\nexport const defaultConfig: AgentServiceConfig = {\n  maxTurns: 25,\n  maxTokens: 4096,\n  timeout: 120_000,\n  retryPolicy: {\n    maxRetries: 2,\n    backoffMs: 1000,\n    backoffMultiplier: 2,\n  },\n};\n","// Task 20: AgentLoop core implementation\n\nimport type {\n  AIProvider,\n  CreateMessageParams,\n  GenerationRequest,\n  Message,\n  SessionEvent,\n  StreamEvent,\n  ToolRegistry,\n  SandboxContext,\n  ContentBlock,\n  ToolUseBlock,\n  ToolResultBlock,\n} from '@yolo-labs/core-types';\nimport type { AgentServiceConfig } from './config.js';\nimport { defaultConfig } from './config.js';\n\n/**\n * Configuration options for the agent loop.\n *\n * @remarks\n * At minimum, a `provider` must be supplied. Provide `toolRegistry` and\n * `sandboxContext` to enable tool execution during the agentic loop.\n * The optional `config` merges with {@link defaultConfig} defaults.\n * Pass an `AbortSignal` to enable external cancellation of the loop.\n */\nexport interface AgentLoopOptions {\n  provider: AIProvider;\n  toolRegistry?: ToolRegistry;\n  sandboxContext?: SandboxContext;\n  config?: Partial<AgentServiceConfig>;\n  /** Optional signal to abort the agent loop externally (e.g. on interrupt). */\n  signal?: AbortSignal;\n}\n\ninterface PendingToolCall {\n  id: string;\n  name: string;\n  inputJson: string;\n}\n\n/**\n * Core agentic loop that orchestrates AI calls, tool execution, and event streaming.\n *\n * @param request - The generation request containing the user prompt and settings.\n * @param options - Provider, tool registry, sandbox context, and config overrides.\n * @returns An async generator yielding {@link SessionEvent} objects as the agent works.\n *\n * @remarks\n * The loop calls the AI provider, streams content deltas, detects tool use blocks,\n * executes tools via the registry, feeds results back, and repeats until the AI\n * signals `end_turn` or the configured `maxTurns` is reached. Errors are emitted\n * as `error` events and the loop terminates with an `agent_complete` event.\n *\n * @example\n * ```ts\n * for await (const event of agentLoop(request, options)) {\n *   if (event.type === 'text_delta') process.stdout.write(event.text);\n * }\n * ```\n */\nexport async function* agentLoop(\n  request: GenerationRequest,\n  options: AgentLoopOptions,\n): AsyncGenerator<SessionEvent> {\n  const config = { ...defaultConfig, ...options.config };\n  const { provider, toolRegistry, sandboxContext, signal } = options;\n  const sessionId = request.sessionId ?? crypto.randomUUID();\n\n  // 20a: Emit agent_start\n  yield {\n    type: 'agent_start',\n    sessionId,\n    timestamp: new Date().toISOString(),\n  };\n\n  // Build initial conversation history\n  const messages: Message[] = [];\n  if (request.context?.conversationHistory) {\n    messages.push(...(request.context.conversationHistory as Message[]));\n  }\n  messages.push({ role: 'user', content: request.prompt });\n\n  // Build tool definitions for the AI\n  const tools = toolRegistry?.toAIToolDefinitions() ?? request.tools ?? [];\n\n  let turn = 0;\n  // Task 97: Accumulate token usage across turns\n  let totalInputTokens = 0;\n  let totalOutputTokens = 0;\n\n  try {\n    while (turn < config.maxTurns) {\n      turn++;\n\n      // Task 117: Check abort signal before each AI call\n      if (signal?.aborted) {\n        yield {\n          type: 'error',\n          error: 'Agent loop aborted',\n          code: 'ABORTED',\n          recoverable: false,\n        };\n        yield {\n          type: 'agent_complete',\n          sessionId,\n          timestamp: new Date().toISOString(),\n          usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n        };\n        return;\n      }\n\n      // 20a: Build the AI request\n      const params: CreateMessageParams = {\n        model: request.model ?? 'claude-sonnet-4-20250514',\n        messages,\n        system: request.system,\n        tools: tools.length > 0 ? tools : undefined,\n        maxTokens: request.maxTokens ?? config.maxTokens,\n        temperature: request.temperature,\n        metadata: request.metadata,\n      };\n\n      // Track content blocks for the assistant turn\n      const assistantContentBlocks: ContentBlock[] = [];\n      const pendingToolCalls: PendingToolCall[] = [];\n      let currentBlockType: string | null = null;\n      let currentBlockId: string | undefined;\n      let currentBlockName: string | undefined;\n      let currentInputJson = '';\n      let stopReason: string | null = null;\n\n      // 20a/20b: Stream the AI response with request-level retry\n      let requestRetries = 0;\n      let stream: AsyncIterable<StreamEvent>;\n\n      while (true) {\n        try {\n          stream = provider.createMessage(params);\n          break;\n        } catch (err) {\n          // 20f: Retry logic for AI errors\n          if (requestRetries >= config.retryPolicy.maxRetries) {\n            yield {\n              type: 'error',\n              error: err instanceof Error ? err.message : String(err),\n              code: 'AI_REQUEST_FAILED',\n              recoverable: false,\n            };\n            yield {\n              type: 'agent_complete',\n              sessionId,\n              timestamp: new Date().toISOString(),\n              usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n            };\n            return;\n          }\n          requestRetries++;\n          const delay =\n            config.retryPolicy.backoffMs *\n            Math.pow(config.retryPolicy.backoffMultiplier, requestRetries - 1);\n          await sleep(delay);\n        }\n      }\n\n      // Task 119: Stream-level retry — retry the current turn on stream error\n      let streamRetries = 0;\n      let streamSuccess = false;\n\n      while (!streamSuccess) {\n        // Reset per-turn accumulators on each stream attempt\n        assistantContentBlocks.length = 0;\n        pendingToolCalls.length = 0;\n        currentBlockType = null;\n        currentBlockId = undefined;\n        currentBlockName = undefined;\n        currentInputJson = '';\n        stopReason = null;\n\n        try {\n          // Task 118: Wrap stream consumption with timeout\n          const streamIterable = streamRetries > 0 ? provider.createMessage(params) : stream!;\n          const timedStream = config.timeout > 0\n            ? withTimeout(streamIterable, config.timeout, signal)\n            : streamIterable;\n\n          for await (const event of timedStream) {\n            // Task 117: Check abort signal during streaming\n            if (signal?.aborted) {\n              yield {\n                type: 'error',\n                error: 'Agent loop aborted',\n                code: 'ABORTED',\n                recoverable: false,\n              };\n              yield {\n                type: 'agent_complete',\n                sessionId,\n                timestamp: new Date().toISOString(),\n                usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n              };\n              return;\n            }\n\n            switch (event.type) {\n              case 'content_block_start': {\n                currentBlockType = event.contentBlock.type;\n                currentBlockId = event.contentBlock.id;\n                currentBlockName = event.contentBlock.name;\n                currentInputJson = '';\n\n                // 20c: Emit tool_call event when tool_use block starts\n                if (currentBlockType === 'tool_use' && currentBlockId && currentBlockName) {\n                  // We'll emit tool_call after we have the full input\n                }\n                break;\n              }\n\n              case 'content_block_delta': {\n                if (event.delta.type === 'text_delta') {\n                  // 20b: Stream text deltas\n                  yield { type: 'text_delta', text: event.delta.text };\n                  // Accumulate for conversation history\n                  const lastBlock = assistantContentBlocks[assistantContentBlocks.length - 1];\n                  if (lastBlock && lastBlock.type === 'text') {\n                    lastBlock.text += event.delta.text;\n                  } else {\n                    assistantContentBlocks.push({ type: 'text', text: event.delta.text });\n                  }\n                } else if (event.delta.type === 'thinking_delta') {\n                  // 20b: Stream thinking/reasoning text\n                  yield { type: 'thought_delta', text: event.delta.thinking };\n                } else if (event.delta.type === 'input_json_delta') {\n                  // 20c: Accumulate tool input JSON\n                  currentInputJson += event.delta.partial_json;\n                  yield {\n                    type: 'tool_input_delta',\n                    toolCallId: currentBlockId ?? '',\n                    partialInput: event.delta.partial_json,\n                  };\n                }\n                break;\n              }\n\n              case 'content_block_stop': {\n                // 20c: When a tool_use block completes, record it\n                if (currentBlockType === 'tool_use' && currentBlockId) {\n                  pendingToolCalls.push({\n                    id: currentBlockId,\n                    name: currentBlockName ?? '',\n                    inputJson: currentInputJson,\n                  });\n                }\n                currentBlockType = null;\n                currentBlockId = undefined;\n                currentBlockName = undefined;\n                currentInputJson = '';\n                break;\n              }\n\n              case 'message_delta': {\n                stopReason = event.delta.stop_reason;\n                // Task 97: Extract output_tokens from message_delta\n                if (event.usage) {\n                  totalOutputTokens += event.usage.output_tokens;\n                }\n                break;\n              }\n\n              case 'message_start': {\n                // Task 97: Extract input_tokens from message_start\n                if (event.message.usage) {\n                  totalInputTokens += event.message.usage.input_tokens;\n                }\n                break;\n              }\n              case 'message_stop':\n                break;\n\n              case 'error': {\n                // 20f: AI stream error\n                yield {\n                  type: 'error',\n                  error: event.error.message,\n                  code: event.error.type,\n                  recoverable: false,\n                };\n                break;\n              }\n            }\n          }\n          streamSuccess = true;\n        } catch (err) {\n          const errMsg = err instanceof Error ? err.message : String(err);\n          const isTimeout = errMsg === 'TIMEOUT';\n          const isAbort = signal?.aborted;\n\n          // Task 117: Abort is not retryable\n          if (isAbort) {\n            yield {\n              type: 'error',\n              error: 'Agent loop aborted',\n              code: 'ABORTED',\n              recoverable: false,\n            };\n            yield {\n              type: 'agent_complete',\n              sessionId,\n              timestamp: new Date().toISOString(),\n              usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n            };\n            return;\n          }\n\n          // Task 118: Timeout is not retryable\n          if (isTimeout) {\n            yield {\n              type: 'error',\n              error: `Request timed out after ${config.timeout}ms`,\n              code: 'TIMEOUT',\n              recoverable: false,\n            };\n            yield {\n              type: 'agent_complete',\n              sessionId,\n              timestamp: new Date().toISOString(),\n              usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n            };\n            return;\n          }\n\n          // Task 119: Stream-level retry — retry the current turn\n          if (streamRetries < config.retryPolicy.maxRetries) {\n            streamRetries++;\n            const delay =\n              config.retryPolicy.backoffMs *\n              Math.pow(config.retryPolicy.backoffMultiplier, streamRetries - 1);\n            yield {\n              type: 'error',\n              error: errMsg,\n              code: 'STREAM_ERROR',\n              recoverable: true,\n            };\n            await sleep(delay);\n            continue;\n          }\n\n          // All retries exhausted\n          yield {\n            type: 'error',\n            error: errMsg,\n            code: 'STREAM_ERROR',\n            recoverable: false,\n          };\n          yield {\n            type: 'agent_complete',\n            sessionId,\n            timestamp: new Date().toISOString(),\n            usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n          };\n          return;\n        }\n      }\n\n      // Task 95: Add assistant message to history with ToolUseBlock entries\n      const fullAssistantContent: ContentBlock[] = [...assistantContentBlocks];\n      for (const tc of pendingToolCalls) {\n        let parsedInput: Record<string, unknown> = {};\n        try {\n          parsedInput = tc.inputJson ? JSON.parse(tc.inputJson) : {};\n        } catch {\n          // Will be handled during tool execution below\n        }\n        const toolUseBlock: ToolUseBlock = {\n          type: 'tool_use',\n          id: tc.id,\n          name: tc.name,\n          input: parsedInput,\n        };\n        fullAssistantContent.push(toolUseBlock);\n      }\n      if (fullAssistantContent.length > 0) {\n        messages.push({ role: 'assistant', content: fullAssistantContent });\n      }\n\n      // 20c/20d: Execute pending tool calls\n      // Task 117: Check abort signal before tool execution\n      if (signal?.aborted) {\n        yield {\n          type: 'error',\n          error: 'Agent loop aborted',\n          code: 'ABORTED',\n          recoverable: false,\n        };\n        yield {\n          type: 'agent_complete',\n          sessionId,\n          timestamp: new Date().toISOString(),\n          usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n        };\n        return;\n      }\n\n      if (pendingToolCalls.length > 0 && toolRegistry && sandboxContext) {\n        const toolResults: { content: string; isError: boolean }[] = [];\n\n        for (const tc of pendingToolCalls) {\n          // Task 117: Check abort signal before each tool execution\n          if (signal?.aborted) {\n            break;\n          }\n\n          let parsedInput: Record<string, unknown> = {};\n          try {\n            parsedInput = tc.inputJson ? JSON.parse(tc.inputJson) : {};\n          } catch {\n            yield {\n              type: 'error',\n              error: `Failed to parse tool input JSON for ${tc.name}`,\n              code: 'TOOL_INPUT_PARSE_ERROR',\n              recoverable: true,\n            };\n            toolResults.push({\n              content: JSON.stringify({ error: 'Failed to parse tool input JSON' }),\n              isError: true,\n            });\n            continue;\n          }\n\n          // Emit tool_call event\n          yield {\n            type: 'tool_call',\n            toolCallId: tc.id,\n            name: tc.name,\n            input: parsedInput,\n          };\n\n          const tool = toolRegistry.get(tc.name);\n          if (!tool) {\n            const errorResult = {\n              type: 'tool_result' as const,\n              toolCallId: tc.id,\n              name: tc.name,\n              success: false,\n              output: null,\n              error: `Tool '${tc.name}' not found in registry`,\n            };\n            yield errorResult;\n            toolResults.push({\n              content: JSON.stringify({ error: `Tool '${tc.name}' not found` }),\n              isError: true,\n            });\n            continue;\n          }\n\n          try {\n            // Execute tool with progress callback\n            const result = await tool.execute(\n              parsedInput,\n              sandboxContext,\n              (progress) => {\n                // Cannot yield from a callback in a generator, so we skip progress events here.\n                // In practice, consumers would use a different pattern for progress.\n              },\n            );\n\n            yield {\n              type: 'tool_result',\n              toolCallId: tc.id,\n              name: tc.name,\n              success: result.success,\n              output: result.output,\n              error: result.error,\n            };\n\n            toolResults.push({\n              content: typeof result.output === 'string'\n                ? result.output\n                : JSON.stringify(result.output),\n              isError: false,\n            });\n          } catch (err) {\n            // 20f: Tool execution error\n            const errorMsg = err instanceof Error ? err.message : String(err);\n            yield {\n              type: 'tool_result',\n              toolCallId: tc.id,\n              name: tc.name,\n              success: false,\n              output: null,\n              error: errorMsg,\n            };\n            toolResults.push({\n              content: JSON.stringify({ error: errorMsg }),\n              isError: true,\n            });\n          }\n        }\n\n        // Task 96: Feed tool results back as structured ToolResultBlock entries\n        const toolResultBlocks: ToolResultBlock[] = toolResults.map((r, i) => ({\n          type: 'tool_result' as const,\n          tool_use_id: pendingToolCalls[i].id,\n          content: r.content,\n          ...(r.isError ? { is_error: true } : {}),\n        }));\n        messages.push({ role: 'user', content: toolResultBlocks });\n\n        // Continue the loop — re-call AI with tool results\n        continue;\n      }\n\n      // 20e: Check stop reason — if end_turn or stop, we're done\n      if (stopReason === 'end_turn' || stopReason === 'stop' || pendingToolCalls.length === 0) {\n        yield {\n          type: 'agent_complete',\n          sessionId,\n          timestamp: new Date().toISOString(),\n          usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n        };\n        return;\n      }\n    }\n\n    // Max turns exceeded\n    yield {\n      type: 'error',\n      error: `Max turns (${config.maxTurns}) exceeded`,\n      code: 'MAX_TURNS_EXCEEDED',\n      recoverable: false,\n    };\n    yield {\n      type: 'agent_complete',\n      sessionId,\n      timestamp: new Date().toISOString(),\n      usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n    };\n  } catch (err) {\n    // 20f: Top-level error handling\n    yield {\n      type: 'error',\n      error: err instanceof Error ? err.message : String(err),\n      code: 'AGENT_LOOP_ERROR',\n      recoverable: false,\n    };\n    yield {\n      type: 'agent_complete',\n      sessionId,\n      timestamp: new Date().toISOString(),\n      usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, totalTurns: turn },\n    };\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Task 118: Wraps an async iterable with a timeout. If the timeout elapses\n * before the iterable completes, throws with message 'TIMEOUT'.\n * Also respects an optional AbortSignal for early cancellation.\n */\nasync function* withTimeout<T>(\n  iterable: AsyncIterable<T>,\n  timeoutMs: number,\n  signal?: AbortSignal,\n): AsyncGenerator<T> {\n  const iterator = iterable[Symbol.asyncIterator]();\n  const timeoutError = new Error('TIMEOUT');\n\n  while (true) {\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      const timer = setTimeout(() => reject(timeoutError), timeoutMs);\n      // If signal aborts, also reject (and clear timer)\n      if (signal) {\n        const onAbort = () => {\n          clearTimeout(timer);\n          reject(new Error('ABORTED'));\n        };\n        if (signal.aborted) {\n          clearTimeout(timer);\n          reject(new Error('ABORTED'));\n        } else {\n          signal.addEventListener('abort', onAbort, { once: true });\n        }\n      }\n    });\n\n    const result = await Promise.race([\n      iterator.next(),\n      timeoutPromise,\n    ]);\n\n    if (result.done) break;\n    yield result.value;\n  }\n}\n","// Task 21: SessionManager implementation\n\nimport type {\n  GenerationRequest,\n  GenerationSession,\n  Message,\n  SessionEvent,\n  SessionStore,\n} from '@yolo-labs/core-types';\n\n/**\n * Options for constructing a SessionManager.\n *\n * @remarks\n * The `maxHistoryLength` controls when truncation kicks in (default 100).\n * Supply `onTruncate` for custom summarization; otherwise oldest messages\n * are dropped.\n */\nexport interface SessionManagerOptions {\n  store: SessionStore;\n  maxHistoryLength?: number;\n  onTruncate?: (messages: Message[]) => Promise<Message[]>;\n}\n\n/**\n * Manages session lifecycle, event logging, and conversation history.\n *\n * @remarks\n * Wraps a {@link SessionStore} implementation to provide higher-level\n * operations: session creation from a request, event append, session\n * resumption, and automatic history truncation.\n */\nexport class SessionManager {\n  private store: SessionStore;\n  private maxHistoryLength: number;\n  private onTruncate?: (messages: Message[]) => Promise<Message[]>;\n\n  constructor(options: SessionManagerOptions) {\n    this.store = options.store;\n    this.maxHistoryLength = options.maxHistoryLength ?? 100;\n    this.onTruncate = options.onTruncate;\n  }\n\n  /**\n   * Creates a new session from a generation request.\n   *\n   * @param request - The generation request to create a session for.\n   * @param userId - Optional user ID to associate with the session.\n   * @returns The newly created {@link GenerationSession}.\n   */\n  async createSession(\n    request: GenerationRequest,\n    userId?: string,\n  ): Promise<GenerationSession> {\n    return this.store.create({\n      userId,\n      conversationHistory: [],\n      toolCallLog: [],\n      metadata: request.metadata ?? {},\n    });\n  }\n\n  /**\n   * Appends a session event to the session's event log.\n   *\n   * @param sessionId - The session to append the event to.\n   * @param event - The {@link SessionEvent} to record.\n   */\n  async appendEvent(sessionId: string, event: SessionEvent): Promise<void> {\n    await this.store.appendEvent(sessionId, event);\n  }\n\n  /**\n   * Resumes an existing session, returning the session and events emitted since a given point.\n   *\n   * @param sessionId - The session to resume.\n   * @param sinceEventId - Optional event ID to replay from. Returns all events if omitted.\n   * @returns The session object and the events since the specified event ID.\n   * @throws Error if the session does not exist.\n   */\n  async resumeSession(\n    sessionId: string,\n    sinceEventId?: string,\n  ): Promise<{\n    session: GenerationSession;\n    events: SessionEvent[];\n  }> {\n    const session = await this.store.get(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n    const events = await this.store.getEventsSince(sessionId, sinceEventId);\n    return { session, events };\n  }\n\n  /** Retrieves the conversation history for a given session. */\n  async getConversationHistory(sessionId: string): Promise<Message[]> {\n    const session = await this.store.get(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n    return session.conversationHistory;\n  }\n\n  /**\n   * Updates conversation history, applying truncation if it exceeds the configured max length.\n   *\n   * @param sessionId - The session to update.\n   * @param messages - The full updated conversation history.\n   *\n   * @remarks\n   * If the history exceeds `maxHistoryLength`, the custom `onTruncate` hook\n   * is called if provided; otherwise the oldest messages are dropped.\n   */\n  async updateConversationHistory(\n    sessionId: string,\n    messages: Message[],\n  ): Promise<void> {\n    // 21d: Truncation/summarization\n    let history = messages;\n    if (history.length > this.maxHistoryLength) {\n      if (this.onTruncate) {\n        history = await this.onTruncate(history);\n      } else {\n        // Default: keep the most recent messages\n        history = history.slice(-this.maxHistoryLength);\n      }\n    }\n\n    await this.store.update(sessionId, { conversationHistory: history });\n  }\n\n  /** Retrieves a session by ID, or undefined if not found. */\n  async getSession(sessionId: string): Promise<GenerationSession | undefined> {\n    return this.store.get(sessionId);\n  }\n\n  /** Deletes a session and its associated data from the store. */\n  async deleteSession(sessionId: string): Promise<void> {\n    await this.store.delete(sessionId);\n  }\n}\n","// Task 22: InMemorySessionStore\n\nimport type { GenerationSession, SessionEvent, SessionStore } from '@yolo-labs/core-types';\n\n/**\n * In-memory implementation of {@link SessionStore} using Maps.\n *\n * @remarks\n * Suitable for development, testing, and single-process deployments.\n * All data is lost when the process exits. For persistent storage,\n * implement a custom {@link SessionStore} backed by a database.\n */\nexport class InMemorySessionStore implements SessionStore {\n  private sessions = new Map<string, GenerationSession>();\n  private events = new Map<string, SessionEvent[]>();\n\n  /** Creates a new session with a generated ID and timestamps. */\n  async create(\n    session: Omit<GenerationSession, 'id' | 'createdAt' | 'updatedAt'>,\n  ): Promise<GenerationSession> {\n    const id = crypto.randomUUID();\n    const now = new Date().toISOString();\n    const full: GenerationSession = {\n      ...session,\n      id,\n      createdAt: now,\n      updatedAt: now,\n    };\n    this.sessions.set(id, full);\n    this.events.set(id, []);\n    return full;\n  }\n\n  /** Retrieves a session by ID, or undefined if not found. */\n  async get(id: string): Promise<GenerationSession | undefined> {\n    return this.sessions.get(id);\n  }\n\n  /** Merges partial updates into an existing session, preserving ID and createdAt. */\n  async update(\n    id: string,\n    updates: Partial<GenerationSession>,\n  ): Promise<GenerationSession> {\n    const existing = this.sessions.get(id);\n    if (!existing) {\n      throw new Error(`Session not found: ${id}`);\n    }\n    const updated: GenerationSession = {\n      ...existing,\n      ...updates,\n      id: existing.id,\n      createdAt: existing.createdAt,\n      updatedAt: new Date().toISOString(),\n    };\n    this.sessions.set(id, updated);\n    return updated;\n  }\n\n  /** Deletes a session and its associated events. */\n  async delete(id: string): Promise<void> {\n    this.sessions.delete(id);\n    this.events.delete(id);\n  }\n\n  /** Lists all sessions belonging to a given user. */\n  async listByUser(userId: string): Promise<GenerationSession[]> {\n    return Array.from(this.sessions.values()).filter(\n      (s) => s.userId === userId,\n    );\n  }\n\n  /** Appends an event to the session's event log. */\n  async appendEvent(sessionId: string, event: SessionEvent): Promise<void> {\n    const events = this.events.get(sessionId);\n    if (!events) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n    events.push(event);\n  }\n\n  /** Returns events for a session, optionally starting from a given event index. */\n  async getEventsSince(\n    sessionId: string,\n    eventId?: string,\n  ): Promise<SessionEvent[]> {\n    const events = this.events.get(sessionId);\n    if (!events) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n    if (!eventId) {\n      return [...events];\n    }\n    // For in-memory store, eventId is treated as an index\n    const index = parseInt(eventId, 10);\n    if (isNaN(index)) {\n      return [...events];\n    }\n    return events.slice(index);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@yolo-labs/core-agent-service",
+  "version": "1.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@yolo-labs/core-types": "1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "description": "Agent loop (async generator) and session management for AI agents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yolo-labs-hq/monorepo.git",
+    "directory": "yolo-core/packages/agent-service"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "homepage": "https://github.com/yolo-labs-hq/monorepo/tree/main/yolo-core#readme",
+  "bugs": {
+    "url": "https://github.com/yolo-labs-hq/monorepo/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}