npm - @treeseed/sdk - Versions diffs - 0.13.0-rc.11 → 0.13.0-rc.111 - Mend

@treeseed/sdk 0.13.0-rc.11 → 0.13.0-rc.111

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (453) hide show

package/dist/agent-capacity/validation/agent-definition-schema.d.ts CHANGED Viewed

@@ -94,12 +94,12 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, "strict", z.ZodTypeAny, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }>;
         branchPolicy: z.ZodObject<{
             kind: z.ZodEnum<["read-only", "main-planning-content", "staging-content", "assignment-feature", "staging-release"]>;
@@ -113,19 +113,19 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }>;
@@ -177,6 +177,43 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[]>>;
+        capabilityRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            capabilityId: z.ZodString;
+            versionRange: z.ZodString;
+            requirement: z.ZodEnum<["required", "preferred"]>;
+            alternativeGroup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            requiredFeatures: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                value: z.ZodUnknown;
+                requirement: z.ZodEnum<["required", "preferred"]>;
+            }, "strict", z.ZodTypeAny, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }>>>;
+        }, "strict", z.ZodTypeAny, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }>, "many">>;
         permissions: z.ZodOptional<z.ZodObject<{
             content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 operations: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
@@ -232,18 +269,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             }>>;
         }, "strict", z.ZodTypeAny, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -254,18 +291,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             } | undefined;
         }, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -308,52 +345,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         }>>;
-        providerOverrides: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            disallowedProviderIds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            promptRef: z.ZodOptional<z.ZodString>;
-            instructionTemplateRefs: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                revision: z.ZodNumber;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                revision: number;
-            }, {
-                id: string;
-                revision: number;
-            }>, "many">, {
-                id: string;
-                revision: number;
-            }[], {
-                id: string;
-                revision: number;
-            }[]>>;
-            maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
-            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
-            maxCostAmount: z.ZodOptional<z.ZodNumber>;
-        }, "strict", z.ZodTypeAny, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }>>;
         tools: z.ZodObject<{
             allowed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
             denied: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
@@ -586,7 +577,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                     publishes?: string[] | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -607,7 +598,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 } | undefined;
                 promptTask?: string | undefined;
             }, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -630,7 +621,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }>, "many">>;
             requiresArtifactKinds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
         }, "strict", z.ZodTypeAny, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -638,7 +629,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -661,7 +652,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }[] | undefined;
             requiresArtifactKinds?: string[] | undefined;
         }, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -669,7 +660,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -758,7 +749,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             blockExecutionWhenCreated?: boolean | undefined;
         }>>;
         execution: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            reasoningEffort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>>;
             maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
             closeoutWarningSeconds: z.ZodOptional<z.ZodNumber>;
             preparationSeconds: z.ZodOptional<z.ZodNumber>;
@@ -791,7 +782,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -812,7 +803,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -831,36 +822,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -890,19 +881,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -925,18 +927,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -956,7 +946,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -964,7 +954,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -1004,36 +994,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -1063,19 +1053,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -1098,18 +1099,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -1129,7 +1118,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -1137,7 +1126,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -1177,36 +1166,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }>, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -1236,19 +1225,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -1271,18 +1271,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -1302,7 +1290,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -1310,7 +1298,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -1350,36 +1338,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -1409,19 +1397,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -1444,18 +1443,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -1475,7 +1462,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -1483,7 +1470,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -1616,12 +1603,12 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, "strict", z.ZodTypeAny, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }>;
         branchPolicy: z.ZodObject<{
             kind: z.ZodEnum<["read-only", "main-planning-content", "staging-content", "assignment-feature", "staging-release"]>;
@@ -1635,19 +1622,19 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }>;
@@ -1699,6 +1686,43 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[]>>;
+        capabilityRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            capabilityId: z.ZodString;
+            versionRange: z.ZodString;
+            requirement: z.ZodEnum<["required", "preferred"]>;
+            alternativeGroup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            requiredFeatures: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                value: z.ZodUnknown;
+                requirement: z.ZodEnum<["required", "preferred"]>;
+            }, "strict", z.ZodTypeAny, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }>>>;
+        }, "strict", z.ZodTypeAny, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }>, "many">>;
         permissions: z.ZodOptional<z.ZodObject<{
             content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 operations: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
@@ -1754,18 +1778,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             }>>;
         }, "strict", z.ZodTypeAny, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -1776,18 +1800,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             } | undefined;
         }, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -1830,52 +1854,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         }>>;
-        providerOverrides: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            disallowedProviderIds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            promptRef: z.ZodOptional<z.ZodString>;
-            instructionTemplateRefs: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                revision: z.ZodNumber;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                revision: number;
-            }, {
-                id: string;
-                revision: number;
-            }>, "many">, {
-                id: string;
-                revision: number;
-            }[], {
-                id: string;
-                revision: number;
-            }[]>>;
-            maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
-            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
-            maxCostAmount: z.ZodOptional<z.ZodNumber>;
-        }, "strict", z.ZodTypeAny, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }>>;
         tools: z.ZodObject<{
             allowed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
             denied: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
@@ -2108,7 +2086,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                     publishes?: string[] | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -2129,7 +2107,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 } | undefined;
                 promptTask?: string | undefined;
             }, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -2152,7 +2130,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }>, "many">>;
             requiresArtifactKinds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
         }, "strict", z.ZodTypeAny, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -2160,7 +2138,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -2183,7 +2161,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }[] | undefined;
             requiresArtifactKinds?: string[] | undefined;
         }, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -2191,7 +2169,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -2280,7 +2258,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             blockExecutionWhenCreated?: boolean | undefined;
         }>>;
         execution: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            reasoningEffort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>>;
             maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
             closeoutWarningSeconds: z.ZodOptional<z.ZodNumber>;
             preparationSeconds: z.ZodOptional<z.ZodNumber>;
@@ -2313,7 +2291,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -2334,7 +2312,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -2353,36 +2331,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -2412,19 +2390,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -2447,18 +2436,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -2478,7 +2455,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -2486,7 +2463,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -2526,36 +2503,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -2585,19 +2562,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -2620,18 +2608,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -2651,7 +2627,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -2659,7 +2635,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -2699,36 +2675,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }>, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -2758,19 +2734,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -2793,18 +2780,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -2824,7 +2799,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -2832,7 +2807,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -2872,36 +2847,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -2931,19 +2906,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -2966,18 +2952,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -2997,7 +2971,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -3005,7 +2979,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -3138,12 +3112,12 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, "strict", z.ZodTypeAny, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }>;
         branchPolicy: z.ZodObject<{
             kind: z.ZodEnum<["read-only", "main-planning-content", "staging-content", "assignment-feature", "staging-release"]>;
@@ -3157,19 +3131,19 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }>;
@@ -3221,6 +3195,43 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[]>>;
+        capabilityRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            capabilityId: z.ZodString;
+            versionRange: z.ZodString;
+            requirement: z.ZodEnum<["required", "preferred"]>;
+            alternativeGroup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            requiredFeatures: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                value: z.ZodUnknown;
+                requirement: z.ZodEnum<["required", "preferred"]>;
+            }, "strict", z.ZodTypeAny, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }>>>;
+        }, "strict", z.ZodTypeAny, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }>, "many">>;
         permissions: z.ZodOptional<z.ZodObject<{
             content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 operations: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
@@ -3276,18 +3287,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             }>>;
         }, "strict", z.ZodTypeAny, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -3298,18 +3309,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             } | undefined;
         }, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -3352,52 +3363,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         }>>;
-        providerOverrides: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            disallowedProviderIds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            promptRef: z.ZodOptional<z.ZodString>;
-            instructionTemplateRefs: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                revision: z.ZodNumber;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                revision: number;
-            }, {
-                id: string;
-                revision: number;
-            }>, "many">, {
-                id: string;
-                revision: number;
-            }[], {
-                id: string;
-                revision: number;
-            }[]>>;
-            maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
-            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
-            maxCostAmount: z.ZodOptional<z.ZodNumber>;
-        }, "strict", z.ZodTypeAny, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }>>;
         tools: z.ZodObject<{
             allowed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
             denied: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
@@ -3630,7 +3595,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                     publishes?: string[] | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -3651,7 +3616,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 } | undefined;
                 promptTask?: string | undefined;
             }, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -3674,7 +3639,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }>, "many">>;
             requiresArtifactKinds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
         }, "strict", z.ZodTypeAny, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -3682,7 +3647,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -3705,7 +3670,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }[] | undefined;
             requiresArtifactKinds?: string[] | undefined;
         }, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -3713,7 +3678,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -3802,7 +3767,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             blockExecutionWhenCreated?: boolean | undefined;
         }>>;
         execution: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            reasoningEffort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>>;
             maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
             closeoutWarningSeconds: z.ZodOptional<z.ZodNumber>;
             preparationSeconds: z.ZodOptional<z.ZodNumber>;
@@ -3835,7 +3800,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -3856,7 +3821,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -3875,36 +3840,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -3934,19 +3899,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -3969,18 +3945,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -4000,7 +3964,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -4008,7 +3972,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -4048,36 +4012,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -4107,19 +4071,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -4142,18 +4117,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -4173,7 +4136,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -4181,7 +4144,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -4221,36 +4184,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }>, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -4280,19 +4243,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -4315,18 +4289,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -4346,7 +4308,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -4354,7 +4316,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -4394,36 +4356,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -4453,19 +4415,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -4488,18 +4461,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -4519,7 +4480,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -4527,7 +4488,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -4660,12 +4621,12 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, "strict", z.ZodTypeAny, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }>;
         branchPolicy: z.ZodObject<{
             kind: z.ZodEnum<["read-only", "main-planning-content", "staging-content", "assignment-feature", "staging-release"]>;
@@ -4679,19 +4640,19 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }>;
@@ -4743,6 +4704,43 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[]>>;
+        capabilityRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            capabilityId: z.ZodString;
+            versionRange: z.ZodString;
+            requirement: z.ZodEnum<["required", "preferred"]>;
+            alternativeGroup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            requiredFeatures: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                value: z.ZodUnknown;
+                requirement: z.ZodEnum<["required", "preferred"]>;
+            }, "strict", z.ZodTypeAny, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }>>>;
+        }, "strict", z.ZodTypeAny, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }>, "many">>;
         permissions: z.ZodOptional<z.ZodObject<{
             content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 operations: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
@@ -4798,18 +4796,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             }>>;
         }, "strict", z.ZodTypeAny, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -4820,18 +4818,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             } | undefined;
         }, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -4874,52 +4872,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         }>>;
-        providerOverrides: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            disallowedProviderIds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            promptRef: z.ZodOptional<z.ZodString>;
-            instructionTemplateRefs: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                revision: z.ZodNumber;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                revision: number;
-            }, {
-                id: string;
-                revision: number;
-            }>, "many">, {
-                id: string;
-                revision: number;
-            }[], {
-                id: string;
-                revision: number;
-            }[]>>;
-            maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
-            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
-            maxCostAmount: z.ZodOptional<z.ZodNumber>;
-        }, "strict", z.ZodTypeAny, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }>>;
         tools: z.ZodObject<{
             allowed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
             denied: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
@@ -5152,7 +5104,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                     publishes?: string[] | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -5173,7 +5125,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 } | undefined;
                 promptTask?: string | undefined;
             }, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -5196,7 +5148,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }>, "many">>;
             requiresArtifactKinds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
         }, "strict", z.ZodTypeAny, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -5204,7 +5156,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -5227,7 +5179,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }[] | undefined;
             requiresArtifactKinds?: string[] | undefined;
         }, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -5235,7 +5187,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -5324,7 +5276,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             blockExecutionWhenCreated?: boolean | undefined;
         }>>;
         execution: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            reasoningEffort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>>;
             maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
             closeoutWarningSeconds: z.ZodOptional<z.ZodNumber>;
             preparationSeconds: z.ZodOptional<z.ZodNumber>;
@@ -5357,7 +5309,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -5378,7 +5330,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -5397,36 +5349,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -5456,19 +5408,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -5491,18 +5454,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -5522,7 +5473,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -5530,7 +5481,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -5570,36 +5521,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -5629,19 +5580,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -5664,18 +5626,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -5695,7 +5645,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -5703,7 +5653,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -5743,36 +5693,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }>, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -5802,19 +5752,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -5837,18 +5798,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -5868,7 +5817,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -5876,7 +5825,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -5916,36 +5865,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -5975,19 +5924,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -6010,18 +5970,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -6041,7 +5989,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -6049,7 +5997,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -6182,12 +6130,12 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, "strict", z.ZodTypeAny, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }, {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         }>;
         branchPolicy: z.ZodObject<{
             kind: z.ZodEnum<["read-only", "main-planning-content", "staging-content", "assignment-feature", "staging-release"]>;
@@ -6201,19 +6149,19 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }, {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         }>;
@@ -6265,6 +6213,43 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[]>>;
+        capabilityRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            capabilityId: z.ZodString;
+            versionRange: z.ZodString;
+            requirement: z.ZodEnum<["required", "preferred"]>;
+            alternativeGroup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            requiredFeatures: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                value: z.ZodUnknown;
+                requirement: z.ZodEnum<["required", "preferred"]>;
+            }, "strict", z.ZodTypeAny, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }>>>;
+        }, "strict", z.ZodTypeAny, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }, {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
+            }> | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }>, "many">>;
         permissions: z.ZodOptional<z.ZodObject<{
             content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 operations: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
@@ -6320,18 +6305,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             }>>;
         }, "strict", z.ZodTypeAny, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -6342,18 +6327,18 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 deniedCommands?: string[] | undefined;
             } | undefined;
         }, {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
-            }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -6396,52 +6381,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         }>>;
-        providerOverrides: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            disallowedProviderIds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-            promptRef: z.ZodOptional<z.ZodString>;
-            instructionTemplateRefs: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                revision: z.ZodNumber;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                revision: number;
-            }, {
-                id: string;
-                revision: number;
-            }>, "many">, {
-                id: string;
-                revision: number;
-            }[], {
-                id: string;
-                revision: number;
-            }[]>>;
-            maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
-            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
-            maxCostAmount: z.ZodOptional<z.ZodNumber>;
-        }, "strict", z.ZodTypeAny, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }, {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        }>>;
         tools: z.ZodObject<{
             allowed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
             denied: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
@@ -6674,7 +6613,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                     publishes?: string[] | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -6695,7 +6634,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
                 } | undefined;
                 promptTask?: string | undefined;
             }, {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -6718,7 +6657,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }>, "many">>;
             requiresArtifactKinds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
         }, "strict", z.ZodTypeAny, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -6726,7 +6665,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -6749,7 +6688,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             }[] | undefined;
             requiresArtifactKinds?: string[] | undefined;
         }, {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -6757,7 +6696,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -6846,7 +6785,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             blockExecutionWhenCreated?: boolean | undefined;
         }>>;
         execution: z.ZodOptional<z.ZodObject<{
-            requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            reasoningEffort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>>;
             maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
             closeoutWarningSeconds: z.ZodOptional<z.ZodNumber>;
             preparationSeconds: z.ZodOptional<z.ZodNumber>;
@@ -6879,7 +6818,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -6900,7 +6839,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -6919,36 +6858,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -6978,19 +6917,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -7013,18 +6963,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -7044,7 +6982,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -7052,7 +6990,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -7092,36 +7030,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -7151,19 +7089,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -7186,18 +7135,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -7217,7 +7154,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -7225,7 +7162,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -7265,36 +7202,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }>, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -7324,19 +7261,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -7359,18 +7307,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -7390,7 +7326,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -7398,7 +7334,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -7438,36 +7374,36 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         enabled: boolean;
+        outputs: {
+            messageTypes: string[];
+            modelMutations: string[];
+        };
         prompt: {
             system: string;
-            task?: string | undefined;
             templates?: Record<string, string> | undefined;
+            task?: string | undefined;
         };
         branchPolicy: {
             kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
             base: "main" | "staging";
-            prefix?: string | undefined;
             target?: "main" | "staging" | undefined;
-            branchNameTemplate?: string | undefined;
             worktree?: string | undefined;
+            prefix?: string | undefined;
+            branchNameTemplate?: string | undefined;
             updateBaseBeforeRun?: boolean | undefined;
             mergeTargetBeforeSave?: boolean | undefined;
         };
-        handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+        handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
         tools: {
             allowed: string[];
             denied?: string[] | undefined;
         };
-        outputs: {
-            messageTypes: string[];
-            modelMutations: string[];
-        };
         execution?: {
             preparationSeconds?: number | undefined;
             closeoutSeconds?: number | undefined;
             closeoutWarningSeconds?: number | undefined;
             enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-            requiredCapabilities?: string[] | undefined;
+            reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
             maxRuntimeSeconds?: number | undefined;
             maxRetries?: number | undefined;
             verificationRequired?: boolean | undefined;
@@ -7497,19 +7433,30 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             id: string;
             revision: number;
         }[] | undefined;
-        permissions?: {
-            content?: Record<string, {
-                operations: string[];
-                filters?: Record<string, unknown> | undefined;
+        capabilityRequirements?: {
+            requirement: "required" | "preferred";
+            capabilityId: string;
+            versionRange: string;
+            configuration?: Record<string, {
+                requirement: "required" | "preferred";
+                value?: unknown;
             }> | undefined;
-            commit?: {
-                allowed: boolean;
-            } | undefined;
+            alternativeGroup?: string | null | undefined;
+            requiredFeatures?: string[] | undefined;
+        }[] | undefined;
+        permissions?: {
             repository?: {
                 allowCodeMutation?: boolean | undefined;
                 readPaths?: string[] | undefined;
                 writePaths?: string[] | undefined;
             } | undefined;
+            commit?: {
+                allowed: boolean;
+            } | undefined;
+            content?: Record<string, {
+                operations: string[];
+                filters?: Record<string, unknown> | undefined;
+            }> | undefined;
             network?: {
                 allowWeb?: boolean | undefined;
                 allowedDomains?: string[] | undefined;
@@ -7532,18 +7479,6 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             requiredArtifactKinds?: string[] | undefined;
             blockOnOpenQuestions?: boolean | undefined;
         } | undefined;
-        providerOverrides?: {
-            instructionTemplateRefs?: {
-                id: string;
-                revision: number;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            maxRuntimeSeconds?: number | undefined;
-            maxTotalTokens?: number | undefined;
-            maxCostAmount?: number | undefined;
-            disallowedProviderIds?: string[] | undefined;
-            promptRef?: string | undefined;
-        } | undefined;
         signals?: {
             subscribesTo?: {
                 contract: string;
@@ -7563,7 +7498,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             publishes?: string[] | undefined;
         } | undefined;
         planningIntent?: {
-            stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+            stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
             objective?: string | undefined;
             proposalTypes?: string[] | undefined;
             artifactKind?: string | undefined;
@@ -7571,7 +7506,7 @@ export declare const agentDefinitionSchema: z.ZodEffects<z.ZodObject<{
             subjectId?: string | null | undefined;
             includeWorkdayArtifacts?: boolean | undefined;
             stages?: {
-                stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                 signals?: {
                     subscribesTo?: {
                         contract: string;
@@ -7708,12 +7643,12 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, "strict", z.ZodTypeAny, {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             }, {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             }>;
             branchPolicy: z.ZodObject<{
                 kind: z.ZodEnum<["read-only", "main-planning-content", "staging-content", "assignment-feature", "staging-release"]>;
@@ -7727,19 +7662,19 @@ export declare function validateAgentDefinitionModel(value: unknown): {
             }, "strict", z.ZodTypeAny, {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
                 base: "main" | "staging";
-                prefix?: string | undefined;
                 target?: "main" | "staging" | undefined;
-                branchNameTemplate?: string | undefined;
                 worktree?: string | undefined;
+                prefix?: string | undefined;
+                branchNameTemplate?: string | undefined;
                 updateBaseBeforeRun?: boolean | undefined;
                 mergeTargetBeforeSave?: boolean | undefined;
             }, {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
                 base: "main" | "staging";
-                prefix?: string | undefined;
                 target?: "main" | "staging" | undefined;
-                branchNameTemplate?: string | undefined;
                 worktree?: string | undefined;
+                prefix?: string | undefined;
+                branchNameTemplate?: string | undefined;
                 updateBaseBeforeRun?: boolean | undefined;
                 mergeTargetBeforeSave?: boolean | undefined;
             }>;
@@ -7791,6 +7726,43 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 id: string;
                 revision: number;
             }[]>>;
+            capabilityRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                capabilityId: z.ZodString;
+                versionRange: z.ZodString;
+                requirement: z.ZodEnum<["required", "preferred"]>;
+                alternativeGroup: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                requiredFeatures: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+                configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    value: z.ZodUnknown;
+                    requirement: z.ZodEnum<["required", "preferred"]>;
+                }, "strict", z.ZodTypeAny, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
+                }, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
+                }>>>;
+            }, "strict", z.ZodTypeAny, {
+                requirement: "required" | "preferred";
+                capabilityId: string;
+                versionRange: string;
+                configuration?: Record<string, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
+                }> | undefined;
+                alternativeGroup?: string | null | undefined;
+                requiredFeatures?: string[] | undefined;
+            }, {
+                requirement: "required" | "preferred";
+                capabilityId: string;
+                versionRange: string;
+                configuration?: Record<string, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
+                }> | undefined;
+                alternativeGroup?: string | null | undefined;
+                requiredFeatures?: string[] | undefined;
+            }>, "many">>;
             permissions: z.ZodOptional<z.ZodObject<{
                 content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                     operations: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
@@ -7846,18 +7818,18 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                     deniedCommands?: string[] | undefined;
                 }>>;
             }, "strict", z.ZodTypeAny, {
-                content?: Record<string, {
-                    operations: string[];
-                    filters?: Record<string, unknown> | undefined;
-                }> | undefined;
-                commit?: {
-                    allowed: boolean;
-                } | undefined;
                 repository?: {
                     allowCodeMutation?: boolean | undefined;
                     readPaths?: string[] | undefined;
                     writePaths?: string[] | undefined;
                 } | undefined;
+                commit?: {
+                    allowed: boolean;
+                } | undefined;
+                content?: Record<string, {
+                    operations: string[];
+                    filters?: Record<string, unknown> | undefined;
+                }> | undefined;
                 network?: {
                     allowWeb?: boolean | undefined;
                     allowedDomains?: string[] | undefined;
@@ -7868,18 +7840,18 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                     deniedCommands?: string[] | undefined;
                 } | undefined;
             }, {
-                content?: Record<string, {
-                    operations: string[];
-                    filters?: Record<string, unknown> | undefined;
-                }> | undefined;
-                commit?: {
-                    allowed: boolean;
-                } | undefined;
                 repository?: {
                     allowCodeMutation?: boolean | undefined;
                     readPaths?: string[] | undefined;
                     writePaths?: string[] | undefined;
                 } | undefined;
+                commit?: {
+                    allowed: boolean;
+                } | undefined;
+                content?: Record<string, {
+                    operations: string[];
+                    filters?: Record<string, unknown> | undefined;
+                }> | undefined;
                 network?: {
                     allowWeb?: boolean | undefined;
                     allowedDomains?: string[] | undefined;
@@ -7922,52 +7894,6 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 requiredArtifactKinds?: string[] | undefined;
                 blockOnOpenQuestions?: boolean | undefined;
             }>>;
-            providerOverrides: z.ZodOptional<z.ZodObject<{
-                requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-                disallowedProviderIds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-                promptRef: z.ZodOptional<z.ZodString>;
-                instructionTemplateRefs: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
-                    id: z.ZodString;
-                    revision: z.ZodNumber;
-                }, "strict", z.ZodTypeAny, {
-                    id: string;
-                    revision: number;
-                }, {
-                    id: string;
-                    revision: number;
-                }>, "many">, {
-                    id: string;
-                    revision: number;
-                }[], {
-                    id: string;
-                    revision: number;
-                }[]>>;
-                maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
-                maxTotalTokens: z.ZodOptional<z.ZodNumber>;
-                maxCostAmount: z.ZodOptional<z.ZodNumber>;
-            }, "strict", z.ZodTypeAny, {
-                instructionTemplateRefs?: {
-                    id: string;
-                    revision: number;
-                }[] | undefined;
-                requiredCapabilities?: string[] | undefined;
-                maxRuntimeSeconds?: number | undefined;
-                maxTotalTokens?: number | undefined;
-                maxCostAmount?: number | undefined;
-                disallowedProviderIds?: string[] | undefined;
-                promptRef?: string | undefined;
-            }, {
-                instructionTemplateRefs?: {
-                    id: string;
-                    revision: number;
-                }[] | undefined;
-                requiredCapabilities?: string[] | undefined;
-                maxRuntimeSeconds?: number | undefined;
-                maxTotalTokens?: number | undefined;
-                maxCostAmount?: number | undefined;
-                disallowedProviderIds?: string[] | undefined;
-                promptRef?: string | undefined;
-            }>>;
             tools: z.ZodObject<{
                 allowed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
                 denied: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
@@ -8200,7 +8126,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                         publishes?: string[] | undefined;
                     }>>;
                 }, "strict", z.ZodTypeAny, {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;
@@ -8221,7 +8147,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                     } | undefined;
                     promptTask?: string | undefined;
                 }, {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;
@@ -8244,7 +8170,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 }>, "many">>;
                 requiresArtifactKinds: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
             }, "strict", z.ZodTypeAny, {
-                stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
                 objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
@@ -8252,7 +8178,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 subjectId?: string | null | undefined;
                 includeWorkdayArtifacts?: boolean | undefined;
                 stages?: {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;
@@ -8275,7 +8201,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 }[] | undefined;
                 requiresArtifactKinds?: string[] | undefined;
             }, {
-                stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
                 objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
@@ -8283,7 +8209,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 subjectId?: string | null | undefined;
                 includeWorkdayArtifacts?: boolean | undefined;
                 stages?: {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;
@@ -8372,7 +8298,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 blockExecutionWhenCreated?: boolean | undefined;
             }>>;
             execution: z.ZodOptional<z.ZodObject<{
-                requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+                reasoningEffort: z.ZodOptional<z.ZodEnum<["minimal", "low", "medium", "high", "xhigh"]>>;
                 maxRuntimeSeconds: z.ZodOptional<z.ZodNumber>;
                 closeoutWarningSeconds: z.ZodOptional<z.ZodNumber>;
                 preparationSeconds: z.ZodOptional<z.ZodNumber>;
@@ -8405,7 +8331,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 closeoutSeconds?: number | undefined;
                 closeoutWarningSeconds?: number | undefined;
                 enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-                requiredCapabilities?: string[] | undefined;
+                reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
                 maxRuntimeSeconds?: number | undefined;
                 maxRetries?: number | undefined;
                 verificationRequired?: boolean | undefined;
@@ -8426,7 +8352,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 closeoutSeconds?: number | undefined;
                 closeoutWarningSeconds?: number | undefined;
                 enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-                requiredCapabilities?: string[] | undefined;
+                reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
                 maxRuntimeSeconds?: number | undefined;
                 maxRetries?: number | undefined;
                 verificationRequired?: boolean | undefined;
@@ -8445,36 +8371,36 @@ export declare function validateAgentDefinitionModel(value: unknown): {
             }>>;
         }, "strict", z.ZodTypeAny, {
             enabled: boolean;
+            outputs: {
+                messageTypes: string[];
+                modelMutations: string[];
+            };
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
                 base: "main" | "staging";
-                prefix?: string | undefined;
                 target?: "main" | "staging" | undefined;
-                branchNameTemplate?: string | undefined;
                 worktree?: string | undefined;
+                prefix?: string | undefined;
+                branchNameTemplate?: string | undefined;
                 updateBaseBeforeRun?: boolean | undefined;
                 mergeTargetBeforeSave?: boolean | undefined;
             };
-            handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+            handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
             tools: {
                 allowed: string[];
                 denied?: string[] | undefined;
             };
-            outputs: {
-                messageTypes: string[];
-                modelMutations: string[];
-            };
             execution?: {
                 preparationSeconds?: number | undefined;
                 closeoutSeconds?: number | undefined;
                 closeoutWarningSeconds?: number | undefined;
                 enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-                requiredCapabilities?: string[] | undefined;
+                reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
                 maxRuntimeSeconds?: number | undefined;
                 maxRetries?: number | undefined;
                 verificationRequired?: boolean | undefined;
@@ -8504,19 +8430,30 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 id: string;
                 revision: number;
             }[] | undefined;
-            permissions?: {
-                content?: Record<string, {
-                    operations: string[];
-                    filters?: Record<string, unknown> | undefined;
+            capabilityRequirements?: {
+                requirement: "required" | "preferred";
+                capabilityId: string;
+                versionRange: string;
+                configuration?: Record<string, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
                 }> | undefined;
-                commit?: {
-                    allowed: boolean;
-                } | undefined;
+                alternativeGroup?: string | null | undefined;
+                requiredFeatures?: string[] | undefined;
+            }[] | undefined;
+            permissions?: {
                 repository?: {
                     allowCodeMutation?: boolean | undefined;
                     readPaths?: string[] | undefined;
                     writePaths?: string[] | undefined;
                 } | undefined;
+                commit?: {
+                    allowed: boolean;
+                } | undefined;
+                content?: Record<string, {
+                    operations: string[];
+                    filters?: Record<string, unknown> | undefined;
+                }> | undefined;
                 network?: {
                     allowWeb?: boolean | undefined;
                     allowedDomains?: string[] | undefined;
@@ -8539,18 +8476,6 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 requiredArtifactKinds?: string[] | undefined;
                 blockOnOpenQuestions?: boolean | undefined;
             } | undefined;
-            providerOverrides?: {
-                instructionTemplateRefs?: {
-                    id: string;
-                    revision: number;
-                }[] | undefined;
-                requiredCapabilities?: string[] | undefined;
-                maxRuntimeSeconds?: number | undefined;
-                maxTotalTokens?: number | undefined;
-                maxCostAmount?: number | undefined;
-                disallowedProviderIds?: string[] | undefined;
-                promptRef?: string | undefined;
-            } | undefined;
             signals?: {
                 subscribesTo?: {
                     contract: string;
@@ -8570,7 +8495,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
                 objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
@@ -8578,7 +8503,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 subjectId?: string | null | undefined;
                 includeWorkdayArtifacts?: boolean | undefined;
                 stages?: {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;
@@ -8618,36 +8543,36 @@ export declare function validateAgentDefinitionModel(value: unknown): {
             } | undefined;
         }, {
             enabled: boolean;
+            outputs: {
+                messageTypes: string[];
+                modelMutations: string[];
+            };
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
                 base: "main" | "staging";
-                prefix?: string | undefined;
                 target?: "main" | "staging" | undefined;
-                branchNameTemplate?: string | undefined;
                 worktree?: string | undefined;
+                prefix?: string | undefined;
+                branchNameTemplate?: string | undefined;
                 updateBaseBeforeRun?: boolean | undefined;
                 mergeTargetBeforeSave?: boolean | undefined;
             };
-            handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+            handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
             tools: {
                 allowed: string[];
                 denied?: string[] | undefined;
             };
-            outputs: {
-                messageTypes: string[];
-                modelMutations: string[];
-            };
             execution?: {
                 preparationSeconds?: number | undefined;
                 closeoutSeconds?: number | undefined;
                 closeoutWarningSeconds?: number | undefined;
                 enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-                requiredCapabilities?: string[] | undefined;
+                reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
                 maxRuntimeSeconds?: number | undefined;
                 maxRetries?: number | undefined;
                 verificationRequired?: boolean | undefined;
@@ -8677,19 +8602,30 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 id: string;
                 revision: number;
             }[] | undefined;
-            permissions?: {
-                content?: Record<string, {
-                    operations: string[];
-                    filters?: Record<string, unknown> | undefined;
+            capabilityRequirements?: {
+                requirement: "required" | "preferred";
+                capabilityId: string;
+                versionRange: string;
+                configuration?: Record<string, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
                 }> | undefined;
-                commit?: {
-                    allowed: boolean;
-                } | undefined;
+                alternativeGroup?: string | null | undefined;
+                requiredFeatures?: string[] | undefined;
+            }[] | undefined;
+            permissions?: {
                 repository?: {
                     allowCodeMutation?: boolean | undefined;
                     readPaths?: string[] | undefined;
                     writePaths?: string[] | undefined;
                 } | undefined;
+                commit?: {
+                    allowed: boolean;
+                } | undefined;
+                content?: Record<string, {
+                    operations: string[];
+                    filters?: Record<string, unknown> | undefined;
+                }> | undefined;
                 network?: {
                     allowWeb?: boolean | undefined;
                     allowedDomains?: string[] | undefined;
@@ -8712,18 +8648,6 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 requiredArtifactKinds?: string[] | undefined;
                 blockOnOpenQuestions?: boolean | undefined;
             } | undefined;
-            providerOverrides?: {
-                instructionTemplateRefs?: {
-                    id: string;
-                    revision: number;
-                }[] | undefined;
-                requiredCapabilities?: string[] | undefined;
-                maxRuntimeSeconds?: number | undefined;
-                maxTotalTokens?: number | undefined;
-                maxCostAmount?: number | undefined;
-                disallowedProviderIds?: string[] | undefined;
-                promptRef?: string | undefined;
-            } | undefined;
             signals?: {
                 subscribesTo?: {
                     contract: string;
@@ -8743,7 +8667,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
                 objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
@@ -8751,7 +8675,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 subjectId?: string | null | undefined;
                 includeWorkdayArtifacts?: boolean | undefined;
                 stages?: {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;
@@ -8791,36 +8715,36 @@ export declare function validateAgentDefinitionModel(value: unknown): {
             } | undefined;
         }>, {
             enabled: boolean;
+            outputs: {
+                messageTypes: string[];
+                modelMutations: string[];
+            };
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
                 base: "main" | "staging";
-                prefix?: string | undefined;
                 target?: "main" | "staging" | undefined;
-                branchNameTemplate?: string | undefined;
                 worktree?: string | undefined;
+                prefix?: string | undefined;
+                branchNameTemplate?: string | undefined;
                 updateBaseBeforeRun?: boolean | undefined;
                 mergeTargetBeforeSave?: boolean | undefined;
             };
-            handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+            handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
             tools: {
                 allowed: string[];
                 denied?: string[] | undefined;
             };
-            outputs: {
-                messageTypes: string[];
-                modelMutations: string[];
-            };
             execution?: {
                 preparationSeconds?: number | undefined;
                 closeoutSeconds?: number | undefined;
                 closeoutWarningSeconds?: number | undefined;
                 enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-                requiredCapabilities?: string[] | undefined;
+                reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
                 maxRuntimeSeconds?: number | undefined;
                 maxRetries?: number | undefined;
                 verificationRequired?: boolean | undefined;
@@ -8850,19 +8774,30 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 id: string;
                 revision: number;
             }[] | undefined;
-            permissions?: {
-                content?: Record<string, {
-                    operations: string[];
-                    filters?: Record<string, unknown> | undefined;
+            capabilityRequirements?: {
+                requirement: "required" | "preferred";
+                capabilityId: string;
+                versionRange: string;
+                configuration?: Record<string, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
                 }> | undefined;
-                commit?: {
-                    allowed: boolean;
-                } | undefined;
+                alternativeGroup?: string | null | undefined;
+                requiredFeatures?: string[] | undefined;
+            }[] | undefined;
+            permissions?: {
                 repository?: {
                     allowCodeMutation?: boolean | undefined;
                     readPaths?: string[] | undefined;
                     writePaths?: string[] | undefined;
                 } | undefined;
+                commit?: {
+                    allowed: boolean;
+                } | undefined;
+                content?: Record<string, {
+                    operations: string[];
+                    filters?: Record<string, unknown> | undefined;
+                }> | undefined;
                 network?: {
                     allowWeb?: boolean | undefined;
                     allowedDomains?: string[] | undefined;
@@ -8885,18 +8820,6 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 requiredArtifactKinds?: string[] | undefined;
                 blockOnOpenQuestions?: boolean | undefined;
             } | undefined;
-            providerOverrides?: {
-                instructionTemplateRefs?: {
-                    id: string;
-                    revision: number;
-                }[] | undefined;
-                requiredCapabilities?: string[] | undefined;
-                maxRuntimeSeconds?: number | undefined;
-                maxTotalTokens?: number | undefined;
-                maxCostAmount?: number | undefined;
-                disallowedProviderIds?: string[] | undefined;
-                promptRef?: string | undefined;
-            } | undefined;
             signals?: {
                 subscribesTo?: {
                     contract: string;
@@ -8916,7 +8839,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
                 objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
@@ -8924,7 +8847,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 subjectId?: string | null | undefined;
                 includeWorkdayArtifacts?: boolean | undefined;
                 stages?: {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;
@@ -8964,36 +8887,36 @@ export declare function validateAgentDefinitionModel(value: unknown): {
             } | undefined;
         }, {
             enabled: boolean;
+            outputs: {
+                messageTypes: string[];
+                modelMutations: string[];
+            };
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
                 base: "main" | "staging";
-                prefix?: string | undefined;
                 target?: "main" | "staging" | undefined;
-                branchNameTemplate?: string | undefined;
                 worktree?: string | undefined;
+                prefix?: string | undefined;
+                branchNameTemplate?: string | undefined;
                 updateBaseBeforeRun?: boolean | undefined;
                 mergeTargetBeforeSave?: boolean | undefined;
             };
-            handler: "writer" | "actor" | "estimate" | "releaser" | "reporter";
+            handler: "actor" | "writer" | "estimate" | "releaser" | "reporter";
             tools: {
                 allowed: string[];
                 denied?: string[] | undefined;
             };
-            outputs: {
-                messageTypes: string[];
-                modelMutations: string[];
-            };
             execution?: {
                 preparationSeconds?: number | undefined;
                 closeoutSeconds?: number | undefined;
                 closeoutWarningSeconds?: number | undefined;
                 enforcementConfidence?: "exact" | "bounded" | "estimated" | "opaque" | undefined;
-                requiredCapabilities?: string[] | undefined;
+                reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
                 maxRuntimeSeconds?: number | undefined;
                 maxRetries?: number | undefined;
                 verificationRequired?: boolean | undefined;
@@ -9023,19 +8946,30 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 id: string;
                 revision: number;
             }[] | undefined;
-            permissions?: {
-                content?: Record<string, {
-                    operations: string[];
-                    filters?: Record<string, unknown> | undefined;
+            capabilityRequirements?: {
+                requirement: "required" | "preferred";
+                capabilityId: string;
+                versionRange: string;
+                configuration?: Record<string, {
+                    requirement: "required" | "preferred";
+                    value?: unknown;
                 }> | undefined;
-                commit?: {
-                    allowed: boolean;
-                } | undefined;
+                alternativeGroup?: string | null | undefined;
+                requiredFeatures?: string[] | undefined;
+            }[] | undefined;
+            permissions?: {
                 repository?: {
                     allowCodeMutation?: boolean | undefined;
                     readPaths?: string[] | undefined;
                     writePaths?: string[] | undefined;
                 } | undefined;
+                commit?: {
+                    allowed: boolean;
+                } | undefined;
+                content?: Record<string, {
+                    operations: string[];
+                    filters?: Record<string, unknown> | undefined;
+                }> | undefined;
                 network?: {
                     allowWeb?: boolean | undefined;
                     allowedDomains?: string[] | undefined;
@@ -9058,18 +8992,6 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 requiredArtifactKinds?: string[] | undefined;
                 blockOnOpenQuestions?: boolean | undefined;
             } | undefined;
-            providerOverrides?: {
-                instructionTemplateRefs?: {
-                    id: string;
-                    revision: number;
-                }[] | undefined;
-                requiredCapabilities?: string[] | undefined;
-                maxRuntimeSeconds?: number | undefined;
-                maxTotalTokens?: number | undefined;
-                maxCostAmount?: number | undefined;
-                disallowedProviderIds?: string[] | undefined;
-                promptRef?: string | undefined;
-            } | undefined;
             signals?: {
                 subscribesTo?: {
                     contract: string;
@@ -9089,7 +9011,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                stage?: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
                 objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
@@ -9097,7 +9019,7 @@ export declare function validateAgentDefinitionModel(value: unknown): {
                 subjectId?: string | null | undefined;
                 includeWorkdayArtifacts?: boolean | undefined;
                 stages?: {
-                    stage: "closeout" | "revision" | "discovery" | "synthesis" | "deliberation" | "evaluation";
+                    stage: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation";
                     signals?: {
                         subscribesTo?: {
                             contract: string;