@gamma23/sdk 0.1.0

package/README.md

@@ -0,0 +1,275 @@
+# @gamma23/sdk
+
+Official TypeScript SDK for the **Gamma23** agent payments API. Give your AI agents the ability to spend money safely — with budgets, policy guardrails, and full auditability.
+
+## Installation
+
+```bash
+npm install @gamma23/sdk
+```
+
+```bash
+pnpm add @gamma23/sdk
+```
+
+```bash
+yarn add @gamma23/sdk
+```
+
+> **Requirements:** Node.js 18+ (uses native `fetch`)
+
+## Quick Start
+
+```typescript
+import { Gamma23 } from '@gamma23/sdk';
+
+const gamma23 = new Gamma23({
+  apiKey: process.env.GAMMA23_API_KEY!, // gm23_...
+});
+
+// 1. Create a spend intent
+const intent = await gamma23.spendIntents.create({
+  goal: 'Purchase cloud compute credits',
+  budget: 50.00,
+  currency: 'USD',
+  merchant: 'AWS',
+  category: 'cloud_compute',
+});
+
+console.log(`Intent ${intent.id}: ${intent.status}`);
+// Intent si_abc123: APPROVED
+
+// 2. Execute the approved intent
+if (intent.spendToken) {
+  const result = await gamma23.spendIntents.execute(intent.id, {
+    spendToken: intent.spendToken,
+    mode: 'LIVE',
+  });
+
+  console.log(`Transaction ${result.transactionId}: $${result.amount}`);
+}
+```
+
+## Configuration
+
+```typescript
+const gamma23 = new Gamma23({
+  apiKey: 'gm23_...',          // Required — your API key
+  baseUrl: 'https://...',      // Optional — defaults to GAMMA23_API_URL env var or https://gamma23.app
+  timeout: 30_000,             // Optional — request timeout in ms (default: 30s)
+  maxRetries: 3,               // Optional — retry count for 429/5xx (default: 3)
+});
+```
+
+## API Reference
+
+### Spend Intents
+
+Spend intents are the core primitive — they represent an agent's *intent* to spend money, subject to policy evaluation.
+
+#### `spendIntents.create(params)`
+
+Create a new spend intent for policy evaluation.
+
+```typescript
+const intent = await gamma23.spendIntents.create({
+  goal: 'Book a flight to SF',
+  budget: 500,
+  currency: 'USD',          // optional, defaults to USD
+  merchant: 'United',       // optional
+  category: 'travel',       // optional
+  domain: 'united.com',     // optional
+  metadata: { trip: 'Q1' }, // optional, arbitrary metadata
+  idempotencyKey: 'uniq-1', // optional, prevents duplicate creation
+});
+```
+
+**Returns:** `SpendIntent`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique intent identifier |
+| `status` | `SpendIntentStatus` | `PENDING`, `APPROVED`, `DENIED`, `EXECUTED`, `CANCELLED`, `EXPIRED` |
+| `goal` | `string` | What the agent wants to buy |
+| `budget` | `number` | Maximum spend amount |
+| `currency` | `string` | ISO 4217 currency code |
+| `selectedRail` | `string \| null` | Payment rail selected by policy |
+| `policyDecision` | `string \| null` | Policy engine decision details |
+| `spendToken` | `string` | Token required to execute (present when approved) |
+| `executeUrl` | `string` | URL to execute the intent |
+| `tokenExpiresInSeconds` | `number` | Time until token expires |
+| `spendRequestId` | `string` | Associated spend request ID |
+
+#### `spendIntents.get(id)`
+
+Retrieve a spend intent by ID.
+
+```typescript
+const intent = await gamma23.spendIntents.get('si_abc123');
+```
+
+#### `spendIntents.cancel(id)`
+
+Cancel a pending or approved spend intent.
+
+```typescript
+const cancelled = await gamma23.spendIntents.cancel('si_abc123');
+```
+
+#### `spendIntents.execute(id, params)`
+
+Execute an approved spend intent.
+
+```typescript
+const result = await gamma23.spendIntents.execute('si_abc123', {
+  spendToken: intent.spendToken!,
+  mode: 'LIVE', // MANUAL | MOCK | SIMULATED | LIVE
+});
+```
+
+**Returns:** `ExecuteResult`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `intentId` | `string` | The intent that was executed |
+| `transactionId` | `string` | Unique transaction identifier |
+| `status` | `string` | Transaction status |
+| `amount` | `number` | Amount charged |
+| `currency` | `string` | Currency of the charge |
+| `riskFlags` | `string[]` | Any risk flags raised |
+| `isSimulated` | `boolean` | Whether this was a simulation |
+| `stripeIntentId` | `string` | Stripe PaymentIntent ID (if applicable) |
+| `instructions` | `string` | Manual execution instructions (if MANUAL mode) |
+| `message` | `string` | Human-readable status message |
+
+---
+
+### Payments
+
+Direct payment requests, bypassing the intent flow.
+
+#### `payments.create(params)`
+
+```typescript
+const payment = await gamma23.payments.create({
+  amount: 25.00,
+  merchant: 'Stripe',
+  domain: 'stripe.com',
+  category: 'saas',
+  reason: 'Monthly subscription',
+  evidenceLinks: ['https://example.com/invoice.pdf'],
+  idempotencyKey: 'pay-001',
+});
+```
+
+#### `payments.execute(id, params)`
+
+```typescript
+const result = await gamma23.payments.execute(payment.id, {
+  spendToken: '...',
+  mode: 'LIVE',
+});
+```
+
+---
+
+### Agents
+
+#### `agents.getBudget(agentId)`
+
+Get the current budget status for an agent.
+
+```typescript
+const budget = await gamma23.agents.getBudget('agent_abc');
+
+console.log(`Remaining: $${budget.remainingBudget}`);
+console.log(`Utilization: ${budget.budgetUtilizationPct}%`);
+console.log(`Can spend: ${budget.canSpend}`);
+```
+
+**Returns:** `AgentBudget`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `agentId` | `string` | Agent identifier |
+| `agentName` | `string` | Human-readable agent name |
+| `monthlyBudget` | `number` | Total monthly budget |
+| `currentSpend` | `number` | Amount spent this period |
+| `remainingBudget` | `number` | Budget remaining |
+| `budgetUtilizationPct` | `number` | Percentage of budget used |
+| `canSpend` | `boolean` | Whether the agent can still spend |
+
+---
+
+## Error Handling
+
+All API errors throw a `Gamma23Error` with structured fields:
+
+```typescript
+import { Gamma23, Gamma23Error, Gamma23TimeoutError } from '@gamma23/sdk';
+
+try {
+  await gamma23.spendIntents.create({ goal: '...', budget: 100 });
+} catch (err) {
+  if (err instanceof Gamma23Error) {
+    console.error(`Status: ${err.status}`);        // HTTP status code
+    console.error(`Code: ${err.code}`);             // API error code
+    console.error(`Message: ${err.message}`);       // Human-readable message
+    console.error(`Request ID: ${err.requestId}`);  // For support tickets
+  }
+
+  if (err instanceof Gamma23TimeoutError) {
+    console.error('Request timed out — try increasing the timeout');
+  }
+}
+```
+
+### Error Types
+
+| Class | When |
+|-------|------|
+| `Gamma23Error` | Any non-2xx API response |
+| `Gamma23TimeoutError` | Request exceeded timeout |
+| `Gamma23ConnectionError` | Network / DNS failure |
+
+---
+
+## Retry Behavior
+
+The SDK automatically retries on transient failures (HTTP 429, 5xx) with exponential backoff:
+
+| Attempt | Delay |
+|---------|-------|
+| 1st retry | ~1s + jitter |
+| 2nd retry | ~2s + jitter |
+| 3rd retry | ~4s + jitter |
+
+Customize via `maxRetries`:
+
+```typescript
+const gamma23 = new Gamma23({
+  apiKey: '...',
+  maxRetries: 5, // up to 5 retries
+});
+```
+
+Set `maxRetries: 0` to disable retries entirely.
+
+---
+
+## TypeScript
+
+This SDK is written in TypeScript and ships with full type declarations. All request params and response types are exported:
+
+```typescript
+import type {
+  CreateSpendIntentParams,
+  SpendIntent,
+  ExecuteResult,
+  AgentBudget,
+} from '@gamma23/sdk';
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+import { SpendIntentsResource } from './resources/spend-intents';
+import { PaymentsResource } from './resources/payments';
+import { AgentsResource } from './resources/agents';
+import type { RequestOptions } from './types';
+export interface Gamma23Config {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+export declare class Gamma23 {
+    readonly spendIntents: SpendIntentsResource;
+    readonly payments: PaymentsResource;
+    readonly agents: AgentsResource;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly maxRetries;
+    constructor(config: Gamma23Config);
+    /** @internal */
+    _request<T>(options: RequestOptions): Promise<T>;
+}
+/** Recursively convert camelCase keys to snake_case for outgoing requests. */
+export declare function toSnakeCase(obj: unknown): unknown;
+//# 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":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,qBAAa,OAAO;IAClB,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,aAAa;IAoBjC,gBAAgB;IACV,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAoFvD;AA8BD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAWjD"}

package/dist/client.js

@@ -0,0 +1,134 @@
+import { Gamma23Error, Gamma23TimeoutError, Gamma23ConnectionError } from './errors';
+import { SpendIntentsResource } from './resources/spend-intents';
+import { PaymentsResource } from './resources/payments';
+import { AgentsResource } from './resources/agents';
+const DEFAULT_BASE_URL = 'https://gamma23.app';
+const DEFAULT_TIMEOUT_MS = 30000;
+const DEFAULT_MAX_RETRIES = 3;
+const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
+export class Gamma23 {
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('Missing required apiKey. Pass it via new Gamma23({ apiKey: "gm23_..." })');
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl =
+            config.baseUrl ??
+                (typeof process !== 'undefined' ? process.env?.GAMMA23_API_URL : undefined) ??
+                DEFAULT_BASE_URL;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+        this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.spendIntents = new SpendIntentsResource(this);
+        this.payments = new PaymentsResource(this);
+        this.agents = new AgentsResource(this);
+    }
+    /** @internal */
+    async _request(options) {
+        const url = `${this.baseUrl}${options.path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            'User-Agent': '@gamma23/sdk/0.1.0',
+            ...options.headers,
+        };
+        if (options.idempotencyKey) {
+            headers['Idempotency-Key'] = options.idempotencyKey;
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            if (attempt > 0) {
+                const backoff = Math.min(1000 * 2 ** (attempt - 1), 10000);
+                const jitter = Math.random() * backoff * 0.5;
+                await sleep(backoff + jitter);
+            }
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            try {
+                const response = await fetch(url, {
+                    method: options.method,
+                    headers,
+                    body: options.body != null ? JSON.stringify(options.body) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (response.ok) {
+                    const json = await response.json();
+                    return toCamelCase(json);
+                }
+                const requestId = response.headers.get('x-request-id') ??
+                    response.headers.get('x-gamma23-request-id');
+                let errorBody = {};
+                try {
+                    errorBody = await response.json();
+                }
+                catch {
+                    // non-JSON error body
+                }
+                const message = errorBody.message ??
+                    errorBody.error ??
+                    `Request failed with status ${response.status}`;
+                const code = errorBody.code ?? null;
+                const error = new Gamma23Error(message, response.status, code, requestId);
+                if (!RETRYABLE_STATUS_CODES.has(response.status)) {
+                    throw error;
+                }
+                lastError = error;
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                if (err instanceof Gamma23Error) {
+                    if (!RETRYABLE_STATUS_CODES.has(err.status))
+                        throw err;
+                    lastError = err;
+                }
+                else if (err instanceof DOMException && err.name === 'AbortError') {
+                    lastError = new Gamma23TimeoutError(this.timeout);
+                    if (attempt === this.maxRetries)
+                        throw lastError;
+                }
+                else {
+                    lastError = new Gamma23ConnectionError(err);
+                    if (attempt === this.maxRetries)
+                        throw lastError;
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ── Case conversion helpers ────────────────────────────────────────────
+function snakeToCamel(str) {
+    return str.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+function camelToSnake(str) {
+    return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+/** Recursively convert snake_case keys to camelCase. */
+function toCamelCase(obj) {
+    if (Array.isArray(obj))
+        return obj.map(toCamelCase);
+    if (obj !== null && typeof obj === 'object') {
+        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
+            snakeToCamel(key),
+            toCamelCase(value),
+        ]));
+    }
+    return obj;
+}
+/** Recursively convert camelCase keys to snake_case for outgoing requests. */
+export function toSnakeCase(obj) {
+    if (Array.isArray(obj))
+        return obj.map(toSnakeCase);
+    if (obj !== null && typeof obj === 'object') {
+        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
+            camelToSnake(key),
+            toSnakeCase(value),
+        ]));
+    }
+    return obj;
+}
+//# 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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"}

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class Gamma23Error extends Error {
+    readonly status: number;
+    readonly code: string | null;
+    readonly requestId: string | null;
+    constructor(message: string, status: number, code?: string | null, requestId?: string | null);
+    toString(): string;
+}
+export declare class Gamma23TimeoutError extends Gamma23Error {
+    constructor(timeoutMs: number);
+}
+export declare class Gamma23ConnectionError extends Gamma23Error {
+    constructor(cause: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,GAAG,IAAW,EAC1B,SAAS,GAAE,MAAM,GAAG,IAAW;IAWjC,QAAQ,IAAI,MAAM;CAOnB;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,SAAS,EAAE,MAAM;CAK9B;AAED,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,KAAK,EAAE,OAAO;CAO3B"}

package/dist/errors.js

@@ -0,0 +1,35 @@
+export class Gamma23Error extends Error {
+    constructor(message, status, code = null, requestId = null) {
+        super(message);
+        this.name = 'Gamma23Error';
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+        Object.setPrototypeOf(this, Gamma23Error.prototype);
+    }
+    toString() {
+        const parts = [`Gamma23Error [${this.status}]`];
+        if (this.code)
+            parts.push(`(${this.code})`);
+        parts.push(`: ${this.message}`);
+        if (this.requestId)
+            parts.push(` (request_id: ${this.requestId})`);
+        return parts.join('');
+    }
+}
+export class Gamma23TimeoutError extends Gamma23Error {
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`, 0, 'TIMEOUT');
+        this.name = 'Gamma23TimeoutError';
+        Object.setPrototypeOf(this, Gamma23TimeoutError.prototype);
+    }
+}
+export class Gamma23ConnectionError extends Gamma23Error {
+    constructor(cause) {
+        const message = cause instanceof Error ? cause.message : 'Connection failed';
+        super(message, 0, 'CONNECTION_ERROR');
+        this.name = 'Gamma23ConnectionError';
+        Object.setPrototypeOf(this, Gamma23ConnectionError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAKrC,YACE,OAAe,EACf,MAAc,EACd,OAAsB,IAAI,EAC1B,YAA2B,IAAI;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,CAAC,iBAAiB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,YAAY,SAAiB;QAC3B,KAAK,CAAC,2BAA2B,SAAS,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD,YAAY,KAAc;QACxB,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC;QAC/D,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { Gamma23 } from './client';
+export type { Gamma23Config } from './client';
+export { Gamma23Error, Gamma23TimeoutError, Gamma23ConnectionError } from './errors';
+export { SpendIntentsResource } from './resources/spend-intents';
+export { PaymentsResource } from './resources/payments';
+export { AgentsResource } from './resources/agents';
+export type { CreateSpendIntentParams, SpendIntent, SpendIntentStatus, ExecuteSpendIntentParams, ExecuteResult, CreatePaymentParams, PaymentRequest, ExecutePaymentParams, AgentBudget, RequestOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAErF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,YAAY,EACV,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Gamma23 } from './client';
+export { Gamma23Error, Gamma23TimeoutError, Gamma23ConnectionError } from './errors';
+export { SpendIntentsResource } from './resources/spend-intents';
+export { PaymentsResource } from './resources/payments';
+export { AgentsResource } from './resources/agents';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAErF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/resources/agents.d.ts

@@ -0,0 +1,8 @@
+import type { Gamma23 } from '../client';
+import type { AgentBudget } from '../types';
+export declare class AgentsResource {
+    private readonly client;
+    constructor(client: Gamma23);
+    getBudget(agentId: string): Promise<AgentBudget>;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/resources/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/resources/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAEtC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAMvD"}

package/dist/resources/agents.js

@@ -0,0 +1,12 @@
+export class AgentsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async getBudget(agentId) {
+        return this.client._request({
+            method: 'GET',
+            path: `/api/v1/agents/${encodeURIComponent(agentId)}/budget`,
+        });
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/resources/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/resources/agents.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IACzB,YAA6B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEhD,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAc;YACvC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,OAAO,CAAC,SAAS;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/index.d.ts

@@ -0,0 +1,4 @@
+export { SpendIntentsResource } from './spend-intents';
+export { PaymentsResource } from './payments';
+export { AgentsResource } from './agents';
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,4 @@
+export { SpendIntentsResource } from './spend-intents';
+export { PaymentsResource } from './payments';
+export { AgentsResource } from './agents';
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/resources/payments.d.ts

@@ -0,0 +1,9 @@
+import type { Gamma23 } from '../client';
+import type { CreatePaymentParams, PaymentRequest, ExecutePaymentParams, ExecuteResult } from '../types';
+export declare class PaymentsResource {
+    private readonly client;
+    constructor(client: Gamma23);
+    create(params: CreatePaymentParams): Promise<PaymentRequest>;
+    execute(id: string, params: ExecutePaymentParams): Promise<ExecuteResult>;
+}
+//# sourceMappingURL=payments.d.ts.map

package/dist/resources/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/resources/payments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAEtC,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAU5D,OAAO,CACX,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,aAAa,CAAC;CAO1B"}

package/dist/resources/payments.js

@@ -0,0 +1,23 @@
+import { toSnakeCase } from '../client';
+export class PaymentsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params) {
+        const { idempotencyKey, ...body } = params;
+        return this.client._request({
+            method: 'POST',
+            path: '/api/v1/payments',
+            body: toSnakeCase(body),
+            idempotencyKey,
+        });
+    }
+    async execute(id, params) {
+        return this.client._request({
+            method: 'POST',
+            path: `/api/v1/payments/${encodeURIComponent(id)}/execute`,
+            body: toSnakeCase(params),
+        });
+    }
+}
+//# sourceMappingURL=payments.js.map

package/dist/resources/payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.js","sourceRoot":"","sources":["../../src/resources/payments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQxC,MAAM,OAAO,gBAAgB;IAC3B,YAA6B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEhD,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAiB;YAC1C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;YACvB,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CACX,EAAU,EACV,MAA4B;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAgB;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,UAAU;YAC1D,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/spend-intents.d.ts

@@ -0,0 +1,11 @@
+import type { Gamma23 } from '../client';
+import type { CreateSpendIntentParams, SpendIntent, ExecuteSpendIntentParams, ExecuteResult } from '../types';
+export declare class SpendIntentsResource {
+    private readonly client;
+    constructor(client: Gamma23);
+    create(params: CreateSpendIntentParams): Promise<SpendIntent>;
+    get(id: string): Promise<SpendIntent>;
+    cancel(id: string): Promise<SpendIntent>;
+    execute(id: string, params: ExecuteSpendIntentParams): Promise<ExecuteResult>;
+}
+//# sourceMappingURL=spend-intents.d.ts.map

package/dist/resources/spend-intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-intents.d.ts","sourceRoot":"","sources":["../../src/resources/spend-intents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,wBAAwB,EACxB,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAEtC,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAU7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOxC,OAAO,CACX,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,aAAa,CAAC;CAO1B"}

package/dist/resources/spend-intents.js

@@ -0,0 +1,35 @@
+import { toSnakeCase } from '../client';
+export class SpendIntentsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params) {
+        const { idempotencyKey, ...body } = params;
+        return this.client._request({
+            method: 'POST',
+            path: '/api/v1/spend-intents',
+            body: toSnakeCase(body),
+            idempotencyKey,
+        });
+    }
+    async get(id) {
+        return this.client._request({
+            method: 'GET',
+            path: `/api/v1/spend-intents/${encodeURIComponent(id)}`,
+        });
+    }
+    async cancel(id) {
+        return this.client._request({
+            method: 'POST',
+            path: `/api/v1/spend-intents/${encodeURIComponent(id)}/cancel`,
+        });
+    }
+    async execute(id, params) {
+        return this.client._request({
+            method: 'POST',
+            path: `/api/v1/spend-intents/${encodeURIComponent(id)}/execute`,
+            body: toSnakeCase(params),
+        });
+    }
+}
+//# sourceMappingURL=spend-intents.js.map

package/dist/resources/spend-intents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-intents.js","sourceRoot":"","sources":["../../src/resources/spend-intents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQxC,MAAM,OAAO,oBAAoB;IAC/B,YAA6B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEhD,KAAK,CAAC,MAAM,CAAC,MAA+B;QAC1C,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAc;YACvC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;YACvB,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAc;YACvC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,kBAAkB,CAAC,EAAE,CAAC,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAc;YACvC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,yBAAyB,kBAAkB,CAAC,EAAE,CAAC,SAAS;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CACX,EAAU,EACV,MAAgC;QAEhC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAgB;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,yBAAyB,kBAAkB,CAAC,EAAE,CAAC,UAAU;YAC/D,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export interface CreateSpendIntentParams {
+    goal: string;
+    budget: number;
+    currency?: string;
+    merchant?: string;
+    category?: string;
+    domain?: string;
+    metadata?: Record<string, unknown>;
+    idempotencyKey?: string;
+}
+export type SpendIntentStatus = 'PENDING' | 'APPROVED' | 'DENIED' | 'EXECUTED' | 'CANCELLED' | 'EXPIRED';
+export interface SpendIntent {
+    id: string;
+    status: SpendIntentStatus;
+    goal: string;
+    budget: number;
+    currency: string;
+    selectedRail: string | null;
+    policyDecision: string | null;
+    spendToken?: string;
+    executeUrl?: string;
+    tokenExpiresInSeconds?: number;
+    spendRequestId?: string;
+}
+export interface ExecuteSpendIntentParams {
+    spendToken: string;
+    mode?: 'MANUAL' | 'MOCK' | 'SIMULATED' | 'LIVE';
+}
+export interface ExecuteResult {
+    intentId: string;
+    transactionId: string;
+    status: string;
+    amount: number;
+    currency: string;
+    riskFlags: string[];
+    isSimulated?: boolean;
+    stripeIntentId?: string;
+    instructions?: string;
+    message?: string;
+}
+export interface CreatePaymentParams {
+    amount: number;
+    merchant: string;
+    domain?: string;
+    category?: string;
+    reason?: string;
+    evidenceLinks?: string[];
+    idempotencyKey?: string;
+}
+export interface PaymentRequest {
+    id: string;
+    status: string;
+    amount: number;
+    merchant: string;
+    domain?: string;
+    category?: string;
+    reason?: string;
+    evidenceLinks?: string[];
+}
+export interface ExecutePaymentParams {
+    spendToken: string;
+    mode?: 'MANUAL' | 'MOCK' | 'SIMULATED' | 'LIVE';
+}
+export interface AgentBudget {
+    agentId: string;
+    agentName: string;
+    monthlyBudget: number;
+    currentSpend: number;
+    remainingBudget: number;
+    budgetUtilizationPct: number;
+    canSpend: boolean;
+}
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    idempotencyKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Spend Intents ──────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0EAA0E"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@gamma23/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the Gamma23 agent payments API",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "gamma23",
+    "payments",
+    "ai-agents",
+    "spend-intents",
+    "sdk",
+    "typescript"
+  ],
+  "author": "Gamma23",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gamma23/sdk-typescript"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  }
+}