@agentxm/client-core 0.11.2 → 0.11.3

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

@@ -101,21 +101,6 @@ export declare const CommandsCapabilitySchema: Schema.Struct<{
 /** @experimental This API is unstable and may change without notice. */
 export type CommandsCapability = Schema.Schema.Type<typeof CommandsCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const McpCapabilitySchema: Schema.Struct<{
-    readonly transports: Schema.$Array<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
-    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
-    readonly support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
-    readonly notes: Schema.optional<Schema.NonEmptyString>;
-    readonly docs: Schema.optional<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 McpCapability = Schema.Schema.Type<typeof McpCapabilitySchema>;
-/** @experimental This API is unstable and may change without notice. */
 export declare const SubagentsCapabilitySchema: Schema.Struct<{
     scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
     support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
@@ -132,7 +117,7 @@ export type SubagentsCapability = Schema.Schema.Type<typeof SubagentsCapabilityS
 /** @experimental This API is unstable and may change without notice. */
 export declare const InstructionsCapabilitySchema: Schema.Struct<{
     readonly files: Schema.$Array<Schema.NonEmptyString>;
-    readonly nestedDiscovery: Schema.optional<Schema.Boolean>;
+    readonly nestedDiscovery: Schema.Boolean;
     readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
     readonly support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
     readonly notes: Schema.optional<Schema.NonEmptyString>;
@@ -161,7 +146,256 @@ export declare const RulesCapabilitySchema: Schema.Struct<{
 /** @experimental This API is unstable and may change without notice. */
 export type RulesCapability = Schema.Schema.Type<typeof RulesCapabilitySchema>;
 /** @experimental This API is unstable and may change without notice. */
-export type AgentCapability = SkillsCapability | CommandsCapability | McpCapability | SubagentsCapability | InstructionsCapability | RulesCapability;
+export declare const ConfigFileFormatSchema: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
+/** @experimental This API is unstable and may change without notice. */
+export type ConfigFileFormat = Schema.Schema.Type<typeof ConfigFileFormatSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const McpServersKeySchema: Schema.Literals<readonly ["mcpServers", "servers", "mcp", "mcp_servers", "context_servers"]>;
+/** @experimental This API is unstable and may change without notice. */
+export type McpServersKey = Schema.Schema.Type<typeof McpServersKeySchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const McpConfigTargetSchema: Schema.Struct<{
+    readonly scope: Schema.Literals<readonly ["user", "project"]>;
+    readonly path: Schema.NonEmptyString;
+    readonly format: Schema.Literals<readonly ["json", "jsonc", "toml", "starlark", "vscode-settings"]>;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+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;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+export type McpTypeFieldValueMap = Schema.Schema.Type<typeof McpTypeFieldValueMapSchema>;
+/** @experimental This API is unstable and may change without notice. */
+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;
+    }>]>;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+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 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.optional<Schema.NonEmptyString>;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+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;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+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 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.optional<Schema.NonEmptyString>;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+export type McpRemoteDialect = Schema.Schema.Type<typeof McpRemoteDialectSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const McpConfigSchema: 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.optional<Schema.Struct<{
+        readonly typeField: Schema.optional<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.optional<Schema.NonEmptyString>;
+    }>>;
+    readonly remote: Schema.optional<Schema.Struct<{
+        readonly typeField: Schema.optional<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.optional<Schema.NonEmptyString>;
+    }>>;
+    readonly transform: Schema.optional<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<{
+        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.optional<Schema.Struct<{
+            readonly typeField: Schema.optional<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.optional<Schema.NonEmptyString>;
+        }>>;
+        readonly remote: Schema.optional<Schema.Struct<{
+            readonly typeField: Schema.optional<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.optional<Schema.NonEmptyString>;
+        }>>;
+        readonly transform: Schema.optional<Schema.NonEmptyString>;
+    }>>;
+    readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
+    readonly support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
+    readonly notes: Schema.optional<Schema.NonEmptyString>;
+    readonly docs: Schema.optional<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 McpCapability = Schema.Schema.Type<typeof McpCapabilitySchema>;
+/** @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. */
+export type PermissionMechanism = Schema.Schema.Type<typeof PermissionMechanismSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const PermissionGrammarStyleSchema: Schema.Literals<readonly ["tool-call", "prefix", "regex", "glob", "starlark-rule"]>;
+/** @experimental This API is unstable and may change without notice. */
+export type PermissionGrammarStyle = Schema.Schema.Type<typeof PermissionGrammarStyleSchema>;
+/** @experimental This API is unstable and may change without notice. */
+export declare const ConfigFileLocationSchema: 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;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+export type ConfigFileLocation = Schema.Schema.Type<typeof ConfigFileLocationSchema>;
+/** @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>;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+export type PermissionGrammar = Schema.Schema.Type<typeof PermissionGrammarSchema>;
+/** @experimental This API is unstable and may change without notice. */
+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>;
+}>;
+/** @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>;
+}>;
+/** @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>;
+}>;
+/** @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<{
+        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 style: Schema.Literals<readonly ["tool-call", "prefix", "regex", "glob", "starlark-rule"]>;
+        readonly example: Schema.NonEmptyString;
+        readonly notes: Schema.optional<Schema.NonEmptyString>;
+    }>>;
+    readonly prerequisites: Schema.optional<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 flag: Schema.NonEmptyString;
+        readonly note: Schema.optional<Schema.NonEmptyString>;
+    }>>>;
+    readonly grants: Schema.optional<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 support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
+    readonly notes: Schema.optional<Schema.NonEmptyString>;
+    readonly docs: Schema.optional<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 | PermissionsCapability;
 /** @experimental This API is unstable and may change without notice. */
 export declare const AgentSchema: Schema.Struct<{
     readonly id: Schema.NonEmptyString;
@@ -200,6 +434,41 @@ export declare const AgentSchema: Schema.Struct<{
     }>>;
     readonly mcp: Schema.optional<Schema.Struct<{
         readonly transports: Schema.$Array<Schema.Literals<readonly ["stdio", "http", "sse"]>>;
+        readonly config: Schema.optional<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.optional<Schema.Struct<{
+                readonly typeField: Schema.optional<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.optional<Schema.NonEmptyString>;
+            }>>;
+            readonly remote: Schema.optional<Schema.Struct<{
+                readonly typeField: Schema.optional<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.optional<Schema.NonEmptyString>;
+            }>>;
+            readonly transform: Schema.optional<Schema.NonEmptyString>;
+        }>>;
         readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
         readonly support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
         readonly notes: Schema.optional<Schema.NonEmptyString>;
@@ -223,7 +492,7 @@ export declare const AgentSchema: Schema.Struct<{
     }>>;
     readonly instructions: Schema.optional<Schema.Struct<{
         readonly files: Schema.$Array<Schema.NonEmptyString>;
-        readonly nestedDiscovery: Schema.optional<Schema.Boolean>;
+        readonly nestedDiscovery: Schema.Boolean;
         readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
         readonly support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
         readonly notes: Schema.optional<Schema.NonEmptyString>;
@@ -246,6 +515,44 @@ export declare const AgentSchema: Schema.Struct<{
         readonly sources: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
         readonly lastVerified: Schema.optional<Schema.NonEmptyString>;
     }>>;
+    readonly permissions: Schema.optional<Schema.Struct<{
+        readonly mechanism: Schema.$Array<Schema.Literals<readonly ["config-file", "cli-flag", "ui-only"]>>;
+        readonly configFiles: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly 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 style: Schema.Literals<readonly ["tool-call", "prefix", "regex", "glob", "starlark-rule"]>;
+            readonly example: Schema.NonEmptyString;
+            readonly notes: Schema.optional<Schema.NonEmptyString>;
+        }>>;
+        readonly prerequisites: Schema.optional<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 flag: Schema.NonEmptyString;
+            readonly note: Schema.optional<Schema.NonEmptyString>;
+        }>>>;
+        readonly grants: Schema.optional<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 support: Schema.Literals<readonly ["standard", "bridged", "planned", "unsupported", "unknown"]>;
+        readonly notes: Schema.optional<Schema.NonEmptyString>;
+        readonly docs: Schema.optional<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 Agent = Schema.Schema.Type<typeof AgentSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/unstable/agent-capabilities/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/unstable/agent-capabilities/schema.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/agent-capabilities/schema.js

@@ -26,7 +26,14 @@ export const SupportLevelSchema = Schema.Literals([
 ]).annotate({
     identifier: "SupportLevel",
     title: "Support Level",
-    description: "How an agent supports a capability.",
+    description: "How an agent supports a capability. `standard`: the agent natively conforms to " +
+        "an industry spec standard for the capability (e.g. the Agent Skills `SKILL.md` " +
+        "format). `bridged`: the capability works through an AXM adapter that maps it to " +
+        "the agent's native format — this is the ceiling for capabilities that have no " +
+        "industry spec standard yet, such as subagents and commands. `planned`: AXM " +
+        "support is intended but not yet available. `unsupported`: an authoritative " +
+        "source confirms the agent lacks the capability. `unknown`: support has not been " +
+        "verified, normally expressed by omitting the capability section entirely.",
     examples: ["standard", "bridged", "unknown"],
 });
 /** @experimental This API is unstable and may change without notice. */
@@ -120,15 +127,6 @@ export const CommandsCapabilitySchema = Schema.Struct({
     description: "Agent support for command extensions.",
 });
 /** @experimental This API is unstable and may change without notice. */
-export const McpCapabilitySchema = Schema.Struct({
-    ...ScopedCapabilityBaseFields,
-    transports: Schema.Array(McpTransportSchema).pipe(Schema.annotateKey({ messageMissingKey: "MCP transports are required" }), Schema.check(Schema.isUnique())),
-}).annotate({
-    identifier: "McpCapability",
-    title: "MCP Capability",
-    description: "Agent support for MCP server extensions.",
-});
-/** @experimental This API is unstable and may change without notice. */
 export const SubagentsCapabilitySchema = Schema.Struct(ScopedCapabilityBaseFields).annotate({
     identifier: "SubagentsCapability",
     title: "Subagents Capability",
@@ -138,7 +136,7 @@ export const SubagentsCapabilitySchema = Schema.Struct(ScopedCapabilityBaseField
 export const InstructionsCapabilitySchema = Schema.Struct({
     ...ScopedCapabilityBaseFields,
     files: Schema.Array(Schema.NonEmptyString).pipe(Schema.annotateKey({ messageMissingKey: "instruction files are required" }), Schema.check(Schema.isUnique())),
-    nestedDiscovery: Schema.optional(Schema.Boolean),
+    nestedDiscovery: Schema.Boolean.pipe(Schema.annotateKey({ messageMissingKey: "nestedDiscovery is required" })),
 }).annotate({
     identifier: "InstructionsCapability",
     title: "Instructions Capability",
@@ -154,6 +152,201 @@ export const RulesCapabilitySchema = Schema.Struct({
     description: "Agent support for structured rule files.",
 });
 /** @experimental This API is unstable and may change without notice. */
+export const ConfigFileFormatSchema = Schema.Literals([
+    "json",
+    "jsonc",
+    "toml",
+    "starlark",
+    "vscode-settings",
+]).annotate({
+    identifier: "ConfigFileFormat",
+    title: "Config File Format",
+    description: "Serialization format used by an agent's permission config file.",
+    examples: ["json", "toml", "vscode-settings"],
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpServersKeySchema = Schema.Literals([
+    "mcpServers",
+    "servers",
+    "mcp",
+    "mcp_servers",
+    "context_servers",
+]).annotate({
+    identifier: "McpServersKey",
+    title: "MCP Servers Key",
+    description: "Top-level key containing MCP server entries in an agent config file.",
+    examples: ["mcpServers", "servers", "mcp"],
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpConfigTargetSchema = Schema.Struct({
+    scope: ScopeSchema,
+    path: Schema.NonEmptyString,
+    format: ConfigFileFormatSchema,
+}).annotate({
+    identifier: "McpConfigTarget",
+    title: "MCP Config Target",
+    description: "A config file target where MCP server entries can be written.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpTypeFieldValueMapSchema = Schema.Struct({
+    "streamable-http": Schema.NonEmptyString,
+    sse: Schema.NonEmptyString,
+}).annotate({
+    identifier: "McpTypeFieldValueMap",
+    title: "MCP Type Field Value Map",
+    description: "Agent discriminator values by upstream remote transport.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpTypeFieldSchema = Schema.Struct({
+    name: Schema.NonEmptyString,
+    value: Schema.Union([Schema.NonEmptyString, McpTypeFieldValueMapSchema]),
+}).annotate({
+    identifier: "McpTypeField",
+    title: "MCP Type Field",
+    description: "Optional per-entry transport discriminator field.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpStdioDialectSchema = Schema.Struct({
+    typeField: Schema.optional(McpTypeFieldSchema),
+    command: Schema.Literals(["split", "array"]),
+    envKey: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "McpStdioDialect",
+    title: "MCP Stdio Dialect",
+    description: "How an agent represents local stdio MCP server entries.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpUrlKeyMapSchema = Schema.Struct({
+    "streamable-http": Schema.NonEmptyString,
+    sse: Schema.NonEmptyString,
+}).annotate({
+    identifier: "McpUrlKeyMap",
+    title: "MCP URL Key Map",
+    description: "Agent URL field names by upstream remote transport.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpRemoteDialectSchema = Schema.Struct({
+    typeField: Schema.optional(McpTypeFieldSchema),
+    urlKey: McpUrlKeyMapSchema,
+    headersKey: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "McpRemoteDialect",
+    title: "MCP Remote Dialect",
+    description: "How an agent represents remote MCP server entries.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpConfigSchema = Schema.Struct({
+    serversKey: McpServersKeySchema,
+    nativeEnabled: Schema.Boolean,
+    targets: Schema.Array(McpConfigTargetSchema).pipe(Schema.annotateKey({ messageMissingKey: "MCP config targets are required" })),
+    stdio: Schema.optional(McpStdioDialectSchema),
+    remote: Schema.optional(McpRemoteDialectSchema),
+    transform: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "McpConfig",
+    title: "MCP Config",
+    description: "Prescriptive config writer metadata for an agent's MCP support.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const McpCapabilitySchema = Schema.Struct({
+    ...ScopedCapabilityBaseFields,
+    transports: Schema.Array(McpTransportSchema).pipe(Schema.annotateKey({ messageMissingKey: "MCP transports are required" }), Schema.check(Schema.isUnique())),
+    config: Schema.optional(McpConfigSchema),
+}).annotate({
+    identifier: "McpCapability",
+    title: "MCP Capability",
+    description: "Agent support for MCP server extensions.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const PermissionMechanismSchema = Schema.Literals([
+    "config-file",
+    "cli-flag",
+    "ui-only",
+]).annotate({
+    identifier: "PermissionMechanism",
+    title: "Permission Mechanism",
+    description: "How an agent exposes permission configuration.",
+    examples: ["config-file", "cli-flag", "ui-only"],
+});
+/** @experimental This API is unstable and may change without notice. */
+export const PermissionGrammarStyleSchema = Schema.Literals([
+    "tool-call",
+    "prefix",
+    "regex",
+    "glob",
+    "starlark-rule",
+]).annotate({
+    identifier: "PermissionGrammarStyle",
+    title: "Permission Grammar Style",
+    description: "Syntax shape used to express a permission rule.",
+    examples: ["tool-call", "prefix", "regex"],
+});
+/** @experimental This API is unstable and may change without notice. */
+export const ConfigFileLocationSchema = Schema.Struct({
+    scope: ScopeSchema,
+    path: Schema.NonEmptyString,
+    format: ConfigFileFormatSchema,
+    gitignored: Schema.Boolean.pipe(Schema.annotateKey({ messageMissingKey: "gitignored is required" })),
+}).annotate({
+    identifier: "ConfigFileLocation",
+    title: "Config File Location",
+    description: "A configuration file where an agent's permission rules can live.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const PermissionGrammarSchema = Schema.Struct({
+    style: PermissionGrammarStyleSchema,
+    example: Schema.NonEmptyString,
+    notes: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "PermissionGrammar",
+    title: "Permission Grammar",
+    description: "Rule syntax used by an agent's permission system.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const PermissionPrerequisiteSchema = Schema.Struct({
+    key: Schema.NonEmptyString,
+    value: Schema.NonEmptyString,
+    scope: ScopeSchema,
+    note: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "PermissionPrerequisite",
+    title: "Permission Prerequisite",
+    description: "Mode or gate that must be set before allow rules take effect.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const PermissionCliFlagSchema = Schema.Struct({
+    flag: Schema.NonEmptyString,
+    note: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "PermissionCliFlag",
+    title: "Permission CLI Flag",
+    description: "Invocation-time flag that adjusts approval or sandbox behavior.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const PermissionGrantSchema = Schema.Struct({
+    target: Schema.NonEmptyString,
+    patch: Schema.optional(Schema.Unknown),
+    template: Schema.optional(Schema.NonEmptyString),
+}).annotate({
+    identifier: "PermissionGrant",
+    title: "Permission Grant",
+    description: "Instruction to grant access for a named tool. Provide patch (JSON-ish merge) or template (raw text). Path and patch may interpolate ${tool} and ${workspaceRoot}.",
+});
+/** @experimental This API is unstable and may change without notice. */
+export const PermissionsCapabilitySchema = Schema.Struct({
+    ...ScopedCapabilityBaseFields,
+    mechanism: Schema.Array(PermissionMechanismSchema).pipe(Schema.annotateKey({ messageMissingKey: "permission mechanisms are required" }), Schema.check(Schema.isUnique())),
+    configFiles: Schema.optional(Schema.Array(ConfigFileLocationSchema)),
+    grammar: Schema.optional(PermissionGrammarSchema),
+    prerequisites: Schema.optional(Schema.Array(PermissionPrerequisiteSchema)),
+    cliFlags: Schema.optional(Schema.Array(PermissionCliFlagSchema)),
+    grants: Schema.optional(Schema.Record(Schema.String, PermissionGrantSchema)),
+}).annotate({
+    identifier: "PermissionsCapability",
+    title: "Permissions Capability",
+    description: "How an agent grants tool execution and filesystem access without per-call prompts.",
+});
+/** @experimental This API is unstable and may change without notice. */
 export const AgentSchema = Schema.Struct({
     id: AgentIdFromYamlSchema.pipe(Schema.annotateKey({ messageMissingKey: "agent id is required" })),
     name: Schema.NonEmptyString.pipe(Schema.annotateKey({ messageMissingKey: "agent name is required" })),
@@ -168,6 +361,7 @@ export const AgentSchema = Schema.Struct({
     subagents: Schema.optional(SubagentsCapabilitySchema),
     instructions: Schema.optional(InstructionsCapabilitySchema),
     rules: Schema.optional(RulesCapabilitySchema),
+    permissions: Schema.optional(PermissionsCapabilitySchema),
 }).annotate({
     identifier: "Agent",
     title: "Agent",