@remnic/core 9.3.612 → 9.3.614

package/dist/{chunk-BFBF3XEF.js.map → chunk-6BDVBBBY.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/maintenance/memory-governance-cron.ts"],"sourcesContent":["import { mkdir, readFile, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nconst DAY_SUMMARY_CRON_ID = \"engram-day-summary\";\nconst GOVERNANCE_CRON_ID = \"engram-nightly-governance\";\nconst PROCEDURAL_MINING_CRON_ID = \"engram-procedural-mining\";\nconst CONTRADICTION_SCAN_CRON_ID = \"engram-contradiction-scan\";\nconst PATTERN_REINFORCEMENT_CRON_ID = \"engram-pattern-reinforcement\";\nconst GRAPH_EDGE_DECAY_CRON_ID = \"engram-graph-edge-decay\";\n\ntype CronJobsShape =\n  | Array<Record<string, unknown>>\n  | {\n      jobs: Array<Record<string, unknown>>;\n      [key: string]: unknown;\n    };\n\nasync function acquireCronJobsLock(jobsPath: string): Promise<() => Promise<void>> {\n  const lockPath = `${jobsPath}.lock`;\n  const start = Date.now();\n  const staleMs = 30_000;\n  const timeoutMs = 5_000;\n  await mkdir(path.dirname(lockPath), { recursive: true });\n\n  while (Date.now() - start < timeoutMs) {\n    try {\n      await mkdir(lockPath);\n      return async () => {\n        try {\n          await rm(lockPath, { recursive: true, force: true });\n        } catch {\n          // Lock cleanup should not fail cron registration.\n        }\n      };\n    } catch (error) {\n      const code = (error as NodeJS.ErrnoException).code;\n      if (code !== \"EEXIST\") {\n        throw error;\n      }\n      try {\n        const lockStat = await stat(lockPath);\n        if (Date.now() - lockStat.mtimeMs > staleMs) {\n          await rm(lockPath, { recursive: true, force: true });\n          continue;\n        }\n      } catch {\n        // Lock may have been released between stat/rm attempts.\n      }\n      await new Promise((resolve) => setTimeout(resolve, 25));\n    }\n  }\n\n  throw new Error(`cron jobs lock acquisition timed out after ${timeoutMs}ms`);\n}\n\nfunction parseCronJobsShape(raw: string): { parsed: CronJobsShape; jobs: Array<Record<string, unknown>> } {\n  const parsed = JSON.parse(raw) as CronJobsShape;\n  const jobs = Array.isArray(parsed) ? parsed : Array.isArray(parsed.jobs) ? parsed.jobs : null;\n  if (!jobs) {\n    throw new Error(\"jobs.json has unexpected structure\");\n  }\n  return { parsed, jobs };\n}\n\nasync function writeCronJobsAtomic(jobsPath: string, value: CronJobsShape): Promise<void> {\n  const tempPath = `${jobsPath}.${process.pid}.${Date.now()}.tmp`;\n  await writeFile(tempPath, JSON.stringify(value, null, 2) + \"\\n\", \"utf-8\");\n  await rename(tempPath, jobsPath);\n}\n\nexport async function ensureCronJob(\n  jobsPath: string,\n  jobId: string,\n  buildJob: () => Record<string, unknown>,\n  options: { updateExisting?: boolean; updateFields?: string[] } = {},\n): Promise<{ created: boolean; updated: boolean; jobId: string }> {\n  const releaseLock = await acquireCronJobsLock(jobsPath);\n  try {\n    const raw = await readFile(jobsPath, \"utf-8\");\n    const { parsed, jobs } = parseCronJobsShape(raw);\n\n    const existingIndex = jobs.findIndex((job) => job.id === jobId);\n    if (existingIndex >= 0) {\n      if (!options.updateExisting) {\n        return { created: false, updated: false, jobId };\n      }\n\n      const desired = buildJob();\n      const existing = jobs[existingIndex];\n      const next = mergeCronJobUpdate(existing, desired, options.updateFields);\n      if (stableJson(existing) === stableJson(next)) {\n        return { created: false, updated: false, jobId };\n      }\n\n      jobs[existingIndex] = next;\n      const output = Array.isArray(parsed) ? jobs : { ...parsed, jobs };\n      await writeCronJobsAtomic(jobsPath, output);\n      return { created: false, updated: true, jobId };\n    }\n\n    jobs.push(buildJob());\n    const output = Array.isArray(parsed) ? jobs : { ...parsed, jobs };\n    await writeCronJobsAtomic(jobsPath, output);\n    return { created: true, updated: false, jobId };\n  } finally {\n    await releaseLock();\n  }\n}\n\nfunction mergeCronJobUpdate(\n  existing: Record<string, unknown>,\n  desired: Record<string, unknown>,\n  updateFields?: string[],\n): Record<string, unknown> {\n  if (!updateFields) {\n    return desired;\n  }\n\n  const next = { ...existing };\n  for (const field of updateFields) {\n    if (Object.prototype.hasOwnProperty.call(desired, field)) {\n      next[field] = desired[field];\n    } else {\n      delete next[field];\n    }\n  }\n  return next;\n}\n\nfunction stableJson(value: unknown): string {\n  if (Array.isArray(value)) {\n    return `[${value.map((item) => stableJson(item)).join(\",\")}]`;\n  }\n  if (value && typeof value === \"object\") {\n    const record = value as Record<string, unknown>;\n    return `{${Object.keys(record)\n      .sort()\n      .map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`)\n      .join(\",\")}}`;\n  }\n  return JSON.stringify(value);\n}\n\nexport async function ensureDaySummaryCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, DAY_SUMMARY_CRON_ID, () => ({\n    id: DAY_SUMMARY_CRON_ID,\n    agentId,\n    name: \"Remnic Day Summary (auto)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: \"47 23 * * *\",\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool engram.day_summary with empty params (it will auto-gather today's facts). If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensureNightlyGovernanceCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    recentDays?: number;\n    maxMemories?: number;\n    batchSize?: number;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const recentDays =\n    typeof options.recentDays === \"number\" && Number.isFinite(options.recentDays)\n      ? Math.max(1, Math.floor(options.recentDays))\n      : 2;\n  const maxMemories =\n    typeof options.maxMemories === \"number\" && Number.isFinite(options.maxMemories)\n      ? Math.max(1, Math.floor(options.maxMemories))\n      : 500;\n  const batchSize =\n    typeof options.batchSize === \"number\" && Number.isFinite(options.batchSize)\n      ? Math.max(1, Math.floor(options.batchSize))\n      : 100;\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"23 2 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, GOVERNANCE_CRON_ID, () => ({\n      id: GOVERNANCE_CRON_ID,\n      agentId,\n      name: \"Remnic Nightly Governance (batched)\",\n      enabled: true,\n      schedule: {\n        kind: \"cron\",\n        expr: scheduleExpr,\n        tz: options.timezone,\n      },\n      sessionTarget: \"isolated\",\n      wakeMode: \"now\",\n      payload: {\n        kind: \"agentTurn\",\n        timeoutSeconds: 900,\n        thinking: \"off\",\n        message:\n          \"You are OpenClaw automation. Call the tool `engram.memory_governance_run` with params \" +\n          `{\"mode\": \"apply\", \"recentDays\": ${recentDays}, \"maxMemories\": ${maxMemories}, \"batchSize\": ${batchSize}}` +\n          \". If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n      },\n      delivery: { mode: \"none\" },\n    }));\n}\n\nexport async function ensureProceduralMiningCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"17 3 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, PROCEDURAL_MINING_CRON_ID, () => ({\n    id: PROCEDURAL_MINING_CRON_ID,\n    agentId,\n    name: \"Remnic Procedural Mining (nightly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.procedure_mining_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensureContradictionScanCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"37 3 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, CONTRADICTION_SCAN_CRON_ID, () => ({\n    id: CONTRADICTION_SCAN_CRON_ID,\n    agentId,\n    name: \"Remnic Contradiction Scan (nightly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.contradiction_scan_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensurePatternReinforcementCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    /**\n     * Cron expression. Default `\"53 4 * * 0\"` — Sunday 04:53 in the\n     * configured timezone, deliberately offset from sibling crons\n     * (`23 2 * * *`, `17 3 * * *`, `37 3 * * *`) so the maintenance\n     * passes don't pile up on the same minute.\n     */\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"53 4 * * 0\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, PATTERN_REINFORCEMENT_CRON_ID, () => ({\n    id: PATTERN_REINFORCEMENT_CRON_ID,\n    agentId,\n    name: \"Remnic Pattern Reinforcement (weekly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.pattern_reinforcement_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\n/**\n * Register a cron job that runs the graph-edge-decay maintenance pass\n * (issue #681 PR 2/3). Default schedule is weekly on Sunday 04:13 — the\n * cadence is configurable via `scheduleExpr`. Cadence is also expressible\n * in milliseconds via `Config.graphEdgeDecayCadenceMs`; the orchestrator\n * picks the right cron expression for sub-daily, daily, or weekly cadence.\n */\nexport async function ensureGraphEdgeDecayCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"13 4 * * 0\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  const scheduleLabel = graphEdgeDecayScheduleLabel(scheduleExpr);\n\n  return ensureCronJob(jobsPath, GRAPH_EDGE_DECAY_CRON_ID, () => ({\n    id: GRAPH_EDGE_DECAY_CRON_ID,\n    agentId,\n    // Schedule label reflects the actual cron expression (`daily` /\n    // `weekly` / `custom`) so cron dashboards do not show \"weekly\"\n    // when the schedule is in fact daily — Cursor review on PR #729.\n    name: `Remnic Graph Edge Decay (${scheduleLabel})`,\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.graph_edge_decay_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\n/**\n * Pick a cron expression that approximates a cadence in milliseconds.\n *\n * - cadence < 7 days → daily at 04:13 (sub-daily cadence is not natively\n *   expressible in 5-field cron without `*\\/N` patterns; daily is the\n *   safe upper bound that won't trip the cron more often than requested).\n * - cadence ≥ 7 days → weekly on Sunday 04:13.\n *\n * Operators who need finer-grained control should set `scheduleExpr`\n * directly via `ensureGraphEdgeDecayCron`.\n */\nexport function graphEdgeDecayCadenceToCronExpr(cadenceMs: number): string {\n  if (!Number.isFinite(cadenceMs) || cadenceMs <= 0) {\n    return \"13 4 * * 0\";\n  }\n  const day = 24 * 60 * 60 * 1000;\n  if (cadenceMs < 7 * day) return \"13 4 * * *\";\n  return \"13 4 * * 0\";\n}\n\n/**\n * Derive a human-friendly schedule label (\"daily\" / \"weekly\" / \"custom\")\n * for the given cron expression. Used to keep the cron job name in\n * sync with the actual schedule (Cursor review on PR #729).\n */\nfunction graphEdgeDecayScheduleLabel(scheduleExpr: string): string {\n  if (scheduleExpr === \"13 4 * * *\") return \"daily\";\n  if (scheduleExpr === \"13 4 * * 0\") return \"weekly\";\n  return \"custom\";\n}\n"],"mappings":"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","names":["output"]}
+{"version":3,"sources":["../src/maintenance/memory-governance-cron.ts"],"sourcesContent":["import { mkdir, readFile, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nconst DAY_SUMMARY_CRON_ID = \"engram-day-summary\";\nconst GOVERNANCE_CRON_ID = \"engram-nightly-governance\";\nconst PROCEDURAL_MINING_CRON_ID = \"engram-procedural-mining\";\nconst CONTRADICTION_SCAN_CRON_ID = \"engram-contradiction-scan\";\nconst PATTERN_REINFORCEMENT_CRON_ID = \"engram-pattern-reinforcement\";\nconst GRAPH_EDGE_DECAY_CRON_ID = \"engram-graph-edge-decay\";\n\ntype CronJobsShape =\n  | Array<Record<string, unknown>>\n  | {\n      jobs: Array<Record<string, unknown>>;\n      [key: string]: unknown;\n    };\n\nasync function acquireCronJobsLock(jobsPath: string): Promise<() => Promise<void>> {\n  const lockPath = `${jobsPath}.lock`;\n  const start = Date.now();\n  const staleMs = 30_000;\n  const timeoutMs = 5_000;\n  await mkdir(path.dirname(lockPath), { recursive: true });\n\n  while (Date.now() - start < timeoutMs) {\n    try {\n      await mkdir(lockPath);\n      return async () => {\n        try {\n          await rm(lockPath, { recursive: true, force: true });\n        } catch {\n          // Lock cleanup should not fail cron registration.\n        }\n      };\n    } catch (error) {\n      const code = (error as NodeJS.ErrnoException).code;\n      if (code !== \"EEXIST\") {\n        throw error;\n      }\n      try {\n        const lockStat = await stat(lockPath);\n        if (Date.now() - lockStat.mtimeMs > staleMs) {\n          await rm(lockPath, { recursive: true, force: true });\n          continue;\n        }\n      } catch {\n        // Lock may have been released between stat/rm attempts.\n      }\n      await new Promise((resolve) => setTimeout(resolve, 25));\n    }\n  }\n\n  throw new Error(`cron jobs lock acquisition timed out after ${timeoutMs}ms`);\n}\n\nfunction parseCronJobsShape(raw: string): { parsed: CronJobsShape; jobs: Array<Record<string, unknown>> } {\n  const parsed = JSON.parse(raw) as CronJobsShape;\n  const jobs = Array.isArray(parsed) ? parsed : Array.isArray(parsed.jobs) ? parsed.jobs : null;\n  if (!jobs) {\n    throw new Error(\"jobs.json has unexpected structure\");\n  }\n  return { parsed, jobs };\n}\n\nasync function writeCronJobsAtomic(jobsPath: string, value: CronJobsShape): Promise<void> {\n  const tempPath = `${jobsPath}.${process.pid}.${Date.now()}.tmp`;\n  await writeFile(tempPath, JSON.stringify(value, null, 2) + \"\\n\", \"utf-8\");\n  await rename(tempPath, jobsPath);\n}\n\nexport async function ensureCronJob(\n  jobsPath: string,\n  jobId: string,\n  buildJob: () => Record<string, unknown>,\n  options: { updateExisting?: boolean; updateFields?: string[] } = {},\n): Promise<{ created: boolean; updated: boolean; jobId: string }> {\n  const releaseLock = await acquireCronJobsLock(jobsPath);\n  try {\n    const raw = await readFile(jobsPath, \"utf-8\");\n    const { parsed, jobs } = parseCronJobsShape(raw);\n\n    const existingIndex = jobs.findIndex((job) => job.id === jobId);\n    if (existingIndex >= 0) {\n      if (!options.updateExisting) {\n        return { created: false, updated: false, jobId };\n      }\n\n      const desired = buildJob();\n      const existing = jobs[existingIndex];\n      const next = mergeCronJobUpdate(existing, desired, options.updateFields);\n      if (stableJson(existing) === stableJson(next)) {\n        return { created: false, updated: false, jobId };\n      }\n\n      jobs[existingIndex] = next;\n      const output = Array.isArray(parsed) ? jobs : { ...parsed, jobs };\n      await writeCronJobsAtomic(jobsPath, output);\n      return { created: false, updated: true, jobId };\n    }\n\n    jobs.push(buildJob());\n    const output = Array.isArray(parsed) ? jobs : { ...parsed, jobs };\n    await writeCronJobsAtomic(jobsPath, output);\n    return { created: true, updated: false, jobId };\n  } finally {\n    await releaseLock();\n  }\n}\n\nfunction mergeCronJobUpdate(\n  existing: Record<string, unknown>,\n  desired: Record<string, unknown>,\n  updateFields?: string[],\n): Record<string, unknown> {\n  if (!updateFields) {\n    return desired;\n  }\n\n  const next = { ...existing };\n  for (const field of updateFields) {\n    if (Object.prototype.hasOwnProperty.call(desired, field)) {\n      next[field] = desired[field];\n    } else {\n      delete next[field];\n    }\n  }\n  return next;\n}\n\nfunction stableJson(value: unknown): string {\n  if (Array.isArray(value)) {\n    return `[${value.map((item) => stableJson(item)).join(\",\")}]`;\n  }\n  if (value && typeof value === \"object\") {\n    const record = value as Record<string, unknown>;\n    return `{${Object.keys(record)\n      .sort()\n      .map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`)\n      .join(\",\")}}`;\n  }\n  return JSON.stringify(value);\n}\n\nexport async function ensureDaySummaryCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, DAY_SUMMARY_CRON_ID, () => ({\n    id: DAY_SUMMARY_CRON_ID,\n    agentId,\n    name: \"Remnic Day Summary (auto)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: \"47 23 * * *\",\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool engram.day_summary with empty params (it will auto-gather today's facts). If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensureNightlyGovernanceCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    recentDays?: number;\n    maxMemories?: number;\n    batchSize?: number;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const recentDays =\n    typeof options.recentDays === \"number\" && Number.isFinite(options.recentDays)\n      ? Math.max(1, Math.floor(options.recentDays))\n      : 2;\n  const maxMemories =\n    typeof options.maxMemories === \"number\" && Number.isFinite(options.maxMemories)\n      ? Math.max(1, Math.floor(options.maxMemories))\n      : 500;\n  const batchSize =\n    typeof options.batchSize === \"number\" && Number.isFinite(options.batchSize)\n      ? Math.max(1, Math.floor(options.batchSize))\n      : 100;\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"23 2 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, GOVERNANCE_CRON_ID, () => ({\n      id: GOVERNANCE_CRON_ID,\n      agentId,\n      name: \"Remnic Nightly Governance (batched)\",\n      enabled: true,\n      schedule: {\n        kind: \"cron\",\n        expr: scheduleExpr,\n        tz: options.timezone,\n      },\n      sessionTarget: \"isolated\",\n      wakeMode: \"now\",\n      payload: {\n        kind: \"agentTurn\",\n        timeoutSeconds: 900,\n        thinking: \"off\",\n        message:\n          \"You are OpenClaw automation. Call the tool `engram.memory_governance_run` with params \" +\n          `{\"mode\": \"apply\", \"recentDays\": ${recentDays}, \"maxMemories\": ${maxMemories}, \"batchSize\": ${batchSize}}` +\n          \". If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n      },\n      delivery: { mode: \"none\" },\n    }));\n}\n\nexport async function ensureProceduralMiningCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"17 3 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, PROCEDURAL_MINING_CRON_ID, () => ({\n    id: PROCEDURAL_MINING_CRON_ID,\n    agentId,\n    name: \"Remnic Procedural Mining (nightly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.procedure_mining_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensureContradictionScanCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"37 3 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, CONTRADICTION_SCAN_CRON_ID, () => ({\n    id: CONTRADICTION_SCAN_CRON_ID,\n    agentId,\n    name: \"Remnic Contradiction Scan (nightly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.contradiction_scan_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensurePatternReinforcementCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    /**\n     * Cron expression. Default `\"53 4 * * 0\"` — Sunday 04:53 in the\n     * configured timezone, deliberately offset from sibling crons\n     * (`23 2 * * *`, `17 3 * * *`, `37 3 * * *`) so the maintenance\n     * passes don't pile up on the same minute.\n     */\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"53 4 * * 0\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, PATTERN_REINFORCEMENT_CRON_ID, () => ({\n    id: PATTERN_REINFORCEMENT_CRON_ID,\n    agentId,\n    name: \"Remnic Pattern Reinforcement (weekly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.pattern_reinforcement_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\n/**\n * Register a cron job that runs the graph-edge-decay maintenance pass\n * (issue #681 PR 2/3). Default schedule is weekly on Sunday 04:13 — the\n * cadence is configurable via `scheduleExpr`. Cadence is also expressible\n * in milliseconds via `Config.graphEdgeDecayCadenceMs`; the orchestrator\n * picks the right cron expression for sub-daily, daily, or weekly cadence.\n */\nexport async function ensureGraphEdgeDecayCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"13 4 * * 0\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  const scheduleLabel = graphEdgeDecayScheduleLabel(scheduleExpr);\n\n  return ensureCronJob(\n    jobsPath,\n    GRAPH_EDGE_DECAY_CRON_ID,\n    () => ({\n      id: GRAPH_EDGE_DECAY_CRON_ID,\n      agentId,\n      // Schedule label reflects the actual cron expression (`daily` /\n      // `weekly` / `custom`) so cron dashboards do not show \"weekly\"\n      // when the schedule is in fact daily — Cursor review on PR #729.\n      name: `Remnic Graph Edge Decay (${scheduleLabel})`,\n      enabled: true,\n      schedule: {\n        kind: \"cron\",\n        expr: scheduleExpr,\n        tz: options.timezone,\n      },\n      sessionTarget: \"isolated\",\n      wakeMode: \"now\",\n      payload: {\n        kind: \"agentTurn\",\n        timeoutSeconds: 900,\n        thinking: \"off\",\n        message:\n          \"You are OpenClaw automation. Call tool `engram.graph_edge_decay_run` with empty params. \" +\n          \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n      },\n      delivery: { mode: \"none\" },\n    }),\n    {\n      updateExisting: true,\n      updateFields: [\"name\", \"schedule\"],\n    },\n  );\n}\n\n/**\n * Pick a cron expression that approximates a cadence in milliseconds.\n *\n * - cadence <= 1 day → daily at 04:13. Sub-daily cadence is not natively\n *   expressible in 5-field cron without hour/minute step patterns; daily\n *   preserves the previous conservative behavior for those values.\n * - cadence > 1 day → weekly on Sunday 04:13. Multi-day intervals like\n *   2-6 days cannot be represented accurately by a portable 5-field cron\n *   expression, and daily would run more often than requested.\n *\n * Operators who need finer-grained control should set `scheduleExpr`\n * directly via `ensureGraphEdgeDecayCron`.\n */\nexport function graphEdgeDecayCadenceToCronExpr(cadenceMs: number): string {\n  if (!Number.isFinite(cadenceMs) || cadenceMs <= 0) {\n    return \"13 4 * * 0\";\n  }\n  const day = 24 * 60 * 60 * 1000;\n  if (cadenceMs <= day) return \"13 4 * * *\";\n  return \"13 4 * * 0\";\n}\n\n/**\n * Derive a human-friendly schedule label (\"daily\" / \"weekly\" / \"custom\")\n * for the given cron expression. Used to keep the cron job name in\n * sync with the actual schedule (Cursor review on PR #729).\n */\nfunction graphEdgeDecayScheduleLabel(scheduleExpr: string): string {\n  if (scheduleExpr === \"13 4 * * *\") return \"daily\";\n  if (scheduleExpr === \"13 4 * * 0\") return \"weekly\";\n  return \"custom\";\n}\n"],"mappings":"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","names":["output"]}

package/dist/{chunk-EAZGEEG2.js → chunk-6L46YAEZ.js}

@@ -4,7 +4,7 @@ var REMNIC_CHATGPT_MEMORY_INSPECTOR_CANONICAL_TOOL = "remnic.chatgpt_memory_insp
 var REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI = "ui://remnic/memory-inspector.v1.html";
 var REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE = "text/html;profile=mcp-app";
 function buildChatGptMemoryInspectorActionRequest(input, recall, xray) {
-  const provenances = xray === null ? recall.results.map(missingRecallProvenance) : xray.results.map((result) => result.provenance ?? missingProvenance(result));
+  const provenances = buildRecallProvenances(recall, xray);
   const hasUnsafeOrMissingProvenance = provenances.some(
     (provenance) => provenance.safeToUse === false || provenance.safety === "blocked"
   ) || provenances.length < recall.count;
@@ -37,13 +37,7 @@ function buildChatGptMemoryInspectorActionRequest(input, recall, xray) {
 }
 function buildChatGptMemoryInspectorResult(input, recall, xray, actionConfidence) {
   const xrayUnavailable = xray === null;
-  const xrayById = /* @__PURE__ */ new Map();
-  const xrayByPath = /* @__PURE__ */ new Map();
-  for (const result of xray?.results ?? []) {
-    xrayById.set(result.memoryId, result);
-    xrayByPath.set(result.path, result);
-  }
-  const matchXrayResult = (summary) => (summary.path ? xrayByPath.get(summary.path) : void 0) ?? xrayById.get(summary.id);
+  const matchXrayResult = buildXrayResultMatcher(xray);
   const matchedXrayResults = recall.results.map(matchXrayResult);
   const memories = recall.results.slice(0, 8).map((summary) => {
     const xrayResult = matchXrayResult(summary);
@@ -266,6 +260,33 @@ function average(values) {
   if (values.length === 0) return void 0;
   return values.reduce((sum, value) => sum + value, 0) / values.length;
 }
+function buildRecallProvenances(recall, xray) {
+  if (xray === null) {
+    return recall.results.map(missingRecallProvenance);
+  }
+  const matchXrayResult = buildXrayResultMatcher(xray);
+  return recall.results.map((summary) => {
+    const result = matchXrayResult(summary);
+    if (result === void 0) {
+      return missingXrayResultProvenance(summary);
+    }
+    return result.provenance ?? missingProvenance(result);
+  });
+}
+function buildXrayResultMatcher(xray) {
+  const xrayById = /* @__PURE__ */ new Map();
+  const xrayByPath = /* @__PURE__ */ new Map();
+  for (const result of xray?.results ?? []) {
+    xrayById.set(result.memoryId, result);
+    xrayByPath.set(result.path, result);
+  }
+  return (summary) => {
+    if (summary.path) {
+      return xrayByPath.get(summary.path);
+    }
+    return xrayById.get(summary.id);
+  };
+}
 function missingProvenance(result) {
   return {
     source: "unknown",
@@ -281,6 +302,21 @@ function missingProvenance(result) {
     safetyReasons: ["X-ray provenance was missing for this memory."]
   };
 }
+function missingXrayResultProvenance(summary) {
+  return {
+    source: "unknown",
+    scope: "unknown",
+    userContextScopes: [],
+    retrievalReason: `X-ray result missing for ${summary.path || summary.id}`,
+    confidence: 0,
+    stale: false,
+    corrected: false,
+    correctionState: "none",
+    safeToUse: false,
+    safety: "blocked",
+    safetyReasons: ["X-ray result was missing for this recalled memory."]
+  };
+}
 function missingRecallProvenance(summary) {
   return {
     source: "unknown",
@@ -332,4 +368,4 @@ export {
   buildChatGptMemoryInspectorResult,
   REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_HTML
 };
-//# sourceMappingURL=chunk-EAZGEEG2.js.map
+//# sourceMappingURL=chunk-6L46YAEZ.js.map

package/dist/chunk-6L46YAEZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp-memory-inspector-app.ts"],"sourcesContent":["import type { EngramAccessRecallResponse } from \"./access-service.js\";\nimport type { ActionConfidenceRequest } from \"./access-schema.js\";\nimport type { RecallXrayResult, RecallXraySnapshot } from \"./recall-xray.js\";\nimport type { ActionConfidenceResult } from \"./action-confidence.js\";\nimport type { RetrievedMemoryProvenance } from \"./memory-provenance.js\";\n\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_TOOL =\n  \"engram.chatgpt_memory_inspector\" as const;\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_CANONICAL_TOOL =\n  \"remnic.chatgpt_memory_inspector\" as const;\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI =\n  \"ui://remnic/memory-inspector.v1.html\" as const;\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE =\n  \"text/html;profile=mcp-app\" as const;\n\nexport interface RemnicChatGptMemoryInspectorInput {\n  query: string;\n  sessionKey?: string;\n  namespace?: string;\n  currentContextScopes?: string[];\n}\n\nexport interface RemnicChatGptMemoryCard {\n  id: string;\n  path?: string;\n  category?: string;\n  status?: string;\n  preview?: string;\n  servedBy?: string;\n  score?: number;\n  source?: string;\n  scope?: string;\n  retrievalReason?: string;\n  confidence?: number;\n  stale?: boolean;\n  corrected?: boolean;\n  safeToUse?: boolean;\n  safety?: string;\n  safetyReasons: string[];\n  userContextScopes: string[];\n}\n\nexport interface RemnicChatGptMemoryInspectorResult {\n  app: {\n    name: \"Remnic Memory Inspector\";\n    resourceUri: typeof REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI;\n    archetype: \"vanilla-widget\";\n  };\n  query: string;\n  sessionKey?: string;\n  namespace: string;\n  safeRecallPreview: string;\n  memoryCount: number;\n  memoryIds: string[];\n  memories: RemnicChatGptMemoryCard[];\n  actionConfidence: ActionConfidenceResult;\n  affordances: Array<{\n    id: \"why\" | \"correct\" | \"forget\" | \"scope\";\n    label: string;\n    followUpPrompt: string;\n  }>;\n  guidance: {\n    correctionTool: \"remnic.suggestion_submit\";\n    forgetTool: \"remnic.memory_action_apply\";\n    scopeTool: \"remnic.memory_action_apply\";\n    note: string;\n  };\n}\n\nexport function buildChatGptMemoryInspectorActionRequest(\n  input: RemnicChatGptMemoryInspectorInput,\n  recall: EngramAccessRecallResponse,\n  xray: RecallXraySnapshot | null,\n): ActionConfidenceRequest {\n  const provenances = buildRecallProvenances(recall, xray);\n  const hasUnsafeOrMissingProvenance = provenances.some(\n    (provenance) => provenance.safeToUse === false || provenance.safety === \"blocked\",\n  ) || provenances.length < recall.count;\n\n  const request: ActionConfidenceRequest = {\n    intendedAction: `Use Remnic memory to answer: ${input.query}`,\n    risk: \"medium\",\n    contextReadiness:\n      recall.count > 0 && !hasUnsafeOrMissingProvenance ? \"sufficient\" : \"partial\",\n    retrievedMemories: provenances.map((provenance) => ({\n      source: provenance.source,\n      created: provenance.created,\n      updated: provenance.updated,\n      scope: provenance.scope,\n      userContextScopes: provenance.userContextScopes,\n      retrievalReason: provenance.retrievalReason,\n      confidence: provenance.confidence,\n      stale: provenance.stale,\n      corrected: provenance.corrected,\n      correctionState: provenance.correctionState,\n      safeToUse: provenance.safeToUse,\n      safety: provenance.safety,\n      safetyReasons: provenance.safetyReasons,\n    })),\n  };\n  const confidence = provenances.length > 0\n    ? average(provenances.map((provenance) => provenance.confidence ?? 0.5))\n    : undefined;\n  if (confidence !== undefined) request.confidence = confidence;\n  if (input.currentContextScopes !== undefined) {\n    request.currentContextScopes = input.currentContextScopes;\n  }\n  return request;\n}\n\nexport function buildChatGptMemoryInspectorResult(\n  input: RemnicChatGptMemoryInspectorInput,\n  recall: EngramAccessRecallResponse,\n  xray: RecallXraySnapshot | null,\n  actionConfidence: ActionConfidenceResult,\n): RemnicChatGptMemoryInspectorResult {\n  const xrayUnavailable = xray === null;\n  const matchXrayResult = buildXrayResultMatcher(xray);\n  const matchedXrayResults = recall.results.map(matchXrayResult);\n\n  const memories = recall.results.slice(0, 8).map((summary) => {\n    const xrayResult = matchXrayResult(summary);\n    const provenance = xrayResult?.provenance;\n    const unverified = !xrayUnavailable && provenance === undefined;\n    const blocked = provenance?.safety === \"blocked\";\n    const preview = xrayUnavailable\n      ? \"Preview withheld: X-ray provenance was unavailable for this recall.\"\n      : unverified\n        ? \"Preview withheld: X-ray provenance was missing for this memory.\"\n      : blocked\n        ? \"Preview withheld: this memory is blocked in the current context.\"\n        : summary.preview;\n    return {\n      id: summary.id,\n      path: summary.path,\n      category: summary.category,\n      status: summary.status,\n      preview,\n      servedBy: xrayResult?.servedBy,\n      score: xrayResult?.scoreDecomposition.final,\n      source: provenance?.source,\n      scope: provenance?.scope,\n      retrievalReason: provenance?.retrievalReason,\n      confidence: provenance?.confidence,\n      stale: provenance?.stale,\n      corrected: provenance?.corrected,\n      safeToUse: provenance?.safeToUse ?? (unverified ? false : undefined),\n      safety: provenance?.safety ?? (unverified ? \"blocked\" : undefined),\n      safetyReasons: provenance?.safetyReasons\n        ?? (unverified ? [\"X-ray provenance was missing for this memory.\"] : []),\n      userContextScopes: provenance?.userContextScopes ?? [],\n    };\n  });\n  const blockedCount = matchedXrayResults\n    .filter((result) => result?.provenance?.safety === \"blocked\")\n    .length;\n  const missingProvenanceCount = xrayUnavailable\n    ? 0\n    : matchedXrayResults\n      .filter((result) => result?.provenance === undefined)\n    .length;\n  const safeRecallPreview = xrayUnavailable\n    ? \"Recall preview withheld: X-ray provenance was unavailable, so memory safety could not be verified.\"\n    : blockedCount > 0 || missingProvenanceCount > 0\n      ? formatUnsafeRecallPreview(blockedCount, missingProvenanceCount)\n      : truncate(recall.context, 1_500);\n\n  const primaryMemoryId = memories[0]?.id ?? \"<memory-id>\";\n  return {\n    app: {\n      name: \"Remnic Memory Inspector\",\n      resourceUri: REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI,\n      archetype: \"vanilla-widget\",\n    },\n    query: recall.query || input.query,\n    ...(input.sessionKey ? { sessionKey: input.sessionKey } : {}),\n    namespace: recall.namespace,\n    safeRecallPreview,\n    memoryCount: recall.count,\n    memoryIds: recall.memoryIds,\n    memories,\n    actionConfidence,\n    affordances: [\n      {\n        id: \"why\",\n        label: \"Why retrieved\",\n        followUpPrompt:\n          `Explain why Remnic retrieved memory ${primaryMemoryId} for \"${input.query}\" using its provenance, score, safety, and retrieval reason.`,\n      },\n      {\n        id: \"correct\",\n        label: \"Correct\",\n        followUpPrompt:\n          `Help me correct memory ${primaryMemoryId}. Draft a replacement or correction and use remnic.suggestion_submit with dryRun first.`,\n      },\n      {\n        id: \"forget\",\n        label: \"Forget\",\n        followUpPrompt:\n          `Help me forget or quarantine memory ${primaryMemoryId}. Ask me to confirm before using any destructive or persistent Remnic action.`,\n      },\n      {\n        id: \"scope\",\n        label: \"Scope\",\n        followUpPrompt:\n          `Help me scope memory ${primaryMemoryId} so it is only used in the right context. Prefer a dry-run Remnic action before any persistent change.`,\n      },\n    ],\n    guidance: {\n      correctionTool: \"remnic.suggestion_submit\",\n      forgetTool: \"remnic.memory_action_apply\",\n      scopeTool: \"remnic.memory_action_apply\",\n      note:\n        \"The demo only proposes correction, forget, and scoping flows. The widget sends follow-up prompts; persistent changes still require an explicit tool call and user confirmation.\",\n    },\n  };\n}\n\nexport const REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_HTML = `\n<div id=\"root\" class=\"remnic-app\">Loading Remnic memory inspector...</div>\n<style>\n  :root {\n    color-scheme: light dark;\n    --bg: #f8faf8;\n    --panel: #ffffff;\n    --text: #17201b;\n    --muted: #56635b;\n    --line: #d8e0da;\n    --accent: #2f7d57;\n    --warn: #9a5b14;\n    --bad: #9c2b2b;\n  }\n  @media (prefers-color-scheme: dark) {\n    :root {\n      --bg: #101512;\n      --panel: #18201b;\n      --text: #edf4ef;\n      --muted: #a8b6ad;\n      --line: #304036;\n      --accent: #75c79a;\n      --warn: #e0ad63;\n      --bad: #f08a8a;\n    }\n  }\n  body { margin: 0; background: var(--bg); color: var(--text); font: 14px/1.45 system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; }\n  .remnic-app { padding: 14px; display: grid; gap: 12px; }\n  .header, .section, .memory { background: var(--panel); border: 1px solid var(--line); border-radius: 8px; padding: 12px; }\n  .title { font-size: 16px; font-weight: 650; margin: 0; }\n  .muted { color: var(--muted); }\n  .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 8px; }\n  .pill { display: inline-flex; align-items: center; gap: 4px; border: 1px solid var(--line); border-radius: 999px; padding: 2px 8px; margin: 2px 4px 2px 0; color: var(--muted); }\n  .safe { color: var(--accent); }\n  .review { color: var(--warn); }\n  .blocked { color: var(--bad); }\n  .memory { display: grid; gap: 8px; }\n  .memory-title { display: flex; justify-content: space-between; gap: 12px; align-items: baseline; font-weight: 650; }\n  .preview { white-space: pre-wrap; overflow-wrap: anywhere; }\n  .actions { display: flex; flex-wrap: wrap; gap: 8px; }\n  button { border: 1px solid var(--line); background: transparent; color: var(--text); border-radius: 6px; padding: 6px 9px; font: inherit; cursor: pointer; }\n  button:hover { border-color: var(--accent); }\n  pre { white-space: pre-wrap; overflow-wrap: anywhere; margin: 0; color: var(--muted); }\n</style>\n<script>\n  const root = document.getElementById(\"root\");\n\n  function escapeHtml(value) {\n    return String(value ?? \"\").replace(/[&<>\"']/g, (char) => ({\n      \"&\": \"&amp;\",\n      \"<\": \"&lt;\",\n      \">\": \"&gt;\",\n      '\"': \"&quot;\",\n      \"'\": \"&#39;\",\n    }[char]));\n  }\n\n  function statusClass(value) {\n    if (value === \"blocked\" || value === false) return \"blocked\";\n    if (value === \"requires-review\") return \"review\";\n    return \"safe\";\n  }\n\n  function followUp(prompt) {\n    if (window.openai?.sendFollowUpMessage) {\n      window.openai.sendFollowUpMessage({ prompt, scrollToBottom: true });\n      return;\n    }\n    window.parent.postMessage({\n      jsonrpc: \"2.0\",\n      method: \"ui/message\",\n      params: {\n        role: \"user\",\n        content: [{ type: \"text\", text: prompt }],\n      },\n    }, \"*\");\n  }\n\n  function actionButtons(actions) {\n    return (actions ?? []).map((action) =>\n      '<button type=\"button\" data-prompt=\"' + escapeHtml(action.followUpPrompt) + '\">' +\n      escapeHtml(action.label) +\n      '</button>'\n    ).join(\"\");\n  }\n\n  function render(payload) {\n    const data = payload?.structuredContent ?? payload ?? window.openai?.toolOutput ?? {};\n    const confidence = data.actionConfidence ?? {};\n    const memories = Array.isArray(data.memories) ? data.memories : [];\n    root.innerHTML = [\n      '<section class=\"header\">',\n        '<p class=\"title\">Remnic Memory Inspector</p>',\n        '<div class=\"muted\">' + escapeHtml(data.query ?? \"No query\") + '</div>',\n        '<div class=\"grid\">',\n          '<div><strong>Namespace</strong><br><span class=\"muted\">' + escapeHtml(data.namespace ?? \"default\") + '</span></div>',\n          '<div><strong>Decision</strong><br><span class=\"' + statusClass(confidence.decision) + '\">' + escapeHtml(confidence.decision ?? \"unknown\") + '</span></div>',\n          '<div><strong>Memories</strong><br><span class=\"muted\">' + escapeHtml(data.memoryCount ?? memories.length) + '</span></div>',\n        '</div>',\n      '</section>',\n      '<section class=\"section\">',\n        '<strong>Safe recall preview</strong>',\n        '<pre>' + escapeHtml(data.safeRecallPreview ?? \"\") + '</pre>',\n      '</section>',\n      '<section class=\"section actions\">',\n        actionButtons(data.affordances),\n      '</section>',\n      memories.map((memory) => [\n        '<article class=\"memory\">',\n          '<div class=\"memory-title\"><span>' + escapeHtml(memory.id) + '</span><span class=\"' + statusClass(memory.safety) + '\">' + escapeHtml(memory.safety ?? \"safe\") + '</span></div>',\n          '<div class=\"preview\">' + escapeHtml(memory.preview ?? \"\") + '</div>',\n          '<div>',\n            '<span class=\"pill\">source ' + escapeHtml(memory.source ?? \"unknown\") + '</span>',\n            '<span class=\"pill\">scope ' + escapeHtml(memory.scope ?? \"unknown\") + '</span>',\n            '<span class=\"pill\">reason ' + escapeHtml(memory.retrievalReason ?? memory.servedBy ?? \"unknown\") + '</span>',\n            '<span class=\"pill\">confidence ' + escapeHtml(memory.confidence ?? \"n/a\") + '</span>',\n          '</div>',\n          '<div class=\"muted\">' + escapeHtml((memory.safetyReasons ?? []).join(\"; \")) + '</div>',\n        '</article>',\n      ].join(\"\")).join(\"\"),\n    ].join(\"\");\n\n    root.querySelectorAll(\"button[data-prompt]\").forEach((button) => {\n      button.addEventListener(\"click\", () => followUp(button.getAttribute(\"data-prompt\") ?? \"\"));\n    });\n  }\n\n  render(window.openai?.toolOutput);\n\n  window.addEventListener(\"message\", (event) => {\n    if (event.source !== window.parent) return;\n    const message = event.data;\n    if (!message || message.jsonrpc !== \"2.0\") return;\n    if (message.method === \"ui/notifications/tool-result\") {\n      render(message.params);\n    }\n  }, { passive: true });\n\n  window.addEventListener(\"openai:set_globals\", (event) => {\n    render(event.detail?.globals?.toolOutput ?? window.openai?.toolOutput);\n  }, { passive: true });\n</script>\n`.trim();\n\nfunction average(values: number[]): number | undefined {\n  if (values.length === 0) return undefined;\n  return values.reduce((sum, value) => sum + value, 0) / values.length;\n}\n\nfunction buildRecallProvenances(\n  recall: EngramAccessRecallResponse,\n  xray: RecallXraySnapshot | null,\n): RetrievedMemoryProvenance[] {\n  if (xray === null) {\n    return recall.results.map(missingRecallProvenance);\n  }\n  const matchXrayResult = buildXrayResultMatcher(xray);\n  return recall.results.map((summary) => {\n    const result = matchXrayResult(summary);\n    if (result === undefined) {\n      return missingXrayResultProvenance(summary);\n    }\n    return result.provenance ?? missingProvenance(result);\n  });\n}\n\nfunction buildXrayResultMatcher(\n  xray: RecallXraySnapshot | null,\n): (summary: EngramAccessRecallResponse[\"results\"][number]) => RecallXrayResult | undefined {\n  const xrayById = new Map<string, RecallXrayResult>();\n  const xrayByPath = new Map<string, RecallXrayResult>();\n  for (const result of xray?.results ?? []) {\n    xrayById.set(result.memoryId, result);\n    xrayByPath.set(result.path, result);\n  }\n  return (summary) => {\n    if (summary.path) {\n      return xrayByPath.get(summary.path);\n    }\n    return xrayById.get(summary.id);\n  };\n}\n\nfunction missingProvenance(result: RecallXrayResult): RetrievedMemoryProvenance {\n  return {\n    source: \"unknown\",\n    scope: \"unknown\",\n    userContextScopes: [],\n    retrievalReason: `X-ray provenance missing for ${result.memoryId || result.path}`,\n    confidence: 0,\n    stale: false,\n    corrected: false,\n    correctionState: \"none\",\n    safeToUse: false,\n    safety: \"blocked\",\n    safetyReasons: [\"X-ray provenance was missing for this memory.\"],\n  };\n}\n\nfunction missingXrayResultProvenance(\n  summary: EngramAccessRecallResponse[\"results\"][number],\n): RetrievedMemoryProvenance {\n  return {\n    source: \"unknown\",\n    scope: \"unknown\",\n    userContextScopes: [],\n    retrievalReason: `X-ray result missing for ${summary.path || summary.id}`,\n    confidence: 0,\n    stale: false,\n    corrected: false,\n    correctionState: \"none\",\n    safeToUse: false,\n    safety: \"blocked\",\n    safetyReasons: [\"X-ray result was missing for this recalled memory.\"],\n  };\n}\n\nfunction missingRecallProvenance(\n  summary: EngramAccessRecallResponse[\"results\"][number],\n): RetrievedMemoryProvenance {\n  return {\n    source: \"unknown\",\n    scope: \"unknown\",\n    userContextScopes: [],\n    retrievalReason: `X-ray provenance unavailable for ${summary.id || summary.path}`,\n    confidence: 0,\n    stale: false,\n    corrected: false,\n    correctionState: \"none\",\n    safeToUse: false,\n    safety: \"blocked\",\n    safetyReasons: [\"X-ray provenance was unavailable for this recall.\"],\n  };\n}\n\nfunction formatUnsafeRecallPreview(\n  blockedCount: number,\n  missingProvenanceCount: number,\n): string {\n  const reasons: string[] = [];\n  if (blockedCount > 0) {\n    reasons.push(`${blockedCount} retrieved ${memoryNoun(blockedCount)} ${isAre(blockedCount)} blocked`);\n  }\n  if (missingProvenanceCount > 0) {\n    reasons.push(\n      `${missingProvenanceCount} retrieved ${memoryNoun(missingProvenanceCount)} ${isAre(missingProvenanceCount)} missing X-ray provenance`,\n    );\n  }\n  return `Recall preview withheld: ${joinReasons(reasons)} in the current context.`;\n}\n\nfunction memoryNoun(count: number): string {\n  return count === 1 ? \"memory\" : \"memories\";\n}\n\nfunction isAre(count: number): string {\n  return count === 1 ? \"is\" : \"are\";\n}\n\nfunction joinReasons(reasons: string[]): string {\n  if (reasons.length <= 1) return reasons[0] ?? \"memory safety could not be verified\";\n  return `${reasons.slice(0, -1).join(\", \")} and ${reasons[reasons.length - 1]}`;\n}\n\nfunction truncate(value: string, maxChars: number): string {\n  if (value.length <= maxChars) return value;\n  return `${value.slice(0, Math.max(0, maxChars - 3))}...`;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-YFS5OEKO.js → chunk-7MLB4NCL.js}

@@ -9,7 +9,7 @@ import {
 import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier
-} from "./chunk-KGK2QKWL.js";
+} from "./chunk-4R4KTDIE.js";
 import {
   inferMemoryStatus,
   isArchivedMemoryPath,
@@ -5361,4 +5361,4 @@ export {
   serializeEntityFile,
   StorageManager
 };
-//# sourceMappingURL=chunk-YFS5OEKO.js.map
+//# sourceMappingURL=chunk-7MLB4NCL.js.map

package/dist/{chunk-IOTENEVL.js → chunk-7YQFWOF7.js}

@@ -1,24 +1,24 @@
+import {
+  chatgptReplayNormalizer
+} from "./chunk-MC4FJXPA.js";
 import {
   claudeReplayNormalizer
 } from "./chunk-LQHDIS7L.js";
 import {
   openclawReplayNormalizer
 } from "./chunk-7F7Z6MOS.js";
+import {
+  importMarkdownBundle
+} from "./chunk-HDDRVXX4.js";
 import {
   importSqlite
 } from "./chunk-4RR6ROTB.js";
-import {
-  chatgptReplayNormalizer
-} from "./chunk-MC4FJXPA.js";
 import {
   exportJsonBundle
 } from "./chunk-UP6MOYCB.js";
 import {
   exportSqlite
-} from "./chunk-XSWKORGM.js";
-import {
-  importMarkdownBundle
-} from "./chunk-HDDRVXX4.js";
+} from "./chunk-S53OYO3F.js";
 import {
   detectImportFormat
 } from "./chunk-OZKVVUJB.js";
@@ -27,7 +27,7 @@ import {
 } from "./chunk-2DL3OFLD.js";
 import {
   backupMemoryDir
-} from "./chunk-2NLLXCJG.js";
+} from "./chunk-BXLOS5AJ.js";
 import {
   exportMarkdownBundle
 } from "./chunk-765K3SAT.js";
@@ -36,29 +36,29 @@ import {
   clampBatchSize,
   runReplay
 } from "./chunk-HOJZMQ4J.js";
+import {
+  rebuildObservations
+} from "./chunk-LZZNTPLR.js";
 import {
   TailscaleHelper
 } from "./chunk-TKWGAOLV.js";
 import {
   WebDavServer
-} from "./chunk-UWY7GIVS.js";
+} from "./chunk-PYIFUBRK.js";
+import {
+  archiveObservations
+} from "./chunk-WMWVO45V.js";
 import {
   migrateObservations
 } from "./chunk-D6RIFG4O.js";
 import {
   rebuildMemoryLifecycleLedger
-} from "./chunk-557IAFPD.js";
+} from "./chunk-APRRL26Q.js";
 import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-MLT75J5S.js";
-import {
-  rebuildObservations
-} from "./chunk-LZZNTPLR.js";
-import {
-  archiveObservations
-} from "./chunk-WMWVO45V.js";
+} from "./chunk-B6SU7YSE.js";
 import {
   getBulkImportSource,
   listBulkImportSources,
@@ -70,18 +70,18 @@ import {
 } from "./chunk-YR6GIWWY.js";
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-IK34DVAC.js";
+} from "./chunk-CIOMS6DI.js";
 import {
   buildResumeBundleFromState,
   getResumeBundleStatus,
   recordResumeBundle
-} from "./chunk-NSKYFGDL.js";
+} from "./chunk-X4QQB7O6.js";
+import {
+  parseXrayCliOptions
+} from "./chunk-3QSU4NFF.js";
 import {
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
-import {
-  parseXrayCliOptions
-} from "./chunk-CF3ZF2YU.js";
 import {
   runBenchmarkRecall,
   runOperatorConfigReview,
@@ -89,12 +89,12 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-VJXSUAO7.js";
+} from "./chunk-TNOWU6RP.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-6JGNHWCI.js";
+} from "./chunk-OBIRVF36.js";
 import {
   collectPatternMemories,
   explainPatternMemory,
@@ -103,7 +103,7 @@ import {
   parseStrictCliDate,
   renderPatternExplain,
   renderPatternsList
-} from "./chunk-AJA46VX5.js";
+} from "./chunk-3T74IZB3.js";
 import {
   GraphDashboardServer
 } from "./chunk-YNDLCWXS.js";
@@ -113,24 +113,24 @@ import {
 } from "./chunk-2PRQG7PV.js";
 import {
   RoutingRulesStore
-} from "./chunk-HPWVAEET.js";
-import {
-  searchVerifiedEpisodes
-} from "./chunk-ZT3EGNLR.js";
+} from "./chunk-X6IRLNOO.js";
 import {
   getUtilityLearningStatus,
   learnUtilityPromotionWeights
-} from "./chunk-3BP57I6J.js";
+} from "./chunk-2F6NP3NT.js";
 import {
   getUtilityTelemetryStatus,
   recordUtilityTelemetryEvent
 } from "./chunk-TERNBNJB.js";
+import {
+  searchVerifiedEpisodes
+} from "./chunk-QPD426WT.js";
 import {
   ThreadingManager
 } from "./chunk-W4RVMTHR.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-GUPISBV2.js";
+} from "./chunk-PP2JH3GP.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -176,7 +176,7 @@ import {
   runEvalBenchmarkCiGate,
   runEvalStoredBaselineCiGate,
   validateEvalBenchmarkPack
-} from "./chunk-G3Z3QEF5.js";
+} from "./chunk-3PY7VHV7.js";
 import {
   getCueAnchorStoreStatus
 } from "./chunk-FZZ2QTJI.js";
@@ -203,33 +203,33 @@ import {
 } from "./chunk-4WMCPJWX.js";
 import {
   parseConfig
-} from "./chunk-NZPF2SYV.js";
+} from "./chunk-T7N6KQGS.js";
 import {
   getAbstractionNodeStoreStatus
 } from "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-5RPTH6AU.js";
+} from "./chunk-VPGUMLBA.js";
 import {
   EngramMcpServer
-} from "./chunk-TH67Q46T.js";
+} from "./chunk-B6FDZPCF.js";
 import {
   EngramAccessService
-} from "./chunk-2QANQKSQ.js";
+} from "./chunk-ADNZVFXG.js";
 import {
   WorkStorage
-} from "./chunk-L227SKTB.js";
+} from "./chunk-GDB4J2H3.js";
 import {
   parseRecallExplainFormat,
   renderRecallExplain,
   renderXray
-} from "./chunk-OXJBNGBK.js";
+} from "./chunk-PSUB67YB.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "./chunk-OI27U2HT.js";
+} from "./chunk-5BTCT236.js";
 import {
   getTrustZoneStoreStatus,
   promoteTrustZoneRecord,
@@ -244,7 +244,7 @@ import {
 import {
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-KGK2QKWL.js";
+} from "./chunk-4R4KTDIE.js";
 import {
   getCausalTrajectoryStoreStatus
 } from "./chunk-TQOU3VAT.js";
@@ -1791,7 +1791,8 @@ async function runAccessHttpServeCliCommand(options) {
       maxBodyBytes: input.maxBodyBytes,
       trustPrincipalHeader: input.trustPrincipalHeader,
       citationsEnabled: input.citationsEnabled,
-      citationsAutoDetect: input.citationsAutoDetect
+      citationsAutoDetect: input.citationsAutoDetect,
+      emitLegacyTools: input.emitLegacyTools
     }));
     const server = createServer(options);
     activeAccessHttpServer = server;
@@ -1823,8 +1824,12 @@ async function runAccessHttpStatusCliCommand() {
   });
 }
 async function runAccessMcpServeCliCommand(service, options = {}) {
-  const server = options.createServer?.(service, { principal: options.principal }) ?? new EngramMcpServer(service, {
-    principal: options.principal
+  const server = options.createServer?.(service, {
+    principal: options.principal,
+    emitLegacyTools: options.emitLegacyTools
+  }) ?? new EngramMcpServer(service, {
+    principal: options.principal,
+    emitLegacyTools: options.emitLegacyTools
   });
   await server.runStdio(options.stdin ?? process.stdin, options.stdout ?? process.stdout);
   return { ok: true };
@@ -2561,7 +2566,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
       );
       tierCmd.command("list").description("Summarize tier distribution across all memories").option("--json", "Emit machine-readable JSON only").action(async (...args) => {
         const options = args[0] ?? {};
-        const { summarizeTiers, formatTierSummaryText } = await import("./tier-stats-SKML2OSF.js");
+        const { summarizeTiers, formatTierSummaryText } = await import("./tier-stats-3LYQ3VV5.js");
         const summary = await summarizeTiers(orchestrator.storage);
         if (reportHasMachineReadableOutput(options)) {
           console.log(JSON.stringify(summary, null, 2));
@@ -2572,7 +2577,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
       tierCmd.command("explain").description("Explain the tier-transition decision for a single memory").argument("<id>", "Memory id to explain").option("--json", "Emit machine-readable JSON only").action(async (...args) => {
         const idArg = typeof args[0] === "string" ? args[0] : "";
         const options = args[1] ?? {};
-        const { explainTierForMemory, formatTierExplainText } = await import("./tier-stats-SKML2OSF.js");
+        const { explainTierForMemory, formatTierExplainText } = await import("./tier-stats-3LYQ3VV5.js");
         try {
           const explain = await explainTierForMemory(
             orchestrator.storage,
@@ -3090,7 +3095,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           }
         }
         if (sourceArchive.endsWith(".enc")) {
-          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-7FJQINUR.js");
+          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-YO5QJ6L3.js");
           const encDetected = await isEncryptedCapsuleFile(sourceArchive).catch(() => true);
           if (encDetected) {
             throw new Error(
@@ -3253,7 +3258,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           const { parseExportBundle } = await import("./transfer/types.js");
           let decryptedBuf;
           try {
-            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-7FJQINUR.js");
+            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-YO5QJ6L3.js");
             decryptedBuf = await decryptCapsuleFileInMemory(archivePath, memoryDir);
           } catch (decErr) {
             const msg = decErr instanceof Error ? decErr.message : String(decErr);
@@ -4718,7 +4723,8 @@ ${doc.content}` : doc.content,
           maxBodyBytes: Number.isFinite(maxBodyBytesRaw) ? maxBodyBytesRaw : 131072,
           trustPrincipalHeader: options.trustPrincipalHeader === true,
           citationsEnabled: orchestrator.config.citationsEnabled,
-          citationsAutoDetect: orchestrator.config.citationsAutoDetect
+          citationsAutoDetect: orchestrator.config.citationsAutoDetect,
+          emitLegacyTools: orchestrator.config.emitLegacyTools
         });
         console.log(JSON.stringify(status, null, 2));
         console.log("OK");
@@ -4737,7 +4743,8 @@ ${doc.content}` : doc.content,
       accessCmd.command("mcp-serve").description("Run the Engram MCP server over stdio").option("--principal <principal>", "Trusted principal (defaults to config/env)").action(async (...args) => {
         const options = args[0] ?? {};
         await runAccessMcpServeCliCommand(accessService, {
-          principal: resolveAccessPrincipalOverride(options.principal, orchestrator.config.agentAccessHttp.principal)
+          principal: resolveAccessPrincipalOverride(options.principal, orchestrator.config.agentAccessHttp.principal),
+          emitLegacyTools: orchestrator.config.emitLegacyTools
         });
       });
       const routeCmd = cmd.command("route").description("Manage custom memory routing rules");
@@ -6616,4 +6623,4 @@ export {
   resolveMemoryDirForNamespace,
   registerCli
 };
-//# sourceMappingURL=chunk-IOTENEVL.js.map
+//# sourceMappingURL=chunk-7YQFWOF7.js.map