@peasant-labs/schema 0.28.0 → 0.29.0

package/dist/fixtures/session-graph-capability.d.ts

@@ -1,8 +1,8 @@
 export declare function sessionGraphCapabilityFixtures(): {
     readonly requiredNames: {
-        readonly derivation: readonly ["legacy-empty", "root-null", "usage-null", "model-only", "source-ref-only", "count-only-zero", "count-only-positive", "root-only", "purpose-only-interaction", "purpose-only-delegated", "purpose-only-helper", "purpose-only-unknown", "relationship-only", "main-deeper-provenance", "folded-call-provenance", "folded-result-provenance", "earlier-only", "earlier-nested-tool-native-usage-model", "navigation-only-read", "retained-accumulates-all"];
+        readonly derivation: readonly ["legacy-empty", "root-null", "usage-null", "model-only", "source-ref-only", "count-only-zero", "count-only-positive", "root-only", "purpose-only-interaction", "purpose-only-delegated", "purpose-only-helper", "purpose-only-unknown", "relationship-only", "main-deeper-provenance", "folded-call-provenance", "folded-result-provenance", "earlier-only", "earlier-nested-tool-native-usage-model", "navigation-only-read", "retained-accumulates-all", "thinking-level-session-seed", "thinking-level-raw-only-seed", "thinking-level-root-turn", "thinking-level-earlier-nested-turn", "thinking-level-absent-needs-no-token"];
         readonly reader: readonly ["advertisement-omitted", "advertisement-empty", "advertisement-null", "advertisement-unknown-duplicate-unordered", "advertisement-future-suffix", "advertisement-retained-duplicate"];
-        readonly producer: readonly ["producer-canonical-four", "producer-unsorted-four", "producer-duplicate", "producer-unknown", "producer-canonical-retained", "producer-unsorted-retained", "producer-duplicate-retained"];
+        readonly producer: readonly ["producer-canonical-four", "producer-unsorted-four", "producer-duplicate", "producer-unknown", "producer-canonical-retained", "producer-unsorted-retained", "producer-duplicate-retained", "producer-canonical-thinking-level", "producer-unsorted-thinking-level"];
     };
     readonly derivation: {
         readonly cases: readonly [{
@@ -16,10 +16,10 @@ export declare function sessionGraphCapabilityFixtures(): {
                 readonly description: "Retained evidence accumulates every existing preservation requirement";
             };
             readonly input: {
-                readonly detailJSON: "{\"id\":\"fixture-session\",\"harness\":\"pi\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":1,\"purpose\":\"interaction\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"depth\":0,\"content\":\"\",\"timestamp\":\"2020-01-01T00:00:00Z\",\"sourceEntryRef\":\"e1\",\"observedModel\":\"provider/model\",\"usage\":{\"ownerId\":\"u1\",\"sourceEntryRef\":\"e1\",\"scope\":\"assistant\",\"completeness\":\"unknown\"},\"toolCalls\":[{\"id\":\"t1\",\"name\":\"tool\",\"namespace\":\"extension\",\"arguments\":\"\",\"result\":\"\"}]}],\"nativeMetadata\":[{\"id\":\"n1\",\"kind\":\"pi.custom.data\",\"source\":{\"entryRef\":\"custom1\",\"sourceType\":\"pi.custom\"},\"customType\":\"extension\",\"data\":{}}],\"diagnostics\":{\"partial\":true},\"retainedUnknown\":[{\"sourceRef\":\"source-0\",\"recordIndex\":2,\"position\":4,\"pointer\":\"\",\"namespace\":\"record\",\"kind\":\"future\",\"payload\":\"{\\\"type\\\":\\\"future\\\"}\"}]}";
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"harness\":\"pi\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":1,\"purpose\":\"interaction\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"depth\":0,\"content\":\"\",\"timestamp\":\"2020-01-01T00:00:00Z\",\"sourceEntryRef\":\"e1\",\"observedModel\":\"provider/model\",\"thinkingLevel\":\"ultra\",\"thinkingLevelRaw\":\"custom\",\"usage\":{\"ownerId\":\"u1\",\"sourceEntryRef\":\"e1\",\"scope\":\"assistant\",\"completeness\":\"unknown\"},\"toolCalls\":[{\"id\":\"t1\",\"name\":\"tool\",\"namespace\":\"extension\",\"arguments\":\"\",\"result\":\"\"}]}],\"nativeMetadata\":[{\"id\":\"n1\",\"kind\":\"pi.custom.data\",\"source\":{\"entryRef\":\"custom1\",\"sourceType\":\"pi.custom\"},\"customType\":\"extension\",\"data\":{}}],\"diagnostics\":{\"partial\":true},\"retainedUnknown\":[{\"sourceRef\":\"source-0\",\"recordIndex\":2,\"position\":4,\"pointer\":\"\",\"namespace\":\"record\",\"kind\":\"future\",\"payload\":\"{\\\"type\\\":\\\"future\\\"}\"}]}";
             };
             readonly expected: {
-                readonly capabilities: readonly ["detailed_usage_v1", "native_metadata_v1", "observed_model_v1", "retained_unknown_v1", "session_graph_provenance_v1", "tool_namespace_v1"];
+                readonly capabilities: readonly ["detailed_usage_v1", "native_metadata_v1", "observed_model_v1", "retained_unknown_v1", "session_graph_provenance_v1", "thinking_level_v1", "tool_namespace_v1"];
             };
         }, {
             readonly name: "legacy-empty";
@@ -315,6 +315,84 @@ export declare function sessionGraphCapabilityFixtures(): {
                 readonly rejectedDurableJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"claude-code\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[],\"relationshipNavigation\":[]}";
             };
             readonly expected: {};
+        }, {
+            readonly name: "thinking-level-session-seed";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation thinking_level_v1";
+            };
+            readonly mutation: {
+                readonly description: "adds only the session-level thinking level seed";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"codex\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"thinkingLevel\":\"high\",\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["thinking_level_v1"];
+            };
+        }, {
+            readonly name: "thinking-level-raw-only-seed";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation thinking_level_v1";
+            };
+            readonly mutation: {
+                readonly description: "adds only an unmapped raw session spelling";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"codex\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"thinkingLevelRaw\":\"custom\",\"turns\":[]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["thinking_level_v1"];
+            };
+        }, {
+            readonly name: "thinking-level-root-turn";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation thinking_level_v1";
+            };
+            readonly mutation: {
+                readonly description: "adds a level on a root assistant turn";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":0,\"harness\":\"codex\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"content\":\"\",\"depth\":0,\"thinkingLevel\":\"off\",\"thinkingLevelRaw\":\"none\",\"timestamp\":\"2020-01-01T00:00:00Z\"}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["thinking_level_v1"];
+            };
+        }, {
+            readonly name: "thinking-level-earlier-nested-turn";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation thinking_level_v1";
+            };
+            readonly mutation: {
+                readonly description: "adds a level on a nested earlier-history assistant turn";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":0,\"toolCallCount\":0,\"harness\":\"codex\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[],\"earlierHistory\":[{\"state\":\"uncertain_migrated\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\"},{\"index\":1,\"role\":\"assistant\",\"content\":\"\",\"depth\":1,\"parentIndex\":0,\"thinkingLevel\":\"medium\",\"timestamp\":\"2020-01-01T00:00:00Z\"}]}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["session_graph_provenance_v1", "thinking_level_v1"];
+            };
+        }, {
+            readonly name: "thinking-level-absent-needs-no-token";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation thinking_level_v1";
+            };
+            readonly mutation: {
+                readonly description: "omits every thinking level field";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":0,\"harness\":\"codex\",\"outcome\":\"resolved\",\"sessionOrigin\":\"unknown\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"content\":\"\",\"depth\":0,\"timestamp\":\"2020-01-01T00:00:00Z\"}]}";
+            };
+            readonly expected: {};
         }];
     };
     readonly reader: {
@@ -529,6 +607,38 @@ export declare function sessionGraphCapabilityFixtures(): {
             readonly expected: {
                 readonly errorContains: "unknown token";
             };
+        }, {
+            readonly name: "producer-canonical-thinking-level";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation";
+            };
+            readonly mutation: {
+                readonly description: "Emits the full sorted inventory including thinking_level_v1";
+            };
+            readonly input: {
+                readonly tokens: readonly ["detailed_usage_v1", "native_metadata_v1", "observed_model_v1", "retained_unknown_v1", "session_graph_provenance_v1", "thinking_level_v1", "tool_namespace_v1"];
+            };
+            readonly expected: {
+                readonly accepted: true;
+            };
+        }, {
+            readonly name: "producer-unsorted-thinking-level";
+            readonly classification: "must-fail";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "content-capability-negotiation";
+            };
+            readonly mutation: {
+                readonly description: "Places thinking_level_v1 after tool_namespace_v1";
+            };
+            readonly input: {
+                readonly tokens: readonly ["tool_namespace_v1", "thinking_level_v1"];
+            };
+            readonly expected: {
+                readonly errorContains: "canonical lexicographic order";
+            };
         }];
     };
 };

package/dist/internal/generated/content-capabilities.gen.d.ts

@@ -14,6 +14,7 @@ export declare const KnownContentCapability: Readonly<{
     readonly ObservedModelV1: "observed_model_v1";
     readonly RetainedUnknownV1: "retained_unknown_v1";
     readonly SessionGraphProvenanceV1: "session_graph_provenance_v1";
+    readonly ThinkingLevelV1: "thinking_level_v1";
     readonly ToolNamespaceV1: "tool_namespace_v1";
 }>;
 export type KnownContentCapability = (typeof KnownContentCapability)[keyof typeof KnownContentCapability];

package/dist/internal/generated/content-capabilities.gen.js

@@ -13,9 +13,10 @@ export const KnownContentCapability = Object.freeze({
     ObservedModelV1: "observed_model_v1",
     RetainedUnknownV1: "retained_unknown_v1",
     SessionGraphProvenanceV1: "session_graph_provenance_v1",
+    ThinkingLevelV1: "thinking_level_v1",
     ToolNamespaceV1: "tool_namespace_v1",
 });
-export const AllContentCapabilities = Object.freeze([KnownContentCapability.DetailedUsageV1, KnownContentCapability.NativeMetadataV1, KnownContentCapability.ObservedModelV1, KnownContentCapability.RetainedUnknownV1, KnownContentCapability.SessionGraphProvenanceV1, KnownContentCapability.ToolNamespaceV1]);
+export const AllContentCapabilities = Object.freeze([KnownContentCapability.DetailedUsageV1, KnownContentCapability.NativeMetadataV1, KnownContentCapability.ObservedModelV1, KnownContentCapability.RetainedUnknownV1, KnownContentCapability.SessionGraphProvenanceV1, KnownContentCapability.ThinkingLevelV1, KnownContentCapability.ToolNamespaceV1]);
 export function isContentCapability(value) {
     return typeof value === "string" && AllContentCapabilities.includes(value);
 }
@@ -42,6 +43,8 @@ function visitTurns(turns, found) {
     for (const turn of turns ?? []) {
         if ((turn.observedModel ?? "") !== "")
             found.add(KnownContentCapability.ObservedModelV1);
+        if ((turn.thinkingLevel ?? "") !== "" || (turn.thinkingLevelRaw ?? "") !== "")
+            found.add(KnownContentCapability.ThinkingLevelV1);
         if (turn.toolCalls?.some((tool) => tool.namespace !== undefined))
             found.add(KnownContentCapability.ToolNamespaceV1);
         if (turn.usage != null || turn.toolCalls?.some((tool) => tool.usage != null))
@@ -56,6 +59,8 @@ export function requiredContentCapabilities(detail) {
         found.add(KnownContentCapability.SessionGraphProvenanceV1);
     if ((detail.nativeMetadata?.length ?? 0) > 0)
         found.add(KnownContentCapability.NativeMetadataV1);
+    if ((detail.thinkingLevel ?? "") !== "" || (detail.thinkingLevelRaw ?? "") !== "")
+        found.add(KnownContentCapability.ThinkingLevelV1);
     if ((detail.retainedUnknown?.length ?? 0) > 0 || detail.diagnostics !== undefined)
         found.add(KnownContentCapability.RetainedUnknownV1);
     visitTurns(detail.turns, found);

package/dist/internal/generated/contract/zod.gen.d.ts

@@ -479,7 +479,7 @@ export type Confidence = z.infer<typeof zConfidence>;
 /**
  * Content Capability
  *
- * Opaque, forward-open revision token in the deployment-specific content-capability set. Clients use exact set membership, never parse _v1 as Semantic Versioning or infer ranges, ignore unknown tokens, and tolerate duplicate or unordered input. Servers emit only their pinned known inventory, reject duplicates, and serialize lexicographically; token meanings are immutable. observed_model_v1 is required iff any root or nested assistant turn has observedModel, not for session model alone, and guarantees assistant-only value validation before persistence with no invalid DB/blob side effects plus byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are excluded.
+ * Opaque, forward-open revision token in the deployment-specific content-capability set. Clients use exact set membership, never parse _v1 as Semantic Versioning or infer ranges, ignore unknown tokens, and tolerate duplicate or unordered input. Servers emit only their pinned known inventory, reject duplicates, and serialize lexicographically; token meanings are immutable. observed_model_v1 is required iff any root or nested assistant turn has observedModel, not for session model alone, and guarantees assistant-only value validation before persistence with no invalid DB/blob side effects plus byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are excluded. thinking_level_v1 is required iff the session detail carries thinkingLevel, thinkingLevelRaw, or a non-empty thinkingLevelHistory, or any main or earlier-history turn carries thinkingLevel or thinkingLevelRaw, and guarantees canonical, raw-bound, and assistant-only validation before persistence with no invalid side effects plus byte-exact preservation of the values, their history order, and their absence through storage, typed migration, rewrite, serving, and pull.
  */
 export declare const zContentCapability: z.ZodString;
 export type ContentCapability = z.infer<typeof zContentCapability>;
@@ -3979,6 +3979,45 @@ export declare const zProjectTasksPayload: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type ProjectTasksPayload = z.infer<typeof zProjectTasksPayload>;
+/**
+ * Thinking Level
+ *
+ * Canonical reasoning-effort level of assistant-generated output: off, minimal, low, medium, high, xhigh, max, ultra, ultracode. off is the single disabled state, ultra is above max, and ultracode is a distinct level. Omit the field when the level is unknown; never infer it from token budgets.
+ */
+export declare const zThinkingLevel: z.ZodEnum<{
+    max: "max";
+    high: "high";
+    low: "low";
+    medium: "medium";
+    off: "off";
+    minimal: "minimal";
+    xhigh: "xhigh";
+    ultra: "ultra";
+    ultracode: "ultracode";
+}>;
+export type ThinkingLevel = z.infer<typeof zThinkingLevel>;
+/**
+ * Thinking Level Raw
+ *
+ * Exact native thinking-level spelling observed when it differs from the emitted canonical thinkingLevel, including when no canonical level could be mapped. Source evidence, never a canonical value; numeric budgets are never raw. Non-empty, valid UTF-8, at most 128 encoded UTF-8 bytes, and no Unicode White_Space code point at either edge. Omit when nothing was observed or the native spelling is canonical.
+ */
+export declare const zThinkingLevelRaw: z.ZodString;
+export type ThinkingLevelRaw = z.infer<typeof zThinkingLevelRaw>;
+export declare const zThinkingLevelChange: z.ZodIntersection<z.ZodUnknown, z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        max: "max";
+        high: "high";
+        low: "low";
+        medium: "medium";
+        off: "off";
+        minimal: "minimal";
+        xhigh: "xhigh";
+        ultra: "ultra";
+        ultracode: "ultracode";
+    }>>;
+    raw: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export type ThinkingLevelChange = z.infer<typeof zThinkingLevelChange>;
 export declare const zTimelineSessionRef: z.ZodObject<{
     harness: z.ZodEnum<{
         strike: "strike";
@@ -5572,6 +5611,32 @@ export declare const zUnifiedMetadata: z.ZodObject<{
         parentUuid: z.ZodString;
         sessionId: z.ZodString;
     }, z.core.$strip>>>;
+    thinkingLevel: z.ZodOptional<z.ZodEnum<{
+        max: "max";
+        high: "high";
+        low: "low";
+        medium: "medium";
+        off: "off";
+        minimal: "minimal";
+        xhigh: "xhigh";
+        ultra: "ultra";
+        ultracode: "ultracode";
+    }>>;
+    thinkingLevelHistory: z.ZodOptional<z.ZodArray<z.ZodIntersection<z.ZodUnknown, z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            max: "max";
+            high: "high";
+            low: "low";
+            medium: "medium";
+            off: "off";
+            minimal: "minimal";
+            xhigh: "xhigh";
+            ultra: "ultra";
+            ultracode: "ultracode";
+        }>>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    thinkingLevelRaw: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodObject<{
         end: z.ZodCoercedBigInt<unknown>;
         ingested: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -6071,6 +6136,18 @@ export declare const zTurnDetail: z.ZodObject<{
         max_turn_requests: "max_turn_requests";
         refusal: "refusal";
     }>>>;
+    thinkingLevel: z.ZodOptional<z.ZodEnum<{
+        max: "max";
+        high: "high";
+        low: "low";
+        medium: "medium";
+        off: "off";
+        minimal: "minimal";
+        xhigh: "xhigh";
+        ultra: "ultra";
+        ultracode: "ultracode";
+    }>>;
+    thinkingLevelRaw: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodISODateTime;
     tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -6378,6 +6455,18 @@ export declare const zEarlierHistorySection: z.ZodObject<{
             max_turn_requests: "max_turn_requests";
             refusal: "refusal";
         }>>>;
+        thinkingLevel: z.ZodOptional<z.ZodEnum<{
+            max: "max";
+            high: "high";
+            low: "low";
+            medium: "medium";
+            off: "off";
+            minimal: "minimal";
+            xhigh: "xhigh";
+            ultra: "ultra";
+            ultracode: "ultracode";
+        }>>;
+        thinkingLevelRaw: z.ZodOptional<z.ZodString>;
         timestamp: z.ZodISODateTime;
         tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -6696,6 +6785,18 @@ export declare const zSessionDetailPayload: z.ZodObject<{
                 max_turn_requests: "max_turn_requests";
                 refusal: "refusal";
             }>>>;
+            thinkingLevel: z.ZodOptional<z.ZodEnum<{
+                max: "max";
+                high: "high";
+                low: "low";
+                medium: "medium";
+                off: "off";
+                minimal: "minimal";
+                xhigh: "xhigh";
+                ultra: "ultra";
+                ultracode: "ultracode";
+            }>>;
+            thinkingLevelRaw: z.ZodOptional<z.ZodString>;
             timestamp: z.ZodISODateTime;
             tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
             tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -7012,6 +7113,32 @@ export declare const zSessionDetailPayload: z.ZodObject<{
     source: z.ZodOptional<z.ZodString>;
     startTime: z.ZodISODateTime;
     status: z.ZodOptional<z.ZodString>;
+    thinkingLevel: z.ZodOptional<z.ZodEnum<{
+        max: "max";
+        high: "high";
+        low: "low";
+        medium: "medium";
+        off: "off";
+        minimal: "minimal";
+        xhigh: "xhigh";
+        ultra: "ultra";
+        ultracode: "ultracode";
+    }>>;
+    thinkingLevelHistory: z.ZodOptional<z.ZodArray<z.ZodIntersection<z.ZodUnknown, z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            max: "max";
+            high: "high";
+            low: "low";
+            medium: "medium";
+            off: "off";
+            minimal: "minimal";
+            xhigh: "xhigh";
+            ultra: "ultra";
+            ultracode: "ultracode";
+        }>>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    thinkingLevelRaw: z.ZodOptional<z.ZodString>;
     tokensIn: z.ZodInt;
     tokensOut: z.ZodInt;
     toolCallCount: z.ZodInt;
@@ -7101,6 +7228,18 @@ export declare const zSessionDetailPayload: z.ZodObject<{
             max_turn_requests: "max_turn_requests";
             refusal: "refusal";
         }>>>;
+        thinkingLevel: z.ZodOptional<z.ZodEnum<{
+            max: "max";
+            high: "high";
+            low: "low";
+            medium: "medium";
+            off: "off";
+            minimal: "minimal";
+            xhigh: "xhigh";
+            ultra: "ultra";
+            ultracode: "ultracode";
+        }>>;
+        thinkingLevelRaw: z.ZodOptional<z.ZodString>;
         timestamp: z.ZodISODateTime;
         tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -7420,6 +7559,18 @@ export declare const zSessionDetailReadPayload: z.ZodObject<{
                 max_turn_requests: "max_turn_requests";
                 refusal: "refusal";
             }>>>;
+            thinkingLevel: z.ZodOptional<z.ZodEnum<{
+                max: "max";
+                high: "high";
+                low: "low";
+                medium: "medium";
+                off: "off";
+                minimal: "minimal";
+                xhigh: "xhigh";
+                ultra: "ultra";
+                ultracode: "ultracode";
+            }>>;
+            thinkingLevelRaw: z.ZodOptional<z.ZodString>;
             timestamp: z.ZodISODateTime;
             tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
             tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -7761,6 +7912,32 @@ export declare const zSessionDetailReadPayload: z.ZodObject<{
     source: z.ZodOptional<z.ZodString>;
     startTime: z.ZodOptional<z.ZodISODateTime>;
     status: z.ZodOptional<z.ZodString>;
+    thinkingLevel: z.ZodOptional<z.ZodEnum<{
+        max: "max";
+        high: "high";
+        low: "low";
+        medium: "medium";
+        off: "off";
+        minimal: "minimal";
+        xhigh: "xhigh";
+        ultra: "ultra";
+        ultracode: "ultracode";
+    }>>;
+    thinkingLevelHistory: z.ZodOptional<z.ZodArray<z.ZodIntersection<z.ZodUnknown, z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            max: "max";
+            high: "high";
+            low: "low";
+            medium: "medium";
+            off: "off";
+            minimal: "minimal";
+            xhigh: "xhigh";
+            ultra: "ultra";
+            ultracode: "ultracode";
+        }>>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    thinkingLevelRaw: z.ZodOptional<z.ZodString>;
     tokensIn: z.ZodOptional<z.ZodInt>;
     tokensOut: z.ZodOptional<z.ZodInt>;
     toolCallCount: z.ZodOptional<z.ZodInt>;
@@ -7850,6 +8027,18 @@ export declare const zSessionDetailReadPayload: z.ZodObject<{
             max_turn_requests: "max_turn_requests";
             refusal: "refusal";
         }>>>;
+        thinkingLevel: z.ZodOptional<z.ZodEnum<{
+            max: "max";
+            high: "high";
+            low: "low";
+            medium: "medium";
+            off: "off";
+            minimal: "minimal";
+            xhigh: "xhigh";
+            ultra: "ultra";
+            ultracode: "ultracode";
+        }>>;
+        thinkingLevelRaw: z.ZodOptional<z.ZodString>;
         timestamp: z.ZodISODateTime;
         tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -8174,6 +8363,18 @@ export declare const zTranscriptContent: z.ZodObject<{
                     max_turn_requests: "max_turn_requests";
                     refusal: "refusal";
                 }>>>;
+                thinkingLevel: z.ZodOptional<z.ZodEnum<{
+                    max: "max";
+                    high: "high";
+                    low: "low";
+                    medium: "medium";
+                    off: "off";
+                    minimal: "minimal";
+                    xhigh: "xhigh";
+                    ultra: "ultra";
+                    ultracode: "ultracode";
+                }>>;
+                thinkingLevelRaw: z.ZodOptional<z.ZodString>;
                 timestamp: z.ZodISODateTime;
                 tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
                 tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
@@ -8490,6 +8691,32 @@ export declare const zTranscriptContent: z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
         startTime: z.ZodISODateTime;
         status: z.ZodOptional<z.ZodString>;
+        thinkingLevel: z.ZodOptional<z.ZodEnum<{
+            max: "max";
+            high: "high";
+            low: "low";
+            medium: "medium";
+            off: "off";
+            minimal: "minimal";
+            xhigh: "xhigh";
+            ultra: "ultra";
+            ultracode: "ultracode";
+        }>>;
+        thinkingLevelHistory: z.ZodOptional<z.ZodArray<z.ZodIntersection<z.ZodUnknown, z.ZodObject<{
+            level: z.ZodOptional<z.ZodEnum<{
+                max: "max";
+                high: "high";
+                low: "low";
+                medium: "medium";
+                off: "off";
+                minimal: "minimal";
+                xhigh: "xhigh";
+                ultra: "ultra";
+                ultracode: "ultracode";
+            }>>;
+            raw: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        thinkingLevelRaw: z.ZodOptional<z.ZodString>;
         tokensIn: z.ZodInt;
         tokensOut: z.ZodInt;
         toolCallCount: z.ZodInt;
@@ -8579,6 +8806,18 @@ export declare const zTranscriptContent: z.ZodObject<{
                 max_turn_requests: "max_turn_requests";
                 refusal: "refusal";
             }>>>;
+            thinkingLevel: z.ZodOptional<z.ZodEnum<{
+                max: "max";
+                high: "high";
+                low: "low";
+                medium: "medium";
+                off: "off";
+                minimal: "minimal";
+                xhigh: "xhigh";
+                ultra: "ultra";
+                ultracode: "ultracode";
+            }>>;
+            thinkingLevelRaw: z.ZodOptional<z.ZodString>;
             timestamp: z.ZodISODateTime;
             tokensIn: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
             tokensOut: z.ZodOptional<z.ZodNullable<z.ZodInt>>;

package/dist/internal/generated/contract/zod.gen.js

@@ -401,7 +401,7 @@ export const zConfidence = z.enum([
 /**
  * Content Capability
  *
- * Opaque, forward-open revision token in the deployment-specific content-capability set. Clients use exact set membership, never parse _v1 as Semantic Versioning or infer ranges, ignore unknown tokens, and tolerate duplicate or unordered input. Servers emit only their pinned known inventory, reject duplicates, and serialize lexicographically; token meanings are immutable. observed_model_v1 is required iff any root or nested assistant turn has observedModel, not for session model alone, and guarantees assistant-only value validation before persistence with no invalid DB/blob side effects plus byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are excluded.
+ * Opaque, forward-open revision token in the deployment-specific content-capability set. Clients use exact set membership, never parse _v1 as Semantic Versioning or infer ranges, ignore unknown tokens, and tolerate duplicate or unordered input. Servers emit only their pinned known inventory, reject duplicates, and serialize lexicographically; token meanings are immutable. observed_model_v1 is required iff any root or nested assistant turn has observedModel, not for session model alone, and guarantees assistant-only value validation before persistence with no invalid DB/blob side effects plus byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are excluded. thinking_level_v1 is required iff the session detail carries thinkingLevel, thinkingLevelRaw, or a non-empty thinkingLevelHistory, or any main or earlier-history turn carries thinkingLevel or thinkingLevelRaw, and guarantees canonical, raw-bound, and assistant-only validation before persistence with no invalid side effects plus byte-exact preservation of the values, their history order, and their absence through storage, typed migration, rewrite, serving, and pull.
  */
 export const zContentCapability = z.string();
 /**
@@ -2109,6 +2109,32 @@ export const zProjectTasksPayload = z.object({
     projectHash: zProjectHash,
     tasks: z.array(zTaskSummary).nullable()
 });
+/**
+ * Thinking Level
+ *
+ * Canonical reasoning-effort level of assistant-generated output: off, minimal, low, medium, high, xhigh, max, ultra, ultracode. off is the single disabled state, ultra is above max, and ultracode is a distinct level. Omit the field when the level is unknown; never infer it from token budgets.
+ */
+export const zThinkingLevel = z.enum([
+    'off',
+    'minimal',
+    'low',
+    'medium',
+    'high',
+    'xhigh',
+    'max',
+    'ultra',
+    'ultracode'
+]);
+/**
+ * Thinking Level Raw
+ *
+ * Exact native thinking-level spelling observed when it differs from the emitted canonical thinkingLevel, including when no canonical level could be mapped. Source evidence, never a canonical value; numeric budgets are never raw. Non-empty, valid UTF-8, at most 128 encoded UTF-8 bytes, and no Unicode White_Space code point at either edge. Omit when nothing was observed or the native spelling is canonical.
+ */
+export const zThinkingLevelRaw = z.string().min(1).max(128).regex(/^(?:|[^\s])(?:[\s\S]*(?:|[^\s]))?$/).refine((value) => !/[\uD800-\uDFFF]/u.test(value) && new TextEncoder().encode(value).length <= 128, { error: "ThinkingLevelRaw is invalid UTF-8 or exceeds 128 bytes" }).refine((value) => { const edge = (text) => text === "\uFEFF" || (!/\s/u.test(text) && text !== "\u0085"); return edge(value.charAt(0)) && edge(value.charAt(value.length - 1)); }, { error: "ThinkingLevelRaw must not begin or end with whitespace" });
+export const zThinkingLevelChange = z.intersection(z.unknown(), z.object({
+    level: zThinkingLevel.optional(),
+    raw: zThinkingLevelRaw.optional()
+})).refine((value) => value.level !== undefined || value.raw !== undefined, { error: "ThinkingLevelChange must carry level or raw" });
 export const zTimelineSessionRef = z.object({
     harness: zHarness,
     hasCommitBinding: z.boolean(),
@@ -2400,6 +2426,9 @@ export const zUnifiedMetadata = z.object({
     source: zSourceInfo,
     stats: zSessionStats,
     subagents: z.array(zSubagentRef).nullable(),
+    thinkingLevel: zThinkingLevel.optional(),
+    thinkingLevelHistory: z.array(zThinkingLevelChange).optional(),
+    thinkingLevelRaw: zThinkingLevelRaw.optional(),
     timestamp: zTimestampInfo,
     version: z.string()
 });
@@ -2490,6 +2519,8 @@ export const zTurnDetail = z.object({
     role: zRole,
     sourceEntryRef: zSourceEntryRef.optional(),
     stopReason: zStopReason.nullish(),
+    thinkingLevel: zThinkingLevel.optional(),
+    thinkingLevelRaw: zThinkingLevelRaw.optional(),
     timestamp: z.iso.datetime(),
     tokensIn: z.int().nullish(),
     tokensOut: z.int().nullish(),
@@ -2527,6 +2558,9 @@ export const zSessionDetailPayload = z.object({
     source: z.string().optional(),
     startTime: z.iso.datetime(),
     status: z.string().optional(),
+    thinkingLevel: zThinkingLevel.optional(),
+    thinkingLevelHistory: z.array(zThinkingLevelChange).optional(),
+    thinkingLevelRaw: zThinkingLevelRaw.optional(),
     tokensIn: z.int(),
     tokensOut: z.int(),
     toolCallCount: z.int(),
@@ -2562,6 +2596,9 @@ export const zSessionDetailReadPayload = z.object({
     source: z.string().optional(),
     startTime: z.iso.datetime().optional(),
     status: z.string().optional(),
+    thinkingLevel: zThinkingLevel.optional(),
+    thinkingLevelHistory: z.array(zThinkingLevelChange).optional(),
+    thinkingLevelRaw: zThinkingLevelRaw.optional(),
     tokensIn: z.int().optional(),
     tokensOut: z.int().optional(),
     toolCallCount: z.int().optional(),

package/dist/internal/generated/enums.gen.d.ts

@@ -87,6 +87,7 @@ import { type LocalSettingKind as LocalSettingKindContract } from "./contract/zo
 import { type AutoPublishEvent as AutoPublishEventContract } from "./contract/zod.gen.js";
 import { type AutoPublishHookStatus as AutoPublishHookStatusContract } from "./contract/zod.gen.js";
 import { type AutoPublishRuleKind as AutoPublishRuleKindContract } from "./contract/zod.gen.js";
+import { type ThinkingLevel as ThinkingLevelContract } from "./contract/zod.gen.js";
 export type PublishOperationKind = PublishOperationKindContract;
 export declare const PublishOperationKind: Readonly<{
     readonly Preserve: "replace" | "append" | "preserve";
@@ -892,3 +893,17 @@ export declare const AutoPublishRuleKind: Readonly<{
 }>;
 export declare const AllAutoPublishRuleKinds: readonly AutoPublishRuleKind[];
 export declare function isAutoPublishRuleKind(value: unknown): value is AutoPublishRuleKind;
+export type ThinkingLevel = ThinkingLevelContract;
+export declare const ThinkingLevel: Readonly<{
+    readonly Off: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly Minimal: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly Low: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly Medium: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly High: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly XHigh: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly Max: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly Ultra: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+    readonly Ultracode: "max" | "high" | "low" | "medium" | "off" | "minimal" | "xhigh" | "ultra" | "ultracode";
+}>;
+export declare const AllThinkingLevels: readonly ThinkingLevel[];
+export declare function isThinkingLevel(value: unknown): value is ThinkingLevel;