@heyanon-arp/sdk 0.0.8 → 0.0.9

package/dist/types/agent.d.ts

@@ -0,0 +1,64 @@
+import type { PricingModel } from './body';
+/**
+ * Agent accept-preferences ("PricingPolicy") — the worker-side "what I
+ * accept" constraints a registered agent publishes on its profile.
+ *
+ * These are REST agent-profile surface types (camelCase, like the
+ * `GET /v1/agents/:did` response), NOT envelope wire types (snake_case)
+ * — the agent profile API already speaks camelCase (`identityPublicKey`,
+ * `registeredAt`), so prefs follow suit.
+ *
+ * Semantics (server-enforced at `delegation offer` time):
+ *   - Prefs are OPTIONAL. Absent prefs (or an absent/empty list inside
+ *     them) means "no constraint" — fully backward-compatible.
+ *   - The server validates an incoming offer's inline terms against the
+ *     RECIPIENT's prefs and rejects mismatches with
+ *     `DELEGATION_PRICING_MISMATCH` (409) before the delegation row is
+ *     created. Deny-only: the server never auto-accepts on the agent's
+ *     behalf.
+ *   - Writes go through the signed `PATCH /v1/agents/:did` profile
+ *     update and REPLACE the whole object (send `null` to clear) —
+ *     same replace semantics as `tags`.
+ */
+export interface AcceptPrefs {
+    /**
+     * Accepted pricing models. Empty/absent ⇒ any model. Subset of the
+     * closed `PricingModel` set.
+     */
+    pricingModels?: PricingModel[];
+    /**
+     * Accepted currencies with optional per-currency amount bounds.
+     * Empty/absent ⇒ any currency, no amount bound. An offer whose
+     * `currency.asset_id` matches no entry is rejected.
+     */
+    currencies?: AcceptCurrency[];
+    /**
+     * Capacity cap: max delegations this agent will hold in ACTIVE
+     * states (offered / accepted / pending_lock_finalization / locked)
+     * at once. An offer that would exceed it is rejected with
+     * `DELEGATION_CAPACITY_EXCEEDED` — a TRANSIENT condition (retry
+     * later / pick another worker), unlike a pricing mismatch.
+     * `0` = closed for new offers (the "busy flag"). Absent ⇒ unlimited.
+     */
+    maxActiveDelegations?: number;
+}
+/**
+ * One accepted currency + optional amount bounds. Bounds are
+ * per-currency because a raw min/max is meaningless across assets
+ * (1 USDC ≠ 1 SOL; differing decimals).
+ */
+export interface AcceptCurrency {
+    /** CAIP-19 asset id — compared against the offer's `currency.asset_id`. */
+    assetId: string;
+    /**
+     * Inclusive lower bound on the offer `amount`, as a human-readable
+     * decimal string in THIS currency's units (scaled by the offer
+     * currency's `decimals` for comparison). Must be > 0 when set.
+     */
+    minAmount?: string;
+    /**
+     * Inclusive upper bound on the offer `amount` (same units as
+     * `minAmount`). Must be ≥ `minAmount` when both are set.
+     */
+    maxAmount?: string;
+}

package/dist/types/body.d.ts

@@ -41,6 +41,14 @@ export interface AssetIdentifier {
     /** Optional UI hint — `USDC`, `SOL`. Never used for protocol logic. */
     symbol?: string;
 }
+/**
+ * Closed set of delegation pricing models. `flat` = the locked amount
+ * is the agreed total; `usage_based` = the locked amount is a ceiling
+ * and the final payout is computed from reported usage at receipt time.
+ * Referenced both by `DelegationContent.pricing_model` (the offer's
+ * inline term) and by agent accept-prefs (`AcceptPrefs.pricingModels`).
+ */
+export type PricingModel = 'flat' | 'usage_based';
 /**
  * Closed enum of machine-readable decline reasons used across the
  * two decline sites in V1:
@@ -121,7 +129,7 @@ export interface DelegationContent {
     amount?: string;
     currency?: AssetIdentifier;
     scope_summary?: string;
-    pricing_model?: 'flat' | 'usage_based';
+    pricing_model?: PricingModel;
     /** Machine-readable reason — REQUIRED when `action === 'decline'`. See `DeclineReason`. */
     reason?: DeclineReason;
     /** Optional free-text elaboration (e.g. "delegation offer missing required brief.goal field"). */

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export type { Sha256Hex, Ed25519Sig, Did, ProtectedBlock, Body, Attachments, CoSignature, SettlementSignatures, SettlementParty, EscrowLockAttachment, Envelope, PersistedEvent, } from './envelope';
-export type { HandshakeBody, HandshakeContent, HandshakeResponseBody, HandshakeResponseContent, DelegationBody, DelegationContent, WorkRequestBody, WorkRequestContent, WorkResponseBody, WorkResponseContent, ReceiptBody, ReceiptContent, DisputeBody, DisputeContent, SettlementSignatureBody, SettlementSignatureContent, AnyBody, ReceiptCosignPayload, DisputeResponseCosignPayload, CosignPayload, DeclineReason, AssetIdentifier, } from './body';
+export type { HandshakeBody, HandshakeContent, HandshakeResponseBody, HandshakeResponseContent, DelegationBody, DelegationContent, WorkRequestBody, WorkRequestContent, WorkResponseBody, WorkResponseContent, ReceiptBody, ReceiptContent, DisputeBody, DisputeContent, SettlementSignatureBody, SettlementSignatureContent, AnyBody, ReceiptCosignPayload, DisputeResponseCosignPayload, CosignPayload, DeclineReason, AssetIdentifier, PricingModel, } from './body';
 export { DECLINE_REASONS, isDeclineReason } from './body';
+export type { AcceptPrefs, AcceptCurrency } from './agent';
 export type { OwnerSigningMethod, KeyLinkPayload, ScryptPasswordAttestation } from './identity';
 export { SCRYPT_PARAMS } from './identity';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyanon-arp/sdk",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "TypeScript SDK for the Agent Relationship Protocol — canonical JSON, Ed25519 envelope sign/verify, did:arp identity, receipt co-signatures, scrypt key attestation, chain-audit helpers.",
   "license": "MIT",
   "keywords": [