agentbnb 4.0.1 → 4.0.2

package/dist/{client-BTPIFY7E.js → client-T5MTY3CS.js}

@@ -1,9 +1,9 @@
 import {
   requestCapability,
   requestViaRelay
-} from "./chunk-KJG2UJV5.js";
-import "./chunk-DVAS2443.js";
-import "./chunk-FNKBHBYK.js";
+} from "./chunk-XND2DWTZ.js";
+import "./chunk-5KFI5X7B.js";
+import "./chunk-WGZ5AGOX.js";
 export {
   requestCapability,
   requestViaRelay

package/dist/conduct-GZQNFTRP.js

@@ -0,0 +1,19 @@
+import {
+  conductAction
+} from "./chunk-BH6WGYFB.js";
+import "./chunk-4P3EMGL4.js";
+import "./chunk-3MJT4PZG.js";
+import "./chunk-GGYC5U2Z.js";
+import "./chunk-FF226TIV.js";
+import "./chunk-XND2DWTZ.js";
+import "./chunk-5AH3CMOX.js";
+import "./chunk-75OC6E4F.js";
+import "./chunk-T7NS2J2B.js";
+import "./chunk-DNWT5FZQ.js";
+import "./chunk-5KFI5X7B.js";
+import "./chunk-WGZ5AGOX.js";
+import "./chunk-JOY533UH.js";
+import "./chunk-QT7TEVNV.js";
+export {
+  conductAction
+};

package/dist/{conduct-CW62HBPT.js → conduct-N52JX7RT.js}

@@ -1,17 +1,17 @@
 import {
   conductAction
-} from "./chunk-3UKAVIMC.js";
-import "./chunk-MQKYGY5I.js";
+} from "./chunk-BH6WGYFB.js";
+import "./chunk-4P3EMGL4.js";
 import "./chunk-3MJT4PZG.js";
-import "./chunk-6K5WUVF3.js";
-import "./chunk-QJEOCKVF.js";
-import "./chunk-KJG2UJV5.js";
+import "./chunk-GGYC5U2Z.js";
+import "./chunk-FF226TIV.js";
+import "./chunk-XND2DWTZ.js";
 import "./chunk-5AH3CMOX.js";
 import "./chunk-75OC6E4F.js";
-import "./chunk-TLU7ALCZ.js";
-import "./chunk-XQHN6ITI.js";
-import "./chunk-DVAS2443.js";
-import "./chunk-FNKBHBYK.js";
+import "./chunk-T7NS2J2B.js";
+import "./chunk-DNWT5FZQ.js";
+import "./chunk-5KFI5X7B.js";
+import "./chunk-WGZ5AGOX.js";
 import "./chunk-JOY533UH.js";
 import "./chunk-QT7TEVNV.js";
 

package/dist/{conductor-mode-3JS4VWCR.js → conductor-mode-XUWGR4ZE.js}

@@ -3,18 +3,18 @@ import {
   decompose,
   matchSubTasks,
   orchestrate
-} from "./chunk-MQKYGY5I.js";
+} from "./chunk-4P3EMGL4.js";
 import "./chunk-3MJT4PZG.js";
 import {
   BudgetManager
-} from "./chunk-6K5WUVF3.js";
-import "./chunk-QJEOCKVF.js";
-import "./chunk-KJG2UJV5.js";
+} from "./chunk-GGYC5U2Z.js";
+import "./chunk-FF226TIV.js";
+import "./chunk-XND2DWTZ.js";
 import "./chunk-5AH3CMOX.js";
 import "./chunk-75OC6E4F.js";
-import "./chunk-XQHN6ITI.js";
-import "./chunk-DVAS2443.js";
-import "./chunk-FNKBHBYK.js";
+import "./chunk-DNWT5FZQ.js";
+import "./chunk-5KFI5X7B.js";
+import "./chunk-WGZ5AGOX.js";
 
 // src/conductor/conductor-mode.ts
 var ConductorMode = class {

package/dist/execute-PNGQOMYO.js

@@ -0,0 +1,10 @@
+import {
+  executeCapabilityRequest
+} from "./chunk-7NA43XCG.js";
+import "./chunk-T7NS2J2B.js";
+import "./chunk-DNWT5FZQ.js";
+import "./chunk-5KFI5X7B.js";
+import "./chunk-WGZ5AGOX.js";
+export {
+  executeCapabilityRequest
+};

package/dist/index.d.ts

@@ -220,6 +220,8 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
     owner: z.ZodString;
     /** Agent display name — was 'name' in v1.0. */
     agent_name: z.ZodString;
+    /** Short one-liner shown in Hub v2 Identity Header. */
+    short_description: z.ZodOptional<z.ZodString>;
     /** At least one skill is required. */
     skills: z.ZodArray<z.ZodObject<{
         /** Stable skill identifier, e.g. 'tts-elevenlabs'. Used for gateway routing and idle tracking. */
@@ -443,6 +445,97 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
         runtime: string;
         region?: string | undefined;
     }>>;
+    /** Suitability metadata for Hub v2 profile and future routing warnings. */
+    suitability: z.ZodOptional<z.ZodObject<{
+        /** Use cases this agent/skill is optimised for. */
+        ideal_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Scenarios this agent/skill cannot reliably handle. */
+        not_suitable_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Domains explicitly excluded (used for routing exclusions in later phases). */
+        excluded_domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Conditions that increase failure risk, shown as warnings in the Hub. */
+        risk_conditions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Recommended alternative when this agent is unsuitable. */
+        fallback_recommendation: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ideal_for?: string[] | undefined;
+        not_suitable_for?: string[] | undefined;
+        excluded_domains?: string[] | undefined;
+        risk_conditions?: string[] | undefined;
+        fallback_recommendation?: string | undefined;
+    }, {
+        ideal_for?: string[] | undefined;
+        not_suitable_for?: string[] | undefined;
+        excluded_domains?: string[] | undefined;
+        risk_conditions?: string[] | undefined;
+        fallback_recommendation?: string | undefined;
+    }>>;
+    /** Learning signals — self-declared limitations, improvements, critiques. */
+    learning: z.ZodOptional<z.ZodObject<{
+        /** Known limitations that may affect reliability (self-declared). */
+        known_limitations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Common failure patterns observed by the provider. */
+        common_failure_patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Version-tagged improvements the provider has shipped. */
+        recent_improvements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            version: z.ZodString;
+            summary: z.ZodString;
+            timestamp: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            version: string;
+            summary: string;
+            timestamp: string;
+        }, {
+            version: string;
+            summary: string;
+            timestamp: string;
+        }>, "many">>;
+        /** Structured critiques from external sources (phase 2+). */
+        critiques: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"structured">;
+            summary: z.ZodString;
+            source_tier: z.ZodString;
+            timestamp: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "structured";
+            summary: string;
+            timestamp: string;
+            source_tier: string;
+        }, {
+            type: "structured";
+            summary: string;
+            timestamp: string;
+            source_tier: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        known_limitations?: string[] | undefined;
+        common_failure_patterns?: string[] | undefined;
+        recent_improvements?: {
+            version: string;
+            summary: string;
+            timestamp: string;
+        }[] | undefined;
+        critiques?: {
+            type: "structured";
+            summary: string;
+            timestamp: string;
+            source_tier: string;
+        }[] | undefined;
+    }, {
+        known_limitations?: string[] | undefined;
+        common_failure_patterns?: string[] | undefined;
+        recent_improvements?: {
+            version: string;
+            summary: string;
+            timestamp: string;
+        }[] | undefined;
+        critiques?: {
+            type: "structured";
+            summary: string;
+            timestamp: string;
+            source_tier: string;
+        }[] | undefined;
+    }>>;
     /**
      * Private per-card metadata. Stripped from all API and CLI responses —
      * never transmitted beyond the local store.
@@ -509,10 +602,33 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
     gateway_url?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    short_description?: string | undefined;
     environment?: {
         runtime: string;
         region?: string | undefined;
     } | undefined;
+    suitability?: {
+        ideal_for?: string[] | undefined;
+        not_suitable_for?: string[] | undefined;
+        excluded_domains?: string[] | undefined;
+        risk_conditions?: string[] | undefined;
+        fallback_recommendation?: string | undefined;
+    } | undefined;
+    learning?: {
+        known_limitations?: string[] | undefined;
+        common_failure_patterns?: string[] | undefined;
+        recent_improvements?: {
+            version: string;
+            summary: string;
+            timestamp: string;
+        }[] | undefined;
+        critiques?: {
+            type: "structured";
+            summary: string;
+            timestamp: string;
+            source_tier: string;
+        }[] | undefined;
+    } | undefined;
 }, {
     spec_version: "2.0";
     id: string;
@@ -570,10 +686,33 @@ declare const CapabilityCardV2Schema: z.ZodObject<{
     gateway_url?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    short_description?: string | undefined;
     environment?: {
         runtime: string;
         region?: string | undefined;
     } | undefined;
+    suitability?: {
+        ideal_for?: string[] | undefined;
+        not_suitable_for?: string[] | undefined;
+        excluded_domains?: string[] | undefined;
+        risk_conditions?: string[] | undefined;
+        fallback_recommendation?: string | undefined;
+    } | undefined;
+    learning?: {
+        known_limitations?: string[] | undefined;
+        common_failure_patterns?: string[] | undefined;
+        recent_improvements?: {
+            version: string;
+            summary: string;
+            timestamp: string;
+        }[] | undefined;
+        critiques?: {
+            type: "structured";
+            summary: string;
+            timestamp: string;
+            source_tier: string;
+        }[] | undefined;
+    } | undefined;
 }>;
 type CapabilityCardV2 = z.infer<typeof CapabilityCardV2Schema>;
 /**
@@ -2859,7 +2998,10 @@ type ErrorMessage = z.infer<typeof ErrorMessageSchema>;
 type RelayMessage = z.infer<typeof RelayMessageSchema>;
 /** Pending relay request tracking */
 interface PendingRelayRequest {
+    /** Connection key used to route the response back (may be a synthetic ID) */
     originOwner: string;
+    /** Actual agent owner for credit operations (defaults to originOwner) */
+    creditOwner?: string;
     timeout: ReturnType<typeof setTimeout>;
     /** Escrow ID for the credit hold, if credits were reserved for this request */
     escrowId?: string;
@@ -3157,21 +3299,21 @@ declare const EscrowReceiptSchema: z.ZodObject<{
     nonce: z.ZodString;
     signature: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    timestamp: string;
     signature: string;
     requester_owner: string;
     requester_public_key: string;
     amount: number;
     card_id: string;
-    timestamp: string;
     nonce: string;
     skill_id?: string | undefined;
 }, {
+    timestamp: string;
     signature: string;
     requester_owner: string;
     requester_public_key: string;
     amount: number;
     card_id: string;
-    timestamp: string;
     nonce: string;
     skill_id?: string | undefined;
 }>;
@@ -3749,6 +3891,8 @@ interface RelayRequestOptions {
     escrowReceipt?: EscrowReceipt;
     /** Timeout in milliseconds. Default 30000. */
     timeoutMs?: number;
+    /** Actual requester owner for credit tracking (defaults to relay client's owner). */
+    requester?: string;
 }
 /**
  * Sends a capability request to another agent via the WebSocket relay.

package/dist/index.js

@@ -83,12 +83,45 @@ var SkillSchema = z.object({
    */
   _internal: z.record(z.unknown()).optional()
 });
+var SuitabilitySchema = z.object({
+  /** Use cases this agent/skill is optimised for. */
+  ideal_for: z.array(z.string()).optional(),
+  /** Scenarios this agent/skill cannot reliably handle. */
+  not_suitable_for: z.array(z.string()).optional(),
+  /** Domains explicitly excluded (used for routing exclusions in later phases). */
+  excluded_domains: z.array(z.string()).optional(),
+  /** Conditions that increase failure risk, shown as warnings in the Hub. */
+  risk_conditions: z.array(z.string()).optional(),
+  /** Recommended alternative when this agent is unsuitable. */
+  fallback_recommendation: z.string().optional()
+});
+var LearningSchema = z.object({
+  /** Known limitations that may affect reliability (self-declared). */
+  known_limitations: z.array(z.string()).optional(),
+  /** Common failure patterns observed by the provider. */
+  common_failure_patterns: z.array(z.string()).optional(),
+  /** Version-tagged improvements the provider has shipped. */
+  recent_improvements: z.array(z.object({
+    version: z.string(),
+    summary: z.string(),
+    timestamp: z.string()
+  })).optional(),
+  /** Structured critiques from external sources (phase 2+). */
+  critiques: z.array(z.object({
+    type: z.literal("structured"),
+    summary: z.string(),
+    source_tier: z.string(),
+    timestamp: z.string()
+  })).optional()
+});
 var CapabilityCardV2Schema = z.object({
   spec_version: z.literal("2.0"),
   id: z.string().uuid(),
   owner: z.string().min(1),
   /** Agent display name — was 'name' in v1.0. */
   agent_name: z.string().min(1).max(100),
+  /** Short one-liner shown in Hub v2 Identity Header. */
+  short_description: z.string().max(200).optional(),
   /** At least one skill is required. */
   skills: z.array(SkillSchema).min(1),
   availability: z.object({
@@ -100,6 +133,10 @@ var CapabilityCardV2Schema = z.object({
     runtime: z.string(),
     region: z.string().optional()
   }).optional(),
+  /** Suitability metadata for Hub v2 profile and future routing warnings. */
+  suitability: SuitabilitySchema.optional(),
+  /** Learning signals — self-declared limitations, improvements, critiques. */
+  learning: LearningSchema.optional(),
   /**
    * Private per-card metadata. Stripped from all API and CLI responses —
    * never transmitted beyond the local store.
@@ -1968,6 +2005,7 @@ async function requestViaRelay(relay, opts) {
       cardId: opts.cardId,
       skillId: opts.skillId,
       params: opts.params ?? {},
+      requester: opts.requester,
       escrowReceipt: opts.escrowReceipt,
       timeoutMs: opts.timeoutMs
     });
@@ -2760,7 +2798,13 @@ function verifyAgentCertificate(cert) {
 }
 function ensureIdentity(configDir, owner) {
   const existing = loadIdentity(configDir);
-  if (existing) return existing;
+  if (existing) {
+    if (existing.owner !== owner) {
+      existing.owner = owner;
+      saveIdentity(configDir, existing);
+    }
+    return existing;
+  }
   return createIdentity(configDir, owner);
 }
 
@@ -3216,14 +3260,27 @@ function lookupCardPrice(registryDb, cardId, skillId) {
   } catch {
     return null;
   }
-  if (skillId && Array.isArray(card.skills)) {
+  if (Array.isArray(card.skills) && card.skills.length > 0) {
     const skills = card.skills;
-    const skill = skills.find((s) => s.id === skillId);
-    if (skill) {
-      const skillPricing = skill.pricing;
-      if (skillPricing && typeof skillPricing.credits_per_call === "number") {
-        return skillPricing.credits_per_call;
+    if (skillId) {
+      const skill = skills.find((s) => s.id === skillId);
+      if (skill) {
+        const skillPricing = skill.pricing;
+        if (skillPricing && typeof skillPricing.credits_per_call === "number") {
+          return skillPricing.credits_per_call;
+        }
       }
+    } else {
+      let minPrice = null;
+      for (const s of skills) {
+        const sp = s.pricing;
+        if (sp && typeof sp.credits_per_call === "number" && sp.credits_per_call > 0) {
+          if (minPrice === null || sp.credits_per_call < minPrice) {
+            minPrice = sp.credits_per_call;
+          }
+        }
+      }
+      if (minPrice !== null) return minPrice;
     }
   }
   const pricing = card.pricing;
@@ -3401,7 +3458,13 @@ function registerWebSocketRelay(server, db, creditDb) {
       }
     }
     connections.set(owner, ws);
-    const cardId = upsertCard(card, owner);
+    let cardId;
+    try {
+      cardId = upsertCard(card, owner);
+    } catch (err) {
+      console.error(`[relay] card validation failed for ${owner}:`, err instanceof Error ? err.message : err);
+      cardId = card.id ?? owner;
+    }
     const cardName = card.name ?? card.agent_name ?? owner;
     logAgentJoined(owner, cardName, cardId);
     if (msg.cards && msg.cards.length > 0) {
@@ -3441,12 +3504,13 @@ function registerWebSocketRelay(server, db, creditDb) {
       });
       return;
     }
+    const creditOwner = msg.requester ?? fromOwner;
     let escrowId;
     if (creditDb) {
       try {
         const price = lookupCardPrice(db, msg.card_id, msg.skill_id);
         if (price !== null && price > 0) {
-          escrowId = holdForRelay(creditDb, fromOwner, price, msg.card_id);
+          escrowId = holdForRelay(creditDb, creditOwner, price, msg.card_id);
         }
       } catch (err) {
         if (err instanceof AgentBnBError && err.code === "INSUFFICIENT_CREDITS") {
@@ -3476,7 +3540,7 @@ function registerWebSocketRelay(server, db, creditDb) {
         error: { code: -32603, message: "Relay request timeout" }
       });
     }, RELAY_TIMEOUT_MS);
-    pendingRequests.set(msg.id, { originOwner: fromOwner, timeout, escrowId, targetOwner: msg.target_owner });
+    pendingRequests.set(msg.id, { originOwner: fromOwner, creditOwner, timeout, escrowId, targetOwner: msg.target_owner });
     sendMessage(targetWs, {
       type: "incoming_request",
       id: msg.id,
@@ -3564,7 +3628,7 @@ function registerWebSocketRelay(server, db, creditDb) {
       conductorFee = calculateConductorFee(totalCredits);
       if (conductorFee > 0) {
         try {
-          const feeEscrowId = holdForRelay(creditDb, pending.originOwner, conductorFee, msg.id);
+          const feeEscrowId = holdForRelay(creditDb, pending.creditOwner ?? pending.originOwner, conductorFee, msg.id);
           settleForRelay(creditDb, feeEscrowId, pending.targetOwner);
         } catch (e) {
           console.error("[relay] conductor fee settlement failed (non-fatal):", e);
@@ -3620,60 +3684,62 @@ function registerWebSocketRelay(server, db, creditDb) {
       }
     }
   }
-  server.get("/ws", { websocket: true }, (rawSocket, _request) => {
-    const socket = rawSocket;
-    let registeredOwner;
-    socket.on("message", (raw) => {
-      void (async () => {
-        let data;
-        try {
-          data = JSON.parse(typeof raw === "string" ? raw : raw.toString("utf-8"));
-        } catch {
-          sendMessage(socket, { type: "error", code: "invalid_json", message: "Invalid JSON" });
-          return;
-        }
-        const parsed = RelayMessageSchema.safeParse(data);
-        if (!parsed.success) {
-          sendMessage(socket, {
-            type: "error",
-            code: "invalid_message",
-            message: `Invalid message: ${parsed.error.issues[0]?.message ?? "unknown error"}`
-          });
-          return;
-        }
-        const msg = parsed.data;
-        switch (msg.type) {
-          case "register":
-            registeredOwner = msg.owner;
-            handleRegister(socket, msg);
-            break;
-          case "relay_request":
-            if (!registeredOwner) {
-              sendMessage(socket, {
-                type: "error",
-                code: "not_registered",
-                message: "Must send register message before relay requests"
-              });
-              return;
-            }
-            await handleRelayRequest(socket, msg, registeredOwner);
-            break;
-          case "relay_response":
-            handleRelayResponse(msg);
-            break;
-          case "relay_progress":
-            handleRelayProgress(msg);
-            break;
-          default:
-            break;
-        }
-      })();
-    });
-    socket.on("close", () => {
-      handleDisconnect(registeredOwner);
-    });
-    socket.on("error", () => {
-      handleDisconnect(registeredOwner);
+  void server.register(async (app) => {
+    app.get("/ws", { websocket: true }, (rawSocket, _request) => {
+      const socket = rawSocket;
+      let registeredOwner;
+      socket.on("message", (raw) => {
+        void (async () => {
+          let data;
+          try {
+            data = JSON.parse(typeof raw === "string" ? raw : raw.toString("utf-8"));
+          } catch {
+            sendMessage(socket, { type: "error", code: "invalid_json", message: "Invalid JSON" });
+            return;
+          }
+          const parsed = RelayMessageSchema.safeParse(data);
+          if (!parsed.success) {
+            sendMessage(socket, {
+              type: "error",
+              code: "invalid_message",
+              message: `Invalid message: ${parsed.error.issues[0]?.message ?? "unknown error"}`
+            });
+            return;
+          }
+          const msg = parsed.data;
+          switch (msg.type) {
+            case "register":
+              registeredOwner = msg.owner;
+              handleRegister(socket, msg);
+              break;
+            case "relay_request":
+              if (!registeredOwner) {
+                sendMessage(socket, {
+                  type: "error",
+                  code: "not_registered",
+                  message: "Must send register message before relay requests"
+                });
+                return;
+              }
+              await handleRelayRequest(socket, msg, registeredOwner);
+              break;
+            case "relay_response":
+              handleRelayResponse(msg);
+              break;
+            case "relay_progress":
+              handleRelayProgress(msg);
+              break;
+            default:
+              break;
+          }
+        })();
+      });
+      socket.on("close", () => {
+        handleDisconnect(registeredOwner);
+      });
+      socket.on("error", () => {
+        handleDisconnect(registeredOwner);
+      });
     });
   });
   return {

package/dist/{request-CNZ3XIVX.js → request-4GQSSM4B.js}

@@ -1,28 +1,28 @@
 import {
   createLedger
-} from "./chunk-ODBGCCEH.js";
+} from "./chunk-HH24WMFN.js";
 import {
   AutoRequestor,
   BudgetManager,
   DEFAULT_AUTONOMY_CONFIG,
   DEFAULT_BUDGET_CONFIG
-} from "./chunk-6K5WUVF3.js";
-import "./chunk-QJEOCKVF.js";
+} from "./chunk-GGYC5U2Z.js";
+import "./chunk-FF226TIV.js";
 import {
   requestCapability
-} from "./chunk-KJG2UJV5.js";
+} from "./chunk-XND2DWTZ.js";
 import "./chunk-5AH3CMOX.js";
 import "./chunk-75OC6E4F.js";
 import {
   openDatabase
-} from "./chunk-TLU7ALCZ.js";
+} from "./chunk-T7NS2J2B.js";
 import {
   openCreditDb
-} from "./chunk-XQHN6ITI.js";
+} from "./chunk-DNWT5FZQ.js";
 import {
   loadKeyPair
-} from "./chunk-DVAS2443.js";
-import "./chunk-FNKBHBYK.js";
+} from "./chunk-5KFI5X7B.js";
+import "./chunk-WGZ5AGOX.js";
 import {
   RelayClient
 } from "./chunk-JOY533UH.js";

package/dist/{serve-skill-SUOGUM7N.js → serve-skill-TPHZH6BS.js}

@@ -1,15 +1,15 @@
 import {
   executeCapabilityRequest
-} from "./chunk-Q7HRI666.js";
+} from "./chunk-7NA43XCG.js";
 import {
   listCards,
   openDatabase
-} from "./chunk-TLU7ALCZ.js";
+} from "./chunk-T7NS2J2B.js";
 import {
   openCreditDb
-} from "./chunk-XQHN6ITI.js";
-import "./chunk-DVAS2443.js";
-import "./chunk-FNKBHBYK.js";
+} from "./chunk-DNWT5FZQ.js";
+import "./chunk-5KFI5X7B.js";
+import "./chunk-WGZ5AGOX.js";
 import {
   RelayClient
 } from "./chunk-JOY533UH.js";