docs: document auto reply delivery runtime

src/auto-reply/reply/agent-runner-helpers.test.ts

@@ -1,3 +1,4 @@
+// Tests agent runner helper decisions for payload and runtime preparation.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { ReplyPayload } from "../types.js";
 import type { TypingSignaler } from "./typing-mode.js";

src/auto-reply/reply/agent-runner-memory.test.ts

@@ -1,3 +1,4 @@
+// Tests agent runner memory flush and persisted memory context handling.
 import fsCore from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";

src/auto-reply/reply/commands-abort-trigger.test.ts

@@ -1,3 +1,4 @@
+// Tests abort trigger command parsing and cancellation requests.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { handleAbortTrigger } from "./commands-session-abort.js";

src/auto-reply/reply/commands-approve.ts

@@ -1,3 +1,4 @@
+// Implements approval commands for pending tool and execution requests.
 import { normalizeLowercaseStringOrEmpty } from "@openclaw/normalization-core/string-coerce";
 import {
   getChannelPlugin,

src/auto-reply/reply/commands-core.runtime.ts

@@ -1 +1,2 @@
+// Runtime barrel for command handlers that need lazy production imports.
 export { emitResetCommandHooks } from "./commands-reset-hooks.js";

src/auto-reply/reply/commands-export-trajectory.ts

@@ -1,3 +1,4 @@
+// Implements trajectory export command packaging for the active session agent.
 import { resolveSessionAgentId } from "../../agents/agent-scope.js";
 import { createExecTool } from "../../agents/bash-tools.js";
 import type { ExecToolDetails } from "../../agents/bash-tools.js";

src/auto-reply/reply/commands-openclaw-cli.ts

@@ -1,3 +1,4 @@
+// Formats OpenClaw CLI command snippets for chat-facing command responses.
 function quoteShellArg(value: string): string {
   if (process.platform === "win32") {
     return `'${value.replaceAll("'", "''")}'`;

src/auto-reply/reply/commands-plugin.test.ts

@@ -1,3 +1,4 @@
+// Tests plugin command dispatch and plugin-scoped command aliases.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { handlePluginCommand } from "./commands-plugin.js";

src/auto-reply/reply/commands-session-restart.test.ts

@@ -1,3 +1,4 @@
+// Tests session restart command behavior and runtime reset handoff.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { RestartSentinelPayload } from "../../infra/restart-sentinel.js";
 import type { scheduleGatewaySigusr1Restart } from "../../infra/restart.js";

src/auto-reply/reply/commands-session-store.ts

@@ -1,3 +1,4 @@
+// Shared session-store helpers for command handlers that mutate sessions.
 import type { SessionEntry } from "../../config/sessions.js";
 import { updateSessionStore } from "../../config/sessions.js";
 import { applyAbortCutoffToSessionEntry, type AbortCutoff } from "./abort-cutoff.js";

src/auto-reply/reply/commands-status-subagents.ts

@@ -1,3 +1,4 @@
+// Formats subagent status rows for the status command response.
 import type { SubagentRunRecord } from "../../agents/subagent-registry.types.js";
 import { formatDurationCompact } from "../../infra/format-time/format-duration.ts";
 import { formatRunLabel, sortSubagentRuns } from "./subagents-utils.js";

src/auto-reply/reply/commands-status.runtime.ts

@@ -1,2 +1,3 @@
+// Runtime barrel for status command helpers loaded outside core command setup.
 export { buildStatusReply } from "./commands-status.js";
 export { buildStatusText } from "../../status/status-text.js";

src/auto-reply/reply/commands-steer.test.ts

@@ -1,3 +1,4 @@
+// Tests steer command persistence and retrieval for session guidance.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import { buildCommandTestParams } from "./commands.test-harness.js";

src/auto-reply/reply/commands-tasks.test.ts

@@ -1,3 +1,4 @@
+// Tests task command routing and persisted task state replies.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { resolveSessionAgentId } from "../../agents/agent-scope.js";
 import {

src/auto-reply/reply/completion-delivery-policy.ts

@@ -1,3 +1,4 @@
+// Resolves whether completed replies should send visibly or stay tool-only.
 import { normalizeChatType, type ChatType } from "../../channels/chat-type.js";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import { deriveSessionChatTypeFromKey } from "../../sessions/session-chat-type-shared.js";

src/auto-reply/reply/dispatch-acp-delivery.test.ts

@@ -1,3 +1,4 @@
+// Tests ACP dispatch delivery routing and visible reply handoff.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { createAcpDispatchDeliveryCoordinator } from "./dispatch-acp-delivery.js";

src/auto-reply/reply/get-reply-directives-apply.test.ts

@@ -1,3 +1,4 @@
+// Tests applying parsed directives to get-reply execution options.
 import { describe, expect, it } from "vitest";
 import { formatModelOverrideResetEvent } from "./get-reply-directives-apply.js";
 

src/auto-reply/reply/get-reply-run.exec-hint.test.ts

@@ -1,3 +1,4 @@
+// Tests execution hint propagation through get-reply run setup.
 import { describe, expect, it } from "vitest";
 import type { SessionEntry } from "../../config/sessions.js";
 import type { TemplateContext } from "../templating.js";

src/auto-reply/reply/get-reply.config-override.test.ts

@@ -1,3 +1,4 @@
+// Tests get-reply config override handling for a single inbound turn.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import {

src/auto-reply/reply/mcp-commands.ts

@@ -1,3 +1,4 @@
+// Implements MCP server command parsing and persisted enablement settings.
 import { parseStandardSetUnsetSlashCommand } from "./commands-setunset-standard.js";
 
 export type McpCommand =

src/auto-reply/reply/reply-dispatcher.ts

@@ -1,3 +1,4 @@
+// Dispatches final reply payloads through visible senders and message tools.
 import type { TypingCallbacks } from "../../channels/typing.js";
 import type { HumanDelayConfig } from "../../config/types.js";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";

src/auto-reply/reply/route-reply.test.ts

@@ -1,3 +1,4 @@
+// Tests routeReply delivery decisions across channels and fallback paths.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type {
   ChannelMessagingAdapter,

src/auto-reply/reply/routing-policy.test.ts

@@ -1,3 +1,4 @@
+// Tests reply routing policy decisions for direct, group, and private routes.
 import { describe, expect, it } from "vitest";
 import { resolveReplyRoutingDecision } from "./routing-policy.js";
 

src/auto-reply/reply/session-run-accounting.ts

@@ -1,3 +1,4 @@
+// Tracks per-session run usage totals and last-run accounting facts.
 import { deriveSessionTotalTokens, type NormalizedUsage } from "../../agents/usage.js";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import { incrementCompactionCount } from "./session-updates.js";