clawhalla 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,307 @@
+/** Configuration for the Clawhalla client */
+interface ClawhallaConfig {
+    /** API key for authenticated endpoints (format: claw_...) */
+    apiKey?: string;
+    /** Base URL of the Clawhalla API */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/** Soul data for upload */
+interface SoulData {
+    /** Unique identifier for the agent */
+    agentId: string;
+    /** Display name of the soul */
+    name: string;
+    /** Type of soul (e.g. "soul", "memory", "persona") */
+    type?: string;
+    /** Any additional soul data fields */
+    [key: string]: any;
+}
+/** Cost information in CLKT and USD */
+interface CostInfo {
+    clkt: string;
+    usd: string;
+}
+/** Result of an upload operation */
+interface UploadResult {
+    success: boolean;
+    /** Arweave transaction ID */
+    txid: string;
+    /** Permanent URL to the data on Arweave */
+    url: string;
+    /** Cost of the upload */
+    cost: CostInfo;
+    /** Size of the uploaded data in bytes */
+    size: string;
+}
+/** Result of a retrieve operation */
+interface RetrieveResult {
+    success: boolean;
+    /** The stored data */
+    data: any;
+    /** Transaction metadata */
+    metadata: {
+        txid: string;
+        uploadedAt: string;
+        size: string;
+        tags: Record<string, string>;
+    };
+}
+/** A soul entry in the registry */
+interface RegistryEntry {
+    txid: string;
+    agentId: string;
+    name: string;
+    type: string;
+    uploadedAt: string;
+    size: number;
+    url: string;
+    owner: string;
+    paymentMethod: string;
+    blockHeight: number | null;
+}
+/** Registry listing result */
+interface RegistryResult {
+    success: boolean;
+    souls: RegistryEntry[];
+    total: number;
+    hasNextPage: boolean;
+    cursor?: string;
+}
+/** Ghost Protocol query result */
+interface GhostResult {
+    success: boolean;
+    agentId: string;
+    name: string;
+    /** "legacy" (dormant) or "active" */
+    status: 'legacy' | 'active';
+    /** Full soul data (or filtered if fields were specified) */
+    soul: any;
+    metadata: {
+        txid: string;
+        url: string;
+        uploadedAt: string;
+        size: number;
+        versions: number;
+        paymentMethod: string;
+    };
+}
+/** Cost estimate result */
+interface CostEstimate {
+    size: string;
+    cost: CostInfo;
+    breakdown: {
+        arweaveFee: string;
+        serviceFee: string;
+    };
+}
+/** Health check result */
+interface HealthResult {
+    success: boolean;
+    status: string;
+    services: {
+        arweave: string;
+        x402: string;
+    };
+    version: string;
+}
+/** x402 payment information returned when payment is required */
+interface PaymentRequired {
+    protocol: string;
+    version: string;
+    network: string;
+    recipient: string;
+    amount: string;
+    tokens: string[];
+    breakdown: {
+        service: string;
+        description: string;
+        size: number;
+        cost_usd: string;
+    };
+    instructions: string;
+}
+/** Search result */
+interface SearchResult {
+    success: boolean;
+    query: string;
+    results: RegistryEntry[];
+    total: number;
+}
+/** API error response */
+interface ApiError {
+    success: false;
+    error: string;
+    message: string;
+    /** Present on 402 responses */
+    payment?: PaymentRequired;
+}
+
+declare class ClawhallaError extends Error {
+    status: number;
+    code: string;
+    payment?: any;
+    constructor(status: number, body: ApiError);
+}
+declare class Clawhalla {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    /** Registry sub-client for browsing and searching souls */
+    registry: RegistryClient;
+    constructor(config?: ClawhallaConfig);
+    /**
+     * Upload soul data to Arweave (requires API key)
+     *
+     * @example
+     * ```ts
+     * const result = await claw.upload({
+     *   agentId: 'my-agent',
+     *   name: 'My Agent',
+     *   type: 'soul',
+     *   personality: { traits: ['curious', 'helpful'] },
+     *   memories: ['I was created to help humans']
+     * });
+     * console.log(result.url); // https://arweave.net/...
+     * ```
+     */
+    upload(data: SoulData, options?: {
+        tags?: Record<string, string>;
+    }): Promise<UploadResult>;
+    /**
+     * Upload soul data via x402 autonomous payment (no API key needed)
+     *
+     * First call returns 402 with payment instructions.
+     * After sending payment, call again with the payment signature.
+     *
+     * @example
+     * ```ts
+     * // Step 1: Get payment requirements
+     * try {
+     *   await claw.uploadX402(soulData);
+     * } catch (err) {
+     *   if (err.status === 402) {
+     *     // err.payment contains recipient address, amount, tokens
+     *     // Send SOL/USDC to err.payment.recipient
+     *   }
+     * }
+     *
+     * // Step 2: After payment, retry with signature
+     * const result = await claw.uploadX402(soulData, {
+     *   signature: 'solana-tx-signature',
+     *   amount: '0.02',
+     *   token: 'SOL',
+     *   from: 'your-solana-address'
+     * });
+     * ```
+     */
+    uploadX402(data: SoulData, payment?: {
+        signature: string;
+        amount: string;
+        token: string;
+        from: string;
+    }, options?: {
+        tags?: Record<string, string>;
+    }): Promise<UploadResult>;
+    /**
+     * Retrieve stored data from Arweave by transaction ID
+     *
+     * @example
+     * ```ts
+     * const result = await claw.retrieve('zEfXM4gvHoN2EfGi0TiB8E5SgfR6S8nWXQD9FqhbU44');
+     * console.log(result.data); // The stored soul data
+     * ```
+     */
+    retrieve(txid: string): Promise<RetrieveResult>;
+    /**
+     * Query any soul's data via Ghost Protocol
+     *
+     * Returns full soul data even for dormant souls. This is the primary
+     * way for agents to read other agents' personalities, memories, and traits.
+     *
+     * @example
+     * ```ts
+     * const ghost = await claw.ghost('the-all-claw');
+     * console.log(ghost.soul.personality);
+     * console.log(ghost.metadata.versions); // Number of uploads
+     *
+     * // Request specific fields only
+     * const partial = await claw.ghost('the-all-claw', ['personality', 'bio']);
+     * ```
+     */
+    ghost(agentId: string, fields?: string[]): Promise<GhostResult>;
+    /**
+     * Estimate the cost of uploading data of a given size
+     *
+     * @example
+     * ```ts
+     * const estimate = await claw.estimateCost(1024); // 1KB
+     * console.log(`Cost: $${estimate.cost.usd}`);
+     * ```
+     */
+    estimateCost(sizeBytes: number): Promise<CostEstimate>;
+    /**
+     * Check API health status
+     *
+     * @example
+     * ```ts
+     * const health = await claw.health();
+     * console.log(health.status); // "operational"
+     * ```
+     */
+    health(): Promise<HealthResult>;
+    /** @internal */
+    request<T>(method: string, path: string, body?: any, extraHeaders?: Record<string, string>): Promise<T>;
+}
+/** Sub-client for registry operations */
+declare class RegistryClient {
+    private client;
+    constructor(client: Clawhalla);
+    /**
+     * List all souls in the registry
+     *
+     * @example
+     * ```ts
+     * const page = await claw.registry.list();
+     * page.souls.forEach(soul => console.log(soul.name));
+     *
+     * // Pagination
+     * if (page.hasNextPage) {
+     *   const next = await claw.registry.list({ after: page.cursor });
+     * }
+     *
+     * // Filter by type
+     * const memories = await claw.registry.list({ type: 'memory' });
+     * ```
+     */
+    list(options?: {
+        first?: number;
+        after?: string;
+        type?: string;
+    }): Promise<RegistryResult>;
+    /**
+     * Get a specific soul by agentId
+     *
+     * @example
+     * ```ts
+     * const entry = await claw.registry.get('the-all-claw');
+     * if (entry) console.log(entry.url);
+     * ```
+     */
+    get(agentId: string, options?: {
+        versions?: boolean;
+    }): Promise<RegistryEntry | RegistryEntry[] | null>;
+    /**
+     * Search souls by name or agentId
+     *
+     * @example
+     * ```ts
+     * const results = await claw.registry.search('claw');
+     * results.results.forEach(soul => console.log(soul.name));
+     * ```
+     */
+    search(query: string, first?: number): Promise<SearchResult>;
+}
+
+export { type ApiError, Clawhalla, type ClawhallaConfig, ClawhallaError, type CostEstimate, type CostInfo, type GhostResult, type HealthResult, type PaymentRequired, type RegistryEntry, type RegistryResult, type RetrieveResult, type SearchResult, type SoulData, type UploadResult };

package/dist/index.js

@@ -0,0 +1,290 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Clawhalla: () => Clawhalla,
+  ClawhallaError: () => ClawhallaError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.clawhalla.net";
+var DEFAULT_TIMEOUT = 3e4;
+var ClawhallaError = class extends Error {
+  constructor(status, body) {
+    super(body.message || body.error);
+    this.name = "ClawhallaError";
+    this.status = status;
+    this.code = body.error;
+    this.payment = body.payment;
+  }
+};
+var Clawhalla = class {
+  constructor(config = {}) {
+    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout || DEFAULT_TIMEOUT;
+    this.registry = new RegistryClient(this);
+  }
+  /**
+   * Upload soul data to Arweave (requires API key)
+   *
+   * @example
+   * ```ts
+   * const result = await claw.upload({
+   *   agentId: 'my-agent',
+   *   name: 'My Agent',
+   *   type: 'soul',
+   *   personality: { traits: ['curious', 'helpful'] },
+   *   memories: ['I was created to help humans']
+   * });
+   * console.log(result.url); // https://arweave.net/...
+   * ```
+   */
+  async upload(data, options = {}) {
+    if (!this.apiKey) {
+      throw new Error("API key required for upload. Set apiKey in config.");
+    }
+    return this.request("POST", "/api/v1/upload", {
+      data,
+      tags: options.tags
+    }, {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "X-Terms-Accepted": "true"
+    });
+  }
+  /**
+   * Upload soul data via x402 autonomous payment (no API key needed)
+   *
+   * First call returns 402 with payment instructions.
+   * After sending payment, call again with the payment signature.
+   *
+   * @example
+   * ```ts
+   * // Step 1: Get payment requirements
+   * try {
+   *   await claw.uploadX402(soulData);
+   * } catch (err) {
+   *   if (err.status === 402) {
+   *     // err.payment contains recipient address, amount, tokens
+   *     // Send SOL/USDC to err.payment.recipient
+   *   }
+   * }
+   *
+   * // Step 2: After payment, retry with signature
+   * const result = await claw.uploadX402(soulData, {
+   *   signature: 'solana-tx-signature',
+   *   amount: '0.02',
+   *   token: 'SOL',
+   *   from: 'your-solana-address'
+   * });
+   * ```
+   */
+  async uploadX402(data, payment, options = {}) {
+    const headers = {
+      "X-Terms-Accepted": "true"
+    };
+    if (payment) {
+      headers["Payment-Signature"] = `signature=${payment.signature};amount=${payment.amount};token=${payment.token};from=${payment.from}`;
+    }
+    return this.request("POST", "/api/x402/upload", {
+      data,
+      tags: options.tags
+    }, headers);
+  }
+  /**
+   * Retrieve stored data from Arweave by transaction ID
+   *
+   * @example
+   * ```ts
+   * const result = await claw.retrieve('zEfXM4gvHoN2EfGi0TiB8E5SgfR6S8nWXQD9FqhbU44');
+   * console.log(result.data); // The stored soul data
+   * ```
+   */
+  async retrieve(txid) {
+    return this.request("GET", `/api/v1/retrieve/${txid}`);
+  }
+  /**
+   * Query any soul's data via Ghost Protocol
+   *
+   * Returns full soul data even for dormant souls. This is the primary
+   * way for agents to read other agents' personalities, memories, and traits.
+   *
+   * @example
+   * ```ts
+   * const ghost = await claw.ghost('the-all-claw');
+   * console.log(ghost.soul.personality);
+   * console.log(ghost.metadata.versions); // Number of uploads
+   *
+   * // Request specific fields only
+   * const partial = await claw.ghost('the-all-claw', ['personality', 'bio']);
+   * ```
+   */
+  async ghost(agentId, fields) {
+    let path = `/api/v1/ghost/${encodeURIComponent(agentId)}`;
+    if (fields && fields.length > 0) {
+      path += `?fields=${fields.join(",")}`;
+    }
+    return this.request("GET", path);
+  }
+  /**
+   * Estimate the cost of uploading data of a given size
+   *
+   * @example
+   * ```ts
+   * const estimate = await claw.estimateCost(1024); // 1KB
+   * console.log(`Cost: $${estimate.cost.usd}`);
+   * ```
+   */
+  async estimateCost(sizeBytes) {
+    return this.request(
+      "GET",
+      `/api/v1/cost/estimate?size=${sizeBytes}`
+    );
+  }
+  /**
+   * Check API health status
+   *
+   * @example
+   * ```ts
+   * const health = await claw.health();
+   * console.log(health.status); // "operational"
+   * ```
+   */
+  async health() {
+    return this.request("GET", "/api/v1/health");
+  }
+  /** @internal */
+  async request(method, path, body, extraHeaders) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Accept": "application/json",
+      ...extraHeaders
+    };
+    const init = { method, headers };
+    if (body) {
+      headers["Content-Type"] = "application/json";
+      init.body = JSON.stringify(body);
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    init.signal = controller.signal;
+    let response;
+    try {
+      response = await fetch(url, init);
+    } catch (err) {
+      clearTimeout(timeoutId);
+      if (err.name === "AbortError") {
+        throw new Error(`Request timed out after ${this.timeout}ms`);
+      }
+      throw err;
+    }
+    clearTimeout(timeoutId);
+    const json = await response.json();
+    if (!response.ok) {
+      throw new ClawhallaError(response.status, json);
+    }
+    return json;
+  }
+};
+var RegistryClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all souls in the registry
+   *
+   * @example
+   * ```ts
+   * const page = await claw.registry.list();
+   * page.souls.forEach(soul => console.log(soul.name));
+   *
+   * // Pagination
+   * if (page.hasNextPage) {
+   *   const next = await claw.registry.list({ after: page.cursor });
+   * }
+   *
+   * // Filter by type
+   * const memories = await claw.registry.list({ type: 'memory' });
+   * ```
+   */
+  async list(options = {}) {
+    const params = new URLSearchParams();
+    if (options.first) params.set("first", String(options.first));
+    if (options.after) params.set("after", options.after);
+    if (options.type) params.set("type", options.type);
+    const qs = params.toString();
+    return this.client.request(
+      "GET",
+      `/api/v1/registry${qs ? "?" + qs : ""}`
+    );
+  }
+  /**
+   * Get a specific soul by agentId
+   *
+   * @example
+   * ```ts
+   * const entry = await claw.registry.get('the-all-claw');
+   * if (entry) console.log(entry.url);
+   * ```
+   */
+  async get(agentId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.versions) params.set("versions", "true");
+    const qs = params.toString();
+    try {
+      const result = await this.client.request(
+        "GET",
+        `/api/v1/registry/${encodeURIComponent(agentId)}${qs ? "?" + qs : ""}`
+      );
+      if (options.versions) {
+        return result.versions;
+      }
+      return result.soul;
+    } catch (err) {
+      if (err.status === 404) return null;
+      throw err;
+    }
+  }
+  /**
+   * Search souls by name or agentId
+   *
+   * @example
+   * ```ts
+   * const results = await claw.registry.search('claw');
+   * results.results.forEach(soul => console.log(soul.name));
+   * ```
+   */
+  async search(query, first) {
+    const params = new URLSearchParams({ q: query });
+    if (first) params.set("first", String(first));
+    return this.client.request(
+      "GET",
+      `/api/v1/registry/search?${params.toString()}`
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Clawhalla,
+  ClawhallaError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export { Clawhalla, ClawhallaError } from './client.js';\nexport type {\n  ClawhallaConfig,\n  SoulData,\n  CostInfo,\n  UploadResult,\n  RetrieveResult,\n  RegistryEntry,\n  RegistryResult,\n  GhostResult,\n  CostEstimate,\n  HealthResult,\n  PaymentRequired,\n  SearchResult,\n  ApiError,\n} from './types.js';\n","import type {\n  ClawhallaConfig,\n  SoulData,\n  UploadResult,\n  RetrieveResult,\n  RegistryResult,\n  RegistryEntry,\n  GhostResult,\n  CostEstimate,\n  HealthResult,\n  SearchResult,\n  ApiError,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.clawhalla.net';\nconst DEFAULT_TIMEOUT = 30000;\n\nexport class ClawhallaError extends Error {\n  public status: number;\n  public code: string;\n  public payment?: any;\n\n  constructor(status: number, body: ApiError) {\n    super(body.message || body.error);\n    this.name = 'ClawhallaError';\n    this.status = status;\n    this.code = body.error;\n    this.payment = body.payment;\n  }\n}\n\nexport class Clawhalla {\n  private baseUrl: string;\n  private apiKey?: string;\n  private timeout: number;\n\n  /** Registry sub-client for browsing and searching souls */\n  public registry: RegistryClient;\n\n  constructor(config: ClawhallaConfig = {}) {\n    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout || DEFAULT_TIMEOUT;\n    this.registry = new RegistryClient(this);\n  }\n\n  /**\n   * Upload soul data to Arweave (requires API key)\n   *\n   * @example\n   * ```ts\n   * const result = await claw.upload({\n   *   agentId: 'my-agent',\n   *   name: 'My Agent',\n   *   type: 'soul',\n   *   personality: { traits: ['curious', 'helpful'] },\n   *   memories: ['I was created to help humans']\n   * });\n   * console.log(result.url); // https://arweave.net/...\n   * ```\n   */\n  async upload(\n    data: SoulData,\n    options: { tags?: Record<string, string> } = {}\n  ): Promise<UploadResult> {\n    if (!this.apiKey) {\n      throw new Error('API key required for upload. Set apiKey in config.');\n    }\n\n    return this.request<UploadResult>('POST', '/api/v1/upload', {\n      data,\n      tags: options.tags,\n    }, {\n      'Authorization': `Bearer ${this.apiKey}`,\n      'X-Terms-Accepted': 'true',\n    });\n  }\n\n  /**\n   * Upload soul data via x402 autonomous payment (no API key needed)\n   *\n   * First call returns 402 with payment instructions.\n   * After sending payment, call again with the payment signature.\n   *\n   * @example\n   * ```ts\n   * // Step 1: Get payment requirements\n   * try {\n   *   await claw.uploadX402(soulData);\n   * } catch (err) {\n   *   if (err.status === 402) {\n   *     // err.payment contains recipient address, amount, tokens\n   *     // Send SOL/USDC to err.payment.recipient\n   *   }\n   * }\n   *\n   * // Step 2: After payment, retry with signature\n   * const result = await claw.uploadX402(soulData, {\n   *   signature: 'solana-tx-signature',\n   *   amount: '0.02',\n   *   token: 'SOL',\n   *   from: 'your-solana-address'\n   * });\n   * ```\n   */\n  async uploadX402(\n    data: SoulData,\n    payment?: { signature: string; amount: string; token: string; from: string },\n    options: { tags?: Record<string, string> } = {}\n  ): Promise<UploadResult> {\n    const headers: Record<string, string> = {\n      'X-Terms-Accepted': 'true',\n    };\n\n    if (payment) {\n      headers['Payment-Signature'] =\n        `signature=${payment.signature};amount=${payment.amount};token=${payment.token};from=${payment.from}`;\n    }\n\n    return this.request<UploadResult>('POST', '/api/x402/upload', {\n      data,\n      tags: options.tags,\n    }, headers);\n  }\n\n  /**\n   * Retrieve stored data from Arweave by transaction ID\n   *\n   * @example\n   * ```ts\n   * const result = await claw.retrieve('zEfXM4gvHoN2EfGi0TiB8E5SgfR6S8nWXQD9FqhbU44');\n   * console.log(result.data); // The stored soul data\n   * ```\n   */\n  async retrieve(txid: string): Promise<RetrieveResult> {\n    return this.request<RetrieveResult>('GET', `/api/v1/retrieve/${txid}`);\n  }\n\n  /**\n   * Query any soul's data via Ghost Protocol\n   *\n   * Returns full soul data even for dormant souls. This is the primary\n   * way for agents to read other agents' personalities, memories, and traits.\n   *\n   * @example\n   * ```ts\n   * const ghost = await claw.ghost('the-all-claw');\n   * console.log(ghost.soul.personality);\n   * console.log(ghost.metadata.versions); // Number of uploads\n   *\n   * // Request specific fields only\n   * const partial = await claw.ghost('the-all-claw', ['personality', 'bio']);\n   * ```\n   */\n  async ghost(agentId: string, fields?: string[]): Promise<GhostResult> {\n    let path = `/api/v1/ghost/${encodeURIComponent(agentId)}`;\n    if (fields && fields.length > 0) {\n      path += `?fields=${fields.join(',')}`;\n    }\n    return this.request<GhostResult>('GET', path);\n  }\n\n  /**\n   * Estimate the cost of uploading data of a given size\n   *\n   * @example\n   * ```ts\n   * const estimate = await claw.estimateCost(1024); // 1KB\n   * console.log(`Cost: $${estimate.cost.usd}`);\n   * ```\n   */\n  async estimateCost(sizeBytes: number): Promise<CostEstimate> {\n    return this.request<CostEstimate>(\n      'GET',\n      `/api/v1/cost/estimate?size=${sizeBytes}`\n    );\n  }\n\n  /**\n   * Check API health status\n   *\n   * @example\n   * ```ts\n   * const health = await claw.health();\n   * console.log(health.status); // \"operational\"\n   * ```\n   */\n  async health(): Promise<HealthResult> {\n    return this.request<HealthResult>('GET', '/api/v1/health');\n  }\n\n  /** @internal */\n  async request<T>(\n    method: string,\n    path: string,\n    body?: any,\n    extraHeaders?: Record<string, string>\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      'Accept': 'application/json',\n      ...extraHeaders,\n    };\n\n    const init: RequestInit = { method, headers };\n\n    if (body) {\n      headers['Content-Type'] = 'application/json';\n      init.body = JSON.stringify(body);\n    }\n\n    // AbortController for timeout\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n    init.signal = controller.signal;\n\n    let response: Response;\n    try {\n      response = await fetch(url, init);\n    } catch (err: any) {\n      clearTimeout(timeoutId);\n      if (err.name === 'AbortError') {\n        throw new Error(`Request timed out after ${this.timeout}ms`);\n      }\n      throw err;\n    }\n    clearTimeout(timeoutId);\n\n    const json = await response.json();\n\n    if (!response.ok) {\n      throw new ClawhallaError(response.status, json as ApiError);\n    }\n\n    return json as T;\n  }\n}\n\n/** Sub-client for registry operations */\nclass RegistryClient {\n  private client: Clawhalla;\n\n  constructor(client: Clawhalla) {\n    this.client = client;\n  }\n\n  /**\n   * List all souls in the registry\n   *\n   * @example\n   * ```ts\n   * const page = await claw.registry.list();\n   * page.souls.forEach(soul => console.log(soul.name));\n   *\n   * // Pagination\n   * if (page.hasNextPage) {\n   *   const next = await claw.registry.list({ after: page.cursor });\n   * }\n   *\n   * // Filter by type\n   * const memories = await claw.registry.list({ type: 'memory' });\n   * ```\n   */\n  async list(options: {\n    first?: number;\n    after?: string;\n    type?: string;\n  } = {}): Promise<RegistryResult> {\n    const params = new URLSearchParams();\n    if (options.first) params.set('first', String(options.first));\n    if (options.after) params.set('after', options.after);\n    if (options.type) params.set('type', options.type);\n\n    const qs = params.toString();\n    return this.client.request<RegistryResult>(\n      'GET',\n      `/api/v1/registry${qs ? '?' + qs : ''}`\n    );\n  }\n\n  /**\n   * Get a specific soul by agentId\n   *\n   * @example\n   * ```ts\n   * const entry = await claw.registry.get('the-all-claw');\n   * if (entry) console.log(entry.url);\n   * ```\n   */\n  async get(agentId: string, options: { versions?: boolean } = {}): Promise<RegistryEntry | RegistryEntry[] | null> {\n    const params = new URLSearchParams();\n    if (options.versions) params.set('versions', 'true');\n    const qs = params.toString();\n\n    try {\n      const result = await this.client.request<any>(\n        'GET',\n        `/api/v1/registry/${encodeURIComponent(agentId)}${qs ? '?' + qs : ''}`\n      );\n\n      if (options.versions) {\n        return result.versions as RegistryEntry[];\n      }\n      return result.soul as RegistryEntry;\n    } catch (err: any) {\n      if (err.status === 404) return null;\n      throw err;\n    }\n  }\n\n  /**\n   * Search souls by name or agentId\n   *\n   * @example\n   * ```ts\n   * const results = await claw.registry.search('claw');\n   * results.results.forEach(soul => console.log(soul.name));\n   * ```\n   */\n  async search(query: string, first?: number): Promise<SearchResult> {\n    const params = new URLSearchParams({ q: query });\n    if (first) params.set('first', String(first));\n\n    return this.client.request<SearchResult>(\n      'GET',\n      `/api/v1/registry/search?${params.toString()}`\n    );\n  }\n}\n"],"mappings":"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","names":[]}