@claudexor/schema 1.0.1 → 2.1.1

package/dist/quota.d.ts

@@ -0,0 +1,269 @@
+import { z } from "zod";
+export declare const QuotaSource: z.ZodEnum<["codex_app_server", "codex_rollout", "claude_statusline", "claude_api_retry", "claude_oauth_usage"]>;
+export type QuotaSource = z.infer<typeof QuotaSource>;
+export declare const QuotaFreshness: z.ZodEnum<["fresh", "stale", "unknown"]>;
+export type QuotaFreshness = z.infer<typeof QuotaFreshness>;
+export declare const QuotaSubject: z.ZodObject<{
+    harness: z.ZodString;
+    credential_route: z.ZodEnum<["vendor_native", "managed_api_key", "local"]>;
+    plan_label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** The CREDENTIAL SUBJECT the windows belong to (release wave round-16
+     * #2): a Claudexor credential-profile id, or null for the harness's
+     * engine-default credential. Every producer (oauth-usage refresher,
+     * typed-event registry, adapter quota events) uses exactly this
+     * vocabulary; budget routing filters snapshots by exact subject so one
+     * account's exhaustion never cools another. */
+    subject_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    harness: string;
+    credential_route: "local" | "vendor_native" | "managed_api_key";
+    plan_label: string | null;
+    subject_id: string | null;
+}, {
+    harness: string;
+    credential_route: "local" | "vendor_native" | "managed_api_key";
+    plan_label?: string | null | undefined;
+    subject_id?: string | null | undefined;
+}>;
+export type QuotaSubject = z.infer<typeof QuotaSubject>;
+export declare const QuotaConstraint: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    used_ratio: z.ZodNullable<z.ZodNumber>;
+    window_seconds: z.ZodNullable<z.ZodNumber>;
+    resets_at: z.ZodNullable<z.ZodString>;
+    cooldown_until: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    label: string;
+    used_ratio: number | null;
+    window_seconds: number | null;
+    resets_at: string | null;
+    cooldown_until: string | null;
+}, {
+    id: string;
+    label: string;
+    used_ratio: number | null;
+    window_seconds: number | null;
+    resets_at: string | null;
+    cooldown_until?: string | null | undefined;
+}>;
+export type QuotaConstraint = z.infer<typeof QuotaConstraint>;
+export declare const QuotaSnapshot: z.ZodObject<{
+    subject: z.ZodObject<{
+        harness: z.ZodString;
+        credential_route: z.ZodEnum<["vendor_native", "managed_api_key", "local"]>;
+        plan_label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** The CREDENTIAL SUBJECT the windows belong to (release wave round-16
+         * #2): a Claudexor credential-profile id, or null for the harness's
+         * engine-default credential. Every producer (oauth-usage refresher,
+         * typed-event registry, adapter quota events) uses exactly this
+         * vocabulary; budget routing filters snapshots by exact subject so one
+         * account's exhaustion never cools another. */
+        subject_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        harness: string;
+        credential_route: "local" | "vendor_native" | "managed_api_key";
+        plan_label: string | null;
+        subject_id: string | null;
+    }, {
+        harness: string;
+        credential_route: "local" | "vendor_native" | "managed_api_key";
+        plan_label?: string | null | undefined;
+        subject_id?: string | null | undefined;
+    }>;
+    constraints: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        used_ratio: z.ZodNullable<z.ZodNumber>;
+        window_seconds: z.ZodNullable<z.ZodNumber>;
+        resets_at: z.ZodNullable<z.ZodString>;
+        cooldown_until: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        label: string;
+        used_ratio: number | null;
+        window_seconds: number | null;
+        resets_at: string | null;
+        cooldown_until: string | null;
+    }, {
+        id: string;
+        label: string;
+        used_ratio: number | null;
+        window_seconds: number | null;
+        resets_at: string | null;
+        cooldown_until?: string | null | undefined;
+    }>, "many">;
+    source: z.ZodEnum<["codex_app_server", "codex_rollout", "claude_statusline", "claude_api_retry", "claude_oauth_usage"]>;
+    observed_at: z.ZodString;
+    freshness: z.ZodEnum<["fresh", "stale", "unknown"]>;
+}, "strict", z.ZodTypeAny, {
+    source: "codex_app_server" | "codex_rollout" | "claude_statusline" | "claude_api_retry" | "claude_oauth_usage";
+    subject: {
+        harness: string;
+        credential_route: "local" | "vendor_native" | "managed_api_key";
+        plan_label: string | null;
+        subject_id: string | null;
+    };
+    constraints: {
+        id: string;
+        label: string;
+        used_ratio: number | null;
+        window_seconds: number | null;
+        resets_at: string | null;
+        cooldown_until: string | null;
+    }[];
+    observed_at: string;
+    freshness: "unknown" | "fresh" | "stale";
+}, {
+    source: "codex_app_server" | "codex_rollout" | "claude_statusline" | "claude_api_retry" | "claude_oauth_usage";
+    subject: {
+        harness: string;
+        credential_route: "local" | "vendor_native" | "managed_api_key";
+        plan_label?: string | null | undefined;
+        subject_id?: string | null | undefined;
+    };
+    constraints: {
+        id: string;
+        label: string;
+        used_ratio: number | null;
+        window_seconds: number | null;
+        resets_at: string | null;
+        cooldown_until?: string | null | undefined;
+    }[];
+    observed_at: string;
+    freshness: "unknown" | "fresh" | "stale";
+}>;
+export type QuotaSnapshot = z.infer<typeof QuotaSnapshot>;
+export declare const ControlQuotaResponse: z.ZodObject<{
+    snapshots: z.ZodArray<z.ZodObject<{
+        subject: z.ZodObject<{
+            harness: z.ZodString;
+            credential_route: z.ZodEnum<["vendor_native", "managed_api_key", "local"]>;
+            plan_label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            /** The CREDENTIAL SUBJECT the windows belong to (release wave round-16
+             * #2): a Claudexor credential-profile id, or null for the harness's
+             * engine-default credential. Every producer (oauth-usage refresher,
+             * typed-event registry, adapter quota events) uses exactly this
+             * vocabulary; budget routing filters snapshots by exact subject so one
+             * account's exhaustion never cools another. */
+            subject_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, "strict", z.ZodTypeAny, {
+            harness: string;
+            credential_route: "local" | "vendor_native" | "managed_api_key";
+            plan_label: string | null;
+            subject_id: string | null;
+        }, {
+            harness: string;
+            credential_route: "local" | "vendor_native" | "managed_api_key";
+            plan_label?: string | null | undefined;
+            subject_id?: string | null | undefined;
+        }>;
+        constraints: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            used_ratio: z.ZodNullable<z.ZodNumber>;
+            window_seconds: z.ZodNullable<z.ZodNumber>;
+            resets_at: z.ZodNullable<z.ZodString>;
+            cooldown_until: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            label: string;
+            used_ratio: number | null;
+            window_seconds: number | null;
+            resets_at: string | null;
+            cooldown_until: string | null;
+        }, {
+            id: string;
+            label: string;
+            used_ratio: number | null;
+            window_seconds: number | null;
+            resets_at: string | null;
+            cooldown_until?: string | null | undefined;
+        }>, "many">;
+        source: z.ZodEnum<["codex_app_server", "codex_rollout", "claude_statusline", "claude_api_retry", "claude_oauth_usage"]>;
+        observed_at: z.ZodString;
+        freshness: z.ZodEnum<["fresh", "stale", "unknown"]>;
+    }, "strict", z.ZodTypeAny, {
+        source: "codex_app_server" | "codex_rollout" | "claude_statusline" | "claude_api_retry" | "claude_oauth_usage";
+        subject: {
+            harness: string;
+            credential_route: "local" | "vendor_native" | "managed_api_key";
+            plan_label: string | null;
+            subject_id: string | null;
+        };
+        constraints: {
+            id: string;
+            label: string;
+            used_ratio: number | null;
+            window_seconds: number | null;
+            resets_at: string | null;
+            cooldown_until: string | null;
+        }[];
+        observed_at: string;
+        freshness: "unknown" | "fresh" | "stale";
+    }, {
+        source: "codex_app_server" | "codex_rollout" | "claude_statusline" | "claude_api_retry" | "claude_oauth_usage";
+        subject: {
+            harness: string;
+            credential_route: "local" | "vendor_native" | "managed_api_key";
+            plan_label?: string | null | undefined;
+            subject_id?: string | null | undefined;
+        };
+        constraints: {
+            id: string;
+            label: string;
+            used_ratio: number | null;
+            window_seconds: number | null;
+            resets_at: string | null;
+            cooldown_until?: string | null | undefined;
+        }[];
+        observed_at: string;
+        freshness: "unknown" | "fresh" | "stale";
+    }>, "many">;
+    refreshed_at: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    snapshots: {
+        source: "codex_app_server" | "codex_rollout" | "claude_statusline" | "claude_api_retry" | "claude_oauth_usage";
+        subject: {
+            harness: string;
+            credential_route: "local" | "vendor_native" | "managed_api_key";
+            plan_label: string | null;
+            subject_id: string | null;
+        };
+        constraints: {
+            id: string;
+            label: string;
+            used_ratio: number | null;
+            window_seconds: number | null;
+            resets_at: string | null;
+            cooldown_until: string | null;
+        }[];
+        observed_at: string;
+        freshness: "unknown" | "fresh" | "stale";
+    }[];
+    refreshed_at: string | null;
+}, {
+    snapshots: {
+        source: "codex_app_server" | "codex_rollout" | "claude_statusline" | "claude_api_retry" | "claude_oauth_usage";
+        subject: {
+            harness: string;
+            credential_route: "local" | "vendor_native" | "managed_api_key";
+            plan_label?: string | null | undefined;
+            subject_id?: string | null | undefined;
+        };
+        constraints: {
+            id: string;
+            label: string;
+            used_ratio: number | null;
+            window_seconds: number | null;
+            resets_at: string | null;
+            cooldown_until?: string | null | undefined;
+        }[];
+        observed_at: string;
+        freshness: "unknown" | "fresh" | "stale";
+    }[];
+    refreshed_at: string | null;
+}>;
+export type ControlQuotaResponse = z.infer<typeof ControlQuotaResponse>;
+//# sourceMappingURL=quota.d.ts.map

package/dist/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,WAAW,iHAQgD,CAAC;AACzE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc,0CAE+B,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY;;;;IAKrB;;;;;mDAK+C;;;;;;;;;;;;EAMhD,CAAC;AACJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;EAUiD,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;;QA3BtB;;;;;uDAK+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BkC,CAAC;AACtF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;YAvC7B;;;;;2DAK+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwCmB,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/quota.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { Id } from "./primitives.js";
+export const QuotaSource = z
+    .enum([
+    "codex_app_server",
+    "codex_rollout",
+    "claude_statusline",
+    "claude_api_retry",
+    "claude_oauth_usage",
+])
+    .describe("Vendor-owned machine-readable source of a quota snapshot.");
+export const QuotaFreshness = z
+    .enum(["fresh", "stale", "unknown"])
+    .describe("Freshness of a quota snapshot at read time.");
+export const QuotaSubject = z
+    .object({
+    harness: Id,
+    credential_route: z.enum(["vendor_native", "managed_api_key", "local"]),
+    plan_label: z.string().nullable().default(null),
+    /** The CREDENTIAL SUBJECT the windows belong to (release wave round-16
+     * #2): a Claudexor credential-profile id, or null for the harness's
+     * engine-default credential. Every producer (oauth-usage refresher,
+     * typed-event registry, adapter quota events) uses exactly this
+     * vocabulary; budget routing filters snapshots by exact subject so one
+     * account's exhaustion never cools another. */
+    subject_id: z.string().nullable().default(null),
+})
+    .strict()
+    .describe("Quota owner and credential route; subject_id is the credential-profile id (null = the engine-default credential).");
+export const QuotaConstraint = z
+    .object({
+    id: Id,
+    label: z.string().min(1),
+    used_ratio: z.number().min(0).max(1).nullable(),
+    window_seconds: z.number().positive().nullable(),
+    resets_at: z.string().datetime({ offset: true }).nullable(),
+    cooldown_until: z.string().datetime({ offset: true }).nullable().default(null),
+})
+    .strict()
+    .describe("One independent vendor quota window; null usage stays unknown.");
+export const QuotaSnapshot = z
+    .object({
+    subject: QuotaSubject,
+    constraints: z.array(QuotaConstraint),
+    source: QuotaSource,
+    observed_at: z.string().datetime({ offset: true }),
+    freshness: QuotaFreshness,
+})
+    .strict()
+    .describe("All independently reported quota windows for one vendor-owned subject.");
+export const ControlQuotaResponse = z
+    .object({
+    snapshots: z.array(QuotaSnapshot),
+    refreshed_at: z.string().datetime({ offset: true }).nullable(),
+})
+    .strict()
+    .describe("Current quota snapshots without a fabricated aggregate.");
+//# sourceMappingURL=quota.js.map

package/dist/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAErC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,IAAI,CAAC;IACJ,kBAAkB;IAClB,eAAe;IACf,mBAAmB;IACnB,kBAAkB;IAClB,oBAAoB;CACrB,CAAC;KACD,QAAQ,CAAC,2DAA2D,CAAC,CAAC;AAGzE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;KACnC,QAAQ,CAAC,6CAA6C,CAAC,CAAC;AAG3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,OAAO,EAAE,EAAE;IACX,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACvE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C;;;;;mDAK+C;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAChD,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CACP,mHAAmH,CACpH,CAAC;AAGJ,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,EAAE,EAAE,EAAE;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC/E,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,gEAAgE,CAAC,CAAC;AAG9E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,OAAO,EAAE,YAAY;IACrB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IACrC,MAAM,EAAE,WAAW;IACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClD,SAAS,EAAE,cAAc;CAC1B,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,wEAAwE,CAAC,CAAC;AAGtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,yDAAyD,CAAC,CAAC"}

package/dist/raw.d.ts

@@ -0,0 +1,195 @@
+import { z } from "zod";
+export declare const ImplementationTransport: z.ZodEnum<["workspace", "git_patch_envelope"]>;
+export type ImplementationTransport = z.infer<typeof ImplementationTransport>;
+export declare const RawContextFile: z.ZodObject<{
+    path: z.ZodString;
+    mode: z.ZodString;
+    blob_oid: z.ZodString;
+    content_hash: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    mode: string;
+    blob_oid: string;
+    content_hash: string;
+    content: string;
+}, {
+    path: string;
+    mode: string;
+    blob_oid: string;
+    content_hash: string;
+    content: string;
+}>;
+export type RawContextFile = z.infer<typeof RawContextFile>;
+export declare const RawContextPacket: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    packet_hash: z.ZodString;
+    base_commit_sha: z.ZodString;
+    base_tree_sha: z.ZodString;
+    readable_files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        mode: z.ZodString;
+        blob_oid: z.ZodString;
+        content_hash: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        mode: string;
+        blob_oid: string;
+        content_hash: string;
+        content: string;
+    }, {
+        path: string;
+        mode: string;
+        blob_oid: string;
+        content_hash: string;
+        content: string;
+    }>, "many">;
+    editable_paths: z.ZodArray<z.ZodString, "many">;
+    creatable_roots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    file_manifest: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        disposition: z.ZodEnum<["full", "included", "manifest_only", "excluded", "sensitive", "binary", "vendored", "oversized", "read_error", "omitted"]>;
+        hash: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+        hash?: string | undefined;
+        bytes?: number | undefined;
+        reason?: string | undefined;
+    }, {
+        path: string;
+        disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+        hash?: string | undefined;
+        bytes?: number | undefined;
+        reason?: string | undefined;
+    }>, "many">;
+    omissions: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+        replacement: z.ZodDefault<z.ZodEnum<["summary", "map", "index", "none"]>>;
+        hash: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        reason: string;
+        replacement: "map" | "none" | "summary" | "index";
+        hash?: string | undefined;
+    }, {
+        path: string;
+        reason: string;
+        hash?: string | undefined;
+        replacement?: "map" | "none" | "summary" | "index" | undefined;
+    }>, "many">;
+    evidence_refs: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    packet_hash: string;
+    base_commit_sha: string;
+    base_tree_sha: string;
+    readable_files: {
+        path: string;
+        mode: string;
+        blob_oid: string;
+        content_hash: string;
+        content: string;
+    }[];
+    editable_paths: string[];
+    creatable_roots: string[];
+    file_manifest: {
+        path: string;
+        disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+        hash?: string | undefined;
+        bytes?: number | undefined;
+        reason?: string | undefined;
+    }[];
+    omissions: {
+        path: string;
+        reason: string;
+        replacement: "map" | "none" | "summary" | "index";
+        hash?: string | undefined;
+    }[];
+    evidence_refs: string[];
+}, {
+    schema_version: 1;
+    packet_hash: string;
+    base_commit_sha: string;
+    base_tree_sha: string;
+    readable_files: {
+        path: string;
+        mode: string;
+        blob_oid: string;
+        content_hash: string;
+        content: string;
+    }[];
+    editable_paths: string[];
+    file_manifest: {
+        path: string;
+        disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+        hash?: string | undefined;
+        bytes?: number | undefined;
+        reason?: string | undefined;
+    }[];
+    omissions: {
+        path: string;
+        reason: string;
+        hash?: string | undefined;
+        replacement?: "map" | "none" | "summary" | "index" | undefined;
+    }[];
+    evidence_refs: string[];
+    creatable_roots?: string[] | undefined;
+}>;
+export type RawContextPacket = z.infer<typeof RawContextPacket>;
+export declare const RawPatchPathEvidence: z.ZodObject<{
+    path: z.ZodString;
+    expected_blob_oid: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    expected_blob_oid: string | null;
+}, {
+    path: string;
+    expected_blob_oid: string | null;
+}>;
+export type RawPatchPathEvidence = z.infer<typeof RawPatchPathEvidence>;
+export declare const RawGitPatchEnvelope: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    context_packet_hash: z.ZodString;
+    base_tree_sha: z.ZodString;
+    patch: z.ZodString;
+    patch_hash: z.ZodString;
+    touched_paths: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        expected_blob_oid: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        expected_blob_oid: string | null;
+    }, {
+        path: string;
+        expected_blob_oid: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    base_tree_sha: string;
+    context_packet_hash: string;
+    patch: string;
+    patch_hash: string;
+    touched_paths: {
+        path: string;
+        expected_blob_oid: string | null;
+    }[];
+}, {
+    schema_version: 1;
+    base_tree_sha: string;
+    context_packet_hash: string;
+    patch: string;
+    patch_hash: string;
+    touched_paths: {
+        path: string;
+        expected_blob_oid: string | null;
+    }[];
+}>;
+export type RawGitPatchEnvelope = z.infer<typeof RawGitPatchEnvelope>;
+export declare const RawPatchRefusalCode: z.ZodEnum<["raw_patch_requires_isolation", "raw_patch_missing_evidence", "raw_patch_digest_mismatch", "raw_patch_base_mismatch", "raw_patch_path_traversal", "raw_patch_outside_scope", "raw_patch_stale_preimage", "raw_patch_binary_unsupported", "raw_patch_sensitive_content", "raw_patch_truncated", "raw_patch_apply_failed"]>;
+export type RawPatchRefusalCode = z.infer<typeof RawPatchRefusalCode>;
+//# sourceMappingURL=raw.d.ts.map

package/dist/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../src/raw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,uBAAuB,gDAIjC,CAAC;AACJ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;;;;;;;EAO/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,mBAAmB,sUAY9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/raw.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { ContentHash } from "./primitives.js";
+import { OmissionEntry, ScopeAtlasEntry } from "./context.js";
+export const ImplementationTransport = z
+    .enum(["workspace", "git_patch_envelope"])
+    .describe("How an implementing harness returns changes: direct isolated-workspace edits or a typed Git patch envelope.");
+export const RawContextFile = z.object({
+    path: z.string().min(1).describe("Exact repo-relative readable/editable path."),
+    mode: z.string().describe("Git object mode at the bound base tree."),
+    blob_oid: z.string().min(1).describe("Git blob oid at the bound base tree."),
+    content_hash: ContentHash,
+    content: z.string().describe("Complete text content; never truncated."),
+});
+export const RawContextPacket = z.object({
+    schema_version: z.literal(1),
+    packet_hash: ContentHash,
+    base_commit_sha: z.string().min(1),
+    base_tree_sha: z.string().min(1),
+    readable_files: z.array(RawContextFile),
+    editable_paths: z.array(z.string().min(1)),
+    creatable_roots: z
+        .array(z.string().min(1))
+        .default([])
+        .describe("Exact repo-relative roots where a patch may add a new path; '.' means the project root."),
+    file_manifest: z.array(ScopeAtlasEntry),
+    omissions: z.array(OmissionEntry),
+    evidence_refs: z.array(z.string().min(1)),
+});
+export const RawPatchPathEvidence = z.object({
+    path: z.string().min(1),
+    expected_blob_oid: z
+        .string()
+        .min(1)
+        .nullable()
+        .describe("Base-tree blob oid, or null only when the path is absent in the base tree."),
+});
+export const RawGitPatchEnvelope = z.object({
+    schema_version: z.literal(1),
+    context_packet_hash: ContentHash,
+    base_tree_sha: z.string().min(1),
+    patch: z.string().min(1),
+    patch_hash: ContentHash,
+    touched_paths: z.array(RawPatchPathEvidence).min(1),
+});
+export const RawPatchRefusalCode = z.enum([
+    "raw_patch_requires_isolation",
+    "raw_patch_missing_evidence",
+    "raw_patch_digest_mismatch",
+    "raw_patch_base_mismatch",
+    "raw_patch_path_traversal",
+    "raw_patch_outside_scope",
+    "raw_patch_stale_preimage",
+    "raw_patch_binary_unsupported",
+    "raw_patch_sensitive_content",
+    "raw_patch_truncated",
+    "raw_patch_apply_failed",
+]);
+//# sourceMappingURL=raw.js.map

package/dist/raw.js.map

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