@obolos_tech/cli 0.3.3 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # Obolos CLI
 
-**Search, browse, and call x402 APIs from the terminal.**
+**Search, browse, and call x402 APIs from the terminal. Manage ACP jobs and ANP negotiations — including signed in-job messaging — without leaving your shell.**
 
 ```bash
 npx @obolos/cli search "token price"
@@ -10,6 +10,8 @@ npx @obolos/cli call ext-abc123 --body '{"symbol":"ETH"}'
 
 ## Commands
 
+### Marketplace
+
 | Command | Description |
 |---------|-------------|
 | `obolos search [query]` | Search APIs by keyword |
@@ -19,6 +21,38 @@ npx @obolos/cli call ext-abc123 --body '{"symbol":"ETH"}'
 | `obolos balance` | Check wallet USDC balance |
 | `obolos setup-mcp` | Show MCP server setup instructions |
 
+### Jobs (ACP)
+
+| Command | Description |
+|---------|-------------|
+| `obolos job create` | Create a new ACP job with title, description, and budget |
+| `obolos job list` | List jobs (filter by status: open, funded, submitted, completed) |
+| `obolos job info <id>` | Get full job details and current state |
+
+### ANP Negotiation
+
+| Command | Description |
+|---------|-------------|
+| `obolos anp list` | List ANP listings (filter by status) |
+| `obolos anp bid <listing_id>` | Submit a signed bid on a listing |
+| `obolos anp accept <bid_id>` | Accept a bid (creates signed acceptance document) |
+| `obolos anp settle <acceptance_id>` | Settle an accepted negotiation on-chain |
+
+### ANP In-Job Messaging (IML)
+
+Once a job is funded, IML commands let both parties communicate, amend scope, and track milestones — all with EIP-712 signatures and content-addressed storage. No message can be repudiated.
+
+| Command | Description |
+|---------|-------------|
+| `obolos anp message <job_id>` | Send a signed in-job message |
+| `obolos anp thread <job_id>` | View the full job thread (messages, amendments, checkpoints) |
+| `obolos anp amend <job_id>` | Propose a scope or price amendment |
+| `obolos anp accept-amend <job_id>` | Accept a pending amendment |
+| `obolos anp checkpoint <job_id>` | Submit a milestone checkpoint for review |
+| `obolos anp approve-cp <job_id>` | Approve a submitted checkpoint |
+| `obolos anp amendments <job_id>` | List all amendments on a job |
+| `obolos anp checkpoints <job_id>` | List all checkpoints on a job |
+
 ## Environment Variables
 
 | Variable | Required | Description |

package/dist/commands/anp.d.ts

@@ -0,0 +1,277 @@
+/**
+ * ANP commands (Agent Negotiation Protocol): list, info, create, bid, accept, verify.
+ * Advanced primitives (message/thread/amend/checkpoint) remain on the legacy
+ * path until this group stabilizes.
+ */
+import type { Command } from '../registry.js';
+export declare const anpListCmd: Command<{
+    status: {
+        type: "string";
+        description: string;
+        enum: string[];
+    };
+    limit: {
+        type: "number";
+        description: string;
+        default: number;
+    };
+}, {
+    listings: any;
+    total: any;
+}>;
+export declare const anpInfoCmd: Command<{
+    cid: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+}, any>;
+export declare const anpCreateCmd: Command<{
+    title: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+    description: {
+        type: "string";
+        description: string;
+    };
+    'min-budget': {
+        type: "number";
+        description: string;
+        default: number;
+    };
+    'max-budget': {
+        type: "number";
+        description: string;
+        default: number;
+    };
+    deadline: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    duration: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    evaluator: {
+        type: "string";
+        description: string;
+    };
+}, {
+    cid: any;
+    signer: any;
+    signature: any;
+}>;
+export declare const anpBidCmd: Command<{
+    cid: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+    price: {
+        type: "number";
+        description: string;
+        required: true;
+    };
+    delivery: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    message: {
+        type: "string";
+        description: string;
+    };
+}, {
+    cid: any;
+    listingCid: string;
+    price: number;
+    signer: any;
+    signature: any;
+}>;
+export declare const anpAcceptCmd: Command<{
+    cid: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+    bid: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+}, {
+    cid: any;
+    listingCid: string;
+    bidCid: string;
+    signer: any;
+    signature: any;
+}>;
+export declare const anpVerifyCmd: Command<{
+    cid: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+}, any>;
+export declare const anpMessageCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+    message: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+    role: {
+        type: "string";
+        description: string;
+        enum: string[];
+        default: string;
+    };
+}, {
+    cid: any;
+    jobId: string;
+    role: string;
+    signer: any;
+}>;
+export declare const anpThreadCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+}, {
+    jobId: string;
+    messages: any;
+}>;
+export declare const anpAmendCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+    'bid-hash': {
+        type: "string";
+        description: string;
+        required: true;
+    };
+    reason: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+    price: {
+        type: "number";
+        description: string;
+    };
+    delivery: {
+        type: "string";
+        description: string;
+    };
+    'scope-delta': {
+        type: "string";
+        description: string;
+    };
+}, {
+    cid: any;
+    jobId: string;
+    price: number;
+    delivery: string;
+    reason: string;
+}>;
+export declare const anpAcceptAmendCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+    amendment: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+}, {
+    cid: any;
+    jobId: string;
+    amendmentCid: string;
+}>;
+export declare const anpAmendmentsCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+}, {
+    jobId: string;
+    amendments: any;
+}>;
+export declare const anpCheckpointCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+    deliverable: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+    milestone: {
+        type: "number";
+        description: string;
+        default: number;
+    };
+    notes: {
+        type: "string";
+        description: string;
+    };
+}, {
+    cid: any;
+    jobId: string;
+    milestone: number;
+}>;
+export declare const anpApproveCpCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+    checkpoint: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+}, {
+    cid: any;
+    jobId: string;
+    checkpointCid: string;
+}>;
+export declare const anpCheckpointsCmd: Command<{
+    job: {
+        type: "string";
+        description: string;
+        positional: number;
+        required: true;
+    };
+}, {
+    jobId: string;
+    checkpoints: any;
+}>;
+export declare const anpCommands: Command[];