docs: document package sources

packages/acp-core/src/error-format.ts

@@ -1,3 +1,4 @@
+// ACP Core helper module supports error format behavior.
 const SECRET_PATTERNS: RegExp[] = [
   /\b[A-Z0-9_]*(?:KEY|TOKEN|SECRET|PASSWORD|PASSWD|CARD[_-]?NUMBER|CARD[_-]?CVC|CARD[_-]?CVV|CVC|CVV|SECURITY[_-]?CODE|PAYMENT[_-]?CREDENTIAL|SHARED[_-]?PAYMENT[_-]?TOKEN)\b\s*[=:]\s*(["']?)([^\s"'\\]+)\1/g,
   /\b[A-Z0-9_]*(?:KEY|TOKEN|SECRET|PASSWORD|PASSWD|CARD[_-]?NUMBER|CARD[_-]?CVC|CARD[_-]?CVV|CVC|CVV|SECURITY[_-]?CODE|PAYMENT[_-]?CREDENTIAL|SHARED[_-]?PAYMENT[_-]?TOKEN)\b\s*[=:]\s*\\+(["'])([^\s"'\\]+)\\+\1/g,

packages/acp-core/src/meta.test.ts

@@ -1,3 +1,4 @@
+// ACP Core tests cover meta behavior.
 import { describe, expect, it } from "vitest";
 import { readBool, readNonNegativeInteger, readNumber, readString } from "./meta.js";
 

packages/acp-core/src/meta.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements meta behavior.
 import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";
 
 function readMetaValue<T>(

packages/acp-core/src/numeric-options.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements numeric options behavior.
 import { resolveIntegerOption as resolveSharedIntegerOption } from "@openclaw/normalization-core/number-coercion";
 
 /** Resolves ACP integer options through the shared normalization contract. */

packages/acp-core/src/runtime/error-text.test.ts

@@ -1,3 +1,4 @@
+// ACP Core tests cover error text behavior.
 import { describe, expect, it } from "vitest";
 import { formatAcpRuntimeErrorText, toAcpRuntimeErrorText } from "./error-text.js";
 import { AcpRuntimeError, toAcpRuntimeError } from "./errors.js";

packages/acp-core/src/runtime/error-text.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements error text behavior.
 import { type AcpRuntimeErrorCode, AcpRuntimeError, toAcpRuntimeError } from "./errors.js";
 
 function resolveAcpRuntimeErrorNextStep(error: AcpRuntimeError): string | undefined {

packages/acp-core/src/runtime/errors.test.ts

@@ -1,3 +1,4 @@
+// ACP Core tests cover errors behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { configureAcpErrorRedactor } from "../error-format.js";
 import {

packages/acp-core/src/runtime/errors.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements errors behavior.
 import { redactSensitiveText, stringifyNonErrorCause } from "../error-format.js";
 
 export const ACP_ERROR_CODES = [

packages/acp-core/src/runtime/session-identifiers.test.ts

@@ -1,3 +1,4 @@
+// ACP Core tests cover session identifiers behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveAcpSessionCwd,

packages/acp-core/src/runtime/session-identifiers.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements session identifiers behavior.
 import { normalizeLowercaseStringOrEmpty } from "@openclaw/normalization-core/string-coerce";
 import { normalizeText } from "../normalize-text.js";
 import type { SessionAcpIdentity, SessionAcpMeta } from "../types.js";

packages/acp-core/src/runtime/session-identity.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements session identity behavior.
 import { normalizeText } from "../normalize-text.js";
 import type { SessionAcpIdentity, SessionAcpIdentitySource, SessionAcpMeta } from "../types.js";
 import type { AcpRuntimeHandle, AcpRuntimeStatus } from "./types.js";

packages/acp-core/src/runtime/types.ts

@@ -1,3 +1,4 @@
+// ACP Core type module defines shared TypeScript contracts.
 export type AcpRuntimePromptMode = "prompt" | "steer";
 
 export type AcpRuntimeSessionMode = "persistent" | "oneshot";

packages/acp-core/src/session-interaction-mode.test.ts

@@ -1,3 +1,4 @@
+// ACP Core tests cover session interaction mode behavior.
 import { describe, expect, it } from "vitest";
 import {
   isParentOwnedBackgroundAcpSession,

packages/acp-core/src/session-interaction-mode.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements session interaction mode behavior.
 import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";
 
 type AcpSessionInteractionMode = "interactive" | "parent-owned-background";

packages/acp-core/src/session-lineage-meta.test.ts

@@ -1,3 +1,4 @@
+// ACP Core tests cover session lineage meta behavior.
 import { describe, expect, it } from "vitest";
 import { toAcpSessionLineageMeta, type AcpSessionLineageRow } from "./session-lineage-meta.js";
 

packages/acp-core/src/session-lineage-meta.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements session lineage meta behavior.
 import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";
 
 const SUBAGENT_ROLES = ["orchestrator", "leaf"] as const;

packages/acp-core/src/session.test.ts

@@ -1,3 +1,4 @@
+// ACP Core tests cover session behavior.
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import { createInMemorySessionStore } from "./session.js";
 

packages/acp-core/src/session.ts

@@ -1,3 +1,4 @@
+// ACP Core module implements session behavior.
 import { randomUUID } from "node:crypto";
 import { resolveIntegerOption } from "./numeric-options.js";
 import type { AcpSession } from "./types.js";

packages/acp-core/src/types.ts

@@ -1,3 +1,4 @@
+// ACP Core type module defines shared TypeScript contracts.
 import { normalizeOptionalLowercaseString } from "@openclaw/normalization-core/string-coerce";
 
 const ACP_PROVENANCE_MODE_VALUES = ["off", "meta", "meta+receipt"] as const;

packages/agent-core/src/agent-loop.test.ts

@@ -1,3 +1,4 @@
+// Agent Core tests cover agent loop behavior.
 import { describe, expect, it } from "vitest";
 import { agentLoop, agentLoopContinue } from "./agent-loop.js";
 import type { Message, Model } from "./llm.js";

packages/agent-core/src/agent.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements agent behavior.
 import type {
   ImageContent,
   Message,

packages/agent-core/src/harness/agent-harness.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements agent harness behavior.
 import type {
   AssistantMessage,
   ImageContent,

packages/agent-core/src/harness/compaction/branch-summarization.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements branch summarization behavior.
 import type { Model, StreamFn } from "../../../../llm-core/src/index.js";
 import {
   type AgentCoreCompletionRuntimeDeps,

packages/agent-core/src/harness/compaction/compaction.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements compaction behavior.
 import type {
   AssistantMessage,
   Context,

packages/agent-core/src/harness/compaction/utils.ts

@@ -1,3 +1,4 @@
+// Agent Core helper module supports utils behavior.
 import type { Message } from "../../../../llm-core/src/index.js";
 import type { AgentMessage } from "../../types.js";
 

packages/agent-core/src/harness/env/kill-tree.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements kill tree behavior.
 import { spawn } from "node:child_process";
 
 const DEFAULT_GRACE_MS = 3000;

packages/agent-core/src/harness/env/nodejs.test.ts

@@ -1,3 +1,4 @@
+// Agent Core tests cover nodejs behavior.
 import { describe, expect, it } from "vitest";
 import { resolveExecTimeoutMs } from "./nodejs.js";
 

packages/agent-core/src/harness/env/nodejs.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements nodejs behavior.
 import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { constants, createReadStream } from "node:fs";

packages/agent-core/src/harness/file-loader-utils.ts

@@ -1,3 +1,4 @@
+// Agent Core helper module supports file loader utils behavior.
 import { parse } from "yaml";
 import { type ExecutionEnv, type FileInfo, type Result, toError } from "./types.js";
 

packages/agent-core/src/harness/messages.test.ts

@@ -1,3 +1,4 @@
+// Agent Core tests cover messages behavior.
 import { describe, expect, it } from "vitest";
 import { convertToLlm, createCustomMessage } from "./messages.js";
 

packages/agent-core/src/harness/messages.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements messages behavior.
 import type { ImageContent, Message, TextContent } from "../../../llm-core/src/index.js";
 import type {
   AgentMessage,

packages/agent-core/src/harness/prompt-templates.test.ts

@@ -1,3 +1,4 @@
+// Agent Core tests cover prompt templates behavior.
 import { describe, expect, it } from "vitest";
 import { parseCommandArgs, substituteArgs } from "./prompt-templates.js";
 

packages/agent-core/src/harness/prompt-templates.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements prompt templates behavior.
 import {
   basenameEnvPath,
   parseFrontmatter,

packages/agent-core/src/harness/session/jsonl-repo.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements jsonl repo behavior.
 import type {
   FileSystem,
   JsonlSessionCreateOptions,

packages/agent-core/src/harness/session/jsonl-storage.test.ts

@@ -1,3 +1,4 @@
+// Agent Core tests cover jsonl storage behavior.
 import { describe, expect, it } from "vitest";
 import { ok, type FileSystem } from "../types.js";
 import { JsonlSessionStorage, loadJsonlSessionMetadata } from "./jsonl-storage.js";

packages/agent-core/src/harness/session/jsonl-storage.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements jsonl storage behavior.
 import type { FileSystem, JsonlSessionMetadata, SessionTreeEntry } from "../types.js";
 import { SessionError, toError } from "../types.js";
 import { getFileSystemResultOrThrow } from "./repo-utils.js";

packages/agent-core/src/harness/session/memory-repo.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements memory repo behavior.
 import { type Session, SessionError, type SessionMetadata, type SessionRepo } from "../types.js";
 import { InMemorySessionStorage } from "./memory-storage.js";
 import { createSessionId, createTimestamp, getEntriesToFork, toSession } from "./repo-utils.js";

packages/agent-core/src/harness/session/memory-storage.test.ts

@@ -1,3 +1,4 @@
+// Agent Core tests cover memory storage behavior.
 import { describe, expect, it } from "vitest";
 import type { SessionTreeEntry } from "../types.js";
 import { InMemorySessionStorage } from "./memory-storage.js";

packages/agent-core/src/harness/session/memory-storage.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements memory storage behavior.
 import type { SessionMetadata, SessionTreeEntry } from "../types.js";
 import { BaseSessionStorage } from "./storage-base.js";
 import { uuidv7 } from "./uuid.js";

packages/agent-core/src/harness/session/repo-utils.ts

@@ -1,3 +1,4 @@
+// Agent Core helper module supports repo utils behavior.
 import {
   type FileError,
   type Result,

packages/agent-core/src/harness/session/session.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements session behavior.
 import type { ImageContent, TextContent } from "../../../../llm-core/src/index.js";
 import type { AgentMessage } from "../../types.js";
 import {

packages/agent-core/src/harness/session/storage-base.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements storage base behavior.
 import {
   type LeafEntry,
   SessionError,

packages/agent-core/src/harness/session/uuid.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements uuid behavior.
 let lastTimestamp = -Infinity;
 let sequence = 0;
 

packages/agent-core/src/harness/skills.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements skills behavior.
 import ignore from "ignore";
 import {
   basenameEnvPath,

packages/agent-core/src/harness/system-prompt.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements system prompt behavior.
 import type { Skill } from "./types.js";
 
 /** Format model-visible skill metadata for inclusion in the harness system prompt. */

packages/agent-core/src/harness/types.ts

@@ -1,3 +1,4 @@
+// Agent Core type module defines shared TypeScript contracts.
 import type {
   ImageContent,
   Model,

packages/agent-core/src/harness/utils/shell-output.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements shell output behavior.
 import {
   type ExecutionEnv,
   type ExecutionEnvExecOptions,

packages/agent-core/src/harness/utils/truncate.test.ts

@@ -1,3 +1,4 @@
+// Agent Core tests cover truncate behavior.
 import { describe, expect, it } from "vitest";
 import { truncateHead, truncateTail } from "./truncate.js";
 

packages/agent-core/src/harness/utils/truncate.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements truncate behavior.
 export const DEFAULT_MAX_LINES = 2000;
 export const DEFAULT_MAX_BYTES = 50 * 1024; // 50KB
 export const GREP_MAX_LINE_LENGTH = 500; // Max chars per grep match line

packages/agent-core/src/runtime-deps.ts

@@ -1,3 +1,4 @@
+// Agent Core module implements runtime deps behavior.
 import type { CompleteSimpleFn, StreamFn } from "../../llm-core/src/index.js";
 
 /** Runtime functions injected by host packages so agent-core stays provider-agnostic. */

packages/agent-core/src/types.ts

@@ -1,3 +1,4 @@
+// Agent Core type module defines shared TypeScript contracts.
 import type { Static, TSchema } from "typebox";
 import type {
   AssistantMessage,

packages/gateway-client/src/client.ts

@@ -1,3 +1,4 @@
+// Gateway Client module implements client behavior.
 import { randomUUID } from "node:crypto";
 import type {
   ConnectParams,

packages/gateway-client/src/client.watchdog.test.ts

@@ -1,3 +1,4 @@
+// Gateway Client tests cover client.watchdog behavior.
 import { createServer as createHttpsServer } from "node:https";
 import { createServer } from "node:net";
 import { afterEach, describe, expect, test, vi } from "vitest";

packages/gateway-client/src/device-auth.ts

@@ -1,3 +1,4 @@
+// Gateway Client module implements device auth behavior.
 export function normalizeDeviceMetadataForAuth(value?: string | null): string {
   if (typeof value !== "string") {
     return "";

packages/gateway-client/src/event-loop-ready.test.ts

@@ -1,3 +1,4 @@
+// Gateway Client tests cover event loop ready behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { waitForEventLoopReady } from "./event-loop-ready.js";
 import { MAX_SAFE_TIMEOUT_DELAY_MS } from "./timeouts.js";

packages/gateway-client/src/event-loop-ready.ts

@@ -1,3 +1,4 @@
+// Gateway Client module implements event loop ready behavior.
 import { resolveFiniteTimeoutDelayMs } from "./timeouts.js";
 
 /** Readiness probe outcome with timing data for diagnosing event-loop stalls. */

packages/gateway-client/src/readiness.ts

@@ -1,3 +1,4 @@
+// Gateway Client module implements readiness behavior.
 import type { GatewayClientOptions } from "./client.js";
 import {
   waitForEventLoopReady,

packages/gateway-client/src/timeouts.test.ts

@@ -1,3 +1,4 @@
+// Gateway Client tests cover timeouts behavior.
 import { describe, expect, it } from "vitest";
 import {
   addSafeTimeoutDelayGraceMs,

packages/gateway-client/src/timeouts.ts

@@ -1,3 +1,4 @@
+// Gateway Client module implements timeouts behavior.
 function parseStrictPositiveInteger(value: string): number | undefined {
   const trimmed = value.trim();
   if (!/^\+?\d+$/u.test(trimmed)) {

packages/gateway-protocol/src/channels.schema.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover channels.schema behavior.
 import { Compile } from "typebox/compile";
 import { describe, expect, it } from "vitest";
 import { ChannelsStatusResultSchema, WebLoginWaitParamsSchema } from "./schema/channels.js";

packages/gateway-protocol/src/connect-error-details.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover connect error details behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildPairingConnectCloseReason,

packages/gateway-protocol/src/cron-validators.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover cron validators behavior.
 import { describe, expect, it } from "vitest";
 import {
   validateCronAddParams,

packages/gateway-protocol/src/exec-approvals-validators.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover exec approvals validators behavior.
 import { describe, expect, it } from "vitest";
 import {
   validateExecApprovalRequestParams,

packages/gateway-protocol/src/index.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover index behavior.
 import { describe, expect, it } from "vitest";
 import { TALK_TEST_PROVIDER_ID } from "../../../src/test-utils/talk-test-provider.js";
 import * as protocol from "./index.js";

packages/gateway-protocol/src/native-protocol-levels.guard.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover native protocol levels.guard behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, it } from "vitest";

packages/gateway-protocol/src/primitives.secretref.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover primitives.secretref behavior.
 import { Compile } from "typebox/compile";
 import { describe, expect, it } from "vitest";
 import {

packages/gateway-protocol/src/push.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover push behavior.
 import { Compile } from "typebox/compile";
 import { describe, expect, it } from "vitest";
 import { PushTestResultSchema } from "./schema/push.js";

packages/gateway-protocol/src/schema/agent.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover agent behavior.
 import { Value } from "typebox/value";
 import { describe, expect, it } from "vitest";
 import { AgentParamsSchema } from "./agent.js";

packages/gateway-protocol/src/schema/agent.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { InputProvenanceSchema, NonEmptyString, SessionLabelString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/agents-models-skills.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover agents models skills behavior.
 import { Value } from "typebox/value";
 import { describe, expect, it } from "vitest";
 import {

packages/gateway-protocol/src/schema/agents-models-skills.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/artifacts.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/channels.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString, SecretInputSchema } from "./primitives.js";
 

packages/gateway-protocol/src/schema/commands.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/config.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/cron.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type, type TSchema } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/devices.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/environments.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/error-codes.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import type { ErrorShape } from "./types.js";
 
 /** Gateway JSON-RPC style error codes shared by clients and server handlers. */

packages/gateway-protocol/src/schema/exec-approvals.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/frames.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { GatewayClientIdSchema, GatewayClientModeSchema, NonEmptyString } from "./primitives.js";
 import { SnapshotSchema, StateVersionSchema } from "./snapshot.js";

packages/gateway-protocol/src/schema/logs-chat.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import type { Static } from "typebox";
 import { Type } from "typebox";
 import { ChatSendSessionKeyString, InputProvenanceSchema, NonEmptyString } from "./primitives.js";

packages/gateway-protocol/src/schema/nodes.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/plugin-approvals.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/plugins.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/primitives.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { GATEWAY_CLIENT_IDS, GATEWAY_CLIENT_MODES } from "../client-info.js";
 import {

packages/gateway-protocol/src/schema/push.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/secrets.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type, type Static } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/sessions.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { PluginJsonValueSchema } from "./plugins.js";
 import { NonEmptyString, SessionLabelString } from "./primitives.js";

packages/gateway-protocol/src/schema/snapshot.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/tasks.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/schema/wizard.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol schema module defines protocol validation shapes.
 import { Type } from "typebox";
 import { NonEmptyString } from "./primitives.js";
 

packages/gateway-protocol/src/talk-config.contract.test.ts

@@ -1,3 +1,4 @@
+// Gateway Protocol tests cover talk config.contract behavior.
 import fs from "node:fs";
 import { describe, expect, it } from "vitest";
 import { buildTalkConfigResponse } from "../../../src/config/talk.js";

packages/llm-core/src/types.ts

@@ -1,3 +1,4 @@
+// LLM Core type module defines shared TypeScript contracts.
 export type { AssistantMessageDiagnostic, DiagnosticErrorInfo } from "./utils/diagnostics.js";
 import type { AssistantMessageDiagnostic } from "./utils/diagnostics.js";
 

packages/llm-core/src/utils/diagnostics.ts

@@ -1,3 +1,4 @@
+// LLM Core module implements diagnostics behavior.
 export interface DiagnosticErrorInfo {
   name?: string;
   message: string;

packages/llm-core/src/utils/event-stream.ts

@@ -1,3 +1,4 @@
+// LLM Core module implements event stream behavior.
 import type {
   AssistantMessage,
   AssistantMessageEvent,

packages/llm-core/src/validation.test.ts

@@ -1,3 +1,4 @@
+// LLM Core tests cover validation behavior.
 import { describe, expect, it } from "vitest";
 import type { Tool } from "./types.js";
 import { validateToolArguments } from "./validation.js";

packages/llm-core/src/validation.ts

@@ -1,3 +1,4 @@
+// LLM Core module implements validation behavior.
 import { Compile } from "typebox/compile";
 import type { TLocalizedValidationError } from "typebox/error";
 import { Value } from "typebox/value";

packages/llm-runtime/src/api-registry.test.ts

@@ -1,3 +1,4 @@
+// LLM Runtime tests cover api registry behavior.
 import { createAssistantMessageEventStream, type Model } from "@openclaw/llm-core";
 import { afterEach, describe, expect, it } from "vitest";
 import { getApiProvider, registerApiProvider, unregisterApiProviders } from "./api-registry.js";

packages/llm-runtime/src/api-registry.ts

@@ -1,3 +1,4 @@
+// LLM Runtime module implements api registry behavior.
 import type {
   Api,
   AssistantMessageEventStreamContract,