engineering-behavior-observatory 0.2.1

package/dist/src/task-packets.d.ts

@@ -0,0 +1,115 @@
+import { type ArtifactValidationError } from "./artifacts.js";
+import { type ArtifactReference, type AssessmentMode, type Digest } from "./contracts.js";
+type TaskPacketBase = {
+    schemaVersion: "ebo.task-packet/v1";
+    id: string;
+    assessmentMode: AssessmentMode;
+    agentInput: {
+        prompt: string;
+        fixture: {
+            source: ArtifactReference & {
+                kind: "sanitized-archive";
+                format: "tar-gzip-v1";
+                limits: {
+                    maxCompressedBytes: number;
+                    maxExpandedBytes: number;
+                    maxMembers: number;
+                };
+            };
+            materializer: {
+                kind: "verified-archive-literal-paths-no-links-v1";
+                destination: "workspace";
+                includePaths: string[];
+            };
+        };
+    };
+    provenance: {
+        repositoryUrl: string;
+        revision: string;
+        license: string;
+    };
+    controlledPerturbation: {
+        reference: ArtifactReference;
+    } | {
+        status: "not-applied" | "unsupported";
+    };
+    sharing: {
+        classification: "open" | "restricted" | "internal";
+    };
+    admission: {
+        status: "proposed" | "admitted" | "rejected";
+        review: {
+            reviewedAt: string;
+            reviewedBy: string;
+            reviewRecord: ArtifactReference;
+        } | null;
+    };
+};
+export type TaskPacket = TaskPacketBase & ({
+    assessmentMode: "observational";
+    restricted?: never;
+} | {
+    assessmentMode: "verified";
+    restricted: {
+        referenceSolution: ArtifactReference | {
+            status: "not-provided" | "unsupported";
+        };
+        verifier: ArtifactReference;
+    };
+});
+export type TaskPacketComponent = {
+    status: "referenced";
+    digest: Digest | null;
+} | {
+    status: "not-provided" | "unsupported" | "not-applied";
+};
+export type TaskPacketComponents = {
+    prompt: Digest;
+    fixture: Digest | null;
+    reference: TaskPacketComponent;
+    verifier: Digest | null;
+    reviewRecord: Digest | null;
+    controlledPerturbation: TaskPacketComponent;
+};
+export type TaskPacketFreezeRecord = {
+    schemaVersion: "ebo.task-packet-freeze/v1";
+    packetId: string;
+    assessmentMode?: AssessmentMode;
+    packetLocator: string;
+    preAdmissionDigest: Digest;
+    packetDigest: Digest;
+    components: TaskPacketComponents;
+    aggregateDigest: Digest;
+    frozenAt: string;
+};
+export type TaskPacketInspection = {
+    packetLocator: string;
+    packet: TaskPacket | null;
+    preAdmissionDigest: Digest | null;
+    packetDigest: Digest | null;
+    components: TaskPacketComponents | null;
+    modelVisible: TaskPacket["agentInput"] | null;
+    errors: ArtifactValidationError[];
+};
+export type TaskPacketStatus = {
+    status: "invalid" | "unadmitted" | "unfrozen" | "frozen" | "changed";
+    packetId: string | null;
+    packetDigest: Digest | null;
+    aggregateDigest: Digest | null;
+    freezeLocator: string;
+    mismatches: string[];
+    errors: ArtifactValidationError[];
+};
+export declare const TASK_PACKET_FREEZE_SCHEMA_VERSION = "ebo.task-packet-freeze/v1";
+export declare const MAX_TASK_PACKET_METADATA_BYTES = 1048576;
+export declare function inspectTaskPacket(bundleRoot: string, packetLocator: string): TaskPacketInspection;
+export declare function admitTaskPacket(bundleRoot: string, packetLocator: string): TaskPacketInspection;
+export declare function assertTaskPacketAdmitted(bundleRoot: string, packetLocator: string): TaskPacketInspection;
+export declare function modelVisibleTaskPacket(packet: TaskPacket): TaskPacket["agentInput"];
+export declare function defaultFreezeLocator(packetLocator: string): string;
+export declare function freezeTaskPacket(bundleRoot: string, packetLocator: string, freezeLocator?: string): TaskPacketFreezeRecord;
+export declare function statusTaskPacket(bundleRoot: string, packetLocator: string, freezeLocator?: string): TaskPacketStatus;
+export declare function formatErrors(errors: readonly ArtifactValidationError[]): string;
+export declare function assertTaskPacketFreezeRecord(record: TaskPacketFreezeRecord): void;
+export declare function assertFreezeLocatorPathWithinLimits(freezeLocator: string, packetLocator: string): void;
+export {};