@a1hvdy/cc-openclaw 0.3.2

package/dist/src/lib/cache-parity.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Cache-parity Track B — appendSystemPrompt + disk registry.
+ *
+ * Per memory `2026-04-26-cache-parity-track-b`: claude-local uses
+ * appendSystemPrompt (NOT body.system) + a disk registry so the Anthropic
+ * CLI auto-attaches cache_control on the system block. This module provides
+ * the registry primitives that cc-openclaw's session bootstrap will use.
+ *
+ * Env: OPENCLAW_CACHE_PARITY=1 (default-on in cc-openclaw) — set 0/false/off to disable.
+ *
+ * The disk registry lives at ~/.openclaw/workspace/memory/cc-openclaw-cache-registry.jsonl
+ * and tracks (sessionId, promptHash, attachedAt) so we can detect cache hits
+ * + emit metrics for the A/B benchmark harness in P2 R3.
+ */
+export declare const REGISTRY_PATH: string;
+/** Resolve cache-parity enabled state. Default-on; only OPENCLAW_CACHE_PARITY=0/false/off opts out. */
+export declare function isCacheParityEnabled(): boolean;
+/** Compute a stable hash of a system prompt for registry tracking. Returns 16-char hex prefix. */
+export declare function hashPrompt(prompt: string): string;
+export interface RegistryEntry {
+    ts: string;
+    sessionId: string;
+    promptHash: string;
+    promptBytes: number;
+    attached: boolean;
+    source: 'appendSystemPrompt' | 'body.system' | 'unknown';
+}
+/**
+ * Record a system-prompt attachment event. Called by session bootstrap when
+ * it appends a sysprompt via appendSystemPrompt rather than body.system.
+ */
+export declare function recordAttachment(input: Omit<RegistryEntry, 'ts' | 'promptHash' | 'promptBytes'> & {
+    prompt: string;
+}): void;
+/** Read the entire registry — used by the A/B bench harness in P2 R3. */
+export declare function readRegistry(): RegistryEntry[];
+export declare function _setWriterForTests(w: (entry: RegistryEntry) => void): void;
+export declare function _restoreDefaultWriterForTests(): void;
+//# sourceMappingURL=cache-parity.d.ts.map

package/dist/src/lib/cache-parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-parity.d.ts","sourceRoot":"","sources":["../../../src/lib/cache-parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,eAAO,MAAM,aAAa,QAAyD,CAAC;AASpF,uGAAuG;AACvG,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAID,kGAAkG;AAClG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAID,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,oBAAoB,GAAG,aAAa,GAAG,SAAS,CAAC;CAC1D;AAoBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,YAAY,GAAG,aAAa,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACnF,IAAI,CAUN;AAED,yEAAyE;AACzE,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAW9C;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAE1E;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/src/lib/cache-parity.js

@@ -0,0 +1,92 @@
+/**
+ * Cache-parity Track B — appendSystemPrompt + disk registry.
+ *
+ * Per memory `2026-04-26-cache-parity-track-b`: claude-local uses
+ * appendSystemPrompt (NOT body.system) + a disk registry so the Anthropic
+ * CLI auto-attaches cache_control on the system block. This module provides
+ * the registry primitives that cc-openclaw's session bootstrap will use.
+ *
+ * Env: OPENCLAW_CACHE_PARITY=1 (default-on in cc-openclaw) — set 0/false/off to disable.
+ *
+ * The disk registry lives at ~/.openclaw/workspace/memory/cc-openclaw-cache-registry.jsonl
+ * and tracks (sessionId, promptHash, attachedAt) so we can detect cache hits
+ * + emit metrics for the A/B benchmark harness in P2 R3.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { createHash } from 'node:crypto';
+import { getCacheParityEnabled, isLogLevelDebug } from './config.js';
+// ─── Paths ───────────────────────────────────────────────────────────────────
+const REGISTRY_DIR = join(homedir(), '.openclaw', 'workspace', 'memory');
+export const REGISTRY_PATH = join(REGISTRY_DIR, 'cc-openclaw-cache-registry.jsonl');
+function ensureDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+// ─── Enabled check ───────────────────────────────────────────────────────────
+/** Resolve cache-parity enabled state. Default-on; only OPENCLAW_CACHE_PARITY=0/false/off opts out. */
+export function isCacheParityEnabled() {
+    // Env read centralized in src/lib/config.ts (PRP_v3 §5 hard rule).
+    return getCacheParityEnabled();
+}
+// ─── Hashing ─────────────────────────────────────────────────────────────────
+/** Compute a stable hash of a system prompt for registry tracking. Returns 16-char hex prefix. */
+export function hashPrompt(prompt) {
+    return createHash('sha256').update(prompt, 'utf8').digest('hex').slice(0, 16);
+}
+// ─── Writer ──────────────────────────────────────────────────────────────────
+let writer = defaultWriter;
+function defaultWriter(entry) {
+    if (!isCacheParityEnabled())
+        return;
+    try {
+        ensureDir(REGISTRY_PATH);
+        appendFileSync(REGISTRY_PATH, JSON.stringify(entry) + '\n');
+    }
+    catch (err) {
+        if (isLogLevelDebug()) {
+            process.stderr.write(`[cache-parity] registry write failed: ${err.message}\n`);
+        }
+    }
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Record a system-prompt attachment event. Called by session bootstrap when
+ * it appends a sysprompt via appendSystemPrompt rather than body.system.
+ */
+export function recordAttachment(input) {
+    const { prompt, ...rest } = input;
+    writer({
+        ts: new Date().toISOString(),
+        sessionId: rest.sessionId,
+        promptHash: hashPrompt(prompt),
+        promptBytes: Buffer.byteLength(prompt, 'utf8'),
+        attached: rest.attached,
+        source: rest.source,
+    });
+}
+/** Read the entire registry — used by the A/B bench harness in P2 R3. */
+export function readRegistry() {
+    if (!existsSync(REGISTRY_PATH))
+        return [];
+    try {
+        const content = readFileSync(REGISTRY_PATH, 'utf8');
+        return content
+            .split('\n')
+            .filter((line) => line.trim().length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Test hooks ──────────────────────────────────────────────────────────────
+export function _setWriterForTests(w) {
+    writer = w;
+}
+export function _restoreDefaultWriterForTests() {
+    writer = defaultWriter;
+}
+//# sourceMappingURL=cache-parity.js.map

package/dist/src/lib/cache-parity.js.map

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

package/dist/src/lib/circuit-breaker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Circuit breaker for engine failure tracking.
+ *
+ * Opens after CIRCUIT_BREAKER_THRESHOLD consecutive failures per engine,
+ * with exponential backoff capped at CIRCUIT_BREAKER_MAX_BACKOFF_MS.
+ * Resets on a successful engine start.
+ */
+export declare class CircuitBreaker {
+    private breakers;
+    /** Throws if the engine circuit is open and backoff has not yet expired. */
+    check(engine: string): void;
+    /** Record a failure — increments count and sets exponential backoff. */
+    recordFailure(engine: string): void;
+    /** Reset (clear) the breaker for an engine after a successful start. */
+    reset(engine: string): void;
+    /** Get status snapshot for health() reporting. */
+    getStatus(): Record<string, {
+        failures: number;
+        backoffUntil: string | null;
+    }>;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/src/lib/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/lib/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IAEnD,4EAA4E;IAC5E,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa3B,wEAAwE;IACxE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAYnC,wEAAwE;IACxE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3B,kDAAkD;IAClD,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAW/E"}

package/dist/src/lib/circuit-breaker.js

@@ -0,0 +1,47 @@
+/**
+ * Circuit breaker for engine failure tracking.
+ *
+ * Opens after CIRCUIT_BREAKER_THRESHOLD consecutive failures per engine,
+ * with exponential backoff capped at CIRCUIT_BREAKER_MAX_BACKOFF_MS.
+ * Resets on a successful engine start.
+ */
+import { CIRCUIT_BREAKER_THRESHOLD, CIRCUIT_BREAKER_BACKOFF_BASE_MS, CIRCUIT_BREAKER_MAX_BACKOFF_MS, } from '../constants.js';
+export class CircuitBreaker {
+    breakers = new Map();
+    /** Throws if the engine circuit is open and backoff has not yet expired. */
+    check(engine) {
+        const breaker = this.breakers.get(engine);
+        if (!breaker)
+            return;
+        if (breaker.count >= CIRCUIT_BREAKER_THRESHOLD && Date.now() < breaker.backoffUntil) {
+            const remaining = Math.ceil((breaker.backoffUntil - Date.now()) / 1000);
+            throw new Error(`Engine '${engine}' circuit breaker open after ${breaker.count} consecutive failures. ` +
+                `Retry in ${remaining}s.`);
+        }
+        // If backoff has expired, allow the attempt (will reset on success)
+    }
+    /** Record a failure — increments count and sets exponential backoff. */
+    recordFailure(engine) {
+        const existing = this.breakers.get(engine) || { count: 0, lastFailure: 0, backoffUntil: 0 };
+        existing.count++;
+        existing.lastFailure = Date.now();
+        const backoff = Math.min(CIRCUIT_BREAKER_BACKOFF_BASE_MS * Math.pow(2, existing.count - 1), CIRCUIT_BREAKER_MAX_BACKOFF_MS);
+        existing.backoffUntil = Date.now() + backoff;
+        this.breakers.set(engine, existing);
+    }
+    /** Reset (clear) the breaker for an engine after a successful start. */
+    reset(engine) {
+        this.breakers.delete(engine);
+    }
+    /** Get status snapshot for health() reporting. */
+    getStatus() {
+        return Object.fromEntries([...this.breakers].map(([engine, state]) => [
+            engine,
+            {
+                failures: state.count,
+                backoffUntil: state.backoffUntil > Date.now() ? new Date(state.backoffUntil).toISOString() : null,
+            },
+        ]));
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/src/lib/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../src/lib/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAQzB,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEnD,4EAA4E;IAC5E,KAAK,CAAC,MAAc;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,OAAO,CAAC,KAAK,IAAI,yBAAyB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YACpF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,gCAAgC,OAAO,CAAC,KAAK,yBAAyB;gBACrF,YAAY,SAAS,IAAI,CAC5B,CAAC;QACJ,CAAC;QACD,oEAAoE;IACtE,CAAC;IAED,wEAAwE;IACxE,aAAa,CAAC,MAAc;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC5F,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,+BAA+B,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,EACjE,8BAA8B,CAC/B,CAAC;QACF,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,MAAc;QAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,SAAS;QACP,OAAO,MAAM,CAAC,WAAW,CACvB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM;YACN;gBACE,QAAQ,EAAE,KAAK,CAAC,KAAK;gBACrB,YAAY,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;aAClG;SACF,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,74 @@
+/**
+ * config — single env-reader source of truth (PRP_v3 §5 hard rule).
+ *
+ * v3 §5 mandates: `process.env` reads only in `src/index.ts`,
+ * `src/lib/route-flag.ts`, and this module. Every other source file imports
+ * its config from here via the typed getter functions.
+ *
+ * Why getters (not cached constants): tests flip env vars at runtime via
+ * `process.env.X = 'y'` and expect immediate effect. Cached-at-import
+ * constants would freeze the value at first load, breaking every existing
+ * test that toggles env mid-run. Getters preserve test flippability while
+ * still centralizing env-coupling to one module.
+ *
+ * Adding a new env var: add a getter here, import it from the consumer.
+ * Do NOT add `process.env.X` reads in any other file under src/ except
+ * the two pre-authorized exceptions noted above.
+ */
+export declare function getAggressiveStripEnabled(): boolean;
+export declare function getCacheParityEnabled(): boolean;
+/** Strict opt-in variant used by cwd-patch route patch (Track B append). */
+export declare function isCacheParityTrackB(): boolean;
+export declare function getLogLevel(): string | undefined;
+/** Convenience boolean — true iff `getLogLevel() === 'debug'`. */
+export declare function isLogLevelDebug(): boolean;
+export declare function isTokenTelemetryEnabled(): boolean;
+export declare function isSyspromptDumpEnabled(): boolean;
+export declare function getMaxConcurrentSessions(): number;
+export declare function getSessionTtlMinutes(): number;
+export declare function ensureUxBridgeAllSessionsDefault(): {
+    mutated: boolean;
+    value: string;
+};
+export declare function getServerHost(): string;
+/** Per-IP rate limit; falls back to RATE_LIMIT_MAX_REQUESTS if unset/invalid. */
+export declare function getRateLimit(): number;
+/** Bearer token for embedded server. Undefined → no auth (default). */
+export declare function getServerToken(): string | undefined;
+/** True iff CORS is wildcarded via OPENCLAW_CORS_ORIGINS=*. */
+export declare function isCorsAllowAll(): boolean;
+export declare function getGatewayUrl(): string | undefined;
+export declare function getGatewayKey(): string | undefined;
+export declare function getAnthropicApiKey(): string | undefined;
+export declare function getOpenaiApiKey(): string | undefined;
+export declare function getGeminiApiKey(): string | undefined;
+export declare function getGeminiBin(): string | undefined;
+export declare function getCodexBin(): string | undefined;
+export declare function getCursorBin(): string | undefined;
+export declare function getClaudeBin(): string | undefined;
+/**
+ * PATH passed to spawned engine subprocesses. Falls back to the standard
+ * Unix path so binaries resolve even when the parent's PATH is unset
+ * (preserved from persistent-session.ts:257 + persistent-custom-session.ts:240).
+ */
+export declare function getProcessPath(): string;
+export declare function isTokenTelemetryWriterEnabled(): boolean;
+/** Strict opt-in — register-guard event logging via OPENCLAW_REGISTER_DEBUG=1. */
+export declare function isRegisterDebugEnabled(): boolean;
+export declare function isHeartbeatWorkaroundDisabled(): boolean;
+export declare function getQuotaPausePct(): number;
+/** Raw value for `isToolsPerMessageModeEnabled()` parsing. */
+export declare function getOpenaiCompatToolsPerMessage(): string | undefined;
+/** Strict opt-in — legacy new-conversation heuristic via env=1. */
+export declare function isOpenaiCompatNewConvoHeuristic(): boolean;
+export declare function getOpenaiCompatStatusUrl(): string | undefined;
+export declare function getUxBridgeAllSessions(): string | undefined;
+export declare function getAnthropicBaseUrlEnv(): string | undefined;
+export declare function isSavvyLiveCardEnabled(): boolean;
+export declare function getHomeOrTmp(): string;
+export declare function getHealthPortEnv(): string | undefined;
+export declare function isDriftAlertsEnabled(): boolean;
+/** Dedup window for repeated drift Telegram alerts. Default 1h. */
+export declare function getDriftDedupeWindowMs(): number;
+export declare function isAutoRecoveryEnabled(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,wBAAgB,yBAAyB,IAAI,OAAO,CAInD;AAcD,wBAAgB,qBAAqB,IAAI,OAAO,CAI/C;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAMD,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAGhD;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAKD,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAKD,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AASD,wBAAgB,gCAAgC,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOtF;AAID,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,iFAAiF;AACjF,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,uEAAuE;AACvE,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAGnD;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAID,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAGlD;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAGlD;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAGvD;AAED,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAGpD;AAED,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAGpD;AAMD,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAGjD;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAGhD;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAGjD;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAQD,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAKD,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAKD,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAID,8DAA8D;AAC9D,wBAAgB,8BAA8B,IAAI,MAAM,GAAG,SAAS,CAGnE;AAED,mEAAmE;AACnE,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,SAAS,CAG7D;AAMD,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAG3D;AAMD,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAG3D;AAID,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAMD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAMD,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAGrD;AAKD,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAKD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/dist/src/lib/config.js

@@ -0,0 +1,244 @@
+/**
+ * config — single env-reader source of truth (PRP_v3 §5 hard rule).
+ *
+ * v3 §5 mandates: `process.env` reads only in `src/index.ts`,
+ * `src/lib/route-flag.ts`, and this module. Every other source file imports
+ * its config from here via the typed getter functions.
+ *
+ * Why getters (not cached constants): tests flip env vars at runtime via
+ * `process.env.X = 'y'` and expect immediate effect. Cached-at-import
+ * constants would freeze the value at first load, breaking every existing
+ * test that toggles env mid-run. Getters preserve test flippability while
+ * still centralizing env-coupling to one module.
+ *
+ * Adding a new env var: add a getter here, import it from the consumer.
+ * Do NOT add `process.env.X` reads in any other file under src/ except
+ * the two pre-authorized exceptions noted above.
+ */
+import { RATE_LIMIT_MAX_REQUESTS } from '../constants.js';
+// ── Sysprompt strip (PRP_v3 §10) ─────────────────────────────────────────
+// Default ON. Opt-out via OPENCLAW_AGGRESSIVE_STRIP=0|false|off (exact-match,
+// case-sensitive — preserved bit-for-bit from sysprompt-strip.ts:43-45 to
+// avoid breaking the 18 existing strip tests).
+export function getAggressiveStripEnabled() {
+    const env = process.env.OPENCLAW_AGGRESSIVE_STRIP;
+    if (env === '0' || env === 'false' || env === 'off')
+        return false;
+    return true;
+}
+// ── Cache parity Track B (PRP_v3 §10) ────────────────────────────────────
+// Default ON. Opt-out via OPENCLAW_CACHE_PARITY=0|false|off (exact-match,
+// case-sensitive — preserved from cache-parity.ts:35-37).
+//
+// NOTE — semantic divergence vs `isCacheParityTrackB()` below:
+// `getCacheParityEnabled()` is the cache-parity *module* gate (default ON).
+// `isCacheParityTrackB()` is the cwd-patch *route patch* gate (default OFF,
+// strict opt-in via `=== '1'`). Both currently key on OPENCLAW_CACHE_PARITY,
+// which is a latent bug — flipping the env var doesn't switch them in lock
+// step. Tracked for B5-followup; B5-heavy preserves existing call-site
+// semantics bit-for-bit.
+export function getCacheParityEnabled() {
+    const env = process.env.OPENCLAW_CACHE_PARITY;
+    if (env === '0' || env === 'false' || env === 'off')
+        return false;
+    return true;
+}
+/** Strict opt-in variant used by cwd-patch route patch (Track B append). */
+export function isCacheParityTrackB() {
+    return process.env.OPENCLAW_CACHE_PARITY === '1';
+}
+// ── Log level (PRP_v3 §10) ───────────────────────────────────────────────
+// Returns raw string for the logger to parse. Empty/unset → undefined; the
+// caller decides the default (logger.ts uses 'info').
+export function getLogLevel() {
+    const v = process.env.OPENCLAW_LOG_LEVEL;
+    return v === undefined || v === null || v === '' ? undefined : v;
+}
+/** Convenience boolean — true iff `getLogLevel() === 'debug'`. */
+export function isLogLevelDebug() {
+    return getLogLevel() === 'debug';
+}
+// ── Telemetry & diagnostics (cwd-patch) ──────────────────────────────────
+// Strict opt-in — both default OFF, both keyed on `=== '1'`.
+export function isTokenTelemetryEnabled() {
+    return process.env.OPENCLAW_TOKEN_TELEMETRY === '1';
+}
+export function isSyspromptDumpEnabled() {
+    return process.env.OPENCLAW_SYSPROMPT_DUMP === '1';
+}
+// ── SessionManager bootstrap caps (cwd-patch eager-init) ─────────────────
+// Defaults preserved from cwd-patch.ts:844-845.
+export function getMaxConcurrentSessions() {
+    return parseInt(process.env.CLAUDE_CODE_MAX_SESSIONS || '', 10) || 32;
+}
+export function getSessionTtlMinutes() {
+    return parseInt(process.env.CLAUDE_CODE_SESSION_TTL || '', 10) || 1440;
+}
+// ── UX bridge bootstrap (cwd-patch register hook) ────────────────────────
+// One-shot mutation: if UX_BRIDGE_ALL_SESSIONS is unset, set it to 'true'.
+// Returns { mutated, value } so the caller can log accurately. Centralized
+// here because it's the one process.env *write* outside index/route-flag.
+//
+// Behavior preserved bit-for-bit from cwd-patch.ts:983-988.
+export function ensureUxBridgeAllSessionsDefault() {
+    const current = process.env.UX_BRIDGE_ALL_SESSIONS;
+    if (current === undefined) {
+        process.env.UX_BRIDGE_ALL_SESSIONS = 'true';
+        return { mutated: true, value: 'true' };
+    }
+    return { mutated: false, value: current };
+}
+// ── Embedded HTTP server (src/session/embedded-server.ts) ────────────────
+export function getServerHost() {
+    return process.env.OPENCLAW_SERVER_HOST || '127.0.0.1';
+}
+/** Per-IP rate limit; falls back to RATE_LIMIT_MAX_REQUESTS if unset/invalid. */
+export function getRateLimit() {
+    return parseInt(process.env.OPENCLAW_RATE_LIMIT || '', 10) || RATE_LIMIT_MAX_REQUESTS;
+}
+/** Bearer token for embedded server. Undefined → no auth (default). */
+export function getServerToken() {
+    const t = process.env.OPENCLAW_SERVER_TOKEN;
+    return t === undefined || t === '' ? undefined : t;
+}
+/** True iff CORS is wildcarded via OPENCLAW_CORS_ORIGINS=*. */
+export function isCorsAllowAll() {
+    return process.env.OPENCLAW_CORS_ORIGINS === '*';
+}
+// ── Gateway proxy (src/session/session-manager.ts) ───────────────────────
+export function getGatewayUrl() {
+    const v = process.env.GATEWAY_URL;
+    return v === undefined || v === '' ? undefined : v;
+}
+export function getGatewayKey() {
+    const v = process.env.GATEWAY_KEY;
+    return v === undefined || v === '' ? undefined : v;
+}
+// ── Provider API keys (session-manager → proxy handler) ──────────────────
+// Each returns undefined when unset/empty so the proxy can decide whether
+// to omit the auth header entirely vs. pass an empty string.
+export function getAnthropicApiKey() {
+    const v = process.env.ANTHROPIC_API_KEY;
+    return v === undefined || v === '' ? undefined : v;
+}
+export function getOpenaiApiKey() {
+    const v = process.env.OPENAI_API_KEY;
+    return v === undefined || v === '' ? undefined : v;
+}
+export function getGeminiApiKey() {
+    const v = process.env.GEMINI_API_KEY;
+    return v === undefined || v === '' ? undefined : v;
+}
+// ── Engine binary overrides (session-manager._createSession + engines) ───
+// Returns undefined when unset so the persistent-*-session constructors
+// fall back to their built-in default (e.g. 'gemini', 'agent').
+export function getGeminiBin() {
+    const v = process.env.GEMINI_BIN;
+    return v === undefined || v === '' ? undefined : v;
+}
+export function getCodexBin() {
+    const v = process.env.CODEX_BIN;
+    return v === undefined || v === '' ? undefined : v;
+}
+export function getCursorBin() {
+    const v = process.env.CURSOR_BIN;
+    return v === undefined || v === '' ? undefined : v;
+}
+export function getClaudeBin() {
+    const v = process.env.CLAUDE_BIN;
+    return v === undefined || v === '' ? undefined : v;
+}
+/**
+ * PATH passed to spawned engine subprocesses. Falls back to the standard
+ * Unix path so binaries resolve even when the parent's PATH is unset
+ * (preserved from persistent-session.ts:257 + persistent-custom-session.ts:240).
+ */
+export function getProcessPath() {
+    return process.env.PATH || '/usr/local/bin:/usr/bin:/bin';
+}
+// ── Telemetry writers (src/lib/telemetry.ts) ─────────────────────────────
+// Default-ON, opt-out via OPENCLAW_TOKEN_TELEMETRY=0.
+// NOTE the divergence from `isTokenTelemetryEnabled()` above (which is the
+// cwd-patch route-patch gate, default-OFF, strict `=== '1'`). Same env var,
+// opposite defaults — pre-existing latent bug. Tracked for unification.
+export function isTokenTelemetryWriterEnabled() {
+    return process.env.OPENCLAW_TOKEN_TELEMETRY !== '0';
+}
+/** Strict opt-in — register-guard event logging via OPENCLAW_REGISTER_DEBUG=1. */
+export function isRegisterDebugEnabled() {
+    return process.env.OPENCLAW_REGISTER_DEBUG === '1';
+}
+// ── Heartbeat workaround kill-switch (src/lib/heartbeat-workaround.ts) ───
+// Strict opt-in — set CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND=1 to bypass.
+export function isHeartbeatWorkaroundDisabled() {
+    return process.env.CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND === '1';
+}
+// ── Telegram quota auto-pause (src/channels/telegram/live-card.ts) ───────
+// Returns parsed percent threshold (0-100). Default 95.
+export function getQuotaPausePct() {
+    const n = Number(process.env.OPENCLAW_QUOTA_PAUSE_PCT);
+    return Number.isFinite(n) ? n : 95;
+}
+// ── OpenAI-compat shim (src/openai-compat/openai-compat.ts) ──────────────
+/** Raw value for `isToolsPerMessageModeEnabled()` parsing. */
+export function getOpenaiCompatToolsPerMessage() {
+    const v = process.env.OPENAI_COMPAT_TOOLS_PER_MESSAGE;
+    return v === undefined || v === '' ? undefined : v;
+}
+/** Strict opt-in — legacy new-conversation heuristic via env=1. */
+export function isOpenaiCompatNewConvoHeuristic() {
+    return process.env.OPENAI_COMPAT_NEW_CONVO_HEURISTIC === '1';
+}
+export function getOpenaiCompatStatusUrl() {
+    const v = process.env.OPENAI_COMPAT_STATUS_URL;
+    return v === undefined || v === '' ? undefined : v;
+}
+// ── UX bridge sessions read-only check (src/channels/telegram/event-reducer.ts) ──
+// Read-only counterpart to `ensureUxBridgeAllSessionsDefault()` — used in
+// hot-path event handlers where the value is treated as a truthy gate.
+export function getUxBridgeAllSessions() {
+    const v = process.env.UX_BRIDGE_ALL_SESSIONS;
+    return v === undefined || v === '' ? undefined : v;
+}
+// ── Anthropic base URL (src/proxy/handler.ts layer 1) ────────────────────
+// proxy/handler.ts owns the higher-level resolver
+// (env → openclaw.json → default); this getter only exposes the raw env.
+export function getAnthropicBaseUrlEnv() {
+    const v = process.env.ANTHROPIC_BASE_URL;
+    return v === undefined || v === '' ? undefined : v;
+}
+// ── Savvy live card gate (src/channels/telegram/tool-tracker.ts) ─────────
+export function isSavvyLiveCardEnabled() {
+    const v = process.env.SAVVY_LIVE_CARD;
+    return !!(v && v !== '');
+}
+// ── Council transcript dir base (src/council/council.ts) ─────────────────
+// Preserves bit-for-bit the original `process.env.HOME || '/tmp'` fallback.
+// Note: differs from os.homedir() which never returns '/tmp' as fallback.
+export function getHomeOrTmp() {
+    return process.env.HOME || '/tmp';
+}
+// ── Health port override (src/health/handler.ts) ─────────────────────────
+// health/handler.ts owns the validation (range check 1-65535). This getter
+// only exposes the raw env so the validator stays where it is.
+export function getHealthPortEnv() {
+    const v = process.env.CC_OPENCLAW_HEALTH_PORT;
+    return v === undefined || v === '' ? undefined : v;
+}
+// ── Drift detection (src/lib/drift-detector.ts) ───────────────────────────
+// Default-ON. Opt-out via OPENCLAW_CC_OPENCLAW_DRIFT_ALERTS=0.
+export function isDriftAlertsEnabled() {
+    return process.env.OPENCLAW_CC_OPENCLAW_DRIFT_ALERTS !== '0';
+}
+/** Dedup window for repeated drift Telegram alerts. Default 1h. */
+export function getDriftDedupeWindowMs() {
+    const v = process.env.OPENCLAW_CC_OPENCLAW_DRIFT_DEDUPE_WINDOW_MS;
+    const n = v !== undefined ? parseInt(v, 10) : NaN;
+    return Number.isFinite(n) && n > 0 ? n : 3_600_000;
+}
+// ── Auto-recovery (src/lib/auto-recovery.ts) ─────────────────────────────
+// Default-ON. Opt-out via OPENCLAW_CC_OPENCLAW_AUTO_RECOVERY=0.
+export function isAutoRecoveryEnabled() {
+    return process.env.OPENCLAW_CC_OPENCLAW_AUTO_RECOVERY !== '0';
+}
+//# sourceMappingURL=config.js.map

package/dist/src/lib/config.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * drift-detector — cross-laptop version mismatch detection.
+ *
+ * On register() and every 5 minutes (default), captures:
+ *   { laptopId, ccOpenclawBuildHash, openclawBinaryVersion, claudeCodeVersion, ts }
+ *
+ * Writes to ~/.openclaw/state/cc-openclaw-version-state.json (one slot per
+ * laptopId) per handoff system slot rule. Compares own slot vs other laptop
+ * slots; on mismatch fires Telegram alert + drift.jsonl row with 1h dedup.
+ *
+ * Configurable via:
+ *   OPENCLAW_CC_OPENCLAW_DRIFT_ALERTS=0          — disable Telegram noise
+ *   OPENCLAW_CC_OPENCLAW_DRIFT_DEDUPE_WINDOW_MS  — dedup window (default 3600000)
+ */
+export interface VersionSlot {
+    laptopId: string;
+    ccOpenclawBuildHash: string;
+    openclawBinaryVersion: string;
+    claudeCodeVersion: string;
+    ts: string;
+    [key: string]: string;
+}
+export type VersionStateFile = Record<string, VersionSlot>;
+export interface DriftReport {
+    detected: boolean;
+    ownSlot: VersionSlot;
+    conflictingSlots: Array<{
+        laptopId: string;
+        slot: VersionSlot;
+        fields: string[];
+    }>;
+}
+export declare function captureVersionSlot(): VersionSlot;
+/** Test-only reset. */
+export declare function _resetDriftAlertForTests(): void;
+/**
+ * Capture own slot, update state file, compare with other laptops.
+ * Fires Telegram + jsonl on mismatch (with 1h dedup).
+ *
+ * Returns the DriftReport so callers can react programmatically.
+ */
+export declare function checkDrift(): Promise<DriftReport>;
+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/drift-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../../../src/lib/drift-detector.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AA2BH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,gBAAgB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACpF;AAuCD,wBAAgB,kBAAkB,IAAI,WAAW,CAQhD;AAgED,uBAAuB;AACvB,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAID;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,CAuCvD;AAMD,wBAAgB,iBAAiB,IAAI,IAAI,CAYxC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}