wiki-graph-core 0.3.1

package/dist/llm/context.js

@@ -0,0 +1,78 @@
+import { getLogger } from "../common/logging.js";
+class LLMContext {
+  #cache;
+  #pendingCacheEntries = /* @__PURE__ */ new Map();
+  #requestFn;
+  #logFiles = [];
+  #finalized = false;
+  sessionId;
+  constructor(sessionId, requestFn, cache) {
+    this.sessionId = sessionId;
+    this.#cache = cache;
+    this.#requestFn = requestFn;
+  }
+  async request(messages, options = {}) {
+    this.#assertActive();
+    return await this.#requestFn({
+      logFiles: this.#logFiles,
+      messages,
+      options,
+      pendingCacheEntries: this.#pendingCacheEntries
+    });
+  }
+  async commit() {
+    if (this.#finalized) {
+      return;
+    }
+    for (const entry of this.#pendingCacheEntries.values()) {
+      if (this.#cache !== void 0) {
+        await this.#cache.write(entry);
+      }
+    }
+    this.#pendingCacheEntries.clear();
+    this.#finalized = true;
+  }
+  rollback() {
+    if (!this.#finalized) {
+      this.#pendingCacheEntries.clear();
+      this.#finalized = true;
+    }
+    return Promise.resolve();
+  }
+  async run(operation) {
+    try {
+      const result = await operation(this);
+      await this.commit();
+      return result;
+    } catch (error) {
+      await this.rollback();
+      this.#printLogFiles();
+      throw error;
+    }
+  }
+  #assertActive() {
+    if (this.#finalized) {
+      throw new Error("LLMContext is already finalized");
+    }
+  }
+  #printLogFiles() {
+    if (this.#logFiles.length === 0) {
+      return;
+    }
+    const logger = getLogger({
+      component: "llm-context",
+      sessionId: this.sessionId
+    });
+    logger.warn(
+      `
+[LLMContext] Failed with ${this.#logFiles.length} log file(s):`
+    );
+    for (const [index, logFile] of this.#logFiles.entries()) {
+      logger.warn(`  ${index + 1}. ${logFile}`);
+    }
+  }
+}
+export {
+  LLMContext
+};
+//# sourceMappingURL=context.js.map

package/dist/llm/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/llm/context.ts"],"sourcesContent":["import { getLogger } from \"../common/logging.js\";\nimport type { LLMCache, PendingCacheEntry } from \"./cache.js\";\nimport type { LLMessage, LLMRequestOptions } from \"./types.js\";\n\nexport interface LLMContextRequestInput<S extends string> {\n  messages: readonly LLMessage[];\n  options: LLMRequestOptions<S>;\n  pendingCacheEntries?: Map<string, PendingCacheEntry>;\n  logFiles?: string[];\n}\n\ntype LLMContextRequest<S extends string> = (\n  input: LLMContextRequestInput<S>,\n) => Promise<string>;\n\nexport class LLMContext<S extends string> {\n  readonly #cache: LLMCache | undefined;\n  readonly #pendingCacheEntries = new Map<string, PendingCacheEntry>();\n  readonly #requestFn: LLMContextRequest<S>;\n  readonly #logFiles: string[] = [];\n  #finalized = false;\n  public readonly sessionId: number;\n\n  public constructor(\n    sessionId: number,\n    requestFn: LLMContextRequest<S>,\n    cache?: LLMCache,\n  ) {\n    this.sessionId = sessionId;\n    this.#cache = cache;\n    this.#requestFn = requestFn;\n  }\n\n  public async request(\n    messages: readonly LLMessage[],\n    options: LLMRequestOptions<S> = {},\n  ): Promise<string> {\n    this.#assertActive();\n\n    return await this.#requestFn({\n      logFiles: this.#logFiles,\n      messages,\n      options,\n      pendingCacheEntries: this.#pendingCacheEntries,\n    });\n  }\n\n  public async commit(): Promise<void> {\n    if (this.#finalized) {\n      return;\n    }\n\n    for (const entry of this.#pendingCacheEntries.values()) {\n      if (this.#cache !== undefined) {\n        await this.#cache.write(entry);\n      }\n    }\n\n    this.#pendingCacheEntries.clear();\n    this.#finalized = true;\n  }\n\n  public rollback(): Promise<void> {\n    if (!this.#finalized) {\n      this.#pendingCacheEntries.clear();\n      this.#finalized = true;\n    }\n\n    return Promise.resolve();\n  }\n\n  public async run<T>(\n    operation: (context: LLMContext<S>) => Promise<T>,\n  ): Promise<T> {\n    try {\n      const result = await operation(this);\n      await this.commit();\n      return result;\n    } catch (error) {\n      await this.rollback();\n      this.#printLogFiles();\n      throw error;\n    }\n  }\n\n  #assertActive(): void {\n    if (this.#finalized) {\n      throw new Error(\"LLMContext is already finalized\");\n    }\n  }\n\n  #printLogFiles(): void {\n    if (this.#logFiles.length === 0) {\n      return;\n    }\n\n    const logger = getLogger({\n      component: \"llm-context\",\n      sessionId: this.sessionId,\n    });\n\n    logger.warn(\n      `\\n[LLMContext] Failed with ${this.#logFiles.length} log file(s):`,\n    );\n\n    for (const [index, logFile] of this.#logFiles.entries()) {\n      logger.warn(`  ${index + 1}. ${logFile}`);\n    }\n  }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAenB,MAAM,WAA6B;AAAA,EAC/B;AAAA,EACA,uBAAuB,oBAAI,IAA+B;AAAA,EAC1D;AAAA,EACA,YAAsB,CAAC;AAAA,EAChC,aAAa;AAAA,EACG;AAAA,EAET,YACL,WACA,WACA,OACA;AACA,SAAK,YAAY;AACjB,SAAK,SAAS;AACd,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAa,QACX,UACA,UAAgC,CAAC,GAChB;AACjB,SAAK,cAAc;AAEnB,WAAO,MAAM,KAAK,WAAW;AAAA,MAC3B,UAAU,KAAK;AAAA,MACf;AAAA,MACA;AAAA,MACA,qBAAqB,KAAK;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EAEA,MAAa,SAAwB;AACnC,QAAI,KAAK,YAAY;AACnB;AAAA,IACF;AAEA,eAAW,SAAS,KAAK,qBAAqB,OAAO,GAAG;AACtD,UAAI,KAAK,WAAW,QAAW;AAC7B,cAAM,KAAK,OAAO,MAAM,KAAK;AAAA,MAC/B;AAAA,IACF;AAEA,SAAK,qBAAqB,MAAM;AAChC,SAAK,aAAa;AAAA,EACpB;AAAA,EAEO,WAA0B;AAC/B,QAAI,CAAC,KAAK,YAAY;AACpB,WAAK,qBAAqB,MAAM;AAChC,WAAK,aAAa;AAAA,IACpB;AAEA,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,MAAa,IACX,WACY;AACZ,QAAI;AACF,YAAM,SAAS,MAAM,UAAU,IAAI;AACnC,YAAM,KAAK,OAAO;AAClB,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,KAAK,SAAS;AACpB,WAAK,eAAe;AACpB,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,gBAAsB;AACpB,QAAI,KAAK,YAAY;AACnB,YAAM,IAAI,MAAM,iCAAiC;AAAA,IACnD;AAAA,EACF;AAAA,EAEA,iBAAuB;AACrB,QAAI,KAAK,UAAU,WAAW,GAAG;AAC/B;AAAA,IACF;AAEA,UAAM,SAAS,UAAU;AAAA,MACvB,WAAW;AAAA,MACX,WAAW,KAAK;AAAA,IAClB,CAAC;AAED,WAAO;AAAA,MACL;AAAA,2BAA8B,KAAK,UAAU,MAAM;AAAA,IACrD;AAEA,eAAW,CAAC,OAAO,OAAO,KAAK,KAAK,UAAU,QAAQ,GAAG;AACvD,aAAO,KAAK,KAAK,QAAQ,CAAC,KAAK,OAAO,EAAE;AAAA,IAC1C;AAAA,EACF;AACF;","names":[]}

package/dist/llm/errors.d.ts

@@ -0,0 +1,7 @@
+declare class LLMPaymentRequiredError extends Error {
+    readonly isRetryable = false;
+    readonly statusCode = 402;
+    constructor(message?: string, options?: ErrorOptions);
+}
+
+export { LLMPaymentRequiredError };

package/dist/llm/errors.js

@@ -0,0 +1,12 @@
+class LLMPaymentRequiredError extends Error {
+  isRetryable = false;
+  statusCode = 402;
+  constructor(message = "LLM payment required.", options) {
+    super(message, options);
+    this.name = "LLMPaymentRequiredError";
+  }
+}
+export {
+  LLMPaymentRequiredError
+};
+//# sourceMappingURL=errors.js.map

package/dist/llm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/llm/errors.ts"],"sourcesContent":["export class LLMPaymentRequiredError extends Error {\n  public readonly isRetryable = false;\n  public readonly statusCode = 402;\n\n  public constructor(\n    message = \"LLM payment required.\",\n    options?: ErrorOptions,\n  ) {\n    super(message, options);\n    this.name = \"LLMPaymentRequiredError\";\n  }\n}\n"],"mappings":"AAAO,MAAM,gCAAgC,MAAM;AAAA,EACjC,cAAc;AAAA,EACd,aAAa;AAAA,EAEtB,YACL,UAAU,yBACV,SACA;AACA,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/dist/llm/index.d.ts

@@ -0,0 +1,7 @@
+export { LLM } from './client.js';
+export { LLMContext } from './context.js';
+export { LLMPaymentRequiredError } from './errors.js';
+export { getScopeDefaults, resolveSamplingSetting, resolveTemperatureSetting } from './sampling.js';
+export { LLMLazyRequestOperation, LLMModel, LLMOptions, LLMRequestFunction, LLMRequestOptions, LLMStreamProgressCallback, LLMTokenUsage, LLMTokenUsageCallback, LLMessage, SamplingProfile, SamplingScopeConfig, TemperatureSetting } from './types.js';
+import './cache.js';
+import 'ai';

package/dist/llm/index.js

@@ -0,0 +1,17 @@
+import { LLM } from "./client.js";
+import { LLMContext } from "./context.js";
+import { LLMPaymentRequiredError } from "./errors.js";
+import {
+  getScopeDefaults,
+  resolveSamplingSetting,
+  resolveTemperatureSetting
+} from "./sampling.js";
+export {
+  LLM,
+  LLMContext,
+  LLMPaymentRequiredError,
+  getScopeDefaults,
+  resolveSamplingSetting,
+  resolveTemperatureSetting
+};
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/llm/index.ts"],"sourcesContent":["export { LLM } from \"./client.js\";\nexport { LLMContext } from \"./context.js\";\nexport { LLMPaymentRequiredError } from \"./errors.js\";\nexport {\n  getScopeDefaults,\n  resolveSamplingSetting,\n  resolveTemperatureSetting,\n} from \"./sampling.js\";\nexport type {\n  LLMessage,\n  LLMLazyRequestOperation,\n  LLMModel,\n  LLMOptions,\n  LLMRequestFunction,\n  LLMRequestOptions,\n  LLMStreamProgressCallback,\n  LLMTokenUsage,\n  LLMTokenUsageCallback,\n  SamplingProfile,\n  SamplingScopeConfig,\n  TemperatureSetting,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,WAAW;AACpB,SAAS,kBAAkB;AAC3B,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/llm/request-log.d.ts

@@ -0,0 +1,9 @@
+declare class RequestLog {
+    #private;
+    constructor(filePath?: string);
+    get filePath(): string | undefined;
+    append(content: string): Promise<void>;
+}
+declare function createRequestLog(logDirPath?: string): RequestLog;
+
+export { RequestLog, createRequestLog };

package/dist/llm/request-log.js

@@ -0,0 +1,35 @@
+import { appendFile } from "fs/promises";
+import { allocateArtifactPath } from "../common/logging.js";
+class RequestLog {
+  #filePath;
+  constructor(filePath) {
+    this.#filePath = filePath;
+  }
+  get filePath() {
+    return this.#filePath;
+  }
+  async append(content) {
+    if (this.#filePath === void 0) {
+      return;
+    }
+    await appendFile(this.#filePath, content, "utf8");
+  }
+}
+function createRequestLog(logDirPath) {
+  if (logDirPath === void 0) {
+    return new RequestLog();
+  }
+  return new RequestLog(
+    allocateArtifactPath({
+      alwaysNumbered: true,
+      category: "llm",
+      logDirPath,
+      prefix: "request"
+    })
+  );
+}
+export {
+  RequestLog,
+  createRequestLog
+};
+//# sourceMappingURL=request-log.js.map

package/dist/llm/request-log.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/llm/request-log.ts"],"sourcesContent":["import { appendFile } from \"fs/promises\";\nimport { allocateArtifactPath } from \"../common/logging.js\";\n\nexport class RequestLog {\n  readonly #filePath: string | undefined;\n\n  public constructor(filePath?: string) {\n    this.#filePath = filePath;\n  }\n\n  public get filePath(): string | undefined {\n    return this.#filePath;\n  }\n\n  public async append(content: string): Promise<void> {\n    if (this.#filePath === undefined) {\n      return;\n    }\n    await appendFile(this.#filePath, content, \"utf8\");\n  }\n}\n\nexport function createRequestLog(logDirPath?: string): RequestLog {\n  if (logDirPath === undefined) {\n    return new RequestLog();\n  }\n\n  return new RequestLog(\n    allocateArtifactPath({\n      alwaysNumbered: true,\n      category: \"llm\",\n      logDirPath,\n      prefix: \"request\",\n    }),\n  );\n}\n"],"mappings":"AAAA,SAAS,kBAAkB;AAC3B,SAAS,4BAA4B;AAE9B,MAAM,WAAW;AAAA,EACb;AAAA,EAEF,YAAY,UAAmB;AACpC,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,IAAW,WAA+B;AACxC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAa,OAAO,SAAgC;AAClD,QAAI,KAAK,cAAc,QAAW;AAChC;AAAA,IACF;AACA,UAAM,WAAW,KAAK,WAAW,SAAS,MAAM;AAAA,EAClD;AACF;AAEO,SAAS,iBAAiB,YAAiC;AAChE,MAAI,eAAe,QAAW;AAC5B,WAAO,IAAI,WAAW;AAAA,EACxB;AAEA,SAAO,IAAI;AAAA,IACT,qBAAqB;AAAA,MACnB,gBAAgB;AAAA,MAChB,UAAU;AAAA,MACV;AAAA,MACA,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/llm/sampling.d.ts

@@ -0,0 +1,11 @@
+import { SamplingScopeConfig, TemperatureSetting } from './types.js';
+import 'ai';
+
+declare function resolveSamplingSetting(value: TemperatureSetting | undefined, fieldName: string, retryIndex?: number, retryMax?: number): number | undefined;
+declare function resolveTemperatureSetting(temperature: TemperatureSetting | undefined, retryIndex?: number, retryMax?: number): number | undefined;
+declare function getScopeDefaults<S extends string>(scope: S | undefined, sampling: SamplingScopeConfig<S> | undefined, defaultTemperature: TemperatureSetting, defaultTopP: TemperatureSetting): {
+    temperature: TemperatureSetting;
+    topP: TemperatureSetting;
+};
+
+export { getScopeDefaults, resolveSamplingSetting, resolveTemperatureSetting };

package/dist/llm/sampling.js

@@ -0,0 +1,67 @@
+function resolveSamplingSetting(value, fieldName, retryIndex, retryMax) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value === "number") {
+    return value;
+  }
+  if (value.length === 1) {
+    return value[0];
+  }
+  if (value.length !== 2) {
+    throw new RangeError(
+      `${fieldName} must be a number or a 2-item range like [0.6, 0.98]`
+    );
+  }
+  const [start, end] = value;
+  if (start === void 0 || end === void 0) {
+    throw new RangeError(
+      `${fieldName} must be a number or a 2-item range like [0.6, 0.98]`
+    );
+  }
+  if (retryIndex === void 0 || retryMax === void 0 || retryMax <= 0) {
+    return start;
+  }
+  const boundedRetryIndex = Math.min(Math.max(retryIndex, 0), retryMax);
+  const progress = boundedRetryIndex / retryMax;
+  return start + (end - start) * progress;
+}
+function resolveTemperatureSetting(temperature, retryIndex, retryMax) {
+  return resolveSamplingSetting(
+    temperature,
+    "temperature",
+    retryIndex,
+    retryMax
+  );
+}
+function getScopeDefaults(scope, sampling, defaultTemperature, defaultTopP) {
+  if (scope === void 0) {
+    return {
+      temperature: defaultTemperature,
+      topP: defaultTopP
+    };
+  }
+  if (sampling === void 0) {
+    return {
+      temperature: defaultTemperature,
+      topP: defaultTopP
+    };
+  }
+  const profile = sampling[scope];
+  if (profile === void 0) {
+    return {
+      temperature: defaultTemperature,
+      topP: defaultTopP
+    };
+  }
+  return {
+    temperature: profile.temperature ?? defaultTemperature,
+    topP: profile.topP ?? defaultTopP
+  };
+}
+export {
+  getScopeDefaults,
+  resolveSamplingSetting,
+  resolveTemperatureSetting
+};
+//# sourceMappingURL=sampling.js.map

package/dist/llm/sampling.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/llm/sampling.ts"],"sourcesContent":["import type { SamplingScopeConfig, TemperatureSetting } from \"./types.js\";\n\nexport function resolveSamplingSetting(\n  value: TemperatureSetting | undefined,\n  fieldName: string,\n  retryIndex?: number,\n  retryMax?: number,\n): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n\n  if (typeof value === \"number\") {\n    return value;\n  }\n\n  if (value.length === 1) {\n    return value[0];\n  }\n\n  if (value.length !== 2) {\n    throw new RangeError(\n      `${fieldName} must be a number or a 2-item range like [0.6, 0.98]`,\n    );\n  }\n  const [start, end] = value;\n\n  if (start === undefined || end === undefined) {\n    throw new RangeError(\n      `${fieldName} must be a number or a 2-item range like [0.6, 0.98]`,\n    );\n  }\n\n  if (retryIndex === undefined || retryMax === undefined || retryMax <= 0) {\n    return start;\n  }\n  const boundedRetryIndex = Math.min(Math.max(retryIndex, 0), retryMax);\n  const progress = boundedRetryIndex / retryMax;\n\n  return start + (end - start) * progress;\n}\n\nexport function resolveTemperatureSetting(\n  temperature: TemperatureSetting | undefined,\n  retryIndex?: number,\n  retryMax?: number,\n): number | undefined {\n  return resolveSamplingSetting(\n    temperature,\n    \"temperature\",\n    retryIndex,\n    retryMax,\n  );\n}\n\nexport function getScopeDefaults<S extends string>(\n  scope: S | undefined,\n  sampling: SamplingScopeConfig<S> | undefined,\n  defaultTemperature: TemperatureSetting,\n  defaultTopP: TemperatureSetting,\n): {\n  temperature: TemperatureSetting;\n  topP: TemperatureSetting;\n} {\n  if (scope === undefined) {\n    return {\n      temperature: defaultTemperature,\n      topP: defaultTopP,\n    };\n  }\n\n  if (sampling === undefined) {\n    return {\n      temperature: defaultTemperature,\n      topP: defaultTopP,\n    };\n  }\n\n  const profile = sampling[scope];\n\n  if (profile === undefined) {\n    return {\n      temperature: defaultTemperature,\n      topP: defaultTopP,\n    };\n  }\n\n  return {\n    temperature: profile.temperature ?? defaultTemperature,\n    topP: profile.topP ?? defaultTopP,\n  };\n}\n"],"mappings":"AAEO,SAAS,uBACd,OACA,WACA,YACA,UACoB;AACpB,MAAI,UAAU,QAAW;AACvB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO,MAAM,CAAC;AAAA,EAChB;AAEA,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI;AAAA,MACR,GAAG,SAAS;AAAA,IACd;AAAA,EACF;AACA,QAAM,CAAC,OAAO,GAAG,IAAI;AAErB,MAAI,UAAU,UAAa,QAAQ,QAAW;AAC5C,UAAM,IAAI;AAAA,MACR,GAAG,SAAS;AAAA,IACd;AAAA,EACF;AAEA,MAAI,eAAe,UAAa,aAAa,UAAa,YAAY,GAAG;AACvE,WAAO;AAAA,EACT;AACA,QAAM,oBAAoB,KAAK,IAAI,KAAK,IAAI,YAAY,CAAC,GAAG,QAAQ;AACpE,QAAM,WAAW,oBAAoB;AAErC,SAAO,SAAS,MAAM,SAAS;AACjC;AAEO,SAAS,0BACd,aACA,YACA,UACoB;AACpB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,iBACd,OACA,UACA,oBACA,aAIA;AACA,MAAI,UAAU,QAAW;AACvB,WAAO;AAAA,MACL,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,EACF;AAEA,MAAI,aAAa,QAAW;AAC1B,WAAO;AAAA,MACL,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,EACF;AAEA,QAAM,UAAU,SAAS,KAAK;AAE9B,MAAI,YAAY,QAAW;AACzB,WAAO;AAAA,MACL,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,EACF;AAEA,SAAO;AAAA,IACL,aAAa,QAAQ,eAAe;AAAA,IACpC,MAAM,QAAQ,QAAQ;AAAA,EACxB;AACF;","names":[]}

package/dist/llm/types.d.ts

@@ -0,0 +1,50 @@
+import { LanguageModel, ModelMessage } from 'ai';
+
+type LLMessage = ModelMessage;
+type LLMModel = LanguageModel;
+type TemperatureSetting = number | readonly number[];
+interface SamplingProfile {
+    readonly temperature?: TemperatureSetting;
+    readonly topP?: TemperatureSetting;
+}
+type SamplingScopeConfig<S extends string> = {
+    readonly [scope in S]: SamplingProfile;
+};
+interface LLMRequestOptions<S extends string> {
+    readonly signal?: AbortSignal;
+    readonly temperature?: TemperatureSetting;
+    readonly topP?: TemperatureSetting;
+    readonly scope?: S;
+    readonly useCache?: boolean;
+    readonly retryIndex?: number;
+    readonly retryMax?: number;
+}
+type LLMRequestFunction<S extends string> = (messages: readonly LLMessage[], options?: LLMRequestOptions<S>) => Promise<string>;
+type LLMLazyRequestOperation<S extends string, T> = (request: LLMRequestFunction<S>) => Promise<T>;
+type LLMStreamProgressCallback = (event: {
+    readonly outputCharacters: number;
+}) => void | Promise<void>;
+interface LLMTokenUsage {
+    readonly cacheReadTokens?: number;
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+}
+type LLMTokenUsageCallback = (usage: LLMTokenUsage) => void | Promise<void>;
+interface LLMOptions<S extends string> {
+    readonly model: LLMModel;
+    readonly dataDirPath: string;
+    readonly logDirPath?: string;
+    readonly cacheDirPath?: string;
+    readonly concurrent?: number;
+    readonly stream?: boolean;
+    readonly timeout?: number;
+    readonly temperature?: TemperatureSetting;
+    readonly topP?: TemperatureSetting;
+    readonly sampling?: SamplingScopeConfig<S>;
+    readonly retryTimes?: number;
+    readonly retryIntervalSeconds?: number;
+    readonly onStreamProgress?: LLMStreamProgressCallback;
+    readonly onTokenUsage?: LLMTokenUsageCallback;
+}
+
+export type { LLMLazyRequestOperation, LLMModel, LLMOptions, LLMRequestFunction, LLMRequestOptions, LLMStreamProgressCallback, LLMTokenUsage, LLMTokenUsageCallback, LLMessage, SamplingProfile, SamplingScopeConfig, TemperatureSetting };

package/dist/llm/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

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

package/dist/output/epub/archive.d.ts

@@ -0,0 +1,9 @@
+import { SourceAsset } from '../../source/types.js';
+import { EpubBook } from './model.js';
+import '../../source/meta.js';
+import 'zod';
+
+declare function writeEpubArchive(path: string, book: EpubBook): Promise<void>;
+declare function createCoverImageHref(cover: SourceAsset): string;
+
+export { createCoverImageHref, writeEpubArchive };

package/dist/output/epub/archive.js

@@ -0,0 +1,81 @@
+import { createWriteStream } from "fs";
+import { dirname, extname } from "path";
+import { finished } from "stream/promises";
+import { mkdir } from "fs/promises";
+import { ZipFile } from "yazl";
+import { normalizeLanguage } from "./shared.js";
+import { renderCoverPage } from "./templates.js";
+const EPUB_CONTAINER_XML = `<?xml version="1.0" encoding="UTF-8"?>
+<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
+  <rootfiles>
+    <rootfile full-path="OEBPS/package.opf" media-type="application/oebps-package+xml"/>
+  </rootfiles>
+</container>
+`;
+async function writeEpubArchive(path, book) {
+  await mkdir(dirname(path), { recursive: true });
+  const zip = new ZipFile();
+  zip.addBuffer(Buffer.from("application/epub+zip"), "mimetype", {
+    compress: false
+  });
+  zip.addBuffer(
+    Buffer.from(EPUB_CONTAINER_XML, "utf8"),
+    "META-INF/container.xml"
+  );
+  zip.addBuffer(Buffer.from(book.packageOpf, "utf8"), "OEBPS/package.opf");
+  zip.addBuffer(Buffer.from(book.navXhtml, "utf8"), "OEBPS/nav.xhtml");
+  for (const section of book.sections) {
+    zip.addBuffer(Buffer.from(section.xhtml, "utf8"), `OEBPS/${section.href}`);
+  }
+  if (book.cover !== void 0) {
+    const coverImageHref = createCoverImageHref(book.cover);
+    const language = normalizeLanguage(book.meta.language);
+    zip.addBuffer(Buffer.from(book.cover.data), `OEBPS/${coverImageHref}`);
+    zip.addBuffer(
+      Buffer.from(createCoverPage(book.meta, coverImageHref, language), "utf8"),
+      "OEBPS/text/cover.xhtml"
+    );
+  }
+  zip.end();
+  const output = createWriteStream(path);
+  const outputDone = finished(output);
+  const zipDone = finished(zip.outputStream);
+  zip.outputStream.pipe(output);
+  await Promise.all([outputDone, zipDone]);
+}
+function createCoverImageHref(cover) {
+  return `images/cover${normalizeCoverExtension(cover)}`;
+}
+function createCoverPage(meta, coverImageHref, language) {
+  const title = meta.title?.trim() || "Untitled";
+  return renderCoverPage({
+    coverImageHref,
+    language,
+    title
+  });
+}
+function normalizeCoverExtension(cover) {
+  const pathExtension = extname(cover.path).toLowerCase();
+  if (pathExtension !== "") {
+    return pathExtension;
+  }
+  switch (cover.mediaType) {
+    case "image/gif":
+      return ".gif";
+    case "image/jpeg":
+      return ".jpg";
+    case "image/png":
+      return ".png";
+    case "image/svg+xml":
+      return ".svg";
+    case "image/webp":
+      return ".webp";
+    default:
+      return ".bin";
+  }
+}
+export {
+  createCoverImageHref,
+  writeEpubArchive
+};
+//# sourceMappingURL=archive.js.map

package/dist/output/epub/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/archive.ts"],"sourcesContent":["import { createWriteStream } from \"fs\";\nimport { dirname, extname } from \"path\";\nimport { finished } from \"stream/promises\";\n\nimport { mkdir } from \"fs/promises\";\nimport { ZipFile } from \"yazl\";\n\nimport type { BookMeta, SourceAsset } from \"../../source/index.js\";\n\nimport type { EpubBook } from \"./model.js\";\nimport { normalizeLanguage } from \"./shared.js\";\nimport { renderCoverPage } from \"./templates.js\";\n\nconst EPUB_CONTAINER_XML = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<container version=\"1.0\" xmlns=\"urn:oasis:names:tc:opendocument:xmlns:container\">\n  <rootfiles>\n    <rootfile full-path=\"OEBPS/package.opf\" media-type=\"application/oebps-package+xml\"/>\n  </rootfiles>\n</container>\n`;\n\nexport async function writeEpubArchive(\n  path: string,\n  book: EpubBook,\n): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n\n  const zip = new ZipFile();\n\n  zip.addBuffer(Buffer.from(\"application/epub+zip\"), \"mimetype\", {\n    compress: false,\n  });\n  zip.addBuffer(\n    Buffer.from(EPUB_CONTAINER_XML, \"utf8\"),\n    \"META-INF/container.xml\",\n  );\n  zip.addBuffer(Buffer.from(book.packageOpf, \"utf8\"), \"OEBPS/package.opf\");\n  zip.addBuffer(Buffer.from(book.navXhtml, \"utf8\"), \"OEBPS/nav.xhtml\");\n\n  for (const section of book.sections) {\n    zip.addBuffer(Buffer.from(section.xhtml, \"utf8\"), `OEBPS/${section.href}`);\n  }\n\n  if (book.cover !== undefined) {\n    const coverImageHref = createCoverImageHref(book.cover);\n    const language = normalizeLanguage(book.meta.language);\n\n    zip.addBuffer(Buffer.from(book.cover.data), `OEBPS/${coverImageHref}`);\n    zip.addBuffer(\n      Buffer.from(createCoverPage(book.meta, coverImageHref, language), \"utf8\"),\n      \"OEBPS/text/cover.xhtml\",\n    );\n  }\n\n  zip.end();\n\n  const output = createWriteStream(path);\n  const outputDone = finished(output);\n  const zipDone = finished(zip.outputStream);\n\n  zip.outputStream.pipe(output);\n  await Promise.all([outputDone, zipDone]);\n}\n\nexport function createCoverImageHref(cover: SourceAsset): string {\n  return `images/cover${normalizeCoverExtension(cover)}`;\n}\n\nfunction createCoverPage(\n  meta: BookMeta,\n  coverImageHref: string,\n  language: string,\n): string {\n  const title = meta.title?.trim() || \"Untitled\";\n\n  return renderCoverPage({\n    coverImageHref,\n    language,\n    title,\n  });\n}\n\nfunction normalizeCoverExtension(cover: SourceAsset): string {\n  const pathExtension = extname(cover.path).toLowerCase();\n\n  if (pathExtension !== \"\") {\n    return pathExtension;\n  }\n\n  switch (cover.mediaType) {\n    case \"image/gif\":\n      return \".gif\";\n    case \"image/jpeg\":\n      return \".jpg\";\n    case \"image/png\":\n      return \".png\";\n    case \"image/svg+xml\":\n      return \".svg\";\n    case \"image/webp\":\n      return \".webp\";\n    default:\n      return \".bin\";\n  }\n}\n"],"mappings":"AAAA,SAAS,yBAAyB;AAClC,SAAS,SAAS,eAAe;AACjC,SAAS,gBAAgB;AAEzB,SAAS,aAAa;AACtB,SAAS,eAAe;AAKxB,SAAS,yBAAyB;AAClC,SAAS,uBAAuB;AAEhC,MAAM,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQ3B,eAAsB,iBACpB,MACA,MACe;AACf,QAAM,MAAM,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AAE9C,QAAM,MAAM,IAAI,QAAQ;AAExB,MAAI,UAAU,OAAO,KAAK,sBAAsB,GAAG,YAAY;AAAA,IAC7D,UAAU;AAAA,EACZ,CAAC;AACD,MAAI;AAAA,IACF,OAAO,KAAK,oBAAoB,MAAM;AAAA,IACtC;AAAA,EACF;AACA,MAAI,UAAU,OAAO,KAAK,KAAK,YAAY,MAAM,GAAG,mBAAmB;AACvE,MAAI,UAAU,OAAO,KAAK,KAAK,UAAU,MAAM,GAAG,iBAAiB;AAEnE,aAAW,WAAW,KAAK,UAAU;AACnC,QAAI,UAAU,OAAO,KAAK,QAAQ,OAAO,MAAM,GAAG,SAAS,QAAQ,IAAI,EAAE;AAAA,EAC3E;AAEA,MAAI,KAAK,UAAU,QAAW;AAC5B,UAAM,iBAAiB,qBAAqB,KAAK,KAAK;AACtD,UAAM,WAAW,kBAAkB,KAAK,KAAK,QAAQ;AAErD,QAAI,UAAU,OAAO,KAAK,KAAK,MAAM,IAAI,GAAG,SAAS,cAAc,EAAE;AACrE,QAAI;AAAA,MACF,OAAO,KAAK,gBAAgB,KAAK,MAAM,gBAAgB,QAAQ,GAAG,MAAM;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,IAAI;AAER,QAAM,SAAS,kBAAkB,IAAI;AACrC,QAAM,aAAa,SAAS,MAAM;AAClC,QAAM,UAAU,SAAS,IAAI,YAAY;AAEzC,MAAI,aAAa,KAAK,MAAM;AAC5B,QAAM,QAAQ,IAAI,CAAC,YAAY,OAAO,CAAC;AACzC;AAEO,SAAS,qBAAqB,OAA4B;AAC/D,SAAO,eAAe,wBAAwB,KAAK,CAAC;AACtD;AAEA,SAAS,gBACP,MACA,gBACA,UACQ;AACR,QAAM,QAAQ,KAAK,OAAO,KAAK,KAAK;AAEpC,SAAO,gBAAgB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,SAAS,wBAAwB,OAA4B;AAC3D,QAAM,gBAAgB,QAAQ,MAAM,IAAI,EAAE,YAAY;AAEtD,MAAI,kBAAkB,IAAI;AACxB,WAAO;AAAA,EACT;AAEA,UAAQ,MAAM,WAAW;AAAA,IACvB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;","names":[]}

package/dist/output/epub/book.d.ts

@@ -0,0 +1,15 @@
+import { ReadonlyDocument } from '../../document/document.js';
+import { EpubBook } from './model.js';
+import '../../source/meta.js';
+import 'zod';
+import '../../source/toc.js';
+import '../../source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/text-streams.js';
+import '../../document/types.js';
+import '../../document/stores.js';
+
+declare function buildEpubBook(document: ReadonlyDocument): Promise<EpubBook>;
+
+export { buildEpubBook };

package/dist/output/epub/book.js

@@ -0,0 +1,76 @@
+import { createCoverImageHref } from "./archive.js";
+import { createFallbackSection, createSectionDocument } from "./content.js";
+import { buildNavItems, createNavDocument } from "./navigation.js";
+import { createPackageOpf } from "./package.js";
+import { normalizeLanguage } from "./shared.js";
+async function buildEpubBook(document) {
+  const [meta, toc, cover] = await Promise.all([
+    document.readBookMeta(),
+    document.readToc(),
+    document.readCover()
+  ]);
+  if (meta === void 0) {
+    throw new Error("Archive metadata is missing");
+  }
+  if (toc === void 0) {
+    throw new Error("Document TOC is missing");
+  }
+  const sectionMap = /* @__PURE__ */ new Map();
+  const language = normalizeLanguage(meta.language);
+  const sections = await collectSections(
+    document,
+    language,
+    toc.items,
+    sectionMap
+  );
+  const navItems = buildNavItems(toc.items, sectionMap);
+  if (sections.length === 0) {
+    sections.push(createFallbackSection(meta, language));
+  }
+  const coverImageHref = cover === void 0 ? void 0 : createCoverImageHref(cover);
+  const coverPageHref = cover === void 0 ? void 0 : "text/cover.xhtml";
+  return {
+    cover,
+    meta,
+    navXhtml: createNavDocument(meta, language, navItems),
+    packageOpf: createPackageOpf({
+      coverImageHref,
+      coverMediaType: cover?.mediaType,
+      coverPageHref,
+      language,
+      meta,
+      modifiedAt: (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/u, "Z"),
+      sections
+    }),
+    sections
+  };
+}
+async function collectSections(document, language, items, sectionMap) {
+  const sections = [];
+  for (const item of items) {
+    if (item.serialId !== void 0) {
+      const summary = await document.readSummary(item.serialId);
+      if (summary === void 0) {
+        throw new Error(
+          `Chapter ${item.serialId} summary is missing. Run \`wg wikg://local/job add --input <chapter-uri> --task reading-summary --accept-cost\` before export, or inspect the archive with \`wg <archive-uri>/chapter/tree get\`.`
+        );
+      }
+      const section = createSectionDocument(
+        item.serialId,
+        language,
+        item.title,
+        summary
+      );
+      sectionMap.set(item.serialId, section);
+      sections.push(section);
+    }
+    sections.push(
+      ...await collectSections(document, language, item.children, sectionMap)
+    );
+  }
+  return sections;
+}
+export {
+  buildEpubBook
+};
+//# sourceMappingURL=book.js.map

package/dist/output/epub/book.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/book.ts"],"sourcesContent":["import type { ReadonlyDocument } from \"../../document/index.js\";\nimport type { TocItem } from \"../../source/index.js\";\n\nimport { createCoverImageHref } from \"./archive.js\";\nimport { createFallbackSection, createSectionDocument } from \"./content.js\";\nimport type { EpubBook, EpubSection } from \"./model.js\";\nimport { buildNavItems, createNavDocument } from \"./navigation.js\";\nimport { createPackageOpf } from \"./package.js\";\nimport { normalizeLanguage } from \"./shared.js\";\n\nexport async function buildEpubBook(\n  document: ReadonlyDocument,\n): Promise<EpubBook> {\n  const [meta, toc, cover] = await Promise.all([\n    document.readBookMeta(),\n    document.readToc(),\n    document.readCover(),\n  ]);\n\n  if (meta === undefined) {\n    throw new Error(\"Archive metadata is missing\");\n  }\n  if (toc === undefined) {\n    throw new Error(\"Document TOC is missing\");\n  }\n\n  const sectionMap = new Map<number, EpubSection>();\n  const language = normalizeLanguage(meta.language);\n  const sections = await collectSections(\n    document,\n    language,\n    toc.items,\n    sectionMap,\n  );\n  const navItems = buildNavItems(toc.items, sectionMap);\n\n  if (sections.length === 0) {\n    sections.push(createFallbackSection(meta, language));\n  }\n\n  const coverImageHref =\n    cover === undefined ? undefined : createCoverImageHref(cover);\n  const coverPageHref = cover === undefined ? undefined : \"text/cover.xhtml\";\n\n  return {\n    cover,\n    meta,\n    navXhtml: createNavDocument(meta, language, navItems),\n    packageOpf: createPackageOpf({\n      coverImageHref,\n      coverMediaType: cover?.mediaType,\n      coverPageHref,\n      language,\n      meta,\n      modifiedAt: new Date().toISOString().replace(/\\.\\d{3}Z$/u, \"Z\"),\n      sections,\n    }),\n    sections,\n  };\n}\n\nasync function collectSections(\n  document: ReadonlyDocument,\n  language: string,\n  items: readonly TocItem[],\n  sectionMap: Map<number, EpubSection>,\n): Promise<EpubSection[]> {\n  const sections: EpubSection[] = [];\n\n  for (const item of items) {\n    if (item.serialId !== undefined) {\n      const summary = await document.readSummary(item.serialId);\n\n      if (summary === undefined) {\n        throw new Error(\n          `Chapter ${item.serialId} summary is missing. Run \\`wg wikg://local/job add --input <chapter-uri> --task reading-summary --accept-cost\\` before export, or inspect the archive with \\`wg <archive-uri>/chapter/tree get\\`.`,\n        );\n      }\n\n      const section = createSectionDocument(\n        item.serialId,\n        language,\n        item.title,\n        summary,\n      );\n\n      sectionMap.set(item.serialId, section);\n      sections.push(section);\n    }\n\n    sections.push(\n      ...(await collectSections(document, language, item.children, sectionMap)),\n    );\n  }\n\n  return sections;\n}\n"],"mappings":"AAGA,SAAS,4BAA4B;AACrC,SAAS,uBAAuB,6BAA6B;AAE7D,SAAS,eAAe,yBAAyB;AACjD,SAAS,wBAAwB;AACjC,SAAS,yBAAyB;AAElC,eAAsB,cACpB,UACmB;AACnB,QAAM,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC3C,SAAS,aAAa;AAAA,IACtB,SAAS,QAAQ;AAAA,IACjB,SAAS,UAAU;AAAA,EACrB,CAAC;AAED,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI,MAAM,6BAA6B;AAAA,EAC/C;AACA,MAAI,QAAQ,QAAW;AACrB,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAEA,QAAM,aAAa,oBAAI,IAAyB;AAChD,QAAM,WAAW,kBAAkB,KAAK,QAAQ;AAChD,QAAM,WAAW,MAAM;AAAA,IACrB;AAAA,IACA;AAAA,IACA,IAAI;AAAA,IACJ;AAAA,EACF;AACA,QAAM,WAAW,cAAc,IAAI,OAAO,UAAU;AAEpD,MAAI,SAAS,WAAW,GAAG;AACzB,aAAS,KAAK,sBAAsB,MAAM,QAAQ,CAAC;AAAA,EACrD;AAEA,QAAM,iBACJ,UAAU,SAAY,SAAY,qBAAqB,KAAK;AAC9D,QAAM,gBAAgB,UAAU,SAAY,SAAY;AAExD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,kBAAkB,MAAM,UAAU,QAAQ;AAAA,IACpD,YAAY,iBAAiB;AAAA,MAC3B;AAAA,MACA,gBAAgB,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAY,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,cAAc,GAAG;AAAA,MAC9D;AAAA,IACF,CAAC;AAAA,IACD;AAAA,EACF;AACF;AAEA,eAAe,gBACb,UACA,UACA,OACA,YACwB;AACxB,QAAM,WAA0B,CAAC;AAEjC,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,aAAa,QAAW;AAC/B,YAAM,UAAU,MAAM,SAAS,YAAY,KAAK,QAAQ;AAExD,UAAI,YAAY,QAAW;AACzB,cAAM,IAAI;AAAA,UACR,WAAW,KAAK,QAAQ;AAAA,QAC1B;AAAA,MACF;AAEA,YAAM,UAAU;AAAA,QACd,KAAK;AAAA,QACL;AAAA,QACA,KAAK;AAAA,QACL;AAAA,MACF;AAEA,iBAAW,IAAI,KAAK,UAAU,OAAO;AACrC,eAAS,KAAK,OAAO;AAAA,IACvB;AAEA,aAAS;AAAA,MACP,GAAI,MAAM,gBAAgB,UAAU,UAAU,KAAK,UAAU,UAAU;AAAA,IACzE;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/output/epub/content.d.ts

@@ -0,0 +1,9 @@
+import { BookMeta } from '../../source/meta.js';
+import { EpubSection } from './model.js';
+import 'zod';
+import '../../source/types.js';
+
+declare function createFallbackSection(meta: BookMeta, language: string): EpubSection;
+declare function createSectionDocument(serialId: number, language: string, title: string | null | undefined, summary: string): EpubSection;
+
+export { createFallbackSection, createSectionDocument };

package/dist/output/epub/content.js

@@ -0,0 +1,35 @@
+import { renderSectionDocument } from "./templates.js";
+function createFallbackSection(meta, language) {
+  const title = meta.title?.trim() || "Untitled";
+  return {
+    href: "text/section-1.xhtml",
+    id: "section-1",
+    title,
+    xhtml: renderSectionDocument({
+      language,
+      paragraphs: [],
+      title
+    })
+  };
+}
+function createSectionDocument(serialId, language, title, summary) {
+  const normalizedTitle = title?.trim() || `Section ${serialId}`;
+  return {
+    href: `text/serial-${serialId}.xhtml`,
+    id: `serial-${serialId}`,
+    title: normalizedTitle,
+    xhtml: renderSectionDocument({
+      language,
+      paragraphs: splitParagraphs(summary.trim()),
+      title: normalizedTitle
+    })
+  };
+}
+function splitParagraphs(summary) {
+  return summary.split(/\n\s*\n/gu).map((paragraph) => paragraph.replace(/\s*\n\s*/gu, " ").trim()).filter((paragraph) => paragraph !== "");
+}
+export {
+  createFallbackSection,
+  createSectionDocument
+};
+//# sourceMappingURL=content.js.map

package/dist/output/epub/content.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/content.ts"],"sourcesContent":["import type { BookMeta } from \"../../source/index.js\";\n\nimport type { EpubSection } from \"./model.js\";\nimport { renderSectionDocument } from \"./templates.js\";\n\nexport function createFallbackSection(\n  meta: BookMeta,\n  language: string,\n): EpubSection {\n  const title = meta.title?.trim() || \"Untitled\";\n\n  return {\n    href: \"text/section-1.xhtml\",\n    id: \"section-1\",\n    title,\n    xhtml: renderSectionDocument({\n      language,\n      paragraphs: [],\n      title,\n    }),\n  };\n}\n\nexport function createSectionDocument(\n  serialId: number,\n  language: string,\n  title: string | null | undefined,\n  summary: string,\n): EpubSection {\n  const normalizedTitle = title?.trim() || `Section ${serialId}`;\n\n  return {\n    href: `text/serial-${serialId}.xhtml`,\n    id: `serial-${serialId}`,\n    title: normalizedTitle,\n    xhtml: renderSectionDocument({\n      language,\n      paragraphs: splitParagraphs(summary.trim()),\n      title: normalizedTitle,\n    }),\n  };\n}\n\nfunction splitParagraphs(summary: string): string[] {\n  return summary\n    .split(/\\n\\s*\\n/gu)\n    .map((paragraph) => paragraph.replace(/\\s*\\n\\s*/gu, \" \").trim())\n    .filter((paragraph) => paragraph !== \"\");\n}\n"],"mappings":"AAGA,SAAS,6BAA6B;AAE/B,SAAS,sBACd,MACA,UACa;AACb,QAAM,QAAQ,KAAK,OAAO,KAAK,KAAK;AAEpC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI;AAAA,IACJ;AAAA,IACA,OAAO,sBAAsB;AAAA,MAC3B;AAAA,MACA,YAAY,CAAC;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEO,SAAS,sBACd,UACA,UACA,OACA,SACa;AACb,QAAM,kBAAkB,OAAO,KAAK,KAAK,WAAW,QAAQ;AAE5D,SAAO;AAAA,IACL,MAAM,eAAe,QAAQ;AAAA,IAC7B,IAAI,UAAU,QAAQ;AAAA,IACtB,OAAO;AAAA,IACP,OAAO,sBAAsB;AAAA,MAC3B;AAAA,MACA,YAAY,gBAAgB,QAAQ,KAAK,CAAC;AAAA,MAC1C,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AACF;AAEA,SAAS,gBAAgB,SAA2B;AAClD,SAAO,QACJ,MAAM,WAAW,EACjB,IAAI,CAAC,cAAc,UAAU,QAAQ,cAAc,GAAG,EAAE,KAAK,CAAC,EAC9D,OAAO,CAAC,cAAc,cAAc,EAAE;AAC3C;","names":[]}

package/dist/output/epub/index.d.ts

@@ -0,0 +1,20 @@
+import { ReadonlyDocument } from '../../document/document.js';
+export { EPUB_OUTPUT_VERSION } from './package.js';
+import '../../source/meta.js';
+import 'zod';
+import '../../source/toc.js';
+import '../../source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/text-streams.js';
+import '../../document/types.js';
+import '../../document/stores.js';
+import './model.js';
+
+interface WriteEpubOptions {
+    readonly document: ReadonlyDocument;
+    readonly path: string;
+}
+declare function writeEpub(options: WriteEpubOptions): Promise<void>;
+
+export { type WriteEpubOptions, writeEpub };

package/dist/output/epub/index.js

@@ -0,0 +1,14 @@
+import { writeEpubArchive } from "./archive.js";
+import { buildEpubBook } from "./book.js";
+import { EPUB_OUTPUT_VERSION } from "./package.js";
+async function writeEpub(options) {
+  const book = await options.document.openSession(async (document) => {
+    return await buildEpubBook(document);
+  });
+  await writeEpubArchive(options.path, book);
+}
+export {
+  EPUB_OUTPUT_VERSION,
+  writeEpub
+};
+//# sourceMappingURL=index.js.map

package/dist/output/epub/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/output/epub/index.ts"],"sourcesContent":["import type { ReadonlyDocument } from \"../../document/index.js\";\n\nimport { writeEpubArchive } from \"./archive.js\";\nimport { buildEpubBook } from \"./book.js\";\nimport { EPUB_OUTPUT_VERSION } from \"./package.js\";\n\nexport interface WriteEpubOptions {\n  readonly document: ReadonlyDocument;\n  readonly path: string;\n}\n\nexport async function writeEpub(options: WriteEpubOptions): Promise<void> {\n  const book = await options.document.openSession(async (document) => {\n    return await buildEpubBook(document);\n  });\n\n  await writeEpubArchive(options.path, book);\n}\n\nexport { EPUB_OUTPUT_VERSION };\n"],"mappings":"AAEA,SAAS,wBAAwB;AACjC,SAAS,qBAAqB;AAC9B,SAAS,2BAA2B;AAOpC,eAAsB,UAAU,SAA0C;AACxE,QAAM,OAAO,MAAM,QAAQ,SAAS,YAAY,OAAO,aAAa;AAClE,WAAO,MAAM,cAAc,QAAQ;AAAA,EACrC,CAAC;AAED,QAAM,iBAAiB,QAAQ,MAAM,IAAI;AAC3C;","names":[]}