@feeble/blay-openclaw-plugin 0.1.17

package/dist/channel/sse-client.js

@@ -0,0 +1,154 @@
+/**
+ * Minimal SSE Client for Node.js
+ *
+ * Connects to a Server-Sent Events endpoint using fetch streams.
+ * Handles reconnection with exponential backoff.
+ * No external dependencies — uses Node.js built-in fetch.
+ */
+export class SSEClient {
+    abortController = null;
+    reconnectDelay;
+    maxReconnectDelay;
+    currentDelay;
+    running = false;
+    options;
+    lastEventId;
+    /**
+     * Generation counter — incremented on every stop(). Prevents stale
+     * reconnection chains from forking when stop() + start() is called
+     * while a reconnection sleep is in progress.
+     */
+    generation = 0;
+    constructor(options) {
+        this.options = options;
+        this.reconnectDelay = options.reconnectDelay ?? 1000;
+        this.maxReconnectDelay = options.maxReconnectDelay ?? 30000;
+        this.currentDelay = this.reconnectDelay;
+    }
+    /**
+     * Start the SSE connection. Reconnects automatically on failure.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.connectWithGen(this.generation);
+    }
+    /**
+     * Stop the SSE connection permanently.
+     */
+    stop() {
+        this.running = false;
+        this.generation++; // Invalidate any pending reconnection chains
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+    }
+    async connectWithGen(gen) {
+        if (!this.running || gen !== this.generation)
+            return;
+        this.abortController = new AbortController();
+        try {
+            const response = await fetch(this.options.url, {
+                method: "GET",
+                headers: {
+                    Accept: "text/event-stream",
+                    "Cache-Control": "no-cache",
+                    ...this.options.headers,
+                    ...(this.lastEventId ? { "Last-Event-ID": this.lastEventId } : {}),
+                },
+                signal: this.abortController.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`SSE connection failed: HTTP ${response.status}`);
+            }
+            if (!response.body) {
+                throw new Error("SSE response has no body");
+            }
+            // Reset reconnect delay on successful connection
+            this.currentDelay = this.reconnectDelay;
+            this.options.onConnected?.();
+            // Read the stream
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            while (this.running && gen === this.generation) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // Parse complete SSE events from buffer
+                const events = this.parseEvents(buffer);
+                buffer = events.remainder;
+                for (const event of events.parsed) {
+                    if (event.id) {
+                        this.lastEventId = event.id;
+                    }
+                    try {
+                        this.options.onEvent(event);
+                    }
+                    catch (err) {
+                        this.options.onError?.(err instanceof Error ? err : new Error(String(err)));
+                    }
+                }
+            }
+        }
+        catch (err) {
+            // Ignore abort errors (intentional disconnect)
+            if (err instanceof Error && err.name === "AbortError") {
+                return;
+            }
+            this.options.onError?.(err instanceof Error ? err : new Error(String(err)));
+        }
+        // Don't fire callbacks or reconnect if this generation was invalidated
+        if (gen !== this.generation)
+            return;
+        this.options.onDisconnected?.();
+        // Reconnect if still running and generation hasn't changed
+        if (this.running && gen === this.generation) {
+            const delay = this.currentDelay;
+            this.currentDelay = Math.min(this.currentDelay * 2, this.maxReconnectDelay);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            this.connectWithGen(gen);
+        }
+    }
+    /**
+     * Parse SSE events from a text buffer.
+     * Returns parsed events and the remaining unparsed text.
+     */
+    parseEvents(buffer) {
+        const parsed = [];
+        // SSE events are separated by double newlines
+        const parts = buffer.split("\n\n");
+        // The last part may be incomplete
+        const remainder = parts.pop() ?? "";
+        for (const part of parts) {
+            const trimmed = part.trim();
+            if (!trimmed)
+                continue;
+            let event = "";
+            let data = "";
+            let id;
+            for (const line of trimmed.split("\n")) {
+                if (line.startsWith("event: ")) {
+                    event = line.slice(7);
+                }
+                else if (line.startsWith("data: ")) {
+                    data += (data ? "\n" : "") + line.slice(6);
+                }
+                else if (line.startsWith("id: ")) {
+                    id = line.slice(4);
+                }
+                else if (line.startsWith(":")) {
+                    // Comment, ignore
+                }
+            }
+            if (data || event) {
+                parsed.push({ event: event || "message", data, id });
+            }
+        }
+        return { parsed, remainder };
+    }
+}
+//# sourceMappingURL=sse-client.js.map

package/dist/channel/sse-client.js.map

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

package/dist/channel/state.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared state — holds the BlayClient reference for use by channel modules.
+ */
+import type { BlayClient } from "../client.js";
+export declare function setBlayClient(client: BlayClient): void;
+export declare function getBlayClient(): BlayClient | null;

package/dist/channel/state.js

@@ -0,0 +1,11 @@
+/**
+ * Shared state — holds the BlayClient reference for use by channel modules.
+ */
+let _client = null;
+export function setBlayClient(client) {
+    _client = client;
+}
+export function getBlayClient() {
+    return _client;
+}
+//# sourceMappingURL=state.js.map

package/dist/channel/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/channel/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,IAAI,OAAO,GAAsB,IAAI,CAAC;AAEtC,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * HTTP client for the Blay REST API.
+ *
+ * Class-based wrapper around fetch with Bearer token auth.
+ * All tools use this to call the API.
+ */
+import type { ApiResponse, BlayPluginConfig } from "./types.js";
+export declare const DEFAULT_BASE_URL = "https://api.blay.io";
+export declare class BlayClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: BlayPluginConfig);
+    private headers;
+    private fetchWithTimeout;
+    get<T = unknown>(path: string, params?: Record<string, string | undefined>): Promise<ApiResponse<T>>;
+    post<T = unknown>(path: string, body?: Record<string, unknown>): Promise<ApiResponse<T>>;
+    patch<T = unknown>(path: string, body: Record<string, unknown>): Promise<ApiResponse<T>>;
+    del<T = unknown>(path: string): Promise<ApiResponse<T>>;
+}
+/**
+ * Format an API error response into an actionable message for the AI.
+ */
+export declare function formatError(res: ApiResponse): string;

package/dist/client.js

@@ -0,0 +1,98 @@
+/**
+ * HTTP client for the Blay REST API.
+ *
+ * Class-based wrapper around fetch with Bearer token auth.
+ * All tools use this to call the API.
+ */
+export const DEFAULT_BASE_URL = "https://api.blay.io";
+export class BlayClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = (config.apiUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+        this.apiKey = config.apiKey;
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+    }
+    async fetchWithTimeout(url, init, timeoutMs = 15_000) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async get(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const res = await this.fetchWithTimeout(url.toString(), {
+            method: "GET",
+            headers: this.headers(),
+        });
+        const data = (await res.json());
+        return { ok: res.ok, status: res.status, data };
+    }
+    async post(path, body) {
+        const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.headers(),
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const data = (await res.json());
+        return { ok: res.ok, status: res.status, data };
+    }
+    async patch(path, body) {
+        const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+            method: "PATCH",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        const data = (await res.json());
+        return { ok: res.ok, status: res.status, data };
+    }
+    async del(path) {
+        const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+            method: "DELETE",
+            headers: this.headers(),
+        });
+        const data = (await res.json());
+        return { ok: res.ok, status: res.status, data };
+    }
+}
+/**
+ * Format an API error response into an actionable message for the AI.
+ */
+export function formatError(res) {
+    const detail = res.data && typeof res.data === "object" && "message" in res.data
+        ? String(res.data.message)
+        : undefined;
+    switch (res.status) {
+        case 401:
+            return "Authentication failed. The API key may be invalid or expired.";
+        case 403:
+            return "Permission denied. You don't have access to this resource.";
+        case 404:
+            return "Not found. The ID may be incorrect — use search or list tools to find the right one.";
+        case 400:
+        case 422:
+            return `Invalid input${detail ? `: ${detail}` : ". Check the parameters and try again."}`;
+        default:
+            if (res.status >= 500) {
+                return "Server error. Try again in a moment.";
+            }
+            return detail ?? `Request failed (HTTP ${res.status}).`;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Blay OpenClaw Plugin — Entry Point
+ *
+ * Registers Blay as a native OpenClaw channel and provides 21 tools
+ * for the agent to interact with the Blay platform.
+ *
+ * Architecture:
+ * - Channel: Blay is registered as a native channel via registerChannel().
+ *   Inbound events arrive via a persistent SSE connection to the Blay API.
+ *   Agent responses are automatically delivered as Blay comments.
+ * - Tools: blay_* tools give the agent direct API access for reading/writing
+ *   Blay data (projects, tasks, comments, etc.)
+ * - Webhook: HTTP route still available as fallback for webhook-based delivery.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export default function register(api: OpenClawPluginApi): void;

package/dist/index.js

@@ -0,0 +1,228 @@
+/**
+ * Blay OpenClaw Plugin — Entry Point
+ *
+ * Registers Blay as a native OpenClaw channel and provides 21 tools
+ * for the agent to interact with the Blay platform.
+ *
+ * Architecture:
+ * - Channel: Blay is registered as a native channel via registerChannel().
+ *   Inbound events arrive via a persistent SSE connection to the Blay API.
+ *   Agent responses are automatically delivered as Blay comments.
+ * - Tools: blay_* tools give the agent direct API access for reading/writing
+ *   Blay data (projects, tasks, comments, etc.)
+ * - Webhook: HTTP route still available as fallback for webhook-based delivery.
+ */
+import { BlayClient } from "./client.js";
+// Channel
+import { setBlayRuntime } from "./channel/runtime.js";
+import { setBlayClient } from "./channel/state.js";
+import { createBlayChannelPlugin, getGatewayPort, getGatewayBind, getGatewayToken } from "./channel/plugin.js";
+// Tools
+import { createBriefingTool } from "./tools/briefing.js";
+import { createOrgOverviewTool } from "./tools/org.js";
+import { createListUsersTool } from "./tools/users.js";
+import { createListProjectsTool, createGetProjectTool, createCreateProjectTool, createUpdateProjectTool, } from "./tools/projects.js";
+import { createListTasksTool, createGetTaskTool, createCreateTaskTool, createUpdateTaskTool, createDeleteTaskTool, } from "./tools/tasks.js";
+import { createListCommentsTool, createPostCommentTool } from "./tools/comments.js";
+import { createGetContextTool } from "./tools/context.js";
+import { createListActionItemsTool, createCreateActionItemTool, createUpdateActionItemTool, } from "./tools/action-items.js";
+import { createSearchTool } from "./tools/search.js";
+import { createListNotificationsTool, createMarkNotificationReadTool } from "./tools/notifications.js";
+// Instrumentation
+import { instrumentTool, truncate } from "./tools/instrumentation.js";
+import { getCurrentRunTracker } from "./channel/run-tracker.js";
+// Abort
+import { isAborted } from "./channel/abort.js";
+// Telemetry
+import { TelemetryPusher, setTelemetryPusher, getTelemetryPusher } from "./telemetry/pusher.js";
+import { UsageCollector, setUsageCollector } from "./telemetry/usage-collector.js";
+// Webhook (fallback)
+import { createWebhookHandler } from "./webhook/handler.js";
+export default function register(api) {
+    const config = (api.pluginConfig ?? {});
+    if (!config.apiKey) {
+        console.warn("[blay] No apiKey configured — plugin loaded but inactive. Add your API key to plugins.entries.blay-openclaw-plugin.config.apiKey in openclaw.json");
+        return;
+    }
+    const client = new BlayClient(config);
+    // Store runtime and client references for channel adapters
+    setBlayRuntime(api.runtime);
+    setBlayClient(client);
+    // ── Register Blay as a native channel (SSE-based) ─────────────────
+    const channelPlugin = createBlayChannelPlugin(client, config);
+    api.registerChannel({ plugin: channelPlugin });
+    // ── Register webhook HTTP route (fallback) ─────────────────────────
+    api.registerHttpRoute({
+        path: "/plugins/blay/webhook",
+        handler: createWebhookHandler(config),
+    });
+    // ── Register all 21 tools (instrumented for run tracking) ────────
+    api.registerTool(instrumentTool(createBriefingTool(client)));
+    api.registerTool(instrumentTool(createOrgOverviewTool(client)));
+    api.registerTool(instrumentTool(createListUsersTool(client)));
+    api.registerTool(instrumentTool(createListProjectsTool(client)));
+    api.registerTool(instrumentTool(createGetProjectTool(client)));
+    api.registerTool(instrumentTool(createCreateProjectTool(client)));
+    api.registerTool(instrumentTool(createUpdateProjectTool(client)));
+    api.registerTool(instrumentTool(createListTasksTool(client)));
+    api.registerTool(instrumentTool(createGetTaskTool(client)));
+    api.registerTool(instrumentTool(createCreateTaskTool(client)));
+    api.registerTool(instrumentTool(createUpdateTaskTool(client)));
+    api.registerTool(instrumentTool(createDeleteTaskTool(client)));
+    api.registerTool(instrumentTool(createListCommentsTool(client)));
+    api.registerTool(instrumentTool(createPostCommentTool(client)));
+    api.registerTool(instrumentTool(createGetContextTool(client)));
+    api.registerTool(instrumentTool(createListActionItemsTool(client)));
+    api.registerTool(instrumentTool(createCreateActionItemTool(client)));
+    api.registerTool(instrumentTool(createUpdateActionItemTool(client)));
+    api.registerTool(instrumentTool(createSearchTool(client)));
+    api.registerTool(instrumentTool(createListNotificationsTool(client)));
+    api.registerTool(instrumentTool(createMarkNotificationReadTool(client)));
+    // ── Telemetry: UsageCollector + TelemetryPusher ──────────────────
+    const usageCollector = new UsageCollector();
+    setUsageCollector(usageCollector);
+    const telemetryPusher = new TelemetryPusher({
+        client,
+        runtime: api.runtime,
+    });
+    setTelemetryPusher(telemetryPusher);
+    // Subscribe to agent_end hook to capture model usage from messages.
+    // The diagnostic_event approach doesn't work due to bundle-level
+    // module duplication (the gateway emits to a different listeners set).
+    // Instead we inspect the messages array from agent_end for usage metadata.
+    api.on("agent_end", (event, _ctx) => {
+        if (!event.messages || !Array.isArray(event.messages))
+            return;
+        // Only process messages added during this run (skip session history)
+        const offset = usageCollector.getRunStartMessageCount();
+        const newMessages = event.messages.slice(offset);
+        let totalInput = 0;
+        let totalOutput = 0;
+        let totalCost = 0;
+        for (const rawMsg of newMessages) {
+            const raw = rawMsg;
+            // Messages may be wrapped in an envelope { type, id, message: { role, usage, ... } }
+            // or may be the inner message directly { role, usage, ... }
+            const m = (raw.message && typeof raw.message === "object" ? raw.message : raw);
+            if (m.role !== "assistant" || !m.usage || typeof m.usage !== "object")
+                continue;
+            const usage = m.usage;
+            const inputTokens = usage.input ?? usage.input_tokens ?? 0;
+            const outputTokens = usage.output ?? usage.output_tokens ?? 0;
+            const cacheRead = usage.cacheRead ?? 0;
+            const cacheWrite = usage.cacheWrite ?? 0;
+            // Use provider's cost.total directly
+            const costObj = usage.cost;
+            const msgCost = costObj && typeof costObj === "object" ? costObj.total ?? 0 : 0;
+            if (inputTokens > 0 || outputTokens > 0 || cacheRead > 0 || cacheWrite > 0) {
+                totalInput += inputTokens + cacheRead + cacheWrite;
+                totalOutput += outputTokens;
+                totalCost += msgCost;
+            }
+        }
+        if (totalInput > 0 || totalOutput > 0) {
+            console.log(`[blay] agent_end usage: input=${totalInput}, output=${totalOutput}, cost=${totalCost}`);
+            usageCollector.recordUsage({
+                inputTokens: totalInput,
+                outputTokens: totalOutput,
+                cost: totalCost,
+            });
+        }
+    });
+    // Subscribe to after_tool_call to capture native/MCP tool calls
+    // (blay_* tools are already captured by instrumentTool, so skip those)
+    try {
+        api.on("after_tool_call", (event) => {
+            const toolName = event?.toolName ?? "";
+            // Record tool name for config snapshot (all tools, including blay_*)
+            const pusher = getTelemetryPusher();
+            if (pusher && toolName) {
+                pusher.recordToolName(toolName);
+            }
+            // Run tracking (skip blay_* — already instrumented via instrumentTool)
+            const tracker = getCurrentRunTracker();
+            if (!tracker)
+                return;
+            if (toolName.startsWith("blay_"))
+                return;
+            // OpenClaw may emit after_tool_call twice (once without timing data).
+            // Skip the emission that has no durationMs to avoid duplicate records.
+            if (event?.durationMs == null)
+                return;
+            const record = {
+                name: toolName,
+                params: truncate(event?.params, 2048),
+                result: event?.error ? undefined : truncate(event?.result, 1024),
+                status: event?.error ? "error" : "success",
+                error: event?.error ? truncate(event.error, 1024) : undefined,
+                startedAt: event?.durationMs != null ? Date.now() - event.durationMs : Date.now(),
+                completedAt: Date.now(),
+                durationMs: event?.durationMs ?? 0,
+            };
+            tracker.recordToolCall(record);
+        });
+    }
+    catch {
+        // after_tool_call hook may not be available — that's fine
+    }
+    // Start telemetry pusher on gateway_start, stop on gateway_stop
+    api.on("gateway_start", (_event, _ctx) => {
+        telemetryPusher.start();
+    });
+    api.on("gateway_stop", (_event, _ctx) => {
+        telemetryPusher.stop();
+        setTelemetryPusher(null);
+        setUsageCollector(null);
+    });
+    // ── Hook: inject Blay context into agent startup ──────────────────
+    api.on("before_agent_start", async (event) => {
+        // Track message count so agent_end can skip old messages
+        usageCollector.setRunStartMessageCount(event?.messages?.length ?? 0);
+        return {
+            prependContext: "You are connected to the Blay project management platform as a team member. " +
+                "Use the blay_* tools to read and write data in Blay (projects, tasks, comments, action items, etc.).\n\n" +
+                "IMPORTANT — Cron jobs for Blay: The main session cannot deliver to Blay. " +
+                "When scheduling cron jobs from Blay conversations, you MUST use sessionTarget: \"isolated\" " +
+                "with payload.kind: \"agentTurn\". Delivery config is auto-inferred from the session — do not set it manually. " +
+                "Do NOT use systemEvent/main for Blay; it has no delivery path.",
+        };
+    });
+    // ── Hook: inject loopback gatewayUrl into cron tool calls ─────────
+    // When gateway.bind is not "loopback", the cron tool resolves the LAN IP
+    // as the gateway URL, which requires device pairing and fails. This hook
+    // intercepts cron tool calls and injects gatewayUrl pointing to loopback,
+    // which is always allowed by OpenClaw's validation.
+    try {
+        api.on("before_tool_call", (event, ctx) => {
+            const toolName = event?.toolName ?? "";
+            console.log(`[blay] before_tool_call fired: tool=${toolName}`);
+            // Kill switch: block all tool calls when abort is active
+            if (isAborted()) {
+                console.log(`[blay] tool call blocked (aborted): ${toolName}`);
+                throw new Error("Agent run was aborted by user");
+            }
+            if (toolName !== "cron")
+                return;
+            const bind = getGatewayBind();
+            if (bind === "loopback")
+                return;
+            const port = getGatewayPort();
+            const params = event?.params ?? {};
+            // Only inject if not already set by the agent
+            if (!params.gatewayUrl) {
+                const token = getGatewayToken();
+                const injected = { ...params, gatewayUrl: `ws://127.0.0.1:${port}` };
+                if (token) {
+                    injected.gatewayToken = token;
+                }
+                console.log(`[blay] before_tool_call: injecting gatewayUrl ws://127.0.0.1:${port} + token for cron tool (bind=${bind})`);
+                return { params: injected };
+            }
+        });
+        console.log("[blay] before_tool_call hook registered");
+    }
+    catch (err) {
+        console.warn("[blay] before_tool_call hook registration failed:", err);
+    }
+}
+//# 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/telemetry/pusher.d.ts

@@ -0,0 +1,71 @@
+/**
+ * TelemetryPusher — periodically pushes snapshots to the Blay API.
+ *
+ * Sends heartbeat data every 60 seconds including:
+ * - Phase 1: connection status, uptime, run counts
+ * - Phase 2: aggregate token usage (via UsageCollector)
+ * - Phase 3: cron job snapshots (from cron.json)
+ * - Phase 4: agent config snapshots (from runtime config)
+ *
+ * All pushes are fire-and-forget — telemetry failures must never
+ * break agent execution.
+ */
+import type { BlayClient } from "../client.js";
+export interface TelemetryPusherOpts {
+    client: BlayClient;
+    /** Optional: OpenClaw runtime for reading cron.json and config */
+    runtime?: any;
+}
+export declare class TelemetryPusher {
+    private client;
+    private runtime;
+    private interval;
+    private startedAt;
+    private runsCompleted;
+    private runsFailed;
+    private lastConfigHash;
+    private observedTools;
+    constructor(opts: TelemetryPusherOpts);
+    /** Start periodic telemetry pushes. Called on gateway_start. */
+    start(): void;
+    /** Stop periodic pushes. Called on gateway_stop. */
+    stop(): void;
+    /** Record a completed run (called from run tracker). */
+    recordRunCompleted(): void;
+    /** Record a failed run (called from run tracker). */
+    recordRunFailed(): void;
+    /** Record an observed tool name (cumulative across the session). */
+    recordToolName(name: string): void;
+    /** Gather all telemetry data and POST to the API. */
+    private pushSnapshot;
+    /**
+     * Phase 3: Read cron state from OpenClaw's state directory.
+     *
+     * OpenClaw stores cron data at:
+     *   <stateDir>/cron/jobs.json   — currently configured jobs ({version, jobs: [...]})
+     *   <stateDir>/cron/runs/*.jsonl — per-job run history (one JSONL per job ID)
+     *
+     * We read both: configured jobs for current state, and recent run logs
+     * for historical visibility (last entry per JSONL = most recent run).
+     */
+    private readCronJobs;
+    /**
+     * Phase 4: Read agent config from OpenClaw runtime.
+     * Returns null if config hasn't changed since last push.
+     */
+    private readConfig;
+    /**
+     * Read markdown files from the agent's workspace directory.
+     * Returns filenames and contents. Each file capped at 50KB, total at 200KB.
+     */
+    private readWorkspaceFiles;
+    /**
+     * Read SKILL.md files for the given skill names.
+     * Searches built-in skills dir and extension skill dirs.
+     * Parses YAML frontmatter for description and emoji.
+     * Returns a Map of skill name → metadata.
+     */
+    private readSkillMetadata;
+}
+export declare function setTelemetryPusher(pusher: TelemetryPusher | null): void;
+export declare function getTelemetryPusher(): TelemetryPusher | null;