wiki-graph-core 0.3.1

package/dist/worker-BgQ0Xl8T.d.cts

@@ -0,0 +1,181 @@
+import { a as GcContext, d as GcJobResult } from './types-FVIqiLC9.cjs';
+
+declare const BUILD_JOB_STATES: readonly ["queued", "running", "canceling", "paused", "succeeded", "failed", "canceled"];
+type BuildJobState = (typeof BUILD_JOB_STATES)[number];
+type BuildJobTarget = "knowledge-graph" | "reading-graph" | "reading-summary";
+type BuildJobProgressPhase = "committing" | "enrichment" | "grounding" | "matching" | "narrowing" | "relation-discovery" | "screening";
+type BuildJobProgressUnit = "candidate" | "char" | "item" | "page" | "qid" | "sentence" | "window" | "record";
+interface BuildJobProgressCounter {
+    readonly done: number;
+    readonly name: string;
+    readonly total: number;
+    readonly unit: BuildJobProgressUnit | "word";
+}
+interface BuildJobTokenUsage {
+    readonly cacheReadTokens?: number;
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+}
+interface BuildJob {
+    readonly archiveKey: string;
+    readonly archivePath: string;
+    readonly cachePath: string;
+    readonly chapterId: number;
+    readonly createdAt: number;
+    readonly currentStep?: BuildJobTarget;
+    readonly errorJSON?: string;
+    readonly eventsPath: string;
+    readonly finishedAt?: number;
+    readonly jobId: string;
+    readonly inputRevision?: number;
+    readonly logPath: string;
+    readonly llmJSON?: string;
+    readonly ownerId?: string;
+    readonly ownerPid?: number;
+    readonly prompt?: string;
+    readonly queueRank: number;
+    readonly state: BuildJobState;
+    readonly readingSummaryStartedAt?: number;
+    readonly target: BuildJobTarget;
+    readonly updatedAt: number;
+    readonly workspacePath: string;
+}
+type BuildJobEvent = {
+    readonly at: number;
+    readonly jobId: string;
+    readonly seq: number;
+    readonly state: BuildJobState;
+    readonly type: "created" | "paused" | "resumed" | "boosted" | "canceling";
+} | {
+    readonly at: number;
+    readonly jobId: string;
+    readonly seq: number;
+    readonly from: BuildJobTarget;
+    readonly to: BuildJobTarget;
+    readonly type: "target_changed";
+} | {
+    readonly at: number;
+    readonly jobId: string;
+    readonly seq: number;
+    readonly state: "running";
+    readonly type: "started";
+} | {
+    readonly at: number;
+    readonly jobId: string;
+    readonly seq: number;
+    readonly state: "queued";
+    readonly type: "requeued";
+} | {
+    readonly at: number;
+    readonly jobId: string;
+    readonly seq: number;
+    readonly step: BuildJobTarget;
+    readonly type: "step_started" | "step_completed";
+} | {
+    readonly at: number;
+    readonly counters: readonly BuildJobProgressCounter[];
+    readonly jobId: string;
+    readonly phase?: BuildJobProgressPhase;
+    readonly seq: number;
+    readonly step?: BuildJobTarget;
+    readonly tokens?: BuildJobTokenUsage;
+    readonly type: "status_snapshot";
+} | {
+    readonly at: number;
+    readonly error?: unknown;
+    readonly jobId: string;
+    readonly seq: number;
+    readonly state: "failed" | "canceled" | "succeeded";
+    readonly type: "failed" | "canceled" | "succeeded";
+};
+interface AddBuildJobOptions {
+    readonly archivePath: string;
+    readonly boost?: boolean;
+    readonly chapterId: number;
+    readonly jobId?: string;
+    readonly llmJSON?: string;
+    readonly prompt?: string;
+    readonly target: BuildJobTarget;
+}
+interface BuildJobListOptions {
+    readonly activeOnly?: boolean;
+    readonly all?: boolean;
+    readonly archivePath?: string;
+}
+interface BuildJobWorkerOptions {
+    readonly concurrency: number;
+    readonly executeJob: (job: BuildJob, reporter: BuildJobProgressReporter, context: BuildJobExecutionContext) => Promise<void>;
+    readonly idleTimeoutMs?: number;
+}
+interface BuildJobExecutionContext {
+    readonly signal: AbortSignal;
+}
+interface BuildJobProgressReporter {
+    addOutputCharacters(characters: number): Promise<void>;
+    addTokenUsage(usage: BuildJobTokenUsage): Promise<void>;
+    setTotals(input: {
+        readonly totalGraphWords?: number;
+        readonly totalReadingSummaryWords?: number;
+    }): Promise<void>;
+    stepCompleted(step: BuildJobTarget): Promise<void>;
+    stepStarted(step: BuildJobTarget): Promise<void>;
+    updateWords(input: {
+        readonly graphWords?: number;
+        readonly readingSummaryWords?: number;
+    }): Promise<void>;
+    updatePhase(input: {
+        readonly done: number;
+        readonly force?: boolean;
+        readonly phase: BuildJobProgressPhase;
+        readonly phaseDetail?: string;
+        readonly total: number;
+        readonly unit: BuildJobProgressUnit;
+    }): Promise<void>;
+    throwIfStopped(): Promise<void>;
+}
+type BuildJobConflictScope = {
+    readonly kind: "archive";
+} | {
+    readonly chapterIds: readonly number[];
+    readonly kind: "chapter";
+};
+declare function addBuildJob(options: AddBuildJobOptions): Promise<BuildJob>;
+declare function recordBuildJobInputRevision(input: {
+    readonly currentRevision: number;
+    readonly jobId: string;
+    readonly ownerId: string;
+}): Promise<BuildJob>;
+declare function assertBuildJobInputRevision(input: {
+    readonly currentRevision: number;
+    readonly jobId: string;
+    readonly ownerId: string;
+}): Promise<void>;
+declare function listBuildJobs(options?: BuildJobListOptions): Promise<BuildJob[]>;
+declare function getBuildJob(jobId: string): Promise<BuildJob>;
+declare function resolveBuildJobId(jobIdPrefix: string): Promise<string>;
+declare function pauseBuildJob(jobId: string): Promise<BuildJob>;
+declare function resumeBuildJob(jobId: string): Promise<BuildJob>;
+declare function cancelBuildJob(jobId: string): Promise<BuildJob>;
+declare function boostBuildJob(jobId: string): Promise<BuildJob>;
+declare function updateBuildJobTarget(jobId: string, target: BuildJobTarget): Promise<BuildJob>;
+declare function assertNoActiveBuildJobs(input: {
+    readonly archivePath: string;
+    readonly chapterIds: readonly number[];
+    readonly operation: string;
+    readonly requiresTarget?: BuildJobTarget;
+}): Promise<void>;
+declare function assertNoActiveBuildJobConflicts(input: {
+    readonly archivePath: string;
+    readonly operation: string;
+    readonly requiresTarget?: BuildJobTarget;
+    readonly scope: BuildJobConflictScope;
+}): Promise<void>;
+declare function runBuildJobWorker(options: BuildJobWorkerOptions): Promise<void>;
+declare function readBuildJobEvents(job: Pick<BuildJob, "eventsPath">): Promise<BuildJobEvent[]>;
+declare function cleanBuildJobs(options?: {
+    readonly olderThanMs?: number;
+    readonly states?: readonly BuildJobState[];
+}): Promise<number>;
+declare function runBuildQueueGc(context: GcContext): Promise<GcJobResult>;
+
+export { type AddBuildJobOptions as A, type BuildJobProgressReporter as B, type BuildJob as a, type BuildJobConflictScope as b, type BuildJobEvent as c, type BuildJobExecutionContext as d, type BuildJobListOptions as e, type BuildJobProgressCounter as f, type BuildJobState as g, type BuildJobTarget as h, type BuildJobWorkerOptions as i, addBuildJob as j, assertBuildJobInputRevision as k, assertNoActiveBuildJobConflicts as l, assertNoActiveBuildJobs as m, boostBuildJob as n, cancelBuildJob as o, cleanBuildJobs as p, getBuildJob as q, listBuildJobs as r, pauseBuildJob as s, readBuildJobEvents as t, recordBuildJobInputRevision as u, resolveBuildJobId as v, resumeBuildJob as w, runBuildJobWorker as x, runBuildQueueGc as y, updateBuildJobTarget as z };