@illuma-ai/agents 1.4.0-alpha.6 → 1.5.0

package/dist/cjs/content/ContentStore.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContentStore.cjs","sources":["../../../src/content/ContentStore.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport type Keyv from 'keyv';\nimport type {\n  StoreEntry,\n  StoredEntry,\n  ContentMetadata,\n  ReadResult,\n  ReadAllResult,\n  SearchMatch,\n  EditResult,\n} from './types';\n\n/**\n * Default 3-minute TTL for ephemeral content entries. Resets on every\n * access. Kept short to reduce cache-backing memory pressure — callers\n * that persist to durable storage (see {@link ArtifactStore}) rely on\n * lazy restore from the durable backend on cache miss.\n *\n * Exported so consumers can construct their injected {@link Keyv}\n * instance with a matching TTL without hard-coding the number.\n */\nexport const CONTENT_TTL_MS = 180_000;\n\n/** Default number of lines returned by readLines(). */\nconst DEFAULT_READ_LINES = 200;\n\n/** Maximum lines that can be read in a single call. */\nconst MAX_READ_LINES = 500;\n\n/** Maximum search results returned per call. */\nconst MAX_SEARCH_RESULTS = 50;\n\n/** Lines of context to show around a failed edit match for diagnostics. */\nconst ERROR_CONTEXT_LINES = 5;\n\n/**\n * Normalize line endings: CRLF → LF, stray CR → LF.\n * Prevents invisible mismatches when content originates from Windows/Office tools.\n */\nfunction normalizeNewlines(text: string): string {\n  return text.replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n}\n\n/**\n * Trim trailing whitespace from each line — used as a fallback when\n * exact matching fails due to invisible trailing spaces.\n */\nfunction trimTrailingPerLine(text: string): string {\n  return text\n    .split('\\n')\n    .map((l) => l.trimEnd())\n    .join('\\n');\n}\n\n/**\n * Fuzzy indentation-normalized matching. Compares line content after stripping\n * all leading whitespace, then maps back to the real line range in the content.\n * Returns `{ start, end }` character offsets in `content` if a unique match is found,\n * or `null` if no match or ambiguous (multiple matches).\n */\nfunction findIndentationNormalizedMatch(\n  content: string,\n  oldStr: string\n): { start: number; end: number } | null {\n  const contentLines = content.split('\\n');\n  const oldLines = oldStr.split('\\n');\n\n  // Strip leading whitespace for comparison — keep non-empty lines only for matching key\n  const oldTrimmed = oldLines.map((l) => l.trimStart());\n\n  // Need at least 1 non-empty line to match on\n  const nonEmptyOldLines = oldTrimmed.filter((l) => l.length > 0);\n  if (nonEmptyOldLines.length === 0) return null;\n\n  const matches: { start: number; end: number }[] = [];\n\n  // Slide a window of oldLines.length across contentLines\n  for (let i = 0; i <= contentLines.length - oldLines.length; i++) {\n    let matched = true;\n    for (let j = 0; j < oldLines.length; j++) {\n      const contentTrimmed = contentLines[i + j].trimStart();\n      if (contentTrimmed !== oldTrimmed[j]) {\n        matched = false;\n        break;\n      }\n    }\n    if (matched) {\n      // Calculate character offsets for the matched region\n      let charStart = 0;\n      for (let k = 0; k < i; k++) {\n        charStart += contentLines[k].length + 1; // +1 for \\n\n      }\n      let charEnd = charStart;\n      for (let k = 0; k < oldLines.length; k++) {\n        charEnd +=\n          contentLines[i + k].length + (k < oldLines.length - 1 ? 1 : 0);\n      }\n      matches.push({ start: charStart, end: charEnd });\n    }\n  }\n\n  // Only return if exactly one match (unambiguous)\n  return matches.length === 1 ? matches[0] : null;\n}\n\n/** Minimum fraction of lines that must match for partial fuzzy matching. */\nconst FUZZY_MATCH_THRESHOLD = 0.6;\n\n/**\n * Partial fuzzy matching — tolerates some lines being slightly different.\n * LLMs often reconstruct code from memory with subtle differences on a few lines\n * (e.g., changed variable name, missing semicolon). This layer finds the best-scoring\n * region where at least FUZZY_MATCH_THRESHOLD of lines match after trimming.\n *\n * Returns `{ start, end }` character offsets if a single high-confidence region is found.\n */\nfunction findPartialFuzzyMatch(\n  content: string,\n  oldStr: string\n): { start: number; end: number } | null {\n  const contentLines = content.split('\\n');\n  const oldLines = oldStr.split('\\n');\n\n  // Need at least 3 lines for fuzzy matching to be meaningful\n  if (oldLines.length < 3) return null;\n\n  const oldTrimmed = oldLines.map((l) => l.trim());\n  const minScore = Math.ceil(oldLines.length * FUZZY_MATCH_THRESHOLD);\n\n  let bestScore = 0;\n  let bestIdx = -1;\n  let secondBestScore = 0;\n\n  for (let i = 0; i <= contentLines.length - oldLines.length; i++) {\n    let score = 0;\n    for (let j = 0; j < oldLines.length; j++) {\n      const contentTrimmed = contentLines[i + j].trim();\n      // Exact match after trimming all whitespace\n      if (contentTrimmed === oldTrimmed[j]) {\n        score++;\n      } else if (\n        // Substring match — one contains the other (handles minor edits)\n        contentTrimmed.length > 0 &&\n        oldTrimmed[j].length > 0 &&\n        (contentTrimmed.includes(oldTrimmed[j]) ||\n          oldTrimmed[j].includes(contentTrimmed))\n      ) {\n        score += 0.5;\n      }\n    }\n    if (score > bestScore) {\n      secondBestScore = bestScore;\n      bestScore = score;\n      bestIdx = i;\n    } else if (score > secondBestScore) {\n      secondBestScore = score;\n    }\n  }\n\n  // Require: meets threshold AND is clearly better than second-best (unique match)\n  if (\n    bestIdx < 0 ||\n    bestScore < minScore ||\n    secondBestScore >= bestScore * 0.9\n  ) {\n    return null;\n  }\n\n  // Calculate character offsets\n  let charStart = 0;\n  for (let k = 0; k < bestIdx; k++) {\n    charStart += contentLines[k].length + 1;\n  }\n  let charEnd = charStart;\n  for (let k = 0; k < oldLines.length; k++) {\n    charEnd +=\n      contentLines[bestIdx + k].length + (k < oldLines.length - 1 ? 1 : 0);\n  }\n  return { start: charStart, end: charEnd };\n}\n\n/**\n * Find the best approximate match location for `needle` in `haystack` using\n * overlapping line content. Returns the 1-based line number of the best match\n * region, or 0 if no reasonable overlap is found.\n */\nfunction findApproximateLocation(haystack: string, needle: string): number {\n  const needleLines = needle\n    .split('\\n')\n    .map((l) => l.trim())\n    .filter(Boolean);\n  if (needleLines.length === 0) return 0;\n\n  const haystackLines = haystack.split('\\n');\n  let bestScore = 0;\n  let bestLine = 0;\n\n  for (let i = 0; i < haystackLines.length; i++) {\n    let score = 0;\n    for (\n      let j = 0;\n      j < needleLines.length && i + j < haystackLines.length;\n      j++\n    ) {\n      if (\n        haystackLines[i + j].trim().includes(needleLines[j]) ||\n        needleLines[j].includes(haystackLines[i + j].trim())\n      ) {\n        score++;\n      }\n    }\n    if (score > bestScore) {\n      bestScore = score;\n      bestLine = i + 1; // 1-based\n    }\n  }\n\n  // Require at least 1 matching line to report a location\n  return bestScore >= 1 ? bestLine : 0;\n}\n\n/**\n * Build a diagnostic error message showing nearby content when an edit match fails.\n */\nfunction buildEditDiagnostic(content: string, oldStr: string): string {\n  const approxLine = findApproximateLocation(content, oldStr);\n  const lines = content.split('\\n');\n\n  let contextSnippet = '';\n  if (approxLine > 0) {\n    const start = Math.max(\n      0,\n      approxLine - 1 - Math.floor(ERROR_CONTEXT_LINES / 2)\n    );\n    const end = Math.min(lines.length, start + ERROR_CONTEXT_LINES);\n    const padWidth = String(end).length;\n    const snippet = lines\n      .slice(start, end)\n      .map((l, i) => `${String(start + i + 1).padStart(padWidth, ' ')} | ${l}`)\n      .join('\\n');\n    contextSnippet = `\\nNearest content (around line ${approxLine}):\\n${snippet}`;\n  }\n\n  return `old_str not found in content. Re-read the file with content_tool read before retrying.${contextSnippet}`;\n}\n\n/**\n * Strip line-number prefixes (\"  N | \") that readLines() adds.\n * Agents may copy these when constructing old_str for edits.\n */\nfunction stripLineNumberPrefixes(text: string): string {\n  return text\n    .split('\\n')\n    .map((line) => {\n      const match = line.match(/^\\s*\\d+\\s*\\|\\s?(.*)/);\n      return match ? match[1] : line;\n    })\n    .join('\\n');\n}\n\n/**\n * Generates a short, URL-safe random ID.\n * @param length - Number of random bytes (output is hex, so 2x chars). Default 5 → 10 hex chars.\n */\nfunction generateId(length = 5): string {\n  return crypto.randomBytes(length).toString('hex');\n}\n\n/**\n * Per-conversation content store backed by a caller-provided {@link Keyv}\n * cache (typically Keyv + @keyv/redis, with in-memory fallback).\n *\n * Stores large content (MCP results, artifacts, agent-generated text)\n * outside the LLM context window. Entries inherit the TTL configured on\n * the injected {@link Keyv} instance — {@link CONTENT_TTL_MS} is the\n * recommended default.\n *\n * The caller is responsible for namespacing the Keyv instance per\n * conversation so content_ids don't collide across threads.\n *\n * @example\n * ```ts\n * import Keyv from 'keyv';\n * const cache = new Keyv({ namespace: `content-store::${conversationId}`, ttl: CONTENT_TTL_MS });\n * const store = new ContentStore(cache);\n * const id = await store.store({ name: 'report.csv', type: 'text/plain', content: csv, source: 'mcp:sharepoint' });\n * const result = await store.readLines(id, 1, 50);\n * ```\n */\nexport class ContentStore {\n  protected indexKey = '_index';\n\n  /**\n   * @param cache - A pre-namespaced {@link Keyv} instance. The store\n   *   writes both content entries and a per-store `_index` key, so\n   *   callers MUST namespace the Keyv per conversation to avoid\n   *   cross-thread collisions.\n   */\n  constructor(protected cache: Keyv) {}\n\n  /**\n   * Store new content and return a content ID.\n   * @param entry - The content to store with metadata.\n   * @returns The generated content ID.\n   */\n  async store(entry: StoreEntry): Promise<string> {\n    const id = generateId();\n    const lines = entry.content.split('\\n');\n\n    const metadata: ContentMetadata = {\n      id,\n      name: entry.name,\n      type: entry.type,\n      source: entry.source,\n      totalLines: lines.length,\n      totalChars: entry.content.length,\n      createdAt: Date.now(),\n    };\n\n    const stored: StoredEntry = { content: entry.content, metadata };\n    await this.cache.set(id, JSON.stringify(stored));\n\n    // Update the index\n    const index = await this.getIndex();\n    index[id] = metadata;\n    await this.cache.set(this.indexKey, JSON.stringify(index));\n\n    return id;\n  }\n\n  /**\n   * Get metadata for a content entry without loading the full content.\n   * @param contentId - The content entry ID.\n   * @returns Metadata or null if not found.\n   */\n  async info(contentId: string): Promise<ContentMetadata | null> {\n    const stored = await this.getStored(contentId);\n    if (!stored) {\n      return null;\n    }\n    // Touch both content entry and index to reset TTL\n    await this.touchEntry(contentId, stored);\n    return stored.metadata;\n  }\n\n  /**\n   * Read lines from a content entry with optional range.\n   * Lines are 1-based and inclusive. Returns formatted content with line numbers.\n   *\n   * @param contentId - The content entry ID.\n   * @param startLine - First line to read (1-based, default 1).\n   * @param endLine - Last line to read (inclusive, default startLine + DEFAULT_READ_LINES - 1).\n   * @returns Read result with formatted content and range info, or null if not found.\n   */\n  async readLines(\n    contentId: string,\n    startLine?: number,\n    endLine?: number\n  ): Promise<ReadResult | null> {\n    const stored = await this.getStored(contentId);\n    if (!stored) {\n      return null;\n    }\n\n    const lines = stored.content.split('\\n');\n    const totalLines = lines.length;\n\n    // Clamp start to valid range\n    const start = Math.max(1, startLine ?? 1);\n    // Clamp end: default to start + DEFAULT_READ_LINES - 1, cap at totalLines and start + MAX_READ_LINES - 1\n    let end = endLine ?? start + DEFAULT_READ_LINES - 1;\n    end = Math.min(end, totalLines, start + MAX_READ_LINES - 1);\n\n    // Slice is 0-based, our line numbers are 1-based\n    const slice = lines.slice(start - 1, end);\n\n    // Format with line numbers (padded for alignment)\n    const padWidth = String(end).length;\n    const formatted = slice\n      .map((line, i) => {\n        const lineNum = String(start + i).padStart(padWidth, ' ');\n        return `${lineNum} | ${line}`;\n      })\n      .join('\\n');\n\n    // Touch both content entry and index to reset TTL\n    await this.touchEntry(contentId, stored);\n\n    return {\n      content: formatted,\n      startLine: start,\n      endLine: end,\n      totalLines,\n      totalChars: stored.content.length,\n      truncated: end < totalLines,\n    };\n  }\n\n  /**\n   * Read the full content of an entry without line-number formatting or line caps.\n   * Used by API endpoints that serve complete content to the frontend (e.g., CodeViz).\n   * Unlike readLines(), this has no MAX_READ_LINES cap and returns raw content.\n   *\n   * @param contentId - The content entry ID.\n   * @returns Raw content with total line/char counts, or null if not found.\n   */\n  async readAll(contentId: string): Promise<ReadAllResult | null> {\n    const stored = await this.getStored(contentId);\n    if (!stored) {\n      return null;\n    }\n\n    // Touch both content entry and index to reset TTL\n    await this.touchEntry(contentId, stored);\n\n    return {\n      content: stored.content,\n      totalLines: stored.content.split('\\n').length,\n      totalChars: stored.content.length,\n    };\n  }\n\n  /**\n   * Search for a pattern within a content entry.\n   * Supports plain text matching and regex patterns.\n   *\n   * @param contentId - The content entry ID.\n   * @param pattern - Text or regex pattern to match.\n   * @param maxResults - Maximum matches to return (default MAX_SEARCH_RESULTS).\n   * @returns Array of matches with line numbers, or null if content not found.\n   */\n  async search(\n    contentId: string,\n    pattern: string,\n    maxResults = MAX_SEARCH_RESULTS\n  ): Promise<SearchMatch[] | null> {\n    const stored = await this.getStored(contentId);\n    if (!stored) {\n      return null;\n    }\n\n    const lines = stored.content.split('\\n');\n    const matches: SearchMatch[] = [];\n\n    // Try regex first, fall back to plain string match\n    let regex: RegExp | null = null;\n    try {\n      regex = new RegExp(pattern, 'i');\n    } catch {\n      // Invalid regex — use plain string matching below\n    }\n\n    for (let i = 0; i < lines.length && matches.length < maxResults; i++) {\n      const line = lines[i];\n      const isMatch = regex ? regex.test(line) : line.includes(pattern);\n      if (isMatch) {\n        matches.push({ lineNumber: i + 1, content: line });\n      }\n    }\n\n    // Touch both content entry and index to reset TTL\n    await this.touchEntry(contentId, stored);\n\n    return matches;\n  }\n\n  /**\n   * Surgical string replacement within a content entry.\n   * Fails if old_str is not found or appears more than once (ambiguous).\n   *\n   * Uses layered matching: exact → line-number-stripped → CRLF-normalized → trailing-whitespace-trimmed.\n   * On failure, returns diagnostic context showing nearby content to help the agent self-correct.\n   *\n   * @param contentId - The content entry ID.\n   * @param oldStr - Exact string to find.\n   * @param newStr - Replacement string.\n   * @returns Edit result with diff and affected line info.\n   */\n  async strReplace(\n    contentId: string,\n    oldStr: string,\n    newStr: string\n  ): Promise<EditResult> {\n    const stored = await this.getStored(contentId);\n    if (!stored) {\n      return {\n        success: false,\n        diff: '',\n        lineNumber: 0,\n        linesAffected: 0,\n        error: `Content \"${contentId}\" not found`,\n      };\n    }\n\n    const content = stored.content;\n    let effectiveOldStr = oldStr;\n    let firstIdx = content.indexOf(effectiveOldStr);\n\n    // Layer 1: Strip line-number prefixes that readLines() adds.\n    // Agents often copy formatted output (e.g., \"  1 | import React\") into old_str.\n    if (firstIdx === -1) {\n      const stripped = stripLineNumberPrefixes(oldStr);\n      if (stripped !== oldStr) {\n        firstIdx = content.indexOf(stripped);\n        if (firstIdx !== -1) {\n          effectiveOldStr = stripped;\n        }\n      }\n    }\n\n    // Layer 2: Normalize CRLF → LF (content from Windows/Office/MCP tools may have \\r\\n)\n    if (firstIdx === -1) {\n      const normContent = normalizeNewlines(content);\n      const normOld = normalizeNewlines(effectiveOldStr);\n      if (normContent !== content || normOld !== effectiveOldStr) {\n        const normIdx = normContent.indexOf(normOld);\n        if (normIdx !== -1) {\n          // Normalize stored content permanently so future edits don't hit this again\n          stored.content = normContent;\n          effectiveOldStr = normOld;\n          firstIdx = normIdx;\n        }\n      }\n    }\n\n    // Layer 3: Trim trailing whitespace per line (invisible trailing spaces cause mismatches)\n    if (firstIdx === -1) {\n      const trimmedContent = trimTrailingPerLine(stored.content);\n      const trimmedOld = trimTrailingPerLine(effectiveOldStr);\n      if (trimmedContent !== stored.content || trimmedOld !== effectiveOldStr) {\n        const trimIdx = trimmedContent.indexOf(trimmedOld);\n        if (trimIdx !== -1) {\n          // Use trimmed content for matching; map back to actual content position\n          // by finding the equivalent position in the original\n          stored.content = trimmedContent;\n          effectiveOldStr = trimmedOld;\n          firstIdx = trimIdx;\n        }\n      }\n    }\n\n    // Layer 4: Indentation-normalized line-by-line matching.\n    // Agent often gets the right code but with different indentation (e.g., 2 vs 4 spaces).\n    // Match lines by trimmed content, then replace the actual content range.\n    let rangeMatch: { start: number; end: number } | null = null;\n    if (firstIdx === -1) {\n      rangeMatch = findIndentationNormalizedMatch(\n        stored.content,\n        effectiveOldStr\n      );\n      if (rangeMatch) {\n        effectiveOldStr = stored.content.substring(\n          rangeMatch.start,\n          rangeMatch.end\n        );\n        firstIdx = rangeMatch.start;\n      }\n    }\n\n    // Layer 5: Partial fuzzy matching — tolerates some lines being slightly different.\n    // LLMs reconstruct code from memory and often get 80-90% of lines right but miss a few.\n    // This layer finds the best-scoring unique region above a match threshold.\n    if (firstIdx === -1) {\n      rangeMatch = findPartialFuzzyMatch(stored.content, effectiveOldStr);\n      if (rangeMatch) {\n        effectiveOldStr = stored.content.substring(\n          rangeMatch.start,\n          rangeMatch.end\n        );\n        firstIdx = rangeMatch.start;\n      }\n    }\n\n    if (firstIdx === -1) {\n      const diagnostic = buildEditDiagnostic(stored.content, oldStr);\n      return {\n        success: false,\n        diff: '',\n        lineNumber: 0,\n        linesAffected: 0,\n        error: diagnostic,\n      };\n    }\n\n    // For range-matched edits (layers 4/5), skip the ambiguity check (already verified unique)\n    const lastIdx = rangeMatch\n      ? firstIdx\n      : stored.content.lastIndexOf(effectiveOldStr);\n    if (firstIdx !== lastIdx) {\n      return {\n        success: false,\n        diff: '',\n        lineNumber: 0,\n        linesAffected: 0,\n        error: 'old_str appears multiple times — make it more specific',\n      };\n    }\n\n    // Find the line number where the match starts\n    const currentContent = stored.content;\n    const beforeMatch = currentContent.substring(0, firstIdx);\n    const lineNumber = beforeMatch.split('\\n').length;\n\n    // Perform replacement\n    const newContent =\n      currentContent.substring(0, firstIdx) +\n      newStr +\n      currentContent.substring(firstIdx + effectiveOldStr.length);\n\n    // Build a simple diff\n    const oldLines = effectiveOldStr.split('\\n');\n    const newLines = newStr.split('\\n');\n    let diff = '';\n    for (const line of oldLines) {\n      diff += `- ${line}\\n`;\n    }\n    for (const line of newLines) {\n      diff += `+ ${line}\\n`;\n    }\n\n    const linesAffected = Math.max(oldLines.length, newLines.length);\n\n    // Update stored content and metadata\n    stored.content = newContent;\n    stored.metadata.totalLines = newContent.split('\\n').length;\n    stored.metadata.totalChars = newContent.length;\n    await this.cache.set(contentId, JSON.stringify(stored));\n\n    // Update index metadata\n    const index = await this.getIndex();\n    if (index[contentId]) {\n      index[contentId] = stored.metadata;\n      await this.cache.set(this.indexKey, JSON.stringify(index));\n    }\n\n    return { success: true, diff: diff.trimEnd(), lineNumber, linesAffected };\n  }\n\n  /**\n   * Overwrite content for an existing entry, preserving its name/source/type.\n   * @param contentId - The content entry ID.\n   * @param content - New content to write.\n   * @throws If content ID is not found.\n   */\n  async write(contentId: string, content: string): Promise<void> {\n    const stored = await this.getStored(contentId);\n    if (!stored) {\n      throw new Error(`Content \"${contentId}\" not found`);\n    }\n\n    stored.content = content;\n    stored.metadata.totalLines = content.split('\\n').length;\n    stored.metadata.totalChars = content.length;\n    await this.cache.set(contentId, JSON.stringify(stored));\n\n    // Update index metadata\n    const index = await this.getIndex();\n    if (index[contentId]) {\n      index[contentId] = stored.metadata;\n      await this.cache.set(this.indexKey, JSON.stringify(index));\n    }\n  }\n\n  /**\n   * List all content entries in this conversation's store.\n   * @returns Array of metadata for all entries.\n   */\n  async list(): Promise<ContentMetadata[]> {\n    const index = await this.getIndex();\n    // Touch index to reset TTL on access\n    if (Object.keys(index).length > 0) {\n      await this.cache.set(this.indexKey, JSON.stringify(index));\n    }\n    return Object.values(index);\n  }\n\n  /**\n   * Get the raw content string for a content entry, without line-number formatting.\n   * Resets TTL on access. Used by code edit wrapper to retrieve stored code for execution.\n   *\n   * @param contentId - The content entry ID.\n   * @returns Raw content string, or null if not found/expired.\n   */\n  async getRawContent(contentId: string): Promise<string | null> {\n    const stored = await this.getStored(contentId);\n    if (!stored) {\n      return null;\n    }\n    await this.touchEntry(contentId, stored);\n    return stored.content;\n  }\n\n  /**\n   * Delete a content entry.\n   * @param contentId - The content entry ID.\n   */\n  async delete(contentId: string): Promise<void> {\n    await this.cache.delete(contentId);\n\n    const index = await this.getIndex();\n    delete index[contentId];\n    await this.cache.set(this.indexKey, JSON.stringify(index));\n  }\n\n  /**\n   * Reset TTL on both a content entry and the index.\n   * Called on every access to keep active content alive.\n   * @param contentId - The content entry ID.\n   * @param stored - The stored entry to re-set (resets TTL via Keyv).\n   */\n  protected async touchEntry(\n    contentId: string,\n    stored: StoredEntry\n  ): Promise<void> {\n    await this.cache.set(contentId, JSON.stringify(stored));\n    const index = await this.getIndex();\n    if (Object.keys(index).length > 0) {\n      await this.cache.set(this.indexKey, JSON.stringify(index));\n    }\n  }\n\n  /**\n   * Retrieve the full stored entry (content + metadata) from Redis.\n   * Returns null if the entry has expired or doesn't exist.\n   */\n  protected async getStored(contentId: string): Promise<StoredEntry | null> {\n    const raw = (await this.cache.get(contentId)) as string | undefined;\n    if (!raw) {\n      return null;\n    }\n    try {\n      return JSON.parse(raw) as StoredEntry;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Retrieve the conversation's content index from Redis.\n   * The index maps content IDs to their metadata.\n   */\n  protected async getIndex(): Promise<Record<string, ContentMetadata>> {\n    const raw = (await this.cache.get(this.indexKey)) as string | undefined;\n    if (!raw) {\n      return {};\n    }\n    try {\n      return JSON.parse(raw) as Record<string, ContentMetadata>;\n    } catch {\n      return {};\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/cjs/content/contentAnalyzer.cjs

@@ -1,91 +0,0 @@
-'use strict';
-
-/**
- * Utilities for measuring, classifying, and previewing content.
- * Used by the content_tool and MCP auto-caching (Phase 2) to decide
- * when content is "large" and how to summarize it for the LLM.
- */
-/**
- * Threshold in characters above which content is considered "large"
- * and should be stored in ContentStore rather than inlined.
- * 50K chars ~ 12.5K tokens ~ 6% of 200K context window.
- */
-const LARGE_CONTENT_THRESHOLD = 50_000;
-/**
- * Measure content size and determine if it exceeds the large-content threshold.
- * @param text - The content to measure.
- * @returns Measurement with char count, line count, and large flag.
- */
-function measureContent(text) {
-    return {
-        totalChars: text.length,
-        totalLines: text.split('\n').length,
-        isLarge: text.length > LARGE_CONTENT_THRESHOLD,
-    };
-}
-/**
- * Detect the structural type of content.
- * @param text - The content to classify.
- * @returns The detected type: 'json_array', 'json_object', 'text', or 'mixed'.
- */
-function detectContentType(text) {
-    const trimmed = text.trim();
-    if (!trimmed) {
-        return 'text';
-    }
-    // Fast check: does it look like JSON?
-    if (trimmed[0] === '[' || trimmed[0] === '{') {
-        try {
-            const parsed = JSON.parse(trimmed);
-            if (Array.isArray(parsed)) {
-                return 'json_array';
-            }
-            if (typeof parsed === 'object' && parsed !== null) {
-                return 'json_object';
-            }
-        }
-        catch {
-            // Not valid JSON — might be mixed content
-            if (trimmed[0] === '[' || trimmed[0] === '{') {
-                return 'mixed';
-            }
-        }
-    }
-    return 'text';
-}
-/**
- * Generate a preview/summary of content for the LLM context.
- * For JSON arrays, shows the first N items. For text, truncates with an ellipsis.
- *
- * @param text - The full content to preview.
- * @param opts - Options controlling preview size.
- * @returns A truncated preview string.
- */
-function generatePreview(text, opts) {
-    const maxItems = opts?.maxItems ?? 5;
-    const maxChars = opts?.maxChars ?? 2048;
-    const contentType = detectContentType(text);
-    if (contentType === 'json_array') {
-        try {
-            const arr = JSON.parse(text.trim());
-            if (arr.length <= maxItems) {
-                return text.trim();
-            }
-            const preview = arr.slice(0, maxItems);
-            const result = JSON.stringify(preview, null, 2);
-            return `${result}\n... (${arr.length - maxItems} more items, ${arr.length} total)`;
-        }
-        catch {
-            // Fall through to text truncation
-        }
-    }
-    if (text.length <= maxChars) {
-        return text;
-    }
-    return `${text.substring(0, maxChars)}\n... (truncated, ${text.length} chars total)`;
-}
-
-exports.detectContentType = detectContentType;
-exports.generatePreview = generatePreview;
-exports.measureContent = measureContent;
-//# sourceMappingURL=contentAnalyzer.cjs.map

package/dist/cjs/content/contentAnalyzer.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"contentAnalyzer.cjs","sources":["../../../src/content/contentAnalyzer.ts"],"sourcesContent":["/**\n * Utilities for measuring, classifying, and previewing content.\n * Used by the content_tool and MCP auto-caching (Phase 2) to decide\n * when content is \"large\" and how to summarize it for the LLM.\n */\n\n/**\n * Threshold in characters above which content is considered \"large\"\n * and should be stored in ContentStore rather than inlined.\n * 50K chars ~ 12.5K tokens ~ 6% of 200K context window.\n */\nconst LARGE_CONTENT_THRESHOLD = 50_000;\n\n/** Content size measurements. */\nexport interface ContentMeasurement {\n  totalChars: number;\n  totalLines: number;\n  /** True if content exceeds the large-content threshold. */\n  isLarge: boolean;\n}\n\n/** Detected content type. */\nexport type ContentType = 'json_array' | 'json_object' | 'text' | 'mixed';\n\n/**\n * Measure content size and determine if it exceeds the large-content threshold.\n * @param text - The content to measure.\n * @returns Measurement with char count, line count, and large flag.\n */\nexport function measureContent(text: string): ContentMeasurement {\n  return {\n    totalChars: text.length,\n    totalLines: text.split('\\n').length,\n    isLarge: text.length > LARGE_CONTENT_THRESHOLD,\n  };\n}\n\n/**\n * Detect the structural type of content.\n * @param text - The content to classify.\n * @returns The detected type: 'json_array', 'json_object', 'text', or 'mixed'.\n */\nexport function detectContentType(text: string): ContentType {\n  const trimmed = text.trim();\n  if (!trimmed) {\n    return 'text';\n  }\n\n  // Fast check: does it look like JSON?\n  if (trimmed[0] === '[' || trimmed[0] === '{') {\n    try {\n      const parsed = JSON.parse(trimmed);\n      if (Array.isArray(parsed)) {\n        return 'json_array';\n      }\n      if (typeof parsed === 'object' && parsed !== null) {\n        return 'json_object';\n      }\n    } catch {\n      // Not valid JSON — might be mixed content\n      if (trimmed[0] === '[' || trimmed[0] === '{') {\n        return 'mixed';\n      }\n    }\n  }\n\n  return 'text';\n}\n\n/**\n * Generate a preview/summary of content for the LLM context.\n * For JSON arrays, shows the first N items. For text, truncates with an ellipsis.\n *\n * @param text - The full content to preview.\n * @param opts - Options controlling preview size.\n * @returns A truncated preview string.\n */\nexport function generatePreview(\n  text: string,\n  opts?: { maxItems?: number; maxChars?: number }\n): string {\n  const maxItems = opts?.maxItems ?? 5;\n  const maxChars = opts?.maxChars ?? 2048;\n  const contentType = detectContentType(text);\n\n  if (contentType === 'json_array') {\n    try {\n      const arr = JSON.parse(text.trim()) as unknown[];\n      if (arr.length <= maxItems) {\n        return text.trim();\n      }\n      const preview = arr.slice(0, maxItems);\n      const result = JSON.stringify(preview, null, 2);\n      return `${result}\\n... (${arr.length - maxItems} more items, ${arr.length} total)`;\n    } catch {\n      // Fall through to text truncation\n    }\n  }\n\n  if (text.length <= maxChars) {\n    return text;\n  }\n\n  return `${text.substring(0, maxChars)}\\n... (truncated, ${text.length} chars total)`;\n}\n"],"names":[],"mappings":";;AAAA;;;;AAIG;AAEH;;;;AAIG;AACH,MAAM,uBAAuB,GAAG,MAAM;AAatC;;;;AAIG;AACG,SAAU,cAAc,CAAC,IAAY,EAAA;IACzC,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;AACnC,QAAA,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,uBAAuB;KAC/C;AACH;AAEA;;;;AAIG;AACG,SAAU,iBAAiB,CAAC,IAAY,EAAA;AAC5C,IAAA,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE;IAC3B,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,OAAO,MAAM;IACf;;AAGA,IAAA,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;AAC5C,QAAA,IAAI;YACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;AAClC,YAAA,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;AACzB,gBAAA,OAAO,YAAY;YACrB;YACA,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE;AACjD,gBAAA,OAAO,aAAa;YACtB;QACF;AAAE,QAAA,MAAM;;AAEN,YAAA,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;AAC5C,gBAAA,OAAO,OAAO;YAChB;QACF;IACF;AAEA,IAAA,OAAO,MAAM;AACf;AAEA;;;;;;;AAOG;AACG,SAAU,eAAe,CAC7B,IAAY,EACZ,IAA+C,EAAA;AAE/C,IAAA,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,CAAC;AACpC,IAAA,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI;AACvC,IAAA,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC;AAE3C,IAAA,IAAI,WAAW,KAAK,YAAY,EAAE;AAChC,QAAA,IAAI;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAc;AAChD,YAAA,IAAI,GAAG,CAAC,MAAM,IAAI,QAAQ,EAAE;AAC1B,gBAAA,OAAO,IAAI,CAAC,IAAI,EAAE;YACpB;YACA,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;AACtC,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/C,YAAA,OAAO,CAAA,EAAG,MAAM,CAAA,OAAA,EAAU,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAA,aAAA,EAAgB,GAAG,CAAC,MAAM,SAAS;QACpF;AAAE,QAAA,MAAM;;QAER;IACF;AAEA,IAAA,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE;AAC3B,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,OAAO,CAAA,EAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA,kBAAA,EAAqB,IAAI,CAAC,MAAM,eAAe;AACtF;;;;;;"}

package/dist/cjs/content/index.cjs

@@ -1,20 +0,0 @@
-'use strict';
-
-var ContentStore = require('./ContentStore.cjs');
-var ArtifactStore = require('./ArtifactStore.cjs');
-var contentAnalyzer = require('./contentAnalyzer.cjs');
-var mcpAutoCache = require('./mcpAutoCache.cjs');
-
-
-
-exports.CONTENT_TTL_MS = ContentStore.CONTENT_TTL_MS;
-exports.ContentStore = ContentStore.ContentStore;
-exports.ArtifactStore = ArtifactStore.ArtifactStore;
-exports.sanitizeName = ArtifactStore.sanitizeName;
-exports.detectContentType = contentAnalyzer.detectContentType;
-exports.generatePreview = contentAnalyzer.generatePreview;
-exports.measureContent = contentAnalyzer.measureContent;
-exports.buildCachedResponse = mcpAutoCache.buildCachedResponse;
-exports.extractUiMarkers = mcpAutoCache.extractUiMarkers;
-exports.interceptMcpResult = mcpAutoCache.interceptMcpResult;
-//# sourceMappingURL=index.cjs.map

package/dist/cjs/content/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}

package/dist/cjs/content/mcpAutoCache.cjs

@@ -1,115 +0,0 @@
-'use strict';
-
-var contentAnalyzer = require('./contentAnalyzer.cjs');
-
-/**
- * MCP Auto-Caching Interceptor
- *
- * When an MCP tool returns a large text result (>50K chars / ~12.5K tokens),
- * stores it in the caller-provided {@link ContentStore} and returns a
- * compact metadata reference. The LLM then uses a `content_reader` tool
- * (read/search/list/info) to pull relevant pieces of the stored result
- * without burning tokens on the full payload.
- *
- * Gate: callers MUST pass `contentReaderEnabled: true` on the context —
- * otherwise the interceptor returns the original text unchanged, because
- * caching without a reader tool leaves the agent with a content_id it
- * cannot dereference.
- *
- * Design:
- * - Only text content is cached. Images and UI resources pass through.
- * - UI resource markers (\ui{...}) are preserved in the returned text.
- * - Artifacts (second element of the tuple) are never modified.
- * - Cached response is a compact one-liner (~30 tokens) — no preview blob.
- * - If the store write fails, degrades gracefully — returns original text.
- */
-/**
- * Regex to detect UI resource markers: \ui{...}
- * These MUST be preserved in the returned text even after caching.
- */
-const UI_MARKER_REGEX = /\\ui\{[^}]+\}/g;
-/**
- * Extract all UI resource markers from text.
- * @param text - The text to scan.
- * @returns Array of marker strings (e.g. ['\\ui{abc123}', '\\ui{def456}'])
- */
-function extractUiMarkers(text) {
-    return text.match(UI_MARKER_REGEX) ?? [];
-}
-/**
- * Build a compact metadata reference for the cached content.
- * Keeps token usage minimal (~30 tokens) while giving the LLM all it needs
- * to access the data via content_tool.
- *
- * @param contentId - ContentStore entry ID.
- * @param measurement - Size data.
- * @param toolName - The MCP tool that produced the result.
- * @param uiMarkers - UI markers extracted from the original text.
- */
-function buildCachedResponse(contentId, measurement, toolName, uiMarkers) {
-    const sizeKB = (measurement.totalChars / 1024).toFixed(0);
-    let response = `[Stored: ${toolName} result | ${sizeKB}KB | ${measurement.totalLines} lines | content_id: ${contentId}]\nUse content_reader (action: read or search) with this content_id to access the full result — do NOT re-run the MCP tool.`;
-    if (uiMarkers.length > 0) {
-        response += '\n\n' + uiMarkers.join('\n');
-    }
-    return response;
-}
-/**
- * Core auto-cache interceptor for MCP tool results.
- *
- * If the text exceeds the large-content threshold (50K chars), stores it
- * in ContentStore and returns a preview + content_id. Otherwise passes through.
- *
- * @param text - The text content from the MCP tool result.
- * @param context - MCP tool and conversation context.
- * @returns AutoCacheResult with possibly-modified text and caching metadata.
- */
-async function interceptMcpResult(text, context) {
-    const measurement = contentAnalyzer.measureContent(text);
-    const log = context.logger;
-    if (!measurement.isLarge) {
-        return { text, cached: false, measurement };
-    }
-    // Gate: caching only makes sense when the agent can read back the stub.
-    // If content_reader is disabled, returning a content_id the agent can't
-    // dereference is strictly worse than returning the full text — the model
-    // would either hallucinate tool calls or flag the result as inaccessible.
-    if (!context.contentReaderEnabled) {
-        log?.debug(`[MCP Auto-Cache] Skipped caching for ${context.serverName}:${context.toolName} — content_reader disabled on this agent`, {
-            totalChars: measurement.totalChars,
-            totalLines: measurement.totalLines,
-            conversationId: context.conversationId,
-        });
-        return { text, cached: false, measurement };
-    }
-    try {
-        const contentType = contentAnalyzer.detectContentType(text);
-        const contentId = await context.store.store({
-            name: `${context.toolName} result`,
-            type: contentType === 'text' ? 'text/plain' : 'application/json',
-            content: text,
-            source: `mcp:${context.serverName}`,
-        });
-        const uiMarkers = extractUiMarkers(text);
-        const replacementText = buildCachedResponse(contentId, measurement, context.toolName, uiMarkers);
-        log?.debug(`[MCP Auto-Cache] Cached large result from ${context.serverName}:${context.toolName}`, {
-            contentId,
-            totalChars: measurement.totalChars,
-            totalLines: measurement.totalLines,
-            conversationId: context.conversationId,
-            contentType,
-            uiMarkersPreserved: uiMarkers.length,
-        });
-        return { text: replacementText, cached: true, contentId, measurement };
-    }
-    catch (error) {
-        // PERF: If caching fails, fall through silently — full content goes to LLM
-        log?.warn(`[MCP Auto-Cache] Failed to cache result from ${context.serverName}:${context.toolName}, passing through`, { error: error.message });
-        return { text, cached: false, measurement };
-    }
-}
-
-exports.buildCachedResponse = buildCachedResponse;
-exports.extractUiMarkers = extractUiMarkers;
-exports.interceptMcpResult = interceptMcpResult;
-//# sourceMappingURL=mcpAutoCache.cjs.map

package/dist/cjs/content/mcpAutoCache.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcpAutoCache.cjs","sources":["../../../src/content/mcpAutoCache.ts"],"sourcesContent":["/**\n * MCP Auto-Caching Interceptor\n *\n * When an MCP tool returns a large text result (>50K chars / ~12.5K tokens),\n * stores it in the caller-provided {@link ContentStore} and returns a\n * compact metadata reference. The LLM then uses a `content_reader` tool\n * (read/search/list/info) to pull relevant pieces of the stored result\n * without burning tokens on the full payload.\n *\n * Gate: callers MUST pass `contentReaderEnabled: true` on the context —\n * otherwise the interceptor returns the original text unchanged, because\n * caching without a reader tool leaves the agent with a content_id it\n * cannot dereference.\n *\n * Design:\n * - Only text content is cached. Images and UI resources pass through.\n * - UI resource markers (\\ui{...}) are preserved in the returned text.\n * - Artifacts (second element of the tuple) are never modified.\n * - Cached response is a compact one-liner (~30 tokens) — no preview blob.\n * - If the store write fails, degrades gracefully — returns original text.\n */\n\nimport { ContentStore } from './ContentStore';\nimport { measureContent, detectContentType } from './contentAnalyzer';\nimport type { Logger } from './ArtifactStore';\nimport type { ContentMeasurement } from './contentAnalyzer';\n\n/** Context for the auto-cache interceptor. */\nexport interface AutoCacheContext {\n  /**\n   * Pre-constructed {@link ContentStore} instance scoped to the current\n   * conversation. Caller owns the underlying cache lifecycle.\n   */\n  store: ContentStore;\n  /** MCP server name (e.g. \"sharepoint\", \"github\"). */\n  serverName: string;\n  /** MCP tool name (e.g. \"read_file\", \"search_code\"). */\n  toolName: string;\n  /**\n   * Whether the current agent has `content_reader` available. When false,\n   * the interceptor passes the large text through unchanged — caching\n   * without a reader tool leaves the agent with a content_id it cannot\n   * dereference, which is worse than returning the raw text.\n   */\n  contentReaderEnabled: boolean;\n  /**\n   * Optional diagnostic echo. Typically the conversation ID so operators\n   * can correlate the log line with upstream traces.\n   */\n  conversationId?: string;\n  /** Optional logger; defaults to silence. */\n  logger?: Logger;\n}\n\n/** Result of the auto-cache interception. */\nexport interface AutoCacheResult {\n  /** The (possibly modified) text content to return to the LLM. */\n  text: string;\n  /** Whether the content was cached. */\n  cached: boolean;\n  /** The content_id if cached. */\n  contentId?: string;\n  /** Content measurement data. */\n  measurement?: ContentMeasurement;\n}\n\n/**\n * Regex to detect UI resource markers: \\ui{...}\n * These MUST be preserved in the returned text even after caching.\n */\nconst UI_MARKER_REGEX = /\\\\ui\\{[^}]+\\}/g;\n\n/**\n * Extract all UI resource markers from text.\n * @param text - The text to scan.\n * @returns Array of marker strings (e.g. ['\\\\ui{abc123}', '\\\\ui{def456}'])\n */\nexport function extractUiMarkers(text: string): string[] {\n  return text.match(UI_MARKER_REGEX) ?? [];\n}\n\n/**\n * Build a compact metadata reference for the cached content.\n * Keeps token usage minimal (~30 tokens) while giving the LLM all it needs\n * to access the data via content_tool.\n *\n * @param contentId - ContentStore entry ID.\n * @param measurement - Size data.\n * @param toolName - The MCP tool that produced the result.\n * @param uiMarkers - UI markers extracted from the original text.\n */\nexport function buildCachedResponse(\n  contentId: string,\n  measurement: ContentMeasurement,\n  toolName: string,\n  uiMarkers: string[]\n): string {\n  const sizeKB = (measurement.totalChars / 1024).toFixed(0);\n  let response = `[Stored: ${toolName} result | ${sizeKB}KB | ${measurement.totalLines} lines | content_id: ${contentId}]\\nUse content_reader (action: read or search) with this content_id to access the full result — do NOT re-run the MCP tool.`;\n\n  if (uiMarkers.length > 0) {\n    response += '\\n\\n' + uiMarkers.join('\\n');\n  }\n\n  return response;\n}\n\n/**\n * Core auto-cache interceptor for MCP tool results.\n *\n * If the text exceeds the large-content threshold (50K chars), stores it\n * in ContentStore and returns a preview + content_id. Otherwise passes through.\n *\n * @param text - The text content from the MCP tool result.\n * @param context - MCP tool and conversation context.\n * @returns AutoCacheResult with possibly-modified text and caching metadata.\n */\nexport async function interceptMcpResult(\n  text: string,\n  context: AutoCacheContext\n): Promise<AutoCacheResult> {\n  const measurement = measureContent(text);\n  const log = context.logger;\n\n  if (!measurement.isLarge) {\n    return { text, cached: false, measurement };\n  }\n\n  // Gate: caching only makes sense when the agent can read back the stub.\n  // If content_reader is disabled, returning a content_id the agent can't\n  // dereference is strictly worse than returning the full text — the model\n  // would either hallucinate tool calls or flag the result as inaccessible.\n  if (!context.contentReaderEnabled) {\n    log?.debug(\n      `[MCP Auto-Cache] Skipped caching for ${context.serverName}:${context.toolName} — content_reader disabled on this agent`,\n      {\n        totalChars: measurement.totalChars,\n        totalLines: measurement.totalLines,\n        conversationId: context.conversationId,\n      }\n    );\n    return { text, cached: false, measurement };\n  }\n\n  try {\n    const contentType = detectContentType(text);\n\n    const contentId = await context.store.store({\n      name: `${context.toolName} result`,\n      type: contentType === 'text' ? 'text/plain' : 'application/json',\n      content: text,\n      source: `mcp:${context.serverName}`,\n    });\n\n    const uiMarkers = extractUiMarkers(text);\n\n    const replacementText = buildCachedResponse(\n      contentId,\n      measurement,\n      context.toolName,\n      uiMarkers\n    );\n\n    log?.debug(\n      `[MCP Auto-Cache] Cached large result from ${context.serverName}:${context.toolName}`,\n      {\n        contentId,\n        totalChars: measurement.totalChars,\n        totalLines: measurement.totalLines,\n        conversationId: context.conversationId,\n        contentType,\n        uiMarkersPreserved: uiMarkers.length,\n      }\n    );\n\n    return { text: replacementText, cached: true, contentId, measurement };\n  } catch (error) {\n    // PERF: If caching fails, fall through silently — full content goes to LLM\n    log?.warn(\n      `[MCP Auto-Cache] Failed to cache result from ${context.serverName}:${context.toolName}, passing through`,\n      { error: (error as Error).message }\n    );\n    return { text, cached: false, measurement };\n  }\n}\n"],"names":["measureContent","detectContentType"],"mappings":"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"}

package/dist/cjs/graphs/HandoffRegistry.cjs

@@ -1,143 +0,0 @@
-'use strict';
-
-/**
- * Registry for async handoff execution.
- *
- * Enables the autonomous orchestration pattern:
- * 1. Orchestrator spawns children (non-blocking)
- * 2. Orchestrator stays alive to reason, spawn more, or check status
- * 3. Orchestrator collects results when ready
- *
- * Scoped per MultiAgentGraph instance — each orchestrator graph gets its own registry.
- */
-class HandoffRegistry {
-    records = new Map();
-    /** Monotonically increasing counter for unique spawn IDs */
-    spawnCounter = 0;
-    /**
-     * Register a spawned handoff child.
-     * The promise runs in the background — not awaited here.
-     * Uses a unique key per spawn so the same agent can be spawned multiple times
-     * across rounds without overwriting prior records.
-     */
-    spawn(params) {
-        // Unique internal key: agentId + counter to support multiple spawns of same agent.
-        // record.id stays as the agent identity so callers/observability can attribute
-        // results to the agent regardless of which spawn round they came from.
-        const spawnKey = `${params.id}__${this.spawnCounter++}`;
-        const record = {
-            id: params.id,
-            spawnKey,
-            name: params.name,
-            task: params.task,
-            spawnedAt: Date.now(),
-            status: 'running',
-            promise: params.promise,
-        };
-        // Wire up the promise to update the record on completion
-        params.promise
-            .then((result) => {
-            const resultText = params.extractResult(result.messages, params.id);
-            const truncated = params.truncateResult(resultText, params.maxResultChars);
-            record.status = 'completed';
-            record.resultText = truncated;
-            record.durationMs = Date.now() - record.spawnedAt;
-            record.resultMessageCount = result.messages.length;
-            params.onComplete?.(record);
-        })
-            .catch((err) => {
-            record.status = 'failed';
-            record.error = err instanceof Error ? err.message : String(err);
-            record.durationMs = Date.now() - record.spawnedAt;
-            params.onComplete?.(record);
-        });
-        this.records.set(spawnKey, record);
-    }
-    /** List all pending (running) handoffs */
-    listPending() {
-        return Array.from(this.records.values()).filter((r) => r.status === 'running');
-    }
-    /** List all completed handoffs (not yet collected) */
-    listCompleted() {
-        return Array.from(this.records.values()).filter((r) => r.status === 'completed' || r.status === 'failed');
-    }
-    /** List all handoffs regardless of status */
-    listAll() {
-        return Array.from(this.records.values());
-    }
-    /**
-     * Get a handoff record by either its unique spawnKey or by agentId.
-     * - Exact spawnKey match wins (O(1)).
-     * - Falls back to the most recently spawned record for that agentId — matching
-     *   lookups by callers that only know the agent identity, not the spawn round.
-     */
-    get(idOrSpawnKey) {
-        const direct = this.records.get(idOrSpawnKey);
-        if (direct)
-            return direct;
-        let latest;
-        for (const record of this.records.values()) {
-            if (record.id !== idOrSpawnKey)
-                continue;
-            if (!latest || record.spawnedAt >= latest.spawnedAt)
-                latest = record;
-        }
-        return latest;
-    }
-    /** Check if any handoffs are still running */
-    hasPending() {
-        return this.listPending().length > 0;
-    }
-    /**
-     * Wait for ALL pending handoffs to complete and return all records.
-     * Records are NOT auto-cleared — caller removes collected records via remove().
-     */
-    async waitForAll() {
-        const pending = this.listPending();
-        if (pending.length > 0) {
-            await Promise.allSettled(pending.map((r) => r.promise));
-        }
-        const results = this.listAll();
-        return results;
-    }
-    /**
-     * Wait for ANY pending handoff to complete.
-     * Returns the newly completed record(s).
-     */
-    async waitForAny() {
-        const pending = this.listPending();
-        if (pending.length === 0) {
-            return this.listCompleted();
-        }
-        // Race all pending promises — at least one will resolve
-        await Promise.race(pending.map((r) => r.promise.then(() => r).catch(() => r)));
-        // Small yield to let promise handlers update records
-        await new Promise((resolve) => setTimeout(resolve, 0));
-        return this.listCompleted();
-    }
-    /**
-     * Remove record(s) by spawnKey or agentId.
-     * - Exact spawnKey match removes only that record.
-     * - agentId match removes ALL records for that agent (covers callers that
-     *   want to forget everything tied to a given agent).
-     */
-    remove(idOrSpawnKey) {
-        if (this.records.delete(idOrSpawnKey))
-            return;
-        for (const [key, record] of this.records) {
-            if (record.id === idOrSpawnKey)
-                this.records.delete(key);
-        }
-    }
-    /** Clear all records (for cleanup between graph invocations) */
-    clear() {
-        this.records.clear();
-    }
-    /** Number of total tracked handoffs */
-    get size() {
-        return this.records.size;
-    }
-}
-
-exports.HandoffRegistry = HandoffRegistry;
-//# sourceMappingURL=HandoffRegistry.cjs.map

package/dist/cjs/graphs/HandoffRegistry.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"HandoffRegistry.cjs","sources":["../../../src/graphs/HandoffRegistry.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport type * as t from '@/types';\n\n/**\n * Tracks the lifecycle of a spawned handoff child agent.\n */\nexport type HandoffRecord = {\n  /** Agent identity (destination agentId) — stable across multiple spawns of the same agent */\n  id: string;\n  /** Unique internal key for this specific spawn (agentId + monotonic counter) */\n  spawnKey: string;\n  /** Display name of the child agent */\n  name: string;\n  /** Task description / instructions passed to child */\n  task: string;\n  /** When the handoff was spawned */\n  spawnedAt: number;\n  /** Current status */\n  status: 'pending' | 'running' | 'completed' | 'failed';\n  /** The background promise executing the child subgraph */\n  promise: Promise<t.BaseGraphState>;\n  /** Resolved result text (populated on completion) */\n  resultText?: string;\n  /** Error message (populated on failure) */\n  error?: string;\n  /** Duration in ms (populated on completion/failure) */\n  durationMs?: number;\n  /** Number of messages in child's output */\n  resultMessageCount?: number;\n};\n\n/**\n * Registry for async handoff execution.\n *\n * Enables the autonomous orchestration pattern:\n * 1. Orchestrator spawns children (non-blocking)\n * 2. Orchestrator stays alive to reason, spawn more, or check status\n * 3. Orchestrator collects results when ready\n *\n * Scoped per MultiAgentGraph instance — each orchestrator graph gets its own registry.\n */\nexport class HandoffRegistry {\n  private records: Map<string, HandoffRecord> = new Map();\n  /** Monotonically increasing counter for unique spawn IDs */\n  private spawnCounter = 0;\n\n  /**\n   * Register a spawned handoff child.\n   * The promise runs in the background — not awaited here.\n   * Uses a unique key per spawn so the same agent can be spawned multiple times\n   * across rounds without overwriting prior records.\n   */\n  spawn(params: {\n    id: string;\n    name: string;\n    task: string;\n    promise: Promise<t.BaseGraphState>;\n    extractResult: (messages: BaseMessage[], agentId: string) => string;\n    truncateResult: (text: string, maxChars: number) => string;\n    maxResultChars: number;\n    /** Callback when child completes (for SSE events) */\n    onComplete?: (record: HandoffRecord) => void;\n  }): void {\n    // Unique internal key: agentId + counter to support multiple spawns of same agent.\n    // record.id stays as the agent identity so callers/observability can attribute\n    // results to the agent regardless of which spawn round they came from.\n    const spawnKey = `${params.id}__${this.spawnCounter++}`;\n    const record: HandoffRecord = {\n      id: params.id,\n      spawnKey,\n      name: params.name,\n      task: params.task,\n      spawnedAt: Date.now(),\n      status: 'running',\n      promise: params.promise,\n    };\n\n    // Wire up the promise to update the record on completion\n    params.promise\n      .then((result) => {\n        const resultText = params.extractResult(result.messages, params.id);\n        const truncated = params.truncateResult(\n          resultText,\n          params.maxResultChars\n        );\n        record.status = 'completed';\n        record.resultText = truncated;\n        record.durationMs = Date.now() - record.spawnedAt;\n        record.resultMessageCount = result.messages.length;\n        params.onComplete?.(record);\n      })\n      .catch((err) => {\n        record.status = 'failed';\n        record.error = err instanceof Error ? err.message : String(err);\n        record.durationMs = Date.now() - record.spawnedAt;\n        params.onComplete?.(record);\n      });\n\n    this.records.set(spawnKey, record);\n  }\n\n  /** List all pending (running) handoffs */\n  listPending(): HandoffRecord[] {\n    return Array.from(this.records.values()).filter(\n      (r) => r.status === 'running'\n    );\n  }\n\n  /** List all completed handoffs (not yet collected) */\n  listCompleted(): HandoffRecord[] {\n    return Array.from(this.records.values()).filter(\n      (r) => r.status === 'completed' || r.status === 'failed'\n    );\n  }\n\n  /** List all handoffs regardless of status */\n  listAll(): HandoffRecord[] {\n    return Array.from(this.records.values());\n  }\n\n  /**\n   * Get a handoff record by either its unique spawnKey or by agentId.\n   * - Exact spawnKey match wins (O(1)).\n   * - Falls back to the most recently spawned record for that agentId — matching\n   *   lookups by callers that only know the agent identity, not the spawn round.\n   */\n  get(idOrSpawnKey: string): HandoffRecord | undefined {\n    const direct = this.records.get(idOrSpawnKey);\n    if (direct) return direct;\n    let latest: HandoffRecord | undefined;\n    for (const record of this.records.values()) {\n      if (record.id !== idOrSpawnKey) continue;\n      if (!latest || record.spawnedAt >= latest.spawnedAt) latest = record;\n    }\n    return latest;\n  }\n\n  /** Check if any handoffs are still running */\n  hasPending(): boolean {\n    return this.listPending().length > 0;\n  }\n\n  /**\n   * Wait for ALL pending handoffs to complete and return all records.\n   * Records are NOT auto-cleared — caller removes collected records via remove().\n   */\n  async waitForAll(): Promise<HandoffRecord[]> {\n    const pending = this.listPending();\n    if (pending.length > 0) {\n      await Promise.allSettled(pending.map((r) => r.promise));\n    }\n    const results = this.listAll();\n    return results;\n  }\n\n  /**\n   * Wait for ANY pending handoff to complete.\n   * Returns the newly completed record(s).\n   */\n  async waitForAny(): Promise<HandoffRecord[]> {\n    const pending = this.listPending();\n    if (pending.length === 0) {\n      return this.listCompleted();\n    }\n\n    // Race all pending promises — at least one will resolve\n    await Promise.race(\n      pending.map((r) => r.promise.then(() => r).catch(() => r))\n    );\n\n    // Small yield to let promise handlers update records\n    await new Promise((resolve) => setTimeout(resolve, 0));\n\n    return this.listCompleted();\n  }\n\n  /**\n   * Remove record(s) by spawnKey or agentId.\n   * - Exact spawnKey match removes only that record.\n   * - agentId match removes ALL records for that agent (covers callers that\n   *   want to forget everything tied to a given agent).\n   */\n  remove(idOrSpawnKey: string): void {\n    if (this.records.delete(idOrSpawnKey)) return;\n    for (const [key, record] of this.records) {\n      if (record.id === idOrSpawnKey) this.records.delete(key);\n    }\n  }\n\n  /** Clear all records (for cleanup between graph invocations) */\n  clear(): void {\n    this.records.clear();\n  }\n\n  /** Number of total tracked handoffs */\n  get size(): number {\n    return this.records.size;\n  }\n}\n"],"names":[],"mappings":";;AA+BA;;;;;;;;;AASG;MACU,eAAe,CAAA;AAClB,IAAA,OAAO,GAA+B,IAAI,GAAG,EAAE;;IAE/C,YAAY,GAAG,CAAC;AAExB;;;;;AAKG;AACH,IAAA,KAAK,CAAC,MAUL,EAAA;;;;AAIC,QAAA,MAAM,QAAQ,GAAG,CAAA,EAAG,MAAM,CAAC,EAAE,CAAA,EAAA,EAAK,IAAI,CAAC,YAAY,EAAE,CAAA,CAAE;AACvD,QAAA,MAAM,MAAM,GAAkB;YAC5B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,QAAQ;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;AACjB,YAAA,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;AACrB,YAAA,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;;AAGD,QAAA,MAAM,CAAC;AACJ,aAAA,IAAI,CAAC,CAAC,MAAM,KAAI;AACf,YAAA,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;AACnE,YAAA,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CACrC,UAAU,EACV,MAAM,CAAC,cAAc,CACtB;AACD,YAAA,MAAM,CAAC,MAAM,GAAG,WAAW;AAC3B,YAAA,MAAM,CAAC,UAAU,GAAG,SAAS;YAC7B,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS;YACjD,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM;AAClD,YAAA,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;AAC7B,QAAA,CAAC;AACA,aAAA,KAAK,CAAC,CAAC,GAAG,KAAI;AACb,YAAA,MAAM,CAAC,MAAM,GAAG,QAAQ;AACxB,YAAA,MAAM,CAAC,KAAK,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC;YAC/D,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS;AACjD,YAAA,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;AAC7B,QAAA,CAAC,CAAC;QAEJ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;IACpC;;IAGA,WAAW,GAAA;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC7C,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,SAAS,CAC9B;IACH;;IAGA,aAAa,GAAA;AACX,QAAA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC7C,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CACzD;IACH;;IAGA,OAAO,GAAA;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1C;AAEA;;;;;AAKG;AACH,IAAA,GAAG,CAAC,YAAoB,EAAA;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AAC7C,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;AACzB,QAAA,IAAI,MAAiC;QACrC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE;AAC1C,YAAA,IAAI,MAAM,CAAC,EAAE,KAAK,YAAY;gBAAE;YAChC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS;gBAAE,MAAM,GAAG,MAAM;QACtE;AACA,QAAA,OAAO,MAAM;IACf;;IAGA,UAAU,GAAA;QACR,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,GAAG,CAAC;IACtC;AAEA;;;AAGG;AACH,IAAA,MAAM,UAAU,GAAA;AACd,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE;AAClC,QAAA,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;AACtB,YAAA,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;QACzD;AACA,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE;AAC9B,QAAA,OAAO,OAAO;IAChB;AAEA;;;AAGG;AACH,IAAA,MAAM,UAAU,GAAA;AACd,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE;AAClC,QAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;AACxB,YAAA,OAAO,IAAI,CAAC,aAAa,EAAE;QAC7B;;AAGA,QAAA,MAAM,OAAO,CAAC,IAAI,CAChB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAC3D;;AAGD,QAAA,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAEtD,QAAA,OAAO,IAAI,CAAC,aAAa,EAAE;IAC7B;AAEA;;;;;AAKG;AACH,IAAA,MAAM,CAAC,YAAoB,EAAA;AACzB,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;YAAE;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE;AACxC,YAAA,IAAI,MAAM,CAAC,EAAE,KAAK,YAAY;AAAE,gBAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QAC1D;IACF;;IAGA,KAAK,GAAA;AACH,QAAA,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;IACtB;;AAGA,IAAA,IAAI,IAAI,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI;IAC1B;AACD;;;;"}