agentbnb 5.1.11 → 7.0.0-beta.1

package/dist/index.d.ts

@@ -116,6 +116,8 @@ declare const CapabilityCardSchema: z.ZodObject<{
     }>>;
     created_at: z.ZodOptional<z.ZodString>;
     updated_at: z.ZodOptional<z.ZodString>;
+    /** Exact-match capability type key for network routing (e.g. 'task_decomposition'). Optional — backward-compatible. */
+    capability_type: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     description: string;
@@ -161,6 +163,7 @@ declare const CapabilityCardSchema: z.ZodObject<{
     } | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    capability_type?: string | undefined;
 }, {
     name: string;
     description: string;
@@ -206,6 +209,7 @@ declare const CapabilityCardSchema: z.ZodObject<{
     } | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    capability_type?: string | undefined;
 }>;
 type CapabilityCard = z.infer<typeof CapabilityCardSchema>;
 /**
@@ -231,6 +235,25 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         level: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
         /** Optional grouping category, e.g. 'tts' | 'video_gen' | 'code_review'. */
         category: z.ZodOptional<z.ZodString>;
+        /** Exact-match capability type key for network routing (e.g. 'task_decomposition'). Optional — per-skill routing hint. */
+        capability_type: z.ZodOptional<z.ZodString>;
+        /**
+         * Multi-value capability routing tags — what this skill IS / offers to the outside.
+         * Used by Conductor for precise skill-level matching.
+         * Example: ["audio_generation", "audio_editing", "content_production"]
+         */
+        capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Capabilities this skill internally depends on when executing.
+         * Used by Conductor for decomposition planning and cost estimation.
+         * Example: ["tts", "sound_effects", "audio_mixing"]
+         */
+        requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Publishing visibility. 'private' skills are excluded from published CapabilityCards.
+         * Defaults to 'public' when omitted.
+         */
+        visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
         inputs: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<["text", "json", "file", "audio", "image", "video", "stream"]>;
@@ -379,7 +402,11 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
                 calls_per_hour: number;
             } | undefined;
         } | undefined;
+        capability_type?: string | undefined;
         category?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
     }, {
         name: string;
         description: string;
@@ -422,7 +449,11 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
                 calls_per_hour?: number | undefined;
             } | undefined;
         } | undefined;
+        capability_type?: string | undefined;
         category?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
     }>, "many">;
     availability: z.ZodObject<{
         online: z.ZodBoolean;
@@ -543,6 +574,8 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
     _internal: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     /** Public gateway URL where this agent accepts requests. Populated on remote publish. */
     gateway_url: z.ZodOptional<z.ZodString>;
+    /** Exact-match capability type key for network routing (e.g. 'task_decomposition'). Optional — backward-compatible. */
+    capability_type: z.ZodOptional<z.ZodString>;
     created_at: z.ZodOptional<z.ZodString>;
     updated_at: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -596,12 +629,17 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
                 calls_per_hour: number;
             } | undefined;
         } | undefined;
+        capability_type?: string | undefined;
         category?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
     }[];
     _internal?: Record<string, unknown> | undefined;
     gateway_url?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    capability_type?: string | undefined;
     short_description?: string | undefined;
     environment?: {
         runtime: string;
@@ -680,12 +718,17 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
                 calls_per_hour?: number | undefined;
             } | undefined;
         } | undefined;
+        capability_type?: string | undefined;
         category?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
     }[];
     _internal?: Record<string, unknown> | undefined;
     gateway_url?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    capability_type?: string | undefined;
     short_description?: string | undefined;
     environment?: {
         runtime: string;
@@ -819,6 +862,10 @@ declare function getBalance(db: Database.Database, owner: string): number;
  * Wraps a REST API call with input/output mapping.
  */
 declare const ApiSkillConfigSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"api">;
     name: z.ZodString;
@@ -876,6 +923,13 @@ declare const ApiSkillConfigSchema: z.ZodObject<{
     timeout_ms: z.ZodDefault<z.ZodNumber>;
     retries: z.ZodDefault<z.ZodNumber>;
     provider: z.ZodOptional<z.ZodString>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "api";
@@ -891,7 +945,14 @@ declare const ApiSkillConfigSchema: z.ZodObject<{
     output_mapping: Record<string, string>;
     timeout_ms: number;
     retries: number;
+    description?: string | undefined;
     provider?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     auth?: {
         type: "bearer";
         token: string;
@@ -915,7 +976,14 @@ declare const ApiSkillConfigSchema: z.ZodObject<{
     };
     endpoint: string;
     method: "GET" | "POST" | "PUT" | "DELETE";
+    description?: string | undefined;
     provider?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     auth?: {
         type: "bearer";
         token: string;
@@ -938,6 +1006,10 @@ declare const ApiSkillConfigSchema: z.ZodObject<{
  * Chains multiple skills or commands sequentially.
  */
 declare const PipelineSkillConfigSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"pipeline">;
     name: z.ZodString;
@@ -974,6 +1046,13 @@ declare const PipelineSkillConfigSchema: z.ZodObject<{
         free_tier?: number | undefined;
     }>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "pipeline";
@@ -990,6 +1069,13 @@ declare const PipelineSkillConfigSchema: z.ZodObject<{
         input_mapping: Record<string, string>;
         command: string;
     })[];
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }, {
     name: string;
@@ -1007,6 +1093,13 @@ declare const PipelineSkillConfigSchema: z.ZodObject<{
         command: string;
         input_mapping?: Record<string, string> | undefined;
     })[];
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }>;
 /**
@@ -1014,6 +1107,10 @@ declare const PipelineSkillConfigSchema: z.ZodObject<{
  * Forwards execution to a local OpenClaw agent.
  */
 declare const OpenClawSkillConfigSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"openclaw">;
     name: z.ZodString;
@@ -1033,6 +1130,13 @@ declare const OpenClawSkillConfigSchema: z.ZodObject<{
         free_tier?: number | undefined;
     }>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "openclaw";
@@ -1044,6 +1148,13 @@ declare const OpenClawSkillConfigSchema: z.ZodObject<{
     };
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }, {
     name: string;
@@ -1056,6 +1167,13 @@ declare const OpenClawSkillConfigSchema: z.ZodObject<{
     };
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }>;
 /**
@@ -1063,6 +1181,10 @@ declare const OpenClawSkillConfigSchema: z.ZodObject<{
  * Runs local shell commands with parameter substitution.
  */
 declare const CommandSkillConfigSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"command">;
     name: z.ZodString;
@@ -1070,6 +1192,22 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     output_type: z.ZodEnum<["json", "text", "file"]>;
     allowed_commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     working_dir: z.ZodOptional<z.ZodString>;
+    claude_code: z.ZodOptional<z.ZodObject<{
+        /** Optional system prompt passed via `-p` flag. */
+        system_prompt: z.ZodOptional<z.ZodString>;
+        /** Model to use (e.g. 'claude-opus-4-6', 'claude-sonnet-4-6'). */
+        model: z.ZodOptional<z.ZodString>;
+        /** When true, passes `--dangerously-skip-permissions` to claude CLI. */
+        auto_mode: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        auto_mode: boolean;
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+    }, {
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+        auto_mode?: boolean | undefined;
+    }>>;
     timeout_ms: z.ZodDefault<z.ZodNumber>;
     pricing: z.ZodObject<{
         credits_per_call: z.ZodNumber;
@@ -1084,6 +1222,13 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
         credits_per_minute?: number | undefined;
         free_tier?: number | undefined;
     }>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "command";
@@ -1096,8 +1241,20 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     timeout_ms: number;
     command: string;
     output_type: "text" | "json" | "file";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     allowed_commands?: string[] | undefined;
     working_dir?: string | undefined;
+    claude_code?: {
+        auto_mode: boolean;
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+    } | undefined;
 }, {
     name: string;
     type: "command";
@@ -1109,15 +1266,31 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     };
     command: string;
     output_type: "text" | "json" | "file";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
     allowed_commands?: string[] | undefined;
     working_dir?: string | undefined;
+    claude_code?: {
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+        auto_mode?: boolean | undefined;
+    } | undefined;
 }>;
 /**
  * Schema for conductor orchestration skills (Mode E).
  * Routes execution to the ConductorMode for task decomposition and multi-agent orchestration.
  */
 declare const ConductorSkillConfigSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"conductor">;
     name: z.ZodString;
@@ -1136,6 +1309,13 @@ declare const ConductorSkillConfigSchema: z.ZodObject<{
         free_tier?: number | undefined;
     }>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "conductor";
@@ -1146,6 +1326,13 @@ declare const ConductorSkillConfigSchema: z.ZodObject<{
         free_tier?: number | undefined;
     };
     conductor_skill: "orchestrate" | "plan";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }, {
     name: string;
@@ -1157,6 +1344,13 @@ declare const ConductorSkillConfigSchema: z.ZodObject<{
         free_tier?: number | undefined;
     };
     conductor_skill: "orchestrate" | "plan";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }>;
 /**
@@ -1164,6 +1358,10 @@ declare const ConductorSkillConfigSchema: z.ZodObject<{
  * Used by SkillExecutor to dispatch to the correct executor mode.
  */
 declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"api">;
     name: z.ZodString;
@@ -1221,6 +1419,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     timeout_ms: z.ZodDefault<z.ZodNumber>;
     retries: z.ZodDefault<z.ZodNumber>;
     provider: z.ZodOptional<z.ZodString>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "api";
@@ -1236,7 +1441,14 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     output_mapping: Record<string, string>;
     timeout_ms: number;
     retries: number;
+    description?: string | undefined;
     provider?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     auth?: {
         type: "bearer";
         token: string;
@@ -1260,7 +1472,14 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     };
     endpoint: string;
     method: "GET" | "POST" | "PUT" | "DELETE";
+    description?: string | undefined;
     provider?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     auth?: {
         type: "bearer";
         token: string;
@@ -1278,6 +1497,10 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     timeout_ms?: number | undefined;
     retries?: number | undefined;
 }>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"pipeline">;
     name: z.ZodString;
@@ -1314,6 +1537,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         free_tier?: number | undefined;
     }>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "pipeline";
@@ -1330,6 +1560,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         input_mapping: Record<string, string>;
         command: string;
     })[];
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }, {
     name: string;
@@ -1347,8 +1584,19 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         command: string;
         input_mapping?: Record<string, string> | undefined;
     })[];
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"openclaw">;
     name: z.ZodString;
@@ -1368,6 +1616,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         free_tier?: number | undefined;
     }>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "openclaw";
@@ -1379,6 +1634,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     };
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }, {
     name: string;
@@ -1391,8 +1653,19 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     };
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"command">;
     name: z.ZodString;
@@ -1400,6 +1673,22 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     output_type: z.ZodEnum<["json", "text", "file"]>;
     allowed_commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     working_dir: z.ZodOptional<z.ZodString>;
+    claude_code: z.ZodOptional<z.ZodObject<{
+        /** Optional system prompt passed via `-p` flag. */
+        system_prompt: z.ZodOptional<z.ZodString>;
+        /** Model to use (e.g. 'claude-opus-4-6', 'claude-sonnet-4-6'). */
+        model: z.ZodOptional<z.ZodString>;
+        /** When true, passes `--dangerously-skip-permissions` to claude CLI. */
+        auto_mode: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        auto_mode: boolean;
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+    }, {
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+        auto_mode?: boolean | undefined;
+    }>>;
     timeout_ms: z.ZodDefault<z.ZodNumber>;
     pricing: z.ZodObject<{
         credits_per_call: z.ZodNumber;
@@ -1414,6 +1703,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         credits_per_minute?: number | undefined;
         free_tier?: number | undefined;
     }>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "command";
@@ -1426,8 +1722,20 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     timeout_ms: number;
     command: string;
     output_type: "text" | "json" | "file";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     allowed_commands?: string[] | undefined;
     working_dir?: string | undefined;
+    claude_code?: {
+        auto_mode: boolean;
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+    } | undefined;
 }, {
     name: string;
     type: "command";
@@ -1439,10 +1747,26 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     };
     command: string;
     output_type: "text" | "json" | "file";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
     allowed_commands?: string[] | undefined;
     working_dir?: string | undefined;
+    claude_code?: {
+        model?: string | undefined;
+        system_prompt?: string | undefined;
+        auto_mode?: boolean | undefined;
+    } | undefined;
 }>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
     id: z.ZodString;
     type: z.ZodLiteral<"conductor">;
     name: z.ZodString;
@@ -1461,6 +1785,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         free_tier?: number | undefined;
     }>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent?: number | undefined;
+    }, {
+        max_concurrent?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "conductor";
@@ -1471,6 +1802,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         free_tier?: number | undefined;
     };
     conductor_skill: "orchestrate" | "plan";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }, {
     name: string;
@@ -1482,6 +1820,13 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         free_tier?: number | undefined;
     };
     conductor_skill: "orchestrate" | "plan";
+    description?: string | undefined;
+    capability_types?: string[] | undefined;
+    requires_capabilities?: string[] | undefined;
+    visibility?: "public" | "private" | undefined;
+    capacity?: {
+        max_concurrent?: number | undefined;
+    } | undefined;
     timeout_ms?: number | undefined;
 }>]>;
 /**
@@ -1490,6 +1835,10 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
  */
 declare const SkillsFileSchema: z.ZodObject<{
     skills: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
         id: z.ZodString;
         type: z.ZodLiteral<"api">;
         name: z.ZodString;
@@ -1547,6 +1896,13 @@ declare const SkillsFileSchema: z.ZodObject<{
         timeout_ms: z.ZodDefault<z.ZodNumber>;
         retries: z.ZodDefault<z.ZodNumber>;
         provider: z.ZodOptional<z.ZodString>;
+        capacity: z.ZodOptional<z.ZodObject<{
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_concurrent?: number | undefined;
+        }, {
+            max_concurrent?: number | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         type: "api";
@@ -1562,7 +1918,14 @@ declare const SkillsFileSchema: z.ZodObject<{
         output_mapping: Record<string, string>;
         timeout_ms: number;
         retries: number;
+        description?: string | undefined;
         provider?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         auth?: {
             type: "bearer";
             token: string;
@@ -1586,7 +1949,14 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         endpoint: string;
         method: "GET" | "POST" | "PUT" | "DELETE";
+        description?: string | undefined;
         provider?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         auth?: {
             type: "bearer";
             token: string;
@@ -1604,6 +1974,10 @@ declare const SkillsFileSchema: z.ZodObject<{
         timeout_ms?: number | undefined;
         retries?: number | undefined;
     }>, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
         id: z.ZodString;
         type: z.ZodLiteral<"pipeline">;
         name: z.ZodString;
@@ -1640,6 +2014,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             free_tier?: number | undefined;
         }>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
+        capacity: z.ZodOptional<z.ZodObject<{
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_concurrent?: number | undefined;
+        }, {
+            max_concurrent?: number | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         type: "pipeline";
@@ -1656,6 +2037,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             input_mapping: Record<string, string>;
             command: string;
         })[];
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     }, {
         name: string;
@@ -1673,8 +2061,19 @@ declare const SkillsFileSchema: z.ZodObject<{
             command: string;
             input_mapping?: Record<string, string> | undefined;
         })[];
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     }>, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
         id: z.ZodString;
         type: z.ZodLiteral<"openclaw">;
         name: z.ZodString;
@@ -1694,6 +2093,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             free_tier?: number | undefined;
         }>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
+        capacity: z.ZodOptional<z.ZodObject<{
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_concurrent?: number | undefined;
+        }, {
+            max_concurrent?: number | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         type: "openclaw";
@@ -1705,6 +2111,13 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     }, {
         name: string;
@@ -1717,8 +2130,19 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     }>, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
         id: z.ZodString;
         type: z.ZodLiteral<"command">;
         name: z.ZodString;
@@ -1726,6 +2150,22 @@ declare const SkillsFileSchema: z.ZodObject<{
         output_type: z.ZodEnum<["json", "text", "file"]>;
         allowed_commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         working_dir: z.ZodOptional<z.ZodString>;
+        claude_code: z.ZodOptional<z.ZodObject<{
+            /** Optional system prompt passed via `-p` flag. */
+            system_prompt: z.ZodOptional<z.ZodString>;
+            /** Model to use (e.g. 'claude-opus-4-6', 'claude-sonnet-4-6'). */
+            model: z.ZodOptional<z.ZodString>;
+            /** When true, passes `--dangerously-skip-permissions` to claude CLI. */
+            auto_mode: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            auto_mode: boolean;
+            model?: string | undefined;
+            system_prompt?: string | undefined;
+        }, {
+            model?: string | undefined;
+            system_prompt?: string | undefined;
+            auto_mode?: boolean | undefined;
+        }>>;
         timeout_ms: z.ZodDefault<z.ZodNumber>;
         pricing: z.ZodObject<{
             credits_per_call: z.ZodNumber;
@@ -1740,6 +2180,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             credits_per_minute?: number | undefined;
             free_tier?: number | undefined;
         }>;
+        capacity: z.ZodOptional<z.ZodObject<{
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_concurrent?: number | undefined;
+        }, {
+            max_concurrent?: number | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         type: "command";
@@ -1752,8 +2199,20 @@ declare const SkillsFileSchema: z.ZodObject<{
         timeout_ms: number;
         command: string;
         output_type: "text" | "json" | "file";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         allowed_commands?: string[] | undefined;
         working_dir?: string | undefined;
+        claude_code?: {
+            auto_mode: boolean;
+            model?: string | undefined;
+            system_prompt?: string | undefined;
+        } | undefined;
     }, {
         name: string;
         type: "command";
@@ -1765,10 +2224,26 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         command: string;
         output_type: "text" | "json" | "file";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
         allowed_commands?: string[] | undefined;
         working_dir?: string | undefined;
+        claude_code?: {
+            model?: string | undefined;
+            system_prompt?: string | undefined;
+            auto_mode?: boolean | undefined;
+        } | undefined;
     }>, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        capability_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        requires_capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
         id: z.ZodString;
         type: z.ZodLiteral<"conductor">;
         name: z.ZodString;
@@ -1787,6 +2262,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             free_tier?: number | undefined;
         }>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
+        capacity: z.ZodOptional<z.ZodObject<{
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_concurrent?: number | undefined;
+        }, {
+            max_concurrent?: number | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         type: "conductor";
@@ -1797,6 +2279,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             free_tier?: number | undefined;
         };
         conductor_skill: "orchestrate" | "plan";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     }, {
         name: string;
@@ -1808,6 +2297,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             free_tier?: number | undefined;
         };
         conductor_skill: "orchestrate" | "plan";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     }>]>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -1826,7 +2322,14 @@ declare const SkillsFileSchema: z.ZodObject<{
         output_mapping: Record<string, string>;
         timeout_ms: number;
         retries: number;
+        description?: string | undefined;
         provider?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         auth?: {
             type: "bearer";
             token: string;
@@ -1855,6 +2358,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             input_mapping: Record<string, string>;
             command: string;
         })[];
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     } | {
         name: string;
@@ -1867,6 +2377,13 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     } | {
         name: string;
@@ -1880,8 +2397,20 @@ declare const SkillsFileSchema: z.ZodObject<{
         timeout_ms: number;
         command: string;
         output_type: "text" | "json" | "file";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         allowed_commands?: string[] | undefined;
         working_dir?: string | undefined;
+        claude_code?: {
+            auto_mode: boolean;
+            model?: string | undefined;
+            system_prompt?: string | undefined;
+        } | undefined;
     } | {
         name: string;
         type: "conductor";
@@ -1892,6 +2421,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             free_tier?: number | undefined;
         };
         conductor_skill: "orchestrate" | "plan";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     })[];
 }, {
@@ -1906,7 +2442,14 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         endpoint: string;
         method: "GET" | "POST" | "PUT" | "DELETE";
+        description?: string | undefined;
         provider?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         auth?: {
             type: "bearer";
             token: string;
@@ -1939,6 +2482,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             command: string;
             input_mapping?: Record<string, string> | undefined;
         })[];
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     } | {
         name: string;
@@ -1951,6 +2501,13 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     } | {
         name: string;
@@ -1963,9 +2520,21 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         command: string;
         output_type: "text" | "json" | "file";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
         allowed_commands?: string[] | undefined;
         working_dir?: string | undefined;
+        claude_code?: {
+            model?: string | undefined;
+            system_prompt?: string | undefined;
+            auto_mode?: boolean | undefined;
+        } | undefined;
     } | {
         name: string;
         type: "conductor";
@@ -1976,6 +2545,13 @@ declare const SkillsFileSchema: z.ZodObject<{
             free_tier?: number | undefined;
         };
         conductor_skill: "orchestrate" | "plan";
+        description?: string | undefined;
+        capability_types?: string[] | undefined;
+        requires_capabilities?: string[] | undefined;
+        visibility?: "public" | "private" | undefined;
+        capacity?: {
+            max_concurrent?: number | undefined;
+        } | undefined;
         timeout_ms?: number | undefined;
     })[];
 }>;
@@ -2041,6 +2617,45 @@ interface ExecutionResult {
     error?: string;
     /** Wall-clock execution time in milliseconds. */
     latency_ms: number;
+    /** Structured failure reason (e.g. 'overload' when at max_concurrent capacity). */
+    failure_reason?: string;
+}
+/**
+ * Tracks in-flight concurrent executions per skill ID.
+ * Used by SkillExecutor to enforce `capacity.max_concurrent` limits.
+ *
+ * Thread-safe within a single Node.js event loop (no true parallelism).
+ * acquire/release must always be paired (use try/finally).
+ */
+declare class ConcurrencyGuard {
+    private active;
+    /**
+     * Check whether the skill can accept another concurrent execution.
+     *
+     * @param skillId - The skill ID to check.
+     * @param maxConcurrent - The maximum allowed concurrent executions.
+     * @returns true if current load is below the limit.
+     */
+    canAccept(skillId: string, maxConcurrent: number): boolean;
+    /**
+     * Increment the in-flight counter for a skill. Call before execution starts.
+     *
+     * @param skillId - The skill ID to acquire a slot for.
+     */
+    acquire(skillId: string): void;
+    /**
+     * Decrement the in-flight counter for a skill. Call after execution completes (in finally block).
+     *
+     * @param skillId - The skill ID to release a slot for.
+     */
+    release(skillId: string): void;
+    /**
+     * Returns the current number of in-flight executions for a skill.
+     *
+     * @param skillId - The skill ID to check.
+     * @returns Current in-flight count (0 if no executions tracked).
+     */
+    getCurrentLoad(skillId: string): number;
 }
 /**
  * Interface that all executor mode implementations must satisfy.
@@ -2069,11 +2684,13 @@ interface ExecutorMode {
 declare class SkillExecutor {
     private readonly skillMap;
     private readonly modeMap;
+    private readonly concurrencyGuard?;
     /**
      * @param configs - Parsed SkillConfig array (from parseSkillsFile).
      * @param modes - Map from skill type string to its executor implementation.
+     * @param concurrencyGuard - Optional ConcurrencyGuard to enforce max_concurrent limits.
      */
-    constructor(configs: SkillConfig[], modes: Map<string, ExecutorMode>);
+    constructor(configs: SkillConfig[], modes: Map<string, ExecutorMode>, concurrencyGuard?: ConcurrencyGuard);
     /**
      * Execute a skill by ID with the given input parameters.
      *
@@ -2107,9 +2724,10 @@ declare class SkillExecutor {
  *
  * @param configs - Array of parsed SkillConfig objects.
  * @param modes - Map from type key to ExecutorMode implementation.
+ * @param concurrencyGuard - Optional ConcurrencyGuard to enforce max_concurrent limits.
  * @returns A configured SkillExecutor instance.
  */
-declare function createSkillExecutor(configs: SkillConfig[], modes: Map<string, ExecutorMode>): SkillExecutor;
+declare function createSkillExecutor(configs: SkillConfig[], modes: Map<string, ExecutorMode>, concurrencyGuard?: ConcurrencyGuard): SkillExecutor;
 
 /**
  * Options for creating a gateway server.
@@ -2411,6 +3029,14 @@ interface OrchestrationResult {
     latency_ms: number;
     /** Error messages for failed sub-tasks. */
     errors?: string[];
+    /**
+     * Per-task team traceability context. Keys are subtask IDs.
+     * Present only when the orchestration ran with a team.
+     */
+    trace?: Map<string, {
+        team_id: string | null;
+        capability_type: string | null;
+    }>;
 }
 
 /**
@@ -2993,6 +3619,104 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     id: string;
     message?: string | undefined;
     progress?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat">;
+    owner: z.ZodString;
+    capacity: z.ZodObject<{
+        current_load: z.ZodNumber;
+        max_concurrent: z.ZodNumber;
+        queue_depth: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        max_concurrent: number;
+        current_load: number;
+        queue_depth: number;
+    }, {
+        max_concurrent: number;
+        current_load: number;
+        queue_depth: number;
+    }>;
+    self_summary: z.ZodObject<{
+        capabilities: z.ZodArray<z.ZodString, "many">;
+        success_rate: z.ZodNumber;
+        credit_balance: z.ZodNumber;
+        total_completed: z.ZodNumber;
+        provider_number: z.ZodNumber;
+        reliability: z.ZodObject<{
+            current_streak: z.ZodNumber;
+            repeat_hire_rate: z.ZodNumber;
+            avg_feedback: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            current_streak: number;
+            repeat_hire_rate: number;
+            avg_feedback: number;
+        }, {
+            current_streak: number;
+            repeat_hire_rate: number;
+            avg_feedback: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        success_rate: number;
+        capabilities: string[];
+        credit_balance: number;
+        total_completed: number;
+        provider_number: number;
+        reliability: {
+            current_streak: number;
+            repeat_hire_rate: number;
+            avg_feedback: number;
+        };
+    }, {
+        success_rate: number;
+        capabilities: string[];
+        credit_balance: number;
+        total_completed: number;
+        provider_number: number;
+        reliability: {
+            current_streak: number;
+            repeat_hire_rate: number;
+            avg_feedback: number;
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "heartbeat";
+    owner: string;
+    capacity: {
+        max_concurrent: number;
+        current_load: number;
+        queue_depth: number;
+    };
+    self_summary: {
+        success_rate: number;
+        capabilities: string[];
+        credit_balance: number;
+        total_completed: number;
+        provider_number: number;
+        reliability: {
+            current_streak: number;
+            repeat_hire_rate: number;
+            avg_feedback: number;
+        };
+    };
+}, {
+    type: "heartbeat";
+    owner: string;
+    capacity: {
+        max_concurrent: number;
+        current_load: number;
+        queue_depth: number;
+    };
+    self_summary: {
+        success_rate: number;
+        capabilities: string[];
+        credit_balance: number;
+        total_completed: number;
+        provider_number: number;
+        reliability: {
+            current_streak: number;
+            repeat_hire_rate: number;
+            avg_feedback: number;
+        };
+    };
 }>]>;
 type RegisterMessage = z.infer<typeof RegisterMessageSchema>;
 type RegisteredMessage = z.infer<typeof RegisteredMessageSchema>;
@@ -3016,6 +3740,12 @@ interface PendingRelayRequest {
     /** Job ID if this request was dispatched from the job queue (relay bridge) */
     jobId?: string;
 }
+/** Capacity data reported by agent heartbeats */
+interface AgentCapacityData {
+    current_load: number;
+    max_concurrent: number;
+    queue_depth: number;
+}
 /** Relay server state returned from registerWebSocketRelay */
 interface RelayState {
     /** Number of currently connected agents */
@@ -3032,6 +3762,10 @@ interface RelayState {
     getPendingRequests?(): Map<string, PendingRelayRequest>;
     /** Send a JSON message over a WebSocket */
     sendMessage?(ws: unknown, msg: Record<string, unknown>): void;
+    /** Get capacity data for an agent (from heartbeat) */
+    getAgentCapacity?(owner: string): AgentCapacityData | undefined;
+    /** Get all agent capacity data */
+    getAllCapacities?(): Map<string, AgentCapacityData>;
 }
 
 /** Result of handling an incoming relay request */
@@ -3132,6 +3866,59 @@ declare class RelayClient {
     private scheduleReconnect;
 }
 
+/**
+ * Capability-first team data model for Conductor team formation.
+ *
+ * TeamMember.capability_type is the required_capability value this member is fulfilling.
+ * It is a direct match to SubTask.required_capability — not an abstract role hint.
+ */
+
+/**
+ * A single team member: a SubTask matched to an agent.
+ */
+interface TeamMember {
+    /** The sub-task this member handles. */
+    subtask: SubTask;
+    /** The required_capability value this member is fulfilling (e.g. 'text_gen', 'tts'). */
+    capability_type: string;
+    /** Owner ID of the matched agent. */
+    agent: string;
+    /** Skill ID on the agent's card for this task. */
+    skill: string;
+    /** Card ID for relay-based execution. */
+    card_id?: string;
+    /** Negotiated credit cost. */
+    credits: number;
+    /** Match quality score (0-1). */
+    score: number;
+}
+/**
+ * A fully-formed team: matched members + unrouted subtasks.
+ * Unrouted subtasks had no matching agent for their required_capability.
+ */
+interface Team {
+    /** Unique team identifier (UUID). */
+    team_id: string;
+    /** Formation strategy used to select agents. */
+    strategy: FormationStrategy;
+    /** Successfully matched team members. */
+    matched: TeamMember[];
+    /**
+     * Sub-tasks that could not be matched — no available agent found in the registry
+     * for the required_capability.
+     * Callers should decide whether to fail-fast or proceed with partial teams.
+     */
+    unrouted: SubTask[];
+}
+/**
+ * Agent selection strategy for team formation.
+ *
+ * cost_optimized     — select the lowest-cost agent per sub-task
+ * quality_optimized  — select the highest-scored agent per sub-task (success_rate × cost_efficiency × idle_rate)
+ * balanced           — use the default scorePeers() composite ranking (same as standard matchSubTasks)
+ */
+type FormationStrategy = 'cost_optimized' | 'quality_optimized' | 'balanced';
+
 /**
  * PipelineOrchestrator — DAG-based remote execution engine for the Conductor.
  *
@@ -3166,6 +3953,12 @@ interface OrchestrateOptions {
     relayClient?: RelayClient;
     /** Owner identifier of the requester agent. Used for relay requests. */
     requesterOwner?: string;
+    /**
+     * Optional pre-formed team from formTeam(). When provided, agent assignments
+     * for matched team members override the MatchResult selected_agent.
+     * Same-role subtasks in the same wave are routed to the same agent.
+     */
+    team?: Team;
 }
 /**
  * Executes a DAG of sub-tasks across remote agents via Gateway.