wiki-graph-sdk 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +32 -0
  3. package/dist/archives.cjs +2799 -0
  4. package/dist/archives.cjs.map +1 -0
  5. package/dist/archives.d.ts +249 -0
  6. package/dist/archives.js +2814 -0
  7. package/dist/archives.js.map +1 -0
  8. package/dist/conversions.cjs +1332 -0
  9. package/dist/conversions.cjs.map +1 -0
  10. package/dist/conversions.d.ts +37 -0
  11. package/dist/conversions.js +1308 -0
  12. package/dist/conversions.js.map +1 -0
  13. package/dist/data/editor/clue_reviewer.jinja +410 -0
  14. package/dist/data/editor/clue_reviewer_generator.jinja +428 -0
  15. package/dist/data/editor/revision_feedback.jinja +5 -0
  16. package/dist/data/editor/text_compressor.jinja +131 -0
  17. package/dist/data/guaranteed/response_intent_classifier.jinja +8 -0
  18. package/dist/data/output/epub/cover.xhtml.jinja +13 -0
  19. package/dist/data/output/epub/nav.xhtml.jinja +12 -0
  20. package/dist/data/output/epub/package.opf.xml.jinja +39 -0
  21. package/dist/data/output/epub/section.xhtml.jinja +12 -0
  22. package/dist/data/topologization/book_coherence_extraction.jinja +223 -0
  23. package/dist/data/topologization/chunk_extraction.jinja +233 -0
  24. package/dist/data/topologization/evidence_choice.jinja +38 -0
  25. package/dist/data/topologization/translate_chunks.jinja +138 -0
  26. package/dist/data/topologization/user_focused_extraction.jinja +378 -0
  27. package/dist/default-worker.cjs +1709 -0
  28. package/dist/default-worker.cjs.map +1 -0
  29. package/dist/default-worker.d.ts +10 -0
  30. package/dist/default-worker.js +1705 -0
  31. package/dist/default-worker.js.map +1 -0
  32. package/dist/embedding.cjs +1091 -0
  33. package/dist/embedding.cjs.map +1 -0
  34. package/dist/embedding.d.ts +26 -0
  35. package/dist/embedding.js +1062 -0
  36. package/dist/embedding.js.map +1 -0
  37. package/dist/entry-context.cjs +91 -0
  38. package/dist/entry-context.cjs.map +1 -0
  39. package/dist/entry-context.d.ts +20 -0
  40. package/dist/entry-context.js +68 -0
  41. package/dist/entry-context.js.map +1 -0
  42. package/dist/gc.cjs +731 -0
  43. package/dist/gc.cjs.map +1 -0
  44. package/dist/gc.d.ts +14 -0
  45. package/dist/gc.js +707 -0
  46. package/dist/gc.js.map +1 -0
  47. package/dist/index.cjs +4760 -0
  48. package/dist/index.cjs.map +1 -0
  49. package/dist/index.d.ts +213 -0
  50. package/dist/index.js +4808 -0
  51. package/dist/index.js.map +1 -0
  52. package/dist/jobs-Dd5PMSId.d.ts +98 -0
  53. package/dist/llm.cjs +101 -0
  54. package/dist/llm.cjs.map +1 -0
  55. package/dist/llm.d.ts +7 -0
  56. package/dist/llm.js +79 -0
  57. package/dist/llm.js.map +1 -0
  58. package/dist/local-config.cjs +1024 -0
  59. package/dist/local-config.cjs.map +1 -0
  60. package/dist/local-config.d.ts +14 -0
  61. package/dist/local-config.js +989 -0
  62. package/dist/local-config.js.map +1 -0
  63. package/dist/maintenance.cjs +800 -0
  64. package/dist/maintenance.cjs.map +1 -0
  65. package/dist/maintenance.d.ts +24 -0
  66. package/dist/maintenance.js +778 -0
  67. package/dist/maintenance.js.map +1 -0
  68. package/dist/node-platform.cjs +758 -0
  69. package/dist/node-platform.cjs.map +1 -0
  70. package/dist/node-platform.d.ts +49 -0
  71. package/dist/node-platform.js +723 -0
  72. package/dist/node-platform.js.map +1 -0
  73. package/dist/planning.cjs +164 -0
  74. package/dist/planning.cjs.map +1 -0
  75. package/dist/planning.d.ts +43 -0
  76. package/dist/planning.js +137 -0
  77. package/dist/planning.js.map +1 -0
  78. package/dist/runtime-config.cjs +1155 -0
  79. package/dist/runtime-config.cjs.map +1 -0
  80. package/dist/runtime-config.d.ts +50 -0
  81. package/dist/runtime-config.js +1127 -0
  82. package/dist/runtime-config.js.map +1 -0
  83. package/dist/stage.cjs +1265 -0
  84. package/dist/stage.cjs.map +1 -0
  85. package/dist/stage.d.ts +16 -0
  86. package/dist/stage.js +1239 -0
  87. package/dist/stage.js.map +1 -0
  88. package/dist/wikispine.cjs +85 -0
  89. package/dist/wikispine.cjs.map +1 -0
  90. package/dist/wikispine.d.ts +6 -0
  91. package/dist/wikispine.js +63 -0
  92. package/dist/wikispine.js.map +1 -0
  93. package/dist/worker.cjs +738 -0
  94. package/dist/worker.cjs.map +1 -0
  95. package/dist/worker.d.ts +157 -0
  96. package/dist/worker.js +715 -0
  97. package/dist/worker.js.map +1 -0
  98. package/package.json +151 -0
@@ -0,0 +1,1024 @@
1
+ globalThis.__WIKIGRAPH_DATA_DIR__ ??= require("path").resolve(__dirname, "data");
2
+ "use strict";
3
+ var __create = Object.create;
4
+ var __defProp = Object.defineProperty;
5
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
6
+ var __getOwnPropNames = Object.getOwnPropertyNames;
7
+ var __getProtoOf = Object.getPrototypeOf;
8
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
9
+ var __export = (target, all) => {
10
+ for (var name in all)
11
+ __defProp(target, name, { get: all[name], enumerable: true });
12
+ };
13
+ var __copyProps = (to, from, except, desc) => {
14
+ if (from && typeof from === "object" || typeof from === "function") {
15
+ for (let key of __getOwnPropNames(from))
16
+ if (!__hasOwnProp.call(to, key) && key !== except)
17
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
18
+ }
19
+ return to;
20
+ };
21
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
22
+ // If the importer is in node compatibility mode or this is not an ESM
23
+ // file that has been converted to a CommonJS file using a Babel-
24
+ // compatible transform (i.e. "__esModule" has not been set), then set
25
+ // "default" to the CommonJS "module.exports" for node compatibility.
26
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
27
+ mod
28
+ ));
29
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
30
+
31
+ // src/local-config.ts
32
+ var local_config_exports = {};
33
+ __export(local_config_exports, {
34
+ LOCAL_CONFIG_SECTIONS: () => LOCAL_CONFIG_SECTIONS,
35
+ clearLocalConfigSection: () => clearLocalConfigSection,
36
+ deleteLocalConfigValue: () => deleteLocalConfigValue,
37
+ maskLocalConfigSection: () => maskLocalConfigSection,
38
+ normalizeLocalConfigKey: () => normalizeLocalConfigKey,
39
+ parseLocalConfigSection: () => parseLocalConfigSection,
40
+ putLocalConfigValue: () => putLocalConfigValue,
41
+ readLocalConfigSection: () => readLocalConfigSection,
42
+ replaceLocalConfigSection: () => replaceLocalConfigSection,
43
+ validateLocalConfigSection: () => validateLocalConfigSection
44
+ });
45
+ module.exports = __toCommonJS(local_config_exports);
46
+ var import_wiki_graph_core = require("wiki-graph-core");
47
+
48
+ // src/runtime-context.ts
49
+ var import_async_hooks = require("async_hooks");
50
+ var RUNTIME_CONTEXT_KEY = /* @__PURE__ */ Symbol.for("wiki-graph-sdk.runtime-context.v1");
51
+ var runtimeContext = getRuntimeContextStorage();
52
+ function getRuntimeContextStorage() {
53
+ const runtimeGlobal = globalThis;
54
+ const existing = runtimeGlobal[RUNTIME_CONTEXT_KEY];
55
+ if (existing !== void 0) {
56
+ return existing;
57
+ }
58
+ const storage = new import_async_hooks.AsyncLocalStorage();
59
+ Object.defineProperty(runtimeGlobal, RUNTIME_CONTEXT_KEY, {
60
+ configurable: false,
61
+ enumerable: false,
62
+ value: storage,
63
+ writable: false
64
+ });
65
+ return storage;
66
+ }
67
+ function getWikiGraphSDKRuntimeContext() {
68
+ return runtimeContext.getStore() ?? {
69
+ cwd: process.cwd(),
70
+ env: process.env,
71
+ envPolicy: "production"
72
+ };
73
+ }
74
+ function getWikiGraphSDKStateDir() {
75
+ return getWikiGraphSDKRuntimeContext().stateDir;
76
+ }
77
+
78
+ // src/node-platform.ts
79
+ var asyncHooks = __toESM(require("async_hooks"), 1);
80
+ var crypto = __toESM(require("crypto"), 1);
81
+ var fs = __toESM(require("fs"), 1);
82
+ var fsPromises = __toESM(require("fs/promises"), 1);
83
+ var os = __toESM(require("os"), 1);
84
+ var pathModule = __toESM(require("path"), 1);
85
+ var process2 = __toESM(require("process"), 1);
86
+ var import_node_stream = require("stream");
87
+ var import_promises = require("stream/promises");
88
+ var sqlite3 = __toESM(require("sqlite3"), 1);
89
+ var yauzl = __toESM(require("yauzl"), 1);
90
+ var yazl = __toESM(require("yazl"), 1);
91
+ var import_nunjucks = require("nunjucks");
92
+ var import_platform = require("wiki-graph-core/platform");
93
+ var nodeProcess = process2.default ?? process2;
94
+ var nodeSqlite3 = sqlite3.default ?? sqlite3;
95
+ var NODE_RESOURCE_KIND = /* @__PURE__ */ Symbol.for("wiki-graph-sdk.node-resource.v1");
96
+ var NodeFile = class {
97
+ constructor(path, name = pathModule.basename(path)) {
98
+ this.path = path;
99
+ this.identity = encodeNodeResourceIdentity("file", path);
100
+ this.name = name;
101
+ }
102
+ path;
103
+ kind = "file";
104
+ [NODE_RESOURCE_KIND] = "file";
105
+ identity;
106
+ name;
107
+ async openReader() {
108
+ const handle = await fsPromises.open(this.path, "r");
109
+ let closed = false;
110
+ try {
111
+ const stats = await handle.stat();
112
+ if (!stats.isFile())
113
+ throw new Error("File reader requires a regular file");
114
+ const { size } = stats;
115
+ return {
116
+ size,
117
+ close: async () => {
118
+ if (!closed) await handle.close();
119
+ closed = true;
120
+ },
121
+ read: async (offset, length) => {
122
+ if (closed) throw new Error("Cannot read from a closed FileReader");
123
+ assertFileRange(offset, length, size);
124
+ const buffer = Buffer.allocUnsafe(length);
125
+ let bytesRead = 0;
126
+ while (bytesRead < length) {
127
+ const result = await handle.read(
128
+ buffer,
129
+ bytesRead,
130
+ length - bytesRead,
131
+ offset + bytesRead
132
+ );
133
+ if (result.bytesRead === 0) {
134
+ throw new Error("File changed while reading its byte range");
135
+ }
136
+ bytesRead += result.bytesRead;
137
+ }
138
+ return new Uint8Array(buffer.buffer, buffer.byteOffset, bytesRead);
139
+ }
140
+ };
141
+ } catch (error) {
142
+ await handle.close();
143
+ throw error;
144
+ }
145
+ }
146
+ async getLastModified() {
147
+ try {
148
+ return (await fsPromises.stat(this.path)).mtimeMs;
149
+ } catch (error) {
150
+ if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
151
+ return void 0;
152
+ }
153
+ throw error;
154
+ }
155
+ }
156
+ async openWriter() {
157
+ await fsPromises.mkdir(pathModule.dirname(this.path), { recursive: true });
158
+ const temporary = `${this.path}.tmp-${crypto.randomUUID()}`;
159
+ const handle = await fsPromises.open(temporary, "wx");
160
+ let closed = false;
161
+ return {
162
+ write: async (data) => {
163
+ if (closed) throw new Error("Cannot write to a closed FileWriter");
164
+ await writeNodeFileHandle(handle, data);
165
+ },
166
+ writeAt: async (offset, data) => {
167
+ if (closed) throw new Error("Cannot write to a closed FileWriter");
168
+ assertFileOffset(offset);
169
+ await writeNodeFileHandle(handle, data, offset);
170
+ },
171
+ commit: async () => {
172
+ if (!closed) {
173
+ await handle.close();
174
+ await fsPromises.rename(temporary, this.path);
175
+ }
176
+ closed = true;
177
+ },
178
+ abort: async () => {
179
+ if (!closed) {
180
+ await handle.close();
181
+ await fsPromises.rm(temporary, { force: true });
182
+ }
183
+ closed = true;
184
+ }
185
+ };
186
+ }
187
+ };
188
+ async function writeNodeFileHandle(handle, data, position) {
189
+ const buffer = Buffer.from(data);
190
+ let written = 0;
191
+ while (written < buffer.byteLength) {
192
+ const result = await handle.write(
193
+ buffer,
194
+ written,
195
+ buffer.byteLength - written,
196
+ position === void 0 ? null : position + written
197
+ );
198
+ if (result.bytesWritten === 0) {
199
+ throw new Error("File writer made no progress");
200
+ }
201
+ written += result.bytesWritten;
202
+ }
203
+ }
204
+ function assertFileRange(offset, length, size) {
205
+ assertFileOffset(offset);
206
+ if (!Number.isSafeInteger(length) || length < 0) {
207
+ throw new RangeError(
208
+ "File read length must be a non-negative safe integer"
209
+ );
210
+ }
211
+ if (offset > size || length > size - offset) {
212
+ throw new RangeError("File read range exceeds the file size");
213
+ }
214
+ }
215
+ function assertFileOffset(offset) {
216
+ if (!Number.isSafeInteger(offset) || offset < 0) {
217
+ throw new RangeError("File offset must be a non-negative safe integer");
218
+ }
219
+ }
220
+ var NodeDirectory = class _NodeDirectory {
221
+ constructor(path) {
222
+ this.path = path;
223
+ this.identity = encodeNodeResourceIdentity("directory", path);
224
+ this.name = pathModule.basename(path);
225
+ }
226
+ path;
227
+ kind = "directory";
228
+ [NODE_RESOURCE_KIND] = "directory";
229
+ identity;
230
+ name;
231
+ async getFile(name) {
232
+ assertChildName(name);
233
+ const file = new NodeFile(pathModule.join(this.path, name));
234
+ try {
235
+ return (await fsPromises.stat(file.path)).isFile() ? file : void 0;
236
+ } catch {
237
+ return void 0;
238
+ }
239
+ }
240
+ async getLastModified() {
241
+ try {
242
+ return (await fsPromises.stat(this.path)).mtimeMs;
243
+ } catch (error) {
244
+ if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
245
+ return void 0;
246
+ }
247
+ throw error;
248
+ }
249
+ }
250
+ async getDirectory(name) {
251
+ assertChildName(name);
252
+ const directory = new _NodeDirectory(pathModule.join(this.path, name));
253
+ try {
254
+ return (await fsPromises.stat(directory.path)).isDirectory() ? directory : void 0;
255
+ } catch {
256
+ return void 0;
257
+ }
258
+ }
259
+ async list() {
260
+ const entries = await fsPromises.readdir(this.path, {
261
+ withFileTypes: true
262
+ });
263
+ return entries.map(
264
+ (entry) => entry.isDirectory() ? new _NodeDirectory(pathModule.join(this.path, entry.name)) : new NodeFile(pathModule.join(this.path, entry.name), entry.name)
265
+ );
266
+ }
267
+ async createFile(name) {
268
+ assertChildName(name);
269
+ await fsPromises.mkdir(this.path, { recursive: true });
270
+ const file = new NodeFile(pathModule.join(this.path, name));
271
+ await fsPromises.writeFile(file.path, "", { flag: "wx" });
272
+ return file;
273
+ }
274
+ async createDirectory(name) {
275
+ assertChildName(name);
276
+ await fsPromises.mkdir(this.path, { recursive: true });
277
+ const directory = new _NodeDirectory(pathModule.join(this.path, name));
278
+ await fsPromises.mkdir(directory.path);
279
+ return directory;
280
+ }
281
+ async remove(name, options) {
282
+ assertChildName(name);
283
+ await fsPromises.rm(pathModule.join(this.path, name), {
284
+ force: true,
285
+ recursive: options?.recursive === true
286
+ });
287
+ }
288
+ };
289
+ function encodeNodeResourceIdentity(kind, path) {
290
+ return `node-${kind}:${Buffer.from(pathModule.resolve(path), "utf8").toString("base64url")}`;
291
+ }
292
+ function decodeNodeResourceIdentity(identity, kind) {
293
+ const prefix = `node-${kind}:`;
294
+ if (!identity.startsWith(prefix)) {
295
+ return pathModule.isAbsolute(identity) ? identity : void 0;
296
+ }
297
+ try {
298
+ return Buffer.from(identity.slice(prefix.length), "base64url").toString(
299
+ "utf8"
300
+ );
301
+ } catch {
302
+ return void 0;
303
+ }
304
+ }
305
+ function assertChildName(name) {
306
+ if (name.length === 0 || name === "." || name === ".." || pathModule.isAbsolute(name) || name.includes("/") || name.includes("\\")) {
307
+ throw new TypeError(`Directory child must be a relative name: ${name}`);
308
+ }
309
+ }
310
+ var NodeDatabaseConnection = class {
311
+ constructor(database) {
312
+ this.database = database;
313
+ }
314
+ database;
315
+ async close() {
316
+ await new Promise((resolve2, reject) => {
317
+ this.database.close((error) => {
318
+ if (error) reject(error);
319
+ else resolve2();
320
+ });
321
+ });
322
+ }
323
+ async execute(sql) {
324
+ await new Promise((resolve2, reject) => {
325
+ this.database.exec(sql, (error) => {
326
+ if (error) reject(error);
327
+ else resolve2();
328
+ });
329
+ });
330
+ }
331
+ async queryAll(sql, params = []) {
332
+ return await new Promise((resolve2, reject) => {
333
+ this.database.all(sql, [...params], (error, rows) => {
334
+ if (error) reject(error);
335
+ else resolve2(rows);
336
+ });
337
+ });
338
+ }
339
+ async queryOne(sql, params = []) {
340
+ return await new Promise((resolve2, reject) => {
341
+ this.database.get(sql, [...params], (error, row) => {
342
+ if (error) reject(error);
343
+ else resolve2(row);
344
+ });
345
+ });
346
+ }
347
+ async run(sql, params = []) {
348
+ await new Promise((resolve2, reject) => {
349
+ this.database.run(sql, [...params], (error) => {
350
+ if (error) reject(error);
351
+ else resolve2();
352
+ });
353
+ });
354
+ }
355
+ };
356
+ async function openNodeDatabase(file, options) {
357
+ const flags = (options.mode === "readonly" ? nodeSqlite3.OPEN_READONLY : nodeSqlite3.OPEN_READWRITE | (options.create ? nodeSqlite3.OPEN_CREATE : 0)) | nodeSqlite3.OPEN_FULLMUTEX;
358
+ return new NodeDatabaseConnection(await openNativeNodeDatabase(file, flags));
359
+ }
360
+ async function openNativeNodeDatabase(file, flags) {
361
+ const path = getBrandedNodeResourcePath(file, "file");
362
+ if (path === void 0) {
363
+ throw new TypeError("The Node database adapter requires a NodeFile");
364
+ }
365
+ return await new Promise((resolve2, reject) => {
366
+ const database = new nodeSqlite3.Database(path, flags, (error) => {
367
+ if (error) reject(error);
368
+ else resolve2(database);
369
+ });
370
+ });
371
+ }
372
+ async function openNodeZip(file) {
373
+ const path = getBrandedNodeResourcePath(file, "file");
374
+ if (path === void 0) {
375
+ throw new TypeError("The Node ZIP adapter requires a NodeFile");
376
+ }
377
+ const zipFile = await new Promise((resolve2, reject) => {
378
+ yauzl.open(
379
+ path,
380
+ { autoClose: false, lazyEntries: true },
381
+ (error, opened) => {
382
+ if (error || opened === void 0)
383
+ reject(error ?? new Error("Cannot open ZIP"));
384
+ else resolve2(opened);
385
+ }
386
+ );
387
+ });
388
+ const entries = await new Promise(
389
+ (resolve2, reject) => {
390
+ const discovered = /* @__PURE__ */ new Map();
391
+ const rejectAndClose = (error) => {
392
+ zipFile.close();
393
+ reject(
394
+ error instanceof Error ? error : new Error("Cannot scan ZIP central directory")
395
+ );
396
+ };
397
+ const resolveEntries = () => {
398
+ zipFile.off("error", rejectAndClose);
399
+ resolve2(discovered);
400
+ };
401
+ zipFile.on("entry", (entry) => {
402
+ if (!entry.fileName.endsWith("/")) {
403
+ discovered.set(entry.fileName, entry);
404
+ }
405
+ zipFile.readEntry();
406
+ });
407
+ zipFile.once("error", rejectAndClose);
408
+ zipFile.once("end", resolveEntries);
409
+ zipFile.readEntry();
410
+ }
411
+ );
412
+ let closed = false;
413
+ return {
414
+ close: () => {
415
+ if (!closed) zipFile.close();
416
+ closed = true;
417
+ return Promise.resolve();
418
+ },
419
+ copyEntry: async (name, target) => {
420
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
421
+ const entry = entries.get(name);
422
+ if (entry === void 0) return false;
423
+ await copyNodeZipEntry(zipFile, entry, target);
424
+ return true;
425
+ },
426
+ getEntrySize: (name) => {
427
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
428
+ return Promise.resolve(entries.get(name)?.uncompressedSize);
429
+ },
430
+ listEntries: () => Promise.resolve([...entries.keys()]),
431
+ readEntryRange: async (name, offset, length) => {
432
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
433
+ const entry = entries.get(name);
434
+ if (entry === void 0) return void 0;
435
+ return await readNodeZipEntryRange(zipFile, entry, offset, length);
436
+ },
437
+ readEntry: async (name) => {
438
+ if (closed) throw new Error("Cannot read a closed ZIP archive");
439
+ const entry = entries.get(name);
440
+ if (entry === void 0) return void 0;
441
+ return await readNodeZipEntry(zipFile, entry);
442
+ }
443
+ };
444
+ }
445
+ async function copyNodeZipEntry(zipFile, entry, target) {
446
+ const writer = await target.openWriter();
447
+ try {
448
+ const stream = await openNodeZipEntryStream(zipFile, entry);
449
+ await writeNodeStream(stream, writer);
450
+ await writer.commit();
451
+ } catch (error) {
452
+ await writer.abort().catch(() => void 0);
453
+ throw error;
454
+ }
455
+ }
456
+ async function readNodeZipEntry(zipFile, entry) {
457
+ return await collectNodeStream(await openNodeZipEntryStream(zipFile, entry));
458
+ }
459
+ async function readNodeZipEntryRange(zipFile, entry, offset, length) {
460
+ assertFileRange(offset, length, entry.uncompressedSize);
461
+ if (length === 0) return new Uint8Array();
462
+ if (entry.compressionMethod !== 0) {
463
+ const content2 = await collectDecodedNodeStreamRange(
464
+ await openNodeZipEntryStream(zipFile, entry),
465
+ offset,
466
+ length
467
+ );
468
+ return new Uint8Array(
469
+ content2.buffer,
470
+ content2.byteOffset,
471
+ content2.byteLength
472
+ );
473
+ }
474
+ const content = await collectNodeStream(
475
+ await openNodeZipEntryStream(zipFile, entry, {
476
+ decompress: null,
477
+ decrypt: null,
478
+ end: offset + length,
479
+ start: offset
480
+ })
481
+ );
482
+ return new Uint8Array(content.buffer, content.byteOffset, content.byteLength);
483
+ }
484
+ async function collectDecodedNodeStreamRange(input, offset, length) {
485
+ const chunks = [];
486
+ const end = offset + length;
487
+ let position = 0;
488
+ let collected = 0;
489
+ for await (const value of input) {
490
+ const chunk = Buffer.isBuffer(value) ? value : Buffer.from(value);
491
+ const chunkEnd = position + chunk.byteLength;
492
+ if (chunkEnd > offset && position < end) {
493
+ const selected = chunk.subarray(
494
+ Math.max(0, offset - position),
495
+ Math.min(chunk.byteLength, end - position)
496
+ );
497
+ chunks.push(selected);
498
+ collected += selected.byteLength;
499
+ }
500
+ position = chunkEnd;
501
+ if (position >= end) break;
502
+ }
503
+ if (collected !== length) {
504
+ throw new Error("ZIP entry changed while reading its byte range");
505
+ }
506
+ return Buffer.concat(chunks, collected);
507
+ }
508
+ async function openNodeZipEntryStream(zipFile, entry, options) {
509
+ return await new Promise((resolve2, reject) => {
510
+ const callback = (error, opened) => {
511
+ if (error || opened === void 0) {
512
+ reject(error ?? new Error(`Cannot read ZIP entry: ${entry.fileName}`));
513
+ } else {
514
+ resolve2(opened);
515
+ }
516
+ };
517
+ if (options === void 0) zipFile.openReadStream(entry, callback);
518
+ else zipFile.openReadStream(entry, options, callback);
519
+ });
520
+ }
521
+ async function writeNodeZip(file, entries) {
522
+ const zipFile = new yazl.ZipFile();
523
+ const writer = await file.openWriter();
524
+ const outputStream = zipFile.outputStream;
525
+ const outputDone = writeNodeStream(outputStream, writer);
526
+ const entryState = { cancelled: false, complete: false };
527
+ let iterator;
528
+ try {
529
+ iterator = getNodeZipEntryIterator(entries);
530
+ const entriesDone = addNodeZipEntries(zipFile, iterator, entryState);
531
+ await Promise.race([entriesDone, outputDone]);
532
+ if (!entryState.complete) {
533
+ throw new Error("ZIP output ended before entry production completed");
534
+ }
535
+ zipFile.end();
536
+ await outputDone;
537
+ await writer.commit();
538
+ } catch (error) {
539
+ entryState.cancelled = true;
540
+ if (!entryState.complete && iterator !== void 0) {
541
+ closeNodeZipEntryIterator(iterator);
542
+ }
543
+ if (!outputStream.destroyed) {
544
+ outputStream.destroy(
545
+ error instanceof Error ? error : new Error("Cannot write ZIP archive")
546
+ );
547
+ }
548
+ await outputDone.catch(() => void 0);
549
+ await writer.abort().catch(() => void 0);
550
+ throw error;
551
+ }
552
+ }
553
+ async function addNodeZipEntries(zipFile, iterator, state) {
554
+ while (!state.cancelled) {
555
+ const result = await iterator.next();
556
+ if (state.cancelled) return;
557
+ if (result.done) {
558
+ state.complete = true;
559
+ return;
560
+ }
561
+ if ("file" in result.value) {
562
+ zipFile.addReadStream(
563
+ createNodeFileReadStream(result.value.file),
564
+ result.value.name,
565
+ { compress: false }
566
+ );
567
+ } else if ("data" in result.value) {
568
+ zipFile.addBuffer(Buffer.from(result.value.data), result.value.name, {
569
+ compress: false
570
+ });
571
+ } else {
572
+ zipFile.addReadStream(
573
+ createNodeRangeReadStream(result.value),
574
+ result.value.name,
575
+ { compress: false, size: result.value.size }
576
+ );
577
+ }
578
+ }
579
+ }
580
+ function createNodeFileReadStream(file) {
581
+ return import_node_stream.Readable.from(
582
+ (async function* () {
583
+ const reader = await file.openReader();
584
+ try {
585
+ for (let offset = 0; offset < reader.size; ) {
586
+ const chunk = await reader.read(
587
+ offset,
588
+ Math.min(64 * 1024, reader.size - offset)
589
+ );
590
+ offset += chunk.byteLength;
591
+ yield chunk;
592
+ }
593
+ } finally {
594
+ await reader.close();
595
+ }
596
+ })()
597
+ );
598
+ }
599
+ function getBrandedNodeResourcePath(resource, kind) {
600
+ if (typeof resource !== "object" || resource === null) return void 0;
601
+ const candidate = resource;
602
+ return candidate[NODE_RESOURCE_KIND] === kind && typeof candidate.path === "string" ? candidate.path : void 0;
603
+ }
604
+ function createNodeRangeReadStream(entry) {
605
+ return import_node_stream.Readable.from(
606
+ (async function* () {
607
+ for (let offset = 0; offset < entry.size; ) {
608
+ const chunk = await entry.read(
609
+ offset,
610
+ Math.min(64 * 1024, entry.size - offset)
611
+ );
612
+ offset += chunk.byteLength;
613
+ yield chunk;
614
+ }
615
+ })()
616
+ );
617
+ }
618
+ function getNodeZipEntryIterator(entries) {
619
+ const asyncIterator = entries[Symbol.asyncIterator];
620
+ return asyncIterator === void 0 ? entries[Symbol.iterator]() : asyncIterator.call(entries);
621
+ }
622
+ function closeNodeZipEntryIterator(iterator) {
623
+ if (iterator.return === void 0) return;
624
+ try {
625
+ void Promise.resolve(iterator.return()).catch(() => void 0);
626
+ } catch {
627
+ }
628
+ }
629
+ async function writeNodeStream(input, writer) {
630
+ await (0, import_promises.pipeline)(
631
+ input,
632
+ new import_node_stream.Writable({
633
+ write: (chunk, _encoding, callback) => {
634
+ void writer.write(chunk).then(
635
+ () => callback(),
636
+ (error) => callback(
637
+ error instanceof Error ? error : new Error("Cannot stream ZIP archive")
638
+ )
639
+ );
640
+ }
641
+ })
642
+ );
643
+ }
644
+ async function collectNodeStream(input) {
645
+ return await new Promise((resolve2, reject) => {
646
+ const chunks = [];
647
+ input.on("data", (chunk) => chunks.push(chunk));
648
+ input.once("error", reject);
649
+ input.once("end", () => resolve2(Buffer.concat(chunks)));
650
+ });
651
+ }
652
+ var nodeWikiGraphPlatform = {
653
+ asyncContext: {
654
+ create: () => new asyncHooks.AsyncLocalStorage()
655
+ },
656
+ database: { open: openNodeDatabase },
657
+ lifecycle: {
658
+ instanceId: `node-process:${nodeProcess.pid}`,
659
+ isInstanceAlive: (instanceId) => {
660
+ const match = /^node-process:(\d+)$/u.exec(instanceId);
661
+ if (match === null) return Promise.resolve(void 0);
662
+ try {
663
+ nodeProcess.kill(Number(match[1]), 0);
664
+ return Promise.resolve(true);
665
+ } catch (error) {
666
+ if (typeof error === "object" && error !== null && "code" in error && error.code === "ESRCH") {
667
+ return Promise.resolve(false);
668
+ }
669
+ return Promise.resolve(true);
670
+ }
671
+ }
672
+ },
673
+ resources: {
674
+ getDirectory: (identity) => {
675
+ const path = decodeNodeResourceIdentity(identity, "directory");
676
+ return Promise.resolve(
677
+ path === void 0 ? void 0 : new NodeDirectory(path)
678
+ );
679
+ },
680
+ getFile: (identity) => {
681
+ const path = decodeNodeResourceIdentity(identity, "file");
682
+ return Promise.resolve(
683
+ path === void 0 ? void 0 : new NodeFile(path)
684
+ );
685
+ },
686
+ resolveLegacyDirectory: (reference) => {
687
+ const path = decodeNodeResourceIdentity(reference, "directory");
688
+ return Promise.resolve(
689
+ path === void 0 ? void 0 : new NodeDirectory(path)
690
+ );
691
+ }
692
+ },
693
+ templates: {
694
+ createEnvironment: (options) => new import_nunjucks.Environment(new NodeTemplateLoader(), options)
695
+ },
696
+ zip: {
697
+ open: openNodeZip,
698
+ write: writeNodeZip
699
+ }
700
+ };
701
+ var NodeTemplateLoader = class extends import_nunjucks.Loader {
702
+ #dataDirectory;
703
+ constructor(dataDirectory) {
704
+ super();
705
+ this.#dataDirectory = dataDirectory;
706
+ }
707
+ getSource(templateName) {
708
+ const name = (0, import_platform.normalizeTemplateName)(templateName);
709
+ const filePath = pathModule.join(
710
+ this.#dataDirectory ?? resolveNodeDataDirectory(),
711
+ name
712
+ );
713
+ return {
714
+ noCache: false,
715
+ path: name,
716
+ src: fs.readFileSync(filePath, "utf8")
717
+ };
718
+ }
719
+ };
720
+ function resolveNodeDataDirectory() {
721
+ const injected = globalThis.__WIKIGRAPH_DATA_DIR__;
722
+ if (typeof injected === "string" && injected !== "") return injected;
723
+ let directory = nodeProcess.cwd();
724
+ while (true) {
725
+ for (const candidate of [
726
+ pathModule.join(directory, "data"),
727
+ pathModule.join(directory, "packages", "core", "data")
728
+ ]) {
729
+ try {
730
+ if (fs.statSync(candidate).isDirectory()) return candidate;
731
+ } catch {
732
+ }
733
+ }
734
+ const parent = pathModule.dirname(directory);
735
+ if (parent === directory)
736
+ throw new Error("Could not locate data directory");
737
+ directory = parent;
738
+ }
739
+ }
740
+
741
+ // src/local-config.ts
742
+ var import_path = require("path");
743
+ var import_os = require("os");
744
+ var LOCAL_CONFIG_SECTIONS = [
745
+ "concurrent",
746
+ "embeddings",
747
+ "llm",
748
+ "wikimedia",
749
+ "wikispine"
750
+ ];
751
+ var LOCAL_CONFIG_SCHEMA_SQL = `
752
+ CREATE TABLE IF NOT EXISTS config_sections (
753
+ section TEXT PRIMARY KEY,
754
+ value_json TEXT NOT NULL,
755
+ updated_at INTEGER NOT NULL
756
+ );
757
+ `;
758
+ async function readLocalConfigSection(section) {
759
+ return await withLocalConfigDatabase(async (database) => {
760
+ return await readLocalConfigSectionInDatabase(database, section);
761
+ });
762
+ }
763
+ async function replaceLocalConfigSection(section, value) {
764
+ const normalized = validateLocalConfigSection(section, value);
765
+ return await withLocalConfigDatabase(async (database) => {
766
+ await writeLocalConfigSectionInDatabase(database, section, normalized);
767
+ return normalized;
768
+ });
769
+ }
770
+ async function putLocalConfigValue(section, key, value) {
771
+ return await withLocalConfigDatabase(async (database) => {
772
+ const current = await readLocalConfigSectionInDatabase(database, section);
773
+ const next = validateLocalConfigSection(section, {
774
+ ...current,
775
+ [normalizeLocalConfigKey(section, key)]: value
776
+ });
777
+ await writeLocalConfigSectionInDatabase(database, section, next);
778
+ return next;
779
+ });
780
+ }
781
+ async function deleteLocalConfigValue(section, key) {
782
+ return await withLocalConfigDatabase(async (database) => {
783
+ const current = await readLocalConfigSectionInDatabase(database, section);
784
+ const normalizedKey = normalizeLocalConfigKey(section, key);
785
+ const { [normalizedKey]: _removed, ...nextInput } = current;
786
+ const next = validateLocalConfigSection(section, nextInput);
787
+ await writeLocalConfigSectionInDatabase(database, section, next);
788
+ return next;
789
+ });
790
+ }
791
+ async function clearLocalConfigSection(section) {
792
+ return await replaceLocalConfigSection(section, {});
793
+ }
794
+ function parseLocalConfigSection(value) {
795
+ if (value === "embedding") {
796
+ return "embeddings";
797
+ }
798
+ return LOCAL_CONFIG_SECTIONS.find((section) => section === value);
799
+ }
800
+ function maskLocalConfigSection(section, value) {
801
+ if (section !== "llm" && section !== "embeddings" && section !== "wikimedia" && section !== "wikispine" || value.apiKey === void 0 && value.token === void 0) {
802
+ return value;
803
+ }
804
+ return {
805
+ ...value,
806
+ ...value.apiKey === void 0 ? {} : { apiKey: "****" },
807
+ ...value.token === void 0 ? {} : { token: "****" }
808
+ };
809
+ }
810
+ function normalizeLocalConfigKey(section, key) {
811
+ const normalized = key.trim();
812
+ if (normalized === "") {
813
+ throw new Error("Config key cannot be empty.");
814
+ }
815
+ if (section === "llm" || section === "embeddings") {
816
+ switch (normalized) {
817
+ case "api-key":
818
+ return "apiKey";
819
+ case "base-url":
820
+ return "baseURL";
821
+ default:
822
+ return normalized;
823
+ }
824
+ }
825
+ return normalized;
826
+ }
827
+ function validateLocalConfigSection(section, value) {
828
+ switch (section) {
829
+ case "embeddings":
830
+ return validateEmbeddingsConfig(value);
831
+ case "llm":
832
+ return validateLLMConfig(value);
833
+ case "concurrent":
834
+ return validateConcurrentConfig(value);
835
+ case "wikimedia":
836
+ return validateWikimediaConfig(value);
837
+ case "wikispine":
838
+ return validateWikispineConfig(value);
839
+ }
840
+ }
841
+ async function withLocalConfigDatabase(operation) {
842
+ const database = await (0, import_wiki_graph_core.openSharedStateDatabase)(
843
+ new NodeFile(
844
+ (0, import_path.join)(
845
+ getWikiGraphSDKStateDir() ?? (0, import_path.join)((0, import_os.homedir)(), ".wikigraph"),
846
+ "core.sqlite"
847
+ )
848
+ ),
849
+ LOCAL_CONFIG_SCHEMA_SQL
850
+ );
851
+ try {
852
+ return await operation(database);
853
+ } finally {
854
+ await database.close();
855
+ }
856
+ }
857
+ async function readLocalConfigSectionInDatabase(database, section) {
858
+ const value = await database.queryOne(
859
+ "SELECT value_json FROM config_sections WHERE section = ?",
860
+ [section],
861
+ (row) => String(row.value_json)
862
+ );
863
+ return value === void 0 ? {} : parseSectionJSON(section, value);
864
+ }
865
+ async function writeLocalConfigSectionInDatabase(database, section, value) {
866
+ await database.run(
867
+ `
868
+ INSERT INTO config_sections (section, value_json, updated_at)
869
+ VALUES (?, ?, ?)
870
+ ON CONFLICT(section) DO UPDATE SET
871
+ value_json = excluded.value_json,
872
+ updated_at = excluded.updated_at
873
+ `,
874
+ [section, JSON.stringify(value), Date.now()]
875
+ );
876
+ }
877
+ function parseSectionJSON(section, value) {
878
+ let parsed;
879
+ try {
880
+ parsed = JSON.parse(value);
881
+ } catch (error) {
882
+ throw new Error(
883
+ `Invalid local config JSON for ${section}: ${formatError(error)}`
884
+ );
885
+ }
886
+ if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
887
+ throw new Error(
888
+ `Invalid local config section ${section}: expected object.`
889
+ );
890
+ }
891
+ return validateLocalConfigSection(section, parsed);
892
+ }
893
+ function validateEmbeddingsConfig(value) {
894
+ const allowedKeys = /* @__PURE__ */ new Set([
895
+ "apiKey",
896
+ "baseURL",
897
+ "dimensions",
898
+ "model",
899
+ "name",
900
+ "provider"
901
+ ]);
902
+ const allowedProviders = /* @__PURE__ */ new Set(["openai", "openai-compatible"]);
903
+ const next = {};
904
+ for (const [key, entry] of Object.entries(value)) {
905
+ if (!allowedKeys.has(key)) {
906
+ throw new Error(`Unknown embeddings config key: ${key}`);
907
+ }
908
+ if (key === "dimensions") {
909
+ const parsed = typeof entry === "number" ? entry : typeof entry === "string" ? Number(entry) : NaN;
910
+ if (!Number.isInteger(parsed) || parsed <= 0) {
911
+ throw new Error("embeddings.dimensions must be a positive integer.");
912
+ }
913
+ next[key] = parsed;
914
+ continue;
915
+ }
916
+ if (typeof entry !== "string" || entry.trim() === "") {
917
+ throw new Error(`embeddings.${key} must be a non-empty string.`);
918
+ }
919
+ const normalized = entry.trim();
920
+ if (key === "provider" && !allowedProviders.has(normalized)) {
921
+ throw new Error(`Unknown embeddings.provider: ${normalized}`);
922
+ }
923
+ next[key] = normalized;
924
+ }
925
+ return next;
926
+ }
927
+ function validateLLMConfig(value) {
928
+ const allowedKeys = /* @__PURE__ */ new Set([
929
+ "apiKey",
930
+ "baseURL",
931
+ "model",
932
+ "name",
933
+ "provider"
934
+ ]);
935
+ const allowedProviders = /* @__PURE__ */ new Set([
936
+ "anthropic",
937
+ "google",
938
+ "openai",
939
+ "openai-compatible"
940
+ ]);
941
+ const next = {};
942
+ for (const [key, entry] of Object.entries(value)) {
943
+ if (!allowedKeys.has(key)) {
944
+ throw new Error(`Unknown llm config key: ${key}`);
945
+ }
946
+ if (typeof entry !== "string" || entry.trim() === "") {
947
+ throw new Error(`llm.${key} must be a non-empty string.`);
948
+ }
949
+ const normalized = entry.trim();
950
+ if (key === "provider" && !allowedProviders.has(normalized)) {
951
+ throw new Error(`Unknown llm.provider: ${normalized}`);
952
+ }
953
+ next[key] = normalized;
954
+ }
955
+ return next;
956
+ }
957
+ function validateConcurrentConfig(value) {
958
+ const allowedKeys = /* @__PURE__ */ new Set(["job", "request"]);
959
+ const next = {};
960
+ for (const [key, entry] of Object.entries(value)) {
961
+ if (!allowedKeys.has(key)) {
962
+ throw new Error(`Unknown concurrent config key: ${key}`);
963
+ }
964
+ const parsed = typeof entry === "number" ? entry : typeof entry === "string" ? Number(entry) : NaN;
965
+ if (!Number.isInteger(parsed) || parsed <= 0) {
966
+ throw new Error(`concurrent.${key} must be a positive integer.`);
967
+ }
968
+ next[key] = parsed;
969
+ }
970
+ return next;
971
+ }
972
+ function validateWikispineConfig(value) {
973
+ const allowedKeys = /* @__PURE__ */ new Set(["endpoint", "provider", "token"]);
974
+ const allowedProviders = /* @__PURE__ */ new Set(["cli", "fetch"]);
975
+ const next = {};
976
+ for (const [key, entry] of Object.entries(value)) {
977
+ if (!allowedKeys.has(key)) {
978
+ throw new Error(`Unknown wikispine config key: ${key}`);
979
+ }
980
+ if (typeof entry !== "string" || entry.trim() === "") {
981
+ throw new Error(`wikispine.${key} must be a non-empty string.`);
982
+ }
983
+ const normalized = entry.trim();
984
+ if (key === "provider" && !allowedProviders.has(normalized)) {
985
+ throw new Error(`Unknown wikispine.provider: ${normalized}`);
986
+ }
987
+ next[key] = normalized;
988
+ }
989
+ return next;
990
+ }
991
+ function validateWikimediaConfig(value) {
992
+ return validateEndpointConfig("wikimedia", value);
993
+ }
994
+ function validateEndpointConfig(section, value) {
995
+ const allowedKeys = /* @__PURE__ */ new Set(["endpoint", "token"]);
996
+ const next = {};
997
+ for (const [key, entry] of Object.entries(value)) {
998
+ if (!allowedKeys.has(key)) {
999
+ throw new Error(`Unknown ${section} config key: ${key}`);
1000
+ }
1001
+ if (typeof entry !== "string" || entry.trim() === "") {
1002
+ throw new Error(`${section}.${key} must be a non-empty string.`);
1003
+ }
1004
+ next[key] = entry.trim();
1005
+ }
1006
+ return next;
1007
+ }
1008
+ function formatError(error) {
1009
+ return error instanceof Error ? error.message : String(error);
1010
+ }
1011
+ // Annotate the CommonJS export names for ESM import in node:
1012
+ 0 && (module.exports = {
1013
+ LOCAL_CONFIG_SECTIONS,
1014
+ clearLocalConfigSection,
1015
+ deleteLocalConfigValue,
1016
+ maskLocalConfigSection,
1017
+ normalizeLocalConfigKey,
1018
+ parseLocalConfigSection,
1019
+ putLocalConfigValue,
1020
+ readLocalConfigSection,
1021
+ replaceLocalConfigSection,
1022
+ validateLocalConfigSection
1023
+ });
1024
+ //# sourceMappingURL=local-config.cjs.map