archer-wizard 0.1.0

package/.env.example

@@ -0,0 +1,6 @@
+# Archer — event intelligence for AI agents
+# Copy this to .env and fill in your Supabase credentials
+
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+SUPABASE_ANON_KEY=your-anon-key

package/README.md

@@ -0,0 +1,140 @@
+# 🏹 Archer
+
+**Event intelligence for AI agents.** One command connects your backend to Cursor, Claude Code, Windsurf, and any MCP-compatible agent.
+
+```
+npx archer
+```
+
+## What it does
+
+Archer gives your AI agent a `watch` tool. The agent can monitor real-time events from your backend — database changes, auth events, webhooks — and react when conditions match.
+
+```
+"Watch my users table for new signups from @company.com"
+```
+
+→ Archer subscribes to the event, filters by condition, and POSTs to your webhook URL.
+
+## Supported Sources
+
+| Source | Events | Status |
+|--------|--------|--------|
+| **Supabase** | `auth.signup`, `table.insert`, `table.update`, `table.delete` | ✅ Available |
+| **Firebase** | Auth, Firestore, Realtime DB | 🔜 Coming soon |
+| **Stripe** | Payments, subscriptions, invoices | 🔜 Coming soon |
+| **GitHub** | Push, PR, issues, deployments | 🔜 Coming soon |
+| **Custom Webhooks** | Any incoming webhook | 🔜 Coming soon |
+
+> Want a source added? [Open an issue →](https://github.com/archer-mcp/archer/issues)
+
+## Setup
+
+```bash
+npx archer
+```
+
+The interactive wizard will:
+
+1. **Scan** your project for credentials (`.env`, `.env.local`, etc.)
+2. **Detect** installed AI agents (Cursor, Claude Code, Windsurf, etc.)
+3. **Inject** the Archer MCP server into each agent's config
+4. **Write** agent rules so the LLM knows how to use the tool
+
+## Supported Agents
+
+| Agent | Config Path | Status |
+|-------|------------|--------|
+| Cursor | `~/.cursor/mcp.json` | ✅ |
+| Claude Code | Platform-specific | ✅ |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` | ✅ |
+| OpenCode | `~/.config/opencode/config.json` | ✅ |
+
+## The `archer_watch` Tool
+
+### Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `source` | `string` | Yes | Event source (`"supabase"`, more coming) |
+| `event` | `string` | Yes | Event type (source-specific) |
+| `table` | `string` | Depends | Resource name (e.g. table for Supabase) |
+| `condition` | `string` | No | Filter like `"email ends with @gmail.com"` |
+| `webhookUrl` | `string` | Yes | URL to receive POST notifications |
+
+### Condition Operators
+
+- `ends with` — `"email ends with @company.com"`
+- `starts with` — `"name starts with John"`
+- `contains` — `"status contains active"`
+- `equals` — `"role equals admin"`
+
+### Example: Supabase
+
+```json
+{
+  "source": "supabase",
+  "event": "auth.signup",
+  "webhookUrl": "https://hooks.example.com/signups"
+}
+```
+
+```json
+{
+  "source": "supabase",
+  "event": "table.insert",
+  "table": "orders",
+  "condition": "total equals 0",
+  "webhookUrl": "https://hooks.example.com/free-orders"
+}
+```
+
+### Webhook Payload
+
+Every webhook POST follows the same envelope format, regardless of source:
+
+```json
+{
+  "archer": {
+    "watchId": "watch_a1b2c3d4",
+    "event": "table.insert",
+    "source": "supabase",
+    "firedAt": "2025-01-15T10:30:00.000Z"
+  },
+  "data": { ... }
+}
+```
+
+## Architecture
+
+```
+npx archer          →  Interactive wizard (scan, detect, inject, configure)
+npx archer --mcp    →  MCP server mode (stdio transport, used by agents)
+```
+
+The wizard injects this into each agent's config:
+
+```json
+{
+  "mcpServers": {
+    "archer": {
+      "command": "npx",
+      "args": ["-y", "archer", "--mcp"],
+      "env": {
+        "SUPABASE_URL": "...",
+        "SUPABASE_SERVICE_ROLE_KEY": "..."
+      }
+    }
+  }
+}
+```
+
+## Requirements
+
+- Node.js 18+
+- At least one supported AI agent installed
+- Credentials for your event source (e.g. Supabase URL + service role key)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+// ─── Mode Detection ─────────────────────────────────────────
+const isMcpMode = process.argv.includes('--mcp');
+if (isMcpMode) {
+    // ─── MCP Server Mode ─────────────────────────────────────
+    const { Server } = await import('@modelcontextprotocol/sdk/server/index.js');
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { CallToolRequestSchema, ListToolsRequestSchema, } = await import('@modelcontextprotocol/sdk/types.js');
+    const { executeWatch, WATCH_TOOL_SCHEMA } = await import('./tools/watch.js');
+    const { stderrReady, stderrError } = await import('./lib/ascii.js');
+    const server = new Server({
+        name: 'archer',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register tool listing
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [WATCH_TOOL_SCHEMA],
+        };
+    });
+    // Register tool execution
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (name === 'archer_watch') {
+            const result = executeWatch(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: `unknown tool: ${name}` }),
+                },
+            ],
+            isError: true,
+        };
+    });
+    // Start server
+    try {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        stderrReady('archer MCP server running on stdio');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        stderrError(`failed to start MCP server: ${message}`);
+        process.exit(1);
+    }
+}
+else {
+    // ─── Wizard Mode ─────────────────────────────────────────
+    const { runWizard } = await import('./wizard/index.js');
+    try {
+        await runWizard();
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('cancel')) {
+            console.log('\n  cancelled.\n');
+            process.exit(0);
+        }
+        console.error(err);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/ascii.d.ts

@@ -0,0 +1,14 @@
+export declare function showAsciiArt(): void;
+export declare function logAction(message: string): void;
+export declare function logSuccess(message: string): void;
+export declare function logError(message: string): void;
+export declare function logProgress(message: string): void;
+export declare function logReady(message: string): void;
+export declare function maskCredential(value: string): string;
+export declare function showSuccessBox(agentCount: number): void;
+export declare function stderrLog(message: string): void;
+export declare function stderrAction(message: string): void;
+export declare function stderrSuccess(message: string): void;
+export declare function stderrError(message: string): void;
+export declare function stderrReady(message: string): void;
+//# sourceMappingURL=ascii.d.ts.map

package/dist/lib/ascii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii.d.ts","sourceRoot":"","sources":["../../src/lib/ascii.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,IAAI,IAAI,CA0BnC;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAID,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAqBvD;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/lib/ascii.js

@@ -0,0 +1,88 @@
+import pc from 'picocolors';
+// ─── ASCII Art ──────────────────────────────────────────────
+export function showAsciiArt() {
+    const lines = [
+        '█████╗ ██████╗  ██████╗██╗  ██╗███████╗██████╗ ',
+        '██╔══██╗██╔══██╗██╔════╝██║  ██║██╔════╝██╔══██╗',
+        '███████║██████╔╝██║     ███████║█████╗  ██████╔╝',
+        '██╔══██║██╔══██╗██║     ██╔══██║██╔══╝  ██╔══██╗',
+        '██║  ██║██║  ██║╚██████╗██║  ██║███████╗██║  ██║',
+        '╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝',
+    ];
+    // Column boundaries for coloring:
+    // A: cols 0-5, R: 6-13, C: 14-21, H: 22-29, E: 30-37, R: 38-45
+    // ARCH = white, ER = green
+    const archEnd = 30; // columns 0-29 are A R C H
+    const erEnd = 46; // columns 30-45 are E R
+    for (const line of lines) {
+        const archPart = line.slice(0, archEnd);
+        const erPart = line.slice(archEnd, erEnd);
+        const rest = line.slice(erEnd);
+        process.stdout.write(pc.white(archPart) + pc.green(erPart) + rest + '\n');
+    }
+    console.log();
+    console.log(pc.dim('  v0.1.0  ·  event intelligence for AI agents'));
+    console.log();
+}
+// ─── Status Logger ──────────────────────────────────────────
+export function logAction(message) {
+    console.log(`${pc.blue('◆')}  ${message}`);
+}
+export function logSuccess(message) {
+    console.log(`${pc.green('✓')}  ${message}`);
+}
+export function logError(message) {
+    console.log(`${pc.red('✗')}  ${message}`);
+}
+export function logProgress(message) {
+    console.log(`${pc.white('●')}  ${message}`);
+}
+export function logReady(message) {
+    console.log(`${pc.green('▶')}  ${message}`);
+}
+// ─── Credential Masking ─────────────────────────────────────
+export function maskCredential(value) {
+    if (value.length <= 8) {
+        return value.slice(0, 3) + '******';
+    }
+    return value.slice(0, 8) + '******';
+}
+// ─── Success Box ────────────────────────────────────────────
+export function showSuccessBox(agentCount) {
+    const lines = [
+        '',
+        `   ${pc.green('▶')}  Archer is ready`,
+        '',
+        `   injected into ${agentCount} agent${agentCount !== 1 ? 's' : ''}`,
+        '   connected to your Supabase project',
+        '',
+        '   open your AI agent and say:',
+        `   ${pc.dim('"watch my users table for new signups"')}`,
+        '',
+    ];
+    const maxLen = 46;
+    console.log(`  ┌${'─'.repeat(maxLen)}┐`);
+    for (const line of lines) {
+        const stripped = line.replace(/\x1b\[[0-9;]*m/g, '');
+        const padding = maxLen - stripped.length;
+        console.log(`  │${line}${' '.repeat(Math.max(0, padding))}│`);
+    }
+    console.log(`  └${'─'.repeat(maxLen)}┘`);
+}
+// ─── Stderr Logger (for MCP mode) ───────────────────────────
+export function stderrLog(message) {
+    process.stderr.write(`${message}\n`);
+}
+export function stderrAction(message) {
+    process.stderr.write(`${pc.blue('◆')}  ${message}\n`);
+}
+export function stderrSuccess(message) {
+    process.stderr.write(`${pc.green('✓')}  ${message}\n`);
+}
+export function stderrError(message) {
+    process.stderr.write(`${pc.red('✗')}  ${message}\n`);
+}
+export function stderrReady(message) {
+    process.stderr.write(`${pc.green('▶')}  ${message}\n`);
+}
+//# sourceMappingURL=ascii.js.map

package/dist/lib/ascii.js.map

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

package/dist/lib/supabase.d.ts

@@ -0,0 +1,7 @@
+import { type SupabaseClient, type RealtimeChannel } from '@supabase/supabase-js';
+import type { PostgresEvent } from '../types/index.js';
+export declare function getSupabaseClient(): SupabaseClient;
+export declare function createAuthChannel(channelName: string, onEvent: (payload: Record<string, unknown>) => void): RealtimeChannel;
+export declare function createTableChannel(channelName: string, table: string, event: PostgresEvent, onEvent: (payload: Record<string, unknown>) => void): RealtimeChannel;
+export declare function removeChannel(channel: RealtimeChannel): Promise<void>;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/lib/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/lib/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEhG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAiBvD,wBAAgB,iBAAiB,IAAI,cAAc,CAclD;AAID,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAClD,eAAe,CAWjB;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAClD,eAAe,CAYjB;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E"}

package/dist/lib/supabase.js

@@ -0,0 +1,54 @@
+import { createClient } from '@supabase/supabase-js';
+import { stderrError } from './ascii.js';
+// ─── Env Validation ─────────────────────────────────────────
+function getEnvVar(name) {
+    const value = process.env[name];
+    if (!value) {
+        stderrError(`missing required env var: ${name}`);
+        throw new Error(`Missing env var: ${name}`);
+    }
+    return value;
+}
+// ─── Supabase Client ────────────────────────────────────────
+let _client = null;
+export function getSupabaseClient() {
+    if (_client)
+        return _client;
+    const url = getEnvVar('SUPABASE_URL');
+    const key = getEnvVar('SUPABASE_SERVICE_ROLE_KEY');
+    _client = createClient(url, key, {
+        auth: {
+            autoRefreshToken: false,
+            persistSession: false,
+        },
+    });
+    return _client;
+}
+// ─── Realtime Channel Helpers ───────────────────────────────
+export function createAuthChannel(channelName, onEvent) {
+    const client = getSupabaseClient();
+    const channel = client
+        .channel(channelName)
+        .on('postgres_changes', { event: 'INSERT', schema: 'auth', table: 'users' }, (payload) => {
+        onEvent(payload.new);
+    })
+        .subscribe();
+    return channel;
+}
+export function createTableChannel(channelName, table, event, onEvent) {
+    const client = getSupabaseClient();
+    const channel = client
+        .channel(channelName)
+        .on('postgres_changes', { event, schema: 'public', table }, (payload) => {
+        const data = event === 'DELETE' ? payload.old : payload.new;
+        onEvent(data);
+    })
+        .subscribe();
+    return channel;
+}
+// ─── Cleanup ────────────────────────────────────────────────
+export async function removeChannel(channel) {
+    const client = getSupabaseClient();
+    await client.removeChannel(channel);
+}
+//# sourceMappingURL=supabase.js.map

package/dist/lib/supabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.js","sourceRoot":"","sources":["../../src/lib/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA6C,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,+DAA+D;AAE/D,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,WAAW,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+DAA+D;AAE/D,IAAI,OAAO,GAA0B,IAAI,CAAC;AAE1C,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,GAAG,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,SAAS,CAAC,2BAA2B,CAAC,CAAC;IAEnD,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE;QAC/B,IAAI,EAAE;YACJ,gBAAgB,EAAE,KAAK;YACvB,cAAc,EAAE,KAAK;SACtB;KACF,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+DAA+D;AAE/D,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,OAAmD;IAEnD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAEnC,MAAM,OAAO,GAAG,MAAM;SACnB,OAAO,CAAC,WAAW,CAAC;SACpB,EAAE,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE;QACvF,OAAO,CAAC,OAAO,CAAC,GAA8B,CAAC,CAAC;IAClD,CAAC,CAAC;SACD,SAAS,EAAE,CAAC;IAEf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,KAAa,EACb,KAAoB,EACpB,OAAmD;IAEnD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAEnC,MAAM,OAAO,GAAG,MAAM;SACnB,OAAO,CAAC,WAAW,CAAC;SACpB,EAAE,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE;QACtE,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAC5D,OAAO,CAAC,IAA+B,CAAC,CAAC;IAC3C,CAAC,CAAC;SACD,SAAS,EAAE,CAAC;IAEf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAwB;IAC1D,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/lib/webhook.d.ts

@@ -0,0 +1,4 @@
+import type { WebhookOptions, WebhookPayload } from '../types/index.js';
+export declare function fireWebhook(options: WebhookOptions): Promise<boolean>;
+export declare function buildWebhookPayload(watchId: string, event: string, data: Record<string, unknown>): WebhookPayload;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/lib/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/lib/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAaxE,wBAAsB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAoC3E;AAID,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,cAAc,CAUhB"}

package/dist/lib/webhook.js

@@ -0,0 +1,53 @@
+import { stderrAction, stderrSuccess, stderrError } from './ascii.js';
+// ─── Retry Config ───────────────────────────────────────────
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 2000;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ─── Fire Webhook ───────────────────────────────────────────
+export async function fireWebhook(options) {
+    const { url, payload, event } = options;
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            stderrAction(`webhook → ${url} (attempt ${attempt}/${MAX_RETRIES})`);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'Archer/0.1.0',
+                    'X-Archer-Event': event,
+                },
+                body: JSON.stringify(payload),
+            });
+            if (response.ok) {
+                stderrSuccess(`webhook delivered → ${response.status}`);
+                return true;
+            }
+            stderrError(`webhook failed → ${response.status} ${response.statusText}`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            stderrError(`webhook error → ${message}`);
+        }
+        if (attempt < MAX_RETRIES) {
+            stderrAction(`retrying in ${RETRY_DELAY_MS / 1000}s...`);
+            await sleep(RETRY_DELAY_MS);
+        }
+    }
+    stderrError(`webhook exhausted all ${MAX_RETRIES} retries`);
+    return false;
+}
+// ─── Build Payload ──────────────────────────────────────────
+export function buildWebhookPayload(watchId, event, data) {
+    return {
+        archer: {
+            watchId,
+            event,
+            source: 'supabase',
+            firedAt: new Date().toISOString(),
+        },
+        data,
+    };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/lib/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/lib/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGtE,+DAA+D;AAE/D,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAuB;IACvD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAExC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,YAAY,CAAC,aAAa,GAAG,aAAa,OAAO,IAAI,WAAW,GAAG,CAAC,CAAC;YAErE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,YAAY,EAAE,cAAc;oBAC5B,gBAAgB,EAAE,KAAK;iBACxB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,aAAa,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACxD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,WAAW,CAAC,oBAAoB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,WAAW,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,YAAY,CAAC,eAAe,cAAc,GAAG,IAAI,MAAM,CAAC,CAAC;YACzD,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,WAAW,CAAC,yBAAyB,WAAW,UAAU,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+DAA+D;AAE/D,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,KAAa,EACb,IAA6B;IAE7B,OAAO;QACL,MAAM,EAAE;YACN,OAAO;YACP,KAAK;YACL,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAClC;QACD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/tools/watch.d.ts

@@ -0,0 +1,35 @@
+import { type WatchResult } from '../types/index.js';
+export declare function executeWatch(rawInput: unknown): WatchResult;
+export declare const WATCH_TOOL_SCHEMA: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            source: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            event: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            table: {
+                type: "string";
+                description: string;
+            };
+            condition: {
+                type: "string";
+                description: string;
+            };
+            webhookUrl: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=watch.d.ts.map

package/dist/tools/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/tools/watch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqC,KAAK,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AAmG5G,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAoF3D;AAID,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC7B,CAAC"}