@xopcai/xopc 0.0.136 → 0.0.138

package/dist/src/knowledge/ingestion-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion-service.js","names":[],"sources":["../../../src/knowledge/ingestion-service.ts"],"sourcesContent":["import { createLogger } from '../utils/logger.js';\nimport {\n  finishKnowledgeSyncRun,\n  getKnowledgeSourceCursor,\n  setKnowledgeSourceCursor,\n  startKnowledgeSyncRun,\n  upsertKnowledgeSourceItems,\n} from '../storage/sqlite/knowledge-repository.js';\nimport type { KnowledgeSourceAdapter, KnowledgeSyncRun } from './types.js';\n\nconst log = createLogger('KnowledgeIngestion');\n\nexport interface KnowledgeSourceStateStore {\n  getCursor(instanceId: string): string | undefined;\n  setCursor(instanceId: string, cursor: string | undefined): void;\n}\n\nexport class SqliteKnowledgeSourceStateStore implements KnowledgeSourceStateStore {\n  getCursor(instanceId: string): string | undefined {\n    return getKnowledgeSourceCursor(instanceId);\n  }\n\n  setCursor(instanceId: string, cursor: string | undefined): void {\n    setKnowledgeSourceCursor(instanceId, cursor);\n  }\n}\n\nexport class KnowledgeIngestionService {\n  constructor(\n    private readonly adapters: ReadonlyMap<string, KnowledgeSourceAdapter>,\n    private readonly state: KnowledgeSourceStateStore = new SqliteKnowledgeSourceStateStore(),\n  ) {}\n\n  async sync(params: {\n    adapterKind: string;\n    instanceId: string;\n    windowStart?: string;\n    signal?: AbortSignal;\n  }): Promise<KnowledgeSyncRun> {\n    const adapter = this.adapters.get(params.adapterKind);\n    if (!adapter) {\n      throw new Error(`Knowledge source adapter not found: ${params.adapterKind}`);\n    }\n    const cursorBefore = this.state.getCursor(params.instanceId);\n    const run = startKnowledgeSyncRun({\n      sourceInstanceId: params.instanceId,\n      cursorBefore,\n    });\n    const controller = params.signal ? null : new AbortController();\n    const signal = params.signal ?? controller!.signal;\n\n    try {\n      const pulled = await adapter.pull({\n        instanceId: params.instanceId,\n        cursor: cursorBefore,\n        windowStart: params.windowStart,\n        signal,\n      });\n      const stored = upsertKnowledgeSourceItems(pulled.items);\n      this.state.setCursor(params.instanceId, pulled.nextCursor);\n      const completed = finishKnowledgeSyncRun({\n        runId: run.id,\n        status: pulled.warnings.length > 0 ? 'partial' : 'succeeded',\n        cursorAfter: pulled.nextCursor,\n        itemsSeen: pulled.items.length,\n        itemsCreated: stored.created,\n        itemsUpdated: stored.updated,\n        warnings: pulled.warnings,\n      });\n      log.info(\n        {\n          runId: run.id,\n          sourceInstanceId: params.instanceId,\n          itemsSeen: pulled.items.length,\n          itemsCreated: stored.created,\n          itemsUpdated: stored.updated,\n        },\n        'Knowledge source sync completed',\n      );\n      return completed;\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      const status = signal.aborted ? 'cancelled' : 'failed';\n      log.warn(\n        { err, runId: run.id, sourceInstanceId: params.instanceId },\n        `Knowledge source sync ${status}: ${errorMessage}`,\n      );\n      return finishKnowledgeSyncRun({\n        runId: run.id,\n        status,\n        error: errorMessage,\n      });\n    }\n  }\n}\n"],"mappings":";;;;aAAkD;AAUlD,MAAM,MAAM,aAAa,qBAAqB;AAO9C,IAAa,kCAAb,MAAkF;CAChF,UAAU,YAAwC;AAChD,SAAO,yBAAyB,WAAW;;CAG7C,UAAU,YAAoB,QAAkC;AAC9D,2BAAyB,YAAY,OAAO;;;AAIhD,IAAa,4BAAb,MAAuC;CACrC,YACE,UACA,QAAoD,IAAI,iCAAiC,EACzF;AAFiB,OAAA,WAAA;AACA,OAAA,QAAA;;CAGnB,MAAM,KAAK,QAKmB;EAC5B,MAAM,UAAU,KAAK,SAAS,IAAI,OAAO,YAAY;AACrD,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,uCAAuC,OAAO,cAAc;EAE9E,MAAM,eAAe,KAAK,MAAM,UAAU,OAAO,WAAW;EAC5D,MAAM,MAAM,sBAAsB;GAChC,kBAAkB,OAAO;GACzB;GACD,CAAC;EACF,MAAM,aAAa,OAAO,SAAS,OAAO,IAAI,iBAAiB;EAC/D,MAAM,SAAS,OAAO,UAAU,WAAY;AAE5C,MAAI;GACF,MAAM,SAAS,MAAM,QAAQ,KAAK;IAChC,YAAY,OAAO;IACnB,QAAQ;IACR,aAAa,OAAO;IACpB;IACD,CAAC;GACF,MAAM,SAAS,2BAA2B,OAAO,MAAM;AACvD,QAAK,MAAM,UAAU,OAAO,YAAY,OAAO,WAAW;GAC1D,MAAM,YAAY,uBAAuB;IACvC,OAAO,IAAI;IACX,QAAQ,OAAO,SAAS,SAAS,IAAI,YAAY;IACjD,aAAa,OAAO;IACpB,WAAW,OAAO,MAAM;IACxB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,UAAU,OAAO;IAClB,CAAC;AACF,OAAI,KACF;IACE,OAAO,IAAI;IACX,kBAAkB,OAAO;IACzB,WAAW,OAAO,MAAM;IACxB,cAAc,OAAO;IACrB,cAAc,OAAO;IACtB,EACD,kCACD;AACD,UAAO;WACA,KAAK;GACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;GACrE,MAAM,SAAS,OAAO,UAAU,cAAc;AAC9C,OAAI,KACF;IAAE;IAAK,OAAO,IAAI;IAAI,kBAAkB,OAAO;IAAY,EAC3D,yBAAyB,OAAO,IAAI,eACrC;AACD,UAAO,uBAAuB;IAC5B,OAAO,IAAI;IACX;IACA,OAAO;IACR,CAAC"}

package/dist/src/knowledge/types.d.ts

@@ -0,0 +1,70 @@
+import type { MemorySensitivity } from '../agent/memory/types.js';
+export type KnowledgeSyncRunStatus = 'running' | 'succeeded' | 'partial' | 'failed' | 'cancelled';
+export type KnowledgeSynthesisStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'ignored';
+export type KnowledgeRetentionClass = 'ephemeral' | 'bounded' | 'durable';
+export type KnowledgeAuthorRole = 'user' | 'assistant' | 'third_party' | 'system' | 'unknown';
+export interface KnowledgeSourceItem {
+    id: string;
+    sourceInstanceId: string;
+    externalId: string;
+    itemType: string;
+    authorRole?: KnowledgeAuthorRole;
+    occurredAt?: string;
+    sourceUpdatedAt?: string;
+    contentHash: string;
+    normalizedText?: string;
+    payloadRef?: string;
+    metadata: Record<string, unknown>;
+    sensitivity: MemorySensitivity;
+    retentionClass: KnowledgeRetentionClass;
+    synthesisStatus: KnowledgeSynthesisStatus;
+    deletedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KnowledgeSourceItemInput {
+    id?: string;
+    sourceInstanceId: string;
+    externalId: string;
+    itemType: string;
+    authorRole?: KnowledgeAuthorRole;
+    occurredAt?: string;
+    sourceUpdatedAt?: string;
+    contentHash: string;
+    normalizedText?: string;
+    payloadRef?: string;
+    metadata?: Record<string, unknown>;
+    sensitivity?: MemorySensitivity;
+    retentionClass?: KnowledgeRetentionClass;
+    synthesisStatus?: KnowledgeSynthesisStatus;
+    deletedAt?: string;
+}
+export interface KnowledgeSyncRun {
+    id: string;
+    sourceInstanceId: string;
+    status: KnowledgeSyncRunStatus;
+    cursorBefore?: string;
+    cursorAfter?: string;
+    itemsSeen: number;
+    itemsCreated: number;
+    itemsUpdated: number;
+    warnings: string[];
+    error?: string;
+    startedAt: string;
+    finishedAt?: string;
+}
+export interface KnowledgePullInput {
+    instanceId: string;
+    cursor?: string;
+    windowStart?: string;
+    signal: AbortSignal;
+}
+export interface KnowledgePullResult {
+    items: KnowledgeSourceItemInput[];
+    nextCursor?: string;
+    warnings: string[];
+}
+export interface KnowledgeSourceAdapter {
+    readonly kind: string;
+    pull(input: KnowledgePullInput): Promise<KnowledgePullResult>;
+}

package/dist/src/knowledge/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -3,7 +3,6 @@ import { join } from "node:path";
 import { existsSync, readdirSync, statSync } from "node:fs";
 //#region src/projects/project-kind.ts
 const STRONG_CODE_MARKERS = [
-	".git",
 	"package.json",
 	"pnpm-lock.yaml",
 	"yarn.lock",

package/dist/src/projects/project-kind.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-kind.js","names":[],"sources":["../../../src/projects/project-kind.ts"],"sourcesContent":["import { existsSync, readdirSync, statSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { canonicalWorkspacePath } from './workspace-project.js';\n\nexport type ProjectKind = 'coding' | 'general' | 'unknown';\nexport type ProjectKindOverride = 'auto' | 'coding' | 'general';\n\nexport type ProjectKindInference = {\n  kind: ProjectKind;\n  confidence: number;\n  reasons: string[];\n};\n\nconst STRONG_CODE_MARKERS = [\n  '.git',\n  'package.json',\n  'pnpm-lock.yaml',\n  'yarn.lock',\n  'package-lock.json',\n  'tsconfig.json',\n  'go.mod',\n  'Cargo.toml',\n  'pyproject.toml',\n  'requirements.txt',\n  'pom.xml',\n  'build.gradle',\n  'Makefile',\n  'Dockerfile',\n  'deno.json',\n  'deno.jsonc',\n  'composer.json',\n  'Gemfile',\n] as const;\n\nconst WEAK_CODE_DIRECTORIES = ['src', 'app', 'lib', 'tests', 'test', '__tests__', '.github'] as const;\nconst CODE_EXTENSIONS = new Set([\n  '.c',\n  '.cc',\n  '.cpp',\n  '.cs',\n  '.css',\n  '.go',\n  '.h',\n  '.hpp',\n  '.html',\n  '.java',\n  '.js',\n  '.jsx',\n  '.kt',\n  '.mjs',\n  '.php',\n  '.py',\n  '.rb',\n  '.rs',\n  '.sh',\n  '.swift',\n  '.ts',\n  '.tsx',\n]);\n\nfunction normalizeOverride(value: string | null | undefined): ProjectKindOverride {\n  const normalized = value?.trim().toLowerCase();\n  return normalized === 'coding' || normalized === 'general' ? normalized : 'auto';\n}\n\nfunction hasSourceExtension(name: string): boolean {\n  const lower = name.toLowerCase();\n  for (const extension of CODE_EXTENSIONS) {\n    if (lower.endsWith(extension)) return true;\n  }\n  return false;\n}\n\nfunction readDirectoryNames(pathValue: string): string[] {\n  try {\n    return readdirSync(pathValue).slice(0, 200);\n  } catch {\n    return [];\n  }\n}\n\nfunction directoryExists(pathValue: string): boolean {\n  try {\n    return statSync(pathValue).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport function inferProjectKind(input: {\n  name?: string | null;\n  description?: string | null;\n  workspaceRoot?: string | null;\n  projectKind?: string | null;\n}): ProjectKindInference {\n  const override = normalizeOverride(input.projectKind);\n  if (override === 'coding') return { kind: 'coding', confidence: 1, reasons: ['selected coding project type'] };\n  if (override === 'general') return { kind: 'general', confidence: 1, reasons: ['selected general project type'] };\n\n  const workspaceRoot = canonicalWorkspacePath(input.workspaceRoot);\n  const reasons: string[] = [];\n  let score = 0;\n\n  if (workspaceRoot && directoryExists(workspaceRoot)) {\n    for (const marker of STRONG_CODE_MARKERS) {\n      if (existsSync(join(workspaceRoot, marker))) {\n        score += 4;\n        reasons.push(`found ${marker}`);\n        break;\n      }\n    }\n\n    for (const dir of WEAK_CODE_DIRECTORIES) {\n      if (directoryExists(join(workspaceRoot, dir))) {\n        score += 1;\n        reasons.push(`found ${dir}/`);\n        break;\n      }\n    }\n\n    if (readDirectoryNames(workspaceRoot).some(hasSourceExtension)) {\n      score += 2;\n      reasons.push('found source files');\n    } else {\n      for (const dir of ['src', 'app', 'lib']) {\n        const childDir = join(workspaceRoot, dir);\n        if (directoryExists(childDir) && readDirectoryNames(childDir).some(hasSourceExtension)) {\n          score += 2;\n          reasons.push(`found source files in ${dir}/`);\n          break;\n        }\n      }\n    }\n  }\n\n  if (score >= 4) return { kind: 'coding', confidence: 0.9, reasons };\n  if (score >= 3) return { kind: 'coding', confidence: 0.75, reasons };\n  if (workspaceRoot) return { kind: 'general', confidence: 0.55, reasons };\n  return { kind: 'unknown', confidence: 0.25, reasons };\n}\n"],"mappings":";;;;AAcA,MAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,wBAAwB;CAAC;CAAO;CAAO;CAAO;CAAS;CAAQ;CAAa;CAAU;AAC5F,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAS,kBAAkB,OAAuD;CAChF,MAAM,aAAa,OAAO,MAAM,CAAC,aAAa;AAC9C,QAAO,eAAe,YAAY,eAAe,YAAY,aAAa;;AAG5E,SAAS,mBAAmB,MAAuB;CACjD,MAAM,QAAQ,KAAK,aAAa;AAChC,MAAK,MAAM,aAAa,gBACtB,KAAI,MAAM,SAAS,UAAU,CAAE,QAAO;AAExC,QAAO;;AAGT,SAAS,mBAAmB,WAA6B;AACvD,KAAI;AACF,SAAO,YAAY,UAAU,CAAC,MAAM,GAAG,IAAI;SACrC;AACN,SAAO,EAAE;;;AAIb,SAAS,gBAAgB,WAA4B;AACnD,KAAI;AACF,SAAO,SAAS,UAAU,CAAC,aAAa;SAClC;AACN,SAAO;;;AAIX,SAAgB,iBAAiB,OAKR;CACvB,MAAM,WAAW,kBAAkB,MAAM,YAAY;AACrD,KAAI,aAAa,SAAU,QAAO;EAAE,MAAM;EAAU,YAAY;EAAG,SAAS,CAAC,+BAA+B;EAAE;AAC9G,KAAI,aAAa,UAAW,QAAO;EAAE,MAAM;EAAW,YAAY;EAAG,SAAS,CAAC,gCAAgC;EAAE;CAEjH,MAAM,gBAAgB,uBAAuB,MAAM,cAAc;CACjE,MAAM,UAAoB,EAAE;CAC5B,IAAI,QAAQ;AAEZ,KAAI,iBAAiB,gBAAgB,cAAc,EAAE;AACnD,OAAK,MAAM,UAAU,oBACnB,KAAI,WAAW,KAAK,eAAe,OAAO,CAAC,EAAE;AAC3C,YAAS;AACT,WAAQ,KAAK,SAAS,SAAS;AAC/B;;AAIJ,OAAK,MAAM,OAAO,sBAChB,KAAI,gBAAgB,KAAK,eAAe,IAAI,CAAC,EAAE;AAC7C,YAAS;AACT,WAAQ,KAAK,SAAS,IAAI,GAAG;AAC7B;;AAIJ,MAAI,mBAAmB,cAAc,CAAC,KAAK,mBAAmB,EAAE;AAC9D,YAAS;AACT,WAAQ,KAAK,qBAAqB;QAElC,MAAK,MAAM,OAAO;GAAC;GAAO;GAAO;GAAM,EAAE;GACvC,MAAM,WAAW,KAAK,eAAe,IAAI;AACzC,OAAI,gBAAgB,SAAS,IAAI,mBAAmB,SAAS,CAAC,KAAK,mBAAmB,EAAE;AACtF,aAAS;AACT,YAAQ,KAAK,yBAAyB,IAAI,GAAG;AAC7C;;;;AAMR,KAAI,SAAS,EAAG,QAAO;EAAE,MAAM;EAAU,YAAY;EAAK;EAAS;AACnE,KAAI,SAAS,EAAG,QAAO;EAAE,MAAM;EAAU,YAAY;EAAM;EAAS;AACpE,KAAI,cAAe,QAAO;EAAE,MAAM;EAAW,YAAY;EAAM;EAAS;AACxE,QAAO;EAAE,MAAM;EAAW,YAAY;EAAM;EAAS"}
+{"version":3,"file":"project-kind.js","names":[],"sources":["../../../src/projects/project-kind.ts"],"sourcesContent":["import { existsSync, readdirSync, statSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { canonicalWorkspacePath } from './workspace-project.js';\n\nexport type ProjectKind = 'coding' | 'general' | 'unknown';\nexport type ProjectKindOverride = 'auto' | 'coding' | 'general';\n\nexport type ProjectKindInference = {\n  kind: ProjectKind;\n  confidence: number;\n  reasons: string[];\n};\n\nconst STRONG_CODE_MARKERS = [\n  'package.json',\n  'pnpm-lock.yaml',\n  'yarn.lock',\n  'package-lock.json',\n  'tsconfig.json',\n  'go.mod',\n  'Cargo.toml',\n  'pyproject.toml',\n  'requirements.txt',\n  'pom.xml',\n  'build.gradle',\n  'Makefile',\n  'Dockerfile',\n  'deno.json',\n  'deno.jsonc',\n  'composer.json',\n  'Gemfile',\n] as const;\n\nconst WEAK_CODE_DIRECTORIES = ['src', 'app', 'lib', 'tests', 'test', '__tests__', '.github'] as const;\nconst CODE_EXTENSIONS = new Set([\n  '.c',\n  '.cc',\n  '.cpp',\n  '.cs',\n  '.css',\n  '.go',\n  '.h',\n  '.hpp',\n  '.html',\n  '.java',\n  '.js',\n  '.jsx',\n  '.kt',\n  '.mjs',\n  '.php',\n  '.py',\n  '.rb',\n  '.rs',\n  '.sh',\n  '.swift',\n  '.ts',\n  '.tsx',\n]);\n\nfunction normalizeOverride(value: string | null | undefined): ProjectKindOverride {\n  const normalized = value?.trim().toLowerCase();\n  return normalized === 'coding' || normalized === 'general' ? normalized : 'auto';\n}\n\nfunction hasSourceExtension(name: string): boolean {\n  const lower = name.toLowerCase();\n  for (const extension of CODE_EXTENSIONS) {\n    if (lower.endsWith(extension)) return true;\n  }\n  return false;\n}\n\nfunction readDirectoryNames(pathValue: string): string[] {\n  try {\n    return readdirSync(pathValue).slice(0, 200);\n  } catch {\n    return [];\n  }\n}\n\nfunction directoryExists(pathValue: string): boolean {\n  try {\n    return statSync(pathValue).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport function inferProjectKind(input: {\n  name?: string | null;\n  description?: string | null;\n  workspaceRoot?: string | null;\n  projectKind?: string | null;\n}): ProjectKindInference {\n  const override = normalizeOverride(input.projectKind);\n  if (override === 'coding') return { kind: 'coding', confidence: 1, reasons: ['selected coding project type'] };\n  if (override === 'general') return { kind: 'general', confidence: 1, reasons: ['selected general project type'] };\n\n  const workspaceRoot = canonicalWorkspacePath(input.workspaceRoot);\n  const reasons: string[] = [];\n  let score = 0;\n\n  if (workspaceRoot && directoryExists(workspaceRoot)) {\n    for (const marker of STRONG_CODE_MARKERS) {\n      if (existsSync(join(workspaceRoot, marker))) {\n        score += 4;\n        reasons.push(`found ${marker}`);\n        break;\n      }\n    }\n\n    for (const dir of WEAK_CODE_DIRECTORIES) {\n      if (directoryExists(join(workspaceRoot, dir))) {\n        score += 1;\n        reasons.push(`found ${dir}/`);\n        break;\n      }\n    }\n\n    if (readDirectoryNames(workspaceRoot).some(hasSourceExtension)) {\n      score += 2;\n      reasons.push('found source files');\n    } else {\n      for (const dir of ['src', 'app', 'lib']) {\n        const childDir = join(workspaceRoot, dir);\n        if (directoryExists(childDir) && readDirectoryNames(childDir).some(hasSourceExtension)) {\n          score += 2;\n          reasons.push(`found source files in ${dir}/`);\n          break;\n        }\n      }\n    }\n  }\n\n  if (score >= 4) return { kind: 'coding', confidence: 0.9, reasons };\n  if (score >= 3) return { kind: 'coding', confidence: 0.75, reasons };\n  if (workspaceRoot) return { kind: 'general', confidence: 0.55, reasons };\n  return { kind: 'unknown', confidence: 0.25, reasons };\n}\n"],"mappings":";;;;AAcA,MAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,wBAAwB;CAAC;CAAO;CAAO;CAAO;CAAS;CAAQ;CAAa;CAAU;AAC5F,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAS,kBAAkB,OAAuD;CAChF,MAAM,aAAa,OAAO,MAAM,CAAC,aAAa;AAC9C,QAAO,eAAe,YAAY,eAAe,YAAY,aAAa;;AAG5E,SAAS,mBAAmB,MAAuB;CACjD,MAAM,QAAQ,KAAK,aAAa;AAChC,MAAK,MAAM,aAAa,gBACtB,KAAI,MAAM,SAAS,UAAU,CAAE,QAAO;AAExC,QAAO;;AAGT,SAAS,mBAAmB,WAA6B;AACvD,KAAI;AACF,SAAO,YAAY,UAAU,CAAC,MAAM,GAAG,IAAI;SACrC;AACN,SAAO,EAAE;;;AAIb,SAAS,gBAAgB,WAA4B;AACnD,KAAI;AACF,SAAO,SAAS,UAAU,CAAC,aAAa;SAClC;AACN,SAAO;;;AAIX,SAAgB,iBAAiB,OAKR;CACvB,MAAM,WAAW,kBAAkB,MAAM,YAAY;AACrD,KAAI,aAAa,SAAU,QAAO;EAAE,MAAM;EAAU,YAAY;EAAG,SAAS,CAAC,+BAA+B;EAAE;AAC9G,KAAI,aAAa,UAAW,QAAO;EAAE,MAAM;EAAW,YAAY;EAAG,SAAS,CAAC,gCAAgC;EAAE;CAEjH,MAAM,gBAAgB,uBAAuB,MAAM,cAAc;CACjE,MAAM,UAAoB,EAAE;CAC5B,IAAI,QAAQ;AAEZ,KAAI,iBAAiB,gBAAgB,cAAc,EAAE;AACnD,OAAK,MAAM,UAAU,oBACnB,KAAI,WAAW,KAAK,eAAe,OAAO,CAAC,EAAE;AAC3C,YAAS;AACT,WAAQ,KAAK,SAAS,SAAS;AAC/B;;AAIJ,OAAK,MAAM,OAAO,sBAChB,KAAI,gBAAgB,KAAK,eAAe,IAAI,CAAC,EAAE;AAC7C,YAAS;AACT,WAAQ,KAAK,SAAS,IAAI,GAAG;AAC7B;;AAIJ,MAAI,mBAAmB,cAAc,CAAC,KAAK,mBAAmB,EAAE;AAC9D,YAAS;AACT,WAAQ,KAAK,qBAAqB;QAElC,MAAK,MAAM,OAAO;GAAC;GAAO;GAAO;GAAM,EAAE;GACvC,MAAM,WAAW,KAAK,eAAe,IAAI;AACzC,OAAI,gBAAgB,SAAS,IAAI,mBAAmB,SAAS,CAAC,KAAK,mBAAmB,EAAE;AACtF,aAAS;AACT,YAAQ,KAAK,yBAAyB,IAAI,GAAG;AAC7C;;;;AAMR,KAAI,SAAS,EAAG,QAAO;EAAE,MAAM;EAAU,YAAY;EAAK;EAAS;AACnE,KAAI,SAAS,EAAG,QAAO;EAAE,MAAM;EAAU,YAAY;EAAM;EAAS;AACpE,KAAI,cAAe,QAAO;EAAE,MAAM;EAAW,YAAY;EAAM;EAAS;AACxE,QAAO;EAAE,MAAM;EAAW,YAAY;EAAM;EAAS"}

package/dist/src/providers/presentation.js

@@ -5,6 +5,7 @@ import { getDomesticProviderPreset, getDomesticProviderPresetIds } from "./domes
 init_providers();
 init_plugin_registry();
 const FEATURED_PROVIDER_ORDER = [
+	"deepseek",
 	"openai",
 	"anthropic",
 	"xai",
@@ -15,7 +16,6 @@ const FEATURED_PROVIDER_ORDER = [
 	"volcengine-ark",
 	"volcengine-plan",
 	"byteplus-plan",
-	"deepseek",
 	"moonshotai",
 	"moonshotai-cn",
 	"kimi-coding",

package/dist/src/providers/presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"presentation.js","names":[],"sources":["../../../src/providers/presentation.ts"],"sourcesContent":["import type { Api, Model } from '@earendil-works/pi-ai';\n\nimport {\n  getAllModels,\n  getAllProviders,\n  getModelsByProvider,\n  getProviderDisplayName,\n  isProviderConfigured,\n  PROVIDER_META,\n  type ProviderCategory,\n} from './index.js';\nimport {\n  getDomesticProviderPreset,\n  getDomesticProviderPresetIds,\n  type DomesticProviderModelPreset,\n} from './domestic-presets.js';\nimport { getProviderRegistry } from './plugin-registry.js';\n\nexport interface ModelCatalogView {\n  ref: string;\n  provider: string;\n  id: string;\n  name: string;\n  reasoning: boolean;\n  input: Array<'text' | 'image'>;\n  contextWindow?: number;\n  maxTokens?: number;\n  vision: boolean;\n  recommended: boolean;\n}\n\nexport interface ProviderCatalogView {\n  id: string;\n  name: string;\n  category: ProviderCategory;\n  supportsOAuth: boolean;\n  supportsApiKey: boolean;\n  configured: boolean;\n  onboardingFeatured: boolean;\n  recommendedModels: ModelCatalogView[];\n  modelCount: number;\n  hint?: string;\n}\n\nconst FEATURED_PROVIDER_ORDER = [\n  'openai',\n  'anthropic',\n  'xai',\n  'google',\n  'openrouter',\n  'dashscope-cn',\n  'dashscope-intl',\n  'volcengine-ark',\n  'volcengine-plan',\n  'byteplus-plan',\n  'deepseek',\n  'moonshotai',\n  'moonshotai-cn',\n  'kimi-coding',\n  'stepfun-cn',\n  'stepfun-intl',\n  'stepfun-plan-cn',\n  'stepfun-plan-intl',\n  'xiaomi',\n  'xiaomi-token-plan-cn',\n  'ant-ling',\n  'zhipu-cn',\n  'zai',\n  'zai-coding-cn',\n  'zhipu-coding-cn',\n  'minimax',\n  'minimax-cn',\n];\n\nconst PROVIDER_HINTS: Record<string, string> = {\n  openai: 'Frontier OpenAI models from the official API.',\n  anthropic: 'Claude models for coding, long context, and reasoning.',\n  xai: 'Grok models from xAI.',\n  google: 'Gemini models with strong multimodal and long-context support.',\n  openrouter: 'Route many hosted models through one API key.',\n  dashscope: 'DashScope service provider for Alibaba Model Studio.',\n  'dashscope-cn': 'Alibaba Bailian Qwen models through the China OpenAI-compatible endpoint.',\n  'dashscope-intl': 'Alibaba Bailian Qwen models through the international OpenAI-compatible endpoint.',\n  'volcengine-ark': 'Volcengine Ark OpenAI-compatible endpoints; use your Ark endpoint id as the model id.',\n  'volcengine-plan': 'Doubao coding-plan models through Volcengine Ark.',\n  'byteplus-plan': 'Doubao coding-plan models through BytePlus.',\n  deepseek: 'DeepSeek V4 models with strong price/performance.',\n  moonshotai: 'Kimi models through Moonshot International.',\n  'moonshotai-cn': 'Kimi models through Moonshot China.',\n  'kimi-coding': 'Kimi dedicated coding endpoint with Anthropic-compatible requests.',\n  stepfun: 'StepFun OpenAI-compatible endpoint.',\n  'stepfun-cn': 'StepFun China OpenAI-compatible endpoint.',\n  'stepfun-intl': 'StepFun international OpenAI-compatible endpoint.',\n  'stepfun-plan': 'StepFun Step Plan coding/planning endpoint.',\n  'stepfun-plan-cn': 'StepFun Step Plan China coding/planning endpoint.',\n  'stepfun-plan-intl': 'StepFun Step Plan international coding/planning endpoint.',\n  xiaomi: 'Xiaomi MiMo OpenAI-compatible model access.',\n  'xiaomi-token-plan-cn': 'Xiaomi MiMo Token Plan China endpoint.',\n  'xiaomi-token-plan-ams': 'Xiaomi MiMo Token Plan Amsterdam endpoint.',\n  'xiaomi-token-plan-sgp': 'Xiaomi MiMo Token Plan Singapore endpoint.',\n  'ant-ling': 'Ant Ling models through a domestic OpenAI-compatible endpoint.',\n  'zhipu-cn': 'Zhipu GLM China through the BigModel OpenAI-compatible API.',\n  zai: 'Zhipu GLM International through z.ai.',\n  'zai-coding-cn': 'Zhipu GLM coding-plan China endpoint from pi-ai.',\n  'zai-coding-global': 'Zhipu GLM coding-plan international endpoint.',\n  'zhipu-coding-cn': 'Zhipu GLM coding-plan China endpoint.',\n  minimax: 'MiniMax text models; Anthropic-compatible endpoint is preferred for agent workflows.',\n  'minimax-cn': 'MiniMax China endpoint for domestic access.',\n  'openai-codex': 'OpenAI Codex models through OAuth.',\n  'google-gemini-cli': 'Gemini through Google Cloud Code Assist OAuth.',\n  'google-antigravity': 'Gemini/Antigravity OAuth model access.',\n};\n\nconst RECOMMENDED_MODEL_PATTERNS: Record<string, RegExp[]> = {\n  openai: [/^gpt-5\\.6$/i, /^gpt-5\\.6-sol$/i, /^gpt-5\\.6-terra$/i, /^gpt-5\\.6-luna$/i, /^gpt-5\\.5$/i, /^gpt-5\\.5-pro$/i],\n  'openai-codex': [/^gpt-5\\.6-sol$/i, /^gpt-5\\.6-terra$/i, /^gpt-5\\.6-luna$/i, /^gpt-5\\.5$/i],\n  anthropic: [/^claude-sonnet-5$/i, /^claude-opus-4-8$/i, /^claude-fable-5$/i, /^claude-sonnet-4-6$/i, /^claude-sonnet-4-5$/i],\n  google: [/^gemini-3\\.5-flash$/i, /^gemini-3\\.1-pro-preview$/i, /^gemini-3-flash-preview$/i, /^gemini-3-pro-preview$/i],\n  'google-vertex': [/^gemini-3\\.5-flash$/i, /^gemini-3\\.1-pro-preview$/i, /^gemini-3-flash-preview$/i, /^gemini-3-pro-preview$/i],\n  xai: [/^grok-4/i, /^grok-3/i, /^grok-code/i],\n  dashscope: [/^qwen3\\.7-plus$/i, /^qwen3\\.7-max$/i, /^qwen3\\.6-flash$/i],\n  'dashscope-cn': [/^qwen3\\.7-plus$/i, /^qwen3\\.7-max$/i, /^qwen3\\.6-flash$/i],\n  'dashscope-intl': [/^qwen3\\.7-plus$/i, /^qwen3\\.7-max$/i, /^qwen3\\.6-flash$/i],\n  'volcengine-ark': [/^ep-your-endpoint-id$/i],\n  'volcengine-plan': [/^ark-code-latest$/i, /^doubao-seed-2\\.0-code$/i, /^doubao-seed-2\\.0-pro$/i],\n  'byteplus-plan': [/^ark-code-latest$/i, /^doubao-seed-2\\.0-code$/i, /^doubao-seed-2\\.0-pro$/i],\n  deepseek: [/^deepseek-v4-flash$/i, /^deepseek-v4-pro$/i],\n  openrouter: [/^openai\\/gpt-5/i, /^anthropic\\/claude-sonnet-4/i, /^google\\/gemini-3/i],\n  moonshotai: [/^kimi-k2\\.7-code$/i, /^kimi-k2\\.6$/i],\n  'moonshotai-cn': [/^kimi-k2\\.7-code$/i, /^kimi-k2\\.6$/i],\n  'kimi-coding': [/^k2p7$/i, /^kimi-for-coding$/i],\n  stepfun: [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-cn': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-intl': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-plan': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-plan-cn': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-plan-intl': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  xiaomi: [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'xiaomi-token-plan-cn': [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'xiaomi-token-plan-ams': [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'xiaomi-token-plan-sgp': [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'ant-ling': [/^Ling-2\\.6-1T$/i, /^Ling-2\\.6-flash$/i, /^Ring-2\\.6-1T$/i],\n  'zhipu-cn': [/^glm-5\\.2$/i],\n  zai: [/^glm-5\\.2$/i],\n  'zai-coding-cn': [/^glm-5\\.2$/i, /^glm-5\\.1$/i, /^glm-5-turbo$/i],\n  'zai-coding-global': [/^glm-5\\.2$/i],\n  'zhipu-coding-cn': [/^glm-5\\.2$/i],\n  minimax: [/^MiniMax-M3$/i, /^MiniMax-M2\\.7-highspeed$/i, /^MiniMax-M2\\.7$/i],\n  'minimax-cn': [/^MiniMax-M3$/i, /^MiniMax-M2\\.7-highspeed$/i, /^MiniMax-M2\\.7$/i],\n};\n\nfunction modelRef(model: Pick<Model<Api>, 'provider' | 'id'>): string {\n  return `${model.provider}/${model.id}`;\n}\n\nfunction recommendedRank(provider: string, modelId: string): number {\n  const patterns = RECOMMENDED_MODEL_PATTERNS[provider] ?? [];\n  const idx = patterns.findIndex((pattern) => pattern.test(modelId));\n  return idx === -1 ? Number.POSITIVE_INFINITY : idx;\n}\n\nexport function isRecommendedModel(provider: string, modelId: string): boolean {\n  return Number.isFinite(recommendedRank(provider, modelId));\n}\n\nexport function modelToCatalogView(model: Model<Api>): ModelCatalogView {\n  const input = (model.input ?? ['text']) as Array<'text' | 'image'>;\n  return {\n    ref: modelRef(model),\n    provider: model.provider,\n    id: model.id,\n    name: model.name || model.id,\n    reasoning: model.reasoning ?? false,\n    input,\n    ...(model.contextWindow ? { contextWindow: model.contextWindow } : {}),\n    ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),\n    vision: input.includes('image'),\n    recommended: isRecommendedModel(model.provider, model.id),\n  };\n}\n\nfunction presetModelToCatalogView(provider: string, model: DomesticProviderModelPreset): ModelCatalogView {\n  const input = model.input ?? ['text'];\n  return {\n    ref: `${provider}/${model.id}`,\n    provider,\n    id: model.id,\n    name: model.name || model.id,\n    reasoning: model.reasoning ?? false,\n    input,\n    ...(model.contextWindow ? { contextWindow: model.contextWindow } : {}),\n    ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),\n    vision: input.includes('image'),\n    recommended: isRecommendedModel(provider, model.id),\n  };\n}\n\nexport function sortModelsForPicker(models: readonly Model<Api>[]): Model<Api>[] {\n  return [...models].sort((a, b) => {\n    const aRank = recommendedRank(a.provider, a.id);\n    const bRank = recommendedRank(b.provider, b.id);\n    if (aRank !== bRank) return aRank - bRank;\n    if (a.provider !== b.provider) return a.provider.localeCompare(b.provider);\n    return (a.name || a.id).localeCompare(b.name || b.id, undefined, { sensitivity: 'base' });\n  });\n}\n\nexport function getRecommendedModelsForProvider(provider: string, limit = 4): ModelCatalogView[] {\n  const models = sortModelsForPicker(getModelsByProvider(provider));\n  const fromRegistry = models\n    .filter((model) => isRecommendedModel(provider, model.id))\n    .slice(0, limit)\n    .map(modelToCatalogView);\n  if (fromRegistry.length > 0) return fromRegistry;\n\n  const preset = getDomesticProviderPreset(provider);\n  if (!preset) return [];\n  return preset.models\n    .filter((model) => isRecommendedModel(provider, model.id))\n    .slice(0, limit)\n    .map((model) => presetModelToCatalogView(provider, model));\n}\n\nexport function getProviderHint(provider: string): string | undefined {\n  return PROVIDER_HINTS[provider];\n}\n\nexport function getOnboardingFeaturedProviders(): string[] {\n  const providers = new Set([...getAllProviders(), ...getDomesticProviderPresetIds()]);\n  return FEATURED_PROVIDER_ORDER.filter((provider) => providers.has(provider));\n}\n\nexport function sortProvidersForPicker(providers: readonly string[]): string[] {\n  const featuredRank = new Map(FEATURED_PROVIDER_ORDER.map((provider, index) => [provider, index] as const));\n  return [...providers].sort((a, b) => {\n    const aRank = featuredRank.get(a) ?? Number.POSITIVE_INFINITY;\n    const bRank = featuredRank.get(b) ?? Number.POSITIVE_INFINITY;\n    if (aRank !== bRank) return aRank - bRank;\n    const catA = PROVIDER_META[a]?.category ?? 'specialty';\n    const catB = PROVIDER_META[b]?.category ?? 'specialty';\n    const catOrder: Record<ProviderCategory, number> = {\n      common: 0,\n      domestic: 1,\n      specialty: 2,\n      enterprise: 3,\n      oauth: 4,\n      extension: 5,\n    };\n    if (catOrder[catA] !== catOrder[catB]) return catOrder[catA] - catOrder[catB];\n    return getProviderDisplayName(a).localeCompare(getProviderDisplayName(b), undefined, { sensitivity: 'base' });\n  });\n}\n\nexport async function getProviderCatalogViews(): Promise<ProviderCatalogView[]> {\n  const pluginRegistry = getProviderRegistry();\n  const providers = sortProvidersForPicker([...new Set([...getAllProviders(), ...getDomesticProviderPresetIds()])]);\n  const modelCounts = new Map<string, number>();\n  for (const model of getAllModels()) {\n    modelCounts.set(model.provider, (modelCounts.get(model.provider) ?? 0) + 1);\n  }\n\n  return Promise.all(\n    providers.map(async (provider) => {\n      const plugin = pluginRegistry.get(provider);\n      const meta = PROVIDER_META[provider];\n      const domesticPreset = getDomesticProviderPreset(provider);\n      return {\n        id: provider,\n        name: plugin?.name ?? domesticPreset?.displayName ?? getProviderDisplayName(provider),\n        category: plugin ? 'extension' : (meta?.category ?? (domesticPreset ? 'domestic' : 'specialty')),\n        supportsOAuth: plugin ? false : (meta?.supportsOAuth ?? false),\n        supportsApiKey: plugin ? false : (meta?.supportsApiKey ?? true),\n        configured: plugin ? true : await isProviderConfigured(provider),\n        onboardingFeatured: FEATURED_PROVIDER_ORDER.includes(provider),\n        recommendedModels: getRecommendedModelsForProvider(provider),\n        modelCount: modelCounts.get(provider) ?? 0,\n        ...(getProviderHint(provider) ? { hint: getProviderHint(provider) } : {}),\n      };\n    }),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"presentation.js","names":[],"sources":["../../../src/providers/presentation.ts"],"sourcesContent":["import type { Api, Model } from '@earendil-works/pi-ai';\n\nimport {\n  getAllModels,\n  getAllProviders,\n  getModelsByProvider,\n  getProviderDisplayName,\n  isProviderConfigured,\n  PROVIDER_META,\n  type ProviderCategory,\n} from './index.js';\nimport {\n  getDomesticProviderPreset,\n  getDomesticProviderPresetIds,\n  type DomesticProviderModelPreset,\n} from './domestic-presets.js';\nimport { getProviderRegistry } from './plugin-registry.js';\n\nexport interface ModelCatalogView {\n  ref: string;\n  provider: string;\n  id: string;\n  name: string;\n  reasoning: boolean;\n  input: Array<'text' | 'image'>;\n  contextWindow?: number;\n  maxTokens?: number;\n  vision: boolean;\n  recommended: boolean;\n}\n\nexport interface ProviderCatalogView {\n  id: string;\n  name: string;\n  category: ProviderCategory;\n  supportsOAuth: boolean;\n  supportsApiKey: boolean;\n  configured: boolean;\n  onboardingFeatured: boolean;\n  recommendedModels: ModelCatalogView[];\n  modelCount: number;\n  hint?: string;\n}\n\nconst FEATURED_PROVIDER_ORDER = [\n  'deepseek',\n  'openai',\n  'anthropic',\n  'xai',\n  'google',\n  'openrouter',\n  'dashscope-cn',\n  'dashscope-intl',\n  'volcengine-ark',\n  'volcengine-plan',\n  'byteplus-plan',\n  'moonshotai',\n  'moonshotai-cn',\n  'kimi-coding',\n  'stepfun-cn',\n  'stepfun-intl',\n  'stepfun-plan-cn',\n  'stepfun-plan-intl',\n  'xiaomi',\n  'xiaomi-token-plan-cn',\n  'ant-ling',\n  'zhipu-cn',\n  'zai',\n  'zai-coding-cn',\n  'zhipu-coding-cn',\n  'minimax',\n  'minimax-cn',\n];\n\nconst PROVIDER_HINTS: Record<string, string> = {\n  openai: 'Frontier OpenAI models from the official API.',\n  anthropic: 'Claude models for coding, long context, and reasoning.',\n  xai: 'Grok models from xAI.',\n  google: 'Gemini models with strong multimodal and long-context support.',\n  openrouter: 'Route many hosted models through one API key.',\n  dashscope: 'DashScope service provider for Alibaba Model Studio.',\n  'dashscope-cn': 'Alibaba Bailian Qwen models through the China OpenAI-compatible endpoint.',\n  'dashscope-intl': 'Alibaba Bailian Qwen models through the international OpenAI-compatible endpoint.',\n  'volcengine-ark': 'Volcengine Ark OpenAI-compatible endpoints; use your Ark endpoint id as the model id.',\n  'volcengine-plan': 'Doubao coding-plan models through Volcengine Ark.',\n  'byteplus-plan': 'Doubao coding-plan models through BytePlus.',\n  deepseek: 'DeepSeek V4 models with strong price/performance.',\n  moonshotai: 'Kimi models through Moonshot International.',\n  'moonshotai-cn': 'Kimi models through Moonshot China.',\n  'kimi-coding': 'Kimi dedicated coding endpoint with Anthropic-compatible requests.',\n  stepfun: 'StepFun OpenAI-compatible endpoint.',\n  'stepfun-cn': 'StepFun China OpenAI-compatible endpoint.',\n  'stepfun-intl': 'StepFun international OpenAI-compatible endpoint.',\n  'stepfun-plan': 'StepFun Step Plan coding/planning endpoint.',\n  'stepfun-plan-cn': 'StepFun Step Plan China coding/planning endpoint.',\n  'stepfun-plan-intl': 'StepFun Step Plan international coding/planning endpoint.',\n  xiaomi: 'Xiaomi MiMo OpenAI-compatible model access.',\n  'xiaomi-token-plan-cn': 'Xiaomi MiMo Token Plan China endpoint.',\n  'xiaomi-token-plan-ams': 'Xiaomi MiMo Token Plan Amsterdam endpoint.',\n  'xiaomi-token-plan-sgp': 'Xiaomi MiMo Token Plan Singapore endpoint.',\n  'ant-ling': 'Ant Ling models through a domestic OpenAI-compatible endpoint.',\n  'zhipu-cn': 'Zhipu GLM China through the BigModel OpenAI-compatible API.',\n  zai: 'Zhipu GLM International through z.ai.',\n  'zai-coding-cn': 'Zhipu GLM coding-plan China endpoint from pi-ai.',\n  'zai-coding-global': 'Zhipu GLM coding-plan international endpoint.',\n  'zhipu-coding-cn': 'Zhipu GLM coding-plan China endpoint.',\n  minimax: 'MiniMax text models; Anthropic-compatible endpoint is preferred for agent workflows.',\n  'minimax-cn': 'MiniMax China endpoint for domestic access.',\n  'openai-codex': 'OpenAI Codex models through OAuth.',\n  'google-gemini-cli': 'Gemini through Google Cloud Code Assist OAuth.',\n  'google-antigravity': 'Gemini/Antigravity OAuth model access.',\n};\n\nconst RECOMMENDED_MODEL_PATTERNS: Record<string, RegExp[]> = {\n  openai: [/^gpt-5\\.6$/i, /^gpt-5\\.6-sol$/i, /^gpt-5\\.6-terra$/i, /^gpt-5\\.6-luna$/i, /^gpt-5\\.5$/i, /^gpt-5\\.5-pro$/i],\n  'openai-codex': [/^gpt-5\\.6-sol$/i, /^gpt-5\\.6-terra$/i, /^gpt-5\\.6-luna$/i, /^gpt-5\\.5$/i],\n  anthropic: [/^claude-sonnet-5$/i, /^claude-opus-4-8$/i, /^claude-fable-5$/i, /^claude-sonnet-4-6$/i, /^claude-sonnet-4-5$/i],\n  google: [/^gemini-3\\.5-flash$/i, /^gemini-3\\.1-pro-preview$/i, /^gemini-3-flash-preview$/i, /^gemini-3-pro-preview$/i],\n  'google-vertex': [/^gemini-3\\.5-flash$/i, /^gemini-3\\.1-pro-preview$/i, /^gemini-3-flash-preview$/i, /^gemini-3-pro-preview$/i],\n  xai: [/^grok-4/i, /^grok-3/i, /^grok-code/i],\n  dashscope: [/^qwen3\\.7-plus$/i, /^qwen3\\.7-max$/i, /^qwen3\\.6-flash$/i],\n  'dashscope-cn': [/^qwen3\\.7-plus$/i, /^qwen3\\.7-max$/i, /^qwen3\\.6-flash$/i],\n  'dashscope-intl': [/^qwen3\\.7-plus$/i, /^qwen3\\.7-max$/i, /^qwen3\\.6-flash$/i],\n  'volcengine-ark': [/^ep-your-endpoint-id$/i],\n  'volcengine-plan': [/^ark-code-latest$/i, /^doubao-seed-2\\.0-code$/i, /^doubao-seed-2\\.0-pro$/i],\n  'byteplus-plan': [/^ark-code-latest$/i, /^doubao-seed-2\\.0-code$/i, /^doubao-seed-2\\.0-pro$/i],\n  deepseek: [/^deepseek-v4-flash$/i, /^deepseek-v4-pro$/i],\n  openrouter: [/^openai\\/gpt-5/i, /^anthropic\\/claude-sonnet-4/i, /^google\\/gemini-3/i],\n  moonshotai: [/^kimi-k2\\.7-code$/i, /^kimi-k2\\.6$/i],\n  'moonshotai-cn': [/^kimi-k2\\.7-code$/i, /^kimi-k2\\.6$/i],\n  'kimi-coding': [/^k2p7$/i, /^kimi-for-coding$/i],\n  stepfun: [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-cn': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-intl': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-plan': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-plan-cn': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  'stepfun-plan-intl': [/^step-3\\.7-flash$/i, /^step-3\\.5-flash-2603$/i, /^step-3\\.5-flash$/i],\n  xiaomi: [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'xiaomi-token-plan-cn': [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'xiaomi-token-plan-ams': [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'xiaomi-token-plan-sgp': [/^mimo-v2\\.5-pro$/i, /^mimo-v2\\.5-pro-ultraspeed$/i, /^mimo-v2\\.5$/i],\n  'ant-ling': [/^Ling-2\\.6-1T$/i, /^Ling-2\\.6-flash$/i, /^Ring-2\\.6-1T$/i],\n  'zhipu-cn': [/^glm-5\\.2$/i],\n  zai: [/^glm-5\\.2$/i],\n  'zai-coding-cn': [/^glm-5\\.2$/i, /^glm-5\\.1$/i, /^glm-5-turbo$/i],\n  'zai-coding-global': [/^glm-5\\.2$/i],\n  'zhipu-coding-cn': [/^glm-5\\.2$/i],\n  minimax: [/^MiniMax-M3$/i, /^MiniMax-M2\\.7-highspeed$/i, /^MiniMax-M2\\.7$/i],\n  'minimax-cn': [/^MiniMax-M3$/i, /^MiniMax-M2\\.7-highspeed$/i, /^MiniMax-M2\\.7$/i],\n};\n\nfunction modelRef(model: Pick<Model<Api>, 'provider' | 'id'>): string {\n  return `${model.provider}/${model.id}`;\n}\n\nfunction recommendedRank(provider: string, modelId: string): number {\n  const patterns = RECOMMENDED_MODEL_PATTERNS[provider] ?? [];\n  const idx = patterns.findIndex((pattern) => pattern.test(modelId));\n  return idx === -1 ? Number.POSITIVE_INFINITY : idx;\n}\n\nexport function isRecommendedModel(provider: string, modelId: string): boolean {\n  return Number.isFinite(recommendedRank(provider, modelId));\n}\n\nexport function modelToCatalogView(model: Model<Api>): ModelCatalogView {\n  const input = (model.input ?? ['text']) as Array<'text' | 'image'>;\n  return {\n    ref: modelRef(model),\n    provider: model.provider,\n    id: model.id,\n    name: model.name || model.id,\n    reasoning: model.reasoning ?? false,\n    input,\n    ...(model.contextWindow ? { contextWindow: model.contextWindow } : {}),\n    ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),\n    vision: input.includes('image'),\n    recommended: isRecommendedModel(model.provider, model.id),\n  };\n}\n\nfunction presetModelToCatalogView(provider: string, model: DomesticProviderModelPreset): ModelCatalogView {\n  const input = model.input ?? ['text'];\n  return {\n    ref: `${provider}/${model.id}`,\n    provider,\n    id: model.id,\n    name: model.name || model.id,\n    reasoning: model.reasoning ?? false,\n    input,\n    ...(model.contextWindow ? { contextWindow: model.contextWindow } : {}),\n    ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),\n    vision: input.includes('image'),\n    recommended: isRecommendedModel(provider, model.id),\n  };\n}\n\nexport function sortModelsForPicker(models: readonly Model<Api>[]): Model<Api>[] {\n  return [...models].sort((a, b) => {\n    const aRank = recommendedRank(a.provider, a.id);\n    const bRank = recommendedRank(b.provider, b.id);\n    if (aRank !== bRank) return aRank - bRank;\n    if (a.provider !== b.provider) return a.provider.localeCompare(b.provider);\n    return (a.name || a.id).localeCompare(b.name || b.id, undefined, { sensitivity: 'base' });\n  });\n}\n\nexport function getRecommendedModelsForProvider(provider: string, limit = 4): ModelCatalogView[] {\n  const models = sortModelsForPicker(getModelsByProvider(provider));\n  const fromRegistry = models\n    .filter((model) => isRecommendedModel(provider, model.id))\n    .slice(0, limit)\n    .map(modelToCatalogView);\n  if (fromRegistry.length > 0) return fromRegistry;\n\n  const preset = getDomesticProviderPreset(provider);\n  if (!preset) return [];\n  return preset.models\n    .filter((model) => isRecommendedModel(provider, model.id))\n    .slice(0, limit)\n    .map((model) => presetModelToCatalogView(provider, model));\n}\n\nexport function getProviderHint(provider: string): string | undefined {\n  return PROVIDER_HINTS[provider];\n}\n\nexport function getOnboardingFeaturedProviders(): string[] {\n  const providers = new Set([...getAllProviders(), ...getDomesticProviderPresetIds()]);\n  return FEATURED_PROVIDER_ORDER.filter((provider) => providers.has(provider));\n}\n\nexport function sortProvidersForPicker(providers: readonly string[]): string[] {\n  const featuredRank = new Map(FEATURED_PROVIDER_ORDER.map((provider, index) => [provider, index] as const));\n  return [...providers].sort((a, b) => {\n    const aRank = featuredRank.get(a) ?? Number.POSITIVE_INFINITY;\n    const bRank = featuredRank.get(b) ?? Number.POSITIVE_INFINITY;\n    if (aRank !== bRank) return aRank - bRank;\n    const catA = PROVIDER_META[a]?.category ?? 'specialty';\n    const catB = PROVIDER_META[b]?.category ?? 'specialty';\n    const catOrder: Record<ProviderCategory, number> = {\n      common: 0,\n      domestic: 1,\n      specialty: 2,\n      enterprise: 3,\n      oauth: 4,\n      extension: 5,\n    };\n    if (catOrder[catA] !== catOrder[catB]) return catOrder[catA] - catOrder[catB];\n    return getProviderDisplayName(a).localeCompare(getProviderDisplayName(b), undefined, { sensitivity: 'base' });\n  });\n}\n\nexport async function getProviderCatalogViews(): Promise<ProviderCatalogView[]> {\n  const pluginRegistry = getProviderRegistry();\n  const providers = sortProvidersForPicker([...new Set([...getAllProviders(), ...getDomesticProviderPresetIds()])]);\n  const modelCounts = new Map<string, number>();\n  for (const model of getAllModels()) {\n    modelCounts.set(model.provider, (modelCounts.get(model.provider) ?? 0) + 1);\n  }\n\n  return Promise.all(\n    providers.map(async (provider) => {\n      const plugin = pluginRegistry.get(provider);\n      const meta = PROVIDER_META[provider];\n      const domesticPreset = getDomesticProviderPreset(provider);\n      return {\n        id: provider,\n        name: plugin?.name ?? domesticPreset?.displayName ?? getProviderDisplayName(provider),\n        category: plugin ? 'extension' : (meta?.category ?? (domesticPreset ? 'domestic' : 'specialty')),\n        supportsOAuth: plugin ? false : (meta?.supportsOAuth ?? false),\n        supportsApiKey: plugin ? false : (meta?.supportsApiKey ?? true),\n        configured: plugin ? true : await isProviderConfigured(provider),\n        onboardingFeatured: FEATURED_PROVIDER_ORDER.includes(provider),\n        recommendedModels: getRecommendedModelsForProvider(provider),\n        modelCount: modelCounts.get(provider) ?? 0,\n        ...(getProviderHint(provider) ? { hint: getProviderHint(provider) } : {}),\n      };\n    }),\n  );\n}\n"],"mappings":"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"}

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

@@ -12,6 +12,7 @@ export { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckp
 export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } from './notes-repository.js';
 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, getMemoryProviderState, getMemoryRecord, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemorySignalRowPayload, type MemoryTraceFeedback, type MemoryTraceEventPayload, type SearchMemoryRecordsOptions, type SetMemoryTraceFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-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 { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';
 export { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent, } from './activity-repository.js';

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

@@ -13,7 +13,8 @@ import { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckp
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
 import { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex } from "./memory-index-repository.js";
-import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord } from "./memory-records-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 { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "./config-repository.js";
 import { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "./activity-repository.js";
-export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, createObjectLinkRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionKeyBySessionId, getActivityEventRecord, getCompactionCheckpointDetail, getCurrentSessionId, getGlobalSessionStats, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCompactionCheckpoints, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, summarizeMemoryRecallFeedback, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, 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, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, createObjectLinkRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, finishKnowledgeSyncRun, getActivityEventRecord, getCompactionCheckpointDetail, getCurrentSessionId, getGlobalSessionStats, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCompactionCheckpoints, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

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

@@ -0,0 +1,50 @@
+import type { KnowledgeSourceItem, KnowledgeSourceItemInput, KnowledgeSyncRun, KnowledgeSyncRunStatus, KnowledgeSynthesisStatus } from '../../knowledge/types.js';
+import type { MemoryEvidence, MemoryEvidenceRelation } from '../../agent/memory/types.js';
+export declare function startKnowledgeSyncRun(input: {
+    sourceInstanceId: string;
+    cursorBefore?: string;
+    nowMs?: number;
+}): KnowledgeSyncRun;
+export declare function finishKnowledgeSyncRun(input: {
+    runId: string;
+    status: Exclude<KnowledgeSyncRunStatus, 'running'>;
+    cursorAfter?: string;
+    itemsSeen?: number;
+    itemsCreated?: number;
+    itemsUpdated?: number;
+    warnings?: string[];
+    error?: string;
+    nowMs?: number;
+}): KnowledgeSyncRun;
+export declare function listKnowledgeSyncRuns(options?: {
+    sourceInstanceId?: string;
+    status?: KnowledgeSyncRunStatus;
+    limit?: number;
+}): KnowledgeSyncRun[];
+export declare function getKnowledgeSourceCursor(sourceInstanceId: string): string | undefined;
+export declare function setKnowledgeSourceCursor(sourceInstanceId: string, cursor: string | undefined): void;
+export declare function upsertKnowledgeSourceItems(inputs: KnowledgeSourceItemInput[], nowMs?: number): {
+    items: KnowledgeSourceItem[];
+    created: number;
+    updated: number;
+    unchanged: number;
+};
+export declare function getKnowledgeSourceItem(itemId: string): KnowledgeSourceItem | null;
+export declare function listKnowledgeSourceItems(options?: {
+    sourceInstanceId?: string;
+    synthesisStatus?: KnowledgeSynthesisStatus;
+    includeDeleted?: boolean;
+    limit?: number;
+    offset?: number;
+}): KnowledgeSourceItem[];
+export declare function setKnowledgeSourceItemSynthesisStatus(itemIds: string[], status: KnowledgeSynthesisStatus, nowMs?: number): number;
+export declare function attachMemoryEvidence(input: {
+    recordId: string;
+    sourceItemId?: string;
+    relation?: MemoryEvidenceRelation;
+    excerpt?: string;
+    confidence?: number;
+    observedAt?: string;
+    nowMs?: number;
+}): MemoryEvidence;
+export declare function listMemoryEvidence(recordId: string): MemoryEvidence[];

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

@@ -0,0 +1,237 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/knowledge-repository.ts
+function parseTimestamp(value) {
+	if (!value) return null;
+	const parsed = Date.parse(value);
+	return Number.isFinite(parsed) ? parsed : null;
+}
+function timestampToIso(value) {
+	return value == null ? void 0 : new Date(value).toISOString();
+}
+function parseRecord(json) {
+	try {
+		const parsed = JSON.parse(json);
+		return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+function parseStrings(json) {
+	try {
+		const parsed = JSON.parse(json);
+		return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
+	} catch {
+		return [];
+	}
+}
+function sourceItemFromRow(row) {
+	return {
+		id: row.item_id,
+		sourceInstanceId: row.source_instance_id,
+		externalId: row.external_id,
+		itemType: row.item_type,
+		...row.author_role ? { authorRole: row.author_role } : {},
+		...timestampToIso(row.occurred_at) ? { occurredAt: timestampToIso(row.occurred_at) } : {},
+		...timestampToIso(row.source_updated_at) ? { sourceUpdatedAt: timestampToIso(row.source_updated_at) } : {},
+		contentHash: row.content_hash,
+		...row.normalized_text ? { normalizedText: row.normalized_text } : {},
+		...row.payload_ref ? { payloadRef: row.payload_ref } : {},
+		metadata: parseRecord(row.metadata_json),
+		sensitivity: row.sensitivity,
+		retentionClass: row.retention_class,
+		synthesisStatus: row.synthesis_status,
+		...timestampToIso(row.deleted_at) ? { deletedAt: timestampToIso(row.deleted_at) } : {},
+		createdAt: new Date(row.created_at).toISOString(),
+		updatedAt: new Date(row.updated_at).toISOString()
+	};
+}
+function syncRunFromRow(row) {
+	return {
+		id: row.run_id,
+		sourceInstanceId: row.source_instance_id,
+		status: row.status,
+		...row.cursor_before ? { cursorBefore: row.cursor_before } : {},
+		...row.cursor_after ? { cursorAfter: row.cursor_after } : {},
+		itemsSeen: row.items_seen,
+		itemsCreated: row.items_created,
+		itemsUpdated: row.items_updated,
+		warnings: parseStrings(row.warnings_json),
+		...row.error ? { error: row.error } : {},
+		startedAt: new Date(row.started_at).toISOString(),
+		...timestampToIso(row.finished_at) ? { finishedAt: timestampToIso(row.finished_at) } : {}
+	};
+}
+function startKnowledgeSyncRun(input) {
+	const id = randomUUID();
+	const now = input.nowMs ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO knowledge_sync_runs (
+        run_id, source_instance_id, status, cursor_before, started_at
+      ) VALUES (?, ?, 'running', ?, ?)`).run(id, input.sourceInstanceId, input.cursorBefore ?? null, now);
+	});
+	return {
+		id,
+		sourceInstanceId: input.sourceInstanceId,
+		status: "running",
+		...input.cursorBefore ? { cursorBefore: input.cursorBefore } : {},
+		itemsSeen: 0,
+		itemsCreated: 0,
+		itemsUpdated: 0,
+		warnings: [],
+		startedAt: new Date(now).toISOString()
+	};
+}
+function finishKnowledgeSyncRun(input) {
+	const now = input.nowMs ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE knowledge_sync_runs SET
+        status = ?, cursor_after = ?, items_seen = ?, items_created = ?,
+        items_updated = ?, warnings_json = ?, error = ?, finished_at = ?
+       WHERE run_id = ?`).run(input.status, input.cursorAfter ?? null, input.itemsSeen ?? 0, input.itemsCreated ?? 0, input.itemsUpdated ?? 0, JSON.stringify(input.warnings ?? []), input.error ?? null, now, input.runId);
+	});
+	const row = getSqliteDatabase().prepare(`SELECT * FROM knowledge_sync_runs WHERE run_id = ?`).get(input.runId);
+	if (!row) throw new Error(`Knowledge sync run not found: ${input.runId}`);
+	return syncRunFromRow(row);
+}
+function listKnowledgeSyncRuns(options = {}) {
+	const where = [];
+	const params = [];
+	if (options.sourceInstanceId) {
+		where.push("source_instance_id = ?");
+		params.push(options.sourceInstanceId);
+	}
+	if (options.status) {
+		where.push("status = ?");
+		params.push(options.status);
+	}
+	const limit = Math.max(1, Math.min(500, options.limit ?? 100));
+	return getSqliteDatabase().prepare(`SELECT * FROM knowledge_sync_runs
+       ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
+       ORDER BY started_at DESC LIMIT ?`).all(...params, limit).map(syncRunFromRow);
+}
+function getKnowledgeSourceCursor(sourceInstanceId) {
+	return getSqliteDatabase().prepare(`SELECT cursor FROM knowledge_source_state WHERE source_instance_id = ?`).get(sourceInstanceId)?.cursor ?? void 0;
+}
+function setKnowledgeSourceCursor(sourceInstanceId, cursor) {
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO knowledge_source_state (source_instance_id, cursor, updated_at)
+       VALUES (?, ?, ?)
+       ON CONFLICT(source_instance_id) DO UPDATE SET
+         cursor = excluded.cursor,
+         updated_at = excluded.updated_at`).run(sourceInstanceId, cursor ?? null, Date.now());
+	});
+}
+function upsertKnowledgeSourceItems(inputs, nowMs = Date.now()) {
+	return runSqliteWriteTransaction((db) => {
+		const items = [];
+		let created = 0;
+		let updated = 0;
+		let unchanged = 0;
+		for (const input of inputs) {
+			const existing = db.prepare(`SELECT * FROM knowledge_source_items
+         WHERE source_instance_id = ? AND external_id = ?`).get(input.sourceInstanceId, input.externalId);
+			const id = existing?.item_id ?? input.id ?? randomUUID();
+			if (existing?.content_hash === input.contentHash && existing.deleted_at === parseTimestamp(input.deletedAt)) {
+				unchanged += 1;
+				items.push(sourceItemFromRow(existing));
+				continue;
+			}
+			db.prepare(`INSERT INTO knowledge_source_items (
+          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 (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(source_instance_id, external_id) DO UPDATE SET
+          item_type = excluded.item_type,
+          author_role = excluded.author_role,
+          occurred_at = excluded.occurred_at,
+          source_updated_at = excluded.source_updated_at,
+          content_hash = excluded.content_hash,
+          normalized_text = excluded.normalized_text,
+          payload_ref = excluded.payload_ref,
+          metadata_json = excluded.metadata_json,
+          sensitivity = excluded.sensitivity,
+          retention_class = excluded.retention_class,
+          synthesis_status = excluded.synthesis_status,
+          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);
+			const row = db.prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ?`).get(id);
+			items.push(sourceItemFromRow(row));
+			if (existing) updated += 1;
+			else created += 1;
+		}
+		return {
+			items,
+			created,
+			updated,
+			unchanged
+		};
+	});
+}
+function getKnowledgeSourceItem(itemId) {
+	const row = getSqliteDatabase().prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ?`).get(itemId);
+	return row ? sourceItemFromRow(row) : null;
+}
+function listKnowledgeSourceItems(options = {}) {
+	const where = [];
+	const params = [];
+	if (options.sourceInstanceId) {
+		where.push("source_instance_id = ?");
+		params.push(options.sourceInstanceId);
+	}
+	if (options.synthesisStatus) {
+		where.push("synthesis_status = ?");
+		params.push(options.synthesisStatus);
+	}
+	if (!options.includeDeleted) where.push("deleted_at IS NULL");
+	const limit = Math.max(1, Math.min(500, options.limit ?? 100));
+	const offset = Math.max(0, options.offset ?? 0);
+	return getSqliteDatabase().prepare(`SELECT * FROM knowledge_source_items
+       ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
+       ORDER BY COALESCE(source_updated_at, occurred_at, updated_at) DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map(sourceItemFromRow);
+}
+function setKnowledgeSourceItemSynthesisStatus(itemIds, status, nowMs = Date.now()) {
+	if (itemIds.length === 0) return 0;
+	return runSqliteWriteTransaction((db) => {
+		const placeholders = itemIds.map(() => "?").join(", ");
+		const result = db.prepare(`UPDATE knowledge_source_items SET synthesis_status = ?, updated_at = ?
+       WHERE item_id IN (${placeholders})`).run(status, nowMs, ...itemIds);
+		return Number(result.changes);
+	});
+}
+function attachMemoryEvidence(input) {
+	const 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);
+	});
+	return {
+		evidenceId,
+		...input.sourceItemId ? { sourceItemId: input.sourceItemId } : {},
+		relation: input.relation ?? "supports",
+		...input.excerpt ? { sourceText: input.excerpt } : {},
+		...input.confidence != null ? { confidence: input.confidence } : {},
+		...observedAt != null ? { observedAt: new Date(observedAt).toISOString() } : {}
+	};
+}
+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,
+		...row.source_item_id ? { sourceItemId: row.source_item_id } : {},
+		relation: row.relation,
+		...row.excerpt ? { sourceText: row.excerpt } : {},
+		...row.confidence != null ? { confidence: row.confidence } : {},
+		...timestampToIso(row.observed_at) ? { observedAt: timestampToIso(row.observed_at) } : {}
+	}));
+}
+//#endregion
+export { attachMemoryEvidence, finishKnowledgeSyncRun, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems };
+
+//# sourceMappingURL=knowledge-repository.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-repository.js","names":[],"sources":["../../../../src/storage/sqlite/knowledge-repository.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type {\n  KnowledgeSourceItem,\n  KnowledgeSourceItemInput,\n  KnowledgeSyncRun,\n  KnowledgeSyncRunStatus,\n  KnowledgeSynthesisStatus,\n} from '../../knowledge/types.js';\nimport type { MemoryEvidence, MemoryEvidenceRelation } from '../../agent/memory/types.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\ntype KnowledgeSourceItemRow = {\n  item_id: string;\n  source_instance_id: string;\n  external_id: string;\n  item_type: string;\n  author_role: string | null;\n  occurred_at: number | null;\n  source_updated_at: number | null;\n  content_hash: string;\n  normalized_text: string | null;\n  payload_ref: string | null;\n  metadata_json: string;\n  sensitivity: string;\n  retention_class: string;\n  synthesis_status: string;\n  deleted_at: number | null;\n  created_at: number;\n  updated_at: number;\n};\n\ntype KnowledgeSyncRunRow = {\n  run_id: string;\n  source_instance_id: string;\n  status: string;\n  cursor_before: string | null;\n  cursor_after: string | null;\n  items_seen: number;\n  items_created: number;\n  items_updated: number;\n  warnings_json: string;\n  error: string | null;\n  started_at: number;\n  finished_at: number | null;\n};\n\ntype MemoryEvidenceRow = {\n  evidence_id: string;\n  record_id: string;\n  source_item_id: string | null;\n  relation: string;\n  excerpt: string | null;\n  confidence: number | null;\n  observed_at: number | null;\n  created_at: number;\n};\n\nfunction parseTimestamp(value: string | undefined): number | null {\n  if (!value) return null;\n  const parsed = Date.parse(value);\n  return Number.isFinite(parsed) ? parsed : null;\n}\n\nfunction timestampToIso(value: number | null): string | undefined {\n  return value == null ? undefined : new Date(value).toISOString();\n}\n\nfunction parseRecord(json: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(json) as unknown;\n    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)\n      ? parsed as Record<string, unknown>\n      : {};\n  } catch {\n    return {};\n  }\n}\n\nfunction parseStrings(json: string): string[] {\n  try {\n    const parsed = JSON.parse(json) as unknown;\n    return Array.isArray(parsed) ? parsed.filter((item): item is string => typeof item === 'string') : [];\n  } catch {\n    return [];\n  }\n}\n\nfunction sourceItemFromRow(row: KnowledgeSourceItemRow): KnowledgeSourceItem {\n  return {\n    id: row.item_id,\n    sourceInstanceId: row.source_instance_id,\n    externalId: row.external_id,\n    itemType: row.item_type,\n    ...(row.author_role ? { authorRole: row.author_role as KnowledgeSourceItem['authorRole'] } : {}),\n    ...(timestampToIso(row.occurred_at) ? { occurredAt: timestampToIso(row.occurred_at) } : {}),\n    ...(timestampToIso(row.source_updated_at) ? { sourceUpdatedAt: timestampToIso(row.source_updated_at) } : {}),\n    contentHash: row.content_hash,\n    ...(row.normalized_text ? { normalizedText: row.normalized_text } : {}),\n    ...(row.payload_ref ? { payloadRef: row.payload_ref } : {}),\n    metadata: parseRecord(row.metadata_json),\n    sensitivity: row.sensitivity as KnowledgeSourceItem['sensitivity'],\n    retentionClass: row.retention_class as KnowledgeSourceItem['retentionClass'],\n    synthesisStatus: row.synthesis_status as KnowledgeSourceItem['synthesisStatus'],\n    ...(timestampToIso(row.deleted_at) ? { deletedAt: timestampToIso(row.deleted_at) } : {}),\n    createdAt: new Date(row.created_at).toISOString(),\n    updatedAt: new Date(row.updated_at).toISOString(),\n  };\n}\n\nfunction syncRunFromRow(row: KnowledgeSyncRunRow): KnowledgeSyncRun {\n  return {\n    id: row.run_id,\n    sourceInstanceId: row.source_instance_id,\n    status: row.status as KnowledgeSyncRunStatus,\n    ...(row.cursor_before ? { cursorBefore: row.cursor_before } : {}),\n    ...(row.cursor_after ? { cursorAfter: row.cursor_after } : {}),\n    itemsSeen: row.items_seen,\n    itemsCreated: row.items_created,\n    itemsUpdated: row.items_updated,\n    warnings: parseStrings(row.warnings_json),\n    ...(row.error ? { error: row.error } : {}),\n    startedAt: new Date(row.started_at).toISOString(),\n    ...(timestampToIso(row.finished_at) ? { finishedAt: timestampToIso(row.finished_at) } : {}),\n  };\n}\n\nexport function startKnowledgeSyncRun(input: {\n  sourceInstanceId: string;\n  cursorBefore?: string;\n  nowMs?: number;\n}): KnowledgeSyncRun {\n  const id = randomUUID();\n  const now = input.nowMs ?? Date.now();\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO knowledge_sync_runs (\n        run_id, source_instance_id, status, cursor_before, started_at\n      ) VALUES (?, ?, 'running', ?, ?)`,\n    ).run(id, input.sourceInstanceId, input.cursorBefore ?? null, now);\n  });\n  return {\n    id,\n    sourceInstanceId: input.sourceInstanceId,\n    status: 'running',\n    ...(input.cursorBefore ? { cursorBefore: input.cursorBefore } : {}),\n    itemsSeen: 0,\n    itemsCreated: 0,\n    itemsUpdated: 0,\n    warnings: [],\n    startedAt: new Date(now).toISOString(),\n  };\n}\n\nexport function finishKnowledgeSyncRun(input: {\n  runId: string;\n  status: Exclude<KnowledgeSyncRunStatus, 'running'>;\n  cursorAfter?: string;\n  itemsSeen?: number;\n  itemsCreated?: number;\n  itemsUpdated?: number;\n  warnings?: string[];\n  error?: string;\n  nowMs?: number;\n}): KnowledgeSyncRun {\n  const now = input.nowMs ?? Date.now();\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `UPDATE knowledge_sync_runs SET\n        status = ?, cursor_after = ?, items_seen = ?, items_created = ?,\n        items_updated = ?, warnings_json = ?, error = ?, finished_at = ?\n       WHERE run_id = ?`,\n    ).run(\n      input.status,\n      input.cursorAfter ?? null,\n      input.itemsSeen ?? 0,\n      input.itemsCreated ?? 0,\n      input.itemsUpdated ?? 0,\n      JSON.stringify(input.warnings ?? []),\n      input.error ?? null,\n      now,\n      input.runId,\n    );\n  });\n  const row = getSqliteDatabase()\n    .prepare(`SELECT * FROM knowledge_sync_runs WHERE run_id = ?`)\n    .get(input.runId) as KnowledgeSyncRunRow | undefined;\n  if (!row) throw new Error(`Knowledge sync run not found: ${input.runId}`);\n  return syncRunFromRow(row);\n}\n\nexport function listKnowledgeSyncRuns(options: {\n  sourceInstanceId?: string;\n  status?: KnowledgeSyncRunStatus;\n  limit?: number;\n} = {}): KnowledgeSyncRun[] {\n  const where: string[] = [];\n  const params: Array<string | number> = [];\n  if (options.sourceInstanceId) {\n    where.push('source_instance_id = ?');\n    params.push(options.sourceInstanceId);\n  }\n  if (options.status) {\n    where.push('status = ?');\n    params.push(options.status);\n  }\n  const limit = Math.max(1, Math.min(500, options.limit ?? 100));\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT * FROM knowledge_sync_runs\n       ${where.length > 0 ? `WHERE ${where.join(' AND ')}` : ''}\n       ORDER BY started_at DESC LIMIT ?`,\n    )\n    .all(...params, limit) as KnowledgeSyncRunRow[];\n  return rows.map(syncRunFromRow);\n}\n\nexport function getKnowledgeSourceCursor(sourceInstanceId: string): string | undefined {\n  const row = getSqliteDatabase()\n    .prepare(`SELECT cursor FROM knowledge_source_state WHERE source_instance_id = ?`)\n    .get(sourceInstanceId) as { cursor: string | null } | undefined;\n  return row?.cursor ?? undefined;\n}\n\nexport function setKnowledgeSourceCursor(sourceInstanceId: string, cursor: string | undefined): void {\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO knowledge_source_state (source_instance_id, cursor, updated_at)\n       VALUES (?, ?, ?)\n       ON CONFLICT(source_instance_id) DO UPDATE SET\n         cursor = excluded.cursor,\n         updated_at = excluded.updated_at`,\n    ).run(sourceInstanceId, cursor ?? null, Date.now());\n  });\n}\n\nexport function upsertKnowledgeSourceItems(\n  inputs: KnowledgeSourceItemInput[],\n  nowMs = Date.now(),\n): { items: KnowledgeSourceItem[]; created: number; updated: number; unchanged: number } {\n  return runSqliteWriteTransaction((db) => {\n    const items: KnowledgeSourceItem[] = [];\n    let created = 0;\n    let updated = 0;\n    let unchanged = 0;\n    for (const input of inputs) {\n      const existing = db.prepare(\n        `SELECT * FROM knowledge_source_items\n         WHERE source_instance_id = ? AND external_id = ?`,\n      ).get(input.sourceInstanceId, input.externalId) as KnowledgeSourceItemRow | undefined;\n      const id = existing?.item_id ?? input.id ?? randomUUID();\n      if (existing?.content_hash === input.contentHash && existing.deleted_at === parseTimestamp(input.deletedAt)) {\n        unchanged += 1;\n        items.push(sourceItemFromRow(existing));\n        continue;\n      }\n      db.prepare(\n        `INSERT INTO knowledge_source_items (\n          item_id, source_instance_id, external_id, item_type, author_role,\n          occurred_at, source_updated_at, content_hash, normalized_text,\n          payload_ref, metadata_json, sensitivity, retention_class,\n          synthesis_status, deleted_at, created_at, updated_at\n        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n        ON CONFLICT(source_instance_id, external_id) DO UPDATE SET\n          item_type = excluded.item_type,\n          author_role = excluded.author_role,\n          occurred_at = excluded.occurred_at,\n          source_updated_at = excluded.source_updated_at,\n          content_hash = excluded.content_hash,\n          normalized_text = excluded.normalized_text,\n          payload_ref = excluded.payload_ref,\n          metadata_json = excluded.metadata_json,\n          sensitivity = excluded.sensitivity,\n          retention_class = excluded.retention_class,\n          synthesis_status = excluded.synthesis_status,\n          deleted_at = excluded.deleted_at,\n          updated_at = excluded.updated_at`,\n      ).run(\n        id,\n        input.sourceInstanceId,\n        input.externalId,\n        input.itemType,\n        input.authorRole ?? null,\n        parseTimestamp(input.occurredAt),\n        parseTimestamp(input.sourceUpdatedAt),\n        input.contentHash,\n        input.normalizedText ?? null,\n        input.payloadRef ?? null,\n        JSON.stringify(input.metadata ?? {}),\n        input.sensitivity ?? 'normal',\n        input.retentionClass ?? 'bounded',\n        input.synthesisStatus ?? 'pending',\n        parseTimestamp(input.deletedAt),\n        existing?.created_at ?? nowMs,\n        nowMs,\n      );\n      const row = db.prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ?`).get(id) as KnowledgeSourceItemRow;\n      items.push(sourceItemFromRow(row));\n      if (existing) updated += 1;\n      else created += 1;\n    }\n    return { items, created, updated, unchanged };\n  });\n}\n\nexport function getKnowledgeSourceItem(itemId: string): KnowledgeSourceItem | null {\n  const row = getSqliteDatabase()\n    .prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ?`)\n    .get(itemId) as KnowledgeSourceItemRow | undefined;\n  return row ? sourceItemFromRow(row) : null;\n}\n\nexport function listKnowledgeSourceItems(options: {\n  sourceInstanceId?: string;\n  synthesisStatus?: KnowledgeSynthesisStatus;\n  includeDeleted?: boolean;\n  limit?: number;\n  offset?: number;\n} = {}): KnowledgeSourceItem[] {\n  const where: string[] = [];\n  const params: Array<string | number> = [];\n  if (options.sourceInstanceId) {\n    where.push('source_instance_id = ?');\n    params.push(options.sourceInstanceId);\n  }\n  if (options.synthesisStatus) {\n    where.push('synthesis_status = ?');\n    params.push(options.synthesisStatus);\n  }\n  if (!options.includeDeleted) where.push('deleted_at IS NULL');\n  const limit = Math.max(1, Math.min(500, options.limit ?? 100));\n  const offset = Math.max(0, options.offset ?? 0);\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT * FROM knowledge_source_items\n       ${where.length > 0 ? `WHERE ${where.join(' AND ')}` : ''}\n       ORDER BY COALESCE(source_updated_at, occurred_at, updated_at) DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset) as KnowledgeSourceItemRow[];\n  return rows.map(sourceItemFromRow);\n}\n\nexport function setKnowledgeSourceItemSynthesisStatus(\n  itemIds: string[],\n  status: KnowledgeSynthesisStatus,\n  nowMs = Date.now(),\n): number {\n  if (itemIds.length === 0) return 0;\n  return runSqliteWriteTransaction((db) => {\n    const placeholders = itemIds.map(() => '?').join(', ');\n    const result = db.prepare(\n      `UPDATE knowledge_source_items SET synthesis_status = ?, updated_at = ?\n       WHERE item_id IN (${placeholders})`,\n    ).run(status, nowMs, ...itemIds);\n    return Number(result.changes);\n  });\n}\n\nexport function attachMemoryEvidence(input: {\n  recordId: string;\n  sourceItemId?: string;\n  relation?: MemoryEvidenceRelation;\n  excerpt?: string;\n  confidence?: number;\n  observedAt?: string;\n  nowMs?: number;\n}): MemoryEvidence {\n  const evidenceId = randomUUID();\n  const now = input.nowMs ?? Date.now();\n  const observedAt = parseTimestamp(input.observedAt);\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO memory_evidence (\n        evidence_id, record_id, source_item_id, relation, excerpt,\n        confidence, observed_at, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      evidenceId,\n      input.recordId,\n      input.sourceItemId ?? null,\n      input.relation ?? 'supports',\n      input.excerpt ?? null,\n      input.confidence ?? null,\n      observedAt,\n      now,\n    );\n  });\n  return {\n    evidenceId,\n    ...(input.sourceItemId ? { sourceItemId: input.sourceItemId } : {}),\n    relation: input.relation ?? 'supports',\n    ...(input.excerpt ? { sourceText: input.excerpt } : {}),\n    ...(input.confidence != null ? { confidence: input.confidence } : {}),\n    ...(observedAt != null ? { observedAt: new Date(observedAt).toISOString() } : {}),\n  };\n}\n\nexport function listMemoryEvidence(recordId: string): MemoryEvidence[] {\n  const rows = getSqliteDatabase()\n    .prepare(`SELECT * FROM memory_evidence WHERE record_id = ? ORDER BY created_at ASC`)\n    .all(recordId) as MemoryEvidenceRow[];\n  return rows.map((row) => ({\n    evidenceId: row.evidence_id,\n    ...(row.source_item_id ? { sourceItemId: row.source_item_id } : {}),\n    relation: row.relation as MemoryEvidenceRelation,\n    ...(row.excerpt ? { sourceText: row.excerpt } : {}),\n    ...(row.confidence != null ? { confidence: row.confidence } : {}),\n    ...(timestampToIso(row.observed_at) ? { observedAt: timestampToIso(row.observed_at) } : {}),\n  }));\n}\n"],"mappings":";;;AA0DA,SAAS,eAAe,OAA0C;AAChE,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,SAAS,KAAK,MAAM,MAAM;AAChC,QAAO,OAAO,SAAS,OAAO,GAAG,SAAS;;AAG5C,SAAS,eAAe,OAA0C;AAChE,QAAO,SAAS,OAAO,KAAA,IAAY,IAAI,KAAK,MAAM,CAAC,aAAa;;AAGlE,SAAS,YAAY,MAAuC;AAC1D,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,SAAO,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,GACjE,SACA,EAAE;SACA;AACN,SAAO,EAAE;;;AAIb,SAAS,aAAa,MAAwB;AAC5C,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,SAAO,MAAM,QAAQ,OAAO,GAAG,OAAO,QAAQ,SAAyB,OAAO,SAAS,SAAS,GAAG,EAAE;SAC/F;AACN,SAAO,EAAE;;;AAIb,SAAS,kBAAkB,KAAkD;AAC3E,QAAO;EACL,IAAI,IAAI;EACR,kBAAkB,IAAI;EACtB,YAAY,IAAI;EAChB,UAAU,IAAI;EACd,GAAI,IAAI,cAAc,EAAE,YAAY,IAAI,aAAkD,GAAG,EAAE;EAC/F,GAAI,eAAe,IAAI,YAAY,GAAG,EAAE,YAAY,eAAe,IAAI,YAAY,EAAE,GAAG,EAAE;EAC1F,GAAI,eAAe,IAAI,kBAAkB,GAAG,EAAE,iBAAiB,eAAe,IAAI,kBAAkB,EAAE,GAAG,EAAE;EAC3G,aAAa,IAAI;EACjB,GAAI,IAAI,kBAAkB,EAAE,gBAAgB,IAAI,iBAAiB,GAAG,EAAE;EACtE,GAAI,IAAI,cAAc,EAAE,YAAY,IAAI,aAAa,GAAG,EAAE;EAC1D,UAAU,YAAY,IAAI,cAAc;EACxC,aAAa,IAAI;EACjB,gBAAgB,IAAI;EACpB,iBAAiB,IAAI;EACrB,GAAI,eAAe,IAAI,WAAW,GAAG,EAAE,WAAW,eAAe,IAAI,WAAW,EAAE,GAAG,EAAE;EACvF,WAAW,IAAI,KAAK,IAAI,WAAW,CAAC,aAAa;EACjD,WAAW,IAAI,KAAK,IAAI,WAAW,CAAC,aAAa;EAClD;;AAGH,SAAS,eAAe,KAA4C;AAClE,QAAO;EACL,IAAI,IAAI;EACR,kBAAkB,IAAI;EACtB,QAAQ,IAAI;EACZ,GAAI,IAAI,gBAAgB,EAAE,cAAc,IAAI,eAAe,GAAG,EAAE;EAChE,GAAI,IAAI,eAAe,EAAE,aAAa,IAAI,cAAc,GAAG,EAAE;EAC7D,WAAW,IAAI;EACf,cAAc,IAAI;EAClB,cAAc,IAAI;EAClB,UAAU,aAAa,IAAI,cAAc;EACzC,GAAI,IAAI,QAAQ,EAAE,OAAO,IAAI,OAAO,GAAG,EAAE;EACzC,WAAW,IAAI,KAAK,IAAI,WAAW,CAAC,aAAa;EACjD,GAAI,eAAe,IAAI,YAAY,GAAG,EAAE,YAAY,eAAe,IAAI,YAAY,EAAE,GAAG,EAAE;EAC3F;;AAGH,SAAgB,sBAAsB,OAIjB;CACnB,MAAM,KAAK,YAAY;CACvB,MAAM,MAAM,MAAM,SAAS,KAAK,KAAK;AACrC,4BAA2B,OAAO;AAChC,KAAG,QACD;;wCAGD,CAAC,IAAI,IAAI,MAAM,kBAAkB,MAAM,gBAAgB,MAAM,IAAI;GAClE;AACF,QAAO;EACL;EACA,kBAAkB,MAAM;EACxB,QAAQ;EACR,GAAI,MAAM,eAAe,EAAE,cAAc,MAAM,cAAc,GAAG,EAAE;EAClE,WAAW;EACX,cAAc;EACd,cAAc;EACd,UAAU,EAAE;EACZ,WAAW,IAAI,KAAK,IAAI,CAAC,aAAa;EACvC;;AAGH,SAAgB,uBAAuB,OAUlB;CACnB,MAAM,MAAM,MAAM,SAAS,KAAK,KAAK;AACrC,4BAA2B,OAAO;AAChC,KAAG,QACD;;;yBAID,CAAC,IACA,MAAM,QACN,MAAM,eAAe,MACrB,MAAM,aAAa,GACnB,MAAM,gBAAgB,GACtB,MAAM,gBAAgB,GACtB,KAAK,UAAU,MAAM,YAAY,EAAE,CAAC,EACpC,MAAM,SAAS,MACf,KACA,MAAM,MACP;GACD;CACF,MAAM,MAAM,mBAAmB,CAC5B,QAAQ,qDAAqD,CAC7D,IAAI,MAAM,MAAM;AACnB,KAAI,CAAC,IAAK,OAAM,IAAI,MAAM,iCAAiC,MAAM,QAAQ;AACzE,QAAO,eAAe,IAAI;;AAG5B,SAAgB,sBAAsB,UAIlC,EAAE,EAAsB;CAC1B,MAAM,QAAkB,EAAE;CAC1B,MAAM,SAAiC,EAAE;AACzC,KAAI,QAAQ,kBAAkB;AAC5B,QAAM,KAAK,yBAAyB;AACpC,SAAO,KAAK,QAAQ,iBAAiB;;AAEvC,KAAI,QAAQ,QAAQ;AAClB,QAAM,KAAK,aAAa;AACxB,SAAO,KAAK,QAAQ,OAAO;;CAE7B,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,QAAQ,SAAS,IAAI,CAAC;AAQ9D,QAPa,mBAAmB,CAC7B,QACC;SACG,MAAM,SAAS,IAAI,SAAS,MAAM,KAAK,QAAQ,KAAK,GAAG;yCAE3D,CACA,IAAI,GAAG,QAAQ,MACP,CAAC,IAAI,eAAe;;AAGjC,SAAgB,yBAAyB,kBAA8C;AAIrF,QAHY,mBAAmB,CAC5B,QAAQ,yEAAyE,CACjF,IAAI,iBACG,EAAE,UAAU,KAAA;;AAGxB,SAAgB,yBAAyB,kBAA0B,QAAkC;AACnG,4BAA2B,OAAO;AAChC,KAAG,QACD;;;;2CAKD,CAAC,IAAI,kBAAkB,UAAU,MAAM,KAAK,KAAK,CAAC;GACnD;;AAGJ,SAAgB,2BACd,QACA,QAAQ,KAAK,KAAK,EACqE;AACvF,QAAO,2BAA2B,OAAO;EACvC,MAAM,QAA+B,EAAE;EACvC,IAAI,UAAU;EACd,IAAI,UAAU;EACd,IAAI,YAAY;AAChB,OAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,WAAW,GAAG,QAClB;2DAED,CAAC,IAAI,MAAM,kBAAkB,MAAM,WAAW;GAC/C,MAAM,KAAK,UAAU,WAAW,MAAM,MAAM,YAAY;AACxD,OAAI,UAAU,iBAAiB,MAAM,eAAe,SAAS,eAAe,eAAe,MAAM,UAAU,EAAE;AAC3G,iBAAa;AACb,UAAM,KAAK,kBAAkB,SAAS,CAAC;AACvC;;AAEF,MAAG,QACD;;;;;;;;;;;;;;;;;;;4CAoBD,CAAC,IACA,IACA,MAAM,kBACN,MAAM,YACN,MAAM,UACN,MAAM,cAAc,MACpB,eAAe,MAAM,WAAW,EAChC,eAAe,MAAM,gBAAgB,EACrC,MAAM,aACN,MAAM,kBAAkB,MACxB,MAAM,cAAc,MACpB,KAAK,UAAU,MAAM,YAAY,EAAE,CAAC,EACpC,MAAM,eAAe,UACrB,MAAM,kBAAkB,WACxB,MAAM,mBAAmB,WACzB,eAAe,MAAM,UAAU,EAC/B,UAAU,cAAc,OACxB,MACD;GACD,MAAM,MAAM,GAAG,QAAQ,yDAAyD,CAAC,IAAI,GAAG;AACxF,SAAM,KAAK,kBAAkB,IAAI,CAAC;AAClC,OAAI,SAAU,YAAW;OACpB,YAAW;;AAElB,SAAO;GAAE;GAAO;GAAS;GAAS;GAAW;GAC7C;;AAGJ,SAAgB,uBAAuB,QAA4C;CACjF,MAAM,MAAM,mBAAmB,CAC5B,QAAQ,yDAAyD,CACjE,IAAI,OAAO;AACd,QAAO,MAAM,kBAAkB,IAAI,GAAG;;AAGxC,SAAgB,yBAAyB,UAMrC,EAAE,EAAyB;CAC7B,MAAM,QAAkB,EAAE;CAC1B,MAAM,SAAiC,EAAE;AACzC,KAAI,QAAQ,kBAAkB;AAC5B,QAAM,KAAK,yBAAyB;AACpC,SAAO,KAAK,QAAQ,iBAAiB;;AAEvC,KAAI,QAAQ,iBAAiB;AAC3B,QAAM,KAAK,uBAAuB;AAClC,SAAO,KAAK,QAAQ,gBAAgB;;AAEtC,KAAI,CAAC,QAAQ,eAAgB,OAAM,KAAK,qBAAqB;CAC7D,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,QAAQ,SAAS,IAAI,CAAC;CAC9D,MAAM,SAAS,KAAK,IAAI,GAAG,QAAQ,UAAU,EAAE;AAS/C,QARa,mBAAmB,CAC7B,QACC;SACG,MAAM,SAAS,IAAI,SAAS,MAAM,KAAK,QAAQ,KAAK,GAAG;;yBAG3D,CACA,IAAI,GAAG,QAAQ,OAAO,OACd,CAAC,IAAI,kBAAkB;;AAGpC,SAAgB,sCACd,SACA,QACA,QAAQ,KAAK,KAAK,EACV;AACR,KAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAO,2BAA2B,OAAO;EACvC,MAAM,eAAe,QAAQ,UAAU,IAAI,CAAC,KAAK,KAAK;EACtD,MAAM,SAAS,GAAG,QAChB;2BACqB,aAAa,GACnC,CAAC,IAAI,QAAQ,OAAO,GAAG,QAAQ;AAChC,SAAO,OAAO,OAAO,QAAQ;GAC7B;;AAGJ,SAAgB,qBAAqB,OAQlB;CACjB,MAAM,aAAa,YAAY;CAC/B,MAAM,MAAM,MAAM,SAAS,KAAK,KAAK;CACrC,MAAM,aAAa,eAAe,MAAM,WAAW;AACnD,4BAA2B,OAAO;AAChC,KAAG,QACD;;;yCAID,CAAC,IACA,YACA,MAAM,UACN,MAAM,gBAAgB,MACtB,MAAM,YAAY,YAClB,MAAM,WAAW,MACjB,MAAM,cAAc,MACpB,YACA,IACD;GACD;AACF,QAAO;EACL;EACA,GAAI,MAAM,eAAe,EAAE,cAAc,MAAM,cAAc,GAAG,EAAE;EAClE,UAAU,MAAM,YAAY;EAC5B,GAAI,MAAM,UAAU,EAAE,YAAY,MAAM,SAAS,GAAG,EAAE;EACtD,GAAI,MAAM,cAAc,OAAO,EAAE,YAAY,MAAM,YAAY,GAAG,EAAE;EACpE,GAAI,cAAc,OAAO,EAAE,YAAY,IAAI,KAAK,WAAW,CAAC,aAAa,EAAE,GAAG,EAAE;EACjF;;AAGH,SAAgB,mBAAmB,UAAoC;AAIrE,QAHa,mBAAmB,CAC7B,QAAQ,4EAA4E,CACpF,IAAI,SACI,CAAC,KAAK,SAAS;EACxB,YAAY,IAAI;EAChB,GAAI,IAAI,iBAAiB,EAAE,cAAc,IAAI,gBAAgB,GAAG,EAAE;EAClE,UAAU,IAAI;EACd,GAAI,IAAI,UAAU,EAAE,YAAY,IAAI,SAAS,GAAG,EAAE;EAClD,GAAI,IAAI,cAAc,OAAO,EAAE,YAAY,IAAI,YAAY,GAAG,EAAE;EAChE,GAAI,eAAe,IAAI,YAAY,GAAG,EAAE,YAAY,eAAe,IAAI,YAAY,EAAE,GAAG,EAAE;EAC3F,EAAE"}