refactor(agents): narrow runtime guard exports

vincentkoc · vincentkoc · commit d1ea170c9b55 · 2026-06-17T08:32:26.000+08:00
diff --git a/src/agents/provider-http-errors.ts b/src/agents/provider-http-errors.ts
@@ -27,7 +27,7 @@ export function truncateErrorDetail(detail: string, limit = 220): string {
 }
 
 /** Redacts secrets before preserving a bounded provider error body preview. */
-export function redactProviderErrorBody(body: string): string {
+function redactProviderErrorBody(body: string): string {
   return truncateErrorDetail(redactSensitiveText(body), ERROR_BODY_METADATA_LIMIT);
 }
 
@@ -145,7 +145,7 @@ function extractProviderErrorPayloadMetadata(payload: unknown): ProviderErrorPay
 }
 
 /** Metadata extracted from a non-2xx provider response body and headers. */
-export type ProviderHttpErrorInfo = {
+type ProviderHttpErrorInfo = {
   detail?: string;
   code?: string;
   type?: string;
diff --git a/src/agents/run-cleanup-timeout.ts b/src/agents/run-cleanup-timeout.ts
@@ -9,8 +9,8 @@ import { parseStrictPositiveInteger } from "../infra/parse-finite-number.js";
 // Cleanup steps must not block run completion forever. This module bounds each
 // cleanup step and logs enough context to debug late failures.
 export const AGENT_CLEANUP_STEP_TIMEOUT_MS = 10_000;
-export const AGENT_CLEANUP_STEP_TIMEOUT_ENV = "OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS";
-export const TRAJECTORY_FLUSH_TIMEOUT_ENV = "OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS";
+const AGENT_CLEANUP_STEP_TIMEOUT_ENV = "OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS";
+const TRAJECTORY_FLUSH_TIMEOUT_ENV = "OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS";
 export const CLEANUP_TIMEOUT_DETAILS_MAX_CHARS = 512;
 
 const CLEANUP_TIMEOUT_DETAILS_TRUNCATED_SUFFIX = "...[truncated]";
diff --git a/src/agents/run-termination.ts b/src/agents/run-termination.ts
@@ -5,7 +5,7 @@
  * controller aborts without matching free-form error text.
  */
 /** Stop reason emitted when an agent run is aborted. */
-export const AGENT_RUN_ABORTED_STOP_REASON = "aborted" as const;
+const AGENT_RUN_ABORTED_STOP_REASON = "aborted" as const;
 /** Error text used for aborted agent runs. */
 export const AGENT_RUN_ABORTED_ERROR = "agent run aborted" as const;
 export const AGENT_RUN_RESTART_ABORT_STOP_REASON = "restart" as const;
diff --git a/src/agents/run-timeout-attribution.ts b/src/agents/run-timeout-attribution.ts
@@ -1,5 +1,5 @@
 /** Agent run phases used when attributing timeout/cancellation sources. */
-export const AGENT_RUN_TIMEOUT_PHASES = [
+const AGENT_RUN_TIMEOUT_PHASES = [
   "queue",
   "preflight",
   "provider",
diff --git a/src/agents/session-write-lock.ts b/src/agents/session-write-lock.ts
@@ -46,9 +46,9 @@ type CleanupSignal = (typeof CLEANUP_SIGNALS)[number];
 const CLEANUP_STATE_KEY = Symbol.for("openclaw.sessionWriteLockCleanupState");
 const WATCHDOG_STATE_KEY = Symbol.for("openclaw.sessionWriteLockWatchdogState");
 
-export const DEFAULT_SESSION_WRITE_LOCK_STALE_MS = 30 * 60 * 1000;
-export const DEFAULT_SESSION_WRITE_LOCK_MAX_HOLD_MS = 5 * 60 * 1000;
-export const DEFAULT_SESSION_WRITE_LOCK_ACQUIRE_TIMEOUT_MS = 60_000;
+const DEFAULT_SESSION_WRITE_LOCK_STALE_MS = 30 * 60 * 1000;
+const DEFAULT_SESSION_WRITE_LOCK_MAX_HOLD_MS = 5 * 60 * 1000;
+const DEFAULT_SESSION_WRITE_LOCK_ACQUIRE_TIMEOUT_MS = 60_000;
 const DEFAULT_WATCHDOG_INTERVAL_MS = 60_000;
 const DEFAULT_TIMEOUT_GRACE_MS = 2 * 60 * 1000;
 const REPORT_ONLY_STALE_LOCK_REASONS = new Set(["too-old", "hold-exceeded"]);
@@ -189,7 +189,7 @@ export function resolveSessionWriteLockStaleMs(
   });
 }
 
-export function resolveSessionWriteLockMaxHoldMs(
+function resolveSessionWriteLockMaxHoldMs(
   config?: SessionWriteLockAcquireTimeoutConfig,
   params: { env?: NodeJS.ProcessEnv; fallback?: number } = {},
 ): number {

Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@ export function truncateErrorDetail(detail: string, limit = 220): string {`
`27`	`27`	`}`
`28`	`28`
`29`	`29`	`/** Redacts secrets before preserving a bounded provider error body preview. */`
`30`		`-export function redactProviderErrorBody(body: string): string {`
	`30`	`+function redactProviderErrorBody(body: string): string {`
`31`	`31`	`return truncateErrorDetail(redactSensitiveText(body), ERROR_BODY_METADATA_LIMIT);`
`32`	`32`	`}`
`33`	`33`
`@@ -145,7 +145,7 @@ function extractProviderErrorPayloadMetadata(payload: unknown): ProviderErrorPay`
`145`	`145`	`}`
`146`	`146`
`147`	`147`	`/** Metadata extracted from a non-2xx provider response body and headers. */`
`148`		`-export type ProviderHttpErrorInfo = {`
	`148`	`+type ProviderHttpErrorInfo = {`
`149`	`149`	`detail?: string;`
`150`	`150`	`code?: string;`
`151`	`151`	`type?: string;`