diff --git a/packages/acp-core/src/error-format.ts b/packages/acp-core/src/error-format.ts index f3b30150d71..172bf38e32e 100644 --- a/packages/acp-core/src/error-format.ts +++ b/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, diff --git a/packages/acp-core/src/meta.test.ts b/packages/acp-core/src/meta.test.ts index 7e8e522fed0..2cd4b057dc3 100644 --- a/packages/acp-core/src/meta.test.ts +++ b/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"; diff --git a/packages/acp-core/src/meta.ts b/packages/acp-core/src/meta.ts index 3eb42ccea6d..b295ce7f0e1 100644 --- a/packages/acp-core/src/meta.ts +++ b/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( diff --git a/packages/acp-core/src/numeric-options.ts b/packages/acp-core/src/numeric-options.ts index 71e689bc22f..53a49c16ee3 100644 --- a/packages/acp-core/src/numeric-options.ts +++ b/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. */ diff --git a/packages/acp-core/src/runtime/error-text.test.ts b/packages/acp-core/src/runtime/error-text.test.ts index 80d3eea39e5..20e39d2cff2 100644 --- a/packages/acp-core/src/runtime/error-text.test.ts +++ b/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"; diff --git a/packages/acp-core/src/runtime/error-text.ts b/packages/acp-core/src/runtime/error-text.ts index 38ee84a13ea..617fbc41a9c 100644 --- a/packages/acp-core/src/runtime/error-text.ts +++ b/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 { diff --git a/packages/acp-core/src/runtime/errors.test.ts b/packages/acp-core/src/runtime/errors.test.ts index 70cceb44fca..2846c15f7c5 100644 --- a/packages/acp-core/src/runtime/errors.test.ts +++ b/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 { diff --git a/packages/acp-core/src/runtime/errors.ts b/packages/acp-core/src/runtime/errors.ts index a4fbe241f03..ef99704076b 100644 --- a/packages/acp-core/src/runtime/errors.ts +++ b/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 = [ diff --git a/packages/acp-core/src/runtime/session-identifiers.test.ts b/packages/acp-core/src/runtime/session-identifiers.test.ts index 88198ba03bf..b18bf42784e 100644 --- a/packages/acp-core/src/runtime/session-identifiers.test.ts +++ b/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, diff --git a/packages/acp-core/src/runtime/session-identifiers.ts b/packages/acp-core/src/runtime/session-identifiers.ts index 953e646e097..a7bb7625ceb 100644 --- a/packages/acp-core/src/runtime/session-identifiers.ts +++ b/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"; diff --git a/packages/acp-core/src/runtime/session-identity.ts b/packages/acp-core/src/runtime/session-identity.ts index f6b00bbae74..eb0633dbdd7 100644 --- a/packages/acp-core/src/runtime/session-identity.ts +++ b/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"; diff --git a/packages/acp-core/src/runtime/types.ts b/packages/acp-core/src/runtime/types.ts index 3f6a6ff9d84..3f24c2e2c34 100644 --- a/packages/acp-core/src/runtime/types.ts +++ b/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"; diff --git a/packages/acp-core/src/session-interaction-mode.test.ts b/packages/acp-core/src/session-interaction-mode.test.ts index 5b77ee8079f..0bf5784286b 100644 --- a/packages/acp-core/src/session-interaction-mode.test.ts +++ b/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, diff --git a/packages/acp-core/src/session-interaction-mode.ts b/packages/acp-core/src/session-interaction-mode.ts index 9e84a8fb950..741c2712a6c 100644 --- a/packages/acp-core/src/session-interaction-mode.ts +++ b/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"; diff --git a/packages/acp-core/src/session-lineage-meta.test.ts b/packages/acp-core/src/session-lineage-meta.test.ts index b290d4c94d5..a441929f633 100644 --- a/packages/acp-core/src/session-lineage-meta.test.ts +++ b/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"; diff --git a/packages/acp-core/src/session-lineage-meta.ts b/packages/acp-core/src/session-lineage-meta.ts index 1915cc2f5ee..82ca278f850 100644 --- a/packages/acp-core/src/session-lineage-meta.ts +++ b/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; diff --git a/packages/acp-core/src/session.test.ts b/packages/acp-core/src/session.test.ts index 30a55b45fd2..5dbf0d474d5 100644 --- a/packages/acp-core/src/session.test.ts +++ b/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"; diff --git a/packages/acp-core/src/session.ts b/packages/acp-core/src/session.ts index c0f65e1d4a3..bb2313e2895 100644 --- a/packages/acp-core/src/session.ts +++ b/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"; diff --git a/packages/acp-core/src/types.ts b/packages/acp-core/src/types.ts index 92b05f9da90..971c0fbdc39 100644 --- a/packages/acp-core/src/types.ts +++ b/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; diff --git a/packages/agent-core/src/agent-loop.test.ts b/packages/agent-core/src/agent-loop.test.ts index 40cde4d624c..0677fcd7bcc 100644 --- a/packages/agent-core/src/agent-loop.test.ts +++ b/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"; diff --git a/packages/agent-core/src/agent.ts b/packages/agent-core/src/agent.ts index 522df048cea..57fa069ee73 100644 --- a/packages/agent-core/src/agent.ts +++ b/packages/agent-core/src/agent.ts @@ -1,3 +1,4 @@ +// Agent Core module implements agent behavior. import type { ImageContent, Message, diff --git a/packages/agent-core/src/harness/agent-harness.ts b/packages/agent-core/src/harness/agent-harness.ts index 0d3b173a639..a42f035000e 100644 --- a/packages/agent-core/src/harness/agent-harness.ts +++ b/packages/agent-core/src/harness/agent-harness.ts @@ -1,3 +1,4 @@ +// Agent Core module implements agent harness behavior. import type { AssistantMessage, ImageContent, diff --git a/packages/agent-core/src/harness/compaction/branch-summarization.ts b/packages/agent-core/src/harness/compaction/branch-summarization.ts index ea71aabc147..e9a9443ec33 100644 --- a/packages/agent-core/src/harness/compaction/branch-summarization.ts +++ b/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, diff --git a/packages/agent-core/src/harness/compaction/compaction.ts b/packages/agent-core/src/harness/compaction/compaction.ts index 32f9c7c84c7..c497fe0eeb7 100644 --- a/packages/agent-core/src/harness/compaction/compaction.ts +++ b/packages/agent-core/src/harness/compaction/compaction.ts @@ -1,3 +1,4 @@ +// Agent Core module implements compaction behavior. import type { AssistantMessage, Context, diff --git a/packages/agent-core/src/harness/compaction/utils.ts b/packages/agent-core/src/harness/compaction/utils.ts index 56302df5c70..7d1632b9d4c 100644 --- a/packages/agent-core/src/harness/compaction/utils.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/env/kill-tree.ts b/packages/agent-core/src/harness/env/kill-tree.ts index 1d372862391..4ea5f2e5deb 100644 --- a/packages/agent-core/src/harness/env/kill-tree.ts +++ b/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; diff --git a/packages/agent-core/src/harness/env/nodejs.test.ts b/packages/agent-core/src/harness/env/nodejs.test.ts index 919f1615de5..6bc90cf902f 100644 --- a/packages/agent-core/src/harness/env/nodejs.test.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/env/nodejs.ts b/packages/agent-core/src/harness/env/nodejs.ts index 26013e4985a..e50093b9a37 100644 --- a/packages/agent-core/src/harness/env/nodejs.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/file-loader-utils.ts b/packages/agent-core/src/harness/file-loader-utils.ts index 668f35128df..cf29689918f 100644 --- a/packages/agent-core/src/harness/file-loader-utils.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/messages.test.ts b/packages/agent-core/src/harness/messages.test.ts index 74c22746b36..e42542399f2 100644 --- a/packages/agent-core/src/harness/messages.test.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/messages.ts b/packages/agent-core/src/harness/messages.ts index dfc2ed70490..eaf4adefbcd 100644 --- a/packages/agent-core/src/harness/messages.ts +++ b/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, diff --git a/packages/agent-core/src/harness/prompt-templates.test.ts b/packages/agent-core/src/harness/prompt-templates.test.ts index 6532e059b15..b1202300455 100644 --- a/packages/agent-core/src/harness/prompt-templates.test.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/prompt-templates.ts b/packages/agent-core/src/harness/prompt-templates.ts index e8a7f35d5b2..422e4d6bcc7 100644 --- a/packages/agent-core/src/harness/prompt-templates.ts +++ b/packages/agent-core/src/harness/prompt-templates.ts @@ -1,3 +1,4 @@ +// Agent Core module implements prompt templates behavior. import { basenameEnvPath, parseFrontmatter, diff --git a/packages/agent-core/src/harness/session/jsonl-repo.ts b/packages/agent-core/src/harness/session/jsonl-repo.ts index 87bc3506ac1..36515365fd2 100644 --- a/packages/agent-core/src/harness/session/jsonl-repo.ts +++ b/packages/agent-core/src/harness/session/jsonl-repo.ts @@ -1,3 +1,4 @@ +// Agent Core module implements jsonl repo behavior. import type { FileSystem, JsonlSessionCreateOptions, diff --git a/packages/agent-core/src/harness/session/jsonl-storage.test.ts b/packages/agent-core/src/harness/session/jsonl-storage.test.ts index 8d3ec7846db..75ef8996885 100644 --- a/packages/agent-core/src/harness/session/jsonl-storage.test.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/session/jsonl-storage.ts b/packages/agent-core/src/harness/session/jsonl-storage.ts index 5c426486a12..91df4ce025f 100644 --- a/packages/agent-core/src/harness/session/jsonl-storage.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/session/memory-repo.ts b/packages/agent-core/src/harness/session/memory-repo.ts index 8cb5994090a..082bb45f6b1 100644 --- a/packages/agent-core/src/harness/session/memory-repo.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/session/memory-storage.test.ts b/packages/agent-core/src/harness/session/memory-storage.test.ts index 764956ec1c3..5fd4a33da56 100644 --- a/packages/agent-core/src/harness/session/memory-storage.test.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/session/memory-storage.ts b/packages/agent-core/src/harness/session/memory-storage.ts index bf3555d9e46..f8bfc32084f 100644 --- a/packages/agent-core/src/harness/session/memory-storage.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/session/repo-utils.ts b/packages/agent-core/src/harness/session/repo-utils.ts index 1aebf12be5c..43d838ad93d 100644 --- a/packages/agent-core/src/harness/session/repo-utils.ts +++ b/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, diff --git a/packages/agent-core/src/harness/session/session.ts b/packages/agent-core/src/harness/session/session.ts index 02afb0bc82f..44ac9e0c3dd 100644 --- a/packages/agent-core/src/harness/session/session.ts +++ b/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 { diff --git a/packages/agent-core/src/harness/session/storage-base.ts b/packages/agent-core/src/harness/session/storage-base.ts index 66092d12172..7a5936fedf3 100644 --- a/packages/agent-core/src/harness/session/storage-base.ts +++ b/packages/agent-core/src/harness/session/storage-base.ts @@ -1,3 +1,4 @@ +// Agent Core module implements storage base behavior. import { type LeafEntry, SessionError, diff --git a/packages/agent-core/src/harness/session/uuid.ts b/packages/agent-core/src/harness/session/uuid.ts index b998a8eeada..45203e69c44 100644 --- a/packages/agent-core/src/harness/session/uuid.ts +++ b/packages/agent-core/src/harness/session/uuid.ts @@ -1,3 +1,4 @@ +// Agent Core module implements uuid behavior. let lastTimestamp = -Infinity; let sequence = 0; diff --git a/packages/agent-core/src/harness/skills.ts b/packages/agent-core/src/harness/skills.ts index fc945e8c28d..1c8a0bb14e8 100644 --- a/packages/agent-core/src/harness/skills.ts +++ b/packages/agent-core/src/harness/skills.ts @@ -1,3 +1,4 @@ +// Agent Core module implements skills behavior. import ignore from "ignore"; import { basenameEnvPath, diff --git a/packages/agent-core/src/harness/system-prompt.ts b/packages/agent-core/src/harness/system-prompt.ts index 7030e51fc30..1b1cc08cc25 100644 --- a/packages/agent-core/src/harness/system-prompt.ts +++ b/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. */ diff --git a/packages/agent-core/src/harness/types.ts b/packages/agent-core/src/harness/types.ts index 25567db090f..f74ecc3cc85 100644 --- a/packages/agent-core/src/harness/types.ts +++ b/packages/agent-core/src/harness/types.ts @@ -1,3 +1,4 @@ +// Agent Core type module defines shared TypeScript contracts. import type { ImageContent, Model, diff --git a/packages/agent-core/src/harness/utils/shell-output.ts b/packages/agent-core/src/harness/utils/shell-output.ts index e8843911d3a..58079aebc15 100644 --- a/packages/agent-core/src/harness/utils/shell-output.ts +++ b/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, diff --git a/packages/agent-core/src/harness/utils/truncate.test.ts b/packages/agent-core/src/harness/utils/truncate.test.ts index 5425de01602..a4b719b72fe 100644 --- a/packages/agent-core/src/harness/utils/truncate.test.ts +++ b/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"; diff --git a/packages/agent-core/src/harness/utils/truncate.ts b/packages/agent-core/src/harness/utils/truncate.ts index 88fb3cdbdaf..f92fb63785e 100644 --- a/packages/agent-core/src/harness/utils/truncate.ts +++ b/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 diff --git a/packages/agent-core/src/runtime-deps.ts b/packages/agent-core/src/runtime-deps.ts index 01ce1131775..d30b93afbc8 100644 --- a/packages/agent-core/src/runtime-deps.ts +++ b/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. */ diff --git a/packages/agent-core/src/types.ts b/packages/agent-core/src/types.ts index 7baf77299d1..ba6e8eace36 100644 --- a/packages/agent-core/src/types.ts +++ b/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, diff --git a/packages/gateway-client/src/client.ts b/packages/gateway-client/src/client.ts index 4d81d8a4750..c25cc0b5f71 100644 --- a/packages/gateway-client/src/client.ts +++ b/packages/gateway-client/src/client.ts @@ -1,3 +1,4 @@ +// Gateway Client module implements client behavior. import { randomUUID } from "node:crypto"; import type { ConnectParams, diff --git a/packages/gateway-client/src/client.watchdog.test.ts b/packages/gateway-client/src/client.watchdog.test.ts index 4ce20ca594c..884539a5bdd 100644 --- a/packages/gateway-client/src/client.watchdog.test.ts +++ b/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"; diff --git a/packages/gateway-client/src/device-auth.ts b/packages/gateway-client/src/device-auth.ts index 10cbdd4ef96..d3ed6dda2e4 100644 --- a/packages/gateway-client/src/device-auth.ts +++ b/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 ""; diff --git a/packages/gateway-client/src/event-loop-ready.test.ts b/packages/gateway-client/src/event-loop-ready.test.ts index 4081cac63b4..1d9f10a38c3 100644 --- a/packages/gateway-client/src/event-loop-ready.test.ts +++ b/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"; diff --git a/packages/gateway-client/src/event-loop-ready.ts b/packages/gateway-client/src/event-loop-ready.ts index 10c2c87f42e..257feebc02d 100644 --- a/packages/gateway-client/src/event-loop-ready.ts +++ b/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. */ diff --git a/packages/gateway-client/src/readiness.ts b/packages/gateway-client/src/readiness.ts index 3ace314671d..a67a392a52c 100644 --- a/packages/gateway-client/src/readiness.ts +++ b/packages/gateway-client/src/readiness.ts @@ -1,3 +1,4 @@ +// Gateway Client module implements readiness behavior. import type { GatewayClientOptions } from "./client.js"; import { waitForEventLoopReady, diff --git a/packages/gateway-client/src/timeouts.test.ts b/packages/gateway-client/src/timeouts.test.ts index 4f97d08dad7..3a3861f35ab 100644 --- a/packages/gateway-client/src/timeouts.test.ts +++ b/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, diff --git a/packages/gateway-client/src/timeouts.ts b/packages/gateway-client/src/timeouts.ts index 5e2c02a5902..15589d94aed 100644 --- a/packages/gateway-client/src/timeouts.ts +++ b/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)) { diff --git a/packages/gateway-protocol/src/channels.schema.test.ts b/packages/gateway-protocol/src/channels.schema.test.ts index fc64b758b92..c4429158287 100644 --- a/packages/gateway-protocol/src/channels.schema.test.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/connect-error-details.test.ts b/packages/gateway-protocol/src/connect-error-details.test.ts index 811c0dcadc5..3ac1fb266ce 100644 --- a/packages/gateway-protocol/src/connect-error-details.test.ts +++ b/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, diff --git a/packages/gateway-protocol/src/cron-validators.test.ts b/packages/gateway-protocol/src/cron-validators.test.ts index 2e8b276832f..1c4d0a0e89d 100644 --- a/packages/gateway-protocol/src/cron-validators.test.ts +++ b/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, diff --git a/packages/gateway-protocol/src/exec-approvals-validators.test.ts b/packages/gateway-protocol/src/exec-approvals-validators.test.ts index 63d95050d5e..f95892ba313 100644 --- a/packages/gateway-protocol/src/exec-approvals-validators.test.ts +++ b/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, diff --git a/packages/gateway-protocol/src/index.test.ts b/packages/gateway-protocol/src/index.test.ts index fe7ceb0f4c6..2a7b8df21bd 100644 --- a/packages/gateway-protocol/src/index.test.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/native-protocol-levels.guard.test.ts b/packages/gateway-protocol/src/native-protocol-levels.guard.test.ts index 67725ef7cfa..7ecc1cf64e5 100644 --- a/packages/gateway-protocol/src/native-protocol-levels.guard.test.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/primitives.secretref.test.ts b/packages/gateway-protocol/src/primitives.secretref.test.ts index adebe775d4d..7831714a240 100644 --- a/packages/gateway-protocol/src/primitives.secretref.test.ts +++ b/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 { diff --git a/packages/gateway-protocol/src/push.test.ts b/packages/gateway-protocol/src/push.test.ts index e479271a554..5dd5ebc8331 100644 --- a/packages/gateway-protocol/src/push.test.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/agent.test.ts b/packages/gateway-protocol/src/schema/agent.test.ts index 1dbb7ea1ca8..bd03583bd7a 100644 --- a/packages/gateway-protocol/src/schema/agent.test.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/agent.ts b/packages/gateway-protocol/src/schema/agent.ts index 7af4dc4625c..c19a0907654 100644 --- a/packages/gateway-protocol/src/schema/agent.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/agents-models-skills.test.ts b/packages/gateway-protocol/src/schema/agents-models-skills.test.ts index 90a2303426d..9dd96354645 100644 --- a/packages/gateway-protocol/src/schema/agents-models-skills.test.ts +++ b/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 { diff --git a/packages/gateway-protocol/src/schema/agents-models-skills.ts b/packages/gateway-protocol/src/schema/agents-models-skills.ts index a76e1d3ad50..02887bf97a2 100644 --- a/packages/gateway-protocol/src/schema/agents-models-skills.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/artifacts.ts b/packages/gateway-protocol/src/schema/artifacts.ts index 35a08f84604..74aee0f4cf7 100644 --- a/packages/gateway-protocol/src/schema/artifacts.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/channels.ts b/packages/gateway-protocol/src/schema/channels.ts index 78fa6020d28..78b49f7ccb6 100644 --- a/packages/gateway-protocol/src/schema/channels.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/commands.ts b/packages/gateway-protocol/src/schema/commands.ts index b63572059d3..a24972162df 100644 --- a/packages/gateway-protocol/src/schema/commands.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/config.ts b/packages/gateway-protocol/src/schema/config.ts index b234b4fc76d..1f78a083b82 100644 --- a/packages/gateway-protocol/src/schema/config.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/cron.ts b/packages/gateway-protocol/src/schema/cron.ts index 06051102b48..d50db3e51f9 100644 --- a/packages/gateway-protocol/src/schema/cron.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/devices.ts b/packages/gateway-protocol/src/schema/devices.ts index 017f1ab503f..53fc1818c69 100644 --- a/packages/gateway-protocol/src/schema/devices.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/environments.ts b/packages/gateway-protocol/src/schema/environments.ts index 3bfe0de4873..bee748b4628 100644 --- a/packages/gateway-protocol/src/schema/environments.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/error-codes.ts b/packages/gateway-protocol/src/schema/error-codes.ts index 619c0fa730d..d93647bf865 100644 --- a/packages/gateway-protocol/src/schema/error-codes.ts +++ b/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. */ diff --git a/packages/gateway-protocol/src/schema/exec-approvals.ts b/packages/gateway-protocol/src/schema/exec-approvals.ts index c7133ebe819..12318b0856c 100644 --- a/packages/gateway-protocol/src/schema/exec-approvals.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/frames.ts b/packages/gateway-protocol/src/schema/frames.ts index 5c5e2b8d3e6..4b3c36bc4fd 100644 --- a/packages/gateway-protocol/src/schema/frames.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/logs-chat.ts b/packages/gateway-protocol/src/schema/logs-chat.ts index 90816032a98..a4b8f5aaa43 100644 --- a/packages/gateway-protocol/src/schema/logs-chat.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/nodes.ts b/packages/gateway-protocol/src/schema/nodes.ts index 053f85798b9..2ba0ddb7376 100644 --- a/packages/gateway-protocol/src/schema/nodes.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/plugin-approvals.ts b/packages/gateway-protocol/src/schema/plugin-approvals.ts index a1156222762..66e879a6981 100644 --- a/packages/gateway-protocol/src/schema/plugin-approvals.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/plugins.ts b/packages/gateway-protocol/src/schema/plugins.ts index 7d4d6c97820..94c465c5ec4 100644 --- a/packages/gateway-protocol/src/schema/plugins.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/primitives.ts b/packages/gateway-protocol/src/schema/primitives.ts index 20ef68c12af..e6636a61240 100644 --- a/packages/gateway-protocol/src/schema/primitives.ts +++ b/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 { diff --git a/packages/gateway-protocol/src/schema/push.ts b/packages/gateway-protocol/src/schema/push.ts index a2d2be4db89..249b0246687 100644 --- a/packages/gateway-protocol/src/schema/push.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/secrets.ts b/packages/gateway-protocol/src/schema/secrets.ts index 84896065f9a..aa5d740d938 100644 --- a/packages/gateway-protocol/src/schema/secrets.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/sessions.ts b/packages/gateway-protocol/src/schema/sessions.ts index 31e21a0a1bb..9d6cbd269cc 100644 --- a/packages/gateway-protocol/src/schema/sessions.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/snapshot.ts b/packages/gateway-protocol/src/schema/snapshot.ts index 25e7375550a..596f830bdda 100644 --- a/packages/gateway-protocol/src/schema/snapshot.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/tasks.ts b/packages/gateway-protocol/src/schema/tasks.ts index 2073319a582..92361cf227e 100644 --- a/packages/gateway-protocol/src/schema/tasks.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/schema/wizard.ts b/packages/gateway-protocol/src/schema/wizard.ts index 8b82b61faac..ccfb6e95746 100644 --- a/packages/gateway-protocol/src/schema/wizard.ts +++ b/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"; diff --git a/packages/gateway-protocol/src/talk-config.contract.test.ts b/packages/gateway-protocol/src/talk-config.contract.test.ts index ea4551a8122..f6040061726 100644 --- a/packages/gateway-protocol/src/talk-config.contract.test.ts +++ b/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"; diff --git a/packages/llm-core/src/types.ts b/packages/llm-core/src/types.ts index 40879fe200a..8229be51fdc 100644 --- a/packages/llm-core/src/types.ts +++ b/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"; diff --git a/packages/llm-core/src/utils/diagnostics.ts b/packages/llm-core/src/utils/diagnostics.ts index 0b7e3286c5f..81de38b9fa8 100644 --- a/packages/llm-core/src/utils/diagnostics.ts +++ b/packages/llm-core/src/utils/diagnostics.ts @@ -1,3 +1,4 @@ +// LLM Core module implements diagnostics behavior. export interface DiagnosticErrorInfo { name?: string; message: string; diff --git a/packages/llm-core/src/utils/event-stream.ts b/packages/llm-core/src/utils/event-stream.ts index ac4f8c26238..af1df433071 100644 --- a/packages/llm-core/src/utils/event-stream.ts +++ b/packages/llm-core/src/utils/event-stream.ts @@ -1,3 +1,4 @@ +// LLM Core module implements event stream behavior. import type { AssistantMessage, AssistantMessageEvent, diff --git a/packages/llm-core/src/validation.test.ts b/packages/llm-core/src/validation.test.ts index a35a5c83f43..2c84cb564e5 100644 --- a/packages/llm-core/src/validation.test.ts +++ b/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"; diff --git a/packages/llm-core/src/validation.ts b/packages/llm-core/src/validation.ts index 211ee768129..93e6dd2d288 100644 --- a/packages/llm-core/src/validation.ts +++ b/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"; diff --git a/packages/llm-runtime/src/api-registry.test.ts b/packages/llm-runtime/src/api-registry.test.ts index 498718b689d..a7ec9e8e9f3 100644 --- a/packages/llm-runtime/src/api-registry.test.ts +++ b/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"; diff --git a/packages/llm-runtime/src/api-registry.ts b/packages/llm-runtime/src/api-registry.ts index 9b386ee7942..75d6a29d95f 100644 --- a/packages/llm-runtime/src/api-registry.ts +++ b/packages/llm-runtime/src/api-registry.ts @@ -1,3 +1,4 @@ +// LLM Runtime module implements api registry behavior. import type { Api, AssistantMessageEventStreamContract, diff --git a/packages/llm-runtime/src/stream.ts b/packages/llm-runtime/src/stream.ts index e06090c4f45..604eae2bcbf 100644 --- a/packages/llm-runtime/src/stream.ts +++ b/packages/llm-runtime/src/stream.ts @@ -1,3 +1,4 @@ +// LLM Runtime module implements stream behavior. import type { Api, AssistantMessage, diff --git a/packages/markdown-core/src/chunk-text.ts b/packages/markdown-core/src/chunk-text.ts index 612f4b916a4..2c9331a9a04 100644 --- a/packages/markdown-core/src/chunk-text.ts +++ b/packages/markdown-core/src/chunk-text.ts @@ -1,3 +1,4 @@ +// Markdown Core module implements chunk text behavior. function resolveChunkEarlyReturn(text: string, limit: number): string[] | undefined { if (!text) { return []; diff --git a/packages/markdown-core/src/code-spans.ts b/packages/markdown-core/src/code-spans.ts index 9af8102d96d..3e94d27ae2b 100644 --- a/packages/markdown-core/src/code-spans.ts +++ b/packages/markdown-core/src/code-spans.ts @@ -1,3 +1,4 @@ +// Markdown Core module implements code spans behavior. import { scanFenceSpans, type FenceScanState, type FenceSpan } from "./fences.js"; /** Incremental inline-code scanner state carried across chunk boundaries. */ diff --git a/packages/markdown-core/src/frontmatter.test.ts b/packages/markdown-core/src/frontmatter.test.ts index 6a2203cda4b..76da49ae601 100644 --- a/packages/markdown-core/src/frontmatter.test.ts +++ b/packages/markdown-core/src/frontmatter.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover frontmatter behavior. import JSON5 from "json5"; import { describe, expect, it } from "vitest"; import { parseFrontmatterBlock } from "./frontmatter.js"; diff --git a/packages/markdown-core/src/frontmatter.ts b/packages/markdown-core/src/frontmatter.ts index 6fb320be800..1559febeeee 100644 --- a/packages/markdown-core/src/frontmatter.ts +++ b/packages/markdown-core/src/frontmatter.ts @@ -1,3 +1,4 @@ +// Markdown Core module implements frontmatter behavior. import YAML from "yaml"; type ParsedFrontmatter = Record; diff --git a/packages/markdown-core/src/ir.chunking.test.ts b/packages/markdown-core/src/ir.chunking.test.ts index 4267f4f72e6..14135fcd77f 100644 --- a/packages/markdown-core/src/ir.chunking.test.ts +++ b/packages/markdown-core/src/ir.chunking.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover ir.chunking behavior. import { describe, expect, it } from "vitest"; import { chunkMarkdownIR, type MarkdownIR } from "./ir.js"; diff --git a/packages/markdown-core/src/ir.hr-spacing.test.ts b/packages/markdown-core/src/ir.hr-spacing.test.ts index 5a7a0931cc8..8df3f1df347 100644 --- a/packages/markdown-core/src/ir.hr-spacing.test.ts +++ b/packages/markdown-core/src/ir.hr-spacing.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover ir.hr spacing behavior. import { describe, it, expect } from "vitest"; import { markdownToIR } from "./ir.js"; diff --git a/packages/markdown-core/src/ir.table-block.test.ts b/packages/markdown-core/src/ir.table-block.test.ts index 43c97a9e7a7..6096f6f4121 100644 --- a/packages/markdown-core/src/ir.table-block.test.ts +++ b/packages/markdown-core/src/ir.table-block.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover ir.table block behavior. import { describe, expect, it } from "vitest"; import { markdownToIRWithMeta } from "./ir.js"; diff --git a/packages/markdown-core/src/ir.table-bullets.test.ts b/packages/markdown-core/src/ir.table-bullets.test.ts index 2cefd1c51de..4cc6c9d85a6 100644 --- a/packages/markdown-core/src/ir.table-bullets.test.ts +++ b/packages/markdown-core/src/ir.table-bullets.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover ir.table bullets behavior. import { describe, expect, it } from "vitest"; import { markdownToIR } from "./ir.js"; diff --git a/packages/markdown-core/src/ir.table-code.test.ts b/packages/markdown-core/src/ir.table-code.test.ts index 5a52c3dd22c..f18f3cc7da8 100644 --- a/packages/markdown-core/src/ir.table-code.test.ts +++ b/packages/markdown-core/src/ir.table-code.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover ir.table code behavior. import { describe, expect, it } from "vitest"; import { markdownToIR } from "./ir.js"; diff --git a/packages/markdown-core/src/ir.ts b/packages/markdown-core/src/ir.ts index df42090c6b0..23e1e8ccfac 100644 --- a/packages/markdown-core/src/ir.ts +++ b/packages/markdown-core/src/ir.ts @@ -1,3 +1,4 @@ +// Markdown Core module implements ir behavior. import MarkdownIt from "markdown-it"; import { chunkText } from "./chunk-text.js"; import type { MarkdownTableMode } from "./types.js"; diff --git a/packages/markdown-core/src/render-aware-chunking.test.ts b/packages/markdown-core/src/render-aware-chunking.test.ts index 5daf9419ef5..8913168a79e 100644 --- a/packages/markdown-core/src/render-aware-chunking.test.ts +++ b/packages/markdown-core/src/render-aware-chunking.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover render aware chunking behavior. import { describe, expect, it } from "vitest"; import type { MarkdownIR } from "./ir.js"; import { markdownToIR } from "./ir.js"; diff --git a/packages/markdown-core/src/render-aware-chunking.ts b/packages/markdown-core/src/render-aware-chunking.ts index c4b9b5cf7bc..db596671c19 100644 --- a/packages/markdown-core/src/render-aware-chunking.ts +++ b/packages/markdown-core/src/render-aware-chunking.ts @@ -1,3 +1,4 @@ +// Markdown Core module implements render aware chunking behavior. import { chunkMarkdownIR, sliceMarkdownIR, diff --git a/packages/markdown-core/src/render.ts b/packages/markdown-core/src/render.ts index a3bb9ba9465..45817ec21b5 100644 --- a/packages/markdown-core/src/render.ts +++ b/packages/markdown-core/src/render.ts @@ -1,3 +1,4 @@ +// Markdown Core module implements render behavior. import type { MarkdownIR, MarkdownLinkSpan, MarkdownStyle, MarkdownStyleSpan } from "./ir.js"; /** Marker pair used to wrap a styled Markdown span in the target renderer. */ diff --git a/packages/markdown-core/src/tables.test.ts b/packages/markdown-core/src/tables.test.ts index 89a0bb286b2..14a66013509 100644 --- a/packages/markdown-core/src/tables.test.ts +++ b/packages/markdown-core/src/tables.test.ts @@ -1,3 +1,4 @@ +// Markdown Core tests cover tables behavior. import { describe, expect, it } from "vitest"; import { convertMarkdownTables } from "./tables.js"; diff --git a/packages/markdown-core/src/tables.ts b/packages/markdown-core/src/tables.ts index 5a560a6c472..2cb60f6b720 100644 --- a/packages/markdown-core/src/tables.ts +++ b/packages/markdown-core/src/tables.ts @@ -1,3 +1,4 @@ +// Markdown Core module implements tables behavior. import { markdownToIRWithMeta } from "./ir.js"; import { renderMarkdownWithMarkers } from "./render.js"; import type { MarkdownTableMode } from "./types.js"; diff --git a/packages/media-core/src/base64.test.ts b/packages/media-core/src/base64.test.ts index e6d02ab979f..a501ec14509 100644 --- a/packages/media-core/src/base64.test.ts +++ b/packages/media-core/src/base64.test.ts @@ -1,3 +1,4 @@ +// Media Core tests cover base64 behavior. import { describe, expect, it } from "vitest"; import { canonicalizeBase64, estimateBase64DecodedBytes } from "./base64.js"; diff --git a/packages/media-core/src/file-name.ts b/packages/media-core/src/file-name.ts index afc083f9629..e355449ff3c 100644 --- a/packages/media-core/src/file-name.ts +++ b/packages/media-core/src/file-name.ts @@ -1,3 +1,4 @@ +// Media Core module implements file name behavior. import path from "node:path"; /** Returns the final filename segment for either POSIX or Windows-style paths. */ diff --git a/packages/media-core/src/inbound-path-policy.test.ts b/packages/media-core/src/inbound-path-policy.test.ts index 66c88117d9b..a5f942bc2be 100644 --- a/packages/media-core/src/inbound-path-policy.test.ts +++ b/packages/media-core/src/inbound-path-policy.test.ts @@ -1,3 +1,4 @@ +// Media Core tests cover inbound path policy behavior. import { describe, expect, it } from "vitest"; import { isInboundPathAllowed, diff --git a/packages/media-core/src/inbound-path-policy.ts b/packages/media-core/src/inbound-path-policy.ts index c229eecdf57..9bb0a902e48 100644 --- a/packages/media-core/src/inbound-path-policy.ts +++ b/packages/media-core/src/inbound-path-policy.ts @@ -1,3 +1,4 @@ +// Media Core module implements inbound path policy behavior. import path from "node:path"; const WILDCARD_SEGMENT = "*"; diff --git a/packages/media-core/src/inline-image-data-url.test.ts b/packages/media-core/src/inline-image-data-url.test.ts index ee4a4625dc6..2e092f451dc 100644 --- a/packages/media-core/src/inline-image-data-url.test.ts +++ b/packages/media-core/src/inline-image-data-url.test.ts @@ -1,3 +1,4 @@ +// Media Core tests cover inline image data url behavior. import { describe, expect, it } from "vitest"; import { sanitizeInlineImageDataUrl, sniffInlineImageMime } from "./inline-image-data-url.js"; diff --git a/packages/media-core/src/inline-image-data-url.ts b/packages/media-core/src/inline-image-data-url.ts index 6fb23692f9a..7211ecd7bbc 100644 --- a/packages/media-core/src/inline-image-data-url.ts +++ b/packages/media-core/src/inline-image-data-url.ts @@ -1,3 +1,4 @@ +// Media Core module implements inline image data url behavior. import { canonicalizeBase64 } from "./base64.js"; /** Prefix used to distinguish inline data URLs from remote/local image references. */ diff --git a/packages/media-core/src/media-source-url.ts b/packages/media-core/src/media-source-url.ts index 0c423f26b73..5a829d35266 100644 --- a/packages/media-core/src/media-source-url.ts +++ b/packages/media-core/src/media-source-url.ts @@ -1,3 +1,4 @@ +// Media Core module implements media source url behavior. const HTTP_URL_RE = /^https?:\/\//i; const MXC_URL_RE = /^mxc:\/\//i; diff --git a/packages/media-core/src/mime.test.ts b/packages/media-core/src/mime.test.ts index 5600036c3b4..bb4d85087a8 100644 --- a/packages/media-core/src/mime.test.ts +++ b/packages/media-core/src/mime.test.ts @@ -1,3 +1,4 @@ +// Media Core tests cover mime behavior. import JSZip from "jszip"; import { describe, expect, it } from "vitest"; import { mediaKindFromMime } from "./constants.js"; diff --git a/packages/media-core/src/mime.ts b/packages/media-core/src/mime.ts index df55d1662ba..3a80e47d85f 100644 --- a/packages/media-core/src/mime.ts +++ b/packages/media-core/src/mime.ts @@ -1,3 +1,4 @@ +// Media Core module implements mime behavior. import path from "node:path"; import { type MediaKind, mediaKindFromMime } from "./constants.js"; import { createLazyImportLoader } from "./lazy-import.js"; diff --git a/packages/media-core/src/read-byte-stream-with-limit.test.ts b/packages/media-core/src/read-byte-stream-with-limit.test.ts index 43f0ef21a90..464f827a1ca 100644 --- a/packages/media-core/src/read-byte-stream-with-limit.test.ts +++ b/packages/media-core/src/read-byte-stream-with-limit.test.ts @@ -1,3 +1,4 @@ +// Media Core tests cover read byte stream with limit behavior. import { Readable } from "node:stream"; import { describe, expect, it, vi } from "vitest"; import { readByteStreamWithLimit } from "./read-byte-stream-with-limit.js"; diff --git a/packages/media-core/src/read-response-with-limit.test.ts b/packages/media-core/src/read-response-with-limit.test.ts index ccbba435cce..b53d62345ca 100644 --- a/packages/media-core/src/read-response-with-limit.test.ts +++ b/packages/media-core/src/read-response-with-limit.test.ts @@ -1,3 +1,4 @@ +// Media Core tests cover read response with limit behavior. import { MAX_TIMER_TIMEOUT_MS } from "@openclaw/normalization-core/number-coercion"; import { beforeEach, describe, expect, it, vi } from "vitest"; import { readResponseTextSnippet, readResponseWithLimit } from "./read-response-with-limit.js"; diff --git a/packages/media-core/src/read-response-with-limit.ts b/packages/media-core/src/read-response-with-limit.ts index e26361b7cba..d6a9bc046e0 100644 --- a/packages/media-core/src/read-response-with-limit.ts +++ b/packages/media-core/src/read-response-with-limit.ts @@ -1,3 +1,4 @@ +// Media Core module implements read response with limit behavior. import { resolveTimerTimeoutMs } from "@openclaw/normalization-core/number-coercion"; async function readChunkWithIdleTimeout( diff --git a/packages/media-generation-core/src/capability-model-ref.ts b/packages/media-generation-core/src/capability-model-ref.ts index 2f733efed79..ed61aab3f9e 100644 --- a/packages/media-generation-core/src/capability-model-ref.ts +++ b/packages/media-generation-core/src/capability-model-ref.ts @@ -1,3 +1,4 @@ +// Media Generation Core module implements capability model ref behavior. import { normalizeOptionalString } from "./string.js"; /** Provider catalog entry shape used when resolving capability-scoped model references. */ diff --git a/packages/media-generation-core/src/catalog.test.ts b/packages/media-generation-core/src/catalog.test.ts index c47a913a504..0dd47e0645a 100644 --- a/packages/media-generation-core/src/catalog.test.ts +++ b/packages/media-generation-core/src/catalog.test.ts @@ -1,3 +1,4 @@ +// Media Generation Core tests cover catalog behavior. import { describe, expect, it } from "vitest"; import { listMediaGenerationProviderModels, diff --git a/packages/media-generation-core/src/catalog.ts b/packages/media-generation-core/src/catalog.ts index 2a9c5d53f25..15415570c78 100644 --- a/packages/media-generation-core/src/catalog.ts +++ b/packages/media-generation-core/src/catalog.ts @@ -1,3 +1,4 @@ +// Media Generation Core module implements catalog behavior. import { uniqueTrimmedStrings } from "./string.js"; // Shared media-generation catalog contracts and static entry synthesis. diff --git a/packages/media-generation-core/src/model-ref.test.ts b/packages/media-generation-core/src/model-ref.test.ts index f14b02cfbf1..7c13614d3de 100644 --- a/packages/media-generation-core/src/model-ref.test.ts +++ b/packages/media-generation-core/src/model-ref.test.ts @@ -1,3 +1,4 @@ +// Media Generation Core tests cover model ref behavior. import { describe, expect, it } from "vitest"; import { resolveCapabilityModelRefForProviders, diff --git a/packages/media-generation-core/src/model-ref.ts b/packages/media-generation-core/src/model-ref.ts index 94e29b23cd9..b103ad183b7 100644 --- a/packages/media-generation-core/src/model-ref.ts +++ b/packages/media-generation-core/src/model-ref.ts @@ -1,3 +1,4 @@ +// Media Generation Core module implements model ref behavior. import { normalizeOptionalString } from "./string.js"; /** Provider/model pair parsed from a generation model reference like `provider/model`. */ diff --git a/packages/media-understanding-common/src/defaults.ts b/packages/media-understanding-common/src/defaults.ts index fbb8db16f45..15bac5620d2 100644 --- a/packages/media-understanding-common/src/defaults.ts +++ b/packages/media-understanding-common/src/defaults.ts @@ -1,3 +1,4 @@ +// Media Understanding Common module implements defaults behavior. import type { MediaUnderstandingCapability } from "./types.js"; // Shared defaults for media-understanding limits, prompts, and concurrency. diff --git a/packages/media-understanding-common/src/format.test.ts b/packages/media-understanding-common/src/format.test.ts index 57ea5ebf83b..bb30b4843ea 100644 --- a/packages/media-understanding-common/src/format.test.ts +++ b/packages/media-understanding-common/src/format.test.ts @@ -1,3 +1,4 @@ +// Media Understanding Common tests cover format behavior. import { describe, expect, it } from "vitest"; import { formatMediaUnderstandingBody } from "./format.js"; diff --git a/packages/media-understanding-common/src/format.ts b/packages/media-understanding-common/src/format.ts index 8eb400c8260..6ce11a88df2 100644 --- a/packages/media-understanding-common/src/format.ts +++ b/packages/media-understanding-common/src/format.ts @@ -1,3 +1,4 @@ +// Media Understanding Common helper module supports format behavior. import type { MediaUnderstandingOutput } from "./types.js"; const MEDIA_PLACEHOLDER_RE = /^]+>(\s*\([^)]*\))?$/i; diff --git a/packages/media-understanding-common/src/provider-supports.ts b/packages/media-understanding-common/src/provider-supports.ts index 51e3c549cd5..204a6434270 100644 --- a/packages/media-understanding-common/src/provider-supports.ts +++ b/packages/media-understanding-common/src/provider-supports.ts @@ -1,3 +1,4 @@ +// Media Understanding Common module implements provider supports behavior. import type { MediaUnderstandingCapability, MediaUnderstandingProvider } from "./types.js"; // Capability checks for media-understanding provider objects. diff --git a/packages/media-understanding-common/src/video.ts b/packages/media-understanding-common/src/video.ts index d11d31e1d39..501a9fc9536 100644 --- a/packages/media-understanding-common/src/video.ts +++ b/packages/media-understanding-common/src/video.ts @@ -1,3 +1,4 @@ +// Media Understanding Common module implements video behavior. import { DEFAULT_VIDEO_MAX_BASE64_BYTES } from "./defaults.js"; // Video payload size helpers for base64-expanded request bodies. diff --git a/packages/memory-host-sdk/src/host/backend-config.test.ts b/packages/memory-host-sdk/src/host/backend-config.test.ts index d35381e3b1d..98b914e075a 100644 --- a/packages/memory-host-sdk/src/host/backend-config.test.ts +++ b/packages/memory-host-sdk/src/host/backend-config.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover backend config behavior. import syncFs from "node:fs"; import type { Dirent } from "node:fs"; import fs from "node:fs/promises"; diff --git a/packages/memory-host-sdk/src/host/backend-config.ts b/packages/memory-host-sdk/src/host/backend-config.ts index 42e84d0bc5e..6548c92f016 100644 --- a/packages/memory-host-sdk/src/host/backend-config.ts +++ b/packages/memory-host-sdk/src/host/backend-config.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements backend config behavior. import fs from "node:fs"; import path from "node:path"; import { diff --git a/packages/memory-host-sdk/src/host/batch-error-utils.test.ts b/packages/memory-host-sdk/src/host/batch-error-utils.test.ts index c92c9cbac39..37897b08d58 100644 --- a/packages/memory-host-sdk/src/host/batch-error-utils.test.ts +++ b/packages/memory-host-sdk/src/host/batch-error-utils.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover batch error utils behavior. import { describe, expect, it } from "vitest"; import { extractBatchErrorMessage, formatUnavailableBatchError } from "./batch-error-utils.js"; diff --git a/packages/memory-host-sdk/src/host/batch-error-utils.ts b/packages/memory-host-sdk/src/host/batch-error-utils.ts index 04ff0940160..0386400ed23 100644 --- a/packages/memory-host-sdk/src/host/batch-error-utils.ts +++ b/packages/memory-host-sdk/src/host/batch-error-utils.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports batch error utils behavior. import { formatErrorMessage } from "./error-utils.js"; // Extracts provider batch error text from output and unavailable error files. diff --git a/packages/memory-host-sdk/src/host/batch-http.test.ts b/packages/memory-host-sdk/src/host/batch-http.test.ts index 3bb2428f046..5650f49b6aa 100644 --- a/packages/memory-host-sdk/src/host/batch-http.test.ts +++ b/packages/memory-host-sdk/src/host/batch-http.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover batch http behavior. import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest"; vi.mock("./post-json.js", () => ({ diff --git a/packages/memory-host-sdk/src/host/batch-http.ts b/packages/memory-host-sdk/src/host/batch-http.ts index d7b4b8904df..dbca28843db 100644 --- a/packages/memory-host-sdk/src/host/batch-http.ts +++ b/packages/memory-host-sdk/src/host/batch-http.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements batch http behavior. import { postJson } from "./post-json.js"; import { retryAsync } from "./retry-utils.js"; import type { SsrFPolicy } from "./ssrf-policy.js"; diff --git a/packages/memory-host-sdk/src/host/batch-output.test.ts b/packages/memory-host-sdk/src/host/batch-output.test.ts index 812bd01e47a..8958485aced 100644 --- a/packages/memory-host-sdk/src/host/batch-output.test.ts +++ b/packages/memory-host-sdk/src/host/batch-output.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover batch output behavior. import { describe, expect, it } from "vitest"; import { applyEmbeddingBatchOutputLine } from "./batch-output.js"; diff --git a/packages/memory-host-sdk/src/host/batch-provider-common.ts b/packages/memory-host-sdk/src/host/batch-provider-common.ts index 60cd5386d2e..9b007b149f7 100644 --- a/packages/memory-host-sdk/src/host/batch-provider-common.ts +++ b/packages/memory-host-sdk/src/host/batch-provider-common.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports batch provider common behavior. import type { EmbeddingBatchOutputLine } from "./batch-output.js"; // Common OpenAI-compatible batch shapes shared by remote embedding providers. diff --git a/packages/memory-host-sdk/src/host/batch-runner.test.ts b/packages/memory-host-sdk/src/host/batch-runner.test.ts index cf1a7d56693..b03eeb92104 100644 --- a/packages/memory-host-sdk/src/host/batch-runner.test.ts +++ b/packages/memory-host-sdk/src/host/batch-runner.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover batch runner behavior. import { describe, expect, it, vi } from "vitest"; import { MAX_SAFE_TIMEOUT_DELAY_MS } from "../../../gateway-client/src/timeouts.js"; import { buildEmbeddingBatchGroupOptions, runEmbeddingBatchGroups } from "./batch-runner.js"; diff --git a/packages/memory-host-sdk/src/host/batch-runner.ts b/packages/memory-host-sdk/src/host/batch-runner.ts index 338fc26a4f2..525a839925d 100644 --- a/packages/memory-host-sdk/src/host/batch-runner.ts +++ b/packages/memory-host-sdk/src/host/batch-runner.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements batch runner behavior. import { resolveSafeTimeoutDelayMs } from "../../../gateway-client/src/timeouts.js"; import { splitBatchRequests } from "./batch-utils.js"; import { runWithConcurrency } from "./internal.js"; diff --git a/packages/memory-host-sdk/src/host/batch-status.test.ts b/packages/memory-host-sdk/src/host/batch-status.test.ts index 82a992556af..e2e7953934d 100644 --- a/packages/memory-host-sdk/src/host/batch-status.test.ts +++ b/packages/memory-host-sdk/src/host/batch-status.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover batch status behavior. import { describe, expect, it } from "vitest"; import { resolveBatchCompletionFromStatus, diff --git a/packages/memory-host-sdk/src/host/batch-upload.test.ts b/packages/memory-host-sdk/src/host/batch-upload.test.ts index ab71a2b7be7..29ab2fdf93f 100644 --- a/packages/memory-host-sdk/src/host/batch-upload.test.ts +++ b/packages/memory-host-sdk/src/host/batch-upload.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover batch upload behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { uploadBatchJsonlFile } from "./batch-upload.js"; import { withRemoteHttpResponse } from "./remote-http.js"; diff --git a/packages/memory-host-sdk/src/host/batch-upload.ts b/packages/memory-host-sdk/src/host/batch-upload.ts index 03b02475469..db9fbbf8666 100644 --- a/packages/memory-host-sdk/src/host/batch-upload.ts +++ b/packages/memory-host-sdk/src/host/batch-upload.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements batch upload behavior. import { buildBatchHeaders, normalizeBatchBaseUrl, diff --git a/packages/memory-host-sdk/src/host/batch-utils.ts b/packages/memory-host-sdk/src/host/batch-utils.ts index b7e951af0b0..e205274573a 100644 --- a/packages/memory-host-sdk/src/host/batch-utils.ts +++ b/packages/memory-host-sdk/src/host/batch-utils.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports batch utils behavior. import type { SsrFPolicy } from "./ssrf-policy.js"; // Common HTTP and grouping helpers for remote embedding batch clients. diff --git a/packages/memory-host-sdk/src/host/config-utils.test.ts b/packages/memory-host-sdk/src/host/config-utils.test.ts index 0d64b73e6e0..2ccfaf751f4 100644 --- a/packages/memory-host-sdk/src/host/config-utils.test.ts +++ b/packages/memory-host-sdk/src/host/config-utils.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover config utils behavior. import { describe, expect, it } from "vitest"; import { parseDurationMs } from "./config-utils.js"; diff --git a/packages/memory-host-sdk/src/host/config-utils.ts b/packages/memory-host-sdk/src/host/config-utils.ts index 8248e4650ba..f5f8b7449dc 100644 --- a/packages/memory-host-sdk/src/host/config-utils.ts +++ b/packages/memory-host-sdk/src/host/config-utils.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports config utils behavior. import fs from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/packages/memory-host-sdk/src/host/embedding-chunk-limits.test.ts b/packages/memory-host-sdk/src/host/embedding-chunk-limits.test.ts index 8b687f5b861..f4ce9fbaf6f 100644 --- a/packages/memory-host-sdk/src/host/embedding-chunk-limits.test.ts +++ b/packages/memory-host-sdk/src/host/embedding-chunk-limits.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover embedding chunk limits behavior. import { describe, expect, it } from "vitest"; import { enforceEmbeddingMaxInputTokens } from "./embedding-chunk-limits.js"; import { estimateUtf8Bytes } from "./embedding-input-limits.js"; diff --git a/packages/memory-host-sdk/src/host/embedding-chunk-limits.ts b/packages/memory-host-sdk/src/host/embedding-chunk-limits.ts index a1354b89b6e..348f720a991 100644 --- a/packages/memory-host-sdk/src/host/embedding-chunk-limits.ts +++ b/packages/memory-host-sdk/src/host/embedding-chunk-limits.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embedding chunk limits behavior. import { estimateUtf8Bytes, splitTextToUtf8ByteLimit } from "./embedding-input-limits.js"; import { hasNonTextEmbeddingParts } from "./embedding-inputs.js"; import { resolveEmbeddingMaxInputTokens } from "./embedding-model-limits.js"; diff --git a/packages/memory-host-sdk/src/host/embedding-input-limits.ts b/packages/memory-host-sdk/src/host/embedding-input-limits.ts index 4eadf1bf48d..d09ddc5e97a 100644 --- a/packages/memory-host-sdk/src/host/embedding-input-limits.ts +++ b/packages/memory-host-sdk/src/host/embedding-input-limits.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embedding input limits behavior. import type { EmbeddingInput } from "./embedding-inputs.js"; // Helpers for enforcing embedding model input size limits. diff --git a/packages/memory-host-sdk/src/host/embedding-model-limits.ts b/packages/memory-host-sdk/src/host/embedding-model-limits.ts index 17a595642bd..f217ee3f648 100644 --- a/packages/memory-host-sdk/src/host/embedding-model-limits.ts +++ b/packages/memory-host-sdk/src/host/embedding-model-limits.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embedding model limits behavior. import type { EmbeddingProvider } from "./embeddings.js"; // Provider input limits are byte-based approximations for pre-embedding chunk splitting. diff --git a/packages/memory-host-sdk/src/host/embedding-provider-adapter-utils.ts b/packages/memory-host-sdk/src/host/embedding-provider-adapter-utils.ts index a624a05bb75..4355eb9963b 100644 --- a/packages/memory-host-sdk/src/host/embedding-provider-adapter-utils.ts +++ b/packages/memory-host-sdk/src/host/embedding-provider-adapter-utils.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports embedding provider adapter utils behavior. import { normalizeLowercaseStringOrEmpty } from "./string-utils.js"; // Adapter helpers shared by remote embedding provider implementations. diff --git a/packages/memory-host-sdk/src/host/embeddings-debug.ts b/packages/memory-host-sdk/src/host/embeddings-debug.ts index 1be644b0588..8a205b62267 100644 --- a/packages/memory-host-sdk/src/host/embeddings-debug.ts +++ b/packages/memory-host-sdk/src/host/embeddings-debug.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embeddings debug behavior. import { normalizeLowercaseStringOrEmpty } from "./string-utils.js"; // Lightweight stderr debug logging for memory embedding internals. diff --git a/packages/memory-host-sdk/src/host/embeddings-model-normalize.test.ts b/packages/memory-host-sdk/src/host/embeddings-model-normalize.test.ts index dc0581b82fe..85bad07a8a8 100644 --- a/packages/memory-host-sdk/src/host/embeddings-model-normalize.test.ts +++ b/packages/memory-host-sdk/src/host/embeddings-model-normalize.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover embeddings model normalize behavior. import { describe, expect, it } from "vitest"; import { normalizeEmbeddingModelWithPrefixes } from "./embeddings-model-normalize.js"; diff --git a/packages/memory-host-sdk/src/host/embeddings-remote-client.test.ts b/packages/memory-host-sdk/src/host/embeddings-remote-client.test.ts index 6f914055fc4..b7f02397ecd 100644 --- a/packages/memory-host-sdk/src/host/embeddings-remote-client.test.ts +++ b/packages/memory-host-sdk/src/host/embeddings-remote-client.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover embeddings remote client behavior. import { describe, expect, it, vi } from "vitest"; import { resolveRemoteEmbeddingBearerClient } from "./embeddings-remote-client.js"; diff --git a/packages/memory-host-sdk/src/host/embeddings-remote-client.ts b/packages/memory-host-sdk/src/host/embeddings-remote-client.ts index 3d851068bc6..fc970ccbb9e 100644 --- a/packages/memory-host-sdk/src/host/embeddings-remote-client.ts +++ b/packages/memory-host-sdk/src/host/embeddings-remote-client.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embeddings remote client behavior. import type { EmbeddingProviderOptions } from "./embeddings.types.js"; import { requireApiKey, resolveApiKeyForProvider } from "./openclaw-runtime-auth.js"; import { buildRemoteBaseUrlPolicy } from "./remote-http.js"; diff --git a/packages/memory-host-sdk/src/host/embeddings-remote-fetch.test.ts b/packages/memory-host-sdk/src/host/embeddings-remote-fetch.test.ts index 036630d57a1..62c3e2edd24 100644 --- a/packages/memory-host-sdk/src/host/embeddings-remote-fetch.test.ts +++ b/packages/memory-host-sdk/src/host/embeddings-remote-fetch.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover embeddings remote fetch behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { fetchRemoteEmbeddingVectors } from "./embeddings-remote-fetch.js"; diff --git a/packages/memory-host-sdk/src/host/embeddings-remote-fetch.ts b/packages/memory-host-sdk/src/host/embeddings-remote-fetch.ts index 57ce6d98467..24072776f1b 100644 --- a/packages/memory-host-sdk/src/host/embeddings-remote-fetch.ts +++ b/packages/memory-host-sdk/src/host/embeddings-remote-fetch.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embeddings remote fetch behavior. import { postJson } from "./post-json.js"; import type { SsrFPolicy } from "./ssrf-policy.js"; diff --git a/packages/memory-host-sdk/src/host/embeddings-remote-provider.ts b/packages/memory-host-sdk/src/host/embeddings-remote-provider.ts index 08697d01960..bc1bff19bce 100644 --- a/packages/memory-host-sdk/src/host/embeddings-remote-provider.ts +++ b/packages/memory-host-sdk/src/host/embeddings-remote-provider.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embeddings remote provider behavior. import { resolveRemoteEmbeddingBearerClient, type RemoteEmbeddingProviderId, diff --git a/packages/memory-host-sdk/src/host/embeddings-worker-child.ts b/packages/memory-host-sdk/src/host/embeddings-worker-child.ts index 3027bfab47b..f212a3eaf06 100644 --- a/packages/memory-host-sdk/src/host/embeddings-worker-child.ts +++ b/packages/memory-host-sdk/src/host/embeddings-worker-child.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embeddings worker child behavior. import { createLocalEmbeddingProviderInProcess } from "./embeddings.js"; import type { EmbeddingProvider, EmbeddingProviderOptions } from "./embeddings.types.js"; diff --git a/packages/memory-host-sdk/src/host/embeddings-worker.ts b/packages/memory-host-sdk/src/host/embeddings-worker.ts index 566787aa58e..b7994c578e8 100644 --- a/packages/memory-host-sdk/src/host/embeddings-worker.ts +++ b/packages/memory-host-sdk/src/host/embeddings-worker.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embeddings worker behavior. import { fork, type ChildProcess } from "node:child_process"; import path from "node:path"; import { fileURLToPath } from "node:url"; diff --git a/packages/memory-host-sdk/src/host/embeddings.test.ts b/packages/memory-host-sdk/src/host/embeddings.test.ts index 8807aee8520..964a9810d8f 100644 --- a/packages/memory-host-sdk/src/host/embeddings.test.ts +++ b/packages/memory-host-sdk/src/host/embeddings.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover embeddings behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/packages/memory-host-sdk/src/host/embeddings.ts b/packages/memory-host-sdk/src/host/embeddings.ts index 9d31d420a05..bbd3dd5f469 100644 --- a/packages/memory-host-sdk/src/host/embeddings.ts +++ b/packages/memory-host-sdk/src/host/embeddings.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements embeddings behavior. import { DEFAULT_LOCAL_MODEL } from "./embedding-defaults.js"; import { sanitizeAndNormalizeEmbedding } from "./embedding-vectors.js"; import { createLocalEmbeddingWorkerProvider } from "./embeddings-worker.js"; diff --git a/packages/memory-host-sdk/src/host/embeddings.types.ts b/packages/memory-host-sdk/src/host/embeddings.types.ts index 6a0e1083a8b..4c7824c0393 100644 --- a/packages/memory-host-sdk/src/host/embeddings.types.ts +++ b/packages/memory-host-sdk/src/host/embeddings.types.ts @@ -1,3 +1,4 @@ +// Memory Host SDK type module defines shared TypeScript contracts. import type { OpenClawConfig, SecretInput } from "../engine-foundation.js"; import type { EmbeddingInput } from "./embedding-inputs.js"; diff --git a/packages/memory-host-sdk/src/host/error-utils.ts b/packages/memory-host-sdk/src/host/error-utils.ts index 39f3653203b..a63090f8d03 100644 --- a/packages/memory-host-sdk/src/host/error-utils.ts +++ b/packages/memory-host-sdk/src/host/error-utils.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports error utils behavior. const SECRET_PATTERNS: RegExp[] = [ /\b[A-Z0-9_]*(?:KEY|TOKEN|SECRET|PASSWORD|PASSWD)\b\s*[=:]\s*(["']?)([^\s"'\\]+)\1/g, /[?&](?:access[-_]?token|auth[-_]?token|hook[-_]?token|refresh[-_]?token|api[-_]?key|client[-_]?secret|token|key|secret|password|pass|passwd|auth|signature)=([^&\s"'<>]+)/gi, diff --git a/packages/memory-host-sdk/src/host/fs-utils.ts b/packages/memory-host-sdk/src/host/fs-utils.ts index 0b1181fefb8..019daad2906 100644 --- a/packages/memory-host-sdk/src/host/fs-utils.ts +++ b/packages/memory-host-sdk/src/host/fs-utils.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports fs utils behavior. import { configureFsSafePython } from "@openclaw/fs-safe/config"; // fs-safe facade with Python validation disabled by default for this package's // host-side memory file operations. diff --git a/packages/memory-host-sdk/src/host/hash.ts b/packages/memory-host-sdk/src/host/hash.ts index ebb6b124d7f..e76b867b852 100644 --- a/packages/memory-host-sdk/src/host/hash.ts +++ b/packages/memory-host-sdk/src/host/hash.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements hash behavior. import crypto from "node:crypto"; /** SHA-256 hash helper for stable cache/content keys. */ diff --git a/packages/memory-host-sdk/src/host/internal.test.ts b/packages/memory-host-sdk/src/host/internal.test.ts index ab41261b087..0a5489f5c54 100644 --- a/packages/memory-host-sdk/src/host/internal.test.ts +++ b/packages/memory-host-sdk/src/host/internal.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover internal behavior. import fsSync from "node:fs"; import fs from "node:fs/promises"; import os from "node:os"; diff --git a/packages/memory-host-sdk/src/host/internal.ts b/packages/memory-host-sdk/src/host/internal.ts index f5d9982ee34..7ad391ed2b6 100644 --- a/packages/memory-host-sdk/src/host/internal.ts +++ b/packages/memory-host-sdk/src/host/internal.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements internal behavior. import crypto from "node:crypto"; import fsSync from "node:fs"; import fs from "node:fs/promises"; diff --git a/packages/memory-host-sdk/src/host/memory-schema.ts b/packages/memory-host-sdk/src/host/memory-schema.ts index 981fb6b823c..ad0885ae8c5 100644 --- a/packages/memory-host-sdk/src/host/memory-schema.ts +++ b/packages/memory-host-sdk/src/host/memory-schema.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements memory schema behavior. import type { DatabaseSync } from "node:sqlite"; import { formatErrorMessage } from "./error-utils.js"; diff --git a/packages/memory-host-sdk/src/host/multimodal.ts b/packages/memory-host-sdk/src/host/multimodal.ts index 26ad7db7a88..0060302976e 100644 --- a/packages/memory-host-sdk/src/host/multimodal.ts +++ b/packages/memory-host-sdk/src/host/multimodal.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements multimodal behavior. import { normalizeLowercaseStringOrEmpty } from "./string-utils.js"; // Multimodal memory settings and file classification helpers. diff --git a/packages/memory-host-sdk/src/host/openclaw-runtime-auth.ts b/packages/memory-host-sdk/src/host/openclaw-runtime-auth.ts index e04eacba451..92088d951d5 100644 --- a/packages/memory-host-sdk/src/host/openclaw-runtime-auth.ts +++ b/packages/memory-host-sdk/src/host/openclaw-runtime-auth.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements openclaw runtime auth behavior. import { requireApiKey } from "../../../../src/agents/model-auth-runtime-shared.js"; import type { resolveApiKeyForProvider as ResolveApiKeyForProvider } from "../../../../src/agents/model-auth.js"; diff --git a/packages/memory-host-sdk/src/host/post-json.test.ts b/packages/memory-host-sdk/src/host/post-json.test.ts index c57e6a83e09..2fb031d6d06 100644 --- a/packages/memory-host-sdk/src/host/post-json.test.ts +++ b/packages/memory-host-sdk/src/host/post-json.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover post json behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { postJson } from "./post-json.js"; import { withRemoteHttpResponse } from "./remote-http.js"; diff --git a/packages/memory-host-sdk/src/host/post-json.ts b/packages/memory-host-sdk/src/host/post-json.ts index be0c9f2748f..1eb032aace1 100644 --- a/packages/memory-host-sdk/src/host/post-json.ts +++ b/packages/memory-host-sdk/src/host/post-json.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements post json behavior. import { withRemoteHttpResponse } from "./remote-http.js"; import { readResponseJsonWithLimit, readResponseTextSnippet } from "./response-snippet.js"; import type { SsrFPolicy } from "./ssrf-policy.js"; diff --git a/packages/memory-host-sdk/src/host/qmd-process.test.ts b/packages/memory-host-sdk/src/host/qmd-process.test.ts index 2d0bc327ff5..7ceaf03c8ac 100644 --- a/packages/memory-host-sdk/src/host/qmd-process.test.ts +++ b/packages/memory-host-sdk/src/host/qmd-process.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover qmd process behavior. import { EventEmitter } from "node:events"; import fs from "node:fs/promises"; import os from "node:os"; diff --git a/packages/memory-host-sdk/src/host/qmd-process.ts b/packages/memory-host-sdk/src/host/qmd-process.ts index eb863280891..d40bd96b17b 100644 --- a/packages/memory-host-sdk/src/host/qmd-process.ts +++ b/packages/memory-host-sdk/src/host/qmd-process.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements qmd process behavior. import { spawn } from "node:child_process"; import { statSync } from "node:fs"; import { resolveSafeTimeoutDelayMs } from "../../../gateway-client/src/timeouts.js"; diff --git a/packages/memory-host-sdk/src/host/qmd-query-parser.test.ts b/packages/memory-host-sdk/src/host/qmd-query-parser.test.ts index 14f0992e741..8f14646cb8b 100644 --- a/packages/memory-host-sdk/src/host/qmd-query-parser.test.ts +++ b/packages/memory-host-sdk/src/host/qmd-query-parser.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover qmd query parser behavior. import { describe, expect, it } from "vitest"; import { parseQmdQueryJson } from "./qmd-query-parser.js"; diff --git a/packages/memory-host-sdk/src/host/qmd-query-parser.ts b/packages/memory-host-sdk/src/host/qmd-query-parser.ts index 0368b134888..a8be1db3695 100644 --- a/packages/memory-host-sdk/src/host/qmd-query-parser.ts +++ b/packages/memory-host-sdk/src/host/qmd-query-parser.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements qmd query parser behavior. import { formatErrorMessage } from "./error-utils.js"; import { normalizeLowercaseStringOrEmpty } from "./string-utils.js"; diff --git a/packages/memory-host-sdk/src/host/qmd-scope.test.ts b/packages/memory-host-sdk/src/host/qmd-scope.test.ts index 6bcaa9105da..1b8e70b8fa7 100644 --- a/packages/memory-host-sdk/src/host/qmd-scope.test.ts +++ b/packages/memory-host-sdk/src/host/qmd-scope.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover qmd scope behavior. import { describe, expect, it } from "vitest"; import type { ResolvedQmdConfig } from "./backend-config.js"; import { deriveQmdScopeChannel, deriveQmdScopeChatType, isQmdScopeAllowed } from "./qmd-scope.js"; diff --git a/packages/memory-host-sdk/src/host/qmd-scope.ts b/packages/memory-host-sdk/src/host/qmd-scope.ts index d9e2df84324..fe4e21a559e 100644 --- a/packages/memory-host-sdk/src/host/qmd-scope.ts +++ b/packages/memory-host-sdk/src/host/qmd-scope.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements qmd scope behavior. import type { ResolvedQmdConfig } from "./backend-config.js"; import { normalizeLowercaseStringOrEmpty, diff --git a/packages/memory-host-sdk/src/host/query-expansion.test.ts b/packages/memory-host-sdk/src/host/query-expansion.test.ts index f33060aa709..77db808f1dc 100644 --- a/packages/memory-host-sdk/src/host/query-expansion.test.ts +++ b/packages/memory-host-sdk/src/host/query-expansion.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover query expansion behavior. import { describe, expect, it } from "vitest"; import { expandQueryForFts, extractKeywords } from "./query-expansion.js"; diff --git a/packages/memory-host-sdk/src/host/query-expansion.ts b/packages/memory-host-sdk/src/host/query-expansion.ts index fdf7a1ea18a..378bf156347 100644 --- a/packages/memory-host-sdk/src/host/query-expansion.ts +++ b/packages/memory-host-sdk/src/host/query-expansion.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements query expansion behavior. import { normalizeLowercaseStringOrEmpty } from "./string-utils.js"; /** diff --git a/packages/memory-host-sdk/src/host/read-file-shared.test.ts b/packages/memory-host-sdk/src/host/read-file-shared.test.ts index fbd894d66fc..1c3675e2b59 100644 --- a/packages/memory-host-sdk/src/host/read-file-shared.test.ts +++ b/packages/memory-host-sdk/src/host/read-file-shared.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover read file shared behavior. import { describe, expect, it } from "vitest"; import { buildMemoryReadResult, buildMemoryReadResultFromSlice } from "./read-file-shared.js"; diff --git a/packages/memory-host-sdk/src/host/read-file-shared.ts b/packages/memory-host-sdk/src/host/read-file-shared.ts index c5055aeaee2..2b91dae9a0d 100644 --- a/packages/memory-host-sdk/src/host/read-file-shared.ts +++ b/packages/memory-host-sdk/src/host/read-file-shared.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements read file shared behavior. import type { MemoryReadResult } from "./types.js"; // Shared memory-file read result shaping and truncation notices. diff --git a/packages/memory-host-sdk/src/host/read-file.test.ts b/packages/memory-host-sdk/src/host/read-file.test.ts index b3702f6145d..ac0713b98c5 100644 --- a/packages/memory-host-sdk/src/host/read-file.test.ts +++ b/packages/memory-host-sdk/src/host/read-file.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover read file behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/packages/memory-host-sdk/src/host/read-file.ts b/packages/memory-host-sdk/src/host/read-file.ts index 53a47c44f92..215ac8310ae 100644 --- a/packages/memory-host-sdk/src/host/read-file.ts +++ b/packages/memory-host-sdk/src/host/read-file.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements read file behavior. import fs from "node:fs/promises"; import path from "node:path"; import { diff --git a/packages/memory-host-sdk/src/host/read-retry.test.ts b/packages/memory-host-sdk/src/host/read-retry.test.ts index ad946db7771..9bef77af268 100644 --- a/packages/memory-host-sdk/src/host/read-retry.test.ts +++ b/packages/memory-host-sdk/src/host/read-retry.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover read retry behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { retryTransientMemoryRead } from "./read-retry.js"; diff --git a/packages/memory-host-sdk/src/host/read-retry.ts b/packages/memory-host-sdk/src/host/read-retry.ts index 06cc071b94d..5ce78bdeecf 100644 --- a/packages/memory-host-sdk/src/host/read-retry.ts +++ b/packages/memory-host-sdk/src/host/read-retry.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements read retry behavior. import { retryAsync } from "./retry-utils.js"; // Retry helper for transient filesystem reads observed on memory stores. diff --git a/packages/memory-host-sdk/src/host/remote-http.test.ts b/packages/memory-host-sdk/src/host/remote-http.test.ts index 15c06afa9cd..698fb09df4e 100644 --- a/packages/memory-host-sdk/src/host/remote-http.test.ts +++ b/packages/memory-host-sdk/src/host/remote-http.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover remote http behavior. import { describe, expect, it } from "vitest"; import { MEMORY_REMOTE_TRUSTED_ENV_PROXY_MODE, withRemoteHttpResponse } from "./remote-http.js"; diff --git a/packages/memory-host-sdk/src/host/remote-http.ts b/packages/memory-host-sdk/src/host/remote-http.ts index 44b9a0f6c66..18152293dc5 100644 --- a/packages/memory-host-sdk/src/host/remote-http.ts +++ b/packages/memory-host-sdk/src/host/remote-http.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements remote http behavior. import { fetchWithSsrFGuard, shouldUseEnvHttpProxyForUrl, diff --git a/packages/memory-host-sdk/src/host/response-snippet.test.ts b/packages/memory-host-sdk/src/host/response-snippet.test.ts index 6de17709c62..7776b29bee6 100644 --- a/packages/memory-host-sdk/src/host/response-snippet.test.ts +++ b/packages/memory-host-sdk/src/host/response-snippet.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover response snippet behavior. import { describe, expect, it } from "vitest"; import { readResponseTextSnippet } from "./response-snippet.js"; diff --git a/packages/memory-host-sdk/src/host/response-snippet.ts b/packages/memory-host-sdk/src/host/response-snippet.ts index 78e202fe11b..b71eb3b1a45 100644 --- a/packages/memory-host-sdk/src/host/response-snippet.ts +++ b/packages/memory-host-sdk/src/host/response-snippet.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements response snippet behavior. const DEFAULT_ERROR_BODY_MAX_BYTES = 8 * 1024; const DEFAULT_ERROR_BODY_MAX_CHARS = 1_000; const DEFAULT_JSON_BODY_MAX_BYTES = 64 * 1024 * 1024; diff --git a/packages/memory-host-sdk/src/host/retry-utils.test.ts b/packages/memory-host-sdk/src/host/retry-utils.test.ts index 908b6cbabf0..94695ff8ee1 100644 --- a/packages/memory-host-sdk/src/host/retry-utils.test.ts +++ b/packages/memory-host-sdk/src/host/retry-utils.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover retry utils behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { MAX_SAFE_TIMEOUT_DELAY_MS } from "../../../gateway-client/src/timeouts.js"; import { resolveRetryConfig, retryAsync } from "./retry-utils.js"; diff --git a/packages/memory-host-sdk/src/host/retry-utils.ts b/packages/memory-host-sdk/src/host/retry-utils.ts index 13546359a9f..70823d51926 100644 --- a/packages/memory-host-sdk/src/host/retry-utils.ts +++ b/packages/memory-host-sdk/src/host/retry-utils.ts @@ -1,3 +1,4 @@ +// Memory Host SDK helper module supports retry utils behavior. import { resolveSafeTimeoutDelayMs } from "../../../gateway-client/src/timeouts.js"; /** Retry timing configuration with optional jitter. */ diff --git a/packages/memory-host-sdk/src/host/secret-input.ts b/packages/memory-host-sdk/src/host/secret-input.ts index 9eadbf70717..44796861d4c 100644 --- a/packages/memory-host-sdk/src/host/secret-input.ts +++ b/packages/memory-host-sdk/src/host/secret-input.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements secret input behavior. import { hasConfiguredSecretInput, normalizeEnvSecretInputString, diff --git a/packages/memory-host-sdk/src/host/session-files-yield.test.ts b/packages/memory-host-sdk/src/host/session-files-yield.test.ts index 21f25db04f8..b59fbbfbe2b 100644 --- a/packages/memory-host-sdk/src/host/session-files-yield.test.ts +++ b/packages/memory-host-sdk/src/host/session-files-yield.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover session files yield behavior. import { afterEach, describe, expect, it, vi } from "vitest"; const { fileState } = vi.hoisted(() => ({ diff --git a/packages/memory-host-sdk/src/host/session-files.test.ts b/packages/memory-host-sdk/src/host/session-files.test.ts index 66d9e96c826..c77ba5cfa6c 100644 --- a/packages/memory-host-sdk/src/host/session-files.test.ts +++ b/packages/memory-host-sdk/src/host/session-files.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover session files behavior. import fsSync from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/packages/memory-host-sdk/src/host/session-files.ts b/packages/memory-host-sdk/src/host/session-files.ts index 8bd646583ad..5595a15c8e0 100644 --- a/packages/memory-host-sdk/src/host/session-files.ts +++ b/packages/memory-host-sdk/src/host/session-files.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements session files behavior. import fsSync from "node:fs"; import fs from "node:fs/promises"; import path from "node:path"; diff --git a/packages/memory-host-sdk/src/host/sqlite-vec-platform-variant.ts b/packages/memory-host-sdk/src/host/sqlite-vec-platform-variant.ts index 6405c836cd7..54bd3e6dbcc 100644 --- a/packages/memory-host-sdk/src/host/sqlite-vec-platform-variant.ts +++ b/packages/memory-host-sdk/src/host/sqlite-vec-platform-variant.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements sqlite vec platform variant behavior. import { createRequire } from "node:module"; // Resolves optional sqlite-vec native extension packages for the current platform. diff --git a/packages/memory-host-sdk/src/host/sqlite-vec.test.ts b/packages/memory-host-sdk/src/host/sqlite-vec.test.ts index c58daf945e2..e10b2f063ef 100644 --- a/packages/memory-host-sdk/src/host/sqlite-vec.test.ts +++ b/packages/memory-host-sdk/src/host/sqlite-vec.test.ts @@ -1,3 +1,4 @@ +// Memory Host SDK tests cover sqlite vec behavior. import { existsSync } from "node:fs"; import { createRequire } from "node:module"; import { afterEach, describe, expect, it, vi } from "vitest"; diff --git a/packages/memory-host-sdk/src/host/sqlite-vec.ts b/packages/memory-host-sdk/src/host/sqlite-vec.ts index 000e1b8c088..605112febe9 100644 --- a/packages/memory-host-sdk/src/host/sqlite-vec.ts +++ b/packages/memory-host-sdk/src/host/sqlite-vec.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements sqlite vec behavior. import type { DatabaseSync } from "node:sqlite"; import { formatErrorMessage } from "./error-utils.js"; import { resolveSqliteVecPlatformVariant } from "./sqlite-vec-platform-variant.js"; diff --git a/packages/memory-host-sdk/src/host/sqlite.ts b/packages/memory-host-sdk/src/host/sqlite.ts index 6cc8e86dcaa..5f28d4d10b7 100644 --- a/packages/memory-host-sdk/src/host/sqlite.ts +++ b/packages/memory-host-sdk/src/host/sqlite.ts @@ -1,3 +1,4 @@ +// Memory Host SDK module implements sqlite behavior. import { createRequire } from "node:module"; import type { DatabaseSync } from "node:sqlite"; import { formatErrorMessage } from "./error-utils.js"; diff --git a/packages/model-catalog-core/src/configured-model-refs.test.ts b/packages/model-catalog-core/src/configured-model-refs.test.ts index e10c359a2b3..f65f293fd81 100644 --- a/packages/model-catalog-core/src/configured-model-refs.test.ts +++ b/packages/model-catalog-core/src/configured-model-refs.test.ts @@ -1,3 +1,4 @@ +// Model Catalog Core tests cover configured model refs behavior. import { describe, expect, it } from "vitest"; import { collectConfiguredModelRefs, diff --git a/packages/model-catalog-core/src/configured-model-refs.ts b/packages/model-catalog-core/src/configured-model-refs.ts index 6b799ab8f32..02c55513db5 100644 --- a/packages/model-catalog-core/src/configured-model-refs.ts +++ b/packages/model-catalog-core/src/configured-model-refs.ts @@ -1,3 +1,4 @@ +// Model Catalog Core module implements configured model refs behavior. import { normalizeProviderId } from "./provider-id.js"; // Collects configured model references from OpenClaw config-shaped objects. diff --git a/packages/model-catalog-core/src/model-catalog-normalize.test.ts b/packages/model-catalog-core/src/model-catalog-normalize.test.ts index 1332714fdb6..5453695e16d 100644 --- a/packages/model-catalog-core/src/model-catalog-normalize.test.ts +++ b/packages/model-catalog-core/src/model-catalog-normalize.test.ts @@ -1,3 +1,4 @@ +// Model Catalog Core tests cover model catalog normalize behavior. import { describe, expect, it } from "vitest"; import { normalizeModelCatalog, normalizeModelCatalogRows } from "./index.js"; import { buildModelCatalogMergeKey, buildModelCatalogRef } from "./model-catalog-refs.js"; diff --git a/packages/model-catalog-core/src/model-catalog-normalize.ts b/packages/model-catalog-core/src/model-catalog-normalize.ts index 4524893aced..ea69bc8ee8b 100644 --- a/packages/model-catalog-core/src/model-catalog-normalize.ts +++ b/packages/model-catalog-core/src/model-catalog-normalize.ts @@ -1,3 +1,4 @@ +// Model Catalog Core helper module supports model catalog normalize behavior. import { buildModelCatalogMergeKey, buildModelCatalogRef, diff --git a/packages/model-catalog-core/src/model-catalog-refs.test.ts b/packages/model-catalog-core/src/model-catalog-refs.test.ts index cc8fe99927a..3ca229a1917 100644 --- a/packages/model-catalog-core/src/model-catalog-refs.test.ts +++ b/packages/model-catalog-core/src/model-catalog-refs.test.ts @@ -1,3 +1,4 @@ +// Model Catalog Core tests cover model catalog refs behavior. import { describe, expect, it } from "vitest"; import { buildModelCatalogMergeKey, buildModelCatalogRef } from "./model-catalog-refs.js"; diff --git a/packages/model-catalog-core/src/model-catalog-refs.ts b/packages/model-catalog-core/src/model-catalog-refs.ts index 0cc2b8f62e2..f4887a0d4a6 100644 --- a/packages/model-catalog-core/src/model-catalog-refs.ts +++ b/packages/model-catalog-core/src/model-catalog-refs.ts @@ -1,3 +1,4 @@ +// Model Catalog Core module implements model catalog refs behavior. import { normalizeLowercaseStringOrEmpty } from "./provider-id.js"; // Stable model catalog ref and merge-key builders. diff --git a/packages/model-catalog-core/src/provider-id.ts b/packages/model-catalog-core/src/provider-id.ts index 16a62c48f09..96b1c7357b9 100644 --- a/packages/model-catalog-core/src/provider-id.ts +++ b/packages/model-catalog-core/src/provider-id.ts @@ -1,3 +1,4 @@ +// Model Catalog Core module implements provider id behavior. export function normalizeLowercaseStringOrEmpty(value: unknown): string { return typeof value === "string" ? value.trim().toLowerCase() : ""; } diff --git a/packages/model-catalog-core/src/provider-model-id-normalization.test.ts b/packages/model-catalog-core/src/provider-model-id-normalization.test.ts index 5a8a904e716..5db78e435f6 100644 --- a/packages/model-catalog-core/src/provider-model-id-normalization.test.ts +++ b/packages/model-catalog-core/src/provider-model-id-normalization.test.ts @@ -1,3 +1,4 @@ +// Model Catalog Core tests cover provider model id normalization behavior. import { describe, expect, it } from "vitest"; import { collectManifestModelIdNormalizationPolicies, diff --git a/packages/model-catalog-core/src/provider-model-id-normalization.ts b/packages/model-catalog-core/src/provider-model-id-normalization.ts index 0e45b8c4fb6..0e436a62151 100644 --- a/packages/model-catalog-core/src/provider-model-id-normalization.ts +++ b/packages/model-catalog-core/src/provider-model-id-normalization.ts @@ -1,3 +1,4 @@ +// Model Catalog Core module implements provider model id normalization behavior. import { normalizeLowercaseStringOrEmpty } from "./provider-id.js"; import { normalizeGooglePreviewModelId, diff --git a/packages/model-catalog-core/src/provider-model-id-normalize.test.ts b/packages/model-catalog-core/src/provider-model-id-normalize.test.ts index 2f409ea2fed..f96cbac3ce8 100644 --- a/packages/model-catalog-core/src/provider-model-id-normalize.test.ts +++ b/packages/model-catalog-core/src/provider-model-id-normalize.test.ts @@ -1,3 +1,4 @@ +// Model Catalog Core tests cover provider model id normalize behavior. import { describe, expect, it } from "vitest"; import { normalizeGooglePreviewModelId } from "./provider-model-id-normalize.js"; diff --git a/packages/model-catalog-core/src/provider-model-id-normalize.ts b/packages/model-catalog-core/src/provider-model-id-normalize.ts index acc21d30ce1..3292b5f105c 100644 --- a/packages/model-catalog-core/src/provider-model-id-normalize.ts +++ b/packages/model-catalog-core/src/provider-model-id-normalize.ts @@ -1,3 +1,4 @@ +// Model Catalog Core helper module supports provider model id normalize behavior. const ANTIGRAVITY_BARE_PRO_IDS = new Set(["gemini-3-pro", "gemini-3.1-pro", "gemini-3-1-pro"]); const GOOGLE_PROVIDER_PREFIX = "google/"; diff --git a/packages/net-policy/src/ip-test-fixtures.ts b/packages/net-policy/src/ip-test-fixtures.ts index d2fa9cd5436..e8ae0f06fb4 100644 --- a/packages/net-policy/src/ip-test-fixtures.ts +++ b/packages/net-policy/src/ip-test-fixtures.ts @@ -1 +1,2 @@ +// Network Policy module implements ip test fixtures behavior. export const blockedIpv6MulticastLiterals = ["ff02::1", "ff05::1:3", "[ff02::1]"] as const; diff --git a/packages/net-policy/src/ip.test.ts b/packages/net-policy/src/ip.test.ts index 49deee39335..11f7c342375 100644 --- a/packages/net-policy/src/ip.test.ts +++ b/packages/net-policy/src/ip.test.ts @@ -1,3 +1,4 @@ +// Network Policy tests cover ip behavior. import { describe, expect, it } from "vitest"; import { blockedIpv6MulticastLiterals } from "./ip-test-fixtures.js"; import { diff --git a/packages/net-policy/src/ip.ts b/packages/net-policy/src/ip.ts index 64272be9fdf..0964b3771f6 100644 --- a/packages/net-policy/src/ip.ts +++ b/packages/net-policy/src/ip.ts @@ -1,3 +1,4 @@ +// Network Policy module implements ip behavior. import ipaddr from "ipaddr.js"; function normalizeOptionalString(value: unknown): string | undefined { diff --git a/packages/net-policy/src/ipv4.test.ts b/packages/net-policy/src/ipv4.test.ts index 165f3f48bcd..ca1f8a83e44 100644 --- a/packages/net-policy/src/ipv4.test.ts +++ b/packages/net-policy/src/ipv4.test.ts @@ -1,3 +1,4 @@ +// Network Policy tests cover ipv4 behavior. import { describe, expect, it } from "vitest"; import { validateDottedDecimalIPv4Input, validateIPv4AddressInput } from "./ipv4.js"; diff --git a/packages/net-policy/src/ipv4.ts b/packages/net-policy/src/ipv4.ts index e2a7be701c8..19408eb046b 100644 --- a/packages/net-policy/src/ipv4.ts +++ b/packages/net-policy/src/ipv4.ts @@ -1,3 +1,4 @@ +// Network Policy module implements ipv4 behavior. import { isCanonicalDottedDecimalIPv4 } from "./ip.js"; /** Validates the custom-bind IPv4 input and returns the user-facing error text. */ diff --git a/packages/net-policy/src/redact-sensitive-url.test.ts b/packages/net-policy/src/redact-sensitive-url.test.ts index a849475e208..02e9bce039d 100644 --- a/packages/net-policy/src/redact-sensitive-url.test.ts +++ b/packages/net-policy/src/redact-sensitive-url.test.ts @@ -1,3 +1,4 @@ +// Network Policy tests cover redact sensitive url behavior. import { describe, expect, it } from "vitest"; import { isSensitiveUrlQueryParamName, diff --git a/packages/net-policy/src/redact-sensitive-url.ts b/packages/net-policy/src/redact-sensitive-url.ts index 04d3748276e..76d86312aaa 100644 --- a/packages/net-policy/src/redact-sensitive-url.ts +++ b/packages/net-policy/src/redact-sensitive-url.ts @@ -1,3 +1,4 @@ +// Network Policy module implements redact sensitive url behavior. type ConfigUiHintTags = { tags?: string[]; }; diff --git a/packages/normalization-core/src/number-coercion.test.ts b/packages/normalization-core/src/number-coercion.test.ts index a2ea0ae73d2..453156ade5f 100644 --- a/packages/normalization-core/src/number-coercion.test.ts +++ b/packages/normalization-core/src/number-coercion.test.ts @@ -1,3 +1,4 @@ +// Normalization Core tests cover number coercion behavior. import { describe, expect, test } from "vitest"; import { asDateTimestampMs, diff --git a/packages/normalization-core/src/record-coerce.test.ts b/packages/normalization-core/src/record-coerce.test.ts index 166e5660b40..b3225019f7d 100644 --- a/packages/normalization-core/src/record-coerce.test.ts +++ b/packages/normalization-core/src/record-coerce.test.ts @@ -1,3 +1,4 @@ +// Normalization Core tests cover record coerce behavior. import { readFileSync } from "node:fs"; import path from "node:path"; import { describe, expect, it } from "vitest"; diff --git a/packages/normalization-core/src/string-coerce.test.ts b/packages/normalization-core/src/string-coerce.test.ts index 1f13a6581c9..5462e47a168 100644 --- a/packages/normalization-core/src/string-coerce.test.ts +++ b/packages/normalization-core/src/string-coerce.test.ts @@ -1,3 +1,4 @@ +// Normalization Core tests cover string coerce behavior. import { describe, expect, it } from "vitest"; import { normalizeStringifiedEntries } from "./string-coerce.js"; diff --git a/packages/normalization-core/src/string-normalization.test.ts b/packages/normalization-core/src/string-normalization.test.ts index f1aa05c8b14..0228ff635d8 100644 --- a/packages/normalization-core/src/string-normalization.test.ts +++ b/packages/normalization-core/src/string-normalization.test.ts @@ -1,3 +1,4 @@ +// Normalization Core tests cover string normalization behavior. import { describe, expect, it } from "vitest"; import { normalizeAtHashSlug, diff --git a/packages/normalization-core/src/string-normalization.ts b/packages/normalization-core/src/string-normalization.ts index b6fce15fac7..d193ea05057 100644 --- a/packages/normalization-core/src/string-normalization.ts +++ b/packages/normalization-core/src/string-normalization.ts @@ -1,3 +1,4 @@ +// Normalization Core module implements string normalization behavior. import { normalizeOptionalLowercaseString, normalizeOptionalString } from "./string-coerce.js"; /** Coerces entries to strings, trims them, and drops empty results. */ diff --git a/packages/plugin-package-contract/src/index.test.ts b/packages/plugin-package-contract/src/index.test.ts index 6d8314ce4c2..800f8a9d7eb 100644 --- a/packages/plugin-package-contract/src/index.test.ts +++ b/packages/plugin-package-contract/src/index.test.ts @@ -1,3 +1,4 @@ +// Plugin Package Contract tests cover index behavior. import { describe, expect, it } from "vitest"; import { EXTERNAL_CODE_PLUGIN_REQUIRED_FIELD_PATHS, diff --git a/packages/plugin-sdk/src/testing.ts b/packages/plugin-sdk/src/testing.ts index d6206c242e4..0271f065722 100644 --- a/packages/plugin-sdk/src/testing.ts +++ b/packages/plugin-sdk/src/testing.ts @@ -1 +1,2 @@ +// Plugin SDK module implements testing behavior. export * from "../../../src/plugin-sdk/testing.js"; diff --git a/packages/sdk/src/client.ts b/packages/sdk/src/client.ts index c6658df7e62..efcbb106d00 100644 --- a/packages/sdk/src/client.ts +++ b/packages/sdk/src/client.ts @@ -1,3 +1,4 @@ +// OpenClaw SDK module implements client behavior. import { randomUUID } from "node:crypto"; import { EventHub } from "./event-hub.js"; import { normalizeGatewayEvent } from "./normalize.js"; diff --git a/packages/sdk/src/event-hub.ts b/packages/sdk/src/event-hub.ts index d6070fb987c..6f2422c7bdd 100644 --- a/packages/sdk/src/event-hub.ts +++ b/packages/sdk/src/event-hub.ts @@ -1,3 +1,4 @@ +// OpenClaw SDK module implements event hub behavior. import type { GatewayEvent } from "./types.js"; // Async event hub with bounded replay for SDK event streams. diff --git a/packages/sdk/src/index.e2e.test.ts b/packages/sdk/src/index.e2e.test.ts index 2e2ac56aef3..84b35e82c4f 100644 --- a/packages/sdk/src/index.e2e.test.ts +++ b/packages/sdk/src/index.e2e.test.ts @@ -1,3 +1,4 @@ +// OpenClaw SDK tests cover index behavior. import type { AddressInfo } from "node:net"; import net from "node:net"; import { afterEach, describe, expect, it } from "vitest"; diff --git a/packages/sdk/src/index.test.ts b/packages/sdk/src/index.test.ts index d137f691d6b..02f05387fb7 100644 --- a/packages/sdk/src/index.test.ts +++ b/packages/sdk/src/index.test.ts @@ -1,3 +1,4 @@ +// OpenClaw SDK tests cover index behavior. import { describe, expect, it } from "vitest"; import { EventHub, OpenClaw, normalizeGatewayEvent } from "./index.js"; import type { diff --git a/packages/sdk/src/normalize.ts b/packages/sdk/src/normalize.ts index 21fa36c62c8..debb8cd48ed 100644 --- a/packages/sdk/src/normalize.ts +++ b/packages/sdk/src/normalize.ts @@ -1,3 +1,4 @@ +// OpenClaw SDK helper module supports normalize behavior. import type { GatewayEvent, JsonObject, OpenClawEvent, OpenClawEventType } from "./types.js"; // Normalize raw Gateway events into stable SDK event types and common metadata. diff --git a/packages/sdk/src/package.e2e.test.ts b/packages/sdk/src/package.e2e.test.ts index d1939465a65..a8c5534816f 100644 --- a/packages/sdk/src/package.e2e.test.ts +++ b/packages/sdk/src/package.e2e.test.ts @@ -1,3 +1,4 @@ +// OpenClaw SDK tests cover package behavior. import { spawn } from "node:child_process"; import { createReadStream } from "node:fs"; import fs from "node:fs/promises"; @@ -108,7 +109,10 @@ function tarballFileName(manifest: PackageManifest): string { return `${manifest.name.replace(/^@/, "").replace("/", "-")}-${manifest.version}.tgz`; } -async function createPackStagingRoot(packageRoot: string, destinationRoot: string): Promise { +async function createPackStagingRoot( + packageRoot: string, + destinationRoot: string, +): Promise { const manifest = await readPackageManifest(packageRoot); const packageSlug = manifest.name.replace(/^@/, "").replace("/", "-"); const stagingRoot = path.join(destinationRoot, `pack-${packageSlug}`); diff --git a/packages/sdk/src/transport.ts b/packages/sdk/src/transport.ts index 660ae2823cf..858989410f8 100644 --- a/packages/sdk/src/transport.ts +++ b/packages/sdk/src/transport.ts @@ -1,3 +1,4 @@ +// OpenClaw SDK module implements transport behavior. import { GatewayClient } from "@openclaw/gateway-client"; import { EventHub } from "./event-hub.js"; import type { diff --git a/packages/speech-core/src/tts.test.ts b/packages/speech-core/src/tts.test.ts index c2df50cd227..fb286f231d0 100644 --- a/packages/speech-core/src/tts.test.ts +++ b/packages/speech-core/src/tts.test.ts @@ -1,3 +1,4 @@ +// Speech Core tests cover tts behavior. import { rmSync } from "node:fs"; import path from "node:path"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; diff --git a/packages/speech-core/src/tts.ts b/packages/speech-core/src/tts.ts index 1d391024b4a..c69ca39aef0 100644 --- a/packages/speech-core/src/tts.ts +++ b/packages/speech-core/src/tts.ts @@ -1,3 +1,4 @@ +// Speech Core module implements tts behavior. import { existsSync, readFileSync } from "node:fs"; import path from "node:path"; import { resolveChannelTtsVoiceDelivery } from "openclaw/plugin-sdk/channel-targets"; diff --git a/packages/terminal-core/src/ansi.test.ts b/packages/terminal-core/src/ansi.test.ts index 832313ba940..2b5f86a03b3 100644 --- a/packages/terminal-core/src/ansi.test.ts +++ b/packages/terminal-core/src/ansi.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover ansi behavior. import { describe, expect, it } from "vitest"; import { sanitizeForLog, diff --git a/packages/terminal-core/src/decorative-emoji.test.ts b/packages/terminal-core/src/decorative-emoji.test.ts index cd2cf7a0eca..c6b67d1d1d7 100644 --- a/packages/terminal-core/src/decorative-emoji.test.ts +++ b/packages/terminal-core/src/decorative-emoji.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover decorative emoji behavior. import { describe, expect, it } from "vitest"; import { decorativeEmoji, diff --git a/packages/terminal-core/src/decorative-emoji.ts b/packages/terminal-core/src/decorative-emoji.ts index 9dc29bf826b..a7fc85277a1 100644 --- a/packages/terminal-core/src/decorative-emoji.ts +++ b/packages/terminal-core/src/decorative-emoji.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements decorative emoji behavior. import { splitGraphemes } from "./ansi.js"; // Decorative emoji helpers that degrade cleanly on terminals without reliable emoji support. diff --git a/packages/terminal-core/src/display-string.ts b/packages/terminal-core/src/display-string.ts index 7761470665a..f5e1a507537 100644 --- a/packages/terminal-core/src/display-string.ts +++ b/packages/terminal-core/src/display-string.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements display string behavior. import os from "node:os"; import path from "node:path"; diff --git a/packages/terminal-core/src/health-style.ts b/packages/terminal-core/src/health-style.ts index f710cc443e3..fd85ff10a2b 100644 --- a/packages/terminal-core/src/health-style.ts +++ b/packages/terminal-core/src/health-style.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements health style behavior. import { normalizeLowercaseStringOrEmpty } from "./string.js"; import { theme } from "./theme.js"; diff --git a/packages/terminal-core/src/links.test.ts b/packages/terminal-core/src/links.test.ts index 4205d17d612..0f005c5f4b1 100644 --- a/packages/terminal-core/src/links.test.ts +++ b/packages/terminal-core/src/links.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover links behavior. import { describe, expect, it } from "vitest"; import { formatDocsLink } from "./links.js"; diff --git a/packages/terminal-core/src/links.ts b/packages/terminal-core/src/links.ts index 98787f4f497..f839a61c9b2 100644 --- a/packages/terminal-core/src/links.ts +++ b/packages/terminal-core/src/links.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements links behavior. import { formatTerminalLink } from "./terminal-link.js"; function resolveDocsRoot(): string { diff --git a/packages/terminal-core/src/note.ts b/packages/terminal-core/src/note.ts index 18ab330dd7a..9e679456364 100644 --- a/packages/terminal-core/src/note.ts +++ b/packages/terminal-core/src/note.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements note behavior. import { AsyncLocalStorage } from "node:async_hooks"; import { note as clackNote } from "@clack/prompts"; import { visibleWidth } from "./ansi.js"; diff --git a/packages/terminal-core/src/osc-progress.test.ts b/packages/terminal-core/src/osc-progress.test.ts index 537e75e369f..53c372088b9 100644 --- a/packages/terminal-core/src/osc-progress.test.ts +++ b/packages/terminal-core/src/osc-progress.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover osc progress behavior. import { describe, expect, it } from "vitest"; import { createOscProgressController, supportsOscProgress } from "./osc-progress.js"; diff --git a/packages/terminal-core/src/prompt-select-styled-params.ts b/packages/terminal-core/src/prompt-select-styled-params.ts index 17b8733a817..d02b1570f91 100644 --- a/packages/terminal-core/src/prompt-select-styled-params.ts +++ b/packages/terminal-core/src/prompt-select-styled-params.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements prompt select styled params behavior. import { stylePromptHint, stylePromptMessage } from "./prompt-style.js"; // Pure prompt parameter styler used by interactive prompts and tests. diff --git a/packages/terminal-core/src/prompt-select-styled.test.ts b/packages/terminal-core/src/prompt-select-styled.test.ts index c89d0e43fa2..450d1bca248 100644 --- a/packages/terminal-core/src/prompt-select-styled.test.ts +++ b/packages/terminal-core/src/prompt-select-styled.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover prompt select styled behavior. import { describe, expect, it } from "vitest"; import { styleSelectParams } from "./prompt-select-styled-params.js"; diff --git a/packages/terminal-core/src/prompt-select-styled.ts b/packages/terminal-core/src/prompt-select-styled.ts index 0bdca8d1cf3..1355306ba94 100644 --- a/packages/terminal-core/src/prompt-select-styled.ts +++ b/packages/terminal-core/src/prompt-select-styled.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements prompt select styled behavior. import { select } from "@clack/prompts"; import { styleSelectParams } from "./prompt-select-styled-params.js"; diff --git a/packages/terminal-core/src/prompt-style.ts b/packages/terminal-core/src/prompt-style.ts index ae82570030e..af138c7d609 100644 --- a/packages/terminal-core/src/prompt-style.ts +++ b/packages/terminal-core/src/prompt-style.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements prompt style behavior. import { isRich, theme } from "./theme.js"; // Shared styling helpers for interactive prompt copy. diff --git a/packages/terminal-core/src/restore.test.ts b/packages/terminal-core/src/restore.test.ts index 2d6361f240e..c6e91b77264 100644 --- a/packages/terminal-core/src/restore.test.ts +++ b/packages/terminal-core/src/restore.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover restore behavior. import { afterEach, describe, expect, it, vi } from "vitest"; const clearActiveProgressLine = vi.hoisted(() => vi.fn()); diff --git a/packages/terminal-core/src/restore.ts b/packages/terminal-core/src/restore.ts index bc18af6148a..98bd13c0f38 100644 --- a/packages/terminal-core/src/restore.ts +++ b/packages/terminal-core/src/restore.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements restore behavior. import { clearActiveProgressLine } from "./progress-line.js"; const RESET_SEQUENCE = diff --git a/packages/terminal-core/src/safe-text.test.ts b/packages/terminal-core/src/safe-text.test.ts index 76c777a5c42..f1e9fcd48e9 100644 --- a/packages/terminal-core/src/safe-text.test.ts +++ b/packages/terminal-core/src/safe-text.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover safe text behavior. import { describe, expect, it } from "vitest"; import { sanitizeTerminalText } from "./safe-text.js"; diff --git a/packages/terminal-core/src/safe-text.ts b/packages/terminal-core/src/safe-text.ts index f6754da5aef..9a1ab6d2c8e 100644 --- a/packages/terminal-core/src/safe-text.ts +++ b/packages/terminal-core/src/safe-text.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements safe text behavior. import { stripAnsi } from "./ansi.js"; /** diff --git a/packages/terminal-core/src/stream-writer.test.ts b/packages/terminal-core/src/stream-writer.test.ts index ab2744e8078..bd543db7815 100644 --- a/packages/terminal-core/src/stream-writer.test.ts +++ b/packages/terminal-core/src/stream-writer.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover stream writer behavior. import { describe, expect, it } from "vitest"; import { createSafeStreamWriter } from "./stream-writer.js"; diff --git a/packages/terminal-core/src/table.test.ts b/packages/terminal-core/src/table.test.ts index 59caaa688ae..cab80bfff02 100644 --- a/packages/terminal-core/src/table.test.ts +++ b/packages/terminal-core/src/table.test.ts @@ -1,3 +1,4 @@ +// Terminal Core tests cover table behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { visibleWidth } from "./ansi.js"; import { resolveNoteColumns, wrapNoteMessage } from "./note.js"; diff --git a/packages/terminal-core/src/table.ts b/packages/terminal-core/src/table.ts index d52dac30331..c6c22e09de4 100644 --- a/packages/terminal-core/src/table.ts +++ b/packages/terminal-core/src/table.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements table behavior. import { splitGraphemes, truncateToVisibleWidth, visibleWidth } from "./ansi.js"; import { displayString } from "./display-string.js"; diff --git a/packages/terminal-core/src/theme.ts b/packages/terminal-core/src/theme.ts index 7b18f43a948..2e8e8c3a08e 100644 --- a/packages/terminal-core/src/theme.ts +++ b/packages/terminal-core/src/theme.ts @@ -1,3 +1,4 @@ +// Terminal Core module implements theme behavior. import chalk, { Chalk } from "chalk"; import { LOBSTER_PALETTE } from "./palette.js"; diff --git a/packages/tool-call-repair/src/payload.ts b/packages/tool-call-repair/src/payload.ts index 8378fe22c90..64528d4c4ff 100644 --- a/packages/tool-call-repair/src/payload.ts +++ b/packages/tool-call-repair/src/payload.ts @@ -1,3 +1,4 @@ +// Tool Call Repair module implements payload behavior. import { consumeLineBreak, END_TOOL_REQUEST, diff --git a/packages/tool-call-repair/src/promote.ts b/packages/tool-call-repair/src/promote.ts index 3282dac8a10..9290d7d29d9 100644 --- a/packages/tool-call-repair/src/promote.ts +++ b/packages/tool-call-repair/src/promote.ts @@ -1,3 +1,4 @@ +// Tool Call Repair module implements promote behavior. import { parseStandalonePlainTextToolCallBlocks, type PlainTextToolCallBlock } from "./payload.js"; /** Resolves model-emitted tool names to the exact names allowed by the provider request. */ diff --git a/packages/tool-call-repair/src/stream-normalizer.ts b/packages/tool-call-repair/src/stream-normalizer.ts index e7b77a41907..e1052823b70 100644 --- a/packages/tool-call-repair/src/stream-normalizer.ts +++ b/packages/tool-call-repair/src/stream-normalizer.ts @@ -1,3 +1,4 @@ +// Tool Call Repair helper module supports stream normalizer behavior. import { consumeJsonToolClosingMarker, END_TOOL_REQUEST, diff --git a/packages/web-content-core/src/index.ts b/packages/web-content-core/src/index.ts index f684a359c77..047068384c5 100644 --- a/packages/web-content-core/src/index.ts +++ b/packages/web-content-core/src/index.ts @@ -1 +1,2 @@ +// Web Content Core public barrel exports the package API surface. export * from "./provider-runtime-shared.js"; diff --git a/packages/web-content-core/src/provider-runtime-shared.test.ts b/packages/web-content-core/src/provider-runtime-shared.test.ts index dd3461377e4..b10ddd08ccf 100644 --- a/packages/web-content-core/src/provider-runtime-shared.test.ts +++ b/packages/web-content-core/src/provider-runtime-shared.test.ts @@ -1,3 +1,4 @@ +// Web Content Core tests cover provider runtime shared behavior. import { describe, expect, it } from "vitest"; import { hasWebProviderEntryCredential, diff --git a/packages/web-content-core/src/provider-runtime-shared.ts b/packages/web-content-core/src/provider-runtime-shared.ts index 984c0a21a14..723d1d2d8a7 100644 --- a/packages/web-content-core/src/provider-runtime-shared.ts +++ b/packages/web-content-core/src/provider-runtime-shared.ts @@ -1,3 +1,4 @@ +// Web Content Core module implements provider runtime shared behavior. export type WebProviderConfigSource = { tools?: { web?: {