@remnic/core 1.0.0

package/dist/chunk-YNI4S5WT.js

@@ -0,0 +1,143 @@
+import {
+  scanSignals
+} from "./chunk-XYIK4LF6.js";
+import {
+  log
+} from "./chunk-KWBU5S5U.js";
+
+// src/bootstrap.ts
+import path from "path";
+import { readdir, readFile } from "fs/promises";
+var BootstrapEngine = class {
+  constructor(config, orchestrator) {
+    this.config = config;
+    this.orchestrator = orchestrator;
+  }
+  config;
+  orchestrator;
+  async run(options) {
+    const dryRun = options.dryRun === true;
+    const since = options.since ?? /* @__PURE__ */ new Date(0);
+    const end = /* @__PURE__ */ new Date();
+    const limit = Math.max(0, options.limit ?? Number.POSITIVE_INFINITY);
+    const sessions = await this.resolveSessions(options.sessionsDir, since, end);
+    const selected = sessions.slice(0, Number.isFinite(limit) ? limit : sessions.length);
+    const beforeCount = dryRun ? 0 : (await this.orchestrator.storage.readAllMemories()).length;
+    let turnsProcessed = 0;
+    let highSignalTurns = 0;
+    let skipped = 0;
+    for (const session of selected) {
+      for (const entry of session.entries) {
+        if (entry.role !== "user") continue;
+        turnsProcessed += 1;
+        const content = typeof entry.content === "string" ? entry.content.trim() : "";
+        if (!content) {
+          skipped += 1;
+          continue;
+        }
+        const signal = scanSignals(content, this.config.highSignalPatterns);
+        if (signal.level !== "high") {
+          skipped += 1;
+          continue;
+        }
+        highSignalTurns += 1;
+        if (!dryRun) {
+          await this.orchestrator.processTurn("user", content, session.sessionKey);
+        }
+      }
+    }
+    let memoriesCreated = 0;
+    if (!dryRun && highSignalTurns > 0) {
+      await this.orchestrator.waitForExtractionIdle();
+      const afterCount = (await this.orchestrator.storage.readAllMemories()).length;
+      memoriesCreated = Math.max(0, afterCount - beforeCount);
+    }
+    const result = {
+      sessionsScanned: selected.length,
+      turnsProcessed,
+      highSignalTurns,
+      memoriesCreated,
+      skipped
+    };
+    log.info(
+      `bootstrap complete: sessions=${result.sessionsScanned}, turns=${result.turnsProcessed}, high=${result.highSignalTurns}, created=${result.memoriesCreated}, skipped=${result.skipped}, dryRun=${dryRun}`
+    );
+    return result;
+  }
+  async resolveSessions(sessionsDir, since, until) {
+    if (sessionsDir && sessionsDir.trim().length > 0) {
+      return this.readSessionsFromDir(sessionsDir, since, until);
+    }
+    const keys = await this.orchestrator.transcript.listSessionKeys();
+    const sessions = [];
+    for (const key of keys) {
+      const entries = await this.orchestrator.transcript.readRange(
+        since.toISOString(),
+        until.toISOString(),
+        key
+      );
+      if (entries.length > 0) {
+        sessions.push({ sessionKey: key, entries });
+      }
+    }
+    return sessions;
+  }
+  async readSessionsFromDir(baseDir, since, until) {
+    const files = await this.listJsonlFiles(baseDir);
+    const bySession = /* @__PURE__ */ new Map();
+    for (const filePath of files) {
+      let raw = "";
+      try {
+        raw = await readFile(filePath, "utf-8");
+      } catch {
+        continue;
+      }
+      const lines = raw.split("\n").filter((line) => line.trim().length > 0);
+      for (const line of lines) {
+        let parsed;
+        try {
+          parsed = JSON.parse(line);
+        } catch {
+          continue;
+        }
+        const ts = new Date(String(parsed?.timestamp ?? ""));
+        if (Number.isNaN(ts.getTime())) continue;
+        if (ts < since || ts > until) continue;
+        const role = String(parsed?.role ?? "");
+        const content = typeof parsed?.content === "string" ? parsed.content : "";
+        if (!role || !content) continue;
+        const sessionKey = typeof parsed?.sessionKey === "string" && parsed.sessionKey.length > 0 ? parsed.sessionKey : path.relative(baseDir, filePath);
+        const list = bySession.get(sessionKey) ?? [];
+        list.push({
+          role,
+          content,
+          timestamp: ts.toISOString(),
+          sessionKey
+        });
+        bySession.set(sessionKey, list);
+      }
+    }
+    return Array.from(bySession.entries()).map(([sessionKey, entries]) => ({
+      sessionKey,
+      entries: entries.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime())
+    }));
+  }
+  async listJsonlFiles(dir) {
+    const out = [];
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        out.push(...await this.listJsonlFiles(full));
+      } else if (entry.isFile() && full.endsWith(".jsonl")) {
+        out.push(full);
+      }
+    }
+    return out;
+  }
+};
+
+export {
+  BootstrapEngine
+};
+//# sourceMappingURL=chunk-YNI4S5WT.js.map

package/dist/chunk-YNI4S5WT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bootstrap.ts"],"sourcesContent":["import path from \"node:path\";\nimport { readdir, readFile } from \"node:fs/promises\";\nimport { scanSignals } from \"./signal.js\";\nimport { log } from \"./logger.js\";\nimport type { PluginConfig } from \"./types.js\";\nimport type { Orchestrator } from \"./orchestrator.js\";\n\nexport type BootstrapResult = {\n  sessionsScanned: number;\n  turnsProcessed: number;\n  highSignalTurns: number;\n  memoriesCreated: number;\n  skipped: number;\n};\n\nexport type BootstrapOptions = {\n  dryRun?: boolean;\n  sessionsDir?: string;\n  limit?: number;\n  since?: Date;\n};\n\ntype BootstrapEntry = {\n  role: string;\n  content: string;\n  timestamp: string;\n  sessionKey?: string;\n};\n\nexport class BootstrapEngine {\n  constructor(private config: PluginConfig, private orchestrator: Orchestrator) {}\n\n  async run(options: BootstrapOptions): Promise<BootstrapResult> {\n    const dryRun = options.dryRun === true;\n    const since = options.since ?? new Date(0);\n    const end = new Date();\n    const limit = Math.max(0, options.limit ?? Number.POSITIVE_INFINITY);\n\n    const sessions = await this.resolveSessions(options.sessionsDir, since, end);\n    const selected = sessions.slice(0, Number.isFinite(limit) ? limit : sessions.length);\n\n    const beforeCount = dryRun ? 0 : (await this.orchestrator.storage.readAllMemories()).length;\n    let turnsProcessed = 0;\n    let highSignalTurns = 0;\n    let skipped = 0;\n\n    for (const session of selected) {\n      for (const entry of session.entries) {\n        if (entry.role !== \"user\") continue;\n        turnsProcessed += 1;\n\n        const content = typeof entry.content === \"string\" ? entry.content.trim() : \"\";\n        if (!content) {\n          skipped += 1;\n          continue;\n        }\n\n        const signal = scanSignals(content, this.config.highSignalPatterns);\n        if (signal.level !== \"high\") {\n          skipped += 1;\n          continue;\n        }\n\n        highSignalTurns += 1;\n        if (!dryRun) {\n          await this.orchestrator.processTurn(\"user\", content, session.sessionKey);\n        }\n      }\n    }\n\n    let memoriesCreated = 0;\n    if (!dryRun && highSignalTurns > 0) {\n      await this.orchestrator.waitForExtractionIdle();\n      const afterCount = (await this.orchestrator.storage.readAllMemories()).length;\n      memoriesCreated = Math.max(0, afterCount - beforeCount);\n    }\n\n    const result: BootstrapResult = {\n      sessionsScanned: selected.length,\n      turnsProcessed,\n      highSignalTurns,\n      memoriesCreated,\n      skipped,\n    };\n    log.info(\n      `bootstrap complete: sessions=${result.sessionsScanned}, turns=${result.turnsProcessed}, high=${result.highSignalTurns}, created=${result.memoriesCreated}, skipped=${result.skipped}, dryRun=${dryRun}`,\n    );\n    return result;\n  }\n\n  private async resolveSessions(\n    sessionsDir: string | undefined,\n    since: Date,\n    until: Date,\n  ): Promise<Array<{ sessionKey: string; entries: BootstrapEntry[] }>> {\n    if (sessionsDir && sessionsDir.trim().length > 0) {\n      return this.readSessionsFromDir(sessionsDir, since, until);\n    }\n\n    const keys = await this.orchestrator.transcript.listSessionKeys();\n    const sessions: Array<{ sessionKey: string; entries: BootstrapEntry[] }> = [];\n    for (const key of keys) {\n      const entries = await this.orchestrator.transcript.readRange(\n        since.toISOString(),\n        until.toISOString(),\n        key,\n      );\n      if (entries.length > 0) {\n        sessions.push({ sessionKey: key, entries });\n      }\n    }\n    return sessions;\n  }\n\n  private async readSessionsFromDir(\n    baseDir: string,\n    since: Date,\n    until: Date,\n  ): Promise<Array<{ sessionKey: string; entries: BootstrapEntry[] }>> {\n    const files = await this.listJsonlFiles(baseDir);\n    const bySession = new Map<string, BootstrapEntry[]>();\n\n    for (const filePath of files) {\n      let raw = \"\";\n      try {\n        raw = await readFile(filePath, \"utf-8\");\n      } catch {\n        continue;\n      }\n      const lines = raw.split(\"\\n\").filter((line) => line.trim().length > 0);\n      for (const line of lines) {\n        let parsed: any;\n        try {\n          parsed = JSON.parse(line);\n        } catch {\n          continue;\n        }\n        const ts = new Date(String(parsed?.timestamp ?? \"\"));\n        if (Number.isNaN(ts.getTime())) continue;\n        if (ts < since || ts > until) continue;\n        const role = String(parsed?.role ?? \"\");\n        const content = typeof parsed?.content === \"string\" ? parsed.content : \"\";\n        if (!role || !content) continue;\n        const sessionKey = typeof parsed?.sessionKey === \"string\" && parsed.sessionKey.length > 0\n          ? parsed.sessionKey\n          : path.relative(baseDir, filePath);\n        const list = bySession.get(sessionKey) ?? [];\n        list.push({\n          role,\n          content,\n          timestamp: ts.toISOString(),\n          sessionKey,\n        });\n        bySession.set(sessionKey, list);\n      }\n    }\n\n    return Array.from(bySession.entries()).map(([sessionKey, entries]) => ({\n      sessionKey,\n      entries: entries.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime()),\n    }));\n  }\n\n  private async listJsonlFiles(dir: string): Promise<string[]> {\n    const out: string[] = [];\n    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);\n    for (const entry of entries) {\n      const full = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        out.push(...(await this.listJsonlFiles(full)));\n      } else if (entry.isFile() && full.endsWith(\".jsonl\")) {\n        out.push(full);\n      }\n    }\n    return out;\n  }\n}\n\n"],"mappings":"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","names":[]}

package/dist/chunk-YRMVARQP.js

@@ -0,0 +1,406 @@
+// src/session-integrity.ts
+import path from "path";
+import { readFile, readdir, unlink, writeFile } from "fs/promises";
+function isObjectRecord(input) {
+  return Boolean(input) && typeof input === "object";
+}
+function isTranscriptEntry(raw) {
+  if (!isObjectRecord(raw)) return false;
+  if (raw.role !== "user" && raw.role !== "assistant") return false;
+  return typeof raw.timestamp === "string" && raw.timestamp.length > 0 && typeof raw.content === "string" && typeof raw.sessionKey === "string" && raw.sessionKey.length > 0 && typeof raw.turnId === "string" && raw.turnId.length > 0;
+}
+async function listTranscriptFiles(memoryDir) {
+  const transcriptsDir = path.join(memoryDir, "transcripts");
+  const out = [];
+  const stack = [transcriptsDir];
+  while (stack.length > 0) {
+    const dir = stack.pop();
+    if (!dir) continue;
+    let entries;
+    try {
+      entries = await readdir(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(fullPath);
+      } else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+        out.push(fullPath);
+      }
+    }
+  }
+  return out.sort((a, b) => a.localeCompare(b));
+}
+async function parseTranscriptFile(filePath) {
+  const bySession = /* @__PURE__ */ new Map();
+  const malformed = [];
+  const invalid = [];
+  const invalidBySession = /* @__PURE__ */ new Map();
+  let raw = "";
+  try {
+    raw = await readFile(filePath, "utf-8");
+  } catch {
+    return { bySession, malformed, invalid, invalidBySession };
+  }
+  const lines = raw.split("\n");
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index]?.trim() ?? "";
+    if (!line) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch {
+      malformed.push({
+        code: "transcript_malformed_line",
+        severity: "warn",
+        message: "Transcript line is not valid JSON.",
+        filePath,
+        line: index + 1
+      });
+      continue;
+    }
+    if (!isTranscriptEntry(parsed)) {
+      const sessionKey = isObjectRecord(parsed) && typeof parsed.sessionKey === "string" && parsed.sessionKey.length > 0 ? parsed.sessionKey : void 0;
+      invalid.push({
+        code: "transcript_invalid_entry",
+        severity: "warn",
+        message: "Transcript entry is missing required fields.",
+        filePath,
+        line: index + 1,
+        sessionKey
+      });
+      if (sessionKey) {
+        invalidBySession.set(sessionKey, (invalidBySession.get(sessionKey) ?? 0) + 1);
+      }
+      continue;
+    }
+    const list = bySession.get(parsed.sessionKey) ?? [];
+    list.push({ filePath, lineNumber: index + 1, entry: parsed });
+    bySession.set(parsed.sessionKey, list);
+  }
+  return { bySession, malformed, invalid, invalidBySession };
+}
+function analyzeSessionEntries(sessionKey, refs) {
+  function parseTimestampForSort(timestamp) {
+    const parsed = Date.parse(timestamp);
+    if (Number.isFinite(parsed)) return parsed;
+    return Number.MAX_SAFE_INTEGER;
+  }
+  const issues = [];
+  const sorted = [...refs].sort((a, b) => {
+    const tsA = parseTimestampForSort(a.entry.timestamp);
+    const tsB = parseTimestampForSort(b.entry.timestamp);
+    if (tsA !== tsB) return tsA - tsB;
+    const rawTimestampCmp = a.entry.timestamp.localeCompare(b.entry.timestamp);
+    if (rawTimestampCmp !== 0) return rawTimestampCmp;
+    return a.entry.turnId.localeCompare(b.entry.turnId);
+  });
+  const turnIdSeen = /* @__PURE__ */ new Set();
+  let duplicateTurnIds = 0;
+  let brokenChains = 0;
+  for (let i = 0; i < sorted.length; i += 1) {
+    const current = sorted[i];
+    if (turnIdSeen.has(current.entry.turnId)) {
+      duplicateTurnIds += 1;
+      issues.push({
+        code: "transcript_duplicate_turn_id",
+        severity: "warn",
+        message: `Duplicate turnId detected: ${current.entry.turnId}`,
+        sessionKey,
+        filePath: current.filePath,
+        line: current.lineNumber
+      });
+    } else {
+      turnIdSeen.add(current.entry.turnId);
+    }
+    if (i > 0) {
+      const previous = sorted[i - 1];
+      if (previous && previous.entry.role === current.entry.role) {
+        brokenChains += 1;
+        issues.push({
+          code: "transcript_broken_chain",
+          severity: "warn",
+          message: `Adjacent turns have the same role (${current.entry.role}).`,
+          sessionKey,
+          filePath: current.filePath,
+          line: current.lineNumber
+        });
+      }
+    }
+  }
+  let incompleteTurns = 0;
+  if (sorted.length > 0 && sorted[sorted.length - 1]?.entry.role === "user") {
+    incompleteTurns = 1;
+    const last = sorted[sorted.length - 1];
+    issues.push({
+      code: "transcript_incomplete_turn",
+      severity: "warn",
+      message: "Session ends on a user turn without assistant response.",
+      sessionKey,
+      filePath: last?.filePath,
+      line: last?.lineNumber
+    });
+  }
+  return {
+    stats: {
+      sessionKey,
+      entries: sorted.length,
+      malformedLines: 0,
+      invalidEntries: 0,
+      duplicateTurnIds,
+      brokenChains,
+      incompleteTurns
+    },
+    issues
+  };
+}
+function validateCheckpointRaw(checkpoint) {
+  if (!isObjectRecord(checkpoint)) return false;
+  return typeof checkpoint.sessionKey === "string" && checkpoint.sessionKey.length > 0 && typeof checkpoint.capturedAt === "string" && typeof checkpoint.ttl === "string" && Array.isArray(checkpoint.turns);
+}
+async function analyzeCheckpoint(memoryDir) {
+  const checkpointPath = path.join(memoryDir, "state", "checkpoint.json");
+  const issues = [];
+  const checkpoint = {
+    present: false,
+    healthy: true,
+    path: checkpointPath
+  };
+  let raw = "";
+  try {
+    raw = await readFile(checkpointPath, "utf-8");
+  } catch {
+    issues.push({
+      code: "checkpoint_missing",
+      severity: "info",
+      message: "No checkpoint file present.",
+      filePath: checkpointPath
+    });
+    return { checkpoint, issues };
+  }
+  checkpoint.present = true;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    checkpoint.healthy = false;
+    issues.push({
+      code: "checkpoint_invalid_json",
+      severity: "error",
+      message: "Checkpoint file is invalid JSON.",
+      filePath: checkpointPath
+    });
+    return { checkpoint, issues };
+  }
+  if (!validateCheckpointRaw(parsed)) {
+    checkpoint.healthy = false;
+    issues.push({
+      code: "checkpoint_invalid_metadata",
+      severity: "error",
+      message: "Checkpoint file is missing required metadata fields.",
+      filePath: checkpointPath
+    });
+    return { checkpoint, issues };
+  }
+  checkpoint.sessionKey = parsed.sessionKey;
+  checkpoint.expiresAt = parsed.ttl;
+  const ttlMs = Date.parse(parsed.ttl);
+  const capturedAtMs = Date.parse(parsed.capturedAt);
+  if (!Number.isFinite(ttlMs) || !Number.isFinite(capturedAtMs) || ttlMs <= capturedAtMs) {
+    checkpoint.healthy = false;
+    issues.push({
+      code: "checkpoint_invalid_metadata",
+      severity: "error",
+      message: "Checkpoint timestamps are invalid or inconsistent.",
+      filePath: checkpointPath,
+      sessionKey: parsed.sessionKey
+    });
+    return { checkpoint, issues };
+  }
+  if (ttlMs < Date.now()) {
+    checkpoint.healthy = false;
+    issues.push({
+      code: "checkpoint_expired",
+      severity: "warn",
+      message: "Checkpoint TTL has expired.",
+      filePath: checkpointPath,
+      sessionKey: parsed.sessionKey
+    });
+  }
+  for (const turn of parsed.turns) {
+    if (!isTranscriptEntry(turn)) {
+      checkpoint.healthy = false;
+      issues.push({
+        code: "checkpoint_invalid_metadata",
+        severity: "error",
+        message: "Checkpoint contains invalid turn entries.",
+        filePath: checkpointPath,
+        sessionKey: parsed.sessionKey
+      });
+      break;
+    }
+  }
+  return { checkpoint, issues };
+}
+async function analyzeSessionIntegrity(options) {
+  const memoryDir = options.memoryDir;
+  const reportIssues = [];
+  const allSessionRefs = /* @__PURE__ */ new Map();
+  const invalidBySession = /* @__PURE__ */ new Map();
+  const sessions = /* @__PURE__ */ new Map();
+  const files = await listTranscriptFiles(memoryDir);
+  for (const filePath of files) {
+    const parsed = await parseTranscriptFile(filePath);
+    reportIssues.push(...parsed.malformed, ...parsed.invalid);
+    for (const [sessionKey, count] of parsed.invalidBySession.entries()) {
+      invalidBySession.set(sessionKey, (invalidBySession.get(sessionKey) ?? 0) + count);
+    }
+    for (const [sessionKey, refs] of parsed.bySession.entries()) {
+      const existing = allSessionRefs.get(sessionKey) ?? [];
+      existing.push(...refs);
+      allSessionRefs.set(sessionKey, existing);
+    }
+  }
+  for (const [sessionKey, refs] of allSessionRefs.entries()) {
+    const analyzed = analyzeSessionEntries(sessionKey, refs);
+    reportIssues.push(...analyzed.issues);
+    sessions.set(sessionKey, {
+      ...analyzed.stats,
+      malformedLines: 0,
+      invalidEntries: invalidBySession.get(sessionKey) ?? 0
+    });
+  }
+  const checkpoint = await analyzeCheckpoint(memoryDir);
+  reportIssues.push(...checkpoint.issues);
+  const severeIssueCount = reportIssues.filter((issue) => issue.severity !== "info").length;
+  return {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    memoryDir,
+    healthy: severeIssueCount === 0,
+    sessions: [...sessions.values()].sort((a, b) => a.sessionKey.localeCompare(b.sessionKey)),
+    checkpoint: checkpoint.checkpoint,
+    issues: reportIssues
+  };
+}
+function collectTranscriptRewriteTargets(report) {
+  const set = /* @__PURE__ */ new Set();
+  for (const issue of report.issues) {
+    if (!issue.filePath) continue;
+    if (issue.code === "transcript_malformed_line" || issue.code === "transcript_invalid_entry") {
+      set.add(issue.filePath);
+    }
+  }
+  return [...set].sort((a, b) => a.localeCompare(b));
+}
+function planSessionRepair(options) {
+  const actions = [];
+  const transcriptTargets = collectTranscriptRewriteTargets(options.report);
+  for (const targetPath of transcriptTargets) {
+    actions.push({
+      kind: "rewrite_transcript",
+      targetPath,
+      description: "Rewrite transcript file with only valid JSON transcript entries."
+    });
+  }
+  const checkpointNeedsRepair = options.report.issues.some(
+    (issue) => issue.code === "checkpoint_invalid_json" || issue.code === "checkpoint_invalid_metadata" || issue.code === "checkpoint_expired"
+  );
+  if (checkpointNeedsRepair && options.report.checkpoint.present) {
+    actions.push({
+      kind: "remove_checkpoint",
+      targetPath: options.report.checkpoint.path,
+      description: "Remove invalid or expired checkpoint file."
+    });
+  }
+  if (options.sessionFilesDir && options.allowSessionFileRepair === true) {
+    actions.push({
+      kind: "repair_session_files",
+      targetPath: options.sessionFilesDir,
+      description: "Session file repair was requested; no automatic rewiring is performed.",
+      details: "No-op by design. OpenClaw session files require explicit manual review."
+    });
+  }
+  return {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    dryRun: options.dryRun,
+    allowSessionFileRepair: options.allowSessionFileRepair === true,
+    actions
+  };
+}
+async function rewriteTranscriptFile(targetPath) {
+  let raw = "";
+  try {
+    raw = await readFile(targetPath, "utf-8");
+  } catch {
+    return;
+  }
+  const lines = raw.split("\n");
+  const validLines = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (!isTranscriptEntry(parsed)) continue;
+      validLines.push(JSON.stringify(parsed));
+    } catch {
+    }
+  }
+  const body = validLines.length > 0 ? `${validLines.join("\n")}
+` : "";
+  await writeFile(targetPath, body, "utf-8");
+}
+async function applySessionRepair(options) {
+  const { plan } = options;
+  if (plan.dryRun) {
+    return {
+      applied: false,
+      actionsAttempted: plan.actions.length,
+      actionsApplied: 0,
+      errors: []
+    };
+  }
+  let actionsApplied = 0;
+  const errors = [];
+  for (const action of plan.actions) {
+    try {
+      if (action.kind === "rewrite_transcript") {
+        await rewriteTranscriptFile(action.targetPath);
+        actionsApplied += 1;
+        continue;
+      }
+      if (action.kind === "remove_checkpoint") {
+        try {
+          await unlink(action.targetPath);
+        } catch (err) {
+          const code = typeof err === "object" && err && "code" in err ? String(err.code ?? "") : "";
+          if (code !== "ENOENT") {
+            throw err;
+          }
+        }
+        actionsApplied += 1;
+        continue;
+      }
+      if (action.kind === "repair_session_files") {
+        actionsApplied += 1;
+      }
+    } catch (err) {
+      errors.push(`Failed ${action.kind} ${action.targetPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  return {
+    applied: true,
+    actionsAttempted: plan.actions.length,
+    actionsApplied,
+    errors
+  };
+}
+
+export {
+  analyzeSessionIntegrity,
+  planSessionRepair,
+  applySessionRepair
+};
+//# sourceMappingURL=chunk-YRMVARQP.js.map

package/dist/chunk-YRMVARQP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-integrity.ts"],"sourcesContent":["import path from \"node:path\";\nimport { readFile, readdir, unlink, writeFile } from \"node:fs/promises\";\nimport type { Checkpoint, TranscriptEntry } from \"./types.js\";\n\nexport type SessionIntegrityIssueCode =\n  | \"transcript_malformed_line\"\n  | \"transcript_invalid_entry\"\n  | \"transcript_duplicate_turn_id\"\n  | \"transcript_broken_chain\"\n  | \"transcript_incomplete_turn\"\n  | \"checkpoint_missing\"\n  | \"checkpoint_invalid_json\"\n  | \"checkpoint_invalid_metadata\"\n  | \"checkpoint_expired\";\n\nexport interface SessionIntegrityIssue {\n  code: SessionIntegrityIssueCode;\n  severity: \"info\" | \"warn\" | \"error\";\n  message: string;\n  filePath?: string;\n  line?: number;\n  sessionKey?: string;\n}\n\nexport interface SessionTranscriptStats {\n  sessionKey: string;\n  entries: number;\n  malformedLines: number;\n  invalidEntries: number;\n  duplicateTurnIds: number;\n  brokenChains: number;\n  incompleteTurns: number;\n}\n\nexport interface SessionIntegrityReport {\n  generatedAt: string;\n  memoryDir: string;\n  healthy: boolean;\n  sessions: SessionTranscriptStats[];\n  checkpoint: {\n    present: boolean;\n    healthy: boolean;\n    path: string;\n    sessionKey?: string;\n    expiresAt?: string;\n  };\n  issues: SessionIntegrityIssue[];\n}\n\ntype SessionEntryRef = {\n  filePath: string;\n  lineNumber: number;\n  entry: TranscriptEntry;\n};\n\ntype FileSessionParse = {\n  bySession: Map<string, SessionEntryRef[]>;\n  malformed: SessionIntegrityIssue[];\n  invalid: SessionIntegrityIssue[];\n  invalidBySession: Map<string, number>;\n};\n\nexport interface SessionRepairAction {\n  kind: \"rewrite_transcript\" | \"remove_checkpoint\" | \"repair_session_files\";\n  description: string;\n  targetPath: string;\n  details?: string;\n}\n\nexport interface SessionRepairPlan {\n  generatedAt: string;\n  dryRun: boolean;\n  allowSessionFileRepair: boolean;\n  actions: SessionRepairAction[];\n}\n\nexport interface SessionRepairApplyResult {\n  applied: boolean;\n  actionsAttempted: number;\n  actionsApplied: number;\n  errors: string[];\n}\n\nexport interface AnalyzeSessionIntegrityOptions {\n  memoryDir: string;\n}\n\nexport interface PlanSessionRepairOptions {\n  report: SessionIntegrityReport;\n  dryRun: boolean;\n  allowSessionFileRepair?: boolean;\n  sessionFilesDir?: string;\n}\n\nexport interface ApplySessionRepairOptions {\n  plan: SessionRepairPlan;\n}\n\nfunction isObjectRecord(input: unknown): input is Record<string, unknown> {\n  return Boolean(input) && typeof input === \"object\";\n}\n\nfunction isTranscriptEntry(raw: unknown): raw is TranscriptEntry {\n  if (!isObjectRecord(raw)) return false;\n  if (raw.role !== \"user\" && raw.role !== \"assistant\") return false;\n  return (\n    typeof raw.timestamp === \"string\" &&\n    raw.timestamp.length > 0 &&\n    typeof raw.content === \"string\" &&\n    typeof raw.sessionKey === \"string\" &&\n    raw.sessionKey.length > 0 &&\n    typeof raw.turnId === \"string\" &&\n    raw.turnId.length > 0\n  );\n}\n\nasync function listTranscriptFiles(memoryDir: string): Promise<string[]> {\n  const transcriptsDir = path.join(memoryDir, \"transcripts\");\n  const out: string[] = [];\n  const stack = [transcriptsDir];\n  while (stack.length > 0) {\n    const dir = stack.pop();\n    if (!dir) continue;\n    let entries: Array<{ name: string; isDirectory(): boolean; isFile(): boolean }>;\n    try {\n      entries = await readdir(dir, { withFileTypes: true });\n    } catch {\n      continue;\n    }\n    for (const entry of entries) {\n      const fullPath = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        stack.push(fullPath);\n      } else if (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n        out.push(fullPath);\n      }\n    }\n  }\n  return out.sort((a, b) => a.localeCompare(b));\n}\n\nasync function parseTranscriptFile(filePath: string): Promise<FileSessionParse> {\n  const bySession = new Map<string, SessionEntryRef[]>();\n  const malformed: SessionIntegrityIssue[] = [];\n  const invalid: SessionIntegrityIssue[] = [];\n  const invalidBySession = new Map<string, number>();\n\n  let raw = \"\";\n  try {\n    raw = await readFile(filePath, \"utf-8\");\n  } catch {\n    return { bySession, malformed, invalid, invalidBySession };\n  }\n\n  const lines = raw.split(\"\\n\");\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index]?.trim() ?? \"\";\n    if (!line) continue;\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(line);\n    } catch {\n      malformed.push({\n        code: \"transcript_malformed_line\",\n        severity: \"warn\",\n        message: \"Transcript line is not valid JSON.\",\n        filePath,\n        line: index + 1,\n      });\n      continue;\n    }\n    if (!isTranscriptEntry(parsed)) {\n      const sessionKey =\n        isObjectRecord(parsed) &&\n        typeof parsed.sessionKey === \"string\" &&\n        parsed.sessionKey.length > 0\n          ? parsed.sessionKey\n          : undefined;\n      invalid.push({\n        code: \"transcript_invalid_entry\",\n        severity: \"warn\",\n        message: \"Transcript entry is missing required fields.\",\n        filePath,\n        line: index + 1,\n        sessionKey,\n      });\n      if (sessionKey) {\n        invalidBySession.set(sessionKey, (invalidBySession.get(sessionKey) ?? 0) + 1);\n      }\n      continue;\n    }\n\n    const list = bySession.get(parsed.sessionKey) ?? [];\n    list.push({ filePath, lineNumber: index + 1, entry: parsed });\n    bySession.set(parsed.sessionKey, list);\n  }\n  return { bySession, malformed, invalid, invalidBySession };\n}\n\nfunction analyzeSessionEntries(\n  sessionKey: string,\n  refs: SessionEntryRef[],\n): { stats: SessionTranscriptStats; issues: SessionIntegrityIssue[] } {\n  function parseTimestampForSort(timestamp: string): number {\n    const parsed = Date.parse(timestamp);\n    if (Number.isFinite(parsed)) return parsed;\n    return Number.MAX_SAFE_INTEGER;\n  }\n\n  const issues: SessionIntegrityIssue[] = [];\n  const sorted = [...refs].sort((a, b) => {\n    const tsA = parseTimestampForSort(a.entry.timestamp);\n    const tsB = parseTimestampForSort(b.entry.timestamp);\n    if (tsA !== tsB) return tsA - tsB;\n    const rawTimestampCmp = a.entry.timestamp.localeCompare(b.entry.timestamp);\n    if (rawTimestampCmp !== 0) return rawTimestampCmp;\n    return a.entry.turnId.localeCompare(b.entry.turnId);\n  });\n  const turnIdSeen = new Set<string>();\n  let duplicateTurnIds = 0;\n  let brokenChains = 0;\n\n  for (let i = 0; i < sorted.length; i += 1) {\n    const current = sorted[i];\n    if (turnIdSeen.has(current.entry.turnId)) {\n      duplicateTurnIds += 1;\n      issues.push({\n        code: \"transcript_duplicate_turn_id\",\n        severity: \"warn\",\n        message: `Duplicate turnId detected: ${current.entry.turnId}`,\n        sessionKey,\n        filePath: current.filePath,\n        line: current.lineNumber,\n      });\n    } else {\n      turnIdSeen.add(current.entry.turnId);\n    }\n\n    if (i > 0) {\n      const previous = sorted[i - 1];\n      if (previous && previous.entry.role === current.entry.role) {\n        brokenChains += 1;\n        issues.push({\n          code: \"transcript_broken_chain\",\n          severity: \"warn\",\n          message: `Adjacent turns have the same role (${current.entry.role}).`,\n          sessionKey,\n          filePath: current.filePath,\n          line: current.lineNumber,\n        });\n      }\n    }\n  }\n\n  let incompleteTurns = 0;\n  if (sorted.length > 0 && sorted[sorted.length - 1]?.entry.role === \"user\") {\n    incompleteTurns = 1;\n    const last = sorted[sorted.length - 1];\n    issues.push({\n      code: \"transcript_incomplete_turn\",\n      severity: \"warn\",\n      message: \"Session ends on a user turn without assistant response.\",\n      sessionKey,\n      filePath: last?.filePath,\n      line: last?.lineNumber,\n    });\n  }\n\n  return {\n    stats: {\n      sessionKey,\n      entries: sorted.length,\n      malformedLines: 0,\n      invalidEntries: 0,\n      duplicateTurnIds,\n      brokenChains,\n      incompleteTurns,\n    },\n    issues,\n  };\n}\n\nfunction validateCheckpointRaw(checkpoint: unknown): checkpoint is Checkpoint {\n  if (!isObjectRecord(checkpoint)) return false;\n  return (\n    typeof checkpoint.sessionKey === \"string\" &&\n    checkpoint.sessionKey.length > 0 &&\n    typeof checkpoint.capturedAt === \"string\" &&\n    typeof checkpoint.ttl === \"string\" &&\n    Array.isArray(checkpoint.turns)\n  );\n}\n\nasync function analyzeCheckpoint(memoryDir: string): Promise<{\n  checkpoint: SessionIntegrityReport[\"checkpoint\"];\n  issues: SessionIntegrityIssue[];\n}> {\n  const checkpointPath = path.join(memoryDir, \"state\", \"checkpoint.json\");\n  const issues: SessionIntegrityIssue[] = [];\n  const checkpoint: SessionIntegrityReport[\"checkpoint\"] = {\n    present: false,\n    healthy: true,\n    path: checkpointPath,\n  };\n\n  let raw = \"\";\n  try {\n    raw = await readFile(checkpointPath, \"utf-8\");\n  } catch {\n    issues.push({\n      code: \"checkpoint_missing\",\n      severity: \"info\",\n      message: \"No checkpoint file present.\",\n      filePath: checkpointPath,\n    });\n    return { checkpoint, issues };\n  }\n\n  checkpoint.present = true;\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    checkpoint.healthy = false;\n    issues.push({\n      code: \"checkpoint_invalid_json\",\n      severity: \"error\",\n      message: \"Checkpoint file is invalid JSON.\",\n      filePath: checkpointPath,\n    });\n    return { checkpoint, issues };\n  }\n\n  if (!validateCheckpointRaw(parsed)) {\n    checkpoint.healthy = false;\n    issues.push({\n      code: \"checkpoint_invalid_metadata\",\n      severity: \"error\",\n      message: \"Checkpoint file is missing required metadata fields.\",\n      filePath: checkpointPath,\n    });\n    return { checkpoint, issues };\n  }\n\n  checkpoint.sessionKey = parsed.sessionKey;\n  checkpoint.expiresAt = parsed.ttl;\n\n  const ttlMs = Date.parse(parsed.ttl);\n  const capturedAtMs = Date.parse(parsed.capturedAt);\n  if (!Number.isFinite(ttlMs) || !Number.isFinite(capturedAtMs) || ttlMs <= capturedAtMs) {\n    checkpoint.healthy = false;\n    issues.push({\n      code: \"checkpoint_invalid_metadata\",\n      severity: \"error\",\n      message: \"Checkpoint timestamps are invalid or inconsistent.\",\n      filePath: checkpointPath,\n      sessionKey: parsed.sessionKey,\n    });\n    return { checkpoint, issues };\n  }\n\n  if (ttlMs < Date.now()) {\n    checkpoint.healthy = false;\n    issues.push({\n      code: \"checkpoint_expired\",\n      severity: \"warn\",\n      message: \"Checkpoint TTL has expired.\",\n      filePath: checkpointPath,\n      sessionKey: parsed.sessionKey,\n    });\n  }\n\n  for (const turn of parsed.turns) {\n    if (!isTranscriptEntry(turn)) {\n      checkpoint.healthy = false;\n      issues.push({\n        code: \"checkpoint_invalid_metadata\",\n        severity: \"error\",\n        message: \"Checkpoint contains invalid turn entries.\",\n        filePath: checkpointPath,\n        sessionKey: parsed.sessionKey,\n      });\n      break;\n    }\n  }\n\n  return { checkpoint, issues };\n}\n\nexport async function analyzeSessionIntegrity(\n  options: AnalyzeSessionIntegrityOptions,\n): Promise<SessionIntegrityReport> {\n  const memoryDir = options.memoryDir;\n  const reportIssues: SessionIntegrityIssue[] = [];\n  const allSessionRefs = new Map<string, SessionEntryRef[]>();\n  const invalidBySession = new Map<string, number>();\n  const sessions = new Map<string, SessionTranscriptStats>();\n\n  const files = await listTranscriptFiles(memoryDir);\n  for (const filePath of files) {\n    const parsed = await parseTranscriptFile(filePath);\n    reportIssues.push(...parsed.malformed, ...parsed.invalid);\n    for (const [sessionKey, count] of parsed.invalidBySession.entries()) {\n      invalidBySession.set(sessionKey, (invalidBySession.get(sessionKey) ?? 0) + count);\n    }\n\n    for (const [sessionKey, refs] of parsed.bySession.entries()) {\n      const existing = allSessionRefs.get(sessionKey) ?? [];\n      existing.push(...refs);\n      allSessionRefs.set(sessionKey, existing);\n    }\n  }\n\n  for (const [sessionKey, refs] of allSessionRefs.entries()) {\n    const analyzed = analyzeSessionEntries(sessionKey, refs);\n    reportIssues.push(...analyzed.issues);\n    sessions.set(sessionKey, {\n      ...analyzed.stats,\n      malformedLines: 0,\n      invalidEntries: invalidBySession.get(sessionKey) ?? 0,\n    });\n  }\n\n  const checkpoint = await analyzeCheckpoint(memoryDir);\n  reportIssues.push(...checkpoint.issues);\n\n  const severeIssueCount = reportIssues.filter((issue) => issue.severity !== \"info\").length;\n\n  return {\n    generatedAt: new Date().toISOString(),\n    memoryDir,\n    healthy: severeIssueCount === 0,\n    sessions: [...sessions.values()].sort((a, b) => a.sessionKey.localeCompare(b.sessionKey)),\n    checkpoint: checkpoint.checkpoint,\n    issues: reportIssues,\n  };\n}\n\nfunction collectTranscriptRewriteTargets(report: SessionIntegrityReport): string[] {\n  const set = new Set<string>();\n  for (const issue of report.issues) {\n    if (!issue.filePath) continue;\n    if (\n      issue.code === \"transcript_malformed_line\" ||\n      issue.code === \"transcript_invalid_entry\"\n    ) {\n      set.add(issue.filePath);\n    }\n  }\n  return [...set].sort((a, b) => a.localeCompare(b));\n}\n\nexport function planSessionRepair(options: PlanSessionRepairOptions): SessionRepairPlan {\n  const actions: SessionRepairAction[] = [];\n  const transcriptTargets = collectTranscriptRewriteTargets(options.report);\n  for (const targetPath of transcriptTargets) {\n    actions.push({\n      kind: \"rewrite_transcript\",\n      targetPath,\n      description: \"Rewrite transcript file with only valid JSON transcript entries.\",\n    });\n  }\n\n  const checkpointNeedsRepair = options.report.issues.some((issue) =>\n    issue.code === \"checkpoint_invalid_json\" ||\n    issue.code === \"checkpoint_invalid_metadata\" ||\n    issue.code === \"checkpoint_expired\"\n  );\n  if (checkpointNeedsRepair && options.report.checkpoint.present) {\n    actions.push({\n      kind: \"remove_checkpoint\",\n      targetPath: options.report.checkpoint.path,\n      description: \"Remove invalid or expired checkpoint file.\",\n    });\n  }\n\n  if (options.sessionFilesDir && options.allowSessionFileRepair === true) {\n    actions.push({\n      kind: \"repair_session_files\",\n      targetPath: options.sessionFilesDir,\n      description: \"Session file repair was requested; no automatic rewiring is performed.\",\n      details: \"No-op by design. OpenClaw session files require explicit manual review.\",\n    });\n  }\n\n  return {\n    generatedAt: new Date().toISOString(),\n    dryRun: options.dryRun,\n    allowSessionFileRepair: options.allowSessionFileRepair === true,\n    actions,\n  };\n}\n\nasync function rewriteTranscriptFile(targetPath: string): Promise<void> {\n  let raw = \"\";\n  try {\n    raw = await readFile(targetPath, \"utf-8\");\n  } catch {\n    return;\n  }\n  const lines = raw.split(\"\\n\");\n  const validLines: string[] = [];\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n    try {\n      const parsed = JSON.parse(trimmed);\n      if (!isTranscriptEntry(parsed)) continue;\n      validLines.push(JSON.stringify(parsed));\n    } catch {\n      // drop malformed lines\n    }\n  }\n  const body = validLines.length > 0 ? `${validLines.join(\"\\n\")}\\n` : \"\";\n  await writeFile(targetPath, body, \"utf-8\");\n}\n\nexport async function applySessionRepair(\n  options: ApplySessionRepairOptions,\n): Promise<SessionRepairApplyResult> {\n  const { plan } = options;\n  if (plan.dryRun) {\n    return {\n      applied: false,\n      actionsAttempted: plan.actions.length,\n      actionsApplied: 0,\n      errors: [],\n    };\n  }\n\n  let actionsApplied = 0;\n  const errors: string[] = [];\n\n  for (const action of plan.actions) {\n    try {\n      if (action.kind === \"rewrite_transcript\") {\n        await rewriteTranscriptFile(action.targetPath);\n        actionsApplied += 1;\n        continue;\n      }\n      if (action.kind === \"remove_checkpoint\") {\n        try {\n          await unlink(action.targetPath);\n        } catch (err) {\n          const code = typeof err === \"object\" && err && \"code\" in err ? String((err as { code?: unknown }).code ?? \"\") : \"\";\n          if (code !== \"ENOENT\") {\n            throw err;\n          }\n        }\n        actionsApplied += 1;\n        continue;\n      }\n      if (action.kind === \"repair_session_files\") {\n        // intentionally no-op; pointer/session rewiring is explicitly forbidden here.\n        actionsApplied += 1;\n      }\n    } catch (err) {\n      errors.push(`Failed ${action.kind} ${action.targetPath}: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  return {\n    applied: true,\n    actionsAttempted: plan.actions.length,\n    actionsApplied,\n    errors,\n  };\n}\n"],"mappings":";AAAA,OAAO,UAAU;AACjB,SAAS,UAAU,SAAS,QAAQ,iBAAiB;AAiGrD,SAAS,eAAe,OAAkD;AACxE,SAAO,QAAQ,KAAK,KAAK,OAAO,UAAU;AAC5C;AAEA,SAAS,kBAAkB,KAAsC;AAC/D,MAAI,CAAC,eAAe,GAAG,EAAG,QAAO;AACjC,MAAI,IAAI,SAAS,UAAU,IAAI,SAAS,YAAa,QAAO;AAC5D,SACE,OAAO,IAAI,cAAc,YACzB,IAAI,UAAU,SAAS,KACvB,OAAO,IAAI,YAAY,YACvB,OAAO,IAAI,eAAe,YAC1B,IAAI,WAAW,SAAS,KACxB,OAAO,IAAI,WAAW,YACtB,IAAI,OAAO,SAAS;AAExB;AAEA,eAAe,oBAAoB,WAAsC;AACvE,QAAM,iBAAiB,KAAK,KAAK,WAAW,aAAa;AACzD,QAAM,MAAgB,CAAC;AACvB,QAAM,QAAQ,CAAC,cAAc;AAC7B,SAAO,MAAM,SAAS,GAAG;AACvB,UAAM,MAAM,MAAM,IAAI;AACtB,QAAI,CAAC,IAAK;AACV,QAAI;AACJ,QAAI;AACF,gBAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;AAAA,IACtD,QAAQ;AACN;AAAA,IACF;AACA,eAAW,SAAS,SAAS;AAC3B,YAAM,WAAW,KAAK,KAAK,KAAK,MAAM,IAAI;AAC1C,UAAI,MAAM,YAAY,GAAG;AACvB,cAAM,KAAK,QAAQ;AAAA,MACrB,WAAW,MAAM,OAAO,KAAK,MAAM,KAAK,SAAS,QAAQ,GAAG;AAC1D,YAAI,KAAK,QAAQ;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACA,SAAO,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAC9C;AAEA,eAAe,oBAAoB,UAA6C;AAC9E,QAAM,YAAY,oBAAI,IAA+B;AACrD,QAAM,YAAqC,CAAC;AAC5C,QAAM,UAAmC,CAAC;AAC1C,QAAM,mBAAmB,oBAAI,IAAoB;AAEjD,MAAI,MAAM;AACV,MAAI;AACF,UAAM,MAAM,SAAS,UAAU,OAAO;AAAA,EACxC,QAAQ;AACN,WAAO,EAAE,WAAW,WAAW,SAAS,iBAAiB;AAAA,EAC3D;AAEA,QAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,UAAM,OAAO,MAAM,KAAK,GAAG,KAAK,KAAK;AACrC,QAAI,CAAC,KAAM;AACX,QAAI;AACJ,QAAI;AACF,eAAS,KAAK,MAAM,IAAI;AAAA,IAC1B,QAAQ;AACN,gBAAU,KAAK;AAAA,QACb,MAAM;AAAA,QACN,UAAU;AAAA,QACV,SAAS;AAAA,QACT;AAAA,QACA,MAAM,QAAQ;AAAA,MAChB,CAAC;AACD;AAAA,IACF;AACA,QAAI,CAAC,kBAAkB,MAAM,GAAG;AAC9B,YAAM,aACJ,eAAe,MAAM,KACrB,OAAO,OAAO,eAAe,YAC7B,OAAO,WAAW,SAAS,IACvB,OAAO,aACP;AACN,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,UAAU;AAAA,QACV,SAAS;AAAA,QACT;AAAA,QACA,MAAM,QAAQ;AAAA,QACd;AAAA,MACF,CAAC;AACD,UAAI,YAAY;AACd,yBAAiB,IAAI,aAAa,iBAAiB,IAAI,UAAU,KAAK,KAAK,CAAC;AAAA,MAC9E;AACA;AAAA,IACF;AAEA,UAAM,OAAO,UAAU,IAAI,OAAO,UAAU,KAAK,CAAC;AAClD,SAAK,KAAK,EAAE,UAAU,YAAY,QAAQ,GAAG,OAAO,OAAO,CAAC;AAC5D,cAAU,IAAI,OAAO,YAAY,IAAI;AAAA,EACvC;AACA,SAAO,EAAE,WAAW,WAAW,SAAS,iBAAiB;AAC3D;AAEA,SAAS,sBACP,YACA,MACoE;AACpE,WAAS,sBAAsB,WAA2B;AACxD,UAAM,SAAS,KAAK,MAAM,SAAS;AACnC,QAAI,OAAO,SAAS,MAAM,EAAG,QAAO;AACpC,WAAO,OAAO;AAAA,EAChB;AAEA,QAAM,SAAkC,CAAC;AACzC,QAAM,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM;AACtC,UAAM,MAAM,sBAAsB,EAAE,MAAM,SAAS;AACnD,UAAM,MAAM,sBAAsB,EAAE,MAAM,SAAS;AACnD,QAAI,QAAQ,IAAK,QAAO,MAAM;AAC9B,UAAM,kBAAkB,EAAE,MAAM,UAAU,cAAc,EAAE,MAAM,SAAS;AACzE,QAAI,oBAAoB,EAAG,QAAO;AAClC,WAAO,EAAE,MAAM,OAAO,cAAc,EAAE,MAAM,MAAM;AAAA,EACpD,CAAC;AACD,QAAM,aAAa,oBAAI,IAAY;AACnC,MAAI,mBAAmB;AACvB,MAAI,eAAe;AAEnB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,UAAU,OAAO,CAAC;AACxB,QAAI,WAAW,IAAI,QAAQ,MAAM,MAAM,GAAG;AACxC,0BAAoB;AACpB,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,UAAU;AAAA,QACV,SAAS,8BAA8B,QAAQ,MAAM,MAAM;AAAA,QAC3D;AAAA,QACA,UAAU,QAAQ;AAAA,QAClB,MAAM,QAAQ;AAAA,MAChB,CAAC;AAAA,IACH,OAAO;AACL,iBAAW,IAAI,QAAQ,MAAM,MAAM;AAAA,IACrC;AAEA,QAAI,IAAI,GAAG;AACT,YAAM,WAAW,OAAO,IAAI,CAAC;AAC7B,UAAI,YAAY,SAAS,MAAM,SAAS,QAAQ,MAAM,MAAM;AAC1D,wBAAgB;AAChB,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,UAAU;AAAA,UACV,SAAS,sCAAsC,QAAQ,MAAM,IAAI;AAAA,UACjE;AAAA,UACA,UAAU,QAAQ;AAAA,UAClB,MAAM,QAAQ;AAAA,QAChB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,MAAI,kBAAkB;AACtB,MAAI,OAAO,SAAS,KAAK,OAAO,OAAO,SAAS,CAAC,GAAG,MAAM,SAAS,QAAQ;AACzE,sBAAkB;AAClB,UAAM,OAAO,OAAO,OAAO,SAAS,CAAC;AACrC,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT;AAAA,MACA,UAAU,MAAM;AAAA,MAChB,MAAM,MAAM;AAAA,IACd,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA,SAAS,OAAO;AAAA,MAChB,gBAAgB;AAAA,MAChB,gBAAgB;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,sBAAsB,YAA+C;AAC5E,MAAI,CAAC,eAAe,UAAU,EAAG,QAAO;AACxC,SACE,OAAO,WAAW,eAAe,YACjC,WAAW,WAAW,SAAS,KAC/B,OAAO,WAAW,eAAe,YACjC,OAAO,WAAW,QAAQ,YAC1B,MAAM,QAAQ,WAAW,KAAK;AAElC;AAEA,eAAe,kBAAkB,WAG9B;AACD,QAAM,iBAAiB,KAAK,KAAK,WAAW,SAAS,iBAAiB;AACtE,QAAM,SAAkC,CAAC;AACzC,QAAM,aAAmD;AAAA,IACvD,SAAS;AAAA,IACT,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AAEA,MAAI,MAAM;AACV,MAAI;AACF,UAAM,MAAM,SAAS,gBAAgB,OAAO;AAAA,EAC9C,QAAQ;AACN,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AACD,WAAO,EAAE,YAAY,OAAO;AAAA,EAC9B;AAEA,aAAW,UAAU;AAErB,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,GAAG;AAAA,EACzB,QAAQ;AACN,eAAW,UAAU;AACrB,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AACD,WAAO,EAAE,YAAY,OAAO;AAAA,EAC9B;AAEA,MAAI,CAAC,sBAAsB,MAAM,GAAG;AAClC,eAAW,UAAU;AACrB,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AACD,WAAO,EAAE,YAAY,OAAO;AAAA,EAC9B;AAEA,aAAW,aAAa,OAAO;AAC/B,aAAW,YAAY,OAAO;AAE9B,QAAM,QAAQ,KAAK,MAAM,OAAO,GAAG;AACnC,QAAM,eAAe,KAAK,MAAM,OAAO,UAAU;AACjD,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,SAAS,YAAY,KAAK,SAAS,cAAc;AACtF,eAAW,UAAU;AACrB,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,UAAU;AAAA,MACV,YAAY,OAAO;AAAA,IACrB,CAAC;AACD,WAAO,EAAE,YAAY,OAAO;AAAA,EAC9B;AAEA,MAAI,QAAQ,KAAK,IAAI,GAAG;AACtB,eAAW,UAAU;AACrB,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,UAAU;AAAA,MACV,SAAS;AAAA,MACT,UAAU;AAAA,MACV,YAAY,OAAO;AAAA,IACrB,CAAC;AAAA,EACH;AAEA,aAAW,QAAQ,OAAO,OAAO;AAC/B,QAAI,CAAC,kBAAkB,IAAI,GAAG;AAC5B,iBAAW,UAAU;AACrB,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,UAAU;AAAA,QACV,SAAS;AAAA,QACT,UAAU;AAAA,QACV,YAAY,OAAO;AAAA,MACrB,CAAC;AACD;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,YAAY,OAAO;AAC9B;AAEA,eAAsB,wBACpB,SACiC;AACjC,QAAM,YAAY,QAAQ;AAC1B,QAAM,eAAwC,CAAC;AAC/C,QAAM,iBAAiB,oBAAI,IAA+B;AAC1D,QAAM,mBAAmB,oBAAI,IAAoB;AACjD,QAAM,WAAW,oBAAI,IAAoC;AAEzD,QAAM,QAAQ,MAAM,oBAAoB,SAAS;AACjD,aAAW,YAAY,OAAO;AAC5B,UAAM,SAAS,MAAM,oBAAoB,QAAQ;AACjD,iBAAa,KAAK,GAAG,OAAO,WAAW,GAAG,OAAO,OAAO;AACxD,eAAW,CAAC,YAAY,KAAK,KAAK,OAAO,iBAAiB,QAAQ,GAAG;AACnE,uBAAiB,IAAI,aAAa,iBAAiB,IAAI,UAAU,KAAK,KAAK,KAAK;AAAA,IAClF;AAEA,eAAW,CAAC,YAAY,IAAI,KAAK,OAAO,UAAU,QAAQ,GAAG;AAC3D,YAAM,WAAW,eAAe,IAAI,UAAU,KAAK,CAAC;AACpD,eAAS,KAAK,GAAG,IAAI;AACrB,qBAAe,IAAI,YAAY,QAAQ;AAAA,IACzC;AAAA,EACF;AAEA,aAAW,CAAC,YAAY,IAAI,KAAK,eAAe,QAAQ,GAAG;AACzD,UAAM,WAAW,sBAAsB,YAAY,IAAI;AACvD,iBAAa,KAAK,GAAG,SAAS,MAAM;AACpC,aAAS,IAAI,YAAY;AAAA,MACvB,GAAG,SAAS;AAAA,MACZ,gBAAgB;AAAA,MAChB,gBAAgB,iBAAiB,IAAI,UAAU,KAAK;AAAA,IACtD,CAAC;AAAA,EACH;AAEA,QAAM,aAAa,MAAM,kBAAkB,SAAS;AACpD,eAAa,KAAK,GAAG,WAAW,MAAM;AAEtC,QAAM,mBAAmB,aAAa,OAAO,CAAC,UAAU,MAAM,aAAa,MAAM,EAAE;AAEnF,SAAO;AAAA,IACL,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC;AAAA,IACA,SAAS,qBAAqB;AAAA,IAC9B,UAAU,CAAC,GAAG,SAAS,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,cAAc,EAAE,UAAU,CAAC;AAAA,IACxF,YAAY,WAAW;AAAA,IACvB,QAAQ;AAAA,EACV;AACF;AAEA,SAAS,gCAAgC,QAA0C;AACjF,QAAM,MAAM,oBAAI,IAAY;AAC5B,aAAW,SAAS,OAAO,QAAQ;AACjC,QAAI,CAAC,MAAM,SAAU;AACrB,QACE,MAAM,SAAS,+BACf,MAAM,SAAS,4BACf;AACA,UAAI,IAAI,MAAM,QAAQ;AAAA,IACxB;AAAA,EACF;AACA,SAAO,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AACnD;AAEO,SAAS,kBAAkB,SAAsD;AACtF,QAAM,UAAiC,CAAC;AACxC,QAAM,oBAAoB,gCAAgC,QAAQ,MAAM;AACxE,aAAW,cAAc,mBAAmB;AAC1C,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN;AAAA,MACA,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AAEA,QAAM,wBAAwB,QAAQ,OAAO,OAAO;AAAA,IAAK,CAAC,UACxD,MAAM,SAAS,6BACf,MAAM,SAAS,iCACf,MAAM,SAAS;AAAA,EACjB;AACA,MAAI,yBAAyB,QAAQ,OAAO,WAAW,SAAS;AAC9D,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,YAAY,QAAQ,OAAO,WAAW;AAAA,MACtC,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,mBAAmB,QAAQ,2BAA2B,MAAM;AACtE,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,YAAY,QAAQ;AAAA,MACpB,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,QAAQ,QAAQ;AAAA,IAChB,wBAAwB,QAAQ,2BAA2B;AAAA,IAC3D;AAAA,EACF;AACF;AAEA,eAAe,sBAAsB,YAAmC;AACtE,MAAI,MAAM;AACV,MAAI;AACF,UAAM,MAAM,SAAS,YAAY,OAAO;AAAA,EAC1C,QAAQ;AACN;AAAA,EACF;AACA,QAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,QAAM,aAAuB,CAAC;AAC9B,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAU,KAAK,KAAK;AAC1B,QAAI,CAAC,QAAS;AACd,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,OAAO;AACjC,UAAI,CAAC,kBAAkB,MAAM,EAAG;AAChC,iBAAW,KAAK,KAAK,UAAU,MAAM,CAAC;AAAA,IACxC,QAAQ;AAAA,IAER;AAAA,EACF;AACA,QAAM,OAAO,WAAW,SAAS,IAAI,GAAG,WAAW,KAAK,IAAI,CAAC;AAAA,IAAO;AACpE,QAAM,UAAU,YAAY,MAAM,OAAO;AAC3C;AAEA,eAAsB,mBACpB,SACmC;AACnC,QAAM,EAAE,KAAK,IAAI;AACjB,MAAI,KAAK,QAAQ;AACf,WAAO;AAAA,MACL,SAAS;AAAA,MACT,kBAAkB,KAAK,QAAQ;AAAA,MAC/B,gBAAgB;AAAA,MAChB,QAAQ,CAAC;AAAA,IACX;AAAA,EACF;AAEA,MAAI,iBAAiB;AACrB,QAAM,SAAmB,CAAC;AAE1B,aAAW,UAAU,KAAK,SAAS;AACjC,QAAI;AACF,UAAI,OAAO,SAAS,sBAAsB;AACxC,cAAM,sBAAsB,OAAO,UAAU;AAC7C,0BAAkB;AAClB;AAAA,MACF;AACA,UAAI,OAAO,SAAS,qBAAqB;AACvC,YAAI;AACF,gBAAM,OAAO,OAAO,UAAU;AAAA,QAChC,SAAS,KAAK;AACZ,gBAAM,OAAO,OAAO,QAAQ,YAAY,OAAO,UAAU,MAAM,OAAQ,IAA2B,QAAQ,EAAE,IAAI;AAChH,cAAI,SAAS,UAAU;AACrB,kBAAM;AAAA,UACR;AAAA,QACF;AACA,0BAAkB;AAClB;AAAA,MACF;AACA,UAAI,OAAO,SAAS,wBAAwB;AAE1C,0BAAkB;AAAA,MACpB;AAAA,IACF,SAAS,KAAK;AACZ,aAAO,KAAK,UAAU,OAAO,IAAI,IAAI,OAAO,UAAU,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC,EAAE;AAAA,IAC/G;AAAA,EACF;AAEA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,kBAAkB,KAAK,QAAQ;AAAA,IAC/B;AAAA,IACA;AAAA,EACF;AACF;","names":[]}