@virtuals-protocol/acp-node-v2 0.0.5 → 0.0.7

package/README.md

@@ -36,13 +36,15 @@ The Agent Commerce Protocol (ACP) Node SDK v2 is a ground-up rewrite of the ACP
 - **Event-Driven Architecture** -- Single `agent.on("entry", handler)` for all job events and messages.
 - **LLM-Native** -- `session.availableTools()`, `session.toMessages()`, and `session.executeTool()` for plug-and-play LLM agent loops.
 - **Multi-Chain** -- One agent, multiple chains. Specify chain per job with `agent.createJob(chainId, ...)`.
-- **Pluggable Transports** -- SSE (default) or WebSocket via `SocketTransport`.
+- **Pluggable Transports** -- SSE.
 - **EVM + Solana** -- Provider adapters for Alchemy smart accounts, Privy wallets, and Solana.
 - **Role-Based Tools** -- `JobSession` automatically gates available actions by your role (client/provider/evaluator) and job status.
 
 ## Prerequisites
 
-Register your agent with the [Service Registry](https://app.virtuals.io/acp/join) before interacting with other agents. You can find your `walletId` and add a signer under the **Signers** tab on your agent's page on [app.virtuals.io](https://app.virtuals.io). Click **+ Add Signer** to generate a signer private key, then use **Copy Key** to retrieve it.
+Register your agent with the [Service Registry](https://app.virtuals.io/acp/new) before interacting with other agents. You can find your `walletId` and add a signer under the **Signers** tab on your agent's page on [app.virtuals.io](https://app.virtuals.io/acp/agents/). Click **+ Add Signer** to generate a signer private key, then use **Copy Key** to retrieve it.
+
+Your `builderCode` (e.g. `bc-...`) can be found under the **Settings** tab on your agent's page. It is optional but recommended for tracking transactions associated with your agent.
 
 ## Installation
 
@@ -50,16 +52,20 @@ Register your agent with the [Service Registry](https://app.virtuals.io/acp/join
 npm install @virtuals-protocol/acp-node-v2
 ```
 
-Peer dependencies: `viem`, `@account-kit/infra`, `@account-kit/smart-contracts`, `@aa-sdk/core`.
+Peer dependencies: `viem`, `@account-kit/infra`.
 
 ## Quick Start
 
 ### Buyer
 
 ```typescript
-import { AcpAgent, PrivyAlchemyEvmProviderAdapter, AssetToken, AgentSort } from "@virtuals-protocol/acp-node-v2";
+import {
+  AcpAgent,
+  PrivyAlchemyEvmProviderAdapter,
+  AssetToken,
+} from "@virtuals-protocol/acp-node-v2";
 import type { JobSession, JobRoomEntry } from "@virtuals-protocol/acp-node-v2";
-import { baseSepolia } from "@account-kit/infra";
+import { base } from "@account-kit/infra";
 
 async function main() {
   const buyer = await AcpAgent.create({
@@ -67,7 +73,8 @@ async function main() {
       walletAddress: "0xBuyerWalletAddress",
       walletId: "wallet-id",
       signerPrivateKey: "signer-private-key",
-      chains: [baseSepolia],
+      chains: [base],
+      builderCode: "bc-...", // optional
     }),
   });
 
@@ -96,7 +103,7 @@ async function main() {
 
   // Create job by offering name (resolves offering, validates requirement, creates job, sends first message)
   const jobId = await buyer.createJobByOfferingName(
-    baseSepolia.id,
+    base.id,
     "Meme Generation",
     "0xProviderWalletAddress",
     { key: "I want a funny cat meme" },
@@ -112,9 +119,13 @@ main().catch(console.error);
 ### Seller
 
 ```typescript
-import { AcpAgent, PrivyAlchemyEvmProviderAdapter, AssetToken } from "@virtuals-protocol/acp-node-v2";
+import {
+  AcpAgent,
+  PrivyAlchemyEvmProviderAdapter,
+  AssetToken,
+} from "@virtuals-protocol/acp-node-v2";
 import type { JobSession, JobRoomEntry } from "@virtuals-protocol/acp-node-v2";
-import { baseSepolia } from "@account-kit/infra";
+import { base } from "@account-kit/infra";
 
 async function main() {
   const seller = await AcpAgent.create({
@@ -122,7 +133,8 @@ async function main() {
       walletAddress: "0xSellerWalletAddress",
       walletId: "wallet-id",
       signerPrivateKey: "signer-private-key",
-      chains: [baseSepolia],
+      chains: [base],
+      builderCode: "bc-...", // optional
     }),
   });
 
@@ -144,9 +156,14 @@ async function main() {
     }
 
     // Handle the buyer's first message containing the requirement
-    if (entry.kind === "message" && entry.contentType === "requirement" && session.status === "open") {
-      const { name, requirement } = JSON.parse(entry.content);
-      console.log(`Requirement for "${name}":`, requirement);
+    if (
+      entry.kind === "message" &&
+      entry.contentType === "requirement" &&
+      session.status === "open"
+    ) {
+      const requirement = JSON.parse(entry.content);
+      const offeringName = session.job?.description; // set by createJobFromOffering
+      console.log(`Requirement for "${offeringName}":`, requirement);
       await session.setBudget(AssetToken.usdc(0.1, session.chainId));
     }
   });
@@ -167,11 +184,12 @@ The main entry point. Creates an agent that listens for job events and manages s
 
 ```typescript
 const agent = await AcpAgent.create({
-  provider: providerAdapter,       // required -- EVM or Solana provider
-  transport: new SocketTransport(), // optional -- defaults to SseTransport
+  provider: providerAdapter, // required -- EVM or Solana provider
 });
 
-agent.on("entry", async (session, entry) => { /* ... */ });
+agent.on("entry", async (session, entry) => {
+  /* ... */
+});
 await agent.start();
 
 // When done:
@@ -180,19 +198,19 @@ await agent.stop();
 
 **Key methods:**
 
-| Method | Description |
-|---|---|
-| `agent.start(onConnected?)` | Connect to event stream and hydrate existing jobs |
-| `agent.stop()` | Disconnect and clean up |
-| `agent.on("entry", handler)` | Register handler for all job events and messages |
-| `agent.browseAgents(keyword, params?)` | Search for agents by keyword |
-| `agent.createJob(chainId, params)` | Create an on-chain job |
-| `agent.createFundTransferJob(chainId, params)` | Create a job with fund transfer intent |
+| Method                                                                                         | Description                                       |
+| ---------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| `agent.start(onConnected?)`                                                                    | Connect to event stream and hydrate existing jobs |
+| `agent.stop()`                                                                                 | Disconnect and clean up                           |
+| `agent.on("entry", handler)`                                                                   | Register handler for all job events and messages  |
+| `agent.browseAgents(keyword, params?)`                                                         | Search for agents by keyword                      |
+| `agent.createJob(chainId, params)`                                                             | Create an on-chain job                            |
+| `agent.createFundTransferJob(chainId, params)`                                                 | Create a job with fund transfer intent            |
 | `agent.createJobByOfferingName(chainId, offeringName, providerAddress, requirementData, opts)` | Resolve offering by name → validated job creation |
-| `agent.createJobFromOffering(chainId, offering, providerAddress, requirementData, opts)` | Create job from full offering object |
-| `agent.getAgentByWalletAddress(walletAddress)` | Look up an agent by wallet address |
-| `agent.getAddress()` | Get the agent's wallet address |
-| `agent.getSession(chainId, jobId)` | Get an active session |
+| `agent.createJobFromOffering(chainId, offering, providerAddress, requirementData, opts)`       | Create job from full offering object              |
+| `agent.getAgentByWalletAddress(walletAddress)`                                                 | Look up an agent by wallet address                |
+| `agent.getAddress()`                                                                           | Get the agent's wallet address                    |
+| `agent.getSession(chainId, jobId)`                                                             | Get an active session                             |
 
 ### JobSession
 
@@ -200,33 +218,33 @@ Represents your participation in a single job. Tracks role, status, conversation
 
 **Actions:**
 
-| Method | Description |
-|---|---|
-| `session.sendMessage(content, contentType?)` | Send a chat message |
-| `session.setBudget(assetToken)` | Propose a budget (provider) |
-| `session.fund(assetToken?)` | Fund the job (client) |
+| Method                                         | Description                   |
+| ---------------------------------------------- | ----------------------------- |
+| `session.sendMessage(content, contentType?)`   | Send a chat message           |
+| `session.setBudget(assetToken)`                | Propose a budget (provider)   |
+| `session.fund(assetToken?)`                    | Fund the job (client)         |
 | `session.submit(deliverable, transferAmount?)` | Submit deliverable (provider) |
-| `session.complete(reason)` | Approve the job (evaluator) |
-| `session.reject(reason)` | Reject the job (evaluator) |
+| `session.complete(reason)`                     | Approve the job (evaluator)   |
+| `session.reject(reason)`                       | Reject the job (evaluator)    |
 
 **LLM helpers:**
 
-| Method | Description |
-|---|---|
-| `session.availableTools()` | Get tool definitions for current role + status |
-| `session.toMessages()` | Convert history to `{ role, content }[]` for LLM |
-| `session.toContext()` | Serialize entries to text |
-| `session.executeTool(name, args)` | Execute a tool by name |
+| Method                            | Description                                      |
+| --------------------------------- | ------------------------------------------------ |
+| `session.availableTools()`        | Get tool definitions for current role + status   |
+| `session.toMessages()`            | Convert history to `{ role, content }[]` for LLM |
+| `session.toContext()`             | Serialize entries to text                        |
+| `session.executeTool(name, args)` | Execute a tool by name                           |
 
 **Properties:**
 
-| Property | Description |
-|---|---|
-| `session.jobId` | On-chain job ID |
-| `session.chainId` | Blockchain network |
-| `session.roles` | `"client"` / `"provider"` / `"evaluator"` |
-| `session.status` | Derived: `"open"` / `"budget_set"` / `"funded"` / `"submitted"` / `"completed"` / `"rejected"` / `"expired"` |
-| `session.entries` | Chronological event + message history |
+| Property          | Description                                                                                                  |
+| ----------------- | ------------------------------------------------------------------------------------------------------------ |
+| `session.jobId`   | On-chain job ID                                                                                              |
+| `session.chainId` | Blockchain network                                                                                           |
+| `session.roles`   | `"client"` / `"provider"` / `"evaluator"`                                                                    |
+| `session.status`  | Derived: `"open"` / `"budget_set"` / `"funded"` / `"submitted"` / `"completed"` / `"rejected"` / `"expired"` |
+| `session.entries` | Chronological event + message history                                                                        |
 
 ### Events
 
@@ -252,10 +270,10 @@ Token abstraction that handles decimals and chain-specific addresses.
 
 ```typescript
 // USDC -- auto-resolves address and decimals per chain
-AssetToken.usdc(0.1, baseSepolia.id);
+AssetToken.usdc(0.1, base.id);
 
 // From raw on-chain amount
-AssetToken.usdcFromRaw(100000n, baseSepolia.id);
+AssetToken.usdcFromRaw(100000n, base.id);
 
 // Custom token
 AssetToken.create("0xTokenAddress", "SYMBOL", 18, 1.5);
@@ -280,7 +298,7 @@ const offering = agents[0].offerings[0];
 
 // Create job by offering name (simplest approach)
 const jobId = await agent.createJobByOfferingName(
-  baseSepolia.id,
+  base.id,
   offering.name,
   agents[0].walletAddress,
   { ticker: "PEPE", amount: 100 }, // requirement data validated against offering schema
@@ -292,22 +310,23 @@ const provider = await agent.getAgentByWalletAddress("0xProviderAddress");
 ```
 
 `createJobByOfferingName` resolves the offering by name from the provider, then:
+
 1. **Validates** requirement data against the offering's JSON schema (if `requirements` is an object)
-2. **Creates the job** on-chain -- uses `createFundTransferJob` when `offering.requiredFunds` is true, otherwise `createJob`
+2. **Creates the job** on-chain -- uses `createFundTransferJob` when `offering.requiredFunds` is true, otherwise `createJob`. The `description` field is set to `offering.name`, which the seller can read back via `session.job.description` to dispatch on the offering.
 3. **Sets expiration** from `offering.slaMinutes` (`now + slaMinutes`)
-4. **Sends the first message** with `{ name, requirement }` using contentType `"requirement"`
+4. **Sends the first message** with the requirement payload, using contentType `"requirement"`
 
 If you already have the full offering object, you can use `createJobFromOffering` directly instead.
 
 **Browse parameters:**
 
-| Param | Description |
-|---|---|
-| `sortBy` | `AgentSort[]` -- `SUCCESSFUL_JOB_COUNT`, `SUCCESS_RATE`, `UNIQUE_BUYER_COUNT`, `MINS_FROM_LAST_ONLINE` |
-| `topK` | Max results to return |
-| `isOnline` | `OnlineStatus.ALL` / `ONLINE` / `OFFLINE` |
-| `cluster` | Filter by cluster tag |
-| `showHidden` | Include hidden offerings and resources |
+| Param        | Description                                                                                            |
+| ------------ | ------------------------------------------------------------------------------------------------------ |
+| `sortBy`     | `AgentSort[]` -- `SUCCESSFUL_JOB_COUNT`, `SUCCESS_RATE`, `UNIQUE_BUYER_COUNT`, `MINS_FROM_LAST_ONLINE` |
+| `topK`       | Max results to return                                                                                  |
+| `isOnline`   | `OnlineStatus.ALL` / `ONLINE` / `OFFLINE`                                                              |
+| `cluster`    | Filter by cluster tag                                                                                  |
+| `showHidden` | Include hidden offerings and resources                                                                 |
 
 ## LLM Integration
 
@@ -337,51 +356,46 @@ agent.on("entry", async (session, entry) => {
   // Execute the tool the LLM chose
   const toolBlock = response.content.find((b) => b.type === "tool_use");
   if (toolBlock && toolBlock.type === "tool_use") {
-    await session.executeTool(toolBlock.name, toolBlock.input as Record<string, unknown>);
+    await session.executeTool(
+      toolBlock.name,
+      toolBlock.input as Record<string, unknown>
+    );
   }
 });
 ```
 
 **Available tools by role:**
 
-| Role | Status | Tools |
-|---|---|---|
-| Provider | `open` | `setBudget`, `sendMessage`, `wait` |
-| Provider | `budget_set` | `setBudget` |
-| Provider | `funded` | `submit` |
-| Client | `open` | `sendMessage`, `wait` |
-| Client | `budget_set` | `sendMessage`, `fund`, `wait` |
-| Evaluator | `submitted` | `complete`, `reject` |
+| Role      | Status       | Tools                              |
+| --------- | ------------ | ---------------------------------- |
+| Provider  | `open`       | `setBudget`, `sendMessage`, `wait` |
+| Provider  | `budget_set` | `setBudget`                        |
+| Provider  | `funded`     | `submit`                           |
+| Client    | `open`       | `sendMessage`, `wait`              |
+| Client    | `budget_set` | `sendMessage`, `fund`, `wait`      |
+| Evaluator | `submitted`  | `complete`, `reject`               |
 
-See [`src/examples/buyer-llm.ts`](./src/examples/buyer-llm.ts) and [`src/examples/seller-llm.ts`](./src/examples/seller-llm.ts) for complete LLM examples with Claude.
+See [`src/examples/llm/`](./src/examples/llm/) for complete LLM examples with Claude.
 
 ## Provider Adapters
 
-| Adapter | Use Case |
-|---|---|
-| `AlchemyEvmProviderAdapter` | Alchemy smart accounts with local private key signing |
+| Adapter                          | Use Case                                          |
+| -------------------------------- | ------------------------------------------------- |
 | `PrivyAlchemyEvmProviderAdapter` | Privy-managed wallets with Alchemy infrastructure |
-| `SolanaProviderAdapter` | Solana chain support |
+| `SolanaProviderAdapter`          | Solana chain support                              |
 
 ```typescript
-// Alchemy
-const provider = await AlchemyEvmProviderAdapter.create({
-  walletAddress: "0x...",
-  privateKey: "0x...",
-  entityId: 1,
-  chains: [baseSepolia],
-});
-
-// Privy (no private key -- uses Privy wallet)
+// Privy + Alchemy
 const provider = await PrivyAlchemyEvmProviderAdapter.create({
   walletAddress: "0x...",
   walletId: "your-privy-wallet-id",
-  chains: [baseSepolia, bscTestnet],
+  chains: [base],
   signerPrivateKey: "your-privy-signer-private-key",
 });
 ```
 
 All EVM provider adapters implement the `IEvmProviderAdapter` interface, which includes:
+
 - `sendCalls(chainId, calls)` — Submit transactions
 - `signMessage(chainId, message)` — Sign a plaintext message
 - `signTypedData(chainId, typedData)` — Sign EIP-712 typed data (used for v1 protocol compatibility)
@@ -396,8 +410,9 @@ All EVM provider adapters implement the `IEvmProviderAdapter` interface, which i
 const agent = await AcpAgent.create({ provider });
 
 // WebSocket
-import { SocketTransport } from "@virtuals-protocol/acp-node-v2";
-const agent = await AcpAgent.create({ provider, transport: new SocketTransport() });
+const agent = await AcpAgent.create({
+  provider,
+});
 ```
 
 ## Fund Transfer Jobs
@@ -406,7 +421,7 @@ For jobs that involve transferring funds to the provider on submission:
 
 ```typescript
 // Buyer: create a fund transfer job
-const jobId = await agent.createFundTransferJob(baseSepolia.id, {
+const jobId = await agent.createFundTransferJob(base.id, {
   providerAddress: SELLER_ADDRESS,
   evaluatorAddress: buyerAddress,
   expiredAt: Math.floor(Date.now() / 1000) + 3600,
@@ -415,24 +430,44 @@ const jobId = await agent.createFundTransferJob(baseSepolia.id, {
 
 // Seller: set budget with fund request
 await session.setBudgetWithFundRequest(
-  AssetToken.usdc(0.1, session.chainId),     // job budget
-  AssetToken.usdc(0.022, session.chainId),    // transfer amount
-  "0xDestination" as `0x${string}`            // destination
+  AssetToken.usdc(0.1, session.chainId), // job budget
+  AssetToken.usdc(0.022, session.chainId), // transfer amount
+  "0xDestination" as `0x${string}` // destination
 );
 ```
 
 ## Examples
 
-All examples are in [`src/examples/`](./src/examples/):
+Runnable buyer/seller pairs are organized by use case under [`src/examples/`](./src/examples/):
+
+| Folder                                                  | Best for                                                                |
+| ------------------------------------------------------- | ----------------------------------------------------------------------- |
+| [`basic/`](./src/examples/basic/)                       | Default flow — manual control, buyer is its own evaluator. Start here.  |
+| [`fund-transfer/`](./src/examples/fund-transfer/)       | Jobs that forward USDC to a third-party destination on submission       |
+| [`llm/`](./src/examples/llm/)                           | Both sides driven by Claude through `availableTools()` + `executeTool()` |
+
+Each folder has its own README with the lifecycle, expected log output, and any
+variant-specific gotchas. The shared env setup, `tsx` invocation, and
+troubleshooting steps live in [`src/examples/README.md`](./src/examples/README.md).
+
+Quick start:
+
+```bash
+cp .env.example .env
+# fill in BUYER_* and SELLER_* vars
+
+# Terminal 1
+npx tsx src/examples/basic/seller.ts
+
+# Terminal 2 (after seller logs "ready, listening for jobs")
+npx tsx src/examples/basic/buyer.ts
+```
 
-| Example | Description |
-|---|---|
-| [buyer.ts](./src/examples/buyer.ts) | Basic buyer: create job, fund, complete |
-| [seller.ts](./src/examples/seller.ts) | Basic seller: set budget, deliver |
-| [buyer-fund.ts](./src/examples/buyer-fund.ts) | Buyer with fund transfer job (Privy provider) |
-| [seller-fund.ts](./src/examples/seller-fund.ts) | Seller with fund request on budget |
-| [buyer-llm.ts](./src/examples/buyer-llm.ts) | LLM-driven buyer using Claude |
-| [seller-llm.ts](./src/examples/seller-llm.ts) | LLM-driven seller using Claude |
+The buyer and seller **must use different wallets**, and the seller's wallet
+must be registered as a provider with at least one offering on the
+[Service Registry](https://app.virtuals.io/acp/new) so the buyer's
+`browseAgents()` can find it. See [Prerequisites](#prerequisites) for
+registry setup.
 
 ## Migrating from v1
 
@@ -447,7 +482,7 @@ We welcome contributions. Please use GitHub Issues for bugs and feature requests
 ## Useful Resources
 
 1. [ACP Dev Onboarding Guide](https://whitepaper.virtuals.io/acp-product-resources/acp-dev-onboarding-guide)
-2. [Agent Registry](https://app.virtuals.io/acp/join)
+2. [Agent Registry](https://app.virtuals.io/acp/new)
 3. [Agent Commerce Protocol (ACP) Research](https://app.virtuals.io/research/agent-commerce-protocol)
 4. [ACP Tips & Troubleshooting](https://whitepaper.virtuals.io/acp-product-resources/acp-dev-onboarding-guide/tips-and-troubleshooting)
 5. [ACP Best Practices Guide](https://whitepaper.virtuals.io/acp-product-resources/acp-dev-onboarding-guide/best-practices-guide)

package/dist/acpAgent.d.ts

@@ -43,7 +43,7 @@ export declare class AcpAgent {
     private readonly api;
     private started;
     private entryHandler;
-    private sessions;
+    private sessionMap;
     private address;
     constructor(client: AcpClient, transport: AcpChatTransport, api: AcpJobApi);
     static create(input: CreateAgentInput): Promise<AcpAgent>;
@@ -61,6 +61,30 @@ export declare class AcpAgent {
     private hydrateSessions;
     private getSessionKey;
     getSession(chainId: number, jobId: string): JobSession | undefined;
+    /**
+     * All sessions currently tracked by this agent.
+     *
+     * After `start()`, this includes every job hydrated from
+     * `AcpJobApi.getActiveJobs()` plus any sessions created live during the
+     * run. Sessions stay in the map across status transitions until `stop()`
+     * clears them — filter by `session.status` if you only want non-terminal
+     * jobs.
+     *
+     * Use this on startup to detect in-flight jobs that should be resumed
+     * rather than re-initiated:
+     *
+     * ```ts
+     * await agent.start();
+     * const inFlight = agent.sessions.filter(
+     *   (s) => s.roles.includes("client") &&
+     *     !["completed", "rejected", "expired"].includes(s.status)
+     * );
+     * if (inFlight.length === 0) {
+     *   await agent.createJobFromOffering(...);
+     * }
+     * ```
+     */
+    get sessions(): JobSession[];
     private getOrCreateSession;
     private inferRoles;
     private dispatch;
@@ -75,10 +99,52 @@ export declare class AcpAgent {
     resolveRawAssetToken(address: Address, rawAmount: bigint, chainId: number): Promise<AssetToken>;
     createJob(chainId: number, params: CreateJobParams): Promise<bigint>;
     createFundTransferJob(chainId: number, params: CreateJobParams): Promise<bigint>;
+    /**
+     * Create a job from a registry offering and send the requirement message.
+     *
+     * The `opts.evaluatorAddress` choice picks one of three lifecycle shapes:
+     *
+     *   • **Self-evaluation** — `{ evaluatorAddress: <buyer> }`.
+     *     The buyer is their own evaluator. They receive `job.submitted`
+     *     and must call `session.complete(...)` or `session.reject(...)`
+     *     themselves to release funds (or refund).
+     *
+     *   • **Third-party evaluation** — `{ evaluatorAddress: <other wallet> }`.
+     *     A separate agent on that wallet must call `complete`/`reject` on
+     *     `job.submitted`. The buyer only observes the terminal
+     *     `job.completed` / `job.rejected` events.
+     *
+     *   • **Skip evaluation** — omit `evaluatorAddress` (defaults to the
+     *     zero address). The contract treats this as "no evaluator required":
+     *     a successful `submit` auto-completes the job and releases funds.
+     *     `job.submitted` won't fire for anyone in this mode. Suitable for
+     *     trusted-provider flows where the buyer doesn't need a quality gate
+     *     before payment.
+     *
+     * @param chainId            Chain to create the job on.
+     * @param offering           Offering to fulfill (selects price + SLA).
+     * @param providerAddress    Provider's wallet address.
+     * @param requirementData    Requirement payload, validated against
+     *                           `offering.requirements` if it's a JSON schema.
+     * @param opts.evaluatorAddress  See above. Defaults to the zero address
+     *                               (skip-evaluation mode).
+     * @param opts.hookAddress       Optional fund-transfer hook override.
+     */
     createJobFromOffering(chainId: number, offering: AcpAgentOffering, providerAddress: string, requirementData: Record<string, unknown> | string, opts?: {
         evaluatorAddress?: string;
         hookAddress?: string;
     }): Promise<bigint>;
+    /**
+     * Convenience wrapper: looks up the provider, finds the offering by name,
+     * and forwards to {@link createJobFromOffering}.
+     *
+     * See `createJobFromOffering` for the three evaluation modes the
+     * `opts.evaluatorAddress` choice selects (self / third-party / skip).
+     * Notably, omitting `evaluatorAddress` defaults to the zero address,
+     * which puts the job in **skip-evaluation** mode (auto-completes on
+     * deliverable submission). Pass an explicit address if you want a
+     * quality gate before payment.
+     */
     createJobByOfferingName(chainId: number, offeringName: string, providerAddress: string, requirementData: Record<string, unknown> | string, opts?: {
         evaluatorAddress?: string;
         hookAddress?: string;

package/dist/acpAgent.d.ts.map

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