@a1hvdy/cc-openclaw 0.29.0 → 0.31.0

package/dist/src/types/runtime-config.d.ts

@@ -1,208 +0,0 @@
-/**
- * Cluster A — Type the seams.
- *
- * Single typed runtime configuration parsed from `process.env` at boot.
- * Replaces the 12+ scattered env-flag readers in `src/lib/config.ts` with
- * one zod-validated immutable object.
- *
- * Pre-existing latent bugs documented at `src/lib/config.ts:39-42` and
- * `src/lib/config.ts:195-197` (two readers per env var with opposite
- * defaults) are resolved by FIELD-SPLITTING rather than choosing one
- * default. This preserves both current call-site behaviors verbatim.
- *
- * NOT consumed yet — Cluster A first commit establishes the vocabulary.
- * Cluster A migration order (per PRP §14) wires this in incrementally
- * with `src/lib/config.ts` getters delegating during the shim window.
- */
-import { z } from 'zod';
-/**
- * Three-state activation mode derived from the two LISTENERS / ACTIVE flags.
- * Replaces the implicit two-flag matrix at `src/lib/route-flag.ts`.
- *
- * - PASSIVE          — listeners NOT wired; no engine routing.
- * - LISTENERS_ONLY   — listeners wired, but engine routing returns 'claude-local'.
- * - ACTIVE_ROUTING   — listeners wired AND engine routing returns 'cc-openclaw'.
- */
-export declare enum RuntimeMode {
-    PASSIVE = "PASSIVE",
-    LISTENERS_ONLY = "LISTENERS_ONLY",
-    ACTIVE_ROUTING = "ACTIVE_ROUTING"
-}
-/**
- * Derive RuntimeMode from raw env. Honors deprecated alias
- * `OPENCLAW_USE_CC_OPENCLAW` only when the primary `OPENCLAW_CC_OPENCLAW_ACTIVE`
- * is unset. Alias retained through v0.9.x; removed at v1.0.0.
- */
-export declare function deriveMode(env: NodeJS.ProcessEnv): RuntimeMode;
-export declare const RuntimeConfigSchema: z.ZodObject<{
-    mode: z.ZodNativeEnum<typeof RuntimeMode>;
-    listenersEnabled: z.ZodDefault<z.ZodBoolean>;
-    activeRouting: z.ZodDefault<z.ZodBoolean>;
-    toolStream: z.ZodDefault<z.ZodBoolean>;
-    allowBuiltins: z.ZodDefault<z.ZodBoolean>;
-    toolsPerMessage: z.ZodDefault<z.ZodBoolean>;
-    /**
-     * Native-tools allowList. Default at
-     * v0.11.x matches the previously hardcoded `Set(['message.voice'])` in
-     * `src/openai-compat/bridges/allowlist.ts` to preserve behavior. Override
-     * via `CC_OPENCLAW_NATIVE_TOOLS_ALLOWLIST=` comma-separated. Expanded
-     * default (`message.voice,message.image,memory.recall,memory.persist,sessions_spawn`)
-     * lands at v1.0.0-rc1 alongside the `CC_OPENCLAW_NATIVE_TOOLS=1` flip.
-     */
-    nativeToolsAllowList: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    cacheParityModuleEnabled: z.ZodDefault<z.ZodBoolean>;
-    cacheParityTrackB: z.ZodDefault<z.ZodBoolean>;
-    newConvoHeuristic: z.ZodDefault<z.ZodBoolean>;
-    aggressiveStripEnabled: z.ZodDefault<z.ZodBoolean>;
-    debug: z.ZodDefault<z.ZodBoolean>;
-    registerDebug: z.ZodDefault<z.ZodBoolean>;
-    tokenTelemetryRouteGate: z.ZodDefault<z.ZodBoolean>;
-    tokenTelemetryWriter: z.ZodDefault<z.ZodBoolean>;
-    perfCacheTelemetryEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfKeepaliveEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfEditCadenceEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfSpecBubbleEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfSkillOnDemandEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfPredictiveContinueEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfTypingPrefetchEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfHaikuRouteEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfAsyncCompactEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfReadBatchEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfResidentCliEnabled: z.ZodDefault<z.ZodBoolean>;
-    perfDirectSdkEnabled: z.ZodDefault<z.ZodBoolean>;
-    syspromptDump: z.ZodDefault<z.ZodBoolean>;
-    trajectoryEnabled: z.ZodDefault<z.ZodBoolean>;
-    statusUrl: z.ZodOptional<z.ZodString>;
-    surfaceThinking: z.ZodDefault<z.ZodBoolean>;
-    thinkingExcerpt: z.ZodDefault<z.ZodBoolean>;
-    maxConcurrentSessions: z.ZodDefault<z.ZodNumber>;
-    sessionTtlMinutes: z.ZodDefault<z.ZodNumber>;
-    serverHost: z.ZodDefault<z.ZodString>;
-    rateLimit: z.ZodDefault<z.ZodNumber>;
-    serverToken: z.ZodOptional<z.ZodString>;
-    corsAllowAll: z.ZodDefault<z.ZodBoolean>;
-    claudeBin: z.ZodOptional<z.ZodString>;
-    geminiBin: z.ZodOptional<z.ZodString>;
-    codexBin: z.ZodOptional<z.ZodString>;
-    cursorBin: z.ZodOptional<z.ZodString>;
-    driftAlertsEnabled: z.ZodDefault<z.ZodBoolean>;
-    autoRecoveryEnabled: z.ZodDefault<z.ZodBoolean>;
-    quotaPausePct: z.ZodDefault<z.ZodNumber>;
-    testMode: z.ZodDefault<z.ZodBoolean>;
-    heartbeatWorkaroundDisabled: z.ZodDefault<z.ZodBoolean>;
-    savvyLiveCardEnabled: z.ZodDefault<z.ZodBoolean>;
-    /** True if mode was derived from the deprecated alias path. Logged at boot. */
-    usedDeprecatedAlias: z.ZodDefault<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    mode: RuntimeMode;
-    listenersEnabled: boolean;
-    activeRouting: boolean;
-    toolStream: boolean;
-    allowBuiltins: boolean;
-    toolsPerMessage: boolean;
-    nativeToolsAllowList: string[];
-    cacheParityModuleEnabled: boolean;
-    cacheParityTrackB: boolean;
-    newConvoHeuristic: boolean;
-    aggressiveStripEnabled: boolean;
-    debug: boolean;
-    registerDebug: boolean;
-    tokenTelemetryRouteGate: boolean;
-    tokenTelemetryWriter: boolean;
-    perfCacheTelemetryEnabled: boolean;
-    perfKeepaliveEnabled: boolean;
-    perfEditCadenceEnabled: boolean;
-    perfSpecBubbleEnabled: boolean;
-    perfSkillOnDemandEnabled: boolean;
-    perfPredictiveContinueEnabled: boolean;
-    perfTypingPrefetchEnabled: boolean;
-    perfHaikuRouteEnabled: boolean;
-    perfAsyncCompactEnabled: boolean;
-    perfReadBatchEnabled: boolean;
-    perfResidentCliEnabled: boolean;
-    perfDirectSdkEnabled: boolean;
-    syspromptDump: boolean;
-    trajectoryEnabled: boolean;
-    surfaceThinking: boolean;
-    thinkingExcerpt: boolean;
-    maxConcurrentSessions: number;
-    sessionTtlMinutes: number;
-    serverHost: string;
-    rateLimit: number;
-    corsAllowAll: boolean;
-    driftAlertsEnabled: boolean;
-    autoRecoveryEnabled: boolean;
-    quotaPausePct: number;
-    testMode: boolean;
-    heartbeatWorkaroundDisabled: boolean;
-    savvyLiveCardEnabled: boolean;
-    usedDeprecatedAlias: boolean;
-    statusUrl?: string | undefined;
-    serverToken?: string | undefined;
-    claudeBin?: string | undefined;
-    geminiBin?: string | undefined;
-    codexBin?: string | undefined;
-    cursorBin?: string | undefined;
-}, {
-    mode: RuntimeMode;
-    listenersEnabled?: boolean | undefined;
-    activeRouting?: boolean | undefined;
-    toolStream?: boolean | undefined;
-    allowBuiltins?: boolean | undefined;
-    toolsPerMessage?: boolean | undefined;
-    nativeToolsAllowList?: string[] | undefined;
-    cacheParityModuleEnabled?: boolean | undefined;
-    cacheParityTrackB?: boolean | undefined;
-    newConvoHeuristic?: boolean | undefined;
-    aggressiveStripEnabled?: boolean | undefined;
-    debug?: boolean | undefined;
-    registerDebug?: boolean | undefined;
-    tokenTelemetryRouteGate?: boolean | undefined;
-    tokenTelemetryWriter?: boolean | undefined;
-    perfCacheTelemetryEnabled?: boolean | undefined;
-    perfKeepaliveEnabled?: boolean | undefined;
-    perfEditCadenceEnabled?: boolean | undefined;
-    perfSpecBubbleEnabled?: boolean | undefined;
-    perfSkillOnDemandEnabled?: boolean | undefined;
-    perfPredictiveContinueEnabled?: boolean | undefined;
-    perfTypingPrefetchEnabled?: boolean | undefined;
-    perfHaikuRouteEnabled?: boolean | undefined;
-    perfAsyncCompactEnabled?: boolean | undefined;
-    perfReadBatchEnabled?: boolean | undefined;
-    perfResidentCliEnabled?: boolean | undefined;
-    perfDirectSdkEnabled?: boolean | undefined;
-    syspromptDump?: boolean | undefined;
-    trajectoryEnabled?: boolean | undefined;
-    statusUrl?: string | undefined;
-    surfaceThinking?: boolean | undefined;
-    thinkingExcerpt?: boolean | undefined;
-    maxConcurrentSessions?: number | undefined;
-    sessionTtlMinutes?: number | undefined;
-    serverHost?: string | undefined;
-    rateLimit?: number | undefined;
-    serverToken?: string | undefined;
-    corsAllowAll?: boolean | undefined;
-    claudeBin?: string | undefined;
-    geminiBin?: string | undefined;
-    codexBin?: string | undefined;
-    cursorBin?: string | undefined;
-    driftAlertsEnabled?: boolean | undefined;
-    autoRecoveryEnabled?: boolean | undefined;
-    quotaPausePct?: number | undefined;
-    testMode?: boolean | undefined;
-    heartbeatWorkaroundDisabled?: boolean | undefined;
-    savvyLiveCardEnabled?: boolean | undefined;
-    usedDeprecatedAlias?: boolean | undefined;
-}>;
-export type RuntimeConfig = z.infer<typeof RuntimeConfigSchema>;
-export declare class ConfigError extends Error {
-    readonly issues: ReadonlyArray<z.ZodIssue>;
-    constructor(issues: z.ZodIssue[]);
-}
-export type ParseEnvResult = {
-    readonly ok: true;
-    readonly config: Readonly<RuntimeConfig>;
-} | {
-    readonly ok: false;
-    readonly error: ConfigError;
-};

package/dist/src/types/sse.d.ts

@@ -1,29 +0,0 @@
-/**
- * Cluster A — SSE wire-format types.
- *
- * Re-exports the SSE types currently inline in `openai-compat.ts` and the
- * Anthropic event types from `cli-stream-parser.ts` under a single import
- * surface. Cluster B's `sse-translator.ts` already lives at
- * `src/openai-compat/sse-translator.ts` — this module is its typed contract.
- *
- * NOT consumed yet — Cluster A first commit establishes the vocabulary.
- */
-export type { OpenAIChatCompletionChunk as SseChunk, OpenAIToolCall, } from '../openai-compat/openai-compat.js';
-export type { AnthropicEvent, AnthropicMessage, MessageUsage, MessageDeltaBody, ContentBlockStart, ContentBlockDelta, ParsedEvent, CliStreamParser, } from '../openai-compat/cli-stream-parser.js';
-/**
- * One delta in an OpenAI streaming chunk. Cluster B will tighten this when
- * `sse-translator.ts` is extracted into the typed boundary.
- */
-export interface OpenAIDelta {
-    readonly role?: 'assistant' | 'system' | 'user' | 'tool';
-    readonly content?: string;
-    readonly tool_calls?: ReadonlyArray<{
-        readonly index: number;
-        readonly id?: string;
-        readonly type?: 'function';
-        readonly function?: {
-            readonly name?: string;
-            readonly arguments?: string;
-        };
-    }>;
-}

package/dist/src/types/tool-bridge.d.ts

@@ -1,82 +0,0 @@
-/**
- * Cluster A — Tool bridge contract.
- *
- * Declares the interface Cluster B's three tool-mode strategies will
- * implement (`EmbeddedToolsBridge`, `PerMessageToolsBridge`,
- * `NativeToolStreamBridge`). Lives in `src/types/` — pure type
- * declaration, no runtime code, zero implementation yet.
- *
- * The mode → bridge selection in Cluster B is one-way: `bridges/factory.ts`
- * imports from this module; `system-prompt-builder.ts` (the other
- * potentially-circular dependency) accepts a `ToolMode` arg from the
- * bridge rather than importing the factory. See PRP §11 Decision Log.
- *
- * NOT consumed yet — Cluster A first commit establishes the vocabulary.
- */
-import type { OpenAIToolCall } from './route.js';
-import type { OpenAIDelta } from './sse.js';
-/**
- * Three tool-handling modes documented in ARCHITECTURE.md §5.3:
- *
- * - Embedded     — default. Tools embedded in session system prompt at
- *                  create-time; NOT re-injected per turn; cacheable.
- * - PerMessage   — legacy `OPENAI_COMPAT_TOOLS_PER_MESSAGE=1`. Tool block
- *                  prepended to every user message; defeats prompt caching;
- *                  allows mutating tool list mid-session.
- * - NativeStream — `CC_OPENCLAW_TOOL_STREAM=1`. Tools forwarded as
- *                  `--tools` allowlist; native `tool_use` events flow
- *                  through; SSE translator emits inline `delta.tool_calls`.
- */
-export declare enum ToolMode {
-    Embedded = "embedded",
-    PerMessage = "per-message",
-    NativeStream = "native-stream",
-    OpenClawNative = "openclaw-native"
-}
-/**
- * The tool definition shape OpenClaw's `createOpenClawCodingTools` produces
- * and that callers send in `request.tools`. Shape mirrors the OpenAI tool
- * definition. Cluster B will tighten when bridge implementations land.
- */
-export interface ToolDefinition {
-    readonly type: 'function';
-    readonly function: {
-        readonly name: string;
-        readonly description?: string;
-        readonly parameters?: Record<string, unknown>;
-    };
-}
-/**
- * Result of translating a single Anthropic `tool_use` event from the
- * Claude CLI stream into an OpenAI streaming chunk delta. `null` means
- * the bridge consumed the event but emitted nothing (e.g. mid-block
- * input_json_delta accumulation).
- */
-export type TranslatedToolUseDelta = OpenAIDelta | null;
-/**
- * The contract every tool-mode bridge must satisfy. Cluster B's three
- * strategy classes live at `src/openai-compat/bridges/{embedded-tools,
- * per-message,native-stream}.ts`. Each is constructed once per route
- * request and discarded after the response is written.
- */
-export interface IToolBridge {
-    readonly mode: ToolMode;
-    /**
-     * Build the system-prompt fragment that advertises the tool list to
-     * the model. Pure function — no I/O. Empty string when the bridge
-     * does not embed tools in the prompt (NativeStream).
-     */
-    buildToolPreamble(tools: ReadonlyArray<ToolDefinition> | undefined): string;
-    /**
-     * Translate one parsed Anthropic event into an OpenAI delta if it
-     * represents a tool_use boundary. Returns `null` for events the
-     * bridge does not surface as tool_calls deltas.
-     */
-    translateToolUse(event: unknown): TranslatedToolUseDelta;
-    /**
-     * Serialize an OpenAI tool_call result back into the format the
-     * bridge sends to Claude CLI on the next turn. Embedded + PerMessage
-     * use `<tool_result>` XML; NativeStream uses native blocks.
-     */
-    serializeToolResult(call: OpenAIToolCall, result: string): string;
-}