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

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

@@ -0,0 +1 @@
+{"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":";;;;AAYA;;;;;;;;AAQG;AACI,MAAM,cAAc,GAAG;AAE9B;AACA,MAAM,kBAAkB,GAAG,GAAG;AAE9B;AACA,MAAM,cAAc,GAAG,GAAG;AAE1B;AACA,MAAM,kBAAkB,GAAG,EAAE;AAE7B;AACA,MAAM,mBAAmB,GAAG,CAAC;AAE7B;;;AAGG;AACH,SAAS,iBAAiB,CAAC,IAAY,EAAA;AACrC,IAAA,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;AACzD;AAEA;;;AAGG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAA;AACvC,IAAA,OAAO;SACJ,KAAK,CAAC,IAAI;SACV,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;SACtB,IAAI,CAAC,IAAI,CAAC;AACf;AAEA;;;;;AAKG;AACH,SAAS,8BAA8B,CACrC,OAAe,EACf,MAAc,EAAA;IAEd,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;;AAGnC,IAAA,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;;AAGrD,IAAA,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/D,IAAA,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;IAE9C,MAAM,OAAO,GAAqC,EAAE;;AAGpD,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QAC/D,IAAI,OAAO,GAAG,IAAI;AAClB,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACxC,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE;AACtD,YAAA,IAAI,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE;gBACpC,OAAO,GAAG,KAAK;gBACf;YACF;QACF;QACA,IAAI,OAAO,EAAE;;YAEX,IAAI,SAAS,GAAG,CAAC;AACjB,YAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC1B,SAAS,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1C;YACA,IAAI,OAAO,GAAG,SAAS;AACvB,YAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBACxC,OAAO;oBACL,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClE;AACA,YAAA,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QAClD;IACF;;AAGA,IAAA,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;AACjD;AAEA;AACA,MAAM,qBAAqB,GAAG,GAAG;AAEjC;;;;;;;AAOG;AACH,SAAS,qBAAqB,CAC5B,OAAe,EACf,MAAc,EAAA;IAEd,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;;AAGnC,IAAA,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;AAAE,QAAA,OAAO,IAAI;AAEpC,IAAA,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,IAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,qBAAqB,CAAC;IAEnE,IAAI,SAAS,GAAG,CAAC;AACjB,IAAA,IAAI,OAAO,GAAG,EAAE;IAChB,IAAI,eAAe,GAAG,CAAC;AAEvB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QAC/D,IAAI,KAAK,GAAG,CAAC;AACb,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACxC,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;;AAEjD,YAAA,IAAI,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE;AACpC,gBAAA,KAAK,EAAE;YACT;AAAO,iBAAA;;YAEL,cAAc,CAAC,MAAM,GAAG,CAAC;AACzB,gBAAA,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;iBACvB,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;oBACrC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EACzC;gBACA,KAAK,IAAI,GAAG;YACd;QACF;AACA,QAAA,IAAI,KAAK,GAAG,SAAS,EAAE;YACrB,eAAe,GAAG,SAAS;YAC3B,SAAS,GAAG,KAAK;YACjB,OAAO,GAAG,CAAC;QACb;AAAO,aAAA,IAAI,KAAK,GAAG,eAAe,EAAE;YAClC,eAAe,GAAG,KAAK;QACzB;IACF;;IAGA,IACE,OAAO,GAAG,CAAC;AACX,QAAA,SAAS,GAAG,QAAQ;AACpB,QAAA,eAAe,IAAI,SAAS,GAAG,GAAG,EAClC;AACA,QAAA,OAAO,IAAI;IACb;;IAGA,IAAI,SAAS,GAAG,CAAC;AACjB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE;QAChC,SAAS,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;IACzC;IACA,IAAI,OAAO,GAAG,SAAS;AACvB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACxC,OAAO;YACL,YAAY,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxE;IACA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE;AAC3C;AAEA;;;;AAIG;AACH,SAAS,uBAAuB,CAAC,QAAgB,EAAE,MAAc,EAAA;IAC/D,MAAM,WAAW,GAAG;SACjB,KAAK,CAAC,IAAI;SACV,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;SACnB,MAAM,CAAC,OAAO,CAAC;AAClB,IAAA,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,CAAC;IAEtC,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IAC1C,IAAI,SAAS,GAAG,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC;AAEhB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QAC7C,IAAI,KAAK,GAAG,CAAC;QACb,KACE,IAAI,CAAC,GAAG,CAAC,EACT,CAAC,GAAG,WAAW,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,MAAM,EACtD,CAAC,EAAE,EACH;AACA,YAAA,IACE,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AACpD,gBAAA,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EACpD;AACA,gBAAA,KAAK,EAAE;YACT;QACF;AACA,QAAA,IAAI,KAAK,GAAG,SAAS,EAAE;YACrB,SAAS,GAAG,KAAK;AACjB,YAAA,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB;IACF;;IAGA,OAAO,SAAS,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC;AACtC;AAEA;;AAEG;AACH,SAAS,mBAAmB,CAAC,OAAe,EAAE,MAAc,EAAA;IAC1D,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;IAEjC,IAAI,cAAc,GAAG,EAAE;AACvB,IAAA,IAAI,UAAU,GAAG,CAAC,EAAE;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,EACD,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC,CACrD;AACD,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,mBAAmB,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM;QACnC,MAAM,OAAO,GAAG;AACb,aAAA,KAAK,CAAC,KAAK,EAAE,GAAG;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAA,EAAG,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA,GAAA,EAAM,CAAC,CAAA,CAAE;aACvE,IAAI,CAAC,IAAI,CAAC;AACb,QAAA,cAAc,GAAG,CAAA,+BAAA,EAAkC,UAAU,CAAA,IAAA,EAAO,OAAO,EAAE;IAC/E;IAEA,OAAO,CAAA,sFAAA,EAAyF,cAAc,CAAA,CAAE;AAClH;AAEA;;;AAGG;AACH,SAAS,uBAAuB,CAAC,IAAY,EAAA;AAC3C,IAAA,OAAO;SACJ,KAAK,CAAC,IAAI;AACV,SAAA,GAAG,CAAC,CAAC,IAAI,KAAI;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC;AAC/C,QAAA,OAAO,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;AAChC,IAAA,CAAC;SACA,IAAI,CAAC,IAAI,CAAC;AACf;AAEA;;;AAGG;AACH,SAAS,UAAU,CAAC,MAAM,GAAG,CAAC,EAAA;IAC5B,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;AACnD;AAEA;;;;;;;;;;;;;;;;;;;;AAoBG;MACU,YAAY,CAAA;AASD,IAAA,KAAA;IARZ,QAAQ,GAAG,QAAQ;AAE7B;;;;;AAKG;AACH,IAAA,WAAA,CAAsB,KAAW,EAAA;QAAX,IAAA,CAAA,KAAK,GAAL,KAAK;IAAS;AAEpC;;;;AAIG;IACH,MAAM,KAAK,CAAC,KAAiB,EAAA;AAC3B,QAAA,MAAM,EAAE,GAAG,UAAU,EAAE;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;AAEvC,QAAA,MAAM,QAAQ,GAAoB;YAChC,EAAE;YACF,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,MAAM;AACxB,YAAA,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;AAChC,YAAA,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB;QAED,MAAM,MAAM,GAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE;AAChE,QAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;;AAGhD,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;AACnC,QAAA,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ;AACpB,QAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAE1D,QAAA,OAAO,EAAE;IACX;AAEA;;;;AAIG;IACH,MAAM,IAAI,CAAC,SAAiB,EAAA;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,OAAO,IAAI;QACb;;QAEA,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;QACxC,OAAO,MAAM,CAAC,QAAQ;IACxB;AAEA;;;;;;;;AAQG;AACH,IAAA,MAAM,SAAS,CACb,SAAiB,EACjB,SAAkB,EAClB,OAAgB,EAAA;QAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,OAAO,IAAI;QACb;QAEA,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;AACxC,QAAA,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM;;AAG/B,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC;;QAEzC,IAAI,GAAG,GAAG,OAAO,IAAI,KAAK,GAAG,kBAAkB,GAAG,CAAC;AACnD,QAAA,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,GAAG,cAAc,GAAG,CAAC,CAAC;;AAG3D,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC;;QAGzC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM;QACnC,MAAM,SAAS,GAAG;AACf,aAAA,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAI;AACf,YAAA,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;AACzD,YAAA,OAAO,CAAA,EAAG,OAAO,CAAA,GAAA,EAAM,IAAI,EAAE;AAC/B,QAAA,CAAC;aACA,IAAI,CAAC,IAAI,CAAC;;QAGb,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;QAExC,OAAO;AACL,YAAA,OAAO,EAAE,SAAS;AAClB,YAAA,SAAS,EAAE,KAAK;AAChB,YAAA,OAAO,EAAE,GAAG;YACZ,UAAU;AACV,YAAA,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YACjC,SAAS,EAAE,GAAG,GAAG,UAAU;SAC5B;IACH;AAEA;;;;;;;AAOG;IACH,MAAM,OAAO,CAAC,SAAiB,EAAA;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,OAAO,IAAI;QACb;;QAGA,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;QAExC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;AAC7C,YAAA,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;SAClC;IACH;AAEA;;;;;;;;AAQG;IACH,MAAM,MAAM,CACV,SAAiB,EACjB,OAAe,EACf,UAAU,GAAG,kBAAkB,EAAA;QAE/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,OAAO,IAAI;QACb;QAEA,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QACxC,MAAM,OAAO,GAAkB,EAAE;;QAGjC,IAAI,KAAK,GAAkB,IAAI;AAC/B,QAAA,IAAI;YACF,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC;QAClC;AAAE,QAAA,MAAM;;QAER;QAEA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE;AACpE,YAAA,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;YACrB,MAAM,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YACjE,IAAI,OAAO,EAAE;AACX,gBAAA,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACpD;QACF;;QAGA,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;AAExC,QAAA,OAAO,OAAO;IAChB;AAEA;;;;;;;;;;;AAWG;AACH,IAAA,MAAM,UAAU,CACd,SAAiB,EACjB,MAAc,EACd,MAAc,EAAA;QAEd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE;YACX,OAAO;AACL,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,IAAI,EAAE,EAAE;AACR,gBAAA,UAAU,EAAE,CAAC;AACb,gBAAA,aAAa,EAAE,CAAC;gBAChB,KAAK,EAAE,CAAA,SAAA,EAAY,SAAS,CAAA,WAAA,CAAa;aAC1C;QACH;AAEA,QAAA,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO;QAC9B,IAAI,eAAe,GAAG,MAAM;QAC5B,IAAI,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;;;AAI/C,QAAA,IAAI,QAAQ,KAAK,EAAE,EAAE;AACnB,YAAA,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC;AAChD,YAAA,IAAI,QAAQ,KAAK,MAAM,EAAE;AACvB,gBAAA,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;AACpC,gBAAA,IAAI,QAAQ,KAAK,EAAE,EAAE;oBACnB,eAAe,GAAG,QAAQ;gBAC5B;YACF;QACF;;AAGA,QAAA,IAAI,QAAQ,KAAK,EAAE,EAAE;AACnB,YAAA,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC;AAC9C,YAAA,MAAM,OAAO,GAAG,iBAAiB,CAAC,eAAe,CAAC;YAClD,IAAI,WAAW,KAAK,OAAO,IAAI,OAAO,KAAK,eAAe,EAAE;gBAC1D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;AAC5C,gBAAA,IAAI,OAAO,KAAK,EAAE,EAAE;;AAElB,oBAAA,MAAM,CAAC,OAAO,GAAG,WAAW;oBAC5B,eAAe,GAAG,OAAO;oBACzB,QAAQ,GAAG,OAAO;gBACpB;YACF;QACF;;AAGA,QAAA,IAAI,QAAQ,KAAK,EAAE,EAAE;YACnB,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC;AAC1D,YAAA,MAAM,UAAU,GAAG,mBAAmB,CAAC,eAAe,CAAC;YACvD,IAAI,cAAc,KAAK,MAAM,CAAC,OAAO,IAAI,UAAU,KAAK,eAAe,EAAE;gBACvE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC;AAClD,gBAAA,IAAI,OAAO,KAAK,EAAE,EAAE;;;AAGlB,oBAAA,MAAM,CAAC,OAAO,GAAG,cAAc;oBAC/B,eAAe,GAAG,UAAU;oBAC5B,QAAQ,GAAG,OAAO;gBACpB;YACF;QACF;;;;QAKA,IAAI,UAAU,GAA0C,IAAI;AAC5D,QAAA,IAAI,QAAQ,KAAK,EAAE,EAAE;YACnB,UAAU,GAAG,8BAA8B,CACzC,MAAM,CAAC,OAAO,EACd,eAAe,CAChB;YACD,IAAI,UAAU,EAAE;AACd,gBAAA,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CACxC,UAAU,CAAC,KAAK,EAChB,UAAU,CAAC,GAAG,CACf;AACD,gBAAA,QAAQ,GAAG,UAAU,CAAC,KAAK;YAC7B;QACF;;;;AAKA,QAAA,IAAI,QAAQ,KAAK,EAAE,EAAE;YACnB,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC;YACnE,IAAI,UAAU,EAAE;AACd,gBAAA,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CACxC,UAAU,CAAC,KAAK,EAChB,UAAU,CAAC,GAAG,CACf;AACD,gBAAA,QAAQ,GAAG,UAAU,CAAC,KAAK;YAC7B;QACF;AAEA,QAAA,IAAI,QAAQ,KAAK,EAAE,EAAE;YACnB,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;YAC9D,OAAO;AACL,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,IAAI,EAAE,EAAE;AACR,gBAAA,UAAU,EAAE,CAAC;AACb,gBAAA,aAAa,EAAE,CAAC;AAChB,gBAAA,KAAK,EAAE,UAAU;aAClB;QACH;;QAGA,MAAM,OAAO,GAAG;AACd,cAAE;cACA,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC;AAC/C,QAAA,IAAI,QAAQ,KAAK,OAAO,EAAE;YACxB,OAAO;AACL,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,IAAI,EAAE,EAAE;AACR,gBAAA,UAAU,EAAE,CAAC;AACb,gBAAA,aAAa,EAAE,CAAC;AAChB,gBAAA,KAAK,EAAE,wDAAwD;aAChE;QACH;;AAGA,QAAA,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO;QACrC,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC;QACzD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;;QAGjD,MAAM,UAAU,GACd,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC;YACrC,MAAM;YACN,cAAc,CAAC,SAAS,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC;;QAG7D,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,IAAI,IAAI,GAAG,EAAE;AACb,QAAA,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE;AAC3B,YAAA,IAAI,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,EAAA,CAAI;QACvB;AACA,QAAA,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE;AAC3B,YAAA,IAAI,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,EAAA,CAAI;QACvB;AAEA,QAAA,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;;AAGhE,QAAA,MAAM,CAAC,OAAO,GAAG,UAAU;AAC3B,QAAA,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;QAC1D,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC,MAAM;AAC9C,QAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;;AAGvD,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;AACnC,QAAA,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE;AACpB,YAAA,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,QAAQ;AAClC,YAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5D;AAEA,QAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE;IAC3E;AAEA;;;;;AAKG;AACH,IAAA,MAAM,KAAK,CAAC,SAAiB,EAAE,OAAe,EAAA;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,CAAA,WAAA,CAAa,CAAC;QACrD;AAEA,QAAA,MAAM,CAAC,OAAO,GAAG,OAAO;AACxB,QAAA,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;QACvD,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM;AAC3C,QAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;;AAGvD,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;AACnC,QAAA,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE;AACpB,YAAA,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,QAAQ;AAClC,YAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5D;IACF;AAEA;;;AAGG;AACH,IAAA,MAAM,IAAI,GAAA;AACR,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;;QAEnC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;AACjC,YAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5D;AACA,QAAA,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7B;AAEA;;;;;;AAMG;IACH,MAAM,aAAa,CAAC,SAAiB,EAAA;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,OAAO,IAAI;QACb;QACA,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;QACxC,OAAO,MAAM,CAAC,OAAO;IACvB;AAEA;;;AAGG;IACH,MAAM,MAAM,CAAC,SAAiB,EAAA;QAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;AAElC,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;AACnC,QAAA,OAAO,KAAK,CAAC,SAAS,CAAC;AACvB,QAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D;AAEA;;;;;AAKG;AACO,IAAA,MAAM,UAAU,CACxB,SAAiB,EACjB,MAAmB,EAAA;AAEnB,QAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACvD,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;QACnC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;AACjC,YAAA,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5D;IACF;AAEA;;;AAGG;IACO,MAAM,SAAS,CAAC,SAAiB,EAAA;AACzC,QAAA,MAAM,GAAG,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAuB;QACnE,IAAI,CAAC,GAAG,EAAE;AACR,YAAA,OAAO,IAAI;QACb;AACA,QAAA,IAAI;AACF,YAAA,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB;QACvC;AAAE,QAAA,MAAM;AACN,YAAA,OAAO,IAAI;QACb;IACF;AAEA;;;AAGG;AACO,IAAA,MAAM,QAAQ,GAAA;AACtB,QAAA,MAAM,GAAG,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAuB;QACvE,IAAI,CAAC,GAAG,EAAE;AACR,YAAA,OAAO,EAAE;QACX;AACA,QAAA,IAAI;AACF,YAAA,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoC;QAC3D;AAAE,QAAA,MAAM;AACN,YAAA,OAAO,EAAE;QACX;IACF;AACD;;;;;"}

package/dist/cjs/content/contentAnalyzer.cjs

@@ -0,0 +1,91 @@
+'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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,20 @@
+'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

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

package/dist/cjs/content/mcpAutoCache.cjs

@@ -0,0 +1,115 @@
+'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

@@ -0,0 +1 @@
+{"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/main.cjs

@@ -44,6 +44,9 @@ var config$1 = require('./providers/mcp/config.cjs');
 var A2ACapabilityProvider = require('./providers/a2a/A2ACapabilityProvider.cjs');
 var client = require('./providers/a2a/client.cjs');
 var config = require('./providers/a2a/config.cjs');
+var ContentStore = require('./content/ContentStore.cjs');
+var ArtifactStore = require('./content/ArtifactStore.cjs');
+var mcpAutoCache = require('./content/mcpAutoCache.cjs');
 var constants$2 = require('./memory/constants.cjs');
 var paths = require('./memory/paths.cjs');
 var pgvectorStore = require('./memory/pgvectorStore.cjs');
@@ -268,6 +271,13 @@ exports.extractTaskText = client.extractTaskText;
 exports.generateRpcId = client.generateRpcId;
 exports.a2aConsoleLogger = config.consoleLogger;
 exports.getA2AEnvDefaults = config.getA2AEnvDefaults;
+exports.CONTENT_TTL_MS = ContentStore.CONTENT_TTL_MS;
+exports.ContentStore = ContentStore.ContentStore;
+exports.ArtifactStore = ArtifactStore.ArtifactStore;
+exports.sanitizeName = ArtifactStore.sanitizeName;
+exports.buildCachedResponse = mcpAutoCache.buildCachedResponse;
+exports.extractUiMarkers = mcpAutoCache.extractUiMarkers;
+exports.interceptMcpResult = mcpAutoCache.interceptMcpResult;
 exports.DEFAULT_CITATIONS_MODE = constants$2.DEFAULT_CITATIONS_MODE;
 exports.DEFAULT_FLUSH_RESERVE_FLOOR_TOKENS = constants$2.DEFAULT_FLUSH_RESERVE_FLOOR_TOKENS;
 exports.DEFAULT_FLUSH_SOFT_THRESHOLD_TOKENS = constants$2.DEFAULT_FLUSH_SOFT_THRESHOLD_TOKENS;

package/dist/cjs/main.cjs.map

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

package/dist/cjs/providers/tools-server/ToolsServerCapabilityProvider.cjs

@@ -22,9 +22,10 @@ class ToolsServerCapabilityProvider {
     manifestPath;
     executePath;
     cache;
+    getExecuteAuthHeaders;
     constructor(config) {
         this.config = config;
-        const { baseUrl, apiKey, manifestPath = '/manifest', executePath = '/execute/:name', timeoutMs = 30_000, manifestTtlMs = 60_000, client, proxy, } = config;
+        const { baseUrl, apiKey, manifestPath = '/manifest', executePath = '/execute/:name', timeoutMs = 30_000, manifestTtlMs = 60_000, client, proxy, getExecuteAuthHeaders, } = config;
         if (!baseUrl) {
             throw new Error('ToolsServerCapabilityProvider: baseUrl is required');
         }
@@ -35,6 +36,7 @@ class ToolsServerCapabilityProvider {
         this.manifestPath = manifestPath;
         this.executePath = executePath;
         this.cache = new toolManifest.ManifestCache({ ttlMs: manifestTtlMs });
+        this.getExecuteAuthHeaders = getExecuteAuthHeaders;
         if (client) {
             this.client = client;
         }
@@ -81,6 +83,7 @@ class ToolsServerCapabilityProvider {
         return capabilities.map((cap) => proxyTool.buildProxyTool(cap, credentials, {
             client: this.client,
             executePath: this.executePath,
+            getAuthHeaders: this.getExecuteAuthHeaders,
         }));
     }
     /** Force a manifest refresh on next fetchManifest call. */

package/dist/cjs/providers/tools-server/ToolsServerCapabilityProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ToolsServerCapabilityProvider.cjs","sources":["../../../../src/providers/tools-server/ToolsServerCapabilityProvider.ts"],"sourcesContent":["/**\n * ToolsServerCapabilityProvider — capabilities sourced from a tools-server\n * HTTP endpoint.\n *\n * Fetches the manifest via GET /manifest, builds proxy StructuredTools via\n * POST /execute/:tool. Manifest is cached (TTL-configurable) so repeated\n * init cycles don't refetch.\n *\n * See docs/architecture-capability-layer.md for the design rationale.\n */\n\nimport type { AxiosInstance } from 'axios';\nimport type { StructuredToolInterface } from '@langchain/core/tools';\nimport {\n  CapabilityKind,\n  type Capability,\n  type CapabilityFilter,\n  type CapabilityProvider,\n  type CredentialMap,\n} from '@/providers/types';\nimport {\n  createHttpClient,\n  type HttpClientConfig,\n  assertOk,\n} from '@/utils/httpClient';\nimport {\n  ManifestCache,\n  filterToCacheKey,\n  applyFilter,\n} from '@/utils/toolManifest';\nimport { buildProxyTool } from '@/tools/proxyTool';\n\n/** Configuration for ToolsServerCapabilityProvider. */\nexport interface ToolsServerConfig {\n  /** Tools-server base URL (e.g., https://tools.illuma.ai or http://localhost:3500). */\n  baseUrl: string;\n  /** API key sent as x-api-key header on all requests. Required. */\n  apiKey: string;\n  /** Optional override for manifest path. Defaults to `/manifest`. */\n  manifestPath?: string;\n  /** Optional override for execute path template. Defaults to `/execute/:name`. */\n  executePath?: string;\n  /** Request timeout in ms. Defaults to 30_000. */\n  timeoutMs?: number;\n  /** Manifest cache TTL in ms. 0 disables. Defaults to 60_000 (1 min). */\n  manifestTtlMs?: number;\n  /** Optional pre-built axios instance (for testing). */\n  client?: AxiosInstance;\n  /** Optional proxy override (defaults to process.env.PROXY). */\n  proxy?: string | null;\n}\n\n/**\n * Shape of a single entry from tools-server's /manifest response.\n *\n * Matches the tools-server ManifestToolEntry type. We define our own here\n * to avoid cross-package coupling — the shape is a stable HTTP contract.\n */\ninterface ToolsServerManifestEntry {\n  pluginKey: string;\n  name: string;\n  description: string;\n  icon?: string;\n  authConfig?: Array<{\n    authField: string;\n    label?: string;\n    description?: string;\n    source?: string;\n    required?: boolean;\n    prod?: boolean;\n    admin?: boolean;\n    hide?: boolean;\n  }>;\n  /** Input schema as JSON Schema (tools-server emits `schema`). */\n  schema?: unknown;\n  /** Legacy alias accepted for backwards compatibility. */\n  jsonSchema?: unknown;\n  category?: string;\n  tags?: string[];\n  toolkit?: string;\n  endpoint?: string;\n  /** Governance flags forwarded by tools-server getManifest(). */\n  hidden?: boolean;\n  admin?: boolean;\n  env?: Array<'development' | 'production' | 'test' | 'staging'>;\n}\n\nexport class ToolsServerCapabilityProvider implements CapabilityProvider {\n  readonly providerId: string;\n  private readonly client: AxiosInstance;\n  private readonly manifestPath: string;\n  private readonly executePath: string;\n  private readonly cache: ManifestCache;\n\n  constructor(private readonly config: ToolsServerConfig) {\n    const {\n      baseUrl,\n      apiKey,\n      manifestPath = '/manifest',\n      executePath = '/execute/:name',\n      timeoutMs = 30_000,\n      manifestTtlMs = 60_000,\n      client,\n      proxy,\n    } = config;\n\n    if (!baseUrl) {\n      throw new Error('ToolsServerCapabilityProvider: baseUrl is required');\n    }\n    if (!apiKey) {\n      throw new Error('ToolsServerCapabilityProvider: apiKey is required');\n    }\n\n    this.providerId = `tools-server:${baseUrl}`;\n    this.manifestPath = manifestPath;\n    this.executePath = executePath;\n    this.cache = new ManifestCache({ ttlMs: manifestTtlMs });\n\n    if (client) {\n      this.client = client;\n    } else {\n      const httpConfig: HttpClientConfig = {\n        baseURL: baseUrl,\n        apiKey,\n        timeoutMs,\n        proxy,\n      };\n      this.client = createHttpClient(httpConfig);\n    }\n  }\n\n  async fetchManifest(filter?: CapabilityFilter): Promise<Capability[]> {\n    const cacheKey = filterToCacheKey(filter);\n    const cached = this.cache.get(cacheKey);\n    if (cached) {\n      // DEBUG: cache hit (remove after stabilization)\n      // eslint-disable-next-line no-console\n      console.debug(\n        `[${this.providerId}] manifest cache hit — ${cached.length} caps`\n      );\n      return cached;\n    }\n\n    // DEBUG\n    // eslint-disable-next-line no-console\n    console.debug(\n      `[${this.providerId}] fetching manifest from ${this.manifestPath}`\n    );\n\n    const res = await this.client.get<ToolsServerManifestEntry[]>(\n      this.manifestPath\n    );\n    assertOk(res.status, this.manifestPath, res.data);\n\n    const entries = Array.isArray(res.data) ? res.data : [];\n    const capabilities: Capability[] = entries.map((entry) =>\n      normalizeEntry(entry)\n    );\n\n    // Apply filter before caching the full list separately so unfiltered\n    // refetches don't re-hit the network.\n    const fullCacheKey = filterToCacheKey();\n    this.cache.set(fullCacheKey, capabilities);\n\n    const filtered = applyFilter(capabilities, filter);\n    if (cacheKey !== fullCacheKey) {\n      this.cache.set(cacheKey, filtered);\n    }\n\n    // DEBUG\n    // eslint-disable-next-line no-console\n    console.debug(\n      `[${this.providerId}] manifest loaded — ${capabilities.length} caps, ${filtered.length} after filter`\n    );\n\n    return filtered;\n  }\n\n  async createRunnables(\n    capabilities: Capability[],\n    credentials: CredentialMap\n  ): Promise<StructuredToolInterface[]> {\n    return capabilities.map((cap) =>\n      buildProxyTool(cap, credentials, {\n        client: this.client,\n        executePath: this.executePath,\n      })\n    );\n  }\n\n  /** Force a manifest refresh on next fetchManifest call. */\n  invalidateCache(): void {\n    this.cache.clear();\n  }\n}\n\n/**\n * Translate a raw tools-server manifest entry into a typed Capability.\n * Defensive — tools-server may add fields; we pull only what we need.\n */\nfunction normalizeEntry(entry: ToolsServerManifestEntry): Capability {\n  return {\n    kind: CapabilityKind.TOOL,\n    name: entry.pluginKey,\n    description: entry.description ?? '',\n    schema: entry.schema ?? entry.jsonSchema,\n    authConfig: (entry.authConfig ?? []).map((ac) => ({\n      authField: ac.authField,\n      label: ac.label,\n      description: ac.description,\n      required: ac.required,\n      prod: ac.prod,\n      admin: ac.admin,\n      hide: ac.hide,\n      // Source is a string in wire format; downstream consumers coerce to AuthSource.\n      source: ac.source as Capability['authConfig'][number]['source'],\n    })),\n    metadata: {\n      icon: entry.icon,\n      category: entry.category,\n      tags: entry.tags,\n      // Governance — hosts use these to gate UI/role/environment.\n      hidden: entry.hidden,\n      admin: entry.admin,\n      env: entry.env,\n    },\n  };\n}\n"],"names":["ManifestCache","createHttpClient","filterToCacheKey","assertOk","applyFilter","buildProxyTool","CapabilityKind"],"mappings":"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"}
+{"version":3,"file":"ToolsServerCapabilityProvider.cjs","sources":["../../../../src/providers/tools-server/ToolsServerCapabilityProvider.ts"],"sourcesContent":["/**\n * ToolsServerCapabilityProvider — capabilities sourced from a tools-server\n * HTTP endpoint.\n *\n * Fetches the manifest via GET /manifest, builds proxy StructuredTools via\n * POST /execute/:tool. Manifest is cached (TTL-configurable) so repeated\n * init cycles don't refetch.\n *\n * See docs/architecture-capability-layer.md for the design rationale.\n */\n\nimport type { AxiosInstance } from 'axios';\nimport type { StructuredToolInterface } from '@langchain/core/tools';\nimport {\n  CapabilityKind,\n  type Capability,\n  type CapabilityFilter,\n  type CapabilityProvider,\n  type CredentialMap,\n} from '@/providers/types';\nimport {\n  createHttpClient,\n  type HttpClientConfig,\n  assertOk,\n} from '@/utils/httpClient';\nimport {\n  ManifestCache,\n  filterToCacheKey,\n  applyFilter,\n} from '@/utils/toolManifest';\nimport { buildProxyTool } from '@/tools/proxyTool';\n\n/** Configuration for ToolsServerCapabilityProvider. */\nexport interface ToolsServerConfig {\n  /** Tools-server base URL (e.g., https://tools.illuma.ai or http://localhost:3500). */\n  baseUrl: string;\n  /** API key sent as x-api-key header on all requests. Required. */\n  apiKey: string;\n  /** Optional override for manifest path. Defaults to `/manifest`. */\n  manifestPath?: string;\n  /** Optional override for execute path template. Defaults to `/execute/:name`. */\n  executePath?: string;\n  /** Request timeout in ms. Defaults to 30_000. */\n  timeoutMs?: number;\n  /** Manifest cache TTL in ms. 0 disables. Defaults to 60_000 (1 min). */\n  manifestTtlMs?: number;\n  /** Optional pre-built axios instance (for testing). */\n  client?: AxiosInstance;\n  /** Optional proxy override (defaults to process.env.PROXY). */\n  proxy?: string | null;\n  /**\n   * Optional per-request auth header builder — invoked on every tool\n   * invocation (NOT on the manifest fetch, which is service-to-service).\n   * When provided, the returned headers are merged into the `/execute`\n   * request so the host can pass user-scoped identity (e.g.,\n   * `Authorization: Bearer <jwt>`) that tools-server verifies for\n   * admin-gated tools.\n   *\n   * Typical host wiring: mint a short-lived JWT per call carrying the\n   * authenticated user's `{ userId, role }` claims; tools-server's\n   * `TOOLS_SERVER_JWT_SECRET` validates.\n   */\n  getExecuteAuthHeaders?: () =>\n    | Record<string, string>\n    | Promise<Record<string, string>>;\n}\n\n/**\n * Shape of a single entry from tools-server's /manifest response.\n *\n * Matches the tools-server ManifestToolEntry type. We define our own here\n * to avoid cross-package coupling — the shape is a stable HTTP contract.\n */\ninterface ToolsServerManifestEntry {\n  pluginKey: string;\n  name: string;\n  description: string;\n  icon?: string;\n  authConfig?: Array<{\n    authField: string;\n    label?: string;\n    description?: string;\n    source?: string;\n    required?: boolean;\n    prod?: boolean;\n    admin?: boolean;\n    hide?: boolean;\n  }>;\n  /** Input schema as JSON Schema (tools-server emits `schema`). */\n  schema?: unknown;\n  /** Legacy alias accepted for backwards compatibility. */\n  jsonSchema?: unknown;\n  category?: string;\n  tags?: string[];\n  toolkit?: string;\n  endpoint?: string;\n  /** Governance flags forwarded by tools-server getManifest(). */\n  hidden?: boolean;\n  admin?: boolean;\n  env?: Array<'development' | 'production' | 'test' | 'staging'>;\n}\n\nexport class ToolsServerCapabilityProvider implements CapabilityProvider {\n  readonly providerId: string;\n  private readonly client: AxiosInstance;\n  private readonly manifestPath: string;\n  private readonly executePath: string;\n  private readonly cache: ManifestCache;\n  private readonly getExecuteAuthHeaders?: () =>\n    | Record<string, string>\n    | Promise<Record<string, string>>;\n\n  constructor(private readonly config: ToolsServerConfig) {\n    const {\n      baseUrl,\n      apiKey,\n      manifestPath = '/manifest',\n      executePath = '/execute/:name',\n      timeoutMs = 30_000,\n      manifestTtlMs = 60_000,\n      client,\n      proxy,\n      getExecuteAuthHeaders,\n    } = config;\n\n    if (!baseUrl) {\n      throw new Error('ToolsServerCapabilityProvider: baseUrl is required');\n    }\n    if (!apiKey) {\n      throw new Error('ToolsServerCapabilityProvider: apiKey is required');\n    }\n\n    this.providerId = `tools-server:${baseUrl}`;\n    this.manifestPath = manifestPath;\n    this.executePath = executePath;\n    this.cache = new ManifestCache({ ttlMs: manifestTtlMs });\n    this.getExecuteAuthHeaders = getExecuteAuthHeaders;\n\n    if (client) {\n      this.client = client;\n    } else {\n      const httpConfig: HttpClientConfig = {\n        baseURL: baseUrl,\n        apiKey,\n        timeoutMs,\n        proxy,\n      };\n      this.client = createHttpClient(httpConfig);\n    }\n  }\n\n  async fetchManifest(filter?: CapabilityFilter): Promise<Capability[]> {\n    const cacheKey = filterToCacheKey(filter);\n    const cached = this.cache.get(cacheKey);\n    if (cached) {\n      // DEBUG: cache hit (remove after stabilization)\n      // eslint-disable-next-line no-console\n      console.debug(\n        `[${this.providerId}] manifest cache hit — ${cached.length} caps`\n      );\n      return cached;\n    }\n\n    // DEBUG\n    // eslint-disable-next-line no-console\n    console.debug(\n      `[${this.providerId}] fetching manifest from ${this.manifestPath}`\n    );\n\n    const res = await this.client.get<ToolsServerManifestEntry[]>(\n      this.manifestPath\n    );\n    assertOk(res.status, this.manifestPath, res.data);\n\n    const entries = Array.isArray(res.data) ? res.data : [];\n    const capabilities: Capability[] = entries.map((entry) =>\n      normalizeEntry(entry)\n    );\n\n    // Apply filter before caching the full list separately so unfiltered\n    // refetches don't re-hit the network.\n    const fullCacheKey = filterToCacheKey();\n    this.cache.set(fullCacheKey, capabilities);\n\n    const filtered = applyFilter(capabilities, filter);\n    if (cacheKey !== fullCacheKey) {\n      this.cache.set(cacheKey, filtered);\n    }\n\n    // DEBUG\n    // eslint-disable-next-line no-console\n    console.debug(\n      `[${this.providerId}] manifest loaded — ${capabilities.length} caps, ${filtered.length} after filter`\n    );\n\n    return filtered;\n  }\n\n  async createRunnables(\n    capabilities: Capability[],\n    credentials: CredentialMap\n  ): Promise<StructuredToolInterface[]> {\n    return capabilities.map((cap) =>\n      buildProxyTool(cap, credentials, {\n        client: this.client,\n        executePath: this.executePath,\n        getAuthHeaders: this.getExecuteAuthHeaders,\n      })\n    );\n  }\n\n  /** Force a manifest refresh on next fetchManifest call. */\n  invalidateCache(): void {\n    this.cache.clear();\n  }\n}\n\n/**\n * Translate a raw tools-server manifest entry into a typed Capability.\n * Defensive — tools-server may add fields; we pull only what we need.\n */\nfunction normalizeEntry(entry: ToolsServerManifestEntry): Capability {\n  return {\n    kind: CapabilityKind.TOOL,\n    name: entry.pluginKey,\n    description: entry.description ?? '',\n    schema: entry.schema ?? entry.jsonSchema,\n    authConfig: (entry.authConfig ?? []).map((ac) => ({\n      authField: ac.authField,\n      label: ac.label,\n      description: ac.description,\n      required: ac.required,\n      prod: ac.prod,\n      admin: ac.admin,\n      hide: ac.hide,\n      // Source is a string in wire format; downstream consumers coerce to AuthSource.\n      source: ac.source as Capability['authConfig'][number]['source'],\n    })),\n    metadata: {\n      icon: entry.icon,\n      category: entry.category,\n      tags: entry.tags,\n      // Governance — hosts use these to gate UI/role/environment.\n      hidden: entry.hidden,\n      admin: entry.admin,\n      env: entry.env,\n    },\n  };\n}\n"],"names":["ManifestCache","createHttpClient","filterToCacheKey","assertOk","applyFilter","buildProxyTool","CapabilityKind"],"mappings":"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"}

package/dist/cjs/tools/proxyTool.cjs

@@ -24,7 +24,7 @@ var httpClient = require('../utils/httpClient.cjs');
  * per-invocation credential rotation should rebuild the tool.
  */
 function buildProxyTool(capability, credentials, options) {
-    const { client, executePath = '/execute/:name', onExecute } = options;
+    const { client, executePath = '/execute/:name', onExecute, getAuthHeaders, } = options;
     const url = executePath.replace(':name', encodeURIComponent(capability.name));
     return tools.tool(async (input) => {
         const startMs = Date.now();
@@ -33,10 +33,12 @@ function buildProxyTool(capability, credentials, options) {
             // DEBUG: log (remove after POC stabilizes)
             // eslint-disable-next-line no-console
             console.debug(`${debugPrefix} invoking — inputKeys=${input && typeof input === 'object' ? Object.keys(input).length : 0}`);
-            const res = await client.post(url, {
-                input,
-                credentials,
-            });
+            const extraHeaders = getAuthHeaders
+                ? await getAuthHeaders()
+                : undefined;
+            const res = await client.post(url, { input, credentials }, extraHeaders && Object.keys(extraHeaders).length > 0
+                ? { headers: extraHeaders }
+                : undefined);
             const durationMs = Date.now() - startMs;
             if (res.status < 200 || res.status >= 300) {
                 throw new httpClient.HttpError(res.status, url, res.data);

package/dist/cjs/tools/proxyTool.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"proxyTool.cjs","sources":["../../../src/tools/proxyTool.ts"],"sourcesContent":["/**\n * proxyTool — wraps a Capability into a LangChain StructuredTool that\n * dispatches execution to a remote backend (e.g., tools-server) over HTTP.\n *\n * The LLM sees this tool identically to a locally-implemented tool:\n *   - same name\n *   - same description\n *   - same input schema (JSON Schema)\n *   - same invoke(input) contract\n *\n * Under the hood, invoke() POSTs to the backend's execute endpoint with\n * the input and a caller-supplied credential map. The backend returns\n * { success, result, error, timing } which this wrapper unpacks.\n */\n\nimport type { AxiosInstance } from 'axios';\nimport { tool, type StructuredToolInterface } from '@langchain/core/tools';\nimport type { Capability, CredentialMap } from '@/providers/types';\nimport { HttpError } from '@/utils/httpClient';\n\n/** Shape of the backend's execute response. Matches tools-server. */\nexport interface ExecuteResponse {\n  success: boolean;\n  result?: unknown;\n  error?: string;\n  timing?: { durationMs: number };\n}\n\n/** Options passed to buildProxyTool. */\nexport interface ProxyToolOptions {\n  /** HTTP client configured with backend base URL + auth. */\n  client: AxiosInstance;\n  /**\n   * Path template for execution. The literal `:name` is replaced with the\n   * capability's name. Defaults to `/execute/:name` (tools-server convention).\n   */\n  executePath?: string;\n  /**\n   * Optional callback invoked on every execution — used for metrics,\n   * telemetry, debug logging. Errors in the hook are swallowed.\n   */\n  onExecute?: (ctx: ExecuteCallbackContext) => void;\n}\n\nexport interface ExecuteCallbackContext {\n  capabilityName: string;\n  input: unknown;\n  response?: ExecuteResponse;\n  error?: Error;\n  durationMs: number;\n}\n\n/**\n * Build a StructuredTool that proxies to a remote backend.\n *\n * The credentialMap is baked into the closure — callers that need\n * per-invocation credential rotation should rebuild the tool.\n */\nexport function buildProxyTool(\n  capability: Capability,\n  credentials: CredentialMap,\n  options: ProxyToolOptions\n): StructuredToolInterface {\n  const { client, executePath = '/execute/:name', onExecute } = options;\n  const url = executePath.replace(':name', encodeURIComponent(capability.name));\n\n  return tool(\n    async (input: unknown): Promise<string> => {\n      const startMs = Date.now();\n      const debugPrefix = `[proxyTool:${capability.name}]`;\n\n      try {\n        // DEBUG: log (remove after POC stabilizes)\n        // eslint-disable-next-line no-console\n        console.debug(\n          `${debugPrefix} invoking — inputKeys=${input && typeof input === 'object' ? Object.keys(input as object).length : 0}`\n        );\n\n        const res = await client.post<ExecuteResponse>(url, {\n          input,\n          credentials,\n        });\n\n        const durationMs = Date.now() - startMs;\n\n        if (res.status < 200 || res.status >= 300) {\n          throw new HttpError(res.status, url, res.data);\n        }\n\n        const body = res.data;\n        if (onExecute) {\n          try {\n            onExecute({\n              capabilityName: capability.name,\n              input,\n              response: body,\n              durationMs,\n            });\n          } catch {\n            // hook errors are non-fatal\n          }\n        }\n\n        if (!body.success) {\n          // DEBUG\n          // eslint-disable-next-line no-console\n          console.debug(\n            `${debugPrefix} backend reported failure — ${body.error}`\n          );\n          throw new Error(body.error ?? 'Tool execution failed');\n        }\n\n        // LangChain tools typically return strings; stringify non-string results\n        if (typeof body.result === 'string') {\n          return body.result;\n        }\n        return JSON.stringify(body.result);\n      } catch (err) {\n        const durationMs = Date.now() - startMs;\n        const error = err instanceof Error ? err : new Error(String(err));\n        if (onExecute) {\n          try {\n            onExecute({\n              capabilityName: capability.name,\n              input,\n              error,\n              durationMs,\n            });\n          } catch {\n            // hook errors are non-fatal\n          }\n        }\n        throw error;\n      }\n    },\n    {\n      name: capability.name,\n      description: capability.description,\n      schema: (capability.schema as object) ?? {\n        type: 'object',\n        properties: {},\n      },\n      responseFormat: 'content',\n    }\n  );\n}\n"],"names":["tool","HttpError"],"mappings":"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"}
+{"version":3,"file":"proxyTool.cjs","sources":["../../../src/tools/proxyTool.ts"],"sourcesContent":["/**\n * proxyTool — wraps a Capability into a LangChain StructuredTool that\n * dispatches execution to a remote backend (e.g., tools-server) over HTTP.\n *\n * The LLM sees this tool identically to a locally-implemented tool:\n *   - same name\n *   - same description\n *   - same input schema (JSON Schema)\n *   - same invoke(input) contract\n *\n * Under the hood, invoke() POSTs to the backend's execute endpoint with\n * the input and a caller-supplied credential map. The backend returns\n * { success, result, error, timing } which this wrapper unpacks.\n */\n\nimport type { AxiosInstance } from 'axios';\nimport { tool, type StructuredToolInterface } from '@langchain/core/tools';\nimport type { Capability, CredentialMap } from '@/providers/types';\nimport { HttpError } from '@/utils/httpClient';\n\n/** Shape of the backend's execute response. Matches tools-server. */\nexport interface ExecuteResponse {\n  success: boolean;\n  result?: unknown;\n  error?: string;\n  timing?: { durationMs: number };\n}\n\n/** Options passed to buildProxyTool. */\nexport interface ProxyToolOptions {\n  /** HTTP client configured with backend base URL + auth. */\n  client: AxiosInstance;\n  /**\n   * Path template for execution. The literal `:name` is replaced with the\n   * capability's name. Defaults to `/execute/:name` (tools-server convention).\n   */\n  executePath?: string;\n  /**\n   * Optional callback invoked on every execution — used for metrics,\n   * telemetry, debug logging. Errors in the hook are swallowed.\n   */\n  onExecute?: (ctx: ExecuteCallbackContext) => void;\n  /**\n   * Optional per-invocation auth header builder. Called on every tool\n   * invocation before POSTing; returned headers are merged into the\n   * request alongside the base client's headers. Typical use: pass a\n   * freshly minted per-user JWT for admin-gated tools.\n   */\n  getAuthHeaders?: () =>\n    | Record<string, string>\n    | Promise<Record<string, string>>;\n}\n\nexport interface ExecuteCallbackContext {\n  capabilityName: string;\n  input: unknown;\n  response?: ExecuteResponse;\n  error?: Error;\n  durationMs: number;\n}\n\n/**\n * Build a StructuredTool that proxies to a remote backend.\n *\n * The credentialMap is baked into the closure — callers that need\n * per-invocation credential rotation should rebuild the tool.\n */\nexport function buildProxyTool(\n  capability: Capability,\n  credentials: CredentialMap,\n  options: ProxyToolOptions\n): StructuredToolInterface {\n  const {\n    client,\n    executePath = '/execute/:name',\n    onExecute,\n    getAuthHeaders,\n  } = options;\n  const url = executePath.replace(':name', encodeURIComponent(capability.name));\n\n  return tool(\n    async (input: unknown): Promise<string> => {\n      const startMs = Date.now();\n      const debugPrefix = `[proxyTool:${capability.name}]`;\n\n      try {\n        // DEBUG: log (remove after POC stabilizes)\n        // eslint-disable-next-line no-console\n        console.debug(\n          `${debugPrefix} invoking — inputKeys=${input && typeof input === 'object' ? Object.keys(input as object).length : 0}`\n        );\n\n        const extraHeaders = getAuthHeaders\n          ? await getAuthHeaders()\n          : undefined;\n        const res = await client.post<ExecuteResponse>(\n          url,\n          { input, credentials },\n          extraHeaders && Object.keys(extraHeaders).length > 0\n            ? { headers: extraHeaders }\n            : undefined\n        );\n\n        const durationMs = Date.now() - startMs;\n\n        if (res.status < 200 || res.status >= 300) {\n          throw new HttpError(res.status, url, res.data);\n        }\n\n        const body = res.data;\n        if (onExecute) {\n          try {\n            onExecute({\n              capabilityName: capability.name,\n              input,\n              response: body,\n              durationMs,\n            });\n          } catch {\n            // hook errors are non-fatal\n          }\n        }\n\n        if (!body.success) {\n          // DEBUG\n          // eslint-disable-next-line no-console\n          console.debug(\n            `${debugPrefix} backend reported failure — ${body.error}`\n          );\n          throw new Error(body.error ?? 'Tool execution failed');\n        }\n\n        // LangChain tools typically return strings; stringify non-string results\n        if (typeof body.result === 'string') {\n          return body.result;\n        }\n        return JSON.stringify(body.result);\n      } catch (err) {\n        const durationMs = Date.now() - startMs;\n        const error = err instanceof Error ? err : new Error(String(err));\n        if (onExecute) {\n          try {\n            onExecute({\n              capabilityName: capability.name,\n              input,\n              error,\n              durationMs,\n            });\n          } catch {\n            // hook errors are non-fatal\n          }\n        }\n        throw error;\n      }\n    },\n    {\n      name: capability.name,\n      description: capability.description,\n      schema: (capability.schema as object) ?? {\n        type: 'object',\n        properties: {},\n      },\n      responseFormat: 'content',\n    }\n  );\n}\n"],"names":["tool","HttpError"],"mappings":"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"}