};

/** Ordered backend candidates plus display helper for diagnostics. */

export type BackendCandidatePlan = {

type BackendCandidatePlan = {

candidateBackends: string[];

describeBackendCandidate: (backend: string) => string;

};

const ACP_BACKGROUND_TASK_PROGRESS_MAX_LENGTH = 240;

/** Context needed to mirror a child ACP turn into the requester task registry. */

export type BackgroundTaskContext = {

type BackgroundTaskContext = {

requesterSessionKey: string;

requesterOrigin?: DeliveryContext;

childSessionKey: string;

import { normalizeText } from "./runtime-options.js";

/** Mutable gate used to suppress late events after timeout/cancel races. */

export type AcpTurnEventGate = {

type AcpTurnEventGate = {

open: boolean;

};

/** Summary of whether a turn stream emitted user-visible output or terminal events. */

export type AcpTurnStreamOutcome = {

type AcpTurnStreamOutcome = {

sawOutput: boolean;

sawTerminalEvent: boolean;

};

onEvent?: (event: AcpRuntimeEvent) => Promise<void> | void;

};

export type AcpTurnLifecycleEvent = {

type AcpTurnLifecycleEvent = {

type: "prompt_submitted";

at: number;

};

};

/** Snapshot entry used for idle eviction and cache diagnostics. */

export type CachedRuntimeSnapshot = {

type CachedRuntimeSnapshot = {

actorKey: string;

state: CachedRuntimeState;

lastTouchedAt: number;

stale: 15_000,

} as const;

export type AcpEventLedgerEntry = {

type AcpEventLedgerEntry = {

seq: number;

at: number;

sessionId: string;

const ACP_DISPATCH_DISABLED_MESSAGE =

"ACP dispatch is disabled by policy (`acp.dispatch.enabled=false`).";

export type AcpDispatchPolicyState = "enabled" | "acp_disabled" | "dispatch_disabled";

type AcpDispatchPolicyState = "enabled" | "acp_disabled" | "dispatch_disabled";

/** Returns whether ACP is globally enabled by config policy. */

export function isAcpEnabledByPolicy(cfg: OpenClawConfig): boolean {

>;

/** ACP session controls and modes shown to the client. */

export type SessionPresentation = {

type SessionPresentation = {

configOptions: SessionConfigOption[];

modes: SessionModeState;

};

/** ACP session metadata plus lineage information. */

export type SessionMetadata = {

type SessionMetadata = {

title?: string | null;

updatedAt?: string | null;

_meta?: AcpSessionLineageMeta;

};

/** Context/token usage snapshot for ACP clients that expose progress meters. */

export type SessionUsageSnapshot = {

type SessionUsageSnapshot = {

size: number;

used: number;

};

thinking?: string;

};

export type ReplayChunk = {

type ReplayChunk = {

sessionUpdate: "user_message_chunk" | "agent_message_chunk" | "agent_thought_chunk";

text: string;

};

ACP_LIST_SESSIONS_MAX_CURSOR_OFFSET + ACP_LIST_SESSIONS_MAX_PAGE_SIZE + 1;

/** Opaque cursor payload used to page ACP session list results. */

export type ListSessionsCursor = {

type ListSessionsCursor = {

offset: number;

cwd?: string;

};