agent402-client 0.1.0 → 0.2.1

package/README.md

@@ -47,12 +47,30 @@ const a = new Agent402({ fetch: payFetch });
 const article = await a.call("extract", { url: "https://example.com/article" });
 ```
 
+## Workflows (skill packs)
+
+For jobs that no single tool covers — e.g. "audit a domain", "build a stock
+brief" — Agent402 ships curated multi-tool **skill packs**: 5–7 catalog tools
+composed into a Claude-ready task template. Discover them the same way you'd
+discover a tool:
+
+```js
+const packs = await a.findWorkflows("security audit");
+// → [{ slug: "security-audit", title, tagline, toolSlugs, score, url, promptName }]
+
+// Render the full prompt with arguments substituted in (same output as MCP prompts/get).
+const { messages } = await a.getWorkflowPrompt("security-audit", { domain: "stripe.com" });
+// → feed messages straight to any LLM
+```
+
 ## API
 
 | Method | What |
 |---|---|
 | `new Agent402({ baseUrl?, fetch?, cache?, fetchImpl? })` | `fetch` is your x402-wrapped fetch for paid tools (optional); `cache` (default `true`) memoizes deterministic results |
 | `await a.find(task, { k = 5 })` | Resolve a plain-language task to the best-matching tools (route, price, schema, example) |
+| `await a.findWorkflows(task, { k = 2 })` | Resolve a task to matching multi-tool workflow templates (skill packs) |
+| `await a.getWorkflowPrompt(slug, args)` | Fetch the rendered prompt messages for a skill pack with arguments substituted in |
 | `await a.call(slug, params, { idempotencyKey?, cache? })` | Call a tool; auto-pays (PoW for free tools, x402 for wallet-only); returns the JSON result |
 | `Agent402.solvePow(pow)` | Solve a proof-of-work challenge object → an `X-Pow-Solution` value |
 | `a.clearCache()` | Drop the in-memory result cache |

package/index.js

@@ -51,6 +51,32 @@ export class Agent402 {
     return (await r.json()).results || [];
   }
 
+  /**
+   * Resolve a task to matching multi-tool workflow templates (skill packs).
+   * Each pack composes 5–7 catalog tools into a Claude-ready task template
+   * for jobs that no single tool covers (e.g. audit a domain). Returns
+   * `[{slug, title, tagline, toolSlugs, score, url, promptName}]` (possibly
+   * empty when the lexical signal is weak). Use `getWorkflowPrompt(slug, args)`
+   * to fetch the rendered prompt messages, or hand the slug to an MCP client.
+   */
+  async findWorkflows(task, { k = 2 } = {}) {
+    const r = await this.f(`${this.baseUrl}/api/find?q=${encodeURIComponent(task)}&k=${k}`);
+    if (!r.ok) throw new Error(`findWorkflows failed: HTTP ${r.status}`);
+    return (await r.json()).packs || [];
+  }
+
+  /**
+   * Fetch the rendered prompt messages for a skill pack with arguments
+   * substituted in. Same output as MCP `prompts/get` — usable directly with
+   * any LLM. `args` are passed by promptArg name (see /api/skill-packs.json).
+   */
+  async getWorkflowPrompt(slug, args = {}) {
+    const qs = new URLSearchParams(Object.entries(args).map(([k, v]) => [k, String(v)])).toString();
+    const r = await this.f(`${this.baseUrl}/api/skill-packs/${encodeURIComponent(slug)}/prompt${qs ? `?${qs}` : ""}`);
+    if (!r.ok) throw new Error(`getWorkflowPrompt("${slug}") failed: HTTP ${r.status}`);
+    return r.json();
+  }
+
   /** Solve a proof-of-work challenge object (from a 402 body) into an X-Pow-Solution value. */
   static solvePow(pow) {
     let n = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-client",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Tiny buyer-side client for Agent402 (x402): resolve a task to a tool and call it with payment handled for you — free tools settle via built-in proof-of-work (no wallet), wallet-only tools via your x402 fetch. Caching + idempotent retries.",
   "type": "module",
   "main": "index.js",