refactor: localize internal implementation types (#101731)

vincentkoc · web-flow · commit fdc7892a6e5a · 2026-07-07T07:41:04.000-07:00
diff --git a/extensions/discord/src/approval-handler.runtime.ts b/extensions/discord/src/approval-handler.runtime.ts
@@ -49,7 +49,7 @@ type PreparedDeliveryTarget = {
   recipientUserId?: string;
 };
 
-export type DiscordApprovalHandlerContext = {
+type DiscordApprovalHandlerContext = {
   token: string;
   config: DiscordExecApprovalConfig;
 };
diff --git a/extensions/feishu/src/doctor.ts b/extensions/feishu/src/doctor.ts
@@ -71,7 +71,7 @@ export type FeishuDoctorInspection = {
   sessionEntries: FeishuDoctorSessionEntry[];
 };
 
-export type FeishuDoctorRepairReport = {
+type FeishuDoctorRepairReport = {
   backupDir: string;
   stateDirRepairAttempted: boolean;
   rebuiltStateDir: boolean;
diff --git a/extensions/feishu/src/monitor.account.ts b/extensions/feishu/src/monitor.account.ts
@@ -46,7 +46,7 @@ export type FeishuReactionCreatedEvent = {
   action_time?: string;
 };
 
-export type FeishuReactionDeletedEvent = FeishuReactionCreatedEvent & {
+type FeishuReactionDeletedEvent = FeishuReactionCreatedEvent & {
   reaction_id?: string;
 };
 
@@ -500,7 +500,9 @@ export async function monitorSingleAccount(params: MonitorSingleAccountParams):
     const eventDispatcher = createEventDispatcher(account);
     const chatHistories = new Map<string, HistoryEntry[]>();
     threadBindingManager = createFeishuThreadBindingManager({ accountId, cfg });
-    const channelRuntime = params.channelRuntime?.inbound ? params.channelRuntime : getFeishuRuntime().channel;
+    const channelRuntime = params.channelRuntime?.inbound
+      ? params.channelRuntime
+      : getFeishuRuntime().channel;
 
     registerEventHandlers(eventDispatcher, {
       cfg,
diff --git a/extensions/file-transfer/src/shared/policy.ts b/extensions/file-transfer/src/shared/policy.ts
@@ -52,7 +52,7 @@ import { mutateConfigFile } from "openclaw/plugin-sdk/config-mutation";
 import { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
 
 export type FilePolicyKind = "read" | "write";
-export type FilePolicyAskMode = "off" | "on-miss" | "always";
+type FilePolicyAskMode = "off" | "on-miss" | "always";
 
 type FilePolicyDecision =
   | { ok: true; reason: "matched-allow"; maxBytes?: number; followSymlinks: boolean }
diff --git a/extensions/logbook/src/node-host.ts b/extensions/logbook/src/node-host.ts
@@ -10,7 +10,7 @@ import { resolvePreferredOpenClawTmpDir } from "openclaw/plugin-sdk/temp-path";
 
 const execFileAsync = promisify(execFile);
 
-export type LogbookSnapshotParams = {
+type LogbookSnapshotParams = {
   screenIndex?: number;
   maxWidth?: number;
   quality?: number;
diff --git a/extensions/matrix/src/approval-handler.runtime.ts b/extensions/matrix/src/approval-handler.runtime.ts
@@ -139,7 +139,7 @@ export type MatrixApprovalHandlerDeps = {
   repairDirectRooms?: typeof repairMatrixDirectRooms;
 };
 
-export type MatrixApprovalHandlerContext = {
+type MatrixApprovalHandlerContext = {
   client: MatrixClient;
   deps?: MatrixApprovalHandlerDeps;
 };
diff --git a/extensions/msteams/src/graph-messages.ts b/extensions/msteams/src/graph-messages.ts
@@ -312,7 +312,7 @@ export const TEAMS_REACTION_TYPES = [
   "sad",
   "angry",
 ] as const;
-export type TeamsReactionType = (typeof TEAMS_REACTION_TYPES)[number];
+type TeamsReactionType = (typeof TEAMS_REACTION_TYPES)[number];
 
 type GraphReaction = {
   reactionType?: string;
diff --git a/extensions/qa-lab/src/live-transports/shared/credential-lease.runtime.ts b/extensions/qa-lab/src/live-transports/shared/credential-lease.runtime.ts
@@ -74,7 +74,7 @@ type QaCredentialLeaseHeartbeat = {
   throwIfFailed(): void;
 };
 
-export type QaCredentialRole = "ci" | "maintainer";
+type QaCredentialRole = "ci" | "maintainer";
 
 type QaCredentialLeaseSource = "convex" | "env";
 
diff --git a/extensions/qa-lab/src/live-transports/whatsapp/whatsapp-live.runtime.ts b/extensions/qa-lab/src/live-transports/whatsapp/whatsapp-live.runtime.ts
@@ -51,7 +51,7 @@ import {
 
 const execFileAsync = promisify(execFile);
 
-export type WhatsAppQaRuntimeEnv = {
+type WhatsAppQaRuntimeEnv = {
   driverAuthArchiveBase64: string;
   driverPhoneE164: string;
   sutAuthArchiveBase64: string;
diff --git a/extensions/qa-lab/src/scorecard-taxonomy.ts b/extensions/qa-lab/src/scorecard-taxonomy.ts
@@ -325,10 +325,10 @@ export type QaNativeCoverageEvidenceKind = "script" | "vitest" | "playwright";
 export type QaScorecardEvidenceKind = QaNativeCoverageEvidenceKind | "qa-scenario";
 export type QaScorecardEvidenceMode = z.infer<typeof qaScorecardEvidenceModeSchema>;
 export type QaScorecardChannelDriver = z.infer<typeof qaScorecardChannelDriverSchema>;
-export type QaMaturityScoreKey = (typeof QA_MATURITY_SCORE_KEYS)[number];
+type QaMaturityScoreKey = (typeof QA_MATURITY_SCORE_KEYS)[number];
 export type QaMaturityScoreObject = z.infer<typeof qaMaturityScoreObjectSchema>;
 export type QaMaturityScoreSurfaceLts = z.infer<typeof qaMaturityScoreSurfaceLtsSchema>;
-export type QaMaturityScoreCategory = z.infer<typeof qaMaturityScoreCategorySchema>;
+type QaMaturityScoreCategory = z.infer<typeof qaMaturityScoreCategorySchema>;
 export type QaMaturityScoreSurface = z.infer<typeof qaMaturityScoreSurfaceSchema>;
 export type QaMaturityScores = z.infer<typeof qaMaturityScoresSchema>;
 export type QaMaturityTaxonomyLevel = z.infer<typeof qaMaturityLevelSchema>;
diff --git a/extensions/signal/src/client.ts b/extensions/signal/src/client.ts
@@ -18,7 +18,7 @@ export type SignalRpcError = {
   data?: unknown;
 };
 
-export type SignalRpcResponse<T> = {
+type SignalRpcResponse<T> = {
   jsonrpc?: string;
   result?: T;
   error?: SignalRpcError;
diff --git a/extensions/slack/src/approval-handler.runtime.ts b/extensions/slack/src/approval-handler.runtime.ts
@@ -56,7 +56,7 @@ type SlackExecApprovalConfig = NonNullable<
   NonNullable<NonNullable<OpenClawConfig["channels"]>["slack"]>["execApprovals"]
 >;
 
-export type SlackApprovalHandlerContext = {
+type SlackApprovalHandlerContext = {
   app: App;
   config: SlackExecApprovalConfig;
 };
diff --git a/extensions/slack/src/draft-stream.ts b/extensions/slack/src/draft-stream.ts
@@ -23,7 +23,7 @@ type SlackDraftStream = {
   channelId: () => string | undefined;
 };
 
-export type SlackDraftStreamUpdate =
+type SlackDraftStreamUpdate =
   | string
   | {
       text: string;
diff --git a/extensions/slack/src/monitor/relay-source.ts b/extensions/slack/src/monitor/relay-source.ts
@@ -35,7 +35,7 @@ type RelayConnectionState = {
 const SLACK_RELAY_ROUTE_KINDS = new Set(["user_group", "thread_affinity", "channel_default"]);
 export const SLACK_RELAY_MAX_PAYLOAD_BYTES = 1024 * 1024;
 
-export type SlackRelayRoute = {
+type SlackRelayRoute = {
   kind: "user_group" | "thread_affinity" | "channel_default";
   key: string;
 };
diff --git a/extensions/telegram/src/rich-plain-fallback.ts b/extensions/telegram/src/rich-plain-fallback.ts
@@ -11,10 +11,7 @@ const RICH_ENTITY_INVALID_RE =
 const RICH_CONTENT_REQUIRED_RE = /RICH_MESSAGE_CONTENT_REQUIRED/i;
 const PARSE_ERR_RE = /can't parse entities|parse entities|find end of the entity/i;
 
-export type TelegramPlainFallbackTrigger =
-  | "rich-entity-invalid"
-  | "html-parse"
-  | "rich-content-required";
+type TelegramPlainFallbackTrigger = "rich-entity-invalid" | "html-parse" | "rich-content-required";
 
 type TelegramPlainFallbackPlan = {
   plainText: string;
diff --git a/extensions/tlon/src/urbit/send.ts b/extensions/tlon/src/urbit/send.ts
@@ -6,7 +6,7 @@ import {
 } from "openclaw/plugin-sdk/channel-outbound";
 import { markdownToStory, createImageBlock, isImageUrl, type Story } from "./story.js";
 
-export type TlonPokeApi = {
+type TlonPokeApi = {
   poke: (params: { app: string; mark: string; json: unknown }) => Promise<unknown>;
 };
 
diff --git a/extensions/voice-call/src/config.ts b/extensions/voice-call/src/config.ts
@@ -100,7 +100,7 @@ const VoiceCallNumberRouteConfigSchema = z
     responseTimeoutMs: z.number().int().positive().optional(),
   })
   .strict();
-export type VoiceCallNumberRouteConfig = z.infer<typeof VoiceCallNumberRouteConfigSchema>;
+type VoiceCallNumberRouteConfig = z.infer<typeof VoiceCallNumberRouteConfigSchema>;
 
 // -----------------------------------------------------------------------------
 // Webhook Server Configuration
diff --git a/src/agents/acp-spawn.ts b/src/agents/acp-spawn.ts
@@ -117,7 +117,7 @@ const log = createSubsystemLogger("agents/acp-spawn");
 const ACP_RUNTIME_TIMEOUT_MAX_SECONDS = 24 * 60 * 60;
 
 export const ACP_SPAWN_MODES = ["run", "session"] as const;
-export type SpawnAcpMode = (typeof ACP_SPAWN_MODES)[number];
+type SpawnAcpMode = (typeof ACP_SPAWN_MODES)[number];
 const ACP_SPAWN_SANDBOX_MODES = ["inherit", "require"] as const;
 export type SpawnAcpSandboxMode = (typeof ACP_SPAWN_SANDBOX_MODES)[number];
 export const ACP_SPAWN_STREAM_TARGETS = ["parent"] as const;
@@ -197,7 +197,7 @@ const ACP_SPAWN_ERROR_CODES = [
   "spawn_failed",
   "dispatch_failed",
 ] as const;
-export type SpawnAcpErrorCode = (typeof ACP_SPAWN_ERROR_CODES)[number];
+type SpawnAcpErrorCode = (typeof ACP_SPAWN_ERROR_CODES)[number];
 
 type SpawnAcpResultFields = {
   childSessionKey?: string;
diff --git a/src/agents/auth-profiles/oauth-manager.ts b/src/agents/auth-profiles/oauth-manager.ts
@@ -53,7 +53,7 @@ export type OAuthManagerAdapter = {
   isRefreshTokenReusedError: (error: unknown) => boolean;
 };
 
-export type ResolvedOAuthAccess = {
+type ResolvedOAuthAccess = {
   apiKey: string;
   credential: OAuthCredential;
 };
diff --git a/src/agents/model-fallback.ts b/src/agents/model-fallback.ts
@@ -176,7 +176,7 @@ export function isFallbackSummaryError(err: unknown): err is FallbackSummaryErro
   return err instanceof FallbackSummaryError;
 }
 
-export type ModelFallbackRunOptions = {
+type ModelFallbackRunOptions = {
   allowTransientCooldownProbe?: boolean;
   isFinalFallbackAttempt?: boolean;
 };
diff --git a/src/agents/utils/syntax-highlight.ts b/src/agents/utils/syntax-highlight.ts
@@ -10,7 +10,7 @@ import { decodeHtmlEntityAt } from "./html.js";
 /** Formatter applied to highlighted text segments. */
 export type HighlightFormatter = (text: string) => string;
 /** Mapping from highlight.js scope names to text formatters. */
-export type HighlightTheme = Partial<Record<string, HighlightFormatter>>;
+type HighlightTheme = Partial<Record<string, HighlightFormatter>>;
 
 /** Options used when highlighting code and rendering themed text. */
 interface HighlightOptions {
diff --git a/src/auto-reply/reply/agent-runner-cli-dispatch.ts b/src/auto-reply/reply/agent-runner-cli-dispatch.ts
@@ -210,7 +210,7 @@ function readCommentaryTextPayload(evt: AgentEventPayload): CommentaryTextPayloa
   };
 }
 
-export type CliToolEventPayload = {
+type CliToolEventPayload = {
   name: string | undefined;
   phase: "start" | "update" | "result";
   args: Record<string, unknown> | undefined;
diff --git a/src/auto-reply/reply/prompt-prelude.ts b/src/auto-reply/reply/prompt-prelude.ts
@@ -78,7 +78,7 @@ export function buildReplyPromptBodies(params: {
 }
 
 /** Startup action associated with a reply prompt envelope. */
-export type ReplyPromptEnvelopeStartupAction = "new" | "reset";
+type ReplyPromptEnvelopeStartupAction = "new" | "reset";
 
 /** Full prompt envelope passed into reply run preparation. */
 export type ReplyPromptEnvelope = ReturnType<typeof buildReplyPromptBodies> & {
diff --git a/src/channels/plugins/read-only.ts b/src/channels/plugins/read-only.ts
@@ -154,7 +154,7 @@ type ReadOnlyChannelPluginResolution = {
   loadFailures: ReadOnlyChannelPluginLoadFailure[];
 };
 type ManifestChannelConfigRecord = NonNullable<PluginManifestRecord["channelConfigs"]>[string];
-export type ReadOnlyChannelPluginLoadFailure = {
+type ReadOnlyChannelPluginLoadFailure = {
   channelId: string;
   pluginId: string;
   message: string;
diff --git a/src/cli/hooks-cli.ts b/src/cli/hooks-cli.ts
@@ -42,7 +42,7 @@ export type HooksCheckOptions = {
   json?: boolean;
 };
 
-export type HooksUpdateOptions = {
+type HooksUpdateOptions = {
   all?: boolean;
   dryRun?: boolean;
 };
diff --git a/src/cli/plugins-cli.ts b/src/cli/plugins-cli.ts
@@ -7,7 +7,7 @@ import type { PluginsListOptions } from "./plugins-list-command.js";
 import { parseStrictPositiveIntOption } from "./program/helpers.js";
 import { applyParentDefaultHelpAction } from "./program/parent-default-help.js";
 
-export type PluginUpdateOptions = {
+type PluginUpdateOptions = {
   all?: boolean;
   acknowledgeClawhubRisk?: boolean;
   dryRun?: boolean;
@@ -40,7 +40,7 @@ export type PluginMarketplaceRefreshOptions = {
   json?: boolean;
 };
 
-export type PluginSearchOptions = {
+type PluginSearchOptions = {
   json?: boolean;
   limit?: number;
 };
@@ -58,18 +58,18 @@ export type PluginRegistryOptions = {
   refresh?: boolean;
 };
 
-export type PluginAuthoringBuildOptions = {
+type PluginAuthoringBuildOptions = {
   root?: string;
   entry?: string;
   check?: boolean;
 };
 
-export type PluginAuthoringValidateOptions = {
+type PluginAuthoringValidateOptions = {
   root?: string;
   entry?: string;
 };
 
-export type PluginAuthoringInitOptions = {
+type PluginAuthoringInitOptions = {
   directory?: string;
   force?: boolean;
   type?: string;
diff --git a/src/cli/program/routed-command-definitions.ts b/src/cli/program/routed-command-definitions.ts
@@ -28,7 +28,7 @@ type ModelsStatusCommandModule = typeof import("../../commands/models/list.statu
 type TasksJsonCommandModule = typeof import("../../commands/tasks-json.js");
 
 /** Typed parsed route definition that binds one parser to its runner. */
-export type RoutedCommandDefinition<TParse extends RouteArgParser<unknown>> = {
+type RoutedCommandDefinition<TParse extends RouteArgParser<unknown>> = {
   parseArgs: TParse;
   runParsedArgs: (args: ParsedRouteArgs<TParse>) => Promise<void>;
 };
diff --git a/src/commands/onboard-non-interactive/local/output.ts b/src/commands/onboard-non-interactive/local/output.ts
@@ -24,7 +24,7 @@ export type GatewayHealthFailureDiagnostics = {
 };
 
 /** Coarse recovery category for gateway health failures. */
-export type GatewayHealthFailureClassification =
+type GatewayHealthFailureClassification =
   | "not-listening"
   | "auth-mismatch"
   | "service-missing"
diff --git a/src/gateway/session-compaction-checkpoints.ts b/src/gateway/session-compaction-checkpoints.ts
@@ -66,7 +66,7 @@ export type CompactionCheckpointForkedTranscript = ForkedCompactionCheckpointTra
   totalTokens?: number;
 };
 
-export type CompactionCheckpointTranscriptForkResult =
+type CompactionCheckpointTranscriptForkResult =
   | { status: "created"; transcript: CompactionCheckpointForkedTranscript }
   | { status: "missing-boundary" }
   | { status: "failed" };
diff --git a/src/hooks/install.ts b/src/hooks/install.ts
@@ -53,8 +53,7 @@ export const HOOK_INSTALL_ERROR_CODE = {
   EMPTY_OPENCLAW_HOOKS: "empty_openclaw_hooks",
 } as const;
 
-export type HookInstallErrorCode =
-  (typeof HOOK_INSTALL_ERROR_CODE)[keyof typeof HOOK_INSTALL_ERROR_CODE];
+type HookInstallErrorCode = (typeof HOOK_INSTALL_ERROR_CODE)[keyof typeof HOOK_INSTALL_ERROR_CODE];
 
 /** Integrity drift payload surfaced when npm metadata no longer matches an install record. */
 export type HookNpmIntegrityDriftParams = {
diff --git a/src/infra/backup-create.ts b/src/infra/backup-create.ts
@@ -169,7 +169,7 @@ function isTarEofRaceError(err: unknown): boolean {
   return /(did not encounter expected|encountered unexpected) EOF|TAR_BAD_ARCHIVE/i.test(message);
 }
 
-export type BackupTarRetryLogger = (message: string) => void;
+type BackupTarRetryLogger = (message: string) => void;
 
 function resolveBackupTarAttemptTempPath(tempArchivePath: string, attempt: number): string {
   return attempt === 1 ? tempArchivePath : `${tempArchivePath}.retry-${attempt}`;
diff --git a/src/infra/outbound/channel-target-prefix.ts b/src/infra/outbound/channel-target-prefix.ts
@@ -53,7 +53,7 @@ export function stripTargetTopicSuffix(
 }
 
 /** Parsed provider prefix and the channel that owns it. */
-export type ChannelTargetProviderPrefix = {
+type ChannelTargetProviderPrefix = {
   prefix: string;
   channel: string;
 };
diff --git a/src/infra/outbound/message.ts b/src/infra/outbound/message.ts
@@ -47,7 +47,7 @@ const loadMessageGatewayRuntime = createLazyRuntimeModule(
   () => import("./message.gateway.runtime.js"),
 );
 
-export type MessageGatewayOptions = OutboundMessageGatewayOptionsInput;
+type MessageGatewayOptions = OutboundMessageGatewayOptionsInput;
 
 type MessageSendParams = {
   to: string;
diff --git a/src/infra/outbound/targets.ts b/src/infra/outbound/targets.ts
@@ -38,7 +38,7 @@ import {
 export type OutboundChannel = DeliverableMessageChannel;
 
 /** Heartbeat target channel id from agent/default heartbeat config. */
-export type HeartbeatTarget = OutboundChannel;
+type HeartbeatTarget = OutboundChannel;
 
 /** Resolved outbound delivery destination and routing hints. */
 export type OutboundTarget = {
diff --git a/src/plugins/discovery.ts b/src/plugins/discovery.ts
@@ -109,7 +109,7 @@ function currentUid(overrideUid?: number | null): number | null {
   return process.getuid();
 }
 
-export type CandidateBlockReason =
+type CandidateBlockReason =
   | "source_escapes_root"
   | "path_stat_failed"
   | "path_world_writable"
diff --git a/src/plugins/setup-registry.ts b/src/plugins/setup-registry.ts
@@ -67,7 +67,7 @@ export type PluginSetupRegistryDiagnosticCode =
   | "setup-descriptor-cli-backend-missing-runtime"
   | "setup-descriptor-cli-backend-runtime-undeclared";
 
-export type PluginSetupRegistryDiagnostic = {
+type PluginSetupRegistryDiagnostic = {
   pluginId: string;
   code: PluginSetupRegistryDiagnosticCode;
   declaredId?: string;
diff --git a/src/plugins/update.ts b/src/plugins/update.ts
@@ -82,7 +82,7 @@ export type PluginUpdateLogger = {
 /** Outcome status for one plugin update attempt. */
 export type PluginUpdateStatus = "updated" | "unchanged" | "skipped" | "error";
 
-export type PluginUpdateChannelFallback = {
+type PluginUpdateChannelFallback = {
   requestedSpec: string;
   usedSpec: string;
   requestedLabel: string;
diff --git a/src/process/spawn-utils.ts b/src/process/spawn-utils.ts
