@claudexor/schema 3.0.4 → 3.1.0

package/dist/telemetry.d.ts.map

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

package/dist/telemetry.js

@@ -1,10 +1,13 @@
 import { z } from "zod";
-import { AccessProfile, ExternalContextPolicy, Id, IsoTimestamp, ModeKind, SchemaVersion, } from "./primitives.js";
+import { AccessProfile, ContentHash, ExternalContextPolicy, Id, IsoTimestamp, ModeKind, SchemaVersion, } from "./primitives.js";
+import { OutputSchemaDialect } from "./output-schema-dialect.js";
+import { DeepScanSynthesis } from "./deep-scan.js";
 import { ToolKind } from "./tool-ref.js";
-import { AuthMode } from "./budget.js";
+import { AuthMode, RouteRankingRationale } from "./budget.js";
 import { AuthPreference } from "./primitives.js";
 import { AuthRouteReason, AuthSourceKind } from "./auth.js";
 import { RequestRequirementResolution } from "./request-requirements.js";
+import { WorkState } from "./work-report.js";
 /**
  * Run telemetry artifact (`final/telemetry.yaml`).
  *
@@ -29,6 +32,20 @@ export const WebEvidenceRecord = z
         .default(false)
         .describe("Whether the web-evidence requirement was satisfied."),
     status: WebEvidenceStatus.default("none"),
+    /**
+     * QA-042: retrieval STRENGTH of a satisfied/attempted web requirement,
+     * orthogonal to `status`. `verified` = at least one web result carried a
+     * typed successful retrieval (e.g. claude WebFetch content, a browser
+     * navigation); `dispatched` = web activity completed but the route exposes
+     * no typed fetch outcome (codex `web_search`/`open_page`), so the gate is
+     * satisfied at dispatch strength but content is NOT proven; `none` = no web
+     * activity. A surface renders "Web verified" only for `verified`, never for
+     * a dispatch-only route (which is honestly "Web reached").
+     */
+    verification: z
+        .enum(["verified", "dispatched", "none"])
+        .default("none")
+        .describe("Retrieval strength of the web evidence: verified (typed retrieval), dispatched (completed but no typed outcome), or none."),
     tool: z
         .string()
         .nullable()
@@ -68,12 +85,38 @@ export const ToolErrorRecord = z
         .describe("Tool use id correlating the error to its call, when known."),
 })
     .describe("One tool error observed during an attempt.");
+/**
+ * Typed taxonomy (GH #31) the orchestrator classifies every adapter/harness
+ * transient failure into at the adapter→orchestrator boundary. Orthogonal to
+ * the fine-grained `kind`: the retry policy gates on this category's
+ * `retryable` verdict, and required-actions attach auth guidance ONLY on
+ * `auth_failed`. Never inferred by surfaces or parsed from prose.
+ */
+export const HarnessFailureCategory = z
+    .enum([
+    "timeout",
+    "rate_limited",
+    "auth_failed",
+    "capability_refused",
+    "process_crash",
+    "config_error",
+    "unknown_harness_error",
+])
+    .describe("Typed harness-failure category (GH #31) the retry policy and required-actions read; orthogonal to the fine-grained kind.");
 export const TransientFailureRecord = z
     .object({
     kind: z
         .enum(["network", "stream_disconnect", "service_unavailable", "timeout", "unknown"])
         .default("unknown")
-        .describe("Kind of transient failure."),
+        .describe("Fine-grained kind of transient failure (adapter-declared)."),
+    /** GH #31 typed category the retry policy and required-actions read. */
+    category: HarnessFailureCategory.default("unknown_harness_error").describe("Typed failure category (GH #31) the retry policy and required-actions read; orthogonal to kind."),
+    /** Whether the classified category is retryable — the centralized retry
+     * gate reads THIS, never a bare sawTransient boolean. */
+    retryable: z
+        .boolean()
+        .default(false)
+        .describe("Whether the classified category is retryable (the centralized retry-policy gate)."),
     retry_delay_ms: z
         .number()
         .int()
@@ -81,6 +124,25 @@ export const TransientFailureRecord = z
         .nullable()
         .default(null)
         .describe("Suggested retry delay in milliseconds, when reported."),
+    /** Preserved safe provider metadata: the vendor's HTTP status when disclosed. */
+    http_status: z
+        .number()
+        .int()
+        .nullable()
+        .default(null)
+        .describe("Vendor HTTP status code disclosed by the error, when any; null otherwise."),
+    /** Process termination signal (e.g. SIGKILL) when a crash killed the child, else null. */
+    signal: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Process termination signal (e.g. SIGKILL) when a crash killed the child; null otherwise."),
+    /** Vendor/adapter error-category code passed verbatim as evidence, when any. */
+    adapter_code: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Vendor/adapter error-category code passed verbatim as evidence; null when none."),
 })
     .describe("An adapter-declared transient failure that informed bounded retry policy.");
 export const AttemptOutcomeStatus = z
@@ -106,6 +168,15 @@ export const AttemptOutcome = z
         .boolean()
         .default(false)
         .describe("True when required web evidence was not satisfied."),
+    /** QA-024: the run requested the Claudexor delegation belt (--delegate) but
+     * the injected MCP server never became operational (the harness reported it
+     * `failed`). A requested-but-unavailable belt must not terminalize a silent
+     * clean success — the harness may have degraded to its own native subagent
+     * with no Claudexor sub-run provenance. */
+    delegation_belt_unavailable: z
+        .boolean()
+        .default(false)
+        .describe("True when --delegate requested the belt but the injected MCP server failed to become operational (QA-024); blocks a silent clean success."),
     tool_warnings_count: z
         .number()
         .int()
@@ -113,6 +184,12 @@ export const AttemptOutcome = z
         .default(0)
         .describe("Count of tool warnings in the attempt."),
     status: AttemptOutcomeStatus.default("success"),
+    /**
+     * D-16 work_state axis for this attempt (INV-116): the model-attested work
+     * outcome from its WorkReport, orthogonal to `status`. Absent when the
+     * route carries no work_report transport (pre-D16 shape preserved).
+     */
+    work_state: WorkState.optional().describe("D-16 model-attested work outcome for the attempt (from its WorkReport), orthogonal to status; absent when the route has no work_report transport."),
 })
     .describe("Contract/outcome truth for one attempt; tool errors are tracked separately from deliverable production.");
 /**
@@ -123,6 +200,12 @@ export const AttemptOutcome = z
 export const StructuredOutputConformance = z
     .object({
     schema_version: SchemaVersion,
+    schema_dialect: OutputSchemaDialect.nullable()
+        .default(null)
+        .describe("Dialect used to compile and validate the caller schema; null only for legacy receipts."),
+    schema_hash: ContentHash.nullable()
+        .default(null)
+        .describe("Stable hash of the original caller schema; null only for legacy receipts written before schema identity was recorded."),
     status: z
         .enum(["passed", "failed"])
         .describe("Whether the final answer conformed to the run's output schema."),
@@ -137,7 +220,7 @@ export const StructuredOutputConformance = z
         .string()
         .nullable()
         .default(null)
-        .describe("Artifact path of the materialized structured output (final/output.json); null when the answer never parsed."),
+        .describe("Artifact path of the materialized structured output: final/output.json when conformant, final/output.invalid.json when parsed but non-conformant; null when the answer never parsed."),
     generated_at: IsoTimestamp.describe("When the receipt was generated."),
 })
     .describe("Structured-output conformance receipt (final/structured_output.yaml): the single engine validator's verdict on the final answer.");
@@ -148,6 +231,79 @@ export const TokenUsage = z
     cached_input_tokens: z.number().int().nonnegative().nullable().default(null),
 })
     .describe("Token usage summed from harness usage events; money is tracked separately in the budget ledger, not here. Each field is null until a harness reports it (cursor reports cost only; raw-api has no cached), so unreported never reads as 0. Do NOT sum into a grand total: codex cached is a subset of input while claude cached is disjoint from input.");
+/**
+ * Runtime readiness receipt for the Claudexor delegation belt (D32) on one
+ * attempt (QA-024). The preflight/descriptor layer refuses TYPED when no belt
+ * `cli.js` entry exists; THIS record is the complementary runtime truth: when a
+ * belt WAS injected, did the harness's MCP server actually come up, and did any
+ * belt tool actually run? A `failed` server with zero tool evidence is the
+ * false-success trap — the harness saw no `mcp__claudexor__*` tools and may
+ * have answered from its own native subagent with no Claudexor sub-run.
+ */
+export const DelegationBeltEvidence = z
+    .object({
+    requested: z
+        .boolean()
+        .default(false)
+        .describe("A Claudexor delegation belt MCP server was injected into this attempt's sandbox."),
+    server_name: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("The injected belt MCP server name (as the harness reports it); null when unknown."),
+    ready: z
+        .boolean()
+        .default(false)
+        .describe("The harness reported the injected belt MCP server as connected/ready."),
+    failed: z
+        .boolean()
+        .default(false)
+        .describe("The harness reported the injected belt MCP server as failed to start."),
+    tool_evidence: z
+        .boolean()
+        .default(false)
+        .describe("At least one belt tool (mcp__<server>__*) was actually invoked in this attempt."),
+})
+    .describe("Runtime readiness receipt for the injected Claudexor delegation belt on one attempt (QA-024).");
+/**
+ * QA-040: runtime browser-MCP evidence for one attempt. `requested` is set when
+ * the engine armed the Playwright browser injection for this lane (the injected
+ * server name is known — a fixed `browser` namespace). `attempted`/`satisfied`/
+ * `failed` flip from the run's tool events matched to that injected server, so a
+ * successful browser navigation is recognized as trusted live-web activity even
+ * though the adapter normalizes browser calls as `kind:"mcp"` (codex/claude both
+ * do). `unused` discloses an armed-but-never-called browser (a generic
+ * web_search satisfied instead) WITHOUT failing the run — disclosure only.
+ */
+export const BrowserEvidenceRecord = z
+    .object({
+    requested: z
+        .boolean()
+        .default(false)
+        .describe("The engine armed (injected) the browser MCP for this attempt."),
+    server_name: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("The injected browser MCP server name; null when not armed."),
+    attempted: z
+        .boolean()
+        .default(false)
+        .describe("At least one browser MCP tool call (matched to the injected server) occurred."),
+    satisfied: z
+        .boolean()
+        .default(false)
+        .describe("At least one browser MCP tool call succeeded (trusted live-web activity)."),
+    failed: z
+        .boolean()
+        .default(false)
+        .describe("A browser MCP tool call failed and was not superseded by a success."),
+    unused: z
+        .boolean()
+        .default(false)
+        .describe("The browser was armed but never called while generic web evidence satisfied the run (disclosure only; not a failure)."),
+})
+    .describe("Runtime browser-MCP evidence for one attempt (QA-040).");
 export const AttemptTelemetryRecord = z
     .object({
     attempt_id: Id.describe("Attempt id."),
@@ -237,6 +393,12 @@ export const AttemptTelemetryRecord = z
         .describe("Adapter-declared transient failures that informed bounded retry policy."),
     /** Contract/outcome projection for this attempt. */
     outcome: AttemptOutcome.default({}),
+    /** Delegation-belt runtime readiness (QA-024); present only when a belt was
+     * injected into this attempt. Absent on non-delegate attempts. */
+    delegation_belt: DelegationBeltEvidence.optional(),
+    /** Browser-MCP runtime evidence (QA-040); present only when the browser was
+     * armed for this attempt. Absent when the browser was not injected. */
+    browser: BrowserEvidenceRecord.optional(),
     /** Token usage summed across this attempt's usage events. */
     usage: TokenUsage.default({}),
 })
@@ -312,6 +474,17 @@ export const RunTelemetry = z
         .nullable()
         .default(null)
         .describe("Auth route receipt: requested preference, disclosed effective route/source, deterministic reason, and the disclosing attempt; surfaces project it verbatim."),
+    /** Typed routing rationale (QA-034) recorded ONCE at pool ordering: the
+     * ordered/dropped pool, the decisive reason, and per-candidate billing/cost
+     * tuples. Run evidence, not an event. Null on legacy artifacts and on runs
+     * with an explicit single-harness pool where no ranking was computed. */
+    routing_rationale: RouteRankingRationale.nullable()
+        .default(null)
+        .describe("Typed routing rationale recorded once at pool ordering (QA-034); null on legacy artifacts or when no ranking was computed."),
+    /** Deep-scan reducer outcome (#27 / D-6); null on non-deep-scan/legacy runs. */
+    deep_scan_synthesis: DeepScanSynthesis.nullable()
+        .default(null)
+        .describe("Deep-scan reducer outcome (#27); null on non-deep-scan runs and legacy artifacts."),
     generated_at: IsoTimestamp.describe("When the telemetry artifact was generated."),
 })
     .describe("Run telemetry artifact (final/telemetry.yaml), the single computed source of web/tool evidence; surfaces project it and never re-derive evidence from raw events.");

package/dist/telemetry.js.map

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

package/dist/tool-ref.d.ts

@@ -22,6 +22,18 @@ export declare const ToolRef: z.ZodObject<{
     /** Redacted, bounded content detail for results (success or failure). */
     content_summary: z.ZodOptional<z.ZodString>;
     exit_code: z.ZodOptional<z.ZodNumber>;
+    /**
+     * QA-042: adapter-stamped RETRIEVAL outcome for a web/browser tool result,
+     * distinct from `status` (the tool-call LIFECYCLE). `verified` = the vendor
+     * exposed a typed successful retrieval (content/page present); `dispatched`
+     * = the tool call completed but the vendor exposes NO typed fetch outcome
+     * (codex `web_search`/`open_page` — a completed item can hide a 502), so the
+     * evidence is dispatch-only, not proof of content; `failed` = a typed
+     * retrieval failure. Absent on non-web tools and on adapters that do not
+     * stamp it. The engine reads THIS (never prose) to separate "web reached"
+     * from "web verified".
+     */
+    web_retrieval: z.ZodOptional<z.ZodEnum<["verified", "dispatched", "failed"]>>;
 }, "strip", z.ZodTypeAny, {
     kind: "web" | "file" | "command" | "mcp" | "search" | "other";
     name: string;
@@ -31,6 +43,7 @@ export declare const ToolRef: z.ZodObject<{
     error_summary?: string | undefined;
     content_summary?: string | undefined;
     exit_code?: number | undefined;
+    web_retrieval?: "failed" | "verified" | "dispatched" | undefined;
 }, {
     name: string;
     status?: "cancelled" | "ok" | "error" | "denied" | undefined;
@@ -40,6 +53,7 @@ export declare const ToolRef: z.ZodObject<{
     error_summary?: string | undefined;
     content_summary?: string | undefined;
     exit_code?: number | undefined;
+    web_retrieval?: "failed" | "verified" | "dispatched" | undefined;
 }>;
 export type ToolRef = z.infer<typeof ToolRef>;
 //# sourceMappingURL=tool-ref.d.ts.map

package/dist/tool-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ref.d.ts","sourceRoot":"","sources":["../src/tool-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,QAAQ,iEAIlB,CAAC;AACJ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;IAKhB,wEAAwE;;;IAWxE,+DAA+D;;IAK/D,yEAAyE;;;;;;;;;;;;;;;;;;;;;EAWA,CAAC;AAC9E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC"}
+{"version":3,"file":"tool-ref.d.ts","sourceRoot":"","sources":["../src/tool-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,QAAQ,iEAIlB,CAAC;AACJ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;IAKhB,wEAAwE;;;IAWxE,+DAA+D;;IAK/D,yEAAyE;;;IAUzE;;;;;;;;;;OAUG;;;;;;;;;;;;;;;;;;;;;;EAQsE,CAAC;AAC9E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/tool-ref.js

@@ -40,6 +40,21 @@ export const ToolRef = z
         .int()
         .optional()
         .describe("Process exit code for command tools, when known."),
+    /**
+     * QA-042: adapter-stamped RETRIEVAL outcome for a web/browser tool result,
+     * distinct from `status` (the tool-call LIFECYCLE). `verified` = the vendor
+     * exposed a typed successful retrieval (content/page present); `dispatched`
+     * = the tool call completed but the vendor exposes NO typed fetch outcome
+     * (codex `web_search`/`open_page` — a completed item can hide a 502), so the
+     * evidence is dispatch-only, not proof of content; `failed` = a typed
+     * retrieval failure. Absent on non-web tools and on adapters that do not
+     * stamp it. The engine reads THIS (never prose) to separate "web reached"
+     * from "web verified".
+     */
+    web_retrieval: z
+        .enum(["verified", "dispatched", "failed"])
+        .optional()
+        .describe("Adapter-stamped web/browser retrieval outcome (verified/dispatched/failed), distinct from the tool-call status lifecycle."),
 })
     .describe("Typed tool reference attached to tool_call/tool_result events.");
 //# sourceMappingURL=tool-ref.js.map

package/dist/tool-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ref.js","sourceRoot":"","sources":["../src/tool-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;KAC1D,QAAQ,CACP,iGAAiG,CAClG,CAAC;AAGJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACxE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACtF,wEAAwE;IACxE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;IAChF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;SAC5C,QAAQ,EAAE;SACV,QAAQ,CACP,oGAAoG,CACrG;IACH,+DAA+D;IAC/D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,yEAAyE;IACzE,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC;KACD,QAAQ,CAAC,gEAAgE,CAAC,CAAC"}
+{"version":3,"file":"tool-ref.js","sourceRoot":"","sources":["../src/tool-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;KAC1D,QAAQ,CACP,iGAAiG,CAClG,CAAC;AAGJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACxE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACtF,wEAAwE;IACxE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;IAChF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;SAC5C,QAAQ,EAAE;SACV,QAAQ,CACP,oGAAoG,CACrG;IACH,+DAA+D;IAC/D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,yEAAyE;IACzE,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D;;;;;;;;;;OAUG;IACH,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;SAC1C,QAAQ,EAAE;SACV,QAAQ,CACP,2HAA2H,CAC5H;CACJ,CAAC;KACD,QAAQ,CAAC,gEAAgE,CAAC,CAAC"}

package/dist/work-report.d.ts

@@ -0,0 +1,131 @@
+import { z } from "zod";
+/**
+ * D-16: the model-authored WorkReport — the typed self-assessment an attempt
+ * emits alongside its deliverable so the finalizer can tell "I finished" from
+ * "I need input / I ran out of room" WITHOUT prose matching. It rides the
+ * existing structured-output seam inside a compiled envelope (see
+ * `buildWorkReportEnvelope` in output-schema.ts) and is validated by the
+ * attempt finalizer, never by a Zod refinement on the wire type: the wire
+ * shape is deliberately permissive (a malformed report is a typed
+ * `work_report_contract` failure the finalizer raises, not a parse throw that
+ * loses the whole answer).
+ */
+/** What state the model says its own work reached. Cross-field rules
+ * (completed ⇒ no required_inputs; needs_input ⇒ ≥1) are enforced by the
+ * finalizer, not here — the wire type stays permissive for transport. */
+export declare const WorkReportState: z.ZodEnum<["completed", "needs_input", "incomplete"]>;
+export type WorkReportState = z.infer<typeof WorkReportState>;
+/** The category of a blocking input the model needs to proceed. */
+export declare const RequiredInputKind: z.ZodEnum<["file", "context", "credential", "permission", "decision", "external_dependency"]>;
+export type RequiredInputKind = z.infer<typeof RequiredInputKind>;
+/** One blocking input the model reports it needs. `locator` points at the
+ * concrete missing thing (a path, a URL, an env var name) when it can name it. */
+export declare const RequiredInput: z.ZodObject<{
+    kind: z.ZodEnum<["file", "context", "credential", "permission", "decision", "external_dependency"]>;
+    locator: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+    description: string;
+    locator: string | null;
+}, {
+    kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+    description: string;
+    locator?: string | null | undefined;
+}>;
+export type RequiredInput = z.infer<typeof RequiredInput>;
+/** The model-authored work self-assessment (D-16). */
+export declare const WorkReport: z.ZodObject<{
+    state: z.ZodEnum<["completed", "needs_input", "incomplete"]>;
+    required_inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["file", "context", "credential", "permission", "decision", "external_dependency"]>;
+        locator: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator: string | null;
+    }, {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator?: string | null | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    state: "completed" | "needs_input" | "incomplete";
+    required_inputs: {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator: string | null;
+    }[];
+}, {
+    state: "completed" | "needs_input" | "incomplete";
+    required_inputs?: {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator?: string | null | undefined;
+    }[] | undefined;
+}>;
+export type WorkReport = z.infer<typeof WorkReport>;
+/**
+ * How the engine OBTAINED (or failed to obtain) a WorkReport for an attempt —
+ * the provenance of the work_state axis:
+ * - `constrained`: a native schema-constrained transport carried it (codex
+ *   --output-schema, claude StructuredOutput tool).
+ * - `validated`: a whole-answer validated-JSON transport carried it (cursor).
+ * - `absent`: the route could not carry one (transport unsupported or a lane
+ *   gated the structured transport off) — a DISCLOSED absence, not a failure.
+ */
+export declare const WorkReportSource: z.ZodEnum<["constrained", "validated", "absent"]>;
+export type WorkReportSource = z.infer<typeof WorkReportSource>;
+/**
+ * The D-16 work_state axis attached to attempt/run outcomes, ORTHOGONAL to the
+ * process lifecycle (INV-116). `state` folds the WorkReport state with an
+ * `unverified` value for the disclosed-absence case (transport unsupported /
+ * lane gated). A `needs_input`/`incomplete` work_state VETOES applyability and
+ * forces a non-zero CLI exit even when the process lifecycle succeeded, but it
+ * NEVER flips the lifecycle itself.
+ */
+export declare const WorkState: z.ZodObject<{
+    state: z.ZodEnum<["completed", "needs_input", "incomplete", "unverified"]>;
+    source: z.ZodEnum<["constrained", "validated", "absent"]>;
+    required_inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["file", "context", "credential", "permission", "decision", "external_dependency"]>;
+        locator: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator: string | null;
+    }, {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator?: string | null | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    source: "constrained" | "validated" | "absent";
+    state: "completed" | "needs_input" | "incomplete" | "unverified";
+    required_inputs?: {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator: string | null;
+    }[] | undefined;
+}, {
+    source: "constrained" | "validated" | "absent";
+    state: "completed" | "needs_input" | "incomplete" | "unverified";
+    required_inputs?: {
+        kind: "file" | "context" | "decision" | "credential" | "permission" | "external_dependency";
+        description: string;
+        locator?: string | null | undefined;
+    }[] | undefined;
+}>;
+export type WorkState = z.infer<typeof WorkState>;
+/**
+ * Strict transport form of the WorkReport, hand-authored to match the Zod shape
+ * (every key required, additionalProperties:false, optional locator expressed
+ * as string|null — the vendor strict-mode recipe). This is the WorkReport half
+ * of the compiled envelope that rides `HarnessRunSpec.output_schema`. A unit
+ * test pins it against a fresh strictify of the generated WorkReport schema so
+ * drift is caught.
+ */
+export declare const WORK_REPORT_TRANSPORT_SCHEMA: Record<string, unknown>;
+//# sourceMappingURL=work-report.d.ts.map

package/dist/work-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-report.d.ts","sourceRoot":"","sources":["../src/work-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH;;yEAEyE;AACzE,eAAO,MAAM,eAAe,uDAIzB,CAAC;AACJ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,+FAI3B,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;kFACkF;AAClF,eAAO,MAAM,aAAa;;;;;;;;;;;;EAckD,CAAC;AAC7E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,sDAAsD;AACtD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAapB,CAAC;AACJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,mDAI1B,CAAC;AACJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBnB,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA+BhE,CAAC"}