@ampersend_ai/ampersend-sdk 0.0.22 → 0.0.26

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,118 @@
+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<{
+    readonly address: Schema.NonEmptyString;
+    readonly name: Schema.NonEmptyString;
+    readonly slug: Schema.NullOr<Schema.NonEmptyString>;
+    readonly status: Schema.Literals<readonly ["deploying", "deployed", "failed"]>;
+    readonly published: Schema.Boolean;
+    readonly registry_id: Schema.NullOr<Schema.NonEmptyString>;
+    readonly registry_uri: Schema.NullOr<Schema.NonEmptyString>;
+    readonly balance_usdc_micro: Schema.BigIntFromString;
+}>;
+export type AgentSelfDTO = typeof AgentSelfDTO.Type;
+/** Spend policy (per-tx / daily / monthly limits, auto-topup). */
+export declare const AgentSpendConfigDTO: Schema.Struct<{
+    readonly agent_address: Schema.NonEmptyString;
+    readonly daily_limit: Schema.NullOr<Schema.BigIntFromString>;
+    readonly monthly_limit: Schema.NullOr<Schema.BigIntFromString>;
+    readonly per_transaction_limit: Schema.NullOr<Schema.BigIntFromString>;
+    readonly auto_topup_allowed: Schema.Boolean;
+    readonly created_at: Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, Schema.NumberFromString>]>;
+    readonly updated_at: Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, 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.Struct<{
+    readonly agent_address: Schema.NonEmptyString;
+    readonly daily_limit: Schema.NullOr<Schema.BigIntFromString>;
+    readonly monthly_limit: Schema.NullOr<Schema.BigIntFromString>;
+    readonly per_transaction_limit: Schema.NullOr<Schema.BigIntFromString>;
+    readonly auto_topup_allowed: Schema.Boolean;
+    readonly created_at: Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, Schema.NumberFromString>]>;
+    readonly updated_at: Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, Schema.NumberFromString>]>;
+    readonly daily_remaining_usdc_micro: Schema.NullOr<Schema.BigIntFromString>;
+    readonly monthly_remaining_usdc_micro: Schema.NullOr<Schema.BigIntFromString>;
+}>;
+export type AgentSelfSpendConfigDTO = typeof AgentSelfSpendConfigDTO.Type;
+/** Auto-collect (earnings sweep) configuration. */
+export declare const AgentAutoCollectConfigDTO: Schema.Struct<{
+    readonly agent_address: Schema.NonEmptyString;
+    readonly enabled: Schema.Boolean;
+    readonly target_address: Schema.NullOr<Schema.NonEmptyString>;
+    readonly threshold: Schema.BigIntFromString;
+    readonly minimum_remaining: Schema.NullOr<Schema.BigIntFromString>;
+    readonly created_at: Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, Schema.NumberFromString>]>;
+    readonly updated_at: Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, 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<{
+    readonly seller_address: Schema.NonEmptyString;
+    readonly amount_usdc_micro: Schema.BigIntFromString;
+    readonly scheme: Schema.NullOr<Schema.Literals<readonly ["exact", "deferred"]>>;
+    readonly status: Schema.Literals<readonly ["requested", "authorized", "denied", "settled", "expired", "unmanaged", "success", "failure", "pending"]>;
+    readonly tx_hash: Schema.NullOr<Schema.NonEmptyString>;
+    readonly chain_caip2id: Schema.NullOr<Schema.NonEmptyString>;
+    readonly created_at: Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, Schema.NumberFromString>]>;
+    readonly expires_at: Schema.NullOr<Schema.Union<readonly [Schema.Int, Schema.compose<Schema.Int, Schema.NumberFromString>]>>;
+}>;
+export type AgentSelfPaymentDTO = typeof AgentSelfPaymentDTO.Type;
+/** Single row in the unified spend + earn activity feed. */
+export declare const UnifiedAgentActivityDTO: Schema.Struct<{
+    readonly type: Schema.Literals<readonly ["earn", "spend"]>;
+    readonly id: Schema.String;
+    readonly agent_address: Schema.NonEmptyString;
+    readonly receiver: Schema.NonEmptyString;
+    readonly amount: Schema.Union<readonly [Schema.Number, Schema.NumberFromString]>;
+    readonly status: Schema.Literals<readonly ["received", "settled", "authorized", "failed", "denied"]>;
+    readonly timestamp: Schema.BigIntFromString;
+    readonly tx_hash: Schema.NullOr<Schema.String>;
+    readonly chain_caip2id: Schema.NullOr<Schema.String>;
+}>;
+export type UnifiedAgentActivityDTO = typeof UnifiedAgentActivityDTO.Type;
+/** Paginated unified spend + earn activity response. */
+export declare const AgentActivityResponse: Schema.Struct<{
+    readonly activity: Schema.$Array<Schema.Struct<{
+        readonly type: Schema.Literals<readonly ["earn", "spend"]>;
+        readonly id: Schema.String;
+        readonly agent_address: Schema.NonEmptyString;
+        readonly receiver: Schema.NonEmptyString;
+        readonly amount: Schema.Union<readonly [Schema.Number, Schema.NumberFromString]>;
+        readonly status: Schema.Literals<readonly ["received", "settled", "authorized", "failed", "denied"]>;
+        readonly timestamp: Schema.BigIntFromString;
+        readonly tx_hash: Schema.NullOr<Schema.String>;
+        readonly chain_caip2id: Schema.NullOr<Schema.String>;
+    }>>;
+    readonly hasNextPage: Schema.Boolean;
+    readonly totalCount: Schema.Int;
+}>;
+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<{
+    readonly user_id: Schema.brand<Schema.String, "ID">;
+    readonly wallet_address: Schema.NonEmptyString;
+}>;
+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<{
+    readonly url: 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;AAqB/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;;;;;;;;;;EAKnC,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,109 @@
+import { Schema } from "effect";
+import { Address, Caip2ID, ConvertedTimestamp, ID, NonEmptyTrimmedString, NonNegativeInt, 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.Literals(["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: NonEmptyTrimmedString,
+    slug: Schema.NullOr(NonEmptyTrimmedString),
+    status: DeploymentStatus,
+    published: Schema.Boolean,
+    registry_id: Schema.NullOr(NonEmptyTrimmedString),
+    registry_uri: Schema.NullOr(NonEmptyTrimmedString),
+    balance_usdc_micro: Schema.BigIntFromString,
+});
+/** Spend policy (per-tx / daily / monthly limits, auto-topup). */
+export const AgentSpendConfigDTO = Schema.Struct({
+    agent_address: Address,
+    daily_limit: Schema.NullOr(Schema.BigIntFromString),
+    monthly_limit: Schema.NullOr(Schema.BigIntFromString),
+    per_transaction_limit: Schema.NullOr(Schema.BigIntFromString),
+    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 = AgentSpendConfigDTO.pipe(Schema.fieldsAssign({
+    daily_remaining_usdc_micro: Schema.NullOr(Schema.BigIntFromString),
+    monthly_remaining_usdc_micro: Schema.NullOr(Schema.BigIntFromString),
+}));
+/** Auto-collect (earnings sweep) configuration. */
+export const AgentAutoCollectConfigDTO = Schema.Struct({
+    agent_address: Address,
+    enabled: Schema.Boolean,
+    target_address: Schema.NullOr(Address),
+    threshold: Schema.BigIntFromString,
+    minimum_remaining: Schema.NullOr(Schema.BigIntFromString),
+    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.BigIntFromString,
+    scheme: Schema.NullOr(Scheme),
+    status: Schema.Literals([
+        "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.Literals(["earn", "spend"]),
+    id: Schema.String,
+    agent_address: Address,
+    receiver: Address,
+    amount: Schema.Union([Schema.Number, Schema.NumberFromString]),
+    status: Schema.Literals(["received", "settled", "authorized", "failed", "denied"]),
+    timestamp: Schema.BigIntFromString,
+    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: 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/approval.js.map

@@ -1 +1 @@
-{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../src/ampersend/approval.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../src/ampersend/approval.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.Codec<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.Codec<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,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY/E;;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,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CA2C3F"}