refactor(acp): hide helper types

vincentkoc · vincentkoc · commit f9439715e99b · 2026-06-17T12:48:07.000+08:00
diff --git a/src/acp/control-plane/manager.backend-failover.ts b/src/acp/control-plane/manager.backend-failover.ts
@@ -11,7 +11,7 @@ export type BackendAttempt = {
 };
 
 /** Ordered backend candidates plus display helper for diagnostics. */
-export type BackendCandidatePlan = {
+type BackendCandidatePlan = {
   candidateBackends: string[];
   describeBackendCandidate: (backend: string) => string;
 };
diff --git a/src/acp/control-plane/manager.background-task.ts b/src/acp/control-plane/manager.background-task.ts
@@ -17,7 +17,7 @@ const ACP_BACKGROUND_TASK_TEXT_MAX_LENGTH = 160;
 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;
diff --git a/src/acp/control-plane/manager.turn-stream.ts b/src/acp/control-plane/manager.turn-stream.ts
@@ -10,12 +10,12 @@ import { normalizeAcpErrorCode } from "./manager.utils.js";
 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;
 };
diff --git a/src/acp/control-plane/manager.types.ts b/src/acp/control-plane/manager.types.ts
@@ -70,7 +70,7 @@ export type AcpRunTurnInput = {
   onEvent?: (event: AcpRuntimeEvent) => Promise<void> | void;
 };
 
-export type AcpTurnLifecycleEvent = {
+type AcpTurnLifecycleEvent = {
   type: "prompt_submitted";
   at: number;
 };
diff --git a/src/acp/control-plane/runtime-cache.ts b/src/acp/control-plane/runtime-cache.ts
@@ -23,7 +23,7 @@ type RuntimeCacheEntry = {
 };
 
 /** Snapshot entry used for idle eviction and cache diagnostics. */
-export type CachedRuntimeSnapshot = {
+type CachedRuntimeSnapshot = {
   actorKey: string;
   state: CachedRuntimeState;
   lastTouchedAt: number;
diff --git a/src/acp/event-ledger.ts b/src/acp/event-ledger.ts
@@ -29,7 +29,7 @@ const FILE_LEDGER_LOCK_OPTIONS = {
   stale: 15_000,
 } as const;
 
-export type AcpEventLedgerEntry = {
+type AcpEventLedgerEntry = {
   seq: number;
   at: number;
   sessionId: string;
diff --git a/src/acp/policy.ts b/src/acp/policy.ts
@@ -7,7 +7,7 @@ const ACP_DISABLED_MESSAGE = "ACP is disabled by policy (`acp.enabled=false`).";
 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 {
diff --git a/src/acp/translator.presentation.ts b/src/acp/translator.presentation.ts
@@ -64,20 +64,20 @@ export type GatewaySessionPresentationRow = Pick<
 >;
 
 /** 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;
 };
diff --git a/src/acp/translator.replay.ts b/src/acp/translator.replay.ts
@@ -10,7 +10,7 @@ export type GatewayChatContentBlock = {
   thinking?: string;
 };
 
-export type ReplayChunk = {
+type ReplayChunk = {
   sessionUpdate: "user_message_chunk" | "agent_message_chunk" | "agent_thought_chunk";
   text: string;
 };
diff --git a/src/acp/translator.session-list.ts b/src/acp/translator.session-list.ts
@@ -12,7 +12,7 @@ export const ACP_LIST_SESSIONS_MAX_FETCH_LIMIT =
   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;
 };
diff --git a/src/acp/translator.session-updates.ts b/src/acp/translator.session-updates.ts
@@ -8,7 +8,7 @@ import type {
 import type { AcpEventLedger, AcpEventLedgerReplay } from "./event-ledger.js";
 
 /** Session identity used when emitting and recording ACP translator updates. */
-export type AcpTranslatorSessionRef = {
+type AcpTranslatorSessionRef = {
   sessionId: string;
   sessionKey: string;
   ledgerSessionId?: string;
