@xona-labs/xpay 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -6,6 +6,42 @@ versioning follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.2.4] – 2026-07-03
+
+Re-release of 0.2.3 with no code changes (registry hygiene).
+
+## [0.2.3] – 2026-07-03
+
+### Added
+- **AgenC marketplace (agenc.ag) as a discovery source with smart-routed
+  execution.** Hireable AgenC listings now appear in `xpay discover` /
+  `xpay_discover` alongside x402 services (marked `metadata.source: "agenc"`,
+  priced in SOL). Discovery merges sources with failure isolation — one
+  catalog going down no longer breaks discovery — and reserves result slots so
+  marketplace listings aren't drowned out by the 21k-item x402 catalog. Opt
+  out with `XPAY_DISCOVERY_SOURCES=orbitx402` or `discover({ sources })`.
+- **Smart execution routing in `use()`.** AgenC resources are detected by
+  their `agenc-hire` payment scheme and executed as on-chain SOL escrow hires
+  via `@tetsuo-ai/marketplace-sdk` (humanless entry point — tasks pin to
+  CreatorReview, so escrow never auto-releases without the buyer's
+  acceptance). x402 resources keep the existing payment path; same
+  `use()`/`do()` API for both. The result of a hire is a receipt
+  (`task`, `hireRecord`, `txSig`, explorer link) — the provider works
+  asynchronously.
+- **CLI `xpay agenc hire <listingPda>` / `xpay agenc status <taskPda>`** and
+  MCP tool `xpay_agenc_status` for tracking hire progress.
+- **Guardrail SOL pricing.** AgenC hires are converted lamports → USD at spot
+  (multi-feed: CoinGecko → Coinbase → Kraken, 60s cache) and enforced against
+  the existing USD caps before signing; fails closed if no feed is reachable
+  while caps are configured.
+- Examples: `examples/agenc-hire.ts` (live discover → hire → poll) and
+  `examples/agenc-local-sandbox.ts` (full hire lifecycle against the real
+  compiled program in-process via litesvm — no RPC, no SOL spent).
+
+### Changed
+- `@solana/kit` bumped `^5.5.1` → `^6.9.0` (required by the AgenC SDK;
+  `@x402/svm` accepts `>=5.1.0`).
+
 ## [0.2.2] – 2026-06-30
 
 ### Fixed

package/README.md

@@ -5,13 +5,14 @@
 [![license](https://img.shields.io/npm/l/@xona-labs/xpay)](https://github.com/xona-labs/xpay/blob/main/LICENSE)
 ![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
 
-> **Agentic-commerce wallet.** Multi-network USDC wallet, x402 payments, and discovery across 20,000+ services — as a CLI, an SDK, and an MCP server.
+> **Agentic-commerce wallet.** Multi-network USDC wallet, x402 payments, AgenC marketplace hires, and discovery across 20,000+ services — as a CLI, an SDK, and an MCP server.
 
 ```bash
 npm install -g @xona-labs/xpay
 xpay init                                  # creates Solana + EVM keys, encrypted
-xpay discover "research API"               # 21k catalog, ranked
+xpay discover "research API"               # 21k x402 catalog + AgenC agent listings, ranked
 xpay pay  https://api.example.com/x402     # x402 one-liner
+xpay agenc hire <listingPda>               # hire an on-chain agent (SOL escrow)
 xpay transfer 5 USDC 7G73PL...gC           # direct USDC transfer
 xpay balance                               # unified across networks
 xpay report                                # daily / weekly / monthly report via OrbitX402
@@ -62,8 +63,10 @@ xpay pay https://orbisapi.com/proxy/image-alt-text-generator-api-1c9472
 | `xpay init [name]` | Create a profile (Solana + EVM keys from one BIP-39 seed). `--import` to restore from a phrase, `--no-encrypt` for dev wallets, `--workspace` to store locally. |
 | `xpay accounts list \| show \| use` | List profiles, inspect one, or set the active profile. |
 | `xpay balance` | USDC balance per network for the active profile. |
-| `xpay discover [query]` | Search 21k+ x402 services across chains — Solana, Base, **BNB Chain**, and other EVM networks (cached on disk). `--network`, `--limit`, `--json`. |
+| `xpay discover [query]` | Search 21k+ x402 services across chains — Solana, Base, **BNB Chain**, and other EVM networks — plus **AgenC marketplace** agent listings (cached on disk). `--network`, `--limit`, `--json`. |
 | `xpay pay <url>` | Pay an x402 endpoint. Works on catalog URLs and any URL that returns 402. `--max-usd`, `--body`, `-y`. |
+| `xpay agenc hire <listingPda>` | Hire an [AgenC marketplace](#agenc-marketplace-hire-on-chain-agents) listing — escrows its SOL price on-chain; the provider works asynchronously. `--max-usd`, `--review-window`, `-y`. |
+| `xpay agenc status <taskPda>` | Check a hire's progress (read-only, no wallet). `--json`. |
 | `xpay transfer <amount> USDC <to>` | Direct USDC transfer, subject to the guardrail. `--network`, `-y`. |
 | `xpay report` | Comprehensive USDC activity report — totals, net flow, timeline, top counterparties, biggest txs. `--period daily\|weekly\|monthly`, `--network`, `--json`. |
 | `xpay guardrail show \| set \| clear` | Inspect or edit spending caps and allowed hosts. |
@@ -160,7 +163,7 @@ That's the whole setup. The generated wallet's **Solana address is printed to
 stderr on first run** — fund it with USDC and the agent can pay. It persists
 under `~/.xpay` and is reused on every later boot, so the address is stable.
 
-The host sees the core tools: `xpay_discover`, `xpay_use`, `xpay_do`, `xpay_transfer`, `xpay_balance`, `xpay_report`, `xpay_guardrail`, plus `xpay_bento_status` / `xpay_bento_enable` / `xpay_bento_disable` to manage the [intent firewall](#security--bento-intent-firewall-optional). If you've linked a Sana key (see below), eight additional `sana_*` tools are also registered automatically.
+The host sees the core tools: `xpay_discover`, `xpay_use`, `xpay_do`, `xpay_transfer`, `xpay_balance`, `xpay_report`, `xpay_guardrail`, `xpay_agenc_status`, plus `xpay_bento_status` / `xpay_bento_enable` / `xpay_bento_disable` to manage the [intent firewall](#security--bento-intent-firewall-optional). If you've linked a Sana key (see below), eight additional `sana_*` tools are also registered automatically.
 
 **Bring your own wallet instead** — the wallet source order is *existing profile → key env → auto-generate*, so any of these overrides the generated wallet:
 
@@ -319,6 +322,31 @@ xpay sana unlink          # removes the key from the profile
 
 The `sana_*` tools disappear from the MCP server on next restart.
 
+## AgenC marketplace — hire on-chain agents
+
+[AgenC](https://agenc.ag) is a Solana-mainnet marketplace where registered agents sell services with on-chain escrow. Its hireable listings appear in `xpay discover` alongside x402 services — but they **execute differently**, and xpay routes them automatically:
+
+| | x402 service | AgenC listing |
+|---|---|---|
+| Priced in | USDC | native **SOL** |
+| Payment | HTTP `X-Payment` header | on-chain **escrow** (program `HJsZ…w1xK`) |
+| Result | immediate HTTP response | **hire receipt** — the provider works asynchronously |
+| Settlement | instant | after your review window (default 24h) |
+
+```bash
+xpay discover "research"                   # AgenC listings show as “agenc escrow”, priced in ◎SOL
+xpay agenc hire <listingPda>               # confirm → escrow SOL → get a task PDA
+xpay agenc status <taskPda>                # poll: open → claimed → review → settled
+```
+
+The same smart routing works in the SDK and MCP — `xpay.use(resource)` / `xpay_use` detect the `agenc-hire` payment scheme and run the escrow flow, returning a receipt (`task`, `txSig`, explorer link) as `data`. Hires are made through AgenC's *humanless* entry point, which pins the task to **CreatorReview** — escrowed funds never auto-release without your acceptance.
+
+Notes:
+- The guardrail applies to hires too: SOL prices are converted to USD at spot (multi-feed, cached) and checked against `maxPerTx`/`maxPerDay` **before signing**. If no price feed is reachable and caps are set, the hire fails closed.
+- The wallet needs **SOL** (escrow + fees), not just USDC.
+- Reviewing/accepting results happens on [agenc.ag](https://agenc.ag) for now; `xpay agenc accept` is planned.
+- Config (optional): `agenc: { rpcUrl, reviewWindowSecs, endpoint }` in the profile, or `XPAY_AGENC_ENDPOINT`. Opt out of the discovery source with `XPAY_DISCOVERY_SOURCES=orbitx402`.
+
 ## Multi-network
 
 `init` configures Solana and Base by default. Add or change via `~/.xpay/<name>/config.json`:
@@ -340,23 +368,25 @@ Public RPCs work for development but rate-limit hard. Production deployments sho
 ## How it works
 
 - **Keys** — One BIP-39 mnemonic per profile derives Solana (`m/44'/501'/0'/0'`, Phantom-compatible) and EVM (`m/44'/60'/0'/0/0`, MetaMask-compatible) keypairs. Encrypted at rest with scrypt + AES-256-GCM.
-- **Discovery** — the catalog spans 21k+ x402 endpoints across multiple chains — **Solana, Base, BNB Chain, and other EVM networks** — so `discover()` surfaces BNB Chain x402 resources alongside everything else. The fetcher walks the offset-pagination, validates each entry against a Zod schema, and persists to `~/.xpay/cache/` so repeat lookups skip the cold-fetch tax. (Filter with `--network` / `discover({ networks })`.)
-- **Pay** — `use()` and `useByUrl()` both go: guardrail check → signer.pay(USDC) on the right network → `X-Payment` header → retry. The signer abstraction means the same code path works for Solana SPL transfers and EVM ERC-20 transfers.
+- **Discovery** — the catalog spans 21k+ x402 endpoints across multiple chains — **Solana, Base, BNB Chain, and other EVM networks** — plus AgenC marketplace listings, merged from independent sources (`Promise.allSettled`, so one source failing never kills discovery). The fetcher walks each API's pagination, validates every entry against a Zod schema, and persists to `~/.xpay/cache/` so repeat lookups skip the cold-fetch tax. (Filter with `--network` / `discover({ networks })`; pick sources with `discover({ sources })` or `XPAY_DISCOVERY_SOURCES`.)
+- **Pay** — `use()` and `useByUrl()` both go: guardrail check → signer.pay(USDC) on the right network → `X-Payment` header → retry. The signer abstraction means the same code path works for Solana SPL transfers and EVM ERC-20 transfers. AgenC resources are detected by their `agenc-hire` payment scheme and routed to the on-chain escrow flow instead — same `use()` call, different rail.
 - **Report** — Comprehensive USDC activity (daily / weekly / monthly) fetched from the OrbitX402 API. On-chain data is resolved server-side — no RPC calls from xpay, no rate-limiting, no RPC key required.
 
 ## Project status
 
-**v0.1 (current):**
-- ✅ CLI: init, accounts, balance, discover, pay, transfer, report, guardrail, mcp
+**v0.2.4 (current):**
+- ✅ CLI: init, accounts, balance, discover, pay, agenc, transfer, report, guardrail, mcp
 - ✅ SDK: full parity with CLI; tool exporters for Claude / OpenAI / Gemini
-- ✅ MCP server on stdio with 10 tools (incl. the Bento intent firewall)
+- ✅ MCP server on stdio with 11 tools (incl. the Bento intent firewall)
 - ✅ Solana + Base mainnet with disk caching
 - ✅ Optional Sana agent card integration (`xpay sana link`) — 8 additional `sana_*` tools
+- ✅ AgenC marketplace as a discovery source + smart-routed SOL escrow hires (`xpay agenc hire|status`)
 
-**v0.2 planned:**
+**Planned:**
 - `bridge` — USDC EVM ↔ SVM via CCTP (Circle's native burn/mint)
 - `link / unlink` — opt-in cloud sync (audit log, dashboard)
 - Pay catalog + xona-labs catalog as additional discovery sources
+- `xpay agenc accept|rate` — review AgenC hire results without leaving the CLI
 
 ## License
 

package/SKILL.md

@@ -45,6 +45,7 @@ the MCP `env`. To require an explicit wallet (no auto-generation), set
 | `xpay_balance` | The wallet's balance per network, plus its addresses (use this to tell the user where to send funds). |
 | `xpay_report` | Spending/income report (daily / weekly / monthly). |
 | `xpay_guardrail` | Read the active spending caps (per-tx, per-day, allowed hosts, approval threshold). |
+| `xpay_agenc_status` | Check the progress of an AgenC marketplace hire (see below). Read-only. |
 | `xpay_bento_status` | Check whether the Bento intent firewall is on (read-only). |
 | `xpay_bento_enable` | Turn the Bento intent firewall on. Returns the agent wallet address to register at app.bentoguard.xyz. |
 | `xpay_bento_disable` | Turn the Bento firewall off — use if the wallet isn't registered and payments are rejected. |
@@ -66,6 +67,28 @@ The agent pays from its own wallet, so **it must be funded first**. If a call
 fails for lack of funds, ask the user to send USDC to the address from
 `xpay_balance` (Solana mainnet or Base).
 
+## AgenC marketplace listings — a different execution rail
+
+`xpay_discover` results may include **AgenC marketplace** listings
+(`metadata.source === "agenc"`) — on-chain agent services priced in **SOL**,
+not USDC. Calling `xpay_use` on one is detected automatically and runs a
+Solana **escrow hire** instead of an HTTP payment:
+
+- The listing's SOL price is escrowed on-chain; the wallet needs **SOL**, not
+  USDC, for these.
+- The result is a **hire receipt** (`data.kind === "agenc-hire-receipt"` with
+  `task`, `txSig`, `explorer`), **not** the service's output — the provider
+  works asynchronously.
+- Poll `xpay_agenc_status { taskPda }` to track progress:
+  `open/claimed → review → settled`. A just-created task can 404 for ~a minute
+  (the API snapshot lags); retry, don't treat it as failure.
+- Tell the user the work is in progress and how to review it
+  (https://agenc.ag/tasks/<taskPda>) — escrow only settles after their review
+  window.
+
+The guardrail still applies (SOL converted to USD at spot, checked before
+signing), and hires never auto-release funds without the buyer's acceptance.
+
 ## Safety — built in, respect it
 
 - **Spending guardrail.** Per-tx and per-day USD caps and an allowed-host list
@@ -94,6 +117,11 @@ fails for lack of funds, ask the user to send USDC to the address from
 **Receive funds**
 - `xpay_balance` → give the user the Solana address to send USDC to.
 
+**Hire an on-chain agent (AgenC)**
+1. `xpay_discover { query: "..." }` → pick a result with `metadata.source === "agenc"`
+2. Confirm the SOL price with the user, then `xpay_use { resource: <that object> }`
+3. Report the receipt's `task` + `explorer` link; later, `xpay_agenc_status { taskPda }`.
+
 **Send funds (with approval)**
 1. `xpay_transfer { amount: 5, to: "<address>", token: "USDC" }` → returns a code
 2. Confirm details with the user

package/dist/agenc/api.d.ts

@@ -0,0 +1,138 @@
+/**
+ * AgenC marketplace client — keyless reads of Solana-mainnet marketplace state.
+ *
+ * AgenC (https://agenc.ag) lists standing service offers from registered
+ * on-chain agents. Discovery is a public REST API (cached snapshot of chain
+ * state, rebuilt ~every 45s); execution is NOT x402 — hiring escrows native
+ * SOL on-chain via `@tetsuo-ai/marketplace-sdk` (see ./hire.ts).
+ */
+import { z } from "zod";
+import type { Resource } from "../types.js";
+/** Payment scheme marking a resource as an AgenC escrow hire. `use()` dispatches on this. */
+export declare const AGENC_SCHEME = "agenc-hire";
+/** Listing shape returned by GET /api/listings. Lamports are u64 decimal strings. */
+declare const AgencListingSchema: z.ZodObject<{
+    pda: z.ZodString;
+    providerAgent: z.ZodString;
+    authority: z.ZodString;
+    name: z.ZodDefault<z.ZodString>;
+    specHash: z.ZodString;
+    specUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priceLamports: z.ZodString;
+    /** null = priced in native SOL. Anything else is an SPL mint (not hireable). */
+    priceMint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    defaultDeadlineSecs: z.ZodOptional<z.ZodNumber>;
+    operator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operatorFeeBps: z.ZodOptional<z.ZodNumber>;
+    /** 0=Active, 1=Paused, 2=Retired */
+    state: z.ZodNumber;
+    maxOpenJobs: z.ZodOptional<z.ZodNumber>;
+    openJobs: z.ZodOptional<z.ZodNumber>;
+    totalHires: z.ZodOptional<z.ZodString>;
+    ratingCount: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodDefault<z.ZodString>;
+    createdAtUnix: z.ZodOptional<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    pda: z.ZodString;
+    providerAgent: z.ZodString;
+    authority: z.ZodString;
+    name: z.ZodDefault<z.ZodString>;
+    specHash: z.ZodString;
+    specUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priceLamports: z.ZodString;
+    /** null = priced in native SOL. Anything else is an SPL mint (not hireable). */
+    priceMint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    defaultDeadlineSecs: z.ZodOptional<z.ZodNumber>;
+    operator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operatorFeeBps: z.ZodOptional<z.ZodNumber>;
+    /** 0=Active, 1=Paused, 2=Retired */
+    state: z.ZodNumber;
+    maxOpenJobs: z.ZodOptional<z.ZodNumber>;
+    openJobs: z.ZodOptional<z.ZodNumber>;
+    totalHires: z.ZodOptional<z.ZodString>;
+    ratingCount: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodDefault<z.ZodString>;
+    createdAtUnix: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    pda: z.ZodString;
+    providerAgent: z.ZodString;
+    authority: z.ZodString;
+    name: z.ZodDefault<z.ZodString>;
+    specHash: z.ZodString;
+    specUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priceLamports: z.ZodString;
+    /** null = priced in native SOL. Anything else is an SPL mint (not hireable). */
+    priceMint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    defaultDeadlineSecs: z.ZodOptional<z.ZodNumber>;
+    operator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operatorFeeBps: z.ZodOptional<z.ZodNumber>;
+    /** 0=Active, 1=Paused, 2=Retired */
+    state: z.ZodNumber;
+    maxOpenJobs: z.ZodOptional<z.ZodNumber>;
+    openJobs: z.ZodOptional<z.ZodNumber>;
+    totalHires: z.ZodOptional<z.ZodString>;
+    ratingCount: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodDefault<z.ZodString>;
+    createdAtUnix: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
+export type AgencListing = z.infer<typeof AgencListingSchema>;
+/** Task shape returned by GET /api/tasks/:pda — used to poll hire progress. */
+declare const AgencTaskSchema: z.ZodObject<{
+    pda: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    rewardLamports: z.ZodOptional<z.ZodString>;
+    deadlineUnix: z.ZodOptional<z.ZodNumber>;
+    createdAtUnix: z.ZodOptional<z.ZodNumber>;
+    creatorPda: z.ZodOptional<z.ZodString>;
+    workerPda: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    pda: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    rewardLamports: z.ZodOptional<z.ZodString>;
+    deadlineUnix: z.ZodOptional<z.ZodNumber>;
+    createdAtUnix: z.ZodOptional<z.ZodNumber>;
+    creatorPda: z.ZodOptional<z.ZodString>;
+    workerPda: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    pda: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    rewardLamports: z.ZodOptional<z.ZodString>;
+    deadlineUnix: z.ZodOptional<z.ZodNumber>;
+    createdAtUnix: z.ZodOptional<z.ZodNumber>;
+    creatorPda: z.ZodOptional<z.ZodString>;
+    workerPda: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type AgencTask = z.infer<typeof AgencTaskSchema>;
+export interface AgencClientOptions {
+    /** API base. Defaults to https://api.agenc.ag (override: XPAY_AGENC_ENDPOINT). */
+    endpoint?: string;
+    maxItems?: number;
+    fetch?: typeof fetch;
+}
+/**
+ * Fetch all hireable listings (Active, SOL-priced, moderation-passed) and map
+ * them into xpay's Resource shape. The API pre-filters via `hireable=true`;
+ * we re-check state/mint per item as belt-and-suspenders.
+ */
+export declare function fetchAgencResources(opts?: AgencClientOptions): Promise<Resource[]>;
+/**
+ * Map an AgenC listing into xpay's Resource shape. Everything `hire.ts` needs
+ * to execute rides in `accepts[0].extra`, so a discovered resource is
+ * self-contained — no extra API round-trips at hire time.
+ */
+export declare function listingToResource(l: AgencListing): Resource;
+/** Whether a discovered resource is an AgenC listing (executes as an escrow hire, not HTTP). */
+export declare function isAgencResource(r: Resource): boolean;
+/**
+ * Fetch a single listing by PDA — used as a pre-hire freshness check. The API
+ * has no listing-by-pda route, so scan the hireable pages for a match.
+ * Returns undefined when the listing is gone or no longer hireable.
+ */
+export declare function fetchAgencListing(pda: string, opts?: AgencClientOptions): Promise<AgencListing | undefined>;
+/** Fetch a task by PDA (GET /api/tasks/:pda) — the status of a hire. */
+export declare function fetchAgencTask(pda: string, opts?: AgencClientOptions): Promise<AgencTask>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/agenc/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/agenc/api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,6FAA6F;AAC7F,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,qFAAqF;AACrF,QAAA,MAAM,kBAAkB;;;;;;;;IASpB,gFAAgF;;;;;IAKhF,oCAAoC;;;;;;;;;;;;;;;;IALpC,gFAAgF;;;;;IAKhF,oCAAoC;;;;;;;;;;;;;;;;IALpC,gFAAgF;;;;;IAKhF,oCAAoC;;;;;;;;gCASxB,CAAC;AACjB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,+EAA+E;AAC/E,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAWL,CAAC;AACjB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AASD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAkC5F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CAiC3D;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAsBnC;AAED,wEAAwE;AACxE,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoBnG"}

package/dist/agenc/api.js

@@ -0,0 +1,194 @@
+/**
+ * AgenC marketplace client — keyless reads of Solana-mainnet marketplace state.
+ *
+ * AgenC (https://agenc.ag) lists standing service offers from registered
+ * on-chain agents. Discovery is a public REST API (cached snapshot of chain
+ * state, rebuilt ~every 45s); execution is NOT x402 — hiring escrows native
+ * SOL on-chain via `@tetsuo-ai/marketplace-sdk` (see ./hire.ts).
+ */
+import { z } from "zod";
+const DEFAULT_ENDPOINT = "https://api.agenc.ag";
+const PAGE_SIZE = 100; // API max
+/** Payment scheme marking a resource as an AgenC escrow hire. `use()` dispatches on this. */
+export const AGENC_SCHEME = "agenc-hire";
+/** Listing shape returned by GET /api/listings. Lamports are u64 decimal strings. */
+const AgencListingSchema = z
+    .object({
+    pda: z.string(),
+    providerAgent: z.string(),
+    authority: z.string(),
+    name: z.string().default(""),
+    specHash: z.string(),
+    specUri: z.string().nullable().optional(),
+    priceLamports: z.string(),
+    /** null = priced in native SOL. Anything else is an SPL mint (not hireable). */
+    priceMint: z.string().nullable().optional(),
+    defaultDeadlineSecs: z.number().optional(),
+    operator: z.string().nullable().optional(),
+    operatorFeeBps: z.number().optional(),
+    /** 0=Active, 1=Paused, 2=Retired */
+    state: z.number(),
+    maxOpenJobs: z.number().optional(),
+    openJobs: z.number().optional(),
+    totalHires: z.string().optional(),
+    ratingCount: z.number().optional(),
+    version: z.string().default("1"),
+    createdAtUnix: z.number().optional(),
+})
+    .passthrough();
+/** Task shape returned by GET /api/tasks/:pda — used to poll hire progress. */
+const AgencTaskSchema = z
+    .object({
+    pda: z.string(),
+    title: z.string().optional(),
+    status: z.string(),
+    rewardLamports: z.string().optional(),
+    deadlineUnix: z.number().optional(),
+    createdAtUnix: z.number().optional(),
+    creatorPda: z.string().optional(),
+    workerPda: z.string().nullable().optional(),
+})
+    .passthrough();
+/**
+ * Fetch all hireable listings (Active, SOL-priced, moderation-passed) and map
+ * them into xpay's Resource shape. The API pre-filters via `hireable=true`;
+ * we re-check state/mint per item as belt-and-suspenders.
+ */
+export async function fetchAgencResources(opts = {}) {
+    const endpoint = opts.endpoint ?? process.env.XPAY_AGENC_ENDPOINT ?? DEFAULT_ENDPOINT;
+    const maxItems = opts.maxItems ?? Infinity;
+    const fetchImpl = opts.fetch ?? fetch;
+    const all = [];
+    let total = Infinity;
+    for (let page = 1; page <= 100 && all.length < Math.min(total, maxItems); page++) {
+        const url = new URL("/api/listings", endpoint);
+        url.searchParams.set("hireable", "true");
+        url.searchParams.set("page", String(page));
+        url.searchParams.set("pageSize", String(PAGE_SIZE));
+        const res = await fetchImpl(url.toString(), { headers: { accept: "application/json" } });
+        if (!res.ok)
+            throw new Error(await apiError("AgenC discovery", res));
+        const body = (await res.json());
+        const rawItems = body.items ?? [];
+        for (const raw of rawItems) {
+            const parsed = AgencListingSchema.safeParse(raw);
+            if (!parsed.success)
+                continue;
+            const l = parsed.data;
+            if (l.state !== 0 || (l.priceMint !== null && l.priceMint !== undefined))
+                continue;
+            all.push(listingToResource(l));
+            if (all.length >= maxItems)
+                return all;
+        }
+        total = body.total ?? all.length;
+        if (rawItems.length < PAGE_SIZE)
+            break;
+    }
+    return all;
+}
+/**
+ * Map an AgenC listing into xpay's Resource shape. Everything `hire.ts` needs
+ * to execute rides in `accepts[0].extra`, so a discovered resource is
+ * self-contained — no extra API round-trips at hire time.
+ */
+export function listingToResource(l) {
+    return {
+        resource: `https://agenc.ag/listings/${l.pda}`,
+        type: "agenc",
+        method: "HIRE",
+        accepts: [
+            {
+                scheme: AGENC_SCHEME,
+                network: "solana",
+                asset: "SOL",
+                payTo: l.authority,
+                amount: l.priceLamports,
+                ...(l.defaultDeadlineSecs ? { maxTimeoutSeconds: l.defaultDeadlineSecs } : {}),
+                extra: {
+                    listingPda: l.pda,
+                    specHash: l.specHash,
+                    version: l.version,
+                    providerAgent: l.providerAgent,
+                    operator: l.operator ?? null,
+                    operatorFeeBps: l.operatorFeeBps ?? 0,
+                },
+            },
+        ],
+        metadata: {
+            source: "agenc",
+            name: l.name,
+            listingPda: l.pda,
+            specUri: l.specUri ?? null,
+            reputation: { ratingCount: l.ratingCount ?? 0, totalHires: l.totalHires ?? "0" },
+            capacity: { openJobs: l.openJobs ?? 0, maxOpenJobs: l.maxOpenJobs ?? 0 },
+            execution: "solana-escrow-hire",
+        },
+    };
+}
+/** Whether a discovered resource is an AgenC listing (executes as an escrow hire, not HTTP). */
+export function isAgencResource(r) {
+    return r.accepts.some((a) => a.scheme === AGENC_SCHEME);
+}
+/**
+ * Fetch a single listing by PDA — used as a pre-hire freshness check. The API
+ * has no listing-by-pda route, so scan the hireable pages for a match.
+ * Returns undefined when the listing is gone or no longer hireable.
+ */
+export async function fetchAgencListing(pda, opts = {}) {
+    const endpoint = opts.endpoint ?? process.env.XPAY_AGENC_ENDPOINT ?? DEFAULT_ENDPOINT;
+    const fetchImpl = opts.fetch ?? fetch;
+    for (let page = 1; page <= 100; page++) {
+        const url = new URL("/api/listings", endpoint);
+        url.searchParams.set("hireable", "true");
+        url.searchParams.set("page", String(page));
+        url.searchParams.set("pageSize", String(PAGE_SIZE));
+        const res = await fetchImpl(url.toString(), { headers: { accept: "application/json" } });
+        if (!res.ok)
+            throw new Error(await apiError("AgenC listing lookup", res));
+        const body = (await res.json());
+        const rawItems = body.items ?? [];
+        for (const raw of rawItems) {
+            const parsed = AgencListingSchema.safeParse(raw);
+            if (parsed.success && parsed.data.pda === pda)
+                return parsed.data;
+        }
+        if (rawItems.length < PAGE_SIZE)
+            break;
+    }
+    return undefined;
+}
+/** Fetch a task by PDA (GET /api/tasks/:pda) — the status of a hire. */
+export async function fetchAgencTask(pda, opts = {}) {
+    const endpoint = opts.endpoint ?? process.env.XPAY_AGENC_ENDPOINT ?? DEFAULT_ENDPOINT;
+    const fetchImpl = opts.fetch ?? fetch;
+    const url = new URL(`/api/tasks/${encodeURIComponent(pda)}`, endpoint);
+    const res = await fetchImpl(url.toString(), { headers: { accept: "application/json" } });
+    if (res.status === 404) {
+        throw new Error(`AgenC task ${pda} not found. The API snapshot rebuilds ~every 45s — ` +
+            `if this hire just landed, retry in about a minute.`);
+    }
+    if (!res.ok)
+        throw new Error(await apiError("AgenC task lookup", res));
+    const body = (await res.json());
+    const parsed = AgencTaskSchema.safeParse(body.task ?? body);
+    if (!parsed.success) {
+        throw new Error(`AgenC task lookup: unexpected response shape for ${pda}`);
+    }
+    return parsed.data;
+}
+/** Render an API failure, surfacing the `{error}` body and the 503 chain-lag case. */
+async function apiError(what, res) {
+    let reason = "";
+    try {
+        const body = (await res.json());
+        if (body?.error)
+            reason = ` — ${body.error}`;
+    }
+    catch {
+        /* no JSON body */
+    }
+    const hint = res.status === 503 ? " (chain snapshot lagging; retry shortly)" : "";
+    return `${what} failed: ${res.status} ${res.statusText}${reason}${hint}`;
+}
+//# sourceMappingURL=api.js.map

package/dist/agenc/api.js.map

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

package/dist/agenc/hire.d.ts

@@ -0,0 +1,41 @@
+/**
+ * AgenC hire execution — the non-x402 payment rail.
+ *
+ * Hiring a listing is a Solana transaction (program
+ * HJsZ53Zb27b8QMRbQpuDngE44AdwCGxvEZr61Zmxw1xK) that escrows the listing's
+ * price in native SOL and creates a Task + HireRecord on-chain. The provider
+ * then works ASYNCHRONOUSLY: escrow → work → review → settle. So unlike an
+ * x402 call, `use()` on an AgenC resource returns a hire *receipt*, not a
+ * response body — poll progress with `xpay agenc status <taskPda>`.
+ *
+ * The humanless entry point pins the task to CreatorReview, so escrowed funds
+ * never auto-release without the buyer accepting the result.
+ */
+import type { UseResult } from "../types.js";
+import { type UseArgs } from "../use/index.js";
+export interface AgencHireConfig {
+    /** Solana RPC for building/sending the hire tx. Falls back to XPAY_SOLANA_RPC, then xpay's default. */
+    rpcUrl?: string;
+    /** Buyer review window after the provider submits, in seconds. Default 86400 (24h). */
+    reviewWindowSecs?: number;
+    /** AgenC API base override (freshness check + status polling). */
+    endpoint?: string;
+}
+/** Returned as `UseResult.data` for an AgenC hire. */
+export interface AgencHireReceipt {
+    kind: "agenc-hire-receipt";
+    /** Listing PDA that was hired. */
+    listing: string;
+    /** Task PDA created by the hire — the handle for status polling and review. */
+    task: string;
+    /** HireRecord PDA linking the task back to the listing. */
+    hireRecord: string;
+    providerAgent: string;
+    priceLamports: string;
+    txSig: string;
+    status: "escrowed";
+    statusHint: string;
+    explorer: string;
+}
+export declare function useAgencHire(args: UseArgs): Promise<UseResult>;
+//# sourceMappingURL=hire.d.ts.map

package/dist/agenc/hire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hire.d.ts","sourceRoot":"","sources":["../../src/agenc/hire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAsB,SAAS,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAIlE,MAAM,WAAW,eAAe;IAC9B,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAQD,wBAAsB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAoGpE"}