@opengauge/openclaw-plugin 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# @opengauge/openclaw-plugin
+
+PromptOps observability for [OpenClaw](https://openclaw.ai) agents. Wraps every LLM provider call via `registerProvider` to give you per-call cost tracking, runaway loop detection, circuit breaker protection, and budget enforcement — without modifying your agent.
+
+## Install
+
+```bash
+openclaw plugins install @opengauge/openclaw-plugin
+```
+
+Or manually:
+
+```bash
+npm install @opengauge/openclaw-plugin
+```
+
+## What it does
+
+Once installed, the plugin transparently wraps your OpenClaw agent's LLM provider:
+
+- **Per-call cost tracking** — every API call logged to `~/.opengauge/data.db` with token counts, cost estimates, and latency
+- **Runaway loop detection** — trigram Jaccard similarity detects when your agent is stuck making the same call repeatedly
+- **Circuit breaker** — optionally blocks calls when runaway loops or budget thresholds are breached
+- **Budget enforcement** — session, daily, and monthly spend limits
+- **Fail-safe** — if anything in OpenGauge fails, your agent is unaffected. Errors are logged to `~/.opengauge/error.log`
+
+## Configuration
+
+Create or edit `~/.opengauge/config.yml`:
+
+```yaml
+openclaw:
+  circuit_breaker:
+    enabled: true
+    similarity_threshold: 0.8
+    max_similar_calls: 5
+    action: warn          # warn | block
+  budget:
+    session_limit_usd: 5.00
+    daily_limit_usd: 20.00
+    monthly_limit_usd: 400.00
+  optimize: false
+  log_response_text: true
+  log_full_request: false
+```
+
+## View stats
+
+From within OpenClaw:
+```
+opengauge-stats
+```
+
+Or from the terminal:
+```bash
+npx opengauge stats --source=openclaw
+```
+
+## How it works
+
+The plugin uses OpenClaw's `registerProvider` API to wrap the active LLM provider. Every individual LLM call — including multi-call tool-use loops within a single agent turn — is intercepted, logged, analyzed, and forwarded. The agent never knows OpenGauge is there.
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+export interface OpenClawCircuitBreakerConfig {
+    enabled: boolean;
+    similarity_threshold: number;
+    max_similar_calls: number;
+    escalation_check: boolean;
+    action: 'warn' | 'block';
+}
+export interface OpenClawBudgetConfig {
+    session_limit_usd: number;
+    daily_limit_usd: number;
+    monthly_limit_usd: number;
+}
+export interface OpenClawPluginConfig {
+    circuit_breaker: OpenClawCircuitBreakerConfig;
+    budget: OpenClawBudgetConfig;
+    optimize: boolean;
+    log_response_text: boolean;
+    log_full_request: boolean;
+    session_timeout_ms: number;
+}
+export declare function loadPluginConfig(): OpenClawPluginConfig;
+export declare function getErrorLogPath(): string;
+export declare function logError(error: unknown): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAqBD,wBAAgB,gBAAgB,IAAI,oBAAoB,CAiCvD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAY7C"}

package/dist/config.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPluginConfig = loadPluginConfig;
+exports.getErrorLogPath = getErrorLogPath;
+exports.logError = logError;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const DEFAULT_CONFIG = {
+    circuit_breaker: {
+        enabled: true,
+        similarity_threshold: 0.8,
+        max_similar_calls: 5,
+        escalation_check: true,
+        action: 'warn',
+    },
+    budget: {
+        session_limit_usd: 5.00,
+        daily_limit_usd: 20.00,
+        monthly_limit_usd: 400.00,
+    },
+    optimize: false,
+    log_response_text: true,
+    log_full_request: false,
+    session_timeout_ms: 5 * 60 * 1000, // 5 minutes
+};
+function loadPluginConfig() {
+    const configPath = path_1.default.join(os_1.default.homedir(), '.opengauge', 'config.yml');
+    try {
+        if (!fs_1.default.existsSync(configPath))
+            return { ...DEFAULT_CONFIG };
+        const raw = fs_1.default.readFileSync(configPath, 'utf-8');
+        try {
+            const yaml = require('js-yaml');
+            const parsed = yaml.load(raw);
+            if (!parsed?.openclaw)
+                return { ...DEFAULT_CONFIG };
+            const oc = parsed.openclaw;
+            return {
+                circuit_breaker: {
+                    ...DEFAULT_CONFIG.circuit_breaker,
+                    ...oc.circuit_breaker,
+                },
+                budget: {
+                    ...DEFAULT_CONFIG.budget,
+                    ...oc.budget,
+                },
+                optimize: oc.optimize ?? DEFAULT_CONFIG.optimize,
+                log_response_text: oc.log_response_text ?? DEFAULT_CONFIG.log_response_text,
+                log_full_request: oc.log_full_request ?? DEFAULT_CONFIG.log_full_request,
+                session_timeout_ms: oc.session_timeout_ms ?? DEFAULT_CONFIG.session_timeout_ms,
+            };
+        }
+        catch {
+            return { ...DEFAULT_CONFIG };
+        }
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+function getErrorLogPath() {
+    return path_1.default.join(os_1.default.homedir(), '.opengauge', 'error.log');
+}
+function logError(error) {
+    try {
+        const logPath = getErrorLogPath();
+        const dir = path_1.default.dirname(logPath);
+        if (!fs_1.default.existsSync(dir))
+            fs_1.default.mkdirSync(dir, { recursive: true });
+        const timestamp = new Date().toISOString();
+        const message = error instanceof Error ? error.stack || error.message : String(error);
+        fs_1.default.appendFileSync(logPath, `[${timestamp}] ${message}\n`);
+    }
+    catch {
+        // If we can't even write error logs, silently fail
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @opengauge/openclaw-plugin
+ *
+ * OpenClaw plugin that wraps every LLM provider call via registerProvider,
+ * logging every individual API call to @opengauge/core's SQLite database.
+ *
+ * Features:
+ *   - Per-call cost tracking
+ *   - Runaway loop detection (circuit breaker)
+ *   - Budget enforcement (session/daily/monthly)
+ *   - Fail-safe: never crashes the agent
+ *
+ * Install: openclaw plugins install @opengauge/openclaw-plugin
+ */
+import { type OpenClawProvider } from './wrapped-provider';
+/**
+ * OpenClaw plugin API interface (minimal — matches registerProvider + registerCommand).
+ */
+interface OpenClawPluginAPI {
+    registerProvider(provider: any): void;
+    registerCommand?(name: string, handler: (args: string[]) => Promise<string | void>): void;
+    getProvider?(): OpenClawProvider;
+    on?(event: string, handler: (...args: any[]) => void): void;
+}
+/**
+ * Plugin entry point — called by OpenClaw when the plugin is loaded.
+ */
+export declare function register(api: OpenClawPluginAPI): void;
+/**
+ * Plugin metadata for OpenClaw's plugin system.
+ */
+export declare const metadata: {
+    name: string;
+    npm: string;
+    version: string;
+    description: string;
+    author: string;
+};
+export {};
+//# 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":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG5E;;GAEG;AACH,UAAU,iBAAiB;IACzB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IACtC,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1F,WAAW,CAAC,IAAI,gBAAgB,CAAC;IACjC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7D;AAID;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA8DrD;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAC"}

package/dist/index.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * @opengauge/openclaw-plugin
+ *
+ * OpenClaw plugin that wraps every LLM provider call via registerProvider,
+ * logging every individual API call to @opengauge/core's SQLite database.
+ *
+ * Features:
+ *   - Per-call cost tracking
+ *   - Runaway loop detection (circuit breaker)
+ *   - Budget enforcement (session/daily/monthly)
+ *   - Fail-safe: never crashes the agent
+ *
+ * Install: openclaw plugins install @opengauge/openclaw-plugin
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metadata = void 0;
+exports.register = register;
+const core_1 = require("opengauge/core");
+const wrapped_provider_1 = require("./wrapped-provider");
+const config_1 = require("./config");
+let wrappedProvider = null;
+/**
+ * Plugin entry point — called by OpenClaw when the plugin is loaded.
+ */
+function register(api) {
+    try {
+        // Initialize database
+        const db = (0, core_1.getDb)();
+        (0, core_1.initSchema)(db);
+        const config = (0, config_1.loadPluginConfig)();
+        // Get the current provider and wrap it
+        const realProvider = api.getProvider?.();
+        if (!realProvider) {
+            (0, config_1.logError)(new Error('OpenGauge: Could not get current provider from OpenClaw API'));
+            return;
+        }
+        wrappedProvider = new wrapped_provider_1.WrappedProvider(realProvider, config);
+        // Register the wrapped provider
+        api.registerProvider(wrappedProvider);
+        // Register optional stats command
+        if (api.registerCommand) {
+            api.registerCommand('opengauge-stats', async (args) => {
+                try {
+                    const queries = new core_1.SessionQueries((0, core_1.getDb)());
+                    const summary = queries.getSpendSummary();
+                    const alerts = queries.queryAlerts({ dismissed: false, limit: 5 });
+                    const lines = [
+                        '--- OpenGauge Stats ---',
+                        `Sessions: ${summary.session_count}`,
+                        `Total spend: $${summary.total_cost_usd.toFixed(4)}`,
+                        `Tokens: ${summary.total_tokens_in.toLocaleString()} in / ${summary.total_tokens_out.toLocaleString()} out`,
+                        `Tokens saved: ${summary.total_tokens_saved.toLocaleString()}`,
+                    ];
+                    if (alerts.length > 0) {
+                        lines.push('', '--- Active Alerts ---');
+                        for (const alert of alerts) {
+                            lines.push(`[${alert.severity.toUpperCase()}] ${alert.alert_type}: ${alert.message}`);
+                        }
+                    }
+                    return lines.join('\n');
+                }
+                catch (e) {
+                    (0, config_1.logError)(e);
+                    return 'OpenGauge: Failed to fetch stats. Check ~/.opengauge/error.log';
+                }
+            });
+        }
+        // Listen for shutdown to finalize session
+        if (api.on) {
+            api.on('gateway_stop', () => {
+                wrappedProvider?.shutdown();
+            });
+        }
+    }
+    catch (error) {
+        // Fail-safe: plugin must never crash OpenClaw
+        (0, config_1.logError)(error);
+    }
+}
+/**
+ * Plugin metadata for OpenClaw's plugin system.
+ */
+exports.metadata = {
+    name: '@opengauge/openclaw-plugin',
+    npm: '@opengauge/openclaw-plugin',
+    version: '0.1.0',
+    description: 'Cost tracking, runaway loop detection, and budget enforcement for OpenClaw agents',
+    author: 'OpenGauge',
+};
+//# 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/wrapped-provider.d.ts

@@ -0,0 +1,66 @@
+import { OpenClawPluginConfig } from './config';
+/**
+ * OpenClaw provider interface (minimal — matches what registerProvider expects).
+ */
+export interface OpenClawProviderRequest {
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    model?: string;
+    max_tokens?: number;
+    temperature?: number;
+    stream?: boolean;
+    [key: string]: any;
+}
+export interface OpenClawProviderResponse {
+    content: string;
+    model: string;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        prompt_tokens?: number;
+        completion_tokens?: number;
+    };
+    [key: string]: any;
+}
+export interface OpenClawProvider {
+    name: string;
+    defaultModel?: string;
+    chat(request: OpenClawProviderRequest): Promise<OpenClawProviderResponse>;
+    chatStream?(request: OpenClawProviderRequest): AsyncIterable<any>;
+}
+export declare class WrappedProvider {
+    private realProvider;
+    private config;
+    private queries;
+    private session;
+    constructor(realProvider: OpenClawProvider, config: OpenClawPluginConfig);
+    get name(): string;
+    get defaultModel(): string | undefined;
+    /**
+     * Ensure we have an active session, creating one if needed or if timed out.
+     */
+    private ensureSession;
+    /**
+     * Run circuit breaker checks. Returns a block message if the call should be stopped.
+     */
+    private runCircuitBreaker;
+    /**
+     * Check budget thresholds. Returns a block message if budget is breached.
+     */
+    private checkBudget;
+    /**
+     * Main chat wrapper — intercepts every LLM call.
+     */
+    chat(request: OpenClawProviderRequest): Promise<OpenClawProviderResponse>;
+    /**
+     * Stream wrapper — logs the complete interaction after stream completes.
+     */
+    chatStream(request: OpenClawProviderRequest): AsyncIterable<any>;
+    /**
+     * Finalize the current session (called on plugin shutdown).
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=wrapped-provider.d.ts.map

package/dist/wrapped-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapped-provider.d.ts","sourceRoot":"","sources":["../src/wrapped-provider.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAY,MAAM,UAAU,CAAC;AAc1D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC1E,UAAU,CAAC,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;CACnE;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAA6B;gBAEhC,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,oBAAoB;IAMxE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAyCrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwCzB;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA4F/E;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa,CAAC,GAAG,CAAC;IA+EvE;;OAEG;IACH,QAAQ,IAAI,IAAI;CAQjB"}

package/dist/wrapped-provider.js

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WrappedProvider = void 0;
+const core_1 = require("opengauge/core");
+const config_1 = require("./config");
+class WrappedProvider {
+    realProvider;
+    config;
+    queries;
+    session = null;
+    constructor(realProvider, config) {
+        this.realProvider = realProvider;
+        this.config = config;
+        this.queries = new core_1.SessionQueries((0, core_1.getDb)());
+    }
+    get name() {
+        return this.realProvider.name;
+    }
+    get defaultModel() {
+        return this.realProvider.defaultModel;
+    }
+    /**
+     * Ensure we have an active session, creating one if needed or if timed out.
+     */
+    ensureSession(model) {
+        const now = Date.now();
+        if (this.session && (now - this.session.lastCallTimestamp) > this.config.session_timeout_ms) {
+            try {
+                this.queries.finalizeSession(this.session.sessionId);
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+            }
+            this.session = null;
+        }
+        if (!this.session) {
+            try {
+                const record = this.queries.createSession('openclaw', model, this.realProvider.name);
+                this.session = {
+                    sessionId: record.id,
+                    interactionCount: 0,
+                    runningCostUsd: 0,
+                    lastCallTimestamp: now,
+                    recentInteractions: [],
+                    contextDepthTokens: 0,
+                };
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+                this.session = {
+                    sessionId: `fallback-${now}`,
+                    interactionCount: 0,
+                    runningCostUsd: 0,
+                    lastCallTimestamp: now,
+                    recentInteractions: [],
+                    contextDepthTokens: 0,
+                };
+            }
+        }
+        return this.session;
+    }
+    /**
+     * Run circuit breaker checks. Returns a block message if the call should be stopped.
+     */
+    runCircuitBreaker(session) {
+        if (!this.config.circuit_breaker.enabled)
+            return null;
+        const verdict = (0, core_1.checkRunawayLoop)(session.recentInteractions, {
+            similarityThreshold: this.config.circuit_breaker.similarity_threshold,
+            tripPairCount: this.config.circuit_breaker.max_similar_calls,
+            warningPairCount: Math.max(2, this.config.circuit_breaker.max_similar_calls - 2),
+        });
+        if (verdict.verdict === 'trip') {
+            const msg = `OpenGauge circuit breaker: ${verdict.reason}. Session cost: $${session.runningCostUsd.toFixed(2)}. Stopping to prevent runaway spend.`;
+            try {
+                this.queries.writeAlert(session.sessionId, 'runaway_loop', 'critical', msg, { ...verdict, sessionCost: session.runningCostUsd });
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+            }
+            if (this.config.circuit_breaker.action === 'block') {
+                return msg;
+            }
+        }
+        else if (verdict.verdict === 'warning') {
+            try {
+                this.queries.writeAlert(session.sessionId, 'runaway_loop', 'warning', verdict.reason, verdict);
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+            }
+        }
+        return null;
+    }
+    /**
+     * Check budget thresholds. Returns a block message if budget is breached.
+     */
+    checkBudget(session) {
+        if (session.runningCostUsd >= this.config.budget.session_limit_usd) {
+            const msg = `OpenGauge budget: Session cost ($${session.runningCostUsd.toFixed(2)}) exceeds limit ($${this.config.budget.session_limit_usd.toFixed(2)}).`;
+            try {
+                this.queries.writeAlert(session.sessionId, 'budget_breach', 'critical', msg, {
+                    sessionCost: session.runningCostUsd,
+                    limit: this.config.budget.session_limit_usd,
+                });
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+            }
+            if (this.config.circuit_breaker.action === 'block')
+                return msg;
+        }
+        try {
+            const todayStart = new Date();
+            todayStart.setHours(0, 0, 0, 0);
+            const summary = this.queries.getSpendSummary(todayStart.getTime(), 'openclaw');
+            if (summary.total_cost_usd >= this.config.budget.daily_limit_usd) {
+                const msg = `OpenGauge budget: Daily spend ($${summary.total_cost_usd.toFixed(2)}) exceeds limit ($${this.config.budget.daily_limit_usd.toFixed(2)}).`;
+                this.queries.writeAlert(session.sessionId, 'budget_breach', 'critical', msg, {
+                    dailyCost: summary.total_cost_usd,
+                    limit: this.config.budget.daily_limit_usd,
+                });
+                if (this.config.circuit_breaker.action === 'block')
+                    return msg;
+            }
+        }
+        catch (e) {
+            (0, config_1.logError)(e);
+        }
+        return null;
+    }
+    /**
+     * Main chat wrapper — intercepts every LLM call.
+     */
+    async chat(request) {
+        const model = request.model || this.realProvider.defaultModel || 'unknown';
+        const session = this.ensureSession(model);
+        const startTime = Date.now();
+        try {
+            const lastUserMsg = [...request.messages].reverse().find(m => m.role === 'user');
+            const originalPrompt = lastUserMsg?.content || '';
+            const blockMsg = this.runCircuitBreaker(session);
+            if (blockMsg) {
+                return {
+                    content: blockMsg,
+                    model,
+                    usage: { input_tokens: 0, output_tokens: 0 },
+                };
+            }
+            const budgetMsg = this.checkBudget(session);
+            if (budgetMsg) {
+                return {
+                    content: budgetMsg,
+                    model,
+                    usage: { input_tokens: 0, output_tokens: 0 },
+                };
+            }
+            const response = await this.realProvider.chat(request);
+            const latencyMs = Date.now() - startTime;
+            const tokensIn = response.usage?.input_tokens || response.usage?.prompt_tokens || 0;
+            const tokensOut = response.usage?.output_tokens || response.usage?.completion_tokens || 0;
+            const costEstimate = (0, core_1.calculateCost)(this.realProvider.name, model, tokensIn, tokensOut);
+            session.interactionCount++;
+            session.runningCostUsd += costEstimate.totalCost;
+            session.lastCallTimestamp = Date.now();
+            session.contextDepthTokens += tokensIn;
+            session.recentInteractions.push({
+                role: 'user',
+                content: originalPrompt,
+                timestamp: startTime,
+            });
+            session.recentInteractions.push({
+                role: 'assistant',
+                content: response.content,
+                timestamp: Date.now(),
+            });
+            if (session.recentInteractions.length > 40) {
+                session.recentInteractions = session.recentInteractions.slice(-40);
+            }
+            try {
+                this.queries.writeInteraction(session.sessionId, session.interactionCount, model, {
+                    originalPrompt,
+                    responseText: this.config.log_response_text ? response.content : undefined,
+                    tokensIn,
+                    tokensOut,
+                    costUsd: costEstimate.totalCost,
+                    latencyMs,
+                    contextDepthTokens: session.contextDepthTokens,
+                    metadata: this.config.log_full_request ? { messages: request.messages } : undefined,
+                });
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+            }
+            try {
+                this.queries.updateSessionAggregates(session.sessionId, tokensIn, tokensOut, costEstimate.totalCost);
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+            }
+            return response;
+        }
+        catch (error) {
+            (0, config_1.logError)(error);
+            try {
+                return await this.realProvider.chat(request);
+            }
+            catch (providerError) {
+                throw providerError;
+            }
+        }
+    }
+    /**
+     * Stream wrapper — logs the complete interaction after stream completes.
+     */
+    async *chatStream(request) {
+        if (!this.realProvider.chatStream) {
+            const response = await this.chat(request);
+            yield { content: response.content, done: true, ...response.usage };
+            return;
+        }
+        const model = request.model || this.realProvider.defaultModel || 'unknown';
+        const session = this.ensureSession(model);
+        const startTime = Date.now();
+        const lastUserMsg = [...request.messages].reverse().find(m => m.role === 'user');
+        const originalPrompt = lastUserMsg?.content || '';
+        try {
+            const blockMsg = this.runCircuitBreaker(session);
+            if (blockMsg) {
+                yield { content: blockMsg, done: true };
+                return;
+            }
+            const budgetMsg = this.checkBudget(session);
+            if (budgetMsg) {
+                yield { content: budgetMsg, done: true };
+                return;
+            }
+        }
+        catch (e) {
+            (0, config_1.logError)(e);
+        }
+        let fullContent = '';
+        let finalTokensIn = 0;
+        let finalTokensOut = 0;
+        try {
+            for await (const chunk of this.realProvider.chatStream(request)) {
+                if (chunk.content)
+                    fullContent += chunk.content;
+                if (chunk.input_tokens || chunk.prompt_tokens) {
+                    finalTokensIn = chunk.input_tokens || chunk.prompt_tokens || finalTokensIn;
+                }
+                if (chunk.output_tokens || chunk.completion_tokens) {
+                    finalTokensOut = chunk.output_tokens || chunk.completion_tokens || finalTokensOut;
+                }
+                yield chunk;
+            }
+        }
+        catch (error) {
+            (0, config_1.logError)(error);
+            throw error;
+        }
+        try {
+            const latencyMs = Date.now() - startTime;
+            const costEstimate = (0, core_1.calculateCost)(this.realProvider.name, model, finalTokensIn, finalTokensOut);
+            session.interactionCount++;
+            session.runningCostUsd += costEstimate.totalCost;
+            session.lastCallTimestamp = Date.now();
+            session.contextDepthTokens += finalTokensIn;
+            session.recentInteractions.push({ role: 'user', content: originalPrompt, timestamp: startTime }, { role: 'assistant', content: fullContent, timestamp: Date.now() });
+            if (session.recentInteractions.length > 40) {
+                session.recentInteractions = session.recentInteractions.slice(-40);
+            }
+            this.queries.writeInteraction(session.sessionId, session.interactionCount, model, {
+                originalPrompt,
+                responseText: this.config.log_response_text ? fullContent : undefined,
+                tokensIn: finalTokensIn,
+                tokensOut: finalTokensOut,
+                costUsd: costEstimate.totalCost,
+                latencyMs,
+                contextDepthTokens: session.contextDepthTokens,
+            });
+            this.queries.updateSessionAggregates(session.sessionId, finalTokensIn, finalTokensOut, costEstimate.totalCost);
+        }
+        catch (e) {
+            (0, config_1.logError)(e);
+        }
+    }
+    /**
+     * Finalize the current session (called on plugin shutdown).
+     */
+    shutdown() {
+        if (this.session) {
+            try {
+                this.queries.finalizeSession(this.session.sessionId);
+            }
+            catch (e) {
+                (0, config_1.logError)(e);
+            }
+            this.session = null;
+        }
+    }
+}
+exports.WrappedProvider = WrappedProvider;
+//# sourceMappingURL=wrapped-provider.js.map

package/dist/wrapped-provider.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "@opengauge/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "PromptOps observability for OpenClaw: per-call cost tracking, runaway loop detection, circuit breaker, and budget enforcement",
+  "author": "OpenGauge / Vega IoT",
+  "license": "MIT",
+  "entry": "dist/index.js",
+  "capabilities": ["registerProvider", "registerCommand"],
+  "config_schema": {
+    "circuit_breaker.enabled": { "type": "boolean", "default": true },
+    "circuit_breaker.similarity_threshold": { "type": "number", "default": 0.8 },
+    "circuit_breaker.max_similar_calls": { "type": "number", "default": 5 },
+    "circuit_breaker.action": { "type": "string", "enum": ["warn", "block"], "default": "warn" },
+    "budget.session_limit_usd": { "type": "number", "default": 5.0 },
+    "budget.daily_limit_usd": { "type": "number", "default": 20.0 },
+    "budget.monthly_limit_usd": { "type": "number", "default": 400.0 },
+    "optimize": { "type": "boolean", "default": false }
+  },
+  "keywords": ["observability", "cost-tracking", "circuit-breaker", "promptops"]
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@opengauge/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "PromptOps observability for OpenClaw: per-call cost tracking, runaway loop detection, circuit breaker, and budget enforcement",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "prepack": "npm run build"
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "keywords": [
+    "openclaw",
+    "opengauge",
+    "promptops",
+    "observability",
+    "cost-tracking",
+    "circuit-breaker",
+    "llm",
+    "ai-agent"
+  ],
+  "author": "OpenGauge / Vega IoT",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/applytorque/opengauge",
+    "directory": "packages/openclaw-plugin"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0",
+    "opengauge": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.13.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}