poke 0.1.2 → 0.2.0

package/README.md

@@ -1,6 +1,8 @@
 # poke
 
-CLI for [Poke](https://poke.com) — manage authentication and MCP server connections.
+The official [Poke](https://poke.com) developer toolkit — a CLI and Node.js SDK for managing authentication, MCP server connections, and programmatic access to your Poke agent.
+
+Built by [Interaction Company](https://poke.com) in California.
 
 ## Installation
 
@@ -10,7 +12,107 @@ npm install -g poke
 
 Requires Node.js >= 18.
 
-## Commands
+## SDK
+
+Use the SDK to interact with your Poke agent programmatically.
+
+```bash
+npm install poke
+```
+
+### Quick start
+
+```typescript
+import { Poke } from "poke";
+
+const poke = new Poke({ apiKey: "pk_..." });
+
+// Send a message to your agent
+await poke.sendMessage("Summarize my unread emails");
+
+// Create a webhook trigger
+const webhook = await poke.createWebhook({
+  condition: "When a deploy fails",
+  action: "Send me a summary of the error",
+});
+
+// Fire the webhook with data
+await poke.sendWebhook({
+  webhookUrl: webhook.webhookUrl,
+  webhookToken: webhook.webhookToken,
+  data: { event: "deploy_failed", repo: "my-app", error: "OOM killed" },
+});
+```
+
+### Authentication
+
+The SDK resolves credentials in this order:
+
+1. `apiKey` passed to the constructor
+2. `POKE_API_KEY` environment variable
+3. Credentials from `poke login` (`~/.config/poke/credentials.json`)
+
+```typescript
+// Option 1: Pass directly
+const poke = new Poke({ apiKey: "pk_..." });
+
+// Option 2: Set POKE_API_KEY in your environment
+const poke = new Poke();
+
+// Option 3: Run `poke login` first, then
+const poke = new Poke();
+```
+
+Get your API key at [poke.com/kitchen/api-keys](https://poke.com/kitchen/api-keys).
+
+### Methods
+
+#### `poke.sendMessage(text)`
+
+Send a text message to your Poke agent.
+
+```typescript
+const response = await poke.sendMessage("What meetings do I have today?");
+// { success: true, message: "..." }
+```
+
+#### `poke.createWebhook({ condition, action })`
+
+Create a webhook trigger. Returns a `webhookUrl` and `webhookToken` that you use with `sendWebhook`.
+
+```typescript
+const webhook = await poke.createWebhook({
+  condition: "When a new user signs up",
+  action: "Send me a welcome summary in Slack",
+});
+// {
+//   triggerId: "...",
+//   webhookUrl: "https://poke.com/api/v1/inbound/webhook",
+//   webhookToken: "eyJhbG..."
+// }
+```
+
+#### `poke.sendWebhook({ webhookUrl, webhookToken, data })`
+
+Fire a webhook trigger with data. Use the `webhookUrl` and `webhookToken` returned by `createWebhook`.
+
+```typescript
+await poke.sendWebhook({
+  webhookUrl: webhook.webhookUrl,
+  webhookToken: webhook.webhookToken,
+  data: { event: "new_signup", email: "user@example.com", plan: "pro" },
+});
+// { success: true }
+```
+
+### Configuration
+
+| Option | Environment Variable | Default |
+|--------|---------------------|---------|
+| `apiKey` | `POKE_API_KEY` | — |
+| `baseUrl` | `POKE_API` | `https://poke.com/api/v1` |
+
+## CLI
 
 ### `poke login`
 
@@ -61,14 +163,33 @@ poke tunnel http://localhost:3000/mcp --name "Local Dev"
 | Option | Description |
 |--------|-------------|
 | `-n, --name <name>` | Display name for the connection (required) |
+| `--share` | Create a shareable recipe with QR code |
 
 The tunnel stays active until you press Ctrl+C. Tools are synced automatically every 5 minutes.
 
+### `poke wrap`
+
+Analyze your project with AI and generate an MCP server that exposes its capabilities, then tunnel it to Poke.
+
+```bash
+poke wrap
+poke wrap --name "My Project" --share
+```
+
+| Option | Description |
+|--------|-------------|
+| `--port <port>` | Port for the generated MCP server (default: `8765`) |
+| `-n, --name <name>` | Display name for the connection |
+| `--share` | Create a shareable recipe with QR code |
+
+Requires [uv](https://docs.astral.sh/uv/) to be installed.
+
 ## Configuration
 
 Credentials are stored in `~/.config/poke/credentials.json` (respects `$XDG_CONFIG_HOME`).
 
 | Environment Variable | Description | Default |
 |---------------------|-------------|---------|
+| `POKE_API_KEY` | API key for SDK usage | &mdash; |
 | `POKE_API` | API base URL | `https://poke.com/api/v1` |
-| `POKE_FRONTEND` | Frontend URL | `https://poke.com` |
+| `POKE_FRONTEND` | Frontend URL | `https://poke.com` |

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var u=Object.create;var a=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var w=Object.getPrototypeOf,P=Object.prototype.hasOwnProperty;var f=(s,e)=>{for(var o in e)a(s,o,{get:e[o],enumerable:!0})},d=(s,e,o,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of m(e))!P.call(s,r)&&r!==o&&a(s,r,{get:()=>e[r],enumerable:!(t=b(e,r))||t.enumerable});return s};var h=(s,e,o)=>(o=s!=null?u(w(s)):{},d(e||!s||!s.__esModule?a(o,"default",{value:s,enumerable:!0}):o,s)),l=s=>d(a({},"__esModule",{value:!0}),s);var S={};f(S,{Poke:()=>c});module.exports=l(S);var y=h(require("fs"),1),g=h(require("os"),1),p=h(require("path"),1);function O(){try{let s=process.env.XDG_CONFIG_HOME?p.default.join(process.env.XDG_CONFIG_HOME,"poke"):p.default.join(g.default.homedir(),".config","poke"),e=y.default.readFileSync(p.default.join(s,"credentials.json"),"utf-8");return JSON.parse(e).token??void 0}catch{return}}var c=class{apiKey;baseUrl;constructor(e){let o=e?.apiKey??process.env.POKE_API_KEY??O();if(!o)throw new Error(["Missing API key. Find yours at https://poke.com/kitchen/api-keys","","Provide it in one of three ways:",'  1. new Poke({ apiKey: "pk_..." })',"  2. Set the POKE_API_KEY environment variable","  3. Run `poke login` in your terminal"].join(`
+`));this.apiKey=o,this.baseUrl=e?.baseUrl??process.env.POKE_API??"https://poke.com/api/v1"}async request({path:e,body:o}){let t=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(o)});if(!t.ok){let r=await t.text(),i="";try{let n=JSON.parse(r);i=n.error??n.message??""}catch{}throw t.status===401?new Error("Poke: Invalid API key. Get a new one at https://poke.com/kitchen/api-keys"):t.status===403?new Error("Poke: API key doesn't have permission for this action. Check your key scopes at https://poke.com/kitchen/api-keys"):t.status===429?new Error("Poke: Rate limited. Please slow down and retry."):new Error(`Poke API error (${t.status}): ${i||t.statusText}`)}return t.json()}async sendMessage(e){return this.request({path:"/inbound/api-message",body:{message:e}})}async sendWebhook({webhookUrl:e,webhookToken:o,data:t}){let r=await fetch(e,{method:"POST",headers:{Authorization:`Bearer ${o}`,"Content-Type":"application/json"},body:JSON.stringify(t)});if(!r.ok){let i=await r.text(),n="";try{let k=JSON.parse(i);n=k.error??k.message??""}catch{}throw new Error(`Poke webhook error (${r.status}): ${n||r.statusText}`)}return r.json()}async createWebhook({condition:e,action:o}){return this.request({path:"/api-keys/webhook",body:{condition:e,action:o}})}};0&&(module.exports={Poke});

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { Poke, type PokeOptions, type SendMessageResponse, type SendWebhookResponse, type CreateWebhookResponse, } from "./sdk.js";

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import h from"fs";import k from"os";import i from"path";function d(){try{let p=process.env.XDG_CONFIG_HOME?i.join(process.env.XDG_CONFIG_HOME,"poke"):i.join(k.homedir(),".config","poke"),e=h.readFileSync(i.join(p,"credentials.json"),"utf-8");return JSON.parse(e).token??void 0}catch{return}}var a=class{apiKey;baseUrl;constructor(e){let s=e?.apiKey??process.env.POKE_API_KEY??d();if(!s)throw new Error(["Missing API key. Find yours at https://poke.com/kitchen/api-keys","","Provide it in one of three ways:",'  1. new Poke({ apiKey: "pk_..." })',"  2. Set the POKE_API_KEY environment variable","  3. Run `poke login` in your terminal"].join(`
+`));this.apiKey=s,this.baseUrl=e?.baseUrl??process.env.POKE_API??"https://poke.com/api/v1"}async request({path:e,body:s}){let o=await fetch(`${this.baseUrl}${e}`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(s)});if(!o.ok){let t=await o.text(),n="";try{let r=JSON.parse(t);n=r.error??r.message??""}catch{}throw o.status===401?new Error("Poke: Invalid API key. Get a new one at https://poke.com/kitchen/api-keys"):o.status===403?new Error("Poke: API key doesn't have permission for this action. Check your key scopes at https://poke.com/kitchen/api-keys"):o.status===429?new Error("Poke: Rate limited. Please slow down and retry."):new Error(`Poke API error (${o.status}): ${n||o.statusText}`)}return o.json()}async sendMessage(e){return this.request({path:"/inbound/api-message",body:{message:e}})}async sendWebhook({webhookUrl:e,webhookToken:s,data:o}){let t=await fetch(e,{method:"POST",headers:{Authorization:`Bearer ${s}`,"Content-Type":"application/json"},body:JSON.stringify(o)});if(!t.ok){let n=await t.text(),r="";try{let c=JSON.parse(n);r=c.error??c.message??""}catch{}throw new Error(`Poke webhook error (${t.status}): ${r||t.statusText}`)}return t.json()}async createWebhook({condition:e,action:s}){return this.request({path:"/api-keys/webhook",body:{condition:e,action:s}})}};export{a as Poke};

package/dist/sdk.d.ts

@@ -0,0 +1,32 @@
+export interface PokeOptions {
+    apiKey?: string;
+    baseUrl?: string;
+}
+export interface SendMessageResponse {
+    success: boolean;
+    message: string;
+}
+export interface SendWebhookResponse {
+    success: boolean;
+}
+export interface CreateWebhookResponse {
+    triggerId: string;
+    webhookUrl: string;
+    webhookToken: string;
+}
+export declare class Poke {
+    private apiKey;
+    private baseUrl;
+    constructor(options?: PokeOptions);
+    private request;
+    sendMessage(text: string): Promise<SendMessageResponse>;
+    sendWebhook({ webhookUrl, webhookToken, data, }: {
+        webhookUrl: string;
+        webhookToken: string;
+        data: Record<string, unknown>;
+    }): Promise<SendWebhookResponse>;
+    createWebhook({ condition, action, }: {
+        condition: string;
+        action: string;
+    }): Promise<CreateWebhookResponse>;
+}

package/package.json

@@ -1,8 +1,18 @@
 {
   "name": "poke",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "description": "Poke.com Developer SDK",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
   "bin": {
     "poke": "./dist/cli.cjs"
   },
@@ -10,7 +20,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc --noEmit && node esbuild.config.js",
+    "build": "tsc --noEmit && tsc --emitDeclarationOnly --outDir dist && node esbuild.config.js",
     "dev": "tsx src/cli.ts"
   },
   "dependencies": {