@claudexor/schema 1.0.0

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,aAAa,gCAEoF,CAAC;AAC/G,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BvB,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,8EAA8E;AAC9E,eAAO,MAAM,WAAW;;;;IAKpB;;;;;;OAMG;;;;;;;;;;;;EAU4H,CAAC;AACpI,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,qDAAqD;AACrD,eAAO,MAAM,YAAY;;;IAIrB;;;;OAIG;;;;;;QAcC;;;;WAIG;;QAKH,iEAAiE;;QAEjE;;;;WAIG;;;;;;;;;;;;;;;;;;;QAYH;;;;;;;WAOG;;;;;;;;;;QAcH;;;WAGG;;;;;;;;;;;;;;;QAWH;;;;;;;;;WASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4BC,4EAA4E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUoC,CAAC;AAC7H,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,kEAAkE;AAClE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA3JvB;;;;;;WAMG;;;;;;;;;;;;;;;;QAkBH;;;;WAIG;;;;;;YAcC;;;;eAIG;;YAKH,iEAAiE;;YAEjE;;;;eAIG;;;;;;;;;;;;;;;;;;;YAYH;;;;;;;eAOG;;;;;;;;;;YAcH;;;eAGG;;;;;;;;;;;;;;;YAWH;;;;;;;;;eASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA4BC,4EAA4E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBd,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/config.js

@@ -0,0 +1,194 @@
+import { z } from "zod";
+import { AccessProfile, AuthPreference, ExternalContextPolicy, ProviderFamily } from "./primitives.js";
+import { EffortHint } from "./harness.js";
+import { Portfolio } from "./budget.js";
+// The former "portfolio" value was deleted as a fake knob (it behaved
+// identically to "auto"); the config loader migrates it to "auto".
+export const RoutingPolicy = z
+    .enum(["auto", "primary"])
+    .describe("Default routing policy: auto (engine picks) or primary (prefer the configured primary harness).");
+/**
+ * Project config — safe, versioned settings. This shape may NOT carry sensitive
+ * settings (full access, secrets, budget-above-cap, plugin auto-install, etc.);
+ * those live only in global/user-local/trust configs and are modeled separately.
+ */
+export const ProjectConfig = z
+    .object({
+    version: z.literal(1).default(1).describe("Config format version."),
+    context: z
+        .object({
+        mandatory_files: z.array(z.string()).default([]).describe("Files every context pack must include."),
+        include: z.array(z.string()).default([]).describe("Globs to include in context building."),
+        exclude: z.array(z.string()).default([]).describe("Globs to exclude from context building."),
+    })
+        .strict()
+        .default({})
+        .describe("Context-building preferences for the project."),
+    tests: z
+        .object({ commands: z.array(z.string()).default([]).describe("Test commands run as deterministic gates.") })
+        .strict()
+        .default({ commands: [] })
+        .describe("Project-configured deterministic test gates."),
+    budget: z
+        .object({ portfolio: Portfolio.default("subscription-first") })
+        .strict()
+        .default({ portfolio: "subscription-first" })
+        .describe("Project budget preferences."),
+})
+    .strict()
+    .describe("Project config (.claudexor/config.yaml) — safe, versioned settings only; sensitive settings live in global/user-local/trust configs.");
+/** Sensitive trust settings — only valid in global/user-local/trust files. */
+export const TrustConfig = z
+    .object({
+    version: z.literal(1).default(1).describe("Config format version."),
+    access_default: AccessProfile.default("workspace_write").describe("Default access profile for runs in this repo."),
+    allow_full_access: z.boolean().default(false).describe("Per-repo allow required before any run may use the full access profile."),
+    /**
+     * Provenance ONLY: which repo root this file was written for. The file's
+     * key stays the repo-root HASH in its filename — this field never gates
+     * anything; it exists so trust state is enumerable (Settings lists the
+     * projects with full access). Legacy files (written before this field)
+     * carry null and surfaces disclose them as revocable only via CLI.
+     */
+    repo_root: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Provenance only: repo root this trust file was written for; never gates anything. Null on legacy files written before this field."),
+})
+    .strict()
+    .describe("Sensitive per-repo trust settings — only valid in global/user-local trust files, never in the versioned repo config.");
+/** Global user config (~/.claudexor/config.yaml). */
+export const GlobalConfig = z
+    .object({
+    version: z.literal(1).default(1).describe("Config format version."),
+    default_portfolio: Portfolio.default("subscription-first").describe("Budget portfolio used when a run does not specify one."),
+    /**
+     * How long an interactive run waits for the user's answer to a harness
+     * question (interaction.requested) before delivering a benign decline and
+     * letting the model continue with assumptions.
+     */
+    interaction_timeout_ms: z
+        .number()
+        .int()
+        .positive()
+        .default(900_000)
+        .describe("How long an interactive run waits for the user's answer to a harness question before delivering a benign decline and letting the model continue."),
+    routing: z
+        .object({
+        default_policy: RoutingPolicy.default("auto"),
+        primary_harness: z.string().nullable().default(null).describe("Global default primary harness; null = engine decides."),
+        eligible_harnesses: z.array(z.string()).default([]).describe("Harness pool eligible for routing/races; empty = all available."),
+        /**
+         * How the child harness env is built: `mirror_native` inherits the user's
+         * shell env (default, matches how the native CLIs run); `clean` spawns from
+         * a minimal allowlist (agent env isolation).
+         */
+        env_inheritance: z
+            .enum(["mirror_native", "clean"])
+            .default("mirror_native")
+            .describe("How the child harness env is built: mirror_native inherits the user's shell env; clean spawns from a minimal allowlist."),
+        /** Default auth route preference (subscription/api_key/auto). */
+        auth_preference: AuthPreference.default("auto"),
+        /**
+         * Operator-tunable per-provider-family quality priors (0..1) feeding
+         * RouterCandidate.qualityForIntent. A DECLARED prior, not
+         * invented magic: unset families ride the router's neutral 0.5.
+         */
+        quality_priors: z
+            .record(ProviderFamily, z.number().min(0).max(1))
+            .default({})
+            .describe("Operator-tunable per-provider-family quality priors (0..1) feeding the router; unset families ride the neutral 0.5."),
+    })
+        .strict()
+        .default({})
+        .describe("Global routing defaults."),
+    budget: z
+        .object({
+        max_usd_per_run: z.number().nonnegative().nullable().default(null).describe("Global USD cap per run; null = no cap."),
+        /**
+         * Per-candidate reservation floor (USD) held against the run cap for
+         * every race-wave slot AFTER the first, BEFORE any usage streams.
+         * Makes concurrent in-flight candidates visible to the budget breaker
+         * so a parallel wave cannot blow past `max_usd_per_run` between
+         * settlements. The first slot never holds it: a cap smaller than the
+         * floor still runs one candidate and stops on real usage.
+         */
+        estimate_usd_floor: z
+            .number()
+            .nonnegative()
+            .default(0.05)
+            .describe("Per-candidate USD reservation floor held against the run cap for every race-wave slot after the first, so a parallel wave cannot blow past the cap between settlements."),
+    })
+        .strict()
+        .default({})
+        .describe("Global budget limits."),
+    runtime: z
+        .object({
+        /**
+         * Bounded retry policy for adapter-declared transient failures. User-global
+         * only: a versioned repo must not silently increase operator runtime costs.
+         */
+        transient_retry: z
+            .object({
+            max_retries: z.number().int().min(0).max(5).default(2).describe("Maximum retries for a transient failure."),
+            initial_delay_ms: z.number().int().nonnegative().default(1_000).describe("Initial retry delay in milliseconds."),
+            max_delay_ms: z.number().int().nonnegative().default(10_000).describe("Maximum retry delay in milliseconds."),
+        })
+            .strict()
+            .default({})
+            .describe("Bounded retry policy for adapter-declared transient failures; user-global only."),
+        reviewer_timeout_ms: z.number().int().positive().default(600_000).describe("Wall-clock timeout for a reviewer run, in milliseconds."),
+        /**
+         * Inactivity watchdog for candidate/planner/read-only harness streams:
+         * NO events for this window means the CLI is wedged — the stream is
+         * aborted (process-group kill) and the attempt fails with a typed
+         * timeout instead of parking the run in `running` forever. Distinct
+         * from the reviewer wall-clock timeout: long runs are fine as long as
+         * they keep emitting. Note the timer resets on HARNESS events — a tool
+         * call that streams nothing for the whole window is indistinguishable
+         * from a hang and will be killed.
+         */
+        harness_inactivity_timeout_ms: z
+            .number()
+            .int()
+            .positive()
+            .default(1_200_000)
+            .describe("Inactivity watchdog for harness streams: no events for this window aborts the stream and fails the attempt with a typed timeout."),
+    })
+        .strict()
+        .default({})
+        .describe("Global runtime timeouts and retry policy."),
+    harnesses: z
+        .record(z.string(), z
+        .object({
+        enabled: z.boolean().default(true).describe("Whether the harness participates in routing."),
+        default_model: z.string().nullable().default(null).describe("Per-harness default model; null = the harness's own default."),
+        effort: EffortHint.nullable().default(null).describe("Default reasoning effort for the harness; null = harness default."),
+        max_turns: z.number().int().positive().nullable().default(null).describe("Default max agent turns; null = no limit."),
+        max_rounds: z.number().int().positive().nullable().default(null).describe("Default max convergence rounds; null = engine default."),
+        max_usd: z.number().nonnegative().nullable().default(null).describe("Per-harness USD cap; null = no cap."),
+        tools_allow: z.array(z.string()).default([]).describe("Tool names allowed for this harness."),
+        tools_deny: z.array(z.string()).default([]).describe("Tool names denied for this harness."),
+        fallback_model: z.string().nullable().default(null).describe("Model to fall back to on typed fallback signals; null = none."),
+        web: ExternalContextPolicy.default("auto").describe("Default web policy for this harness."),
+        /** Per-harness auth route preference; overrides routing.auth_preference. */
+        auth_preference: AuthPreference.default("auto"),
+    })
+        .strict()
+        .describe("Per-harness settings."))
+        .default({})
+        .describe("Per-harness settings keyed by harness id."),
+})
+    .strict()
+    .describe("Global user config (~/.claudexor/config.yaml): portfolio, routing, budget, runtime, and per-harness settings.");
+/** The fully-resolved effective config after precedence merge. */
+export const ResolvedConfig = z
+    .object({
+    project: ProjectConfig,
+    trust: TrustConfig,
+    global: GlobalConfig,
+    sources: z.array(z.string()).default([]).describe("Config file paths that contributed to the merge."),
+})
+    .describe("The fully-resolved effective config after precedence merge.");
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,222 @@
+import { z } from "zod";
+/** How a tracked path was accounted for in the Scope Atlas. No path is ever silently dropped. */
+export declare const PathDisposition: z.ZodEnum<["full", "included", "manifest_only", "excluded", "sensitive", "binary", "vendored", "oversized", "read_error", "omitted"]>;
+export type PathDisposition = z.infer<typeof PathDisposition>;
+export declare const ScopeAtlasEntry: 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";
+    reason?: string | undefined;
+    hash?: string | undefined;
+    bytes?: number | undefined;
+}, {
+    path: string;
+    disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+    reason?: string | undefined;
+    hash?: string | undefined;
+    bytes?: number | undefined;
+}>;
+export type ScopeAtlasEntry = z.infer<typeof ScopeAtlasEntry>;
+export declare const OmissionEntry: 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;
+}>;
+export type OmissionEntry = z.infer<typeof OmissionEntry>;
+export declare const ContextFileRef: z.ZodObject<{
+    path: z.ZodString;
+    hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    hash: string;
+}, {
+    path: string;
+    hash: string;
+}>;
+export type ContextFileRef = z.infer<typeof ContextFileRef>;
+/**
+ * The deterministic, hashable bundle every harness receives. Built from the
+ * TaskContract + repo state. Omissions are explicit; nothing is silently cut.
+ */
+export declare const ContextPack: z.ZodObject<{
+    task_contract_hash: z.ZodString;
+    hash: z.ZodString;
+    files: z.ZodObject<{
+        mandatory: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            hash: string;
+        }, {
+            path: string;
+            hash: string;
+        }>, "many">>;
+        included: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            hash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            hash: string;
+        }, {
+            path: string;
+            hash: string;
+        }>, "many">>;
+        omitted: z.ZodDefault<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">>;
+    }, "strip", z.ZodTypeAny, {
+        included: {
+            path: string;
+            hash: string;
+        }[];
+        omitted: {
+            path: string;
+            reason: string;
+            replacement: "map" | "none" | "summary" | "index";
+            hash?: string | undefined;
+        }[];
+        mandatory: {
+            path: string;
+            hash: string;
+        }[];
+    }, {
+        included?: {
+            path: string;
+            hash: string;
+        }[] | undefined;
+        omitted?: {
+            path: string;
+            reason: string;
+            hash?: string | undefined;
+            replacement?: "map" | "none" | "summary" | "index" | undefined;
+        }[] | undefined;
+        mandatory?: {
+            path: string;
+            hash: string;
+        }[] | undefined;
+    }>;
+    atlas: z.ZodDefault<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";
+        reason?: string | undefined;
+        hash?: string | undefined;
+        bytes?: number | undefined;
+    }, {
+        path: string;
+        disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+        reason?: string | undefined;
+        hash?: string | undefined;
+        bytes?: number | undefined;
+    }>, "many">>;
+    instructions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    token_budget: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        estimated_used: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        estimated_used: number;
+    }, {
+        limit: number;
+        estimated_used: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    hash: string;
+    task_contract_hash: string;
+    files: {
+        included: {
+            path: string;
+            hash: string;
+        }[];
+        omitted: {
+            path: string;
+            reason: string;
+            replacement: "map" | "none" | "summary" | "index";
+            hash?: string | undefined;
+        }[];
+        mandatory: {
+            path: string;
+            hash: string;
+        }[];
+    };
+    atlas: {
+        path: string;
+        disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+        reason?: string | undefined;
+        hash?: string | undefined;
+        bytes?: number | undefined;
+    }[];
+    instructions: string[];
+    token_budget?: {
+        limit: number;
+        estimated_used: number;
+    } | undefined;
+}, {
+    hash: string;
+    task_contract_hash: string;
+    files: {
+        included?: {
+            path: string;
+            hash: string;
+        }[] | undefined;
+        omitted?: {
+            path: string;
+            reason: string;
+            hash?: string | undefined;
+            replacement?: "map" | "none" | "summary" | "index" | undefined;
+        }[] | undefined;
+        mandatory?: {
+            path: string;
+            hash: string;
+        }[] | undefined;
+    };
+    atlas?: {
+        path: string;
+        disposition: "full" | "included" | "manifest_only" | "excluded" | "sensitive" | "binary" | "vendored" | "oversized" | "read_error" | "omitted";
+        reason?: string | undefined;
+        hash?: string | undefined;
+        bytes?: number | undefined;
+    }[] | undefined;
+    instructions?: string[] | undefined;
+    token_budget?: {
+        limit: number;
+        estimated_used: number;
+    } | undefined;
+}>;
+export type ContextPack = z.infer<typeof ContextPack>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,iGAAiG;AACjG,eAAO,MAAM,eAAe,uIAezB,CAAC;AACJ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAQ4C,CAAC;AACzE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAUiE,CAAC;AAC5F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc;;;;;;;;;EAKqC,CAAC;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/context.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { ContentHash } from "./primitives.js";
+/** How a tracked path was accounted for in the Scope Atlas. No path is ever silently dropped. */
+export const PathDisposition = z
+    .enum([
+    "full",
+    "included",
+    "manifest_only",
+    "excluded",
+    "sensitive",
+    "binary",
+    "vendored",
+    "oversized",
+    "read_error",
+    "omitted",
+])
+    .describe("How a tracked path was accounted for in the Scope Atlas (full/included content, manifest_only, or excluded/sensitive/binary/vendored/oversized/read_error/omitted); no path is ever silently dropped.");
+export const ScopeAtlasEntry = z
+    .object({
+    path: z.string().describe("Repo-relative path."),
+    disposition: PathDisposition,
+    hash: ContentHash.optional().describe("Content hash of the path, when read."),
+    bytes: z.number().int().nonnegative().optional().describe("Size of the path in bytes, when known."),
+    reason: z.string().optional().describe("Why the path got this disposition."),
+})
+    .describe("Accounting entry for one tracked path in the Scope Atlas.");
+export const OmissionEntry = z
+    .object({
+    path: z.string().describe("Repo-relative path that was omitted."),
+    reason: z.string().describe("Why the path was omitted."),
+    replacement: z
+        .enum(["summary", "map", "index", "none"])
+        .default("none")
+        .describe("What stands in for the omitted content: a summary, a map, an index, or nothing."),
+    hash: ContentHash.optional().describe("Content hash of the omitted file, when known."),
+})
+    .describe("Explicit record of a file omitted from the context; nothing is silently cut.");
+export const ContextFileRef = z
+    .object({
+    path: z.string().describe("Repo-relative path of the included file."),
+    hash: ContentHash.describe("Content hash of the file as included."),
+})
+    .describe("Reference to a file included in the context pack.");
+/**
+ * The deterministic, hashable bundle every harness receives. Built from the
+ * TaskContract + repo state. Omissions are explicit; nothing is silently cut.
+ */
+export const ContextPack = z
+    .object({
+    task_contract_hash: ContentHash.describe("Hash of the TaskContract this pack was built from."),
+    hash: ContentHash.describe("Content hash of the pack itself."),
+    files: z
+        .object({
+        mandatory: z.array(ContextFileRef).default([]).describe("Files every harness must receive."),
+        included: z.array(ContextFileRef).default([]).describe("Additional files included in the pack."),
+        omitted: z.array(OmissionEntry).default([]).describe("Files explicitly omitted, with reasons."),
+    })
+        .describe("Files included in or explicitly omitted from the pack."),
+    atlas: z.array(ScopeAtlasEntry).default([]).describe("Scope Atlas: per-path accounting of the whole tracked tree."),
+    instructions: z.array(z.string()).default([]).describe("Instruction strings passed alongside the files."),
+    token_budget: z
+        .object({
+        limit: z.number().int().positive().describe("Token budget limit for the pack."),
+        estimated_used: z.number().int().nonnegative().describe("Estimated tokens consumed by the pack."),
+    })
+        .optional()
+        .describe("Token budget accounting for the pack, when computed."),
+})
+    .describe("The deterministic, hashable context bundle every harness receives, built from the TaskContract plus repo state; omissions are explicit.");
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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