@ampersend_ai/ampersend-sdk 0.0.22 → 0.0.25

package/dist/ampersend/agent-client.d.ts

@@ -0,0 +1,81 @@
+import { AgentActivityResponse, AgentAutoCollectConfigDTO, AgentFundingLinkDTO, AgentOwnerDTO, AgentSelfDTO, AgentSelfPaymentDTO, AgentSelfSpendConfigDTO } from "./agent.ts";
+import { ApiClient } from "./client.ts";
+import { Address, type ApiClientOptions } from "./types.ts";
+export interface AgentReadClientOptions extends ApiClientOptions {
+}
+/**
+ * Read-only client for an agent's own state on the Ampersend service.
+ *
+ * Wraps the `/v1/agents/self/*` endpoints. Auth is the standard
+ * agent SIWE session token, reused from {@link ApiClient}; the session
+ * pins which agent the server will answer for, so none of these methods
+ * take an agent address.
+ *
+ * Each response is decoded against the canonical DTO from `./agent.ts`.
+ * The server imports those same DTOs, so there is no drift surface
+ * between client and server for the agent-led read endpoints.
+ *
+ * @example
+ * ```ts
+ * const agent = new AgentReadClient({
+ *   baseUrl: "https://api.ampersend.ai",
+ *   agentAddress,
+ *   sessionKeyPrivateKey,
+ * })
+ * const snapshot = await agent.getSelf()
+ * const limits = await agent.getSpendConfig()
+ * const payments = await agent.getPayments({ preset: "30d" })
+ * ```
+ */
+export declare class AgentReadClient {
+    private api;
+    /**
+     * Construct from credentials (production path) or from an existing
+     * `ApiClient` (test path / sharing auth state with another SDK client).
+     * Discriminates on shape, not `instanceof` — test doubles never satisfy
+     * `instanceof ApiClient` but do expose `getAuthorized`.
+     */
+    constructor(input: AgentReadClientOptions | ApiClient);
+    /** Full snapshot: agent record + live USDC balance. */
+    getSelf(): Promise<AgentSelfDTO>;
+    /**
+     * Spend policy (per-tx / daily / monthly limits, auto-topup) plus live
+     * remaining budgets. Throws `ApiError` with `status === 404` when no
+     * spend policy exists for this agent.
+     */
+    getSpendConfig(): Promise<AgentSelfSpendConfigDTO>;
+    /**
+     * Auto-collect (earnings sweep) configuration. Throws `ApiError` with
+     * `status === 404` when no auto-collect configuration exists for this
+     * agent.
+     */
+    getAutoCollectConfig(): Promise<AgentAutoCollectConfigDTO>;
+    /** Seller allowlist this agent is permitted to pay. */
+    getAuthorizedSellers(): Promise<ReadonlyArray<Address>>;
+    /** Outgoing payments. `preset` selects the timerange (default: 30d). */
+    getPayments(params?: {
+        preset?: "1d" | "30d" | "all";
+    }): Promise<ReadonlyArray<AgentSelfPaymentDTO>>;
+    /** Unified spend + earn activity, paginated. */
+    getActivity(params?: {
+        preset?: string;
+        limit?: number;
+        page?: number;
+    }): Promise<AgentActivityResponse>;
+    /** Narrow owner projection: `{ user_id, wallet_address }`. */
+    getOwner(): Promise<AgentOwnerDTO>;
+    /**
+     * Build a dashboard `/fund` URL the user can open to add USDC. The server
+     * is a pure URL formatter — no DB row, no token, no side effects. The
+     * returned URL preselects the calling agent (`destination: "agent"`, default)
+     * or the owner's main account (`destination: "main"`).
+     *
+     * `amount` is a decimal USDC string, strictly validated server-side as
+     * positive, ≤6 fractional digits, no leading zeros.
+     */
+    getFundingLink(params?: {
+        amount?: string;
+        destination?: "agent" | "main";
+    }): Promise<AgentFundingLinkDTO>;
+}
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/ampersend/agent-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../src/ampersend/agent-client.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;CAAG;AAEnE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAW;IAEtB;;;;;OAKG;gBACS,KAAK,EAAE,sBAAsB,GAAG,SAAS;IAIrD,uDAAuD;IACvD,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAIhC;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAIlD;;;;OAIG;IACH,oBAAoB,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAI1D,uDAAuD;IACvD,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAIvD,wEAAwE;IACxE,WAAW,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAKxG,gDAAgD;IAChD,WAAW,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAS5G,8DAA8D;IAC9D,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAIlC;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAO/G"}

package/dist/ampersend/agent-client.js

@@ -0,0 +1,104 @@
+import { Schema } from "effect";
+import { AgentActivityResponse, AgentAutoCollectConfigDTO, AgentFundingLinkDTO, AgentOwnerDTO, AgentSelfDTO, AgentSelfPaymentDTO, AgentSelfSpendConfigDTO, } from "./agent.js";
+import { ApiClient } from "./client.js";
+import { Address } from "./types.js";
+/**
+ * Read-only client for an agent's own state on the Ampersend service.
+ *
+ * Wraps the `/v1/agents/self/*` endpoints. Auth is the standard
+ * agent SIWE session token, reused from {@link ApiClient}; the session
+ * pins which agent the server will answer for, so none of these methods
+ * take an agent address.
+ *
+ * Each response is decoded against the canonical DTO from `./agent.ts`.
+ * The server imports those same DTOs, so there is no drift surface
+ * between client and server for the agent-led read endpoints.
+ *
+ * @example
+ * ```ts
+ * const agent = new AgentReadClient({
+ *   baseUrl: "https://api.ampersend.ai",
+ *   agentAddress,
+ *   sessionKeyPrivateKey,
+ * })
+ * const snapshot = await agent.getSelf()
+ * const limits = await agent.getSpendConfig()
+ * const payments = await agent.getPayments({ preset: "30d" })
+ * ```
+ */
+export class AgentReadClient {
+    api;
+    /**
+     * Construct from credentials (production path) or from an existing
+     * `ApiClient` (test path / sharing auth state with another SDK client).
+     * Discriminates on shape, not `instanceof` — test doubles never satisfy
+     * `instanceof ApiClient` but do expose `getAuthorized`.
+     */
+    constructor(input) {
+        this.api = "getAuthorized" in input ? input : new ApiClient(input);
+    }
+    /** Full snapshot: agent record + live USDC balance. */
+    getSelf() {
+        return this.api.getAuthorized("/api/v1/agents/self", AgentSelfDTO);
+    }
+    /**
+     * Spend policy (per-tx / daily / monthly limits, auto-topup) plus live
+     * remaining budgets. Throws `ApiError` with `status === 404` when no
+     * spend policy exists for this agent.
+     */
+    getSpendConfig() {
+        return this.api.getAuthorized("/api/v1/agents/self/spend-config", AgentSelfSpendConfigDTO);
+    }
+    /**
+     * Auto-collect (earnings sweep) configuration. Throws `ApiError` with
+     * `status === 404` when no auto-collect configuration exists for this
+     * agent.
+     */
+    getAutoCollectConfig() {
+        return this.api.getAuthorized("/api/v1/agents/self/auto-collect-config", AgentAutoCollectConfigDTO);
+    }
+    /** Seller allowlist this agent is permitted to pay. */
+    getAuthorizedSellers() {
+        return this.api.getAuthorized("/api/v1/agents/self/authorized-sellers", Schema.Array(Address));
+    }
+    /** Outgoing payments. `preset` selects the timerange (default: 30d). */
+    getPayments(params = {}) {
+        const qs = params.preset ? `?preset=${params.preset}` : "";
+        return this.api.getAuthorized(`/api/v1/agents/self/payments${qs}`, Schema.Array(AgentSelfPaymentDTO));
+    }
+    /** Unified spend + earn activity, paginated. */
+    getActivity(params = {}) {
+        const qs = new URLSearchParams();
+        if (params.preset)
+            qs.set("preset", params.preset);
+        if (params.limit != null)
+            qs.set("limit", String(params.limit));
+        if (params.page != null)
+            qs.set("page", String(params.page));
+        const suffix = qs.toString();
+        return this.api.getAuthorized(`/api/v1/agents/self/activity${suffix ? `?${suffix}` : ""}`, AgentActivityResponse);
+    }
+    /** Narrow owner projection: `{ user_id, wallet_address }`. */
+    getOwner() {
+        return this.api.getAuthorized("/api/v1/agents/self/owner", AgentOwnerDTO);
+    }
+    /**
+     * Build a dashboard `/fund` URL the user can open to add USDC. The server
+     * is a pure URL formatter — no DB row, no token, no side effects. The
+     * returned URL preselects the calling agent (`destination: "agent"`, default)
+     * or the owner's main account (`destination: "main"`).
+     *
+     * `amount` is a decimal USDC string, strictly validated server-side as
+     * positive, ≤6 fractional digits, no leading zeros.
+     */
+    getFundingLink(params = {}) {
+        const qs = new URLSearchParams();
+        if (params.amount != null)
+            qs.set("amount", params.amount);
+        if (params.destination != null)
+            qs.set("destination", params.destination);
+        const suffix = qs.toString();
+        return this.api.getAuthorized(`/api/v1/agents/self/funding-link${suffix ? `?${suffix}` : ""}`, AgentFundingLinkDTO);
+    }
+}
+//# sourceMappingURL=agent-client.js.map

package/dist/ampersend/agent-client.js.map

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

package/dist/ampersend/agent.d.ts

@@ -0,0 +1,119 @@
+import { Schema } from "effect";
+/**
+ * Full agent snapshot with live USDC balance.
+ *
+ * All bigint amounts on `AgentSelf*` DTOs are micro-USDC (1 USDC = 10^6). The
+ * `_usdc_micro` suffix makes the unit explicit at the wire-format boundary.
+ * Note: parent DTOs shared with the dashboard (`AgentSpendConfigDTO`,
+ * `AgentAutoCollectConfigDTO`) keep their unsuffixed names to avoid breaking
+ * existing dashboard consumers; new agent-facing fields adopt the convention.
+ */
+export declare const AgentSelfDTO: Schema.Struct<{
+    address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+    name: typeof Schema.NonEmptyTrimmedString;
+    slug: Schema.NullOr<typeof Schema.NonEmptyTrimmedString>;
+    status: Schema.Literal<["deploying", "deployed", "failed"]>;
+    published: typeof Schema.Boolean;
+    registry_id: Schema.NullOr<typeof Schema.NonEmptyTrimmedString>;
+    registry_uri: Schema.NullOr<typeof Schema.NonEmptyTrimmedString>;
+    balance_usdc_micro: typeof Schema.BigInt;
+}>;
+export type AgentSelfDTO = typeof AgentSelfDTO.Type;
+/** Spend policy (per-tx / daily / monthly limits, auto-topup). */
+export declare const AgentSpendConfigDTO: Schema.Struct<{
+    agent_address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+    daily_limit: Schema.NullOr<typeof Schema.BigInt>;
+    monthly_limit: Schema.NullOr<typeof Schema.BigInt>;
+    per_transaction_limit: Schema.NullOr<typeof Schema.BigInt>;
+    auto_topup_allowed: typeof Schema.Boolean;
+    created_at: Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>;
+    updated_at: Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>;
+}>;
+export type AgentSpendConfigDTO = typeof AgentSpendConfigDTO.Type;
+/**
+ * Spend policy plus live remaining-budget figures for the calling agent.
+ * `daily_remaining` / `monthly_remaining` are `null` when the corresponding
+ * `*_limit` isn't set (i.e. unlimited).
+ */
+export declare const AgentSelfSpendConfigDTO: Schema.extend<Schema.Struct<{
+    agent_address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+    daily_limit: Schema.NullOr<typeof Schema.BigInt>;
+    monthly_limit: Schema.NullOr<typeof Schema.BigInt>;
+    per_transaction_limit: Schema.NullOr<typeof Schema.BigInt>;
+    auto_topup_allowed: typeof Schema.Boolean;
+    created_at: Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>;
+    updated_at: Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>;
+}>, Schema.Struct<{
+    daily_remaining_usdc_micro: Schema.NullOr<typeof Schema.BigInt>;
+    monthly_remaining_usdc_micro: Schema.NullOr<typeof Schema.BigInt>;
+}>>;
+export type AgentSelfSpendConfigDTO = typeof AgentSelfSpendConfigDTO.Type;
+/** Auto-collect (earnings sweep) configuration. */
+export declare const AgentAutoCollectConfigDTO: Schema.Struct<{
+    agent_address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+    enabled: typeof Schema.Boolean;
+    target_address: Schema.NullOr<Schema.refine<string, typeof Schema.NonEmptyTrimmedString>>;
+    threshold: typeof Schema.BigInt;
+    minimum_remaining: Schema.NullOr<typeof Schema.BigInt>;
+    created_at: Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>;
+    updated_at: Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>;
+}>;
+export type AgentAutoCollectConfigDTO = typeof AgentAutoCollectConfigDTO.Type;
+/** Outgoing payment as exposed to the calling agent (excludes signature, EIP-3009 nonce, internal row id, signing-key details). */
+export declare const AgentSelfPaymentDTO: Schema.Struct<{
+    seller_address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+    amount_usdc_micro: typeof Schema.BigInt;
+    scheme: Schema.NullOr<Schema.Literal<["exact", "deferred"]>>;
+    status: Schema.Literal<["requested", "authorized", "denied", "settled", "expired", "unmanaged", "success", "failure", "pending"]>;
+    tx_hash: Schema.NullOr<Schema.filter<typeof Schema.NonEmptyTrimmedString>>;
+    chain_caip2id: Schema.NullOr<Schema.filter<typeof Schema.NonEmptyTrimmedString>>;
+    created_at: Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>;
+    expires_at: Schema.NullOr<Schema.Union<[Schema.refine<number, typeof Schema.NonNegative>, Schema.filter<Schema.filter<typeof Schema.NumberFromString>>]>>;
+}>;
+export type AgentSelfPaymentDTO = typeof AgentSelfPaymentDTO.Type;
+/** Single row in the unified spend + earn activity feed. */
+export declare const UnifiedAgentActivityDTO: Schema.Struct<{
+    type: Schema.Literal<["earn", "spend"]>;
+    id: typeof Schema.String;
+    agent_address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+    receiver: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+    amount: Schema.Union<[typeof Schema.Number, typeof Schema.NumberFromString]>;
+    status: Schema.Literal<["received", "settled", "authorized", "failed", "denied"]>;
+    timestamp: typeof Schema.BigInt;
+    tx_hash: Schema.NullOr<typeof Schema.String>;
+    chain_caip2id: Schema.NullOr<typeof Schema.String>;
+}>;
+export type UnifiedAgentActivityDTO = typeof UnifiedAgentActivityDTO.Type;
+/** Paginated unified spend + earn activity response. */
+export declare const AgentActivityResponse: Schema.Struct<{
+    activity: Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["earn", "spend"]>;
+        id: typeof Schema.String;
+        agent_address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+        receiver: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+        amount: Schema.Union<[typeof Schema.Number, typeof Schema.NumberFromString]>;
+        status: Schema.Literal<["received", "settled", "authorized", "failed", "denied"]>;
+        timestamp: typeof Schema.BigInt;
+        tx_hash: Schema.NullOr<typeof Schema.String>;
+        chain_caip2id: Schema.NullOr<typeof Schema.String>;
+    }>>;
+    hasNextPage: typeof Schema.Boolean;
+    totalCount: Schema.refine<number, typeof Schema.NonNegative>;
+}>;
+export type AgentActivityResponse = typeof AgentActivityResponse.Type;
+/** Narrow owner projection: `{ user_id, wallet_address }` — no email, sibling agents, or cross-agent aggregates. */
+export declare const AgentOwnerDTO: Schema.Struct<{
+    user_id: Schema.brand<typeof Schema.UUID, "ID">;
+    wallet_address: Schema.refine<string, typeof Schema.NonEmptyTrimmedString>;
+}>;
+export type AgentOwnerDTO = typeof AgentOwnerDTO.Type;
+/**
+ * Funding link the agent can present to its owner. The URL points at the
+ * dashboard's `/fund` page, prefilled per the requested destination. Pure
+ * URL formatter on the server — no DB row, no token, no side effects.
+ */
+export declare const AgentFundingLinkDTO: Schema.Struct<{
+    url: typeof Schema.String;
+}>;
+export type AgentFundingLinkDTO = typeof AgentFundingLinkDTO.Type;
+//# sourceMappingURL=agent.d.ts.map

package/dist/ampersend/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/ampersend/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAY/B;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;;EASvB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;EAQ9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;GAMnC,CAAA;AACD,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEzE,mDAAmD;AACnD,eAAO,MAAM,yBAAyB;;;;;;;;EAQpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA;AAE7E,mIAAmI;AACnI,eAAO,MAAM,mBAAmB;;;;;;;;;EAmB9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB;;;;;;;;;;EAUlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEzE,wDAAwD;AACxD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;EAIhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAErE,oHAAoH;AACpH,eAAO,MAAM,aAAa;;;EAGxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;EAE9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA"}

package/dist/ampersend/agent.js

@@ -0,0 +1,99 @@
+import { Schema } from "effect";
+import { Address, Caip2ID, ConvertedTimestamp, ID, Scheme, TxHash } from "./types.js";
+// Response DTOs for `/v1/agents/self/*`. These are the canonical wire shapes
+// for the agent-led read surface: the closed-source server imports them from
+// this file (via `@ampersend_ai/ampersend-sdk/ampersend`) rather than defining
+// its own copies. Keep field sets stable — adding/removing a field here is a
+// breaking change for both SDK consumers and server callers.
+const DeploymentStatus = Schema.Literal("deploying", "deployed", "failed");
+/**
+ * Full agent snapshot with live USDC balance.
+ *
+ * All bigint amounts on `AgentSelf*` DTOs are micro-USDC (1 USDC = 10^6). The
+ * `_usdc_micro` suffix makes the unit explicit at the wire-format boundary.
+ * Note: parent DTOs shared with the dashboard (`AgentSpendConfigDTO`,
+ * `AgentAutoCollectConfigDTO`) keep their unsuffixed names to avoid breaking
+ * existing dashboard consumers; new agent-facing fields adopt the convention.
+ */
+export const AgentSelfDTO = Schema.Struct({
+    address: Address,
+    name: Schema.NonEmptyTrimmedString,
+    slug: Schema.NullOr(Schema.NonEmptyTrimmedString),
+    status: DeploymentStatus,
+    published: Schema.Boolean,
+    registry_id: Schema.NullOr(Schema.NonEmptyTrimmedString),
+    registry_uri: Schema.NullOr(Schema.NonEmptyTrimmedString),
+    balance_usdc_micro: Schema.BigInt,
+});
+/** Spend policy (per-tx / daily / monthly limits, auto-topup). */
+export const AgentSpendConfigDTO = Schema.Struct({
+    agent_address: Address,
+    daily_limit: Schema.NullOr(Schema.BigInt),
+    monthly_limit: Schema.NullOr(Schema.BigInt),
+    per_transaction_limit: Schema.NullOr(Schema.BigInt),
+    auto_topup_allowed: Schema.Boolean,
+    created_at: ConvertedTimestamp,
+    updated_at: ConvertedTimestamp,
+});
+/**
+ * Spend policy plus live remaining-budget figures for the calling agent.
+ * `daily_remaining` / `monthly_remaining` are `null` when the corresponding
+ * `*_limit` isn't set (i.e. unlimited).
+ */
+export const AgentSelfSpendConfigDTO = Schema.extend(AgentSpendConfigDTO, Schema.Struct({
+    daily_remaining_usdc_micro: Schema.NullOr(Schema.BigInt),
+    monthly_remaining_usdc_micro: Schema.NullOr(Schema.BigInt),
+}));
+/** Auto-collect (earnings sweep) configuration. */
+export const AgentAutoCollectConfigDTO = Schema.Struct({
+    agent_address: Address,
+    enabled: Schema.Boolean,
+    target_address: Schema.NullOr(Address),
+    threshold: Schema.BigInt,
+    minimum_remaining: Schema.NullOr(Schema.BigInt),
+    created_at: ConvertedTimestamp,
+    updated_at: ConvertedTimestamp,
+});
+/** Outgoing payment as exposed to the calling agent (excludes signature, EIP-3009 nonce, internal row id, signing-key details). */
+export const AgentSelfPaymentDTO = Schema.Struct({
+    seller_address: Address,
+    amount_usdc_micro: Schema.BigInt,
+    scheme: Schema.NullOr(Scheme),
+    status: Schema.Literal("requested", "authorized", "denied", "settled", "expired", "unmanaged", "success", "failure", "pending"),
+    tx_hash: Schema.NullOr(TxHash),
+    chain_caip2id: Schema.NullOr(Caip2ID),
+    created_at: ConvertedTimestamp,
+    expires_at: Schema.NullOr(ConvertedTimestamp),
+});
+/** Single row in the unified spend + earn activity feed. */
+export const UnifiedAgentActivityDTO = Schema.Struct({
+    type: Schema.Literal("earn", "spend"),
+    id: Schema.String,
+    agent_address: Address,
+    receiver: Address,
+    amount: Schema.Union(Schema.Number, Schema.NumberFromString),
+    status: Schema.Literal("received", "settled", "authorized", "failed", "denied"),
+    timestamp: Schema.BigInt,
+    tx_hash: Schema.NullOr(Schema.String),
+    chain_caip2id: Schema.NullOr(Schema.String),
+});
+/** Paginated unified spend + earn activity response. */
+export const AgentActivityResponse = Schema.Struct({
+    activity: Schema.Array(UnifiedAgentActivityDTO),
+    hasNextPage: Schema.Boolean,
+    totalCount: Schema.NonNegativeInt,
+});
+/** Narrow owner projection: `{ user_id, wallet_address }` — no email, sibling agents, or cross-agent aggregates. */
+export const AgentOwnerDTO = Schema.Struct({
+    user_id: ID,
+    wallet_address: Address,
+});
+/**
+ * Funding link the agent can present to its owner. The URL points at the
+ * dashboard's `/fund` page, prefilled per the requested destination. Pure
+ * URL formatter on the server — no DB row, no token, no side effects.
+ */
+export const AgentFundingLinkDTO = Schema.Struct({
+    url: Schema.String,
+});
+//# sourceMappingURL=agent.js.map

package/dist/ampersend/agent.js.map

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

package/dist/ampersend/client.d.ts

@@ -1,5 +1,6 @@
+import { Schema } from "effect";
 import type { PaymentAuthorization, PaymentRequest } from "../x402/envelopes.ts";
-import { AgentAuthorizeRequest, AgentAuthorizeResponse, AgentPaymentEventResponse, type Address, type ApiClientOptions, type PaymentEvent } from "./types.js";
+import { AgentAuthorizeRequest, AgentAuthorizeResponse, AgentPaymentEventResponse, SignSiwxResponse, type Address, type ApiClientOptions, type PaymentEvent } from "./types.js";
 export * from "./types.js";
 /**
  * TypeScript SDK for the API
@@ -8,10 +9,17 @@ export * from "./types.js";
  * including SIWE authentication and payment lifecycle management.
  */
 export declare class ApiClient {
-    private baseUrl;
-    private sessionKeyPrivateKey;
-    private agentAddress;
-    private timeout;
+    private readonly baseUrl;
+    private readonly sessionKeyPrivateKey;
+    private readonly agentAddress;
+    private readonly timeout;
+    /**
+     * `Ampersend-Client` header value sent on every authenticated request.
+     * Format: `<name>/<version>`. Used by the API for product-analytics
+     * client attribution. Defaults to `sdk-typescript/<VERSION>`; the
+     * `ampersend` CLI overrides `clientName` to `ampersend-cli`.
+     */
+    private clientHeader;
     private authMutex;
     private auth;
     constructor(options: ApiClientOptions);
@@ -20,15 +28,31 @@ export declare class ApiClient {
      */
     private performAuthentication;
     authorizePayment(paymentRequest: PaymentRequest, context?: AgentAuthorizeRequest["context"]): Promise<typeof AgentAuthorizeResponse.Type>;
+    /**
+     * Ask the Ampersend API to co-sign a Sign-In-With-X (CAIP-122 / EIP-4361)
+     * message. The service parses the message, verifies it claims this agent's
+     * smart account, and signs `hashMessage(message)` with the service key.
+     *
+     * The buyer concatenates this with its own session-key signature and wraps
+     * via CoSignerValidator for ERC-1271 verification.
+     */
+    signSiwxChallenge(message: string): Promise<typeof SignSiwxResponse.Type>;
     reportPaymentEvent(eventId: string, payment: PaymentAuthorization, event: PaymentEvent): Promise<AgentPaymentEventResponse>;
+    /**
+     * Authenticated GET against a path on the API. Performs SIWE auth first
+     * if needed, then decodes the response against `schema`. Use this from
+     * read-only clients that share auth with the rest of the SDK.
+     */
+    getAuthorized<A, I>(path: string, schema: Schema.Schema<A, I>): Promise<A>;
     /**
      * Clear the current authentication state
      */
     clearAuth(): void;
     /**
-     * Get the configured agent address
+     * Get the configured agent address, or `undefined` if the client was
+     * constructed for unauthenticated reads only.
      */
-    getAgentAddress(): Address;
+    getAgentAddress(): Address | undefined;
     /**
      * Check if currently authenticated and token is valid
      */
@@ -40,6 +64,6 @@ export declare class ApiClient {
     /**
      * Internal fetch wrapper with error handling and schema decoding
      */
-    private fetch;
+    fetch<A, I>(path: string, init: RequestInit, schema: Schema.Schema<A, I>): Promise<A>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/ampersend/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ampersend/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EAEtB,yBAAyB,EAIzB,KAAK,OAAO,EACZ,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAElB,MAAM,YAAY,CAAA;AAEnB,cAAc,YAAY,CAAA;AAE1B;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,oBAAoB,CAA2B;IACvD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAGX;gBAEW,OAAO,EAAE,gBAAgB;IAOrC;;OAEG;YACW,qBAAqB;IAmE7B,gBAAgB,CACpB,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACzC,OAAO,CAAC,OAAO,sBAAsB,CAAC,IAAI,CAAC;IAoCxC,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,yBAAyB,CAAC;IAoBrC;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;YACW,mBAAmB;IAQjC;;OAEG;YACW,KAAK;CAkCpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ampersend/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,MAAM,EAAE,MAAM,QAAQ,CAAA;AAKzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EAEtB,yBAAyB,EAEzB,gBAAgB,EAGhB,KAAK,OAAO,EACZ,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAElB,MAAM,YAAY,CAAA;AAEnB,cAAc,YAAY,CAAA;AA2B1B;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA2B;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC;;;;;OAKG;IACH,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAGX;gBAEW,OAAO,EAAE,gBAAgB;IASrC;;OAEG;YACW,qBAAqB;IAsE7B,gBAAgB,CACpB,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACzC,OAAO,CAAC,OAAO,sBAAsB,CAAC,IAAI,CAAC;IAoC9C;;;;;;;OAOG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC;IAiBzE,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,yBAAyB,CAAC;IAoBrC;;;;OAIG;IACG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhF;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;;OAGG;IACH,eAAe,IAAI,OAAO,GAAG,SAAS;IAItC;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;YACW,mBAAmB;IAQjC;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CA2C5F"}

package/dist/ampersend/client.js

@@ -2,8 +2,34 @@ import { Mutex } from "async-mutex";
 import { DateTime, Schema } from "effect";
 import { SiweMessage } from "siwe";
 import { privateKeyToAccount } from "viem/accounts";
-import { AgentAuthorizeRequest, AgentAuthorizeResponse, AgentPaymentEventReport, AgentPaymentEventResponse, ApiError, SIWELoginResponse, SIWENonceResponse, } from "./types.js";
+import { VERSION } from "../version.js";
+import { AgentAuthorizeRequest, AgentAuthorizeResponse, AgentPaymentEventReport, AgentPaymentEventResponse, ApiError, SignSiwxResponse, SIWELoginResponse, SIWENonceResponse, } from "./types.js";
 export * from "./types.js";
+/**
+ * Best-effort summary of an HTTP error body. The server emits Effect Schema
+ * decode errors as JSON like `{ _tag: "HttpApiDecodeError", issues: [{ path,
+ * message }, ...], message: "<long indented blob>" }`. The raw `message` is
+ * unreadable; collapse `issues[]` into a flat string instead. For anything
+ * we don't recognise — including non-JSON bodies — return the body verbatim.
+ */
+function formatServerErrorBody(body) {
+    try {
+        const { issues, message } = JSON.parse(body);
+        if (Array.isArray(issues) && issues.length > 0) {
+            return issues
+                .map((i) => {
+                const path = Array.isArray(i?.path) && i.path.length > 0 ? i.path.join(".") : null;
+                const msg = typeof i?.message === "string" ? i.message : "validation failed";
+                return path ? `${path}: ${msg}` : msg;
+            })
+                .join("; ");
+        }
+        return typeof message === "string" ? message : body;
+    }
+    catch {
+        return body;
+    }
+}
 /**
  * TypeScript SDK for the API
  *
@@ -15,6 +41,13 @@ export class ApiClient {
     sessionKeyPrivateKey;
     agentAddress;
     timeout;
+    /**
+     * `Ampersend-Client` header value sent on every authenticated request.
+     * Format: `<name>/<version>`. Used by the API for product-analytics
+     * client attribution. Defaults to `sdk-typescript/<VERSION>`; the
+     * `ampersend` CLI overrides `clientName` to `ampersend-cli`.
+     */
+    clientHeader;
     authMutex = new Mutex();
     auth = {
         token: null,
@@ -25,6 +58,8 @@ export class ApiClient {
         this.sessionKeyPrivateKey = options.sessionKeyPrivateKey;
         this.agentAddress = options.agentAddress;
         this.timeout = options.timeout ?? 30000;
+        const clientName = options.clientName ?? "sdk-typescript";
+        this.clientHeader = `${clientName}/${VERSION}`;
     }
     /**
      * Internal method to perform authentication without mutex (for use within mutex)
@@ -33,6 +68,9 @@ export class ApiClient {
         if (!this.sessionKeyPrivateKey) {
             throw new ApiError("Session key private key is required for authentication");
         }
+        if (!this.agentAddress) {
+            throw new ApiError("Agent address is required for authentication");
+        }
         try {
             const account = privateKeyToAccount(this.sessionKeyPrivateKey);
             const sessionKeyAddress = account.address;
@@ -112,6 +150,25 @@ export class ApiClient {
             checkIndex(rej.acceptsIndex, "rejected");
         return response;
     }
+    /**
+     * Ask the Ampersend API to co-sign a Sign-In-With-X (CAIP-122 / EIP-4361)
+     * message. The service parses the message, verifies it claims this agent's
+     * smart account, and signs `hashMessage(message)` with the service key.
+     *
+     * The buyer concatenates this with its own session-key signature and wraps
+     * via CoSignerValidator for ERC-1271 verification.
+     */
+    async signSiwxChallenge(message) {
+        await this.ensureAuthenticated();
+        return this.fetch(`/api/v1/agents/${this.agentAddress}/auth/sign-siwx`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.auth.token}`,
+            },
+            body: JSON.stringify({ message }),
+        }, SignSiwxResponse);
+    }
     async reportPaymentEvent(eventId, payment, event) {
         await this.ensureAuthenticated();
         const report = { id: eventId, payment, event };
@@ -125,6 +182,18 @@ export class ApiClient {
             body: JSON.stringify(wireBody),
         }, AgentPaymentEventResponse);
     }
+    /**
+     * Authenticated GET against a path on the API. Performs SIWE auth first
+     * if needed, then decodes the response against `schema`. Use this from
+     * read-only clients that share auth with the rest of the SDK.
+     */
+    async getAuthorized(path, schema) {
+        await this.ensureAuthenticated();
+        return this.fetch(path, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.auth.token}` },
+        }, schema);
+    }
     /**
      * Clear the current authentication state
      */
@@ -135,7 +204,8 @@ export class ApiClient {
         };
     }
     /**
-     * Get the configured agent address
+     * Get the configured agent address, or `undefined` if the client was
+     * constructed for unauthenticated reads only.
      */
     getAgentAddress() {
         return this.agentAddress;
@@ -162,8 +232,16 @@ export class ApiClient {
     async fetch(path, init, schema) {
         const url = `${this.baseUrl}${path}`;
         try {
+            // Merge in the Ampersend-Client header so the API can attribute
+            // product-analytics events to SDK vs CLI vs library callers.
+            // Caller-supplied headers win on conflict.
+            const headers = new Headers(init.headers);
+            if (!headers.has("Ampersend-Client")) {
+                headers.set("Ampersend-Client", this.clientHeader);
+            }
             const response = await fetch(url, {
                 ...init,
+                headers,
                 signal: AbortSignal.timeout(this.timeout),
             });
             if (!response.ok) {
@@ -171,7 +249,7 @@ export class ApiClient {
                 try {
                     const errorBody = await response.text();
                     if (errorBody) {
-                        errorMessage += `: ${errorBody}`;
+                        errorMessage += `: ${formatServerErrorBody(errorBody)}`;
                     }
                 }
                 catch {