@once-agent/sdk 0.1.5 → 0.1.7

package/dist/connect/execute.js

@@ -0,0 +1,47 @@
+import { CONNECT_DECISION, classifyConnectOperation, } from "./classifier.js";
+import { bindConnectOperation, } from "./binding.js";
+export class ConnectExecutionError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "ConnectExecutionError";
+        this.code = code;
+    }
+}
+/**
+ * Framework-neutral Connect orchestration boundary.
+ *
+ * Connect decides whether the proposed tool call requires
+ * Once protection. It does not implement execution safety.
+ *
+ * Protected execution is delegated to the existing Once
+ * runtime/kernel supplied by the caller.
+ */
+export async function executeConnectOperation({ safety, operationId, payload, bypass, protect, }) {
+    const classification = classifyConnectOperation(safety);
+    if (classification.decision ===
+        CONNECT_DECISION.REJECT) {
+        throw new ConnectExecutionError("Once Connect rejected an incomplete or invalid safety declaration.", "CONNECT_REJECTED");
+    }
+    if (classification.decision ===
+        CONNECT_DECISION.BYPASS) {
+        if (typeof bypass !== "function") {
+            throw new ConnectExecutionError("Once Connect bypass execution is unavailable.", "BYPASS_HANDLER_MISSING");
+        }
+        return await bypass();
+    }
+    const binding = bindConnectOperation({
+        operationId,
+        payload,
+    });
+    if (typeof protect !== "function") {
+        throw new ConnectExecutionError("Once Connect protected execution is unavailable.", "PROTECT_HANDLER_MISSING");
+    }
+    return await protect({
+        operationId: binding.operationId,
+        payload,
+        payloadFingerprint: binding.payloadFingerprint,
+        classification,
+    });
+}
+//# sourceMappingURL=execute.js.map

package/dist/connect/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/connect/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAuBtB,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,CAAS;IAEtB,YACE,OAAe,EACf,IAAY;QAEZ,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAc,EACzD,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,OAAO,GACkB;IACzB,MAAM,cAAc,GAClB,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEnC,IACE,cAAc,CAAC,QAAQ;QACvB,gBAAgB,CAAC,MAAM,EACvB,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,oEAAoE,EACpE,kBAAkB,CACnB,CAAC;IACJ,CAAC;IAED,IACE,cAAc,CAAC,QAAQ;QACvB,gBAAgB,CAAC,MAAM,EACvB,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,qBAAqB,CAC7B,+CAA+C,EAC/C,wBAAwB,CACzB,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,OAAO,GACX,oBAAoB,CAAC;QACnB,WAAW;QACX,OAAO;KACR,CAAC,CAAC;IAEL,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,qBAAqB,CAC7B,kDAAkD,EAClD,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,OAAO,CAAC;QACnB,WAAW,EACT,OAAO,CAAC,WAAW;QAErB,OAAO;QAEP,kBAAkB,EAChB,OAAO,CAAC,kBAAkB;QAE5B,cAAc;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/connect/kernel.d.ts

@@ -0,0 +1,33 @@
+import { ConnectExecutionError } from "./execute.js";
+import type { ConnectSafetyDeclaration } from "./classifier.js";
+import type { ConnectPayload } from "./binding.js";
+interface OnceConnectClient {
+    execute(input: {
+        operationId: string;
+        provider: string;
+        action: Record<string, unknown>;
+    }): Promise<unknown>;
+}
+export interface ConnectKernelInput<T = unknown> {
+    once: OnceConnectClient | null | undefined;
+    provider: string;
+    safety: ConnectSafetyDeclaration;
+    operationId: string;
+    payload: ConnectPayload;
+    action: Record<string, unknown> | null;
+    bypass?: () => Promise<T> | T;
+}
+export declare class ConnectKernelError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Route a proposed tool operation through Connect and, when protection
+ * is required, through the existing authoritative Once.execute() kernel.
+ *
+ * This adapter deliberately contains no execution-state machine,
+ * replay logic, reconciliation logic, or truth semantics.
+ */
+export declare function executeConnectWithOnce<T = unknown>({ once, provider, safety, operationId, payload, action, bypass, }: ConnectKernelInput<T>): Promise<T | unknown>;
+export { ConnectExecutionError, };
+//# sourceMappingURL=kernel.d.ts.map

package/dist/connect/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/connect/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,UAAU,iBAAiB;IACzB,OAAO,CAAC,KAAK,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,wBAAwB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAC/B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM;CAMf;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAAE,EACxD,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,MAAM,GACP,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAkD9C;AAED,OAAO,EACL,qBAAqB,GACtB,CAAC"}

package/dist/connect/kernel.js

@@ -0,0 +1,46 @@
+import { executeConnectOperation, ConnectExecutionError, } from "./execute.js";
+export class ConnectKernelError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "ConnectKernelError";
+        this.code = code;
+    }
+}
+/**
+ * Route a proposed tool operation through Connect and, when protection
+ * is required, through the existing authoritative Once.execute() kernel.
+ *
+ * This adapter deliberately contains no execution-state machine,
+ * replay logic, reconciliation logic, or truth semantics.
+ */
+export async function executeConnectWithOnce({ once, provider, safety, operationId, payload, action, bypass, }) {
+    if (!once ||
+        typeof once.execute !== "function") {
+        throw new ConnectKernelError("Once Connect requires an existing Once client.", "ONCE_CLIENT_REQUIRED");
+    }
+    return executeConnectOperation({
+        safety,
+        operationId,
+        payload,
+        bypass,
+        protect: async (context) => {
+            if (typeof provider !== "string" ||
+                provider.trim() === "") {
+                throw new ConnectKernelError("Protected Connect execution requires a Once provider.", "PROVIDER_REQUIRED");
+            }
+            if (action === null ||
+                typeof action !== "object" ||
+                Array.isArray(action)) {
+                throw new ConnectKernelError("Protected Connect execution requires an action object.", "ACTION_REQUIRED");
+            }
+            return once.execute({
+                operationId: context.operationId,
+                provider,
+                action,
+            });
+        },
+    });
+}
+export { ConnectExecutionError, };
+//# sourceMappingURL=kernel.js.map

package/dist/connect/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../../src/connect/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AA4BtB,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAS;IAEtB,YACE,OAAe,EACf,IAAY;QAEZ,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAc,EACxD,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,MAAM,GACgB;IACtB,IACE,CAAC,IAAI;QACL,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,EAClC,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,gDAAgD,EAChD,sBAAsB,CACvB,CAAC;IACJ,CAAC;IAED,OAAO,uBAAuB,CAAc;QAC1C,MAAM;QACN,WAAW;QACX,OAAO;QAEP,MAAM;QAEN,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,IACE,OAAO,QAAQ,KAAK,QAAQ;gBAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EACtB,CAAC;gBACD,MAAM,IAAI,kBAAkB,CAC1B,uDAAuD,EACvD,mBAAmB,CACpB,CAAC;YACJ,CAAC;YAED,IACE,MAAM,KAAK,IAAI;gBACf,OAAO,MAAM,KAAK,QAAQ;gBAC1B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACrB,CAAC;gBACD,MAAM,IAAI,kBAAkB,CAC1B,wDAAwD,EACxD,iBAAiB,CAClB,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,WAAW,EACT,OAAO,CAAC,WAAW;gBAErB,QAAQ;gBAER,MAAM;aACP,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,qBAAqB,GACtB,CAAC"}

package/dist/connect/openai-agents.d.ts

@@ -0,0 +1,31 @@
+import type { ConnectSafetyDeclaration } from "./classifier.js";
+import type { Once } from "../index.js";
+export type OpenAIAgentsToolInput = Record<string, unknown>;
+export type OpenAIAgentsAction = Record<string, unknown>;
+export interface OpenAIAgentsConnectToolInput {
+    once: Once;
+    provider: string;
+    safety: ConnectSafetyDeclaration;
+    operationId: string;
+    input: OpenAIAgentsToolInput;
+    action: OpenAIAgentsAction;
+    bypass?: () => unknown | Promise<unknown>;
+}
+export declare class OpenAIAgentsConnectError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Minimal OpenAI Agents -> Once Connect execution adapter.
+ *
+ * This adapter owns no execution-safety state machine.
+ * It validates the framework boundary and delegates to
+ * the existing Connect -> Once kernel.
+ *
+ * OpenAI tool-call IDs are intentionally not used as
+ * logical operation identity. The caller must provide a
+ * stable operationId representing the same real-world
+ * logical operation across retries.
+ */
+export declare function executeOpenAIAgentsConnectTool({ once, provider, safety, operationId, input, action, bypass, }: OpenAIAgentsConnectToolInput): Promise<unknown>;
+//# sourceMappingURL=openai-agents.d.ts.map

package/dist/connect/openai-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-agents.d.ts","sourceRoot":"","sources":["../../src/connect/openai-agents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,IAAI,EACL,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,qBAAqB,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,MAAM,kBAAkB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,wBAAwB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM;CAMf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,8BAA8B,CAClD,EACE,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,KAAK,EACL,MAAM,EACN,MAAM,GACP,EAAE,4BAA4B,GAC9B,OAAO,CAAC,OAAO,CAAC,CA2BlB"}

package/dist/connect/openai-agents.js

@@ -0,0 +1,42 @@
+import { executeConnectWithOnce, } from "./kernel.js";
+export class OpenAIAgentsConnectError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "OpenAIAgentsConnectError";
+        this.code = code;
+    }
+}
+/**
+ * Minimal OpenAI Agents -> Once Connect execution adapter.
+ *
+ * This adapter owns no execution-safety state machine.
+ * It validates the framework boundary and delegates to
+ * the existing Connect -> Once kernel.
+ *
+ * OpenAI tool-call IDs are intentionally not used as
+ * logical operation identity. The caller must provide a
+ * stable operationId representing the same real-world
+ * logical operation across retries.
+ */
+export async function executeOpenAIAgentsConnectTool({ once, provider, safety, operationId, input, action, bypass, }) {
+    if (input === null ||
+        typeof input !== "object" ||
+        Array.isArray(input)) {
+        throw new OpenAIAgentsConnectError("Once Connect requires parsed OpenAI Agents tool input.", "INVALID_OPENAI_TOOL_INPUT");
+    }
+    return await executeConnectWithOnce({
+        once,
+        provider,
+        safety,
+        operationId,
+        /*
+         * Parsed consequential tool input becomes the payload
+         * bound to the stable logical operation identity.
+         */
+        payload: input,
+        action,
+        bypass,
+    });
+}
+//# sourceMappingURL=openai-agents.js.map

package/dist/connect/openai-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-agents.js","sourceRoot":"","sources":["../../src/connect/openai-agents.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GACvB,MAAM,aAAa,CAAC;AA0BrB,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,CAAS;IAEtB,YACE,OAAe,EACf,IAAY;QAEZ,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,EACE,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,KAAK,EACL,MAAM,EACN,MAAM,GACuB;IAE/B,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,wBAAwB,CAChC,wDAAwD,EACxD,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,sBAAsB,CAAC;QAClC,IAAI;QACJ,QAAQ;QACR,MAAM;QACN,WAAW;QAEX;;;WAGG;QACH,OAAO,EAAE,KAAK;QAEd,MAAM;QACN,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/dataset-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=dataset-cli.d.ts.map

package/dist/dataset-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-cli.d.ts","sourceRoot":"","sources":["../src/dataset-cli.ts"],"names":[],"mappings":""}

package/dist/dataset-cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { runDatasetSeal } from "./dataset.js";
+import { runDatasetProgress } from "./dataset-progress.js";
+function argumentValue(args, prefix) {
+    const value = args.find(argument => argument.startsWith(prefix));
+    return value?.substring(prefix.length);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const command = (args.shift() ?? "").toLowerCase();
+    if (command === "progress") {
+        const tracePath = args.find(value => !value.startsWith("--"));
+        if (!tracePath) {
+            throw new Error("dataset progress requires a source JSONL trace path.");
+        }
+        const preregistrationPath = argumentValue(args, "--prereg=");
+        if (!preregistrationPath) {
+            throw new Error("dataset progress requires --prereg=<path>; stopping criteria must come from the preregistered protocol.");
+        }
+        await runDatasetProgress(tracePath, preregistrationPath);
+        return;
+    }
+    if (command !== "seal") {
+        throw new Error("Usage:\n  once-dataset progress <trace.jsonl> --prereg=<preregistration.json>\n  once-dataset seal <trace.jsonl> --collector-commit=<git-sha> [--id=001] [--out=.once/datasets]");
+    }
+    const tracePath = args.find(value => !value.startsWith("--"));
+    if (!tracePath) {
+        throw new Error("dataset seal requires a source JSONL trace path.");
+    }
+    const collectorGitCommit = argumentValue(args, "--collector-commit=");
+    if (!collectorGitCommit) {
+        throw new Error("dataset seal requires --collector-commit=<git-sha>; provenance must be explicit, never inferred later.");
+    }
+    await runDatasetSeal(tracePath, {
+        datasetId: argumentValue(args, "--id="),
+        outputDirectory: argumentValue(args, "--out="),
+        collectorGitCommit
+    });
+}
+try {
+    await main();
+}
+catch (error) {
+    console.error("");
+    console.error("Once dataset command failed.");
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=dataset-cli.js.map

package/dist/dataset-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-cli.js","sourceRoot":"","sources":["../src/dataset-cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,SAAS,aAAa,CACpB,IAAc,EACd,MAAc;IAEd,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,OAAO,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAEnD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,mBAAmB,GAAG,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7D,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;QACJ,CAAC;QAED,MAAM,kBAAkB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,iLAAiL,CAClL,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IACtE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,CAAC,SAAS,EAAE;QAC9B,SAAS,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;QACvC,eAAe,EAAE,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC9C,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC;AAED,IAAI,CAAC;IACH,MAAM,IAAI,EAAE,CAAC;AACf,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/dataset-progress.d.ts

@@ -0,0 +1,16 @@
+export interface DatasetProgress {
+    dataset_id: string;
+    observations: number;
+    minimum_observations: number;
+    eligible_repeated_observations: number;
+    minimum_eligible_repeated_observations: number;
+    unique_resources: number;
+    minimum_unique_resources: number;
+    collection_days: number;
+    minimum_collection_days: number;
+    once_decision_count: 0;
+    stop_rule_satisfied: boolean;
+}
+export declare function datasetProgress(tracePath: string, preregistrationPath: string): Promise<DatasetProgress>;
+export declare function runDatasetProgress(tracePath: string, preregistrationPath: string): Promise<DatasetProgress>;
+//# sourceMappingURL=dataset-progress.d.ts.map

package/dist/dataset-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-progress.d.ts","sourceRoot":"","sources":["../src/dataset-progress.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8BAA8B,EAAE,MAAM,CAAC;IACvC,sCAAsC,EAAE,MAAM,CAAC;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,CAAC,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAwID,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,eAAe,CAAC,CAoD1B;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,eAAe,CAAC,CA6B1B"}

package/dist/dataset-progress.js

@@ -0,0 +1,130 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+function finiteNonNegativeInteger(value, field) {
+    if (typeof value !== "number" ||
+        !Number.isInteger(value) ||
+        value < 0) {
+        throw new Error(`Invalid preregistration field: ${field}`);
+    }
+    return value;
+}
+function parseTimestamp(value, field) {
+    if (typeof value !== "string") {
+        throw new Error(`Invalid timestamp field: ${field}`);
+    }
+    const parsed = Date.parse(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`Invalid timestamp field: ${field}`);
+    }
+    return parsed;
+}
+async function readPreregistration(preregistrationPath) {
+    const raw = await readFile(resolve(preregistrationPath), "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.schema_version !== "once-dataset-preregistration-v1" ||
+        typeof parsed.dataset_id !== "string" ||
+        typeof parsed.collection_start !== "string" ||
+        !parsed.stopping_rule ||
+        parsed.stopping_rule.type !== "all_conditions_must_be_met" ||
+        parsed.stopping_rule.outcome_dependent_stopping !== false) {
+        throw new Error("Unsupported or invalid dataset preregistration.");
+    }
+    finiteNonNegativeInteger(parsed.stopping_rule.minimum_observations, "minimum_observations");
+    finiteNonNegativeInteger(parsed.stopping_rule.minimum_eligible_repeated_observations, "minimum_eligible_repeated_observations");
+    finiteNonNegativeInteger(parsed.stopping_rule.minimum_unique_resources, "minimum_unique_resources");
+    if (typeof parsed.stopping_rule.minimum_collection_days !== "number" ||
+        !Number.isFinite(parsed.stopping_rule.minimum_collection_days) ||
+        parsed.stopping_rule.minimum_collection_days < 0) {
+        throw new Error("Invalid preregistration field: minimum_collection_days");
+    }
+    parseTimestamp(parsed.collection_start, "collection_start");
+    return parsed;
+}
+async function readStructuralObservations(tracePath) {
+    const raw = await readFile(resolve(tracePath), "utf8");
+    const lines = raw
+        .split(/\r?\n/u)
+        .filter(line => line.trim().length > 0);
+    if (lines.length === 0) {
+        throw new Error("Dataset progress requires a non-empty trace.");
+    }
+    const resources = new Set();
+    let repeats = 0;
+    let latestTimestamp = Number.NEGATIVE_INFINITY;
+    let onceDecisionCount = 0;
+    for (let index = 0; index < lines.length; index += 1) {
+        const observation = JSON.parse(lines[index]);
+        if (typeof observation.resource !== "string" ||
+            observation.resource.length === 0) {
+            throw new Error(`Invalid resource on observation ${index + 1}.`);
+        }
+        const timestamp = parseTimestamp(observation.timestamp, `observation ${index + 1}`);
+        latestTimestamp = Math.max(latestTimestamp, timestamp);
+        if (resources.has(observation.resource)) {
+            repeats += 1;
+        }
+        else {
+            resources.add(observation.resource);
+        }
+        if (observation.once_decision !== undefined) {
+            onceDecisionCount += 1;
+        }
+    }
+    if (onceDecisionCount > 0) {
+        throw new Error(`Refusing blind progress: found ${onceDecisionCount} observation(s) containing once_decision.`);
+    }
+    return {
+        observations: lines.length,
+        uniqueResources: resources.size,
+        eligibleRepeatedObservations: repeats,
+        latestTimestamp
+    };
+}
+export async function datasetProgress(tracePath, preregistrationPath) {
+    const preregistration = await readPreregistration(preregistrationPath);
+    const structural = await readStructuralObservations(tracePath);
+    const collectionStart = parseTimestamp(preregistration.collection_start, "collection_start");
+    if (structural.latestTimestamp < collectionStart) {
+        throw new Error("Latest observation predates the preregistered collection start.");
+    }
+    const collectionDays = (structural.latestTimestamp - collectionStart) /
+        86_400_000;
+    const minimumObservations = finiteNonNegativeInteger(preregistration.stopping_rule.minimum_observations, "minimum_observations");
+    const minimumRepeated = finiteNonNegativeInteger(preregistration.stopping_rule.minimum_eligible_repeated_observations, "minimum_eligible_repeated_observations");
+    const minimumUnique = finiteNonNegativeInteger(preregistration.stopping_rule.minimum_unique_resources, "minimum_unique_resources");
+    const minimumDays = preregistration.stopping_rule.minimum_collection_days;
+    const stopRuleSatisfied = structural.observations >= minimumObservations &&
+        structural.eligibleRepeatedObservations >= minimumRepeated &&
+        structural.uniqueResources >= minimumUnique &&
+        collectionDays >= minimumDays;
+    return {
+        dataset_id: preregistration.dataset_id,
+        observations: structural.observations,
+        minimum_observations: minimumObservations,
+        eligible_repeated_observations: structural.eligibleRepeatedObservations,
+        minimum_eligible_repeated_observations: minimumRepeated,
+        unique_resources: structural.uniqueResources,
+        minimum_unique_resources: minimumUnique,
+        collection_days: collectionDays,
+        minimum_collection_days: minimumDays,
+        once_decision_count: 0,
+        stop_rule_satisfied: stopRuleSatisfied
+    };
+}
+export async function runDatasetProgress(tracePath, preregistrationPath) {
+    const progress = await datasetProgress(tracePath, preregistrationPath);
+    console.log("");
+    console.log("Once Dataset Progress");
+    console.log("---------------------");
+    console.log(`Dataset: ${progress.dataset_id}`);
+    console.log(`Observations: ${progress.observations} / ${progress.minimum_observations}`);
+    console.log(`Eligible repeated observations: ${progress.eligible_repeated_observations} / ${progress.minimum_eligible_repeated_observations}`);
+    console.log(`Unique resources: ${progress.unique_resources} / ${progress.minimum_unique_resources}`);
+    console.log(`Collection span: ${progress.collection_days.toFixed(2)} / ${progress.minimum_collection_days} days`);
+    console.log("Policy decisions present: 0");
+    console.log("Fingerprint outcomes inspected: NO");
+    console.log(`Stop rule satisfied: ${progress.stop_rule_satisfied ? "YES" : "NO"}`);
+    console.log(`Status: ${progress.stop_rule_satisfied ? "READY TO SEAL" : "COLLECTING"}`);
+    return progress;
+}
+//# sourceMappingURL=dataset-progress.js.map

package/dist/dataset-progress.js.map

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

package/dist/dataset.d.ts

@@ -0,0 +1,35 @@
+export interface SealDatasetOptions {
+    datasetId?: string;
+    outputDirectory?: string;
+    collectorGitCommit: string;
+    sealedAt?: string;
+}
+export interface DatasetManifest {
+    schema_version: "once-dataset-manifest-v1";
+    observation_schema: "once-benchmark-observation-v1";
+    trace_format: "jsonl";
+    dataset_id: string;
+    sealed_at: string;
+    dataset_filename: string;
+    sha256_filename: string;
+    manifest_filename: string;
+    source_trace_filename: string;
+    sha256: string;
+    raw_bytes: number;
+    observations: number;
+    unique_resources: number;
+    collection_started_at: string;
+    collection_ended_at: string;
+    collectors: string[];
+    collector_git_commit: string;
+    once_decision_count: 0;
+}
+export interface SealDatasetResult {
+    datasetPath: string;
+    sha256Path: string;
+    manifestPath: string;
+    manifest: DatasetManifest;
+}
+export declare function sealDataset(tracePath: string, options: SealDatasetOptions): Promise<SealDatasetResult>;
+export declare function runDatasetSeal(tracePath: string, options: SealDatasetOptions): Promise<SealDatasetResult>;
+//# sourceMappingURL=dataset.d.ts.map

package/dist/dataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset.d.ts","sourceRoot":"","sources":["../src/dataset.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,0BAA0B,CAAC;IAC3C,kBAAkB,EAAE,+BAA+B,CAAC;IACpD,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AA4DD,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAmG5B;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAmB5B"}

package/dist/dataset.js

@@ -0,0 +1,133 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile, access } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import { readBenchmarkTrace } from "./benchmark.js";
+function assertDatasetId(value) {
+    if (!/^\d{3,}$/u.test(value)) {
+        throw new Error("dataset id must contain at least three digits, for example 001.");
+    }
+}
+function assertCollectorCommit(value) {
+    if (!/^[0-9a-f]{7,40}$/u.test(value)) {
+        throw new Error("collector git commit must be an explicit 7-40 character hexadecimal git commit.");
+    }
+}
+async function assertAbsent(path) {
+    try {
+        await access(path);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+    throw new Error(`Refusing to overwrite sealed dataset artifact: ${path}`);
+}
+function observationTime(observation, index) {
+    const value = Date.parse(observation.timestamp);
+    if (!Number.isFinite(value)) {
+        throw new Error(`Invalid timestamp on observation ${index + 1}: ${observation.timestamp}`);
+    }
+    return value;
+}
+function collectorNames(observations) {
+    const values = new Set();
+    for (const observation of observations) {
+        const collector = observation.metadata?.collector;
+        if (typeof collector === "string" && collector.length > 0) {
+            values.add(collector);
+        }
+    }
+    return [...values].sort();
+}
+export async function sealDataset(tracePath, options) {
+    const datasetId = options.datasetId ?? "001";
+    const outputDirectory = resolve(options.outputDirectory ?? ".once/datasets");
+    const collectorGitCommit = options.collectorGitCommit.toLowerCase();
+    assertDatasetId(datasetId);
+    assertCollectorCommit(collectorGitCommit);
+    const rawTrace = await readFile(resolve(tracePath));
+    const observations = await readBenchmarkTrace(tracePath);
+    if (observations.length === 0) {
+        throw new Error("Cannot seal an empty dataset.");
+    }
+    const onceDecisionCount = observations.filter(observation => observation.once_decision !== undefined).length;
+    if (onceDecisionCount > 0) {
+        throw new Error(`Refusing to seal raw holdout: found ${onceDecisionCount} observation(s) containing once_decision.`);
+    }
+    const times = observations.map(observationTime);
+    const collectionStartedAt = new Date(Math.min(...times)).toISOString();
+    const collectionEndedAt = new Date(Math.max(...times)).toISOString();
+    const uniqueResources = new Set(observations.map(observation => observation.resource)).size;
+    const sha256 = createHash("sha256")
+        .update(rawTrace)
+        .digest("hex");
+    const stem = `once-dataset-${datasetId}`;
+    const datasetFilename = `${stem}.jsonl`;
+    const sha256Filename = `${stem}.sha256`;
+    const manifestFilename = `${stem}-manifest.json`;
+    const datasetPath = resolve(outputDirectory, datasetFilename);
+    const sha256Path = resolve(outputDirectory, sha256Filename);
+    const manifestPath = resolve(outputDirectory, manifestFilename);
+    await mkdir(outputDirectory, { recursive: true });
+    await Promise.all([
+        assertAbsent(datasetPath),
+        assertAbsent(sha256Path),
+        assertAbsent(manifestPath)
+    ]);
+    const sealedAt = options.sealedAt ?? new Date().toISOString();
+    if (!Number.isFinite(Date.parse(sealedAt))) {
+        throw new Error(`Invalid sealed_at timestamp: ${sealedAt}`);
+    }
+    const manifest = {
+        schema_version: "once-dataset-manifest-v1",
+        observation_schema: "once-benchmark-observation-v1",
+        trace_format: "jsonl",
+        dataset_id: datasetId,
+        sealed_at: new Date(sealedAt).toISOString(),
+        dataset_filename: datasetFilename,
+        sha256_filename: sha256Filename,
+        manifest_filename: manifestFilename,
+        source_trace_filename: basename(tracePath),
+        sha256,
+        raw_bytes: rawTrace.byteLength,
+        observations: observations.length,
+        unique_resources: uniqueResources,
+        collection_started_at: collectionStartedAt,
+        collection_ended_at: collectionEndedAt,
+        collectors: collectorNames(observations),
+        collector_git_commit: collectorGitCommit,
+        once_decision_count: 0
+    };
+    // The dataset bytes are written exactly as collected. No reserialization.
+    await writeFile(datasetPath, rawTrace, { flag: "wx" });
+    await writeFile(sha256Path, `${sha256}  ${datasetFilename}\n`, { encoding: "utf8", flag: "wx" });
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, { encoding: "utf8", flag: "wx" });
+    return {
+        datasetPath,
+        sha256Path,
+        manifestPath,
+        manifest
+    };
+}
+export async function runDatasetSeal(tracePath, options) {
+    const result = await sealDataset(tracePath, options);
+    console.log("");
+    console.log("Once Dataset Seal");
+    console.log("-----------------");
+    console.log(`Dataset: ${result.datasetPath}`);
+    console.log(`SHA-256: ${result.manifest.sha256}`);
+    console.log(`Hash file: ${result.sha256Path}`);
+    console.log(`Manifest: ${result.manifestPath}`);
+    console.log(`Observations: ${result.manifest.observations}`);
+    console.log(`Unique resources: ${result.manifest.unique_resources}`);
+    console.log(`Collection start: ${result.manifest.collection_started_at}`);
+    console.log(`Collection end: ${result.manifest.collection_ended_at}`);
+    console.log(`Collector commit: ${result.manifest.collector_git_commit}`);
+    console.log("Policy decisions present: 0");
+    console.log("Status: SEALED RAW HOLDOUT");
+    return result;
+}
+//# sourceMappingURL=dataset.js.map

package/dist/dataset.js.map

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