agentbnb 6.0.0 → 7.0.0

package/dist/index.d.ts

@@ -13,6 +13,8 @@ declare const CapabilityCardSchema: z.ZodObject<{
     spec_version: z.ZodDefault<z.ZodLiteral<"1.0">>;
     id: z.ZodString;
     owner: z.ZodString;
+    /** V8: Cryptographic agent identity (Ed25519 public key hash). */
+    agent_id: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
     description: z.ZodString;
     level: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
@@ -148,6 +150,7 @@ declare const CapabilityCardSchema: z.ZodObject<{
         online: boolean;
         schedule?: string | undefined;
     };
+    agent_id?: string | undefined;
     powered_by?: {
         provider: string;
         model?: string | undefined;
@@ -194,6 +197,7 @@ declare const CapabilityCardSchema: z.ZodObject<{
         schedule?: string | undefined;
     };
     spec_version?: "1.0" | undefined;
+    agent_id?: string | undefined;
     powered_by?: {
         provider: string;
         model?: string | undefined;
@@ -222,6 +226,8 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
     spec_version: z.ZodLiteral<"2.0">;
     id: z.ZodString;
     owner: z.ZodString;
+    /** V8: Cryptographic agent identity (Ed25519 public key hash). */
+    agent_id: z.ZodOptional<z.ZodString>;
     /** Agent display name — was 'name' in v1.0. */
     agent_name: z.ZodString;
     /** Short one-liner shown in Hub v2 Identity Header. */
@@ -635,6 +641,7 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
     }[];
+    agent_id?: string | undefined;
     _internal?: Record<string, unknown> | undefined;
     gateway_url?: string | undefined;
     created_at?: string | undefined;
@@ -724,6 +731,7 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         requires_capabilities?: string[] | undefined;
         visibility?: "public" | "private" | undefined;
     }[];
+    agent_id?: string | undefined;
     _internal?: Record<string, unknown> | undefined;
     gateway_url?: string | undefined;
     created_at?: string | undefined;
@@ -766,6 +774,8 @@ type CapabilityCardV2 = z.infer<typeof CapabilityCardV2Schema>;
 interface EscrowReceipt {
     /** Agent owner identifier of the requester. */
     requester_owner: string;
+    /** V8: Cryptographic agent identity of the requester. */
+    requester_agent_id?: string;
     /** Hex-encoded Ed25519 public key of the requester. */
     requester_public_key: string;
     /** Number of credits committed. */
@@ -1192,6 +1202,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;
@@ -1234,6 +1260,11 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     } | 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";
@@ -1255,6 +1286,11 @@ declare const CommandSkillConfigSchema: z.ZodObject<{
     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).
@@ -1647,6 +1683,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;
@@ -1689,6 +1741,11 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     } | 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";
@@ -1710,6 +1767,11 @@ declare const SkillConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     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">>;
@@ -2098,6 +2160,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;
@@ -2140,6 +2218,11 @@ declare const SkillsFileSchema: z.ZodObject<{
         } | 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";
@@ -2161,6 +2244,11 @@ declare const SkillsFileSchema: z.ZodObject<{
         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">>;
@@ -2328,6 +2416,11 @@ declare const SkillsFileSchema: z.ZodObject<{
         } | 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";
@@ -2447,6 +2540,11 @@ declare const SkillsFileSchema: z.ZodObject<{
         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";
@@ -2529,6 +2627,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.
@@ -2557,11 +2694,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.
      *
@@ -2595,9 +2734,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.
@@ -2769,22 +2909,41 @@ declare class OpenClawBridge implements ExecutorMode {
  * - Three output types: text (raw stdout), json (parsed), file (path from stdout)
  * - Security allowlist via `allowed_commands` (base command checked against list)
  * - Configurable timeout and working directory
+ * - SIGTERM → SIGKILL escalation on timeout (prevents zombie processes)
+ * - Process registry for graceful shutdown of all active children
+ * - Per-skill concurrency enforcement via capacity.max_concurrent
  */
 declare class CommandExecutor implements ExecutorMode {
+    /** Active child processes — killed on shutdown(). */
+    private readonly activeProcesses;
+    /** In-flight execution count per skill ID for concurrency limiting. */
+    private readonly inflight;
     /**
      * Execute a command skill with the provided parameters.
      *
      * Steps:
-     * 1. Security check: base command must be in `allowed_commands` if set.
-     * 2. Interpolate `config.command` using `{ params }` context.
-     * 3. Run via `child_process.exec` with timeout and cwd.
-     * 4. Parse stdout based on `output_type`: text | json | file.
+     * 1. Concurrency check: reject if at capacity.max_concurrent limit.
+     * 2. Security check: base command must be in `allowed_commands` if set.
+     * 3. Interpolate `config.command` using `{ params }` context.
+     * 4. Run via spawn with SIGTERM→SIGKILL timeout handling.
+     * 5. Parse stdout based on `output_type`: text | json | file.
      *
      * @param config - Validated CommandSkillConfig.
      * @param params - Input parameters passed by the caller.
      * @returns Partial ExecutionResult (without latency_ms).
      */
     execute(config: SkillConfig, params: Record<string, unknown>): Promise<Omit<ExecutionResult, 'latency_ms'>>;
+    /**
+     * Kill all active child processes. Called during service shutdown
+     * to prevent zombie processes.
+     */
+    shutdown(): void;
+    /** Returns the number of currently active child processes. */
+    get activeCount(): number;
+    /** Returns the in-flight count for a specific skill ID. */
+    getInflight(skillId: string): number;
+    /** Decrement the inflight counter for a skill ID. */
+    private decrementInflight;
 }
 
 /**
@@ -3151,21 +3310,58 @@ declare function registerConductorCard(db: Database.Database): CapabilityCardV2;
 declare const RegisterMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"register">;
     owner: z.ZodString;
+    /** V8: Cryptographic agent identity. When present, used as the canonical key. */
+    agent_id: z.ZodOptional<z.ZodString>;
+    /** V8 Phase 3: Server identifier for multi-agent delegation. */
+    server_id: z.ZodOptional<z.ZodString>;
     token: z.ZodString;
     card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     cards: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    /** V8 Phase 3: Additional agents served by this server (multi-agent registration). */
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent_id: z.ZodString;
+        display_name: z.ZodString;
+        cards: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        delegation_token: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }, {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "register";
     owner: string;
     token: string;
     card: Record<string, unknown>;
+    agent_id?: string | undefined;
+    server_id?: string | undefined;
     cards?: Record<string, unknown>[] | undefined;
+    agents?: {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }[] | undefined;
 }, {
     type: "register";
     owner: string;
     token: string;
     card: Record<string, unknown>;
+    agent_id?: string | undefined;
+    server_id?: string | undefined;
     cards?: Record<string, unknown>[] | undefined;
+    agents?: {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }[] | undefined;
 }>;
 /** Registry → Agent: Acknowledge registration */
 declare const RegisteredMessageSchema: z.ZodObject<{
@@ -3183,6 +3379,8 @@ declare const RelayRequestMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"relay_request">;
     id: z.ZodString;
     target_owner: z.ZodString;
+    /** V8: Target agent's cryptographic identity. Preferred over target_owner. */
+    target_agent_id: z.ZodOptional<z.ZodString>;
     card_id: z.ZodString;
     skill_id: z.ZodOptional<z.ZodString>;
     params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -3197,6 +3395,7 @@ declare const RelayRequestMessageSchema: z.ZodObject<{
     skill_id?: string | undefined;
     requester?: string | undefined;
     escrow_receipt?: Record<string, unknown> | undefined;
+    target_agent_id?: string | undefined;
 }, {
     type: "relay_request";
     id: string;
@@ -3206,6 +3405,7 @@ declare const RelayRequestMessageSchema: z.ZodObject<{
     skill_id?: string | undefined;
     requester?: string | undefined;
     escrow_receipt?: Record<string, unknown> | undefined;
+    target_agent_id?: string | undefined;
 }>;
 /** Registry → Agent B: Incoming request forwarded from Agent A */
 declare const IncomingRequestMessageSchema: z.ZodObject<{
@@ -3321,21 +3521,58 @@ declare const ErrorMessageSchema: z.ZodObject<{
 declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"register">;
     owner: z.ZodString;
+    /** V8: Cryptographic agent identity. When present, used as the canonical key. */
+    agent_id: z.ZodOptional<z.ZodString>;
+    /** V8 Phase 3: Server identifier for multi-agent delegation. */
+    server_id: z.ZodOptional<z.ZodString>;
     token: z.ZodString;
     card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     cards: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    /** V8 Phase 3: Additional agents served by this server (multi-agent registration). */
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent_id: z.ZodString;
+        display_name: z.ZodString;
+        cards: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        delegation_token: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }, {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "register";
     owner: string;
     token: string;
     card: Record<string, unknown>;
+    agent_id?: string | undefined;
+    server_id?: string | undefined;
     cards?: Record<string, unknown>[] | undefined;
+    agents?: {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }[] | undefined;
 }, {
     type: "register";
     owner: string;
     token: string;
     card: Record<string, unknown>;
+    agent_id?: string | undefined;
+    server_id?: string | undefined;
     cards?: Record<string, unknown>[] | undefined;
+    agents?: {
+        agent_id: string;
+        display_name: string;
+        cards: Record<string, unknown>[];
+        delegation_token?: Record<string, unknown> | undefined;
+    }[] | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"registered">;
     agent_id: z.ZodString;
@@ -3349,6 +3586,8 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"relay_request">;
     id: z.ZodString;
     target_owner: z.ZodString;
+    /** V8: Target agent's cryptographic identity. Preferred over target_owner. */
+    target_agent_id: z.ZodOptional<z.ZodString>;
     card_id: z.ZodString;
     skill_id: z.ZodOptional<z.ZodString>;
     params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -3363,6 +3602,7 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     skill_id?: string | undefined;
     requester?: string | undefined;
     escrow_receipt?: Record<string, unknown> | undefined;
+    target_agent_id?: string | undefined;
 }, {
     type: "relay_request";
     id: string;
@@ -3372,6 +3612,7 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     skill_id?: string | undefined;
     requester?: string | undefined;
     escrow_receipt?: Record<string, unknown> | undefined;
+    target_agent_id?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"incoming_request">;
     id: z.ZodString;
@@ -3489,6 +3730,224 @@ 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;
+        };
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"escrow_hold">;
+    consumer_agent_id: z.ZodString;
+    provider_agent_id: z.ZodString;
+    skill_id: z.ZodString;
+    amount: z.ZodNumber;
+    request_id: z.ZodString;
+    signature: z.ZodOptional<z.ZodString>;
+    public_key: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "escrow_hold";
+    skill_id: string;
+    amount: number;
+    request_id: string;
+    consumer_agent_id: string;
+    provider_agent_id: string;
+    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;
+    public_key?: string | undefined;
+    signature?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"escrow_hold_confirmed">;
+    request_id: z.ZodString;
+    escrow_id: z.ZodString;
+    hold_amount: z.ZodNumber;
+    consumer_remaining: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "escrow_hold_confirmed";
+    request_id: string;
+    escrow_id: string;
+    hold_amount: number;
+    consumer_remaining: number;
+}, {
+    type: "escrow_hold_confirmed";
+    request_id: string;
+    escrow_id: string;
+    hold_amount: number;
+    consumer_remaining: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"escrow_settle">;
+    escrow_id: z.ZodString;
+    request_id: z.ZodString;
+    success: z.ZodBoolean;
+    failure_reason: z.ZodOptional<z.ZodEnum<["bad_execution", "overload", "timeout", "auth_error", "not_found"]>>;
+    result_hash: z.ZodOptional<z.ZodString>;
+    signature: z.ZodOptional<z.ZodString>;
+    public_key: z.ZodOptional<z.ZodString>;
+    consumer_agent_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "escrow_settle";
+    success: boolean;
+    request_id: string;
+    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;
+    result_hash?: string | undefined;
+}, {
+    type: "escrow_settle";
+    success: boolean;
+    request_id: string;
+    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;
+    result_hash?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"escrow_settled">;
+    escrow_id: z.ZodString;
+    request_id: z.ZodString;
+    provider_earned: z.ZodNumber;
+    network_fee: z.ZodNumber;
+    consumer_remaining: z.ZodNumber;
+    provider_balance: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "escrow_settled";
+    network_fee: number;
+    request_id: string;
+    escrow_id: string;
+    consumer_remaining: number;
+    provider_earned: number;
+    provider_balance: number;
+}, {
+    type: "escrow_settled";
+    network_fee: number;
+    request_id: string;
+    escrow_id: string;
+    consumer_remaining: number;
+    provider_earned: number;
+    provider_balance: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"balance_sync">;
+    agent_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "balance_sync";
+    agent_id: string;
+}, {
+    type: "balance_sync";
+    agent_id: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"balance_sync_response">;
+    agent_id: z.ZodString;
+    balance: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "balance_sync_response";
+    agent_id: string;
+    balance: number;
+}, {
+    type: "balance_sync_response";
+    agent_id: string;
+    balance: number;
 }>]>;
 type RegisterMessage = z.infer<typeof RegisterMessageSchema>;
 type RegisteredMessage = z.infer<typeof RegisteredMessageSchema>;
@@ -3512,6 +3971,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 */
@@ -3528,6 +3993,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 */
@@ -3539,17 +4008,31 @@ interface RelayHandlerResult {
     };
 }
 /** Options for the RelayClient constructor */
+/** V8 Phase 3: Additional agent to register on the same connection */
+interface DelegatedAgent {
+    agent_id: string;
+    display_name: string;
+    cards: Record<string, unknown>[];
+    delegation_token?: Record<string, unknown>;
+}
+/** Options for the RelayClient constructor */
 interface RelayClientOptions {
     /** Registry WebSocket URL (e.g., "wss://hub.agentbnb.dev/ws") */
     registryUrl: string;
     /** Agent owner identifier */
     owner: string;
+    /** V8: Cryptographic agent identity */
+    agent_id?: string;
+    /** V8 Phase 3: Server identifier for multi-agent delegation */
+    server_id?: string;
     /** Authentication token */
     token: string;
     /** Capability card data to register */
     card: Record<string, unknown>;
     /** Additional cards to register alongside the primary card (e.g., conductor card) */
     cards?: Record<string, unknown>[];
+    /** V8 Phase 3: Additional agents served by this connection */
+    agents?: DelegatedAgent[];
     /** Handler for incoming relay requests from other agents */
     onRequest: (req: IncomingRequestMessage) => Promise<RelayHandlerResult>;
     /** Suppress logging. Default false. */
@@ -3558,6 +4041,8 @@ interface RelayClientOptions {
 /** Options for making a relay request to another agent */
 interface RelayRequestOptions$1 {
     targetOwner: string;
+    /** V8: Target agent's cryptographic identity. Preferred for routing. */
+    targetAgentId?: string;
     cardId: string;
     skillId?: string;
     params: Record<string, unknown>;
@@ -3852,6 +4337,7 @@ declare function verifyEscrowReceipt(data: Record<string, unknown>, signature: s
  */
 declare const EscrowReceiptSchema: z.ZodObject<{
     requester_owner: z.ZodString;
+    requester_agent_id: z.ZodOptional<z.ZodString>;
     requester_public_key: z.ZodString;
     amount: z.ZodNumber;
     card_id: z.ZodString;
@@ -3868,6 +4354,7 @@ declare const EscrowReceiptSchema: z.ZodObject<{
     card_id: string;
     nonce: string;
     skill_id?: string | undefined;
+    requester_agent_id?: string | undefined;
 }, {
     timestamp: string;
     signature: string;
@@ -3877,6 +4364,7 @@ declare const EscrowReceiptSchema: z.ZodObject<{
     card_id: string;
     nonce: string;
     skill_id?: string | undefined;
+    requester_agent_id?: string | undefined;
 }>;
 /**
  * Options for creating a signed escrow receipt.
@@ -3884,6 +4372,8 @@ declare const EscrowReceiptSchema: z.ZodObject<{
 interface CreateReceiptOpts {
     /** Agent owner identifier (requester). */
     owner: string;
+    /** V8: Cryptographic agent identity (preferred over owner). */
+    agent_id?: string;
     /** Number of credits to commit. */
     amount: number;
     /** Capability Card ID being requested. */
@@ -3968,8 +4458,8 @@ declare const AgentIdentitySchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     owner: string;
-    created_at: string;
     agent_id: string;
+    created_at: string;
     public_key: string;
     guarantor?: {
         github_login: string;
@@ -3977,8 +4467,8 @@ declare const AgentIdentitySchema: z.ZodObject<{
     } | undefined;
 }, {
     owner: string;
-    created_at: string;
     agent_id: string;
+    created_at: string;
     public_key: string;
     guarantor?: {
         github_login: string;
@@ -4013,8 +4503,8 @@ declare const AgentCertificateSchema: z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         owner: string;
-        created_at: string;
         agent_id: string;
+        created_at: string;
         public_key: string;
         guarantor?: {
             github_login: string;
@@ -4022,8 +4512,8 @@ declare const AgentCertificateSchema: z.ZodObject<{
         } | undefined;
     }, {
         owner: string;
-        created_at: string;
         agent_id: string;
+        created_at: string;
         public_key: string;
         guarantor?: {
             github_login: string;
@@ -4042,8 +4532,8 @@ declare const AgentCertificateSchema: z.ZodObject<{
     signature: string;
     identity: {
         owner: string;
-        created_at: string;
         agent_id: string;
+        created_at: string;
         public_key: string;
         guarantor?: {
             github_login: string;
@@ -4057,8 +4547,8 @@ declare const AgentCertificateSchema: z.ZodObject<{
     signature: string;
     identity: {
         owner: string;
-        created_at: string;
         agent_id: string;
+        created_at: string;
         public_key: string;
         guarantor?: {
             github_login: string;