@wanshi-kg/wanshi 0.1.0

package/dist/core/cost/CostMeter.js

@@ -0,0 +1,235 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.meter = exports.CostMeter = exports.OUTPUT_TOKENS_PER_CHUNK = exports.SYSTEM_OVERHEAD_TOKENS = exports.CHARS_PER_TOKEN = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const shared_1 = require("../../shared");
+const prices_1 = require("./prices");
+/** Rough pre-run estimate constants (deliberately approximate; the end tally is exact). */
+exports.CHARS_PER_TOKEN = 4;
+exports.SYSTEM_OVERHEAD_TOKENS = 900; // v5 system prompt + retrieved context, per chunk
+exports.OUTPUT_TOKENS_PER_CHUNK = 400; // a chunk's worth of entities/relations JSON
+const emptyBucket = () => ({ calls: 0, promptTokens: 0, completionTokens: 0, cost: 0 });
+/**
+ * Cost / token meter — a module singleton (à la `shared/shutdown` and the trace
+ * writer) so every LLM provider can `meter.record(...)` without DI plumbing.
+ * `ContainerFactory` calls `configure` once. Off by default ⇒ `record` is an early
+ * return guarded at the call site by `if (meter.enabled)`, so a default run carries
+ * zero overhead and is byte-identical.
+ *
+ * Accounting is split: `thisRun` is what the current invocation spent (drives the
+ * `--max-cost` cap + this-run tally); `prior` is the cumulative loaded from the
+ * ledger. Resumed chunks skip generation entirely (no `record`), so re-running a
+ * finished job adds $0 — the ledger never double-counts.
+ */
+class CostMeter {
+    constructor() {
+        this._enabled = false;
+        this.currency = "USD";
+        this.prices = {};
+        this.thisRunTotal = emptyBucket();
+        this.thisRunByModel = new Map();
+        this.capTripped = false;
+        this.warnedModels = new Set();
+    }
+    get enabled() {
+        return this._enabled;
+    }
+    get thisRunCost() {
+        return this.thisRunTotal.cost;
+    }
+    /** Attach the resolved run logger (ContainerFactory configures the meter before one exists). */
+    attachLogger(logger) {
+        this.logger = logger;
+    }
+    configure(config) {
+        this._enabled = config.enabled;
+        this.maxCost = config.maxCost;
+        this.currency = config.currency || "USD";
+        this.prices = Object.assign(Object.assign({}, prices_1.DEFAULT_PRICES), (config.prices || {}));
+        this.ledgerPath = config.ledgerPath;
+        this.logger = config.logger;
+        this.thisRunTotal = emptyBucket();
+        this.thisRunByModel = new Map();
+        this.capTripped = false;
+        this.warnedModels.clear();
+        this.prior = this._enabled ? this.loadLedger() : undefined;
+    }
+    /** USD per 1M {in,out} tokens for a model: exact id, then the longest substring key, else 0. */
+    priceFor(model) {
+        var _a;
+        if (this.prices[model])
+            return this.prices[model];
+        let best;
+        for (const [key, price] of Object.entries(this.prices)) {
+            if (model.includes(key) && (!best || key.length > best.key.length))
+                best = { key, price };
+        }
+        return (_a = best === null || best === void 0 ? void 0 : best.price) !== null && _a !== void 0 ? _a : { in: 0, out: 0 };
+    }
+    /** Record one generation's usage. Guarded by `enabled` at the call site, but safe regardless. */
+    record(model, usage) {
+        var _a, _b, _c, _d, _e;
+        if (!this._enabled || !usage)
+            return;
+        const price = this.priceFor(model);
+        if (price.in === 0 && price.out === 0 && !this.warnedModels.has(model)) {
+            this.warnedModels.add(model);
+            (_a = this.logger) === null || _a === void 0 ? void 0 : _a.info(`Cost meter: no price for model '${model}' — its spend is shown as ${this.currency} 0 (set cost.prices for an accurate bill).`);
+        }
+        const prompt = (_b = usage.promptTokens) !== null && _b !== void 0 ? _b : 0;
+        const completion = (_c = usage.completionTokens) !== null && _c !== void 0 ? _c : 0;
+        const cost = (prompt / 1e6) * price.in + (completion / 1e6) * price.out;
+        const bucket = (_d = this.thisRunByModel.get(model)) !== null && _d !== void 0 ? _d : emptyBucket();
+        bucket.calls++;
+        bucket.promptTokens += prompt;
+        bucket.completionTokens += completion;
+        bucket.cost += cost;
+        this.thisRunByModel.set(model, bucket);
+        this.thisRunTotal.calls++;
+        this.thisRunTotal.promptTokens += prompt;
+        this.thisRunTotal.completionTokens += completion;
+        this.thisRunTotal.cost += cost;
+        if (this.maxCost != null && this.thisRunTotal.cost > this.maxCost && !this.capTripped) {
+            this.capTripped = true;
+            (_e = this.logger) === null || _e === void 0 ? void 0 : _e.warn(`Cost cap reached: spent ${this.fmt(this.thisRunTotal.cost)} > cap ${this.fmt(this.maxCost)} this run. ` +
+                `Finishing the in-flight chunk, checkpointing, and exporting the partial graph — re-run with --resume to continue.`);
+            shared_1.shutdown.request();
+        }
+    }
+    /** Rough pre-run projection from total input characters + chunk size. */
+    estimate(totalInputChars, chunkSize, model) {
+        const estChunks = chunkSize > 0 ? Math.ceil(totalInputChars / chunkSize) : 0;
+        const estPromptTokens = estChunks * (Math.ceil(chunkSize / exports.CHARS_PER_TOKEN) + exports.SYSTEM_OVERHEAD_TOKENS);
+        const estCompletionTokens = estChunks * exports.OUTPUT_TOKENS_PER_CHUNK;
+        const price = this.priceFor(model);
+        const estCost = (estPromptTokens / 1e6) * price.in + (estCompletionTokens / 1e6) * price.out;
+        return { estChunks, estPromptTokens, estCompletionTokens, estCost, priced: price.in > 0 || price.out > 0 };
+    }
+    /** Multi-line human summary for the end-of-run log (this run + cumulative). */
+    summary() {
+        const lines = ["Cost / token usage (this run):"];
+        if (this.thisRunByModel.size === 0) {
+            lines.push("  (no metered LLM calls)");
+        }
+        else {
+            for (const [model, b] of this.thisRunByModel) {
+                lines.push(`  ${model}: ${b.calls} call(s), ${b.promptTokens}+${b.completionTokens} tok, ${this.fmt(b.cost)}`);
+            }
+        }
+        lines.push(`  TOTAL this run: ${this.thisRunTotal.promptTokens + this.thisRunTotal.completionTokens} tok, ${this.fmt(this.thisRunTotal.cost)}`);
+        const cum = this.cumulative();
+        if (this.prior) {
+            lines.push(`  CUMULATIVE (incl. prior resume runs): ${this.fmt(cum.total.cost)} over ${cum.runs} run(s)`);
+        }
+        lines.push(`  (prices best-effort as of ${prices_1.PRICES_AS_OF}; override via cost.prices)`);
+        return lines.join("\n");
+    }
+    /** Persist the cumulative ledger (prior + this run). No-op without a path. */
+    persistLedger() {
+        if (!this._enabled || !this.ledgerPath)
+            return;
+        const ledger = this.cumulative();
+        try {
+            fs.mkdirSync(path.dirname(this.ledgerPath), { recursive: true });
+            fs.writeFileSync(this.ledgerPath, JSON.stringify(ledger, null, 2) + "\n");
+        }
+        catch (_a) {
+            /* best-effort side channel — never fail the run over the ledger */
+        }
+    }
+    /** prior + this-run, folded into a fresh ledger object. */
+    cumulative() {
+        var _a, _b, _c;
+        const total = emptyBucket();
+        const perModel = {};
+        const add = (into, b) => {
+            into.calls += b.calls;
+            into.promptTokens += b.promptTokens;
+            into.completionTokens += b.completionTokens;
+            into.cost += b.cost;
+        };
+        if (this.prior) {
+            add(total, this.prior.total);
+            for (const [m, b] of Object.entries(this.prior.perModel)) {
+                perModel[m] = emptyBucket();
+                add(perModel[m], b);
+            }
+        }
+        add(total, this.thisRunTotal);
+        for (const [m, b] of this.thisRunByModel) {
+            perModel[m] = (_a = perModel[m]) !== null && _a !== void 0 ? _a : emptyBucket();
+            add(perModel[m], b);
+        }
+        return {
+            currency: this.currency,
+            runs: ((_c = (_b = this.prior) === null || _b === void 0 ? void 0 : _b.runs) !== null && _c !== void 0 ? _c : 0) + 1,
+            updatedAt: new Date().toISOString(),
+            total,
+            perModel,
+        };
+    }
+    loadLedger() {
+        if (!this.ledgerPath || !fs.existsSync(this.ledgerPath))
+            return undefined;
+        try {
+            return JSON.parse(fs.readFileSync(this.ledgerPath, "utf-8"));
+        }
+        catch (_a) {
+            return undefined; // corrupt ledger — start cumulative fresh rather than crash
+        }
+    }
+    fmt(n) {
+        return `${this.currency} ${n.toFixed(n < 1 ? 4 : 2)}`;
+    }
+    /** Test hook — restore the disabled default. */
+    reset() {
+        this._enabled = false;
+        this.maxCost = undefined;
+        this.prices = {};
+        this.ledgerPath = undefined;
+        this.logger = undefined;
+        this.thisRunTotal = emptyBucket();
+        this.thisRunByModel = new Map();
+        this.prior = undefined;
+        this.capTripped = false;
+        this.warnedModels.clear();
+    }
+}
+exports.CostMeter = CostMeter;
+/** The process-wide cost meter singleton. */
+exports.meter = new CostMeter();
+//# sourceMappingURL=CostMeter.js.map

package/dist/core/cost/CostMeter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CostMeter.js","sourceRoot":"","sources":["../../../src/core/cost/CostMeter.ts"],"names":[],"mappings":"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"}

package/dist/core/cost/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./prices"), exports);
+__exportStar(require("./CostMeter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/cost/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/cost/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B"}

package/dist/core/cost/prices.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PRICES = exports.PRICES_AS_OF = void 0;
+/**
+ * Built-in best-effort price map for cost metering. Values are USD per 1M tokens
+ * `{ in: prompt, out: completion }`. Matched by exact model id first, then by the
+ * longest key that is a substring of the model id (so `gpt-4o` matches
+ * `gpt-4o-2024-08-06`, and an OpenRouter `openai/gpt-4o` matches `gpt-4o`).
+ *
+ * Prices DRIFT. This map is a convenience, not a source of truth — the tally
+ * prints `PRICES_AS_OF` and tells the user to override via `cost.prices` for an
+ * accurate bill. A model with no match resolves to 0 (local Ollama, or an
+ * unknown id) and is reported as `$0` with a one-time note.
+ */
+exports.PRICES_AS_OF = "2026-06";
+exports.DEFAULT_PRICES = {
+    // OpenAI
+    "gpt-4o-mini": { in: 0.15, out: 0.6 },
+    "gpt-4o": { in: 2.5, out: 10 },
+    "gpt-4.1-mini": { in: 0.4, out: 1.6 },
+    "gpt-4.1": { in: 2, out: 8 },
+    "o4-mini": { in: 1.1, out: 4.4 },
+    // Anthropic
+    "claude-3-5-haiku": { in: 0.8, out: 4 },
+    "claude-3-5-sonnet": { in: 3, out: 15 },
+    "claude-3-7-sonnet": { in: 3, out: 15 },
+    "claude-3-opus": { in: 15, out: 75 },
+    // Google (Gemini, incl. OpenRouter ids like `google/gemini-1.5-pro`)
+    "gemini-1.5-flash": { in: 0.075, out: 0.3 },
+    "gemini-1.5-pro": { in: 1.25, out: 5 },
+    "gemini-2.0-flash": { in: 0.1, out: 0.4 },
+    // Open-weight on metered hosts (OpenRouter-style ids); rough midpoints
+    "llama-3.1-70b": { in: 0.35, out: 0.4 },
+    "llama-3.3-70b": { in: 0.35, out: 0.4 },
+    "qwen-2.5-72b": { in: 0.35, out: 0.4 },
+    // Local Ollama is free; left unlisted ⇒ resolves to 0.
+};
+//# sourceMappingURL=prices.js.map

package/dist/core/cost/prices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.js","sourceRoot":"","sources":["../../../src/core/cost/prices.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACU,QAAA,YAAY,GAAG,SAAS,CAAC;AAOzB,QAAA,cAAc,GAA+B;IACxD,SAAS;IACT,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;IACrC,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE;IAC9B,cAAc,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACrC,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IAC5B,SAAS,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAChC,YAAY;IACZ,kBAAkB,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE;IACvC,mBAAmB,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACvC,mBAAmB,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACvC,eAAe,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,qEAAqE;IACrE,kBAAkB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;IAC3C,gBAAgB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE;IACtC,kBAAkB,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACzC,uEAAuE;IACvE,eAAe,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;IACvC,eAAe,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;IACvC,cAAc,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;IACtC,uDAAuD;CACxD,CAAC"}

package/dist/core/cv/ObjectDetectionService.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectDetectionService = void 0;
+const DEFAULT_CLOSED_MODEL = "Xenova/detr-resnet-50";
+const DEFAULT_ZEROSHOT_MODEL = "Xenova/owlvit-base-patch32";
+/**
+ * Opt-in CV object detector backed by `@huggingface/transformers` (already a dep;
+ * bundles onnxruntime-node + sharp — zero new deps). Loads the pipeline **once**
+ * (a per-image `pipeline()` would reload the model), then runs it per image. Two
+ * config-selectable modes: `closed` (`object-detection`, COCO-80) and `zero-shot`
+ * (`zero-shot-object-detection`, open-vocab via `labels`). The heavy dep is
+ * lazy-imported so a run with detection off pays nothing.
+ *
+ * Signal-not-verdict (Phase 2): detections are confidence-tagged (the detector's
+ * own score) and feed the VLM context + a `cv-detection` graph fragment. Any
+ * failure (model download offline, bad image, empty zero-shot labels) → `[]` with
+ * a one-time warn — no signal, never a throw (the C2PA `unavailable` discipline).
+ */
+class ObjectDetectionService {
+    constructor(opts, logger, injectedPipeline) {
+        this.opts = opts;
+        this.logger = logger;
+        this.injectedPipeline = injectedPipeline;
+        this.warned = false;
+    }
+    detect(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (this.opts.mode === "zero-shot" && this.opts.labels.length === 0) {
+                this.warnOnce("Object detection mode=zero-shot but readers.cv.detection.labels is empty; skipping");
+                return [];
+            }
+            try {
+                const pipe = yield this.loadPipeline();
+                const raw = this.opts.mode === "zero-shot"
+                    ? yield pipe(filePath, this.opts.labels, { threshold: this.opts.threshold })
+                    : yield pipe(filePath, { threshold: this.opts.threshold });
+                return (Array.isArray(raw) ? raw : [])
+                    .filter((d) => d && typeof d.label === "string" && typeof d.score === "number" && d.score >= this.opts.threshold)
+                    .map((d) => ({ label: d.label, score: d.score, box: d.box }))
+                    .sort((a, b) => b.score - a.score)
+                    .slice(0, this.opts.maxObjects);
+            }
+            catch (e) {
+                this.warnOnce(`Object detection unavailable (${(_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : e}); no CV signal emitted`);
+                return [];
+            }
+        });
+    }
+    /** Lazy-load + cache the pipeline. A rejected load stays cached (detect() → []). */
+    loadPipeline() {
+        if (this.injectedPipeline)
+            return Promise.resolve(this.injectedPipeline);
+        if (!this.pipelinePromise) {
+            this.pipelinePromise = (() => __awaiter(this, void 0, void 0, function* () {
+                const tf = yield Promise.resolve().then(() => __importStar(require("@huggingface/transformers")));
+                if (this.opts.cacheDir)
+                    tf.env.cacheDir = this.opts.cacheDir;
+                if (!this.opts.allowRemote)
+                    tf.env.allowRemoteModels = false;
+                const task = this.opts.mode === "zero-shot" ? "zero-shot-object-detection" : "object-detection";
+                const model = this.opts.model || (this.opts.mode === "zero-shot" ? DEFAULT_ZEROSHOT_MODEL : DEFAULT_CLOSED_MODEL);
+                this.logger.info(`Loading object-detection pipeline (${task}, ${model})`);
+                return (yield tf.pipeline(task, model));
+            }))();
+        }
+        return this.pipelinePromise;
+    }
+    warnOnce(message) {
+        if (this.warned)
+            return;
+        this.warned = true;
+        this.logger.warn(message);
+    }
+}
+exports.ObjectDetectionService = ObjectDetectionService;
+//# sourceMappingURL=ObjectDetectionService.js.map

package/dist/core/cv/ObjectDetectionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectDetectionService.js","sourceRoot":"","sources":["../../../src/core/cv/ObjectDetectionService.ts"],"names":[],"mappings":"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"}