@agentxm/client-core 0.14.1 → 0.15.1

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

@@ -4,10 +4,8 @@
  * @experimental This API is unstable and may change without notice.
  */
 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>;
+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. */
@@ -21,11 +19,13 @@ 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 ["available", "planned"]>;
+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. */
@@ -45,25 +45,128 @@ 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;
+export declare const DetectionSignalSchema: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+/** @experimental This API is unstable and may change without notice. */
+export type DetectionSignal = Schema.Schema.Type<typeof DetectionSignalSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const DetectionMarkerSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+    readonly note: Schema.NullOr<Schema.NonEmptyString>;
+    readonly kind: Schema.Literal<"dir">;
+    readonly path: Schema.NonEmptyString;
+}>, Schema.Struct<{
+    readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+    readonly note: Schema.NullOr<Schema.NonEmptyString>;
+    readonly kind: Schema.Literal<"file">;
+    readonly path: Schema.NonEmptyString;
+}>, Schema.Struct<{
+    readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+    readonly note: Schema.NullOr<Schema.NonEmptyString>;
+    readonly kind: Schema.Literal<"executable">;
     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>;
+export type DetectionMarker = Schema.Schema.Type<typeof DetectionMarkerSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const DocLinkSchema: Schema.Struct<{
-    readonly label: Schema.NonEmptyString;
-    readonly url: Schema.NonEmptyString;
+export declare const ScopeDetectionSchema: Schema.Struct<{
+    readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+        readonly note: Schema.NullOr<Schema.NonEmptyString>;
+        readonly kind: Schema.Literal<"dir">;
+        readonly path: Schema.NonEmptyString;
+    }>, Schema.Struct<{
+        readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+        readonly note: Schema.NullOr<Schema.NonEmptyString>;
+        readonly kind: Schema.Literal<"file">;
+        readonly path: Schema.NonEmptyString;
+    }>, Schema.Struct<{
+        readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+        readonly note: Schema.NullOr<Schema.NonEmptyString>;
+        readonly kind: Schema.Literal<"executable">;
+        readonly name: Schema.NonEmptyString;
+    }>]>>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
-export type DocLink = Schema.Schema.Type<typeof DocLinkSchema>;
+export type ScopeDetection = Schema.Schema.Type<typeof ScopeDetectionSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const DetectionSchema: Schema.Struct<{
+export declare const DetectionSchema: Schema.decodeTo<Schema.toType<Schema.Struct<{
+    readonly project: Schema.Struct<{
+        readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"dir">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"file">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"executable">;
+            readonly name: Schema.NonEmptyString;
+        }>]>>;
+    }>;
+    readonly user: Schema.Struct<{
+        readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"dir">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"file">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"executable">;
+            readonly name: Schema.NonEmptyString;
+        }>]>>;
+    }>;
+}>>, Schema.Union<readonly [Schema.Struct<{
+    readonly project: Schema.Struct<{
+        readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"dir">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"file">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"executable">;
+            readonly name: Schema.NonEmptyString;
+        }>]>>;
+    }>;
+    readonly user: Schema.Struct<{
+        readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"dir">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"file">;
+            readonly path: Schema.NonEmptyString;
+        }>, Schema.Struct<{
+            readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+            readonly note: Schema.NullOr<Schema.NonEmptyString>;
+            readonly kind: Schema.Literal<"executable">;
+            readonly name: Schema.NonEmptyString;
+        }>]>>;
+    }>;
+}>, Schema.Struct<{
     readonly projectDirs: Schema.$Array<Schema.NonEmptyString>;
     readonly userDirs: Schema.$Array<Schema.NonEmptyString>;
-}>;
+}>]>, never, never>;
 /** @experimental This API is unstable and may change without notice. */
 export type Detection = Schema.Schema.Type<typeof DetectionSchema>;
 /** @experimental This API is unstable and may change without notice. */
@@ -72,7 +175,7 @@ export declare const LastVerifiedDateSchema: Schema.NonEmptyString;
 export type LastVerifiedDate = Schema.Schema.Type<typeof LastVerifiedDateSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const CapabilityBaseSchema: Schema.Union<readonly [Schema.Struct<{
-    lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     notes: Schema.NullOr<Schema.NonEmptyString>;
     docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -94,7 +197,7 @@ export declare const CapabilityBaseSchema: Schema.Union<readonly [Schema.Struct<
 export type CapabilityBase = Schema.Schema.Type<typeof CapabilityBaseSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const ScopedCapabilityBaseSchema: Schema.Struct<{
-    lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     notes: Schema.NullOr<Schema.NonEmptyString>;
     docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -107,11 +210,11 @@ export declare const ScopedCapabilityBaseSchema: Schema.Struct<{
 /** @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.Union<readonly [Schema.Struct<{
+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 lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -130,11 +233,11 @@ export declare const SkillsCapabilitySchema: Schema.Union<readonly [Schema.Struc
     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.Union<readonly [Schema.Struct<{
+export declare const CommandsExtensionCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
     readonly directory: Schema.NonEmptyString;
-    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -153,16 +256,16 @@ export declare const CommandsCapabilitySchema: Schema.Union<readonly [Schema.Str
     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.Union<readonly [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 ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -181,24 +284,25 @@ export declare const SubagentsCapabilitySchema: Schema.Union<readonly [Schema.St
     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.Union<readonly [Schema.Struct<{
+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 ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -212,9 +316,10 @@ export declare const InstructionsCapabilitySchema: Schema.Union<readonly [Schema
     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 ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -228,9 +333,10 @@ export declare const InstructionsCapabilitySchema: Schema.Union<readonly [Schema
     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 ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -249,11 +355,13 @@ export declare const InstructionsCapabilitySchema: Schema.Union<readonly [Schema
     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.Union<readonly [Schema.Struct<{
+export declare const FilesExtensionCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
     readonly directory: Schema.NonEmptyString;
-    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    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;
@@ -272,7 +380,7 @@ export declare const RulesCapabilitySchema: Schema.Union<readonly [Schema.Struct
     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. */
@@ -292,7 +400,7 @@ export type McpConfigTarget = Schema.Schema.Type<typeof McpConfigTargetSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const McpTypeFieldValueMapSchema: Schema.Struct<{
     readonly "streamable-http": Schema.NonEmptyString;
-    readonly sse: Schema.NonEmptyString;
+    readonly sse: Schema.optionalKey<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpTypeFieldValueMap = Schema.Schema.Type<typeof McpTypeFieldValueMapSchema>;
@@ -301,7 +409,7 @@ export declare const McpTypeFieldSchema: 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 sse: Schema.optionalKey<Schema.NonEmptyString>;
     }>]>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
@@ -312,7 +420,7 @@ export declare const McpStdioDialectSchema: 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 sse: Schema.optionalKey<Schema.NonEmptyString>;
         }>]>;
     }>>;
     readonly command: Schema.Literals<readonly ["split", "array"]>;
@@ -323,7 +431,7 @@ export type McpStdioDialect = Schema.Schema.Type<typeof McpStdioDialectSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const McpUrlKeyMapSchema: Schema.Struct<{
     readonly "streamable-http": Schema.NonEmptyString;
-    readonly sse: Schema.NonEmptyString;
+    readonly sse: Schema.optionalKey<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpUrlKeyMap = Schema.Schema.Type<typeof McpUrlKeyMapSchema>;
@@ -333,12 +441,12 @@ export declare const McpRemoteDialectSchema: 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 sse: Schema.optionalKey<Schema.NonEmptyString>;
         }>]>;
     }>>;
     readonly urlKey: Schema.Struct<{
         readonly "streamable-http": Schema.NonEmptyString;
-        readonly sse: Schema.NonEmptyString;
+        readonly sse: Schema.optionalKey<Schema.NonEmptyString>;
     }>;
     readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
 }>;
@@ -358,7 +466,7 @@ export declare const McpConfigSchema: 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 sse: Schema.optionalKey<Schema.NonEmptyString>;
             }>]>;
         }>>;
         readonly command: Schema.Literals<readonly ["split", "array"]>;
@@ -369,12 +477,12 @@ export declare const McpConfigSchema: 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 sse: Schema.optionalKey<Schema.NonEmptyString>;
             }>]>;
         }>>;
         readonly urlKey: Schema.Struct<{
             readonly "streamable-http": Schema.NonEmptyString;
-            readonly sse: Schema.NonEmptyString;
+            readonly sse: Schema.optionalKey<Schema.NonEmptyString>;
         }>;
         readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
     }>>;
@@ -383,11 +491,16 @@ export declare const McpConfigSchema: Schema.Struct<{
 /** @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.Union<readonly [Schema.Struct<{
-    readonly standardsCompliance: Schema.Literal<"full">;
-    readonly convention: Schema.Literals<readonly ["universal", "vendor"]>;
+export declare const McpEnvExpansionSchema: Schema.Struct<{
+    readonly variables: Schema.Literals<readonly ["none", "braced"]>;
+    readonly defaults: Schema.Boolean;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+export type McpEnvExpansion = Schema.Schema.Type<typeof McpEnvExpansionSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const McpExtensionCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
     readonly transports: Schema.NonEmptyArray<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
-    readonly config: Schema.Struct<{
+    readonly config: Schema.optionalKey<Schema.Struct<{
         readonly serversKey: Schema.Literals<readonly ["mcpServers", "servers", "mcp", "mcp_servers", "context_servers"]>;
         readonly nativeEnabled: Schema.Boolean;
         readonly targets: Schema.$Array<Schema.Struct<{
@@ -400,7 +513,7 @@ export declare const McpCapabilitySchema: Schema.Union<readonly [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 sse: Schema.optionalKey<Schema.NonEmptyString>;
                 }>]>;
             }>>;
             readonly command: Schema.Literals<readonly ["split", "array"]>;
@@ -411,31 +524,24 @@ export declare const McpCapabilitySchema: Schema.Union<readonly [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 sse: Schema.optionalKey<Schema.NonEmptyString>;
                 }>]>;
             }>>;
             readonly urlKey: Schema.Struct<{
                 readonly "streamable-http": Schema.NonEmptyString;
-                readonly sse: Schema.NonEmptyString;
+                readonly sse: Schema.optionalKey<Schema.NonEmptyString>;
             }>;
             readonly headersKey: Schema.NullOr<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 mcpEnvExpansion: Schema.optionalKey<Schema.Struct<{
+        readonly variables: Schema.Literals<readonly ["none", "braced"]>;
+        readonly defaults: Schema.Boolean;
+    }>>;
+    readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
     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 lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -454,7 +560,7 @@ export declare const McpCapabilitySchema: Schema.Union<readonly [Schema.Struct<{
     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. */
@@ -477,7 +583,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.Union<readonly [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;
@@ -485,7 +591,7 @@ export declare const HooksCapabilitySchema: Schema.Union<readonly [Schema.Struct
         readonly gitignored: Schema.Boolean;
     }>>;
     readonly serializer: Schema.Literals<readonly ["claude-code-settings"]>;
-    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -504,7 +610,7 @@ export declare const HooksCapabilitySchema: Schema.Union<readonly [Schema.Struct
     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"]>;
@@ -538,7 +644,7 @@ export declare const PermissionGrantSchema: Schema.Struct<{
 /** @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.Union<readonly [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"]>;
@@ -566,7 +672,7 @@ export declare const PermissionsCapabilitySchema: Schema.Union<readonly [Schema.
         readonly patch: Schema.NullOr<Schema.Unknown>;
         readonly template: Schema.NullOr<Schema.NonEmptyString>;
     }>>;
-    readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+    readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
     readonly notes: Schema.NullOr<Schema.NonEmptyString>;
     readonly docs: Schema.$Array<Schema.Struct<{
         readonly label: Schema.NonEmptyString;
@@ -585,31 +691,14 @@ export declare const PermissionsCapabilitySchema: Schema.Union<readonly [Schema.
     readonly sources: Schema.$Array<Schema.NonEmptyString>;
 }>]>;
 /** @experimental This API is unstable and may change without notice. */
-export type PermissionsCapability = Schema.Schema.Type<typeof PermissionsCapabilitySchema>;
+export type PermissionsExtensionCapability = Schema.Schema.Type<typeof PermissionsExtensionCapabilitySchema>;
 /** @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.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.Union<readonly [Schema.Struct<{
+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 lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
         readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
@@ -627,9 +716,9 @@ export declare const AgentSchema: Schema.Struct<{
         }>>;
         readonly sources: Schema.$Array<Schema.NonEmptyString>;
     }>]>;
-    readonly commands: Schema.Union<readonly [Schema.Struct<{
+    command: Schema.Union<readonly [Schema.Struct<{
         readonly directory: Schema.NonEmptyString;
-        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
         readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
@@ -647,11 +736,9 @@ export declare const AgentSchema: Schema.Struct<{
         }>>;
         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"]>;
+    "mcp-server": Schema.Union<readonly [Schema.Struct<{
         readonly transports: Schema.NonEmptyArray<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
-        readonly config: Schema.Struct<{
+        readonly config: Schema.optionalKey<Schema.Struct<{
             readonly serversKey: Schema.Literals<readonly ["mcpServers", "servers", "mcp", "mcp_servers", "context_servers"]>;
             readonly nativeEnabled: Schema.Boolean;
             readonly targets: Schema.$Array<Schema.Struct<{
@@ -664,7 +751,7 @@ export declare const AgentSchema: 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 sse: Schema.optionalKey<Schema.NonEmptyString>;
                     }>]>;
                 }>>;
                 readonly command: Schema.Literals<readonly ["split", "array"]>;
@@ -675,18 +762,24 @@ export declare const AgentSchema: 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 sse: Schema.optionalKey<Schema.NonEmptyString>;
                     }>]>;
                 }>>;
                 readonly urlKey: Schema.Struct<{
                     readonly "streamable-http": Schema.NonEmptyString;
-                    readonly sse: Schema.NonEmptyString;
+                    readonly sse: Schema.optionalKey<Schema.NonEmptyString>;
                 }>;
                 readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
             }>>;
             readonly transform: Schema.NullOr<Schema.NonEmptyString>;
-        }>;
-        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        }>>;
+        readonly mcpEnvExpansion: Schema.optionalKey<Schema.Struct<{
+            readonly variables: Schema.Literals<readonly ["none", "braced"]>;
+            readonly defaults: Schema.Boolean;
+        }>>;
+        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;
@@ -696,10 +789,18 @@ export declare const AgentSchema: Schema.Struct<{
         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 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;
@@ -717,10 +818,11 @@ export declare const AgentSchema: Schema.Struct<{
         }>>;
         readonly sources: Schema.$Array<Schema.NonEmptyString>;
     }>]>;
-    readonly subagents: Schema.Union<readonly [Schema.Struct<{
+    files: Schema.Union<readonly [Schema.Struct<{
         readonly directory: Schema.NonEmptyString;
-        readonly layout: Schema.Literals<readonly ["file", "directory"]>;
-        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        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;
@@ -738,14 +840,15 @@ export declare const AgentSchema: Schema.Struct<{
         }>>;
         readonly sources: Schema.$Array<Schema.NonEmptyString>;
     }>]>;
-    readonly instructions: Schema.Union<readonly [Schema.Struct<{
+    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 ["available", "planned"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
         readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
@@ -759,9 +862,10 @@ export declare const AgentSchema: Schema.Struct<{
         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 ["available", "planned"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
         readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
@@ -775,9 +879,10 @@ export declare const AgentSchema: Schema.Struct<{
         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 ["available", "planned"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
         readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
@@ -795,27 +900,7 @@ export declare const AgentSchema: 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<{
+    hook: Schema.Union<readonly [Schema.Struct<{
         readonly configFiles: Schema.$Array<Schema.Struct<{
             readonly scope: Schema.Literals<readonly ["user", "project"]>;
             readonly path: Schema.NonEmptyString;
@@ -823,7 +908,7 @@ export declare const AgentSchema: Schema.Struct<{
             readonly gitignored: Schema.Boolean;
         }>>;
         readonly serializer: Schema.Literals<readonly ["claude-code-settings"]>;
-        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
         readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;
@@ -841,6 +926,336 @@ export declare const AgentSchema: Schema.Struct<{
         }>>;
         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.decodeTo<Schema.toType<Schema.Struct<{
+        readonly project: Schema.Struct<{
+            readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"dir">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"file">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"executable">;
+                readonly name: Schema.NonEmptyString;
+            }>]>>;
+        }>;
+        readonly user: Schema.Struct<{
+            readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"dir">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"file">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"executable">;
+                readonly name: Schema.NonEmptyString;
+            }>]>>;
+        }>;
+    }>>, Schema.Union<readonly [Schema.Struct<{
+        readonly project: Schema.Struct<{
+            readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"dir">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"file">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"executable">;
+                readonly name: Schema.NonEmptyString;
+            }>]>>;
+        }>;
+        readonly user: Schema.Struct<{
+            readonly markers: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"dir">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"file">;
+                readonly path: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly signal: Schema.Literals<readonly ["definitive", "supporting", "ambiguous"]>;
+                readonly note: Schema.NullOr<Schema.NonEmptyString>;
+                readonly kind: Schema.Literal<"executable">;
+                readonly name: Schema.NonEmptyString;
+            }>]>>;
+        }>;
+    }>, Schema.Struct<{
+        readonly projectDirs: Schema.$Array<Schema.NonEmptyString>;
+        readonly userDirs: Schema.$Array<Schema.NonEmptyString>;
+    }>]>, never, never>;
+    readonly docs: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.NonEmptyString;
+        readonly url: Schema.NonEmptyString;
+    }>>;
+    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 transports: Schema.NonEmptyArray<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
+            readonly config: Schema.optionalKey<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.optionalKey<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.optionalKey<Schema.NonEmptyString>;
+                        }>]>;
+                    }>>;
+                    readonly urlKey: Schema.Struct<{
+                        readonly "streamable-http": Schema.NonEmptyString;
+                        readonly sse: Schema.optionalKey<Schema.NonEmptyString>;
+                    }>;
+                    readonly headersKey: Schema.NullOr<Schema.NonEmptyString>;
+                }>>;
+                readonly transform: Schema.NullOr<Schema.NonEmptyString>;
+            }>>;
+            readonly mcpEnvExpansion: Schema.optionalKey<Schema.Struct<{
+                readonly variables: Schema.Literals<readonly ["none", "braced"]>;
+                readonly defaults: Schema.Boolean;
+            }>>;
+            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>;
+        }>]>;
+        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<{
@@ -869,7 +1284,7 @@ export declare const AgentSchema: Schema.Struct<{
             readonly patch: Schema.NullOr<Schema.Unknown>;
             readonly template: Schema.NullOr<Schema.NonEmptyString>;
         }>>;
-        readonly lifecycle: Schema.Literals<readonly ["available", "planned"]>;
+        readonly lifecycle: Schema.Literals<readonly ["supported", "planned"]>;
         readonly notes: Schema.NullOr<Schema.NonEmptyString>;
         readonly docs: Schema.$Array<Schema.Struct<{
             readonly label: Schema.NonEmptyString;