@xopcai/xopcbot 0.1.3 → 0.2.0

package/dist/utils/diagnostic-events.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Diagnostic Events System
+ *
+ * Structured event stream for system diagnostics:
+ * - Webhook events (received, processed, error)
+ * - Message events (queued, processed)
+ * - Session events (state changes, stuck detection)
+ * - Model usage events (tokens, cost, duration)
+ * - Heartbeat events (system health)
+ *
+ * Based on OpenClaw's diagnostic-events.ts implementation.
+ */
+export type DiagnosticSessionState = 'idle' | 'processing' | 'waiting';
+type DiagnosticBaseEvent = {
+    ts: number;
+    seq: number;
+};
+export type DiagnosticWebhookReceivedEvent = DiagnosticBaseEvent & {
+    type: 'webhook.received';
+    channel: string;
+    updateType?: string;
+    chatId?: number | string;
+};
+export type DiagnosticWebhookProcessedEvent = DiagnosticBaseEvent & {
+    type: 'webhook.processed';
+    channel: string;
+    updateType?: string;
+    chatId?: number | string;
+    durationMs?: number;
+};
+export type DiagnosticWebhookErrorEvent = DiagnosticBaseEvent & {
+    type: 'webhook.error';
+    channel: string;
+    updateType?: string;
+    chatId?: number | string;
+    error: string;
+};
+export type DiagnosticMessageQueuedEvent = DiagnosticBaseEvent & {
+    type: 'message.queued';
+    sessionKey?: string;
+    sessionId?: string;
+    channel?: string;
+    source: string;
+    queueDepth?: number;
+};
+export type DiagnosticMessageProcessedEvent = DiagnosticBaseEvent & {
+    type: 'message.processed';
+    channel: string;
+    messageId?: number | string;
+    chatId?: number | string;
+    sessionKey?: string;
+    sessionId?: string;
+    durationMs?: number;
+    outcome: 'completed' | 'skipped' | 'error';
+    reason?: string;
+    error?: string;
+};
+export type DiagnosticSessionStateEvent = DiagnosticBaseEvent & {
+    type: 'session.state';
+    sessionKey?: string;
+    sessionId?: string;
+    prevState?: DiagnosticSessionState;
+    state: DiagnosticSessionState;
+    reason?: string;
+    queueDepth?: number;
+};
+export type DiagnosticSessionStuckEvent = DiagnosticBaseEvent & {
+    type: 'session.stuck';
+    sessionKey?: string;
+    sessionId?: string;
+    state: DiagnosticSessionState;
+    ageMs: number;
+    queueDepth?: number;
+};
+export type DiagnosticLaneEnqueueEvent = DiagnosticBaseEvent & {
+    type: 'queue.lane.enqueue';
+    lane: string;
+    queueSize: number;
+};
+export type DiagnosticLaneDequeueEvent = DiagnosticBaseEvent & {
+    type: 'queue.lane.dequeue';
+    lane: string;
+    queueSize: number;
+    waitMs: number;
+};
+export type DiagnosticRunAttemptEvent = DiagnosticBaseEvent & {
+    type: 'run.attempt';
+    sessionKey?: string;
+    sessionId?: string;
+    runId: string;
+    attempt: number;
+};
+export type DiagnosticModelUsageEvent = DiagnosticBaseEvent & {
+    type: 'model.usage';
+    sessionKey?: string;
+    sessionId?: string;
+    channel?: string;
+    provider?: string;
+    model?: string;
+    usage: {
+        input?: number;
+        output?: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+        promptTokens?: number;
+        total?: number;
+    };
+    context?: {
+        limit?: number;
+        used?: number;
+    };
+    costUsd?: number;
+    durationMs?: number;
+};
+export type DiagnosticHeartbeatEvent = DiagnosticBaseEvent & {
+    type: 'diagnostic.heartbeat';
+    webhooks: {
+        received: number;
+        processed: number;
+        errors: number;
+    };
+    active: number;
+    waiting: number;
+    queued: number;
+};
+export type DiagnosticEventPayload = DiagnosticWebhookReceivedEvent | DiagnosticWebhookProcessedEvent | DiagnosticWebhookErrorEvent | DiagnosticMessageQueuedEvent | DiagnosticMessageProcessedEvent | DiagnosticSessionStateEvent | DiagnosticSessionStuckEvent | DiagnosticLaneEnqueueEvent | DiagnosticLaneDequeueEvent | DiagnosticRunAttemptEvent | DiagnosticModelUsageEvent | DiagnosticHeartbeatEvent;
+export type DiagnosticEventInput = DiagnosticEventPayload extends infer Event ? Event extends DiagnosticEventPayload ? Omit<Event, 'seq' | 'ts'> : never : never;
+/**
+ * Check if diagnostics are enabled
+ */
+export declare function diagnosticsEnabled(): boolean;
+/**
+ * Emit a diagnostic event
+ *
+ * @param event - Event to emit (without seq/ts)
+ */
+export declare function emitDiagnosticEvent(event: DiagnosticEventInput): void;
+/**
+ * Subscribe to diagnostic events
+ *
+ * @param listener - Callback function
+ * @returns Unsubscribe function
+ */
+export declare function onDiagnosticEvent(listener: (evt: DiagnosticEventPayload) => void): () => void;
+/**
+ * Get the number of subscribers
+ */
+export declare function getSubscriberCount(): number;
+/**
+ * Log webhook received
+ */
+export declare function logWebhookReceived(params: {
+    channel: string;
+    updateType?: string;
+    chatId?: number | string;
+}): void;
+/**
+ * Log webhook processed
+ */
+export declare function logWebhookProcessed(params: {
+    channel: string;
+    updateType?: string;
+    chatId?: number | string;
+    durationMs?: number;
+}): void;
+/**
+ * Log webhook error
+ */
+export declare function logWebhookError(params: {
+    channel: string;
+    updateType?: string;
+    chatId?: number | string;
+    error: string;
+}): void;
+/**
+ * Log message queued
+ */
+export declare function logMessageQueued(params: {
+    sessionId?: string;
+    sessionKey?: string;
+    channel?: string;
+    source: string;
+}): void;
+/**
+ * Log message processed
+ */
+export declare function logMessageProcessed(params: {
+    channel: string;
+    messageId?: number | string;
+    chatId?: number | string;
+    sessionId?: string;
+    sessionKey?: string;
+    durationMs?: number;
+    outcome: 'completed' | 'skipped' | 'error';
+    reason?: string;
+    error?: string;
+}): void;
+/**
+ * Log model usage
+ */
+export declare function logModelUsage(params: {
+    sessionId?: string;
+    sessionKey?: string;
+    channel?: string;
+    provider?: string;
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    costUsd?: number;
+    durationMs?: number;
+}): void;
+/**
+ * Reset diagnostic events (for testing)
+ */
+export declare function resetDiagnosticEventsForTest(): void;
+declare const _default: {
+    emitDiagnosticEvent: typeof emitDiagnosticEvent;
+    onDiagnosticEvent: typeof onDiagnosticEvent;
+    diagnosticsEnabled: typeof diagnosticsEnabled;
+    logWebhookReceived: typeof logWebhookReceived;
+    logWebhookProcessed: typeof logWebhookProcessed;
+    logWebhookError: typeof logWebhookError;
+    logMessageQueued: typeof logMessageQueued;
+    logMessageProcessed: typeof logMessageProcessed;
+    logModelUsage: typeof logModelUsage;
+    resetDiagnosticEventsForTest: typeof resetDiagnosticEventsForTest;
+};
+export default _default;

package/dist/utils/diagnostic-events.js

@@ -0,0 +1,189 @@
+/**
+ * Diagnostic Events System
+ *
+ * Structured event stream for system diagnostics:
+ * - Webhook events (received, processed, error)
+ * - Message events (queued, processed)
+ * - Session events (state changes, stuck detection)
+ * - Model usage events (tokens, cost, duration)
+ * - Heartbeat events (system health)
+ *
+ * Based on OpenClaw's diagnostic-events.ts implementation.
+ */
+import { createRequire } from 'node:module';
+const requireConfig = createRequire(import.meta.url);
+// =============================================================================
+// Internal State
+// =============================================================================
+let seq = 0;
+const listeners = new Set();
+// =============================================================================
+// Configuration
+// =============================================================================
+function isDiagnosticsEnabled() {
+    try {
+        const loaded = requireConfig('../config/config.js');
+        return loaded.loadConfig?.()?.diagnostics?.enabled === true;
+    }
+    catch {
+        return false;
+    }
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Check if diagnostics are enabled
+ */
+export function diagnosticsEnabled() {
+    return isDiagnosticsEnabled();
+}
+/**
+ * Emit a diagnostic event
+ *
+ * @param event - Event to emit (without seq/ts)
+ */
+export function emitDiagnosticEvent(event) {
+    // Always emit even if diagnostics disabled (for internal use)
+    // but could be gated if needed
+    const enriched = {
+        ...event,
+        seq: (seq += 1),
+        ts: Date.now(),
+    };
+    for (const listener of listeners) {
+        try {
+            listener(enriched);
+        }
+        catch {
+            // Ignore listener failures
+        }
+    }
+}
+/**
+ * Subscribe to diagnostic events
+ *
+ * @param listener - Callback function
+ * @returns Unsubscribe function
+ */
+export function onDiagnosticEvent(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+/**
+ * Get the number of subscribers
+ */
+export function getSubscriberCount() {
+    return listeners.size;
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * Log webhook received
+ */
+export function logWebhookReceived(params) {
+    emitDiagnosticEvent({
+        type: 'webhook.received',
+        channel: params.channel,
+        updateType: params.updateType,
+        chatId: params.chatId,
+    });
+}
+/**
+ * Log webhook processed
+ */
+export function logWebhookProcessed(params) {
+    emitDiagnosticEvent({
+        type: 'webhook.processed',
+        channel: params.channel,
+        updateType: params.updateType,
+        chatId: params.chatId,
+        durationMs: params.durationMs,
+    });
+}
+/**
+ * Log webhook error
+ */
+export function logWebhookError(params) {
+    emitDiagnosticEvent({
+        type: 'webhook.error',
+        channel: params.channel,
+        updateType: params.updateType,
+        chatId: params.chatId,
+        error: params.error,
+    });
+}
+/**
+ * Log message queued
+ */
+export function logMessageQueued(params) {
+    emitDiagnosticEvent({
+        type: 'message.queued',
+        sessionId: params.sessionId,
+        sessionKey: params.sessionKey,
+        channel: params.channel,
+        source: params.source,
+    });
+}
+/**
+ * Log message processed
+ */
+export function logMessageProcessed(params) {
+    emitDiagnosticEvent({
+        type: 'message.processed',
+        channel: params.channel,
+        messageId: params.messageId,
+        chatId: params.chatId,
+        sessionId: params.sessionId,
+        sessionKey: params.sessionKey,
+        durationMs: params.durationMs,
+        outcome: params.outcome,
+        reason: params.reason,
+        error: params.error,
+    });
+}
+/**
+ * Log model usage
+ */
+export function logModelUsage(params) {
+    emitDiagnosticEvent({
+        type: 'model.usage',
+        sessionId: params.sessionId,
+        sessionKey: params.sessionKey,
+        channel: params.channel,
+        provider: params.provider,
+        model: params.model,
+        usage: {
+            input: params.inputTokens,
+            output: params.outputTokens,
+            cacheRead: params.cacheReadTokens,
+            cacheWrite: params.cacheWriteTokens,
+        },
+        costUsd: params.costUsd,
+        durationMs: params.durationMs,
+    });
+}
+// =============================================================================
+// Test Helpers
+// =============================================================================
+/**
+ * Reset diagnostic events (for testing)
+ */
+export function resetDiagnosticEventsForTest() {
+    seq = 0;
+    listeners.clear();
+}
+export default {
+    emitDiagnosticEvent,
+    onDiagnosticEvent,
+    diagnosticsEnabled,
+    logWebhookReceived,
+    logWebhookProcessed,
+    logWebhookError,
+    logMessageQueued,
+    logMessageProcessed,
+    logModelUsage,
+    resetDiagnosticEventsForTest,
+};
+//# sourceMappingURL=diagnostic-events.js.map

package/dist/utils/diagnostic-events.js.map

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

package/dist/utils/frontmatter.d.ts

@@ -8,7 +8,6 @@ export interface ParsedFrontmatter<T = Record<string, unknown>> {
 }
 /**
  * Parse YAML frontmatter from markdown content
- * Supports both JSON and YAML-style frontmatter
  */
 export declare function parseFrontmatter<T = Record<string, unknown>>(content: string): ParsedFrontmatter<T>;
 /**

package/dist/utils/frontmatter.js

@@ -2,13 +2,13 @@
  * Frontmatter parsing utility
  * Extracts YAML frontmatter from markdown content
  */
+import yaml from 'js-yaml';
 /**
  * Parse YAML frontmatter from markdown content
- * Supports both JSON and YAML-style frontmatter
  */
 export function parseFrontmatter(content) {
-    // Match --- frontmatter ---
-    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    // Match --- frontmatter --- (supports both Unix \n and Windows \r\n line endings)
+    const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
     if (!frontmatterMatch) {
         return {
             frontmatter: {},
@@ -16,89 +16,25 @@ export function parseFrontmatter(content) {
         };
     }
     const [, frontmatterRaw, bodyContent] = frontmatterMatch;
-    // Try to parse as JSON first (if wrapped in {})
-    let frontmatter = {};
     try {
-        const trimmed = frontmatterRaw.trim();
-        if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
-            frontmatter = JSON.parse(trimmed);
-        }
-        else {
-            // Simple YAML-like parsing for key: value pairs
-            frontmatter = parseSimpleYaml(trimmed);
-        }
-    }
-    catch {
-        // If parsing fails, treat as empty
-        frontmatter = {};
+        const frontmatter = yaml.load(frontmatterRaw);
+        return {
+            frontmatter: (frontmatter || {}),
+            content: bodyContent.trim(),
+        };
     }
-    return {
-        frontmatter: frontmatter,
-        content: bodyContent.trim(),
-    };
-}
-/**
- * Simple YAML parser for key: value pairs
- * Handles:
- * - key: value
- * - key: "quoted value"
- * - key: 'quoted value'
- * - key: { json: object }
- * - key: [array, values]
- */
-function parseSimpleYaml(content) {
-    const result = {};
-    const lines = content.split('\n');
-    for (const line of lines) {
-        const colonIndex = line.indexOf(':');
-        if (colonIndex <= 0)
-            continue;
-        const key = line.slice(0, colonIndex).trim();
-        let value = line.slice(colonIndex + 1).trim();
-        // Remove quotes
-        if (typeof value === 'string') {
-            if ((value.startsWith('"') && value.endsWith('"')) ||
-                (value.startsWith("'") && value.endsWith("'"))) {
-                value = value.slice(1, -1);
-            }
-            // Try to parse as JSON (for objects/arrays)
-            const strValue = value;
-            if ((strValue.startsWith('{') && strValue.endsWith('}')) ||
-                (strValue.startsWith('[') && strValue.endsWith(']'))) {
-                try {
-                    value = JSON.parse(strValue);
-                }
-                catch {
-                    // Keep as string if JSON parsing fails
-                }
-            }
-            // Try to parse as number
-            if (typeof value === 'string' && /^-?\d+(\.\d+)?$/.test(value)) {
-                value = parseFloat(value);
-            }
-            // Parse booleans
-            if (value === 'true')
-                value = true;
-            if (value === 'false')
-                value = false;
-        }
-        result[key] = value;
+    catch (error) {
+        console.warn('Failed to parse frontmatter:', error);
+        return {
+            frontmatter: {},
+            content: bodyContent.trim(),
+        };
     }
-    return result;
 }
 /**
  * Serialize frontmatter to YAML format
  */
 export function serializeFrontmatter(frontmatter) {
-    const lines = Object.entries(frontmatter).map(([key, value]) => {
-        if (typeof value === 'string' && (value.includes(':') || value.includes('\n'))) {
-            return `${key}: "${value.replace(/"/g, '\\"')}"`;
-        }
-        if (typeof value === 'object') {
-            return `${key}: ${JSON.stringify(value)}`;
-        }
-        return `${key}: ${value}`;
-    });
-    return `---\n${lines.join('\n')}\n---`;
+    return '---\n' + yaml.dump(frontmatter) + '---';
 }
 //# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,SAAS,CAAC;AAO3B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe;IAEf,kFAAkF;IAClF,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAErF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO;YACL,WAAW,EAAE,EAAO;YACpB,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,EAAE,cAAc,EAAE,WAAW,CAAC,GAAG,gBAAgB,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAA4B,CAAC;QACzE,OAAO;YACL,WAAW,EAAE,CAAC,WAAW,IAAI,EAAE,CAAM;YACrC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO;YACL,WAAW,EAAE,EAAO;YACpB,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAoC;IACvE,OAAO,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;AAClD,CAAC"}

package/dist/utils/log-stream.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Log Streaming Module - SSE Real-time Log Delivery
+ *
+ * Provides Server-Sent Events (SSE) for real-time log streaming:
+ * - Subscribe to log events
+ * - Filter by level and module
+ * - Automatic cleanup on disconnect
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    module?: string;
+    prefix?: string;
+    service?: string;
+    plugin?: string;
+    requestId?: string;
+    sessionId?: string;
+    userId?: string;
+    [key: string]: unknown;
+}
+export interface LogStreamOptions {
+    /** Minimum log level to stream */
+    minLevel?: LogLevel;
+    /** Filter by module name */
+    module?: string;
+    /** Include these levels (overrides minLevel) */
+    levels?: LogLevel[];
+}
+type LogSubscriber = (entry: LogEntry) => void;
+/**
+ * Subscribe to log events
+ *
+ * @param subscriber - Callback function to receive log entries
+ * @returns Unsubscribe function
+ */
+export declare function subscribeToLogs(subscriber: LogSubscriber): () => void;
+/**
+ * Get number of active subscribers
+ */
+export declare function getSubscriberCount(): number;
+/**
+ * Check if any subscribers are active
+ */
+export declare function hasSubscribers(): boolean;
+/**
+ * Emit a log entry to all subscribers
+ *
+ * @internal - Called by the logger integration
+ */
+export declare function emitLogEntry(entry: LogEntry): void;
+/**
+ * Create a log entry from raw data
+ *
+ * @internal
+ */
+export declare function createLogEntry(level: LogLevel, message: string, context?: Record<string, unknown>): LogEntry;
+/**
+ * Create an SSE handler for log streaming
+ *
+ * Usage:
+ * ```typescript
+ * import { createLogStreamHandler } from './log-stream.js';
+ *
+ * app.get('/api/logs/stream', createLogStreamHandler());
+ * ```
+ */
+export declare function createLogStreamHandler(): (req: Request) => Response;
+/**
+ * Create a Hono-compatible SSE handler for log streaming
+ *
+ * Usage:
+ * ```typescript
+ * import { createLogSSEHandler } from './log-stream.js';
+ *
+ * app.get('/api/logs/stream', createLogSSEHandler());
+ * ```
+ */
+export declare function createLogSSEHandler(): (c: {
+    req: {
+        raw: Request;
+        url: string;
+    };
+}) => Promise<Response>;
+declare const _default: {
+    subscribeToLogs: typeof subscribeToLogs;
+    getSubscriberCount: typeof getSubscriberCount;
+    hasSubscribers: typeof hasSubscribers;
+    emitLogEntry: typeof emitLogEntry;
+    createLogEntry: typeof createLogEntry;
+    createLogStreamHandler: typeof createLogStreamHandler;
+    createLogSSEHandler: typeof createLogSSEHandler;
+};
+export default _default;