agentbnb 7.0.0-beta.1 → 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. */
@@ -2899,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;
 }
 
 /**
@@ -3281,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<{
@@ -3313,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>>;
@@ -3327,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;
@@ -3336,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<{
@@ -3451,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;
@@ -3479,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>>;
@@ -3493,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;
@@ -3502,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;
@@ -3717,6 +3828,126 @@ declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             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>;
@@ -3777,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. */
@@ -3796,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>;
@@ -4090,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;
@@ -4106,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;
@@ -4115,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.
@@ -4122,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. */
@@ -4206,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;
@@ -4215,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;
@@ -4251,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;
@@ -4260,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;
@@ -4280,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;
@@ -4295,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;