@humain/humain-code-contracts 0.3.2

package/dist/trace-api.d.ts

@@ -0,0 +1,293 @@
+import { type Static, Type } from "typebox";
+import { type DhAckV1, type DhArtifactV1, type DhEventV1 } from "./trace.ts";
+/** Candidate HTTP DTOs only. No server routes or retention/access policy are implemented here. */
+export declare const DH_HTTP_MAX_PAGE_ITEMS = 100;
+export declare const DH_HTTP_MAX_CURSOR_LENGTH = 1024;
+export declare const DH_BATCH_SCHEMA_PROPOSAL: "dh.batch/1-proposal";
+export declare const DH_BATCH_MAX_RECORDS = 500;
+export declare const DH_BATCH_MAX_UTF8_BYTES: number;
+declare function generationSchema(): Type.TObject<{
+    readonly outcome: Type.TOptional<Type.TEnum<["succeeded", "failed", "cancelled", "unknown"]>>;
+    readonly startedAt: Type.TOptional<Type.TString>;
+    readonly finishedAt: Type.TOptional<Type.TString>;
+    readonly coverage: Type.TOptional<Type.TObject<{
+        readonly state: Type.TEnum<["captured", "redacted", "truncated", "unavailable", "not-applicable", "inferred"]>;
+        readonly reason: Type.TOptional<Type.TEnum<["secret_redacted", "policy_redacted", "size_limit", "producer_lost", "worker_exited_before_flush", "legacy_producer", "not_captured_by_version", "provider_hidden", "not_applicable", "derived_from_summary"]>>;
+    }>>;
+    readonly eventCount: Type.TOptional<Type.TInteger>;
+    readonly artifactCount: Type.TOptional<Type.TInteger>;
+    readonly generationId: Type.TString;
+    readonly rootAgentId: Type.TOptional<Type.TString>;
+}>;
+declare function agentSchema(): Type.TObject<{
+    readonly outcome: Type.TOptional<Type.TEnum<["succeeded", "failed", "cancelled", "unknown"]>>;
+    readonly startedAt: Type.TOptional<Type.TString>;
+    readonly finishedAt: Type.TOptional<Type.TString>;
+    readonly coverage: Type.TOptional<Type.TObject<{
+        readonly state: Type.TEnum<["captured", "redacted", "truncated", "unavailable", "not-applicable", "inferred"]>;
+        readonly reason: Type.TOptional<Type.TEnum<["secret_redacted", "policy_redacted", "size_limit", "producer_lost", "worker_exited_before_flush", "legacy_producer", "not_captured_by_version", "provider_hidden", "not_applicable", "derived_from_summary"]>>;
+    }>>;
+    readonly eventCount: Type.TOptional<Type.TInteger>;
+    readonly artifactCount: Type.TOptional<Type.TInteger>;
+    readonly generationId: Type.TString;
+    readonly agentId: Type.TString;
+    readonly parentAgentId: Type.TOptional<Type.TString>;
+}>;
+export type DhGenerationSummary = Static<ReturnType<typeof generationSchema>>;
+export type DhAgentSummary = Static<ReturnType<typeof agentSchema>>;
+export type DhGenerationPage = Static<ReturnType<typeof generationPageSchema>>;
+export type DhAgentPage = Static<ReturnType<typeof agentPageSchema>>;
+declare function generationPageSchema(): Type.TObject<{
+    readonly schema: Type.TLiteral<"dh.agent-page/2" | "dh.generation-page/2">;
+    readonly cursorBinding: Type.TObject<{
+        readonly schema: Type.TLiteral<"dh.cursor-binding/2">;
+        readonly environmentId: Type.TString;
+        readonly projectId: Type.TString;
+        readonly resource: Type.TEnum<["generations", "agents", "events", "manifest"]>;
+        readonly generationId: Type.TOptional<Type.TString>;
+        readonly bindingId: Type.TOptional<Type.TString>;
+        readonly filterSha256: Type.TString;
+        readonly view: Type.TUnion<[Type.TLiteral<"metadata">, Type.TLiteral<"content">]>;
+        readonly cutoff: Type.TObject<{
+            readonly schema: Type.TLiteral<"dh.snapshot-cutoff/1">;
+            readonly snapshotId: Type.TString;
+            readonly receiptOrdinal: Type.TInteger;
+            readonly captureCutoff: Type.TString;
+        }>;
+        readonly mappingRevision: Type.TString;
+        readonly authorizationRevision: Type.TString;
+        readonly principalId: Type.TString;
+        readonly grantId: Type.TString;
+        readonly sessionId: Type.TString;
+        readonly pageSize: Type.TInteger;
+    }>;
+    readonly nextCursor: Type.TUnion<[Type.TNull, Type.TString]>;
+    readonly captureCutoff: Type.TString;
+    readonly items: Type.TArray<Type.TObject<{
+        readonly outcome: Type.TOptional<Type.TEnum<["succeeded", "failed", "cancelled", "unknown"]>>;
+        readonly startedAt: Type.TOptional<Type.TString>;
+        readonly finishedAt: Type.TOptional<Type.TString>;
+        readonly coverage: Type.TOptional<Type.TObject<{
+            readonly state: Type.TEnum<["captured", "redacted", "truncated", "unavailable", "not-applicable", "inferred"]>;
+            readonly reason: Type.TOptional<Type.TEnum<["secret_redacted", "policy_redacted", "size_limit", "producer_lost", "worker_exited_before_flush", "legacy_producer", "not_captured_by_version", "provider_hidden", "not_applicable", "derived_from_summary"]>>;
+        }>>;
+        readonly eventCount: Type.TOptional<Type.TInteger>;
+        readonly artifactCount: Type.TOptional<Type.TInteger>;
+        readonly generationId: Type.TString;
+        readonly rootAgentId: Type.TOptional<Type.TString>;
+    }>>;
+}>;
+declare function agentPageSchema(): Type.TObject<{
+    readonly schema: Type.TLiteral<"dh.agent-page/2" | "dh.generation-page/2">;
+    readonly cursorBinding: Type.TObject<{
+        readonly schema: Type.TLiteral<"dh.cursor-binding/2">;
+        readonly environmentId: Type.TString;
+        readonly projectId: Type.TString;
+        readonly resource: Type.TEnum<["generations", "agents", "events", "manifest"]>;
+        readonly generationId: Type.TOptional<Type.TString>;
+        readonly bindingId: Type.TOptional<Type.TString>;
+        readonly filterSha256: Type.TString;
+        readonly view: Type.TUnion<[Type.TLiteral<"metadata">, Type.TLiteral<"content">]>;
+        readonly cutoff: Type.TObject<{
+            readonly schema: Type.TLiteral<"dh.snapshot-cutoff/1">;
+            readonly snapshotId: Type.TString;
+            readonly receiptOrdinal: Type.TInteger;
+            readonly captureCutoff: Type.TString;
+        }>;
+        readonly mappingRevision: Type.TString;
+        readonly authorizationRevision: Type.TString;
+        readonly principalId: Type.TString;
+        readonly grantId: Type.TString;
+        readonly sessionId: Type.TString;
+        readonly pageSize: Type.TInteger;
+    }>;
+    readonly nextCursor: Type.TUnion<[Type.TNull, Type.TString]>;
+    readonly captureCutoff: Type.TString;
+    readonly items: Type.TArray<Type.TObject<{
+        readonly outcome: Type.TOptional<Type.TEnum<["succeeded", "failed", "cancelled", "unknown"]>>;
+        readonly startedAt: Type.TOptional<Type.TString>;
+        readonly finishedAt: Type.TOptional<Type.TString>;
+        readonly coverage: Type.TOptional<Type.TObject<{
+            readonly state: Type.TEnum<["captured", "redacted", "truncated", "unavailable", "not-applicable", "inferred"]>;
+            readonly reason: Type.TOptional<Type.TEnum<["secret_redacted", "policy_redacted", "size_limit", "producer_lost", "worker_exited_before_flush", "legacy_producer", "not_captured_by_version", "provider_hidden", "not_applicable", "derived_from_summary"]>>;
+        }>>;
+        readonly eventCount: Type.TOptional<Type.TInteger>;
+        readonly artifactCount: Type.TOptional<Type.TInteger>;
+        readonly generationId: Type.TString;
+        readonly agentId: Type.TString;
+        readonly parentAgentId: Type.TOptional<Type.TString>;
+    }>>;
+}>;
+/** Transport states describe export work, not execution outcome or capture coverage. */
+export declare const DH_EXPORT_STATES: readonly ["queued", "running", "ready", "failed"];
+export type DhExportState = (typeof DH_EXPORT_STATES)[number];
+declare function exportJobSchema(): Type.TObject<{
+    readonly jobId: Type.TString;
+    readonly state: Type.TEnum<["queued", "running", "ready", "failed"]>;
+}>;
+export type DhExportJob = Static<ReturnType<typeof exportJobSchema>>;
+/** No URLs: a descriptor is not authorization to fetch a recorded or arbitrary URL. */
+declare function exportDownloadSchema(): Type.TUnion<[Type.TObject<{
+    readonly schema: Type.TLiteral<"dh.export-download/2">;
+    readonly state: Type.TLiteral<"pending">;
+}>, Type.TObject<{
+    readonly schema: Type.TLiteral<"dh.export-download/2">;
+    readonly state: Type.TLiteral<"unavailable">;
+}>, Type.TObject<{
+    readonly schema: Type.TLiteral<"dh.export-download/2">;
+    readonly state: Type.TLiteral<"ready">;
+    readonly manifestSha256: Type.TString;
+    readonly headerSha256: Type.TString;
+    readonly sizeBytes: Type.TInteger;
+    readonly sha256: Type.TString;
+    readonly mediaType: Type.TLiteral<"application/octet-stream">;
+}>]>;
+export type DhExportDownload = Static<ReturnType<typeof exportDownloadSchema>>;
+/** Candidate manifest: identifies included records and cutoff; never claims missing data is complete. */
+declare function exportManifestSchema(): Type.TObject<{
+    readonly generationId: Type.TString;
+    readonly tenantScope: Type.TObject<{
+        readonly environmentId: Type.TString;
+        readonly projectId: Type.TString;
+    }>;
+    readonly captureCutoff: Type.TString;
+    readonly contentIncluded: Type.TBoolean;
+    readonly eventIds: Type.TArray<Type.TString>;
+    readonly artifactIds: Type.TArray<Type.TString>;
+    readonly coverage: Type.TObject<{
+        readonly state: Type.TEnum<["captured", "redacted", "truncated", "unavailable", "not-applicable", "inferred"]>;
+        readonly reason: Type.TOptional<Type.TEnum<["secret_redacted", "policy_redacted", "size_limit", "producer_lost", "worker_exited_before_flush", "legacy_producer", "not_captured_by_version", "provider_hidden", "not_applicable", "derived_from_summary"]>>;
+    }>;
+}>;
+export type DhExportManifest = Static<ReturnType<typeof exportManifestSchema>>;
+export declare const parseDhGenerationPage: (value: unknown) => {
+    readonly schema: "dh.agent-page/2" | "dh.generation-page/2";
+    readonly cursorBinding: {
+        readonly schema: "dh.cursor-binding/2";
+        readonly environmentId: string;
+        readonly projectId: string;
+        readonly resource: "agents" | "events" | "generations" | "manifest";
+        readonly generationId?: string | undefined;
+        readonly bindingId?: string | undefined;
+        readonly filterSha256: string;
+        readonly view: "content" | "metadata";
+        readonly cutoff: {
+            readonly schema: "dh.snapshot-cutoff/1";
+            readonly snapshotId: string;
+            readonly receiptOrdinal: number;
+            readonly captureCutoff: string;
+        };
+        readonly mappingRevision: string;
+        readonly authorizationRevision: string;
+        readonly principalId: string;
+        readonly grantId: string;
+        readonly sessionId: string;
+        readonly pageSize: number;
+    };
+    readonly nextCursor: string | null;
+    readonly captureCutoff: string;
+    readonly items: {
+        readonly outcome?: "cancelled" | "failed" | "succeeded" | "unknown" | undefined;
+        readonly startedAt?: string | undefined;
+        readonly finishedAt?: string | undefined;
+        readonly coverage?: {
+            readonly state: "captured" | "inferred" | "not-applicable" | "redacted" | "truncated" | "unavailable";
+            readonly reason?: "derived_from_summary" | "legacy_producer" | "not_applicable" | "not_captured_by_version" | "policy_redacted" | "producer_lost" | "provider_hidden" | "secret_redacted" | "size_limit" | "worker_exited_before_flush" | undefined;
+        } | undefined;
+        readonly eventCount?: number | undefined;
+        readonly artifactCount?: number | undefined;
+        readonly generationId: string;
+        readonly rootAgentId?: string | undefined;
+    }[];
+};
+export declare const parseDhAgentPage: (value: unknown) => {
+    readonly schema: "dh.agent-page/2" | "dh.generation-page/2";
+    readonly cursorBinding: {
+        readonly schema: "dh.cursor-binding/2";
+        readonly environmentId: string;
+        readonly projectId: string;
+        readonly resource: "agents" | "events" | "generations" | "manifest";
+        readonly generationId?: string | undefined;
+        readonly bindingId?: string | undefined;
+        readonly filterSha256: string;
+        readonly view: "content" | "metadata";
+        readonly cutoff: {
+            readonly schema: "dh.snapshot-cutoff/1";
+            readonly snapshotId: string;
+            readonly receiptOrdinal: number;
+            readonly captureCutoff: string;
+        };
+        readonly mappingRevision: string;
+        readonly authorizationRevision: string;
+        readonly principalId: string;
+        readonly grantId: string;
+        readonly sessionId: string;
+        readonly pageSize: number;
+    };
+    readonly nextCursor: string | null;
+    readonly captureCutoff: string;
+    readonly items: {
+        readonly outcome?: "cancelled" | "failed" | "succeeded" | "unknown" | undefined;
+        readonly startedAt?: string | undefined;
+        readonly finishedAt?: string | undefined;
+        readonly coverage?: {
+            readonly state: "captured" | "inferred" | "not-applicable" | "redacted" | "truncated" | "unavailable";
+            readonly reason?: "derived_from_summary" | "legacy_producer" | "not_applicable" | "not_captured_by_version" | "policy_redacted" | "producer_lost" | "provider_hidden" | "secret_redacted" | "size_limit" | "worker_exited_before_flush" | undefined;
+        } | undefined;
+        readonly eventCount?: number | undefined;
+        readonly artifactCount?: number | undefined;
+        readonly generationId: string;
+        readonly agentId: string;
+        readonly parentAgentId?: string | undefined;
+    }[];
+};
+export declare const parseDhExportJob: (value: unknown) => {
+    readonly jobId: string;
+    readonly state: "failed" | "queued" | "ready" | "running";
+};
+export declare const parseDhExportDownload: (value: unknown) => {
+    readonly schema: "dh.export-download/2";
+    readonly state: "pending";
+} | {
+    readonly schema: "dh.export-download/2";
+    readonly state: "unavailable";
+} | {
+    readonly schema: "dh.export-download/2";
+    readonly state: "ready";
+    readonly manifestSha256: string;
+    readonly headerSha256: string;
+    readonly sizeBytes: number;
+    readonly sha256: string;
+    readonly mediaType: "application/octet-stream";
+};
+export declare const parseDhExportManifest: (value: unknown) => {
+    readonly generationId: string;
+    readonly tenantScope: {
+        readonly environmentId: string;
+        readonly projectId: string;
+    };
+    readonly captureCutoff: string;
+    readonly contentIncluded: boolean;
+    readonly eventIds: string[];
+    readonly artifactIds: string[];
+    readonly coverage: {
+        readonly state: "captured" | "inferred" | "not-applicable" | "redacted" | "truncated" | "unavailable";
+        readonly reason?: "derived_from_summary" | "legacy_producer" | "not_applicable" | "not_captured_by_version" | "policy_redacted" | "producer_lost" | "provider_hidden" | "secret_redacted" | "size_limit" | "worker_exited_before_flush" | undefined;
+    };
+};
+export interface DhIngestBatch {
+    schema: typeof DH_BATCH_SCHEMA_PROPOSAL;
+    streamId: string;
+    events: readonly DhEventV1[];
+    artifacts: readonly DhArtifactV1[];
+}
+/** Artifact metadata and artifact bytes are independent transfers; a batch need not be a complete bundle. */
+export declare function parseDhIngestBatch(value: unknown): DhIngestBatch;
+/**
+ * Reuses dh.ack/1. accepted.eventIds, accepted.artifactIds and rejected are independent evidence;
+ * ackedThroughSequence never implies artifact metadata or byte acceptance. A PUT acknowledgement
+ * can name bytes only in the context of that PUT; a batch acknowledgement names records only.
+ */
+export declare function parseDhIngestAck(value: unknown): DhAckV1;
+export {};
+//# sourceMappingURL=trace-api.d.ts.map

package/dist/trace-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-api.d.ts","sourceRoot":"","sources":["../src/trace-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,IAAI,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAMN,KAAK,OAAO,EAGZ,KAAK,YAAY,EAEjB,KAAK,SAAS,EAOd,MAAM,YAAY,CAAC;AAIpB,kGAAkG;AAClG,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,wBAAwB,EAAG,qBAA8B,CAAC;AACvE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,uBAAuB,QAAc,CAAC;AA6BnD,iBAAS,gBAAgB;;;;;;;;;;;;GAMxB;AACD,iBAAS,WAAW;;;;;;;;;;;;;GAOnB;AAWD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAC/E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC;AACrE,iBAAS,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE5B;AACD,iBAAS,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEvB;AAED,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,YAAI,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAClF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9D,iBAAS,eAAe;;;GAEvB;AACD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC;AAErE,uFAAuF;AACvF,iBAAS,oBAAoB;;;;;;;;;;;;;;KAc5B;AACD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAE/E,yGAAyG;AACzG,iBAAS,oBAAoB;;;;;;;;;;;;;;GAU5B;AACD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAkD/E,eAAO,MAAM,qBAAqB,UAVlB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAU0C,CAAC;AAClE,eAAO,MAAM,gBAAgB,UAXb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWgC,CAAC;AACxD,eAAO,MAAM,gBAAgB,UAZb,OAAO;;;CAYgC,CAAC;AACxD,eAAO,MAAM,qBAAqB,UAblB,OAAO;;;;;;;;;;;;;;CAa0C,CAAC;AAClE,eAAO,MAAM,qBAAqB,UAdlB,OAAO;;;;;;;;;;;;;;CAc0C,CAAC;AAElE,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;CACnC;AAUD,6GAA6G;AAC7G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAgChE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWxD"}

package/dist/trace-api.js

@@ -0,0 +1,202 @@
+import { Type } from "typebox";
+import { Compile } from "typebox/compile";
+import { DH_COVERAGE_REASONS, DH_COVERAGE_STATES, DH_EVENT_MAX_UTF8_BYTES, DH_MAX_ACK_IDS, DH_OUTCOMES, DhAgentIdSchema, DhArtifactIdSchema, DhEventIdSchema, DhGenerationIdSchema, DhStreamIdSchema, DhTenantScopeSchema, parseDhAck, parseDhArtifact, parseDhEvent, } from "./trace.js";
+import { assertDhPlainData, DhContractError, dhCanonicalText, parseDhRawJson } from "./trace-canonical.js";
+import { assertDhReadPageBinding, dhCursorBindingSchema } from "./trace-http.js";
+/** Candidate HTTP DTOs only. No server routes or retention/access policy are implemented here. */
+export const DH_HTTP_MAX_PAGE_ITEMS = 100;
+export const DH_HTTP_MAX_CURSOR_LENGTH = 1024;
+export const DH_BATCH_SCHEMA_PROPOSAL = "dh.batch/1-proposal";
+export const DH_BATCH_MAX_RECORDS = 500;
+export const DH_BATCH_MAX_UTF8_BYTES = 1024 * 1024;
+const strict = (properties) => Type.Object(properties, { additionalProperties: false });
+const count = Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER });
+const timestamp = Type.String({
+    minLength: 20,
+    maxLength: 30,
+    pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?Z$",
+});
+const jobId = Type.String({ minLength: 1, maxLength: 256, pattern: "^[A-Za-z0-9_-]+$" });
+const digest = Type.String({ pattern: "^[a-f0-9]{64}$" });
+function metadataCoverageSchema() {
+    // Deliberately excludes coverage.detail: it can carry transcript content.
+    return strict({ state: Type.Enum(DH_COVERAGE_STATES), reason: Type.Optional(Type.Enum(DH_COVERAGE_REASONS)) });
+}
+function summaryProperties() {
+    return {
+        outcome: Type.Optional(Type.Enum(DH_OUTCOMES)),
+        startedAt: Type.Optional(timestamp),
+        finishedAt: Type.Optional(timestamp),
+        coverage: Type.Optional(metadataCoverageSchema()),
+        eventCount: Type.Optional(count),
+        artifactCount: Type.Optional(count),
+    };
+}
+function generationSchema() {
+    return strict({
+        generationId: DhGenerationIdSchema,
+        rootAgentId: Type.Optional(DhAgentIdSchema),
+        ...summaryProperties(),
+    });
+}
+function agentSchema() {
+    return strict({
+        generationId: DhGenerationIdSchema,
+        agentId: DhAgentIdSchema,
+        parentAgentId: Type.Optional(DhAgentIdSchema),
+        ...summaryProperties(),
+    });
+}
+function pageSchema(item, schema) {
+    return strict({
+        schema: Type.Literal(schema),
+        cursorBinding: dhCursorBindingSchema(),
+        nextCursor: Type.Union([Type.Null(), Type.String({ minLength: 1, maxLength: DH_HTTP_MAX_CURSOR_LENGTH })]),
+        captureCutoff: timestamp,
+        items: Type.Array(item, { maxItems: DH_HTTP_MAX_PAGE_ITEMS }),
+    });
+}
+function generationPageSchema() {
+    return pageSchema(generationSchema(), "dh.generation-page/2");
+}
+function agentPageSchema() {
+    return pageSchema(agentSchema(), "dh.agent-page/2");
+}
+/** Transport states describe export work, not execution outcome or capture coverage. */
+export const DH_EXPORT_STATES = ["queued", "running", "ready", "failed"];
+function exportJobSchema() {
+    return strict({ jobId, state: Type.Enum(DH_EXPORT_STATES) });
+}
+/** No URLs: a descriptor is not authorization to fetch a recorded or arbitrary URL. */
+function exportDownloadSchema() {
+    return Type.Union([
+        strict({ schema: Type.Literal("dh.export-download/2"), state: Type.Literal("pending") }),
+        strict({ schema: Type.Literal("dh.export-download/2"), state: Type.Literal("unavailable") }),
+        strict({
+            schema: Type.Literal("dh.export-download/2"),
+            state: Type.Literal("ready"),
+            manifestSha256: digest,
+            headerSha256: digest,
+            sizeBytes: count,
+            sha256: digest,
+            mediaType: Type.Literal("application/octet-stream"),
+        }),
+    ]);
+}
+/** Candidate manifest: identifies included records and cutoff; never claims missing data is complete. */
+function exportManifestSchema() {
+    return strict({
+        generationId: DhGenerationIdSchema,
+        tenantScope: DhTenantScopeSchema,
+        captureCutoff: timestamp,
+        contentIncluded: Type.Boolean(),
+        eventIds: Type.Array(DhEventIdSchema, { maxItems: DH_MAX_ACK_IDS, uniqueItems: true }),
+        artifactIds: Type.Array(DhArtifactIdSchema, { maxItems: DH_MAX_ACK_IDS, uniqueItems: true }),
+        coverage: metadataCoverageSchema(),
+    });
+}
+function assertMetadataSemantics(value) {
+    if (value === null || typeof value !== "object")
+        return;
+    if (!Array.isArray(value)) {
+        const record = value;
+        for (const key of ["captureCutoff", "startedAt", "finishedAt"]) {
+            const text = record[key];
+            if (typeof text !== "string")
+                continue;
+            const base = text.slice(0, 19);
+            const instant = Date.parse(`${base}.000Z`);
+            if (!Number.isFinite(instant) || new Date(instant).toISOString().slice(0, 19) !== base) {
+                throw new DhContractError("schema_invalid", `Invalid trace HTTP DTO: ${key} is not a calendar-valid UTC instant`);
+            }
+        }
+        const coverage = record.coverage;
+        if (coverage && coverage.state !== "captured" && coverage.reason === undefined) {
+            throw new DhContractError("schema_invalid", "Invalid trace HTTP DTO: non-captured coverage requires a reason");
+        }
+        if (Array.isArray(record.items)) {
+            for (const item of record.items)
+                assertMetadataSemantics(item);
+            if (record.schema === "dh.generation-page/2" || record.schema === "dh.agent-page/2")
+                assertDhReadPageBinding({
+                    cursorBinding: record.cursorBinding,
+                    captureCutoff: record.captureCutoff,
+                    items: record.items,
+                }, record.schema === "dh.generation-page/2" ? "generations" : "agents");
+        }
+    }
+}
+/** Lazy compilation avoids an initialization cycle with the existing /trace re-export. */
+function parser(schema) {
+    let validator;
+    return (value) => {
+        assertDhPlainData(value);
+        validator ??= Compile(schema());
+        if (!validator.Check(value))
+            throw new DhContractError("schema_invalid", "Invalid trace HTTP DTO");
+        const clone = JSON.parse(JSON.stringify(value));
+        if (!validator.Check(clone))
+            throw new DhContractError("schema_invalid", "Invalid trace HTTP DTO");
+        assertMetadataSemantics(clone);
+        return clone;
+    };
+}
+export const parseDhGenerationPage = parser(generationPageSchema);
+export const parseDhAgentPage = parser(agentPageSchema);
+export const parseDhExportJob = parser(exportJobSchema);
+export const parseDhExportDownload = parser(exportDownloadSchema);
+export const parseDhExportManifest = parser(exportManifestSchema);
+const parseBatchEnvelope = parser(() => strict({
+    schema: Type.Literal(DH_BATCH_SCHEMA_PROPOSAL),
+    streamId: DhStreamIdSchema,
+    events: Type.Array(Type.Unknown(), { maxItems: DH_BATCH_MAX_RECORDS }),
+    artifacts: Type.Array(Type.Unknown(), { maxItems: DH_BATCH_MAX_RECORDS }),
+}));
+/** Artifact metadata and artifact bytes are independent transfers; a batch need not be a complete bundle. */
+export function parseDhIngestBatch(value) {
+    if (value instanceof Uint8Array)
+        value = parseDhRawJson(value, {
+            maxBytes: DH_BATCH_MAX_UTF8_BYTES,
+            rootArrayItemMaxBytes: { events: DH_EVENT_MAX_UTF8_BYTES },
+        });
+    assertDhPlainData(value);
+    // Validate records before serializing: serialization must not silently discard invalid payload values.
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        throw new DhContractError("schema_invalid", "Invalid trace batch");
+    const input = value;
+    if (!Array.isArray(input.events) || !Array.isArray(input.artifacts))
+        throw new DhContractError("schema_invalid", "Invalid trace batch record count");
+    if (input.events.length + input.artifacts.length > DH_BATCH_MAX_RECORDS)
+        throw new DhContractError("too_large", "Invalid trace batch record count");
+    // Array.from visits holes as undefined; map would skip them and serialize invalid null records.
+    const events = Array.from(input.events, parseDhEvent);
+    const artifacts = Array.from(input.artifacts, parseDhArtifact);
+    const envelope = parseBatchEnvelope({ ...input, events, artifacts });
+    if (events.some((event) => event.streamId !== envelope.streamId))
+        throw new DhContractError("schema_invalid", "Invalid trace batch streamId");
+    // Repeating an id (identical or with changed bytes) or a stream sequence inside one batch is never valid.
+    if (new Set(events.map((event) => event.eventId)).size !== events.length ||
+        new Set(events.map((event) => event.sequence)).size !== events.length ||
+        new Set(artifacts.map((artifact) => artifact.artifactId)).size !== artifacts.length)
+        throw new DhContractError("schema_invalid", "Invalid trace batch duplicate record");
+    const batch = { schema: envelope.schema, streamId: envelope.streamId, events, artifacts };
+    if (new TextEncoder().encode(dhCanonicalText(batch)).length > DH_BATCH_MAX_UTF8_BYTES)
+        throw new DhContractError("too_large", "Invalid trace batch size");
+    return batch;
+}
+/**
+ * Reuses dh.ack/1. accepted.eventIds, accepted.artifactIds and rejected are independent evidence;
+ * ackedThroughSequence never implies artifact metadata or byte acceptance. A PUT acknowledgement
+ * can name bytes only in the context of that PUT; a batch acknowledgement names records only.
+ */
+export function parseDhIngestAck(value) {
+    const ack = parseDhAck(value);
+    const accepted = [...ack.accepted.eventIds, ...ack.accepted.artifactIds];
+    const rejected = ack.rejected.map((entry) => entry.id);
+    if (new Set(accepted).size !== accepted.length ||
+        new Set(rejected).size !== rejected.length ||
+        rejected.some((id) => accepted.includes(id)))
+        throw new DhContractError("schema_invalid", "Invalid trace acknowledgement: duplicate or conflicting ids");
+    return ack;
+}
+//# sourceMappingURL=trace-api.js.map

package/dist/trace-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-api.js","sourceRoot":"","sources":["../src/trace-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Static, type TSchema, Type } from \"typebox\";\nimport { Compile } from \"typebox/compile\";\nimport {\n\tDH_COVERAGE_REASONS,\n\tDH_COVERAGE_STATES,\n\tDH_EVENT_MAX_UTF8_BYTES,\n\tDH_MAX_ACK_IDS,\n\tDH_OUTCOMES,\n\ttype DhAckV1,\n\tDhAgentIdSchema,\n\tDhArtifactIdSchema,\n\ttype DhArtifactV1,\n\tDhEventIdSchema,\n\ttype DhEventV1,\n\tDhGenerationIdSchema,\n\tDhStreamIdSchema,\n\tDhTenantScopeSchema,\n\tparseDhAck,\n\tparseDhArtifact,\n\tparseDhEvent,\n} from \"./trace.ts\";\nimport { assertDhPlainData, DhContractError, dhCanonicalText, parseDhRawJson } from \"./trace-canonical.ts\";\nimport { assertDhReadPageBinding, dhCursorBindingSchema } from \"./trace-http.ts\";\n\n/** Candidate HTTP DTOs only. No server routes or retention/access policy are implemented here. */\nexport const DH_HTTP_MAX_PAGE_ITEMS = 100;\nexport const DH_HTTP_MAX_CURSOR_LENGTH = 1024;\nexport const DH_BATCH_SCHEMA_PROPOSAL = \"dh.batch/1-proposal\" as const;\nexport const DH_BATCH_MAX_RECORDS = 500;\nexport const DH_BATCH_MAX_UTF8_BYTES = 1024 * 1024;\n\nconst strict = <const T extends Parameters<typeof Type.Object>[0]>(properties: T) =>\n\tType.Object(properties, { additionalProperties: false });\nconst count = Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER });\nconst timestamp = Type.String({\n\tminLength: 20,\n\tmaxLength: 30,\n\tpattern: \"^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}(?:\\\\.\\\\d{1,9})?Z$\",\n});\nconst jobId = Type.String({ minLength: 1, maxLength: 256, pattern: \"^[A-Za-z0-9_-]+$\" });\nconst digest = Type.String({ pattern: \"^[a-f0-9]{64}$\" });\n\nfunction metadataCoverageSchema() {\n\t// Deliberately excludes coverage.detail: it can carry transcript content.\n\treturn strict({ state: Type.Enum(DH_COVERAGE_STATES), reason: Type.Optional(Type.Enum(DH_COVERAGE_REASONS)) });\n}\n\nfunction summaryProperties() {\n\treturn {\n\t\toutcome: Type.Optional(Type.Enum(DH_OUTCOMES)),\n\t\tstartedAt: Type.Optional(timestamp),\n\t\tfinishedAt: Type.Optional(timestamp),\n\t\tcoverage: Type.Optional(metadataCoverageSchema()),\n\t\teventCount: Type.Optional(count),\n\t\tartifactCount: Type.Optional(count),\n\t};\n}\n\nfunction generationSchema() {\n\treturn strict({\n\t\tgenerationId: DhGenerationIdSchema,\n\t\trootAgentId: Type.Optional(DhAgentIdSchema),\n\t\t...summaryProperties(),\n\t});\n}\nfunction agentSchema() {\n\treturn strict({\n\t\tgenerationId: DhGenerationIdSchema,\n\t\tagentId: DhAgentIdSchema,\n\t\tparentAgentId: Type.Optional(DhAgentIdSchema),\n\t\t...summaryProperties(),\n\t});\n}\nfunction pageSchema<T extends TSchema>(item: T, schema: \"dh.generation-page/2\" | \"dh.agent-page/2\") {\n\treturn strict({\n\t\tschema: Type.Literal(schema),\n\t\tcursorBinding: dhCursorBindingSchema(),\n\t\tnextCursor: Type.Union([Type.Null(), Type.String({ minLength: 1, maxLength: DH_HTTP_MAX_CURSOR_LENGTH })]),\n\t\tcaptureCutoff: timestamp,\n\t\titems: Type.Array(item, { maxItems: DH_HTTP_MAX_PAGE_ITEMS }),\n\t});\n}\n\nexport type DhGenerationSummary = Static<ReturnType<typeof generationSchema>>;\nexport type DhAgentSummary = Static<ReturnType<typeof agentSchema>>;\nexport type DhGenerationPage = Static<ReturnType<typeof generationPageSchema>>;\nexport type DhAgentPage = Static<ReturnType<typeof agentPageSchema>>;\nfunction generationPageSchema() {\n\treturn pageSchema(generationSchema(), \"dh.generation-page/2\");\n}\nfunction agentPageSchema() {\n\treturn pageSchema(agentSchema(), \"dh.agent-page/2\");\n}\n\n/** Transport states describe export work, not execution outcome or capture coverage. */\nexport const DH_EXPORT_STATES = [\"queued\", \"running\", \"ready\", \"failed\"] as const;\nexport type DhExportState = (typeof DH_EXPORT_STATES)[number];\nfunction exportJobSchema() {\n\treturn strict({ jobId, state: Type.Enum(DH_EXPORT_STATES) });\n}\nexport type DhExportJob = Static<ReturnType<typeof exportJobSchema>>;\n\n/** No URLs: a descriptor is not authorization to fetch a recorded or arbitrary URL. */\nfunction exportDownloadSchema() {\n\treturn Type.Union([\n\t\tstrict({ schema: Type.Literal(\"dh.export-download/2\"), state: Type.Literal(\"pending\") }),\n\t\tstrict({ schema: Type.Literal(\"dh.export-download/2\"), state: Type.Literal(\"unavailable\") }),\n\t\tstrict({\n\t\t\tschema: Type.Literal(\"dh.export-download/2\"),\n\t\t\tstate: Type.Literal(\"ready\"),\n\t\t\tmanifestSha256: digest,\n\t\t\theaderSha256: digest,\n\t\t\tsizeBytes: count,\n\t\t\tsha256: digest,\n\t\t\tmediaType: Type.Literal(\"application/octet-stream\"),\n\t\t}),\n\t]);\n}\nexport type DhExportDownload = Static<ReturnType<typeof exportDownloadSchema>>;\n\n/** Candidate manifest: identifies included records and cutoff; never claims missing data is complete. */\nfunction exportManifestSchema() {\n\treturn strict({\n\t\tgenerationId: DhGenerationIdSchema,\n\t\ttenantScope: DhTenantScopeSchema,\n\t\tcaptureCutoff: timestamp,\n\t\tcontentIncluded: Type.Boolean(),\n\t\teventIds: Type.Array(DhEventIdSchema, { maxItems: DH_MAX_ACK_IDS, uniqueItems: true }),\n\t\tartifactIds: Type.Array(DhArtifactIdSchema, { maxItems: DH_MAX_ACK_IDS, uniqueItems: true }),\n\t\tcoverage: metadataCoverageSchema(),\n\t});\n}\nexport type DhExportManifest = Static<ReturnType<typeof exportManifestSchema>>;\n\nfunction assertMetadataSemantics(value: unknown): void {\n\tif (value === null || typeof value !== \"object\") return;\n\tif (!Array.isArray(value)) {\n\t\tconst record = value as Record<string, unknown>;\n\t\tfor (const key of [\"captureCutoff\", \"startedAt\", \"finishedAt\"]) {\n\t\t\tconst text = record[key];\n\t\t\tif (typeof text !== \"string\") continue;\n\t\t\tconst base = text.slice(0, 19);\n\t\t\tconst instant = Date.parse(`${base}.000Z`);\n\t\t\tif (!Number.isFinite(instant) || new Date(instant).toISOString().slice(0, 19) !== base) {\n\t\t\t\tthrow new DhContractError(\n\t\t\t\t\t\"schema_invalid\",\n\t\t\t\t\t`Invalid trace HTTP DTO: ${key} is not a calendar-valid UTC instant`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tconst coverage = record.coverage as { state?: unknown; reason?: unknown } | undefined;\n\t\tif (coverage && coverage.state !== \"captured\" && coverage.reason === undefined) {\n\t\t\tthrow new DhContractError(\"schema_invalid\", \"Invalid trace HTTP DTO: non-captured coverage requires a reason\");\n\t\t}\n\t\tif (Array.isArray(record.items)) {\n\t\t\tfor (const item of record.items) assertMetadataSemantics(item);\n\t\t\tif (record.schema === \"dh.generation-page/2\" || record.schema === \"dh.agent-page/2\")\n\t\t\t\tassertDhReadPageBinding(\n\t\t\t\t\t{\n\t\t\t\t\t\tcursorBinding: record.cursorBinding,\n\t\t\t\t\t\tcaptureCutoff: record.captureCutoff as string,\n\t\t\t\t\t\titems: record.items,\n\t\t\t\t\t},\n\t\t\t\t\trecord.schema === \"dh.generation-page/2\" ? \"generations\" : \"agents\",\n\t\t\t\t);\n\t\t}\n\t}\n}\n\n/** Lazy compilation avoids an initialization cycle with the existing /trace re-export. */\nfunction parser<T extends TSchema>(schema: () => T) {\n\tlet validator: ReturnType<typeof Compile<T>> | undefined;\n\treturn (value: unknown): Static<T> => {\n\t\tassertDhPlainData(value);\n\t\tvalidator ??= Compile(schema());\n\t\tif (!validator.Check(value)) throw new DhContractError(\"schema_invalid\", \"Invalid trace HTTP DTO\");\n\t\tconst clone: unknown = JSON.parse(JSON.stringify(value));\n\t\tif (!validator.Check(clone)) throw new DhContractError(\"schema_invalid\", \"Invalid trace HTTP DTO\");\n\t\tassertMetadataSemantics(clone);\n\t\treturn clone;\n\t};\n}\nexport const parseDhGenerationPage = parser(generationPageSchema);\nexport const parseDhAgentPage = parser(agentPageSchema);\nexport const parseDhExportJob = parser(exportJobSchema);\nexport const parseDhExportDownload = parser(exportDownloadSchema);\nexport const parseDhExportManifest = parser(exportManifestSchema);\n\nexport interface DhIngestBatch {\n\tschema: typeof DH_BATCH_SCHEMA_PROPOSAL;\n\tstreamId: string;\n\tevents: readonly DhEventV1[];\n\tartifacts: readonly DhArtifactV1[];\n}\nconst parseBatchEnvelope = parser(() =>\n\tstrict({\n\t\tschema: Type.Literal(DH_BATCH_SCHEMA_PROPOSAL),\n\t\tstreamId: DhStreamIdSchema,\n\t\tevents: Type.Array(Type.Unknown(), { maxItems: DH_BATCH_MAX_RECORDS }),\n\t\tartifacts: Type.Array(Type.Unknown(), { maxItems: DH_BATCH_MAX_RECORDS }),\n\t}),\n);\n\n/** Artifact metadata and artifact bytes are independent transfers; a batch need not be a complete bundle. */\nexport function parseDhIngestBatch(value: unknown): DhIngestBatch {\n\tif (value instanceof Uint8Array)\n\t\tvalue = parseDhRawJson(value, {\n\t\t\tmaxBytes: DH_BATCH_MAX_UTF8_BYTES,\n\t\t\trootArrayItemMaxBytes: { events: DH_EVENT_MAX_UTF8_BYTES },\n\t\t});\n\tassertDhPlainData(value);\n\t// Validate records before serializing: serialization must not silently discard invalid payload values.\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value))\n\t\tthrow new DhContractError(\"schema_invalid\", \"Invalid trace batch\");\n\tconst input = value as Record<string, unknown>;\n\tif (!Array.isArray(input.events) || !Array.isArray(input.artifacts))\n\t\tthrow new DhContractError(\"schema_invalid\", \"Invalid trace batch record count\");\n\tif (input.events.length + input.artifacts.length > DH_BATCH_MAX_RECORDS)\n\t\tthrow new DhContractError(\"too_large\", \"Invalid trace batch record count\");\n\t// Array.from visits holes as undefined; map would skip them and serialize invalid null records.\n\tconst events = Array.from(input.events, parseDhEvent);\n\tconst artifacts = Array.from(input.artifacts, parseDhArtifact);\n\tconst envelope = parseBatchEnvelope({ ...input, events, artifacts });\n\tif (events.some((event) => event.streamId !== envelope.streamId))\n\t\tthrow new DhContractError(\"schema_invalid\", \"Invalid trace batch streamId\");\n\t// Repeating an id (identical or with changed bytes) or a stream sequence inside one batch is never valid.\n\tif (\n\t\tnew Set(events.map((event) => event.eventId)).size !== events.length ||\n\t\tnew Set(events.map((event) => event.sequence)).size !== events.length ||\n\t\tnew Set(artifacts.map((artifact) => artifact.artifactId)).size !== artifacts.length\n\t)\n\t\tthrow new DhContractError(\"schema_invalid\", \"Invalid trace batch duplicate record\");\n\tconst batch: DhIngestBatch = { schema: envelope.schema, streamId: envelope.streamId, events, artifacts };\n\tif (new TextEncoder().encode(dhCanonicalText(batch)).length > DH_BATCH_MAX_UTF8_BYTES)\n\t\tthrow new DhContractError(\"too_large\", \"Invalid trace batch size\");\n\treturn batch;\n}\n\n/**\n * Reuses dh.ack/1. accepted.eventIds, accepted.artifactIds and rejected are independent evidence;\n * ackedThroughSequence never implies artifact metadata or byte acceptance. A PUT acknowledgement\n * can name bytes only in the context of that PUT; a batch acknowledgement names records only.\n */\nexport function parseDhIngestAck(value: unknown): DhAckV1 {\n\tconst ack = parseDhAck(value);\n\tconst accepted = [...ack.accepted.eventIds, ...ack.accepted.artifactIds];\n\tconst rejected = ack.rejected.map((entry) => entry.id);\n\tif (\n\t\tnew Set(accepted).size !== accepted.length ||\n\t\tnew Set(rejected).size !== rejected.length ||\n\t\trejected.some((id) => accepted.includes(id))\n\t)\n\t\tthrow new DhContractError(\"schema_invalid\", \"Invalid trace acknowledgement: duplicate or conflicting ids\");\n\treturn ack;\n}\n"]}

package/dist/trace-artifact.d.ts

@@ -0,0 +1,94 @@
+export declare const DH_ARTIFACT_SCHEMA_IDS: Readonly<{
+    readonly capabilityManifest: "dh.capability-manifest/1";
+    readonly contractArtifact: "dh.contract-artifact/1";
+}>;
+/** Literal implemented IDs only; lazy to preserve /trace entry-order neutrality. */
+export declare function getDhImplementedSchemaIds(): readonly string[];
+export declare const DH_CAPABILITY_ACTIONS: readonly ["backgroundStatus", "cancelSelected", "cancelWholeRun", "continueLive", "retryFresh"];
+export type DhCapabilityAction = (typeof DH_CAPABILITY_ACTIONS)[number];
+export declare const parseDhCapabilityManifest: (value: unknown) => {
+    readonly schema: "dh.capability-manifest/1";
+    readonly packageName: "@humain/humain-code-contracts";
+    readonly packageVersion: string;
+    readonly contractVersion: 1;
+    readonly artifactSha256: string;
+    readonly canonicalProfile: "dh.canonical-jcs/1";
+    readonly schemaIds: string[];
+    readonly conformanceVectorSha256: string;
+    readonly runtimes: {
+        readonly runtime: "cli-bun" | "cli-node" | "flow" | "forge-native";
+        readonly buildSha256: string;
+        readonly mode: string;
+        readonly platform: "darwin" | "linux" | "win32";
+        readonly actions: {
+            readonly backgroundStatus: {
+                readonly status: "supported" | "unknown" | "unsupported";
+                readonly channel: "in-process" | "inherited-fd3" | "native-executor" | "none" | "unix-socket";
+                readonly qualificationSha256?: string | undefined;
+                readonly reasonCode?: string | undefined;
+            };
+            readonly cancelSelected: {
+                readonly status: "supported" | "unknown" | "unsupported";
+                readonly channel: "in-process" | "inherited-fd3" | "native-executor" | "none" | "unix-socket";
+                readonly qualificationSha256?: string | undefined;
+                readonly reasonCode?: string | undefined;
+            };
+            readonly cancelWholeRun: {
+                readonly status: "supported" | "unknown" | "unsupported";
+                readonly channel: "in-process" | "inherited-fd3" | "native-executor" | "none" | "unix-socket";
+                readonly qualificationSha256?: string | undefined;
+                readonly reasonCode?: string | undefined;
+            };
+            readonly continueLive: {
+                readonly status: "supported" | "unknown" | "unsupported";
+                readonly channel: "in-process" | "inherited-fd3" | "native-executor" | "none" | "unix-socket";
+                readonly qualificationSha256?: string | undefined;
+                readonly reasonCode?: string | undefined;
+            };
+            readonly retryFresh: {
+                readonly status: "supported" | "unknown" | "unsupported";
+                readonly channel: "in-process" | "inherited-fd3" | "native-executor" | "none" | "unix-socket";
+                readonly qualificationSha256?: string | undefined;
+                readonly reasonCode?: string | undefined;
+            };
+        };
+    }[];
+};
+export type DhCapabilityManifest = ReturnType<typeof parseDhCapabilityManifest>;
+export type DhCapabilityTarget = Pick<DhCapabilityManifest["runtimes"][number], "runtime" | "buildSha256" | "mode" | "platform">;
+export declare function assertDhCapabilityAction(input: unknown, target: DhCapabilityTarget, action: DhCapabilityAction): DhCapabilityManifest["runtimes"][number]["actions"][DhCapabilityAction];
+export declare const parseDhContractArtifact: (value: unknown) => {
+    readonly schema: "dh.contract-artifact/1";
+    readonly packageName: "@humain/humain-code-contracts";
+    readonly packageVersion: "0.3.2";
+    readonly contractVersion: 1;
+    readonly tarballFile: string;
+    readonly sha256: string;
+    readonly npmIntegrity: string;
+    readonly capabilityManifestFile: string;
+    readonly capabilityManifestSha256: string;
+    readonly conformanceVectorSha256: string;
+    readonly schemaIds: string[];
+};
+export type DhContractArtifact = ReturnType<typeof parseDhContractArtifact>;
+/** Actual file/digest/export inspection is owned by the installer, not inferred from a descriptor. */
+export interface DhContractArtifactInspection {
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly contractVersion: number;
+    readonly exports: Readonly<Record<string, {
+        readonly types: string;
+        readonly import: string;
+    }>>;
+    readonly distPresent: boolean;
+    readonly sha256: string;
+    readonly npmIntegrity: string;
+    readonly capabilityManifest: unknown;
+    readonly capabilityManifestSha256: string;
+    readonly conformanceVectorSha256: string;
+    readonly schemaIds: readonly string[];
+    readonly tarballSymlink: boolean;
+    readonly capabilityManifestSymlink: boolean;
+}
+export declare function assertDhContractArtifact(input: unknown, inspection: DhContractArtifactInspection): void;
+//# sourceMappingURL=trace-artifact.d.ts.map

package/dist/trace-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-artifact.d.ts","sourceRoot":"","sources":["../src/trace-artifact.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB;iCACd,0BAA0B;+BAC5B,wBAAwB;EAChC,CAAC;AACZ,oFAAoF;AACpF,wBAAgB,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAgB7D;AAUD,eAAO,MAAM,qBAAqB,YACjC,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,CACH,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAyCxE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAepC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAChF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACpC,oBAAoB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EACxC,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,CAC/C,CAAC;AACF,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,GACxB,oBAAoB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAqBzE;AAMD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;CAyBnC,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC5E,sGAAsG;AACtG,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAChG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;CAC5C;AACD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,4BAA4B,GAAG,IAAI,CAmCvG"}