apinow-sdk 0.15.1 → 0.16.0

package/README.md

@@ -42,9 +42,30 @@ Returns:
 | `call(endpoint, opts?)` | Call any endpoint with automatic x402 payment |
 | `search(query, limit?)` | Semantic search across all endpoints |
 | `info(ns, name)` | Get endpoint details (free) |
+| `listWorkflows(opts?)` | List workflows (free) |
+| `getWorkflow(id)` | Get workflow details (free) |
+| `runWorkflow(id, input)` | Run a workflow with automatic x402 payment |
 | `wallet` | Your wallet address |
 | `fetch` | Raw x402-wrapped `fetch` for advanced use |
 
+### Workflows
+
+Workflows chain multiple x402 endpoints into a single paid DAG pipeline with automatic payment splitting.
+
+```typescript
+// list workflows
+const { workflows } = await apinow.listWorkflows({ status: 'active', limit: 10 });
+
+// get workflow details (nodes, splits, pricing)
+const workflow = await apinow.getWorkflow('90931d9c8fb94df9');
+console.log(workflow.name, workflow.totalPrice, workflow.graph.nodes);
+
+// run a workflow — x402 payment covers all nodes + creator split
+const result = await apinow.runWorkflow('90931d9c8fb94df9', {
+  query: 'birthday gift ideas for a friend who loves cooking',
+});
+```
+
 ## CLI
 
 ```bash
@@ -87,6 +108,31 @@ npx apinow call ns/endpoint -m GET -k 0xYOUR_KEY
 | `-m, --method <method>` | HTTP method (default: from endpoint) |
 | `-k, --key <privateKey>` | Wallet key (or set `APINOW_WALLET_PKEY`) |
 
+### `workflows` — list workflows
+
+```bash
+npx apinow workflows
+npx apinow workflows --status active --limit 10
+npx apinow workflows --creator 0x32e8...E934
+```
+
+### `workflow` — workflow details
+
+```bash
+npx apinow workflow 90931d9c8fb94df9
+```
+
+### `run-workflow` — run a workflow (paid)
+
+```bash
+APINOW_WALLET_PKEY=0x... npx apinow run-workflow 90931d9c8fb94df9 -d '{"query":"birthday gift ideas"}'
+```
+
+| Flag | Description |
+|------|-------------|
+| `-d, --data <json>` | JSON input (default: `{"query":"hello world"}`) |
+| `-k, --key <privateKey>` | Wallet key (or set `APINOW_WALLET_PKEY`) |
+
 ## Requirements
 
 - Node.js v18+

package/dist/cli.js

@@ -6,7 +6,7 @@ const program = new Command();
 program
     .name('apinow')
     .description('CLI for APINow.fun — search, inspect, and call pay-per-request APIs')
-    .version('0.15.0');
+    .version('0.16.0');
 // ─── Helpers ───
 function getPrivateKey(opts) {
     const raw = opts.key || process.env.APINOW_WALLET_PKEY || process.env.PRIVATE_KEY;
@@ -216,4 +216,100 @@ program
         process.exit(1);
     }
 });
+// ─── workflows ───
+program
+    .command('workflows')
+    .description('List workflows')
+    .option('-l, --limit <n>', 'Max results', '20')
+    .option('-c, --creator <address>', 'Filter by creator wallet')
+    .option('-s, --status <status>', 'Filter by status: active | draft | all', 'all')
+    .action(async (opts) => {
+    try {
+        const params = new URLSearchParams({ limit: opts.limit, status: opts.status });
+        if (opts.creator)
+            params.set('creator', opts.creator);
+        const data = await fetchJson(`${API_BASE}/api/workflows?${params}`);
+        const workflows = data.workflows || [];
+        if (!workflows.length) {
+            console.log('No workflows found.');
+            return;
+        }
+        const rows = [['ID', 'NAME', 'STATUS', 'NODES', 'COST', 'DESCRIPTION']];
+        for (const w of workflows) {
+            rows.push([
+                w.workflowId,
+                truncate(w.name || '', 24),
+                w.status,
+                String(w.graph?.nodes?.length || 0),
+                `$${w.totalPrice}`,
+                truncate(w.description || '', 40),
+            ]);
+        }
+        printTable(rows);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+// ─── workflow info ───
+program
+    .command('workflow <id>')
+    .description('Get workflow details')
+    .action(async (id) => {
+    try {
+        const data = await fetchJson(`${API_BASE}/api/workflows/${id}`);
+        console.log(`\n  ${data.name}`);
+        console.log(`  ${'─'.repeat(40)}`);
+        console.log(`  ${data.description || '(no description)'}\n`);
+        console.log(`  ID:      ${data.workflowId}`);
+        console.log(`  Status:  ${data.status}`);
+        console.log(`  Cost:    $${data.totalPrice} USDC`);
+        console.log(`  Chain:   ${data.chain || 'base'}`);
+        console.log(`  Creator: ${data.creatorWallet}`);
+        console.log(`  Nodes:   ${data.graph?.nodes?.length || 0}`);
+        if (data.graph?.nodes?.length) {
+            console.log(`\n  Pipeline:`);
+            for (const node of data.graph.nodes) {
+                const deps = node.dependsOn?.length ? ` (depends on: ${node.dependsOn.join(', ')})` : '';
+                const isOutput = node.id === data.graph.outputNode ? ' [output]' : '';
+                console.log(`    → ${node.id}: ${node.endpoint}${deps}${isOutput}`);
+            }
+        }
+        if (data.splits?.length) {
+            console.log(`\n  Payment Split:`);
+            for (const s of data.splits) {
+                const pct = (s.basisPoints / 100).toFixed(1);
+                const usd = (parseFloat(data.totalPrice) * s.basisPoints / 10000).toFixed(4);
+                console.log(`    ${s.label}: ${pct}% ($${usd})`);
+            }
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+// ─── run workflow ───
+program
+    .command('run-workflow <id>')
+    .description('Run a workflow (x402 paid)')
+    .option('-d, --data <json>', 'JSON input', '{"query":"hello world"}')
+    .option('-k, --key <privateKey>', 'Wallet private key')
+    .action(async (id, opts) => {
+    try {
+        const privateKey = getPrivateKey(opts);
+        const body = JSON.parse(opts.data);
+        const details = await fetchJson(`${API_BASE}/api/workflows/${id}`);
+        console.error(`Running workflow "${details.name}" — cost: $${details.totalPrice} USDC`);
+        const apinow = createClient({ privateKey });
+        const result = await apinow.runWorkflow(id, body);
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/index.d.ts

@@ -27,6 +27,25 @@ export declare function createClient(config: ApinowConfig): {
      * Get public endpoint info (free, no payment).
      */
     info(namespace: string, endpointName: string): Promise<any>;
+    /**
+     * List workflows. Optionally filter by creator or status.
+     */
+    listWorkflows(opts?: {
+        creator?: string;
+        status?: string;
+        limit?: number;
+    }): Promise<any>;
+    /**
+     * Get workflow details by ID.
+     */
+    getWorkflow(workflowId: string): Promise<any>;
+    /**
+     * Run a workflow. Handles x402 payment automatically.
+     *
+     * @example
+     * const result = await apinow.runWorkflow('90931d9c8fb94df9', { query: 'hello world' });
+     */
+    runWorkflow(workflowId: string, input: Record<string, any>): Promise<any>;
     /**
      * The underlying x402-wrapped fetch, for advanced use.
      */

package/dist/index.js

@@ -58,6 +58,44 @@ export function createClient(config) {
                 throw new Error(`Failed to fetch info: ${res.status}`);
             return res.json();
         },
+        // ─── Workflows ───
+        /**
+         * List workflows. Optionally filter by creator or status.
+         */
+        async listWorkflows(opts = {}) {
+            const params = new URLSearchParams();
+            if (opts.limit)
+                params.set('limit', String(opts.limit));
+            if (opts.creator)
+                params.set('creator', opts.creator);
+            if (opts.status)
+                params.set('status', opts.status);
+            const res = await fetch(`${baseUrl}/api/workflows?${params}`);
+            if (!res.ok)
+                throw new Error(`Failed to list workflows: ${res.status}`);
+            return res.json();
+        },
+        /**
+         * Get workflow details by ID.
+         */
+        async getWorkflow(workflowId) {
+            const res = await fetch(`${baseUrl}/api/workflows/${workflowId}`);
+            if (!res.ok)
+                throw new Error(`Failed to get workflow: ${res.status}`);
+            return res.json();
+        },
+        /**
+         * Run a workflow. Handles x402 payment automatically.
+         *
+         * @example
+         * const result = await apinow.runWorkflow('90931d9c8fb94df9', { query: 'hello world' });
+         */
+        async runWorkflow(workflowId, input) {
+            return this.call(`/api/workflows/${workflowId}/run`, {
+                method: 'POST',
+                body: input,
+            });
+        },
         /**
          * The underlying x402-wrapped fetch, for advanced use.
          */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "apinow-sdk",
-  "version": "0.15.1",
-  "description": "Pay-per-call API SDK & CLI for APINow.fun — wraps x402 so you don't have to",
+  "version": "0.16.0",
+  "description": "Pay-per-call API SDK & CLI for APINow.fun — endpoints + workflows, wraps x402 so you don't have to",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -24,7 +24,9 @@
     "web3",
     "ai",
     "llm",
-    "cli"
+    "cli",
+    "workflow",
+    "dag"
   ],
   "author": "ApiNow.fun",
   "license": "MIT",