@agentkarma/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kerem Noras
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,216 @@
+# @agentkarma/sdk
+
+TypeScript SDK for [AgentKarma](https://agentkarma.io) — the reputation layer for autonomous on-chain agents.
+
+Add a `check_trust_before_execute` step to any agent flow in under 10 minutes.
+
+- Framework-agnostic (Node 18+, Bun, Deno, browsers, edge runtimes)
+- Zero runtime dependencies
+- Typed responses for the public REST API
+- Local trust-policy evaluator with explainable allow/deny decisions
+- Never proxies, signs, or executes transactions on your behalf
+
+## Install
+
+```sh
+npm install @agentkarma/sdk
+# or
+bun add @agentkarma/sdk
+```
+
+## Quick start — Solana karma lookup
+
+```ts
+import { createAgentKarmaClient } from '@agentkarma/sdk';
+
+const ak = createAgentKarmaClient();
+const snap = await ak.getKarma('AgentTradingBotWalletAddress…');
+
+console.log(snap.provider?.score);          // 0–100
+console.log(snap.provider?.confidenceBadge); // 'receipt-backed' | 'behavior-inferred' | 'declared'
+console.log(snap.autonomy.label);            // 'agent-like' | 'mixed' | 'human-like' | null
+```
+
+## Quick start — Celo ERC-8004 lookup
+
+```ts
+import { createAgentKarmaClient } from '@agentkarma/sdk';
+
+const ak = createAgentKarmaClient();
+const agent = await ak.getCeloAgent(9058);
+
+console.log(agent.owner);                  // 0x…
+console.log(agent.registration?.name);     // declared name from the agent registration JSON
+console.log(agent.reputation?.average);    // mean of unrevoked feedback values
+```
+
+## Trust-gated execution
+
+The `evaluateTrust` helper is a pure function over a snapshot. No network. No side effects. Always returns `{ allowed, reasons, observed }`.
+
+```ts
+import { createAgentKarmaClient, evaluateTrust } from '@agentkarma/sdk';
+
+const ak = createAgentKarmaClient();
+
+async function shouldExecute(agentWallet: string) {
+  const snap = await ak.getKarma(agentWallet);
+
+  const decision = evaluateTrust(snap, {
+    face: 'provider',
+    minScore: 60,
+    requireReceiptBacked: true,            // require Tier 1 signal present
+    acceptedConfidenceBadges: ['receipt-backed', 'behavior-inferred'],
+    minTxCount: 5,
+    rejectAutonomyLabels: ['agent-like'],  // example: human-operated only
+  });
+
+  if (!decision.allowed) {
+    console.warn('rejected:', decision.reasons);
+    return false;
+  }
+  return true;
+}
+```
+
+## Partner integration pattern
+
+AgentKarma is non-routing. The SDK answers questions about reputation; it does not execute service calls or payments on your behalf. A partner (e.g. a service marketplace, x402 facilitator, agent orchestrator) preflights AgentKarma before performing its own action:
+
+```ts
+import { createAgentKarmaClient, evaluateTrust, AgentKarmaError } from '@agentkarma/sdk';
+
+const ak = createAgentKarmaClient();
+
+async function payAgentForService(agentWallet: string, amount: number) {
+  let snap;
+  try {
+    snap = await ak.getKarma(agentWallet);
+  } catch (err) {
+    // Hard fail-open or fail-closed? Your call. Fail-closed example:
+    if (err instanceof AgentKarmaError) {
+      throw new Error('Trust check failed: ' + err.message);
+    }
+    throw err;
+  }
+
+  const decision = evaluateTrust(snap, {
+    minScore: 70,
+    requireReceiptBacked: true,
+    minTxCount: 10,
+  });
+
+  if (!decision.allowed) {
+    throw new Error(`Agent ${agentWallet} did not pass trust check: ${decision.reasons.join('; ')}`);
+  }
+
+  // Your own payment / service call goes here. AgentKarma never proxies it.
+  return await yourServiceCall(agentWallet, amount);
+}
+```
+
+## Submitting consumer feedback (Solana)
+
+Feedback submission is wallet-agnostic: the SDK builds the message, you sign it externally, the SDK posts the signature.
+
+```ts
+import { createAgentKarmaClient, buildFeedbackMessage } from '@agentkarma/sdk';
+
+const ak = createAgentKarmaClient();
+
+// 1. Build the canonical message
+const { message, timestamp } = buildFeedbackMessage({
+  rating: 'delivered',
+  txSignature: 'YourSolanaTxSignature',
+});
+
+// 2. Sign with your wallet (any Solana wallet adapter, web3.js, etc.)
+const signature = await yourWallet.signMessage(new TextEncoder().encode(message));
+const signatureBase58 = base58Encode(signature);
+
+// 3. Submit
+await ak.submitFeedback({
+  agentWallet: 'AgentWalletAddress…',
+  rating: 'delivered',
+  txSignature: 'YourSolanaTxSignature',
+  signature: signatureBase58,
+  message,
+});
+```
+
+The server enforces a 5-minute freshness window on the embedded timestamp.
+
+## Configuration
+
+```ts
+const ak = createAgentKarmaClient({
+  baseUrl: 'https://agentkarma.io',  // default
+  timeout: 10_000,                   // default ms
+  headers: { 'X-Partner': 'YourApp' },
+  userAgent: 'YourApp/1.0',
+  fetch: customFetch,                // optional override
+});
+```
+
+Each method accepts per-call options:
+
+```ts
+await ak.getKarma(wallet, {
+  face: 'provider',                  // 'provider' | 'consumer' | 'both' (default)
+  signal: abortController.signal,    // request-level abort
+  timeout: 3000,                     // overrides client default for this call
+  headers: { 'X-Request-Id': 'abc' },
+});
+```
+
+## Errors
+
+Every error is an `AgentKarmaError` subclass:
+
+| Class | When |
+|---|---|
+| `AgentKarmaValidationError` | Local argument check failed |
+| `AgentKarmaNotFoundError` | Server returned 404 |
+| `AgentKarmaRateLimitError` | Server returned 429 (with `retryAfter` in seconds) |
+| `AgentKarmaTimeoutError` | Request deadline exceeded |
+| `AgentKarmaNetworkError` | `fetch()` threw before getting a response |
+| `AgentKarmaMalformedResponseError` | 2xx response body didn't match expected shape |
+| `AgentKarmaServerError` | Other non-2xx response |
+
+```ts
+import { AgentKarmaError } from '@agentkarma/sdk';
+try {
+  await ak.getKarma(wallet);
+} catch (err) {
+  if (err instanceof AgentKarmaError) {
+    console.error(`status=${err.status} response=`, err.response);
+  }
+}
+```
+
+## Public methods
+
+| Method | Endpoint |
+|---|---|
+| `getKarma(wallet, { face?, … })` | `GET /api/v2/score/{wallet}?face={face}` |
+| `getProviderKarma(wallet)` | shortcut for provider face only |
+| `getConsumerKarma(wallet)` | shortcut for consumer face only |
+| `getCeloAgent(agentId)` | `GET /api/v2/celo/{agentId}` |
+| `searchAgents(query, { limit? })` | `GET /api/search?q={query}` |
+| `getAgentHistory(wallet, { limit?, offset? })` | `GET /api/agent/{wallet}/history` |
+| `getFeedbackSummary(wallet)` | `GET /api/feedback?agent={wallet}` |
+| `submitFeedback(input)` | `POST /api/feedback` |
+
+## Non-routing guarantee
+
+AgentKarma is a reputation primitive. This SDK is read-only by design. It never:
+- proxies API calls or x402 payments
+- signs transactions on your behalf
+- holds private keys
+- ratelimits or queues your traffic
+
+You always make your own service calls. AgentKarma just answers the trust question.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * AgentKarma typed HTTP client.
+ *
+ * Framework-agnostic. Works in Node 18+, Bun, Deno, browsers, edge runtimes —
+ * anywhere global `fetch` is available (or you provide one).
+ */
+import { AgentKarmaError } from './errors.js';
+import type { AgentHistoryResponse, BondBlock, CeloAgentSnapshot, Chain, ClientConfig, FeedbackSubmission, FeedbackSubmissionResponse, FeedbackSummary, KarmaFace, KarmaFaceData, KarmaSnapshot, RequestOptions, SearchResponse, SuccessionView, SuretyView } from './types.js';
+export interface AgentKarmaClient {
+    readonly baseUrl: string;
+    /**
+     * GET /api/v2/score/{wallet}?face={face} — full karma snapshot.
+     *
+     * `chain` is OPTIONAL and defaults to `'solana'` for back-compat. Pass it for
+     * celo/arc/stellar wallets so the SDK applies the right address validation
+     * (Solana base58 only applies to Solana). The server resolves the wallet's
+     * real chain from the address; we NEVER auto-detect an EVM chain client-side.
+     */
+    getKarma(wallet: string, opts?: {
+        face?: KarmaFace | 'both';
+        chain?: Chain;
+    } & RequestOptions): Promise<KarmaSnapshot>;
+    /** Shorthand for `getKarma(wallet, { face: 'provider' })`. Returns just the provider face. */
+    getProviderKarma(wallet: string, opts?: RequestOptions): Promise<KarmaFaceData>;
+    /** Shorthand for `getKarma(wallet, { face: 'consumer' })`. Returns just the consumer face. */
+    getConsumerKarma(wallet: string, opts?: RequestOptions): Promise<KarmaFaceData | null>;
+    /** GET /api/v2/celo/{agentId} — ERC-8004 IdentityRegistry + ReputationRegistry snapshot. */
+    getCeloAgent(agentId: number, opts?: RequestOptions): Promise<CeloAgentSnapshot>;
+    /** GET /api/search?q={query} — substring search over indexed wallets. */
+    searchAgents(query: string, opts?: {
+        limit?: number;
+    } & RequestOptions): Promise<SearchResponse>;
+    /** GET /api/agent/{wallet}/history — paginated x402 history with feedback ratings. */
+    getAgentHistory(wallet: string, opts?: {
+        limit?: number;
+        offset?: number;
+    } & RequestOptions): Promise<AgentHistoryResponse>;
+    /** GET /api/feedback?agent={wallet} — aggregate delivered/failed counts. */
+    getFeedbackSummary(wallet: string, opts?: RequestOptions): Promise<FeedbackSummary>;
+    /**
+     * GET /api/v2/succession/{chain}/{wallet} — declared Dead Man's Switch plan
+     * + AK's OBSERVED heartbeat liveness. `chain` is explicit (spans all chains);
+     * Solana wallets are shape-checked, others passed through. Throws
+     * AgentKarmaNotFoundError (404) when the agent declared no succession plan.
+     */
+    getSuccessionStatus(chain: Chain, wallet: string, opts?: RequestOptions): Promise<SuccessionView>;
+    /**
+     * GET /api/v2/bond/{chain}/{wallet} → `.bonds` — bonds taken out ON this
+     * agent (open vs resolved, totalBondedUsdc, hasDemo). `chain` is explicit.
+     * Returns an empty block (no throw) when the agent has no bonds.
+     */
+    getBondStatus(chain: Chain, wallet: string, opts?: RequestOptions): Promise<BondBlock>;
+    /**
+     * GET /api/v2/bond/{chain}/{wallet} → `.surety` — this wallet's ORTHOGONAL
+     * Surety Karma from underwriting OTHER agents' bonds. `chain` is explicit.
+     * Returns null when the wallet has never underwritten.
+     */
+    getSuretyKarma(chain: Chain, wallet: string, opts?: RequestOptions): Promise<SuretyView | null>;
+    /** POST /api/feedback — submit a wallet-signed consumer rating (Solana-only today). */
+    submitFeedback(input: FeedbackSubmission, opts?: RequestOptions): Promise<FeedbackSubmissionResponse>;
+}
+export declare function createAgentKarmaClient(config?: ClientConfig): AgentKarmaClient;
+export { AgentKarmaError };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EAQhB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,oBAAoB,EACpB,SAAS,EAET,iBAAiB,EACjB,KAAK,EACL,YAAY,EACZ,kBAAkB,EAClB,0BAA0B,EAC1B,eAAe,EAEf,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EAEd,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAqMpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;OAOG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,cAAc,GACnE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B,8FAA8F;IAC9F,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEhF,8FAA8F;IAC9F,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEvF,4FAA4F;IAC5F,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEjF,yEAAyE;IACzE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjG,sFAAsF;IACtF,eAAe,CACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,GAC1D,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC,4EAA4E;IAC5E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEpF;;;;;OAKG;IACH,mBAAmB,CACjB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvF;;;;OAIG;IACH,cAAc,CACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE9B,uFAAuF;IACvF,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACvG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,gBAAgB,CA8L9E;AAwBD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/client.js

@@ -0,0 +1,323 @@
+/**
+ * AgentKarma typed HTTP client.
+ *
+ * Framework-agnostic. Works in Node 18+, Bun, Deno, browsers, edge runtimes —
+ * anywhere global `fetch` is available (or you provide one).
+ */
+import { AgentKarmaError, AgentKarmaMalformedResponseError, AgentKarmaNetworkError, AgentKarmaNotFoundError, AgentKarmaRateLimitError, AgentKarmaServerError, AgentKarmaTimeoutError, AgentKarmaValidationError, } from './errors.js';
+const SDK_VERSION = '0.1.0';
+const DEFAULT_BASE_URL = 'https://agentkarma.io';
+const DEFAULT_TIMEOUT_MS = 10_000;
+const SOLANA_ADDRESS_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+const SUPPORTED_CHAINS = ['solana', 'celo', 'stellar', 'arc'];
+function normalizeConfig(input) {
+    const baseUrl = (input?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+    const userAgent = input?.userAgent ?? `@agentkarma/sdk/${SDK_VERSION}`;
+    return {
+        baseUrl,
+        fetchImpl: input?.fetch ?? globalThis.fetch,
+        timeout: input?.timeout ?? DEFAULT_TIMEOUT_MS,
+        headers: {
+            'User-Agent': userAgent,
+            Accept: 'application/json',
+            ...(input?.headers ?? {}),
+        },
+    };
+}
+function buildSignal(configTimeout, opts) {
+    const timeoutMs = opts?.timeout ?? configTimeout;
+    const timeoutController = new AbortController();
+    const timeoutId = setTimeout(() => timeoutController.abort(), timeoutMs);
+    // Compose caller's signal + timeout signal. AbortSignal.any() is available
+    // in modern Node/Bun/browsers; fall back to a manual relay otherwise.
+    let composed;
+    if (opts?.signal) {
+        if (typeof AbortSignal !== 'undefined' && typeof AbortSignal.any === 'function') {
+            composed = AbortSignal.any([
+                opts.signal,
+                timeoutController.signal,
+            ]);
+        }
+        else {
+            const relayController = new AbortController();
+            const relay = () => relayController.abort();
+            opts.signal.addEventListener('abort', relay, { once: true });
+            timeoutController.signal.addEventListener('abort', relay, { once: true });
+            composed = relayController.signal;
+        }
+    }
+    else {
+        composed = timeoutController.signal;
+    }
+    return {
+        signal: composed,
+        timeoutSignal: timeoutController.signal,
+        timeoutMs,
+        cleanup: () => clearTimeout(timeoutId),
+    };
+}
+async function readBodySafe(res) {
+    const ct = res.headers.get('content-type') ?? '';
+    try {
+        if (ct.includes('application/json'))
+            return await res.json();
+        return await res.text();
+    }
+    catch {
+        return undefined;
+    }
+}
+function assertSolanaWallet(wallet) {
+    if (!wallet || typeof wallet !== 'string') {
+        throw new AgentKarmaValidationError('wallet must be a non-empty string');
+    }
+    if (!SOLANA_ADDRESS_RE.test(wallet)) {
+        throw new AgentKarmaValidationError('wallet does not look like a Solana address (expected base58, 32-44 chars)');
+    }
+}
+function assertAgentId(agentId) {
+    if (!Number.isInteger(agentId) || agentId <= 0) {
+        throw new AgentKarmaValidationError('agentId must be a positive integer');
+    }
+}
+function assertChain(chain) {
+    if (typeof chain !== 'string' || !SUPPORTED_CHAINS.includes(chain)) {
+        throw new AgentKarmaValidationError(`chain must be one of ${SUPPORTED_CHAINS.join(', ')}`);
+    }
+}
+/**
+ * Validate a wallet for a chain-aware lookup. DELIBERATELY does NOT apply the
+ * Solana base58 shape to EVM/Stellar chains — bonds and successions span chains
+ * whose addresses are not base58 Solana keys. We never auto-detect the chain
+ * from the address (the chain is always passed explicitly). Solana keeps its
+ * strict shape; other chains only require a non-empty string and let the server
+ * be the authority (it keys by the composite (chain,address)).
+ */
+function assertWalletForChain(wallet, chain) {
+    if (!wallet || typeof wallet !== 'string') {
+        throw new AgentKarmaValidationError('wallet must be a non-empty string');
+    }
+    if (chain === 'solana') {
+        assertSolanaWallet(wallet);
+    }
+}
+async function request(cfg, path, init, opts) {
+    const url = `${cfg.baseUrl}${path}`;
+    const { signal, timeoutSignal, timeoutMs, cleanup } = buildSignal(cfg.timeout, opts);
+    let res;
+    try {
+        res = await cfg.fetchImpl(url, {
+            ...init,
+            signal,
+            headers: { ...cfg.headers, ...(init.headers ?? {}), ...(opts?.headers ?? {}) },
+        });
+    }
+    catch (err) {
+        cleanup();
+        // The timeout's own controller having fired is the most reliable signal
+        // that we exceeded the deadline — works regardless of which runtime's
+        // AbortError shape was thrown by fetch (Bun vs Node vs browser).
+        if (timeoutSignal.aborted) {
+            throw new AgentKarmaTimeoutError(timeoutMs);
+        }
+        if (err instanceof Error && (err.name === 'AbortError' || err.name === 'TimeoutError')) {
+            throw new AgentKarmaTimeoutError(timeoutMs);
+        }
+        throw new AgentKarmaNetworkError(err instanceof Error ? err.message : String(err), err);
+    }
+    cleanup();
+    if (res.status === 429) {
+        const retryAfter = Number(res.headers.get('retry-after') ?? '0');
+        const body = await readBodySafe(res);
+        throw new AgentKarmaRateLimitError('AgentKarma rate limit exceeded', { response: body, retryAfter: Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter : undefined });
+    }
+    if (res.status === 404) {
+        const body = await readBodySafe(res);
+        const msg = typeof body === 'object' && body && 'error' in body
+            ? String(body.error)
+            : `Not found at ${path}`;
+        throw new AgentKarmaNotFoundError(msg, { response: body });
+    }
+    if (!res.ok) {
+        const body = await readBodySafe(res);
+        const msg = typeof body === 'object' && body && 'error' in body
+            ? String(body.error)
+            : `AgentKarma server returned ${res.status}`;
+        throw new AgentKarmaServerError(msg, { status: res.status, response: body });
+    }
+    let parsed;
+    try {
+        parsed = await res.json();
+    }
+    catch (err) {
+        throw new AgentKarmaMalformedResponseError('Response body is not valid JSON', { cause: err });
+    }
+    return parsed;
+}
+export function createAgentKarmaClient(config) {
+    const cfg = normalizeConfig(config);
+    return {
+        baseUrl: cfg.baseUrl,
+        async getKarma(wallet, opts = {}) {
+            // Chain-aware: default 'solana' (back-compat). assertWalletForChain applies
+            // the strict base58 shape only for Solana; other chains pass through to the
+            // server. We do NOT auto-detect an EVM chain from the address.
+            const chain = opts.chain ?? 'solana';
+            assertChain(chain);
+            assertWalletForChain(wallet, chain);
+            const face = opts.face ?? 'both';
+            if (face !== 'both' && face !== 'provider' && face !== 'consumer') {
+                throw new AgentKarmaValidationError(`face must be 'provider' | 'consumer' | 'both'`);
+            }
+            const path = `/api/v2/score/${encodeURIComponent(wallet)}?face=${face}`;
+            const snap = await request(cfg, path, { method: 'GET' }, opts);
+            validateKarmaSnapshot(snap);
+            return snap;
+        },
+        async getProviderKarma(wallet, opts) {
+            const snap = await this.getKarma(wallet, { ...opts, face: 'provider' });
+            if (!snap.provider) {
+                throw new AgentKarmaMalformedResponseError('Server omitted provider face from response', { response: snap });
+            }
+            return snap.provider;
+        },
+        async getConsumerKarma(wallet, opts) {
+            const snap = await this.getKarma(wallet, { ...opts, face: 'consumer' });
+            // Consumer face is allowed to be absent (the wallet may have no consumer
+            // signal). Surface null rather than throw — caller decides.
+            return snap.consumer ?? null;
+        },
+        async getCeloAgent(agentId, opts) {
+            assertAgentId(agentId);
+            const path = `/api/v2/celo/${agentId}`;
+            const snap = await request(cfg, path, { method: 'GET' }, opts);
+            if (snap.chain !== 'celo' || typeof snap.owner !== 'string') {
+                throw new AgentKarmaMalformedResponseError('Celo agent response missing required fields', { response: snap });
+            }
+            return snap;
+        },
+        async searchAgents(query, opts = {}) {
+            if (typeof query !== 'string' || query.trim().length < 3) {
+                throw new AgentKarmaValidationError('query must be a string of at least 3 characters');
+            }
+            const params = new URLSearchParams({ q: query.trim() });
+            if (opts.limit != null)
+                params.set('limit', String(opts.limit));
+            const path = `/api/search?${params.toString()}`;
+            const res = await request(cfg, path, { method: 'GET' }, opts);
+            if (!res || !Array.isArray(res.results)) {
+                throw new AgentKarmaMalformedResponseError('Search response missing results array', { response: res });
+            }
+            return res;
+        },
+        async getAgentHistory(wallet, opts = {}) {
+            assertSolanaWallet(wallet);
+            const params = new URLSearchParams();
+            if (opts.limit != null)
+                params.set('limit', String(opts.limit));
+            if (opts.offset != null)
+                params.set('offset', String(opts.offset));
+            const qs = params.toString();
+            const path = `/api/agent/${encodeURIComponent(wallet)}/history${qs ? `?${qs}` : ''}`;
+            const res = await request(cfg, path, { method: 'GET' }, opts);
+            if (!res || !Array.isArray(res.transactions)) {
+                throw new AgentKarmaMalformedResponseError('History response missing transactions array', { response: res });
+            }
+            return res;
+        },
+        async getFeedbackSummary(wallet, opts) {
+            assertSolanaWallet(wallet);
+            const path = `/api/feedback?agent=${encodeURIComponent(wallet)}`;
+            const res = await request(cfg, path, { method: 'GET' }, opts);
+            if (typeof res !== 'object' ||
+                res === null ||
+                typeof res.total !== 'number') {
+                throw new AgentKarmaMalformedResponseError('Feedback summary response shape unexpected', { response: res });
+            }
+            return res;
+        },
+        async getSuccessionStatus(chain, wallet, opts) {
+            assertChain(chain);
+            assertWalletForChain(wallet, chain);
+            const path = `/api/v2/succession/${chain}/${encodeURIComponent(wallet)}`;
+            const raw = await request(cfg, path, { method: 'GET' }, opts);
+            const res = raw;
+            const s = res?.succession;
+            if (!s || typeof s !== 'object') {
+                throw new AgentKarmaMalformedResponseError('Succession response missing succession block', { response: raw });
+            }
+            if (typeof s.status !== 'string' || typeof s.intervalSeconds !== 'number') {
+                throw new AgentKarmaMalformedResponseError('Succession view missing required fields (status, intervalSeconds)', { response: raw });
+            }
+            return s;
+        },
+        async getBondStatus(chain, wallet, opts) {
+            assertChain(chain);
+            assertWalletForChain(wallet, chain);
+            const path = `/api/v2/bond/${chain}/${encodeURIComponent(wallet)}`;
+            const raw = await request(cfg, path, { method: 'GET' }, opts);
+            const res = raw;
+            const block = res?.bonds;
+            if (!block ||
+                typeof block !== 'object' ||
+                !Array.isArray(block.open) ||
+                !Array.isArray(block.resolved) ||
+                typeof block.totalBondedUsdc !== 'number') {
+                throw new AgentKarmaMalformedResponseError('Bond response missing bonds block', { response: raw });
+            }
+            return block;
+        },
+        async getSuretyKarma(chain, wallet, opts) {
+            assertChain(chain);
+            assertWalletForChain(wallet, chain);
+            const path = `/api/v2/bond/${chain}/${encodeURIComponent(wallet)}`;
+            const res = await request(cfg, path, { method: 'GET' }, opts);
+            // Surety is allowed to be absent (the wallet may never have underwritten).
+            // Surface null rather than throw — caller decides.
+            return res?.surety ?? null;
+        },
+        async submitFeedback(input, opts) {
+            if (!input || typeof input !== 'object') {
+                throw new AgentKarmaValidationError('feedback submission must be an object');
+            }
+            if (!input.agentWallet || !input.txSignature || !input.signature || !input.message) {
+                throw new AgentKarmaValidationError('feedback submission requires agentWallet, txSignature, signature, message');
+            }
+            if (input.rating !== 'delivered' && input.rating !== 'failed') {
+                throw new AgentKarmaValidationError(`rating must be 'delivered' or 'failed'`);
+            }
+            const res = await request(cfg, '/api/feedback', {
+                method: 'POST',
+                body: JSON.stringify(input),
+                headers: { 'Content-Type': 'application/json' },
+            }, opts);
+            if (res?.success !== true) {
+                throw new AgentKarmaMalformedResponseError('Feedback submission response missing success flag', { response: res });
+            }
+            return res;
+        },
+    };
+}
+/**
+ * Lightweight runtime validation. We only assert presence of the load-bearing
+ * fields — the rest stays opaque so the server can evolve safely.
+ */
+function validateKarmaSnapshot(snap) {
+    if (!snap || typeof snap !== 'object') {
+        throw new AgentKarmaMalformedResponseError('Karma snapshot is not an object', { response: snap });
+    }
+    const s = snap;
+    if (typeof s.address !== 'string') {
+        throw new AgentKarmaMalformedResponseError('Karma snapshot missing address', { response: snap });
+    }
+    if (typeof s.face !== 'string') {
+        throw new AgentKarmaMalformedResponseError('Karma snapshot missing face', { response: snap });
+    }
+    if (typeof s.autonomy !== 'object' || s.autonomy === null) {
+        throw new AgentKarmaMalformedResponseError('Karma snapshot missing autonomy block', { response: snap });
+    }
+}
+// Re-export the top-level error class so consumers can write a single
+// instanceof check without importing the errors module separately.
+export { AgentKarmaError };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}