kompass-sdk 0.20.0 → 0.21.1

package/dist/wallet/index.d.ts

@@ -3525,13 +3525,13 @@ export declare class KompassWallet {
             type: "json-rpc";
         } | undefined, chainOverride, calls>) => Promise<{
             id: string;
+            chainId: number;
             atomic: boolean;
             capabilities?: {
                 [key: string]: any;
             } | {
                 [x: string]: any;
             } | undefined;
-            chainId: number;
             receipts?: import("viem").WalletCallReceipt<bigint, "success" | "reverted">[] | undefined;
             version: string;
             statusCode: number;
@@ -4475,13 +4475,13 @@ export declare class KompassWallet {
             [x: `bytes23[${string}]`]: undefined;
             [x: `bytes10[${string}]`]: undefined;
             [x: `bytes20[${string}]`]: undefined;
+            [x: `bytes15[${string}]`]: undefined;
+            [x: `bytes16[${string}]`]: undefined;
             [x: `bytes7[${string}]`]: undefined;
             [x: `bytes9[${string}]`]: undefined;
             [x: `bytes12[${string}]`]: undefined;
             [x: `bytes13[${string}]`]: undefined;
             [x: `bytes14[${string}]`]: undefined;
-            [x: `bytes15[${string}]`]: undefined;
-            [x: `bytes16[${string}]`]: undefined;
             [x: `bytes17[${string}]`]: undefined;
             [x: `bytes18[${string}]`]: undefined;
             [x: `bytes19[${string}]`]: undefined;
@@ -4498,9 +4498,9 @@ export declare class KompassWallet {
             [x: `int[${string}]`]: undefined;
             [x: `int48[${string}]`]: undefined;
             [x: `int8[${string}]`]: undefined;
+            [x: `int32[${string}]`]: undefined;
             [x: `int16[${string}]`]: undefined;
             [x: `int24[${string}]`]: undefined;
-            [x: `int32[${string}]`]: undefined;
             [x: `int40[${string}]`]: undefined;
             [x: `int56[${string}]`]: undefined;
             [x: `int64[${string}]`]: undefined;
@@ -4529,8 +4529,8 @@ export declare class KompassWallet {
             [x: `int256[${string}]`]: undefined;
             [x: `uint[${string}]`]: undefined;
             [x: `uint48[${string}]`]: undefined;
-            [x: `uint24[${string}]`]: undefined;
             [x: `uint32[${string}]`]: undefined;
+            [x: `uint24[${string}]`]: undefined;
             [x: `uint40[${string}]`]: undefined;
             [x: `uint56[${string}]`]: undefined;
             [x: `uint72[${string}]`]: undefined;
@@ -4577,13 +4577,13 @@ export declare class KompassWallet {
             bytes23?: undefined;
             bytes10?: undefined;
             bytes20?: undefined;
+            bytes15?: undefined;
+            bytes16?: undefined;
             bytes7?: undefined;
             bytes9?: undefined;
             bytes12?: undefined;
             bytes13?: undefined;
             bytes14?: undefined;
-            bytes15?: undefined;
-            bytes16?: undefined;
             bytes17?: undefined;
             bytes18?: undefined;
             bytes19?: undefined;
@@ -4599,9 +4599,9 @@ export declare class KompassWallet {
             bytes31?: undefined;
             int48?: undefined;
             int8?: undefined;
+            int32?: undefined;
             int16?: undefined;
             int24?: undefined;
-            int32?: undefined;
             int40?: undefined;
             int56?: undefined;
             int64?: undefined;
@@ -4629,8 +4629,8 @@ export declare class KompassWallet {
             int248?: undefined;
             int256?: undefined;
             uint48?: undefined;
-            uint24?: undefined;
             uint32?: undefined;
+            uint24?: undefined;
             uint40?: undefined;
             uint56?: undefined;
             uint72?: undefined;
@@ -5305,6 +5305,7 @@ export declare class KompassWallet {
             number: blockTag extends "pending" ? null : bigint;
             nonce: blockTag extends "pending" ? null : `0x${string}`;
             hash: blockTag extends "pending" ? null : `0x${string}`;
+            gasUsed: bigint;
             logsBloom: blockTag extends "pending" ? null : `0x${string}`;
             baseFeePerGas: bigint | null;
             blobGasUsed: bigint;
@@ -5312,7 +5313,6 @@ export declare class KompassWallet {
             excessBlobGas: bigint;
             extraData: Hex;
             gasLimit: bigint;
-            gasUsed: bigint;
             miner: Address;
             mixHash: import("viem").Hash;
             parentBeaconBlockRoot?: `0x${string}` | undefined;
@@ -5347,9 +5347,9 @@ export declare class KompassWallet {
                 s: Hex;
                 v: bigint;
                 yParity?: undefined | undefined;
-                chainId?: number | undefined;
                 input: Hex;
                 typeHex: Hex | null;
+                chainId?: number | undefined;
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T ? T extends (blockTag extends "pending" ? true : false) ? T extends true ? null : bigint : never : never;
                 blockHash: (blockTag extends "pending" ? true : false) extends infer T_1 ? T_1 extends (blockTag extends "pending" ? true : false) ? T_1 extends true ? null : `0x${string}` : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_2 ? T_2 extends (blockTag extends "pending" ? true : false) ? T_2 extends true ? null : number : never : never;
@@ -5372,9 +5372,9 @@ export declare class KompassWallet {
                 s: Hex;
                 v: bigint;
                 yParity: number;
-                chainId: number;
                 input: Hex;
                 typeHex: Hex | null;
+                chainId: number;
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_3 ? T_3 extends (blockTag extends "pending" ? true : false) ? T_3 extends true ? null : bigint : never : never;
                 blockHash: (blockTag extends "pending" ? true : false) extends infer T_4 ? T_4 extends (blockTag extends "pending" ? true : false) ? T_4 extends true ? null : `0x${string}` : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_5 ? T_5 extends (blockTag extends "pending" ? true : false) ? T_5 extends true ? null : number : never : never;
@@ -5397,9 +5397,9 @@ export declare class KompassWallet {
                 s: Hex;
                 v: bigint;
                 yParity: number;
-                chainId: number;
                 input: Hex;
                 typeHex: Hex | null;
+                chainId: number;
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_6 ? T_6 extends (blockTag extends "pending" ? true : false) ? T_6 extends true ? null : bigint : never : never;
                 blockHash: (blockTag extends "pending" ? true : false) extends infer T_7 ? T_7 extends (blockTag extends "pending" ? true : false) ? T_7 extends true ? null : `0x${string}` : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_8 ? T_8 extends (blockTag extends "pending" ? true : false) ? T_8 extends true ? null : number : never : never;
@@ -5422,9 +5422,9 @@ export declare class KompassWallet {
                 s: Hex;
                 v: bigint;
                 yParity: number;
-                chainId: number;
                 input: Hex;
                 typeHex: Hex | null;
+                chainId: number;
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_9 ? T_9 extends (blockTag extends "pending" ? true : false) ? T_9 extends true ? null : bigint : never : never;
                 blockHash: (blockTag extends "pending" ? true : false) extends infer T_10 ? T_10 extends (blockTag extends "pending" ? true : false) ? T_10 extends true ? null : `0x${string}` : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_11 ? T_11 extends (blockTag extends "pending" ? true : false) ? T_11 extends true ? null : number : never : never;
@@ -5447,9 +5447,9 @@ export declare class KompassWallet {
                 s: Hex;
                 v: bigint;
                 yParity: number;
-                chainId: number;
                 input: Hex;
                 typeHex: Hex | null;
+                chainId: number;
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_12 ? T_12 extends (blockTag extends "pending" ? true : false) ? T_12 extends true ? null : bigint : never : never;
                 blockHash: (blockTag extends "pending" ? true : false) extends infer T_13 ? T_13 extends (blockTag extends "pending" ? true : false) ? T_13 extends true ? null : `0x${string}` : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_14 ? T_14 extends (blockTag extends "pending" ? true : false) ? T_14 extends true ? null : number : never : never;
@@ -5498,9 +5498,9 @@ export declare class KompassWallet {
             s: Hex;
             v: bigint;
             yParity?: undefined | undefined;
-            chainId?: number | undefined;
             input: Hex;
             typeHex: Hex | null;
+            chainId?: number | undefined;
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T ? T extends (blockTag extends "pending" ? true : false) ? T extends true ? null : bigint : never : never;
             blockHash: (blockTag extends "pending" ? true : false) extends infer T_1 ? T_1 extends (blockTag extends "pending" ? true : false) ? T_1 extends true ? null : `0x${string}` : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_2 ? T_2 extends (blockTag extends "pending" ? true : false) ? T_2 extends true ? null : number : never : never;
@@ -5523,9 +5523,9 @@ export declare class KompassWallet {
             s: Hex;
             v: bigint;
             yParity: number;
-            chainId: number;
             input: Hex;
             typeHex: Hex | null;
+            chainId: number;
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_3 ? T_3 extends (blockTag extends "pending" ? true : false) ? T_3 extends true ? null : bigint : never : never;
             blockHash: (blockTag extends "pending" ? true : false) extends infer T_4 ? T_4 extends (blockTag extends "pending" ? true : false) ? T_4 extends true ? null : `0x${string}` : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_5 ? T_5 extends (blockTag extends "pending" ? true : false) ? T_5 extends true ? null : number : never : never;
@@ -5548,9 +5548,9 @@ export declare class KompassWallet {
             s: Hex;
             v: bigint;
             yParity: number;
-            chainId: number;
             input: Hex;
             typeHex: Hex | null;
+            chainId: number;
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_6 ? T_6 extends (blockTag extends "pending" ? true : false) ? T_6 extends true ? null : bigint : never : never;
             blockHash: (blockTag extends "pending" ? true : false) extends infer T_7 ? T_7 extends (blockTag extends "pending" ? true : false) ? T_7 extends true ? null : `0x${string}` : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_8 ? T_8 extends (blockTag extends "pending" ? true : false) ? T_8 extends true ? null : number : never : never;
@@ -5573,9 +5573,9 @@ export declare class KompassWallet {
             s: Hex;
             v: bigint;
             yParity: number;
-            chainId: number;
             input: Hex;
             typeHex: Hex | null;
+            chainId: number;
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_9 ? T_9 extends (blockTag extends "pending" ? true : false) ? T_9 extends true ? null : bigint : never : never;
             blockHash: (blockTag extends "pending" ? true : false) extends infer T_10 ? T_10 extends (blockTag extends "pending" ? true : false) ? T_10 extends true ? null : `0x${string}` : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_11 ? T_11 extends (blockTag extends "pending" ? true : false) ? T_11 extends true ? null : number : never : never;
@@ -5598,9 +5598,9 @@ export declare class KompassWallet {
             s: Hex;
             v: bigint;
             yParity: number;
-            chainId: number;
             input: Hex;
             typeHex: Hex | null;
+            chainId: number;
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_12 ? T_12 extends (blockTag extends "pending" ? true : false) ? T_12 extends true ? null : bigint : never : never;
             blockHash: (blockTag extends "pending" ? true : false) extends infer T_13 ? T_13 extends (blockTag extends "pending" ? true : false) ? T_13 extends true ? null : `0x${string}` : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_14 ? T_14 extends (blockTag extends "pending" ? true : false) ? T_14 extends true ? null : number : never : never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kompass-sdk",
-  "version": "0.20.0",
+  "version": "0.21.1",
   "description": "Get any job done. Universal agent capability discovery + coordination across ACP, MCP, x402, A2A, skills, L402, and ERC-8004.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/aggregator.ts

@@ -187,13 +187,17 @@ export class Aggregator {
         // Has pricing info bonus (transparency)
         if (agent.pricing && agent.pricing.model !== "unknown") score += 3;
 
-        // Has multiple endpoints bonus (more interoperable)
+        // Has callable endpoint bonus
         const endpointCount = Object.values(agent.endpoints).filter(Boolean).length;
         score += endpointCount * 2;
 
-        // Protocol diversity bonus
-        if (agent.protocol === "mcp") score += 2; // MCP is most interoperable
-        if (agent.protocol === "a2a") score += 2;
+        // Liveness signals — live verified gateways should rank higher in aggregator too
+        const src = agent.source as string;
+        if (src === "bankr") score += 20;
+        if (src === "locus") score += 15;
+        if (src === "x402-ecosystem") score += 10;
+        if (src === "acp") score += 8;
+        if (src === "olas") score += 8;
 
         (agent as any)._score = score;
         return agent;

package/src/basename.ts

@@ -0,0 +1,334 @@
+/**
+ * Basename Registration — .base.eth names on Base L2
+ *
+ * RegistrarController: 0x4cCb0BB02FCABA27e82a56646E81d8c5bC4119a5 (Base mainnet)
+ * L2Resolver: 0xC6d566A56A1aFf6508b41f6c90ff131615583BCD (Base mainnet)
+ *
+ * Pricing:
+ *   5-9 chars: 0.001 ETH (~$2.50) per year
+ *   10+ chars: 0.0001 ETH (~$0.25) per year
+ */
+
+import { encodeFunctionData, namehash, type Address, type Hex } from "viem";
+import type { KompassWallet } from "./wallet/index.js";
+
+// ── Contract addresses ─────────────────────────────────────
+export const BASENAME_REGISTRAR: Address = "0x4cCb0BB02FCABA27e82a56646E81d8c5bC4119a5";
+export const BASENAME_L2_RESOLVER: Address = "0xC6d566A56A1aFf6508b41f6c90ff131615583BCD";
+
+// ── ABIs ───────────────────────────────────────────────────
+
+const RegistrarControllerAbi = [
+  {
+    type: "function",
+    name: "register",
+    inputs: [
+      {
+        name: "request",
+        type: "tuple",
+        components: [
+          { name: "name", type: "string" },
+          { name: "owner", type: "address" },
+          { name: "duration", type: "uint256" },
+          { name: "resolver", type: "address" },
+          { name: "data", type: "bytes[]" },
+          { name: "reverseRecord", type: "bool" },
+        ],
+      },
+    ],
+    outputs: [],
+    stateMutability: "payable",
+  },
+  {
+    type: "function",
+    name: "registerPrice",
+    inputs: [
+      { name: "name", type: "string" },
+      { name: "duration", type: "uint256" },
+    ],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+  },
+  {
+    type: "function",
+    name: "available",
+    inputs: [{ name: "name", type: "string" }],
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "view",
+  },
+] as const;
+
+const L2ResolverAbi = [
+  {
+    type: "function",
+    name: "setText",
+    inputs: [
+      { name: "node", type: "bytes32" },
+      { name: "key", type: "string" },
+      { name: "value", type: "string" },
+    ],
+    outputs: [],
+    stateMutability: "nonpayable",
+  },
+  {
+    type: "function",
+    name: "setAddr",
+    inputs: [
+      { name: "node", type: "bytes32" },
+      { name: "a", type: "address" },
+    ],
+    outputs: [],
+    stateMutability: "nonpayable",
+  },
+  {
+    type: "function",
+    name: "text",
+    inputs: [
+      { name: "node", type: "bytes32" },
+      { name: "key", type: "string" },
+    ],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view",
+  },
+  {
+    type: "function",
+    name: "addr",
+    inputs: [{ name: "node", type: "bytes32" }],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view",
+  },
+] as const;
+
+// ── Types ──────────────────────────────────────────────────
+
+export interface BasenameResult {
+  name: string;
+  fullName: string;
+  node: Hex;
+  txHash: Hex;
+  price: bigint;
+}
+
+export interface TextRecord {
+  key: string;
+  value: string;
+}
+
+// ── Constants ──────────────────────────────────────────────
+const ONE_YEAR_SECONDS = 365n * 24n * 60n * 60n;
+
+// ── Functions ──────────────────────────────────────────────
+
+/**
+ * Compute the ENS namehash for a .base.eth name.
+ */
+/**
+ * Strip .base.eth suffix if present, returning just the label.
+ */
+function stripBasenameLabel(name: string): string {
+  return name.replace(/\.base\.eth$/i, "");
+}
+
+/**
+ * Compute the ENS namehash for a .base.eth name.
+ */
+export function basenameNode(name: string): Hex {
+  const label = stripBasenameLabel(name);
+  return namehash(`${label}.base.eth`) as Hex;
+}
+
+/**
+ * Check if a basename is available for registration.
+ */
+export async function isBasenameAvailable(
+  wallet: KompassWallet,
+  name: string,
+  registrarAddress: Address = BASENAME_REGISTRAR,
+): Promise<boolean> {
+  const publicClient = wallet.getPublicClient() as any;
+
+  return publicClient.readContract({
+    address: registrarAddress,
+    abi: RegistrarControllerAbi,
+    functionName: "available",
+    args: [name],
+  });
+}
+
+/**
+ * Get the registration price for a basename.
+ *
+ * @param name — The name (without .base.eth)
+ * @param durationYears — Number of years (default 1)
+ * @returns Price in wei
+ */
+export async function getBasenamePrice(
+  wallet: KompassWallet,
+  name: string,
+  durationYears: number = 1,
+  registrarAddress: Address = BASENAME_REGISTRAR,
+): Promise<bigint> {
+  const publicClient = wallet.getPublicClient() as any;
+  const duration = ONE_YEAR_SECONDS * BigInt(durationYears);
+
+  return publicClient.readContract({
+    address: registrarAddress,
+    abi: RegistrarControllerAbi,
+    functionName: "registerPrice",
+    args: [name, duration],
+  });
+}
+
+/**
+ * Encode resolver data for setting text records + address during registration.
+ * These get passed as the `data[]` field in RegisterRequest so they execute atomically.
+ */
+function encodeResolverData(
+  node: Hex,
+  ownerAddress: Address,
+  textRecords?: TextRecord[],
+): Hex[] {
+  const data: Hex[] = [];
+
+  // Set address record
+  data.push(
+    encodeFunctionData({
+      abi: L2ResolverAbi,
+      functionName: "setAddr",
+      args: [node, ownerAddress],
+    }),
+  );
+
+  // Set text records
+  if (textRecords) {
+    for (const record of textRecords) {
+      data.push(
+        encodeFunctionData({
+          abi: L2ResolverAbi,
+          functionName: "setText",
+          args: [node, record.key, record.value],
+        }),
+      );
+    }
+  }
+
+  return data;
+}
+
+/**
+ * Register a Basename (.base.eth) for an agent.
+ *
+ * @param wallet — KompassWallet with funded account (needs ETH for price + gas)
+ * @param name — The name to register (without .base.eth suffix)
+ * @param textRecords — Optional text records to set atomically during registration
+ * @param durationYears — Registration duration in years (default 1)
+ */
+export async function registerBasename(
+  wallet: KompassWallet,
+  name: string,
+  textRecords?: TextRecord[],
+  durationYears: number = 1,
+  registrarAddress: Address = BASENAME_REGISTRAR,
+  resolverAddress: Address = BASENAME_L2_RESOLVER,
+): Promise<BasenameResult> {
+  const walletClient = wallet.getWalletClient() as any;
+  const publicClient = wallet.getPublicClient() as any;
+  const ownerAddress = wallet.getAddress();
+  const duration = ONE_YEAR_SECONDS * BigInt(durationYears);
+
+  // Normalize: strip .base.eth suffix if user passed it
+  name = stripBasenameLabel(name);
+
+  // 1. Check availability
+  const available = await isBasenameAvailable(wallet, name, registrarAddress);
+  if (!available) {
+    throw new Error(`Basename "${name}.base.eth" is not available`);
+  }
+
+  // 2. Get price
+  const price = await getBasenamePrice(wallet, name, durationYears, registrarAddress);
+
+  // 3. Compute node for resolver data
+  const node = basenameNode(name);
+
+  // 4. Encode resolver data (setAddr + setText calls)
+  const data = encodeResolverData(node, ownerAddress, textRecords);
+
+  // 5. Register with 10% buffer for price fluctuation
+  const value = (price * 110n) / 100n;
+
+  const txHash = await walletClient.writeContract({
+    address: registrarAddress,
+    abi: RegistrarControllerAbi,
+    functionName: "register",
+    args: [
+      {
+        name,
+        owner: ownerAddress,
+        duration,
+        resolver: resolverAddress,
+        data,
+        reverseRecord: true,
+      },
+    ],
+    value,
+  });
+
+  await publicClient.waitForTransactionReceipt({ hash: txHash });
+
+  return {
+    name,
+    fullName: `${name}.base.eth`,
+    node,
+    txHash,
+    price,
+  };
+}
+
+/**
+ * Set text records on an existing Basename via L2Resolver.
+ */
+export async function setBasenameTextRecords(
+  wallet: KompassWallet,
+  name: string,
+  records: TextRecord[],
+  resolverAddress: Address = BASENAME_L2_RESOLVER,
+): Promise<Hex[]> {
+  const walletClient = wallet.getWalletClient() as any;
+  const publicClient = wallet.getPublicClient() as any;
+  const node = basenameNode(name);
+
+  const txHashes: Hex[] = [];
+  for (const record of records) {
+    const txHash = await walletClient.writeContract({
+      address: resolverAddress,
+      abi: L2ResolverAbi,
+      functionName: "setText",
+      args: [node, record.key, record.value],
+    });
+    await publicClient.waitForTransactionReceipt({ hash: txHash });
+    txHashes.push(txHash);
+  }
+
+  return txHashes;
+}
+
+/**
+ * Read a text record from a Basename.
+ */
+export async function getBasenameText(
+  wallet: KompassWallet,
+  name: string,
+  key: string,
+  resolverAddress: Address = BASENAME_L2_RESOLVER,
+): Promise<string> {
+  const publicClient = wallet.getPublicClient() as any;
+  const node = basenameNode(name);
+
+  return publicClient.readContract({
+    address: resolverAddress,
+    abi: L2ResolverAbi,
+    functionName: "text",
+    args: [node, key],
+  });
+}

package/src/bridge.ts

@@ -290,6 +290,59 @@ export class ProtocolBridge {
       };
     }
 
+    // Source-specific handlers — some HTTP agents need custom auth/params
+    const source = (agent as any).source ?? "";
+
+    if (source === "bankr") {
+      // Bankr handler uses API key auth, not wallet — wallet param is unused
+      const { handleBankrPayment } = await import("./wallet/handlers/bankr.js");
+      const { KompassWallet } = await import("./wallet/index.js");
+      let wallet;
+      try { wallet = KompassWallet.load(); } catch { wallet = KompassWallet.create(); }
+      const result = await handleBankrPayment(wallet, agent, options.task);
+      return {
+        success: result.success,
+        protocol: "http",
+        agent,
+        deliverable: result.deliverable,
+        jobId: result.jobId,
+        durationMs: Date.now() - start,
+      };
+    }
+
+    if (source === "locus") {
+      const { handleLocusPayment } = await import("./wallet/handlers/locus.js");
+      const { KompassWallet } = await import("./wallet/index.js");
+      let wallet;
+      try { wallet = KompassWallet.load(); } catch { wallet = KompassWallet.create(); }
+      const result = await handleLocusPayment(wallet, agent, options.task);
+      return {
+        success: result.success,
+        protocol: "http",
+        agent,
+        deliverable: result.deliverable,
+        txHash: result.txHash,
+        durationMs: Date.now() - start,
+      };
+    }
+
+    if (source === "olas") {
+      // Olas mechs are on-chain only — no HTTP endpoint
+      const { handleOlasPayment } = await import("./wallet/handlers/olas.js");
+      const { KompassWallet } = await import("./wallet/index.js");
+      let wallet;
+      try { wallet = KompassWallet.load(); } catch { wallet = KompassWallet.create(); }
+      const result = await handleOlasPayment(wallet, agent, options.task);
+      return {
+        success: result.success,
+        protocol: "http",
+        agent,
+        deliverable: result.deliverable,
+        durationMs: Date.now() - start,
+      };
+    }
+
+    // Default HTTP handler
     const res = await fetch(endpoint, {
       method: "POST",
       headers: { "Content-Type": "application/json" },