agentbnb 8.2.3 → 8.3.0

package/dist/index.d.ts

@@ -80,6 +80,16 @@ declare const CapabilityCardSchema: z.ZodObject<{
         online: boolean;
         schedule?: string | undefined;
     }>;
+    /**
+     * Provider-estimated typical execution duration in milliseconds.
+     * Used by requesters to derive default client-side timeouts.
+     */
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Provider hard timeout in milliseconds.
+     * Used as a fallback timeout hint when expected_duration_ms is unavailable.
+     */
+    hard_timeout_ms: z.ZodOptional<z.ZodNumber>;
     powered_by: z.ZodOptional<z.ZodArray<z.ZodObject<{
         provider: z.ZodString;
         model: z.ZodOptional<z.ZodString>;
@@ -151,6 +161,8 @@ declare const CapabilityCardSchema: z.ZodObject<{
         schedule?: string | undefined;
     };
     agent_id?: string | undefined;
+    expected_duration_ms?: number | undefined;
+    hard_timeout_ms?: number | undefined;
     powered_by?: {
         provider: string;
         model?: string | undefined;
@@ -198,6 +210,8 @@ declare const CapabilityCardSchema: z.ZodObject<{
     };
     spec_version?: "1.0" | undefined;
     agent_id?: string | undefined;
+    expected_duration_ms?: number | undefined;
+    hard_timeout_ms?: number | undefined;
     powered_by?: {
         provider: string;
         model?: string | undefined;
@@ -311,6 +325,16 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
             credits_per_minute?: number | undefined;
             free_tier?: number | undefined;
         }>;
+        /**
+         * Provider-estimated typical execution duration in milliseconds.
+         * Used by requesters to derive default client-side timeouts.
+         */
+        expected_duration_ms: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Provider hard timeout in milliseconds.
+         * Used as a fallback timeout hint when expected_duration_ms is unavailable.
+         */
+        hard_timeout_ms: z.ZodOptional<z.ZodNumber>;
         /** Per-skill online flag — overrides card-level availability for this skill. */
         availability: z.ZodOptional<z.ZodObject<{
             online: z.ZodBoolean;
@@ -393,6 +417,8 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         availability?: {
             online: boolean;
         } | undefined;
+        expected_duration_ms?: number | undefined;
+        hard_timeout_ms?: number | undefined;
         powered_by?: {
             provider: string;
             model?: string | undefined;
@@ -440,6 +466,8 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         availability?: {
             online: boolean;
         } | undefined;
+        expected_duration_ms?: number | undefined;
+        hard_timeout_ms?: number | undefined;
         powered_by?: {
             provider: string;
             model?: string | undefined;
@@ -620,6 +648,8 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         availability?: {
             online: boolean;
         } | undefined;
+        expected_duration_ms?: number | undefined;
+        hard_timeout_ms?: number | undefined;
         powered_by?: {
             provider: string;
             model?: string | undefined;
@@ -710,6 +740,8 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         availability?: {
             online: boolean;
         } | undefined;
+        expected_duration_ms?: number | undefined;
+        hard_timeout_ms?: number | undefined;
         powered_by?: {
             provider: string;
             model?: string | undefined;
@@ -876,6 +908,7 @@ declare const ApiSkillConfigSchema: z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"api">;
     name: z.ZodString;
@@ -957,6 +990,7 @@ declare const ApiSkillConfigSchema: z.ZodObject<{
     retries: number;
     description?: string | undefined;
     provider?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -988,6 +1022,7 @@ declare const ApiSkillConfigSchema: z.ZodObject<{
     method: "GET" | "POST" | "PUT" | "DELETE";
     description?: string | undefined;
     provider?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1020,6 +1055,7 @@ declare const PipelineSkillConfigSchema: z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"pipeline">;
     name: z.ZodString;
@@ -1080,6 +1116,7 @@ declare const PipelineSkillConfigSchema: z.ZodObject<{
         command: string;
     })[];
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1104,6 +1141,7 @@ declare const PipelineSkillConfigSchema: z.ZodObject<{
         input_mapping?: Record<string, string> | undefined;
     })[];
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1121,6 +1159,7 @@ declare const OpenClawSkillConfigSchema: z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"openclaw">;
     name: z.ZodString;
@@ -1159,6 +1198,7 @@ declare const OpenClawSkillConfigSchema: z.ZodObject<{
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1178,6 +1218,7 @@ declare const OpenClawSkillConfigSchema: z.ZodObject<{
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1195,6 +1236,7 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"command">;
     name: z.ZodString;
@@ -1252,6 +1294,7 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     command: string;
     output_type: "text" | "json" | "file";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1277,6 +1320,7 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     command: string;
     output_type: "text" | "json" | "file";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1301,6 +1345,7 @@ declare const ConductorSkillConfigSchema: z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"conductor">;
     name: z.ZodString;
@@ -1337,6 +1382,7 @@ declare const ConductorSkillConfigSchema: z.ZodObject<{
     };
     conductor_skill: "orchestrate" | "plan";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1355,6 +1401,7 @@ declare const ConductorSkillConfigSchema: z.ZodObject<{
     };
     conductor_skill: "orchestrate" | "plan";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1372,6 +1419,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"api">;
     name: z.ZodString;
@@ -1453,6 +1501,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     retries: number;
     description?: string | undefined;
     provider?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1484,6 +1533,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     method: "GET" | "POST" | "PUT" | "DELETE";
     description?: string | undefined;
     provider?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1511,6 +1561,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"pipeline">;
     name: z.ZodString;
@@ -1571,6 +1622,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         command: string;
     })[];
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1595,6 +1647,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         input_mapping?: Record<string, string> | undefined;
     })[];
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1607,6 +1660,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"openclaw">;
     name: z.ZodString;
@@ -1645,6 +1699,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1664,6 +1719,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     agent_name: string;
     channel: "telegram" | "webhook" | "process";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1676,6 +1732,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"command">;
     name: z.ZodString;
@@ -1733,6 +1790,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     command: string;
     output_type: "text" | "json" | "file";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1758,6 +1816,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     command: string;
     output_type: "text" | "json" | "file";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1777,6 +1836,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     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"]>>;
+    expected_duration_ms: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     type: z.ZodLiteral<"conductor">;
     name: z.ZodString;
@@ -1813,6 +1873,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     };
     conductor_skill: "orchestrate" | "plan";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1831,6 +1892,7 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     };
     conductor_skill: "orchestrate" | "plan";
     description?: string | undefined;
+    expected_duration_ms?: number | undefined;
     capability_types?: string[] | undefined;
     requires_capabilities?: string[] | undefined;
     visibility?: "public" | "private" | undefined;
@@ -1849,6 +1911,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         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"]>>;
+        expected_duration_ms: z.ZodOptional<z.ZodNumber>;
         id: z.ZodString;
         type: z.ZodLiteral<"api">;
         name: z.ZodString;
@@ -1930,6 +1993,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         retries: number;
         description?: string | undefined;
         provider?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -1961,6 +2025,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         method: "GET" | "POST" | "PUT" | "DELETE";
         description?: string | undefined;
         provider?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -1988,6 +2053,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         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"]>>;
+        expected_duration_ms: z.ZodOptional<z.ZodNumber>;
         id: z.ZodString;
         type: z.ZodLiteral<"pipeline">;
         name: z.ZodString;
@@ -2048,6 +2114,7 @@ declare const SkillsFileSchema: z.ZodObject<{
             command: string;
         })[];
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2072,6 +2139,7 @@ declare const SkillsFileSchema: z.ZodObject<{
             input_mapping?: Record<string, string> | undefined;
         })[];
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2084,6 +2152,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         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"]>>;
+        expected_duration_ms: z.ZodOptional<z.ZodNumber>;
         id: z.ZodString;
         type: z.ZodLiteral<"openclaw">;
         name: z.ZodString;
@@ -2122,6 +2191,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2141,6 +2211,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2153,6 +2224,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         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"]>>;
+        expected_duration_ms: z.ZodOptional<z.ZodNumber>;
         id: z.ZodString;
         type: z.ZodLiteral<"command">;
         name: z.ZodString;
@@ -2210,6 +2282,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         command: string;
         output_type: "text" | "json" | "file";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2235,6 +2308,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         command: string;
         output_type: "text" | "json" | "file";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2254,6 +2328,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         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"]>>;
+        expected_duration_ms: z.ZodOptional<z.ZodNumber>;
         id: z.ZodString;
         type: z.ZodLiteral<"conductor">;
         name: z.ZodString;
@@ -2290,6 +2365,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         conductor_skill: "orchestrate" | "plan";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2308,6 +2384,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         conductor_skill: "orchestrate" | "plan";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2334,6 +2411,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         retries: number;
         description?: string | undefined;
         provider?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2369,6 +2447,7 @@ declare const SkillsFileSchema: z.ZodObject<{
             command: string;
         })[];
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2388,6 +2467,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2408,6 +2488,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         command: string;
         output_type: "text" | "json" | "file";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2432,6 +2513,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         conductor_skill: "orchestrate" | "plan";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2454,6 +2536,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         method: "GET" | "POST" | "PUT" | "DELETE";
         description?: string | undefined;
         provider?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2493,6 +2576,7 @@ declare const SkillsFileSchema: z.ZodObject<{
             input_mapping?: Record<string, string> | undefined;
         })[];
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2512,6 +2596,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         agent_name: string;
         channel: "telegram" | "webhook" | "process";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2531,6 +2616,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         command: string;
         output_type: "text" | "json" | "file";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2556,6 +2642,7 @@ declare const SkillsFileSchema: z.ZodObject<{
         };
         conductor_skill: "orchestrate" | "plan";
         description?: string | undefined;
+        expected_duration_ms?: number | undefined;
         capability_types?: string[] | undefined;
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
@@ -2878,7 +2965,7 @@ declare class PipelineExecutor implements ExecutorMode {
  * Forwards AgentBnB skill execution requests to an OpenClaw agent via one of
  * three configurable channels:
  * - `webhook` — HTTP POST to OpenClaw agent's local webhook endpoint
- * - `process` — spawn `openclaw run <agent_name>` subprocess
+ * - `process` — spawn `openclaw agent --agent <name> --message <JSON> --json --local`
  * - `telegram` — fire-and-forget POST to Telegram Bot API
  *
  * Implements the {@link ExecutorMode} interface so it can be registered into
@@ -3730,6 +3817,18 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     id: string;
     message?: string | undefined;
     progress?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"relay_started">;
+    id: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "relay_started";
+    id: string;
+    message?: string | undefined;
+}, {
+    type: "relay_started";
+    id: string;
+    message?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"heartbeat">;
     owner: z.ZodString;
@@ -3840,19 +3939,19 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "escrow_hold";
     skill_id: string;
-    amount: number;
     request_id: string;
     consumer_agent_id: string;
     provider_agent_id: string;
+    amount: number;
     public_key?: string | undefined;
     signature?: string | undefined;
 }, {
     type: "escrow_hold";
     skill_id: string;
-    amount: number;
     request_id: string;
     consumer_agent_id: string;
     provider_agent_id: string;
+    amount: number;
     public_key?: string | undefined;
     signature?: string | undefined;
 }>, z.ZodObject<{
@@ -3890,8 +3989,8 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     escrow_id: string;
     public_key?: string | undefined;
     failure_reason?: "timeout" | "bad_execution" | "overload" | "auth_error" | "not_found" | undefined;
-    signature?: string | undefined;
     consumer_agent_id?: string | undefined;
+    signature?: string | undefined;
     result_hash?: string | undefined;
 }, {
     type: "escrow_settle";
@@ -3900,8 +3999,8 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     escrow_id: string;
     public_key?: string | undefined;
     failure_reason?: "timeout" | "bad_execution" | "overload" | "auth_error" | "not_found" | undefined;
-    signature?: string | undefined;
     consumer_agent_id?: string | undefined;
+    signature?: string | undefined;
     result_hash?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"escrow_settled">;
@@ -3963,7 +4062,19 @@ interface PendingRelayRequest {
     originOwner: string;
     /** Actual agent owner for credit operations (defaults to originOwner) */
     creditOwner?: string;
+    /** Active timeout handle (backward-compatible alias for current phase timer). */
     timeout: ReturnType<typeof setTimeout>;
+    /** Idle timeout before provider acknowledges start. */
+    idleTimeout?: ReturnType<typeof setTimeout>;
+    /** Hard timeout after provider start acknowledgement. */
+    hardTimeout?: ReturnType<typeof setTimeout>;
+    /** Grace timeout after requester disconnects post-start. */
+    graceTimeout?: ReturnType<typeof setTimeout>;
+    /** Lifecycle stage tracked by relay for disconnect policy. */
+    lifecycle?: 'held' | 'started' | 'progressing' | 'abandoned';
+    createdAt?: number;
+    startedAt?: number;
+    abandonedAt?: number;
     /** Escrow ID for the credit hold, if credits were reserved for this request */
     escrowId?: string;
     /** The target provider owner, needed to release escrow on provider disconnect */
@@ -4085,10 +4196,17 @@ declare class RelayClient {
      * @returns The result from the target agent.
      */
     request(opts: RelayRequestOptions$1): Promise<unknown>;
+    /**
+     * Send a relay_started message to acknowledge that provider has started work.
+     *
+     * @param requestId - The relay request ID being processed.
+     * @param message - Optional status message.
+     */
+    sendStarted(requestId: string, message?: string): void;
     /**
      * Send a relay_progress message to the relay server for a given request.
      * Used by the onRequest handler to forward SkillExecutor progress updates
-     * to the requesting agent so it can reset its timeout window.
+     * to the requesting agent while work is in-flight.
      *
      * @param requestId - The relay request ID to associate progress with.
      * @param info - Progress details (step, total, message).
@@ -4347,21 +4465,21 @@ declare const EscrowReceiptSchema: z.ZodObject<{
     signature: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     timestamp: string;
+    card_id: string;
+    amount: number;
     signature: string;
     requester_owner: string;
     requester_public_key: string;
-    amount: number;
-    card_id: string;
     nonce: string;
     skill_id?: string | undefined;
     requester_agent_id?: string | undefined;
 }, {
     timestamp: string;
+    card_id: string;
+    amount: number;
     signature: string;
     requester_owner: string;
     requester_public_key: string;
-    amount: number;
-    card_id: string;
     nonce: string;
     skill_id?: string | undefined;
     requester_agent_id?: string | undefined;
@@ -4400,6 +4518,11 @@ declare function createSignedEscrowReceipt(db: Database.Database, privateKey: Bu
 };
 
 /**
+ * @deprecated Use relay-based settlement instead. This function deducts a 5% network
+ * fee from the provider amount but does NOT credit `platform_treasury`, so the fee
+ * effectively vanishes. The relay's `settleEscrow()` correctly handles the fee.
+ * Kept for backward compatibility and audit trail.
+ *
  * Provider-side settlement: records earnings from a signed escrow receipt.
  * The provider calls this after successfully executing a capability.
  * Credits are recorded in the provider's own local DB.
@@ -4638,6 +4761,10 @@ interface ConsumerRequestOptions {
     credits: number;
     /** Timeout in milliseconds. Default 30000. */
     timeoutMs?: number;
+    /** Provider-published expected duration used to derive timeout when timeoutMs is omitted. */
+    expectedDurationMs?: number;
+    /** Provider-published hard timeout used as fallback timeout hint. */
+    providerHardTimeoutMs?: number;
 }
 /**
  * AgentBnBConsumer — high-level SDK class for agents consuming capabilities.
@@ -4676,6 +4803,27 @@ declare class AgentBnBConsumer {
      */
     getIdentity(): AgentIdentity;
     /**
+     * Requests a paid capability via the relay. The relay handles escrow + network fee
+     * server-side, avoiding the fee bypass bug in the signed receipt path.
+     *
+     * @param opts - Relay request options.
+     * @returns The result from the capability execution.
+     * @throws {AgentBnBError} on relay connection failure or execution error.
+     */
+    requestViaRelay(opts: {
+        registryUrl: string;
+        targetOwner: string;
+        targetAgentId?: string;
+        cardId: string;
+        skillId?: string;
+        params?: Record<string, unknown>;
+        timeoutMs?: number;
+    }): Promise<unknown>;
+    /**
+     * @deprecated Use `requestViaRelay()` for paid remote requests. This method uses
+     * local escrow + signed receipts which bypass the network fee. Still works for
+     * free/local requests.
+     *
      * Requests a capability from a remote agent with full escrow lifecycle.
      *
      * 1. Creates a signed escrow receipt (holds credits locally)
@@ -4931,12 +5079,23 @@ type ExecuteResult = {
  */
 declare function executeCapabilityRequest(opts: ExecuteRequestOptions): Promise<ExecuteResult>;
 
+/**
+ * Timeout hints published by a provider card/skill.
+ */
+interface RequestTimeoutHint {
+    /** Typical expected duration from provider metadata. */
+    expected_duration_ms?: number;
+    /** Provider-declared hard timeout from provider metadata. */
+    hard_timeout_ms?: number;
+}
 /**
  * Options for requesting a capability via WebSocket relay.
  */
 interface RelayRequestOptions {
     /** Target agent owner to relay the request to. */
     targetOwner: string;
+    /** Canonical target agent identity. Preferred for routing when available. */
+    targetAgentId?: string;
     /** Capability Card ID to execute. */
     cardId: string;
     /** Optional skill ID within the card. */
@@ -4945,8 +5104,10 @@ interface RelayRequestOptions {
     params?: Record<string, unknown>;
     /** Signed escrow receipt for cross-machine credit verification. */
     escrowReceipt?: EscrowReceipt;
-    /** Timeout in milliseconds. Default 30000. */
+    /** Timeout in milliseconds. Explicit override when provided. */
     timeoutMs?: number;
+    /** Provider timeout metadata used to derive default timeout when timeoutMs is omitted. */
+    timeoutHint?: RequestTimeoutHint;
     /** Actual requester owner for credit tracking (defaults to relay client's owner). */
     requester?: string;
 }