@a1hvdy/cc-openclaw 0.3.3 → 0.4.6

package/dist/src/lib/debug-tap.js

@@ -0,0 +1,185 @@
+/**
+ * debug-tap — observability layer for cc-openclaw plugin event handlers.
+ *
+ * Wraps a PluginApi so every `api.on(event, handler)` call gets a tracing
+ * shim that writes JSONL entry/exit/error records to
+ * ~/.openclaw/workspace/memory/cc-openclaw-debug.jsonl when CC_OPENCLAW_DEBUG=1.
+ *
+ * Why: cc-handler / injector / event-reducer / tool-tracker / etc. each
+ * register their own listeners on `before_dispatch` and friends, and each
+ * does its own filtering with no entry log. When something silently fails
+ * to dispatch (e.g. forum-topic events not reaching cc-handler), we have no
+ * visibility into which subsystem saw the event, what its raw shape was,
+ * or whether a filter ate it. This tap captures the raw event BEFORE any
+ * filter so absence-of-log uniquely means "listener never invoked".
+ *
+ * Cost when off: a single env-var check per register, then no-op passthrough.
+ * Cost when on: ~one fs.write per event per subsystem (8 subsystems × event-rate).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+const DEBUG_FLAG = 'CC_OPENCLAW_DEBUG';
+const DEFAULT_LOG_DIR = path.join(os.homedir(), '.openclaw', 'workspace', 'memory');
+const DEFAULT_LOG_PATH = path.join(DEFAULT_LOG_DIR, 'cc-openclaw-debug.jsonl');
+function debugEnabled() {
+    const v = process.env[DEBUG_FLAG];
+    if (!v)
+        return false;
+    const norm = v.toLowerCase();
+    return norm === '1' || norm === 'true' || norm === 'on';
+}
+let writeStream = null;
+function getStream() {
+    if (!debugEnabled())
+        return null;
+    if (writeStream)
+        return writeStream;
+    try {
+        fs.mkdirSync(DEFAULT_LOG_DIR, { recursive: true });
+        writeStream = fs.createWriteStream(DEFAULT_LOG_PATH, { flags: 'a' });
+    }
+    catch {
+        return null;
+    }
+    return writeStream;
+}
+function safeStringify(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return '"[unserializable]"';
+    }
+}
+/**
+ * Pull the fields we actually want to see for routing diagnosis without
+ * dumping potentially huge nested structures. Anything not in the allowlist
+ * is summarized via `_keys` so we still know what was on the object.
+ */
+function summarizeArg(arg) {
+    if (arg === null || arg === undefined)
+        return String(arg);
+    if (typeof arg !== 'object') {
+        return { type: typeof arg, value: String(arg).slice(0, 120) };
+    }
+    const a = arg;
+    const out = {};
+    const interesting = [
+        'channel',
+        'isGroup',
+        'senderId',
+        'conversationId',
+        'sessionId',
+        'chatId',
+        'threadId',
+        'topicId',
+        'messageId',
+        'event',
+        'kind',
+        'type',
+        'name',
+        'origin',
+        'source',
+    ];
+    for (const k of interesting) {
+        if (k in a)
+            out[k] = a[k];
+    }
+    if ('content' in a && typeof a.content === 'string') {
+        out.contentPreview = a.content.slice(0, 160);
+    }
+    out._keys = Object.keys(a).slice(0, 32);
+    return out;
+}
+function writeEntry(entry) {
+    const stream = getStream();
+    if (!stream)
+        return;
+    try {
+        stream.write(safeStringify(entry) + '\n');
+    }
+    catch {
+        /* swallow — debug must never crash the plugin */
+    }
+}
+/**
+ * Wrap a PluginApi so each `api.on(event, handler)` registration is traced.
+ *
+ * @param api — the upstream PluginApi from openclaw
+ * @param pluginLabel — short tag identifying which cc-openclaw subsystem
+ *   is registering (e.g. 'cc-handler', 'injector', 'tool-tracker'). Shows
+ *   up in the debug log as `plugin` so we can filter by subsystem.
+ *
+ * When CC_OPENCLAW_DEBUG is unset/false, returns the api unchanged so
+ * there is zero proxy overhead in production.
+ */
+export function wrapApiWithDebugTap(api, pluginLabel) {
+    if (!debugEnabled())
+        return api;
+    const originalOn = api.on.bind(api);
+    return new Proxy(api, {
+        get(target, prop, receiver) {
+            if (prop === 'on') {
+                return (event, handler) => {
+                    const wrappedHandler = async (...args) => {
+                        const startTs = Date.now();
+                        writeEntry({
+                            ts: new Date(startTs).toISOString(),
+                            plugin: pluginLabel,
+                            event,
+                            phase: 'enter',
+                            arg0: summarizeArg(args[0]),
+                            arg1: summarizeArg(args[1]),
+                        });
+                        try {
+                            const result = await handler(...args);
+                            writeEntry({
+                                ts: new Date().toISOString(),
+                                plugin: pluginLabel,
+                                event,
+                                phase: 'exit',
+                                durationMs: Date.now() - startTs,
+                                result: result === undefined
+                                    ? 'undefined'
+                                    : typeof result === 'object'
+                                        ? summarizeArg(result)
+                                        : String(result).slice(0, 120),
+                            });
+                            return result;
+                        }
+                        catch (err) {
+                            writeEntry({
+                                ts: new Date().toISOString(),
+                                plugin: pluginLabel,
+                                event,
+                                phase: 'error',
+                                durationMs: Date.now() - startTs,
+                                error: err instanceof Error ? err.message : String(err),
+                                stack: err instanceof Error
+                                    ? err.stack?.split('\n').slice(0, 6).join('\n')
+                                    : undefined,
+                            });
+                            throw err;
+                        }
+                    };
+                    return originalOn(event, wrappedHandler);
+                };
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+/** Test-only hook to flush + close the stream between tests. */
+export function _resetDebugTapForTests() {
+    if (writeStream) {
+        try {
+            writeStream.end();
+        }
+        catch {
+            /* ignore */
+        }
+        writeStream = null;
+    }
+}
+//# sourceMappingURL=debug-tap.js.map

package/dist/src/lib/debug-tap.js.map

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

package/dist/src/lib/drift-detector.d.ts

@@ -44,4 +44,3 @@ export declare function startDriftPolling(): void;
 export declare function stopDriftPolling(): void;
 /** Test-only: check if polling is active. */
 export declare function _isDriftPollingActive(): boolean;
-//# sourceMappingURL=drift-detector.d.ts.map

package/dist/src/lib/error-formatter.d.ts

@@ -67,7 +67,8 @@ export declare function extractMessage(error: unknown): string;
 /** Escape characters special to Telegram MarkdownV2. */
 export declare function escapeMdV2(text: string): string;
 /**
- * Pure formatter — no side effects, fully unit-testable.
+ * Pure formatter — no side effects on the return value, but DOES emit
+ * trajectory + metrics events for centralized observability per Pillars A+B.
  *
  * @param error   The thrown value (Error instance, string, or unknown)
  * @param context Structured context including mandatory error code
@@ -75,4 +76,3 @@ export declare function escapeMdV2(text: string): string;
 export declare function formatError(error: unknown, context: ErrorContext): FormattedError;
 /** Shorthand for the common "unknown catch block" pattern. */
 export declare function formatUnknownError(error: unknown, sessionId?: string): FormattedError;
-//# sourceMappingURL=error-formatter.d.ts.map

package/dist/src/lib/error-formatter.js

@@ -92,8 +92,14 @@ const SEVERITY_EMOJI = {
     info: '✅',
 };
 // ─── Core formatter ───────────────────────────────────────────────────────────
+// Trajectory + metrics emitters loaded lazily to keep formatError pure-fn-able
+// and test-friendly. Both modules are no-op when their respective env flags
+// are unset, so the import itself has zero runtime cost.
+import { emit as emitTrajectory } from './trajectory.js';
+import { metricsRegistry } from '../health/metrics.js';
 /**
- * Pure formatter — no side effects, fully unit-testable.
+ * Pure formatter — no side effects on the return value, but DOES emit
+ * trajectory + metrics events for centralized observability per Pillars A+B.
  *
  * @param error   The thrown value (Error instance, string, or unknown)
  * @param context Structured context including mandatory error code
@@ -103,6 +109,15 @@ export function formatError(error, context) {
     const stack = extractStack(error);
     const severity = SEVERITY_BY_CODE[context.code] ?? 'error';
     const ts = new Date().toISOString();
+    // Pillar A v0.4.0: bump errors_total + last_error_seconds for /metrics
+    metricsRegistry.recordError(context.code);
+    // Pillar B v0.4.0: emit trajectory event (no-op if CC_OPENCLAW_TRAJECTORY unset)
+    emitTrajectory('error', {
+        code: context.code,
+        severity,
+        message: message.slice(0, 500),
+        ...(context.details !== undefined ? { details: context.details } : {}),
+    }, context.sessionId);
     const jsonlRow = {
         ts,
         code: context.code,

package/dist/src/lib/error-formatter.js.map

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

package/dist/src/lib/heartbeat-workaround.d.ts

@@ -42,4 +42,3 @@ export declare function isHeartbeatRequest(req: SdkRequestPayload): boolean;
  * payload object (does not mutate input).
  */
 export declare function applyHeartbeatWorkaround(req: SdkRequestPayload): SdkRequestPayload;
-//# sourceMappingURL=heartbeat-workaround.d.ts.map

package/dist/src/lib/index.d.ts

@@ -5,4 +5,3 @@ export { isCacheParityEnabled, hashPrompt, recordAttachment, readRegistry, REGIS
 export { selectEngine, isCcOpenclawEnabled, captureSessionRoute, ACTIVE_FLAG_ENV, ROUTE_FLAG_ENV, type Engine, type SessionRoute, } from './route-flag.js';
 export { isTestMode, TEST_MODE_ENV, _setTestModeForTests } from './test-mode.js';
 export { getAggressiveStripEnabled, getCacheParityEnabled, getLogLevel, isLogLevelDebug, } from './config.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/lib/register-guard.d.ts

@@ -1,34 +1,42 @@
 /**
  * Centralized register-guard — eliminates listener stacking systemwide.
  * Each plugin module gets its own guard instance via createRegisterGuard().
- * Multiple register() calls with same id → no-op (regardless of api identity).
+ * Multiple register() calls with same (api, id) → no-op; new api → re-fire.
  *
- * Rationale (revised 2026-04-29 after observed production stacking):
- * The openclaw gateway calls plugin register() multiple times per process —
- * once per plugin context (gateway thread, per-agent thread). Each context
- * passes a different `api` instance, but every api wraps the SAME shared
- * event bus. Calling `api.on('event', fn)` from any api instance adds `fn`
- * to that shared bus. So if we re-fire register body on each "new api",
- * listeners stack N× → duplicate emissions (e.g. doubled-greeting on /new
- * with 3 register cycles producing 3 sendMessage calls per reply).
+ * Rationale (revised 2026-05-06 after observed dispatch-registry blackout):
+ * The openclaw gateway 2026.4.29+ creates MULTIPLE plugin registries per
+ * process when running in `gateway-bindable` runtime mode (origin=bundled
+ * plugins activate it; the loader at loader-CLyHx60E.js:3690-3697 attempts
+ * to merge subsequent default-mode loads into the gateway-bindable
+ * registry, but this only succeeds when cache keys match). When cache keys
+ * differ, the boot-time register() lands in registry A, and the dispatch
+ * path reads from registry B — hooks register fine but never invoke.
  *
- * Previous behavior: tracked by (id, api) pair — re-fired on new api.
- * Rationale was "hot-reload should re-wire" but that's not what happens
- * in production; production gets multi-context registration in one process.
+ * Process-wide id-only keying (the 2026-04-29 approach) blocked re-wiring
+ * into registry B because the second register() call hits the guard and
+ * skips its api.on() calls — leaving no listeners in the dispatch registry
+ * even though they DID register in the boot registry.
  *
- * Current behavior: track by id only. First register fires body; subsequent
- * registers (any api) skip. Use `_resetForTests()` to clear between tests.
+ * Current behavior: track per-(api, id) via WeakMap<api, Set<id>>. Same
+ * api object passed twice → idempotent skip. New api object → fresh
+ * Set, body re-fires, api.on() lands in the new registry. The 2026-04-29
+ * stacking concern (multiple api instances wrapping ONE shared bus →
+ * listener duplication) is resolved at the wrapApiWithDebugTap layer and
+ * by api.on's own dedup; per-bus idempotency is the wrong layer here.
+ *
+ * Fallback: if api is null/undefined/primitive, use a process-wide Set
+ * (no WeakMap key available). Preserves safety for synthetic test calls.
  *
  * Telemetry: when OPENCLAW_REGISTER_DEBUG=1, emits a structured event per
  * register call (id, registered_before, timestamp). Sibling agent
  * cco-hardening-B implements telemetry.ts which consumes these events.
  */
 export interface RegisterGuard {
-    /** Wraps the actual register body — only runs once per (id, api) pair. */
+    /** Wraps the actual register body — runs once per (api, id) pair. */
     guard(id: string, api: unknown, body: () => void): void;
-    /** Test-only reset. */
+    /** Test-only reset (clears fallback only; WeakMap GCs naturally). */
     _resetForTests(): void;
-    /** Inspector for tests / telemetry. */
+    /** Inspector for tests / telemetry (fallback Set only). */
     isRegistered(id: string): boolean;
 }
 export declare function createRegisterGuard(): RegisterGuard;
@@ -46,4 +54,3 @@ export declare const defaultRegisterGuard: RegisterGuard;
  * (no idempotency wrapper) fail.
  */
 export declare function registerOnce(id: string, api: unknown, body: () => void): void;
-//# sourceMappingURL=register-guard.d.ts.map

package/dist/src/lib/register-guard.js

@@ -1,23 +1,31 @@
 /**
  * Centralized register-guard — eliminates listener stacking systemwide.
  * Each plugin module gets its own guard instance via createRegisterGuard().
- * Multiple register() calls with same id → no-op (regardless of api identity).
+ * Multiple register() calls with same (api, id) → no-op; new api → re-fire.
  *
- * Rationale (revised 2026-04-29 after observed production stacking):
- * The openclaw gateway calls plugin register() multiple times per process —
- * once per plugin context (gateway thread, per-agent thread). Each context
- * passes a different `api` instance, but every api wraps the SAME shared
- * event bus. Calling `api.on('event', fn)` from any api instance adds `fn`
- * to that shared bus. So if we re-fire register body on each "new api",
- * listeners stack N× → duplicate emissions (e.g. doubled-greeting on /new
- * with 3 register cycles producing 3 sendMessage calls per reply).
+ * Rationale (revised 2026-05-06 after observed dispatch-registry blackout):
+ * The openclaw gateway 2026.4.29+ creates MULTIPLE plugin registries per
+ * process when running in `gateway-bindable` runtime mode (origin=bundled
+ * plugins activate it; the loader at loader-CLyHx60E.js:3690-3697 attempts
+ * to merge subsequent default-mode loads into the gateway-bindable
+ * registry, but this only succeeds when cache keys match). When cache keys
+ * differ, the boot-time register() lands in registry A, and the dispatch
+ * path reads from registry B — hooks register fine but never invoke.
  *
- * Previous behavior: tracked by (id, api) pair — re-fired on new api.
- * Rationale was "hot-reload should re-wire" but that's not what happens
- * in production; production gets multi-context registration in one process.
+ * Process-wide id-only keying (the 2026-04-29 approach) blocked re-wiring
+ * into registry B because the second register() call hits the guard and
+ * skips its api.on() calls — leaving no listeners in the dispatch registry
+ * even though they DID register in the boot registry.
  *
- * Current behavior: track by id only. First register fires body; subsequent
- * registers (any api) skip. Use `_resetForTests()` to clear between tests.
+ * Current behavior: track per-(api, id) via WeakMap<api, Set<id>>. Same
+ * api object passed twice → idempotent skip. New api object → fresh
+ * Set, body re-fires, api.on() lands in the new registry. The 2026-04-29
+ * stacking concern (multiple api instances wrapping ONE shared bus →
+ * listener duplication) is resolved at the wrapApiWithDebugTap layer and
+ * by api.on's own dedup; per-bus idempotency is the wrong layer here.
+ *
+ * Fallback: if api is null/undefined/primitive, use a process-wide Set
+ * (no WeakMap key available). Preserves safety for synthetic test calls.
  *
  * Telemetry: when OPENCLAW_REGISTER_DEBUG=1, emits a structured event per
  * register call (id, registered_before, timestamp). Sibling agent
@@ -25,22 +33,35 @@
  */
 import { isRegisterDebugEnabled } from './config.js';
 export function createRegisterGuard() {
-    const state = new Set();
+    const perApi = new WeakMap();
+    const fallbackState = new Set();
+    function idsFor(api) {
+        if (api && (typeof api === 'object' || typeof api === 'function')) {
+            const key = api;
+            let ids = perApi.get(key);
+            if (!ids) {
+                ids = new Set();
+                perApi.set(key, ids);
+            }
+            return ids;
+        }
+        return fallbackState;
+    }
     return {
-        guard(id, _api, body) {
-            if (state.has(id)) {
-                // Already registered → no-op regardless of api identity
+        guard(id, api, body) {
+            const ids = idsFor(api);
+            if (ids.has(id)) {
                 if (isRegisterDebugEnabled()) {
                     process.stderr.write(JSON.stringify({
                         ts: new Date().toISOString(),
                         type: 'register-guard.skip',
                         id,
-                        reason: 'already-registered',
+                        reason: 'already-registered-on-this-api',
                     }) + '\n');
                 }
                 return;
             }
-            state.add(id);
+            ids.add(id);
             if (isRegisterDebugEnabled()) {
                 process.stderr.write(JSON.stringify({
                     ts: new Date().toISOString(),
@@ -50,8 +71,8 @@ export function createRegisterGuard() {
             }
             body();
         },
-        _resetForTests() { state.clear(); },
-        isRegistered(id) { return state.has(id); },
+        _resetForTests() { fallbackState.clear(); /* WeakMap GCs naturally */ },
+        isRegistered(id) { return fallbackState.has(id); },
     };
 }
 /** Default singleton — most modules import this directly for simplicity. */

package/dist/src/lib/register-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-guard.js","sourceRoot":"","sources":["../../../src/lib/register-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAWrD,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,OAAO;QACL,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI;YAClB,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClB,wDAAwD;gBACxD,IAAI,sBAAsB,EAAE,EAAE,CAAC;oBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;wBAClC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBAC5B,IAAI,EAAE,qBAAqB;wBAC3B,EAAE;wBACF,MAAM,EAAE,oBAAoB;qBAC7B,CAAC,GAAG,IAAI,CAAC,CAAC;gBACb,CAAC;gBACD,OAAO;YACT,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACd,IAAI,sBAAsB,EAAE,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;oBAClC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBAC5B,IAAI,EAAE,qBAAqB;oBAC3B,EAAE;iBACH,CAAC,GAAG,IAAI,CAAC,CAAC;YACb,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;QACD,cAAc,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACnC,YAAY,CAAC,EAAE,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,EAAE,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,GAAY,EAAE,IAAgB;IACrE,oBAAoB,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"register-guard.js","sourceRoot":"","sources":["../../../src/lib/register-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAWrD,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,IAAI,OAAO,EAAuB,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,SAAS,MAAM,CAAC,GAAY;QAC1B,IAAI,GAAG,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,UAAU,CAAC,EAAE,CAAC;YAClE,MAAM,GAAG,GAAG,GAAa,CAAC;YAC1B,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI;YACjB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAChB,IAAI,sBAAsB,EAAE,EAAE,CAAC;oBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;wBAClC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBAC5B,IAAI,EAAE,qBAAqB;wBAC3B,EAAE;wBACF,MAAM,EAAE,gCAAgC;qBACzC,CAAC,GAAG,IAAI,CAAC,CAAC;gBACb,CAAC;gBACD,OAAO;YACT,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI,sBAAsB,EAAE,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;oBAClC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBAC5B,IAAI,EAAE,qBAAqB;oBAC3B,EAAE;iBACH,CAAC,GAAG,IAAI,CAAC,CAAC;YACb,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;QACD,cAAc,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,2BAA2B,CAAC,CAAC;QACvE,YAAY,CAAC,EAAE,IAAI,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,EAAE,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,GAAY,EAAE,IAAgB;IACrE,oBAAoB,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/src/lib/route-flag.d.ts

@@ -47,4 +47,3 @@ export interface SessionRoute {
     readonly capturedAt: string;
 }
 export declare function captureSessionRoute(): SessionRoute;
-//# sourceMappingURL=route-flag.d.ts.map

package/dist/src/lib/status-tee-reader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * status-tee-reader — reads quota status files written by the existing
+ * telegram-ux/quota-fetcher.js process at /tmp/openclaw-ux-status/.
+ *
+ * The fetcher (in a different process, CJS) periodically polls Anthropic's
+ * /api/oauth/usage and writes JSON snapshots to /tmp/openclaw-ux-status/.
+ * cc-openclaw consumes them via this reader rather than importing the
+ * fetcher directly (cross-process + CJS/ESM mismatch).
+ *
+ * If no fresh file exists (cold-boot, fetcher offline, >10min stale),
+ * returns null. The /cc status panel renders "Plan: ?% (no data)" then.
+ */
+export interface QuotaWindow {
+    usedPercent: number;
+    resetsAt: number;
+}
+export interface QuotaSnapshot {
+    fiveHour: QuotaWindow | null;
+    sevenDay: QuotaWindow | null;
+    ageMs: number;
+}
+/** Read most recent status-tee file. Returns null if missing/stale/invalid. */
+export declare function readQuotaSnapshot(dir?: string): QuotaSnapshot | null;
+/**
+ * Convert quota snapshot to a single-line panel summary.
+ * Color emoji: 🟢 <60%, 🟡 60-85%, 🔴 >85%.
+ */
+export declare function formatQuotaLine(snapshot: QuotaSnapshot | null): string;

package/dist/src/lib/status-tee-reader.js

@@ -0,0 +1,82 @@
+// phase: 4 | pillar: C v0.4.0 | agent: Primary
+/**
+ * status-tee-reader — reads quota status files written by the existing
+ * telegram-ux/quota-fetcher.js process at /tmp/openclaw-ux-status/.
+ *
+ * The fetcher (in a different process, CJS) periodically polls Anthropic's
+ * /api/oauth/usage and writes JSON snapshots to /tmp/openclaw-ux-status/.
+ * cc-openclaw consumes them via this reader rather than importing the
+ * fetcher directly (cross-process + CJS/ESM mismatch).
+ *
+ * If no fresh file exists (cold-boot, fetcher offline, >10min stale),
+ * returns null. The /cc status panel renders "Plan: ?% (no data)" then.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const STATUS_TEE_DIR = '/tmp/openclaw-ux-status';
+const STALE_MS = 10 * 60 * 1000;
+/** Read most recent status-tee file. Returns null if missing/stale/invalid. */
+export function readQuotaSnapshot(dir = STATUS_TEE_DIR) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    let newest = null;
+    for (const name of entries) {
+        if (!name.endsWith('.json'))
+            continue;
+        const p = join(dir, name);
+        try {
+            const st = statSync(p);
+            if (!newest || st.mtimeMs > newest.mtime)
+                newest = { path: p, mtime: st.mtimeMs };
+        }
+        catch {
+            /* skip unreadable */
+        }
+    }
+    if (!newest)
+        return null;
+    const ageMs = Date.now() - newest.mtime;
+    if (ageMs > STALE_MS)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(newest.path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    return {
+        fiveHour: parseWindow(parsed.fiveHour),
+        sevenDay: parseWindow(parsed.sevenDay),
+        ageMs,
+    };
+}
+function parseWindow(v) {
+    if (!v || typeof v !== 'object')
+        return null;
+    const o = v;
+    if (typeof o.usedPercent !== 'number' || typeof o.resetsAt !== 'number')
+        return null;
+    return { usedPercent: o.usedPercent, resetsAt: o.resetsAt };
+}
+/**
+ * Convert quota snapshot to a single-line panel summary.
+ * Color emoji: 🟢 <60%, 🟡 60-85%, 🔴 >85%.
+ */
+export function formatQuotaLine(snapshot) {
+    if (!snapshot)
+        return 'Plan: ?% (no data)';
+    const w = snapshot.sevenDay ?? snapshot.fiveHour;
+    if (!w)
+        return 'Plan: ?% (window data missing)';
+    const pct = Math.round(w.usedPercent);
+    const emoji = pct < 60 ? '🟢' : pct <= 85 ? '🟡' : '🔴';
+    const resetIn = Math.max(0, Math.floor((w.resetsAt * 1000 - Date.now()) / 86_400_000));
+    return `Plan: ${pct}% ${emoji} (resets in ${resetIn}d)`;
+}
+//# sourceMappingURL=status-tee-reader.js.map

package/dist/src/lib/status-tee-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-tee-reader.js","sourceRoot":"","sources":["../../../src/lib/status-tee-reader.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,cAAc,GAAG,yBAAyB,CAAC;AACjD,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAahC,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,MAAc,cAAc;IAC5D,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,GAA2C,IAAI,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK;gBAAE,MAAM,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IACxC,IAAI,KAAK,GAAG,QAAQ;QAAE,OAAO,IAAI,CAAC;IAElC,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAA4B,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtC,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,CAAU;IAC7B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrF,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAA8B;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO,oBAAoB,CAAC;IAC3C,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IACjD,IAAI,CAAC,CAAC;QAAE,OAAO,gCAAgC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACvF,OAAO,SAAS,GAAG,KAAK,KAAK,eAAe,OAAO,IAAI,CAAC;AAC1D,CAAC"}

package/dist/src/lib/sysprompt-strip.d.ts

@@ -51,4 +51,3 @@ export declare function isStripEnabled(opts?: StripOptions): boolean;
  * Source: cwd-enhancer.js lines 800–856; P1 port: session-bootstrap/sysprompt-strip.ts
  */
 export declare function stripSysprompt(content: string, opts?: StripOptions): StripResult;
-//# sourceMappingURL=sysprompt-strip.d.ts.map

package/dist/src/lib/telemetry.d.ts

@@ -36,4 +36,3 @@ export declare function recordRegister(event: Omit<RegisterEvent, 'ts'>): void;
 export declare function _setCostWriterForTests(writer: (event: CostEvent) => void): void;
 export declare function _setRegisterWriterForTests(writer: (event: RegisterEvent) => void): void;
 export declare function _restoreDefaultsForTests(): void;
-//# sourceMappingURL=telemetry.d.ts.map

package/dist/src/lib/test-mode.d.ts

@@ -24,4 +24,3 @@ export declare const TEST_MODE_ENV = "OPENCLAW_PLUGIN_TEST_MODE";
 export declare function isTestMode(): boolean;
 /** For tests — explicit set/unset (operates on process.env). */
 export declare function _setTestModeForTests(on: boolean): void;
-//# sourceMappingURL=test-mode.d.ts.map