/**

* Manages reusable Claude CLI stdio sessions for CLI-backed agent turns.

*/

import crypto from "node:crypto";

import type { ReplyBackendHandle } from "../../auto-reply/reply/reply-run-registry.js";

import type { CliBackendConfig } from "../../config/types.js";

import { cliBackendLog, formatCliBackendOutputDigest } from "./log.js";

import type { PreparedCliRunContext } from "./types.js";

/**

* Live Claude CLI stdio session manager.

*

* This keeps a bounded pool of long-lived Claude CLI processes and routes individual turns through

* stream-json stdin/stdout while preserving exec permission state and diagnostic tool events.

*/

type ProcessSupervisor = ReturnType<

typeof import("../../process/supervisor/index.js").getProcessSupervisor

>;

/**

* Materializes selected OpenClaw skills as a temporary Claude CLI plugin.

*/

import { accessSync } from "node:fs";

import fs from "node:fs/promises";

import path from "node:path";

import type { SkillSnapshot } from "../../skills/types.js";

import { cliBackendLog } from "./log.js";

/**

* Materializes selected OpenClaw skills as a temporary Claude CLI plugin.

*/

const CLAUDE_CLI_BACKEND_ID = "claude-cli";

const OPENCLAW_CLAUDE_PLUGIN_NAME = "openclaw-skills";

/**

* Shared logging helpers for CLI backend diagnostics.

*/

import crypto from "node:crypto";

import { createSubsystemLogger } from "../../logging/subsystem.js";

// Shared logging helpers for CLI backend diagnostics.

/** Subsystem logger for CLI backend execution diagnostics. */

export const cliBackendLog = createSubsystemLogger("agent/cli-backend");

/** Env var that enables CLI backend output logging. */

export const CLI_BACKEND_LOG_OUTPUT_ENV = "OPENCLAW_CLI_BACKEND_LOG_OUTPUT";

/** Legacy env var accepted for Claude CLI output logging. */

export const LEGACY_CLAUDE_CLI_LOG_OUTPUT_ENV = "OPENCLAW_CLAUDE_CLI_LOG_OUTPUT";

/** Return a compact byte/hash summary for CLI backend output. */

/**

* Shared types for preparing and executing CLI-backed agent runs.

*/

import type { SourceReplyDeliveryMode } from "../../auto-reply/get-reply-options.types.js";

import type { ReplyOperation } from "../../auto-reply/reply/reply-run-registry.js";

import type { ThinkLevel } from "../../auto-reply/thinking.js";

} from "../embedded-agent-runner/run/params.js";

import type { SilentReplyPromptMode } from "../system-prompt.types.js";

/** Input contract for one CLI-backed agent run. */

export type RunCliAgentParams = {

sessionId: string;

sessionKey?: string;

cleanupBundleMcpOnRunEnd?: boolean;

};

/** Backend config after MCP, skill, env, and cleanup preparation. */

export type CliPreparedBackend = {

backend: CliBackendConfig;

cleanup?: () => Promise<void>;

env?: Record<string, string>;

};

/** Reusable CLI session id and the reason it was rejected, when any. */

export type CliReusableSession = {

sessionId?: string;

invalidatedReason?:

| "orphaned-tool-use";

};

/** Fully prepared execution context consumed by the CLI runner executor. */

export type PreparedCliRunContext = {

params: RunCliAgentParams;

effectiveAuthProfileId?: string;