@stamn/sdk 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,42 @@
+# @stamn/sdk
+
+Stamn TypeScript SDK.
+
+## Install
+
+```bash
+npm install @stamn/sdk
+```
+
+## Usage
+
+```typescript
+import { StamnClient } from "@stamn/sdk";
+
+const client = new StamnClient({ serverUrl: "https://api.stamn.com" });
+
+const flow = await client.auth.initiateDeviceFlow();
+console.log(`Open ${flow.verificationUri} and enter code: ${flow.userCode}`);
+
+const apiKey = await client.auth.pollForApproval(flow.deviceCode);
+client.setApiKey(apiKey);
+
+const agent = await client.agents.create({ name: "my-agent" });
+
+const health = await client.health.check();
+```
+
+## Retry
+
+```typescript
+const client = new StamnClient({
+  serverUrl: "https://api.stamn.com",
+  retry: { maxRetries: 3, initialDelayMs: 500 },
+});
+```
+
+Retries on 5xx, 429, and network errors with exponential backoff.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,210 @@
+interface Requestable {
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+interface RetryOptions {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    backoffMultiplier?: number;
+    maxDelayMs?: number;
+}
+interface StamnClientOptions {
+    apiKey?: string;
+    retry?: RetryOptions;
+}
+interface DeviceFlowData {
+    deviceCode: string;
+    userCode: string;
+    verificationUri: string;
+    expiresIn: number;
+}
+interface DeviceFlowStatus {
+    status: string;
+    apiKey?: string;
+}
+interface ParticipantSettings {
+    requireApprovalAbove: number;
+    allowedVendors: string[];
+    dailySpendLimit?: number;
+    autoPauseTriggers: {
+        balanceBelow: number;
+        dailySpendExceeded: boolean;
+        anomalyDetected: boolean;
+    };
+}
+interface Participant {
+    id: string;
+    type: 'agent' | 'human';
+    name: string;
+    description?: string;
+    userId: string;
+    walletAddress: string;
+    chainId: number;
+    walletType: string;
+    settings: ParticipantSettings;
+    status: 'active' | 'paused' | 'frozen';
+    pluginVersion?: string;
+    lastX?: number;
+    lastY?: number;
+    lastSeenAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BalanceResponse {
+    agentId: string;
+    balanceCents: string;
+    currency: string;
+}
+interface OnchainBalanceResponse {
+    agentId: string;
+    walletAddress: string;
+    onchainBalance: string;
+    token: string;
+}
+interface LedgerEntry {
+    id: string;
+    participantId: string;
+    type: string;
+    amountCents: number;
+    currency: string;
+    decimals: number;
+    direction: 'credit' | 'debit';
+    rail: string;
+    transactionHash?: string;
+    blockNumber?: number;
+    confirmations?: number;
+    counterpartyAddress?: string;
+    counterpartyVendor?: string;
+    description: string;
+    category: string;
+    status: string;
+    createdAt: string;
+    confirmedAt?: string;
+}
+interface ApiKeyCreateResponse {
+    id: string;
+    key: string;
+    prefix: string;
+    label?: string;
+    createdAt: string;
+}
+interface ApiKeySummary {
+    id: string;
+    prefix: string;
+    label?: string;
+    lastUsedAt?: string;
+    expiresAt?: string;
+    createdAt: string;
+}
+interface DirectoryServiceEntry {
+    serviceTag: string;
+    description: string;
+    priceCents: number;
+}
+interface DirectoryEntry {
+    participantId: string;
+    name: string;
+    walletAddress: string;
+    services: DirectoryServiceEntry[];
+}
+interface DirectoryResponse {
+    participants: DirectoryEntry[];
+    total: number;
+}
+interface LeaderboardEntry {
+    rank: number;
+    displayId: string;
+    totalAgents: number;
+    totalTransactions: number;
+    totalVolumeCents: string;
+}
+interface HealthCheckResult {
+    ok: boolean;
+}
+
+declare abstract class Resource {
+    protected readonly client: Requestable;
+    constructor(client: Requestable);
+}
+
+declare class AuthResource extends Resource {
+    initiateDeviceFlow(): Promise<DeviceFlowData>;
+    getDeviceFlowStatus(deviceCode: string): Promise<DeviceFlowStatus>;
+    pollForApproval(deviceCode: string, options?: {
+        pollIntervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<string>;
+}
+
+declare class AgentsResource extends Resource {
+    create(options?: {
+        name?: string;
+        description?: string;
+    }): Promise<Participant>;
+}
+
+declare class ParticipantsResource extends Resource {
+    create(options?: {
+        name?: string;
+        description?: string;
+    }): Promise<Participant>;
+    list(): Promise<Participant[]>;
+    get(participantId: string): Promise<Participant>;
+    update(participantId: string, data: {
+        settings?: Partial<ParticipantSettings>;
+        status?: 'active' | 'paused' | 'frozen';
+    }): Promise<Participant>;
+    getBalance(participantId: string): Promise<BalanceResponse>;
+    getOnchainBalance(participantId: string): Promise<OnchainBalanceResponse>;
+    getLedgerEntries(participantId: string): Promise<LedgerEntry[]>;
+    deposit(participantId: string, data: {
+        amountCents: number;
+    }): Promise<LedgerEntry>;
+}
+
+declare class ApiKeysResource extends Resource {
+    create(): Promise<ApiKeyCreateResponse>;
+    list(): Promise<ApiKeySummary[]>;
+    revoke(id: string): Promise<void>;
+}
+
+declare class DirectoryResource extends Resource {
+    list(options?: {
+        serviceTag?: string;
+        name?: string;
+    }): Promise<DirectoryResponse>;
+}
+
+declare class LeaderboardResource extends Resource {
+    get(): Promise<LeaderboardEntry[]>;
+}
+
+declare class HealthResource extends Resource {
+    check(): Promise<HealthCheckResult>;
+}
+
+declare class StamnApiError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+declare class StamnClient implements Requestable {
+    private readonly serverUrl;
+    private apiKey?;
+    private retryOptions;
+    readonly auth: AuthResource;
+    readonly agents: AgentsResource;
+    readonly participants: ParticipantsResource;
+    readonly apiKeys: ApiKeysResource;
+    readonly directory: DirectoryResource;
+    readonly leaderboard: LeaderboardResource;
+    readonly health: HealthResource;
+    constructor(options?: StamnClientOptions);
+    setApiKey(apiKey: string): void;
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    private executeRequest;
+    private isRetryable;
+    private calculateDelay;
+    private sleep;
+    private parseErrorResponse;
+}
+
+export { type ApiKeyCreateResponse, type ApiKeySummary, ApiKeysResource, AuthResource, type BalanceResponse, type DeviceFlowData, type DeviceFlowStatus, type DirectoryEntry, DirectoryResource, type DirectoryResponse, type DirectoryServiceEntry, type HealthCheckResult, HealthResource, type LeaderboardEntry, LeaderboardResource, type LedgerEntry, type OnchainBalanceResponse, type Participant, type ParticipantSettings, ParticipantsResource, type Requestable, Resource, type RetryOptions, StamnApiError, StamnClient, type StamnClientOptions };

package/dist/index.js

@@ -0,0 +1,303 @@
+// src/resources/base.ts
+var Resource = class {
+  constructor(client) {
+    this.client = client;
+  }
+};
+
+// src/resources/auth.ts
+var DEFAULT_POLL_INTERVAL_MS = 5e3;
+var DEFAULT_TIMEOUT_MS = 3e5;
+var AuthResource = class extends Resource {
+  async initiateDeviceFlow() {
+    const res = await this.client.request(
+      "POST",
+      "/v1/auth/device-codes"
+    );
+    return res.data;
+  }
+  async getDeviceFlowStatus(deviceCode) {
+    const res = await this.client.request(
+      "GET",
+      `/v1/auth/device-codes/${deviceCode}`
+    );
+    return res.data;
+  }
+  async pollForApproval(deviceCode, options) {
+    const pollInterval = options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const timeout = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const deadline = Date.now() + timeout;
+    while (Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, pollInterval));
+      try {
+        const status = await this.getDeviceFlowStatus(deviceCode);
+        if (status.status === "approved" && status.apiKey) {
+          return status.apiKey;
+        }
+        if (status.status === "expired") {
+          throw new Error("Login code expired. Try again.");
+        }
+      } catch (err) {
+        if (err.message.includes("expired")) throw err;
+      }
+    }
+    throw new Error("Login timed out. Try again.");
+  }
+};
+
+// src/resources/agents.ts
+var AgentsResource = class extends Resource {
+  async create(options) {
+    const res = await this.client.request(
+      "POST",
+      "/v1/participants",
+      {
+        name: options?.name,
+        description: options?.description
+      }
+    );
+    return res.data;
+  }
+};
+
+// src/resources/participants.ts
+var ParticipantsResource = class extends Resource {
+  async create(options) {
+    const res = await this.client.request(
+      "POST",
+      "/v1/participants",
+      {
+        name: options?.name || void 0,
+        description: options?.description || void 0
+      }
+    );
+    return res.data;
+  }
+  async list() {
+    const res = await this.client.request(
+      "GET",
+      "/v1/participants"
+    );
+    return res.data;
+  }
+  async get(participantId) {
+    const res = await this.client.request(
+      "GET",
+      `/v1/participants/${participantId}`
+    );
+    return res.data;
+  }
+  async update(participantId, data) {
+    const res = await this.client.request(
+      "PATCH",
+      `/v1/participants/${participantId}`,
+      data
+    );
+    return res.data;
+  }
+  async getBalance(participantId) {
+    const res = await this.client.request(
+      "GET",
+      `/v1/participants/${participantId}/balance`
+    );
+    return res.data;
+  }
+  async getOnchainBalance(participantId) {
+    const res = await this.client.request(
+      "GET",
+      `/v1/participants/${participantId}/onchain-balance`
+    );
+    return res.data;
+  }
+  async getLedgerEntries(participantId) {
+    const res = await this.client.request(
+      "GET",
+      `/v1/participants/${participantId}/ledger-entries`
+    );
+    return res.data;
+  }
+  async deposit(participantId, data) {
+    const res = await this.client.request(
+      "POST",
+      `/v1/participants/${participantId}/deposits`,
+      data
+    );
+    return res.data;
+  }
+};
+
+// src/resources/api-keys.ts
+var ApiKeysResource = class extends Resource {
+  async create() {
+    const res = await this.client.request(
+      "POST",
+      "/v1/api-keys"
+    );
+    return res.data;
+  }
+  async list() {
+    const res = await this.client.request(
+      "GET",
+      "/v1/api-keys"
+    );
+    return res.data;
+  }
+  async revoke(id) {
+    await this.client.request("DELETE", `/v1/api-keys/${id}`);
+  }
+};
+
+// src/resources/directory.ts
+var DirectoryResource = class extends Resource {
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.serviceTag) params.set("serviceTag", options.serviceTag);
+    if (options?.name) params.set("name", options.name);
+    const query = params.toString();
+    const path = query ? `/v1/directory?${query}` : "/v1/directory";
+    const res = await this.client.request(
+      "GET",
+      path
+    );
+    return res.data;
+  }
+};
+
+// src/resources/leaderboard.ts
+var LeaderboardResource = class extends Resource {
+  async get() {
+    const res = await this.client.request(
+      "GET",
+      "/v1/leaderboard"
+    );
+    return res.data;
+  }
+};
+
+// src/resources/health.ts
+var HealthResource = class extends Resource {
+  async check() {
+    try {
+      await this.client.request("GET", "/v1/health");
+      return { ok: true };
+    } catch {
+      return { ok: false };
+    }
+  }
+};
+
+// src/client.ts
+var StamnApiError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "StamnApiError";
+  }
+};
+var DEFAULT_RETRY = {
+  maxRetries: 0,
+  initialDelayMs: 500,
+  backoffMultiplier: 2,
+  maxDelayMs: 1e4
+};
+var SERVER_URL = "https://api.stamn.com";
+var StamnClient = class {
+  serverUrl = SERVER_URL;
+  apiKey;
+  retryOptions;
+  auth;
+  agents;
+  participants;
+  apiKeys;
+  directory;
+  leaderboard;
+  health;
+  constructor(options = {}) {
+    this.apiKey = options.apiKey;
+    this.retryOptions = { ...DEFAULT_RETRY, ...options.retry };
+    this.auth = new AuthResource(this);
+    this.agents = new AgentsResource(this);
+    this.participants = new ParticipantsResource(this);
+    this.apiKeys = new ApiKeysResource(this);
+    this.directory = new DirectoryResource(this);
+    this.leaderboard = new LeaderboardResource(this);
+    this.health = new HealthResource(this);
+  }
+  setApiKey(apiKey) {
+    this.apiKey = apiKey;
+  }
+  async request(method, path, body) {
+    let lastError;
+    for (let attempt = 0; attempt <= this.retryOptions.maxRetries; attempt++) {
+      if (attempt > 0) {
+        await this.sleep(this.calculateDelay(attempt - 1));
+      }
+      try {
+        return await this.executeRequest(method, path, body);
+      } catch (error) {
+        lastError = error;
+        if (!this.isRetryable(error) || attempt === this.retryOptions.maxRetries) {
+          throw error;
+        }
+      }
+    }
+    throw lastError;
+  }
+  async executeRequest(method, path, body) {
+    const headers = {};
+    if (body !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    const res = await fetch(`${this.serverUrl}${path}`, {
+      method,
+      headers,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    if (!res.ok) {
+      const message = await this.parseErrorResponse(res);
+      throw new StamnApiError(message, res.status);
+    }
+    const text = await res.text();
+    if (!text) return void 0;
+    return JSON.parse(text);
+  }
+  isRetryable(error) {
+    if (error instanceof TypeError) return true;
+    if (error instanceof StamnApiError && error.status >= 500) return true;
+    if (error instanceof StamnApiError && error.status === 429) return true;
+    return false;
+  }
+  calculateDelay(attempt) {
+    const baseDelay = this.retryOptions.initialDelayMs * Math.pow(this.retryOptions.backoffMultiplier, attempt);
+    const capped = Math.min(baseDelay, this.retryOptions.maxDelayMs);
+    return Math.random() * capped;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  async parseErrorResponse(res) {
+    const body = await res.text();
+    try {
+      const parsed = JSON.parse(body);
+      const msg = parsed.error?.message ?? (Array.isArray(parsed.message) ? parsed.message.join(". ") : parsed.message);
+      if (msg) return msg;
+    } catch {
+    }
+    return body || `HTTP ${res.status}`;
+  }
+};
+export {
+  ApiKeysResource,
+  AuthResource,
+  DirectoryResource,
+  HealthResource,
+  LeaderboardResource,
+  ParticipantsResource,
+  Resource,
+  StamnApiError,
+  StamnClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/base.ts","../src/resources/auth.ts","../src/resources/agents.ts","../src/resources/participants.ts","../src/resources/api-keys.ts","../src/resources/directory.ts","../src/resources/leaderboard.ts","../src/resources/health.ts","../src/client.ts"],"sourcesContent":["import type { Requestable } from '@/types';\n\nexport abstract class Resource {\n  constructor(protected readonly client: Requestable) {}\n}\n","import { Resource } from '@/resources/base';\nimport type { DeviceFlowData, DeviceFlowStatus } from '@/types';\n\nconst DEFAULT_POLL_INTERVAL_MS = 5_000;\nconst DEFAULT_TIMEOUT_MS = 300_000; // 5 minutes\n\nexport class AuthResource extends Resource {\n\n  async initiateDeviceFlow(): Promise<DeviceFlowData> {\n    const res = await this.client.request<{ data: DeviceFlowData }>(\n      'POST',\n      '/v1/auth/device-codes',\n    );\n    return res.data;\n  }\n\n  async getDeviceFlowStatus(deviceCode: string): Promise<DeviceFlowStatus> {\n    const res = await this.client.request<{ data: DeviceFlowStatus }>(\n      'GET',\n      `/v1/auth/device-codes/${deviceCode}`,\n    );\n    return res.data;\n  }\n\n  async pollForApproval(\n    deviceCode: string,\n    options?: { pollIntervalMs?: number; timeoutMs?: number },\n  ): Promise<string> {\n    const pollInterval = options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    const timeout = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    const deadline = Date.now() + timeout;\n\n    while (Date.now() < deadline) {\n      await new Promise((r) => setTimeout(r, pollInterval));\n\n      try {\n        const status = await this.getDeviceFlowStatus(deviceCode);\n\n        if (status.status === 'approved' && status.apiKey) {\n          return status.apiKey;\n        }\n\n        if (status.status === 'expired') {\n          throw new Error('Login code expired. Try again.');\n        }\n      } catch (err) {\n        if ((err as Error).message.includes('expired')) throw err;\n      }\n    }\n\n    throw new Error('Login timed out. Try again.');\n  }\n}\n","import { Resource } from '@/resources/base';\nimport type { Participant } from '@/types';\n\nexport class AgentsResource extends Resource {\n\n  async create(options?: { name?: string; description?: string }): Promise<Participant> {\n    const res = await this.client.request<{ data: Participant }>(\n      'POST',\n      '/v1/participants',\n      {\n        name: options?.name,\n        description: options?.description,\n      },\n    );\n    return res.data;\n  }\n}\n","import { Resource } from '@/resources/base';\nimport type {\n  Participant,\n  ParticipantSettings,\n  BalanceResponse,\n  OnchainBalanceResponse,\n  LedgerEntry,\n} from '@/types';\n\nexport class ParticipantsResource extends Resource {\n\n  async create(options?: { name?: string; description?: string }): Promise<Participant> {\n    const res = await this.client.request<{ data: Participant }>(\n      'POST',\n      '/v1/participants',\n      {\n        name: options?.name || undefined,\n        description: options?.description || undefined,\n      },\n    );\n    return res.data;\n  }\n\n  async list(): Promise<Participant[]> {\n    const res = await this.client.request<{ data: Participant[] }>(\n      'GET',\n      '/v1/participants',\n    );\n    return res.data;\n  }\n\n  async get(participantId: string): Promise<Participant> {\n    const res = await this.client.request<{ data: Participant }>(\n      'GET',\n      `/v1/participants/${participantId}`,\n    );\n    return res.data;\n  }\n\n  async update(\n    participantId: string,\n    data: {\n      settings?: Partial<ParticipantSettings>;\n      status?: 'active' | 'paused' | 'frozen';\n    },\n  ): Promise<Participant> {\n    const res = await this.client.request<{ data: Participant }>(\n      'PATCH',\n      `/v1/participants/${participantId}`,\n      data,\n    );\n    return res.data;\n  }\n\n  async getBalance(participantId: string): Promise<BalanceResponse> {\n    const res = await this.client.request<{ data: BalanceResponse }>(\n      'GET',\n      `/v1/participants/${participantId}/balance`,\n    );\n    return res.data;\n  }\n\n  async getOnchainBalance(participantId: string): Promise<OnchainBalanceResponse> {\n    const res = await this.client.request<{ data: OnchainBalanceResponse }>(\n      'GET',\n      `/v1/participants/${participantId}/onchain-balance`,\n    );\n    return res.data;\n  }\n\n  async getLedgerEntries(participantId: string): Promise<LedgerEntry[]> {\n    const res = await this.client.request<{ data: LedgerEntry[] }>(\n      'GET',\n      `/v1/participants/${participantId}/ledger-entries`,\n    );\n    return res.data;\n  }\n\n  async deposit(\n    participantId: string,\n    data: { amountCents: number },\n  ): Promise<LedgerEntry> {\n    const res = await this.client.request<{ data: LedgerEntry }>(\n      'POST',\n      `/v1/participants/${participantId}/deposits`,\n      data,\n    );\n    return res.data;\n  }\n}\n","import { Resource } from '@/resources/base';\nimport type { ApiKeyCreateResponse, ApiKeySummary } from '@/types';\n\nexport class ApiKeysResource extends Resource {\n\n  async create(): Promise<ApiKeyCreateResponse> {\n    const res = await this.client.request<{ data: ApiKeyCreateResponse }>(\n      'POST',\n      '/v1/api-keys',\n    );\n    return res.data;\n  }\n\n  async list(): Promise<ApiKeySummary[]> {\n    const res = await this.client.request<{ data: ApiKeySummary[] }>(\n      'GET',\n      '/v1/api-keys',\n    );\n    return res.data;\n  }\n\n  async revoke(id: string): Promise<void> {\n    await this.client.request('DELETE', `/v1/api-keys/${id}`);\n  }\n}\n","import { Resource } from '@/resources/base';\nimport type { DirectoryResponse } from '@/types';\n\nexport class DirectoryResource extends Resource {\n\n  async list(options?: { serviceTag?: string; name?: string }): Promise<DirectoryResponse> {\n    const params = new URLSearchParams();\n    if (options?.serviceTag) params.set('serviceTag', options.serviceTag);\n    if (options?.name) params.set('name', options.name);\n    const query = params.toString();\n    const path = query ? `/v1/directory?${query}` : '/v1/directory';\n\n    const res = await this.client.request<{ data: DirectoryResponse }>(\n      'GET',\n      path,\n    );\n    return res.data;\n  }\n}\n","import { Resource } from '@/resources/base';\nimport type { LeaderboardEntry } from '@/types';\n\nexport class LeaderboardResource extends Resource {\n\n  async get(): Promise<LeaderboardEntry[]> {\n    const res = await this.client.request<{ data: LeaderboardEntry[] }>(\n      'GET',\n      '/v1/leaderboard',\n    );\n    return res.data;\n  }\n}\n","import { Resource } from '@/resources/base';\nimport type { HealthCheckResult } from '@/types';\n\nexport class HealthResource extends Resource {\n\n  async check(): Promise<HealthCheckResult> {\n    try {\n      await this.client.request('GET', '/v1/health');\n      return { ok: true };\n    } catch {\n      return { ok: false };\n    }\n  }\n}\n","import type { StamnClientOptions, Requestable } from '@/types';\nimport { AuthResource } from '@/resources/auth';\nimport { AgentsResource } from '@/resources/agents';\nimport { ParticipantsResource } from '@/resources/participants';\nimport { ApiKeysResource } from '@/resources/api-keys';\nimport { DirectoryResource } from '@/resources/directory';\nimport { LeaderboardResource } from '@/resources/leaderboard';\nimport { HealthResource } from '@/resources/health';\n\nexport class StamnApiError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n  ) {\n    super(message);\n    this.name = \"StamnApiError\";\n  }\n}\n\ninterface ResolvedRetryOptions {\n  maxRetries: number;\n  initialDelayMs: number;\n  backoffMultiplier: number;\n  maxDelayMs: number;\n}\n\nconst DEFAULT_RETRY: ResolvedRetryOptions = {\n  maxRetries: 0,\n  initialDelayMs: 500,\n  backoffMultiplier: 2,\n  maxDelayMs: 10_000,\n};\n\nconst SERVER_URL = \"https://api.stamn.com\";\n\nexport class StamnClient implements Requestable {\n  private readonly serverUrl = SERVER_URL;\n  private apiKey?: string;\n  private retryOptions: ResolvedRetryOptions;\n\n  public readonly auth: AuthResource;\n  public readonly agents: AgentsResource;\n  public readonly participants: ParticipantsResource;\n  public readonly apiKeys: ApiKeysResource;\n  public readonly directory: DirectoryResource;\n  public readonly leaderboard: LeaderboardResource;\n  public readonly health: HealthResource;\n\n  constructor(options: StamnClientOptions = {}) {\n    this.apiKey = options.apiKey;\n    this.retryOptions = { ...DEFAULT_RETRY, ...options.retry };\n\n    this.auth = new AuthResource(this);\n    this.agents = new AgentsResource(this);\n    this.participants = new ParticipantsResource(this);\n    this.apiKeys = new ApiKeysResource(this);\n    this.directory = new DirectoryResource(this);\n    this.leaderboard = new LeaderboardResource(this);\n    this.health = new HealthResource(this);\n  }\n\n  setApiKey(apiKey: string): void {\n    this.apiKey = apiKey;\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= this.retryOptions.maxRetries; attempt++) {\n      if (attempt > 0) {\n        await this.sleep(this.calculateDelay(attempt - 1));\n      }\n\n      try {\n        return await this.executeRequest<T>(method, path, body);\n      } catch (error) {\n        lastError = error;\n        if (\n          !this.isRetryable(error) ||\n          attempt === this.retryOptions.maxRetries\n        ) {\n          throw error;\n        }\n      }\n    }\n\n    throw lastError;\n  }\n\n  private async executeRequest<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const headers: Record<string, string> = {};\n\n    if (body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    if (this.apiKey) {\n      headers[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    }\n\n    const res = await fetch(`${this.serverUrl}${path}`, {\n      method,\n      headers,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n\n    if (!res.ok) {\n      const message = await this.parseErrorResponse(res);\n      throw new StamnApiError(message, res.status);\n    }\n\n    const text = await res.text();\n    if (!text) return undefined as T;\n\n    return JSON.parse(text) as T;\n  }\n\n  private isRetryable(error: unknown): boolean {\n    if (error instanceof TypeError) return true;\n    if (error instanceof StamnApiError && error.status >= 500) return true;\n    if (error instanceof StamnApiError && error.status === 429) return true;\n    return false;\n  }\n\n  private calculateDelay(attempt: number): number {\n    const baseDelay =\n      this.retryOptions.initialDelayMs *\n      Math.pow(this.retryOptions.backoffMultiplier, attempt);\n    const capped = Math.min(baseDelay, this.retryOptions.maxDelayMs);\n    return Math.random() * capped;\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  private async parseErrorResponse(res: Response): Promise<string> {\n    const body = await res.text();\n    try {\n      const parsed = JSON.parse(body);\n      const msg =\n        parsed.error?.message ??\n        (Array.isArray(parsed.message)\n          ? parsed.message.join(\". \")\n          : parsed.message);\n      if (msg) return msg;\n    } catch {}\n    return body || `HTTP ${res.status}`;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@stamn/sdk",
+  "version": "0.1.0-alpha.0",
+  "description": "Stamn SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "npm run build"
+  },
+  "tsup": {
+    "entry": [
+      "src/index.ts"
+    ],
+    "format": [
+      "esm"
+    ],
+    "dts": true,
+    "clean": true,
+    "sourcemap": true
+  },
+  "keywords": [
+    "stamn",
+    "sdk"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.18"
+  }
+}