@a1hvdy/cc-openclaw 0.30.0 → 0.32.0

package/dist/src/health/metrics.d.ts

@@ -1,52 +0,0 @@
-/**
- * In-memory metrics registry exposing Prometheus exposition format at /metrics.
- *
- * Pure singleton; no external deps. Counters increment monotonically. Gauges
- * track current value. Histograms accumulate observation buckets.
- *
- * v0.4.0 Pillar A — minimum viable observability set:
- *   cc_openclaw_requests_total{status}
- *   cc_openclaw_workers
- *   cc_openclaw_uptime_seconds
- *   cc_openclaw_errors_total{code}
- *   cc_openclaw_last_error_seconds
- *
- * Future v0.4.x can add tokens_total, ttft_seconds histogram, cache_hits/misses,
- * tool_uses_total. The serializer + endpoint don't need changes.
- */
-type LabelValues = Readonly<Record<string, string>>;
-declare class Counter {
-    readonly name: string;
-    readonly help: string;
-    private values;
-    constructor(name: string, help: string);
-    inc(labels?: LabelValues, by?: number): void;
-    serialize(): string;
-    reset(): void;
-}
-declare class Gauge {
-    readonly name: string;
-    readonly help: string;
-    private value;
-    private dynamic;
-    constructor(name: string, help: string);
-    set(v: number): void;
-    /** Bind to a function — read on every serialization (for things like uptime). */
-    bind(fn: () => number): void;
-    serialize(): string;
-    reset(): void;
-}
-declare class Registry {
-    readonly requestsTotal: Counter;
-    readonly workers: Gauge;
-    readonly uptimeSeconds: Gauge;
-    readonly errorsTotal: Counter;
-    readonly lastErrorSeconds: Gauge;
-    constructor();
-    serializePrometheus(): string;
-    recordError(code: string): void;
-    resetForTests(): void;
-}
-export declare const metricsRegistry: Registry;
-export declare const PROMETHEUS_CONTENT_TYPE = "text/plain; version=0.0.4; charset=utf-8";
-export {};

package/dist/src/index.d.ts

@@ -1,57 +0,0 @@
-/**
- * cc-openclaw plugin entry — A1xAI's Anthropic CLI bridge plugin for OpenClaw.
- *
- * Registers all module-level register() handlers through a single top-level
- * register(api) call. Each module owns its own register-guard idempotency,
- * so re-calls are safe; the top-level guard here protects against repeated
- * plugin loads emitting duplicate top-level wiring.
- *
- * Module wiring order matters for one reason: cwd-patch + runtime stub
- * injection must run BEFORE any session start so the cwd is already
- * adjusted by the time engines spawn. All others are order-independent.
- */
-import { getConfigService } from './lib/config-service.js';
-export declare const PLUGIN_ID = "cc-openclaw";
-export declare const VERSION = "0.1.0";
-/**
- * Unified PluginApi shape — superset of fields needed by every wired module.
- * cwd-patch and cc-handler both require `registerService`; both reference
- * `logger` and a `config.plugins.{entries,configs}` map (different agents shaped
- * the field name slightly differently). P2 cco-hardening will lift this into a
- * single shared definition imported by every module.
- */
-export interface PluginApi {
-    on(event: string, handler: (...args: unknown[]) => unknown | Promise<unknown>): void;
-    logger?: Console;
-    config?: {
-        plugins?: {
-            entries?: Record<string, {
-                config?: Record<string, unknown>;
-            }>;
-            configs?: Record<string, Record<string, unknown>>;
-        };
-    };
-    registerService(service: {
-        id: string;
-        start: () => Promise<void>;
-        stop: () => Promise<void> | void;
-    }): void;
-}
-export { getConfigService };
-/**
- * Top-level plugin entry. Idempotent — re-calls are no-op.
- * Guard centralized via defaultRegisterGuard (P2 cco-hardening).
- */
-export declare function register(api: PluginApi): void;
-/** Test-only helper to reset top-level registration state. */
-export declare function _resetRegisteredForTests(): void;
-/**
- * Test-only helper to reset the ConfigService singleton. Each test that
- * mutates `process.env` and re-invokes `register()` should call this first
- * so the config is re-parsed with the test's env, not the cached value
- * from a prior test. Also exported from `lib/config-service.ts` directly.
- */
-export declare function _resetConfigServiceForTests(): void;
-export type { ChannelAdapter, ChannelMessage, ChannelInbound, ChannelButton } from './channels/adapter.js';
-export { registerChannelAdapter } from './channels/adapter.js';
-export { selectEngine, captureSessionRoute, type Engine, type SessionRoute } from './lib/config-service.js';

package/dist/src/lib/auto-recovery.d.ts

@@ -1,43 +0,0 @@
-/**
- * auto-recovery — PM2 process exit → openclaw doctor --fix → health probe.
- *
- * Listens for PM2 bus events. On gateway crash:
- *   1. Runs `openclaw doctor --fix`
- *   2. Probes /health (up to 15s, 1s interval)
- *   3. On success: Telegram "recovered" message
- *   4. On failure: Telegram escalation
- *
- * Configurable via:
- *   OPENCLAW_CC_OPENCLAW_AUTO_RECOVERY=0   — disable
- */
-export interface RecoveryResult {
-    success: boolean;
-    durationMs: number;
-    doctorOutput?: string;
-    error?: string;
-}
-/** Minimal type for pm2 bus events. */
-interface Pm2BusEvent {
-    process?: {
-        name?: string;
-        pm_id?: number;
-    };
-    event?: string;
-    at?: number;
-}
-/** Test-only reset. */
-export declare function _resetRecoveryStateForTests(): void;
-export declare function _setOnProcessExitForTests(handler: ((event: Pm2BusEvent) => void) | null): void;
-/**
- * Connect to PM2 bus and listen for process:exit events.
- * No-ops if OPENCLAW_CC_OPENCLAW_AUTO_RECOVERY=0 or already connected.
- *
- * PM2 is a peer dependency — if not available this silently skips.
- */
-export declare function connectPm2Bus(): Promise<void>;
-/**
- * Directly trigger recovery for a named process without going through PM2 bus.
- * Used by chaos scripts and tests.
- */
-export declare function triggerRecovery(processName: string): Promise<RecoveryResult>;
-export {};

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

@@ -1,64 +0,0 @@
-/**
- * Content-addressed cache-parity decision (v0.30.0).
- *
- * Problem (diagnosed 2026-05-23 from the live sysprompt-cost telemetry):
- * cc-openclaw's cache-parity registry is keyed by sessionKey. The cache HIT
- * path strips the role:system messages so the Claude CLI subprocess reuses its
- * already-cached `--append-system-prompt` block; a MISS inlines the full ~7K
- * system prompt into the user message (uncached). On the live box, 70% of all
- * cache misses were `session_unknown` — the FIRST turn of a session, where the
- * registry has no entry yet. Telegram conversations are short (median 1 turn /
- * session, 23 of 35 single-turn), so cold-start dominated: the hit rate stalled
- * at ~75% vs the terminal CLI's ~95%. The dynamic-envelope churn we originally
- * set out to fix was only ~7.5% of turns.
- *
- * Key observation: every Savvy session shares the *identical* system prefix
- * (same SOUL/USER/AGENTS/TOOLS/MEMORY + harness ⇒ same sysHash). So a brand-new
- * session whose sysHash was already seen for some *other* session is a
- * known-good prefix — its `--append-system-prompt` will be injected at
- * startSession from the registry entry the route patch writes this same turn,
- * so it is SAFE to strip the redundant inline and ride the cached path on
- * turn 1 instead of re-billing the full prompt.
- *
- * Safety: the "warm-hash hit" only applies when the session is NEW (not yet in
- * the SessionManager) — that guarantees startSession runs and appends the
- * prompt. An EXISTING session missing its registry entry (e.g. registry wiped
- * mid-life) keeps the legacy inline path so the model never loses its system
- * prompt. A `hash_mismatch` (entry exists, different hash = genuine mid-session
- * churn) also stays on the inline path: the CLI's append still holds the OLD
- * prompt, so the new one must be delivered in-band.
- *
- * Pure + side-effect-free so the decision is unit-testable independent of the
- * EmbeddedServer route closure (matches the codebase's pure-helper pattern:
- * isPersistedSessionFresh, shouldWriteThroughResumeId).
- */
-export type CacheParityAction = 'hit' | 'warm-hash-hit' | 'miss';
-export interface CacheParityDecisionInput {
-    /** Registry entry for THIS sessionKey, if any. */
-    entry: {
-        hash: string;
-    } | undefined;
-    /** sha1 of the (stripped) system content for this turn. */
-    sysHash: string;
-    /** True if sysHash has been seen for ANY session this process (known-good prefix). */
-    knownHash: boolean;
-    /**
-     * True if the SessionManager has no live session for this key yet. A new
-     * session guarantees startSession runs and injects appendSystemPrompt from
-     * the registry, which is what makes stripping the inline safe.
-     */
-    sessionIsNew: boolean;
-}
-/**
- * Decide how the route patch should treat the system prompt this turn.
- *
- *  - 'hit'           → registry entry matches this session: strip role:system,
- *                      ride the already-cached append.
- *  - 'warm-hash-hit' → new session + known-good prefix: write the registry
- *                      entry (so startSession appends it), strip role:system,
- *                      ride the cached path. Closes the cold-start gap.
- *  - 'miss'          → inline the system prompt into the user message (the safe
- *                      legacy path): first-ever prefix, genuine churn, or an
- *                      existing session that lost its registry entry.
- */
-export declare function decideCacheParityAction(input: CacheParityDecisionInput): CacheParityAction;

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

@@ -1,38 +0,0 @@
-/**
- * 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;

package/dist/src/lib/cc-cli-scan.d.ts

@@ -1,52 +0,0 @@
-/**
- * src/lib/cc-cli-scan.ts — v0.28.0.
- *
- * Mirror (read-only) the actual Claude Code CLI sessions so they can be listed
- * and resumed from Telegram, exactly like `claude -r` / `claude --resume`.
- *
- * Why "mirror, not migrate": cc-openclaw IS a `claude` subprocess wrapper, and
- * both the terminal CLI and every cco-spawned session write their transcript to
- * the SAME store — `~/.claude/projects/<encoded-cwd>/<sessionId>.jsonl`. So
- * `claude --resume <uuid>` already resumes any session in that tree regardless
- * of who created it. The filesystem is the sync layer; copying into a parallel
- * registry would only create drift. We read this tree at list-time, never write.
- *
- * Each jsonl already carries the metadata a picker needs:
- *   { "type":"ai-title",    "aiTitle":"…",    "sessionId":"<uuid>" }  ← name
- *   { "type":"last-prompt", "lastPrompt":"…", "sessionId":"<uuid>" }  ← description
- *   { "type":"user", "cwd":"/home/a1xai", … }                        ← resume cwd
- * The filename (minus .jsonl) is the resumable sessionId (uuid).
- *
- * No fabrication: a session with no parseable title falls back to its first
- * user message, then to the short uuid — never an invented label.
- */
-export interface CliSession {
-    /** jsonl filename (minus .jsonl) === Claude session id. Pass to --resume. */
-    uuid: string;
-    /** ai-title if present, else first user message, else ''. */
-    title: string;
-    /** last-prompt if present, else first user message, else ''. */
-    desc: string;
-    /** cwd recorded in the transcript — required to resume the right session. */
-    cwd: string;
-    /** File mtime in ms — proxy for last activity. */
-    mtimeMs: number;
-}
-export interface ScanOpts {
-    /** Only sessions touched within this many ms (default 7 days). 0 = no limit. */
-    maxAgeMs?: number;
-    /** Only sessions whose recorded cwd matches exactly. */
-    cwdFilter?: string;
-    /** Cap the number of results (after sort-by-recency). */
-    limit?: number;
-}
-/**
- * Scan `~/.claude/projects` for resumable Claude Code sessions, newest first.
- * Best-effort and side-effect-free: any unreadable dir/file is skipped, never
- * thrown. Returns [] when the store is absent.
- */
-export declare function scanClaudeCliSessions(opts?: ScanOpts): CliSession[];
-/** Look up a single CLI session by full uuid (case-insensitive). */
-export declare function findCliSession(uuid: string): CliSession | undefined;
-/** True if the string is a full Claude session uuid (not the 8-hex cco short id). */
-export declare function isFullClaudeUuid(s: string): boolean;

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

@@ -1,21 +0,0 @@
-/**
- * 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;
-    }>;
-}

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

@@ -1,106 +0,0 @@
-/**
- * Cluster A — ConfigService.
- *
- * The single source of truth for runtime configuration. Parses
- * `process.env` into a frozen `RuntimeConfig` at boot, exposes two
- * narrow escape hatches that preserve the live-read vs frozen-snapshot
- * asymmetry currently encoded in `src/lib/route-flag.ts:48,63`.
- *
- * Compat-shim window (v0.9.x): existing `src/lib/config.ts` getters
- * delegate here once Cluster A migration step 6 lands. Direct `process.env`
- * reads are removed in step 7 (the final Cluster A commit) when
- * `src/lib/route-flag.ts` collapses into `selectEngine()` /
- * `captureSessionRoute()` below.
- *
- * NOT yet wired into `src/index.ts` — that's Cluster A migration step 3.
- */
-import { type RuntimeConfig, type ParseEnvResult } from '../types/runtime-config.js';
-/**
- * Parse `process.env` into a `RuntimeConfig`. Total function — never
- * throws. Use the discriminated `ParseEnvResult` to handle failure.
- *
- * Behavior preservation contract: every `process.env.X` read here MUST
- * match the semantic of the corresponding getter in `src/lib/config.ts`.
- * The two dual-default flags (`OPENCLAW_TOKEN_TELEMETRY`,
- * `OPENCLAW_CACHE_PARITY`) are split into two fields each — see
- * `src/types/runtime-config.ts` schema comments.
- */
-export declare function parseEnv(env: NodeJS.ProcessEnv): ParseEnvResult;
-export type Engine = 'cc-openclaw' | 'claude-local';
-export interface SessionRoute {
-    readonly engine: Engine;
-    readonly capturedAt: string;
-}
-/** Primary activation env var (PRP_v3 §10). */
-export declare const ACTIVE_FLAG_ENV = "OPENCLAW_CC_OPENCLAW_ACTIVE";
-/**
- * @deprecated Use `ACTIVE_FLAG_ENV`. Read for fallback when the new name
- * is unset. Removed in v1.0.0.
- */
-export declare const ROUTE_FLAG_ENV = "OPENCLAW_USE_CC_OPENCLAW";
-/**
- * Read env at call time and report whether cc-openclaw engine routing is
- * active. **Independent of `LISTENERS`** — per ARCHITECTURE.md §3, engine
- * selection (per-session) and handler wiring (process-wide) are orthogonal:
- * a session can pick the cc-openclaw engine even when LISTENERS is off.
- *
- * Honors deprecated `OPENCLAW_USE_CC_OPENCLAW` fallback when the new
- * ACTIVE_FLAG_ENV is unset.
- *
- * Free-function variant — works without a ConfigService instance.
- */
-export declare function isCcOpenclawEnabled(env?: NodeJS.ProcessEnv): boolean;
-/**
- * Free-function variant of `ConfigService.prototype.selectEngine()`.
- * Re-reads env at call time. Use when you don't have a ConfigService instance
- * (i.e. early boot, or in tests) — semantics match the instance method exactly.
- *
- * **Only reads `ACTIVE_FLAG_ENV` / deprecated alias.** Does NOT consider
- * `LISTENERS` — that flag controls handler wiring, not engine selection.
- * The higher-level `RuntimeMode` enum (which classifies the whole-process
- * activation state) is computed separately by `deriveMode`.
- */
-export declare function selectEngine(env?: NodeJS.ProcessEnv): Engine;
-/**
- * Free-function variant of `ConfigService.prototype.captureSessionRoute()`.
- * Returns a frozen snapshot — subsequent env mutations do NOT affect the
- * captured route. This is what makes "in-flight sessions stay on original
- * engine" architecturally true at the routing layer.
- */
-export declare function captureSessionRoute(env?: NodeJS.ProcessEnv): SessionRoute;
-/**
- * ConfigService wraps the parsed config with the live-read escape hatches
- * that preserve `route-flag.ts:48,63` semantics.
- *
- * - `config`: frozen at construction; reads return boot-time values.
- * - `selectEngine()`: re-reads `process.env` on every call. Use when picking
- *   an engine for a NEW session — lets a rollback flip take effect mid-process
- *   without restart.
- * - `captureSessionRoute()`: snapshots the current engine into a frozen
- *   object. Use at session-start to lock the engine for that session's
- *   lifetime — lets in-flight sessions ride out a rollback unaffected.
- */
-export declare class ConfigService {
-    readonly config: Readonly<RuntimeConfig>;
-    constructor(config: Readonly<RuntimeConfig>);
-    /**
-     * Re-reads env at call time. Use for new-session engine selection.
-     * Asymmetric with `config.activeRouting` (frozen at boot) BY DESIGN —
-     * see PRP §5 Cluster A "Frozen + escape-hatch contract".
-     *
-     * Delegates to the module-level `selectEngine` free function so that
-     * the class API and free-function API share one implementation.
-     */
-    selectEngine(env?: NodeJS.ProcessEnv): Engine;
-    /**
-     * Snapshot the current engine for a new session. Frozen — subsequent
-     * env mutations do NOT affect the captured route. Delegates to the
-     * free function for the same single-source-of-truth reason.
-     */
-    captureSessionRoute(env?: NodeJS.ProcessEnv): Readonly<SessionRoute>;
-    /** Convenience constructor for boot path. */
-    static fromEnv(env?: NodeJS.ProcessEnv): ConfigService;
-}
-export declare function getConfigService(): ConfigService | undefined;
-export declare function setConfigService(svc: ConfigService | undefined): void;
-export declare function _resetConfigServiceForTests(): void;

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

@@ -1,136 +0,0 @@
-/**
- * config — env-reader source of truth.
- *
- * Originally PRP_v3 §5: `process.env` reads only in `src/index.ts`,
- * `src/lib/route-flag.ts`, and this module. Cluster A step 7 layered a
- * compat shim on top: getters now delegate to `ConfigService.config.X`
- * (the typed Cluster A boot config) when available, falling back to
- * the original `process.env.X` read otherwise.
- *
- * Why the shim instead of pure delegation: tests flip env vars at
- * runtime via `process.env.X = 'y'` and expect immediate effect. When
- * `ConfigService` is unset (most tests), getters fall through to env
- * — preserving test flippability bit-for-bit. When `ConfigService` is
- * set (live gateway boot), the typed config wins, providing single-
- * source-of-truth observability via `/health` and the boot log.
- *
- * Adding a new env var: add a getter here AND a field to
- * `RuntimeConfigSchema` in `src/types/runtime-config.ts`. The shim line
- * pattern is `getConfigService()?.config.X ?? legacyEnvRead`.
- *
- * Cluster A step 8 will collapse the activation getters (selectEngine,
- * route-flag) into ConfigService escape hatches and delete
- * `src/lib/route-flag.ts`. Cluster F (v1.0.0) will remove the legacy
- * env-read fallback and hard-fail when ConfigService is missing.
- */
-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;
-/**
- * M8 (perf overhaul idea #8). Default ON; only the falsey set (0/false/off,
- * preserved bit-for-bit from `FALSEY()` in config-service.ts) opts out.
- * Live gateway path goes through ConfigService; tests can flip the env var
- * mid-process and have it take effect immediately.
- */
-export declare function getPerfCacheTelemetryEnabled(): boolean;
-/**
- * M5 (perf overhaul idea #5). Default OFF; opt-in via
- * CC_OPENCLAW_PERF_KEEPALIVE=1. Flips to default-ON after baseline data
- * confirms the perf win (plan: "default ON for safe ideas once measured-good").
- */
-export declare function getPerfKeepaliveEnabled(): boolean;
-/** M9 (perf overhaul idea #9) — speculative thinking bubble. Default OFF. */
-export declare function getPerfSpecBubbleEnabled(): boolean;
-/** M4 — skill-list-on-demand. Default OFF. */
-export declare function getPerfSkillOnDemandEnabled(): boolean;
-/** M11 — predictive continuation. Default OFF. */
-export declare function getPerfPredictiveContinueEnabled(): boolean;
-/** M2 — typing-prefetch subprocess warmup. Default OFF. */
-export declare function getPerfTypingPrefetchEnabled(): boolean;
-/** M10 — Haiku cheap-route. Default OFF. */
-export declare function getPerfHaikuRouteEnabled(): boolean;
-/** M6 — async lossless compaction. Default OFF (medium risk). */
-export declare function getPerfAsyncCompactEnabled(): boolean;
-/** M7 — Read([paths]) batching. Default OFF (medium risk). */
-export declare function getPerfReadBatchEnabled(): boolean;
-/** M12 — direct claude-code SDK in-process. Default OFF (HIGH RISK, hard-gated). */
-export declare function getPerfDirectSdkEnabled(): boolean;
-/**
- * #4 (dual-surface seam / gap#2) — whether the live card mirrors the model's
- * FULL answer text. Default OFF.
- *
- * The OpenClaw gateway already live-streams the answer to Telegram via its own
- * native draft message. Mirroring the same text onto the card too produced
- * (a) double live-streaming of the identical answer and (b) the finalize-blank
- * "answer streams → vanishes → reappears below" seam, because the card had to
- * wipe its copy on finalize to avoid a literal duplicate (no upstream
- * suppressUserDelivery knob exists).
- *
- * With this OFF (default) the card is a pure ACTIVITY pane (status line · tools ·
- * thinking · todos · ✓ Done · ★ Insight takeaway) and the gateway draft is the
- * sole ANSWER pane — the Claude Code CLI split. The card still shows the short
- * ★ Insight block on finalize (extracted from the accumulated text), so the
- * signature "✓ Done + takeaway" card is preserved without the full-answer dup.
- *
- * Set CC_OPENCLAW_CARD_ANSWER_MIRROR=1 to restore the old in-card full-answer
- * streaming (with the finalize-blank dedup) for comparison.
- */
-export declare function getCardAnswerMirrorEnabled(): 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 getTtsAutoMode(): 'off' | 'always' | 'inbound' | 'tagged';
-/** Test-only: reset the TTS auto-mode cache so the next call re-reads. */
-export declare function _resetTtsAutoModeCacheForTests(): void;
-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).
- *
- * NOT in RuntimeConfig — PATH is process-environment, not plugin
- * configuration. Kept as a direct env reader.
- */
-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;
-/**
- * Raw value for `isToolsPerMessageModeEnabled()` parsing.
- * NOT delegated — the consumer parses the raw string itself; the typed
- * `toolsPerMessage` boolean field is for boot-time observability only.
- */
-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 getAnthropicBaseUrlEnv(): string | undefined;
-export declare function getHomeOrTmp(): string;
-export declare function getHealthPortEnv(): string | undefined;
-export declare function isAutoRecoveryEnabled(): boolean;
-export declare function getSurfaceThinkingEnabled(): boolean;

package/dist/src/lib/cost-rollup.d.ts

@@ -1,36 +0,0 @@
-/**
- * v0.16 task-012 — cost rollup.
- *
- * Aggregates per-turn entries from `cc-openclaw-cost.jsonl` (emitted by the
- * openai-compat handlers) into daily and ISO-week buckets, with per-model
- * pricing applied to compute USD cost. Pure function — accepts a file path
- * and returns a structured aggregate. Consumer is the `/status` command +
- * the workspace `metrics` skill.
- *
- * JSONL line shape (from streaming-handler.ts + non-streaming-handler.ts):
- *   { ts, sessionId, turn, model, inputTokens, outputTokens, durationMs }
- *
- * `costUsd` is NOT in the JSONL — it's computed here from the `model` field
- * via the pricing table. Model values can be either full IDs
- * (`claude-opus-4-7`) or shorthand (`opus`, `sonnet`, `haiku`). Pricing per
- * 1M tokens, Anthropic public list pricing as of 2026-Q2. Unknown models
- * fall back to sonnet-rate so the aggregate is never NaN.
- */
-interface BucketAggregate {
-    tokensIn: number;
-    tokensOut: number;
-    turns: number;
-    costUsd: number;
-    durationMsTotal: number;
-}
-export interface CostRollupResult {
-    daily: Record<string, BucketAggregate>;
-    weekly: Record<string, BucketAggregate>;
-    totals: BucketAggregate;
-    rowCount: number;
-    skippedCount: number;
-}
-export declare function rollupCosts(jsonlPath: string): CostRollupResult;
-/** Compact one-line summary for /status output. */
-export declare function formatRollupLine(rollup: CostRollupResult, today: string): string;
-export {};

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

@@ -1,12 +0,0 @@
-/**
- * Pure debounce higher-order function — wraps `fn` so successive invocations
- * within `ms` collapse to a single trailing call.
- *
- * Extracted from `session-manager.ts` 2026-05-13 as a pure-function hot-path
- * decomposition. No module state, no side effects beyond setTimeout.
- *
- * Usage:
- *   const save = makeDebounced(() => writeToDisk(), 500);
- *   save(); save(); save();   // → writeToDisk called once, 500ms after last call
- */
-export declare function makeDebounced(fn: () => void, ms: number): () => void;

package/dist/src/lib/debug-tap.d.ts

@@ -1,13 +0,0 @@
-import type { PluginApi } from '../index.js';
-/**
- * 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 declare function wrapApiWithDebugTap(api: PluginApi, pluginLabel: string): PluginApi;