@wabery/cli 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wabery
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,199 @@
+# Wabery CLI and MCP Server
+
+Developer-facing CLI and MCP server for Wabery flows, automations, WhatsApp contacts, dispatches, and submissions.
+
+## Setup
+
+Install the CLI, then sign in through your browser:
+
+```sh
+npm i -g @wabery/cli
+wabery login
+```
+
+`wabery login` opens `app.wabery.com`, asks you to authorize the CLI, creates
+an API key for your current Wabery organization, and stores it in your local
+CLI config file. You can still override credentials explicitly:
+
+```sh
+export WABERY_API_KEY="wab_live_..."
+export WABERY_BASE_URL="https://app.wabery.com"
+```
+
+Do not pass real keys to `wabery mcp-config --api-key`; generated MCP snippets
+use a placeholder so credentials can live in your CLI config, shell, MCP client
+secret storage, or another local secret manager. Public API keys support scoped
+permissions. Use the smallest scope set the integration needs.
+
+For local repository development, build the workspace package:
+
+```sh
+pnpm --filter @wabery/cli build
+```
+
+Run diagnostics and MCP config from the installed CLI:
+
+```sh
+wabery login
+wabery doctor
+wabery mcp-config claude --raw
+wabery mcp-config codex --raw
+wabery mcp-config opencode --raw
+wabery mcp
+```
+
+MCP starts in read-only mode. To allow mutation tools for a trusted local
+session, set `WABERY_MCP_MODE=write` or generate config with `--write`.
+High-risk tools also require confirmation tokens:
+
+- `wabery_apply_config`: `confirmation_token: "apply_config"`
+- `wabery_publish_flow`: `confirmation_token: "publish:<flow_id>"`
+- `wabery_unenroll_contact` with `erase=true`: `confirmation_token: "erase:<contact_id>"`
+
+## Claude Code
+
+Add a Wabery MCP server to `.mcp.json`:
+
+```sh
+wabery mcp-config claude --raw
+```
+
+Installed CLI:
+
+```json
+{
+	"mcpServers": {
+		"wabery": {
+			"command": "wabery",
+			"args": ["mcp"],
+			"env": {
+				"WABERY_API_KEY": "wab_live_...",
+				"WABERY_BASE_URL": "https://app.wabery.com"
+			}
+		}
+	}
+}
+```
+
+## Codex
+
+Add a Wabery MCP server to Codex `config.toml`:
+
+```sh
+wabery mcp-config codex --raw
+```
+
+Installed CLI:
+
+```toml
+[mcp_servers.wabery]
+command = "wabery"
+args = ["mcp"]
+env = { WABERY_API_KEY = "wab_live_...", WABERY_BASE_URL = "https://app.wabery.com" }
+```
+
+## OpenCode
+
+Add a Wabery MCP server to OpenCode `opencode.json`:
+
+```sh
+wabery mcp-config opencode --raw
+```
+
+Installed CLI:
+
+```json
+{
+	"$schema": "https://opencode.ai/config.json",
+	"mcp": {
+		"wabery": {
+			"type": "local",
+			"command": ["wabery", "mcp"],
+			"enabled": true,
+			"environment": {
+				"WABERY_API_KEY": "wab_live_...",
+				"WABERY_BASE_URL": "https://app.wabery.com"
+			}
+		}
+	}
+}
+```
+
+## MCP Tools
+
+- `wabery_get_config_schema`
+- `wabery_get_config_example`
+- `wabery_check_connection`
+- `wabery_export_config`
+- `wabery_validate_config`
+- `wabery_preview_config_diff`
+- `wabery_apply_config`
+- `wabery_list_projects`
+- `wabery_create_project`
+- `wabery_list_channels`
+- `wabery_list_flows`
+- `wabery_get_flow`
+- `wabery_publish_flow`
+- `wabery_enroll_contact`
+- `wabery_list_contacts`
+- `wabery_get_contact`
+- `wabery_unenroll_contact`
+- `wabery_send_flow`
+- `wabery_list_submissions`
+- `wabery_list_dispatches`
+- `wabery_get_dispatch`
+
+## Typical Developer Workflow
+
+1. List or create a project:
+
+```sh
+wabery login
+wabery doctor
+wabery projects list
+wabery projects create --name "Demo project"
+```
+
+2. Enroll a WhatsApp phone number and capture the returned `contact_id` and `channel_id`:
+
+```sh
+wabery contacts enroll \
+	--project-id "proj_or_agent_id" \
+	--phone "+15555550123" \
+	--name "Jane Developer" \
+	--reference-id "user_123"
+wabery contacts get "contact_id"
+```
+
+3. Generate and validate `wabery.config.json`:
+
+```sh
+wabery config init wabery.config.json --project-id "proj_or_agent_id"
+wabery config validate wabery.config.json
+wabery config diff wabery.config.json
+wabery config apply wabery.config.json
+```
+
+4. Publish a flow explicitly after review:
+
+```sh
+wabery flows list
+wabery flows publish "flow_id"
+```
+
+5. Send a published flow:
+
+```sh
+wabery channels list
+wabery flows send "flow_id" --channel-id "channel_id" --contact-id "contact_id"
+```
+
+For sandbox projects, `wabery contacts enroll` returns the shared sandbox `channel_id` that is authorized for that phone number. Use that `channel_id` when sending a flow to the returned `contact_id`.
+
+To remove a phone's sandbox authorization:
+
+```sh
+wabery contacts unenroll "contact_id"
+```
+
+`wabery config apply` intentionally does not publish flows to Meta. Agents should call `wabery_publish_flow` only after explicit user confirmation and with the required confirmation token.

package/dist/api-client.d.ts

@@ -0,0 +1,22 @@
+export interface WaberyClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    apiVersion?: string;
+}
+export declare class WaberyApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export declare class WaberyApiClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly apiVersion?;
+    constructor(options?: WaberyClientOptions);
+    get(path: string, query?: Record<string, string | number | undefined>): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+    private request;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAe,SAAQ,KAAK;aAGvB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,OAAO;gBAF7B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO;CAI9B;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,OAAO,GAAE,mBAAwB;IAoBvC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAIrE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIhC,MAAM,CAAC,IAAI,EAAE,MAAM;YAIX,OAAO;CAuCrB"}

package/dist/api-client.js

@@ -0,0 +1,86 @@
+import { readLocalConfig } from "./local-config.js";
+export class WaberyApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+    }
+}
+export class WaberyApiClient {
+    apiKey;
+    baseUrl;
+    apiVersion;
+    constructor(options = {}) {
+        const localConfig = readLocalConfig();
+        const apiKey = options.apiKey ?? process.env.WABERY_API_KEY ?? localConfig.apiKey;
+        if (!apiKey) {
+            throw new Error("Missing WABERY_API_KEY. Run `wabery login`, or create an API key in Wabery and pass it as an environment variable.");
+        }
+        this.apiKey = apiKey;
+        this.baseUrl = normalizeBaseUrl(options.baseUrl ??
+            process.env.WABERY_BASE_URL ??
+            localConfig.baseUrl ??
+            "https://app.wabery.com");
+        this.apiVersion = options.apiVersion ?? process.env.WABERY_API_VERSION;
+    }
+    async get(path, query) {
+        return this.request("GET", path, undefined, query);
+    }
+    async post(path, body) {
+        return this.request("POST", path, body);
+    }
+    async put(path, body) {
+        return this.request("PUT", path, body);
+    }
+    async delete(path) {
+        return this.request("DELETE", path);
+    }
+    async request(method, path, body, query) {
+        const url = new URL(`${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`);
+        for (const [key, value] of Object.entries(query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        const headers = {
+            authorization: `Bearer ${this.apiKey}`,
+            accept: "application/json",
+        };
+        if (this.apiVersion)
+            headers["wabery-version"] = this.apiVersion;
+        if (body !== undefined)
+            headers["content-type"] = "application/json";
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        const responseBody = await readResponse(response);
+        if (!response.ok) {
+            const message = typeof responseBody === "object" &&
+                responseBody !== null &&
+                "message" in responseBody
+                ? String(responseBody.message)
+                : `Wabery API request failed with HTTP ${response.status}`;
+            throw new WaberyApiError(message, response.status, responseBody);
+        }
+        return responseBody;
+    }
+}
+function normalizeBaseUrl(value) {
+    const trimmed = value.replace(/\/+$/, "");
+    return trimmed.endsWith("/api/v1") ? trimmed : `${trimmed}/api/v1`;
+}
+async function readResponse(response) {
+    const text = await response.text();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}