@agentxm/client-core 0.14.0 → 0.15.0

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

@@ -4,6 +4,8 @@
  * @experimental This API is unstable and may change without notice.
  */
 import * as Schema from "effect/Schema";
+import { type LeafExtensionType } from "../extension-types/schema.js";
+export { DocLinkSchema, LEAF_EXTENSION_TYPES, StandardSchema, UrlSchema, type DocLink, type LeafExtensionType, type Standard, type Url, } from "../extension-types/schema.js";
 /** @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. */
@@ -17,10 +19,20 @@ export declare const ConventionSchema: Schema.Literals<readonly ["universal", "v
 /** @experimental This API is unstable and may change without notice. */
 export type Convention = Schema.Schema.Type<typeof ConventionSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const CapabilityLifecycleSchema: Schema.Literals<readonly ["available", "planned", "unsupported", "unknown"]>;
+export declare const SUPPORTED_LIFECYCLE: "supported";
+/** @experimental This API is unstable and may change without notice. */
+export declare const CapabilityLifecycleSchema: Schema.Literals<readonly ["supported", "planned", "unsupported", "unknown"]>;
 /** @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 ["supported", "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>;
@@ -33,24 +45,9 @@ export declare const McpTransportSchema: Schema.Literals<readonly ["stdio", "htt
 /** @experimental This API is unstable and may change without notice. */
 export type McpTransport = Schema.Schema.Type<typeof McpTransportSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const StandardSchema: Schema.Struct<{
-    readonly id: Schema.NonEmptyString;
-    readonly name: Schema.NonEmptyString;
-    readonly url: Schema.NonEmptyString;
-}>;
-/** @experimental This API is unstable and may change without notice. */
-export type Standard = Schema.Schema.Type<typeof StandardSchema>;
-/** @experimental This API is unstable and may change without notice. */
-export declare const DocLinkSchema: Schema.Struct<{
-    readonly label: Schema.NonEmptyString;
-    readonly url: Schema.NonEmptyString;
-}>;
-/** @experimental This API is unstable and may change without notice. */
-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,127 +56,213 @@ 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 ["supported", "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 ["supported", "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 SkillsExtensionCapabilitySchema: 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 ["supported", "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>;
+export type SkillsExtensionCapability = Schema.Schema.Type<typeof SkillsExtensionCapabilitySchema>;
 /** @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 CommandsExtensionCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly directory: Schema.NonEmptyString;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+export type CommandsExtensionCapability = Schema.Schema.Type<typeof CommandsExtensionCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const SubagentsLayoutSchema: Schema.Literals<readonly ["file", "directory"]>;
 /** @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 SubagentsExtensionCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly directory: Schema.NonEmptyString;
+    readonly layout: Schema.Literals<readonly ["file", "directory"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+export type SubagentsExtensionCapability = Schema.Schema.Type<typeof SubagentsExtensionCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const InstructionsKindSchema: Schema.Literals<readonly ["agents-md", "own-file", "rules-dir"]>;
+export declare const RuleInstructionsKindSchema: Schema.Literals<readonly ["agents-md", "own-file", "rules-dir"]>;
 /** @experimental This API is unstable and may change without notice. */
-export type InstructionsKind = Schema.Schema.Type<typeof InstructionsKindSchema>;
+export type RuleInstructionsKind = Schema.Schema.Type<typeof RuleInstructionsKindSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const InstructionsImportSyntaxSchema: Schema.Literals<readonly ["at-path"]>;
+export declare const RuleInstructionsImportSyntaxSchema: Schema.Literals<readonly ["at-path"]>;
 /** @experimental This API is unstable and may change without notice. */
-export type InstructionsImportSyntax = Schema.Schema.Type<typeof InstructionsImportSyntaxSchema>;
+export type RuleInstructionsImportSyntax = Schema.Schema.Type<typeof RuleInstructionsImportSyntaxSchema>;
 /** @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 RulesExtensionCapabilitySchema: 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 directory: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+    readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "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 directory: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+    readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "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 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 ["supported", "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>;
+export type RulesExtensionCapability = Schema.Schema.Type<typeof RulesExtensionCapabilitySchema>;
 /** @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 FilesExtensionCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly directory: Schema.NonEmptyString;
+    readonly files: Schema.$Array<Schema.NonEmptyString>;
+    readonly naming: Schema.NullOr<Schema.NonEmptyString>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+export type FilesExtensionCapability = Schema.Schema.Type<typeof FilesExtensionCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const ConfigFileFormatSchema: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
 /** @experimental This API is unstable and may change without notice. */
@@ -215,7 +298,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 +306,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 +319,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 +330,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 +343,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 +352,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 +366,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 McpExtensionCapabilitySchema: 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 +385,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 +394,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,24 +408,43 @@ 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 ["supported", "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 ["supported", "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>;
+export type McpExtensionCapability = Schema.Schema.Type<typeof McpExtensionCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const PermissionMechanismSchema: Schema.Literals<readonly ["config-file", "cli-flag", "ui-only"]>;
 /** @experimental This API is unstable and may change without notice. */
@@ -363,7 +467,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 HooksExtensionCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
     readonly configFiles: Schema.$Array<Schema.Struct<{
         readonly scope: Schema.Literals<readonly ["user", "project"]>;
         readonly path: Schema.NonEmptyString;
@@ -371,23 +475,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 ["supported", "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>;
+export type HooksExtensionCapability = Schema.Schema.Type<typeof HooksExtensionCapabilitySchema>;
 /** @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,114 +508,123 @@ 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 PermissionsExtensionCapabilitySchema: 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 ["supported", "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>;
-}>;
-/** @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. */
-export type AgentCapability = SkillsCapability | CommandsCapability | McpCapability | SubagentsCapability | InstructionsCapability | RulesCapability | HooksCapability | PermissionsCapability;
-/** @experimental This API is unstable and may change without notice. */
-export declare const AgentSchema: Schema.Struct<{
-    readonly id: Schema.NonEmptyString;
-    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 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 skills: Schema.optional<Schema.Struct<{
-        readonly directory: Schema.optional<Schema.NonEmptyString>;
+    }>>;
+    readonly sources: Schema.$Array<Schema.NonEmptyString>;
+}>]>;
+/** @experimental This API is unstable and may change without notice. */
+export type PermissionsExtensionCapability = Schema.Schema.Type<typeof PermissionsExtensionCapabilitySchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const AgentCapabilitiesSchema: Schema.Struct<{
+    skill: 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 ["supported", "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>;
+    }>]>;
+    command: Schema.Union<readonly [Schema.Struct<{
+        readonly directory: Schema.NonEmptyString;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+    }>]>;
+    "mcp-server": 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 +632,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 +641,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 +655,145 @@ 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 ["supported", "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 ["supported", "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>;
+    }>]>;
+    subagent: Schema.Union<readonly [Schema.Struct<{
+        readonly directory: Schema.NonEmptyString;
+        readonly layout: Schema.Literals<readonly ["file", "directory"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+    }>]>;
+    files: Schema.Union<readonly [Schema.Struct<{
+        readonly directory: Schema.NonEmptyString;
+        readonly files: Schema.$Array<Schema.NonEmptyString>;
+        readonly naming: Schema.NullOr<Schema.NonEmptyString>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+    }>]>;
+    rule: 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 directory: Schema.optionalKey<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 ["supported", "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 directory: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+        readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "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 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 ["supported", "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>;
+    }>]>;
+    hook: Schema.Union<readonly [Schema.Struct<{
         readonly configFiles: Schema.$Array<Schema.Struct<{
             readonly scope: Schema.Literals<readonly ["user", "project"]>;
             readonly path: Schema.NonEmptyString;
@@ -600,54 +801,335 @@ 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 ["supported", "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 AgentCapabilities = Schema.Schema.Type<typeof AgentCapabilitiesSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export type AgentExtensionCapability = AgentCapabilities[LeafExtensionType];
+/** @experimental This API is unstable and may change without notice. */
+export declare const AgentSchema: Schema.Struct<{
+    readonly id: Schema.NonEmptyString;
+    readonly name: Schema.NonEmptyString;
+    readonly vendor: Schema.NonEmptyString;
+    readonly homepage: Schema.NonEmptyString;
+    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 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 capabilities: Schema.Struct<{
+        skill: 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 lifecycle: Schema.Literals<readonly ["supported", "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>;
+        }>]>;
+        command: Schema.Union<readonly [Schema.Struct<{
+            readonly directory: Schema.NonEmptyString;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+        }>]>;
+        "mcp-server": 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<{
+                    readonly scope: Schema.Literals<readonly ["user", "project"]>;
+                    readonly path: Schema.NonEmptyString;
+                    readonly format: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
+                }>>;
+                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;
+                            readonly sse: Schema.NonEmptyString;
+                        }>]>;
+                    }>>;
+                    readonly command: Schema.Literals<readonly ["split", "array"]>;
+                    readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+                }>>;
+                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;
+                            readonly sse: Schema.NonEmptyString;
+                        }>]>;
+                    }>>;
+                    readonly urlKey: Schema.Struct<{
+                        readonly "streamable-http": Schema.NonEmptyString;
+                        readonly sse: Schema.NonEmptyString;
+                    }>;
+                    readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
+                }>>;
+                readonly transform: Schema.NullOr<Schema.NonEmptyString>;
+            }>;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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 ["supported", "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>;
+        }>]>;
+        subagent: Schema.Union<readonly [Schema.Struct<{
+            readonly directory: Schema.NonEmptyString;
+            readonly layout: Schema.Literals<readonly ["file", "directory"]>;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+        }>]>;
+        files: Schema.Union<readonly [Schema.Struct<{
+            readonly directory: Schema.NonEmptyString;
+            readonly files: Schema.$Array<Schema.NonEmptyString>;
+            readonly naming: Schema.NullOr<Schema.NonEmptyString>;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+        }>]>;
+        rule: 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 directory: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+            readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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 directory: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+            readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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.NullOr<Schema.Literals<readonly ["at-path"]>>;
+            readonly directory: Schema.NonEmptyString;
+            readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
+            readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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>;
+        }>]>;
+        hook: Schema.Union<readonly [Schema.Struct<{
+            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 serializer: Schema.Literals<readonly ["claude-code-settings"]>;
+            readonly lifecycle: Schema.Literals<readonly ["supported", "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 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 ["supported", "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>;