@remnic/core 9.69.36 → 9.69.38

package/dist/chunk-ACY4ZPF7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/summarizer.ts"],"sourcesContent":["import { mkdir, readFile, writeFile, readdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport { log } from \"./logger.js\";\nimport { LocalLlmClient } from \"./local-llm.js\";\nimport { FallbackLlmClient, fallbackLlmRuntimeContextFromConfig, gatewayTaskChainOptions } from \"./fallback-llm.js\";\nimport { ModelRegistry } from \"./model-registry.js\";\nimport { extractJsonCandidates } from \"./json-extract.js\";\nimport {\n  completeBackgroundGeneration,\n  parseBackgroundGenerationJson,\n} from \"./background-generation.js\";\nimport type { HourlySummary, TranscriptEntry, PluginConfig, GatewayConfig } from \"./types.js\";\nimport type { TranscriptManager } from \"./transcript.js\";\nimport { readSummarySnapshot, upsertSummarySnapshot, writeSummarySnapshot } from \"./summary-snapshot.js\";\nimport { encodeStoragePathSegment, resolveSafeStoragePath } from \"./storage-paths.js\";\nimport { sessionStoragePaths } from \"./session-identity.js\";\nimport { resolveLocalLlmCapabilities } from \"./capabilities.js\";\nimport { resolvePipelineProcessingCapabilities } from \"./capabilities.js\";\n\n// Schema for LLM summary output\nconst HourlySummarySchema = z.object({\n  bullets: z.array(z.string().trim().min(1)).min(1).describe(\"3-5 bullet points summarizing the hour's activity\"),\n});\n\ntype HourlySummaryResult = z.infer<typeof HourlySummarySchema>;\n\nconst HourlySummaryExtendedSchema = z.object({\n  topics: z.array(z.string()).default([]),\n  decisions: z.array(z.string()).default([]),\n  actionItems: z.array(z.string()).default([]),\n  rejected: z.array(z.string()).default([]),\n});\n\ntype HourlySummaryExtendedResult = z.infer<typeof HourlySummaryExtendedSchema>;\n\ntype HourlySummaryExtendedMeta = {\n  userTurns: number;\n  assistantTurns: number;\n  toolCalls: number;\n  toolCounts: Record<string, number>;\n};\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/**\n * Outcome stats of one `runHourly` pass (issue #2783). The summarizer must\n * not report success on empty work: an empty or stale transcript store is\n * the delegate-mode starvation signature, and callers surface these counts\n * and the staleness flag as a distinct warning instead of a bare ok.\n */\nexport interface HourlySummarizerRunStats {\n  sessionsConsidered: number;\n  sessionsWithEntries: number;\n  summariesWritten: number;\n  /** True when the newest transcript entry across the store is older than STALE_STORE_MS. */\n  staleStore: boolean;\n  /** ISO timestamp of the newest transcript entry seen by the scan, when any exist. */\n  newestEntryTimestamp: string | null;\n  /** True when the transcript scan itself FAILED (unreadable store) — distinct from an empty store. */\n  scanFailed: boolean;\n}\n\n/** A store whose newest entry is older than this is considered stale (starvation signal, issue #2783). */\nconst STALE_STORE_MS = 2 * 60 * 60 * 1000;\n\n/**\n * Interpret one {@link HourlySummarizerRunStats} into the operator-facing\n * message/warning (issue #2783). Every degraded shape — failed scan, empty\n * store, backend-down, stale store — is DISTINCT from success; monitoring\n * alerts on `warning`, never on `ok` (ok only means \"the run completed\").\n */\nexport function summarizeHourlyStatus(stats: HourlySummarizerRunStats): {\n  message: string;\n  warning?: string;\n} {\n  if (stats.scanFailed) {\n    return {\n      message:\n        \"Hourly summarization completed, but the transcript store scan FAILED (unreadable directory or I/O error). Investigate the daemon's memoryDir.\",\n      warning: \"transcript store scan failed\",\n    };\n  }\n  if (stats.sessionsConsidered === 0) {\n    return {\n      message:\n        \"Hourly summarization completed, but the transcript store is empty — no sessions found. If turns are ingested via observe, transcript persistence may be disabled or failing.\",\n      warning: \"transcript store is empty\",\n    };\n  }\n  if (stats.sessionsWithEntries > 0 && stats.summariesWritten === 0) {\n    return {\n      message: `Hourly summarization found ${stats.sessionsWithEntries} session(s) with transcript entries but wrote no summaries — the summarizer backend may be down.`,\n      warning: \"sessions with entries produced no summaries\",\n    };\n  }\n  if (stats.sessionsWithEntries === 0 && stats.staleStore) {\n    return {\n      message: `Hourly summarization completed with no transcript entries for the target hour, and the store looks stale (newest entry ${stats.newestEntryTimestamp ?? \"unknown\"}).`,\n      warning: \"no transcript entries for the target hour and no new entries recently\",\n    };\n  }\n  return {\n    message: `Hourly summarization completed: ${stats.summariesWritten} summar${stats.summariesWritten === 1 ? \"y\" : \"ies\"} written across ${stats.sessionsWithEntries} session${stats.sessionsWithEntries === 1 ? \"\" : \"s\"} with transcript entries.`,\n  };\n}\n\nexport class HourlySummarizer {\n  private summariesDir: string;\n  private config: PluginConfig;\n  private localLlm: LocalLlmClient;\n  private fallbackLlm: FallbackLlmClient;\n  private modelRegistry: ModelRegistry;\n  private transcript?: TranscriptManager;\n\n  constructor(\n    config: PluginConfig,\n    gatewayConfig?: GatewayConfig,\n    modelRegistry?: ModelRegistry,\n    transcript?: TranscriptManager\n  ) {\n    this.config = config;\n    this.summariesDir = path.join(config.memoryDir, \"summaries\", \"hourly\");\n    this.modelRegistry = modelRegistry ?? new ModelRegistry(config.memoryDir);\n    this.transcript = transcript;\n\n    // Initialize local LLM client with shared model registry\n    this.localLlm = new LocalLlmClient(config, this.modelRegistry);\n\n    // Initialize fallback client with gateway config\n    this.fallbackLlm = new FallbackLlmClient(gatewayConfig, fallbackLlmRuntimeContextFromConfig(config));\n\n    if (\n      !gatewayConfig?.agents?.defaults?.model?.primary &&\n      !resolveLocalLlmCapabilities(config).localLlm &&\n      config.modelSource !== \"gateway\"\n    ) {\n      log.warn(\"no gateway default AI and local LLM disabled — hourly summarization disabled\");\n    }\n  }\n\n  private get useGatewayModelSource(): boolean {\n    return this.config.modelSource === \"gateway\";\n  }\n\n  private get shouldUseLocalLlm(): boolean {\n    return resolveLocalLlmCapabilities(this.config).localLlm && !this.useGatewayModelSource;\n  }\n\n  private withGatewayAgent(\n    options: import(\"./fallback-llm.js\").FallbackLlmOptions\n  ): import(\"./fallback-llm.js\").FallbackLlmOptions {\n    if (!this.useGatewayModelSource) return options;\n    // Shared resolution (taskModelChain > gatewayAgentId) — gotcha #22. Issue #1365.\n    return { ...options, ...gatewayTaskChainOptions(this.config) };\n  }\n\n  async initialize(): Promise<void> {\n    await mkdir(this.summariesDir, { recursive: true });\n    log.info(\"hourly summarizer initialized\");\n  }\n\n  private async summarySessionDir(sessionKey: string): Promise<string> {\n    return resolveSafeStoragePath(this.summariesDir, encodeStoragePathSegment(sessionKey, \"session\"));\n  }\n\n  private async legacySummarySessionDir(sessionKey: string): Promise<string | null> {\n    if (sessionKey.includes(\"\\0\")) return null;\n    try {\n      return await resolveSafeStoragePath(this.summariesDir, sessionKey);\n    } catch {\n      return null;\n    }\n  }\n\n  private summaryDateString(hour: string): string {\n    const dateStr = hour.slice(0, 10);\n    if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(dateStr)) {\n      throw new Error(`invalid hourly summary timestamp: ${hour}`);\n    }\n    return dateStr;\n  }\n\n  // Generate summary for a specific hour and session\n  async generateSummary(\n    sessionKey: string,\n    hourStart: Date,\n    entries: TranscriptEntry[]\n  ): Promise<HourlySummary | null> {\n    if (entries.length === 0) return null;\n\n    // Format entries for the LLM\n    const conversation = entries.map((e) => `[${e.role}] ${e.content}`).join(\"\\n\\n\");\n\n    if (resolvePipelineProcessingCapabilities(this.config).hourlySummariesExtended) {\n      const extended = await this.generateExtended(sessionKey, hourStart, conversation, entries);\n      if (!extended) return null;\n      const meta: HourlySummaryExtendedMeta = {\n        userTurns: entries.filter((e) => e.role === \"user\").length,\n        assistantTurns: entries.filter((e) => e.role === \"assistant\").length,\n        toolCalls: extended._meta.toolCalls,\n        toolCounts: extended._meta.toolCounts,\n      };\n      // Keep HourlySummary surface stable; encode \"topics\" as bullets for recall injection.\n      const base: HourlySummary = {\n        hour: hourStart.toISOString(),\n        sessionKey,\n        bullets: extended.topics.length > 0 ? extended.topics.slice(0, 5) : [\"(summary generated)\"],\n        turnCount: entries.length,\n        generatedAt: new Date().toISOString(),\n      };\n      const withExtras = base as any;\n      withExtras._extended = extended;\n      withExtras._extendedMeta = meta;\n      return base;\n    }\n\n    const hourIso = hourStart.toISOString();\n    const startTime = Date.now();\n\n    if (this.config.backgroundGeneration) {\n      try {\n        const text = await completeBackgroundGeneration(this.config, [\n          { role: \"system\", content: \"You are a conversation summarization system. Output valid JSON only.\" },\n          { role: \"user\", content: `Summarize this conversation:\\n\\n${conversation}` },\n        ]);\n        const parsed = parseBackgroundGenerationJson(text, (value) => HourlySummarySchema.parse(value));\n        if (parsed) {\n          return {\n            hour: hourIso,\n            sessionKey,\n            bullets: parsed.bullets,\n            turnCount: entries.length,\n            generatedAt: new Date().toISOString(),\n          };\n        }\n      } catch {\n        log.info(\"summary generation: background generation unavailable, continuing\");\n      }\n    }\n\n    // Try local LLM first if enabled\n    if (this.shouldUseLocalLlm) {\n      try {\n        const localResult = await this.generateWithLocalLlm(conversation);\n        if (localResult) {\n          const durationMs = Date.now() - startTime;\n          log.debug(`generated hourly summary for ${sessionKey} at ${hourIso} in ${durationMs}ms using local LLM`);\n          return {\n            hour: hourIso,\n            sessionKey,\n            bullets: localResult.bullets,\n            turnCount: entries.length,\n            generatedAt: new Date().toISOString(),\n          };\n        }\n        // Local failed, fall back if allowed\n        if (!this.config.localLlmFallback) {\n          log.warn(\"summary generation: local LLM failed and fallback disabled\");\n          return null;\n        }\n        log.info(\"summary generation: local LLM unavailable, falling back to gateway default AI\");\n      } catch (err) {\n        if (!this.config.localLlmFallback) {\n          log.warn(\"summary generation: local LLM error and fallback disabled:\", err);\n          return null;\n        }\n        log.info(\"summary generation: local LLM error, falling back to gateway default AI:\", err);\n      }\n    }\n\n    // Fall back to gateway's default AI\n    log.info(\"summary generation: falling back to gateway default AI\");\n\n    try {\n      const messages = [\n        {\n          role: \"system\" as const,\n          content: `You are a conversation summarization system. Summarize the following conversation transcript into 3-5 concise bullet points.\n\nGuidelines:\n- Focus on what was accomplished, decided, or discussed\n- Include specific topics, projects, or entities mentioned\n- Note any significant user requests or agent actions\n- Keep bullets brief but informative (1-2 sentences each)\n- Skip trivial greetings or meta-conversation\n- Use present tense for ongoing work, past for completed items\n\nRespond with valid JSON matching this schema:\n{\n  \"bullets\": [\"bullet 1\", \"bullet 2\", \"bullet 3\"]\n}`,\n        },\n        { role: \"user\" as const, content: `Summarize this conversation:\\n\\n${conversation}` },\n      ];\n\n      const result = await this.fallbackLlm.parseWithSchema(\n        messages,\n        HourlySummarySchema,\n        this.withGatewayAgent({ temperature: 0.3, maxTokens: 8192 })\n      );\n\n      const durationMs = Date.now() - startTime;\n\n      if (result) {\n        log.debug(`generated hourly summary for ${sessionKey} at ${hourIso} in ${durationMs}ms via fallback`);\n        return {\n          hour: hourIso,\n          sessionKey,\n          bullets: result.bullets,\n          turnCount: entries.length,\n          generatedAt: new Date().toISOString(),\n        };\n      }\n\n      log.warn(\"summary generation fallback returned no parsed output\");\n      return null;\n    } catch (err) {\n      log.error(\"summary generation fallback failed\", err);\n      return null;\n    }\n  }\n\n  private async generateExtended(\n    sessionKey: string,\n    hourStart: Date,\n    conversation: string,\n    entries: TranscriptEntry[]\n  ): Promise<(HourlySummaryExtendedResult & { _meta: HourlySummaryExtendedMeta }) | null> {\n    const hourIso = hourStart.toISOString();\n    const startTime = Date.now();\n\n    const hourEnd = new Date(hourStart.getTime() + 60 * 60 * 1000);\n    let toolCounts: Record<string, number> = {};\n    if (this.config.hourlySummariesIncludeToolStats && this.transcript) {\n      const uses = await this.transcript.readToolUse(sessionKey, hourStart, hourEnd);\n      for (const u of uses) toolCounts[u.tool] = (toolCounts[u.tool] ?? 0) + 1;\n    }\n\n    const sys = `You are a conversation summarization system.\\n\\nSummarize the hour into structured sections.\\n\\nReturn valid JSON matching:\\n{\\n  \\\"topics\\\": [\\\"...\\\"],\\n  \\\"decisions\\\": [\\\"...\\\"],\\n  \\\"actionItems\\\": [\\\"...\\\"],\\n  \\\"rejected\\\": [\\\"...\\\"]\\n}\\n\\nGuidelines:\\n- Prefer concrete topics and decisions.\\n- Action items should be imperative.\\n- Rejected ideas are things that were explicitly discarded or reversed.\\n- If there are none for a section, return an empty array.\\n`;\n\n    const toolStatsLine =\n      Object.keys(toolCounts).length > 0\n        ? `Tools used (counts): ${Object.entries(toolCounts)\n            .sort((a, b) => b[1] - a[1])\n            .slice(0, 10)\n            .map(([k, v]) => `${k}=${v}`)\n            .join(\", \")}\\n\\n`\n        : \"\";\n    const userTurns = entries.filter((e) => e.role === \"user\").length;\n    const assistantTurns = entries.filter((e) => e.role === \"assistant\").length;\n    const toolCalls = Object.values(toolCounts).reduce((a, b) => a + b, 0);\n    const statsLine = `Stats: userTurns=${userTurns}, assistantTurns=${assistantTurns}, toolCalls=${toolCalls}\\n\\n`;\n\n    const user = `Hour: ${hourIso}\\nSession: ${sessionKey}\\n\\n${statsLine}${toolStatsLine}Conversation:\\n${conversation}\\n`;\n\n    // Try local LLM first if enabled\n    if (this.shouldUseLocalLlm) {\n      try {\n        const contextSizes = this.modelRegistry.calculateContextSizes(\n          this.config.localLlmModel,\n          this.config.localLlmMaxContext\n        );\n        const truncated =\n          user.length > contextSizes.maxInputChars\n            ? user.slice(0, contextSizes.maxInputChars) + \"\\n\\n[truncated]\"\n            : user;\n        const response = await this.localLlm.chatCompletion(\n          [\n            { role: \"system\", content: \"Output valid JSON only.\" },\n            { role: \"user\", content: sys + \"\\n\\n\" + truncated },\n          ],\n          {\n            temperature: 0.2,\n            maxTokens: contextSizes.maxOutputTokens,\n            operation: \"hourly_summary_extended\",\n            priority: \"background\",\n          }\n        );\n        if (response?.content) {\n          const content = response.content.trim();\n          for (const candidate of extractJsonCandidates(content)) {\n            try {\n              const parsed = JSON.parse(candidate);\n              const result = HourlySummaryExtendedSchema.parse(parsed);\n              log.debug(\n                `generated extended hourly summary for ${sessionKey} at ${hourIso} in ${Date.now() - startTime}ms (local)`\n              );\n              return { ...result, _meta: { userTurns, assistantTurns, toolCalls, toolCounts } };\n            } catch {\n              // keep trying candidates\n            }\n          }\n        }\n      } catch (err) {\n        if (!this.config.localLlmFallback) return null;\n        log.info(\"extended summary: local failed, falling back:\", err);\n      }\n    }\n\n    try {\n      const result = await this.fallbackLlm.parseWithSchema(\n        [\n          { role: \"system\" as const, content: sys },\n          { role: \"user\" as const, content: user },\n        ],\n        HourlySummaryExtendedSchema,\n        this.withGatewayAgent({ temperature: 0.2, maxTokens: 2048 })\n      );\n      if (result) {\n        log.debug(\n          `generated extended hourly summary for ${sessionKey} at ${hourIso} in ${Date.now() - startTime}ms (fallback)`\n        );\n        return { ...result, _meta: { userTurns, assistantTurns, toolCalls, toolCounts } };\n      }\n      return null;\n    } catch (err) {\n      log.error(\"extended summary generation failed\", err);\n      return null;\n    }\n  }\n\n  /**\n   * Generate summary using local LLM with JSON mode.\n   * Uses dynamic context sizing based on model capabilities.\n   */\n  private async generateWithLocalLlm(conversation: string): Promise<HourlySummaryResult | null> {\n    // Get dynamic context sizes based on model capabilities\n    const contextSizes = this.modelRegistry.calculateContextSizes(\n      this.config.localLlmModel,\n      this.config.localLlmMaxContext\n    );\n    log.debug(`Summarizer model context: ${contextSizes.description}`);\n\n    const maxConversationChars = contextSizes.maxInputChars;\n    const truncatedConversation =\n      conversation.length > maxConversationChars\n        ? conversation.slice(0, maxConversationChars) + \"\\n\\n[truncated]\"\n        : conversation;\n\n    const instructions = `You are a conversation summarization system. Summarize the following conversation transcript into 3-5 concise bullet points.\n\nGuidelines:\n- Focus on what was accomplished, decided, or discussed\n- Include specific topics, projects, or entities mentioned\n- Note any significant user requests or agent actions\n- Keep bullets brief but informative (1-2 sentences each)\n- Skip trivial greetings or meta-conversation\n- Use present tense for ongoing work, past for completed items\n\nRespond with valid JSON matching this schema:\n{\n  \"bullets\": [\"bullet 1\", \"bullet 2\", \"bullet 3\"]\n}`;\n\n    const fullPrompt = `${instructions}\\n\\nConversation to summarize:\\n${truncatedConversation}`;\n\n    const response = await this.localLlm.chatCompletion(\n      [\n        { role: \"system\", content: \"You are a conversation summarization system. Output valid JSON only.\" },\n        { role: \"user\", content: fullPrompt },\n      ],\n      {\n        temperature: 0.3,\n        maxTokens: contextSizes.maxOutputTokens,\n        operation: \"hourly_summary\",\n        priority: \"background\",\n      }\n    );\n\n    if (!response?.content) {\n      return null;\n    }\n\n    try {\n      // Parse JSON response\n      const content = response.content.trim();\n      for (const candidate of extractJsonCandidates(content)) {\n        try {\n          const parsed = JSON.parse(candidate);\n          return HourlySummarySchema.parse(parsed);\n        } catch {\n          // keep trying candidates\n        }\n      }\n      return null;\n    } catch (err) {\n      log.warn(\"local LLM summary: failed to parse JSON response:\", err);\n      return null;\n    }\n  }\n\n  // Save summary to file\n  async saveSummary(summary: HourlySummary): Promise<void> {\n    const sessionDir = await this.summarySessionDir(summary.sessionKey);\n    await mkdir(sessionDir, { recursive: true });\n\n    // Format date as YYYY-MM-DD for the filename\n    const dateStr = this.summaryDateString(summary.hour);\n    const filePath = await resolveSafeStoragePath(sessionDir, `${dateStr}.md`);\n\n    // Format hour as HH:00 for display\n    const hourStr = summary.hour.slice(11, 13);\n\n    // Build markdown content\n    const lines: string[] = [];\n\n    // Check if file exists to append or create\n    let existingContent = \"\";\n    try {\n      existingContent = await readFile(filePath, \"utf-8\");\n    } catch {\n      // File doesn't exist yet, will create new\n    }\n\n    // Check if this hour already exists (idempotent)\n    const hourHeader = `## ${hourStr}:00`;\n    if (existingContent.includes(hourHeader)) {\n      // Replace existing hour section\n      const headerMatch = new RegExp(`(^|\\\\n)${escapeRegExp(hourHeader)}\\\\n`).exec(existingContent);\n      const sectionStart = headerMatch\n        ? headerMatch.index + headerMatch[1].length\n        : existingContent.indexOf(hourHeader);\n      const nextHeaderPattern = /\\n## \\d{2}:00\\n/g;\n      nextHeaderPattern.lastIndex = sectionStart + hourHeader.length;\n      const nextHeader = nextHeaderPattern.exec(existingContent);\n      const beforeHour = existingContent.slice(0, sectionStart);\n      const afterHour = nextHeader ? existingContent.slice(nextHeader.index + 1) : \"\";\n      const newSection = this.formatHourSection(summary, hourHeader);\n      existingContent = beforeHour + newSection.trimEnd() + (afterHour ? \"\\n\\n\" + afterHour : \"\\n\");\n\n      await writeFile(filePath, existingContent, \"utf-8\");\n      log.debug(`updated hourly summary for ${summary.sessionKey} at ${hourStr}:00`);\n    } else {\n      // Append new hour section\n      const newSection = this.formatHourSection(summary, hourHeader);\n\n      if (existingContent) {\n        // Add to existing file\n        await writeFile(filePath, existingContent.trimEnd() + \"\\n\\n\" + newSection, \"utf-8\");\n      } else {\n        // Create new file with header\n        const header = `# Hourly Summaries — ${dateStr}\\n\\n*Session: ${summary.sessionKey}*\\n`;\n        await writeFile(filePath, header + \"\\n\" + newSection, \"utf-8\");\n      }\n      log.debug(`saved hourly summary for ${summary.sessionKey} at ${hourStr}:00`);\n    }\n    try {\n      await upsertSummarySnapshot(this.config.memoryDir, summary);\n    } catch (error) {\n      log.warn(\n        `hourly summarizer: failed to update summary snapshot for ${summary.sessionKey} (fail-open): ${String(error)}`\n      );\n    }\n  }\n\n  private formatHourSection(summary: HourlySummary, hourHeader: string): string {\n    const ext = (summary as any)._extended as\n      | (HourlySummaryExtendedResult & { _meta?: HourlySummaryExtendedMeta })\n      | undefined;\n    const meta = (summary as any)._extendedMeta as HourlySummaryExtendedMeta | undefined;\n    const lines: string[] = [hourHeader, \"\"];\n\n    if (resolvePipelineProcessingCapabilities(this.config).hourlySummariesExtended && ext) {\n      lines.push(\"### Topics Discussed\");\n      for (const t of ext.topics) lines.push(`- ${t}`);\n      lines.push(\"\");\n      lines.push(\"### Decisions Made\");\n      for (const d of ext.decisions) lines.push(`- ${d}`);\n      lines.push(\"\");\n      lines.push(\"### Action Items\");\n      for (const a of ext.actionItems) lines.push(`- ${a}`);\n      lines.push(\"\");\n      lines.push(\"### Rejected Ideas / Reversals\");\n      for (const r of ext.rejected) lines.push(`- ${r}`);\n      lines.push(\"\");\n      if (meta && Object.keys(meta.toolCounts).length > 0) {\n        lines.push(\"### Tools Used\");\n        const top = Object.entries(meta.toolCounts)\n          .sort((a, b) => b[1] - a[1])\n          .slice(0, 12);\n        for (const [name, count] of top) lines.push(`- ${name}: ${count}`);\n        lines.push(\"\");\n      }\n      lines.push(\"### Stats\");\n      lines.push(`- Turns: ${summary.turnCount}`);\n      if (meta) {\n        lines.push(`- User turns: ${meta.userTurns}`);\n        lines.push(`- Assistant turns: ${meta.assistantTurns}`);\n        lines.push(`- Tool calls: ${meta.toolCalls}`);\n      }\n      lines.push(\"\");\n      return lines.join(\"\\n\");\n    }\n\n    for (const bullet of summary.bullets) lines.push(`- ${bullet}`);\n    lines.push(`  *(${summary.turnCount} turns)*`);\n    lines.push(\"\");\n    return lines.join(\"\\n\");\n  }\n\n  // Read recent summaries for recall injection\n  async readRecent(sessionKey: string, hours: number): Promise<HourlySummary[]> {\n    try {\n      const cutoffTime = Date.now() - hours * 60 * 60 * 1000;\n\n      const snapshot = await readSummarySnapshot(this.config.memoryDir, sessionKey);\n      if (snapshot) {\n        return snapshot\n          .filter((s) => new Date(s.hour).getTime() >= cutoffTime)\n          .sort((a, b) => new Date(b.hour).getTime() - new Date(a.hour).getTime());\n      }\n\n      const summaries: HourlySummary[] = [];\n      const encodedDir = await this.summarySessionDir(sessionKey);\n      const legacyDir = await this.legacySummarySessionDir(sessionKey);\n      const seenDirs = new Set<string>();\n\n      for (const sessionDir of [encodedDir, legacyDir]) {\n        if (!sessionDir || seenDirs.has(sessionDir)) continue;\n        seenDirs.add(sessionDir);\n        const parsed = await this.readSummaryDir(sessionDir, sessionKey);\n        summaries.push(...parsed);\n      }\n\n      const byHour = new Map<string, HourlySummary>();\n      for (const summary of summaries) {\n        if (!byHour.has(summary.hour)) byHour.set(summary.hour, summary);\n      }\n\n      const sortedSummaries = Array.from(byHour.values()).sort(\n        (a, b) => new Date(b.hour).getTime() - new Date(a.hour).getTime()\n      );\n\n      // Filter to recent hours while materializing the full parsed history.\n      const recent = sortedSummaries.filter((s) => new Date(s.hour).getTime() >= cutoffTime);\n\n      if (sortedSummaries.length > 0) {\n        try {\n          await writeSummarySnapshot(this.config.memoryDir, sessionKey, sortedSummaries);\n        } catch (error) {\n          log.warn(\n            `hourly summarizer: failed to materialize summary snapshot for ${sessionKey} (fail-open): ${String(error)}`\n          );\n        }\n      }\n\n      return recent;\n    } catch {\n      // Directory doesn't exist or error reading\n      return [];\n    }\n  }\n\n  private async readSummaryDir(sessionDir: string, sessionKey: string): Promise<HourlySummary[]> {\n    let files: string[];\n    try {\n      files = await readdir(sessionDir);\n    } catch {\n      return [];\n    }\n\n    const summaries: HourlySummary[] = [];\n    const mdFiles = files.filter((f) => f.endsWith(\".md\"));\n    for (const file of mdFiles) {\n      const filePath = await resolveSafeStoragePath(sessionDir, file).catch(() => null);\n      if (filePath === null) continue;\n\n      try {\n        const content = await readFile(filePath, \"utf-8\");\n        summaries.push(...this.parseSummaryFile(content, sessionKey, file));\n      } catch {\n        // Skip unreadable summary files.\n      }\n    }\n\n    return summaries;\n  }\n\n  private parseSummaryFile(content: string, sessionKey: string, filename: string): HourlySummary[] {\n    const summaries: HourlySummary[] = [];\n\n    // Extract date from filename (YYYY-MM-DD.md)\n    const dateMatch = filename.match(/^(\\d{4}-\\d{2}-\\d{2})\\.md$/);\n    if (!dateMatch) return summaries;\n    const dateStr = dateMatch[1];\n\n    // Split by hour sections\n    const hourSections = content.split(/\\n## (\\d{2}):00\\n/);\n\n    // First element is the header, skip it\n    for (let i = 1; i < hourSections.length; i += 2) {\n      const hourStr = hourSections[i];\n      const sectionContent = hourSections[i + 1] || \"\";\n\n      // Parse bullets\n      const bullets: string[] = [];\n      const lines = sectionContent.split(\"\\n\");\n      let turnCount = 0;\n\n      let inTopics = false;\n      let sawExtendedTopicsHeader = false;\n      for (const line of lines) {\n        if (line.startsWith(\"### Topics\")) {\n          inTopics = true;\n          sawExtendedTopicsHeader = true;\n          continue;\n        }\n        if (line.startsWith(\"### \") && !line.startsWith(\"### Topics\")) {\n          inTopics = false;\n        }\n        const bulletMatch = line.match(/^- (.+)$/);\n        if (bulletMatch) {\n          // For extended format, only treat topic bullets as recall bullets.\n          if (!sawExtendedTopicsHeader || inTopics) bullets.push(bulletMatch[1]);\n        }\n        const turnMatch = line.match(/\\((\\d+) turns?\\)/);\n        if (turnMatch) turnCount = parseInt(turnMatch[1], 10);\n      }\n\n      if (bullets.length > 0) {\n        summaries.push({\n          hour: `${dateStr}T${hourStr}:00:00.000Z`,\n          sessionKey,\n          bullets,\n          turnCount,\n          generatedAt: \"\", // Not stored in file, not needed for recall\n        });\n      }\n    }\n\n    return summaries;\n  }\n\n  // Format summaries for recall injection\n  formatForRecall(summaries: HourlySummary[], maxCount: number): string {\n    if (summaries.length === 0) return \"\";\n\n    const limited = summaries.slice(0, maxCount);\n    const lines: string[] = [`## Recent Activity (last ${limited.length} hours)`];\n\n    for (const summary of limited) {\n      const hourStr = summary.hour.slice(11, 16); // HH:MM\n      for (const bullet of summary.bullets) {\n        lines.push(`- ${hourStr}: ${bullet}`);\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  // Main entry point for cron job\n  async runHourly(): Promise<HourlySummarizerRunStats> {\n    log.debug(\"running hourly summary generation\");\n\n    // Get active sessions from transcript. The scan outcome is kept LOCAL to\n    // this invocation (review round 2): shared instance state would let two\n    // concurrent runHourly calls cross-report each other's timestamps.\n    const scan = await this.getActiveSessions();\n    const sessions = scan.sessionKeys;\n    let sessionsWithEntries = 0;\n    let summariesWritten = 0;\n\n    for (const sessionKey of sessions) {\n      // Calculate the hour we want to summarize (previous hour)\n      const now = new Date();\n      const hourStart = new Date(now.getTime() - 60 * 60 * 1000);\n      hourStart.setMinutes(0, 0, 0);\n      const hourEnd = new Date(hourStart.getTime() + 60 * 60 * 1000);\n\n      // Get entries for this session in the target hour\n      const entries = await this.getTranscriptEntries(sessionKey, hourStart, hourEnd);\n\n      if (entries.length === 0) {\n        log.debug(`no transcript entries for ${sessionKey} at ${hourStart.toISOString()}`);\n        continue;\n      }\n      sessionsWithEntries += 1;\n\n      // Generate and save summary\n      const summary = await this.generateSummary(sessionKey, hourStart, entries);\n      if (summary) {\n        await this.saveSummary(summary);\n        summariesWritten += 1;\n        log.info(`generated hourly summary for ${sessionKey} (${entries.length} turns)`);\n      }\n    }\n\n    return {\n      sessionsConsidered: sessions.length,\n      sessionsWithEntries,\n      summariesWritten,\n      // Staleness signal (issue #2783): newest entry across the whole\n      // store, from the same scan getActiveSessions already performs.\n      staleStore:\n        scan.newestEntryTimestamp !== null &&\n        Date.now() - new Date(scan.newestEntryTimestamp).getTime() > STALE_STORE_MS,\n      newestEntryTimestamp: scan.newestEntryTimestamp,\n      scanFailed: scan.scanFailed,\n    };\n  }\n\n  // Get list of active sessions from the transcript directory, plus the\n  // scan bookkeeping runHourly reports: newest entry timestamp (staleness\n  // signal) and whether the scan itself FAILED. A failed scan must not be\n  // reported as an empty store — those are different incidents (review\n  // round 2).\n  private async getActiveSessions(): Promise<{\n    sessionKeys: string[];\n    newestEntryTimestamp: string | null;\n    scanFailed: boolean;\n  }> {\n    const transcriptDir = await resolveSafeStoragePath(this.config.memoryDir, \"transcripts\").catch(() => null);\n    if (transcriptDir === null) {\n      return { sessionKeys: [], newestEntryTimestamp: null, scanFailed: false };\n    }\n\n    const sessionKeys = new Set<string>();\n    let newestEntryTimestamp: string | null = null;\n    let newestEntryTimeMs = Number.NaN;\n    let fileReadFailed = false;\n    const collect = async (transcriptPath: string): Promise<void> => {\n      try {\n        const raw = await readFile(transcriptPath, \"utf-8\");\n        for (const line of raw.split(\"\\n\")) {\n          if (!line.trim()) continue;\n          try {\n            const entry = JSON.parse(line) as TranscriptEntry;\n            if (typeof entry.sessionKey === \"string\" && entry.sessionKey.length > 0) {\n              sessionKeys.add(entry.sessionKey);\n            }\n            // Compare parsed epoch values, never strings: a malformed\n            // timestamp in a hand-edited file must not poison the staleness\n            // signal with a lexically-maximal garbage value (review).\n            if (typeof entry.timestamp === \"string\") {\n              const timeMs = new Date(entry.timestamp).getTime();\n              if (Number.isFinite(timeMs) && (Number.isNaN(newestEntryTimeMs) || timeMs > newestEntryTimeMs)) {\n                newestEntryTimeMs = timeMs;\n                newestEntryTimestamp = entry.timestamp;\n              }\n            }\n          } catch {\n            // ignore malformed transcript lines\n          }\n        }\n      } catch (err) {\n        // ENOENT is a concurrently-deleted file — ignore. Any other read\n        // failure (permissions, I/O) means the store is partially UNREADABLE:\n        // mark the scan failed so the caller warns instead of reporting an\n        // empty store (review round 3).\n        if ((err as NodeJS.ErrnoException)?.code !== \"ENOENT\") {\n          fileReadFailed = true;\n        }\n      }\n    };\n\n    try {\n      const typeEntries = await readdir(transcriptDir, { withFileTypes: true });\n      for (const typeEnt of typeEntries) {\n        if (!typeEnt.isDirectory()) continue;\n        const typeDir = await resolveSafeStoragePath(transcriptDir, typeEnt.name).catch(() => null);\n        if (typeDir === null) continue;\n        const idEntries = await readdir(typeDir, { withFileTypes: true });\n        for (const idEnt of idEntries) {\n          if (!idEnt.isDirectory()) continue;\n          const chanDir = await resolveSafeStoragePath(typeDir, idEnt.name).catch(() => null);\n          if (chanDir === null) continue;\n          const files = (await readdir(chanDir)).filter((f) => f.endsWith(\".jsonl\")).sort();\n          for (const file of files) {\n            const transcriptPath = await resolveSafeStoragePath(chanDir, file).catch(() => null);\n            if (transcriptPath === null) continue;\n            await collect(transcriptPath);\n          }\n        }\n      }\n      return {\n        sessionKeys: Array.from(sessionKeys),\n        newestEntryTimestamp,\n        scanFailed: fileReadFailed,\n      };\n    } catch (err) {\n      // ENOENT on the root is a never-written store — an EMPTY store, not a\n      // scan failure (those are different incidents).\n      const code = (err as NodeJS.ErrnoException)?.code;\n      if (code === \"ENOENT\") {\n        return { sessionKeys: [], newestEntryTimestamp: null, scanFailed: false };\n      }\n      log.warn(`transcript scan failed: ${err}`);\n      return { sessionKeys: [], newestEntryTimestamp: null, scanFailed: true };\n    }\n  }\n\n  // Get transcript entries for a session within a time range\n  private async getTranscriptEntries(sessionKey: string, startTime: Date, endTime: Date): Promise<TranscriptEntry[]> {\n    // Shared session-identity layer (issue #1496, rule #22). Arbitrary keys\n    // route to `session/<hash>`; legacy `agent:<id>:...` keep their paths. The\n    // shared helper also supplies the read-back-only candidate dirs (mirrors\n    // TranscriptManager) so legacy `other/default` AND old `parts.length >= 3`\n    // data stays discoverable here too.\n    const paths = sessionStoragePaths(sessionKey);\n\n    try {\n      const transcriptRoot = path.join(this.config.memoryDir, \"transcripts\");\n      const candidateDirs = new Set(\n        [paths.dir, paths.alternateDir, paths.legacyDir, ...paths.readbackDirs].filter(\n          (dir): dir is string => typeof dir === \"string\" && dir.length > 0\n        )\n      );\n      const entries: TranscriptEntry[] = [];\n      // Dedup identical raw rows that a partially-applied migration may have\n      // left in both the primary dir and a read-back dir (issue #1496, cursor\n      // review). Exact raw JSONL line is the stable identity.\n      const seenRawLines = new Set<string>();\n\n      // Read all daily transcript files in the directory\n      for (const candidateDir of candidateDirs) {\n        const transcriptDir = await resolveSafeStoragePath(transcriptRoot, candidateDir).catch(() => null);\n        if (transcriptDir === null) continue;\n\n        const files = await readdir(transcriptDir).catch(() => []);\n        for (const file of files) {\n          if (!file.endsWith(\".jsonl\")) continue;\n\n          const transcriptPath = await resolveSafeStoragePath(transcriptDir, file).catch(() => null);\n          if (transcriptPath === null) continue;\n\n          try {\n            const content = await readFile(transcriptPath, \"utf-8\");\n            const lines = content.trim().split(\"\\n\");\n\n            for (const line of lines) {\n              if (!line.trim()) continue;\n              try {\n                const entry = JSON.parse(line) as TranscriptEntry;\n                const entryTime = new Date(entry.timestamp).getTime();\n\n                if (\n                  entry.sessionKey === sessionKey &&\n                  entryTime >= startTime.getTime() &&\n                  entryTime < endTime.getTime() &&\n                  !seenRawLines.has(line)\n                ) {\n                  seenRawLines.add(line);\n                  entries.push(entry);\n                }\n              } catch {\n                // Skip malformed lines\n              }\n            }\n          } catch {\n            // Skip unreadable files\n          }\n        }\n      }\n\n      return entries;\n    } catch {\n      return [];\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-2YLMUME2.js → chunk-AECJY3GJ.js}

@@ -1,6 +1,6 @@
 import {
   RECALL_DISCLOSURE_LEVELS
-} from "./chunk-4MDKNUV4.js";
+} from "./chunk-IYKZJVL5.js";
 
 // src/recall-navigate.ts
 var RECALL_NAV_LINK_TYPES = [
@@ -48,4 +48,4 @@ export {
   expandRecallNode,
   traverseRecallLink
 };
-//# sourceMappingURL=chunk-2YLMUME2.js.map
+//# sourceMappingURL=chunk-AECJY3GJ.js.map

package/dist/{chunk-NPNSKE76.js → chunk-B36GUU6T.js}

@@ -5,13 +5,13 @@ import {
   citationTemplateFingerprint,
   isCachedIdentityReusable,
   isReconcileMemoryIdentity
-} from "./chunk-UBG4GAEP.js";
+} from "./chunk-5U7K4W6K.js";
 import {
   offlineSyncStorageForSnapshot
-} from "./chunk-C6KRO3SU.js";
+} from "./chunk-XVDZFTN5.js";
 import {
   createPersistedSupportPassportPrivateFileExclusion
-} from "./chunk-PWPIERBM.js";
+} from "./chunk-37CAEC7E.js";
 import {
   iterateOfflineSyncSnapshotFileRecords
 } from "./chunk-WQZZDN5M.js";
@@ -217,4 +217,4 @@ export {
   planServerIdentityCacheWrite,
   createOfflineSyncManifestStream
 };
-//# sourceMappingURL=chunk-NPNSKE76.js.map
+//# sourceMappingURL=chunk-B36GUU6T.js.map

package/dist/{chunk-Y63ZFP4X.js → chunk-BJEJUOGM.js}

@@ -1,6 +1,6 @@
 import {
   createSearchBackend
-} from "./chunk-JRWW7GM6.js";
+} from "./chunk-OKO57IXB.js";
 import {
   namespaceIdentityToken,
   normalizeNamespaceIdentity
@@ -470,4 +470,4 @@ export {
   NamespaceSearchRouter,
   normalizeQmdResultPath
 };
-//# sourceMappingURL=chunk-Y63ZFP4X.js.map
+//# sourceMappingURL=chunk-BJEJUOGM.js.map

package/dist/{chunk-7CBKAQIG.js → chunk-BOADKFN4.js}

@@ -42,9 +42,19 @@ var EXTRACTION_RESPONSE_SHAPE = `{
   "episodeTitle": "<six-to-eight word conversation segment title>",
   "relationships": [{"source": "<normalized-name>", "target": "<normalized-name>", "label": "<source-grounded relationship>"}]
 }`;
+function extractionResponseShape(spanMode = "off") {
+  if (spanMode === "off") return EXTRACTION_RESPONSE_SHAPE;
+  return EXTRACTION_RESPONSE_SHAPE.replace(
+    `"eventTime": "<optional source temporal expression>"`,
+    `"eventTime": "<optional source temporal expression>",
+    "span": {"sourceMessageIndex": <message number>, "charStart": <number>, "charEnd": <number>, "frame": "<at most 15 words>"}`
+  );
+}
 var EXTRACTION_RESPONSE_PLACEHOLDERS = {};
-for (const placeholder of EXTRACTION_RESPONSE_SHAPE.match(/<[^<>\r\n]+>/g) ?? []) {
-  EXTRACTION_RESPONSE_PLACEHOLDERS[placeholder] = true;
+for (const shape of [EXTRACTION_RESPONSE_SHAPE, extractionResponseShape("on")]) {
+  for (const placeholder of shape.match(/<[^<>\r\n]+>/g) ?? []) {
+    EXTRACTION_RESPONSE_PLACEHOLDERS[placeholder] = true;
+  }
 }
 var CUE_ANCHOR_PROMPT_INSTRUCTION = `- For each fact, emit at most 3 "cueAnchors".
 - Each cue anchor value must be a source-grounded search hook of at most 120 characters, in the form "<main entity or topic> <key aspect>".
@@ -57,6 +67,18 @@ function eventTimePromptInstruction(config) {
   return `
 When a fact states when it became or stopped being true, copy that explicit temporal expression verbatim into "eventTime". Omit "eventTime" when no such expression appears; never infer dates.`;
 }
+function spanModePromptSection(spanMode) {
+  if (spanMode === "off") return "";
+  const requestBoth = spanMode === "shadow";
+  return `
+Span mode (numbered-message offsets):
+- Conversation messages are numbered in order starting at 0 (the "[role] text" blocks).
+- For each fact, return "span": {"sourceMessageIndex": <message number>, "charStart": <number>, "charEnd": <number>, "frame": "<at most 15 words>"} pointing at the verbatim supporting words in that message's text (the text after the "] "). Offsets are [charStart, charEnd), end-exclusive, counting from the first character of the message text.
+- "frame" is at most 15 generated words that make the span self-contained: resolve pronouns to names, name the subject (e.g., frame "Maya's relocation:" + span "moved to Seattle last spring\u2026").${requestBoth ? `
+- This run is in SHADOW mode: ALSO include the full standalone "content" restatement exactly as you would normally write it, in addition to "span".` : `
+- Set "content" to the frame text (the short \u226415-word frame) \u2014 do not restate the full fact; the span plus frame carry it.`}
+- Invalid spans fall back to the frame, so keep the frame informative.`;
+}
 function buildExtractionInstructions(config, existingEntities, ambientCapture = false) {
   const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);
   return `You are a memory extraction system. Analyze the following conversation and extract durable, reusable memories.
@@ -121,7 +143,7 @@ ${existingEntities.join(", ")}
 
 When you see something that matches a known entity, use THAT name exactly. Only create a NEW entity if nothing in this list represents it.
 ` : ""}
-${eventTimePromptInstruction(config)}
+${eventTimePromptInstruction(config)}${spanModePromptSection(config.extraction?.spanMode ?? "off")}
 Also extract relationships between entities mentioned in the conversation.
 - Format: {source: "entity-name", target: "entity-name", label: "relationship description"}
 - Max 5 relationships per extraction
@@ -185,14 +207,16 @@ The output should be the COMPLETE consolidated profile as valid markdown, starti
 
 export {
   EXTRACTION_RESPONSE_SHAPE,
+  extractionResponseShape,
   EXTRACTION_RESPONSE_PLACEHOLDERS,
   CUE_ANCHOR_PROMPT_INSTRUCTION,
   OUTPUT_LANGUAGE_POLICY,
   eventTimePromptInstruction,
+  spanModePromptSection,
   buildExtractionInstructions,
   CONSOLIDATION_RESPONSE_SCHEMA,
   PROFILE_CONSOLIDATION_RESPONSE_SCHEMA,
   buildConsolidationSystemPrompt,
   buildProfileConsolidationSystemPrompt
 };
-//# sourceMappingURL=chunk-7CBKAQIG.js.map
+//# sourceMappingURL=chunk-BOADKFN4.js.map

package/dist/chunk-BOADKFN4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extraction-prompt.ts"],"sourcesContent":["/**\n * Extraction prompt construction (issue #1995 sibling extraction).\n *\n * The system prompt, its JSON response shape, and the placeholder table\n * derived from that shape are prompt DATA, not engine behavior. They live here\n * so `extraction.ts` holds the pipeline and one module owns the text every\n * extraction path — local LLM, direct client, gateway fallback — sends.\n */\n\nimport { AMBIENT_CAPTURE_PROMPT_SECTION, AMBIENT_SPECULATIVE_TIER_CLAUSE } from \"./ambient-provenance.js\";\nimport { resolveMemoryLifecycleCapabilities, resolveRecallAuxiliaryCapabilities } from \"./capabilities.js\";\nimport type { PluginConfig } from \"./types.js\";\n\nexport const EXTRACTION_RESPONSE_SHAPE = `{\n  \"facts\": [{\n    \"category\": \"<category>\",\n    \"content\": \"<source-grounded statement>\",\n    \"confidence\": 0.0,\n    \"tags\": [\"<tag>\"],\n    \"entityRef\": \"<optional normalized-name>\",\n    \"cueAnchors\": [{\"type\": \"<anchor-type>\", \"value\": \"<entity-or-topic plus key aspect>\"}],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"quote\": \"<optional exact contiguous source span>\",\n    \"scope\": \"<optional project-or-global>\",\n    \"subject\": \"<optional user-or-agent>\",\n    \"structuredAttributes\": {\"<key>\": \"<value>\"},\n    \"procedureSteps\": [{\"order\": 1, \"intent\": \"<step>\"}, {\"order\": 2, \"intent\": \"<step>\"}],\n    \"reasoningTrace\": {\n      \"steps\": [{\"order\": 1, \"description\": \"<step>\"}, {\"order\": 2, \"description\": \"<step>\"}],\n      \"finalAnswer\": \"<answer>\",\n      \"observedOutcome\": \"<optional outcome>\"\n    },\n    \"eventTime\": \"<optional source temporal expression>\"\n  }],\n  \"entities\": [{\n    \"name\": \"<normalized-name>\",\n    \"type\": \"<entity-type>\",\n    \"facts\": [\"<source-grounded statement>\"],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"structuredSections\": [{\"key\": \"<section-key>\", \"title\": \"<section-title>\", \"facts\": [\"<source-grounded statement>\"]}]\n  }],\n  \"profileUpdates\": [\"<source-grounded profile update>\"],\n  \"questions\": [{\"question\": \"<source-grounded unresolved question>\", \"context\": \"<source-grounded context>\", \"priority\": 0.0}],\n  \"identityReflection\": \"<conversation-grounded agent reflection>\",\n  \"episodeTitle\": \"<six-to-eight word conversation segment title>\",\n  \"relationships\": [{\"source\": \"<normalized-name>\", \"target\": \"<normalized-name>\", \"label\": \"<source-grounded relationship>\"}]\n}`;\nexport function extractionResponseShape(spanMode: \"off\" | \"shadow\" | \"on\" = \"off\"): string {\n  if (spanMode === \"off\") return EXTRACTION_RESPONSE_SHAPE;\n  return EXTRACTION_RESPONSE_SHAPE.replace(\n    `\"eventTime\": \"<optional source temporal expression>\"`,\n    `\"eventTime\": \"<optional source temporal expression>\",\n    \"span\": {\"sourceMessageIndex\": <message number>, \"charStart\": <number>, \"charEnd\": <number>, \"frame\": \"<at most 15 words>\"}`,\n  );\n}\nexport const EXTRACTION_RESPONSE_PLACEHOLDERS: Record<string, true> = {};\nfor (const shape of [EXTRACTION_RESPONSE_SHAPE, extractionResponseShape(\"on\")]) {\n  for (const placeholder of shape.match(/<[^<>\\r\\n]+>/g) ?? []) {\n    EXTRACTION_RESPONSE_PLACEHOLDERS[placeholder] = true;\n  }\n}\nexport const CUE_ANCHOR_PROMPT_INSTRUCTION = `- For each fact, emit at most 3 \"cueAnchors\".\n- Each cue anchor value must be a source-grounded search hook of at most 120 characters, in the form \"<main entity or topic> <key aspect>\".\n- Set each cue anchor type to entity, file, tool, outcome, constraint, or date.\n- Omit cue anchors when the conversation does not support a useful search hook.\n- Example: \"Alice booked Bistro Max for Mike's surprise party\" can use {\"type\":\"entity\",\"value\":\"Mike surprise party\"} and {\"type\":\"entity\",\"value\":\"Alice restaurant booking\"}.`;\n\n/**\n * Output-language policy (issue #2190). Every prompt that produces memory\n * content embeds this verbatim so non-English conversations are not silently\n * translated to English — translated memories fail later lexical recall.\n */\nexport const OUTPUT_LANGUAGE_POLICY = `Output language: write facts, profile updates, entity names and aliases, tags, questions, and any rewritten or merged memory content in the source language of the conversation or input memories. Never translate into English or another language unless the user explicitly asked for a translation.`;\n\n/**\n * Bi-temporal event-time extraction instruction (#1578 PR2). Emitted on\n * every extraction entry path when `temporal.biTemporal` is on so the LLM\n * emits an optional per-fact `eventTime` expression. The expression is\n * resolved against the source turn timestamp at write time — never\n * wall-clock — so replay/import of old transcripts anchors correctly.\n * Returns an empty string when the gate is off (byte-identical prompt).\n */\nexport function eventTimePromptInstruction(config: PluginConfig): string {\n  if (!config.temporalBiTemporal) return \"\";\n  return `\nWhen a fact states when it became or stopped being true, copy that explicit temporal expression verbatim into \"eventTime\". Omit \"eventTime\" when no such expression appears; never infer dates.`;\n}\n\n/**\n * Span-mode extraction instructions (issue #2333 Phase B). Empty when the\n * mode is off (byte-identical prompt). The offset convention mirrors the\n * Phase A bench: messages numbered in order from 0, offsets index the\n * message's own text (after the `[role] ` tag), [charStart, charEnd)\n * end-exclusive.\n */\nexport function spanModePromptSection(spanMode: \"off\" | \"shadow\" | \"on\"): string {\n  if (spanMode === \"off\") return \"\";\n  const requestBoth = spanMode === \"shadow\";\n  return `\nSpan mode (numbered-message offsets):\n- Conversation messages are numbered in order starting at 0 (the \"[role] text\" blocks).\n- For each fact, return \"span\": {\"sourceMessageIndex\": <message number>, \"charStart\": <number>, \"charEnd\": <number>, \"frame\": \"<at most 15 words>\"} pointing at the verbatim supporting words in that message's text (the text after the \"] \"). Offsets are [charStart, charEnd), end-exclusive, counting from the first character of the message text.\n- \"frame\" is at most 15 generated words that make the span self-contained: resolve pronouns to names, name the subject (e.g., frame \"Maya's relocation:\" + span \"moved to Seattle last spring…\").${\n    requestBoth\n      ? `\n- This run is in SHADOW mode: ALSO include the full standalone \"content\" restatement exactly as you would normally write it, in addition to \"span\".`\n      : `\n- Set \"content\" to the frame text (the short ≤15-word frame) — do not restate the full fact; the span plus frame carry it.`\n  }\n- Invalid spans fall back to the frame, so keep the frame informative.`;\n}\n\n/**\n * Build extraction instructions shared between local and cloud LLM.\n *\n * `ambientCapture` marks input from an always-on recorder, which may carry\n * speech the user never authored (issue #2294).\n */\nexport function buildExtractionInstructions(\n  config: PluginConfig,\n  existingEntities?: string[],\n  ambientCapture = false\n): string {\n  const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);\n  return `You are a memory extraction system. Analyze the following conversation and extract durable, reusable memories.\n\nMemory categories:\n- fact: Objective information about the world\n- preference: User likes, dislikes, or stylistic choices\n- correction: User correcting a mistake or misconception (highest priority)\n- entity: Information about a specific person, project, tool, or company\n- decision: A choice that was made with rationale\n- relationship: How two entities relate to each other (e.g., \"Alice is Bob's manager\", \"Acme Corp uses Shopify\")\n- principle: Durable rules, values, or operating beliefs (e.g., \"never use Chat Completions API\")\n- commitment: Promises, obligations, or deadlines (e.g., \"deploy by Friday\", \"call accountant Monday\")\n- moment: Emotionally significant events or milestones (e.g., \"first successful deployment of engram\")\n- skill: Capabilities the user or agent has demonstrated (e.g., \"user is proficient with Kubernetes\")${\n    resolveRecallAuxiliaryCapabilities(config).causalRuleExtraction\n      ? `\n- rule: Causal rules discovered through experience (format: \"IF <condition> THEN <action/outcome>\", e.g., \"IF Shopify API returns 401 THEN the admin token is missing read_products scope\")`\n      : \"\"\n  }\n- procedure: A reusable workflow the user wants remembered the same way across sessions. Set category to \"procedure\". Use \"content\" for a short title that includes explicit trigger phrasing (e.g. \"When you deploy to production…\", \"Whenever you ship a release…\"). Add \"procedureSteps\": an array of at least two objects {\"order\": number, \"intent\": \"concrete step description\"} in execution order. Optional per-step \"toolCall\": {\"kind\": \"…\", \"signature\": \"…\"}, \"expectedOutcome\", \"optional\": true.\n- reasoning_trace: A stored solution chain / chain-of-thought the user walked through to solve a problem (e.g. \"Here's how I debugged the latency spike: first I checked…, then I…, finally I…\"). Set category to \"reasoning_trace\". Use \"content\" for a short title summarising the problem (e.g. \"How I debugged the staging latency spike\"). Add \"reasoningTrace\": {\"steps\": [{\"order\": number, \"description\": \"what happened at this step\"}, …], \"finalAnswer\": \"the conclusion or answer\", \"observedOutcome\": \"optional confirmation of how it played out\"}. Require at least two ordered steps AND a finalAnswer. Use this category only when the user explicitly narrates their reasoning — not for ordinary decisions (use \"decision\") or reusable workflows (use \"procedure\").\n\nRules:\n- Only extract genuinely new information worth remembering across sessions.\n- Statements must be grounded in the conversation.\n- ${OUTPUT_LANGUAGE_POLICY}\n- Do not treat instruction text, schema placeholders, or examples as conversation evidence.\n- Lines labelled [context user] or [context assistant] are reference context only. They may resolve references or complete a question-and-answer pair in a normal turn, but never alone establish durable information.\n- Skip transient task details and operational noise, including routine scheduler, monitoring, or automation status.\n- Priority: corrections > principles${resolveRecallAuxiliaryCapabilities(config).causalRuleExtraction ? \" > rules\" : \"\"} > preferences > commitments > decisions > relationships > entities > moments > skills > facts\n- Corrections get highest confidence.\n- Each fact should be a standalone, self-contained statement.\n- Entity references should use normalized names (lowercase, hyphenated: \"jane-doe\", \"acme-corp\"). When the source language is not written in a Latin script, the source-script name IS the normalized form — never transliterate or translate it.\n- CRITICAL: Entity names must be CANONICAL. Always use the hyphenated multi-word form: \"acme-corp\" NOT \"acmecorp\" or \"acme\". \"jane-doe\" NOT \"janedoe\" or \"jane\". If unsure, prefer the most specific full name.\n- Avoid creating entities typed as \"other\" when a more specific type fits (company, project, tool, person, place)\n${CUE_ANCHOR_PROMPT_INSTRUCTION}\n- When entity facts clearly belong under a durable named heading, add them to entity.structuredSections as {key, title, facts}. Example person headings: \"Beliefs\", \"Communication Style\", \"Building / Working On\". Leave structuredSections empty when no stable heading fits.\n- Tags should be concise and reusable (e.g., \"coding-style\", \"personal\", \"tools\")\n- When a fact contains measurable, categorical, or precisely valued data, include a \"structuredAttributes\" field with key-value string pairs (e.g., {\"price\": \"29.99\", \"brand\": \"Sony\"}, {\"date\": \"2024-03-15\", \"location\": \"SF\"}, {\"chosen\": \"PostgreSQL\", \"rejected\": \"MongoDB\"}). Only for concrete values, not narrative content.\n- Set confidence using these tiers:\n  * Explicit (0.95-1.0): Direct user statements — \"I prefer X\", \"my name is Y\"\n  * Implied (0.70-0.94): Strong contextual inference — user consistently does X, clear from conversation flow\n  * Inferred (0.40-0.69): Pattern recognition — reasonable guess from limited evidence\n  * Speculative (0.00-0.39): Tentative hypothesis — weak signal, needs future confirmation. Speculative memories auto-expire after 30 days if not confirmed.${ambientCapture ? AMBIENT_SPECULATIVE_TIER_CLAUSE : \"\"}${\n    config.provenance?.enabled\n      ? `\n- Source quotes: For each fact, include a \"quote\" field containing the EXACT verbatim words from the conversation that support the fact. Copy a contiguous span from a single speaker turn (not a paraphrase, not a summary). Cap at ~300 characters. This grounds every memory in the literal utterance that created it.`\n      : \"\"\n  }\n- For commitments: include any deadline or timeframe mentioned${\n    lifecycleCaps.extractionScopeClassification\n      ? `\n\nScope classification:\nFor each fact, set \"scope\" to one of:\n- \"global\" — knowledge that applies across projects: core framework/library bugs, API behavior patterns, user preferences (editor, language, style), general coding patterns, infrastructure knowledge, technology facts not tied to one codebase\n- \"project\" — knowledge specific to one codebase: file paths, environment configs, deployment details, project-specific workarounds, team/stakeholder info tied to one project, repo-specific conventions. Tool, command, or CLI-flag instructions TIED TO ONE AGENT are also \"project\", because the same tool name means different things in different agent integrations (a \"search\" tool may search repository code in one agent and the web in another); when keeping such an agent-tied instruction, the fact text MUST name the originating agent as a leading \"In <agent>,\" clause (e.g. \"In Pi, use the search tool with a repository path.\"). A tool/command fact that holds in every agent and every repo is NOT agent-tied — leave it \"global\" and do not add a qualifier (e.g. \"\\`git status --short\\` emits compact output\"). Examples: \"In Pi, the search tool takes a repository path\" -> \"project\"; \"\\`git status --short\\` emits compact output\" -> \"global\".\nWhen in doubt, prefer \"project\" — it is safer to keep knowledge scoped narrowly.`\n      : \"\"\n  }\n${\n  ambientCapture\n    ? `${AMBIENT_CAPTURE_PROMPT_SECTION}\n`\n    : \"\"\n}\nEntity creation rules (STRICT):\n- Only create entities for DURABLE things: real people, companies, products, tools, ongoing projects\n- NEVER create entities for transient items: individual PRs, branches, Jira tickets, meetings, agent task IDs, log files, database tables, cron job runs, sessions\n- When you learn something about a transient item (e.g., PR #58 fixed a bug), store it as a FACT with an entityRef to the parent project — do NOT create an entity for the PR itself\n- Prefer attaching facts to broad parent entities rather than creating sub-entities. E.g., \"acme-store uses Algolia for search\" is a fact on entity \"acme-store\", NOT a new entity \"acme-store-algolia-connector\"\n- The entity list should be SHORT — think \"things that would have their own Wikipedia page\" not \"things mentioned in passing\"\n\n${\n  existingEntities && existingEntities.length > 0\n    ? `\nKNOWN ENTITIES (use these exact names when referencing existing things):\n${existingEntities.join(\", \")}\n\nWhen you see something that matches a known entity, use THAT name exactly. Only create a NEW entity if nothing in this list represents it.\n`\n    : \"\"\n}\n${eventTimePromptInstruction(config)}${spanModePromptSection(config.extraction?.spanMode ?? \"off\")}\nAlso extract relationships between entities mentioned in the conversation.\n- Format: {source: \"entity-name\", target: \"entity-name\", label: \"relationship description\"}\n- Max 5 relationships per extraction\n- Only include clear, durable relationships (e.g., \"works at\", \"created\", \"manages\", \"uses\")\n- Use normalized entity names (e.g., \"person-jane-doe\", \"company-acme-corp\")\n\n\nAlso emit \"episodeTitle\" as a six-to-eight word title for this conversation segment.\nQuestions are optional. Include only source-grounded unresolved questions that would be useful in future sessions; otherwise return an empty array.\n\nFinally, write a brief identity reflection about the agent who had this conversation, based only on the conversation. Do not write about the extraction process.`;\n}\n\nexport const CONSOLIDATION_RESPONSE_SCHEMA = `{\n  \"items\": [\n    {\n      \"existingId\": \"id\",\n      \"action\": \"ADD\",\n      \"mergeWith\": \"optional-existing-id\",\n      \"updatedContent\": \"optional replacement content\",\n      \"reason\": \"brief reason for this action\"\n    }\n  ],\n  \"profileUpdates\": [\"optional profile update\"],\n  \"entityUpdates\": [{\"name\": \"person-jane-doe\", \"type\": \"person\", \"facts\": [\"Now leads the backend team\", \"Recently migrated the user service to TypeScript\"]}]\n}`;\n\nexport const PROFILE_CONSOLIDATION_RESPONSE_SCHEMA = `{\n  \"consolidatedProfile\": \"# Behavioral Profile\\\\n\\\\n... (complete markdown)\",\n  \"removedCount\": 42,\n  \"summary\": \"brief summary of what was consolidated\"\n}`;\n\n/**\n * System prompt shared by every consolidation path (gateway, direct client,\n * local LLM). Owns the causal-rule clause and the output-language policy so\n * the three paths cannot drift (issue #2190).\n */\nexport function buildConsolidationSystemPrompt(config: PluginConfig): string {\n  return `You are a memory consolidation system. Compare new memories against existing ones and decide what to do with each.\n\nActions:\n- ADD: Keep the new memory as-is (no duplicate exists)\n- MERGE: Combine with an existing memory (provide mergeWith ID and updated content)\n- UPDATE: Replace existing memory content (provide updated content)\n- INVALIDATE: Remove existing memory (it's been superseded or is wrong)\n- SKIP: This new memory is redundant (exact duplicate or subset of existing)\n\nAlso:\n- Suggest profile updates based on patterns across memories\n- Identify entity updates for entity tracking${resolveRecallAuxiliaryCapabilities(config).causalRuleExtraction ? `\n- When merging or updating memories, look for IF→THEN causal patterns. If a memory describes \"X failed/succeeded because Y\" or \"doing X led to Y\", rewrite its content to make the causal rule explicit in the form \"IF <condition> THEN <action/outcome>\".` : \"\"}\n- ${OUTPUT_LANGUAGE_POLICY}`;\n}\n\n/**\n * System prompt shared by every profile-consolidation path (gateway, direct\n * client, local LLM). Owns the output-language policy (issue #2190).\n */\nexport function buildProfileConsolidationSystemPrompt(targetLines: number): string {\n  return `You are a profile consolidation system. You are given a behavioral profile (markdown) that has grown too large. Your job is to produce a CONSOLIDATED version that:\n\n1. PRESERVES all ## section headers and their structure\n2. MERGES duplicate or near-duplicate bullet points into single, clear statements\n3. REMOVES stale information that has been superseded by newer bullets\n4. REMOVES trivial or overly specific operational details that won't be useful across sessions\n5. KEEPS the most important, durable observations about the user's preferences, habits, identity, and working style\n6. Target roughly ${targetLines} lines — this is a soft target, prioritize quality over length\n7. Write in the same style as the existing profile — concise bullets, no fluff\n8. ${OUTPUT_LANGUAGE_POLICY}\n\nThe output should be the COMPLETE consolidated profile as valid markdown, starting with \"# Behavioral Profile\".`;\n}\n"],"mappings":";;;;;;;;;;AAaO,IAAM,4BAA4B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkClC,SAAS,wBAAwB,WAAoC,OAAe;AACzF,MAAI,aAAa,MAAO,QAAO;AAC/B,SAAO,0BAA0B;AAAA,IAC/B;AAAA,IACA;AAAA;AAAA,EAEF;AACF;AACO,IAAM,mCAAyD,CAAC;AACvE,WAAW,SAAS,CAAC,2BAA2B,wBAAwB,IAAI,CAAC,GAAG;AAC9E,aAAW,eAAe,MAAM,MAAM,eAAe,KAAK,CAAC,GAAG;AAC5D,qCAAiC,WAAW,IAAI;AAAA,EAClD;AACF;AACO,IAAM,gCAAgC;AAAA;AAAA;AAAA;AAAA;AAWtC,IAAM,yBAAyB;AAU/B,SAAS,2BAA2B,QAA8B;AACvE,MAAI,CAAC,OAAO,mBAAoB,QAAO;AACvC,SAAO;AAAA;AAET;AASO,SAAS,sBAAsB,UAA2C;AAC/E,MAAI,aAAa,MAAO,QAAO;AAC/B,QAAM,cAAc,aAAa;AACjC,SAAO;AAAA;AAAA;AAAA;AAAA,wMAKL,cACI;AAAA,uJAEA;AAAA,qIAEN;AAAA;AAEF;AAQO,SAAS,4BACd,QACA,kBACA,iBAAiB,OACT;AACR,QAAM,gBAAgB,mCAAmC,MAAM;AAC/D,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uGAaL,mCAAmC,MAAM,EAAE,uBACvC;AAAA,+LAEA,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOE,sBAAsB;AAAA;AAAA;AAAA;AAAA,sCAIY,mCAAmC,MAAM,EAAE,uBAAuB,aAAa,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMrH,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mKAQ+H,iBAAiB,kCAAkC,EAAE,GAC/M,OAAO,YAAY,UACf;AAAA,6TAEA,EACN;AAAA,gEAEE,cAAc,gCACV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yFAOA,EACN;AAAA,EAEA,iBACI,GAAG,8BAA8B;AAAA,IAEjC,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASE,oBAAoB,iBAAiB,SAAS,IAC1C;AAAA;AAAA,EAEJ,iBAAiB,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA,IAIvB,EACN;AAAA,EACE,2BAA2B,MAAM,CAAC,GAAG,sBAAsB,OAAO,YAAY,YAAY,KAAK,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYlG;AAEO,IAAM,gCAAgC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AActC,IAAM,wCAAwC;AAAA;AAAA;AAAA;AAAA;AAW9C,SAAS,+BAA+B,QAA8B;AAC3E,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+CAWsC,mCAAmC,MAAM,EAAE,uBAAuB;AAAA,oQAC8I,EAAE;AAAA,IAC7P,sBAAsB;AAC1B;AAMO,SAAS,sCAAsC,aAA6B;AACjF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAOW,WAAW;AAAA;AAAA,KAE1B,sBAAsB;AAAA;AAAA;AAG3B;","names":[]}

package/dist/{chunk-TLHNF6GA.js → chunk-BV4ZKIZH.js}

@@ -644,4 +644,4 @@ export {
   appendMemoryToGraphContext,
   resolvePersistedMemoryRelativePath
 };
-//# sourceMappingURL=chunk-TLHNF6GA.js.map
+//# sourceMappingURL=chunk-BV4ZKIZH.js.map

package/dist/{chunk-3FJKJ5UZ.js → chunk-BX4EOMKT.js}

@@ -1,6 +1,6 @@
 import {
   parseEntityFile
-} from "./chunk-5VAF4ID4.js";
+} from "./chunk-7S53BPTU.js";
 import {
   inferMemoryStatus
 } from "./chunk-7RJUVTVF.js";
@@ -253,4 +253,4 @@ export {
   WHO_KNOWS_MCP_TOOLS,
   handleWhoKnowsHttpQuery
 };
-//# sourceMappingURL=chunk-3FJKJ5UZ.js.map
+//# sourceMappingURL=chunk-BX4EOMKT.js.map

package/dist/{chunk-6J6K3STG.js → chunk-BYZKLEWG.js}

@@ -1,7 +1,7 @@
 import {
   buildStandup,
   parseStandupDate
-} from "./chunk-JR6H5CYS.js";
+} from "./chunk-JA2QJOAX.js";
 import {
   backfillMemoryStorage,
   runLocationBackfill,
@@ -9,26 +9,27 @@ import {
   runLocationDay,
   runLocationStatus,
   runLocationSync
-} from "./chunk-HXSAWV3A.js";
+} from "./chunk-JNSENHV5.js";
 import {
   externalWikiSearchOperation
-} from "./chunk-LYDJRF45.js";
+} from "./chunk-EY5JAWZC.js";
 import {
   DECISION_SUBCOMMANDS,
   DELTA_SUBCOMMANDS,
   defineOperation,
   isCodegraphToolName
-} from "./chunk-JHZCXUQI.js";
+} from "./chunk-62QIQEUC.js";
 import {
   CorrectionContractError
 } from "./chunk-QLK3SL7Q.js";
-import {
-  memoryStoreRequestSchema
-} from "./chunk-L2QLDZJC.js";
 import {
   serializeMutations,
   withHeldFileLock
 } from "./chunk-FFAZ2XFU.js";
+import {
+  memoryStoreRequestSchema,
+  retainedCategoryAlias
+} from "./chunk-P4ZAEYKG.js";
 import {
   EngramAccessInputError
 } from "./chunk-2Z24E5W2.js";
@@ -1484,16 +1485,18 @@ var memorySearchOperation = defineOperation({
 var memoryStoreOperation = defineOperation({
   name: "memory_store",
   description: "Store an explicit memory through the access layer.",
-  // Reuse the existing schema verbatim — the migration is behavior-preserving;
-  // the schema's external contract is NOT changing in this PR (per the issue's
-  // pitfall note).
+  // The canonical wire schema (issue #2482): its category transform already
+  // mapped compat aliases to "fact", so `input.category` is finite here. The
+  // raw spelling survives on `ctx.rawInput` for the coercion note (#2829).
   schema: memoryStoreRequestSchema,
   handler: async (input, ctx) => {
+    const rawCategory = retainedCategoryAlias(ctx.rawInput);
     const result = await ctx.service.memoryStore(
       {
         ...input,
         authenticatedPrincipal: ctx.authenticatedPrincipal,
-        ...ctx.sourceConnector ? { sourceConnector: ctx.sourceConnector } : {}
+        ...ctx.sourceConnector ? { sourceConnector: ctx.sourceConnector } : {},
+        ...rawCategory ? { rawCategory } : {}
       },
       // Forward transport-level hooks (e.g. HTTP's atomic write-quota gate)
       // so the hook still fires inside the service's idempotent-write lock —
@@ -1911,4 +1914,4 @@ export {
   codegraphIngestTracesOperation,
   REGISTERED_OPERATIONS
 };
-//# sourceMappingURL=chunk-6J6K3STG.js.map
+//# sourceMappingURL=chunk-BYZKLEWG.js.map