From 4df95d3c3fd614463307b12e7152f7862e786b30 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Thu, 4 Jun 2026 20:54:41 -0400 Subject: [PATCH] docs: document package sources --- packages/acp-core/src/error-format.ts | 1 + packages/acp-core/src/meta.test.ts | 1 + packages/acp-core/src/meta.ts | 1 + packages/acp-core/src/numeric-options.ts | 1 + packages/acp-core/src/runtime/error-text.test.ts | 1 + packages/acp-core/src/runtime/error-text.ts | 1 + packages/acp-core/src/runtime/errors.test.ts | 1 + packages/acp-core/src/runtime/errors.ts | 1 + packages/acp-core/src/runtime/session-identifiers.test.ts | 1 + packages/acp-core/src/runtime/session-identifiers.ts | 1 + packages/acp-core/src/runtime/session-identity.ts | 1 + packages/acp-core/src/runtime/types.ts | 1 + packages/acp-core/src/session-interaction-mode.test.ts | 1 + packages/acp-core/src/session-interaction-mode.ts | 1 + packages/acp-core/src/session-lineage-meta.test.ts | 1 + packages/acp-core/src/session-lineage-meta.ts | 1 + packages/acp-core/src/session.test.ts | 1 + packages/acp-core/src/session.ts | 1 + packages/acp-core/src/types.ts | 1 + packages/agent-core/src/agent-loop.test.ts | 1 + packages/agent-core/src/agent.ts | 1 + packages/agent-core/src/harness/agent-harness.ts | 1 + .../src/harness/compaction/branch-summarization.ts | 1 + packages/agent-core/src/harness/compaction/compaction.ts | 1 + packages/agent-core/src/harness/compaction/utils.ts | 1 + packages/agent-core/src/harness/env/kill-tree.ts | 1 + packages/agent-core/src/harness/env/nodejs.test.ts | 1 + packages/agent-core/src/harness/env/nodejs.ts | 1 + packages/agent-core/src/harness/file-loader-utils.ts | 1 + packages/agent-core/src/harness/messages.test.ts | 1 + packages/agent-core/src/harness/messages.ts | 1 + packages/agent-core/src/harness/prompt-templates.test.ts | 1 + packages/agent-core/src/harness/prompt-templates.ts | 1 + packages/agent-core/src/harness/session/jsonl-repo.ts | 1 + .../agent-core/src/harness/session/jsonl-storage.test.ts | 1 + packages/agent-core/src/harness/session/jsonl-storage.ts | 1 + packages/agent-core/src/harness/session/memory-repo.ts | 1 + .../agent-core/src/harness/session/memory-storage.test.ts | 1 + packages/agent-core/src/harness/session/memory-storage.ts | 1 + packages/agent-core/src/harness/session/repo-utils.ts | 1 + packages/agent-core/src/harness/session/session.ts | 1 + packages/agent-core/src/harness/session/storage-base.ts | 1 + packages/agent-core/src/harness/session/uuid.ts | 1 + packages/agent-core/src/harness/skills.ts | 1 + packages/agent-core/src/harness/system-prompt.ts | 1 + packages/agent-core/src/harness/types.ts | 1 + packages/agent-core/src/harness/utils/shell-output.ts | 1 + packages/agent-core/src/harness/utils/truncate.test.ts | 1 + packages/agent-core/src/harness/utils/truncate.ts | 1 + packages/agent-core/src/runtime-deps.ts | 1 + packages/agent-core/src/types.ts | 1 + packages/gateway-client/src/client.ts | 1 + packages/gateway-client/src/client.watchdog.test.ts | 1 + packages/gateway-client/src/device-auth.ts | 1 + packages/gateway-client/src/event-loop-ready.test.ts | 1 + packages/gateway-client/src/event-loop-ready.ts | 1 + packages/gateway-client/src/readiness.ts | 1 + packages/gateway-client/src/timeouts.test.ts | 1 + packages/gateway-client/src/timeouts.ts | 1 + packages/gateway-protocol/src/channels.schema.test.ts | 1 + packages/gateway-protocol/src/connect-error-details.test.ts | 1 + packages/gateway-protocol/src/cron-validators.test.ts | 1 + .../gateway-protocol/src/exec-approvals-validators.test.ts | 1 + packages/gateway-protocol/src/index.test.ts | 1 + .../src/native-protocol-levels.guard.test.ts | 1 + packages/gateway-protocol/src/primitives.secretref.test.ts | 1 + packages/gateway-protocol/src/push.test.ts | 1 + packages/gateway-protocol/src/schema/agent.test.ts | 1 + packages/gateway-protocol/src/schema/agent.ts | 1 + .../src/schema/agents-models-skills.test.ts | 1 + .../gateway-protocol/src/schema/agents-models-skills.ts | 1 + packages/gateway-protocol/src/schema/artifacts.ts | 1 + packages/gateway-protocol/src/schema/channels.ts | 1 + packages/gateway-protocol/src/schema/commands.ts | 1 + packages/gateway-protocol/src/schema/config.ts | 1 + packages/gateway-protocol/src/schema/cron.ts | 1 + packages/gateway-protocol/src/schema/devices.ts | 1 + packages/gateway-protocol/src/schema/environments.ts | 1 + packages/gateway-protocol/src/schema/error-codes.ts | 1 + packages/gateway-protocol/src/schema/exec-approvals.ts | 1 + packages/gateway-protocol/src/schema/frames.ts | 1 + packages/gateway-protocol/src/schema/logs-chat.ts | 1 + packages/gateway-protocol/src/schema/nodes.ts | 1 + packages/gateway-protocol/src/schema/plugin-approvals.ts | 1 + packages/gateway-protocol/src/schema/plugins.ts | 1 + packages/gateway-protocol/src/schema/primitives.ts | 1 + packages/gateway-protocol/src/schema/push.ts | 1 + packages/gateway-protocol/src/schema/secrets.ts | 1 + packages/gateway-protocol/src/schema/sessions.ts | 1 + packages/gateway-protocol/src/schema/snapshot.ts | 1 + packages/gateway-protocol/src/schema/tasks.ts | 1 + packages/gateway-protocol/src/schema/wizard.ts | 1 + packages/gateway-protocol/src/talk-config.contract.test.ts | 1 + packages/llm-core/src/types.ts | 1 + packages/llm-core/src/utils/diagnostics.ts | 1 + packages/llm-core/src/utils/event-stream.ts | 1 + packages/llm-core/src/validation.test.ts | 1 + packages/llm-core/src/validation.ts | 1 + packages/llm-runtime/src/api-registry.test.ts | 1 + packages/llm-runtime/src/api-registry.ts | 1 + packages/llm-runtime/src/stream.ts | 1 + packages/markdown-core/src/chunk-text.ts | 1 + packages/markdown-core/src/code-spans.ts | 1 + packages/markdown-core/src/frontmatter.test.ts | 1 + packages/markdown-core/src/frontmatter.ts | 1 + packages/markdown-core/src/ir.chunking.test.ts | 1 + packages/markdown-core/src/ir.hr-spacing.test.ts | 1 + packages/markdown-core/src/ir.table-block.test.ts | 1 + packages/markdown-core/src/ir.table-bullets.test.ts | 1 + packages/markdown-core/src/ir.table-code.test.ts | 1 + packages/markdown-core/src/ir.ts | 1 + packages/markdown-core/src/render-aware-chunking.test.ts | 1 + packages/markdown-core/src/render-aware-chunking.ts | 1 + packages/markdown-core/src/render.ts | 1 + packages/markdown-core/src/tables.test.ts | 1 + packages/markdown-core/src/tables.ts | 1 + packages/media-core/src/base64.test.ts | 1 + packages/media-core/src/file-name.ts | 1 + packages/media-core/src/inbound-path-policy.test.ts | 1 + packages/media-core/src/inbound-path-policy.ts | 1 + packages/media-core/src/inline-image-data-url.test.ts | 1 + packages/media-core/src/inline-image-data-url.ts | 1 + packages/media-core/src/media-source-url.ts | 1 + packages/media-core/src/mime.test.ts | 1 + packages/media-core/src/mime.ts | 1 + packages/media-core/src/read-byte-stream-with-limit.test.ts | 1 + packages/media-core/src/read-response-with-limit.test.ts | 1 + packages/media-core/src/read-response-with-limit.ts | 1 + packages/media-generation-core/src/capability-model-ref.ts | 1 + packages/media-generation-core/src/catalog.test.ts | 1 + packages/media-generation-core/src/catalog.ts | 1 + packages/media-generation-core/src/model-ref.test.ts | 1 + packages/media-generation-core/src/model-ref.ts | 1 + packages/media-understanding-common/src/defaults.ts | 1 + packages/media-understanding-common/src/format.test.ts | 1 + packages/media-understanding-common/src/format.ts | 1 + .../media-understanding-common/src/provider-supports.ts | 1 + packages/media-understanding-common/src/video.ts | 1 + packages/memory-host-sdk/src/host/backend-config.test.ts | 1 + packages/memory-host-sdk/src/host/backend-config.ts | 1 + packages/memory-host-sdk/src/host/batch-error-utils.test.ts | 1 + packages/memory-host-sdk/src/host/batch-error-utils.ts | 1 + packages/memory-host-sdk/src/host/batch-http.test.ts | 1 + packages/memory-host-sdk/src/host/batch-http.ts | 1 + packages/memory-host-sdk/src/host/batch-output.test.ts | 1 + packages/memory-host-sdk/src/host/batch-provider-common.ts | 1 + packages/memory-host-sdk/src/host/batch-runner.test.ts | 1 + packages/memory-host-sdk/src/host/batch-runner.ts | 1 + packages/memory-host-sdk/src/host/batch-status.test.ts | 1 + packages/memory-host-sdk/src/host/batch-upload.test.ts | 1 + packages/memory-host-sdk/src/host/batch-upload.ts | 1 + packages/memory-host-sdk/src/host/batch-utils.ts | 1 + packages/memory-host-sdk/src/host/config-utils.test.ts | 1 + packages/memory-host-sdk/src/host/config-utils.ts | 1 + .../memory-host-sdk/src/host/embedding-chunk-limits.test.ts | 1 + packages/memory-host-sdk/src/host/embedding-chunk-limits.ts | 1 + packages/memory-host-sdk/src/host/embedding-input-limits.ts | 1 + packages/memory-host-sdk/src/host/embedding-model-limits.ts | 1 + .../src/host/embedding-provider-adapter-utils.ts | 1 + packages/memory-host-sdk/src/host/embeddings-debug.ts | 1 + .../src/host/embeddings-model-normalize.test.ts | 1 + .../src/host/embeddings-remote-client.test.ts | 1 + .../memory-host-sdk/src/host/embeddings-remote-client.ts | 1 + .../src/host/embeddings-remote-fetch.test.ts | 1 + .../memory-host-sdk/src/host/embeddings-remote-fetch.ts | 1 + .../memory-host-sdk/src/host/embeddings-remote-provider.ts | 1 + .../memory-host-sdk/src/host/embeddings-worker-child.ts | 1 + packages/memory-host-sdk/src/host/embeddings-worker.ts | 1 + packages/memory-host-sdk/src/host/embeddings.test.ts | 1 + packages/memory-host-sdk/src/host/embeddings.ts | 1 + packages/memory-host-sdk/src/host/embeddings.types.ts | 1 + packages/memory-host-sdk/src/host/error-utils.ts | 1 + packages/memory-host-sdk/src/host/fs-utils.ts | 1 + packages/memory-host-sdk/src/host/hash.ts | 1 + packages/memory-host-sdk/src/host/internal.test.ts | 1 + packages/memory-host-sdk/src/host/internal.ts | 1 + packages/memory-host-sdk/src/host/memory-schema.ts | 1 + packages/memory-host-sdk/src/host/multimodal.ts | 1 + packages/memory-host-sdk/src/host/openclaw-runtime-auth.ts | 1 + packages/memory-host-sdk/src/host/post-json.test.ts | 1 + packages/memory-host-sdk/src/host/post-json.ts | 1 + packages/memory-host-sdk/src/host/qmd-process.test.ts | 1 + packages/memory-host-sdk/src/host/qmd-process.ts | 1 + packages/memory-host-sdk/src/host/qmd-query-parser.test.ts | 1 + packages/memory-host-sdk/src/host/qmd-query-parser.ts | 1 + packages/memory-host-sdk/src/host/qmd-scope.test.ts | 1 + packages/memory-host-sdk/src/host/qmd-scope.ts | 1 + packages/memory-host-sdk/src/host/query-expansion.test.ts | 1 + packages/memory-host-sdk/src/host/query-expansion.ts | 1 + packages/memory-host-sdk/src/host/read-file-shared.test.ts | 1 + packages/memory-host-sdk/src/host/read-file-shared.ts | 1 + packages/memory-host-sdk/src/host/read-file.test.ts | 1 + packages/memory-host-sdk/src/host/read-file.ts | 1 + packages/memory-host-sdk/src/host/read-retry.test.ts | 1 + packages/memory-host-sdk/src/host/read-retry.ts | 1 + packages/memory-host-sdk/src/host/remote-http.test.ts | 1 + packages/memory-host-sdk/src/host/remote-http.ts | 1 + packages/memory-host-sdk/src/host/response-snippet.test.ts | 1 + packages/memory-host-sdk/src/host/response-snippet.ts | 1 + packages/memory-host-sdk/src/host/retry-utils.test.ts | 1 + packages/memory-host-sdk/src/host/retry-utils.ts | 1 + packages/memory-host-sdk/src/host/secret-input.ts | 1 + .../memory-host-sdk/src/host/session-files-yield.test.ts | 1 + packages/memory-host-sdk/src/host/session-files.test.ts | 1 + packages/memory-host-sdk/src/host/session-files.ts | 1 + .../memory-host-sdk/src/host/sqlite-vec-platform-variant.ts | 1 + packages/memory-host-sdk/src/host/sqlite-vec.test.ts | 1 + packages/memory-host-sdk/src/host/sqlite-vec.ts | 1 + packages/memory-host-sdk/src/host/sqlite.ts | 1 + .../model-catalog-core/src/configured-model-refs.test.ts | 1 + packages/model-catalog-core/src/configured-model-refs.ts | 1 + .../model-catalog-core/src/model-catalog-normalize.test.ts | 1 + packages/model-catalog-core/src/model-catalog-normalize.ts | 1 + packages/model-catalog-core/src/model-catalog-refs.test.ts | 1 + packages/model-catalog-core/src/model-catalog-refs.ts | 1 + packages/model-catalog-core/src/provider-id.ts | 1 + .../src/provider-model-id-normalization.test.ts | 1 + .../src/provider-model-id-normalization.ts | 1 + .../src/provider-model-id-normalize.test.ts | 1 + .../model-catalog-core/src/provider-model-id-normalize.ts | 1 + packages/net-policy/src/ip-test-fixtures.ts | 1 + packages/net-policy/src/ip.test.ts | 1 + packages/net-policy/src/ip.ts | 1 + packages/net-policy/src/ipv4.test.ts | 1 + packages/net-policy/src/ipv4.ts | 1 + packages/net-policy/src/redact-sensitive-url.test.ts | 1 + packages/net-policy/src/redact-sensitive-url.ts | 1 + packages/normalization-core/src/number-coercion.test.ts | 1 + packages/normalization-core/src/record-coerce.test.ts | 1 + packages/normalization-core/src/string-coerce.test.ts | 1 + .../normalization-core/src/string-normalization.test.ts | 1 + packages/normalization-core/src/string-normalization.ts | 1 + packages/plugin-package-contract/src/index.test.ts | 1 + packages/plugin-sdk/src/testing.ts | 1 + packages/sdk/src/client.ts | 1 + packages/sdk/src/event-hub.ts | 1 + packages/sdk/src/index.e2e.test.ts | 1 + packages/sdk/src/index.test.ts | 1 + packages/sdk/src/normalize.ts | 1 + packages/sdk/src/package.e2e.test.ts | 6 +++++- packages/sdk/src/transport.ts | 1 + packages/speech-core/src/tts.test.ts | 1 + packages/speech-core/src/tts.ts | 1 + packages/terminal-core/src/ansi.test.ts | 1 + packages/terminal-core/src/decorative-emoji.test.ts | 1 + packages/terminal-core/src/decorative-emoji.ts | 1 + packages/terminal-core/src/display-string.ts | 1 + packages/terminal-core/src/health-style.ts | 1 + packages/terminal-core/src/links.test.ts | 1 + packages/terminal-core/src/links.ts | 1 + packages/terminal-core/src/note.ts | 1 + packages/terminal-core/src/osc-progress.test.ts | 1 + packages/terminal-core/src/prompt-select-styled-params.ts | 1 + packages/terminal-core/src/prompt-select-styled.test.ts | 1 + packages/terminal-core/src/prompt-select-styled.ts | 1 + packages/terminal-core/src/prompt-style.ts | 1 + packages/terminal-core/src/restore.test.ts | 1 + packages/terminal-core/src/restore.ts | 1 + packages/terminal-core/src/safe-text.test.ts | 1 + packages/terminal-core/src/safe-text.ts | 1 + packages/terminal-core/src/stream-writer.test.ts | 1 + packages/terminal-core/src/table.test.ts | 1 + packages/terminal-core/src/table.ts | 1 + packages/terminal-core/src/theme.ts | 1 + packages/tool-call-repair/src/payload.ts | 1 + packages/tool-call-repair/src/promote.ts | 1 + packages/tool-call-repair/src/stream-normalizer.ts | 1 + packages/web-content-core/src/index.ts | 1 + .../web-content-core/src/provider-runtime-shared.test.ts | 1 + packages/web-content-core/src/provider-runtime-shared.ts | 1 + 270 files changed, 274 insertions(+), 1 deletion(-) diff --git a/packages/acp-core/src/error-format.ts b/packages/acp-core/src/error-format.ts index f3b30150d717..172bf38e32e6 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 7e8e522fed0c..2cd4b057dc36 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 3eb42ccea6d5..b295ce7f0e1b 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 71e689bc22f2..53a49c16ee31 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 80d3eea39e50..20e39d2cff20 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 38ee84a13ea5..617fbc41a9c6 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 70cceb44fcaa..2846c15f7c52 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 a4fbe241f03a..ef99704076bc 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 88198ba03bf1..b18bf42784ee 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 953e646e097a..a7bb7625ceb7 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 f6b00bbae747..eb0633dbdd7d 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 3f6a6ff9d84a..3f24c2e2c343 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 5b77ee8079fc..0bf5784286b9 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 9e84a8fb950b..741c2712a6c1 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 b290d4c94d58..a441929f6332 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 1915cc2f5eef..82ca278f850b 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 30a55b45fd27..5dbf0d474d54 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 c0f65e1d4a3a..bb2313e2895a 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 92b05f9da908..971c0fbdc396 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 40cde4d624ca..0677fcd7bcc2 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 522df048ceaf..57fa069ee73e 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 0d3b173a639f..a42f035000eb 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 ea71aabc1476..e9a9443ec332 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 32f9c7c84c72..c497fe0eeb7f 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 56302df5c70d..7d1632b9d4c2 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 1d3728623916..4ea5f2e5deb0 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 919f1615de54..6bc90cf902f9 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 26013e4985a4..e50093b9a37a 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 668f35128dfb..cf29689918f8 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 74c22746b365..e42542399f24 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 dfc2ed70490f..eaf4adefbcd8 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 6532e059b15d..b12023004558 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 e8a7f35d5b2a..422e4d6bcc72 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 87bc3506ac15..36515365fd2c 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 8d3ec7846db1..75ef8996885a 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 5c426486a120..91df4ce025f5 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 8cb5994090a2..082bb45f6b10 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 764956ec1c36..5fd4a33da56d 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 bf3555d9e461..f8bfc32084f9 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 1aebf12be5cf..43d838ad93dc 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 02afb0bc82f8..44ac9e0c3dda 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 66092d121724..7a5936fedf33 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 b998a8eeadac..45203e69c445 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 fc945e8c28d0..1c8a0bb14e89 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 7030e51fc308..1b1cc08cc25c 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 25567db090f6..f74ecc3cc853 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 e8843911d3a2..58079aebc152 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 5425de01602b..a4b719b72fe6 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 88fb3cdbdaf9..f92fb63785e9 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 01ce11317759..d30b93afbc8d 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 7baf77299d19..ba6e8eace365 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 4d81d8a47504..c25cc0b5f71f 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 4ce20ca594c9..884539a5bddb 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 10cbdd4ef96d..d3ed6dda2e46 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 4081cac63b46..1d9f10a38c31 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 10c2c87f42e1..257feebc02da 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 3ace314671d3..a67a392a52c4 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 4f97d08dad79..3a3861f35ab0 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 5e2c02a5902c..15589d94aed0 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 fc64b758b923..c44291582878 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 811c0dcadc54..3ac1fb266cec 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 2e8b276832fc..1c4d0a0e89d1 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 63d95050d5e5..f95892ba3134 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 fe7ceb0f4c67..2a7b8df21bd0 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 67725ef7cfa7..7ecc1cf64e52 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 adebe775d4dd..7831714a2400 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 e479271a5543..5dd5ebc8331d 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 1dbb7ea1ca86..bd03583bd7a2 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 7af4dc4625c0..c19a0907654c 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 90a2303426da..9dd96354645c 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 a76e1d3ad50e..02887bf97a20 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 35a08f84604f..74aee0f4cf73 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 78fa6020d284..78b49f7ccb6c 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 b63572059d38..a24972162dfb 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 b234b4fc76d1..1f78a083b82d 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 06051102b482..d50db3e51f97 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 017f1ab503f6..53fc1818c69d 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 3bfe0de4873f..bee748b46282 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 619c0fa730d8..d93647bf8652 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 c7133ebe8196..12318b0856c7 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 5c5e2b8d3e66..4b3c36bc4fd5 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 90816032a98b..a4b8f5aaa431 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 053f85798b9f..2ba0ddb7376c 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 a11562227625..66e879a6981f 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 7d4d6c978208..94c465c5ec4f 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 20ef68c12afc..e6636a612405 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 a2d2be4db898..249b02466876 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 84896065f9ab..aa5d740d9387 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 31e21a0a1bba..9d6cbd269ccf 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 25e7375550a2..596f830bdda7 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 2073319a5822..92361cf227ed 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 8b82b61faacc..ccfb6e957461 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 ea4551a8122e..f6040061726e 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 40879fe200a9..8229be51fdcf 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 0b7e3286c5fa..81de38b9fa8d 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 ac4f8c26238e..af1df4330716 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 a35a5c83f43a..2c84cb564e5c 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 211ee7681292..93e6dd2d2885 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 498718b689d0..a7ec9e8e9f30 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 9b386ee79425..75d6a29d95f4 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 e06090c4f453..604eae2bcbf2 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 612f4b916a43..2c9331a9a049 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 9af8102d96d3..3e94d27ae2b6 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 6a2203cda4b0..76da49ae6019 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 6fb320be8007..1559febeeee0 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 4267f4f72e65..14135fcd77f2 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 5a7a0931cc85..8df3f1df3476 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 43c97a9e7a7a..6096f6f41217 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 2cefd1c51de0..4cc6c9d85a62 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 5a52c3dd22c0..f18f3cc7da80 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 df42090c6b03..23e1e8ccfaca 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 5daf9419ef54..8913168a79e3 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 c4b9b5cf7bca..db596671c19a 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 a3bb9ba9465c..45817ec21b5f 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 89a0bb286b2d..14a66013509b 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 5a560a6c4725..2cb60f6b7200 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 e6d02ab979fd..a501ec145095 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 afc083f96290..e355449ff3c2 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 66c88117d9ba..a5f942bc2bee 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 c229eecdf57c..9bb0a902e48c 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 ee4a4625dc60..2e092f451dca 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 6fb23692f9a4..7211ecd7bbc0 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 0c423f26b735..5a829d35266f 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 5600036c3b4e..bb4d85087a8a 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 df55d1662ba5..3a80e47d85f1 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 43f0ef21a902..464f827a1ca9 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 ccbba435ccea..b53d62345ca2 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 e26361b7cbaf..d6a9bc046e06 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 2f733efed79e..ed61aab3f9e1 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 c47a913a5040..0dd47e0645ad 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 2a9c5d53f253..15415570c78c 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 f14b02cfbf13..7c13614d3de0 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 94e29b23cd98..b103ad183b7f 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 fbb8db16f453..15bac5620d2f 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 57ea5ebf83b7..bb30b4843ea0 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 8eb400c82602..6ce11a88df2d 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 51e3c549cd51..204a6434270b 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 d11d31e1d396..501a9fc9536c 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 d35381e3b1d9..98b914e075a2 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 42e84d0bc5e9..6548c92f0164 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 c92c9cbac391..37897b08d588 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 04ff0940160a..0386400ed232 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 3bb2428f0466..5650f49b6aaa 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 d7b4b8904df2..dbca28843db6 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 812bd01e47ab..8958485aced5 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 60cd5386d2e2..9b007b149f7b 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 cf1a7d56693a..b03eeb92104e 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 338fc26a4f28..525a839925d7 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 82a992556afe..e2e7953934da 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 ab71a2b7be78..29ab2fdf93f6 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 03b02475469a..db9fbbf8666e 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 b7e951af0b07..e205274573a0 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 0d64b73e6e04..2ccfaf751f47 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 8248e4650ba2..f5f8b7449dcb 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 8b687f5b8611..f4ce9fbaf6f9 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 a1354b89b6e6..348f720a9913 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 4eadf1bf48d4..d09ddc5e97a2 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 17a595642bdc..f217ee3f6484 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 a624a05bb759..4355eb9963be 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 1be644b05884..8a205b622671 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 dc0581b82fe1..85bad07a8a8c 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 6f914055fc48..b7f02397ecd1 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 3d851068bc68..fc970ccbb9e9 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 036630d57a17..62c3e2edd24b 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 57ce6d98467d..24072776f1be 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 08697d01960e..bc1bff19bce9 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 3027bfab47b0..f212a3eaf061 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 566787aa58e2..b7994c578e80 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 8807aee85206..964a9810d8fc 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 9d31d420a055..bbd3dd5f469f 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 6a0e1083a8b9..4c7824c0393f 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 39f3653203b3..a63090f8d038 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 0b1181fefb8c..019daad2906d 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 ebb6b124d7f1..e76b867b852b 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 ab41261b087a..0a5489f5c542 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 f5d9982ee344..7ad391ed2b64 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 981fb6b823cd..ad0885ae8c59 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 26ad7db7a884..0060302976ec 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 e04eacba451d..92088d951d52 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 c57e6a83e091..2fb031d6d06b 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 be0c9f2748f6..1eb032aace1d 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 2d0bc327ff5d..7ceaf03c8ac8 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 eb8632808919..d40bd96b17bb 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 14f0992e7417..8f14646cb8b4 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 0368b134888d..a8be1db36958 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 6bcaa9105da4..1b8e70b8fa7a 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 d9e2df84324c..fe4e21a559e2 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 f33060aa7095..77db808f1dcf 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 fdf7a1ea18a5..378bf1563472 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 fbd894d66fcd..1c3675e2b59d 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 c5055aeaee25..2b91dae9a0d7 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 b3702f6145d1..ac0713b98c5e 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 53a47c44f929..215ac8310aea 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 ad946db77713..9bef77af2681 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 06cc071b94db..5ce78bdeecf5 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 15c06afa9cd9..698fb09df4ef 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 44b9a0f6c666..18152293dc53 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 6de17709c62d..7776b29bee67 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 78e202fe11b0..b71eb3b1a45a 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 908b6cbabf02..94695ff8ee1f 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 13546359a9f6..70823d519267 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 9eadbf707172..44796861d4cc 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 21f25db04f8e..b59fbbfbe2b8 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 66d9e96c8265..c77ba5cfa6c2 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 8bd646583ad8..5595a15c8e06 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 6405c836cd70..54bd3e6dbcc4 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 c58daf945e20..e10b2f063ef4 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 000e1b8c0884..605112febe9f 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 6cc8e86dcaa4..5f28d4d10b70 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 e10c359a2b3d..f65f293fd810 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 6b799ab8f32c..02c55513db5f 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 1332714fdb65..5453695e16da 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 4524893aced7..ea69bc8ee8b1 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 cc8fe99927a9..3ca229a1917c 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 0cc2b8f62e2c..f4887a0d4a65 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 16a62c48f097..96b1c7357b93 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 5a8a904e716d..5db78e435f68 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 0e45b8c4fb6e..0e436a621518 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 2f409ea2fed3..f96cbac3ce88 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 acc21d30ce18..3292b5f105c7 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 d2fa9cd5436c..e8ae0f06fb40 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 49deee393354..11f7c3423750 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 64272be9fdf8..0964b3771f65 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 165f3f48bcd8..ca1f8a83e44d 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 e2a7be701c88..19408eb046b9 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 a849475e208c..02e9bce039d7 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 04d3748276e4..76d86312aaa9 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 a2ea0ae73d2b..453156ade5f7 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 166e5660b406..b3225019f7dc 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 1f13a6581c98..5462e47a168d 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 f1aa05c8b145..0228ff635d87 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 b6fce15fac7c..d193ea050578 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 6d8314ce4c22..800f8a9d7eb9 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 d6206c242e4e..0271f0657229 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 c6658df7e624..efcbb106d00a 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 d6070fb987c3..6f2422c7bddd 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 2e2ac56aef30..84b35e82c4f2 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 d137f691d6b6..02f05387fb7d 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 21fa36c62c8d..debb8cd48ed1 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 d1939465a657..a8c5534816f1 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 660ae2823cf6..858989410f8a 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 c2df50cd227e..fb286f231d0d 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 1d391024b4ac..c69ca39aef00 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 832313ba940e..2b5f86a03b32 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 cd2cf7a0eca9..c6b67d1d1d76 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 9dc29bf826bf..a7fc85277a1b 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 7761470665a4..f5e1a507537e 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 f710cc443e3f..fd85ff10a2b0 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 4205d17d612e..0f005c5f4b18 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 98787f4f4973..f839a61c9b25 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 18ab330dd7a9..9e679456364e 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 537e75e369f6..53c372088b9d 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 17b8733a817d..d02b1570f91e 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 c89d0e43fa25..450d1bca2481 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 0bdca8d1cf3e..1355306ba94c 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 ae82570030e1..af138c7d6095 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 2d6361f240e0..c6e91b772647 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 bc18af6148a0..98bd13c0f38d 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 76c777a5c42a..f1e9fcd48e9e 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 f6754da5aefb..9a1ab6d2c8ee 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 ab2744e80786..bd543db78150 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 59caaa688aeb..cab80bfff02f 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 d52dac303315..c6c22e09de4a 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 7b18f43a9489..2e8e8c3a08e9 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 8378fe22c90c..64528d4c4ffd 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 3282dac8a101..9290d7d29d90 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 e7b77a419077..e1052823b70a 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 f684a359c770..047068384c59 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 dd3461377e4a..b10ddd08ccf6 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 984c0a21a14b..723d1d2d8a72 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?: {