@a1hvdy/cc-openclaw 0.30.0 → 0.32.0

package/dist/src/types.d.ts

@@ -1,498 +0,0 @@
-/**
- * Shared types for openclaw-claude-code plugin
- */
-import type { ModelPricing } from './models.js';
-export { getModelPricing, overrideModelPricing } from './models.js';
-type PermissionMode = 'acceptEdits' | 'bypassPermissions' | 'default' | 'delegate' | 'dontAsk' | 'plan' | 'auto';
-export type EffortLevel = 'low' | 'medium' | 'high' | 'max' | 'auto';
-export type EngineType = 'claude' | 'codex' | 'gemini' | 'cursor' | 'custom';
-export interface CustomEngineConfig {
-    /** Display name for this engine (used in logs and session IDs) */
-    name: string;
-    /** Binary path or command name, e.g. 'my-agent' or '/usr/local/bin/my-agent' */
-    bin: string;
-    /**
-     * Environment variable name that overrides `bin` at runtime.
-     * e.g. 'MY_AGENT_BIN' — the value of that env var takes precedence over `bin`.
-     */
-    binEnv?: string;
-    /**
-     * true  = persistent subprocess (Claude Code style: start once, JSON I/O on stdin/stdout)
-     * false = one-shot per send (Gemini/Codex style: spawn per message)
-     * @default false
-     */
-    persistent?: boolean;
-    /**
-     * CLI flag mappings. Each key is an OpenClaw concept; the value is the CLI
-     * flag string your agent expects. Omit any flag your CLI doesn't support.
-     *
-     * Example for a Claude Code-compatible CLI:
-     * ```json
-     * {
-     *   "print": "-p",
-     *   "outputFormat": "--output-format",
-     *   "outputFormatValue": "stream-json",
-     *   "inputFormat": "--input-format",
-     *   "inputFormatValue": "stream-json",
-     *   "skipPermissions": "-y",
-     *   "permissionMode": "--permission-mode",
-     *   "model": "--model",
-     *   "systemPrompt": "--system-prompt",
-     *   "appendSystemPrompt": "--append-system-prompt",
-     *   "maxTurns": "--max-turns",
-     *   "resume": "--resume",
-     *   "verbose": "--verbose",
-     *   "replayUserMessages": "--replay-user-messages",
-     *   "includePartialMessages": "--include-partial-messages"
-     * }
-     * ```
-     */
-    args: {
-        /** Flag for non-interactive / print mode, e.g. '-p' */
-        print?: string;
-        /** Flag for output format, e.g. '--output-format' */
-        outputFormat?: string;
-        /** Value for stream-json output format, e.g. 'stream-json' */
-        outputFormatValue?: string;
-        /** Flag for input format (persistent mode only), e.g. '--input-format' */
-        inputFormat?: string;
-        /** Value for stream-json input format, e.g. 'stream-json' */
-        inputFormatValue?: string;
-        /** Flag to skip all permissions, e.g. '-y' or '--dangerously-skip-permissions' */
-        skipPermissions?: string;
-        /** Flag for permission mode, e.g. '--permission-mode' */
-        permissionMode?: string;
-        /** Flag for model selection, e.g. '--model' */
-        model?: string;
-        /** Flag for system prompt override, e.g. '--system-prompt' */
-        systemPrompt?: string;
-        /** Flag for appending to system prompt, e.g. '--append-system-prompt' */
-        appendSystemPrompt?: string;
-        /** Flag for max agent turns, e.g. '--max-turns' */
-        maxTurns?: string;
-        /** Flag for resuming a session, e.g. '--resume' */
-        resume?: string;
-        /** Flag for verbose output, e.g. '--verbose' */
-        verbose?: string;
-        /** Flag for replaying user messages, e.g. '--replay-user-messages' (persistent only) */
-        replayUserMessages?: string;
-        /** Flag for including partial messages, e.g. '--include-partial-messages' (persistent only) */
-        includePartialMessages?: string;
-        /** Flag for effort level, e.g. '--effort' */
-        effort?: string;
-        /** Flag for workspace/cwd, e.g. '--workspace' (one-shot only; overrides cwd) */
-        workspace?: string;
-        /** Additional static arguments always appended to the CLI invocation */
-        extra?: string[];
-    };
-    /**
-     * Maps OpenClaw permission mode names to CLI-specific values.
-     * e.g. { bypassPermissions: 'yolo', default: 'sandbox' }
-     * If omitted, mode names are passed through as-is.
-     */
-    permissionModes?: Record<string, string>;
-    /**
-     * Default pricing per 1M tokens (for cost estimation when model is unknown).
-     * Falls back to { input: 0, output: 0 } if omitted.
-     */
-    pricing?: {
-        input: number;
-        output: number;
-        cached?: number;
-    };
-    /** Context window size in tokens. @default 200000 */
-    contextWindow?: number;
-    /** Extra environment variables to set when spawning the CLI process */
-    env?: Record<string, string>;
-    /**
-     * Regex patterns to sanitize from stderr output (e.g. API key patterns).
-     * Applied as global replacements with '***'.
-     */
-    sanitizePatterns?: string[];
-}
-export interface SessionConfig {
-    name: string;
-    cwd: string;
-    engine?: EngineType;
-    model?: string;
-    baseUrl?: string;
-    permissionMode: PermissionMode;
-    allowedTools?: string[];
-    disallowedTools?: string[];
-    tools?: string[];
-    maxTurns?: number;
-    maxBudgetUsd?: number;
-    systemPrompt?: string;
-    appendSystemPrompt?: string;
-    dangerouslySkipPermissions?: boolean;
-    includePartialMessages?: boolean;
-    agents?: Record<string, {
-        description?: string;
-        prompt: string;
-    }>;
-    agent?: string;
-    customSessionId?: string;
-    sessionName?: string;
-    claudeResumeId?: string;
-    resumeSessionId?: string;
-    /** v0.27.4 (M4/M6) — opt a skipPersistence session into freshness-windowed
-     *  --resume across restart / watchdog-kill. When set (ms), the SessionManager
-     *  persists this session's claudeSessionId and, on the next start for the same
-     *  name, resumes it iff its last activity is within this window. Used by the
-     *  openai-compat bridge so Savvy keeps context across a gateway restart while
-     *  still starting fresh after a long idle gap. */
-    resumeFreshnessMs?: number;
-    forkSession?: boolean;
-    addDir?: string[];
-    effort?: EffortLevel;
-    modelOverrides?: Record<string, string>;
-    enableAutoMode?: boolean;
-    resolvedModel?: string;
-    bare?: boolean;
-    worktree?: string | boolean;
-    fallbackModel?: string;
-    jsonSchema?: string;
-    mcpConfig?: string | string[];
-    settings?: string;
-    noSessionPersistence?: boolean;
-    betas?: string | string[];
-    enableAgentTeams?: boolean;
-    /** Stream hook lifecycle events (PreToolUse/PostToolUse) */
-    includeHookEvents?: boolean;
-    /** Delegate permission prompts to an MCP tool for non-interactive use */
-    permissionPromptTool?: string;
-    /** Move cwd/env/git status from system prompt to user message for better prompt cache hits */
-    excludeDynamicSystemPromptSections?: boolean;
-    /** Enable debug output for specific categories (e.g. "api", "mcp") */
-    debug?: string | string[];
-    /** Write debug output to file instead of stderr */
-    debugFile?: string;
-    /** Resume session linked to a GitHub PR number or URL */
-    fromPr?: string;
-    /** MCP channel subscriptions (research preview) */
-    channels?: string | string[];
-    /** Load development MCP channels */
-    dangerouslyLoadDevelopmentChannels?: string | string[];
-    /** Enable 1-hour prompt cache TTL (vs default 5-min) */
-    enablePromptCaching1H?: boolean;
-    /** Custom engine configuration — required when engine is 'custom' */
-    customEngine?: CustomEngineConfig;
-}
-export interface SessionStats {
-    turns: number;
-    toolCalls: number;
-    toolErrors: number;
-    tokensIn: number;
-    tokensOut: number;
-    cachedTokens: number;
-    costUsd: number;
-    isReady: boolean;
-    startTime: string | null;
-    lastActivity: string | null;
-    /** v0.27.x — wall-clock ISO of the last PROGRESS event (text / tool_use /
-     *  tool_result / thinking / result / init) — i.e. the subprocess produced
-     *  real output. Distinct from lastActivity, which also moves on non-progress
-     *  events like `system/api_retry`. The stalled-session watchdog keys off this
-     *  so an API retry-storm (no output) is fast-failed instead of looking busy. */
-    lastProgressAt: string | null;
-    /** v0.27.6 — tool calls currently in flight (dispatched without a matching
-     *  result yet). Optional: only the Claude persistent-session engine populates
-     *  it; the stalled-session watchdog treats > 0 as "alive, don't kill". */
-    inFlightTools?: number;
-    /**
-     * Approximate context window utilization (0-100).
-     * Estimated as (tokensIn + tokensOut) / 200,000 * 100.
-     * Claude Code does not expose exact context usage via the JSON protocol,
-     * so this is a best-effort heuristic that may overcount on long conversations.
-     */
-    contextPercent: number;
-    /** Total API retry attempts during this session */
-    retries: number;
-    /** Last API retry error category (e.g. "overloaded", "rate_limit") */
-    lastRetryError?: string;
-}
-export interface HookConfig {
-    onToolError?: string;
-    onContextHigh?: string;
-    onStop?: string;
-    onTurnComplete?: string;
-    onStopFailure?: string;
-}
-export interface SendOptions {
-    effort?: EffortLevel;
-    plan?: boolean;
-    autoResume?: boolean;
-    timeout?: number;
-    stream?: boolean;
-    onChunk?: (chunk: string) => void;
-    onEvent?: (event: StreamEvent) => void;
-}
-export interface StreamEvent {
-    type: string;
-    subtype?: string;
-    session_id?: string;
-    message?: {
-        content?: Array<{
-            type: string;
-            text?: string;
-        }>;
-        usage?: {
-            input_tokens?: number;
-            output_tokens?: number;
-            cache_read_input_tokens?: number;
-        };
-    };
-    result?: string;
-    is_error?: boolean;
-    num_turns?: number;
-    total_cost_usd?: number;
-    [key: string]: unknown;
-}
-export interface SessionInfo {
-    name: string;
-    claudeSessionId?: string;
-    created: string;
-    cwd: string;
-    model?: string;
-    paused: boolean;
-    stats: SessionStats;
-}
-export interface SendResult {
-    output: string;
-    sessionId?: string;
-    error?: string;
-    events: StreamEvent[];
-}
-export interface AgentInfo {
-    name: string;
-    file: string;
-    description: string;
-}
-export interface SkillInfo {
-    name: string;
-    hasSkillMd: boolean;
-    description: string;
-}
-export interface RuleInfo {
-    name: string;
-    file: string;
-    description: string;
-    paths: string;
-    condition: string;
-}
-export interface SessionSendOptions {
-    effort?: EffortLevel;
-    plan?: boolean;
-    waitForComplete?: boolean;
-    timeout?: number;
-    callbacks?: StreamCallbacks;
-}
-export interface StreamCallbacks {
-    onText?: (text: string) => void;
-    onToolUse?: (event: unknown) => void;
-    onToolResult?: (event: unknown) => void;
-    /**
-     * v0.7.1: extended-thinking content (opus-4-7+ with reasoning enabled).
-     * Fires once per `thinking_delta` event with the partial reasoning text.
-     * The caller is responsible for accumulation. Privacy-sensitive — most
-     * paths should gate this on `getSurfaceThinkingEnabled()` from
-     * `lib/config.ts` before subscribing. NEVER receives `signature_delta`
-     * content (Anthropic-internal cryptographic field).
-     */
-    onThinking?: (text: string) => void;
-}
-export interface TurnResult {
-    text: string;
-    event: StreamEvent;
-}
-export interface CostBreakdown {
-    model: string;
-    tokensIn: number;
-    tokensOut: number;
-    cachedTokens: number;
-    pricing: {
-        inputPer1M: number;
-        outputPer1M: number;
-        cachedPer1M: number | undefined;
-    };
-    breakdown: {
-        inputCost: number;
-        cachedCost: number;
-        outputCost: number;
-    };
-    totalUsd: number;
-}
-export interface ISession {
-    sessionId?: string;
-    readonly pid?: number;
-    readonly isReady: boolean;
-    readonly isPaused: boolean;
-    readonly isBusy: boolean;
-    /** Initialise the engine subprocess. Engine-specific; config passed via constructor. */
-    start(): Promise<this>;
-    stop(): void;
-    pause(): void;
-    resume(): void;
-    send(message: string | unknown[], options?: SessionSendOptions): Promise<TurnResult | {
-        requestId: number;
-        sent: boolean;
-    }>;
-    getStats(): SessionStats & {
-        sessionId?: string;
-        uptime: number;
-    };
-    getHistory(limit?: number): Array<{
-        time: string;
-        type: string;
-        event: unknown;
-    }>;
-    getCost(): CostBreakdown;
-    compact(summary?: string): Promise<TurnResult | {
-        requestId: number;
-        sent: boolean;
-    }>;
-    getEffort(): EffortLevel;
-    setEffort(level: EffortLevel): void;
-    resolveModel(alias: string): string;
-    on(event: string, listener: (...args: unknown[]) => void): this;
-    once(event: string, listener: (...args: unknown[]) => void): this;
-    emit(event: string, ...args: unknown[]): boolean;
-    removeListener(event: string, listener: (...args: unknown[]) => void): this;
-}
-export interface PluginConfig {
-    claudeBin: string;
-    defaultModel?: string;
-    defaultPermissionMode: PermissionMode;
-    defaultEffort: EffortLevel;
-    maxConcurrentSessions: number;
-    sessionTtlMinutes: number;
-    proxy?: ProxyConfig;
-    /** Override or extend model pricing at runtime without a new release. */
-    pricingOverrides?: Record<string, Partial<ModelPricing>>;
-}
-export interface ProxyConfig {
-    enabled: boolean;
-    bigModel: string;
-    smallModel: string;
-}
-export interface InboxMessage {
-    from: string;
-    text: string;
-    timestamp: string;
-    read: boolean;
-    summary?: string;
-}
-export interface UltraplanResult {
-    id: string;
-    status: 'running' | 'completed' | 'error' | 'timeout';
-    plan?: string;
-    sessionName: string;
-    startTime: string;
-    endTime?: string;
-    error?: string;
-}
-export interface UltrareviewResult {
-    id: string;
-    status: 'running' | 'completed' | 'error';
-    councilId: string;
-    findings?: string;
-    agentCount: number;
-    startTime: string;
-    endTime?: string;
-    error?: string;
-}
-type CouncilEventType = 'session-start' | 'round-start' | 'agent-start' | 'agent-chunk' | 'agent-tool' | 'agent-complete' | 'round-end' | 'complete' | 'error';
-export interface CouncilEvent {
-    type: CouncilEventType;
-    sessionId: string;
-    timestamp: string;
-    round?: number;
-    agent?: string;
-    content?: string;
-    consensus?: boolean;
-    status?: string;
-    task?: string;
-    error?: string;
-    tool?: string;
-    toolInput?: string;
-    toolStatus?: 'start' | 'end';
-}
-export interface AgentPersona {
-    name: string;
-    emoji: string;
-    persona: string;
-    engine?: EngineType;
-    role?: string;
-    model?: string;
-    baseUrl?: string;
-    permissionMode?: PermissionMode;
-    customEngine?: CustomEngineConfig;
-}
-export interface CouncilConfig {
-    name?: string;
-    agents: AgentPersona[];
-    maxRounds: number;
-    projectDir: string;
-    agentTimeoutMs?: number;
-    maxTurnsPerAgent?: number;
-    maxBudgetUsd?: number;
-    defaultPermissionMode?: PermissionMode;
-}
-export interface AgentResponse {
-    agent: string;
-    round: number;
-    content: string;
-    consensus: boolean;
-    sessionKey: string;
-    timestamp: string;
-}
-export interface CouncilSession {
-    id: string;
-    task: string;
-    config: CouncilConfig;
-    responses: AgentResponse[];
-    status: 'running' | 'consensus' | 'awaiting_user' | 'max_rounds' | 'error' | 'accepted' | 'rejected';
-    startTime: string;
-    endTime?: string;
-    finalSummary?: string;
-    compactContext?: string;
-}
-type CouncilFileStatus = 'clean' | 'needs_rework' | 'redundant' | 'missing';
-export interface CouncilChangedFile {
-    file: string;
-    status: CouncilFileStatus;
-    insertions: number;
-    deletions: number;
-    note?: string;
-}
-export interface CouncilReviewResult {
-    councilId: string;
-    projectDir: string;
-    status: 'consensus' | 'max_rounds' | 'error';
-    rounds: number;
-    planExists: boolean;
-    planContent?: string;
-    changedFiles: CouncilChangedFile[];
-    branches: string[];
-    worktrees: string[];
-    reviews: string[];
-    agentSummaries: Array<{
-        agent: string;
-        consensus: boolean;
-        preview: string;
-    }>;
-    /** Reviewer guidance loaded from configs/council-reviewer-prompt.md */
-    reviewerGuidance: string;
-}
-export interface CouncilAcceptResult {
-    councilId: string;
-    branchesDeleted: string[];
-    worktreesRemoved: string[];
-    planDeleted: boolean;
-    reviewsDeleted: boolean;
-}
-export interface CouncilRejectResult {
-    councilId: string;
-    planRewritten: boolean;
-    feedback: string;
-}

package/dist/src/validation.d.ts

@@ -1,31 +0,0 @@
-/**
- * Shared validation utilities for input sanitization.
- *
- * Used by both the plugin tool handlers (index.ts) and the embedded HTTP
- * server (embedded-server.ts) to ensure consistent protection regardless
- * of entry point.
- */
-/**
- * Resolve and validate a working directory path.
- *
- * Prevents path traversal and blocks access to system-critical and
- * sensitive directories. Resolves symlinks where possible to defeat
- * symlink-based bypasses.
- */
-export declare function sanitizeCwd(cwd: string | undefined): string | undefined;
-/**
- * Validate that a string is a syntactically valid regular expression.
- *
- * Returns the compiled RegExp if valid, throws on invalid syntax.
- * Note: this validates syntax only — it does not detect catastrophic
- * backtracking (ReDoS) patterns.
- */
-export declare function validateRegex(pattern: string): RegExp;
-/**
- * Validate a resource name (agent, skill, rule) to prevent path injection.
- *
- * Only allows alphanumeric characters, hyphens, and underscores.
- * Rejects empty strings, dots, slashes, spaces, and any other characters
- * that could be used for path traversal.
- */
-export declare function validateName(name: string): string;