@firela/billclaw-openclaw 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 fire-la
+
+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,275 @@
+# @firela/billclaw-openclaw
+
+OpenClaw plugin adapter for BillClaw financial data import.
+
+## Overview
+
+This package provides an OpenClaw plugin that integrates BillClaw's financial data capabilities with the OpenClaw AI framework. It exposes:
+
+- **Agent Tools**: Plaid sync, Gmail fetch, bill parsing, conversational interface
+- **CLI Commands**: `bills setup`, `bills sync`, `bills status`, `bills config`
+- **OAuth Providers**: Plaid Link and Gmail OAuth flows
+- **Background Services**: Sync service and webhook handler
+
+## Installation
+
+### As OpenClaw Extension
+
+```bash
+cd ~/.openclaw/extensions
+npm install @firela/billclaw-openclaw
+```
+
+### Manual Registration
+
+Add to your OpenClaw configuration:
+
+```json
+{
+  "extensions": ["@firela/billclaw-openclaw"]
+}
+```
+
+## Quick Start
+
+### Using Agent Tools
+
+```typescript
+// In an OpenClaw agent context
+const result = await agent.useTool("plaid_sync", {
+  accountId: "plaid-123"
+});
+// Returns: { success: true, transactionsAdded: 42, ... }
+```
+
+### Using CLI Commands
+
+```bash
+# In OpenClaw CLI
+openclaw bills setup
+openclaw bills sync
+openclaw bills status
+openclaw bills config storage.path
+```
+
+### OAuth Integration
+
+```typescript
+// In OpenClaw OAuth flow
+const oauth = await openclaw.getOAuthProvider("plaid");
+const { url, token } = await oauth.handler(context);
+```
+
+## Available Tools
+
+### plaid_sync
+
+Sync transactions from Plaid-connected bank accounts.
+
+```typescript
+await agent.useTool("plaid_sync", {
+  accountId: "plaid-123"  // Optional - syncs all if omitted
+});
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "accountsSynced": 1,
+  "transactionsAdded": 42,
+  "transactionsUpdated": 5
+}
+```
+
+### gmail_fetch_bills
+
+Fetch and parse bills from Gmail.
+
+```typescript
+await agent.useTool("gmail_fetch_bills", {
+  accountId: "gmail-123",
+  days: 30  // Optional - default 30
+});
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "accountsProcessed": 1,
+  "emailsProcessed": 150,
+  "billsExtracted": 12,
+  "transactionsAdded": 12
+}
+```
+
+### bill_parse
+
+Parse bill data from various formats.
+
+```typescript
+await agent.useTool("bill_parse", {
+  source: "email",
+  data: "raw email content"
+});
+```
+
+### conversational_sync
+
+Sync with natural language support.
+
+```typescript
+await agent.useTool("conversational_sync", {
+  prompt: "Sync my accounts"
+});
+```
+
+### conversational_status
+
+Show account status with natural language.
+
+```typescript
+await agent.useTool("conversational_status", {});
+```
+
+### conversational_help
+
+Get help with BillClaw commands.
+
+```typescript
+await agent.useTool("conversational_help", {
+  topic: "sync"
+});
+```
+
+## CLI Commands
+
+### bills setup
+
+Interactive setup wizard for connecting accounts.
+
+```bash
+openclaw bills setup
+```
+
+### bills sync
+
+Manually trigger transaction sync.
+
+```bash
+# Sync all accounts
+openclaw bills sync
+
+# Sync specific account
+openclaw bills sync plaid-123
+```
+
+### bills status
+
+Show connection status and recent sync results.
+
+```bash
+openclaw bills status
+```
+
+### bills config
+
+Manage plugin configuration.
+
+```bash
+# View all config
+openclaw bills config
+
+# View specific key
+openclaw bills config storage.path
+
+# Set value
+openclaw bills config storage.format json
+```
+
+## OAuth Providers
+
+### Plaid
+
+```typescript
+const oauth = await openclaw.getOAuthProvider("plaid");
+const { url } = await oauth.handler(context);
+// Redirect user to Plaid Link
+```
+
+### Gmail
+
+```typescript
+const oauth = await openclaw.getOAuthProvider("gmail");
+const { url } = await oauth.handler(context);
+// Redirect user to Google OAuth
+```
+
+## Background Services
+
+### billclaw-sync
+
+Automatic sync service that runs on configured intervals.
+
+### billclaw-webhook
+
+HTTP webhook handler for real-time transaction updates from Plaid.
+
+## Configuration
+
+Plugin configuration is managed through OpenClaw's plugin config system:
+
+```json
+{
+  "accounts": [],
+  "storage": {
+    "path": "~/.openclaw/billclaw",
+    "format": "json"
+  },
+  "sync": {
+    "defaultFrequency": "daily",
+    "maxRetries": 3
+  }
+}
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────┐
+│           OpenClaw Framework            │
+├─────────────────────────────────────────┤
+│  BillClaw Plugin                        │
+│  ├── Agent Tools (6)                    │
+│  ├── CLI Commands (4)                   │
+│  ├── OAuth Providers (2)                │
+│  └── Background Services (2)            │
+├─────────────────────────────────────────┤
+│  @firela/billclaw-core                 │
+│  (Framework-agnostic core logic)        │
+└─────────────────────────────────────────┘
+```
+
+## Development
+
+```bash
+# Build
+pnpm build
+
+# Watch mode
+pnpm dev
+
+# Test
+pnpm test
+```
+
+## License
+
+MIT
+
+## See Also
+
+- [@firela/billclaw-core](https://github.com/fire-la/billclaw/tree/main/packages/core)
+- [@firela/billclaw-cli](https://github.com/fire-la/billclaw/tree/main/packages/cli)
+- [OpenClaw Documentation](https://openclaw.dev)

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAGrC,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA"}

package/dist/oauth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/oauth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA"}

package/dist/oauth/plaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plaid.d.ts","sourceRoot":"","sources":["../../src/oauth/plaid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAwFpE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,iBAAiB,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAC,CA2BD"}

package/dist/oauth/plaid.js

@@ -0,0 +1,108 @@
+/**
+ * Plaid OAuth handler - implements Plaid Link flow
+ *
+ * This module handles the Plaid Link OAuth flow for connecting bank accounts.
+ * It supports two modes:
+ * 1. Link token creation (for initializing Plaid Link frontend)
+ * 2. Public token exchange (for completing the connection)
+ */
+import { createPlaidClient } from "@firela/billclaw-core";
+/**
+ * Get Plaid configuration from OpenClaw config
+ *
+ * Checks both pluginConfig and environment variables for credentials.
+ */
+function getPlaidConfig(api) {
+    const pluginConfig = api.pluginConfig;
+    const plaidConfig = pluginConfig?.plaid || {};
+    const clientId = plaidConfig.clientId || process.env.PLAID_CLIENT_ID;
+    const secret = plaidConfig.secret || process.env.PLAID_SECRET;
+    const environment = plaidConfig.environment || "sandbox";
+    if (!clientId || !secret) {
+        throw new Error("Plaid credentials not configured. Set PLAID_CLIENT_ID and PLAID_SECRET environment variables, or configure them in billclaw settings.");
+    }
+    return {
+        clientId,
+        secret,
+        environment: environment,
+    };
+}
+/**
+ * Create Plaid Link token for initializing Link frontend
+ */
+async function createLinkToken(api, accountId) {
+    const plaidConfig = getPlaidConfig(api);
+    const plaidClient = createPlaidClient(plaidConfig);
+    const request = {
+        user: {
+            client_user_id: accountId || `user_${Date.now()}`,
+        },
+        client_name: "BillClaw",
+        products: ["transactions"],
+        country_codes: ["US"],
+        language: "en",
+    };
+    const axiosResponse = await plaidClient.linkTokenCreate(request);
+    const response = axiosResponse.data;
+    api.logger.info?.("Plaid Link token created successfully");
+    return { linkToken: response.link_token };
+}
+/**
+ * Exchange Plaid public token for access token
+ */
+async function exchangePublicToken(api, publicToken) {
+    const plaidConfig = getPlaidConfig(api);
+    const plaidClient = createPlaidClient(plaidConfig);
+    const request = {
+        public_token: publicToken,
+    };
+    const axiosResponse = await plaidClient.itemPublicTokenExchange(request);
+    const response = axiosResponse.data;
+    api.logger.info?.("Plaid public token exchanged successfully");
+    return {
+        accessToken: response.access_token,
+        itemId: response.item_id,
+    };
+}
+/**
+ * Handle Plaid Link OAuth flow
+ *
+ * This integrates Plaid Link (https://plaid.com/docs/link/)
+ * for secure bank account connection.
+ *
+ * Flow:
+ * 1. Create Link token (no params) - Returns { url, token: linkToken }
+ * 2. Handle Link success callback - Receives publicToken
+ * 3. Exchange public_token for access_token - Returns { url: "", token: accessToken, itemId }
+ *
+ * @param api - OpenClaw plugin API
+ * @param publicToken - Optional public token from Plaid Link callback
+ * @returns OAuthResult with URL and token
+ */
+export async function plaidOAuthHandler(api, publicToken) {
+    try {
+        if (!publicToken) {
+            // No public token provided - create Link token for initializing Link
+            const { linkToken } = await createLinkToken(api);
+            // Return Plaid Link URL and the link token
+            return {
+                url: "https://cdn.plaid.com/link/v2/stable/link.html",
+                token: linkToken,
+            };
+        }
+        // Public token provided - exchange for access token
+        const { accessToken, itemId } = await exchangePublicToken(api, publicToken);
+        // Return the access token and item ID for storage
+        return {
+            url: "",
+            token: accessToken,
+            itemId,
+            accessToken,
+        };
+    }
+    catch (error) {
+        api.logger.error?.("Plaid OAuth error:", error);
+        throw error;
+    }
+}
+//# sourceMappingURL=plaid.js.map

package/dist/oauth/plaid.js.map

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

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAYnE;;GAEG;;;;;;kBAQa,iBAAiB;;AAPjC,wBA0NC"}

package/dist/runtime/context.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OpenClaw runtime context adapter
+ *
+ * Adapts OpenClaw's plugin API to BillClaw's runtime abstractions.
+ */
+import type { OpenClawPluginApi } from "../types/openclaw-plugin.js";
+import type { RuntimeContext, ConfigProvider, Logger, EventEmitter } from "@firela/billclaw-core";
+import type { BillclawConfig } from "@firela/billclaw-core";
+/**
+ * OpenClaw logger adapter
+ */
+export declare class OpenClawLogger implements Logger {
+    private api;
+    constructor(api: OpenClawPluginApi);
+    info(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+/**
+ * OpenClaw config provider
+ */
+export declare class OpenClawConfigProvider implements ConfigProvider {
+    private api;
+    private cachedConfig?;
+    constructor(api: OpenClawPluginApi);
+    getConfig(): Promise<BillclawConfig>;
+    getStorageConfig(): Promise<any>;
+    updateAccount(accountId: string, updates: Partial<any>): Promise<void>;
+    getAccount(accountId: string): Promise<any | null>;
+}
+/**
+ * OpenClaw event emitter adapter
+ */
+export declare class OpenClawEventEmitter implements EventEmitter {
+    private listeners;
+    emit(event: string, data?: unknown): void;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+}
+/**
+ * OpenClaw runtime context
+ */
+export declare class OpenClawRuntimeContext implements RuntimeContext {
+    private _logger;
+    private _config;
+    private _events;
+    constructor(api: OpenClawPluginApi);
+    get logger(): Logger;
+    get config(): ConfigProvider;
+    get events(): EventEmitter;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/runtime/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,MAAM,EACN,YAAY,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D;;GAEG;AACH,qBAAa,cAAe,YAAW,MAAM;IAC/B,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,iBAAiB;IAE1C,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKhC;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAG/C,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,YAAY,CAAC,CAAgB;gBAEjB,GAAG,EAAE,iBAAiB;IAEpC,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAUpC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC;IAWhC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;CAIzD;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,SAAS,CAAmD;IAEpE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAazC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI;IAO1D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI;CAM5D;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAc;gBAEjB,GAAG,EAAE,iBAAiB;IA4BlC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED,IAAI,MAAM,IAAI,YAAY,CAEzB;CACF"}

package/dist/runtime/context.js

@@ -0,0 +1,136 @@
+/**
+ * OpenClaw runtime context adapter
+ *
+ * Adapts OpenClaw's plugin API to BillClaw's runtime abstractions.
+ */
+/**
+ * OpenClaw logger adapter
+ */
+export class OpenClawLogger {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    info(...args) {
+        this.api.logger.info?.(...args);
+    }
+    error(...args) {
+        this.api.logger.error?.(...args);
+    }
+    warn(...args) {
+        this.api.logger.warn?.(...args);
+    }
+    debug(...args) {
+        if (process.env.DEBUG) {
+            this.api.logger.debug?.(...args);
+        }
+    }
+}
+/**
+ * OpenClaw config provider
+ */
+export class OpenClawConfigProvider {
+    api;
+    cachedConfig;
+    constructor(api) {
+        this.api = api;
+    }
+    async getConfig() {
+        if (!this.cachedConfig) {
+            // Get config from OpenClaw's plugin config
+            const config = this.api.pluginConfig;
+            this.cachedConfig = config;
+        }
+        return this.cachedConfig;
+    }
+    async getStorageConfig() {
+        const config = await this.getConfig();
+        return (config.storage || {
+            path: "~/.openclaw/billclaw",
+            format: "json",
+            encryption: { enabled: false },
+        });
+    }
+    async updateAccount(accountId, updates) {
+        // This would need to update OpenClaw's config
+        // For now, just log the update
+        this.api.logger.info?.(`Account ${accountId} updated:`, updates);
+    }
+    async getAccount(accountId) {
+        const config = await this.getConfig();
+        return config.accounts.find((a) => a.id === accountId) || null;
+    }
+}
+/**
+ * OpenClaw event emitter adapter
+ */
+export class OpenClawEventEmitter {
+    listeners = new Map();
+    emit(event, data) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(data);
+                }
+                catch (error) {
+                    console.error(`Error in event handler for ${event}:`, error);
+                }
+            }
+        }
+    }
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+    }
+    off(event, handler) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+        }
+    }
+}
+/**
+ * OpenClaw runtime context
+ */
+export class OpenClawRuntimeContext {
+    _logger;
+    _config;
+    _events;
+    constructor(api) {
+        this._logger = new OpenClawLogger(api);
+        this._config = new OpenClawConfigProvider(api);
+        this._events = new OpenClawEventEmitter();
+        // Define readonly properties at runtime
+        Object.defineProperty(this, "logger", {
+            value: this._logger,
+            writable: false,
+            enumerable: true,
+            configurable: false,
+        });
+        Object.defineProperty(this, "config", {
+            value: this._config,
+            writable: false,
+            enumerable: true,
+            configurable: false,
+        });
+        Object.defineProperty(this, "events", {
+            value: this._events,
+            writable: false,
+            enumerable: true,
+            configurable: false,
+        });
+    }
+    get logger() {
+        return this._logger;
+    }
+    get config() {
+        return this._config;
+    }
+    get events() {
+        return this._events;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/runtime/context.js.map

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

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/services/webhook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-handler.d.ts","sourceRoot":"","sources":["../../src/services/webhook-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAIpE;;GAEG;AACH,UAAU,0BAA0B;IAClC,GAAG,EAAE,iBAAiB,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAgCD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,0BAA0B,GACvC,IAAI,CA+BN"}

package/dist/services/webhook-handler.js

@@ -0,0 +1,176 @@
+/**
+ * Webhook handlers for BillClaw OpenClaw plugin
+ *
+ * This module provides HTTP route handlers for receiving webhooks from
+ * external services (Plaid, GoCardless, etc.) and forwarding them to
+ * configured external webhook endpoints.
+ */
+import { emitEvent, verifySignature } from "@firela/billclaw-core";
+// Global API reference for webhook handlers
+let api = null;
+let configWebhooks = [];
+let plaidWebhookSecret;
+/**
+ * Convert OpenClaw logger to BillClaw Logger interface
+ */
+function toLogger(logger) {
+    // Ensure all methods are defined and callable
+    const log = logger?.info || (() => { });
+    const logError = logger?.error || (() => { });
+    const logWarn = logger?.warn || (() => console.warn);
+    const logDebug = logger?.debug || (() => { });
+    return {
+        info: log,
+        error: logError,
+        warn: logWarn,
+        debug: logDebug,
+    };
+}
+/**
+ * Register webhook handlers with OpenClaw HTTP routes
+ *
+ * This function registers HTTP routes for:
+ * - /webhook/plaid - Plaid webhook handler
+ * - /webhook/gocardless - GoCardless webhook handler
+ * - /webhook/test - Test webhook endpoint
+ */
+export function registerWebhookHandlers(dependencies) {
+    api = dependencies.api;
+    plaidWebhookSecret = dependencies.plaidWebhookSecret;
+    // Get webhooks from config
+    const pluginConfig = api.pluginConfig;
+    configWebhooks = pluginConfig?.webhooks || [];
+    api.logger.info?.("billclaw webhook handler registered");
+    // Register HTTP routes
+    api.http?.register({
+        path: "/webhook/plaid",
+        method: "POST",
+        description: "Plaid webhook handler",
+        handler: handlePlaidWebhook,
+    });
+    api.http?.register({
+        path: "/webhook/gocardless",
+        method: "POST",
+        description: "GoCardless webhook handler",
+        handler: handleGoCardlessWebhook,
+    });
+    api.http?.register({
+        path: "/webhook/test",
+        method: "POST",
+        description: "Test webhook endpoint",
+        handler: handleTestWebhook,
+    });
+}
+/**
+ * Handle Plaid webhook
+ *
+ * Processes webhooks from Plaid:
+ * - TRANSACTIONS/SYNC_UPDATES_AVAILABLE: Trigger sync for the item
+ * - ITEM/ERROR: Emit account.error event
+ * - ITEM/LOGIN_REQUIRED: Notify user to re-authenticate
+ */
+async function handlePlaidWebhook(request) {
+    try {
+        const body = request.body;
+        const webhookType = body.webhook_type;
+        const webhookCode = body.webhook_code;
+        const itemId = body.item_id;
+        api?.logger.info?.(`Received Plaid webhook: ${webhookType}.${webhookCode} for item ${itemId}`);
+        // Verify signature if configured
+        const signature = request.headers["plaid-verification"];
+        const timestamp = request.headers["plaid-timestamp"];
+        if (plaidWebhookSecret && signature && timestamp) {
+            const payload = JSON.stringify(body);
+            if (!verifySignature(payload, signature, plaidWebhookSecret)) {
+                return {
+                    status: 401,
+                    body: { received: false, error: "Invalid signature" },
+                };
+            }
+        }
+        // Handle webhook events
+        switch (webhookType) {
+            case "TRANSACTIONS":
+                if (webhookCode === "SYNC_UPDATES_AVAILABLE") {
+                    // Find the account associated with this item
+                    const pluginConfig = api?.pluginConfig;
+                    const account = pluginConfig?.accounts?.find((acc) => acc.type === "plaid" && acc.plaidItemId === itemId && acc.enabled);
+                    if (account && api) {
+                        // Trigger async sync (don't wait for completion)
+                        const { plaidSyncTool } = await import("../tools/index.js");
+                        plaidSyncTool
+                            .execute(api, { accountId: account.id })
+                            .catch((error) => {
+                            api?.logger.error?.(`Webhook-triggered sync failed:`, error);
+                        });
+                    }
+                }
+                break;
+            case "ITEM":
+                if (webhookCode === "ERROR" || webhookCode === "LOGIN_REQUIRED") {
+                    const error = body.error ?? {
+                        error_code: webhookCode,
+                        error_message: "Item login required",
+                    };
+                    // Emit account error event
+                    await emitEvent(toLogger(api.logger), configWebhooks, "account.error", {
+                        accountId: itemId,
+                        accountType: "plaid",
+                        error: JSON.stringify(error),
+                    }).catch((err) => api?.logger.debug?.(`Event emission failed:`, err));
+                }
+                break;
+        }
+        return { status: 200, body: { received: true } };
+    }
+    catch (error) {
+        api?.logger.error?.(`Error handling Plaid webhook:`, error);
+        return {
+            status: 500,
+            body: { received: false, error: "Internal server error" },
+        };
+    }
+}
+/**
+ * Handle GoCardless webhook
+ *
+ * Processes webhooks from GoCardless (placeholder implementation)
+ */
+async function handleGoCardlessWebhook(_request) {
+    try {
+        api?.logger.info?.("Received GoCardless webhook");
+        // TODO: Implement GoCardless webhook handling
+        // - Verify signature
+        // - Process mandate events
+        // - Trigger sync if needed
+        return { status: 200, body: { received: true } };
+    }
+    catch (error) {
+        api?.logger.error?.(`Error handling GoCardless webhook:`, error);
+        return { status: 500, body: { received: false } };
+    }
+}
+/**
+ * Handle test webhook
+ *
+ * Sends a test event to all configured webhooks to verify connectivity
+ */
+async function handleTestWebhook(_request) {
+    try {
+        api?.logger.info?.("Received test webhook request");
+        // Emit test event to all configured webhooks
+        await emitEvent(toLogger(api.logger), configWebhooks, "webhook.test", {
+            message: "Test webhook from BillClaw",
+            triggeredBy: "user",
+        });
+        return { status: 200, body: { sent: true } };
+    }
+    catch (error) {
+        api?.logger.error?.(`Error handling test webhook:`, error);
+        return {
+            status: 500,
+            body: { sent: false, error: "Internal server error" },
+        };
+    }
+}
+//# sourceMappingURL=webhook-handler.js.map

package/dist/services/webhook-handler.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAYpE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;iBAYL,iBAAiB,UAAU;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;CAgCrE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;iBAkBlB,iBAAiB,UACd;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;CAiChD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;kBAgBhB,iBAAiB,UACf;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;;;CAqB3C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBAkB1B,iBAAiB,UACd;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;CAsClD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAYhB,iBAAiB,WAAW;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;CAoBnE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;kBAYb,iBAAiB,UAAU;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;CAmBlE,CAAA"}

package/dist/tools/index.js

@@ -0,0 +1,253 @@
+/**
+ * OpenClaw tool adapters for BillClaw
+ *
+ * These adapters wrap the core BillClaw functionality to work with
+ * OpenClaw's tool API.
+ */
+import { Billclaw } from "@firela/billclaw-core";
+import { OpenClawRuntimeContext } from "../runtime/context.js";
+/**
+ * Create a BillClaw instance from OpenClaw API
+ */
+function createBillclaw(api) {
+    const runtime = new OpenClawRuntimeContext(api);
+    return new Billclaw(runtime);
+}
+/**
+ * Plaid sync tool
+ */
+export const plaidSyncTool = {
+    name: "plaid_sync",
+    label: "Plaid Sync",
+    description: "Sync transactions from Plaid-connected bank accounts",
+    parameters: {
+        accountId: {
+            type: "string",
+            optional: true,
+            description: "Specific account ID to sync (omits to sync all)",
+        },
+    },
+    async execute(api, params) {
+        const billclaw = createBillclaw(api);
+        const results = await billclaw.syncPlaid(params.accountId ? [params.accountId] : undefined);
+        const totalAdded = results.reduce((sum, r) => sum + r.transactionsAdded, 0);
+        const totalUpdated = results.reduce((sum, r) => sum + r.transactionsUpdated, 0);
+        const errors = results.flatMap((r) => r.errors || []);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: errors.length === 0,
+                        accountsSynced: results.length,
+                        transactionsAdded: totalAdded,
+                        transactionsUpdated: totalUpdated,
+                        errors: errors.length > 0 ? errors : undefined,
+                    }, null, 2),
+                },
+            ],
+        };
+    },
+};
+/**
+ * Gmail fetch bills tool
+ */
+export const gmailFetchTool = {
+    name: "gmail_fetch_bills",
+    label: "Gmail Fetch Bills",
+    description: "Fetch and parse bills from Gmail",
+    parameters: {
+        accountId: {
+            type: "string",
+            optional: true,
+            description: "Specific Gmail account ID to sync (omit for all)",
+        },
+        days: {
+            type: "number",
+            optional: true,
+            description: "Number of days to look back (default: 30)",
+        },
+    },
+    async execute(api, params) {
+        const billclaw = createBillclaw(api);
+        const results = await billclaw.syncGmail(params.accountId ? [params.accountId] : undefined, params.days ?? 30);
+        const totalEmails = results.reduce((sum, r) => sum + r.emailsProcessed, 0);
+        const totalBills = results.reduce((sum, r) => sum + r.billsExtracted, 0);
+        const totalAdded = results.reduce((sum, r) => sum + r.transactionsAdded, 0);
+        const errors = results.flatMap((r) => r.errors || []);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: errors.length === 0,
+                        accountsProcessed: results.length,
+                        emailsProcessed: totalEmails,
+                        billsExtracted: totalBills,
+                        transactionsAdded: totalAdded,
+                        errors: errors.length > 0 ? errors : undefined,
+                    }, null, 2),
+                },
+            ],
+        };
+    },
+};
+/**
+ * Bill parse tool
+ */
+export const billParseTool = {
+    name: "bill_parse",
+    label: "Bill Parse",
+    description: "Parse bill data from various formats (PDF, CSV, email)",
+    parameters: {
+        source: {
+            type: "string",
+            description: "Source type: plaid, gmail, file, or email",
+        },
+        data: {
+            type: "string",
+            description: "Raw data or file path to parse",
+        },
+    },
+    async execute(_api, params) {
+        // This is a stub - the actual implementation would depend on the source type
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: false,
+                        source: params.source,
+                        transactions: [],
+                        errors: ["Bill parsing not yet implemented"],
+                    }, null, 2),
+                },
+            ],
+        };
+    },
+};
+/**
+ * Conversational sync tool
+ */
+export const conversationalSyncTool = {
+    name: "conversational_sync",
+    label: "Conversational Sync",
+    description: "Sync transactions with natural language support",
+    parameters: {
+        prompt: {
+            type: "string",
+            optional: true,
+            description: "Natural language prompt (e.g., 'Sync my accounts')",
+        },
+        accountId: {
+            type: "string",
+            optional: true,
+            description: "Explicit account ID to sync",
+        },
+    },
+    async execute(api, params) {
+        const billclaw = createBillclaw(api);
+        // If accountId is specified, sync that account
+        if (params.accountId) {
+            return plaidSyncTool.execute(api, { accountId: params.accountId });
+        }
+        // Otherwise, sync all due accounts
+        const results = await billclaw.syncDueAccounts();
+        const totalAdded = results.reduce((sum, r) => sum + r.transactionsAdded, 0);
+        const totalUpdated = results.reduce((sum, r) => sum + r.transactionsUpdated, 0);
+        const errors = results.flatMap((r) => r.errors || []);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: errors.length === 0,
+                        accountsSynced: results.length,
+                        transactionsAdded: totalAdded,
+                        transactionsUpdated: totalUpdated,
+                        errors: errors.length > 0 ? errors : undefined,
+                    }, null, 2),
+                },
+            ],
+        };
+    },
+};
+/**
+ * Conversational status tool
+ */
+export const conversationalStatusTool = {
+    name: "conversational_status",
+    label: "Conversational Status",
+    description: "Show account status with natural language",
+    parameters: {
+        prompt: {
+            type: "string",
+            optional: true,
+            description: "Natural language prompt",
+        },
+    },
+    async execute(api, _params) {
+        const billclaw = createBillclaw(api);
+        const accounts = await billclaw.getAccounts();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        accounts,
+                        message: `Found ${accounts.length} configured accounts`,
+                    }, null, 2),
+                },
+            ],
+        };
+    },
+};
+/**
+ * Conversational help tool
+ */
+export const conversationalHelpTool = {
+    name: "conversational_help",
+    label: "Conversational Help",
+    description: "Get help with billclaw commands and features",
+    parameters: {
+        topic: {
+            type: "string",
+            optional: true,
+            description: "Specific help topic (sync, export, webhook, etc.)",
+        },
+    },
+    async execute(_api, params) {
+        const helpText = getHelpText(params.topic);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        topic: params.topic || "general",
+                        help: helpText,
+                    }, null, 2),
+                },
+            ],
+        };
+    },
+};
+/**
+ * Get help text for a topic
+ */
+function getHelpText(topic) {
+    const helps = {
+        sync: "Sync transactions from connected accounts. Use 'bills sync' to manually trigger sync.",
+        export: "Export transactions to Beancount or Ledger format. Configure export options in config.",
+        webhook: "Configure webhooks for real-time transaction updates. Set webhook URL and HMAC secret in config.",
+        setup: "Run 'bills setup' to connect new bank accounts via Plaid Link or Gmail OAuth.",
+    };
+    if (topic && helps[topic]) {
+        return helps[topic];
+    }
+    return `Available commands: bills setup, bills sync, bills status, bills config
+
+Available topics: ${Object.keys(helps).join(", ")}
+
+For more information, visit: https://github.com/fire-la/billclaw`;
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://openclaw.dev/plugin.schema.json",
+  "name": "@firela/billclaw-openclaw",
+  "version": "0.0.1",
+  "description": "Financial data sovereignty plugin - Plaid, Gmail, GoCardless integration",
+  "author": "fire-zu",
+  "license": "MIT",
+  "capabilities": {
+    "tools": [
+      {
+        "name": "plaid_sync",
+        "description": "Sync transactions from Plaid-linked bank accounts"
+      },
+      {
+        "name": "gmail_fetch_bills",
+        "description": "Fetch bill statements from Gmail"
+      },
+      {
+        "name": "bill_parse",
+        "description": "Parse bill documents and extract transaction data"
+      },
+      {
+        "name": "conversational_sync",
+        "description": "Sync transactions with natural language support"
+      },
+      {
+        "name": "conversational_status",
+        "description": "Show account status with natural language"
+      },
+      {
+        "name": "conversational_help",
+        "description": "Get help with billclaw commands and features"
+      }
+    ],
+    "cliCommands": [
+      {
+        "name": "bills",
+        "description": "Manage financial data accounts and sync",
+        "subcommands": ["setup", "sync", "status", "config"]
+      }
+    ],
+    "oauthProviders": [
+      {
+        "name": "plaid",
+        "description": "Plaid Link OAuth flow for bank account linking"
+      },
+      {
+        "name": "gmail",
+        "description": "Gmail OAuth 2.0 flow for accessing email bills"
+      }
+    ],
+    "backgroundServices": [
+      {
+        "name": "billclaw-sync",
+        "description": "Automated transaction sync scheduler"
+      },
+      {
+        "name": "billclaw-webhook",
+        "description": "Webhook handler for bank notifications"
+      }
+    ],
+    "httpRoutes": [
+      {
+        "path": "/webhook/plaid",
+        "method": "POST",
+        "description": "Plaid webhook handler for transaction updates"
+      },
+      {
+        "path": "/webhook/gocardless",
+        "method": "POST",
+        "description": "GoCardless webhook handler for mandate events"
+      }
+    ]
+  },
+  "config": {
+    "schema": "./dist/config.schema.js",
+    "uiHints": "./dist/config-ui-hints.js"
+  }
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@firela/billclaw-openclaw",
+  "version": "0.1.3",
+  "description": "BillClaw OpenClaw Plugin - Adapter for OpenClaw AI framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "financial-data",
+    "plaid",
+    "gocardless",
+    "banking",
+    "transactions",
+    "bills"
+  ],
+  "author": "fire-la",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fire-la/billclaw.git",
+    "directory": "packages/openclaw"
+  },
+  "devDependencies": {
+    "@sinclair/typebox": "^0.34.48",
+    "@types/node": "^25.2.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "openclaw": "^0.0.1",
+    "oxfmt": "^0.1.0",
+    "oxlint": "^0.15.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "plaid": "^32.0.0",
+    "zod": "^3.25.0",
+    "@firela/billclaw-core": "0.1.3"
+  },
+  "peerDependencies": {
+    "openclaw": "^0.0.1"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "oxlint",
+    "format": "oxfmt src/",
+    "format:write": "oxfmt -w src/",
+    "clean": "rm -rf dist"
+  }
+}