@xopcai/xopc 0.0.144 → 0.0.145

package/dist/src/media-understanding/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../src/media-understanding/runner.ts"],"sourcesContent":["/**\n * MediaUnderstanding capability runner.\n *\n * Orchestrates per-attachment fallback across providers for one capability\n * (audio / image / video). For each attachment:\n *   1. Build the candidate provider list from the registry, ordered by\n *      autoPriority (lower = first), with caller-supplied `providerOrder`\n *      overriding when set.\n *   2. Try providers in order. A provider is SKIPPED when it does not declare\n *      the requested capability OR does not implement the corresponding method.\n *   3. The first provider whose capability call resolves successfully wins;\n *      its output is recorded as `chosen`. Failures are recorded as attempts\n *      and the next provider is tried.\n *   4. When ALL providers for an attachment fail, the attachment outcome is\n *      `failed`; when no provider was even eligible (capability not registered),\n *      it's `disabled`.\n *\n * DECISION (per docs/voice-rearchitecture.md §5):\n *   - This is a thin runner only. xopc v2.0 ships ONLY audio; image/video\n *     branches exist as type-level fall-throughs (the runner happily handles\n *     them once a provider registers describeImage / describeVideo, but no\n *     image-specific helpers — like multi-image batching — live here yet).\n *   - We deliberately do NOT port openclaw's `MediaAttachmentCache` (which\n *     handles temp-file extraction, SSRF re-validation on remote URLs, etc.).\n *     For xopc v2.0 the caller is expected to pre-load the buffer; remote URL\n *     fetching is the caller's responsibility (typically the channel adapter\n *     does this before invoking the runner).\n */\n\nimport { createLogger } from '../utils/logger.js';\n\nimport { listProvidersForCapability } from './registry.js';\nimport type {\n  AudioTranscriptionRequest,\n  AudioTranscriptionResult,\n  CapabilityAttachmentInput,\n  ImageDescriptionRequest,\n  ImageDescriptionResult,\n  MediaCapability,\n  MediaUnderstandingAttachmentDecision,\n  MediaUnderstandingKind,\n  MediaUnderstandingModelDecision,\n  MediaUnderstandingOutput,\n  MediaUnderstandingProvider,\n  MediaUnderstandingResult,\n  VideoDescriptionRequest,\n  VideoDescriptionResult,\n} from './types.js';\n\nconst log = createLogger('MediaUnderstandingRunner');\n\nexport type { CapabilityAttachmentInput } from './types.js';\n\nexport interface RunCapabilityOptions {\n  capability: MediaCapability;\n  attachments: readonly CapabilityAttachmentInput[];\n  /** Caller-supplied ordering. When set, overrides registry autoPriority. */\n  providerOrder?: readonly string[];\n  /**\n   * Per-provider request builder. Returned shape MUST match the capability:\n   *   audio  → AudioTranscriptionRequest\n   *   image  → ImageDescriptionRequest\n   *   video  → VideoDescriptionRequest\n   * The runner does not synthesize api keys / urls — that's the caller's job\n   * (typically reads from cfg.tools.media.audio.providers[providerId]).\n   */\n  buildRequest: (params: {\n    provider: MediaUnderstandingProvider;\n    attachment: CapabilityAttachmentInput;\n  }) =>\n    | AudioTranscriptionRequest\n    | ImageDescriptionRequest\n    | VideoDescriptionRequest\n    | undefined;\n  /** Optional global timeout signal (e.g. from agent-level cancellation). */\n  signal?: AbortSignal;\n}\n\nconst KIND_BY_CAPABILITY: Record<MediaCapability, MediaUnderstandingKind> = {\n  audio: 'audio.transcription',\n  image: 'image.description',\n  video: 'video.description',\n};\n\nfunction orderProviders(\n  providers: MediaUnderstandingProvider[],\n  capability: MediaCapability,\n  override?: readonly string[],\n): MediaUnderstandingProvider[] {\n  if (override && override.length > 0) {\n    const lookup = new Map(providers.map((p) => [p.id.toLowerCase(), p]));\n    const ordered: MediaUnderstandingProvider[] = [];\n    const used = new Set<string>();\n    for (const id of override) {\n      const provider = lookup.get(id.toLowerCase());\n      if (provider && !used.has(provider.id)) {\n        ordered.push(provider);\n        used.add(provider.id);\n      }\n    }\n    // Append any registered providers not in the override (preserves capability\n    // availability when the override list is incomplete).\n    for (const provider of providers) {\n      if (!used.has(provider.id)) {\n        ordered.push(provider);\n      }\n    }\n    return ordered;\n  }\n  return [...providers].sort((a, b) => {\n    const aPriority = a.autoPriority?.[capability] ?? Number.MAX_SAFE_INTEGER;\n    const bPriority = b.autoPriority?.[capability] ?? Number.MAX_SAFE_INTEGER;\n    return aPriority - bPriority;\n  });\n}\n\nfunction pickMethod(\n  provider: MediaUnderstandingProvider,\n  capability: MediaCapability,\n): ((req: never) => Promise<{ text: string; model?: string }>) | undefined {\n  if (capability === 'audio') {\n    return provider.transcribeAudio as (\n      req: AudioTranscriptionRequest,\n    ) => Promise<AudioTranscriptionResult>;\n  }\n  if (capability === 'image') {\n    return provider.describeImage as (\n      req: ImageDescriptionRequest,\n    ) => Promise<ImageDescriptionResult>;\n  }\n  return provider.describeVideo as (\n    req: VideoDescriptionRequest,\n  ) => Promise<VideoDescriptionResult>;\n}\n\nexport async function runCapability(\n  options: RunCapabilityOptions,\n): Promise<MediaUnderstandingResult> {\n  const eligibleProviders = listProvidersForCapability(options.capability);\n\n  // Capability outcome is 'disabled' when no registered provider implements it.\n  if (eligibleProviders.length === 0) {\n    log.debug(\n      { capability: options.capability },\n      `No providers registered for capability \"${options.capability}\"`,\n    );\n    return {\n      decision: {\n        capability: options.capability,\n        outcome: 'disabled',\n        attachments: options.attachments.map((a) => ({\n          attachmentIndex: a.attachmentIndex,\n          attempts: [],\n        })),\n      },\n      outputs: [],\n    };\n  }\n\n  if (options.attachments.length === 0) {\n    return {\n      decision: { capability: options.capability, outcome: 'no-attachment', attachments: [] },\n      outputs: [],\n    };\n  }\n\n  const providers = orderProviders(eligibleProviders, options.capability, options.providerOrder);\n  const attachmentDecisions: MediaUnderstandingAttachmentDecision[] = [];\n  const outputs: MediaUnderstandingOutput[] = [];\n\n  for (const attachment of options.attachments) {\n    options.signal?.throwIfAborted();\n\n    const attempts: MediaUnderstandingModelDecision[] = [];\n    let chosen: MediaUnderstandingModelDecision | undefined;\n\n    for (const provider of providers) {\n      const method = pickMethod(provider, options.capability);\n      if (!method) {\n        // Defensive: registry filter should already exclude these. Recorded as\n        // skipped so callers can diagnose registry/method mismatches.\n        attempts.push({\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'skipped',\n          reason: `provider \"${provider.id}\" missing method for capability \"${options.capability}\"`,\n        });\n        continue;\n      }\n      const request = options.buildRequest({ provider, attachment });\n      if (!request) {\n        attempts.push({\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'skipped',\n          reason: 'caller buildRequest returned undefined (likely missing config)',\n        });\n        continue;\n      }\n      try {\n        // We narrow `method` by capability above; cast through `unknown` to keep\n        // a single call site without per-capability ceremony.\n        const callResult = await (method as (req: unknown) => Promise<{ text: string; model?: string }>)(\n          request,\n        );\n        const text = callResult.text?.trim() ?? '';\n        if (!text) {\n          attempts.push({\n            provider: provider.id,\n            type: 'provider',\n            outcome: 'failed',\n            reason: 'empty transcription/description text',\n            model: callResult.model,\n          });\n          continue;\n        }\n        chosen = {\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'success',\n          model: callResult.model,\n        };\n        attempts.push(chosen);\n        outputs.push({\n          kind: KIND_BY_CAPABILITY[options.capability],\n          attachmentIndex: attachment.attachmentIndex,\n          text,\n          provider: provider.id,\n          model: callResult.model,\n        });\n        break;\n      } catch (error) {\n        const reason = error instanceof Error ? error.message : String(error);\n        log.warn(\n          {\n            err: error,\n            providerId: provider.id,\n            capability: options.capability,\n            attachmentIndex: attachment.attachmentIndex,\n          },\n          `Provider \"${provider.id}\" failed for ${options.capability}: ${reason}`,\n        );\n        attempts.push({\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'failed',\n          reason,\n        });\n      }\n    }\n\n    attachmentDecisions.push({\n      attachmentIndex: attachment.attachmentIndex,\n      attempts,\n      ...(chosen ? { chosen } : {}),\n    });\n  }\n\n  const overallOutcome = attachmentDecisions.every((d) => d.chosen)\n    ? 'success'\n    : attachmentDecisions.some((d) => d.chosen)\n      ? 'success' // partial success — at least one attachment succeeded\n      : 'failed';\n\n  return {\n    decision: {\n      capability: options.capability,\n      outcome: overallOutcome,\n      attachments: attachmentDecisions,\n    },\n    outputs,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../src/media-understanding/runner.ts"],"sourcesContent":["/**\n * MediaUnderstanding capability runner.\n *\n * Orchestrates per-attachment fallback across providers for one capability\n * (audio / image / video). For each attachment:\n *   1. Build the candidate provider list from the registry, ordered by\n *      autoPriority (lower = first), with caller-supplied `providerOrder`\n *      overriding when set.\n *   2. Try providers in order. A provider is SKIPPED when it does not declare\n *      the requested capability OR does not implement the corresponding method.\n *   3. The first provider whose capability call resolves successfully wins;\n *      its output is recorded as `chosen`. Failures are recorded as attempts\n *      and the next provider is tried.\n *   4. When ALL providers for an attachment fail, the attachment outcome is\n *      `failed`; when no provider was even eligible (capability not registered),\n *      it's `disabled`.\n *\n * DECISION (per docs/voice-rearchitecture.md §5):\n *   - This is a thin runner only. xopc v2.0 ships ONLY audio; image/video\n *     branches exist as type-level fall-throughs (the runner happily handles\n *     them once a provider registers describeImage / describeVideo, but no\n *     image-specific helpers — like multi-image batching — live here yet).\n *   - We deliberately do NOT port openclaw's `MediaAttachmentCache` (which\n *     handles temp-file extraction, SSRF re-validation on remote URLs, etc.).\n *     For xopc v2.0 the caller is expected to pre-load the buffer; remote URL\n *     fetching is the caller's responsibility (typically the channel adapter\n *     does this before invoking the runner).\n */\n\nimport { createLogger } from '../utils/logger.js';\n\nimport { listProvidersForCapability } from './registry.js';\nimport type {\n  AudioTranscriptionRequest,\n  AudioTranscriptionResult,\n  CapabilityAttachmentInput,\n  ImageDescriptionRequest,\n  ImageDescriptionResult,\n  MediaCapability,\n  MediaUnderstandingAttachmentDecision,\n  MediaUnderstandingKind,\n  MediaUnderstandingModelDecision,\n  MediaUnderstandingOutput,\n  MediaUnderstandingProvider,\n  MediaUnderstandingResult,\n  VideoDescriptionRequest,\n  VideoDescriptionResult,\n} from './types.js';\n\nconst log = createLogger('MediaUnderstandingRunner');\n\nexport type { CapabilityAttachmentInput } from './types.js';\n\nexport interface RunCapabilityOptions {\n  capability: MediaCapability;\n  attachments: readonly CapabilityAttachmentInput[];\n  /** Caller-supplied ordering. When set, overrides registry autoPriority. */\n  providerOrder?: readonly string[];\n  /**\n   * Per-provider request builder. Returned shape MUST match the capability:\n   *   audio  → AudioTranscriptionRequest\n   *   image  → ImageDescriptionRequest\n   *   video  → VideoDescriptionRequest\n   * The runner does not synthesize api keys / urls — that's the caller's job\n   * (typically reads from cfg.tools.media.audio.providers[providerId]).\n   */\n  buildRequest: (params: {\n    provider: MediaUnderstandingProvider;\n    attachment: CapabilityAttachmentInput;\n  }) =>\n    | AudioTranscriptionRequest\n    | ImageDescriptionRequest\n    | VideoDescriptionRequest\n    | undefined;\n  /** Optional global timeout signal (e.g. from agent-level cancellation). */\n  signal?: AbortSignal;\n}\n\nconst KIND_BY_CAPABILITY: Record<MediaCapability, MediaUnderstandingKind> = {\n  audio: 'audio.transcription',\n  image: 'image.description',\n  video: 'video.description',\n};\n\nfunction orderProviders(\n  providers: MediaUnderstandingProvider[],\n  capability: MediaCapability,\n  override?: readonly string[],\n): MediaUnderstandingProvider[] {\n  if (override && override.length > 0) {\n    const lookup = new Map(providers.map((p) => [p.id.toLowerCase(), p]));\n    const ordered: MediaUnderstandingProvider[] = [];\n    const used = new Set<string>();\n    for (const id of override) {\n      const provider = lookup.get(id.toLowerCase());\n      if (provider && !used.has(provider.id)) {\n        ordered.push(provider);\n        used.add(provider.id);\n      }\n    }\n    // Append any registered providers not in the override (preserves capability\n    // availability when the override list is incomplete).\n    for (const provider of providers) {\n      if (!used.has(provider.id)) {\n        ordered.push(provider);\n      }\n    }\n    return ordered;\n  }\n  return [...providers].sort((a, b) => {\n    const aPriority = a.autoPriority?.[capability] ?? Number.MAX_SAFE_INTEGER;\n    const bPriority = b.autoPriority?.[capability] ?? Number.MAX_SAFE_INTEGER;\n    return aPriority - bPriority;\n  });\n}\n\nfunction pickMethod(\n  provider: MediaUnderstandingProvider,\n  capability: MediaCapability,\n): ((req: never) => Promise<{ text: string; model?: string }>) | undefined {\n  if (capability === 'audio') {\n    return provider.transcribeAudio as (\n      req: AudioTranscriptionRequest,\n    ) => Promise<AudioTranscriptionResult>;\n  }\n  if (capability === 'image') {\n    return provider.describeImage as (\n      req: ImageDescriptionRequest,\n    ) => Promise<ImageDescriptionResult>;\n  }\n  return provider.describeVideo as (\n    req: VideoDescriptionRequest,\n  ) => Promise<VideoDescriptionResult>;\n}\n\nexport async function runCapability(\n  options: RunCapabilityOptions,\n): Promise<MediaUnderstandingResult> {\n  const eligibleProviders = listProvidersForCapability(options.capability);\n\n  // Capability outcome is 'disabled' when no registered provider implements it.\n  if (eligibleProviders.length === 0) {\n    log.debug(\n      { capability: options.capability },\n      `No providers registered for capability \"${options.capability}\"`,\n    );\n    return {\n      decision: {\n        capability: options.capability,\n        outcome: 'disabled',\n        attachments: options.attachments.map((a) => ({\n          attachmentIndex: a.attachmentIndex,\n          attempts: [],\n        })),\n      },\n      outputs: [],\n    };\n  }\n\n  if (options.attachments.length === 0) {\n    return {\n      decision: { capability: options.capability, outcome: 'no-attachment', attachments: [] },\n      outputs: [],\n    };\n  }\n\n  const providers = orderProviders(eligibleProviders, options.capability, options.providerOrder);\n  const attachmentDecisions: MediaUnderstandingAttachmentDecision[] = [];\n  const outputs: MediaUnderstandingOutput[] = [];\n\n  for (const attachment of options.attachments) {\n    options.signal?.throwIfAborted();\n\n    const attempts: MediaUnderstandingModelDecision[] = [];\n    let chosen: MediaUnderstandingModelDecision | undefined;\n\n    for (const provider of providers) {\n      const method = pickMethod(provider, options.capability);\n      if (!method) {\n        // Defensive: registry filter should already exclude these. Recorded as\n        // skipped so callers can diagnose registry/method mismatches.\n        attempts.push({\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'skipped',\n          reason: `provider \"${provider.id}\" missing method for capability \"${options.capability}\"`,\n        });\n        continue;\n      }\n      const request = options.buildRequest({ provider, attachment });\n      if (!request) {\n        attempts.push({\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'skipped',\n          reason: 'caller buildRequest returned undefined (likely missing config)',\n        });\n        continue;\n      }\n      const startedAt = Date.now();\n      try {\n        // We narrow `method` by capability above; cast through `unknown` to keep\n        // a single call site without per-capability ceremony.\n        const callResult = await (method as (req: unknown) => Promise<{ text: string; model?: string }>)(\n          request,\n        );\n        const text = callResult.text?.trim() ?? '';\n        if (!text) {\n          attempts.push({\n            provider: provider.id,\n            type: 'provider',\n            outcome: 'failed',\n            reason: 'empty transcription/description text',\n            model: callResult.model,\n            latencyMs: Date.now() - startedAt,\n          });\n          continue;\n        }\n        chosen = {\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'success',\n          model: callResult.model,\n          latencyMs: Date.now() - startedAt,\n        };\n        attempts.push(chosen);\n        outputs.push({\n          kind: KIND_BY_CAPABILITY[options.capability],\n          attachmentIndex: attachment.attachmentIndex,\n          text,\n          provider: provider.id,\n          model: callResult.model,\n        });\n        break;\n      } catch (error) {\n        if (options.signal?.aborted) {\n          throw error;\n        }\n        const reason = error instanceof Error ? error.message : String(error);\n        log.warn(\n          {\n            err: error,\n            providerId: provider.id,\n            capability: options.capability,\n            attachmentIndex: attachment.attachmentIndex,\n          },\n          `Provider \"${provider.id}\" failed for ${options.capability}: ${reason}`,\n        );\n        attempts.push({\n          provider: provider.id,\n          type: 'provider',\n          outcome: 'failed',\n          reason,\n          latencyMs: Date.now() - startedAt,\n        });\n      }\n    }\n\n    attachmentDecisions.push({\n      attachmentIndex: attachment.attachmentIndex,\n      attempts,\n      ...(chosen ? { chosen } : {}),\n    });\n  }\n\n  const overallOutcome = attachmentDecisions.every((d) => d.chosen)\n    ? 'success'\n    : attachmentDecisions.some((d) => d.chosen)\n      ? 'success' // partial success — at least one attachment succeeded\n      : 'failed';\n\n  return {\n    decision: {\n      capability: options.capability,\n      outcome: overallOutcome,\n      attachments: attachmentDecisions,\n    },\n    outputs,\n  };\n}\n"],"mappings":";;;;aA6BkD;AAoBlD,MAAM,MAAM,aAAa,2BAA2B;AA6BpD,MAAM,qBAAsE;CAC1E,OAAO;CACP,OAAO;CACP,OAAO;CACR;AAED,SAAS,eACP,WACA,YACA,UAC8B;AAC9B,KAAI,YAAY,SAAS,SAAS,GAAG;EACnC,MAAM,SAAS,IAAI,IAAI,UAAU,KAAK,MAAM,CAAC,EAAE,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC;EACrE,MAAM,UAAwC,EAAE;EAChD,MAAM,uBAAO,IAAI,KAAa;AAC9B,OAAK,MAAM,MAAM,UAAU;GACzB,MAAM,WAAW,OAAO,IAAI,GAAG,aAAa,CAAC;AAC7C,OAAI,YAAY,CAAC,KAAK,IAAI,SAAS,GAAG,EAAE;AACtC,YAAQ,KAAK,SAAS;AACtB,SAAK,IAAI,SAAS,GAAG;;;AAKzB,OAAK,MAAM,YAAY,UACrB,KAAI,CAAC,KAAK,IAAI,SAAS,GAAG,CACxB,SAAQ,KAAK,SAAS;AAG1B,SAAO;;AAET,QAAO,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,MAAM;AAGnC,UAFkB,EAAE,eAAe,eAAe,OAAO,qBACvC,EAAE,eAAe,eAAe,OAAO;GAEzD;;AAGJ,SAAS,WACP,UACA,YACyE;AACzE,KAAI,eAAe,QACjB,QAAO,SAAS;AAIlB,KAAI,eAAe,QACjB,QAAO,SAAS;AAIlB,QAAO,SAAS;;AAKlB,eAAsB,cACpB,SACmC;CACnC,MAAM,oBAAoB,2BAA2B,QAAQ,WAAW;AAGxE,KAAI,kBAAkB,WAAW,GAAG;AAClC,MAAI,MACF,EAAE,YAAY,QAAQ,YAAY,EAClC,2CAA2C,QAAQ,WAAW,GAC/D;AACD,SAAO;GACL,UAAU;IACR,YAAY,QAAQ;IACpB,SAAS;IACT,aAAa,QAAQ,YAAY,KAAK,OAAO;KAC3C,iBAAiB,EAAE;KACnB,UAAU,EAAE;KACb,EAAE;IACJ;GACD,SAAS,EAAE;GACZ;;AAGH,KAAI,QAAQ,YAAY,WAAW,EACjC,QAAO;EACL,UAAU;GAAE,YAAY,QAAQ;GAAY,SAAS;GAAiB,aAAa,EAAE;GAAE;EACvF,SAAS,EAAE;EACZ;CAGH,MAAM,YAAY,eAAe,mBAAmB,QAAQ,YAAY,QAAQ,cAAc;CAC9F,MAAM,sBAA8D,EAAE;CACtE,MAAM,UAAsC,EAAE;AAE9C,MAAK,MAAM,cAAc,QAAQ,aAAa;AAC5C,UAAQ,QAAQ,gBAAgB;EAEhC,MAAM,WAA8C,EAAE;EACtD,IAAI;AAEJ,OAAK,MAAM,YAAY,WAAW;GAChC,MAAM,SAAS,WAAW,UAAU,QAAQ,WAAW;AACvD,OAAI,CAAC,QAAQ;AAGX,aAAS,KAAK;KACZ,UAAU,SAAS;KACnB,MAAM;KACN,SAAS;KACT,QAAQ,aAAa,SAAS,GAAG,mCAAmC,QAAQ,WAAW;KACxF,CAAC;AACF;;GAEF,MAAM,UAAU,QAAQ,aAAa;IAAE;IAAU;IAAY,CAAC;AAC9D,OAAI,CAAC,SAAS;AACZ,aAAS,KAAK;KACZ,UAAU,SAAS;KACnB,MAAM;KACN,SAAS;KACT,QAAQ;KACT,CAAC;AACF;;GAEF,MAAM,YAAY,KAAK,KAAK;AAC5B,OAAI;IAGF,MAAM,aAAa,MAAO,OACxB,QACD;IACD,MAAM,OAAO,WAAW,MAAM,MAAM,IAAI;AACxC,QAAI,CAAC,MAAM;AACT,cAAS,KAAK;MACZ,UAAU,SAAS;MACnB,MAAM;MACN,SAAS;MACT,QAAQ;MACR,OAAO,WAAW;MAClB,WAAW,KAAK,KAAK,GAAG;MACzB,CAAC;AACF;;AAEF,aAAS;KACP,UAAU,SAAS;KACnB,MAAM;KACN,SAAS;KACT,OAAO,WAAW;KAClB,WAAW,KAAK,KAAK,GAAG;KACzB;AACD,aAAS,KAAK,OAAO;AACrB,YAAQ,KAAK;KACX,MAAM,mBAAmB,QAAQ;KACjC,iBAAiB,WAAW;KAC5B;KACA,UAAU,SAAS;KACnB,OAAO,WAAW;KACnB,CAAC;AACF;YACO,OAAO;AACd,QAAI,QAAQ,QAAQ,QAClB,OAAM;IAER,MAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACrE,QAAI,KACF;KACE,KAAK;KACL,YAAY,SAAS;KACrB,YAAY,QAAQ;KACpB,iBAAiB,WAAW;KAC7B,EACD,aAAa,SAAS,GAAG,eAAe,QAAQ,WAAW,IAAI,SAChE;AACD,aAAS,KAAK;KACZ,UAAU,SAAS;KACnB,MAAM;KACN,SAAS;KACT;KACA,WAAW,KAAK,KAAK,GAAG;KACzB,CAAC;;;AAIN,sBAAoB,KAAK;GACvB,iBAAiB,WAAW;GAC5B;GACA,GAAI,SAAS,EAAE,QAAQ,GAAG,EAAE;GAC7B,CAAC;;CAGJ,MAAM,iBAAiB,oBAAoB,OAAO,MAAM,EAAE,OAAO,GAC7D,YACA,oBAAoB,MAAM,MAAM,EAAE,OAAO,GACvC,YACA;AAEN,QAAO;EACL,UAAU;GACR,YAAY,QAAQ;GACpB,SAAS;GACT,aAAa;GACd;EACD;EACD"}

package/dist/src/media-understanding/types.d.ts

@@ -70,6 +70,8 @@ export interface MediaUnderstandingModelDecision {
     type: 'provider' | 'cli';
     outcome: MediaUnderstandingAttemptOutcome;
     reason?: string;
+    /** Wall-clock time spent in this provider attempt. */
+    latencyMs?: number;
 }
 export interface MediaUnderstandingAttachmentDecision {
     attachmentIndex: number;
@@ -98,6 +100,7 @@ export interface AudioTranscriptionRequest {
     prompt?: string;
     query?: Record<string, string | number | boolean>;
     timeoutMs: number;
+    signal?: AbortSignal;
 }
 export interface AudioTranscriptionResult {
     text: string;
@@ -156,6 +159,10 @@ export interface MediaUnderstandingProvider {
      * Defaults to true.
      */
     requiresApiKey?: boolean;
+    /** Optional runtime readiness check for bundled providers such as local STT. */
+    isConfigured?: (options?: {
+        model?: string;
+    }) => boolean;
     /** Lower number = higher priority in auto-selection. */
     autoPriority?: Partial<Record<MediaCapability, number>>;
     /** True when the provider can natively ingest PDF (no OCR pre-step needed). */

package/dist/src/migrations/runner.js

@@ -1,6 +1,6 @@
-import { ConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { ConfigSchema, init_schema } from "../config/schema.js";
 import { listRegisteredMigrations } from "./registry.js";
 import { defaultCapabilityPresetMigration } from "./config/default-capability-preset.js";
 import { dirname, join } from "node:path";

package/dist/src/notes/service.js

@@ -1,11 +1,11 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
-import { publishAutomationProductEvent } from "../automations/product-events.js";
-import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { buildNoteAttachmentRef } from "./attachment-ref.js";
 import { parseNoteMarkdown } from "./note-markdown.js";
 import { changedFieldsFromPatch, emitActivity, previewText, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
+import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
+import { publishAutomationProductEvent } from "../automations/product-events.js";
+import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { NotesStore } from "./store.js";
 import { partitionAttachmentsByReference } from "./note-attachment-sync.js";
 import { buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";

package/dist/src/notes/store.js

@@ -1,11 +1,11 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { buildNoteIndexMeta } from "./note-index-meta.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "../storage/sqlite/notes-repository.js";
 import { deleteNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { resolveNoteHistoryDir, resolveNoteMediaDir } from "./paths.js";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";

package/dist/src/projects/project-service.js

@@ -1,7 +1,7 @@
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
-import { ProjectStore } from "./project-store.js";
 import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
+import { ProjectStore } from "./project-store.js";
 import { bindGoalToProject, listProjectGoalIds, unbindGoalFromProject } from "./goal-bind.js";
 import { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject } from "./session-bind.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";

package/dist/src/projects/workspace.js

@@ -1,7 +1,7 @@
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { projectWorkspacePath } from "../session/session-workspace.js";
 import { ProjectStore } from "./project-store.js";
 //#region src/projects/workspace.ts

package/dist/src/routing/agent-session-key.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { DEFAULT_ACCOUNT_ID, init_account_id, normalizeAccountId, normalizeOptionalAccountId } from "./account-id.js";
 import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
+import { DEFAULT_ACCOUNT_ID, init_account_id, normalizeAccountId, normalizeOptionalAccountId } from "./account-id.js";
 import { getSubagentDepth, init_session_key_utils, isAcpSessionKey, isCronSessionKey, isSubagentSessionKey, parseAgentSessionKey, parseThreadSessionSuffix } from "./session-key-utils.js";
 //#region src/routing/agent-session-key.ts
 function normalizeToken(value) {

package/dist/src/routing/resolve-route.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_account_id, normalizeAccountId } from "./account-id.js";
 import { buildAgentMainSessionKey, buildAgentPeerSessionKey, init_agent_session_key, normalizeSessionKey } from "./agent-session-key.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { buildSessionKey, init_session_key, parseSessionKey } from "./session-key.js";
 import { init_bindings, parseBindingRules, resolveRoute as resolveRoute$1 } from "./bindings.js";
 //#region src/routing/resolve-route.ts

package/dist/src/routing/resolve-tui-session-key.js

@@ -1,7 +1,7 @@
-import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
 import { parseAgentSessionKey } from "./session-key-utils.js";
 import { buildAgentMainSessionKey, init_agent_session_key, normalizeAgentId, normalizeMainKey } from "./agent-session-key.js";
+import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { randomUUID } from "node:crypto";
 //#region src/routing/resolve-tui-session-key.ts
 init_agent_scope();

package/dist/src/session/init-session-turn.js

@@ -1,8 +1,8 @@
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import "../storage/sqlite/index.js";
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
 import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";

package/dist/src/session/resolve-session.js

@@ -1,9 +1,9 @@
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { findSessionKeyBySessionId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";

package/dist/src/session/session-title.js

@@ -1,7 +1,7 @@
-import { isCronSessionKey } from "../routing/session-key-utils.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { isCronSessionKey } from "../routing/session-key-utils.js";
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";

package/dist/src/session/store.js

@@ -1,5 +1,4 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
@@ -9,6 +8,7 @@ import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
 import { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckpointDetail, listCompactionCheckpoints, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreCompactionCheckpoint } from "../storage/sqlite/transcript-repository.js";
 import "../storage/sqlite/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
 import { SessionCompactor } from "../agent/memory/compaction.js";
 import { SlidingWindow } from "../agent/memory/window.js";

package/dist/src/storage/sqlite/connection.js

@@ -1,9 +1,9 @@
 import { resolveXopcDatabasePath } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { ensureXopcDatabaseSchema } from "./schema.js";
 import { requireNodeSqlite } from "../../infra/node-sqlite.js";
 import { installSqliteTransientRejectionHandler } from "../../infra/unhandled-rejections.js";
-import { ensureXopcDatabaseSchema } from "./schema.js";
 import path from "node:path";
 import fs from "node:fs";
 import childProcess from "node:child_process";

package/dist/src/storage/sqlite/index.d.ts

@@ -13,7 +13,7 @@ export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } f
 export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord, type NoteAgentContextRecord, } from './note-agent-context-repository.js';
 export { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex, type MemorySearchHit, } from './memory-index-repository.js';
 export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, findLatestMemoryInjectTrace, getMemoryProviderState, getMemoryRecord, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, setLatestMemoryInjectFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, USER_UNDERSTANDING_REMEDIATION_POLICY, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type FindLatestMemoryInjectTraceInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemoryFeedbackRemediationResult, type MemorySignalRowPayload, type MemoryTraceFeedback, type MemoryTraceEventPayload, type UserUnderstandingQualityMetrics, type SearchMemoryRecordsOptions, type SetMemoryTraceFeedbackInput, type SetLatestMemoryInjectFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-repository.js';
-export { attachMemoryEvidence, finishKnowledgeSyncRun, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeSourceItemSynthesisStatus, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems, } from './knowledge-repository.js';
+export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSourceChanges, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeSourceItemSynthesisStatus, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems, } from './knowledge-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';
 export { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent, } from './activity-repository.js';
 export { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getConnectorConnection, getConnectorApproval, getConnectorInstallation, getCachedConnectorCatalogEntry, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, type CachedConnectorCatalogEntry, } from './connector-repository.js';

package/dist/src/storage/sqlite/index.js

@@ -14,10 +14,10 @@ import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } fr
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
 import { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex } from "./memory-index-repository.js";
 import { USER_UNDERSTANDING_REMEDIATION_POLICY, appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, findLatestMemoryInjectTrace, getMemoryProviderState, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, upsertMemoryRecord } from "./memory-records-repository.js";
-import { attachMemoryEvidence, finishKnowledgeSyncRun, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";
+import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";
 import { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "./config-repository.js";
 import { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "./activity-repository.js";
 import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
 import { getUserProfilePromptState, setUserProfilePromptState } from "./user-profile-setup-repository.js";
-export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, claimConnectorWebhookDelivery, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

package/dist/src/storage/sqlite/knowledge-repository.d.ts

@@ -1,4 +1,4 @@
-import type { KnowledgeSourceItem, KnowledgeSourceItemInput, KnowledgeSyncRun, KnowledgeSyncRunStatus, KnowledgeSynthesisStatus } from '../../knowledge/types.js';
+import type { KnowledgeSourceChange, KnowledgeSourceItem, KnowledgeSourceItemInput, KnowledgeSyncRun, KnowledgeSyncRunStatus, KnowledgeSynthesisPipeline, KnowledgeSynthesisStatus } from '../../knowledge/types.js';
 import type { MemoryEvidence, MemoryEvidenceRelation } from '../../agent/memory/types.js';
 export declare function startKnowledgeSyncRun(input: {
     sourceInstanceId: string;
@@ -30,6 +30,13 @@ export declare function upsertKnowledgeSourceItems(inputs: KnowledgeSourceItemIn
     unchanged: number;
 };
 export declare function getKnowledgeSourceItem(itemId: string): KnowledgeSourceItem | null;
+export declare function listKnowledgeSourceChanges(options?: {
+    sourceInstanceId?: string;
+    afterSequence?: number;
+    limit?: number;
+}): KnowledgeSourceChange[];
+export declare function getKnowledgeConsumerWatermark(consumerId: string, sourceInstanceId: string): number;
+export declare function setKnowledgeConsumerWatermark(consumerId: string, sourceInstanceId: string, sequence: number, nowMs?: number): void;
 export declare function listKnowledgeSourceItems(options?: {
     sourceInstanceId?: string;
     synthesisStatus?: KnowledgeSynthesisStatus;
@@ -38,6 +45,23 @@ export declare function listKnowledgeSourceItems(options?: {
     offset?: number;
 }): KnowledgeSourceItem[];
 export declare function setKnowledgeSourceItemSynthesisStatus(itemIds: string[], status: KnowledgeSynthesisStatus, nowMs?: number): number;
+export declare function claimKnowledgeSourceItems(options: {
+    workerId: string;
+    sourceInstanceId?: string;
+    synthesisPipeline?: KnowledgeSynthesisPipeline;
+    limit?: number;
+    leaseMs?: number;
+    retryDelayMs?: number;
+    maxAttempts?: number;
+    nowMs?: number;
+}): KnowledgeSourceItem[];
+export declare function completeKnowledgeSourceItemSynthesis(input: {
+    itemId: string;
+    workerId: string;
+    status: 'completed' | 'failed' | 'ignored';
+    error?: string;
+    nowMs?: number;
+}): boolean;
 export declare function attachMemoryEvidence(input: {
     recordId: string;
     sourceItemId?: string;
@@ -47,4 +71,5 @@ export declare function attachMemoryEvidence(input: {
     observedAt?: string;
     nowMs?: number;
 }): MemoryEvidence;
+export declare function deleteMemoryEvidenceForRecord(recordId: string, relation?: MemoryEvidenceRelation): number;
 export declare function listMemoryEvidence(recordId: string): MemoryEvidence[];

package/dist/src/storage/sqlite/knowledge-repository.js

@@ -40,12 +40,29 @@ function sourceItemFromRow(row) {
 		metadata: parseRecord(row.metadata_json),
 		sensitivity: row.sensitivity,
 		retentionClass: row.retention_class,
+		synthesisPipeline: row.synthesis_pipeline,
 		synthesisStatus: row.synthesis_status,
+		synthesisAttempts: row.synthesis_attempts,
+		...timestampToIso(row.synthesis_claimed_at) ? { synthesisClaimedAt: timestampToIso(row.synthesis_claimed_at) } : {},
+		...row.synthesis_claimed_by ? { synthesisClaimedBy: row.synthesis_claimed_by } : {},
+		...row.synthesis_error ? { synthesisError: row.synthesis_error } : {},
 		...timestampToIso(row.deleted_at) ? { deletedAt: timestampToIso(row.deleted_at) } : {},
 		createdAt: new Date(row.created_at).toISOString(),
 		updatedAt: new Date(row.updated_at).toISOString()
 	};
 }
+function sourceChangeFromRow(row) {
+	return {
+		sequence: row.sequence,
+		id: row.change_id,
+		sourceInstanceId: row.source_instance_id,
+		sourceItemId: row.source_item_id,
+		kind: row.change_kind,
+		...row.old_hash ? { oldHash: row.old_hash } : {},
+		...row.new_hash ? { newHash: row.new_hash } : {},
+		changedAt: new Date(row.changed_at).toISOString()
+	};
+}
 function syncRunFromRow(row) {
 	return {
 		id: row.run_id,
@@ -141,8 +158,8 @@ function upsertKnowledgeSourceItems(inputs, nowMs = Date.now()) {
           item_id, source_instance_id, external_id, item_type, author_role,
           occurred_at, source_updated_at, content_hash, normalized_text,
           payload_ref, metadata_json, sensitivity, retention_class,
-          synthesis_status, deleted_at, created_at, updated_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          synthesis_pipeline, synthesis_status, deleted_at, created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
         ON CONFLICT(source_instance_id, external_id) DO UPDATE SET
           item_type = excluded.item_type,
           author_role = excluded.author_role,
@@ -154,11 +171,21 @@ function upsertKnowledgeSourceItems(inputs, nowMs = Date.now()) {
           metadata_json = excluded.metadata_json,
           sensitivity = excluded.sensitivity,
           retention_class = excluded.retention_class,
+          synthesis_pipeline = excluded.synthesis_pipeline,
           synthesis_status = excluded.synthesis_status,
+          synthesis_attempts = 0,
+          synthesis_claimed_at = NULL,
+          synthesis_claimed_by = NULL,
+          synthesis_error = NULL,
           deleted_at = excluded.deleted_at,
-          updated_at = excluded.updated_at`).run(id, input.sourceInstanceId, input.externalId, input.itemType, input.authorRole ?? null, parseTimestamp(input.occurredAt), parseTimestamp(input.sourceUpdatedAt), input.contentHash, input.normalizedText ?? null, input.payloadRef ?? null, JSON.stringify(input.metadata ?? {}), input.sensitivity ?? "normal", input.retentionClass ?? "bounded", input.synthesisStatus ?? "pending", parseTimestamp(input.deletedAt), existing?.created_at ?? nowMs, nowMs);
+          updated_at = excluded.updated_at`).run(id, input.sourceInstanceId, input.externalId, input.itemType, input.authorRole ?? null, parseTimestamp(input.occurredAt), parseTimestamp(input.sourceUpdatedAt), input.contentHash, input.normalizedText ?? null, input.payloadRef ?? null, JSON.stringify(input.metadata ?? {}), input.sensitivity ?? "normal", input.retentionClass ?? "bounded", input.synthesisPipeline ?? "user_understanding", input.synthesisStatus ?? "pending", parseTimestamp(input.deletedAt), existing?.created_at ?? nowMs, nowMs);
 			const row = db.prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ?`).get(id);
 			items.push(sourceItemFromRow(row));
+			const changeKind = input.deletedAt ? "deleted" : existing ? "modified" : "added";
+			db.prepare(`INSERT INTO knowledge_source_changes (
+          change_id, source_instance_id, source_item_id, change_kind,
+          old_hash, new_hash, changed_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?)`).run(randomUUID(), input.sourceInstanceId, id, changeKind, existing?.content_hash ?? null, input.deletedAt ? null : input.contentHash, nowMs);
 			if (existing) updated += 1;
 			else created += 1;
 		}
@@ -174,6 +201,36 @@ function getKnowledgeSourceItem(itemId) {
 	const row = getSqliteDatabase().prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ?`).get(itemId);
 	return row ? sourceItemFromRow(row) : null;
 }
+function listKnowledgeSourceChanges(options = {}) {
+	const where = [];
+	const params = [];
+	if (options.sourceInstanceId) {
+		where.push("source_instance_id = ?");
+		params.push(options.sourceInstanceId);
+	}
+	if (options.afterSequence != null) {
+		where.push("sequence > ?");
+		params.push(Math.max(0, options.afterSequence));
+	}
+	const limit = Math.max(1, Math.min(1e3, options.limit ?? 100));
+	return getSqliteDatabase().prepare(`SELECT * FROM knowledge_source_changes
+     ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
+     ORDER BY sequence ASC LIMIT ?`).all(...params, limit).map(sourceChangeFromRow);
+}
+function getKnowledgeConsumerWatermark(consumerId, sourceInstanceId) {
+	return getSqliteDatabase().prepare(`SELECT last_sequence FROM knowledge_consumer_watermarks
+     WHERE consumer_id = ? AND source_instance_id = ?`).get(consumerId, sourceInstanceId)?.last_sequence ?? 0;
+}
+function setKnowledgeConsumerWatermark(consumerId, sourceInstanceId, sequence, nowMs = Date.now()) {
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO knowledge_consumer_watermarks (
+        consumer_id, source_instance_id, last_sequence, updated_at
+      ) VALUES (?, ?, ?, ?)
+      ON CONFLICT(consumer_id, source_instance_id) DO UPDATE SET
+        last_sequence = MAX(last_sequence, excluded.last_sequence),
+        updated_at = excluded.updated_at`).run(consumerId, sourceInstanceId, Math.max(0, sequence), nowMs);
+	});
+}
 function listKnowledgeSourceItems(options = {}) {
 	const where = [];
 	const params = [];
@@ -202,15 +259,66 @@ function setKnowledgeSourceItemSynthesisStatus(itemIds, status, nowMs = Date.now
 		return Number(result.changes);
 	});
 }
+function claimKnowledgeSourceItems(options) {
+	const now = options.nowMs ?? Date.now();
+	const leaseCutoff = now - Math.max(1e3, options.leaseMs ?? 5 * 6e4);
+	const retryCutoff = now - Math.max(1e3, options.retryDelayMs ?? 3e4);
+	const limit = Math.max(1, Math.min(100, options.limit ?? 20));
+	const maxAttempts = Math.max(1, options.maxAttempts ?? 3);
+	return runSqliteWriteTransaction((db) => {
+		const rows = db.prepare(`SELECT * FROM knowledge_source_items
+       WHERE synthesis_attempts < ?
+         ${options.sourceInstanceId ? "AND source_instance_id = ?" : ""}
+         ${options.synthesisPipeline ? "AND synthesis_pipeline = ?" : ""}
+         AND (
+           synthesis_status = 'pending'
+           OR (synthesis_status = 'failed' AND updated_at < ?)
+           OR (synthesis_status = 'processing' AND synthesis_claimed_at < ?)
+         )
+       ORDER BY COALESCE(source_updated_at, occurred_at, updated_at) ASC
+       LIMIT ?`).all(maxAttempts, ...options.sourceInstanceId ? [options.sourceInstanceId] : [], ...options.synthesisPipeline ? [options.synthesisPipeline] : [], retryCutoff, leaseCutoff, limit);
+		if (rows.length === 0) return [];
+		const ids = rows.map((row) => row.item_id);
+		const placeholders = ids.map(() => "?").join(", ");
+		db.prepare(`UPDATE knowledge_source_items SET
+        synthesis_status = 'processing',
+        synthesis_attempts = synthesis_attempts + 1,
+        synthesis_claimed_at = ?,
+        synthesis_claimed_by = ?,
+        synthesis_error = NULL,
+        updated_at = ?
+       WHERE item_id IN (${placeholders})`).run(now, options.workerId, now, ...ids);
+		return db.prepare(`SELECT * FROM knowledge_source_items WHERE item_id IN (${placeholders})`).all(...ids).map(sourceItemFromRow);
+	});
+}
+function completeKnowledgeSourceItemSynthesis(input) {
+	const now = input.nowMs ?? Date.now();
+	return runSqliteWriteTransaction((db) => {
+		const result = db.prepare(`UPDATE knowledge_source_items SET
+        synthesis_status = ?,
+        synthesis_claimed_at = NULL,
+        synthesis_claimed_by = NULL,
+        synthesis_error = ?,
+        updated_at = ?
+       WHERE item_id = ? AND synthesis_status = 'processing' AND synthesis_claimed_by = ?`).run(input.status, input.error ?? null, now, input.itemId, input.workerId);
+		return Number(result.changes) > 0;
+	});
+}
 function attachMemoryEvidence(input) {
-	const evidenceId = randomUUID();
+	let evidenceId = randomUUID();
 	const now = input.nowMs ?? Date.now();
 	const observedAt = parseTimestamp(input.observedAt);
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`INSERT INTO memory_evidence (
         evidence_id, record_id, source_item_id, relation, excerpt,
         confidence, observed_at, created_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(evidenceId, input.recordId, input.sourceItemId ?? null, input.relation ?? "supports", input.excerpt ?? null, input.confidence ?? null, observedAt, now);
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT DO UPDATE SET
+        excerpt = COALESCE(excluded.excerpt, memory_evidence.excerpt),
+        confidence = MAX(COALESCE(memory_evidence.confidence, 0), COALESCE(excluded.confidence, 0)),
+        observed_at = MAX(COALESCE(memory_evidence.observed_at, 0), COALESCE(excluded.observed_at, 0))`).run(evidenceId, input.recordId, input.sourceItemId ?? null, input.relation ?? "supports", input.excerpt ?? null, input.confidence ?? null, observedAt, now);
+		if (input.sourceItemId) evidenceId = db.prepare(`SELECT evidence_id FROM memory_evidence
+         WHERE record_id = ? AND source_item_id = ? AND relation = ?`).get(input.recordId, input.sourceItemId, input.relation ?? "supports")?.evidence_id ?? evidenceId;
 	});
 	return {
 		evidenceId,
@@ -221,6 +329,12 @@ function attachMemoryEvidence(input) {
 		...observedAt != null ? { observedAt: new Date(observedAt).toISOString() } : {}
 	};
 }
+function deleteMemoryEvidenceForRecord(recordId, relation) {
+	return runSqliteWriteTransaction((db) => {
+		const result = relation ? db.prepare(`DELETE FROM memory_evidence WHERE record_id = ? AND relation = ?`).run(recordId, relation) : db.prepare(`DELETE FROM memory_evidence WHERE record_id = ?`).run(recordId);
+		return Number(result.changes);
+	});
+}
 function listMemoryEvidence(recordId) {
 	return getSqliteDatabase().prepare(`SELECT * FROM memory_evidence WHERE record_id = ? ORDER BY created_at ASC`).all(recordId).map((row) => ({
 		evidenceId: row.evidence_id,
@@ -232,6 +346,6 @@ function listMemoryEvidence(recordId) {
 	}));
 }
 //#endregion
-export { attachMemoryEvidence, finishKnowledgeSyncRun, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems };
+export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems };
 
 //# sourceMappingURL=knowledge-repository.js.map