@agentxm/client-core 0.14.0 → 0.14.1

package/dist/src/unstable/agent-capabilities/schema.d.ts

@@ -5,6 +5,10 @@
  */
 import * as Schema from "effect/Schema";
 /** @experimental This API is unstable and may change without notice. */
+export declare const UrlSchema: Schema.NonEmptyString;
+/** @experimental This API is unstable and may change without notice. */
+export type Url = Schema.Schema.Type<typeof UrlSchema>;
+/** @experimental This API is unstable and may change without notice. */
 export declare const AgentIdFromYamlSchema: Schema.NonEmptyString;
 /** @experimental This API is unstable and may change without notice. */
 export type AgentIdFromYaml = Schema.Schema.Type<typeof AgentIdFromYamlSchema>;
@@ -21,6 +25,14 @@ export declare const CapabilityLifecycleSchema: Schema.Literals<readonly ["avail
 /** @experimental This API is unstable and may change without notice. */
 export type CapabilityLifecycle = Schema.Schema.Type<typeof CapabilityLifecycleSchema>;
 /** @experimental This API is unstable and may change without notice. */
+export declare const ActiveLifecycleSchema: Schema.Literals<readonly ["available", "planned"]>;
+/** @experimental This API is unstable and may change without notice. */
+export type ActiveLifecycle = Schema.Schema.Type<typeof ActiveLifecycleSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const InactiveLifecycleSchema: Schema.Literals<readonly ["unsupported", "unknown"]>;
+/** @experimental This API is unstable and may change without notice. */
+export type InactiveLifecycle = Schema.Schema.Type<typeof InactiveLifecycleSchema>;
+/** @experimental This API is unstable and may change without notice. */
 export declare const ScopeSchema: Schema.Literals<readonly ["user", "project"]>;
 /** @experimental This API is unstable and may change without notice. */
 export type Scope = Schema.Schema.Type<typeof ScopeSchema>;
@@ -49,8 +61,8 @@ export declare const DocLinkSchema: Schema.Struct<{
 export type DocLink = Schema.Schema.Type<typeof DocLinkSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const DetectionSchema: Schema.Struct<{
-    readonly projectDirs: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly userDirs: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
+    readonly projectDirs: Schema.$Array<Schema.NonEmptyString>;
+    readonly userDirs: Schema.$Array<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type Detection = Schema.Schema.Type<typeof DetectionSchema>;
@@ -59,62 +71,87 @@ export declare const LastVerifiedDateSchema: Schema.NonEmptyString;
 /** @experimental This API is unstable and may change without notice. */
 export type LastVerifiedDate = Schema.Schema.Type<typeof LastVerifiedDateSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const CapabilityBaseSchema: Schema.Struct<{
-    lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    notes: Schema.optional<Schema.NonEmptyString>;
-    docs: Schema.optional<Schema.$Array<Schema.Struct<{
+export declare const CapabilityBaseSchema: Schema.Union<readonly [Schema.Struct<{
+    lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    notes: Schema.NullOr<Schema.NonEmptyString>;
+    docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    lastVerified: Schema.NonEmptyString;
+    scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type CapabilityBase = Schema.Schema.Type<typeof CapabilityBaseSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const ScopedCapabilityBaseSchema: Schema.Struct<{
-    scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    notes: Schema.optional<Schema.NonEmptyString>;
-    docs: Schema.optional<Schema.$Array<Schema.Struct<{
+    lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    notes: Schema.NullOr<Schema.NonEmptyString>;
+    docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    lastVerified: Schema.optional<Schema.NonEmptyString>;
+    }>>;
+    sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    lastVerified: Schema.NonEmptyString;
+    scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type ScopedCapabilityBase = Schema.Schema.Type<typeof ScopedCapabilityBaseSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const SkillsCapabilitySchema: Schema.Struct<{
-    readonly directory: Schema.optional<Schema.NonEmptyString>;
+export declare const SkillsCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly directory: Schema.NonEmptyString;
     readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
     readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type SkillsCapability = Schema.Schema.Type<typeof SkillsCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const CommandsCapabilitySchema: Schema.Struct<{
-    readonly directory: Schema.optional<Schema.NonEmptyString>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+export declare const CommandsCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly directory: Schema.NonEmptyString;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type CommandsCapability = Schema.Schema.Type<typeof CommandsCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
@@ -122,19 +159,27 @@ export declare const SubagentsLayoutSchema: Schema.Literals<readonly ["file", "d
 /** @experimental This API is unstable and may change without notice. */
 export type SubagentsLayout = Schema.Schema.Type<typeof SubagentsLayoutSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const SubagentsCapabilitySchema: Schema.Struct<{
-    readonly directory: Schema.optional<Schema.NonEmptyString>;
-    readonly layout: Schema.withDecodingDefaultType<Schema.Literals<readonly ["file", "directory"]>>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+export declare const SubagentsCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly directory: Schema.NonEmptyString;
+    readonly layout: Schema.Literals<readonly ["file", "directory"]>;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type SubagentsCapability = Schema.Schema.Type<typeof SubagentsCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
@@ -146,38 +191,86 @@ export declare const InstructionsImportSyntaxSchema: Schema.Literals<readonly ["
 /** @experimental This API is unstable and may change without notice. */
 export type InstructionsImportSyntax = Schema.Schema.Type<typeof InstructionsImportSyntaxSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const InstructionsCapabilitySchema: Schema.Struct<{
-    readonly kind: Schema.Literals<readonly ["agents-md", "own-file", "rules-dir"]>;
+export declare const InstructionsCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"agents-md">;
+    readonly files: Schema.Tuple<readonly [Schema.Literal<"AGENTS.md">]>;
+    readonly nestedDiscovery: Schema.Boolean;
+    readonly importSyntax: Schema.NullOr<Schema.Literals<readonly ["at-path"]>>;
+    readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+    readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"own-file">;
+    readonly files: Schema.Tuple<readonly [Schema.NonEmptyString]>;
+    readonly nestedDiscovery: Schema.Boolean;
+    readonly importSyntax: Schema.NullOr<Schema.Literals<readonly ["at-path"]>>;
+    readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+    readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"rules-dir">;
     readonly files: Schema.$Array<Schema.NonEmptyString>;
     readonly nestedDiscovery: Schema.Boolean;
-    readonly importSyntax: Schema.optional<Schema.Literals<readonly ["at-path"]>>;
+    readonly importSyntax: Schema.NullOr<Schema.Literals<readonly ["at-path"]>>;
     readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
     readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type InstructionsCapability = Schema.Schema.Type<typeof InstructionsCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const RulesCapabilitySchema: Schema.Struct<{
-    readonly directory: Schema.optional<Schema.NonEmptyString>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+export declare const RulesCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly directory: Schema.NonEmptyString;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type RulesCapability = Schema.Schema.Type<typeof RulesCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
@@ -215,7 +308,7 @@ export declare const McpTypeFieldSchema: Schema.Struct<{
 export type McpTypeField = Schema.Schema.Type<typeof McpTypeFieldSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const McpStdioDialectSchema: Schema.Struct<{
-    readonly typeField: Schema.optional<Schema.Struct<{
+    readonly typeField: Schema.NullOr<Schema.Struct<{
         readonly name: Schema.NonEmptyString;
         readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
             readonly "streamable-http": Schema.NonEmptyString;
@@ -223,7 +316,7 @@ export declare const McpStdioDialectSchema: Schema.Struct<{
         }>]>;
     }>>;
     readonly command: Schema.Literals<readonly ["split", "array"]>;
-    readonly envKey: Schema.optional<Schema.NonEmptyString>;
+    readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpStdioDialect = Schema.Schema.Type<typeof McpStdioDialectSchema>;
@@ -236,7 +329,7 @@ export declare const McpUrlKeyMapSchema: Schema.Struct<{
 export type McpUrlKeyMap = Schema.Schema.Type<typeof McpUrlKeyMapSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const McpRemoteDialectSchema: Schema.Struct<{
-    readonly typeField: Schema.optional<Schema.Struct<{
+    readonly typeField: Schema.NullOr<Schema.Struct<{
         readonly name: Schema.NonEmptyString;
         readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
             readonly "streamable-http": Schema.NonEmptyString;
@@ -247,7 +340,7 @@ export declare const McpRemoteDialectSchema: Schema.Struct<{
         readonly "streamable-http": Schema.NonEmptyString;
         readonly sse: Schema.NonEmptyString;
     }>;
-    readonly headersKey: Schema.optional<Schema.NonEmptyString>;
+    readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpRemoteDialect = Schema.Schema.Type<typeof McpRemoteDialectSchema>;
@@ -260,8 +353,8 @@ export declare const McpConfigSchema: Schema.Struct<{
         readonly path: Schema.NonEmptyString;
         readonly format: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
     }>>;
-    readonly stdio: Schema.optional<Schema.Struct<{
-        readonly typeField: Schema.optional<Schema.Struct<{
+    readonly stdio: Schema.NullOr<Schema.Struct<{
+        readonly typeField: Schema.NullOr<Schema.Struct<{
             readonly name: Schema.NonEmptyString;
             readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
                 readonly "streamable-http": Schema.NonEmptyString;
@@ -269,10 +362,10 @@ export declare const McpConfigSchema: Schema.Struct<{
             }>]>;
         }>>;
         readonly command: Schema.Literals<readonly ["split", "array"]>;
-        readonly envKey: Schema.optional<Schema.NonEmptyString>;
+        readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
     }>>;
-    readonly remote: Schema.optional<Schema.Struct<{
-        readonly typeField: Schema.optional<Schema.Struct<{
+    readonly remote: Schema.NullOr<Schema.Struct<{
+        readonly typeField: Schema.NullOr<Schema.Struct<{
             readonly name: Schema.NonEmptyString;
             readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
                 readonly "streamable-http": Schema.NonEmptyString;
@@ -283,16 +376,18 @@ export declare const McpConfigSchema: Schema.Struct<{
             readonly "streamable-http": Schema.NonEmptyString;
             readonly sse: Schema.NonEmptyString;
         }>;
-        readonly headersKey: Schema.optional<Schema.NonEmptyString>;
+        readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
     }>>;
-    readonly transform: Schema.optional<Schema.NonEmptyString>;
+    readonly transform: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpConfig = Schema.Schema.Type<typeof McpConfigSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const McpCapabilitySchema: Schema.Struct<{
-    readonly transports: Schema.$Array<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
-    readonly config: Schema.optional<Schema.Struct<{
+export declare const McpCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly standardsCompliance: Schema.Literal<"full">;
+    readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+    readonly transports: Schema.NonEmptyArray<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
+    readonly config: Schema.Struct<{
         readonly serversKey: Schema.Literals<readonly ["mcpServers", "servers", "mcp", "mcp_servers", "context_servers"]>;
         readonly nativeEnabled: Schema.Boolean;
         readonly targets: Schema.$Array<Schema.Struct<{
@@ -300,8 +395,8 @@ export declare const McpCapabilitySchema: Schema.Struct<{
             readonly path: Schema.NonEmptyString;
             readonly format: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
         }>>;
-        readonly stdio: Schema.optional<Schema.Struct<{
-            readonly typeField: Schema.optional<Schema.Struct<{
+        readonly stdio: Schema.NullOr<Schema.Struct<{
+            readonly typeField: Schema.NullOr<Schema.Struct<{
                 readonly name: Schema.NonEmptyString;
                 readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
                     readonly "streamable-http": Schema.NonEmptyString;
@@ -309,10 +404,10 @@ export declare const McpCapabilitySchema: Schema.Struct<{
                 }>]>;
             }>>;
             readonly command: Schema.Literals<readonly ["split", "array"]>;
-            readonly envKey: Schema.optional<Schema.NonEmptyString>;
+            readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
         }>>;
-        readonly remote: Schema.optional<Schema.Struct<{
-            readonly typeField: Schema.optional<Schema.Struct<{
+        readonly remote: Schema.NullOr<Schema.Struct<{
+            readonly typeField: Schema.NullOr<Schema.Struct<{
                 readonly name: Schema.NonEmptyString;
                 readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
                     readonly "streamable-http": Schema.NonEmptyString;
@@ -323,22 +418,41 @@ export declare const McpCapabilitySchema: Schema.Struct<{
                 readonly "streamable-http": Schema.NonEmptyString;
                 readonly sse: Schema.NonEmptyString;
             }>;
-            readonly headersKey: Schema.optional<Schema.NonEmptyString>;
+            readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
         }>>;
-        readonly transform: Schema.optional<Schema.NonEmptyString>;
+        readonly transform: Schema.NullOr<Schema.NonEmptyString>;
+    }>;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
     }>>;
-    readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly standardsCompliance: Schema.Literals<readonly ["parity", "partial"]>;
     readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly transports: Schema.NonEmptyArray<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpCapability = Schema.Schema.Type<typeof McpCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
@@ -363,7 +477,7 @@ export declare const HooksSerializerSchema: Schema.Literals<readonly ["claude-co
 /** @experimental This API is unstable and may change without notice. */
 export type HooksSerializer = Schema.Schema.Type<typeof HooksSerializerSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const HooksCapabilitySchema: Schema.Struct<{
+export declare const HooksCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
     readonly configFiles: Schema.$Array<Schema.Struct<{
         readonly scope: Schema.Literals<readonly ["user", "project"]>;
         readonly path: Schema.NonEmptyString;
@@ -371,23 +485,31 @@ export declare const HooksCapabilitySchema: Schema.Struct<{
         readonly gitignored: Schema.Boolean;
     }>>;
     readonly serializer: Schema.Literals<readonly ["claude-code-settings"]>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type HooksCapability = Schema.Schema.Type<typeof HooksCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const PermissionGrammarSchema: Schema.Struct<{
     readonly style: Schema.Literals<readonly ["tool-call", "prefix", "regex", "glob", "starlark-rule"]>;
     readonly example: Schema.NonEmptyString;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type PermissionGrammar = Schema.Schema.Type<typeof PermissionGrammarSchema>;
@@ -396,64 +518,72 @@ export declare const PermissionPrerequisiteSchema: Schema.Struct<{
     readonly key: Schema.NonEmptyString;
     readonly value: Schema.NonEmptyString;
     readonly scope: Schema.Literals<readonly ["user", "project"]>;
-    readonly note: Schema.optional<Schema.NonEmptyString>;
+    readonly note: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type PermissionPrerequisite = Schema.Schema.Type<typeof PermissionPrerequisiteSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const PermissionCliFlagSchema: Schema.Struct<{
     readonly flag: Schema.NonEmptyString;
-    readonly note: Schema.optional<Schema.NonEmptyString>;
+    readonly note: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type PermissionCliFlag = Schema.Schema.Type<typeof PermissionCliFlagSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const PermissionGrantSchema: Schema.Struct<{
     readonly target: Schema.NonEmptyString;
-    readonly patch: Schema.optional<Schema.Unknown>;
-    readonly template: Schema.optional<Schema.NonEmptyString>;
+    readonly patch: Schema.NullOr<Schema.Unknown>;
+    readonly template: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type PermissionGrant = Schema.Schema.Type<typeof PermissionGrantSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const PermissionsCapabilitySchema: Schema.Struct<{
-    readonly mechanism: Schema.$Array<Schema.Literals<readonly ["config-file", "cli-flag", "ui-only"]>>;
-    readonly configFiles: Schema.optional<Schema.$Array<Schema.Struct<{
+export declare const PermissionsCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly mechanism: Schema.NonEmptyArray<Schema.Literals<readonly ["config-file", "cli-flag", "ui-only"]>>;
+    readonly configFiles: Schema.$Array<Schema.Struct<{
         readonly scope: Schema.Literals<readonly ["user", "project"]>;
         readonly path: Schema.NonEmptyString;
         readonly format: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
         readonly gitignored: Schema.Boolean;
-    }>>>;
-    readonly grammar: Schema.optional<Schema.Struct<{
+    }>>;
+    readonly grammar: Schema.NullOr<Schema.Struct<{
         readonly style: Schema.Literals<readonly ["tool-call", "prefix", "regex", "glob", "starlark-rule"]>;
         readonly example: Schema.NonEmptyString;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     }>>;
-    readonly prerequisites: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly prerequisites: Schema.$Array<Schema.Struct<{
         readonly key: Schema.NonEmptyString;
         readonly value: Schema.NonEmptyString;
         readonly scope: Schema.Literals<readonly ["user", "project"]>;
-        readonly note: Schema.optional<Schema.NonEmptyString>;
-    }>>>;
-    readonly cliFlags: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly note: Schema.NullOr<Schema.NonEmptyString>;
+    }>>;
+    readonly cliFlags: Schema.$Array<Schema.Struct<{
         readonly flag: Schema.NonEmptyString;
-        readonly note: Schema.optional<Schema.NonEmptyString>;
-    }>>>;
-    readonly grants: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly note: Schema.NullOr<Schema.NonEmptyString>;
+    }>>;
+    readonly grants: Schema.$Record<Schema.String, Schema.Struct<{
         readonly target: Schema.NonEmptyString;
-        readonly patch: Schema.optional<Schema.Unknown>;
-        readonly template: Schema.optional<Schema.NonEmptyString>;
-    }>>>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly patch: Schema.NullOr<Schema.Unknown>;
+        readonly template: Schema.NullOr<Schema.NonEmptyString>;
+    }>>;
+    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-}>;
+    }>>;
+    readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly lastVerified: Schema.NonEmptyString;
+    readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+}>, Schema.Struct<{
+    readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+    readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
 /** @experimental This API is unstable and may change without notice. */
 export type PermissionsCapability = Schema.Schema.Type<typeof PermissionsCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
@@ -464,46 +594,64 @@ export declare const AgentSchema: Schema.Struct<{
     readonly name: Schema.NonEmptyString;
     readonly vendor: Schema.NonEmptyString;
     readonly homepage: Schema.NonEmptyString;
-    readonly interfaces: Schema.$Array<Schema.Literals<readonly ["cli", "ide-extension"]>>;
-    readonly family: Schema.optional<Schema.NonEmptyString>;
-    readonly rootDir: Schema.optional<Schema.NullOr<Schema.NonEmptyString>>;
-    readonly detection: Schema.optional<Schema.Struct<{
-        readonly projectDirs: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly userDirs: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    }>>;
-    readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly interfaces: Schema.NonEmptyArray<Schema.Literals<readonly ["cli", "ide-extension"]>>;
+    readonly family: Schema.NullOr<Schema.NonEmptyString>;
+    readonly rootDir: Schema.NullOr<Schema.NonEmptyString>;
+    readonly detection: Schema.Struct<{
+        readonly projectDirs: Schema.$Array<Schema.NonEmptyString>;
+        readonly userDirs: Schema.$Array<Schema.NonEmptyString>;
+    }>;
+    readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
         readonly url: Schema.NonEmptyString;
-    }>>>;
-    readonly skills: Schema.optional<Schema.Struct<{
-        readonly directory: Schema.optional<Schema.NonEmptyString>;
+    }>>;
+    readonly skills: Schema.Union<readonly [Schema.Struct<{
+        readonly directory: Schema.NonEmptyString;
         readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
         readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
-    readonly commands: Schema.optional<Schema.Struct<{
-        readonly directory: Schema.optional<Schema.NonEmptyString>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
-    readonly mcp: Schema.optional<Schema.Struct<{
-        readonly transports: Schema.$Array<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
-        readonly config: Schema.optional<Schema.Struct<{
+        }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
+    readonly commands: Schema.Union<readonly [Schema.Struct<{
+        readonly directory: Schema.NonEmptyString;
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
+    readonly mcp: Schema.Union<readonly [Schema.Struct<{
+        readonly standardsCompliance: Schema.Literal<"full">;
+        readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+        readonly transports: Schema.NonEmptyArray<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
+        readonly config: Schema.Struct<{
             readonly serversKey: Schema.Literals<readonly ["mcpServers", "servers", "mcp", "mcp_servers", "context_servers"]>;
             readonly nativeEnabled: Schema.Boolean;
             readonly targets: Schema.$Array<Schema.Struct<{
@@ -511,8 +659,8 @@ export declare const AgentSchema: Schema.Struct<{
                 readonly path: Schema.NonEmptyString;
                 readonly format: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
             }>>;
-            readonly stdio: Schema.optional<Schema.Struct<{
-                readonly typeField: Schema.optional<Schema.Struct<{
+            readonly stdio: Schema.NullOr<Schema.Struct<{
+                readonly typeField: Schema.NullOr<Schema.Struct<{
                     readonly name: Schema.NonEmptyString;
                     readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
                         readonly "streamable-http": Schema.NonEmptyString;
@@ -520,10 +668,10 @@ export declare const AgentSchema: Schema.Struct<{
                     }>]>;
                 }>>;
                 readonly command: Schema.Literals<readonly ["split", "array"]>;
-                readonly envKey: Schema.optional<Schema.NonEmptyString>;
+                readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
             }>>;
-            readonly remote: Schema.optional<Schema.Struct<{
-                readonly typeField: Schema.optional<Schema.Struct<{
+            readonly remote: Schema.NullOr<Schema.Struct<{
+                readonly typeField: Schema.NullOr<Schema.Struct<{
                     readonly name: Schema.NonEmptyString;
                     readonly value: Schema.Union<readonly [Schema.NonEmptyString, Schema.Struct<{
                         readonly "streamable-http": Schema.NonEmptyString;
@@ -534,65 +682,140 @@ export declare const AgentSchema: Schema.Struct<{
                     readonly "streamable-http": Schema.NonEmptyString;
                     readonly sse: Schema.NonEmptyString;
                 }>;
-                readonly headersKey: Schema.optional<Schema.NonEmptyString>;
+                readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
             }>>;
-            readonly transform: Schema.optional<Schema.NonEmptyString>;
+            readonly transform: Schema.NullOr<Schema.NonEmptyString>;
+        }>;
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly standardsCompliance: Schema.Literals<readonly ["parity", "partial"]>;
+        readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+        readonly transports: Schema.NonEmptyArray<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
         }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
+    readonly subagents: Schema.Union<readonly [Schema.Struct<{
+        readonly directory: Schema.NonEmptyString;
+        readonly layout: Schema.Literals<readonly ["file", "directory"]>;
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
+    readonly instructions: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"agents-md">;
+        readonly files: Schema.Tuple<readonly [Schema.Literal<"AGENTS.md">]>;
+        readonly nestedDiscovery: Schema.Boolean;
+        readonly importSyntax: Schema.NullOr<Schema.Literals<readonly ["at-path"]>>;
         readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
         readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
-    readonly subagents: Schema.optional<Schema.Struct<{
-        readonly directory: Schema.optional<Schema.NonEmptyString>;
-        readonly layout: Schema.withDecodingDefaultType<Schema.Literals<readonly ["file", "directory"]>>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"own-file">;
+        readonly files: Schema.Tuple<readonly [Schema.NonEmptyString]>;
+        readonly nestedDiscovery: Schema.Boolean;
+        readonly importSyntax: Schema.NullOr<Schema.Literals<readonly ["at-path"]>>;
+        readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+        readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
-    readonly instructions: Schema.optional<Schema.Struct<{
-        readonly kind: Schema.Literals<readonly ["agents-md", "own-file", "rules-dir"]>;
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"rules-dir">;
         readonly files: Schema.$Array<Schema.NonEmptyString>;
         readonly nestedDiscovery: Schema.Boolean;
-        readonly importSyntax: Schema.optional<Schema.Literals<readonly ["at-path"]>>;
+        readonly importSyntax: Schema.NullOr<Schema.Literals<readonly ["at-path"]>>;
         readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
         readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
-    readonly rules: Schema.optional<Schema.Struct<{
-        readonly directory: Schema.optional<Schema.NonEmptyString>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
-    readonly hooks: Schema.optional<Schema.Struct<{
+        }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
+    readonly rules: Schema.Union<readonly [Schema.Struct<{
+        readonly directory: Schema.NonEmptyString;
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
+    readonly hooks: Schema.Union<readonly [Schema.Struct<{
         readonly configFiles: Schema.$Array<Schema.Struct<{
             readonly scope: Schema.Literals<readonly ["user", "project"]>;
             readonly path: Schema.NonEmptyString;
@@ -600,54 +823,70 @@ export declare const AgentSchema: Schema.Struct<{
             readonly gitignored: Schema.Boolean;
         }>>;
         readonly serializer: Schema.Literals<readonly ["claude-code-settings"]>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
-    readonly permissions: Schema.optional<Schema.Struct<{
-        readonly mechanism: Schema.$Array<Schema.Literals<readonly ["config-file", "cli-flag", "ui-only"]>>;
-        readonly configFiles: Schema.optional<Schema.$Array<Schema.Struct<{
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
+    readonly permissions: Schema.Union<readonly [Schema.Struct<{
+        readonly mechanism: Schema.NonEmptyArray<Schema.Literals<readonly ["config-file", "cli-flag", "ui-only"]>>;
+        readonly configFiles: Schema.$Array<Schema.Struct<{
             readonly scope: Schema.Literals<readonly ["user", "project"]>;
             readonly path: Schema.NonEmptyString;
             readonly format: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
             readonly gitignored: Schema.Boolean;
-        }>>>;
-        readonly grammar: Schema.optional<Schema.Struct<{
+        }>>;
+        readonly grammar: Schema.NullOr<Schema.Struct<{
             readonly style: Schema.Literals<readonly ["tool-call", "prefix", "regex", "glob", "starlark-rule"]>;
             readonly example: Schema.NonEmptyString;
-            readonly notes: Schema.optional<Schema.NonEmptyString>;
+            readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         }>>;
-        readonly prerequisites: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly prerequisites: Schema.$Array<Schema.Struct<{
             readonly key: Schema.NonEmptyString;
             readonly value: Schema.NonEmptyString;
             readonly scope: Schema.Literals<readonly ["user", "project"]>;
-            readonly note: Schema.optional<Schema.NonEmptyString>;
-        }>>>;
-        readonly cliFlags: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+        }>>;
+        readonly cliFlags: Schema.$Array<Schema.Struct<{
             readonly flag: Schema.NonEmptyString;
-            readonly note: Schema.optional<Schema.NonEmptyString>;
-        }>>>;
-        readonly grants: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+        }>>;
+        readonly grants: Schema.$Record<Schema.String, Schema.Struct<{
             readonly target: Schema.NonEmptyString;
-            readonly patch: Schema.optional<Schema.Unknown>;
-            readonly template: Schema.optional<Schema.NonEmptyString>;
-        }>>>;
-        readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-        readonly lifecycle: Schema.withDecodingDefaultType<Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>>;
-        readonly notes: Schema.optional<Schema.NonEmptyString>;
-        readonly docs: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly patch: Schema.NullOr<Schema.Unknown>;
+            readonly template: Schema.NullOr<Schema.NonEmptyString>;
+        }>>;
+        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
             readonly url: Schema.NonEmptyString;
-        }>>>;
-        readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
-    }>>;
+        }>>;
+        readonly sources: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly lastVerified: Schema.NonEmptyString;
+        readonly scopes: Schema.NonEmptyArray<Schema.Literals<readonly ["user", "project"]>>;
+    }>, Schema.Struct<{
+        readonly lifecycle: Schema.Literals<readonly ["unsupported", "unknown"]>;
+        readonly notes: Schema.NullOr<Schema.NonEmptyString>;
+        readonly docs: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.NonEmptyString;
+            readonly url: Schema.NonEmptyString;
+        }>>;
+        readonly sources: Schema.$Array<Schema.NonEmptyString>;
+    }>]>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type Agent = Schema.Schema.Type<typeof AgentSchema>;