run402 1.40.0 → 1.40.2

package/sdk/dist/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @run402/sdk — typed TypeScript client for the Run402 API.
+ *
+ * This is the isomorphic entry point. Works in Node 22, Deno, Bun, and V8
+ * isolates with no filesystem. For Node consumers that want zero-config
+ * defaults (keystore + allowance + x402), use `@run402/sdk/node` instead.
+ */
+import type { CredentialsProvider } from "./credentials.js";
+import { Projects } from "./namespaces/projects.js";
+import { Blobs } from "./namespaces/blobs.js";
+import { Functions } from "./namespaces/functions.js";
+import { Secrets } from "./namespaces/secrets.js";
+import { Subdomains } from "./namespaces/subdomains.js";
+import { Domains } from "./namespaces/domains.js";
+import { Sites } from "./namespaces/sites.js";
+import { Service } from "./namespaces/service.js";
+import { Tier } from "./namespaces/tier.js";
+import { Allowance } from "./namespaces/allowance.js";
+import { Ai } from "./namespaces/ai.js";
+import { Auth } from "./namespaces/auth.js";
+import { SenderDomain } from "./namespaces/sender-domain.js";
+import { Billing } from "./namespaces/billing.js";
+import { Apps } from "./namespaces/apps.js";
+import { Email } from "./namespaces/email.js";
+import { Contracts } from "./namespaces/contracts.js";
+import { Admin } from "./namespaces/admin.js";
+export interface Run402Options {
+    /** API base URL, e.g. `https://api.run402.com`. */
+    apiBase: string;
+    /** Credential provider. Required — there is no default in the isomorphic entry. */
+    credentials: CredentialsProvider;
+    /**
+     * Custom fetch implementation. Defaults to `globalThis.fetch`. Node consumers
+     * typically pass an x402-wrapped fetch; sandbox consumers may pass a
+     * session-bound fetch provided by their supervisor.
+     */
+    fetch?: typeof globalThis.fetch;
+}
+export declare class Run402 {
+    readonly projects: Projects;
+    readonly blobs: Blobs;
+    readonly functions: Functions;
+    readonly secrets: Secrets;
+    readonly subdomains: Subdomains;
+    readonly domains: Domains;
+    readonly sites: Sites;
+    readonly service: Service;
+    readonly tier: Tier;
+    readonly allowance: Allowance;
+    readonly ai: Ai;
+    readonly auth: Auth;
+    readonly senderDomain: SenderDomain;
+    readonly billing: Billing;
+    readonly apps: Apps;
+    readonly email: Email;
+    readonly contracts: Contracts;
+    readonly admin: Admin;
+    constructor(opts: Run402Options);
+}
+/**
+ * Factory wrapper equivalent to `new Run402(opts)`. Reads better in code-mode
+ * sandbox examples: `const r = run402({ ... })`.
+ */
+export declare function run402(opts: Run402Options): Run402;
+export { Run402Error, PaymentRequired, ProjectNotFound, Unauthorized, ApiError, NetworkError, } from "./errors.js";
+export type { CredentialsProvider, ProjectKeys } from "./credentials.js";
+export type { RequestOptions, Client } from "./kernel.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,WAAW,EAAE,mBAAmB,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAEV,IAAI,EAAE,aAAa;CA0BhC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAElD;AAED,OAAO,EACL,WAAW,EACX,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/sdk/dist/index.js

@@ -0,0 +1,81 @@
+/**
+ * @run402/sdk — typed TypeScript client for the Run402 API.
+ *
+ * This is the isomorphic entry point. Works in Node 22, Deno, Bun, and V8
+ * isolates with no filesystem. For Node consumers that want zero-config
+ * defaults (keystore + allowance + x402), use `@run402/sdk/node` instead.
+ */
+import { buildClient } from "./kernel.js";
+import { Projects } from "./namespaces/projects.js";
+import { Blobs } from "./namespaces/blobs.js";
+import { Functions } from "./namespaces/functions.js";
+import { Secrets } from "./namespaces/secrets.js";
+import { Subdomains } from "./namespaces/subdomains.js";
+import { Domains } from "./namespaces/domains.js";
+import { Sites } from "./namespaces/sites.js";
+import { Service } from "./namespaces/service.js";
+import { Tier } from "./namespaces/tier.js";
+import { Allowance } from "./namespaces/allowance.js";
+import { Ai } from "./namespaces/ai.js";
+import { Auth } from "./namespaces/auth.js";
+import { SenderDomain } from "./namespaces/sender-domain.js";
+import { Billing } from "./namespaces/billing.js";
+import { Apps } from "./namespaces/apps.js";
+import { Email } from "./namespaces/email.js";
+import { Contracts } from "./namespaces/contracts.js";
+import { Admin } from "./namespaces/admin.js";
+export class Run402 {
+    projects;
+    blobs;
+    functions;
+    secrets;
+    subdomains;
+    domains;
+    sites;
+    service;
+    tier;
+    allowance;
+    ai;
+    auth;
+    senderDomain;
+    billing;
+    apps;
+    email;
+    contracts;
+    admin;
+    constructor(opts) {
+        const kernel = {
+            apiBase: opts.apiBase,
+            fetch: opts.fetch ?? globalThis.fetch.bind(globalThis),
+            credentials: opts.credentials,
+        };
+        const client = buildClient(kernel);
+        this.projects = new Projects(client);
+        this.blobs = new Blobs(client);
+        this.functions = new Functions(client);
+        this.secrets = new Secrets(client);
+        this.subdomains = new Subdomains(client);
+        this.domains = new Domains(client);
+        this.sites = new Sites(client);
+        this.service = new Service(client);
+        this.tier = new Tier(client);
+        this.allowance = new Allowance(client);
+        this.ai = new Ai(client);
+        this.auth = new Auth(client);
+        this.senderDomain = new SenderDomain(client);
+        this.billing = new Billing(client);
+        this.apps = new Apps(client);
+        this.email = new Email(client);
+        this.contracts = new Contracts(client);
+        this.admin = new Admin(client);
+    }
+}
+/**
+ * Factory wrapper equivalent to `new Run402(opts)`. Reads better in code-mode
+ * sandbox examples: `const r = run402({ ... })`.
+ */
+export function run402(opts) {
+    return new Run402(opts);
+}
+export { Run402Error, PaymentRequired, ProjectNotFound, Unauthorized, ApiError, NetworkError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/sdk/dist/index.js.map

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

package/sdk/dist/kernel.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Request kernel — the one place in the SDK that touches `fetch`.
+ *
+ * Isomorphic: uses only platform globals, no Node-only APIs. The kernel is
+ * safe to execute inside a V8 isolate where `fs`, `child_process`, and
+ * `process` are absent.
+ *
+ * Failure translation: maps HTTP status codes and network errors to the
+ * appropriate {@link Run402Error} subclass. Callers never see `undefined`
+ * or a response-shaped error value — they either get the parsed body as T
+ * or an exception.
+ */
+import type { CredentialsProvider, ProjectKeys } from "./credentials.js";
+export interface KernelConfig {
+    apiBase: string;
+    fetch: typeof globalThis.fetch;
+    credentials: CredentialsProvider;
+}
+export interface RequestOptions {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    /** Send body as a raw string (e.g. `text/plain` SQL) or bytes, skipping JSON.stringify. */
+    rawBody?: string | Uint8Array;
+    /** Include credential headers from `credentials.getAuth(path)`. Default: true. */
+    withAuth?: boolean;
+    /** Short verb phrase attached to thrown errors (e.g. "provisioning project"). */
+    context: string;
+}
+/** Internal client surface passed to each namespace. */
+export interface Client {
+    /** API base URL, e.g. `https://api.run402.com`. Exposed for namespaces that need to compute derived URLs (e.g. REST endpoints). */
+    readonly apiBase: string;
+    request<T>(path: string, opts: RequestOptions): Promise<T>;
+    getProject(id: string): Promise<ProjectKeys | null>;
+    /** The underlying credentials provider. Namespaces use this to access optional methods (saveProject, setActiveProject, ...). */
+    readonly credentials: CredentialsProvider;
+    /**
+     * The injected fetch (or default `globalThis.fetch`). Namespaces use this
+     * when they need to hit a non-gateway URL — e.g. an S3 presigned URL from
+     * a multipart upload, where auth + apiBase injection would be wrong.
+     */
+    readonly fetch: typeof globalThis.fetch;
+}
+export declare function request<T>(kernel: KernelConfig, path: string, opts: RequestOptions): Promise<T>;
+export declare function buildClient(kernel: KernelConfig): Client;
+//# sourceMappingURL=kernel.d.ts.map

package/sdk/dist/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,MAAM;IACrB,mIAAmI;IACnI,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACpD,gIAAgI;IAChI,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACzC;AAED,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,CAAC,CAAC,CA0EZ;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAQxD"}

package/sdk/dist/kernel.js

@@ -0,0 +1,76 @@
+/**
+ * Request kernel — the one place in the SDK that touches `fetch`.
+ *
+ * Isomorphic: uses only platform globals, no Node-only APIs. The kernel is
+ * safe to execute inside a V8 isolate where `fs`, `child_process`, and
+ * `process` are absent.
+ *
+ * Failure translation: maps HTTP status codes and network errors to the
+ * appropriate {@link Run402Error} subclass. Callers never see `undefined`
+ * or a response-shaped error value — they either get the parsed body as T
+ * or an exception.
+ */
+import { ApiError, NetworkError, PaymentRequired, Unauthorized, } from "./errors.js";
+export async function request(kernel, path, opts) {
+    const { apiBase, fetch, credentials } = kernel;
+    const { method = "GET", headers = {}, body, rawBody, withAuth = true, context } = opts;
+    const url = `${apiBase}${path}`;
+    const fetchHeaders = { ...headers };
+    if (withAuth) {
+        const auth = await credentials.getAuth(path);
+        if (auth) {
+            for (const [k, v] of Object.entries(auth)) {
+                if (!(k in fetchHeaders))
+                    fetchHeaders[k] = v;
+            }
+        }
+    }
+    let fetchBody;
+    if (rawBody !== undefined) {
+        fetchBody = rawBody;
+    }
+    else if (body !== undefined) {
+        if (!("Content-Type" in fetchHeaders) && !("content-type" in fetchHeaders)) {
+            fetchHeaders["Content-Type"] = "application/json";
+        }
+        fetchBody = JSON.stringify(body);
+    }
+    let res;
+    try {
+        res = await fetch(url, {
+            method,
+            headers: fetchHeaders,
+            body: fetchBody,
+        });
+    }
+    catch (err) {
+        throw new NetworkError(`Network error while ${context}: ${err.message}`, err, context);
+    }
+    const ct = res.headers.get("content-type") ?? "";
+    let resBody;
+    if (ct.includes("application/json")) {
+        resBody = await res.json().catch(() => null);
+    }
+    else {
+        resBody = await res.text();
+    }
+    if (res.ok)
+        return resBody;
+    if (res.status === 402) {
+        throw new PaymentRequired(`Payment required while ${context}`, 402, resBody, context);
+    }
+    if (res.status === 401 || res.status === 403) {
+        throw new Unauthorized(`Unauthorized while ${context} (HTTP ${res.status})`, res.status, resBody, context);
+    }
+    throw new ApiError(`API error while ${context} (HTTP ${res.status})`, res.status, resBody, context);
+}
+export function buildClient(kernel) {
+    return {
+        apiBase: kernel.apiBase,
+        request: (path, opts) => request(kernel, path, opts),
+        getProject: (id) => kernel.credentials.getProject(id),
+        credentials: kernel.credentials,
+        fetch: kernel.fetch,
+    };
+}
+//# sourceMappingURL=kernel.js.map

package/sdk/dist/kernel.js.map

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

package/sdk/dist/namespaces/admin.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `admin` namespace — account-level operations that don't belong to any
+ * single resource: sending messages to the operators, registering agent
+ * contact info.
+ *
+ * (The compound `init` and `status` flows live at the MCP/CLI edge because
+ * they stitch together multiple SDK namespaces + local state.)
+ */
+import type { Client } from "../kernel.js";
+export interface AgentContact {
+    name: string;
+    email?: string;
+    webhook?: string;
+}
+export interface AgentContactResult {
+    wallet: string;
+    name: string;
+    email?: string;
+    webhook?: string;
+    updated_at: string;
+}
+export declare class Admin {
+    private readonly client;
+    constructor(client: Client);
+    /** Send a message to the Run402 developers. Requires an active tier. */
+    sendMessage(message: string): Promise<void>;
+    /** Register agent contact info (name, email, webhook). */
+    setAgentContact(contact: AgentContact): Promise<AgentContactResult>;
+}
+//# sourceMappingURL=admin.d.ts.map

package/sdk/dist/namespaces/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/namespaces/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,wEAAwE;IAClE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,0DAA0D;IACpD,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAW1E"}

package/sdk/dist/namespaces/admin.js

@@ -0,0 +1,36 @@
+/**
+ * `admin` namespace — account-level operations that don't belong to any
+ * single resource: sending messages to the operators, registering agent
+ * contact info.
+ *
+ * (The compound `init` and `status` flows live at the MCP/CLI edge because
+ * they stitch together multiple SDK namespaces + local state.)
+ */
+export class Admin {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Send a message to the Run402 developers. Requires an active tier. */
+    async sendMessage(message) {
+        await this.client.request("/message/v1", {
+            method: "POST",
+            body: { message },
+            context: "sending message",
+        });
+    }
+    /** Register agent contact info (name, email, webhook). */
+    async setAgentContact(contact) {
+        const body = { name: contact.name };
+        if (contact.email)
+            body.email = contact.email;
+        if (contact.webhook)
+            body.webhook = contact.webhook;
+        return this.client.request("/agent/v1/contact", {
+            method: "POST",
+            body,
+            context: "setting agent contact",
+        });
+    }
+}
+//# sourceMappingURL=admin.js.map

package/sdk/dist/namespaces/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/namespaces/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,MAAM,OAAO,KAAK;IACa;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,wEAAwE;IACxE,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,aAAa,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,OAAO,EAAE;YACjB,OAAO,EAAE,iBAAiB;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,eAAe,CAAC,OAAqB;QACzC,MAAM,IAAI,GAA2B,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,OAAO,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9C,IAAI,OAAO,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAEpD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB,mBAAmB,EAAE;YAClE,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAC;IACL,CAAC;CACF"}

package/sdk/dist/namespaces/ai.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `ai` namespace — project-scoped AI add-ons (translation, moderation) and
+ * wallet-scoped image generation.
+ */
+import type { Client } from "../kernel.js";
+export interface TranslateOptions {
+    text: string;
+    to: string;
+    from?: string;
+    context?: string;
+}
+export interface TranslateResult {
+    text: string;
+    from: string;
+    to: string;
+}
+export interface ModerateResult {
+    flagged: boolean;
+    categories: Record<string, boolean>;
+    category_scores: Record<string, number>;
+}
+export interface AiUsageResult {
+    translation: {
+        active: boolean;
+        used_words: number;
+        included_words: number;
+        remaining_words: number;
+        billing_cycle_start: string;
+    };
+}
+export type ImageAspect = "square" | "landscape" | "portrait";
+export interface GenerateImageOptions {
+    prompt: string;
+    aspect?: ImageAspect;
+}
+export interface GenerateImageResult {
+    /** Base64-encoded bytes. */
+    image: string;
+    content_type: string;
+    aspect: string;
+}
+export declare class Ai {
+    private readonly client;
+    constructor(client: Client);
+    /** Translate text. Requires the AI Translation add-on on the project. */
+    translate(projectId: string, opts: TranslateOptions): Promise<TranslateResult>;
+    /** Run content moderation on text. Free for all projects; requires service key. */
+    moderate(projectId: string, text: string): Promise<ModerateResult>;
+    /** Get AI translation usage for the current billing cycle. */
+    usage(projectId: string): Promise<AiUsageResult>;
+    /**
+     * Generate an image from a text prompt. Costs $0.03 USDC via x402.
+     * No project scope — payment flows through the allowance-based fetch.
+     */
+    generateImage(opts: GenerateImageOptions): Promise<GenerateImageResult>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/sdk/dist/namespaces/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/namespaces/ai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE;QACX,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,EAAE;IACD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,yEAAyE;IACnE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBpF,mFAAmF;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAYxE,8DAA8D;IACxD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUtD;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAO9E"}

package/sdk/dist/namespaces/ai.js

@@ -0,0 +1,62 @@
+/**
+ * `ai` namespace — project-scoped AI add-ons (translation, moderation) and
+ * wallet-scoped image generation.
+ */
+import { ProjectNotFound } from "../errors.js";
+export class Ai {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Translate text. Requires the AI Translation add-on on the project. */
+    async translate(projectId, opts) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "translating text");
+        const body = { text: opts.text, to: opts.to };
+        if (opts.from)
+            body.from = opts.from;
+        if (opts.context)
+            body.context = opts.context;
+        return this.client.request("/ai/v1/translate", {
+            method: "POST",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body,
+            context: "translating text",
+        });
+    }
+    /** Run content moderation on text. Free for all projects; requires service key. */
+    async moderate(projectId, text) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "moderating content");
+        return this.client.request("/ai/v1/moderate", {
+            method: "POST",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body: { text },
+            context: "moderating content",
+        });
+    }
+    /** Get AI translation usage for the current billing cycle. */
+    async usage(projectId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "fetching AI usage");
+        return this.client.request("/ai/v1/usage", {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "fetching AI usage",
+        });
+    }
+    /**
+     * Generate an image from a text prompt. Costs $0.03 USDC via x402.
+     * No project scope — payment flows through the allowance-based fetch.
+     */
+    async generateImage(opts) {
+        return this.client.request("/generate-image/v1", {
+            method: "POST",
+            body: { prompt: opts.prompt, aspect: opts.aspect ?? "square" },
+            context: "generating image",
+        });
+    }
+}
+//# sourceMappingURL=ai.js.map

package/sdk/dist/namespaces/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/namespaces/ai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA6C/C,MAAM,OAAO,EAAE;IACgB;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,yEAAyE;IACzE,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,IAAsB;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAEvE,MAAM,IAAI,GAA2B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QACtE,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAkB,kBAAkB,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,IAAI;YACJ,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAAY;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAEzE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAiB,iBAAiB,EAAE;YAC5D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,IAAI,EAAE,EAAE,IAAI,EAAE;YACd,OAAO,EAAE,oBAAoB;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;QAExE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAgB,cAAc,EAAE;YACxD,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,OAAO,EAAE,mBAAmB;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,IAA0B;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAsB,oBAAoB,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE;YAC9D,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC;CACF"}

package/sdk/dist/namespaces/allowance.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `allowance` namespace — the agent's local wallet.
+ *
+ * `status`, `create`, `export` touch the local allowance file via optional
+ * provider methods. Sandbox providers that don't implement those throw a
+ * descriptive error at runtime.
+ *
+ * `faucet` is an API call (request testnet USDC) and works in any environment.
+ */
+import type { Client } from "../kernel.js";
+export interface AllowanceStatusResult {
+    address: string;
+    created?: string;
+    funded?: boolean;
+    lastFaucet?: string;
+    path?: string;
+    /** true when the local provider holds an allowance, false otherwise. */
+    configured: boolean;
+}
+export interface AllowanceCreateResult {
+    address: string;
+    created: string;
+    path?: string;
+}
+export interface FaucetResult {
+    transactionHash: string;
+    amount: string;
+    token: string;
+    network: string;
+}
+export declare class Allowance {
+    private readonly client;
+    constructor(client: Client);
+    /** Inspect the local allowance. Returns `{configured: false}` when absent. */
+    status(): Promise<AllowanceStatusResult>;
+    /**
+     * Generate a new allowance keypair and persist it. Throws when the
+     * provider already holds an allowance (don't overwrite silently) or
+     * when the provider doesn't support local allowance management.
+     */
+    create(): Promise<AllowanceCreateResult>;
+    /** Return the allowance address (safe to share). Throws if none is configured. */
+    export(): Promise<string>;
+    /**
+     * Request testnet USDC from the Run402 faucet. When `address` is omitted,
+     * the SDK uses the provider's local allowance address. Updates the
+     * allowance's `funded` flag on success.
+     */
+    faucet(address?: string): Promise<FaucetResult>;
+}
+//# sourceMappingURL=allowance.d.ts.map

package/sdk/dist/namespaces/allowance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.d.ts","sourceRoot":"","sources":["../../src/namespaces/allowance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,8EAA8E;IACxE,MAAM,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAiB9C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,qBAAqB,CAAC;IA4B9C,kFAAkF;IAC5E,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAY/B;;;;OAIG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAyCtD"}