@vapi-network/core 0.7.0 → 0.9.0

package/dist/spend-policy.d.ts

@@ -6,31 +6,65 @@ declare const ledgerSchema: z.ZodObject<{
     spentAtomic: z.ZodString;
 }, z.core.$strip>;
 export type SpendLedger = z.infer<typeof ledgerSchema>;
+export type SpendKind = "payment" | "escrow-funding" | "dispute-fee";
 export type SpendLedgerRow = SpendLedger & {
     wallet: WalletName;
 };
 export declare class SpendCapError extends Error {
-    readonly code: "per_call_cap_exceeded" | "per_day_cap_exceeded";
-    constructor(code: "per_call_cap_exceeded" | "per_day_cap_exceeded", message: string);
+    readonly code: "per_call_cap_exceeded" | "per_task_cap_exceeded" | "per_day_cap_exceeded";
+    constructor(code: "per_call_cap_exceeded" | "per_task_cap_exceeded" | "per_day_cap_exceeded", message: string);
 }
 export declare function utcDateKey(now?: Date): string;
 /** Today's spend for one wallet. Other wallets and older days read as zero. */
 export declare function readSpendLedger(path?: string, now?: Date, wallet?: WalletName): Promise<SpendLedger>;
+/** Read-only funding headroom; never creates directories, writes, or takes a lock. */
+export declare function escrowFundingDayRemainingAtomic(input: {
+    caps: SpendCaps;
+    ledgerPath: string;
+    now: Date;
+    wallet: WalletName;
+    reservationId?: string;
+}): Promise<bigint>;
+/** Read-only task spend across all stored days, excluding a reservation being retried. */
+export declare function taskReservedAtomic(input: {
+    ledgerPath: string;
+    wallet: WalletName;
+    taskKey: string;
+    now: Date;
+    excludeReservationId?: string;
+}): Promise<bigint>;
 /** Today's spend of every wallet that has spent today. */
 export declare function readSpendLedgerRows(path?: string, now?: Date): Promise<SpendLedgerRow[]>;
 /**
- * Reserves one payment against the caps of one wallet. Per-day totals are kept
- * per wallet, so an agent wallet cannot spend the owner's daily allowance.
+ * Reserves one payment or escrow funding against the caps of one wallet.
+ * Per-day totals are kept per wallet, so an agent wallet cannot spend the
+ * owner's daily allowance.
+ * Task-linked calls without a reservation id return a generated id for rollback.
  */
 export declare function reserveSpend(amountAtomic: bigint, caps: SpendCaps, options?: {
     ledgerPath?: string;
     now?: Date;
     wallet?: WalletName;
     reservationId?: string;
-}): Promise<SpendLedger>;
+    kind?: SpendKind;
+    taskKey?: string;
+    maxPerTaskAtomic?: bigint;
+    reuseExistingEscrowReservation?: boolean;
+    resumeEscrowReservation?: {
+        id: string;
+        wallet: WalletName;
+        amountAtomic: string;
+        date: string;
+        exposed?: boolean;
+        invalidated?: boolean;
+    };
+}): Promise<SpendLedger & {
+    reservationReused?: boolean;
+    reservationId?: string;
+}>;
 /**
- * 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.
+ * Releases an identified reservation on its original UTC day, including task
+ * accounting. Unidentified releases only affect today's daily budget.
  */
 export declare function releaseSpend(amountAtomic: bigint, options: {
     reservedOn: string;

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;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"}
+{"version":3,"file":"spend-policy.d.ts","sourceRoot":"","sources":["../src/spend-policy.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.7.0";
+export declare const VAPI_CLIENT_VERSION = "0.9.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/tasks/actions.d.ts

@@ -0,0 +1,152 @@
+import { type Address } from "viem";
+import { type SpendCaps } from "../config.js";
+import { type ReleaseDecision } from "../funding-policy.js";
+import type { WalletName } from "../wallet-name.js";
+import { type TasksChain, type TasksChainResult } from "./chain-port.js";
+import type { TasksClient } from "./client.js";
+import type { PendingTransactions } from "./pending-transactions.js";
+import { type FrozenDeliveryManifest } from "./delivery-manifest.js";
+import { type TaskMoney } from "./money.js";
+import { type ScopeBindings } from "./scope-bindings.js";
+import { type SignScopeResponse, type UploadFileInput } from "./types.js";
+/** A milestone ID selects a tranche within this order; no implicit selection across tranches. */
+export type TaskTarget = {
+    orderId: string;
+    escrowId?: string;
+    counterparty?: string;
+};
+export type TaskActionInput = TaskTarget & {
+    client: TasksClient;
+    chain: TasksChain;
+    /** Retain one UUID across transport retries; reconcile an existing funding reservation separately. */
+    idempotencyKey?: () => string;
+};
+export type FundingSummary = {
+    money: TaskMoney;
+    dayRemainingUsd: number;
+};
+/** Without approval, an amount above the threshold returns approval_needed. */
+export type TaskFundingApproval = {
+    granted: true;
+} | {
+    granted: false;
+} | {
+    ask: (summary: FundingSummary) => Promise<boolean>;
+};
+export type FundTaskInput = TaskActionInput & {
+    pending?: PendingTransactions;
+    policy: {
+        maxPerTaskUsd: number;
+        approveAboveUsd: number;
+    };
+    caps: SpendCaps;
+    wallet: WalletName;
+    ledgerPath: string;
+    now: () => Date;
+    approval?: TaskFundingApproval;
+};
+export type FundTaskOutcome = {
+    outcome: "refused";
+    reason: "policy.perTask" | "policy.perDay";
+    money: TaskMoney;
+} | {
+    outcome: "approval_needed";
+    money: TaskMoney;
+} | {
+    outcome: "declined";
+    money: TaskMoney;
+} | {
+    outcome: "done";
+    money: TaskMoney;
+    result: TasksChainResult;
+};
+export declare function fundTask(input: FundTaskInput): Promise<FundTaskOutcome>;
+export type TaskDeliveryFile = ({
+    path: string;
+    name?: never;
+} | {
+    name: string;
+    path?: never;
+}) & {
+    bytes: Uint8Array;
+    contentType: UploadFileInput["contentType"];
+};
+export type PrepareDeliveryInput = TaskTarget & {
+    client: TasksClient;
+    pending?: PendingTransactions;
+    files: TaskDeliveryFile[];
+    note: string;
+};
+export type PreparedTaskDelivery = {
+    orderId: string;
+    escrowId: string;
+    manifest: FrozenDeliveryManifest;
+    note: string;
+};
+export declare function prepareDelivery(input: PrepareDeliveryInput): Promise<PreparedTaskDelivery>;
+export type DeliverTaskInput = PrepareDeliveryInput & Pick<TaskActionInput, "chain" | "idempotencyKey">;
+export type DeliverTaskResult = PreparedTaskDelivery & {
+    manifestHash: `0x${string}`;
+    result: TasksChainResult;
+};
+export declare function deliverTask(input: DeliverTaskInput): Promise<DeliverTaskResult>;
+export type TaskMoneyResult = {
+    money: TaskMoney;
+    result: TasksChainResult;
+};
+export declare function releaseTask(input: TaskActionInput): Promise<TaskMoneyResult>;
+export declare function refundTask(input: TaskActionInput): Promise<TaskMoneyResult>;
+export type DisputeTaskInput = FundTaskInput & {
+    evidenceHash: string;
+};
+export type DisputeTaskResult = FundTaskOutcome & {
+    disputeFee: {
+        baseUnits: string;
+        usd: string;
+    };
+};
+export declare function disputeTask(input: DisputeTaskInput): Promise<DisputeTaskResult>;
+export declare function counterEvidenceTask(input: DisputeTaskInput): Promise<DisputeTaskResult>;
+export declare function resolveUnmatchedTask(input: TaskActionInput): Promise<TaskMoneyResult>;
+export declare function autoReleaseDecision(input: {
+    amountUsd: number;
+    autoReleaseBelowUsd: number;
+}): ReleaseDecision;
+export type SignScopeActionInput = {
+    client: TasksClient;
+    chain: TasksChain;
+    orderId: string;
+    role: "poster" | "worker";
+    counterparty?: string;
+    bindings?: ScopeBindings;
+    onTerms?: (terms: SignedScopeTerms) => Promise<void> | void;
+    /** Local EIP-191 signer, invoked only after validating the current scope. */
+    signMessage?: (message: string) => Promise<`0x${string}`>;
+    idempotencyKey?: () => string;
+};
+export type SignedScopeTerms = {
+    role: "client" | "provider";
+    self: Address;
+    direction: "you fund escrow for the worker" | "you deliver work to the poster";
+    counterparty: Address;
+    amountBaseUnits: string;
+    asset: string;
+    network: `eip155:${number}`;
+    deadline: string;
+    deliverables: string[];
+    title: string;
+};
+export type SignScopeAcceptance = SignScopeResponse & {
+    terms: SignedScopeTerms;
+};
+export type SignScopeActionResult = SignScopeAcceptance & {
+    escrowCreation: TasksChainResult | null;
+};
+/** The acceptance response arrived; inspect it before retrying a follow-up separately. */
+export declare class TasksScopeCreationError extends Error {
+    readonly acceptance: SignScopeAcceptance;
+    readonly broadcast: boolean;
+    constructor(acceptance: SignScopeAcceptance, cause: unknown);
+}
+export declare function signScope(input: SignScopeActionInput): Promise<SignScopeActionResult>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/tasks/actions.d.ts.map

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

package/dist/tasks/canonical-json.d.ts

@@ -0,0 +1,6 @@
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare function canonicalizeJson(value: unknown): JsonValue;
+export declare function canonicalJson(value: unknown): string;
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/tasks/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../../src/tasks/canonical-json.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACnB,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEhF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAyB1D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/tasks/chain-error.d.ts

@@ -0,0 +1,6 @@
+import { TasksChainError } from "./chain-port.js";
+/** Local diagnostics may cross the CLI/MCP boundary. RPC/server errors never retain their original cause. */
+export declare class TasksValidationError extends Error {
+}
+export declare function safeTasksChainError(cause: unknown, broadcast: boolean, authorizationExposed: boolean, txHash?: `0x${string}`): TasksChainError;
+//# sourceMappingURL=chain-error.d.ts.map