@vapi-network/core 0.5.0 → 0.8.0

package/dist/siblings.d.ts

@@ -0,0 +1,41 @@
+import type { SecretStore } from "./secret-store.js";
+import type { WalletName, WalletStore } from "./wallet-store.js";
+export type SiblingStatus = "active" | "revoked";
+export type Sibling = {
+    name: string;
+    address: `0x${string}`;
+    device: string | null;
+    status: SiblingStatus;
+    allowance: {
+        routerPerDayUsd: number | null;
+        perCallUsd: number | null;
+        perDayUsd: number | null;
+    };
+    self: boolean;
+};
+export type SiblingsResult = {
+    owner: `0x${string}` | null;
+    siblings: Sibling[];
+    source: {
+        account: WalletName;
+    };
+};
+export type SiblingsErrorCode = "not_linked" | "unsupported" | "invalid_response" | "http";
+export declare class SiblingsError extends Error {
+    readonly code: SiblingsErrorCode;
+    readonly status?: number | undefined;
+    constructor(code: SiblingsErrorCode, message: string, status?: number | undefined);
+}
+export declare const SIBLINGS_UNSUPPORTED_MESSAGE = "This vAPI server does not list siblings yet.";
+export declare const SIBLINGS_DEFAULT_TIMEOUT_MS = 10000;
+export declare function fetchSiblings(args: {
+    apiBase: string;
+    account: WalletName;
+    secrets: SecretStore;
+    wallets: WalletStore;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<SiblingsResult>;
+//# sourceMappingURL=siblings.d.ts.map

package/dist/siblings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siblings.d.ts","sourceRoot":"","sources":["../src/siblings.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjD,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE;QACT,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAC;CACjC,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAE3F,qBAAa,aAAc,SAAQ,KAAK;IAEpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB;IAEhC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBAFf,IAAI,EAAE,iBAAiB,EAChC,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED,eAAO,MAAM,4BAA4B,iDAAiD,CAAC;AAE3F,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAyBlD,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA0D1B"}

package/dist/spend-policy.d.ts

@@ -26,6 +26,18 @@ export declare function reserveSpend(amountAtomic: bigint, caps: SpendCaps, opti
     ledgerPath?: string;
     now?: Date;
     wallet?: WalletName;
+    reservationId?: string;
+}): Promise<SpendLedger>;
+/**
+ * Releases a reservation made earlier on the same UTC day. A reservation from
+ * a prior day has already rolled out of the active ledger and is left alone.
+ */
+export declare function releaseSpend(amountAtomic: bigint, options: {
+    reservedOn: string;
+    ledgerPath?: string;
+    now?: Date;
+    wallet?: WalletName;
+    reservationId?: string;
 }): Promise<SpendLedger>;
 export {};
 //# sourceMappingURL=spend-policy.d.ts.map

package/dist/spend-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spend-policy.d.ts","sourceRoot":"","sources":["../src/spend-policy.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAyC,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1F,QAAA,MAAM,YAAY;;;iBAGhB,CAAC;AAkBH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAElE,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,uBAAuB,GAAG,sBAAsB;gBAAtD,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,EACtE,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,UAAU,CAAC,GAAG,OAAa,GAAG,MAAM,CAEnD;AAED,+EAA+E;AAC/E,wBAAsB,eAAe,CACnC,IAAI,SAA6B,EACjC,GAAG,OAAa,EAChB,MAAM,GAAE,UAAgC,GACvC,OAAO,CAAC,WAAW,CAAC,CAItB;AAED,0DAA0D;AAC1D,wBAAsB,mBAAmB,CACvC,IAAI,SAA6B,EACjC,GAAG,OAAa,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAkB3B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GACjE,OAAO,CAAC,WAAW,CAAC,CAsCtB"}
+{"version":3,"file":"spend-policy.d.ts","sourceRoot":"","sources":["../src/spend-policy.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAyC,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1F,QAAA,MAAM,YAAY;;;iBAGhB,CAAC;AA0BH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAKlE,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,uBAAuB,GAAG,sBAAsB;gBAAtD,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,EACtE,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,UAAU,CAAC,GAAG,OAAa,GAAG,MAAM,CAEnD;AAED,+EAA+E;AAC/E,wBAAsB,eAAe,CACnC,IAAI,SAA6B,EACjC,GAAG,OAAa,EAChB,MAAM,GAAE,UAAgC,GACvC,OAAO,CAAC,WAAW,CAAC,CAItB;AAED,0DAA0D;AAC1D,wBAAsB,mBAAmB,CACvC,IAAI,SAA6B,EACjC,GAAG,OAAa,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAM3B;AAuBD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,WAAW,CAAC,CAsDtB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,WAAW,CAAC,CAgDtB"}

package/dist/status.d.ts

@@ -0,0 +1,73 @@
+import type { AgentRouterUsage } from "./router-client.js";
+import { type MovementSummary } from "./movement.js";
+import type { SecretStore } from "./secret-store.js";
+import type { WalletName } from "./wallet-name.js";
+import { type WalletStore } from "./wallet-store.js";
+export type AccountLinkStatus = "active" | "paused" | "revoked" | "not_linked" | "unknown";
+export type StatusAccount = {
+    name: string;
+    default: boolean;
+    address: string;
+    usdc?: string;
+    routerTodayUsd?: string;
+    routerAllowanceUsd?: string;
+    caps: {
+        perCallUsd: string;
+        perDayUsd: string;
+        ceilingUsd: string;
+        ceilingFloorUsd?: string;
+    };
+    link: AccountLinkStatus;
+};
+export type StatusReport = {
+    version: string;
+    home: string;
+    registry: string;
+    owner?: {
+        address: string;
+        linked: boolean;
+        console: string;
+    };
+    vault: {
+        exists: boolean;
+        unlocked: boolean;
+        store: string;
+        protected: boolean;
+    };
+    accounts: StatusAccount[];
+    unfinishedMovements: MovementSummary[];
+    cloudBackup?: {
+        enabled: boolean;
+        lastUploadAt?: string;
+    };
+    next: string[];
+};
+export type StatusDeps = {
+    version: string;
+    home: string;
+    registry: string;
+    wallets: WalletStore;
+    secrets: SecretStore;
+    env?: NodeJS.ProcessEnv;
+    chain: {
+        usdcBalance: (address: string, signal?: AbortSignal) => Promise<bigint>;
+    };
+    agents: {
+        routerUsage: (account: WalletName, signal?: AbortSignal) => Promise<AgentRouterUsage>;
+        linkStatus: (account: WalletName, signal?: AbortSignal) => Promise<Exclude<AccountLinkStatus, "not_linked">>;
+    };
+    cloudBackup?: (signal?: AbortSignal) => Promise<{
+        enabled: boolean;
+        lastUploadAt?: string;
+    }>;
+    now: () => Date;
+    timeoutMs?: number;
+    timers?: {
+        setTimeout: typeof setTimeout;
+        clearTimeout: typeof clearTimeout;
+    };
+};
+export declare const STATUS_TIMEOUT_MS = 2000;
+export declare function buildStatus(deps: StatusDeps): Promise<StatusReport>;
+export declare function formatUsdAmount(value: bigint | number): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

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

package/dist/support-report.d.ts

@@ -1,5 +1,5 @@
 import { type LookupFn } from "./net-guard.js";
-export declare const VAPI_CLIENT_VERSION = "0.5.0";
+export declare const VAPI_CLIENT_VERSION = "0.8.0";
 export type SupportSystemInfo = {
     platform: string;
     release: string;

package/dist/swarm-capital.d.ts

@@ -0,0 +1,147 @@
+import { z } from "zod";
+import { type CeilingSweepResult } from "./ceiling.js";
+import { type VapiConfig } from "./config.js";
+import { type MovementDependencies } from "./movement.js";
+import { type RunBudget } from "./run-budget.js";
+import { type SwarmBalanceReader } from "./swarm.js";
+import { type TransferNetwork } from "./transfer.js";
+import { type WalletName } from "./wallet-name.js";
+export type SwarmCapitalDeps = MovementDependencies & {
+    balanceReader?: SwarmBalanceReader;
+    config?: VapiConfig;
+    reconcileCeilingSweep?: (account: WalletName) => Promise<CeilingSweepResult>;
+};
+export type SwarmLegResult = {
+    from: string;
+    to: string;
+    amountUsd: string;
+    purpose: "send" | "sweep";
+    status: "planned" | "sent" | "failed" | "unknown" | "cancelled";
+    txHash?: string;
+    reason?: string;
+};
+export type SwarmMovementResult = {
+    movementId: string;
+    reason: string;
+    resumed: boolean;
+    legs: SwarmLegResult[];
+    complete: boolean;
+};
+type SwarmSkippedMember = {
+    account: string;
+    reason: string;
+};
+type SwarmBlockedLeg = {
+    to: string;
+    amountUsd: string;
+    reason: string;
+};
+declare const delegationRecordSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    movementId: z.ZodString;
+    requestId: z.ZodString;
+    swarm: z.ZodString;
+    member: z.ZodString;
+    budgetUsd: z.ZodString;
+    childRunId: z.ZodString;
+    startedAt: z.ZodISODateTime;
+    result: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodNullable<z.ZodString>;
+        answer: z.ZodNullable<z.ZodString>;
+        stoppedBecause: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        spentUsd: z.ZodNumber;
+        budgetUsd: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DelegationRecord = z.infer<typeof delegationRecordSchema>;
+export type SwarmFundResult = {
+    status: "sent" | "incomplete" | "waiting_for_owner" | "resumed";
+    treasury: {
+        account: string;
+        address: string;
+    };
+    network: TransferNetwork;
+    amountUsd: string;
+    fund?: SwarmMovementResult;
+    policy?: SwarmMovementResult | SwarmRebalanceResult;
+    blocked: SwarmBlockedLeg[];
+    skipped: SwarmSkippedMember[];
+    message: string;
+};
+export type SwarmFundOptions = {
+    name: string;
+    amountUsd: string | number;
+    from: string;
+    setup: true;
+} | {
+    name: string;
+    amountUsd: string | number;
+    from?: string;
+    setup?: undefined;
+};
+export type SwarmRebalanceResult = {
+    status: "sent" | "incomplete" | "balanced" | "resumed";
+    movement?: SwarmMovementResult;
+    blocked: SwarmBlockedLeg[];
+    skipped: SwarmSkippedMember[];
+    message: string;
+};
+export type SwarmLeaveResult = {
+    status: "left" | "kept" | "resumed";
+    member: string;
+    movement?: SwarmMovementResult;
+    message: string;
+};
+export type SwarmDissolveResult = {
+    status: "dissolved" | "incomplete" | "resumed";
+    movements: SwarmMovementResult[];
+    message: string;
+};
+export type AllocateFromTreasuryOptions = {
+    name: string;
+    member: string;
+    amountUsd: string | number;
+    reason: "allocate" | "delegate";
+    requestId?: string;
+    draw?: RunBudget;
+};
+export type AllocateFromTreasuryResult = {
+    status: "sent" | "incomplete" | "blocked" | "resumed";
+    movementId: string | null;
+    requestedUsd: string;
+    sentUsd: string;
+    unknownUsd: string;
+    blocked: Array<{
+        to: string;
+        amountUsd: string;
+        reason: string;
+    }>;
+    movement?: SwarmMovementResult;
+    message: string;
+};
+export declare function treasuryRequestMovementId(swarm: string, requestId: string): string;
+/**
+ * Moves treasury capital for one intent. Reusing a requestId returns a finished result or resumes
+ * its unfinished movement; changing its member, amount, or reason is a request conflict. Different
+ * requestIds are distinct intents, bounded only by the run draw and treasury caps.
+ */
+export declare function allocateFromTreasury(opts: AllocateFromTreasuryOptions, deps: SwarmCapitalDeps): Promise<AllocateFromTreasuryResult>;
+export declare function fundSwarm(opts: SwarmFundOptions, deps: SwarmCapitalDeps): Promise<SwarmFundResult>;
+export declare function rebalanceSwarm(opts: {
+    name: string;
+    targetsUsd?: Record<string, string | number>;
+}, deps: SwarmCapitalDeps): Promise<SwarmRebalanceResult>;
+export declare function leaveSwarm(opts: {
+    name: string;
+    member: string;
+}, deps: SwarmCapitalDeps): Promise<SwarmLeaveResult>;
+export declare function dissolveSwarm(opts: {
+    name: string;
+}, deps: SwarmCapitalDeps): Promise<SwarmDissolveResult>;
+export declare function readDelegationRecord(home: string, movementId: string): Promise<DelegationRecord | undefined>;
+export declare function writeDelegationRecord(home: string, record: DelegationRecord): Promise<void>;
+export {};
+//# sourceMappingURL=swarm-capital.d.ts.map

package/dist/swarm-capital.d.ts.map

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

package/dist/swarm.d.ts

@@ -0,0 +1,224 @@
+import { z } from "zod";
+import { type AccountLinkOutcome, type StartAccountLinkArgs } from "./account-add.js";
+import { type AgentGrant } from "./agent-profile.js";
+import { type VapiConfig } from "./config.js";
+import { type MovementSummary } from "./movement.js";
+import type { SecretStore } from "./secret-store.js";
+import type { TransferNetwork } from "./transfer.js";
+import { type WalletName } from "./wallet-name.js";
+import type { WalletStore } from "./wallet-store.js";
+import { type CanonicalX402UsdcNetwork } from "./x402-networks.js";
+export declare const SWARM_NAME_PATTERN: RegExp;
+export declare const SWARM_ROLE_PATTERN: RegExp;
+export declare const DEFAULT_SWARM_MODEL = "venice/claude-sonnet-5";
+export type SwarmStrategy = "targets" | "even" | "weights";
+export declare const SWARM_TREASURY_CAPS: {
+    readonly perCallAtomic: "5000000";
+    readonly perDayAtomic: "20000000";
+};
+export declare const swarmFileSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    name: z.ZodString;
+    device: z.ZodString;
+    network: z.ZodEnum<{
+        "eip155:8453": "eip155:8453";
+        "eip155:5042": "eip155:5042";
+    }>;
+    createdAt: z.ZodISODateTime;
+    treasury: z.ZodObject<{
+        account: z.ZodString;
+        address: z.ZodOptional<z.ZodString>;
+        steps: z.ZodObject<{
+            creating: z.ZodDefault<z.ZodBoolean>;
+            created: z.ZodBoolean;
+            capped: z.ZodBoolean;
+            linked: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    members: z.ZodArray<z.ZodObject<{
+        account: z.ZodString;
+        address: z.ZodOptional<z.ZodString>;
+        role: z.ZodString;
+        weight: z.ZodNumber;
+        targetAtomic: z.ZodString;
+        ceilingAtomic: z.ZodNullable<z.ZodString>;
+        steps: z.ZodObject<{
+            profiled: z.ZodBoolean;
+            creating: z.ZodDefault<z.ZodBoolean>;
+            created: z.ZodBoolean;
+            capped: z.ZodBoolean;
+            linked: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    setupFunding: z.ZodOptional<z.ZodObject<{
+        amountUsd: z.ZodString;
+        from: z.ZodString;
+        movementId: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            sent: "sent";
+            planned: "planned";
+            incomplete: "incomplete";
+        }>;
+        policy: z.ZodOptional<z.ZodObject<{
+            strategy: z.ZodEnum<{
+                even: "even";
+                weights: "weights";
+                targets: "targets";
+            }>;
+            movementId: z.ZodOptional<z.ZodString>;
+            status: z.ZodEnum<{
+                sent: "sent";
+                planned: "planned";
+                incomplete: "incomplete";
+            }>;
+            blocked: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                to: z.ZodString;
+                amountUsd: z.ZodString;
+                reason: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    policy: z.ZodObject<{
+        strategy: z.ZodEnum<{
+            even: "even";
+            weights: "weights";
+            targets: "targets";
+        }>;
+        treasuryCaps: z.ZodObject<{
+            perCallAtomic: z.ZodString;
+            perDayAtomic: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SwarmFile = z.infer<typeof swarmFileSchema>;
+export type SwarmMember = SwarmFile["members"][number];
+export type SwarmErrorCode = "invalid_swarm" | "swarm_not_found" | "swarm_exists_different_shape" | "account_in_other_swarm" | "account_name_taken" | "name_too_long" | "treasury_refused" | "member_not_found" | "member_not_linked" | "draw_exceeded" | "request_conflict" | "movement_unfinished" | "ceiling_sweep_pending" | "account_address_mismatch" | "swarm_locked";
+export declare class SwarmError extends Error {
+    readonly code: SwarmErrorCode;
+    constructor(code: SwarmErrorCode, message: string);
+}
+export declare function swarmsDirectory(home: string): string;
+export declare function swarmFilePath(home: string, name: string): string;
+export declare function readSwarm(home: string, name: string): Promise<SwarmFile>;
+export declare function listSwarms(home: string): Promise<SwarmFile[]>;
+export declare function writeSwarm(home: string, value: SwarmFile): Promise<void>;
+export declare function deleteSwarmFile(home: string, name: string): Promise<void>;
+export declare function withSwarmLock<T>(home: string, name: string, fn: () => Promise<T>): Promise<T>;
+export declare function swarmAccountNames(swarm: SwarmFile): WalletName[];
+export declare function swarmTreasuryName(name: string): WalletName;
+export declare function swarmMemberName(name: string, role: string, n: number): WalletName;
+export declare function roleDefaults(role: string): {
+    weight: number;
+    targetAtomic: string;
+    ceilingAtomic: string;
+};
+export declare function roleGrants(role: string): AgentGrant[];
+export declare function swarmParentResolver(home: string): (account: WalletName) => Promise<{
+    account: WalletName;
+    address: `0x${string}`;
+} | undefined>;
+type LinkOptions = Pick<StartAccountLinkArgs, "fetchImpl" | "startDeviceLink" | "pollDeviceLink" | "saveAgentLink" | "sleep" | "signal" | "configPath" | "env" | "hostname" | "awaitApproval">;
+export type SetupSwarmOptions = LinkOptions & {
+    home?: string;
+    store: WalletStore;
+    secrets: SecretStore;
+    apiBase: string;
+    name: string;
+    agents?: number;
+    roles?: string[];
+    strategy?: SwarmStrategy;
+    targetsUsd?: Record<string, string | number>;
+    weights?: Record<string, number>;
+    ceilingsUsd?: Record<string, string | number | null>;
+    caps?: {
+        perCallUsd: string | number;
+        perDayUsd: string | number;
+    };
+    treasuryCaps?: {
+        perCallUsd: string | number;
+        perDayUsd: string | number;
+    };
+    network?: TransferNetwork;
+    model?: string;
+    surface: "cli" | "mcp";
+    now?: () => Date;
+};
+export type AddSwarmMemberOptions = Omit<SetupSwarmOptions, "agents" | "roles" | "strategy" | "treasuryCaps" | "network"> & {
+    role: string;
+    targetUsd?: string | number;
+    weight?: number;
+    ceilingUsd?: string | number | null;
+};
+export type SwarmNextStep = {
+    kind: "link";
+    account: string;
+    userCode: string;
+    verificationUri: string;
+    verificationUriComplete: string;
+    expiresInSeconds: number;
+} | {
+    kind: "caps";
+    account: string;
+    command: string;
+};
+export type SwarmMemberSetupStatus = {
+    account: string;
+    address: string;
+    role: string;
+    created: boolean;
+    capped: boolean;
+    profiled: boolean;
+    linked: boolean;
+};
+export type SwarmSetupResult = {
+    swarm: SwarmFile;
+    members: SwarmMemberSetupStatus[];
+    next: SwarmNextStep[];
+    completions: Map<string, Promise<AccountLinkOutcome>>;
+};
+export declare function setupSwarm(opts: SetupSwarmOptions): Promise<SwarmSetupResult>;
+export declare function addSwarmMember(opts: AddSwarmMemberOptions): Promise<SwarmSetupResult>;
+export type SwarmBalanceReader = (input: {
+    account: WalletName;
+    address: string;
+    network: CanonicalX402UsdcNetwork;
+}) => Promise<bigint>;
+export type SwarmStatusOptions = {
+    home?: string;
+    store: WalletStore;
+    name: string;
+    balanceReader?: SwarmBalanceReader;
+    config?: VapiConfig;
+    fetchImpl?: typeof fetch;
+};
+export type SwarmStatusResult = {
+    swarm: string;
+    network: TransferNetwork;
+    strategy: SwarmStrategy;
+    treasury: {
+        account: string;
+        address: string;
+        linked: boolean;
+        balanceAtomic: string;
+        balanceUsd: string;
+    };
+    members: Array<{
+        account: string;
+        address: string;
+        role: string;
+        weight: number;
+        targetUsd: string;
+        ceilingUsd: string | null;
+        linked: boolean;
+        profile: boolean;
+        balanceAtomic: string;
+        balanceUsd: string;
+        allocatedInUsd: string;
+        sweptOutUsd: string;
+        netUsd: string;
+    }>;
+    openMovements: MovementSummary[];
+};
+export declare function swarmStatus(opts: SwarmStatusOptions): Promise<SwarmStatusResult>;
+export {};
+//# sourceMappingURL=swarm.d.ts.map

package/dist/swarm.d.ts.map

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

package/dist/transfer-journal.d.ts

@@ -0,0 +1,11 @@
+import { type Receipt } from "./receipts.js";
+import type { WalletName } from "./wallet-name.js";
+export type TransferJournal = {
+    signed: boolean;
+    latest?: Receipt;
+    request?: Receipt;
+    validBefore?: string;
+    reservedOn?: string;
+};
+export declare function readTransferJournal(home: string, from: WalletName, nonce: string): Promise<TransferJournal>;
+//# sourceMappingURL=transfer-journal.d.ts.map

package/dist/transfer-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-journal.d.ts","sourceRoot":"","sources":["../src/transfer-journal.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAsC1B"}

package/dist/transfer.d.ts

@@ -0,0 +1,65 @@
+import type { SecretStore } from "./secret-store.js";
+import { type WalletName, type WalletStore } from "./wallet-store.js";
+import { type X402TypedData } from "./x402.js";
+import { ARC_MAINNET_CAIP2, BASE_MAINNET_CAIP2 } from "./x402-networks.js";
+export type TransferPurpose = "send" | "sweep";
+export type TransferNetwork = typeof BASE_MAINNET_CAIP2 | typeof ARC_MAINNET_CAIP2;
+export type TransferSigner = {
+    address: `0x${string}`;
+    signTypedData: (typedData: X402TypedData) => Promise<`0x${string}`>;
+};
+export type TransferArgs = {
+    store: WalletStore;
+    secrets: SecretStore;
+    apiBase: string;
+    from: WalletName;
+    to: string;
+    amountUsd: string | number;
+    network?: "base" | "arc" | TransferNetwork;
+    purpose?: TransferPurpose;
+    sweepParent?: `0x${string}`;
+    expectedFromAddress?: string;
+    expectedToAddress?: string;
+    unlock?: (account: WalletName) => Promise<TransferSigner>;
+    resume?: `0x${string}`;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+    nonce?: `0x${string}`;
+    timeoutMs?: number;
+    /** Cancels discovery/signing/relay work owned by a bounded best-effort caller. */
+    signal?: AbortSignal;
+    ledgerPath?: string;
+    home?: string;
+};
+export type TransferResult = {
+    status: "sent" | "unknown";
+    from: WalletName;
+    to: `0x${string}`;
+    toName: string;
+    toKind: "owner" | "account";
+    amountUsd: string;
+    amountAtomic: string;
+    network: TransferNetwork;
+    txHash: `0x${string}` | null;
+    nonce: `0x${string}`;
+    replayed: boolean;
+};
+export type TransferErrorCode = "invalid_amount" | "invalid_network" | "not_linked" | "unsupported" | "recipient_not_allowed" | "ambiguous_recipient" | "sweep_not_owner" | "per_call_cap_exceeded" | "per_day_cap_exceeded" | "payer_mismatch" | "payee_not_allowed" | "authorization_invalid" | "relay_limit" | "relay_failed" | "temporarily_unavailable" | "network_error" | "resume_not_found" | "resume_mismatch" | "signer_mismatch" | "account_address_mismatch" | "signing_failed";
+export declare class TransferError extends Error {
+    readonly code: TransferErrorCode;
+    readonly moneyMoved: false;
+    readonly reservationReleased: boolean;
+    readonly resetsAt?: string;
+    readonly addresses?: string[];
+    constructor(code: TransferErrorCode, message: string, options?: {
+        reservationReleased?: boolean;
+        resetsAt?: string;
+        addresses?: string[];
+    });
+}
+export declare function parseTransferAmount(value: string | number): {
+    amountUsd: string;
+    amountAtomic: bigint;
+};
+export declare function transferBetweenAccounts(args: TransferArgs): Promise<TransferResult>;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/transfer.d.ts.map

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