agentbnb 5.1.10 → 6.0.0

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;
@@ -1084,6 +1206,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,6 +1225,13 @@ 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;
 }, {
@@ -1109,6 +1245,13 @@ 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;
@@ -1118,6 +1261,10 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
  * 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 +1283,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 +1300,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 +1318,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 +1332,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 +1393,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 +1415,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 +1446,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 +1471,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 +1511,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 +1534,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 +1558,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 +1590,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 +1608,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 +1627,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;
@@ -1414,6 +1661,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,6 +1680,13 @@ 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;
 }, {
@@ -1439,10 +1700,21 @@ 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;
 }>, 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 +1733,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 +1750,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 +1768,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 +1783,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 +1844,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 +1866,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 +1897,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 +1922,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 +1962,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 +1985,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 +2009,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 +2041,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 +2059,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 +2078,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;
@@ -1740,6 +2112,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,6 +2131,13 @@ 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;
     }, {
@@ -1765,10 +2151,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;
     }>, 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 +2184,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 +2201,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 +2219,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 +2244,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 +2280,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 +2299,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,6 +2319,13 @@ 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;
     } | {
@@ -1892,6 +2338,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 +2359,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 +2399,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 +2418,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,6 +2437,13 @@ 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;
@@ -1976,6 +2457,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;
     })[];
 }>;
@@ -2411,6 +2899,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;
+    }>;
 }
 
 /**
@@ -3132,6 +3628,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 +3715,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.