@trillboards/edge-sdk 0.2.140 → 0.2.151

package/dist/OrderedReviewClient.d.ts

@@ -0,0 +1,38 @@
+import type { LocalSensingClient } from './localSensing';
+import type { AudienceAnalyzeRequest } from './AudienceAnalyzeClient';
+import type { LiteRtVlmProvider, HttpJsonPoster } from './LiteRtVlmProvider';
+import type { VlmCandidate } from './VlmCandidateBuffer';
+import { OrderedSequenceStore, type OrderedCaptureContract } from './OrderedSequenceStore';
+/** Explicit Path 3 adapter. Existing capture -> durable spool -> LocalSensingClient
+ * -> pinned Gemma provider -> local receiver; no production selection is changed.
+ * A factory supplies the SAME client options for the per-sequence provider.
+ */
+export declare class OrderedReviewClient {
+    private readonly client;
+    private readonly store;
+    private readonly factory;
+    private readonly runtime;
+    private readonly transport?;
+    private readonly contract;
+    private completed;
+    private health;
+    constructor(client: LocalSensingClient, store: OrderedSequenceStore, contract: OrderedCaptureContract, factory: (provider: LiteRtVlmProvider) => LocalSensingClient, runtime: {
+        baseUrl: string;
+        model: string;
+    }, transport?: HttpJsonPoster | undefined);
+    prepareReview(): Promise<void>;
+    captureReviewContext(): Record<string, unknown>;
+    retainOrderedCapture(candidate: VlmCandidate): void;
+    pendingOrderedCandidates(): VlmCandidate[];
+    flushOrderedCapture(): void;
+    getEndpoint(): string;
+    getReviewModelUse(context: Record<string, unknown> | undefined): import("./ReviewModelUse").ReviewModelUse;
+    getAcceleratorHealth(): import("./LiteRtVlmProvider").LiteRtAcceleratorHealth;
+    getLocalInferenceStats(): {
+        completed: number;
+    };
+    private prepare;
+    reviewCandidate(request: AudienceAnalyzeRequest): Promise<void>;
+    analyze(request: AudienceAnalyzeRequest): Promise<import("./AudienceAnalyzeClient").AudienceAnalyzeResponse>;
+}
+//# sourceMappingURL=OrderedReviewClient.d.ts.map

package/dist/OrderedReviewClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderedReviewClient.d.ts","sourceRoot":"","sources":["../src/OrderedReviewClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAuB,MAAM,qBAAqB,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIzD,OAAO,EAAE,oBAAoB,EAA2B,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEpH;;;GAGG;AACH,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAqB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAA+B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IALpF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,SAAS,CAAG;IACpB,OAAO,CAAC,MAAM,CAAkE;gBACnD,MAAM,EAAC,kBAAkB,EAAmB,KAAK,EAAC,oBAAoB,EACjG,QAAQ,EAAC,sBAAsB,EAAmB,OAAO,EAAC,CAAC,QAAQ,EAAC,iBAAiB,KAAG,kBAAkB,EACzF,OAAO,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,MAAM,CAAA;KAAC,EAAkB,SAAS,CAAC,EAAC,cAAc,YAAA;IAKnG,aAAa;IACb,oBAAoB,IAAG,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC;IAG7C,oBAAoB,CAAC,SAAS,EAAC,YAAY,GAAE,IAAI;IACjD,wBAAwB,IAAG,YAAY,EAAE;IACzC,mBAAmB,IAAG,IAAI;IAC1B,WAAW;IACX,iBAAiB,CAAC,OAAO,EAAC,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC,GAAC,SAAS;IAC1D,oBAAoB;IACpB,sBAAsB;;;YACR,OAAO;IA2Df,eAAe,CAAC,OAAO,EAAC,sBAAsB,GAAE,OAAO,CAAC,IAAI,CAAC;IAC7D,OAAO,CAAC,OAAO,EAAC,sBAAsB;CAQ7C"}

package/dist/OrderedReviewClient.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderedReviewClient = void 0;
+const crypto_1 = require("crypto");
+const ScopedVlmReview_1 = require("./ScopedVlmReview");
+const ProfileReviewWork_1 = require("./ProfileReviewWork");
+const OrderedFrameReview_1 = require("./OrderedFrameReview");
+const OrderedSequenceStore_1 = require("./OrderedSequenceStore");
+/** Explicit Path 3 adapter. Existing capture -> durable spool -> LocalSensingClient
+ * -> pinned Gemma provider -> local receiver; no production selection is changed.
+ * A factory supplies the SAME client options for the per-sequence provider.
+ */
+class OrderedReviewClient {
+    constructor(client, store, contract, factory, runtime, transport) {
+        this.client = client;
+        this.store = store;
+        this.factory = factory;
+        this.runtime = runtime;
+        this.transport = transport;
+        this.completed = 0;
+        (0, OrderedSequenceStore_1.validateOrderedContract)(contract);
+        this.contract = JSON.parse(JSON.stringify(contract));
+        const url = new URL(client.getEndpoint());
+        if (url.protocol !== 'http:' || !['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname))
+            throw Error('Ordered rehearsal requires a loopback receiver');
+    }
+    prepareReview() { return this.client.prepareReview(); }
+    captureReviewContext() {
+        return { ...this.client.captureReviewContext(), orderedCaptureContract: JSON.parse(JSON.stringify(this.contract)) };
+    }
+    retainOrderedCapture(candidate) { this.store.append(candidate); }
+    pendingOrderedCandidates() { return this.store.candidates(); }
+    flushOrderedCapture() { this.store.flush(); }
+    getEndpoint() { return this.client.getEndpoint(); }
+    getReviewModelUse(context) { return this.client.getReviewModelUse(context); }
+    getAcceleratorHealth() { return this.health ?? this.client.getAcceleratorHealth(); }
+    getLocalInferenceStats() { return { completed: this.completed }; }
+    async prepare(request) {
+        const ref = request.reviewContext?.orderedSequence;
+        if (!ref || ref.version !== 1 || ref.id !== request.evidenceId || !request.checkpointAnalysis || !request.reviewWindowMs)
+            throw Error('Ordered review requires retained sequence identity and checkpoints');
+        const { job, frames, anchor } = this.store.read(ref.id);
+        if (job.cameraId !== this.contract.cameraId || job.capturedAtMs !== request.capturedAt
+            || (0, ProfileReviewWork_1.reviewContextHash)(anchor.reviewContext) !== (0, ProfileReviewWork_1.reviewContextHash)(request.reviewContext)
+            || !request.jpeg.equals(anchor.jpeg))
+            throw Error('Ordered queue anchor changed');
+        const context = request.reviewContext;
+        if (context.temporalReviewContract || context.producerFields?.length || context.scopedVlmReview?.declaredFieldsOnly !== true)
+            throw Error('Ordered comparison requires declared Gemma questions and no duration/detector aggregation');
+        const scopes = (0, ScopedVlmReview_1.planScopedVlmReview)(context.schema, context.scopedVlmReview, context.regions, context.producerFields);
+        if (scopes.length !== 1)
+            throw Error('Ordered comparison requires one shared region or whole frame');
+        const scope = scopes[0];
+        let saved = request.cachedAnalysis ?? this.store.saved(ref.id);
+        const cached = saved?.orderedReview;
+        if (saved && (cached?.sequenceId !== job.id || cached?.contextSha256 !== job.contextSha256
+            || cached?.anchorSha256 !== frames.at(-1).imageSha256 || cached?.capturedAtMs !== job.capturedAtMs))
+            throw Error('Saved ordered result identity mismatch');
+        if (!saved) {
+            const attempt = (0, crypto_1.randomUUID)().replace(/-/g, '');
+            const priorScope = this.store.savedScope(job.id);
+            let identity = priorScope?.identity;
+            const provider = {
+                analyze: async (input) => {
+                    if (!input.expectedModel)
+                        throw Error('Ordered review requires the selected model pin');
+                    const reviewer = await (0, OrderedFrameReview_1.createOrderedFrameReviewer)({ sequenceId: job.id, cameraId: job.cameraId,
+                        contextSha256: job.contextSha256, frames, region: scope.region, prompt: scope.prompt, schema: scope.schema,
+                        expectedModel: input.expectedModel, runtimeModel: this.runtime.model, baseUrl: this.runtime.baseUrl,
+                        record: receipt => this.store.receipt(job.id, attempt, String(receipt.phase), receipt) }, this.transport);
+                    identity = reviewer.identity;
+                    const result = await reviewer.analyze(input);
+                    this.health = reviewer.getAcceleratorHealth();
+                    this.completed++;
+                    return result;
+                },
+            };
+            const inner = this.factory(provider);
+            if (inner.getEndpoint() !== this.client.getEndpoint())
+                throw Error('Ordered client factory changed the receiver');
+            await inner.reviewCandidate({ ...request, cachedAnalysis: undefined, scopedVlmProgress: priorScope?.progress,
+                checkpointScopedReview: progress => {
+                    if (!identity)
+                        throw Error('Missing ordered scope identity');
+                    this.store.checkpointScope(job.id, progress, identity);
+                }, checkpointAnalysis: result => {
+                    if (!identity)
+                        throw Error('Missing ordered model receipt');
+                    saved = { ...result, orderedReview: { version: 1, kind: 'ordered_frame_rehearsal', sequenceId: job.id,
+                            contextSha256: job.contextSha256, anchorSha256: frames.at(-1).imageSha256,
+                            startedAtMs: job.startedAtMs, capturedAtMs: job.capturedAtMs, frames: identity.frames,
+                            expectedModel: identity.expectedModel, semantics: 'visible_occurrence_in_any_frame',
+                            identitySha256: (0, crypto_1.createHash)('sha256').update(JSON.stringify(identity)).digest('hex') } };
+                    // An archive commit precedes the spool checkpoint. Recovery can reuse it
+                    // if the process exits between those two writes.
+                    this.store.checkpoint(job.id, saved);
+                    request.checkpointAnalysis(saved);
+                } });
+        }
+        else {
+            // Validate the native LocalSensingClient cached-analysis contract too.
+            await this.client.reviewCandidate({ ...request, cachedAnalysis: saved });
+            request.checkpointAnalysis(saved);
+        }
+        if (!saved)
+            throw Error('Missing ordered analysis');
+        return saved;
+    }
+    async reviewCandidate(request) { await this.prepare(request); }
+    async analyze(request) {
+        const saved = await this.prepare(request);
+        const result = await this.client.analyze({ ...request, cachedAnalysis: saved, extra: { ...request.extra, orderedReview: saved.orderedReview } });
+        const body = result.body;
+        if (result.ok && body?.accepted === true && body.evidenceId === request.evidenceId
+            && body.evidenceReview?.capturedAtMs === request.capturedAt)
+            this.store.acknowledge(request.evidenceId);
+        return result;
+    }
+}
+exports.OrderedReviewClient = OrderedReviewClient;
+//# sourceMappingURL=OrderedReviewClient.js.map

package/dist/OrderedReviewClient.js.map

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

package/dist/OrderedSequenceStore.d.ts

@@ -0,0 +1,69 @@
+import type { VlmCandidate } from './VlmCandidateBuffer';
+import type { OrderedEvidenceFrame } from './OrderedFrameReview';
+export interface OrderedCaptureContract {
+    version: 1;
+    cameraId: string;
+    frameCount: number;
+    maxGapMs: number;
+    semantics: 'visible_occurrence_in_any_frame';
+}
+export interface OrderedSequence {
+    version: 1;
+    id: string;
+    cameraId: string;
+    contextSha256: string;
+    frameIds: string[];
+    capturedAtMs: number;
+    startedAtMs: number;
+}
+export declare function validateOrderedContract(c: OrderedCaptureContract): void;
+/** Single-owner local archive. Originals commit BEFORE queue admission. A queue
+ * refusal is retried from this archive; acknowledgement is the only terminal state.
+ * All disk use is bounded. No automatic deletion of unsent or incomplete evidence.
+ * The experiment launcher must hold its existing exclusive host lock.
+ */
+export declare class OrderedSequenceStore {
+    private readonly directory;
+    private readonly maxCaptures;
+    private readonly maxBytes;
+    private tail;
+    private pending;
+    private captureCount;
+    private diskBytes;
+    private lastCapture;
+    private incomplete;
+    private captureFault;
+    constructor(directory: string, maxCaptures?: number, maxBytes?: number);
+    private file;
+    private load;
+    private write;
+    private captureName;
+    private validateCapture;
+    append(candidate: VlmCandidate): void;
+    private group;
+    /** Flush an end-of-clip window of 2+; a singleton stays visibly incomplete. */
+    flush(): void;
+    private closeTail;
+    read(id: string): {
+        job: OrderedSequence;
+        frames: OrderedEvidenceFrame[];
+        anchor: VlmCandidate;
+    };
+    candidates(): VlmCandidate[];
+    receipt(id: string, attempt: string, phase: string, value: unknown): void;
+    saved(id: string): Record<string, unknown> | undefined;
+    savedScope(id: string): {
+        progress: any;
+        identity: any;
+    } | undefined;
+    checkpointScope(id: string, progress: unknown, identity: unknown): void;
+    checkpoint(id: string, result: Record<string, unknown>): void;
+    acknowledge(id: string): void;
+    stats(): {
+        captures: number;
+        pendingSequences: number;
+        incompleteFrames: number;
+        bytes: number;
+    };
+}
+//# sourceMappingURL=OrderedSequenceStore.d.ts.map

package/dist/OrderedSequenceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderedSequenceStore.d.ts","sourceRoot":"","sources":["../src/OrderedSequenceStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IACnE,SAAS,EAAE,iCAAiC,CAAC;CAC9C;AAKD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAC,CAAC,CAAC;IAAC,EAAE,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,EAAE,CAAC;IAC/E,YAAY,EAAC,MAAM,CAAC;IAAC,WAAW,EAAC,MAAM,CAAC;CACzC;AAKD,wBAAgB,uBAAuB,CAAC,CAAC,EAAC,sBAAsB,GAAE,IAAI,CAKrE;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAS,OAAO,CAAC,QAAQ,CAAC,WAAW;IACzE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAAG;IACvB,OAAO,CAAC,SAAS,CAAG;IACpB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,YAAY,CAAO;gBACE,SAAS,EAAC,MAAM,EAAmB,WAAW,SAAQ,EAChE,QAAQ,SAAU;IAuBrC,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,eAAe;IAWvB,MAAM,CAAC,SAAS,EAAC,YAAY,GAAE,IAAI;IAmBnC,OAAO,CAAC,KAAK;IASb,+EAA+E;IAC/E,KAAK,IAAG,IAAI;IACZ,OAAO,CAAC,SAAS;IAWjB,IAAI,CAAC,EAAE,EAAC,MAAM,GAAE;QAAC,GAAG,EAAC,eAAe,CAAC;QAAC,MAAM,EAAC,oBAAoB,EAAE,CAAC;QAAC,MAAM,EAAC,YAAY,CAAA;KAAC;IAgBzF,UAAU,IAAG,YAAY,EAAE;IAG3B,OAAO,CAAC,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,KAAK,EAAC,OAAO,GAAE,IAAI;IAIjE,KAAK,CAAC,EAAE,EAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC,GAAC,SAAS;IAIjD,UAAU,CAAC,EAAE,EAAC,MAAM,GAAE;QAAC,QAAQ,EAAC,GAAG,CAAC;QAAA,QAAQ,EAAC,GAAG,CAAA;KAAC,GAAC,SAAS;IAI3D,eAAe,CAAC,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,OAAO,EAAC,QAAQ,EAAC,OAAO,GAAE,IAAI;IAIjE,UAAU,CAAC,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC,GAAE,IAAI;IACxD,WAAW,CAAC,EAAE,EAAC,MAAM,GAAE,IAAI;IAC3B,KAAK;;;;;;CACN"}

package/dist/OrderedSequenceStore.js

@@ -0,0 +1,257 @@
+"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.OrderedSequenceStore = void 0;
+exports.validateOrderedContract = validateOrderedContract;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+const ProfileReviewWork_1 = require("./ProfileReviewWork");
+const jpegFrameSize_1 = require("./jpegFrameSize");
+const sha = (x) => (0, crypto_1.createHash)('sha256').update(JSON.stringify(x)).digest('hex');
+const bytesHash = (b) => (0, crypto_1.createHash)('sha256').update(b).digest('hex');
+const clone = (x) => JSON.parse(JSON.stringify(x));
+const idPattern = /^[a-f0-9]{32}$/;
+function validateOrderedContract(c) {
+    if (!c || c.version !== 1 || !/^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$/.test(c.cameraId)
+        || !Number.isSafeInteger(c.frameCount) || c.frameCount < 2 || c.frameCount > 5
+        || !Number.isSafeInteger(c.maxGapMs) || c.maxGapMs < 1 || c.maxGapMs > 5000
+        || c.semantics !== 'visible_occurrence_in_any_frame')
+        throw Error('Invalid ordered capture contract');
+}
+/** Single-owner local archive. Originals commit BEFORE queue admission. A queue
+ * refusal is retried from this archive; acknowledgement is the only terminal state.
+ * All disk use is bounded. No automatic deletion of unsent or incomplete evidence.
+ * The experiment launcher must hold its existing exclusive host lock.
+ */
+class OrderedSequenceStore {
+    constructor(directory, maxCaptures = 100000, maxBytes = 8 * 1024 ** 3) {
+        this.directory = directory;
+        this.maxCaptures = maxCaptures;
+        this.maxBytes = maxBytes;
+        this.tail = [];
+        this.pending = new Map();
+        this.captureCount = 0;
+        this.diskBytes = 0;
+        this.incomplete = new Set();
+        this.captureFault = false;
+        if (!Number.isSafeInteger(maxCaptures) || maxCaptures < 1 || maxCaptures > 100000
+            || !Number.isSafeInteger(maxBytes) || maxBytes < 1)
+            throw Error('Invalid ordered archive capacity');
+        fs.mkdirSync(directory, { recursive: true });
+        const names = fs.readdirSync(directory);
+        this.diskBytes = names.reduce((n, f) => n + fs.statSync(path.join(directory, f)).size, 0);
+        const assigned = new Set();
+        for (const name of names.filter(n => /^job-[a-f0-9]{32}\.json$/.test(n))) {
+            const job = this.load(name);
+            if (!idPattern.test(job.id) || job.version !== 1 || job.frameIds.length < 2 || job.frameIds.length > 5)
+                throw Error('Corrupt sequence manifest');
+            for (const id of job.frameIds) {
+                if (assigned.has(id))
+                    throw Error('Frame assigned to multiple sequences');
+                assigned.add(id);
+            }
+            if (!fs.existsSync(this.file('ack-' + job.id + '.json')))
+                this.pending.set(job.id, job);
+            else {
+                const ack = this.load('ack-' + job.id + '.json');
+                if (ack.id !== job.id)
+                    throw Error('Corrupt sequence acknowledgement');
+            }
+        }
+        // Only metadata/tail is kept in memory; image payloads stay on disk.
+        for (const name of names.filter(n => /^capture-\d{16}-[a-f0-9]{32}\.json$/.test(n)).sort()) {
+            const capture = this.load(name);
+            this.captureCount++;
+            this.validateCapture(capture);
+            this.lastCapture = capture;
+            this.write('index-' + capture.id + '.json', { name });
+            if (assigned.has(capture.id)) {
+                this.closeTail();
+                continue;
+            }
+            this.group(capture);
+        }
+    }
+    file(name) { if (!/^[a-zA-Z0-9_.-]+$/.test(name))
+        throw Error('Invalid archive key'); return path.join(this.directory, name); }
+    load(name) {
+        const envelope = JSON.parse(fs.readFileSync(this.file(name), 'utf8'));
+        if (!envelope.value || envelope.sha256 !== sha(envelope.value))
+            throw Error('Corrupt ordered archive');
+        return envelope.value;
+    }
+    write(name, value) {
+        const target = this.file(name), text = JSON.stringify({ value, sha256: sha(value) }) + '\n';
+        if (fs.existsSync(target)) {
+            if (sha(this.load(name)) !== sha(value))
+                throw Error('Ordered archive identity changed');
+            return;
+        }
+        const size = Buffer.byteLength(text);
+        if (this.diskBytes + size > this.maxBytes)
+            throw Error('Ordered archive full; existing evidence retained');
+        const temp = this.file('.pending-' + (0, crypto_1.randomUUID)()), fd = fs.openSync(temp, 'wx');
+        try {
+            fs.writeFileSync(fd, text);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fs.renameSync(temp, target);
+        this.diskBytes += size;
+    }
+    captureName(c) { return 'capture-' + String(c.capturedAtMs).padStart(16, '0') + '-' + c.id + '.json'; }
+    validateCapture(c) {
+        const contract = c.candidate.reviewContext?.orderedCaptureContract;
+        validateOrderedContract(contract);
+        const jpeg = Buffer.from(c.imageBase64, 'base64'), size = (0, jpegFrameSize_1.readJpegFrameSize)(jpeg);
+        if (c.candidate.name !== contract.cameraId || (0, ProfileReviewWork_1.reviewContextHash)(c.candidate.reviewContext) !== c.contextSha256
+            || bytesHash(jpeg) !== c.imageSha256 || !size || size.width * size.height > 16777216
+            || c.shape !== size.width + 'x' + size.height || jpeg.length < 4 || jpeg.readUInt16BE(jpeg.length - 2) !== 0xffd9
+            || !Number.isSafeInteger(c.capturedAtMs) || c.capturedAtMs < 0 || c.candidate.enqueuedAtMs !== c.capturedAtMs
+            || c.id !== sha({ camera: c.candidate.name, context: c.contextSha256, time: c.capturedAtMs }).slice(0, 32))
+            throw Error('Invalid retained ordered frame');
+    }
+    append(candidate) {
+        if (this.captureFault)
+            throw Error('Ordered capture storage failed; restart recovery required');
+        const { jpeg, ...meta } = candidate, contextSha256 = (0, ProfileReviewWork_1.reviewContextHash)(candidate.reviewContext);
+        const size = (0, jpegFrameSize_1.readJpegFrameSize)(jpeg);
+        const capture = { id: sha({ camera: candidate.name, context: contextSha256, time: candidate.enqueuedAtMs }).slice(0, 32),
+            contextSha256, imageSha256: bytesHash(jpeg), capturedAtMs: candidate.enqueuedAtMs, shape: size ? size.width + 'x' + size.height : '',
+            candidate: clone(meta), imageBase64: jpeg.toString('base64') };
+        this.validateCapture(capture);
+        if (this.lastCapture && capture.capturedAtMs <= this.lastCapture.capturedAtMs) {
+            if (capture.id === this.lastCapture.id && sha(capture) === sha(this.lastCapture))
+                return;
+            throw Error('Ordered capture requires increasing timestamps');
+        }
+        if (this.captureCount >= this.maxCaptures)
+            throw Error('Ordered capture limit reached; existing evidence retained');
+        try {
+            this.write(this.captureName(capture), capture);
+            this.write('index-' + capture.id + '.json', { name: this.captureName(capture) });
+            this.captureCount++;
+            this.lastCapture = capture;
+            this.group(capture);
+        }
+        catch (error) {
+            this.captureFault = true;
+            throw error;
+        }
+    }
+    group(c) {
+        const contract = c.candidate.reviewContext.orderedCaptureContract, last = this.tail.at(-1), first = this.tail[0];
+        if (last && (last.candidate.name !== c.candidate.name || last.contextSha256 !== c.contextSha256 || last.shape !== c.shape
+            || c.capturedAtMs - last.capturedAtMs > contract.maxGapMs || c.capturedAtMs - first.capturedAtMs > 5000
+            || this.tail.reduce((n, f) => n + Buffer.byteLength(f.imageBase64, 'base64'), 0) + Buffer.byteLength(c.imageBase64, 'base64') > 16 * 1024 ** 2))
+            this.closeTail();
+        this.tail.push(c);
+        if (this.tail.length >= contract.frameCount)
+            this.closeTail();
+    }
+    /** Flush an end-of-clip window of 2+; a singleton stays visibly incomplete. */
+    flush() { if (this.tail.length >= 2)
+        this.closeTail(); }
+    closeTail() {
+        if (!this.tail.length)
+            return;
+        if (this.tail.length === 1) {
+            this.incomplete.add(this.tail[0].id);
+            this.tail = [];
+            return;
+        }
+        const frames = this.tail, first = frames[0], last = frames.at(-1);
+        const frameIds = frames.map(f => f.id), id = sha({ context: first.contextSha256, frameIds }).slice(0, 32);
+        const job = { version: 1, id, cameraId: first.candidate.name, contextSha256: first.contextSha256, frameIds,
+            startedAtMs: first.capturedAtMs, capturedAtMs: last.capturedAtMs };
+        this.write('job-' + id + '.json', job);
+        if (!fs.existsSync(this.file('ack-' + id + '.json')))
+            this.pending.set(id, job);
+        this.tail = [];
+    }
+    read(id) {
+        if (!idPattern.test(id))
+            throw Error('Invalid sequence ID');
+        const job = this.load('job-' + id + '.json');
+        const frames = job.frameIds.map(frameId => {
+            // Manifests include frame IDs, with the small timestamp index persisted separately below.
+            const index = this.load('index-' + frameId + '.json');
+            const c = this.load(index.name);
+            this.validateCapture(c);
+            return c;
+        });
+        if (frames.some(f => f.contextSha256 !== job.contextSha256 || f.candidate.name !== job.cameraId)
+            || frames[0].capturedAtMs !== job.startedAtMs || frames.at(-1).capturedAtMs !== job.capturedAtMs)
+            throw Error('Sequence context mismatch');
+        const last = frames.at(-1);
+        return { job, frames: frames.map(f => ({ evidenceId: f.id, cameraId: job.cameraId, contextSha256: job.contextSha256,
+                capturedAtMs: f.capturedAtMs, imageSha256: f.imageSha256, jpeg: Buffer.from(f.imageBase64, 'base64') })),
+            anchor: { ...clone(last.candidate), jpeg: Buffer.from(last.imageBase64, 'base64'),
+                retainedId: id, reviewContext: { ...clone(last.candidate.reviewContext), orderedSequence: { version: 1, id, contextSha256: job.contextSha256 } } } };
+    }
+    candidates() {
+        return [...this.pending.values()].sort((a, b) => a.capturedAtMs - b.capturedAtMs).slice(0, 16).map(j => this.read(j.id).anchor);
+    }
+    receipt(id, attempt, phase, value) {
+        if (!idPattern.test(id) || !idPattern.test(attempt) || !['prepared', 'request', 'response', 'complete', 'failed'].includes(phase))
+            throw Error('Invalid sequence receipt');
+        this.write('receipt-' + id + '-' + attempt + '-' + phase + '.json', value);
+    }
+    saved(id) {
+        if (!idPattern.test(id))
+            throw Error('Invalid sequence ID');
+        return fs.existsSync(this.file('result-' + id + '.json')) ? this.load('result-' + id + '.json') : undefined;
+    }
+    savedScope(id) {
+        if (!idPattern.test(id))
+            throw Error('Invalid sequence ID');
+        return fs.existsSync(this.file('scope-' + id + '.json')) ? this.load('scope-' + id + '.json') : undefined;
+    }
+    checkpointScope(id, progress, identity) {
+        if (!idPattern.test(id))
+            throw Error('Invalid sequence ID');
+        this.write('scope-' + id + '.json', { progress, identity });
+    }
+    checkpoint(id, result) { if (!idPattern.test(id))
+        throw Error('Invalid sequence ID'); this.write('result-' + id + '.json', result); }
+    acknowledge(id) { if (!idPattern.test(id))
+        throw Error('Invalid sequence ID'); this.write('ack-' + id + '.json', { id }); this.pending.delete(id); }
+    stats() { return { captures: this.captureCount, pendingSequences: this.pending.size, incompleteFrames: this.incomplete.size + this.tail.length, bytes: this.diskBytes }; }
+}
+exports.OrderedSequenceStore = OrderedSequenceStore;
+//# sourceMappingURL=OrderedSequenceStore.js.map

package/dist/OrderedSequenceStore.js.map

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

package/dist/ProfileReviewWork.d.ts

@@ -0,0 +1,68 @@
+import type { FrameGroupingDecision } from './FrameGroupingShadow';
+import type { ProducedFieldSet } from './DetectorFieldProducer';
+/** Shared field answers; a whole-image classifier need not fabricate detection classes or boxes. */
+export interface ProfileFieldSet {
+    produced: Array<Pick<ProducedFieldSet['produced'][number], 'field' | 'modelId' | 'value'>>;
+    withheld: Array<{
+        field: string;
+        modelId: string;
+        reason: string;
+        detail?: string;
+    }>;
+}
+/** Local experiment. A question's selection is not an answer to that question. */
+export interface ProfileReviewWork {
+    version: 1;
+    mode: 'shadow';
+    contextSha256: string;
+    imageSha256: string;
+    capturedAtMs: number;
+    items: Array<{
+        field: string;
+        producer: 'vlm' | 'detector' | 'unresolved';
+        selected: boolean;
+        reason: string;
+        referenceSha256?: string;
+        referenceCapturedAtMs?: number;
+        /** Only set by the spool after the referenced original is committed. */
+        referenceEvidenceId?: string;
+    }>;
+}
+export declare const reviewContextHash: (context: Record<string, unknown> | undefined) => string;
+export declare function promoteProfileDependencies(work: ProfileReviewWork): void;
+/** Each lasso affects its own field. A full-frame question does not select the other fields. */
+export declare function planProfileReview(context: Record<string, unknown> | undefined, grouping: FrameGroupingDecision): ProfileReviewWork | undefined;
+export declare function validateProfileWork(work: ProfileReviewWork, context: Record<string, unknown>, sha256: string, capturedAtMs: number): void;
+export interface ProfileWorkResult {
+    version: 1;
+    /** Deliberately incompatible with SavedLocalAnalysis: never upload as a complete observation. */
+    kind: 'profile_work_rehearsal';
+    evidenceId: string;
+    imageSha256: string;
+    contextSha256: string;
+    capturedAtMs: number;
+    reviewedAtMs: number;
+    selectedFields: string[];
+    unreviewedFields: string[];
+    structured: Record<string, unknown>;
+    unresolvedFields: string[];
+    modelCalls: {
+        vlm: number;
+        producerBatches: number;
+    };
+}
+/** Runs due questions together using existing model adapters; it has no upload capability. */
+export declare function reviewProfileBatch(input: {
+    jpeg: Buffer;
+    evidenceId: string;
+    capturedAtMs: number;
+    context: Record<string, unknown>;
+    work: ProfileReviewWork;
+    analyze: (request: {
+        jpeg: Buffer;
+        schema: Record<string, unknown>;
+        prompt: string;
+    }) => Promise<Record<string, unknown>>;
+    produce: (fields: any[]) => Promise<ProfileFieldSet>;
+}): Promise<ProfileWorkResult>;
+//# sourceMappingURL=ProfileReviewWork.d.ts.map

package/dist/ProfileReviewWork.d.ts.map

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