supafone-labs 0.4.0 → 0.4.1

package/README.md

@@ -297,6 +297,43 @@ const reports = await supafone.optimizer.reports("builder");
 All errors throw `SupafoneLabsError` (with `.status` and `.body`); catch it to
 inspect gateway responses.
 
+## Campaigns & real calls (account-scoped)
+
+The outbound campaign engine behind app.supafone.ai, packaged. Authenticate
+with your account (not an API key) — pass `accountToken`, or
+`accountEmail` + `accountPassword` and the client logs in lazily (and
+re-logs-in transparently when the token expires):
+
+```ts
+const sf = new Supafone({ accountEmail: "you@company.com", accountPassword: "..." });
+
+const { agents } = await sf.listVoiceAgents();
+const { campaign } = await sf.campaigns.create({ name: "Q3 win-back", goal: "reengage", agentId: agents[0].id });
+await sf.campaigns.applyPreset(campaign.id, "win_back");          // or your custom_… preset
+await sf.campaigns.addRecipients(campaign.id, [
+  { name: "Jane Doe", phone: "+15551234567", outreach_consent: "yes" },
+]);
+await sf.campaigns.launch(campaign.id);                            // real calls + emails begin
+
+const live = await sf.campaigns.live(campaign.id);                 // in-flight calls + listen links
+await sf.placeCall({ agentId: agents[0].id, toNumber: "+15551234567" }); // ring a phone right now
+```
+
+`campaigns.live()` returns a portal link (`app.supafone.ai/app/developer`) and
+a listen link per in-flight call; poll `campaigns.getCall(id)` to follow the
+live transcript while a call is in progress.
+
+## Prefer natural language? Use the MCP server
+
+The repo ships an MCP stdio server (`services/supafone-labs/mcp/supafone_mcp.py`)
+exposing this same surface — plus hosted-agent provisioning — as tools for
+Claude Desktop / Claude Code. Configure it with `SUPAFONE_EMAIL` +
+`SUPAFONE_PASSWORD` (campaigns/calls) and/or `SUPAFONE_API_KEY` (hosted
+agents), then just ask: *"create a win-back campaign, add these leads, launch
+it, and show me the calls as they happen"* — Claude replies with developer-
+portal links to watch the calls live. Full tool reference lives in the repo's
+`gitbook/mcp-server.md`.
+
 ## Module format
 
 Ships **both ESM and CommonJS**. `import { Supafone } from "supafone-labs"`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supafone-labs",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "The Supafone agent framework: create hosted voice/web/campaign agents with managed numbers, stages, tools, artifacts, and Supafone Pro watcher built in.",
   "type": "module",
   "main": "./dist/cjs/index.js",