@once-agent/sdk 0.1.4 → 0.1.6

package/dist/connect/classifier.d.ts

@@ -0,0 +1,18 @@
+export declare const CONNECT_DECISION: Readonly<{
+    readonly PROTECT: "PROTECT";
+    readonly BYPASS: "BYPASS";
+    readonly REJECT: "REJECT";
+}>;
+export type ConnectDecision = (typeof CONNECT_DECISION)[keyof typeof CONNECT_DECISION];
+export interface ConnectSafetyDeclaration {
+    changesExternalState: boolean;
+    retryPossible: boolean;
+    ambiguousOutcomePossible: boolean;
+    duplicateUndesirable: boolean;
+}
+export interface ConnectClassification {
+    decision: ConnectDecision;
+    reason: "INVALID_OPERATION" | "INCOMPLETE_SAFETY_DECLARATION" | "CONSEQUENTIAL_RETRY_RISK" | "PROTECTION_CONDITIONS_NOT_ALL_PRESENT";
+}
+export declare function classifyConnectOperation(operation: unknown): Readonly<ConnectClassification>;
+//# sourceMappingURL=classifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/connect/classifier.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;EAIlB,CAAC;AAEZ,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,wBAAwB,EAAE,OAAO,CAAC;IAClC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EACF,mBAAmB,GACnB,+BAA+B,GAC/B,0BAA0B,GAC1B,uCAAuC,CAAC;CAC7C;AAaD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,OAAO,GACjB,QAAQ,CAAC,qBAAqB,CAAC,CAmEjC"}

package/dist/connect/classifier.js

@@ -0,0 +1,49 @@
+export const CONNECT_DECISION = Object.freeze({
+    PROTECT: "PROTECT",
+    BYPASS: "BYPASS",
+    REJECT: "REJECT",
+});
+function requireBoolean(value, name) {
+    if (typeof value !== "boolean") {
+        throw new TypeError(`Once Connect requires boolean "${name}".`);
+    }
+}
+export function classifyConnectOperation(operation) {
+    if (!operation ||
+        typeof operation !== "object" ||
+        Array.isArray(operation)) {
+        return Object.freeze({
+            decision: CONNECT_DECISION.REJECT,
+            reason: "INVALID_OPERATION",
+        });
+    }
+    const candidate = operation;
+    const { changesExternalState, retryPossible, ambiguousOutcomePossible, duplicateUndesirable, } = candidate;
+    try {
+        requireBoolean(changesExternalState, "changesExternalState");
+        requireBoolean(retryPossible, "retryPossible");
+        requireBoolean(ambiguousOutcomePossible, "ambiguousOutcomePossible");
+        requireBoolean(duplicateUndesirable, "duplicateUndesirable");
+    }
+    catch {
+        return Object.freeze({
+            decision: CONNECT_DECISION.REJECT,
+            reason: "INCOMPLETE_SAFETY_DECLARATION",
+        });
+    }
+    const requiresProtection = changesExternalState &&
+        retryPossible &&
+        ambiguousOutcomePossible &&
+        duplicateUndesirable;
+    if (requiresProtection) {
+        return Object.freeze({
+            decision: CONNECT_DECISION.PROTECT,
+            reason: "CONSEQUENTIAL_RETRY_RISK",
+        });
+    }
+    return Object.freeze({
+        decision: CONNECT_DECISION.BYPASS,
+        reason: "PROTECTION_CONDITIONS_NOT_ALL_PRESENT",
+    });
+}
+//# sourceMappingURL=classifier.js.map

package/dist/connect/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/connect/classifier.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC,CAAC;AAqBZ,SAAS,cAAc,CACrB,KAAc,EACd,IAAY;IAEZ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CACjB,kCAAkC,IAAI,IAAI,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,SAAkB;IAElB,IACE,CAAC,SAAS;QACV,OAAO,SAAS,KAAK,QAAQ;QAC7B,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EACxB,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,gBAAgB,CAAC,MAAM;YACjC,MAAM,EAAE,mBAAmB;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GACb,SAAoC,CAAC;IAEvC,MAAM,EACJ,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACxB,oBAAoB,GACrB,GAAG,SAAS,CAAC;IAEd,IAAI,CAAC;QACH,cAAc,CACZ,oBAAoB,EACpB,sBAAsB,CACvB,CAAC;QAEF,cAAc,CACZ,aAAa,EACb,eAAe,CAChB,CAAC;QAEF,cAAc,CACZ,wBAAwB,EACxB,0BAA0B,CAC3B,CAAC;QAEF,cAAc,CACZ,oBAAoB,EACpB,sBAAsB,CACvB,CAAC;IACJ,CAAC;IACD,MAAM,CAAC;QACL,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,gBAAgB,CAAC,MAAM;YACjC,MAAM,EAAE,+BAA+B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,kBAAkB,GACtB,oBAAoB;QACpB,aAAa;QACb,wBAAwB;QACxB,oBAAoB,CAAC;IAEvB,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,gBAAgB,CAAC,OAAO;YAClC,MAAM,EAAE,0BAA0B;SACnC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,gBAAgB,CAAC,MAAM;QACjC,MAAM,EAAE,uCAAuC;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/connect/execute.d.ts

@@ -0,0 +1,30 @@
+import type { ConnectClassification, ConnectSafetyDeclaration } from "./classifier.js";
+import type { ConnectPayload } from "./binding.js";
+export interface ConnectProtectedContext {
+    operationId: string;
+    payload: ConnectPayload;
+    payloadFingerprint: string;
+    classification: Readonly<ConnectClassification>;
+}
+export interface ConnectExecutionInput<T = unknown> {
+    safety: ConnectSafetyDeclaration;
+    operationId: string;
+    payload: ConnectPayload;
+    bypass?: () => Promise<T> | T;
+    protect?: (context: ConnectProtectedContext) => Promise<T> | T;
+}
+export declare class ConnectExecutionError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * 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 declare function executeConnectOperation<T = unknown>({ safety, operationId, payload, bypass, protect, }: ConnectExecutionInput<T>): Promise<T>;
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/connect/execute.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EACV,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IAChD,MAAM,EAAE,wBAAwB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACrB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM;CAMf;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EAAE,EACzD,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,OAAO,GACR,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoDvC"}

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"}