@a1hvdy/cc-openclaw 0.21.2 → 0.23.0

package/dist/src/lib/perf/direct-sdk.js

@@ -0,0 +1,58 @@
+/**
+ * M12 (perf overhaul idea #12) — direct claude-code SDK in-process.
+ *
+ * Bypasses the `claude` CLI subprocess entirely by calling the
+ * `@anthropic-ai/claude-code` SDK in the cc-openclaw Node process.
+ * Eliminates all subprocess overhead (Node bootstrap, bundle parse, auth
+ * handshake) at the cost of losing CLI session/checkpoint features and
+ * recoupling to upstream SDK API churn.
+ *
+ * Flag: CC_OPENCLAW_PERF_DIRECT_SDK (default OFF, HIGH RISK — ships LAST
+ * with the resident-CLI pool as the fallback).
+ *
+ * Probes the SDK availability without bringing it as a hard dependency:
+ * dynamic require with a swallowed ENOENT. The actual invocation is
+ * delegated to the registered handler — session-manager owns the call
+ * details (model, prompt, options) and decides whether the SDK supports
+ * the requested feature set for this turn.
+ */
+import { createRequire } from 'node:module';
+import { getPerfDirectSdkEnabled } from '../config.js';
+const requireFromHere = createRequire(import.meta.url);
+let cachedProbe = null;
+export function probeDirectSdkAvailability() {
+    if (!getPerfDirectSdkEnabled()) {
+        return { enabled: false, available: false, reason: 'flag_off', version: null };
+    }
+    if (cachedProbe && cachedProbe.reason !== 'probe_error')
+        return cachedProbe;
+    try {
+        // Dynamic require path — never bring the SDK as a hard dependency.
+        const mod = requireFromHere('@anthropic-ai/claude-code');
+        if (!mod) {
+            cachedProbe = { enabled: true, available: false, reason: 'sdk_missing', version: null };
+            return cachedProbe;
+        }
+        cachedProbe = {
+            enabled: true,
+            available: true,
+            reason: 'sdk_loaded',
+            version: mod.VERSION ?? null,
+        };
+        return cachedProbe;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('Cannot find module')) {
+            cachedProbe = { enabled: true, available: false, reason: 'sdk_missing', version: null };
+        }
+        else {
+            cachedProbe = { enabled: true, available: false, reason: 'probe_error', version: null };
+        }
+        return cachedProbe;
+    }
+}
+export function _resetDirectSdkProbeForTests() {
+    cachedProbe = null;
+}
+//# sourceMappingURL=direct-sdk.js.map

package/dist/src/lib/perf/direct-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-sdk.js","sourceRoot":"","sources":["../../../../src/lib/perf/direct-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AASvD,IAAI,WAAW,GAAiC,IAAI,CAAC;AAErD,MAAM,UAAU,0BAA0B;IACxC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjF,CAAC;IACD,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,WAAW,CAAC;IAC5E,IAAI,CAAC;QACH,mEAAmE;QACnE,MAAM,GAAG,GAAG,eAAe,CAAC,2BAA2B,CAAqC,CAAC;QAC7F,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACxF,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,WAAW,GAAG;YACZ,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;SAC7B,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACvC,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1F,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/dist/src/lib/perf/haiku-route.d.ts

@@ -0,0 +1,19 @@
+/**
+ * M10 (perf overhaul idea #10) — Haiku 4.5 cheap-route classifier.
+ *
+ * Pattern-matches trivial queries that don't need Opus-level reasoning:
+ * status checks, simple acks, short factual lookups. When matched, the
+ * caller routes the request to Haiku via the OpenAI-compat fallback
+ * pipeline (NOT direct Anthropic API — A1 has no anthropic.com key, only
+ * Max 20x subscription). Sub-500ms; zero Max quota burn.
+ *
+ * Flag: CC_OPENCLAW_PERF_HAIKU_ROUTE (default OFF).
+ *
+ * Conservative by design: any uncertainty falls back to Opus. False positives
+ * are user-visible quality regressions; false negatives just miss a perf win.
+ */
+export interface RouteDecision {
+    routeToHaiku: boolean;
+    reason: 'trivial_pattern' | 'too_long' | 'complex_token' | 'flag_off' | 'no_match';
+}
+export declare function classifyForHaikuRoute(prompt: string): RouteDecision;

package/dist/src/lib/perf/haiku-route.js

@@ -0,0 +1,49 @@
+/**
+ * M10 (perf overhaul idea #10) — Haiku 4.5 cheap-route classifier.
+ *
+ * Pattern-matches trivial queries that don't need Opus-level reasoning:
+ * status checks, simple acks, short factual lookups. When matched, the
+ * caller routes the request to Haiku via the OpenAI-compat fallback
+ * pipeline (NOT direct Anthropic API — A1 has no anthropic.com key, only
+ * Max 20x subscription). Sub-500ms; zero Max quota burn.
+ *
+ * Flag: CC_OPENCLAW_PERF_HAIKU_ROUTE (default OFF).
+ *
+ * Conservative by design: any uncertainty falls back to Opus. False positives
+ * are user-visible quality regressions; false negatives just miss a perf win.
+ */
+import { getPerfHaikuRouteEnabled } from '../config.js';
+const TRIVIAL_PATTERNS = [
+    /^(status|ping|hi|hello|hey|yo|ack|ok|okay|thanks|thx|ty)\s*[.!?]?\s*$/i,
+    /^(what'?s\s+(?:the\s+)?(?:time|date|day))\s*\??\s*$/i,
+    /^(are\s+you\s+(?:there|alive|up|online))\s*\??\s*$/i,
+    /^(version|uptime|health)\s*\??\s*$/i,
+];
+const COMPLEX_TOKENS = [
+    'write', 'create', 'build', 'implement', 'fix', 'debug', 'analyze',
+    'explain', 'refactor', 'review', 'design', 'plan', 'why', 'how',
+    'compare', 'recommend', 'suggest', 'should', 'would', 'could',
+];
+const TRIVIAL_MAX_CHARS = 60;
+export function classifyForHaikuRoute(prompt) {
+    if (!getPerfHaikuRouteEnabled())
+        return { routeToHaiku: false, reason: 'flag_off' };
+    if (!prompt || typeof prompt !== 'string')
+        return { routeToHaiku: false, reason: 'no_match' };
+    const trimmed = prompt.trim();
+    if (trimmed.length === 0)
+        return { routeToHaiku: false, reason: 'no_match' };
+    if (trimmed.length > TRIVIAL_MAX_CHARS)
+        return { routeToHaiku: false, reason: 'too_long' };
+    const lower = trimmed.toLowerCase();
+    for (const token of COMPLEX_TOKENS) {
+        if (lower.includes(token))
+            return { routeToHaiku: false, reason: 'complex_token' };
+    }
+    for (const pat of TRIVIAL_PATTERNS) {
+        if (pat.test(trimmed))
+            return { routeToHaiku: true, reason: 'trivial_pattern' };
+    }
+    return { routeToHaiku: false, reason: 'no_match' };
+}
+//# sourceMappingURL=haiku-route.js.map

package/dist/src/lib/perf/haiku-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"haiku-route.js","sourceRoot":"","sources":["../../../../src/lib/perf/haiku-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,gBAAgB,GAAa;IACjC,wEAAwE;IACxE,sDAAsD;IACtD,qDAAqD;IACrD,qCAAqC;CACtC,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS;IAClE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAC/D,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;CAC9D,CAAC;AAOF,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,IAAI,CAAC,wBAAwB,EAAE;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACpF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9F,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC7E,IAAI,OAAO,CAAC,MAAM,GAAG,iBAAiB;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3F,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACrF,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC"}

package/dist/src/lib/perf/predictive-continuation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * M11 (perf overhaul idea #11) — predictive continuation detector.
+ *
+ * Returns a confident yes/no when a user's incoming message is a pure
+ * continuation request ("more", "continue", "and?", "go on"). When true,
+ * the caller can start generation against the previous turn's tail before
+ * the user finishes typing, giving the perceived-instant feel on common
+ * follow-ups. False on ambiguous input keeps the regular dispatch path.
+ *
+ * Flag: CC_OPENCLAW_PERF_PREDICTIVE_CONTINUE (default OFF).
+ */
+export interface ContinuationDecision {
+    /** True iff the text is a confident continuation request. */
+    isContinuation: boolean;
+    /** Matched pattern source for telemetry; empty when isContinuation=false. */
+    matched: string;
+}
+export declare function isPredictiveContinuation(text: string): ContinuationDecision;

package/dist/src/lib/perf/predictive-continuation.js

@@ -0,0 +1,37 @@
+/**
+ * M11 (perf overhaul idea #11) — predictive continuation detector.
+ *
+ * Returns a confident yes/no when a user's incoming message is a pure
+ * continuation request ("more", "continue", "and?", "go on"). When true,
+ * the caller can start generation against the previous turn's tail before
+ * the user finishes typing, giving the perceived-instant feel on common
+ * follow-ups. False on ambiguous input keeps the regular dispatch path.
+ *
+ * Flag: CC_OPENCLAW_PERF_PREDICTIVE_CONTINUE (default OFF).
+ */
+import { getPerfPredictiveContinueEnabled } from '../config.js';
+const CONTINUATION_PATTERNS = [
+    /^\s*(more|continue|go\s*on|keep\s*going|next|and\??|then\??|\.\.\.)\s*[.!?]?\s*$/i,
+    /^\s*(go|do)\s+(on|ahead)\s*[.!?]?\s*$/i,
+    /^\s*(yes|yep|yeah|ok|okay|sure)[,!.?]?\s+(more|continue|go\s*on|please)\s*[.!?]?\s*$/i,
+];
+export function isPredictiveContinuation(text) {
+    if (!getPerfPredictiveContinueEnabled()) {
+        return { isContinuation: false, matched: '' };
+    }
+    if (!text || typeof text !== 'string') {
+        return { isContinuation: false, matched: '' };
+    }
+    const trimmed = text.trim();
+    // Hard length cap — anything over 40 chars is too substantive to predict.
+    if (trimmed.length === 0 || trimmed.length > 40) {
+        return { isContinuation: false, matched: '' };
+    }
+    for (const pat of CONTINUATION_PATTERNS) {
+        if (pat.test(trimmed)) {
+            return { isContinuation: true, matched: pat.source };
+        }
+    }
+    return { isContinuation: false, matched: '' };
+}
+//# sourceMappingURL=predictive-continuation.js.map

package/dist/src/lib/perf/predictive-continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictive-continuation.js","sourceRoot":"","sources":["../../../../src/lib/perf/predictive-continuation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,qBAAqB,GAAa;IACtC,mFAAmF;IACnF,wCAAwC;IACxC,uFAAuF;CACxF,CAAC;AASF,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,IAAI,CAAC,gCAAgC,EAAE,EAAE,CAAC;QACxC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAChD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAChD,CAAC"}

package/dist/src/lib/perf/read-batch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * M7 (perf overhaul idea #7) — Read([paths]) parallel batch reader.
+ *
+ * The legacy flow is N serial Read tool calls = N LLM round trips. This
+ * helper reads an array of paths concurrently in a single Node.js step,
+ * returning a structured result the tool-router collapses into one
+ * tool_result delta. Eliminates the per-file LLM round trip cost.
+ *
+ * Flag: CC_OPENCLAW_PERF_READ_BATCH (default OFF, medium risk — tool
+ * schema change requires sub-agent training to use the batched form).
+ *
+ * Per-file failures are isolated: an unreadable file produces an error
+ * entry in the result rather than failing the whole batch. Encoding is
+ * fixed to utf8 to match the existing Read tool semantics.
+ */
+export interface BatchReadEntry {
+    path: string;
+    content: string | null;
+    error: string | null;
+    bytes: number;
+}
+export interface BatchReadResult {
+    enabled: boolean;
+    entries: BatchReadEntry[];
+    totalBytes: number;
+    errorCount: number;
+}
+/**
+ * Read up to MAX_BATCH_SIZE paths in parallel. When the flag is off,
+ * returns `enabled: false` with an empty entry list — caller falls back
+ * to the per-file path. Per-file failures populate `.error`, not throw.
+ */
+export declare function batchReadPaths(paths: string[]): Promise<BatchReadResult>;

package/dist/src/lib/perf/read-batch.js

@@ -0,0 +1,48 @@
+/**
+ * M7 (perf overhaul idea #7) — Read([paths]) parallel batch reader.
+ *
+ * The legacy flow is N serial Read tool calls = N LLM round trips. This
+ * helper reads an array of paths concurrently in a single Node.js step,
+ * returning a structured result the tool-router collapses into one
+ * tool_result delta. Eliminates the per-file LLM round trip cost.
+ *
+ * Flag: CC_OPENCLAW_PERF_READ_BATCH (default OFF, medium risk — tool
+ * schema change requires sub-agent training to use the batched form).
+ *
+ * Per-file failures are isolated: an unreadable file produces an error
+ * entry in the result rather than failing the whole batch. Encoding is
+ * fixed to utf8 to match the existing Read tool semantics.
+ */
+import { readFile } from 'node:fs/promises';
+import { getPerfReadBatchEnabled } from '../config.js';
+const MAX_BATCH_SIZE = 16;
+const PER_FILE_BYTE_CAP = 1_048_576;
+/**
+ * Read up to MAX_BATCH_SIZE paths in parallel. When the flag is off,
+ * returns `enabled: false` with an empty entry list — caller falls back
+ * to the per-file path. Per-file failures populate `.error`, not throw.
+ */
+export async function batchReadPaths(paths) {
+    if (!getPerfReadBatchEnabled()) {
+        return { enabled: false, entries: [], totalBytes: 0, errorCount: 0 };
+    }
+    if (!Array.isArray(paths) || paths.length === 0) {
+        return { enabled: true, entries: [], totalBytes: 0, errorCount: 0 };
+    }
+    const slice = paths.slice(0, MAX_BATCH_SIZE);
+    const entries = await Promise.all(slice.map(async (p) => {
+        try {
+            const buf = await readFile(p, 'utf8');
+            const content = buf.length > PER_FILE_BYTE_CAP ? buf.slice(0, PER_FILE_BYTE_CAP) : buf;
+            return { path: p, content, error: null, bytes: content.length };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { path: p, content: null, error: msg, bytes: 0 };
+        }
+    }));
+    const totalBytes = entries.reduce((s, e) => s + e.bytes, 0);
+    const errorCount = entries.filter((e) => e.error !== null).length;
+    return { enabled: true, entries, totalBytes, errorCount };
+}
+//# sourceMappingURL=read-batch.js.map

package/dist/src/lib/perf/read-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-batch.js","sourceRoot":"","sources":["../../../../src/lib/perf/read-batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAgBvD,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAe;IAClD,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAA2B,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACvF,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAC5D,CAAC"}

package/dist/src/lib/perf/resident-cli-pool.d.ts

@@ -0,0 +1,39 @@
+/**
+ * M1 (perf overhaul idea #1) — resident-CLI pool per chat_id.
+ *
+ * Tracks per-chat persistent `claude` child handles. The actual spawn,
+ * stdin framing, and process supervision belong to session-manager —
+ * this module owns the (chatId → handle) map, the acquire/release
+ * lifecycle, and the idle-eviction watchdog.
+ *
+ * Flag: CC_OPENCLAW_PERF_RESIDENT_CLI (default OFF, medium risk —
+ * lifecycle/leak management requires watchdog).
+ *
+ * Eviction: handles idle longer than IDLE_TIMEOUT_MS are released. Cap
+ * at MAX_POOL_SIZE prevents unbounded growth on multi-chat workloads.
+ */
+export declare const IDLE_TIMEOUT_MS: number;
+export declare const MAX_POOL_SIZE = 32;
+export interface ResidentCliHandle {
+    /** Opaque per-process identifier; session-manager owns the actual subprocess. */
+    pid: number;
+    chatId: string;
+    spawnedAt: number;
+    lastUsedAt: number;
+}
+export interface AcquireResult {
+    enabled: boolean;
+    handle: ResidentCliHandle | null;
+    reason: 'flag_off' | 'cached' | 'evicted_stale' | 'pool_full' | 'no_factory';
+}
+/** Register the actual spawn callback. Called by session-manager bootstrap. */
+export declare function setHandleFactory(fn: ((chatId: string) => ResidentCliHandle | null) | null): void;
+/**
+ * Acquire (or create) the resident handle for chatId. Evicts stale handles
+ * before serving new ones so the eviction work is amortized across acquires.
+ */
+export declare function acquireResidentCli(chatId: string, now?: number): AcquireResult;
+/** Release the handle (does not kill the subprocess; just marks idle). */
+export declare function releaseResidentCli(chatId: string): boolean;
+export declare function getPoolSize(): number;
+export declare function _resetResidentCliPoolForTests(): void;

package/dist/src/lib/perf/resident-cli-pool.js

@@ -0,0 +1,60 @@
+/**
+ * M1 (perf overhaul idea #1) — resident-CLI pool per chat_id.
+ *
+ * Tracks per-chat persistent `claude` child handles. The actual spawn,
+ * stdin framing, and process supervision belong to session-manager —
+ * this module owns the (chatId → handle) map, the acquire/release
+ * lifecycle, and the idle-eviction watchdog.
+ *
+ * Flag: CC_OPENCLAW_PERF_RESIDENT_CLI (default OFF, medium risk —
+ * lifecycle/leak management requires watchdog).
+ *
+ * Eviction: handles idle longer than IDLE_TIMEOUT_MS are released. Cap
+ * at MAX_POOL_SIZE prevents unbounded growth on multi-chat workloads.
+ */
+import { getPerfResidentCliEnabled } from '../config.js';
+export const IDLE_TIMEOUT_MS = 5 * 60_000;
+export const MAX_POOL_SIZE = 32;
+const pool = new Map();
+let handleFactory = null;
+/** Register the actual spawn callback. Called by session-manager bootstrap. */
+export function setHandleFactory(fn) {
+    handleFactory = fn;
+}
+/**
+ * Acquire (or create) the resident handle for chatId. Evicts stale handles
+ * before serving new ones so the eviction work is amortized across acquires.
+ */
+export function acquireResidentCli(chatId, now = Date.now()) {
+    if (!getPerfResidentCliEnabled())
+        return { enabled: false, handle: null, reason: 'flag_off' };
+    if (!chatId)
+        return { enabled: true, handle: null, reason: 'no_factory' };
+    // Evict stale handles first.
+    for (const [k, v] of pool) {
+        if (now - v.lastUsedAt > IDLE_TIMEOUT_MS)
+            pool.delete(k);
+    }
+    const existing = pool.get(chatId);
+    if (existing) {
+        existing.lastUsedAt = now;
+        return { enabled: true, handle: existing, reason: 'cached' };
+    }
+    if (pool.size >= MAX_POOL_SIZE) {
+        return { enabled: true, handle: null, reason: 'pool_full' };
+    }
+    if (!handleFactory)
+        return { enabled: true, handle: null, reason: 'no_factory' };
+    const handle = handleFactory(chatId);
+    if (!handle)
+        return { enabled: true, handle: null, reason: 'no_factory' };
+    pool.set(chatId, handle);
+    return { enabled: true, handle, reason: 'cached' };
+}
+/** Release the handle (does not kill the subprocess; just marks idle). */
+export function releaseResidentCli(chatId) {
+    return pool.delete(chatId);
+}
+export function getPoolSize() { return pool.size; }
+export function _resetResidentCliPoolForTests() { pool.clear(); handleFactory = null; }
+//# sourceMappingURL=resident-cli-pool.js.map

package/dist/src/lib/perf/resident-cli-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resident-cli-pool.js","sourceRoot":"","sources":["../../../../src/lib/perf/resident-cli-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAUhC,MAAM,IAAI,GAAG,IAAI,GAAG,EAA6B,CAAC;AAQlD,IAAI,aAAa,GAA0D,IAAI,CAAC;AAEhF,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,EAAyD;IACxF,aAAa,GAAG,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACzE,IAAI,CAAC,yBAAyB,EAAE;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9F,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC1E,6BAA6B;IAC7B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,GAAG,GAAG,CAAC,CAAC,UAAU,GAAG,eAAe;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,IAAI,aAAa,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACjF,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC1E,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW,KAAa,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,MAAM,UAAU,6BAA6B,KAAW,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC"}

package/dist/src/lib/perf/skill-list-collapse.d.ts

@@ -0,0 +1,22 @@
+/**
+ * M4 (perf overhaul idea #4) — collapse <available_skills> sysprompt block.
+ *
+ * The block is ~3K tokens of skill names + descriptions. Almost every turn
+ * the user invokes 0 or 1 skill, so the full listing is dead weight in the
+ * cache-relevant prefix. This collapses it to a one-line hint that points
+ * the model at an on-demand `openclaw skills list` tool call.
+ *
+ * The collapse is text-level so it composes with sysprompt-strip.ts without
+ * coupling to its pipeline. Caller invokes after the strip pass.
+ *
+ * Flag: CC_OPENCLAW_PERF_SKILL_ONDEMAND (default OFF).
+ *
+ * Idempotent — replacing an already-collapsed sysprompt is a no-op.
+ */
+export interface CollapseResult {
+    content: string;
+    changed: boolean;
+    bytesRemoved: number;
+}
+/** Collapse the <available_skills> block; no-op when the flag is off. */
+export declare function collapseSkillList(sysprompt: string): CollapseResult;

package/dist/src/lib/perf/skill-list-collapse.js

@@ -0,0 +1,35 @@
+/**
+ * M4 (perf overhaul idea #4) — collapse <available_skills> sysprompt block.
+ *
+ * The block is ~3K tokens of skill names + descriptions. Almost every turn
+ * the user invokes 0 or 1 skill, so the full listing is dead weight in the
+ * cache-relevant prefix. This collapses it to a one-line hint that points
+ * the model at an on-demand `openclaw skills list` tool call.
+ *
+ * The collapse is text-level so it composes with sysprompt-strip.ts without
+ * coupling to its pipeline. Caller invokes after the strip pass.
+ *
+ * Flag: CC_OPENCLAW_PERF_SKILL_ONDEMAND (default OFF).
+ *
+ * Idempotent — replacing an already-collapsed sysprompt is a no-op.
+ */
+import { getPerfSkillOnDemandEnabled } from '../config.js';
+const SKILL_BLOCK_RE = /<available_skills>[\s\S]*?<\/available_skills>/g;
+const HINT_LINE = '<available_skills>Skills are available via the `openclaw skills list` tool. Invoke it when the user mentions a slash-command or asks "what skills are available?" — do not list them proactively.</available_skills>';
+/** Collapse the <available_skills> block; no-op when the flag is off. */
+export function collapseSkillList(sysprompt) {
+    if (!getPerfSkillOnDemandEnabled()) {
+        return { content: sysprompt, changed: false, bytesRemoved: 0 };
+    }
+    let bytesRemoved = 0;
+    let changed = false;
+    const content = sysprompt.replace(SKILL_BLOCK_RE, (match) => {
+        if (match === HINT_LINE)
+            return match;
+        bytesRemoved += match.length - HINT_LINE.length;
+        changed = true;
+        return HINT_LINE;
+    });
+    return { content, changed, bytesRemoved };
+}
+//# sourceMappingURL=skill-list-collapse.js.map

package/dist/src/lib/perf/skill-list-collapse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-list-collapse.js","sourceRoot":"","sources":["../../../../src/lib/perf/skill-list-collapse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,cAAc,GAAG,iDAAiD,CAAC;AACzE,MAAM,SAAS,GACb,sNAAsN,CAAC;AAQzN,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,IAAI,CAAC,2BAA2B,EAAE,EAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1D,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,YAAY,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAChD,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAC5C,CAAC"}

package/dist/src/lib/perf/typing-prefetch.d.ts

@@ -0,0 +1,25 @@
+/**
+ * M2 (perf overhaul idea #2) — typing-prefetch subprocess warmup.
+ *
+ * Telegram emits `sendChatAction` upstream events while the user is typing
+ * (the "typing…" indicator). This module debounces those signals into a
+ * single "warm the subprocess pool for this chatId" trigger, then invokes
+ * the registered warmup callback. The actual subprocess.spawn() is owned
+ * by the session-manager / cli pool — this module is just the signal layer.
+ *
+ * Flag: CC_OPENCLAW_PERF_TYPING_PREFETCH (default OFF).
+ *
+ * Coalescing: at most one warmup per chatId per WARMUP_COOLDOWN_MS. Prevents
+ * "typing… typing… typing…" hammer events from spawning N subprocesses.
+ */
+export declare const WARMUP_COOLDOWN_MS = 4000;
+/** Register the actual warmup callback (called by session-manager bootstrap). */
+export declare function setWarmupHandler(fn: ((chatId: string) => void) | null): void;
+/**
+ * Notify that user is typing in chatId. Triggers warmup at most once per
+ * cooldown window. No-op when flag off, no handler registered, or in cooldown.
+ * Returns true iff a warmup was actually triggered.
+ */
+export declare function notifyTyping(chatId: string, now?: number): boolean;
+/** Test hook — reset the cooldown map. */
+export declare function _resetTypingPrefetchForTests(): void;

package/dist/src/lib/perf/typing-prefetch.js

@@ -0,0 +1,54 @@
+/**
+ * M2 (perf overhaul idea #2) — typing-prefetch subprocess warmup.
+ *
+ * Telegram emits `sendChatAction` upstream events while the user is typing
+ * (the "typing…" indicator). This module debounces those signals into a
+ * single "warm the subprocess pool for this chatId" trigger, then invokes
+ * the registered warmup callback. The actual subprocess.spawn() is owned
+ * by the session-manager / cli pool — this module is just the signal layer.
+ *
+ * Flag: CC_OPENCLAW_PERF_TYPING_PREFETCH (default OFF).
+ *
+ * Coalescing: at most one warmup per chatId per WARMUP_COOLDOWN_MS. Prevents
+ * "typing… typing… typing…" hammer events from spawning N subprocesses.
+ */
+import { getPerfTypingPrefetchEnabled } from '../config.js';
+export const WARMUP_COOLDOWN_MS = 4_000;
+const lastWarmupAt = new Map();
+let warmupFn = null;
+/** Register the actual warmup callback (called by session-manager bootstrap). */
+export function setWarmupHandler(fn) {
+    warmupFn = fn;
+}
+/**
+ * Notify that user is typing in chatId. Triggers warmup at most once per
+ * cooldown window. No-op when flag off, no handler registered, or in cooldown.
+ * Returns true iff a warmup was actually triggered.
+ */
+export function notifyTyping(chatId, now = Date.now()) {
+    if (!getPerfTypingPrefetchEnabled())
+        return false;
+    if (!chatId || !warmupFn)
+        return false;
+    const last = lastWarmupAt.get(chatId);
+    // First call for this chat always fires; subsequent calls gate on cooldown.
+    // Using has-check (not `|| 0`) so the first call works regardless of `now`'s
+    // absolute magnitude — earlier `now - last < cooldown` rejected first calls
+    // when now < WARMUP_COOLDOWN_MS.
+    if (last !== undefined && now - last < WARMUP_COOLDOWN_MS)
+        return false;
+    lastWarmupAt.set(chatId, now);
+    try {
+        warmupFn(chatId);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Test hook — reset the cooldown map. */
+export function _resetTypingPrefetchForTests() {
+    lastWarmupAt.clear();
+    warmupFn = null;
+}
+//# sourceMappingURL=typing-prefetch.js.map

package/dist/src/lib/perf/typing-prefetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-prefetch.js","sourceRoot":"","sources":["../../../../src/lib/perf/typing-prefetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC/C,IAAI,QAAQ,GAAsC,IAAI,CAAC;AAEvD,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,EAAqC;IACpE,QAAQ,GAAG,EAAE,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACnE,IAAI,CAAC,4BAA4B,EAAE;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,iCAAiC;IACjC,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,GAAG,IAAI,GAAG,kBAAkB;QAAE,OAAO,KAAK,CAAC;IACxE,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,4BAA4B;IAC1C,YAAY,CAAC,KAAK,EAAE,CAAC;IACrB,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/src/observability/perf-telemetry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Perf-baseline telemetry (M8 — cache-miss-telemetry).
+ *
+ * Appends structured perf events to `~/.openclaw/workspace/memory/sysprompt-cost.jsonl`
+ * alongside the existing token-cost records. Every record carries an `event`
+ * field so consumers can filter:
+ *
+ *   - "token_cost"  → legacy per-request sysprompt+user char/token estimate
+ *                     (emitted by cwd-patch.ts; tagged by this module on read).
+ *   - "cache_check" → outcome of the Track-B cache parity decision: hit/miss
+ *                     with a structured `cause` (registry_empty | hash_mismatch
+ *                     | session_unknown | disabled). Drives idea #8.
+ *   - "first_byte"  → first user-visible content delta sent to the SSE client.
+ *                     `elapsed_ms` is measured from request receive (turnStartMs
+ *                     in streaming-handler.ts). This is the baseline for the
+ *                     plan's ≥50% p50 latency drop exit criterion.
+ *   - "turn_end"    → final SSE stop chunk written. `elapsed_ms` is total turn
+ *                     wall-clock. Pair with first_byte to derive generation-vs-
+ *                     latency split per turn.
+ *
+ * Flag: CC_OPENCLAW_PERF_CACHE_TELEMETRY (default ON; opt-out with 0/false/off).
+ * Goes through the same shim pattern as the legacy telemetry getters
+ * (ConfigService when present, env fallback for tests).
+ *
+ * Why same file as token_cost: the plan's verify query targets sysprompt-cost.jsonl
+ * directly; splitting would require operators to remember two paths and would
+ * break the single `jq` pipeline. The `event` field makes filtering trivial.
+ */
+export declare const PERF_TELEMETRY_PATH: string;
+export type PerfEventName = 'cache_check' | 'first_byte' | 'turn_end';
+export type CacheCheckCause = 'hit' | 'registry_empty' | 'hash_mismatch' | 'session_unknown' | 'disabled';
+interface PerfEventBase {
+    event: PerfEventName;
+    sessionKey?: string;
+}
+export interface CacheCheckEvent extends PerfEventBase {
+    event: 'cache_check';
+    outcome: 'hit' | 'miss';
+    cause: CacheCheckCause;
+    sysHash?: string;
+}
+export interface FirstByteEvent extends PerfEventBase {
+    event: 'first_byte';
+    elapsed_ms: number;
+    model?: string;
+    tool_stream?: boolean;
+}
+export interface TurnEndEvent extends PerfEventBase {
+    event: 'turn_end';
+    elapsed_ms: number;
+    first_byte_ms?: number;
+    finish_reason?: 'stop' | 'tool_calls' | 'length' | string;
+    tool_calls?: number;
+    bytes_out?: number;
+}
+export type PerfEvent = CacheCheckEvent | FirstByteEvent | TurnEndEvent;
+/**
+ * Append a perf event to sysprompt-cost.jsonl. No-op when the flag is off
+ * or when an I/O error occurs — telemetry must never break a live turn.
+ */
+export declare function writePerfEvent(event: PerfEvent): void;
+/** Test hook — replace the file-writing sink with an in-memory collector. */
+export declare function _setPerfWriterForTests(w: (line: string) => void): void;
+/** Test hook — restore the default file-writing sink. */
+export declare function _restorePerfWriterForTests(): void;
+export {};