@remnic/core 9.45.3 → 9.45.4

package/dist/external-wiki-access.d.ts

@@ -0,0 +1,127 @@
+import { BoundOperation } from './access-boundary.js';
+import { ExternalWikiSearchResult, ExternalWikiSearchInput } from './external-wiki-search.js';
+import 'zod';
+import './access-service-CsU-ljFD.js';
+import './catalog-bctMURhN.js';
+import './types-yX_FwERf.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './types-continuity.js';
+import './access-namespace-preflight-CWUDwB4M.js';
+import './access-token-capabilities.js';
+import 'node:async_hooks';
+import './scope-profiles-BJzp2F5A.js';
+import './storage-DfjxusTE.js';
+import './entity-id-normalization.js';
+import './page-versioning.js';
+import './consolidation-operator.js';
+import './utils/serialize-mutations.js';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
+import './runtime/better-sqlite.js';
+import 'better-sqlite3';
+import './write-envelope.js';
+import './structured-attributes.js';
+import './types-B1VHaf2w.js';
+import './recall-explain-renderer.js';
+import './recall-state.js';
+import './search/port.js';
+import './recall-xray.js';
+import './memory-provenance.js';
+import './user-model.js';
+import './access-citation.js';
+import './resolve-auth-token.js';
+import './access-health-types.js';
+import './corpus-watermark.js';
+import './replica-divergence.js';
+import './recall-audit-anomaly.js';
+import './recall-audit.js';
+import './orchestrator-DJYlwiUv.js';
+import './briefing.js';
+import './buffer.js';
+import './extraction-faithfulness.js';
+import './local-llm.js';
+import './model-registry.js';
+import './fallback-llm.js';
+import './resolve-provider-secret.js';
+import './transcript.js';
+import './session-integrity.js';
+import './summarizer.js';
+import './maintenance-D2mveyCd.js';
+import './namespaces/search.js';
+import './compounding/engine.js';
+import './shared-context/manager.js';
+import './capabilities.js';
+import './utility-runtime.js';
+import './tier-routing.js';
+import './lifecycle.js';
+import './orchestration/compression-guideline-coordinator.js';
+import './semantic-consolidation-D4KAZO2G.js';
+import './connectors/codex-materialize.js';
+import './logger.js';
+import './embedding-fallback.js';
+import './extraction.js';
+import './schemas.js';
+import './profiling.js';
+import './extraction-error-classification.js';
+import './objective-state.js';
+import './causal-trajectory.js';
+import './trust-zones.js';
+import './harmonic-retrieval.js';
+import './abstraction-nodes.js';
+import './cue-anchors.js';
+import './verified-recall.js';
+import './boxes.js';
+import './semantic-rule-verifier.js';
+import './work-product-ledger.js';
+import './trust-score-stage.js';
+import './trust-score.js';
+import './conversation-index/chunker.js';
+import './conversation-index/backend.js';
+import './faiss-adapter-BHecI1fF.js';
+import './runtime/child-process.js';
+import './namespaces/storage.js';
+import './threading.js';
+import './graph.js';
+import './recall-context-composition.js';
+import './live-connectors-runner.js';
+import './framework-CNDn2164.js';
+import './relevance.js';
+import './negative.js';
+import './session-observer-state.js';
+import './semantic-TddhF0y7.js';
+import './replay/types.js';
+import './service-BeDxSqE-.js';
+import './extraction-judge.js';
+import './lcm/engine.js';
+import './lcm/archive.js';
+import './lcm/summarizer.js';
+import './lcm/dag.js';
+import './lcm/recall.js';
+import './lcm/queue.js';
+import './policy-runtime.js';
+import './explicit-capture.js';
+import './cross-namespace-budget.js';
+import './access-wearables-meetings-surface.js';
+import './graph-snapshot.js';
+import './memory-worth-outcomes.js';
+import './transfer/capsule-import.js';
+import './transfer/types.js';
+import './transfer/capsule-export.js';
+import './capsule-cli.js';
+import './offline-sync.js';
+import './access-offline-manifest.js';
+import './reconcile/manifest.js';
+import './reconcile/plan.js';
+import './action-confidence.js';
+import './access-errors.js';
+import './citations.js';
+
+interface ExternalWikiSearchOutput {
+    readonly result: ExternalWikiSearchResult;
+}
+declare const externalWikiSearchOperation: BoundOperation<ExternalWikiSearchInput, ExternalWikiSearchOutput>;
+
+export { type ExternalWikiSearchOutput, externalWikiSearchOperation };

package/dist/external-wiki-access.js

@@ -0,0 +1,186 @@
+import {
+  externalWikiSearchOperation
+} from "./chunk-D3I2MCN7.js";
+import "./chunk-7CITSYSH.js";
+import "./chunk-ZMAYKGPN.js";
+import "./chunk-ZI32MKDW.js";
+import "./chunk-GDASG7NC.js";
+import "./chunk-GDB4J2H3.js";
+import "./chunk-A4JMGKCD.js";
+import "./chunk-VQ7B2Q6M.js";
+import "./chunk-PJSK6OJM.js";
+import "./chunk-JGSKJHF7.js";
+import "./chunk-GNVZQ5JN.js";
+import "./chunk-YN2UN7N3.js";
+import "./chunk-P5FPO2BR.js";
+import "./chunk-S4DDLTPX.js";
+import "./chunk-O4KMGRXE.js";
+import "./chunk-SOBJ6NEY.js";
+import "./chunk-HFPASSFV.js";
+import "./chunk-AHVEHR6K.js";
+import "./chunk-H7XKCNR6.js";
+import "./chunk-EJHEWCGQ.js";
+import "./chunk-ICP53SKG.js";
+import "./chunk-AQEJKOKI.js";
+import "./chunk-6HMYUWXR.js";
+import "./chunk-CVILPI77.js";
+import "./chunk-EIR5VLIH.js";
+import "./chunk-IISBCCWR.js";
+import "./chunk-JYIFGGEM.js";
+import "./chunk-LTHVM4XN.js";
+import "./chunk-EI6V5UXY.js";
+import "./chunk-X4IDNPOS.js";
+import "./chunk-PNRA7FAD.js";
+import "./chunk-EMDLM3LW.js";
+import "./chunk-NLE6TSLG.js";
+import "./chunk-QDW3E4RD.js";
+import "./chunk-S5NZBKKQ.js";
+import "./chunk-C37ZRXX7.js";
+import "./chunk-EITZHSX6.js";
+import "./chunk-Y7HRYCNW.js";
+import "./chunk-C26TE27X.js";
+import "./chunk-NUEQKLNB.js";
+import "./chunk-UQWIKLQK.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-YLHM5BQQ.js";
+import "./chunk-VYISFWVX.js";
+import "./chunk-GWFSVJ4P.js";
+import "./chunk-XL3TATMJ.js";
+import "./chunk-VANZKHTN.js";
+import "./chunk-W7IGLX4G.js";
+import "./chunk-GUMZC2BO.js";
+import "./chunk-CLB32OHM.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
+import "./chunk-ET356KSB.js";
+import "./chunk-72A4L5JJ.js";
+import "./chunk-3ONXXHQO.js";
+import "./chunk-UFGFMWAD.js";
+import "./chunk-ZFGZ6PZ2.js";
+import "./chunk-KSXJOC4F.js";
+import "./chunk-L2DPF4DF.js";
+import "./chunk-2LSZVONP.js";
+import "./chunk-DEUNUKTD.js";
+import "./chunk-W4FBGYGK.js";
+import "./chunk-TQ4GD737.js";
+import "./chunk-FZP32336.js";
+import "./chunk-UHVXE24Y.js";
+import "./chunk-ENTCVTQR.js";
+import "./chunk-SXIMQLGV.js";
+import "./chunk-S2V7RUCL.js";
+import "./chunk-J6A3CX5N.js";
+import "./chunk-DZPFMQZ7.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-WRJVB3C2.js";
+import "./chunk-DM2T26WE.js";
+import "./chunk-LDXUBPMO.js";
+import "./chunk-JYIJNNN3.js";
+import "./chunk-AAD2ZS6P.js";
+import "./chunk-SYUBB3WM.js";
+import "./chunk-CGASUJVP.js";
+import "./chunk-R3DJVOSM.js";
+import "./chunk-BT7NVCML.js";
+import "./chunk-YXZG5TVN.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-7YKVM5H3.js";
+import "./chunk-IJ7HK452.js";
+import "./chunk-PDJTHRAW.js";
+import "./chunk-NZBZ7IS2.js";
+import "./chunk-DNHVPZOD.js";
+import "./chunk-6CIAGZ6X.js";
+import "./chunk-WQIHRA5F.js";
+import "./chunk-PD6O7AXF.js";
+import "./chunk-QCECHYZL.js";
+import "./chunk-URS5GSM7.js";
+import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
+import "./chunk-OD4FM2U7.js";
+import "./chunk-XMMESCPD.js";
+import "./chunk-42JKGUFJ.js";
+import "./chunk-C23BYTJV.js";
+import "./chunk-QIEUU4UK.js";
+import "./chunk-L2EXJQJP.js";
+import "./chunk-45GF7Y3V.js";
+import "./chunk-RGMVMVMF.js";
+import "./chunk-N7RWREIQ.js";
+import "./chunk-ZY2MNJR6.js";
+import "./chunk-P32IDSHD.js";
+import "./chunk-WNIUPHWV.js";
+import "./chunk-IJ6WHMFB.js";
+import "./chunk-3SG4FGDV.js";
+import "./chunk-K6MV3TRQ.js";
+import "./chunk-QBSFOKY6.js";
+import "./chunk-5GKPFL3S.js";
+import "./chunk-ZIKENA2C.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-6MKAMLQL.js";
+import "./chunk-JAKIDQB2.js";
+import "./chunk-ZBJMUXZH.js";
+import "./chunk-TBBDFYXW.js";
+import "./chunk-KQAFEZQX.js";
+import "./chunk-WEHSQBFR.js";
+import "./chunk-X7Y7WX73.js";
+import "./chunk-J4EB7DNW.js";
+import "./chunk-BJMBJZ2Y.js";
+import "./chunk-UKJAGEXH.js";
+import "./chunk-FP2373TW.js";
+import "./chunk-Z2YFLXHU.js";
+import "./chunk-I4WBNM3M.js";
+import "./chunk-SOAU2OE2.js";
+import "./chunk-3QL24R5Y.js";
+import "./chunk-SYOIVK7K.js";
+import "./chunk-7HXCF4RE.js";
+import "./chunk-LNEWDF2A.js";
+import "./chunk-BIPBQQFI.js";
+import "./chunk-VHFXP27N.js";
+import "./chunk-G7A5HLUS.js";
+import "./chunk-5U7ID3EZ.js";
+import "./chunk-YN6ASZUG.js";
+import "./chunk-R6YJI3HE.js";
+import "./chunk-ELIL2A37.js";
+import "./chunk-EGGE52UU.js";
+import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-GCASGYIO.js";
+import "./chunk-BQIFZ2MP.js";
+import "./chunk-3CSX3ETE.js";
+import "./chunk-RL6NEVXT.js";
+import "./chunk-FFAZ2XFU.js";
+import "./chunk-W5H6ZRPT.js";
+import "./chunk-BGLY7EEM.js";
+import "./chunk-HBVPYRDW.js";
+import "./chunk-GYPQL6XN.js";
+import "./chunk-UI3NYK34.js";
+import "./chunk-GCGJW34D.js";
+import "./chunk-AREGMX2J.js";
+import "./chunk-P7FMDTKL.js";
+import "./chunk-MZWSOLMT.js";
+import "./chunk-3GD2HFR6.js";
+import "./chunk-U3PN77QT.js";
+import "./chunk-2XRE6FLM.js";
+import "./chunk-VFUEZZBS.js";
+import "./chunk-773TRRGT.js";
+import "./chunk-J2WC5LF4.js";
+import "./chunk-O75CRYGF.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
+import "./chunk-2Z24E5W2.js";
+import "./chunk-BTTPKDIL.js";
+import "./chunk-A2IYSXDQ.js";
+import "./chunk-LPSF4OQH.js";
+import "./chunk-TVVEYCNW.js";
+import "./chunk-RFYAYKTD.js";
+import "./chunk-LBLXEFWK.js";
+import "./chunk-JIYDRBVZ.js";
+import "./chunk-FF4KLI5W.js";
+import "./chunk-XQ3HXAQH.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-5UZXUTVO.js";
+import "./chunk-VS2IYZRU.js";
+import "./chunk-NINSR6LX.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  externalWikiSearchOperation
+};
+//# sourceMappingURL=external-wiki-access.js.map

package/dist/external-wiki-access.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/external-wiki-cli.d.ts

@@ -0,0 +1,13 @@
+import { ExternalWikiRoot } from './external-wiki-config.js';
+
+interface ExternalWikiCliIo {
+    readonly stdout: {
+        write(chunk: string): unknown;
+    };
+    readonly stderr: {
+        write(chunk: string): unknown;
+    };
+}
+declare function runExternalWikiCliCommand(roots: readonly ExternalWikiRoot[], args: readonly string[], io: ExternalWikiCliIo): Promise<number>;
+
+export { runExternalWikiCliCommand };

package/dist/external-wiki-cli.js

@@ -0,0 +1,96 @@
+import {
+  searchExternalWikis
+} from "./chunk-7CITSYSH.js";
+import "./chunk-ZMAYKGPN.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/external-wiki-cli.ts
+var USAGE = "Usage: remnic external-wiki search <query...> [--wiki-id <id>] [--limit <1-20>] [--max-chars-per-hit <100-8000>] [--json]\n";
+async function runExternalWikiCliCommand(roots, args, io) {
+  if (args.length === 0 || args[0] === "help" || args[0] === "--help" || args[0] === "-h") {
+    io.stdout.write(USAGE);
+    return 0;
+  }
+  if (args[0] !== "search") {
+    io.stderr.write(`external-wiki: unknown command '${args[0]}'
+${USAGE}`);
+    return 2;
+  }
+  let limit;
+  let wikiId;
+  let maxCharsPerHit;
+  let json = false;
+  const queryParts = [];
+  for (let index = 1; index < args.length; index += 1) {
+    const argument = args[index];
+    if (argument === "--json") {
+      json = true;
+      continue;
+    }
+    if (argument === "--limit" || argument === "--wiki-id" || argument === "--max-chars-per-hit") {
+      const value = args[index + 1];
+      if (value === void 0 || value.startsWith("--")) {
+        io.stderr.write(`external-wiki: ${argument} requires a value
+`);
+        return 2;
+      }
+      index += 1;
+      if (argument === "--wiki-id") {
+        wikiId = value.trim();
+        if (wikiId.length === 0) {
+          io.stderr.write("external-wiki: --wiki-id must not be empty\n");
+          return 2;
+        }
+        continue;
+      }
+      const parsed = Number(value);
+      const maximum = argument === "--limit" ? 20 : 8e3;
+      const minimum = argument === "--limit" ? 1 : 100;
+      if (!Number.isInteger(parsed) || parsed < minimum || parsed > maximum) {
+        io.stderr.write(`external-wiki: ${argument} must be an integer from ${minimum} to ${maximum}
+`);
+        return 2;
+      }
+      if (argument === "--limit") limit = parsed;
+      else maxCharsPerHit = parsed;
+      continue;
+    }
+    if (argument.startsWith("-")) {
+      io.stderr.write(`external-wiki: unknown option '${argument}'
+${USAGE}`);
+      return 2;
+    }
+    queryParts.push(argument);
+  }
+  const query = queryParts.join(" ").trim();
+  if (query.length === 0) {
+    io.stderr.write(`external-wiki: query is required
+${USAGE}`);
+    return 2;
+  }
+  const result = await searchExternalWikis(roots, { query, limit, wikiId, maxCharsPerHit });
+  if (json) {
+    io.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+    return 0;
+  }
+  io.stdout.write(`External wiki results for "${result.query}" (${result.count})
+`);
+  for (const hit of result.hits) {
+    const citation = hit.citations[0];
+    const location = citation ? `${citation.path}:${citation.lineStart}-${citation.lineEnd}` : hit.path;
+    io.stdout.write(`${hit.rank}. [${hit.wikiId}] ${hit.title} (${location})
+`);
+    io.stdout.write(`   ${hit.snippet.replace(/\s+/g, " ").trim()}
+`);
+  }
+  if (result.degradedWikiIds.length > 0) {
+    io.stderr.write(`external-wiki: degraded roots: ${result.degradedWikiIds.join(", ")}
+`);
+  }
+  return 0;
+}
+export {
+  runExternalWikiCliCommand
+};
+//# sourceMappingURL=external-wiki-cli.js.map

package/dist/external-wiki-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/external-wiki-cli.ts"],"sourcesContent":["import { type ExternalWikiRoot, searchExternalWikis } from \"./external-wiki-search.js\";\n\ninterface ExternalWikiCliIo {\n  readonly stdout: { write(chunk: string): unknown };\n  readonly stderr: { write(chunk: string): unknown };\n}\n\nconst USAGE =\n  \"Usage: remnic external-wiki search <query...> [--wiki-id <id>] [--limit <1-20>] [--max-chars-per-hit <100-8000>] [--json]\\n\";\n\nexport async function runExternalWikiCliCommand(\n  roots: readonly ExternalWikiRoot[],\n  args: readonly string[],\n  io: ExternalWikiCliIo\n): Promise<number> {\n  if (args.length === 0 || args[0] === \"help\" || args[0] === \"--help\" || args[0] === \"-h\") {\n    io.stdout.write(USAGE);\n    return 0;\n  }\n  if (args[0] !== \"search\") {\n    io.stderr.write(`external-wiki: unknown command '${args[0]}'\\n${USAGE}`);\n    return 2;\n  }\n\n  let limit: number | undefined;\n  let wikiId: string | undefined;\n  let maxCharsPerHit: number | undefined;\n  let json = false;\n  const queryParts: string[] = [];\n  for (let index = 1; index < args.length; index += 1) {\n    const argument = args[index];\n    if (argument === \"--json\") {\n      json = true;\n      continue;\n    }\n    if (argument === \"--limit\" || argument === \"--wiki-id\" || argument === \"--max-chars-per-hit\") {\n      const value = args[index + 1];\n      if (value === undefined || value.startsWith(\"--\")) {\n        io.stderr.write(`external-wiki: ${argument} requires a value\\n`);\n        return 2;\n      }\n      index += 1;\n      if (argument === \"--wiki-id\") {\n        wikiId = value.trim();\n        if (wikiId.length === 0) {\n          io.stderr.write(\"external-wiki: --wiki-id must not be empty\\n\");\n          return 2;\n        }\n        continue;\n      }\n      const parsed = Number(value);\n      const maximum = argument === \"--limit\" ? 20 : 8_000;\n      const minimum = argument === \"--limit\" ? 1 : 100;\n      if (!Number.isInteger(parsed) || parsed < minimum || parsed > maximum) {\n        io.stderr.write(`external-wiki: ${argument} must be an integer from ${minimum} to ${maximum}\\n`);\n        return 2;\n      }\n      if (argument === \"--limit\") limit = parsed;\n      else maxCharsPerHit = parsed;\n      continue;\n    }\n    if (argument.startsWith(\"-\")) {\n      io.stderr.write(`external-wiki: unknown option '${argument}'\\n${USAGE}`);\n      return 2;\n    }\n    queryParts.push(argument);\n  }\n\n  const query = queryParts.join(\" \").trim();\n  if (query.length === 0) {\n    io.stderr.write(`external-wiki: query is required\\n${USAGE}`);\n    return 2;\n  }\n\n  const result = await searchExternalWikis(roots, { query, limit, wikiId, maxCharsPerHit });\n  if (json) {\n    io.stdout.write(`${JSON.stringify(result, null, 2)}\\n`);\n    return 0;\n  }\n\n  io.stdout.write(`External wiki results for \"${result.query}\" (${result.count})\\n`);\n  for (const hit of result.hits) {\n    const citation = hit.citations[0];\n    const location = citation ? `${citation.path}:${citation.lineStart}-${citation.lineEnd}` : hit.path;\n    io.stdout.write(`${hit.rank}. [${hit.wikiId}] ${hit.title} (${location})\\n`);\n    io.stdout.write(`   ${hit.snippet.replace(/\\s+/g, \" \").trim()}\\n`);\n  }\n  if (result.degradedWikiIds.length > 0) {\n    io.stderr.write(`external-wiki: degraded roots: ${result.degradedWikiIds.join(\", \")}\\n`);\n  }\n  return 0;\n}\n"],"mappings":"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","names":[]}

package/dist/external-wiki-collection-registration.d.ts

@@ -0,0 +1,39 @@
+import { ExternalWikiCollectionRoot, ExternalWikiCollectionStatus } from './external-wiki-collection.js';
+import { SearchExecutionOptions } from './search/port.js';
+import './types-yX_FwERf.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './types-continuity.js';
+
+interface ExternalWikiCollectionRefreshTarget {
+    refresh(roots: readonly ExternalWikiCollectionRoot[], execution?: SearchExecutionOptions): Promise<ExternalWikiCollectionStatus[]>;
+}
+interface ExternalWikiCollectionTimers {
+    schedule(callback: () => void, intervalMs: number): object;
+    cancel(handle: object): void;
+}
+interface ExternalWikiCollectionRegistrarOptions {
+    target: ExternalWikiCollectionRefreshTarget;
+    getRoots: () => readonly ExternalWikiCollectionRoot[];
+    intervalMs: number;
+    timers?: ExternalWikiCollectionTimers;
+}
+declare class ExternalWikiCollectionRegistrar {
+    private readonly options;
+    private readonly timers;
+    private timer;
+    private controller;
+    private inFlight;
+    private disposed;
+    private parentSignal;
+    private parentAbortListener;
+    constructor(options: ExternalWikiCollectionRegistrarOptions);
+    register(signal?: AbortSignal): Promise<void>;
+    refreshNow(): Promise<void>;
+    waitForIdle(): Promise<void>;
+    dispose(): Promise<void>;
+}
+
+export { type ExternalWikiCollectionRefreshTarget, ExternalWikiCollectionRegistrar, type ExternalWikiCollectionRegistrarOptions, type ExternalWikiCollectionTimers };

package/dist/external-wiki-collection-registration.js

@@ -0,0 +1,79 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/external-wiki-collection-registration.ts
+var defaultTimers = {
+  schedule(callback, intervalMs) {
+    const handle = setInterval(callback, intervalMs);
+    handle.unref();
+    return handle;
+  },
+  cancel(handle) {
+    clearInterval(handle);
+  }
+};
+var ExternalWikiCollectionRegistrar = class {
+  constructor(options) {
+    this.options = options;
+    this.timers = options.timers ?? defaultTimers;
+  }
+  options;
+  timers;
+  timer = null;
+  controller = null;
+  inFlight = null;
+  disposed = true;
+  parentSignal = null;
+  parentAbortListener = null;
+  async register(signal) {
+    await this.dispose();
+    if (signal?.aborted) return;
+    this.disposed = false;
+    this.controller = new AbortController();
+    if (signal) {
+      this.parentSignal = signal;
+      this.parentAbortListener = () => this.controller?.abort();
+      signal.addEventListener("abort", this.parentAbortListener, { once: true });
+    }
+    await this.refreshNow();
+    if (this.disposed || this.controller.signal.aborted) return;
+    this.timer = this.timers.schedule(() => {
+      void this.refreshNow().catch(() => void 0);
+    }, this.options.intervalMs);
+  }
+  async refreshNow() {
+    if (this.disposed || this.controller?.signal.aborted) return;
+    if (this.inFlight) return this.inFlight;
+    const execution = this.controller ? { signal: this.controller.signal } : void 0;
+    const running = this.options.target.refresh(this.options.getRoots(), execution).then(() => void 0);
+    this.inFlight = running;
+    const clearInFlight = () => {
+      if (this.inFlight === running) this.inFlight = null;
+    };
+    void running.then(clearInFlight, clearInFlight);
+    return running;
+  }
+  async waitForIdle() {
+    while (this.inFlight) {
+      await this.inFlight;
+    }
+  }
+  async dispose() {
+    this.disposed = true;
+    if (this.timer) {
+      this.timers.cancel(this.timer);
+      this.timer = null;
+    }
+    this.controller?.abort();
+    if (this.parentSignal && this.parentAbortListener) {
+      this.parentSignal.removeEventListener("abort", this.parentAbortListener);
+    }
+    this.parentSignal = null;
+    this.parentAbortListener = null;
+    await this.waitForIdle();
+    this.controller = null;
+  }
+};
+export {
+  ExternalWikiCollectionRegistrar
+};
+//# sourceMappingURL=external-wiki-collection-registration.js.map

package/dist/external-wiki-collection-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/external-wiki-collection-registration.ts"],"sourcesContent":["import type { ExternalWikiCollectionRoot, ExternalWikiCollectionStatus } from \"./external-wiki-collection.js\";\nimport type { SearchExecutionOptions } from \"./search/port.js\";\n\nexport interface ExternalWikiCollectionRefreshTarget {\n  refresh(\n    roots: readonly ExternalWikiCollectionRoot[],\n    execution?: SearchExecutionOptions\n  ): Promise<ExternalWikiCollectionStatus[]>;\n}\n\nexport interface ExternalWikiCollectionTimers {\n  schedule(callback: () => void, intervalMs: number): object;\n  cancel(handle: object): void;\n}\n\nexport interface ExternalWikiCollectionRegistrarOptions {\n  target: ExternalWikiCollectionRefreshTarget;\n  getRoots: () => readonly ExternalWikiCollectionRoot[];\n  intervalMs: number;\n  timers?: ExternalWikiCollectionTimers;\n}\n\nconst defaultTimers: ExternalWikiCollectionTimers = {\n  schedule(callback, intervalMs) {\n    const handle = setInterval(callback, intervalMs);\n    handle.unref();\n    return handle;\n  },\n  cancel(handle) {\n    clearInterval(handle as NodeJS.Timeout);\n  },\n};\n\nexport class ExternalWikiCollectionRegistrar {\n  private readonly timers: ExternalWikiCollectionTimers;\n  private timer: object | null = null;\n  private controller: AbortController | null = null;\n  private inFlight: Promise<void> | null = null;\n  private disposed = true;\n  private parentSignal: AbortSignal | null = null;\n  private parentAbortListener: (() => void) | null = null;\n\n  constructor(private readonly options: ExternalWikiCollectionRegistrarOptions) {\n    this.timers = options.timers ?? defaultTimers;\n  }\n\n  async register(signal?: AbortSignal): Promise<void> {\n    await this.dispose();\n    if (signal?.aborted) return;\n\n    this.disposed = false;\n    this.controller = new AbortController();\n    if (signal) {\n      this.parentSignal = signal;\n      this.parentAbortListener = () => this.controller?.abort();\n      signal.addEventListener(\"abort\", this.parentAbortListener, { once: true });\n    }\n\n    await this.refreshNow();\n    if (this.disposed || this.controller.signal.aborted) return;\n    this.timer = this.timers.schedule(() => {\n      void this.refreshNow().catch(() => undefined);\n    }, this.options.intervalMs);\n  }\n\n  async refreshNow(): Promise<void> {\n    if (this.disposed || this.controller?.signal.aborted) return;\n    if (this.inFlight) return this.inFlight;\n\n    const execution = this.controller ? { signal: this.controller.signal } : undefined;\n    const running = this.options.target.refresh(this.options.getRoots(), execution).then(() => undefined);\n    this.inFlight = running;\n    const clearInFlight = () => {\n      if (this.inFlight === running) this.inFlight = null;\n    };\n    void running.then(clearInFlight, clearInFlight);\n    return running;\n  }\n\n  async waitForIdle(): Promise<void> {\n    while (this.inFlight) {\n      await this.inFlight;\n    }\n  }\n\n  async dispose(): Promise<void> {\n    this.disposed = true;\n    if (this.timer) {\n      this.timers.cancel(this.timer);\n      this.timer = null;\n    }\n    this.controller?.abort();\n    if (this.parentSignal && this.parentAbortListener) {\n      this.parentSignal.removeEventListener(\"abort\", this.parentAbortListener);\n    }\n    this.parentSignal = null;\n    this.parentAbortListener = null;\n    await this.waitForIdle();\n    this.controller = null;\n  }\n}\n"],"mappings":";;;AAsBA,IAAM,gBAA8C;AAAA,EAClD,SAAS,UAAU,YAAY;AAC7B,UAAM,SAAS,YAAY,UAAU,UAAU;AAC/C,WAAO,MAAM;AACb,WAAO;AAAA,EACT;AAAA,EACA,OAAO,QAAQ;AACb,kBAAc,MAAwB;AAAA,EACxC;AACF;AAEO,IAAM,kCAAN,MAAsC;AAAA,EAS3C,YAA6B,SAAiD;AAAjD;AAC3B,SAAK,SAAS,QAAQ,UAAU;AAAA,EAClC;AAAA,EAF6B;AAAA,EARZ;AAAA,EACT,QAAuB;AAAA,EACvB,aAAqC;AAAA,EACrC,WAAiC;AAAA,EACjC,WAAW;AAAA,EACX,eAAmC;AAAA,EACnC,sBAA2C;AAAA,EAMnD,MAAM,SAAS,QAAqC;AAClD,UAAM,KAAK,QAAQ;AACnB,QAAI,QAAQ,QAAS;AAErB,SAAK,WAAW;AAChB,SAAK,aAAa,IAAI,gBAAgB;AACtC,QAAI,QAAQ;AACV,WAAK,eAAe;AACpB,WAAK,sBAAsB,MAAM,KAAK,YAAY,MAAM;AACxD,aAAO,iBAAiB,SAAS,KAAK,qBAAqB,EAAE,MAAM,KAAK,CAAC;AAAA,IAC3E;AAEA,UAAM,KAAK,WAAW;AACtB,QAAI,KAAK,YAAY,KAAK,WAAW,OAAO,QAAS;AACrD,SAAK,QAAQ,KAAK,OAAO,SAAS,MAAM;AACtC,WAAK,KAAK,WAAW,EAAE,MAAM,MAAM,MAAS;AAAA,IAC9C,GAAG,KAAK,QAAQ,UAAU;AAAA,EAC5B;AAAA,EAEA,MAAM,aAA4B;AAChC,QAAI,KAAK,YAAY,KAAK,YAAY,OAAO,QAAS;AACtD,QAAI,KAAK,SAAU,QAAO,KAAK;AAE/B,UAAM,YAAY,KAAK,aAAa,EAAE,QAAQ,KAAK,WAAW,OAAO,IAAI;AACzE,UAAM,UAAU,KAAK,QAAQ,OAAO,QAAQ,KAAK,QAAQ,SAAS,GAAG,SAAS,EAAE,KAAK,MAAM,MAAS;AACpG,SAAK,WAAW;AAChB,UAAM,gBAAgB,MAAM;AAC1B,UAAI,KAAK,aAAa,QAAS,MAAK,WAAW;AAAA,IACjD;AACA,SAAK,QAAQ,KAAK,eAAe,aAAa;AAC9C,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,cAA6B;AACjC,WAAO,KAAK,UAAU;AACpB,YAAM,KAAK;AAAA,IACb;AAAA,EACF;AAAA,EAEA,MAAM,UAAyB;AAC7B,SAAK,WAAW;AAChB,QAAI,KAAK,OAAO;AACd,WAAK,OAAO,OAAO,KAAK,KAAK;AAC7B,WAAK,QAAQ;AAAA,IACf;AACA,SAAK,YAAY,MAAM;AACvB,QAAI,KAAK,gBAAgB,KAAK,qBAAqB;AACjD,WAAK,aAAa,oBAAoB,SAAS,KAAK,mBAAmB;AAAA,IACzE;AACA,SAAK,eAAe;AACpB,SAAK,sBAAsB;AAC3B,UAAM,KAAK,YAAY;AACvB,SAAK,aAAa;AAAA,EACpB;AACF;","names":[]}

package/dist/external-wiki-collection.d.ts

@@ -0,0 +1,50 @@
+import { SearchBackend, SearchExecutionOptions, SearchResult } from './search/port.js';
+import './types-yX_FwERf.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './types-continuity.js';
+
+interface ExternalWikiCollectionRoot {
+    id: string;
+    rootDir: string;
+    enabled?: boolean;
+    pagesDir?: string;
+    indexInQmd?: boolean;
+}
+type ExternalWikiCollectionBackend = Pick<SearchBackend, "updateCollectionStrict" | "updateCollectionFromDir" | "embedCollection" | "embedCollectionStrict" | "hybridSearch" | "collectionStatus"> & {
+    ensureCollection(rootDir: string, collection: string, execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
+} & Required<Pick<SearchBackend, "supportsAdditionalCollections" | "excludeCollectionFromGlobalSearch" | "deleteCollection" | "collectionRoot">>;
+type ExternalWikiCollectionState = "disabled" | "healthy" | "error";
+interface ExternalWikiCollectionStatus {
+    wikiId: string;
+    collection: string;
+    state: ExternalWikiCollectionState;
+    documentCount: number | null;
+    lastIndexedAt: string | null;
+    lastError: string | null;
+}
+declare function externalWikiCollectionName(wikiId: string): string;
+declare function supportsExternalWikiCollections(backend: SearchBackend | ExternalWikiCollectionBackend): backend is ExternalWikiCollectionBackend;
+declare class ExternalWikiCollectionManager {
+    private readonly backend;
+    private readonly defaultCollection;
+    private readonly now;
+    private readonly managedByWikiId;
+    private operationTail;
+    constructor(backend: SearchBackend | ExternalWikiCollectionBackend, defaultCollection: string, now?: () => Date);
+    statuses(): ExternalWikiCollectionStatus[];
+    refresh(roots: readonly ExternalWikiCollectionRoot[], execution?: SearchExecutionOptions): Promise<ExternalWikiCollectionStatus[]>;
+    private refreshSerial;
+    search(wikiId: string, query: string, limit: number, execution?: SearchExecutionOptions): Promise<SearchResult[] | null>;
+    purge(wikiId: string, execution?: SearchExecutionOptions): Promise<boolean>;
+    private enqueueOperation;
+    private refreshRoot;
+    private assertDedicatedCollection;
+    private rememberDisabled;
+    private rememberError;
+    private removeManagedCollection;
+}
+
+export { type ExternalWikiCollectionBackend, ExternalWikiCollectionManager, type ExternalWikiCollectionRoot, type ExternalWikiCollectionState, type ExternalWikiCollectionStatus, externalWikiCollectionName, supportsExternalWikiCollections };