flingit 0.0.18 → 0.0.20

package/dist/worker-runtime/plugin-common.js

@@ -0,0 +1,91 @@
+/**
+ * Shared helpers for plugin worker-runtime modules.
+ *
+ * Extracts the common plumbing (service binding fetch, identity tokens,
+ * HMAC signing, error parsing) so each plugin module only contains
+ * plugin-specific logic.
+ */
+import { __getEnv } from "./index.js";
+/**
+ * Create a pluginFetch function bound to a specific service binding name.
+ *
+ * @param bindingName - The env binding name (e.g., "DISCORD_PLUGIN")
+ */
+export function createPluginFetch(bindingName) {
+    return function pluginFetch(path, init) {
+        const env = __getEnv();
+        const binding = env[bindingName];
+        if (binding === null || binding === undefined || typeof binding["fetch"] !== "function") {
+            throw new Error(`${bindingName} service binding not available. ` +
+                "Re-deploy your project with 'fling push' to get the latest bindings.");
+        }
+        return binding.fetch(`https://plugin${path}`, init);
+    };
+}
+// ═══════════════════════════════════════════════════════
+// HMAC + IDENTITY TOKENS
+// ═══════════════════════════════════════════════════════
+export async function hmacSha256(secret, message) {
+    const encoder = new TextEncoder();
+    const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(message));
+    return Array.from(new Uint8Array(signature))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+export async function generateIdentityToken() {
+    const env = __getEnv();
+    const projectId = env["FLING_PROJECT_ID"];
+    const workerSecret = env["FLING_WORKER_SECRET"];
+    const projectIdStr = typeof projectId === "string" ? projectId :
+        typeof projectId === "number" ? String(projectId) : "";
+    const secretStr = typeof workerSecret === "string" ? workerSecret : "";
+    if (!secretStr) {
+        throw new Error("FLING_WORKER_SECRET not available. Re-deploy your project with 'fling push' to get the latest configuration.");
+    }
+    const timestamp = Date.now();
+    const payload = `${projectIdStr}.${timestamp}`;
+    const signature = await hmacSha256(secretStr, payload);
+    return `${payload}.${signature}`;
+}
+let cachedIdentityToken = null;
+const TOKEN_CACHE_TTL_MS = 30_000;
+export async function getProjectHeaders() {
+    const now = Date.now();
+    if (!cachedIdentityToken || cachedIdentityToken.expiresAt <= now) {
+        const token = await generateIdentityToken();
+        cachedIdentityToken = { token, expiresAt: now + TOKEN_CACHE_TTL_MS };
+    }
+    return {
+        "X-Fling-Identity": cachedIdentityToken.token,
+        "Content-Type": "application/json",
+    };
+}
+// ═══════════════════════════════════════════════════════
+// ERROR RESPONSE PARSING
+// ═══════════════════════════════════════════════════════
+/**
+ * Parse an error response and throw with a descriptive message.
+ * Handles both JSON and non-JSON error bodies gracefully.
+ */
+export async function throwResponseError(response, defaultMessage) {
+    const text = await response.text();
+    try {
+        const json = JSON.parse(text);
+        throw new Error(json.error ?? defaultMessage);
+    }
+    catch (e) {
+        if (e instanceof SyntaxError) {
+            throw new Error(`${defaultMessage} (HTTP ${response.status}): ${text}`);
+        }
+        throw e;
+    }
+}
+/**
+ * Reset the identity token cache. Exposed for testing only.
+ * @internal
+ */
+export function __resetTokenCache() {
+    cachedIdentityToken = null;
+}
+//# sourceMappingURL=plugin-common.js.map

package/dist/worker-runtime/plugin-common.js.map

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

package/dist/worker-runtime/slack.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Fling Worker Runtime - Slack Integration
+ *
+ * Worker-compatible Slack runtime for Cloudflare Workers deployment.
+ * This module provides Slack-specific exports for the worker environment.
+ *
+ * Used via the "flingit/plugin/slack" subpath export.
+ */
+export type { SlackEvent, SlackBlock, SlackMessage, SendMessageOptions, EditMessageOptions, } from "../shared/slack-types.js";
+import type { SlackEvent, SlackMessage, SendMessageOptions, EditMessageOptions } from "../shared/slack-types.js";
+/**
+ * An app mention event from Slack.
+ */
+export interface MentionEvent {
+    type: "app_mention";
+    channel: string;
+    user: string;
+    text: string;
+    ts: string;
+    thread_ts?: string;
+    team?: string;
+}
+type MentionHandler = (event: MentionEvent) => Promise<void> | void;
+type GenericEventHandler = (event: SlackEvent) => Promise<void> | void;
+/**
+ * Internal: Route an event to the appropriate handler.
+ */
+export declare function __handleSlackEvent(event: SlackEvent): Promise<void>;
+/**
+ * Common entry point for the bundler-generated worker.
+ */
+export declare function __handlePluginRequest(request: Request): Promise<Response>;
+export declare const slack: {
+    /**
+     * Register a handler for @mentions of your bot.
+     *
+     * @example
+     * ```typescript
+     * slack.onMention(async (event) => {
+     *   await slack.sendMessage({
+     *     channelId: event.channel,
+     *     threadTs: event.ts,
+     *     text: "Hey! How can I help?",
+     *   });
+     * });
+     * ```
+     */
+    onMention(handler: MentionHandler): void;
+    /**
+     * Register a fallback handler for events that aren't handled by other handlers.
+     * Use this for advanced cases where you need to handle raw events.
+     */
+    onEvent(handler: GenericEventHandler): void;
+    /**
+     * Send a message to a Slack channel.
+     */
+    sendMessage(options: SendMessageOptions): Promise<SlackMessage>;
+    /**
+     * Edit a message.
+     */
+    editMessage(channelId: string, ts: string, options: EditMessageOptions): Promise<SlackMessage>;
+    /**
+     * Add a reaction to a message.
+     */
+    addReaction(channelId: string, ts: string, emoji: string): Promise<void>;
+};
+//# sourceMappingURL=slack.d.ts.map

package/dist/worker-runtime/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/worker-runtime/slack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAMlC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAgBD,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACpE,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAMvE;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAczE;AAMD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAa/E;AAED,eAAO,MAAM,KAAK;IAChB;;;;;;;;;;;;;OAaG;uBACgB,cAAc,GAAG,IAAI;IAIxC;;;OAGG;qBACc,mBAAmB,GAAG,IAAI;IAI3C;;OAEG;yBACwB,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBrE;;OAEG;2BAEU,MAAM,MACb,MAAM,WACD,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC;IAiBxB;;OAEG;2BAC0B,MAAM,MAAM,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAa/E,CAAC"}

package/dist/worker-runtime/slack.js

@@ -0,0 +1,135 @@
+/**
+ * Fling Worker Runtime - Slack Integration
+ *
+ * Worker-compatible Slack runtime for Cloudflare Workers deployment.
+ * This module provides Slack-specific exports for the worker environment.
+ *
+ * Used via the "flingit/plugin/slack" subpath export.
+ */
+import { getPluginMeta } from "../shared/plugin-metadata.js";
+import { createPluginFetch, getProjectHeaders, throwResponseError } from "./plugin-common.js";
+// ═══════════════════════════════════════════════════════
+// INTERNAL HELPERS
+// ═══════════════════════════════════════════════════════
+// Service binding name from plugin metadata (single source of truth)
+const meta = getPluginMeta("slack");
+if (!meta)
+    throw new Error("slack plugin not found in metadata registry");
+const pluginFetch = createPluginFetch(meta.serviceBinding);
+// Registered handlers
+let _mentionHandler = null;
+let _fallbackHandler = null;
+/**
+ * Internal: Route an event to the appropriate handler.
+ */
+export async function __handleSlackEvent(event) {
+    // Handle app mentions
+    if (event.type === "event_callback") {
+        const innerEvent = event.event;
+        if (innerEvent?.type === "app_mention" && _mentionHandler) {
+            await _mentionHandler(innerEvent);
+            return;
+        }
+    }
+    // Fallback handler
+    if (_fallbackHandler) {
+        await _fallbackHandler(event);
+    }
+}
+// ═══════════════════════════════════════════════════════
+// PUBLIC API
+// ═══════════════════════════════════════════════════════
+/**
+ * Common entry point for the bundler-generated worker.
+ */
+export async function __handlePluginRequest(request) {
+    const event = await request.json();
+    try {
+        await __handleSlackEvent(event);
+        return new Response(JSON.stringify({ ok: true }), {
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    catch (error) {
+        console.error("Slack event handler error:", error);
+        return new Response(JSON.stringify({ ok: true }), {
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+}
+export const slack = {
+    /**
+     * Register a handler for @mentions of your bot.
+     *
+     * @example
+     * ```typescript
+     * slack.onMention(async (event) => {
+     *   await slack.sendMessage({
+     *     channelId: event.channel,
+     *     threadTs: event.ts,
+     *     text: "Hey! How can I help?",
+     *   });
+     * });
+     * ```
+     */
+    onMention(handler) {
+        _mentionHandler = handler;
+    },
+    /**
+     * Register a fallback handler for events that aren't handled by other handlers.
+     * Use this for advanced cases where you need to handle raw events.
+     */
+    onEvent(handler) {
+        _fallbackHandler = handler;
+    },
+    /**
+     * Send a message to a Slack channel.
+     */
+    async sendMessage(options) {
+        const response = await pluginFetch("/proxy/messages", {
+            method: "POST",
+            headers: await getProjectHeaders(),
+            body: JSON.stringify({
+                channelId: options.channelId,
+                text: options.text,
+                blocks: options.blocks,
+                threadTs: options.threadTs,
+            }),
+        });
+        if (!response.ok) {
+            await throwResponseError(response, "Failed to send message");
+        }
+        return response.json();
+    },
+    /**
+     * Edit a message.
+     */
+    async editMessage(channelId, ts, options) {
+        const response = await pluginFetch(`/proxy/messages/${channelId}/${ts}`, {
+            method: "PATCH",
+            headers: await getProjectHeaders(),
+            body: JSON.stringify({
+                text: options.text,
+                blocks: options.blocks,
+            }),
+        });
+        if (!response.ok) {
+            await throwResponseError(response, "Failed to edit message");
+        }
+        return response.json();
+    },
+    /**
+     * Add a reaction to a message.
+     */
+    async addReaction(channelId, ts, emoji) {
+        const encodedEmoji = encodeURIComponent(emoji);
+        const response = await pluginFetch(`/proxy/reactions/${channelId}/${ts}/${encodedEmoji}`, {
+            method: "PUT",
+            headers: await getProjectHeaders(),
+        });
+        if (!response.ok) {
+            await throwResponseError(response, "Failed to add reaction");
+        }
+    },
+};
+//# sourceMappingURL=slack.js.map

package/dist/worker-runtime/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../src/worker-runtime/slack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAmC9F,0DAA0D;AAC1D,mBAAmB;AACnB,0DAA0D;AAE1D,qEAAqE;AACrE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,IAAI,CAAC,IAAI;IAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAC1E,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAU3D,sBAAsB;AACtB,IAAI,eAAe,GAA0B,IAAI,CAAC;AAClD,IAAI,gBAAgB,GAA+B,IAAI,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAiB;IACxD,sBAAsB;IACtB,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACpC,MAAM,UAAU,GAAI,KAAuC,CAAC,KAAK,CAAC;QAClE,IAAI,UAAU,EAAE,IAAI,KAAK,aAAa,IAAI,eAAe,EAAE,CAAC;YAC1D,MAAM,eAAe,CAAC,UAAqC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,aAAa;AACb,0DAA0D;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IAC1D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,EAAgB,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YAChD,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YAChD,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,OAAuB;QAC/B,eAAe,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,OAA4B;QAClC,gBAAgB,GAAG,OAAO,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAA2B;QAC3C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,iBAAiB,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,MAAM,iBAAiB,EAAE;YAClC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAA2B,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,EAAU,EACV,OAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,mBAAmB,SAAS,IAAI,EAAE,EAAE,EAAE;YACvE,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,MAAM,iBAAiB,EAAE;YAClC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAA2B,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,EAAU,EAAE,KAAa;QAC5D,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,oBAAoB,SAAS,IAAI,EAAE,IAAI,YAAY,EAAE,EAAE;YACxF,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,MAAM,iBAAiB,EAAE;SACnC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CAEF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flingit",
-    "version": "0.0.18",
+    "version": "0.0.20",
     "description": "Personal Software Platform - Build and deploy personal tools through conversation",
     "type": "module",
     "engines": {
@@ -24,6 +24,12 @@
             "import": "./dist/runtime/discord.js",
             "default": "./dist/runtime/discord.js"
         },
+        "./plugin/slack": {
+            "workerd": "./dist/worker-runtime/slack.js",
+            "types": "./dist/runtime/slack.d.ts",
+            "import": "./dist/runtime/slack.js",
+            "default": "./dist/runtime/slack.js"
+        },
         "./worker-runtime": {
             "types": "./dist/worker-runtime/index.d.ts",
             "import": "./dist/worker-runtime/index.js"
@@ -67,9 +73,11 @@
         "dotenv": "^17.2.3",
         "esbuild": "^0.27.2",
         "hono": "^4.11.7",
-        "tsx": "^4.19.0"
+        "tsx": "^4.19.0",
+        "zod": "^3.25.76"
     },
     "devDependencies": {
+        "@cloudflare/workers-types": "^4.0.0",
         "@eslint/js": "^9.39.2",
         "@types/better-sqlite3": "^7.6.12",
         "@types/node": "^24.10.9",

package/templates/default/skills/fling/.hash

@@ -1 +1 @@
-48c43a6cab25d1a064e710509399ca76
+0862078e056a789ecb1426fcebd51516

package/templates/default/skills/fling/DISCORD.md

@@ -1,15 +1,14 @@
 # Discord Skill
 
-Build Discord chatops bots with Fling. Add slash commands, send messages, handle interactions, and react to events — all from your Fling project.
+Build Discord chatops bots with Fling. Handle slash commands, send messages, handle interactions, and react to events — all from your Fling project.
 
 ## Setup
 
 Discord requires a one-time setup before use:
 
 ```bash
-npm exec fling plugin install discord    # Connect Discord account (opens browser)
-npm exec fling plugin discord add-server # Claim a server for your project
-npm exec fling push                      # Deploy code + register slash commands
+npm exec fling plugin install discord    # Connect Discord account + add bot to a server (opens browser)
+npm exec fling push                      # Deploy code
 ```
 
 Run these commands yourself — you have bash access.
@@ -20,48 +19,31 @@ Run these commands yourself — you have bash access.
 import { app } from "flingit";
 import { discord } from "flingit/plugin/discord";
 
-// 1. Define slash commands (synced to Discord on `fling push`)
-export const commands = discord.defineCommands([
-  { name: "ping", description: "Check bot latency" },
-  {
-    name: "deploy",
-    description: "Deploy a branch",
-    options: [
-      { name: "branch", type: "string", description: "Branch name", required: true }
-    ]
-  }
-]);
-
-// 2. Handle slash commands on POST /discord
-app.post("/discord", async (c) => {
-  const interaction = await discord.verifyInteraction(c);
-
-  if (interaction.data?.name === "ping") {
-    await discord.replyToInteraction(interaction, {
-      content: "Pong!",
-      ephemeral: true  // Only visible to the user who ran the command
-    });
-  }
-
-  if (interaction.data?.name === "deploy") {
-    const branch = interaction.data.options?.[0]?.value as string;
-    await discord.replyToInteraction(interaction, {
-      content: `Deploying ${branch}...`
-    });
-
-    // Do work after the initial reply...
-    const result = await runDeploy(branch);
-
-    // Send a followup message (no 3-second limit)
-    await discord.sendFollowup(interaction, {
-      content: `Deployed ${branch}: ${result}`
-    });
-  }
-
-  return c.json({ ok: true });
+// 1. Handle slash commands using onCommand(name, description, handler)
+//    Commands are auto-registered with Discord on `fling push`
+discord.onCommand("ping", "Check if the bot is alive", async (interaction) => {
+  await discord.reply(interaction, {
+    content: "Pong!",
+    ephemeral: true  // Only visible to the user who ran the command
+  });
+});
+
+discord.onCommand("deploy", "Deploy a branch", async (interaction, options) => {
+  const branch = options.getString("branch") ?? "main";
+  await discord.reply(interaction, {
+    content: `Deploying ${branch}...`
+  });
+
+  // Do work after the initial reply...
+  const result = await runDeploy(branch);
+
+  // Send a followup message (no 3-second limit)
+  await discord.followup(interaction, {
+    content: `Deployed ${branch}: ${result}`
+  });
 });
 
-// 3. Send messages proactively (e.g., from webhooks or cron)
+// 2. Send messages proactively (e.g., from webhooks or cron)
 app.post("/api/notify", async (c) => {
   const { channelId, text } = await c.req.json();
 
@@ -82,67 +64,41 @@ All methods are imported from `"flingit/plugin/discord"`:
 import { discord } from "flingit/plugin/discord";
 ```
 
-### discord.defineCommands(commands)
-
-Register slash commands. **Must be exported** as a top-level `export const commands` for `fling push` to detect them.
-
-```typescript
-export const commands = discord.defineCommands([
-  { name: "status", description: "Show system status" },
-  {
-    name: "lookup",
-    description: "Look up a user",
-    options: [
-      { name: "email", type: "string", description: "User email", required: true },
-      { name: "verbose", type: "boolean", description: "Show full details" }
-    ]
-  }
-]);
-```
-
-**Command names:** 1-32 chars, lowercase letters, numbers, and hyphens only.
-
-**Option types:** `"string"`, `"integer"`, `"boolean"`, `"user"`, `"channel"`, `"role"`
-
-Options can have predefined choices:
-
-```typescript
-{
-  name: "env",
-  type: "string",
-  description: "Target environment",
-  required: true,
-  choices: [
-    { name: "Production", value: "prod" },
-    { name: "Staging", value: "staging" }
-  ]
-}
-```
-
-### discord.verifyInteraction(c)
+### discord.onCommand(name, description, handler)
 
-Parse an incoming Discord interaction from a Hono request context. Call this in your `POST /discord` handler.
+Register a handler for a specific slash command. Commands are **automatically registered** with Discord when you run `fling push` — no need to use the Discord Developer Portal.
 
 ```typescript
-app.post("/discord", async (c) => {
-  const interaction = await discord.verifyInteraction(c);
-
+discord.onCommand("ping", "Check if the bot is alive", async (interaction, options) => {
   // interaction.data.name = command name
-  // interaction.data.options = command arguments
+  // options.getString("param") = get a string option
+  // options.getNumber("count") = get a number option
+  // options.getBoolean("force") = get a boolean option
   // interaction.member.user = who ran the command (in servers)
   // interaction.guild_id = which server
   // interaction.channel_id = which channel
+  await discord.reply(interaction, "Pong!");
 });
 ```
 
 The platform verifies Discord's cryptographic signature before forwarding to your code — you don't need to handle that.
 
-### discord.replyToInteraction(interaction, options)
+### discord.onEvent(handler)
+
+Register a fallback handler for interactions that don't match any `onCommand`. Use for advanced cases.
+
+```typescript
+discord.onEvent(async (interaction) => {
+  // Called for any interaction not handled by onCommand
+});
+```
+
+### discord.reply(interaction, options)
 
 Reply to a slash command. **Must be called within 3 seconds** of receiving the interaction.
 
 ```typescript
-await discord.replyToInteraction(interaction, {
+discord.reply(interaction, {
   content: "Hello!",              // Text content (max 2000 chars)
   ephemeral: true,                // Only visible to command user (optional)
   embeds: [{                      // Rich embeds (optional, max 10)
@@ -153,16 +109,16 @@ await discord.replyToInteraction(interaction, {
 });
 ```
 
-### discord.sendFollowup(interaction, options)
+### discord.followup(interaction, options)
 
 Send additional messages after the initial reply. No 3-second time limit.
 
 ```typescript
-await discord.replyToInteraction(interaction, { content: "Working on it..." });
+discord.reply(interaction, { content: "Working on it..." });
 
 // ... do async work ...
 
-const msg = await discord.sendFollowup(interaction, {
+const msg = await discord.followup(interaction, {
   content: "Done! Here are the results.",
   embeds: [{ title: "Results", description: resultText }]
 });
@@ -243,23 +199,17 @@ Content max: 2000 characters. Embeds max: 10 per message.
 
 ## Reading Command Options
 
-Access option values from `interaction.data.options`:
+The `options` helper provides typed accessors for command options:
 
 ```typescript
-app.post("/discord", async (c) => {
-  const interaction = await discord.verifyInteraction(c);
-
-  if (interaction.data?.name === "deploy") {
-    const options = interaction.data.options ?? [];
-    const branch = options.find(o => o.name === "branch")?.value as string;
-    const force = options.find(o => o.name === "force")?.value as boolean ?? false;
-
-    await discord.replyToInteraction(interaction, {
-      content: `Deploying ${branch}${force ? " (force)" : ""}...`
-    });
-  }
+discord.onCommand("deploy", "Deploy a branch", async (interaction, options) => {
+  const branch = options.getString("branch") ?? "main";
+  const force = options.getBoolean("force") ?? false;
+  const count = options.getNumber("count") ?? 1;
 
-  return c.json({ ok: true });
+  await discord.reply(interaction, {
+    content: `Deploying ${branch}${force ? " (force)" : ""}...`
+  });
 });
 ```
 
@@ -268,9 +218,7 @@ app.post("/discord", async (c) => {
 Access who ran the command and where:
 
 ```typescript
-app.post("/discord", async (c) => {
-  const interaction = await discord.verifyInteraction(c);
-
+discord.onCommand("info", "Show context info", async (interaction) => {
   // Who ran it
   const user = interaction.member?.user;  // In servers
   // user.id, user.username
@@ -289,14 +237,12 @@ app.post("/discord", async (c) => {
 
 ```bash
 # Setup
-npm exec fling plugin install discord      # Connect Discord (OAuth)
-npm exec fling plugin discord add-server   # Claim a server
-npm exec fling plugin discord remove-server # Release a server
+npm exec fling plugin install discord      # Connect Discord (OAuth), auto-claims server
 
 # Status
 npm exec fling plugin permissions discord  # Show connection status + servers
 
-# Deployment (registers slash commands automatically)
+# Deployment
 npm exec fling push
 
 # Teardown
@@ -305,24 +251,21 @@ npm exec fling plugin remove discord       # Disconnect, release all servers
 
 ## How It Works
 
-1. **`fling plugin install discord`** opens a browser for Discord OAuth. You authorize Fling to see your servers and add the bot.
-2. **`fling plugin discord add-server`** claims a Discord server for your project. Each server can only be claimed by one project.
-3. **`export const commands = discord.defineCommands([...])`** in your code defines slash commands. `fling push` extracts them and registers them with Discord in all claimed servers.
-4. When a user runs a slash command, Discord sends it to the platform, which routes it to your worker's `POST /discord` endpoint.
-5. Your code calls `discord.verifyInteraction(c)` to parse it and `discord.replyToInteraction()` to respond.
+1. **`fling plugin install discord`** opens a browser for Discord OAuth. You authorize Fling, select a server to add the bot to, and that server is automatically claimed for your project.
+2. **`discord.onCommand(name, description, handler)`** registers a named command handler with a description.
+3. **`fling push`** bundles your code, deploys it, then automatically registers your slash commands with Discord's API for each claimed server. Commands appear instantly in Discord's slash command picker.
+4. When a user runs a slash command, Discord sends it to the platform, which routes it to your worker.
+5. Your handler receives the interaction and calls `discord.reply()` to respond.
+6. To add the bot to additional servers, re-run `fling plugin install discord` (remove and reinstall to re-OAuth), then `fling push` again to register commands in the new server.
 
 ## Important Constraints
 
 1. **Discord features only work in deployed workers** — They throw errors locally. Use `fling push` to deploy, then test in Discord.
 
-2. **Reply within 3 seconds** — `replyToInteraction()` must be called within 3 seconds. For slow operations, reply immediately with "Working..." then use `sendFollowup()` for the result.
-
-3. **Commands must be exported** — `fling push` looks for `export const commands = discord.defineCommands(...)`. If the export is missing, commands won't be registered.
-
-4. **Handle interactions at POST /discord** — The platform routes all interactions to this exact path on your worker.
+2. **Reply within 3 seconds** — `discord.reply()` must be called within 3 seconds. For slow operations, reply immediately with "Working..." then use `discord.followup()` for the result.
 
-5. **Channels must be in claimed servers** — `sendMessage()`, `editMessage()`, and `addReaction()` only work in channels belonging to servers claimed by your project.
+3. **Channels must be in claimed servers** — `sendMessage()`, `editMessage()`, and `addReaction()` only work in channels belonging to servers claimed by your project.
 
-6. **One project per server** — A Discord server can only be claimed by one Fling project at a time.
+4. **One project per server** — A Discord server can only be claimed by one Fling project at a time.
 
-7. **Plugin must be installed first** — Run `fling plugin install discord` before using any Discord features. Check with `fling plugin permissions discord`.
+5. **Plugin must be installed first** — Run `fling plugin install discord` before using any Discord features. Check with `fling plugin permissions discord`.