@remnic/core 1.1.30 → 9.3.515

package/dist/chunk-PU44GBL4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bulk-import/types.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Bulk-import pipeline types and validation\n// ---------------------------------------------------------------------------\n\nimport { parseIsoOffsetTimestamp } from \"../utils/iso-timestamp.js\";\n\nexport interface BulkImportSource {\n  turns: ImportTurn[];\n  metadata: {\n    source: string;\n    exportDate: string;\n    messageCount: number;\n    dateRange: { from: string; to: string };\n  };\n}\n\nexport interface ImportTurn {\n  role: \"user\" | \"assistant\" | \"other\";\n  content: string;\n  timestamp: string;\n  participantId?: string;\n  participantName?: string;\n  replyToId?: string;\n  parts?: import(\"../message-parts/index.js\").LcmMessagePartInput[];\n  rawContent?: unknown;\n  sourceFormat?: import(\"../message-parts/index.js\").MessagePartSourceFormat;\n  importProvenance?: ImportTurnProvenance;\n}\n\nexport interface ImportTurnProvenance {\n  sourceLabel?: string;\n  sourceId?: string;\n  sourceTimestamp?: string;\n  importedFromPath?: string;\n  importedAt?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface BulkImportOptions {\n  batchSize?: number;\n  dryRun?: boolean;\n  dedup?: boolean;\n  trustLevel?: \"import\";\n  namespace?: string;\n}\n\nexport type ImportSourceRole = ImportTurn[\"role\"];\n\nexport interface BulkImportResult {\n  memoriesCreated: number;\n  duplicatesSkipped: number;\n  entitiesCreated: number;\n  turnsProcessed: number;\n  batchesProcessed: number;\n  errors: BulkImportError[];\n}\n\nexport interface BulkImportError {\n  batchIndex: number;\n  message: string;\n}\n\nexport interface BulkImportSourceAdapter {\n  name: string;\n  parse(\n    input: unknown,\n    options?: { strict?: boolean; platform?: string },\n  ): Promise<BulkImportSource> | BulkImportSource;\n}\n\n// ---------------------------------------------------------------------------\n// Validation helpers\n// ---------------------------------------------------------------------------\n\nconst VALID_ROLES: ReadonlySet<string> = new Set([\"user\", \"assistant\", \"other\"]);\n\nexport interface ImportTurnValidationIssue {\n  code: string;\n  message: string;\n  index?: number;\n}\n\nexport function isImportRole(value: unknown): value is ImportSourceRole {\n  return typeof value === \"string\" && VALID_ROLES.has(value);\n}\n\n/**\n * Parse an ISO-8601 / RFC 3339 timestamp used by bulk-import adapters.\n *\n * Accepts variable-precision fractional seconds and either a `Z` suffix or a\n * `[+-]HH:MM` timezone offset, so adapters may preserve their source\n * timestamps verbatim. Returns milliseconds since epoch, or `null` if the\n * string is not a well-formed timestamp (including overflowed calendar dates\n * or out-of-range offsets).\n *\n * Delegates to the shared parser in `utils/iso-timestamp.ts` — do not\n * reimplement locally; extend that helper instead.\n */\nexport function parseIsoTimestamp(value: string): number | null {\n  return parseIsoOffsetTimestamp(value);\n}\n\nexport function validateImportTurn(\n  turn: ImportTurn,\n  index?: number,\n): ImportTurnValidationIssue[] {\n  const issues: ImportTurnValidationIssue[] = [];\n\n  if (!turn || typeof turn !== \"object\") {\n    issues.push({\n      code: \"turn.invalid\",\n      message: \"Import turn must be an object.\",\n      index,\n    });\n    return issues;\n  }\n\n  if (!isImportRole(turn.role)) {\n    issues.push({\n      code: \"turn.role.invalid\",\n      message:\n        `Import turn role must be 'user', 'assistant', or 'other', ` +\n        `received '${String(turn.role)}'.`,\n      index,\n    });\n  }\n\n  if (\n    !turn.content ||\n    typeof turn.content !== \"string\" ||\n    turn.content.trim().length === 0\n  ) {\n    issues.push({\n      code: \"turn.content.invalid\",\n      message: \"Import turn content must be a non-empty string.\",\n      index,\n    });\n  }\n\n  if (\n    !turn.timestamp ||\n    typeof turn.timestamp !== \"string\" ||\n    parseIsoTimestamp(turn.timestamp) === null\n  ) {\n    issues.push({\n      code: \"turn.timestamp.invalid\",\n      message:\n        `Import turn timestamp must be a valid ISO timestamp, ` +\n        `received '${String(turn.timestamp)}'.`,\n      index,\n    });\n  }\n\n  return issues;\n}\n"],"mappings":";;;;;AA0EA,IAAM,cAAmC,oBAAI,IAAI,CAAC,QAAQ,aAAa,OAAO,CAAC;AAQxE,SAAS,aAAa,OAA2C;AACtE,SAAO,OAAO,UAAU,YAAY,YAAY,IAAI,KAAK;AAC3D;AAcO,SAAS,kBAAkB,OAA8B;AAC9D,SAAO,wBAAwB,KAAK;AACtC;AAEO,SAAS,mBACd,MACA,OAC6B;AAC7B,QAAM,SAAsC,CAAC;AAE7C,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,MACT;AAAA,IACF,CAAC;AACD,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,aAAa,KAAK,IAAI,GAAG;AAC5B,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,SACE,uEACa,OAAO,KAAK,IAAI,CAAC;AAAA,MAChC;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MACE,CAAC,KAAK,WACN,OAAO,KAAK,YAAY,YACxB,KAAK,QAAQ,KAAK,EAAE,WAAW,GAC/B;AACA,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,MACT;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MACE,CAAC,KAAK,aACN,OAAO,KAAK,cAAc,YAC1B,kBAAkB,KAAK,SAAS,MAAM,MACtC;AACA,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,SACE,kEACa,OAAO,KAAK,SAAS,CAAC;AAAA,MACrC;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/{chunk-MJFNCJXV.js → chunk-Q4CAQGKQ.js}

@@ -1,6 +1,6 @@
 // src/search/document-scanner.ts
 import path from "path";
-import { readdir, readFile } from "fs/promises";
+import { lstat, readdir, readFile, realpath } from "fs/promises";
 function parseFrontmatter(raw) {
   const normalized = raw.replace(/\r\n/g, "\n");
   const match = normalized.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
@@ -17,17 +17,30 @@ function parseFrontmatter(raw) {
   }
   return { data, body };
 }
-async function scanDir(dir) {
+async function scanDir(dir, memoryRootReal) {
   const docs = [];
   try {
+    const dirStat = await lstat(dir);
+    if (dirStat.isSymbolicLink()) {
+      throw new Error(`Refusing to scan symlinked memory category directory: ${dir}`);
+    }
+    if (!dirStat.isDirectory()) {
+      const error = new Error(`Memory category path is not a directory: ${dir}`);
+      error.code = "ENOTDIR";
+      throw error;
+    }
+    assertPathInsideRoot(memoryRootReal, await realpath(dir), dir);
     const entries = await readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
+      if (entry.isSymbolicLink()) continue;
       const fullPath = path.join(dir, entry.name);
       if (entry.isDirectory()) {
-        const sub = await scanDir(fullPath);
+        assertPathInsideRoot(memoryRootReal, await realpath(fullPath), fullPath);
+        const sub = await scanDir(fullPath, memoryRootReal);
         docs.push(...sub);
       } else if (entry.name.endsWith(".md")) {
         try {
+          assertPathInsideRoot(memoryRootReal, await realpath(fullPath), fullPath);
           const raw = await readFile(fullPath, "utf-8");
           const parsed = parseFrontmatter(raw);
           const body = parsed ? parsed.body : raw.trim();
@@ -42,20 +55,45 @@ async function scanDir(dir) {
         }
       }
     }
-  } catch {
+  } catch (err) {
+    if (isNodeError(err) && err.code === "ENOENT") {
+      return docs;
+    }
+    throw err;
   }
   return docs;
 }
+function isNodeError(err) {
+  return typeof err === "object" && err !== null && "code" in err;
+}
+function pathIsInside(parent, child) {
+  const relative = path.relative(parent, child);
+  return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+function assertPathInsideRoot(rootReal, candidateReal, originalPath) {
+  if (!pathIsInside(rootReal, candidateReal)) {
+    throw new Error(`Refusing to scan memory path outside memoryDir: ${originalPath}`);
+  }
+}
 async function scanMemoryDir(memoryDir) {
+  let memoryRootReal;
+  try {
+    memoryRootReal = await realpath(memoryDir);
+  } catch (err) {
+    if (isNodeError(err) && err.code === "ENOENT") {
+      return [];
+    }
+    throw err;
+  }
   const factsDir = path.join(memoryDir, "facts");
   const correctionsDir = path.join(memoryDir, "corrections");
   const proceduresDir = path.join(memoryDir, "procedures");
   const reasoningTracesDir = path.join(memoryDir, "reasoning-traces");
   const [facts, corrections, procedures, reasoningTraces] = await Promise.all([
-    scanDir(factsDir),
-    scanDir(correctionsDir),
-    scanDir(proceduresDir),
-    scanDir(reasoningTracesDir)
+    scanDir(factsDir, memoryRootReal),
+    scanDir(correctionsDir, memoryRootReal),
+    scanDir(proceduresDir, memoryRootReal),
+    scanDir(reasoningTracesDir, memoryRootReal)
   ]);
   return [...facts, ...corrections, ...procedures, ...reasoningTraces];
 }
@@ -63,4 +101,4 @@ async function scanMemoryDir(memoryDir) {
 export {
   scanMemoryDir
 };
-//# sourceMappingURL=chunk-MJFNCJXV.js.map
+//# sourceMappingURL=chunk-Q4CAQGKQ.js.map

package/dist/chunk-Q4CAQGKQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search/document-scanner.ts"],"sourcesContent":["import path from \"node:path\";\nimport { lstat, readdir, readFile, realpath } from \"node:fs/promises\";\n\nexport interface IndexableDocument {\n  /** Memory ID from frontmatter or filename stem */\n  docid: string;\n  /** Absolute file path */\n  path: string;\n  /** Markdown body (no YAML frontmatter) */\n  content: string;\n  /** First ~200 chars for display */\n  snippet: string;\n}\n\n/**\n * Parse YAML frontmatter from a markdown string.\n * Returns the frontmatter key-value pairs and body, or null if no frontmatter block.\n */\nfunction parseFrontmatter(raw: string): { data: Record<string, string>; body: string } | null {\n  // Support both LF and CRLF line endings\n  const normalized = raw.replace(/\\r\\n/g, \"\\n\");\n  const match = normalized.match(/^---\\n([\\s\\S]*?)\\n---\\n?([\\s\\S]*)$/);\n  if (!match) return null;\n\n  const fmBlock = match[1];\n  const body = (match[2] ?? \"\").trim();\n  const data: Record<string, string> = {};\n\n  for (const line of fmBlock.split(\"\\n\")) {\n    const colonIdx = line.indexOf(\":\");\n    if (colonIdx === -1) continue;\n    const key = line.slice(0, colonIdx).trim();\n    const value = line.slice(colonIdx + 1).trim();\n    data[key] = value;\n  }\n\n  return { data, body };\n}\n\n/**\n * Recursively scan a directory for `.md` files and return IndexableDocuments.\n */\nasync function scanDir(dir: string, memoryRootReal: string): Promise<IndexableDocument[]> {\n  const docs: IndexableDocument[] = [];\n  try {\n    const dirStat = await lstat(dir);\n    if (dirStat.isSymbolicLink()) {\n      throw new Error(`Refusing to scan symlinked memory category directory: ${dir}`);\n    }\n    if (!dirStat.isDirectory()) {\n      const error = new Error(`Memory category path is not a directory: ${dir}`) as NodeJS.ErrnoException;\n      error.code = \"ENOTDIR\";\n      throw error;\n    }\n    assertPathInsideRoot(memoryRootReal, await realpath(dir), dir);\n\n    const entries = await readdir(dir, { withFileTypes: true });\n    for (const entry of entries) {\n      if (entry.isSymbolicLink()) continue;\n      const fullPath = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        assertPathInsideRoot(memoryRootReal, await realpath(fullPath), fullPath);\n        const sub = await scanDir(fullPath, memoryRootReal);\n        docs.push(...sub);\n      } else if (entry.name.endsWith(\".md\")) {\n        try {\n          assertPathInsideRoot(memoryRootReal, await realpath(fullPath), fullPath);\n          const raw = await readFile(fullPath, \"utf-8\");\n          const parsed = parseFrontmatter(raw);\n          const body = parsed ? parsed.body : raw.trim();\n          const docid = parsed?.data.id || path.basename(entry.name, \".md\");\n          docs.push({\n            docid,\n            path: fullPath,\n            content: body,\n            snippet: body.slice(0, 200),\n          });\n        } catch {\n          // Skip unreadable files\n        }\n      }\n    }\n  } catch (err) {\n    if (isNodeError(err) && err.code === \"ENOENT\") {\n      // Optional category directories may not exist yet.\n      return docs;\n    }\n    throw err;\n  }\n  return docs;\n}\n\nfunction isNodeError(err: unknown): err is NodeJS.ErrnoException {\n  return typeof err === \"object\" && err !== null && \"code\" in err;\n}\n\nfunction pathIsInside(parent: string, child: string): boolean {\n  const relative = path.relative(parent, child);\n  return relative === \"\" || (!relative.startsWith(\"..\") && !path.isAbsolute(relative));\n}\n\nfunction assertPathInsideRoot(rootReal: string, candidateReal: string, originalPath: string): void {\n  if (!pathIsInside(rootReal, candidateReal)) {\n    throw new Error(`Refusing to scan memory path outside memoryDir: ${originalPath}`);\n  }\n}\n\n/**\n * Scan `facts/`, `corrections/`, `procedures/`, and `reasoning-traces/`\n * subdirs of memoryDir for indexable markdown documents.\n *\n * Note: reasoning-traces live under their own subtree (issue #564 PR 3).\n * Non-QMD backends (Orama / Meilisearch / LanceDB) build their index\n * through this helper, so any new category subtree must be listed here\n * or those backends silently stop seeing the new memories.\n */\nexport async function scanMemoryDir(memoryDir: string): Promise<IndexableDocument[]> {\n  let memoryRootReal: string;\n  try {\n    memoryRootReal = await realpath(memoryDir);\n  } catch (err) {\n    if (isNodeError(err) && err.code === \"ENOENT\") {\n      return [];\n    }\n    throw err;\n  }\n  const factsDir = path.join(memoryDir, \"facts\");\n  const correctionsDir = path.join(memoryDir, \"corrections\");\n  const proceduresDir = path.join(memoryDir, \"procedures\");\n  const reasoningTracesDir = path.join(memoryDir, \"reasoning-traces\");\n  const [facts, corrections, procedures, reasoningTraces] = await Promise.all([\n    scanDir(factsDir, memoryRootReal),\n    scanDir(correctionsDir, memoryRootReal),\n    scanDir(proceduresDir, memoryRootReal),\n    scanDir(reasoningTracesDir, memoryRootReal),\n  ]);\n  return [...facts, ...corrections, ...procedures, ...reasoningTraces];\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-U3WSW6PZ.js → chunk-QMYXNM4P.js}

@@ -15,14 +15,16 @@ import {
   validateGmailConfig,
   validateGoogleDriveConfig,
   validateNotionConfig
-} from "./chunk-HXXBL2KD.js";
+} from "./chunk-BECQDWBA.js";
 import {
+  ConnectorStateLockLostError,
   readConnectorState,
+  withConnectorStateLock,
   writeConnectorState
-} from "./chunk-LPMVBPA3.js";
+} from "./chunk-CWWMTTQE.js";
 import {
   runConnectorPollOnce
-} from "./chunk-OZHRDTDX.js";
+} from "./chunk-OKTXM5H4.js";
 
 // src/live-connectors-runner.ts
 function builtInLiveConnectorDefinitions(config) {
@@ -138,44 +140,66 @@ async function runLiveConnectorsOnce(options) {
     let lastStateWrittenAt;
     try {
       const connector = definition.createConnector();
-      runResult = await runConnectorPollOnce({
-        connectorId: definition.id,
-        priorState: state,
-        syncFn: (cursor) => connector.syncIncremental({
-          cursor,
-          config: validatedConfig,
-          abortSignal: options.abortSignal
-        }),
-        ingestFn: options.ingestDocuments,
-        writeCursorFn: (writeState) => {
-          const writeAt = resolveNow(options.now);
-          return writeConnectorState(options.memoryDir, definition.id, {
-            id: definition.id,
-            cursor: writeState.cursor,
-            lastSyncAt: writeAt.toISOString(),
-            lastSyncStatus: writeState.lastSyncStatus,
-            ...writeState.lastSyncError !== void 0 ? { lastSyncError: writeState.lastSyncError } : {},
-            totalDocsImported: writeState.totalDocsImported
-          }).then(() => {
-            lastStateWrittenAt = writeAt;
-          });
+      runResult = await withConnectorStateLock(options.memoryDir, definition.id, async (lockSignal) => {
+        const pollAbortSignal = combineAbortSignals(options.abortSignal, lockSignal);
+        const lockedState = await readConnectorState(options.memoryDir, definition.id);
+        if (!force && !isConnectorDue(lockedState, definition.pollIntervalMs, checkAt)) {
+          return { docsImported: 0 };
         }
+        state = lockedState;
+        return runConnectorPollOnce({
+          connectorId: definition.id,
+          priorState: lockedState,
+          syncFn: (cursor) => connector.syncIncremental({
+            cursor,
+            config: validatedConfig,
+            abortSignal: pollAbortSignal
+          }),
+          ingestFn: async (docs) => {
+            throwIfAborted(pollAbortSignal);
+            await options.ingestDocuments(docs);
+            throwIfAborted(pollAbortSignal);
+          },
+          writeCursorFn: (writeState) => {
+            throwIfAborted(pollAbortSignal);
+            const writeAt = resolveNow(options.now);
+            return writeConnectorState(options.memoryDir, definition.id, {
+              id: definition.id,
+              cursor: writeState.cursor,
+              lastSyncAt: writeAt.toISOString(),
+              lastSyncStatus: writeState.lastSyncStatus,
+              ...writeState.lastSyncError !== void 0 ? { lastSyncError: writeState.lastSyncError } : {},
+              totalDocsImported: writeState.totalDocsImported
+            }).then(() => {
+              lastStateWrittenAt = writeAt;
+            });
+          }
+        });
       });
+      if (runResult.docsImported === 0 && runResult.error === void 0 && runResult.stateWriteError === void 0 && lastStateWrittenAt === void 0) {
+        const lockedState = await readConnectorState(options.memoryDir, definition.id);
+        if (!force && !isConnectorDue(lockedState, definition.pollIntervalMs, checkAt)) {
+          results.push(skipResult(definition, lockedState, "not_due"));
+          continue;
+        }
+      }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       let stateWriteError;
       let writtenErrorState;
       const errorAt = resolveNow(options.now);
-      try {
-        writtenErrorState = await writeConnectorErrorState({
-          memoryDir: options.memoryDir,
-          connectorId: definition.id,
-          state,
-          error: message,
-          now: errorAt
-        });
-      } catch (writeErr) {
-        stateWriteError = writeErr instanceof Error ? writeErr.message : String(writeErr);
+      if (!(err instanceof ConnectorStateLockLostError)) {
+        try {
+          writtenErrorState = await writeConnectorErrorState({
+            memoryDir: options.memoryDir,
+            connectorId: definition.id,
+            state,
+            error: message,
+            now: errorAt
+          });
+        } catch (writeErr) {
+          stateWriteError = writeErr instanceof Error ? writeErr.message : String(writeErr);
+        }
       }
       const reportedState = writtenErrorState ?? state;
       results.push({
@@ -258,6 +282,37 @@ function runItemFromResult(definition, result, priorState, now) {
     nextDueAt: reportedNextDueAt
   };
 }
+function combineAbortSignals(...signals) {
+  const activeSignals = signals.filter((signal) => signal !== void 0);
+  if (activeSignals.length === 0) return void 0;
+  if (activeSignals.length === 1) return activeSignals[0];
+  const abortSignalAny = AbortSignal.any;
+  if (abortSignalAny !== void 0) {
+    return abortSignalAny(activeSignals);
+  }
+  const controller = new AbortController();
+  const abort = (signal) => {
+    if (!controller.signal.aborted) {
+      controller.abort(signal.reason);
+    }
+  };
+  for (const signal of activeSignals) {
+    if (signal.aborted) {
+      abort(signal);
+      break;
+    }
+    signal.addEventListener("abort", () => abort(signal), { once: true });
+  }
+  return controller.signal;
+}
+function throwIfAborted(signal) {
+  if (signal?.aborted !== true) return;
+  const reason = signal.reason;
+  if (reason instanceof Error) {
+    throw reason;
+  }
+  throw new Error(reason === void 0 ? "operation aborted" : String(reason));
+}
 async function writeConnectorErrorState(options) {
   return writeConnectorState(options.memoryDir, options.connectorId, {
     id: options.connectorId,
@@ -274,4 +329,4 @@ export {
   hasEnabledLiveConnector,
   runLiveConnectorsOnce
 };
-//# sourceMappingURL=chunk-U3WSW6PZ.js.map
+//# sourceMappingURL=chunk-QMYXNM4P.js.map

package/dist/chunk-QMYXNM4P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/live-connectors-runner.ts"],"sourcesContent":["import {\n  runConnectorPollOnce,\n  type ConnectorRunResult,\n} from \"./connectors-cli.js\";\nimport {\n  createGitHubConnector,\n  createGmailConnector,\n  createGoogleDriveConnector,\n  createNotionConnector,\n  GITHUB_CONNECTOR_ID,\n  GITHUB_DEFAULT_POLL_INTERVAL_MS,\n  GMAIL_CONNECTOR_ID,\n  GMAIL_DEFAULT_POLL_INTERVAL_MS,\n  GOOGLE_DRIVE_CONNECTOR_ID,\n  GOOGLE_DRIVE_DEFAULT_POLL_INTERVAL_MS,\n  NOTION_CONNECTOR_ID,\n  NOTION_DEFAULT_POLL_INTERVAL_MS,\n  ConnectorStateLockLostError,\n  readConnectorState,\n  withConnectorStateLock,\n  writeConnectorState,\n  validateGitHubConfig,\n  validateGmailConfig,\n  validateGoogleDriveConfig,\n  validateNotionConfig,\n  type ConnectorConfig,\n  type ConnectorCursor,\n  type ConnectorDocument,\n  type ConnectorState,\n  type LiveConnector,\n} from \"./connectors/live/index.js\";\nimport type { LiveConnectorsConfig } from \"./types.js\";\n\nexport type LiveConnectorSkipReason =\n  | \"disabled\"\n  | \"not_due\"\n  | \"invalid_config\"\n  | \"state_read_error\"\n  | \"connector_error\";\n\nexport interface LiveConnectorRunItem {\n  id: string;\n  displayName: string;\n  enabled: boolean;\n  ran: boolean;\n  skippedReason?: LiveConnectorSkipReason;\n  docsImported: number;\n  error?: string;\n  stateWriteError?: string;\n  lastSyncAt: string | null;\n  nextDueAt: string | null;\n}\n\nexport interface LiveConnectorsRunSummary {\n  ranAt: string;\n  force: boolean;\n  totalDocsImported: number;\n  ranCount: number;\n  skippedCount: number;\n  errorCount: number;\n  results: LiveConnectorRunItem[];\n}\n\nexport interface LiveConnectorDefinition {\n  id: string;\n  displayName: string;\n  enabled: boolean;\n  pollIntervalMs: number;\n  rawConfig: unknown;\n  createConnector: () => LiveConnector;\n  validateConfig: (raw: unknown) => ConnectorConfig;\n}\n\ntype LiveConnectorsNow = Date | (() => Date);\n\nexport function builtInLiveConnectorDefinitions(\n  config: LiveConnectorsConfig,\n): LiveConnectorDefinition[] {\n  return [\n    {\n      id: GOOGLE_DRIVE_CONNECTOR_ID,\n      displayName: \"Google Drive\",\n      enabled: config.googleDrive.enabled,\n      pollIntervalMs:\n        config.googleDrive.pollIntervalMs ?? GOOGLE_DRIVE_DEFAULT_POLL_INTERVAL_MS,\n      rawConfig: config.googleDrive,\n      createConnector: createGoogleDriveConnector,\n      validateConfig: (raw) =>\n        validateGoogleDriveConfig(raw) as unknown as ConnectorConfig,\n    },\n    {\n      id: NOTION_CONNECTOR_ID,\n      displayName: \"Notion\",\n      enabled: config.notion.enabled,\n      pollIntervalMs: config.notion.pollIntervalMs ?? NOTION_DEFAULT_POLL_INTERVAL_MS,\n      rawConfig: config.notion,\n      createConnector: createNotionConnector,\n      validateConfig: (raw) =>\n        validateNotionConfig(raw) as unknown as ConnectorConfig,\n    },\n    {\n      id: GMAIL_CONNECTOR_ID,\n      displayName: \"Gmail\",\n      enabled: config.gmail.enabled,\n      pollIntervalMs: config.gmail.pollIntervalMs ?? GMAIL_DEFAULT_POLL_INTERVAL_MS,\n      rawConfig: config.gmail,\n      createConnector: createGmailConnector,\n      validateConfig: (raw) => validateGmailConfig(raw) as unknown as ConnectorConfig,\n    },\n    {\n      id: GITHUB_CONNECTOR_ID,\n      displayName: \"GitHub\",\n      enabled: config.github.enabled,\n      pollIntervalMs:\n        config.github.pollIntervalMs ?? GITHUB_DEFAULT_POLL_INTERVAL_MS,\n      rawConfig: config.github,\n      createConnector: createGitHubConnector,\n      validateConfig: (raw) => validateGitHubConfig(raw) as unknown as ConnectorConfig,\n    },\n  ];\n}\n\nexport function hasEnabledLiveConnector(config: LiveConnectorsConfig): boolean {\n  return (\n    config.googleDrive.enabled ||\n    config.notion.enabled ||\n    config.gmail.enabled ||\n    config.github.enabled\n  );\n}\n\nexport async function runLiveConnectorsOnce(options: {\n  memoryDir: string;\n  connectors: LiveConnectorsConfig;\n  ingestDocuments: (docs: ConnectorDocument[]) => Promise<void>;\n  force?: boolean;\n  now?: LiveConnectorsNow;\n  abortSignal?: AbortSignal;\n  definitions?: LiveConnectorDefinition[];\n}): Promise<LiveConnectorsRunSummary> {\n  const ranAt = resolveNow(options.now);\n  const force = options.force === true;\n  const definitions =\n    options.definitions ?? builtInLiveConnectorDefinitions(options.connectors);\n  const results: LiveConnectorRunItem[] = [];\n\n  for (const definition of definitions) {\n    const checkAt = resolveNow(options.now);\n    if (!definition.enabled) {\n      results.push(skipResult(definition, null, \"disabled\"));\n      continue;\n    }\n    let state: ConnectorState | null;\n    try {\n      state = await readConnectorState(options.memoryDir, definition.id);\n    } catch (err) {\n      results.push({\n        id: definition.id,\n        displayName: definition.displayName,\n        enabled: true,\n        ran: false,\n        skippedReason: \"state_read_error\",\n        docsImported: 0,\n        error: err instanceof Error ? err.message : String(err),\n        lastSyncAt: null,\n        nextDueAt: null,\n      });\n      continue;\n    }\n    if (!force && !isConnectorDue(state, definition.pollIntervalMs, checkAt)) {\n      results.push(skipResult(definition, state, \"not_due\"));\n      continue;\n    }\n\n    let validatedConfig: ConnectorConfig;\n    try {\n      validatedConfig = definition.validateConfig(definition.rawConfig);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      let stateWriteError: string | undefined;\n      let writtenErrorState: ConnectorState | undefined;\n      const errorAt = resolveNow(options.now);\n      try {\n        writtenErrorState = await writeConnectorErrorState({\n          memoryDir: options.memoryDir,\n          connectorId: definition.id,\n          state,\n          error: message,\n          now: errorAt,\n        });\n      } catch (writeErr) {\n        stateWriteError =\n          writeErr instanceof Error ? writeErr.message : String(writeErr);\n      }\n      const reportedState = writtenErrorState ?? state;\n      results.push({\n        id: definition.id,\n        displayName: definition.displayName,\n        enabled: true,\n        ran: false,\n        skippedReason: \"invalid_config\",\n        docsImported: 0,\n        error: message,\n        ...(stateWriteError !== undefined ? { stateWriteError } : {}),\n        lastSyncAt: reportedState?.lastSyncAt ?? null,\n        nextDueAt: nextDueAt(reportedState, definition.pollIntervalMs),\n      });\n      continue;\n    }\n\n    let runResult: ConnectorRunResult;\n    let lastStateWrittenAt: Date | undefined;\n    try {\n      const connector = definition.createConnector();\n      runResult = await withConnectorStateLock(options.memoryDir, definition.id, async (lockSignal) => {\n        const pollAbortSignal = combineAbortSignals(options.abortSignal, lockSignal);\n        const lockedState = await readConnectorState(options.memoryDir, definition.id);\n        if (!force && !isConnectorDue(lockedState, definition.pollIntervalMs, checkAt)) {\n          return { docsImported: 0 };\n        }\n        state = lockedState;\n        return runConnectorPollOnce({\n          connectorId: definition.id,\n          priorState: lockedState,\n          syncFn: (cursor: ConnectorCursor | null) =>\n            connector.syncIncremental({\n              cursor,\n              config: validatedConfig,\n              abortSignal: pollAbortSignal,\n            }),\n          ingestFn: async (docs) => {\n            throwIfAborted(pollAbortSignal);\n            await options.ingestDocuments(docs);\n            throwIfAborted(pollAbortSignal);\n          },\n          writeCursorFn: (writeState) => {\n            throwIfAborted(pollAbortSignal);\n            const writeAt = resolveNow(options.now);\n            return writeConnectorState(options.memoryDir, definition.id, {\n              id: definition.id,\n              cursor: writeState.cursor,\n              lastSyncAt: writeAt.toISOString(),\n              lastSyncStatus: writeState.lastSyncStatus,\n              ...(writeState.lastSyncError !== undefined\n                ? { lastSyncError: writeState.lastSyncError }\n                : {}),\n              totalDocsImported: writeState.totalDocsImported,\n            }).then(() => {\n              lastStateWrittenAt = writeAt;\n            });\n          },\n        });\n      });\n      if (\n        runResult.docsImported === 0 &&\n        runResult.error === undefined &&\n        runResult.stateWriteError === undefined &&\n        lastStateWrittenAt === undefined\n      ) {\n        const lockedState = await readConnectorState(options.memoryDir, definition.id);\n        if (!force && !isConnectorDue(lockedState, definition.pollIntervalMs, checkAt)) {\n          results.push(skipResult(definition, lockedState, \"not_due\"));\n          continue;\n        }\n      }\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      let stateWriteError: string | undefined;\n      let writtenErrorState: ConnectorState | undefined;\n      const errorAt = resolveNow(options.now);\n      if (!(err instanceof ConnectorStateLockLostError)) {\n        try {\n          writtenErrorState = await writeConnectorErrorState({\n            memoryDir: options.memoryDir,\n            connectorId: definition.id,\n            state,\n            error: message,\n            now: errorAt,\n          });\n        } catch (writeErr) {\n          stateWriteError =\n            writeErr instanceof Error ? writeErr.message : String(writeErr);\n        }\n      }\n      const reportedState = writtenErrorState ?? state;\n      results.push({\n        id: definition.id,\n        displayName: definition.displayName,\n        enabled: true,\n        ran: false,\n        skippedReason: \"connector_error\",\n        docsImported: 0,\n        error: message,\n        ...(stateWriteError !== undefined ? { stateWriteError } : {}),\n        lastSyncAt: reportedState?.lastSyncAt ?? null,\n        nextDueAt: nextDueAt(reportedState, definition.pollIntervalMs),\n      });\n      continue;\n    }\n    results.push(\n      runItemFromResult(\n        definition,\n        runResult,\n        state,\n        lastStateWrittenAt ?? resolveNow(options.now),\n      ),\n    );\n  }\n\n  return {\n    ranAt: ranAt.toISOString(),\n    force,\n    totalDocsImported: results.reduce((sum, item) => sum + item.docsImported, 0),\n    ranCount: results.filter((item) => item.ran).length,\n    skippedCount: results.filter((item) => !item.ran).length,\n    errorCount: results.filter(\n      (item) => item.error !== undefined || item.stateWriteError !== undefined,\n    ).length,\n    results,\n  };\n}\n\nfunction resolveNow(now: LiveConnectorsNow | undefined): Date {\n  return typeof now === \"function\" ? now() : now ?? new Date();\n}\n\nfunction isConnectorDue(\n  state: ConnectorState | null,\n  pollIntervalMs: number,\n  now: Date,\n): boolean {\n  if (state?.lastSyncAt === null || state?.lastSyncAt === undefined) return true;\n  const lastMs = Date.parse(state.lastSyncAt);\n  if (!Number.isFinite(lastMs)) return true;\n  return now.getTime() - lastMs >= Math.max(1, Math.floor(pollIntervalMs));\n}\n\nfunction nextDueAt(\n  state: ConnectorState | null,\n  pollIntervalMs: number,\n): string | null {\n  if (state?.lastSyncAt === null || state?.lastSyncAt === undefined) return null;\n  const lastMs = Date.parse(state.lastSyncAt);\n  if (!Number.isFinite(lastMs)) return null;\n  return new Date(lastMs + Math.max(1, Math.floor(pollIntervalMs))).toISOString();\n}\n\nfunction skipResult(\n  definition: LiveConnectorDefinition,\n  state: ConnectorState | null,\n  skippedReason: LiveConnectorSkipReason,\n): LiveConnectorRunItem {\n  return {\n    id: definition.id,\n    displayName: definition.displayName,\n    enabled: definition.enabled,\n    ran: false,\n    skippedReason,\n    docsImported: 0,\n    lastSyncAt: state?.lastSyncAt ?? null,\n    nextDueAt:\n      skippedReason === \"not_due\"\n        ? nextDueAt(state, definition.pollIntervalMs)\n        : null,\n  };\n}\n\nfunction runItemFromResult(\n  definition: LiveConnectorDefinition,\n  result: ConnectorRunResult,\n  priorState: ConnectorState | null,\n  now: Date,\n): LiveConnectorRunItem {\n  const stateWriteFailed = result.stateWriteError !== undefined;\n  const reportedLastSyncAt = stateWriteFailed\n    ? priorState?.lastSyncAt ?? null\n    : now.toISOString();\n  const reportedNextDueAt = stateWriteFailed\n    ? nextDueAt(priorState, definition.pollIntervalMs)\n    : new Date(\n        now.getTime() + Math.max(1, Math.floor(definition.pollIntervalMs)),\n      ).toISOString();\n\n  return {\n    id: definition.id,\n    displayName: definition.displayName,\n    enabled: definition.enabled,\n    ran: true,\n    docsImported: result.docsImported,\n    ...(result.error !== undefined ? { error: result.error } : {}),\n    ...(result.stateWriteError !== undefined\n      ? { stateWriteError: result.stateWriteError }\n      : {}),\n    lastSyncAt: reportedLastSyncAt,\n    nextDueAt: reportedNextDueAt,\n  };\n}\n\nfunction combineAbortSignals(...signals: Array<AbortSignal | undefined>): AbortSignal | undefined {\n  const activeSignals = signals.filter((signal): signal is AbortSignal => signal !== undefined);\n  if (activeSignals.length === 0) return undefined;\n  if (activeSignals.length === 1) return activeSignals[0];\n  const abortSignalAny = (AbortSignal as typeof AbortSignal & {\n    any?: (signals: AbortSignal[]) => AbortSignal;\n  }).any;\n  if (abortSignalAny !== undefined) {\n    return abortSignalAny(activeSignals);\n  }\n  const controller = new AbortController();\n  const abort = (signal: AbortSignal): void => {\n    if (!controller.signal.aborted) {\n      controller.abort(signal.reason);\n    }\n  };\n  for (const signal of activeSignals) {\n    if (signal.aborted) {\n      abort(signal);\n      break;\n    }\n    signal.addEventListener(\"abort\", () => abort(signal), { once: true });\n  }\n  return controller.signal;\n}\n\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted !== true) return;\n  const reason = signal.reason;\n  if (reason instanceof Error) {\n    throw reason;\n  }\n  throw new Error(reason === undefined ? \"operation aborted\" : String(reason));\n}\n\nasync function writeConnectorErrorState(options: {\n  memoryDir: string;\n  connectorId: string;\n  state: ConnectorState | null;\n  error: string;\n  now: Date;\n}): Promise<ConnectorState> {\n  return writeConnectorState(options.memoryDir, options.connectorId, {\n    id: options.connectorId,\n    cursor: options.state?.cursor ?? null,\n    lastSyncAt: options.now.toISOString(),\n    lastSyncStatus: \"error\",\n    lastSyncError: options.error,\n    totalDocsImported: options.state?.totalDocsImported ?? 0,\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-NBNN5GOB.js → chunk-QY7YA7OL.js}

@@ -177,7 +177,16 @@ var ProfilingCollector = class {
   }
   // ---- Query methods -----------------------------------------------------
   getRecentTraces(limit) {
-    const n = limit ?? this.traces.length;
+    if (limit === void 0 || limit === Infinity) {
+      return [...this.traces];
+    }
+    if (!Number.isFinite(limit)) {
+      return [];
+    }
+    const n = Math.floor(limit);
+    if (n <= 0) {
+      return [];
+    }
     return this.traces.slice(-n);
   }
   getStats() {
@@ -299,4 +308,4 @@ export {
   ProfilingCollector,
   formatProfileTraceAscii
 };
-//# sourceMappingURL=chunk-NBNN5GOB.js.map
+//# sourceMappingURL=chunk-QY7YA7OL.js.map

package/dist/chunk-QY7YA7OL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/profiling.ts"],"sourcesContent":["// Performance profiling collector for recall and extraction traces.\n// Zero external dependencies — uses only node:fs and node:path.\n\nimport {\n  existsSync,\n  mkdirSync,\n  writeFileSync,\n  promises as fsp,\n} from \"node:fs\";\nimport { join } from \"node:path\";\n\nimport { log } from \"./logger.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface ProfileSpan {\n  name: string;\n  startOffsetMs: number;\n  durationMs: number;\n}\n\nexport interface ProfileParallelGroupMember {\n  name: string;\n  durationMs: number;\n  resolvedIndex: number;\n}\n\nexport interface ProfileParallelGroup {\n  name: string;\n  startOffsetMs: number;\n  wallMs: number;\n  members: ProfileParallelGroupMember[];\n}\n\nexport interface ProfileTrace {\n  ts: string;\n  kind: \"recall\" | \"extraction\";\n  traceId: string;\n  sessionKey?: string;\n  totalMs: number;\n  spans: ProfileSpan[];\n  parallelGroups?: ProfileParallelGroup[];\n  configSnapshot?: Record<string, unknown>;\n}\n\nexport interface ProfilingConfig {\n  enabled: boolean;\n  storageDir: string;\n  maxTraces: number;\n}\n\nexport interface ParallelGroupHandle {\n  name: string;\n  startOffsetMs: number;\n  traceId?: string;\n}\n\nexport interface ProfilingStats {\n  byKind: Record<string, { count: number; avgMs: number; p50Ms: number; p95Ms: number; maxMs: number }>;\n  bySpan: Record<string, { count: number; avgMs: number; p50Ms: number; p95Ms: number; maxMs: number }>;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction percentile(sorted: number[], p: number): number {\n  if (sorted.length === 0) return 0;\n  const idx = Math.ceil((p / 100) * sorted.length) - 1;\n  return sorted[Math.max(0, Math.min(idx, sorted.length - 1))];\n}\n\nfunction aggregateStats(values: number[]): { count: number; avgMs: number; p50Ms: number; p95Ms: number; maxMs: number } {\n  const count = values.length;\n  if (count === 0) return { count: 0, avgMs: 0, p50Ms: 0, p95Ms: 0, maxMs: 0 };\n  const sorted = [...values].sort((a, b) => a - b);\n  const sum = sorted.reduce((s, v) => s + v, 0);\n  return {\n    count,\n    avgMs: Math.round(sum / count),\n    p50Ms: Math.round(percentile(sorted, 50)),\n    p95Ms: Math.round(percentile(sorted, 95)),\n    maxMs: sorted[sorted.length - 1],\n  };\n}\n\nlet traceCounter = 0;\n\n// ---------------------------------------------------------------------------\n// ProfilingCollector\n// ---------------------------------------------------------------------------\n\nexport class ProfilingCollector {\n  private enabled: boolean;\n  private storageDir: string;\n  private maxTraces: number;\n  private traces: ProfileTrace[] = [];\n  private prunePromise: Promise<void> | null = null;\n\n  // Active trace state — keyed by traceId so concurrent pipelines are isolated.\n  private activeTraces = new Map<\n    string,\n    {\n      kind: \"recall\" | \"extraction\";\n      start: number;\n      sessionKey?: string;\n      configSnapshot?: Record<string, unknown>;\n      spans: ProfileSpan[];\n      spanStarts: Map<string, number>;\n      parallelGroups: ProfileParallelGroup[];\n    }\n  >();\n  private latestTraceId = \"\";\n\n  constructor(config: ProfilingConfig) {\n    this.enabled = config.enabled;\n    this.storageDir = config.storageDir;\n    this.maxTraces = Math.max(0, config.maxTraces);\n\n    if (this.enabled) {\n      if (!existsSync(this.storageDir)) {\n        mkdirSync(this.storageDir, { recursive: true });\n        log.debug(`profiling: created storage dir ${this.storageDir}`);\n      }\n    }\n  }\n\n  get isEnabled(): boolean {\n    return this.enabled;\n  }\n\n  // ---- Trace lifecycle ---------------------------------------------------\n\n  startTrace(kind: \"recall\" | \"extraction\", sessionKey?: string, configSnapshot?: Record<string, unknown>): string {\n    if (!this.enabled) return \"\";\n    traceCounter++;\n    const traceId = `t${traceCounter}-${Date.now().toString(36)}`;\n    this.activeTraces.set(traceId, {\n      kind,\n      start: Date.now(),\n      sessionKey,\n      configSnapshot,\n      spans: [],\n      spanStarts: new Map(),\n      parallelGroups: [],\n    });\n    this.latestTraceId = traceId;\n    log.debug(`profiling: started trace ${traceId} kind=${kind}`);\n    return traceId;\n  }\n\n  startSpan(name: string, traceId?: string): void {\n    const tid = traceId ?? this.latestTraceId;\n    const t = tid ? this.activeTraces.get(tid) : undefined;\n    if (!t) return;\n    const offset = Date.now() - t.start;\n    t.spanStarts.set(name, Date.now());\n    log.debug(`profiling: span ${name} started at +${offset}ms (trace=${tid})`);\n  }\n\n  endSpan(name: string, traceId?: string): void {\n    const tid = traceId ?? this.latestTraceId;\n    const t = tid ? this.activeTraces.get(tid) : undefined;\n    if (!t) return;\n    const start = t.spanStarts.get(name);\n    if (start === undefined) return;\n    const duration = Date.now() - start;\n    const startOffset = start - t.start;\n    t.spans.push({ name, startOffsetMs: startOffset, durationMs: duration });\n    t.spanStarts.delete(name);\n    log.debug(`profiling: span ${name} ended ${duration}ms (trace=${tid})`);\n  }\n\n  endTrace(traceId?: string): ProfileTrace | null {\n    const tid = traceId ?? this.latestTraceId;\n    const t = tid ? this.activeTraces.get(tid) : undefined;\n    if (!t) return null;\n\n    // Auto-close any spans still open when the trace finalizes.\n    const now = Date.now();\n    for (const [name, start] of t.spanStarts) {\n      const duration = now - start;\n      const startOffset = start - t.start;\n      t.spans.push({ name, startOffsetMs: startOffset, durationMs: duration });\n      log.debug(`profiling: auto-closed span ${name} at trace end (${duration}ms, trace=${tid})`);\n    }\n    t.spanStarts.clear();\n\n    const trace: ProfileTrace = {\n      ts: new Date().toISOString(),\n      kind: t.kind,\n      traceId: tid,\n      totalMs: Date.now() - t.start,\n      spans: t.spans,\n      configSnapshot: t.configSnapshot,\n    };\n\n    if (t.sessionKey) {\n      trace.sessionKey = t.sessionKey;\n    }\n    if (t.parallelGroups.length > 0) {\n      trace.parallelGroups = t.parallelGroups;\n    }\n\n    // Remove from active map.\n    this.activeTraces.delete(tid);\n\n    if (!this.enabled) {\n      log.debug(\"profiling: trace discarded (disabled)\");\n      return null;\n    }\n\n    // Persist.\n    this.persistTrace(trace);\n\n    // Buffer in memory (FIFO).\n    this.traces.push(trace);\n    if (this.traces.length > this.maxTraces) {\n      this.traces.shift();\n    }\n\n    // Single-flight: if a prune is already running, piggyback on it;\n    // otherwise start one.  This prevents concurrent prunes from racing\n    // on stale directory snapshots.\n    if (!this.prunePromise) {\n      this.prunePromise = this.pruneFiles().finally(() => {\n        this.prunePromise = null;\n      });\n    }\n    log.debug(`profiling: trace ${trace.traceId} finalized totalMs=${trace.totalMs}`);\n    return trace;\n  }\n\n  // ---- Parallel group tracking -------------------------------------------\n\n  startParallelGroup(name: string, traceId?: string): ParallelGroupHandle {\n    const tid = traceId ?? this.latestTraceId;\n    const t = tid ? this.activeTraces.get(tid) : undefined;\n    const startOffsetMs = t ? Date.now() - t.start : 0;\n    return { name, startOffsetMs, traceId: tid };\n  }\n\n  async endParallelGroup(\n    handle: ParallelGroupHandle,\n    members: Array<{ name: string; promise: Promise<unknown> }>,\n  ): Promise<void> {\n    const wallStart = Date.now();\n\n    let nextResolvedIndex = 0;\n    const resolutionOrder = new Map<string, number>();\n\n    const timed = members.map(async (m) => {\n      const t0 = Date.now();\n      try {\n        await m.promise;\n      } catch {\n        // settled — still record order\n      }\n      resolutionOrder.set(m.name, nextResolvedIndex++);\n      return { name: m.name, durationMs: Date.now() - t0 };\n    });\n    const timedResults = await Promise.allSettled(timed);\n\n    const tid = handle.traceId ?? this.latestTraceId;\n    const t = tid ? this.activeTraces.get(tid) : undefined;\n    if (!t) return;\n\n    const wallMs = Date.now() - wallStart;\n\n    const groupMembers: ProfileParallelGroupMember[] = members.map((m, i) => {\n      const timedResult = timedResults[i].status === \"fulfilled\"\n        ? timedResults[i].value\n        : { name: m.name, durationMs: wallMs };\n      return {\n        name: timedResult.name,\n        durationMs: timedResult.durationMs,\n        resolvedIndex: resolutionOrder.get(m.name) ?? i,\n      };\n    });\n\n    t.parallelGroups.push({\n      name: handle.name,\n      startOffsetMs: handle.startOffsetMs,\n      wallMs,\n      members: groupMembers,\n    });\n\n    log.debug(`profiling: parallel group ${handle.name} wallMs=${wallMs} (trace=${tid})`);\n  }\n\n  // ---- Query methods -----------------------------------------------------\n\n  getRecentTraces(limit?: number): ProfileTrace[] {\n    if (limit === undefined || limit === Infinity) {\n      return [...this.traces];\n    }\n    if (!Number.isFinite(limit)) {\n      return [];\n    }\n    const n = Math.floor(limit);\n    if (n <= 0) {\n      return [];\n    }\n    return this.traces.slice(-n);\n  }\n\n  getStats(): ProfilingStats {\n    const byKind: Record<string, number[]> = {};\n    const bySpan: Record<string, number[]> = {};\n\n    for (const trace of this.traces) {\n      if (!byKind[trace.kind]) byKind[trace.kind] = [];\n      byKind[trace.kind].push(trace.totalMs);\n\n      for (const span of trace.spans) {\n        if (!bySpan[span.name]) bySpan[span.name] = [];\n        bySpan[span.name].push(span.durationMs);\n      }\n    }\n\n    const result: ProfilingStats = { byKind: {}, bySpan: {} };\n    for (const [k, v] of Object.entries(byKind)) {\n      result.byKind[k] = aggregateStats(v);\n    }\n    for (const [k, v] of Object.entries(bySpan)) {\n      result.bySpan[k] = aggregateStats(v);\n    }\n    return result;\n  }\n\n  identifyBottleneck(): string | null {\n    if (this.traces.length === 0) return null;\n    const latest = this.traces[this.traces.length - 1];\n    if (latest.spans.length === 0) return null;\n    let slowest = latest.spans[0];\n    for (const span of latest.spans) {\n      if (span.durationMs > slowest.durationMs) slowest = span;\n    }\n    return slowest.name;\n  }\n\n  // ---- Persistence -------------------------------------------------------\n\n  private persistTrace(trace: ProfileTrace): void {\n    const filename = `${trace.kind}-${trace.traceId}.jsonl`;\n    const filepath = join(this.storageDir, filename);\n    try {\n      writeFileSync(filepath, JSON.stringify(trace) + \"\\n\", \"utf-8\");\n      log.debug(`profiling: persisted ${filename}`);\n    } catch (err) {\n      log.warn(`profiling: failed to persist ${filename}`, err);\n    }\n  }\n\n  async pruneFiles(): Promise<void> {\n    try {\n      const dir = this.storageDir;\n      const entries = await fsp.readdir(dir);\n      const jsonlFiles = entries.filter((f) => f.endsWith(\".jsonl\"));\n      const withMtime = await Promise.all(\n        jsonlFiles.map(async (f) => ({\n          name: f,\n          mtime: (await fsp.stat(join(dir, f))).mtimeMs,\n        })),\n      );\n      const files = withMtime.sort((a, b) => a.mtime - b.mtime).map((f) => f.name);\n\n      while (files.length > this.maxTraces) {\n        const oldest = files.shift()!;\n        await fsp.unlink(join(dir, oldest));\n        log.debug(`profiling: pruned ${oldest}`);\n      }\n    } catch (err) {\n      log.warn(\"profiling: prune failed\", err);\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// ASCII formatter\n// ---------------------------------------------------------------------------\n\nexport function formatProfileTraceAscii(trace: ProfileTrace): string {\n  const lines: string[] = [];\n  const BAR_WIDTH = 40;\n\n  lines.push(`=== Profile: ${trace.kind} ===`);\n  lines.push(`Trace ID : ${trace.traceId}`);\n  lines.push(`Total    : ${trace.totalMs}ms`);\n  if (trace.sessionKey) lines.push(`Session  : ${trace.sessionKey}`);\n  lines.push(\"\");\n\n  // Identify bottleneck.\n  let bottleneckName: string | null = null;\n  if (trace.spans.length > 0) {\n    let slowest = trace.spans[0];\n    for (const s of trace.spans) {\n      if (s.durationMs > slowest.durationMs) slowest = s;\n    }\n    bottleneckName = slowest.name;\n  }\n\n  // Spans.\n  if (trace.spans.length > 0) {\n    const maxDuration = Math.max(...trace.spans.map((s) => s.durationMs), 1);\n    lines.push(\"Spans:\");\n    for (const span of trace.spans) {\n      const barLen = Math.max(1, Math.round((span.durationMs / maxDuration) * BAR_WIDTH));\n      const bar = \"\\u2588\".repeat(barLen);\n      const suffix = span.name === bottleneckName ? \" \\u2190 bottleneck\" : \"\";\n      lines.push(`  ${span.name.padEnd(30)} ${String(span.durationMs).padStart(6)}ms ${bar}${suffix}`);\n    }\n    lines.push(\"\");\n  }\n\n  // Parallel groups.\n  if (trace.parallelGroups && trace.parallelGroups.length > 0) {\n    lines.push(\"Parallel Groups:\");\n    for (const group of trace.parallelGroups) {\n      lines.push(`  ${group.name}:`);\n      lines.push(`    Wall time    : ${group.wallMs}ms`);\n      const efficiency = parallelEfficiency(group);\n      if (efficiency !== null) {\n        lines.push(`    Efficiency   : ${efficiency}%`);\n      }\n      for (const member of group.members) {\n        lines.push(`    [${String(member.resolvedIndex).padStart(2)}] ${member.name.padEnd(28)} ${String(member.durationMs).padStart(6)}ms`);\n      }\n    }\n    lines.push(\"\");\n  }\n\n  lines.push(\"---\");\n  return lines.join(\"\\n\");\n}\n\nfunction parallelEfficiency(group: ProfileParallelGroup): number | null {\n  if (group.members.length <= 1) return null;\n  const idealMs = Math.max(...group.members.map((m) => m.durationMs));\n  if (group.wallMs === 0) return null;\n  return Math.round((idealMs / group.wallMs) * 100);\n}\n"],"mappings":";;;;;AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,OACP;AACP,SAAS,YAAY;AA2DrB,SAAS,WAAW,QAAkB,GAAmB;AACvD,MAAI,OAAO,WAAW,EAAG,QAAO;AAChC,QAAM,MAAM,KAAK,KAAM,IAAI,MAAO,OAAO,MAAM,IAAI;AACnD,SAAO,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC;AAC7D;AAEA,SAAS,eAAe,QAAiG;AACvH,QAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,EAAG,QAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,EAAE;AAC3E,QAAM,SAAS,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAC/C,QAAM,MAAM,OAAO,OAAO,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC;AAC5C,SAAO;AAAA,IACL;AAAA,IACA,OAAO,KAAK,MAAM,MAAM,KAAK;AAAA,IAC7B,OAAO,KAAK,MAAM,WAAW,QAAQ,EAAE,CAAC;AAAA,IACxC,OAAO,KAAK,MAAM,WAAW,QAAQ,EAAE,CAAC;AAAA,IACxC,OAAO,OAAO,OAAO,SAAS,CAAC;AAAA,EACjC;AACF;AAEA,IAAI,eAAe;AAMZ,IAAM,qBAAN,MAAyB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAyB,CAAC;AAAA,EAC1B,eAAqC;AAAA;AAAA,EAGrC,eAAe,oBAAI,IAWzB;AAAA,EACM,gBAAgB;AAAA,EAExB,YAAY,QAAyB;AACnC,SAAK,UAAU,OAAO;AACtB,SAAK,aAAa,OAAO;AACzB,SAAK,YAAY,KAAK,IAAI,GAAG,OAAO,SAAS;AAE7C,QAAI,KAAK,SAAS;AAChB,UAAI,CAAC,WAAW,KAAK,UAAU,GAAG;AAChC,kBAAU,KAAK,YAAY,EAAE,WAAW,KAAK,CAAC;AAC9C,YAAI,MAAM,kCAAkC,KAAK,UAAU,EAAE;AAAA,MAC/D;AAAA,IACF;AAAA,EACF;AAAA,EAEA,IAAI,YAAqB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAIA,WAAW,MAA+B,YAAqB,gBAAkD;AAC/G,QAAI,CAAC,KAAK,QAAS,QAAO;AAC1B;AACA,UAAM,UAAU,IAAI,YAAY,IAAI,KAAK,IAAI,EAAE,SAAS,EAAE,CAAC;AAC3D,SAAK,aAAa,IAAI,SAAS;AAAA,MAC7B;AAAA,MACA,OAAO,KAAK,IAAI;AAAA,MAChB;AAAA,MACA;AAAA,MACA,OAAO,CAAC;AAAA,MACR,YAAY,oBAAI,IAAI;AAAA,MACpB,gBAAgB,CAAC;AAAA,IACnB,CAAC;AACD,SAAK,gBAAgB;AACrB,QAAI,MAAM,4BAA4B,OAAO,SAAS,IAAI,EAAE;AAC5D,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,MAAc,SAAwB;AAC9C,UAAM,MAAM,WAAW,KAAK;AAC5B,UAAM,IAAI,MAAM,KAAK,aAAa,IAAI,GAAG,IAAI;AAC7C,QAAI,CAAC,EAAG;AACR,UAAM,SAAS,KAAK,IAAI,IAAI,EAAE;AAC9B,MAAE,WAAW,IAAI,MAAM,KAAK,IAAI,CAAC;AACjC,QAAI,MAAM,mBAAmB,IAAI,gBAAgB,MAAM,aAAa,GAAG,GAAG;AAAA,EAC5E;AAAA,EAEA,QAAQ,MAAc,SAAwB;AAC5C,UAAM,MAAM,WAAW,KAAK;AAC5B,UAAM,IAAI,MAAM,KAAK,aAAa,IAAI,GAAG,IAAI;AAC7C,QAAI,CAAC,EAAG;AACR,UAAM,QAAQ,EAAE,WAAW,IAAI,IAAI;AACnC,QAAI,UAAU,OAAW;AACzB,UAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,UAAM,cAAc,QAAQ,EAAE;AAC9B,MAAE,MAAM,KAAK,EAAE,MAAM,eAAe,aAAa,YAAY,SAAS,CAAC;AACvE,MAAE,WAAW,OAAO,IAAI;AACxB,QAAI,MAAM,mBAAmB,IAAI,UAAU,QAAQ,aAAa,GAAG,GAAG;AAAA,EACxE;AAAA,EAEA,SAAS,SAAuC;AAC9C,UAAM,MAAM,WAAW,KAAK;AAC5B,UAAM,IAAI,MAAM,KAAK,aAAa,IAAI,GAAG,IAAI;AAC7C,QAAI,CAAC,EAAG,QAAO;AAGf,UAAM,MAAM,KAAK,IAAI;AACrB,eAAW,CAAC,MAAM,KAAK,KAAK,EAAE,YAAY;AACxC,YAAM,WAAW,MAAM;AACvB,YAAM,cAAc,QAAQ,EAAE;AAC9B,QAAE,MAAM,KAAK,EAAE,MAAM,eAAe,aAAa,YAAY,SAAS,CAAC;AACvE,UAAI,MAAM,+BAA+B,IAAI,kBAAkB,QAAQ,aAAa,GAAG,GAAG;AAAA,IAC5F;AACA,MAAE,WAAW,MAAM;AAEnB,UAAM,QAAsB;AAAA,MAC1B,KAAI,oBAAI,KAAK,GAAE,YAAY;AAAA,MAC3B,MAAM,EAAE;AAAA,MACR,SAAS;AAAA,MACT,SAAS,KAAK,IAAI,IAAI,EAAE;AAAA,MACxB,OAAO,EAAE;AAAA,MACT,gBAAgB,EAAE;AAAA,IACpB;AAEA,QAAI,EAAE,YAAY;AAChB,YAAM,aAAa,EAAE;AAAA,IACvB;AACA,QAAI,EAAE,eAAe,SAAS,GAAG;AAC/B,YAAM,iBAAiB,EAAE;AAAA,IAC3B;AAGA,SAAK,aAAa,OAAO,GAAG;AAE5B,QAAI,CAAC,KAAK,SAAS;AACjB,UAAI,MAAM,uCAAuC;AACjD,aAAO;AAAA,IACT;AAGA,SAAK,aAAa,KAAK;AAGvB,SAAK,OAAO,KAAK,KAAK;AACtB,QAAI,KAAK,OAAO,SAAS,KAAK,WAAW;AACvC,WAAK,OAAO,MAAM;AAAA,IACpB;AAKA,QAAI,CAAC,KAAK,cAAc;AACtB,WAAK,eAAe,KAAK,WAAW,EAAE,QAAQ,MAAM;AAClD,aAAK,eAAe;AAAA,MACtB,CAAC;AAAA,IACH;AACA,QAAI,MAAM,oBAAoB,MAAM,OAAO,sBAAsB,MAAM,OAAO,EAAE;AAChF,WAAO;AAAA,EACT;AAAA;AAAA,EAIA,mBAAmB,MAAc,SAAuC;AACtE,UAAM,MAAM,WAAW,KAAK;AAC5B,UAAM,IAAI,MAAM,KAAK,aAAa,IAAI,GAAG,IAAI;AAC7C,UAAM,gBAAgB,IAAI,KAAK,IAAI,IAAI,EAAE,QAAQ;AACjD,WAAO,EAAE,MAAM,eAAe,SAAS,IAAI;AAAA,EAC7C;AAAA,EAEA,MAAM,iBACJ,QACA,SACe;AACf,UAAM,YAAY,KAAK,IAAI;AAE3B,QAAI,oBAAoB;AACxB,UAAM,kBAAkB,oBAAI,IAAoB;AAEhD,UAAM,QAAQ,QAAQ,IAAI,OAAO,MAAM;AACrC,YAAM,KAAK,KAAK,IAAI;AACpB,UAAI;AACF,cAAM,EAAE;AAAA,MACV,QAAQ;AAAA,MAER;AACA,sBAAgB,IAAI,EAAE,MAAM,mBAAmB;AAC/C,aAAO,EAAE,MAAM,EAAE,MAAM,YAAY,KAAK,IAAI,IAAI,GAAG;AAAA,IACrD,CAAC;AACD,UAAM,eAAe,MAAM,QAAQ,WAAW,KAAK;AAEnD,UAAM,MAAM,OAAO,WAAW,KAAK;AACnC,UAAM,IAAI,MAAM,KAAK,aAAa,IAAI,GAAG,IAAI;AAC7C,QAAI,CAAC,EAAG;AAER,UAAM,SAAS,KAAK,IAAI,IAAI;AAE5B,UAAM,eAA6C,QAAQ,IAAI,CAAC,GAAG,MAAM;AACvE,YAAM,cAAc,aAAa,CAAC,EAAE,WAAW,cAC3C,aAAa,CAAC,EAAE,QAChB,EAAE,MAAM,EAAE,MAAM,YAAY,OAAO;AACvC,aAAO;AAAA,QACL,MAAM,YAAY;AAAA,QAClB,YAAY,YAAY;AAAA,QACxB,eAAe,gBAAgB,IAAI,EAAE,IAAI,KAAK;AAAA,MAChD;AAAA,IACF,CAAC;AAED,MAAE,eAAe,KAAK;AAAA,MACpB,MAAM,OAAO;AAAA,MACb,eAAe,OAAO;AAAA,MACtB;AAAA,MACA,SAAS;AAAA,IACX,CAAC;AAED,QAAI,MAAM,6BAA6B,OAAO,IAAI,WAAW,MAAM,WAAW,GAAG,GAAG;AAAA,EACtF;AAAA;AAAA,EAIA,gBAAgB,OAAgC;AAC9C,QAAI,UAAU,UAAa,UAAU,UAAU;AAC7C,aAAO,CAAC,GAAG,KAAK,MAAM;AAAA,IACxB;AACA,QAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,aAAO,CAAC;AAAA,IACV;AACA,UAAM,IAAI,KAAK,MAAM,KAAK;AAC1B,QAAI,KAAK,GAAG;AACV,aAAO,CAAC;AAAA,IACV;AACA,WAAO,KAAK,OAAO,MAAM,CAAC,CAAC;AAAA,EAC7B;AAAA,EAEA,WAA2B;AACzB,UAAM,SAAmC,CAAC;AAC1C,UAAM,SAAmC,CAAC;AAE1C,eAAW,SAAS,KAAK,QAAQ;AAC/B,UAAI,CAAC,OAAO,MAAM,IAAI,EAAG,QAAO,MAAM,IAAI,IAAI,CAAC;AAC/C,aAAO,MAAM,IAAI,EAAE,KAAK,MAAM,OAAO;AAErC,iBAAW,QAAQ,MAAM,OAAO;AAC9B,YAAI,CAAC,OAAO,KAAK,IAAI,EAAG,QAAO,KAAK,IAAI,IAAI,CAAC;AAC7C,eAAO,KAAK,IAAI,EAAE,KAAK,KAAK,UAAU;AAAA,MACxC;AAAA,IACF;AAEA,UAAM,SAAyB,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE;AACxD,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC3C,aAAO,OAAO,CAAC,IAAI,eAAe,CAAC;AAAA,IACrC;AACA,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC3C,aAAO,OAAO,CAAC,IAAI,eAAe,CAAC;AAAA,IACrC;AACA,WAAO;AAAA,EACT;AAAA,EAEA,qBAAoC;AAClC,QAAI,KAAK,OAAO,WAAW,EAAG,QAAO;AACrC,UAAM,SAAS,KAAK,OAAO,KAAK,OAAO,SAAS,CAAC;AACjD,QAAI,OAAO,MAAM,WAAW,EAAG,QAAO;AACtC,QAAI,UAAU,OAAO,MAAM,CAAC;AAC5B,eAAW,QAAQ,OAAO,OAAO;AAC/B,UAAI,KAAK,aAAa,QAAQ,WAAY,WAAU;AAAA,IACtD;AACA,WAAO,QAAQ;AAAA,EACjB;AAAA;AAAA,EAIQ,aAAa,OAA2B;AAC9C,UAAM,WAAW,GAAG,MAAM,IAAI,IAAI,MAAM,OAAO;AAC/C,UAAM,WAAW,KAAK,KAAK,YAAY,QAAQ;AAC/C,QAAI;AACF,oBAAc,UAAU,KAAK,UAAU,KAAK,IAAI,MAAM,OAAO;AAC7D,UAAI,MAAM,wBAAwB,QAAQ,EAAE;AAAA,IAC9C,SAAS,KAAK;AACZ,UAAI,KAAK,gCAAgC,QAAQ,IAAI,GAAG;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,aAA4B;AAChC,QAAI;AACF,YAAM,MAAM,KAAK;AACjB,YAAM,UAAU,MAAM,IAAI,QAAQ,GAAG;AACrC,YAAM,aAAa,QAAQ,OAAO,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC;AAC7D,YAAM,YAAY,MAAM,QAAQ;AAAA,QAC9B,WAAW,IAAI,OAAO,OAAO;AAAA,UAC3B,MAAM;AAAA,UACN,QAAQ,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG;AAAA,QACxC,EAAE;AAAA,MACJ;AACA,YAAM,QAAQ,UAAU,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;AAE3E,aAAO,MAAM,SAAS,KAAK,WAAW;AACpC,cAAM,SAAS,MAAM,MAAM;AAC3B,cAAM,IAAI,OAAO,KAAK,KAAK,MAAM,CAAC;AAClC,YAAI,MAAM,qBAAqB,MAAM,EAAE;AAAA,MACzC;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,KAAK,2BAA2B,GAAG;AAAA,IACzC;AAAA,EACF;AACF;AAMO,SAAS,wBAAwB,OAA6B;AACnE,QAAM,QAAkB,CAAC;AACzB,QAAM,YAAY;AAElB,QAAM,KAAK,gBAAgB,MAAM,IAAI,MAAM;AAC3C,QAAM,KAAK,cAAc,MAAM,OAAO,EAAE;AACxC,QAAM,KAAK,cAAc,MAAM,OAAO,IAAI;AAC1C,MAAI,MAAM,WAAY,OAAM,KAAK,cAAc,MAAM,UAAU,EAAE;AACjE,QAAM,KAAK,EAAE;AAGb,MAAI,iBAAgC;AACpC,MAAI,MAAM,MAAM,SAAS,GAAG;AAC1B,QAAI,UAAU,MAAM,MAAM,CAAC;AAC3B,eAAW,KAAK,MAAM,OAAO;AAC3B,UAAI,EAAE,aAAa,QAAQ,WAAY,WAAU;AAAA,IACnD;AACA,qBAAiB,QAAQ;AAAA,EAC3B;AAGA,MAAI,MAAM,MAAM,SAAS,GAAG;AAC1B,UAAM,cAAc,KAAK,IAAI,GAAG,MAAM,MAAM,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC;AACvE,UAAM,KAAK,QAAQ;AACnB,eAAW,QAAQ,MAAM,OAAO;AAC9B,YAAM,SAAS,KAAK,IAAI,GAAG,KAAK,MAAO,KAAK,aAAa,cAAe,SAAS,CAAC;AAClF,YAAM,MAAM,SAAS,OAAO,MAAM;AAClC,YAAM,SAAS,KAAK,SAAS,iBAAiB,uBAAuB;AACrE,YAAM,KAAK,KAAK,KAAK,KAAK,OAAO,EAAE,CAAC,IAAI,OAAO,KAAK,UAAU,EAAE,SAAS,CAAC,CAAC,MAAM,GAAG,GAAG,MAAM,EAAE;AAAA,IACjG;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AAGA,MAAI,MAAM,kBAAkB,MAAM,eAAe,SAAS,GAAG;AAC3D,UAAM,KAAK,kBAAkB;AAC7B,eAAW,SAAS,MAAM,gBAAgB;AACxC,YAAM,KAAK,KAAK,MAAM,IAAI,GAAG;AAC7B,YAAM,KAAK,sBAAsB,MAAM,MAAM,IAAI;AACjD,YAAM,aAAa,mBAAmB,KAAK;AAC3C,UAAI,eAAe,MAAM;AACvB,cAAM,KAAK,sBAAsB,UAAU,GAAG;AAAA,MAChD;AACA,iBAAW,UAAU,MAAM,SAAS;AAClC,cAAM,KAAK,QAAQ,OAAO,OAAO,aAAa,EAAE,SAAS,CAAC,CAAC,KAAK,OAAO,KAAK,OAAO,EAAE,CAAC,IAAI,OAAO,OAAO,UAAU,EAAE,SAAS,CAAC,CAAC,IAAI;AAAA,MACrI;AAAA,IACF;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AAEA,QAAM,KAAK,KAAK;AAChB,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,mBAAmB,OAA4C;AACtE,MAAI,MAAM,QAAQ,UAAU,EAAG,QAAO;AACtC,QAAM,UAAU,KAAK,IAAI,GAAG,MAAM,QAAQ,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC;AAClE,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,SAAO,KAAK,MAAO,UAAU,MAAM,SAAU,GAAG;AAClD;","names":[]}