diff --git a/extensions/active-memory/config.test.ts b/extensions/active-memory/config.test.ts index 3702685bfbd..2c78a972edd 100644 --- a/extensions/active-memory/config.test.ts +++ b/extensions/active-memory/config.test.ts @@ -1,3 +1,4 @@ +// Active Memory tests cover config plugin behavior. import fs from "node:fs"; import { type JsonSchemaObject, diff --git a/extensions/active-memory/doctor-contract-api.test.ts b/extensions/active-memory/doctor-contract-api.test.ts index b69465c1375..4965d5041e2 100644 --- a/extensions/active-memory/doctor-contract-api.test.ts +++ b/extensions/active-memory/doctor-contract-api.test.ts @@ -1,3 +1,4 @@ +// Active Memory tests cover doctor contract api plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/active-memory/index.test.ts b/extensions/active-memory/index.test.ts index a0edee943ed..7ed70486b82 100644 --- a/extensions/active-memory/index.test.ts +++ b/extensions/active-memory/index.test.ts @@ -1,3 +1,4 @@ +// Active Memory tests cover index plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/admin-http-rpc/index.test.ts b/extensions/admin-http-rpc/index.test.ts index d762b5b182e..19e1e98b8ba 100644 --- a/extensions/admin-http-rpc/index.test.ts +++ b/extensions/admin-http-rpc/index.test.ts @@ -1,3 +1,4 @@ +// Admin Http Rpc tests cover index plugin behavior. import { describe, expect, it } from "vitest"; import plugin from "./index.js"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/admin-http-rpc/src/handler.test.ts b/extensions/admin-http-rpc/src/handler.test.ts index 721360f6c68..dadd0edc1a9 100644 --- a/extensions/admin-http-rpc/src/handler.test.ts +++ b/extensions/admin-http-rpc/src/handler.test.ts @@ -1,3 +1,4 @@ +// Admin Http Rpc tests cover handler plugin behavior. import { Readable } from "node:stream"; import { beforeEach, describe, expect, it, vi } from "vitest"; import { handleAdminHttpRpcRequest } from "./handler.js"; diff --git a/extensions/alibaba/video-generation-provider.test.ts b/extensions/alibaba/video-generation-provider.test.ts index 20fae5df96e..10efa0b07cc 100644 --- a/extensions/alibaba/video-generation-provider.test.ts +++ b/extensions/alibaba/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Alibaba tests cover video generation provider plugin behavior. import { getProviderHttpMocks, installProviderHttpMockCleanup, diff --git a/extensions/amazon-bedrock-mantle/discovery.test.ts b/extensions/amazon-bedrock-mantle/discovery.test.ts index f0fed83bbf0..ed23da426ee 100644 --- a/extensions/amazon-bedrock-mantle/discovery.test.ts +++ b/extensions/amazon-bedrock-mantle/discovery.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock Mantle tests cover discovery plugin behavior. import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; const { diff --git a/extensions/amazon-bedrock-mantle/index.test.ts b/extensions/amazon-bedrock-mantle/index.test.ts index d1073edaa0f..fc8916f644b 100644 --- a/extensions/amazon-bedrock-mantle/index.test.ts +++ b/extensions/amazon-bedrock-mantle/index.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock Mantle tests cover index plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { beforeEach, describe, expect, it, vi } from "vitest"; import bedrockMantlePlugin from "./index.js"; diff --git a/extensions/amazon-bedrock-mantle/mantle-anthropic.runtime.test.ts b/extensions/amazon-bedrock-mantle/mantle-anthropic.runtime.test.ts index 13eeca2e0b2..04fc360a7af 100644 --- a/extensions/amazon-bedrock-mantle/mantle-anthropic.runtime.test.ts +++ b/extensions/amazon-bedrock-mantle/mantle-anthropic.runtime.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock Mantle tests cover mantle anthropic plugin behavior. import type { Model } from "openclaw/plugin-sdk/llm"; import { describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/amazon-bedrock/config-compat.test.ts b/extensions/amazon-bedrock/config-compat.test.ts index 1bd7a4214b7..d552ec33223 100644 --- a/extensions/amazon-bedrock/config-compat.test.ts +++ b/extensions/amazon-bedrock/config-compat.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover config compat plugin behavior. import { describe, expect, it } from "vitest"; import { migrateAmazonBedrockLegacyConfig } from "./config-compat.js"; diff --git a/extensions/amazon-bedrock/discovery.test.ts b/extensions/amazon-bedrock/discovery.test.ts index e56dff0d8c5..4e46fe7acd9 100644 --- a/extensions/amazon-bedrock/discovery.test.ts +++ b/extensions/amazon-bedrock/discovery.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover discovery plugin behavior. import type { BedrockClient } from "@aws-sdk/client-bedrock"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/amazon-bedrock/embedding-provider.test.ts b/extensions/amazon-bedrock/embedding-provider.test.ts index 1a62c0970d4..18ebe9b5ef4 100644 --- a/extensions/amazon-bedrock/embedding-provider.test.ts +++ b/extensions/amazon-bedrock/embedding-provider.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover embedding provider plugin behavior. import { describe, expect, it, vi } from "vitest"; import { testing, hasAwsCredentials } from "./embedding-provider.js"; diff --git a/extensions/amazon-bedrock/index.test.ts b/extensions/amazon-bedrock/index.test.ts index f16f79151bc..7d02f014a77 100644 --- a/extensions/amazon-bedrock/index.test.ts +++ b/extensions/amazon-bedrock/index.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover index plugin behavior. import { readFileSync } from "node:fs"; import { resolve } from "node:path"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; diff --git a/extensions/amazon-bedrock/lazy-import.test.ts b/extensions/amazon-bedrock/lazy-import.test.ts index bc656a5c391..73f0acb7aab 100644 --- a/extensions/amazon-bedrock/lazy-import.test.ts +++ b/extensions/amazon-bedrock/lazy-import.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover lazy import plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { afterEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/amazon-bedrock/memory-embedding-adapter.test.ts b/extensions/amazon-bedrock/memory-embedding-adapter.test.ts index 6d01c8d5d44..c248afa343d 100644 --- a/extensions/amazon-bedrock/memory-embedding-adapter.test.ts +++ b/extensions/amazon-bedrock/memory-embedding-adapter.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover memory embedding adapter plugin behavior. import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest"; const hasAwsCredentialsMock = vi.hoisted(() => vi.fn()); diff --git a/extensions/amazon-bedrock/provider-policy-api.test.ts b/extensions/amazon-bedrock/provider-policy-api.test.ts index a5def199326..2961b226cde 100644 --- a/extensions/amazon-bedrock/provider-policy-api.test.ts +++ b/extensions/amazon-bedrock/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover provider policy api plugin behavior. import { describe, expect, it } from "vitest"; import { resolveThinkingProfile } from "./provider-policy-api.js"; diff --git a/extensions/amazon-bedrock/stream.runtime.test.ts b/extensions/amazon-bedrock/stream.runtime.test.ts index 75e0f2813da..2e2229add84 100644 --- a/extensions/amazon-bedrock/stream.runtime.test.ts +++ b/extensions/amazon-bedrock/stream.runtime.test.ts @@ -1,3 +1,4 @@ +// Amazon Bedrock tests cover stream plugin behavior. import { describe, expect, it } from "vitest"; import { testing } from "./stream.runtime.js"; diff --git a/extensions/anthropic-vertex/api.test.ts b/extensions/anthropic-vertex/api.test.ts index ec231fd5071..d7f42a1688e 100644 --- a/extensions/anthropic-vertex/api.test.ts +++ b/extensions/anthropic-vertex/api.test.ts @@ -1,3 +1,4 @@ +// Anthropic Vertex tests cover api plugin behavior. import { createAssistantMessageEventStream, type Model } from "openclaw/plugin-sdk/llm"; import { beforeAll, describe, expect, it, vi } from "vitest"; import type { AnthropicVertexStreamDeps } from "./stream-runtime.js"; diff --git a/extensions/anthropic-vertex/index.test.ts b/extensions/anthropic-vertex/index.test.ts index b9d088f5fa8..6fa583799ba 100644 --- a/extensions/anthropic-vertex/index.test.ts +++ b/extensions/anthropic-vertex/index.test.ts @@ -1,3 +1,4 @@ +// Anthropic Vertex tests cover index plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/anthropic-vertex/provider-discovery.import-guard.test.ts b/extensions/anthropic-vertex/provider-discovery.import-guard.test.ts index 010c7810949..834e68544c7 100644 --- a/extensions/anthropic-vertex/provider-discovery.import-guard.test.ts +++ b/extensions/anthropic-vertex/provider-discovery.import-guard.test.ts @@ -1,3 +1,4 @@ +// Anthropic Vertex tests cover provider discovery.import guard plugin behavior. import { describe, expect, it } from "vitest"; describe("anthropic-vertex provider discovery entry", () => { diff --git a/extensions/anthropic-vertex/provider-policy-api.test.ts b/extensions/anthropic-vertex/provider-policy-api.test.ts index c8937dbeb11..9f6a78b4ec6 100644 --- a/extensions/anthropic-vertex/provider-policy-api.test.ts +++ b/extensions/anthropic-vertex/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Anthropic Vertex tests cover provider policy api plugin behavior. import { describe, expect, it } from "vitest"; import { resolveThinkingProfile } from "./provider-policy-api.js"; diff --git a/extensions/anthropic-vertex/region.adc.test.ts b/extensions/anthropic-vertex/region.adc.test.ts index dfa141d1082..dd8de591d18 100644 --- a/extensions/anthropic-vertex/region.adc.test.ts +++ b/extensions/anthropic-vertex/region.adc.test.ts @@ -1,3 +1,4 @@ +// Anthropic Vertex tests cover region.adc plugin behavior. import { platform } from "node:os"; import path from "node:path"; import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/anthropic-vertex/region.test.ts b/extensions/anthropic-vertex/region.test.ts index 940ed0fe2c8..49a2ced78f9 100644 --- a/extensions/anthropic-vertex/region.test.ts +++ b/extensions/anthropic-vertex/region.test.ts @@ -1,3 +1,4 @@ +// Anthropic Vertex tests cover region plugin behavior. import { describe, expect, it } from "vitest"; import { resolveAnthropicVertexRegion, resolveAnthropicVertexRegionFromBaseUrl } from "./api.js"; diff --git a/extensions/anthropic-vertex/stream-runtime.test.ts b/extensions/anthropic-vertex/stream-runtime.test.ts index bec67b313c7..ac36f68c884 100644 --- a/extensions/anthropic-vertex/stream-runtime.test.ts +++ b/extensions/anthropic-vertex/stream-runtime.test.ts @@ -1,3 +1,4 @@ +// Anthropic Vertex tests cover stream runtime plugin behavior. import { createAssistantMessageEventStream, type Model } from "openclaw/plugin-sdk/llm"; import { beforeAll, describe, expect, it, vi } from "vitest"; import type { AnthropicVertexStreamDeps } from "./stream-runtime.js"; diff --git a/extensions/anthropic/cli-migration.test.ts b/extensions/anthropic/cli-migration.test.ts index da966af27cc..1c026320000 100644 --- a/extensions/anthropic/cli-migration.test.ts +++ b/extensions/anthropic/cli-migration.test.ts @@ -1,3 +1,4 @@ +// Anthropic tests cover cli migration plugin behavior. import type { ProviderAuthContext, ProviderAuthMethodNonInteractiveContext, diff --git a/extensions/anthropic/cli-shared.test.ts b/extensions/anthropic/cli-shared.test.ts index f35bf343084..91032fe691c 100644 --- a/extensions/anthropic/cli-shared.test.ts +++ b/extensions/anthropic/cli-shared.test.ts @@ -1,3 +1,4 @@ +// Anthropic tests cover cli shared plugin behavior. import { describe, expect, it } from "vitest"; import { buildAnthropicCliBackend } from "./cli-backend.js"; import { diff --git a/extensions/anthropic/index.test.ts b/extensions/anthropic/index.test.ts index 18d010571f9..5727a738d3d 100644 --- a/extensions/anthropic/index.test.ts +++ b/extensions/anthropic/index.test.ts @@ -1,3 +1,4 @@ +// Anthropic tests cover index plugin behavior. import type { ProviderResolveDynamicModelContext, ProviderRuntimeModel, diff --git a/extensions/anthropic/provider-policy-api.test.ts b/extensions/anthropic/provider-policy-api.test.ts index a02639cc12d..6c19bf62736 100644 --- a/extensions/anthropic/provider-policy-api.test.ts +++ b/extensions/anthropic/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Anthropic tests cover provider policy api plugin behavior. import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-types"; import { describe, expect, it } from "vitest"; import { diff --git a/extensions/anthropic/provider-runtime.contract.test.ts b/extensions/anthropic/provider-runtime.contract.test.ts index aff5846e2ea..baa22251eb1 100644 --- a/extensions/anthropic/provider-runtime.contract.test.ts +++ b/extensions/anthropic/provider-runtime.contract.test.ts @@ -1,3 +1,4 @@ +// Anthropic tests cover provider runtime.contract plugin behavior. import { describeAnthropicProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeAnthropicProviderRuntimeContract(() => import("./index.js")); diff --git a/extensions/anthropic/stream-wrappers.test.ts b/extensions/anthropic/stream-wrappers.test.ts index 11a7574afb9..8d354d6c37e 100644 --- a/extensions/anthropic/stream-wrappers.test.ts +++ b/extensions/anthropic/stream-wrappers.test.ts @@ -1,3 +1,4 @@ +// Anthropic tests cover stream wrappers plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import { afterEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/arcee/index.test.ts b/extensions/arcee/index.test.ts index 1a68efb597d..fdda9c9b1b5 100644 --- a/extensions/arcee/index.test.ts +++ b/extensions/arcee/index.test.ts @@ -1,3 +1,4 @@ +// Arcee tests cover index plugin behavior. import { registerSingleProviderPlugin, resolveProviderPluginChoice, diff --git a/extensions/azure-speech/azure-speech.live.test.ts b/extensions/azure-speech/azure-speech.live.test.ts index 16a71e18216..23fa06cbded 100644 --- a/extensions/azure-speech/azure-speech.live.test.ts +++ b/extensions/azure-speech/azure-speech.live.test.ts @@ -1,3 +1,4 @@ +// Azure Speech tests cover azure speech plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/azure-speech/speech-provider.test.ts b/extensions/azure-speech/speech-provider.test.ts index 30854a508b5..cd750319252 100644 --- a/extensions/azure-speech/speech-provider.test.ts +++ b/extensions/azure-speech/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Azure Speech tests cover speech provider plugin behavior. import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest"; const { azureSpeechTTSMock, listAzureSpeechVoicesMock } = vi.hoisted(() => ({ diff --git a/extensions/azure-speech/tts.test.ts b/extensions/azure-speech/tts.test.ts index 0d6933e243e..f576ff764f6 100644 --- a/extensions/azure-speech/tts.test.ts +++ b/extensions/azure-speech/tts.test.ts @@ -1,3 +1,4 @@ +// Azure Speech tests cover tts plugin behavior. import { installPinnedHostnameTestHooks } from "openclaw/plugin-sdk/test-env"; import { afterEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/bonjour/index.test.ts b/extensions/bonjour/index.test.ts index 155755f1947..5e1414bb54b 100644 --- a/extensions/bonjour/index.test.ts +++ b/extensions/bonjour/index.test.ts @@ -1,3 +1,4 @@ +// Bonjour tests cover index plugin behavior. import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { afterAll, describe, expect, it, vi } from "vitest"; diff --git a/extensions/bonjour/manifest.test.ts b/extensions/bonjour/manifest.test.ts index 4206c30c217..b0b11998ffa 100644 --- a/extensions/bonjour/manifest.test.ts +++ b/extensions/bonjour/manifest.test.ts @@ -1,3 +1,4 @@ +// Bonjour tests cover manifest plugin behavior. import fs from "node:fs"; import { describe, expect, it } from "vitest"; diff --git a/extensions/bonjour/src/advertiser.test.ts b/extensions/bonjour/src/advertiser.test.ts index 74ff1eba33f..49d3a4a52f1 100644 --- a/extensions/bonjour/src/advertiser.test.ts +++ b/extensions/bonjour/src/advertiser.test.ts @@ -1,3 +1,4 @@ +// Bonjour tests cover advertiser plugin behavior. import type { ChildProcess } from "node:child_process"; import fs from "node:fs"; import { createRequire } from "node:module"; diff --git a/extensions/bonjour/src/ciao.test.ts b/extensions/bonjour/src/ciao.test.ts index 5798efad94c..f7c63dd944a 100644 --- a/extensions/bonjour/src/ciao.test.ts +++ b/extensions/bonjour/src/ciao.test.ts @@ -1,3 +1,4 @@ +// Bonjour tests cover ciao plugin behavior. import { describe, expect, it } from "vitest"; const { classifyCiaoUnhandledRejection, ignoreCiaoUnhandledRejection } = await import("./ciao.js"); diff --git a/extensions/bonjour/src/errors.test.ts b/extensions/bonjour/src/errors.test.ts index a7a66c2c12c..274b05af0ca 100644 --- a/extensions/bonjour/src/errors.test.ts +++ b/extensions/bonjour/src/errors.test.ts @@ -1,3 +1,4 @@ +// Bonjour tests cover errors plugin behavior. import { describe, expect, it } from "vitest"; import { formatBonjourError } from "./errors.js"; diff --git a/extensions/brave/src/brave-web-search-provider.merge.test.ts b/extensions/brave/src/brave-web-search-provider.merge.test.ts index 6e1fd54d74a..7f1d91b7cb7 100644 --- a/extensions/brave/src/brave-web-search-provider.merge.test.ts +++ b/extensions/brave/src/brave-web-search-provider.merge.test.ts @@ -1,3 +1,4 @@ +// Brave tests cover brave web search provider.merge plugin behavior. import { describe, expect, it, vi } from "vitest"; import { createBraveWebSearchProvider } from "./brave-web-search-provider.js"; diff --git a/extensions/brave/src/brave-web-search-provider.test.ts b/extensions/brave/src/brave-web-search-provider.test.ts index af352949db7..6d5e1a9b209 100644 --- a/extensions/brave/src/brave-web-search-provider.test.ts +++ b/extensions/brave/src/brave-web-search-provider.test.ts @@ -1,3 +1,4 @@ +// Brave tests cover brave web search provider plugin behavior. import fs from "node:fs"; import { validateJsonSchemaValue } from "openclaw/plugin-sdk/json-schema-runtime"; import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/byteplus/index.test.ts b/extensions/byteplus/index.test.ts index c41dea2c046..e9544f235f1 100644 --- a/extensions/byteplus/index.test.ts +++ b/extensions/byteplus/index.test.ts @@ -1,3 +1,4 @@ +// Byteplus tests cover index plugin behavior. import { readFileSync } from "node:fs"; import { resolve } from "node:path"; import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; diff --git a/extensions/byteplus/live.test.ts b/extensions/byteplus/live.test.ts index f2cde1398b7..72aa71ead28 100644 --- a/extensions/byteplus/live.test.ts +++ b/extensions/byteplus/live.test.ts @@ -1,3 +1,4 @@ +// Byteplus tests cover live plugin behavior. import { completeSimple, type Model } from "openclaw/plugin-sdk/llm"; import { createSingleUserPromptMessage, diff --git a/extensions/byteplus/video-generation-provider.test.ts b/extensions/byteplus/video-generation-provider.test.ts index ad1fbea1e04..acac8b50e86 100644 --- a/extensions/byteplus/video-generation-provider.test.ts +++ b/extensions/byteplus/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Byteplus tests cover video generation provider plugin behavior. import { getProviderHttpMocks, installProviderHttpMockCleanup, diff --git a/extensions/canvas/index.test.ts b/extensions/canvas/index.test.ts index 8e65386985e..1c47559a57d 100644 --- a/extensions/canvas/index.test.ts +++ b/extensions/canvas/index.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover index plugin behavior. import type { AnyAgentTool, OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/canvas/scripts/bundle-a2ui.test.ts b/extensions/canvas/scripts/bundle-a2ui.test.ts index 940db54fd43..b075f247d1b 100644 --- a/extensions/canvas/scripts/bundle-a2ui.test.ts +++ b/extensions/canvas/scripts/bundle-a2ui.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover bundle a2ui plugin behavior. import path from "node:path"; import { describe, expect, it } from "vitest"; import { diff --git a/extensions/canvas/scripts/copy-a2ui.test.ts b/extensions/canvas/scripts/copy-a2ui.test.ts index 5326347d8e6..75a96070307 100644 --- a/extensions/canvas/scripts/copy-a2ui.test.ts +++ b/extensions/canvas/scripts/copy-a2ui.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover copy a2ui plugin behavior. import { createHash } from "node:crypto"; import fs from "node:fs/promises"; import path from "node:path"; diff --git a/extensions/canvas/scripts/pnpm-runner.test.ts b/extensions/canvas/scripts/pnpm-runner.test.ts index a36b777c792..83bbcb47d6c 100644 --- a/extensions/canvas/scripts/pnpm-runner.test.ts +++ b/extensions/canvas/scripts/pnpm-runner.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover pnpm runner plugin behavior. import { chmodSync, mkdtempSync, rmSync, writeFileSync } from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/canvas/src/cli-helpers.test.ts b/extensions/canvas/src/cli-helpers.test.ts index 54b957db6bc..48b20009769 100644 --- a/extensions/canvas/src/cli-helpers.test.ts +++ b/extensions/canvas/src/cli-helpers.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover cli helpers plugin behavior. import { describe, expect, it } from "vitest"; import { canvasSnapshotTempPath, diff --git a/extensions/canvas/src/cli.test.ts b/extensions/canvas/src/cli.test.ts index 8a1d532471e..04d4e94a1b1 100644 --- a/extensions/canvas/src/cli.test.ts +++ b/extensions/canvas/src/cli.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover cli plugin behavior. import { Command } from "commander"; import { describe, expect, it, vi } from "vitest"; import { registerNodesCanvasCommands, type CanvasCliDependencies } from "./cli.js"; diff --git a/extensions/canvas/src/config-migration.test.ts b/extensions/canvas/src/config-migration.test.ts index e1eec52f3dd..5c39df9af93 100644 --- a/extensions/canvas/src/config-migration.test.ts +++ b/extensions/canvas/src/config-migration.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover config migration plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { describe, expect, test } from "vitest"; import { migrateLegacyCanvasHostConfig } from "./config-migration.js"; diff --git a/extensions/canvas/src/config.test.ts b/extensions/canvas/src/config.test.ts index 69786174c04..0ae1a15c9ab 100644 --- a/extensions/canvas/src/config.test.ts +++ b/extensions/canvas/src/config.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover config plugin behavior. import { afterEach, describe, expect, it } from "vitest"; import { isCanvasHostEnabled, diff --git a/extensions/canvas/src/documents.test.ts b/extensions/canvas/src/documents.test.ts index 8fa98ca8094..0613f834e7c 100644 --- a/extensions/canvas/src/documents.test.ts +++ b/extensions/canvas/src/documents.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover documents plugin behavior. import { mkdtemp, mkdir, writeFile, readFile } from "node:fs/promises"; import { tmpdir } from "node:os"; import path from "node:path"; diff --git a/extensions/canvas/src/host-url.test.ts b/extensions/canvas/src/host-url.test.ts index 360060e3590..b6497916159 100644 --- a/extensions/canvas/src/host-url.test.ts +++ b/extensions/canvas/src/host-url.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover host url plugin behavior. import { describe, expect, it } from "vitest"; import { resolveCanvasHostUrl } from "./host-url.js"; diff --git a/extensions/canvas/src/host/file-resolver.test.ts b/extensions/canvas/src/host/file-resolver.test.ts index e672956789c..c15b0d2afae 100644 --- a/extensions/canvas/src/host/file-resolver.test.ts +++ b/extensions/canvas/src/host/file-resolver.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover file resolver plugin behavior. import fs from "node:fs/promises"; import path from "node:path"; import { resolvePreferredOpenClawTmpDir, withTempWorkspace } from "openclaw/plugin-sdk/temp-path"; diff --git a/extensions/canvas/src/host/server.state-dir.test.ts b/extensions/canvas/src/host/server.state-dir.test.ts index f3457af89d4..5a17aaa048c 100644 --- a/extensions/canvas/src/host/server.state-dir.test.ts +++ b/extensions/canvas/src/host/server.state-dir.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover server.state dir plugin behavior. import fs from "node:fs/promises"; import path from "node:path"; import { defaultRuntime } from "openclaw/plugin-sdk/runtime-env"; diff --git a/extensions/canvas/src/host/server.test.ts b/extensions/canvas/src/host/server.test.ts index ba0e3123d8d..9ec3b8ec1f6 100644 --- a/extensions/canvas/src/host/server.test.ts +++ b/extensions/canvas/src/host/server.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover server plugin behavior. import fs from "node:fs/promises"; import type { IncomingMessage } from "node:http"; import os from "node:os"; diff --git a/extensions/canvas/src/tool.test.ts b/extensions/canvas/src/tool.test.ts index 38b9e137fe8..d349ec0a061 100644 --- a/extensions/canvas/src/tool.test.ts +++ b/extensions/canvas/src/tool.test.ts @@ -1,3 +1,4 @@ +// Canvas tests cover tool plugin behavior. import { mkdtemp, mkdir, rm, symlink, writeFile } from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/chutes/implicit-provider.test.ts b/extensions/chutes/implicit-provider.test.ts index 486c274c3b2..859ddf29424 100644 --- a/extensions/chutes/implicit-provider.test.ts +++ b/extensions/chutes/implicit-provider.test.ts @@ -1,3 +1,4 @@ +// Chutes tests cover implicit provider plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { resolveOAuthApiKeyMarker } from "openclaw/plugin-sdk/provider-auth"; import { afterEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/chutes/models.test.ts b/extensions/chutes/models.test.ts index 9e7c13a500d..09d9dcceea3 100644 --- a/extensions/chutes/models.test.ts +++ b/extensions/chutes/models.test.ts @@ -1,3 +1,4 @@ +// Chutes tests cover models plugin behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { buildChutesModelDefinition, diff --git a/extensions/chutes/oauth.test.ts b/extensions/chutes/oauth.test.ts index 684fa987ee6..b0b3899bb2e 100644 --- a/extensions/chutes/oauth.test.ts +++ b/extensions/chutes/oauth.test.ts @@ -1,3 +1,4 @@ +// Chutes tests cover oauth plugin behavior. import { describe, expect, it, vi } from "vitest"; import { loginChutes } from "./oauth.js"; diff --git a/extensions/clickclack/src/accounts.test.ts b/extensions/clickclack/src/accounts.test.ts index 36aadd56a1e..becade67de1 100644 --- a/extensions/clickclack/src/accounts.test.ts +++ b/extensions/clickclack/src/accounts.test.ts @@ -1,3 +1,4 @@ +// Clickclack tests cover accounts plugin behavior. import { describe, expect, it } from "vitest"; import { listClickClackAccountIds, diff --git a/extensions/clickclack/src/gateway.test.ts b/extensions/clickclack/src/gateway.test.ts index f009c7cb25d..af26c84ed36 100644 --- a/extensions/clickclack/src/gateway.test.ts +++ b/extensions/clickclack/src/gateway.test.ts @@ -1,3 +1,4 @@ +// Clickclack tests cover gateway plugin behavior. import { EventEmitter } from "node:events"; import type { ChannelGatewayContext } from "openclaw/plugin-sdk/channel-contract"; import { beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/clickclack/src/inbound.test.ts b/extensions/clickclack/src/inbound.test.ts index 2f038a1aa66..65c89813f6e 100644 --- a/extensions/clickclack/src/inbound.test.ts +++ b/extensions/clickclack/src/inbound.test.ts @@ -1,3 +1,4 @@ +// Clickclack tests cover inbound plugin behavior. import { createPluginRuntimeMock } from "openclaw/plugin-sdk/channel-test-helpers"; import type { PluginRuntime } from "openclaw/plugin-sdk/core"; import { describe, expect, it, vi } from "vitest"; diff --git a/extensions/clickclack/src/target.test.ts b/extensions/clickclack/src/target.test.ts index 00fe733d5a9..0ac02ef7b23 100644 --- a/extensions/clickclack/src/target.test.ts +++ b/extensions/clickclack/src/target.test.ts @@ -1,3 +1,4 @@ +// Clickclack tests cover target plugin behavior. import { describe, expect, it } from "vitest"; import { buildClickClackTarget, diff --git a/extensions/cloudflare-ai-gateway/index.test.ts b/extensions/cloudflare-ai-gateway/index.test.ts index 70d588c24eb..2869203fb3b 100644 --- a/extensions/cloudflare-ai-gateway/index.test.ts +++ b/extensions/cloudflare-ai-gateway/index.test.ts @@ -1,3 +1,4 @@ +// Cloudflare Ai Gateway tests cover index plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import { capturePluginRegistration } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; diff --git a/extensions/cloudflare-ai-gateway/provider-discovery.contract.test.ts b/extensions/cloudflare-ai-gateway/provider-discovery.contract.test.ts index 26d5469b4fd..18cd3d88adb 100644 --- a/extensions/cloudflare-ai-gateway/provider-discovery.contract.test.ts +++ b/extensions/cloudflare-ai-gateway/provider-discovery.contract.test.ts @@ -1,3 +1,4 @@ +// Cloudflare Ai Gateway tests cover provider discovery.contract plugin behavior. import { describeCloudflareAiGatewayProviderDiscoveryContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeCloudflareAiGatewayProviderDiscoveryContract(() => import("./index.js")); diff --git a/extensions/cloudflare-ai-gateway/stream-wrappers.test.ts b/extensions/cloudflare-ai-gateway/stream-wrappers.test.ts index 8c70c176c30..d84b2c7e80f 100644 --- a/extensions/cloudflare-ai-gateway/stream-wrappers.test.ts +++ b/extensions/cloudflare-ai-gateway/stream-wrappers.test.ts @@ -1,3 +1,4 @@ +// Cloudflare Ai Gateway tests cover stream wrappers plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import { afterAll, beforeEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/codex-supervisor/index.test.ts b/extensions/codex-supervisor/index.test.ts index c5f566bdb9a..71c596b0c64 100644 --- a/extensions/codex-supervisor/index.test.ts +++ b/extensions/codex-supervisor/index.test.ts @@ -1,3 +1,4 @@ +// Codex Supervisor tests cover index plugin behavior. import { createCapturedPluginRegistration } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import entry from "./index.js"; diff --git a/extensions/codex-supervisor/src/mcp-tools.test.ts b/extensions/codex-supervisor/src/mcp-tools.test.ts index 8c08ae11147..22d2d71277b 100644 --- a/extensions/codex-supervisor/src/mcp-tools.test.ts +++ b/extensions/codex-supervisor/src/mcp-tools.test.ts @@ -1,3 +1,4 @@ +// Codex Supervisor tests cover mcp tools plugin behavior. import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; import { describe, expect, it } from "vitest"; import { diff --git a/extensions/codex-supervisor/src/plugin-tools.test.ts b/extensions/codex-supervisor/src/plugin-tools.test.ts index d3600b05df4..dfa037bec3f 100644 --- a/extensions/codex-supervisor/src/plugin-tools.test.ts +++ b/extensions/codex-supervisor/src/plugin-tools.test.ts @@ -1,3 +1,4 @@ +// Codex Supervisor tests cover plugin tools plugin behavior. import { describe, expect, it } from "vitest"; import { createCodexSupervisorTools } from "./plugin-tools.js"; import type { CodexSupervisor } from "./supervisor.js"; diff --git a/extensions/codex-supervisor/src/supervisor.test.ts b/extensions/codex-supervisor/src/supervisor.test.ts index da164f21ef0..b1c6fbe85e5 100644 --- a/extensions/codex-supervisor/src/supervisor.test.ts +++ b/extensions/codex-supervisor/src/supervisor.test.ts @@ -1,3 +1,4 @@ +// Codex Supervisor tests cover supervisor plugin behavior. import * as fs from "node:fs/promises"; import * as os from "node:os"; import * as path from "node:path"; diff --git a/extensions/comfy/comfy.live.test.ts b/extensions/comfy/comfy.live.test.ts index 2f04d1db75d..3b4597fcbbb 100644 --- a/extensions/comfy/comfy.live.test.ts +++ b/extensions/comfy/comfy.live.test.ts @@ -1,3 +1,4 @@ +// Comfy tests cover comfy plugin behavior. import { resolveDefaultAgentDir } from "openclaw/plugin-sdk/agent-runtime"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; diff --git a/extensions/comfy/image-generation-provider.test.ts b/extensions/comfy/image-generation-provider.test.ts index f7431ea13af..0c77642870c 100644 --- a/extensions/comfy/image-generation-provider.test.ts +++ b/extensions/comfy/image-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Comfy tests cover image generation provider plugin behavior. import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/comfy/image-generation-provider.ts b/extensions/comfy/image-generation-provider.ts index 63dfec2ccb4..e298df3994d 100644 --- a/extensions/comfy/image-generation-provider.ts +++ b/extensions/comfy/image-generation-provider.ts @@ -1,3 +1,4 @@ +// Comfy provider module implements model/runtime integration. import type { GeneratedImageAsset, ImageGenerationProvider, diff --git a/extensions/comfy/index.test.ts b/extensions/comfy/index.test.ts index 89af0191729..a2582ca4286 100644 --- a/extensions/comfy/index.test.ts +++ b/extensions/comfy/index.test.ts @@ -1,3 +1,4 @@ +// Comfy tests cover index plugin behavior. import fs from "node:fs"; import { registerSingleProviderPlugin, diff --git a/extensions/comfy/index.ts b/extensions/comfy/index.ts index ee9e49c1d58..1a1184f9b0e 100644 --- a/extensions/comfy/index.ts +++ b/extensions/comfy/index.ts @@ -1,3 +1,4 @@ +// Comfy plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { buildComfyImageGenerationProvider } from "./image-generation-provider.js"; diff --git a/extensions/comfy/music-generation-provider.test.ts b/extensions/comfy/music-generation-provider.test.ts index 8b5a0d18b28..102e7d8d079 100644 --- a/extensions/comfy/music-generation-provider.test.ts +++ b/extensions/comfy/music-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Comfy tests cover music generation provider plugin behavior. import { expectExplicitMusicGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts"; import { afterEach, describe, expect, it, vi } from "vitest"; import { buildComfyMusicGenerationProvider } from "./music-generation-provider.js"; diff --git a/extensions/comfy/music-generation-provider.ts b/extensions/comfy/music-generation-provider.ts index a582a90ed02..a5dcebfbe43 100644 --- a/extensions/comfy/music-generation-provider.ts +++ b/extensions/comfy/music-generation-provider.ts @@ -1,3 +1,4 @@ +// Comfy provider module implements model/runtime integration. import type { GeneratedMusicAsset, MusicGenerationProvider, diff --git a/extensions/comfy/test-helpers.ts b/extensions/comfy/test-helpers.ts index 3397923628c..deffe5a4ffc 100644 --- a/extensions/comfy/test-helpers.ts +++ b/extensions/comfy/test-helpers.ts @@ -1,3 +1,4 @@ +// Comfy helper module supports test helpers behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import * as providerAuth from "openclaw/plugin-sdk/provider-auth-runtime"; import { expect, vi } from "vitest"; diff --git a/extensions/comfy/video-generation-provider.test.ts b/extensions/comfy/video-generation-provider.test.ts index 2d47eef597f..1c6fdee5dc1 100644 --- a/extensions/comfy/video-generation-provider.test.ts +++ b/extensions/comfy/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Comfy tests cover video generation provider plugin behavior. import { expectExplicitVideoGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/comfy/video-generation-provider.ts b/extensions/comfy/video-generation-provider.ts index 8adf59dd044..23f1dc1271d 100644 --- a/extensions/comfy/video-generation-provider.ts +++ b/extensions/comfy/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Comfy provider module implements model/runtime integration. import type { GeneratedVideoAsset, VideoGenerationProvider, diff --git a/extensions/comfy/workflow-runtime.ts b/extensions/comfy/workflow-runtime.ts index aad0ae699df..ea9a65cab51 100644 --- a/extensions/comfy/workflow-runtime.ts +++ b/extensions/comfy/workflow-runtime.ts @@ -1,3 +1,4 @@ +// Comfy plugin module implements workflow runtime behavior. import fs from "node:fs/promises"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { canResolveEnvSecretRefInReadOnlyPath } from "openclaw/plugin-sdk/extension-shared"; diff --git a/extensions/copilot-proxy/index.ts b/extensions/copilot-proxy/index.ts index 7449c49e992..0f0f60b3734 100644 --- a/extensions/copilot-proxy/index.ts +++ b/extensions/copilot-proxy/index.ts @@ -1,3 +1,4 @@ +// Copilot Proxy plugin entrypoint registers its OpenClaw integration. import { normalizeStringEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime"; import { definePluginEntry, diff --git a/extensions/copilot-proxy/runtime-api.ts b/extensions/copilot-proxy/runtime-api.ts index 04c4c25f7d0..9d12a466e42 100644 --- a/extensions/copilot-proxy/runtime-api.ts +++ b/extensions/copilot-proxy/runtime-api.ts @@ -1,3 +1,4 @@ +// Copilot Proxy API module exposes the plugin public contract. export { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; export type { OpenClawPluginApi, diff --git a/extensions/deepgram/audio.live.test.ts b/extensions/deepgram/audio.live.test.ts index 11d7fd1f39b..92b0a5c0c73 100644 --- a/extensions/deepgram/audio.live.test.ts +++ b/extensions/deepgram/audio.live.test.ts @@ -1,3 +1,4 @@ +// Deepgram tests cover audio plugin behavior. import { runRealtimeSttLiveTest, synthesizeElevenLabsLiveSpeech, diff --git a/extensions/deepgram/audio.test.ts b/extensions/deepgram/audio.test.ts index 60ab395f776..edad94ba5d1 100644 --- a/extensions/deepgram/audio.test.ts +++ b/extensions/deepgram/audio.test.ts @@ -1,3 +1,4 @@ +// Deepgram tests cover audio plugin behavior. import { createAuthCaptureJsonFetch, createRequestCaptureJsonFetch, diff --git a/extensions/deepgram/audio.ts b/extensions/deepgram/audio.ts index a6ede9c2126..126beaa8330 100644 --- a/extensions/deepgram/audio.ts +++ b/extensions/deepgram/audio.ts @@ -1,3 +1,4 @@ +// Deepgram plugin module implements audio behavior. import type { AudioTranscriptionRequest, AudioTranscriptionResult, diff --git a/extensions/deepgram/index.ts b/extensions/deepgram/index.ts index 253715aea0b..302db2508eb 100644 --- a/extensions/deepgram/index.ts +++ b/extensions/deepgram/index.ts @@ -1,3 +1,4 @@ +// Deepgram plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { deepgramMediaUnderstandingProvider } from "./media-understanding-provider.js"; import { buildDeepgramRealtimeTranscriptionProvider } from "./realtime-transcription-provider.js"; diff --git a/extensions/deepgram/media-understanding-provider.ts b/extensions/deepgram/media-understanding-provider.ts index 144d059fac7..2b7e3f2cad7 100644 --- a/extensions/deepgram/media-understanding-provider.ts +++ b/extensions/deepgram/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Deepgram provider module implements model/runtime integration. import type { MediaUnderstandingProvider } from "openclaw/plugin-sdk/media-understanding"; import { transcribeDeepgramAudio } from "./audio.js"; diff --git a/extensions/deepgram/realtime-transcription-provider.test.ts b/extensions/deepgram/realtime-transcription-provider.test.ts index 7964a1f093c..5ef93b28cbc 100644 --- a/extensions/deepgram/realtime-transcription-provider.test.ts +++ b/extensions/deepgram/realtime-transcription-provider.test.ts @@ -1,3 +1,4 @@ +// Deepgram tests cover realtime transcription provider plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { afterEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/deepgram/realtime-transcription-provider.ts b/extensions/deepgram/realtime-transcription-provider.ts index 25b20ba963a..037b5d4b509 100644 --- a/extensions/deepgram/realtime-transcription-provider.ts +++ b/extensions/deepgram/realtime-transcription-provider.ts @@ -1,3 +1,4 @@ +// Deepgram provider module implements model/runtime integration. import { createRealtimeTranscriptionWebSocketSession, type RealtimeTranscriptionProviderConfig, diff --git a/extensions/deepgram/test-api.ts b/extensions/deepgram/test-api.ts index e9136c71743..1414debf70c 100644 --- a/extensions/deepgram/test-api.ts +++ b/extensions/deepgram/test-api.ts @@ -1,2 +1,3 @@ +// Deepgram API module exposes the plugin public contract. export { deepgramMediaUnderstandingProvider } from "./media-understanding-provider.js"; export { buildDeepgramRealtimeTranscriptionProvider } from "./realtime-transcription-provider.js"; diff --git a/extensions/deepinfra/api.ts b/extensions/deepinfra/api.ts index d55ae338790..e90565f8015 100644 --- a/extensions/deepinfra/api.ts +++ b/extensions/deepinfra/api.ts @@ -1,3 +1,4 @@ +// Deepinfra API module exposes the plugin public contract. export { buildDeepInfraProvider, buildStaticDeepInfraProvider } from "./provider-catalog.js"; export { applyDeepInfraConfig } from "./onboard.js"; export { DEEPINFRA_DEFAULT_MODEL_REF } from "./provider-models.js"; diff --git a/extensions/deepinfra/cache-wrapper.test.ts b/extensions/deepinfra/cache-wrapper.test.ts index 662f01f9fac..4e36e17f24e 100644 --- a/extensions/deepinfra/cache-wrapper.test.ts +++ b/extensions/deepinfra/cache-wrapper.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover cache wrapper plugin behavior. import { describe, expect, it } from "vitest"; import { createDeepInfraAnthropicCacheWrapper } from "./cache-wrapper.js"; diff --git a/extensions/deepinfra/cache-wrapper.ts b/extensions/deepinfra/cache-wrapper.ts index e7e136427b5..8322512e361 100644 --- a/extensions/deepinfra/cache-wrapper.ts +++ b/extensions/deepinfra/cache-wrapper.ts @@ -1,3 +1,4 @@ +// Deepinfra plugin module implements cache wrapper behavior. import { applyAnthropicEphemeralCacheControlMarkers, streamWithPayloadPatch, diff --git a/extensions/deepinfra/embedding-provider.ts b/extensions/deepinfra/embedding-provider.ts index dd71c272a2e..31b61ea90a5 100644 --- a/extensions/deepinfra/embedding-provider.ts +++ b/extensions/deepinfra/embedding-provider.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import { createRemoteEmbeddingProvider, resolveRemoteEmbeddingClient, diff --git a/extensions/deepinfra/image-generation-provider.test.ts b/extensions/deepinfra/image-generation-provider.test.ts index 841e0751fc0..245b90e47aa 100644 --- a/extensions/deepinfra/image-generation-provider.test.ts +++ b/extensions/deepinfra/image-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover image generation provider plugin behavior. import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; import { buildDeepInfraImageGenerationProvider } from "./image-generation-provider.js"; diff --git a/extensions/deepinfra/image-generation-provider.ts b/extensions/deepinfra/image-generation-provider.ts index b37b7b09563..38c9b38152b 100644 --- a/extensions/deepinfra/image-generation-provider.ts +++ b/extensions/deepinfra/image-generation-provider.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import { createOpenAiCompatibleImageGenerationProvider, imageSourceUploadFileName, @@ -21,9 +22,10 @@ const MAX_DEEPINFRA_INPUT_IMAGES = 1; export function buildDeepInfraImageGenerationProvider(options?: { imageGenModels?: readonly DeepInfraSurfaceModel[]; }): ImageGenerationProvider { - const ids = options?.imageGenModels && options.imageGenModels.length > 0 - ? options.imageGenModels.map((model) => model.id) - : [...DEEPINFRA_IMAGE_FALLBACK_MODELS]; + const ids = + options?.imageGenModels && options.imageGenModels.length > 0 + ? options.imageGenModels.map((model) => model.id) + : [...DEEPINFRA_IMAGE_FALLBACK_MODELS]; const defaultModel = ids[0] ?? DEEPINFRA_IMAGE_FALLBACK_MODELS[0]; return createOpenAiCompatibleImageGenerationProvider({ id: "deepinfra", diff --git a/extensions/deepinfra/index.test.ts b/extensions/deepinfra/index.test.ts index 660e5077526..208f39392d3 100644 --- a/extensions/deepinfra/index.test.ts +++ b/extensions/deepinfra/index.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover index plugin behavior. import { createCapturedPluginRegistration, registerSingleProviderPlugin, diff --git a/extensions/deepinfra/index.ts b/extensions/deepinfra/index.ts index 90a0bbe0987..074bad91935 100644 --- a/extensions/deepinfra/index.ts +++ b/extensions/deepinfra/index.ts @@ -1,3 +1,4 @@ +// Deepinfra plugin entrypoint registers its OpenClaw integration. import { type ProviderCatalogContext, type ConfiguredProviderCatalogEntry, diff --git a/extensions/deepinfra/media-models.ts b/extensions/deepinfra/media-models.ts index 05b592d4587..5b3e5f3020b 100644 --- a/extensions/deepinfra/media-models.ts +++ b/extensions/deepinfra/media-models.ts @@ -1,3 +1,4 @@ +// Deepinfra plugin module implements media models behavior. import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime"; import { DEEPINFRA_BASE_URL } from "./provider-models.js"; diff --git a/extensions/deepinfra/media-understanding-provider.test.ts b/extensions/deepinfra/media-understanding-provider.test.ts index 70420426d49..a6f4e552ea9 100644 --- a/extensions/deepinfra/media-understanding-provider.test.ts +++ b/extensions/deepinfra/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover media understanding provider plugin behavior. import { describeImagesWithModel, describeImageWithModel, diff --git a/extensions/deepinfra/media-understanding-provider.ts b/extensions/deepinfra/media-understanding-provider.ts index bbaab690de4..517804cc7ab 100644 --- a/extensions/deepinfra/media-understanding-provider.ts +++ b/extensions/deepinfra/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import { describeImageWithModel, describeImagesWithModel, diff --git a/extensions/deepinfra/memory-embedding-adapter.test.ts b/extensions/deepinfra/memory-embedding-adapter.test.ts index 6671d6f5010..1ed0ee7435e 100644 --- a/extensions/deepinfra/memory-embedding-adapter.test.ts +++ b/extensions/deepinfra/memory-embedding-adapter.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover memory embedding adapter plugin behavior. import { isMissingEmbeddingApiKeyError } from "openclaw/plugin-sdk/memory-core-host-engine-embeddings"; import { describe, expect, it } from "vitest"; import { DEFAULT_DEEPINFRA_EMBEDDING_MODEL } from "./embedding-provider.js"; diff --git a/extensions/deepinfra/memory-embedding-adapter.ts b/extensions/deepinfra/memory-embedding-adapter.ts index 727f7a81810..6121f6efc78 100644 --- a/extensions/deepinfra/memory-embedding-adapter.ts +++ b/extensions/deepinfra/memory-embedding-adapter.ts @@ -1,3 +1,4 @@ +// Deepinfra plugin module implements memory embedding adapter behavior. import { isMissingEmbeddingApiKeyError, type MemoryEmbeddingProviderAdapter, diff --git a/extensions/deepinfra/onboard.test.ts b/extensions/deepinfra/onboard.test.ts index 2f4a8080657..1e1765bd5ac 100644 --- a/extensions/deepinfra/onboard.test.ts +++ b/extensions/deepinfra/onboard.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover onboard plugin behavior. import { mkdtempSync } from "node:fs"; import { tmpdir } from "node:os"; import { join } from "node:path"; diff --git a/extensions/deepinfra/onboard.ts b/extensions/deepinfra/onboard.ts index d823b8352c1..5a3d48e226f 100644 --- a/extensions/deepinfra/onboard.ts +++ b/extensions/deepinfra/onboard.ts @@ -1,3 +1,4 @@ +// Deepinfra setup module handles plugin onboarding behavior. import { applyAgentDefaultModelPrimary, type OpenClawConfig, diff --git a/extensions/deepinfra/provider-catalog.ts b/extensions/deepinfra/provider-catalog.ts index 5b5be3f5647..4cb9e1e9e19 100644 --- a/extensions/deepinfra/provider-catalog.ts +++ b/extensions/deepinfra/provider-catalog.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import { buildSingleProviderApiKeyCatalog, type ProviderCatalogContext, diff --git a/extensions/deepinfra/provider-discovery.ts b/extensions/deepinfra/provider-discovery.ts index bdcd77f216c..1a6e9c5b264 100644 --- a/extensions/deepinfra/provider-discovery.ts +++ b/extensions/deepinfra/provider-discovery.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import type { ProviderCatalogContext } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; import { buildDeepInfraApiKeyCatalog, buildStaticDeepInfraProvider } from "./provider-catalog.js"; diff --git a/extensions/deepinfra/provider-models.test.ts b/extensions/deepinfra/provider-models.test.ts index 62a61977c86..027a35b8bde 100644 --- a/extensions/deepinfra/provider-models.test.ts +++ b/extensions/deepinfra/provider-models.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover provider models plugin behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; const isProviderApiKeyConfiguredMock = vi.hoisted(() => vi.fn<(p: unknown) => boolean>()); diff --git a/extensions/deepinfra/provider-models.ts b/extensions/deepinfra/provider-models.ts index d0dbc791571..1358aa5e6ec 100644 --- a/extensions/deepinfra/provider-models.ts +++ b/extensions/deepinfra/provider-models.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import { fetchWithTimeout } from "openclaw/plugin-sdk/provider-http"; diff --git a/extensions/deepinfra/provider-policy-api.test.ts b/extensions/deepinfra/provider-policy-api.test.ts index bb3821b085e..356e04039ff 100644 --- a/extensions/deepinfra/provider-policy-api.test.ts +++ b/extensions/deepinfra/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover provider policy api plugin behavior. import type { ModelDefinitionConfig, ModelProviderConfig, diff --git a/extensions/deepinfra/provider-policy-api.ts b/extensions/deepinfra/provider-policy-api.ts index cdf31482173..5deb6d4e9b8 100644 --- a/extensions/deepinfra/provider-policy-api.ts +++ b/extensions/deepinfra/provider-policy-api.ts @@ -1,3 +1,4 @@ +// Deepinfra API module exposes the plugin public contract. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-types"; /** diff --git a/extensions/deepinfra/provider.contract.test.ts b/extensions/deepinfra/provider.contract.test.ts index 7b2a61a8124..6bdba108836 100644 --- a/extensions/deepinfra/provider.contract.test.ts +++ b/extensions/deepinfra/provider.contract.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover provider.contract plugin behavior. import { describeProviderContracts } from "openclaw/plugin-sdk/provider-test-contracts"; describeProviderContracts("deepinfra"); diff --git a/extensions/deepinfra/speech-provider.test.ts b/extensions/deepinfra/speech-provider.test.ts index de208834ae2..b26b32168e1 100644 --- a/extensions/deepinfra/speech-provider.test.ts +++ b/extensions/deepinfra/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover speech provider plugin behavior. import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; import { buildDeepInfraSpeechProvider } from "./speech-provider.js"; @@ -7,18 +8,18 @@ const { readProviderBinaryResponseMock, resolveProviderHttpRequestConfigMock, } = vi.hoisted(() => ({ - assertOkOrThrowHttpErrorMock: vi.fn(async () => {}), - postJsonRequestMock: vi.fn(), - readProviderBinaryResponseMock: vi.fn(async (response: Response) => { - return new Uint8Array(await response.arrayBuffer()); - }), - resolveProviderHttpRequestConfigMock: vi.fn((params: Record) => ({ - baseUrl: params.baseUrl ?? params.defaultBaseUrl ?? "https://api.deepinfra.com/v1/openai", - allowPrivateNetwork: false, - headers: new Headers(params.defaultHeaders as HeadersInit | undefined), - dispatcherPolicy: undefined, - })), - })); + assertOkOrThrowHttpErrorMock: vi.fn(async () => {}), + postJsonRequestMock: vi.fn(), + readProviderBinaryResponseMock: vi.fn(async (response: Response) => { + return new Uint8Array(await response.arrayBuffer()); + }), + resolveProviderHttpRequestConfigMock: vi.fn((params: Record) => ({ + baseUrl: params.baseUrl ?? params.defaultBaseUrl ?? "https://api.deepinfra.com/v1/openai", + allowPrivateNetwork: false, + headers: new Headers(params.defaultHeaders as HeadersInit | undefined), + dispatcherPolicy: undefined, + })), +})); vi.mock("openclaw/plugin-sdk/provider-http", () => ({ assertOkOrThrowHttpError: assertOkOrThrowHttpErrorMock, diff --git a/extensions/deepinfra/speech-provider.ts b/extensions/deepinfra/speech-provider.ts index b024b7795f0..22d0522dd00 100644 --- a/extensions/deepinfra/speech-provider.ts +++ b/extensions/deepinfra/speech-provider.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import { asObject, createOpenAiCompatibleSpeechProvider, @@ -21,9 +22,10 @@ type DeepInfraTtsExtraConfig = { export function buildDeepInfraSpeechProvider(options?: { ttsModels?: readonly DeepInfraSurfaceModel[]; }): SpeechProviderPlugin { - const ids = options?.ttsModels && options.ttsModels.length > 0 - ? options.ttsModels.map((model) => model.id) - : [...DEEPINFRA_TTS_FALLBACK_MODELS]; + const ids = + options?.ttsModels && options.ttsModels.length > 0 + ? options.ttsModels.map((model) => model.id) + : [...DEEPINFRA_TTS_FALLBACK_MODELS]; const defaultModel = ids[0] ?? DEEPINFRA_TTS_FALLBACK_MODELS[0]; return createOpenAiCompatibleSpeechProvider({ id: "deepinfra", diff --git a/extensions/deepinfra/surface-model-catalogs.test.ts b/extensions/deepinfra/surface-model-catalogs.test.ts index c40a982164a..0b3ba198e9c 100644 --- a/extensions/deepinfra/surface-model-catalogs.test.ts +++ b/extensions/deepinfra/surface-model-catalogs.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover surface model catalogs plugin behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { resetDeepInfraModelCacheForTest } from "./provider-models.js"; import { diff --git a/extensions/deepinfra/surface-model-catalogs.ts b/extensions/deepinfra/surface-model-catalogs.ts index 7b65a932941..4ed788009fe 100644 --- a/extensions/deepinfra/surface-model-catalogs.ts +++ b/extensions/deepinfra/surface-model-catalogs.ts @@ -1,3 +1,4 @@ +// Deepinfra plugin module implements surface model catalogs behavior. import type { UnifiedModelCatalogEntry, UnifiedModelCatalogProviderContext, @@ -6,14 +7,8 @@ import type { VideoGenerationModelCapabilitiesContext, VideoGenerationProviderCapabilities, } from "openclaw/plugin-sdk/video-generation"; -import { - DEEPINFRA_VIDEO_ASPECT_RATIOS, - DEEPINFRA_VIDEO_DURATIONS, -} from "./media-models.js"; -import { - discoverDeepInfraSurfaces, - type DeepInfraSurfaceModel, -} from "./provider-models.js"; +import { DEEPINFRA_VIDEO_ASPECT_RATIOS, DEEPINFRA_VIDEO_DURATIONS } from "./media-models.js"; +import { discoverDeepInfraSurfaces, type DeepInfraSurfaceModel } from "./provider-models.js"; const PROVIDER_ID = "deepinfra"; @@ -22,9 +17,7 @@ const PROVIDER_ID = "deepinfra"; // null without a key so the static fallback wins), and reuses the cached // discoverDeepInfraSurfaces call so chat/image-gen/video-gen share one fetch. -function surfaceModelToImageGenEntry( - model: DeepInfraSurfaceModel, -): UnifiedModelCatalogEntry { +function surfaceModelToImageGenEntry(model: DeepInfraSurfaceModel): UnifiedModelCatalogEntry { return { kind: "image_generation", provider: PROVIDER_ID, diff --git a/extensions/deepinfra/video-generation-provider.test.ts b/extensions/deepinfra/video-generation-provider.test.ts index 72a8f4c571d..fab8829832e 100644 --- a/extensions/deepinfra/video-generation-provider.test.ts +++ b/extensions/deepinfra/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Deepinfra tests cover video generation provider plugin behavior. import { getProviderHttpMocks, installProviderHttpMockCleanup, diff --git a/extensions/deepinfra/video-generation-provider.ts b/extensions/deepinfra/video-generation-provider.ts index b4d067987b5..b1826625a6c 100644 --- a/extensions/deepinfra/video-generation-provider.ts +++ b/extensions/deepinfra/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Deepinfra provider module implements model/runtime integration. import { extensionForMime } from "openclaw/plugin-sdk/media-mime"; import { canonicalizeBase64 } from "openclaw/plugin-sdk/media-runtime"; import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; diff --git a/extensions/deepseek/api.ts b/extensions/deepseek/api.ts index 9a61dc77e27..6154b8f3e7b 100644 --- a/extensions/deepseek/api.ts +++ b/extensions/deepseek/api.ts @@ -1,3 +1,4 @@ +// Deepseek API module exposes the plugin public contract. export { buildDeepSeekModelDefinition, DEEPSEEK_BASE_URL, diff --git a/extensions/deepseek/deepseek.live.test.ts b/extensions/deepseek/deepseek.live.test.ts index 0f57bb50d5c..925c3812efe 100644 --- a/extensions/deepseek/deepseek.live.test.ts +++ b/extensions/deepseek/deepseek.live.test.ts @@ -1,3 +1,4 @@ +// Deepseek tests cover deepseek plugin behavior. import { completeSimple, streamSimple, diff --git a/extensions/deepseek/index.test.ts b/extensions/deepseek/index.test.ts index 6711f0ca917..533b927f4e2 100644 --- a/extensions/deepseek/index.test.ts +++ b/extensions/deepseek/index.test.ts @@ -1,3 +1,4 @@ +// Deepseek tests cover index plugin behavior. import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { createAssistantMessageEventStream } from "openclaw/plugin-sdk/llm"; import { diff --git a/extensions/deepseek/index.ts b/extensions/deepseek/index.ts index 04d11dc44a8..e26c4f182e8 100644 --- a/extensions/deepseek/index.ts +++ b/extensions/deepseek/index.ts @@ -1,3 +1,4 @@ +// Deepseek plugin entrypoint registers its OpenClaw integration. import { readConfiguredProviderCatalogEntries } from "openclaw/plugin-sdk/provider-catalog-shared"; import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/deepseek/models.ts b/extensions/deepseek/models.ts index 73140d79731..ed987fa7104 100644 --- a/extensions/deepseek/models.ts +++ b/extensions/deepseek/models.ts @@ -1,3 +1,4 @@ +// Deepseek plugin module implements models behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/deepseek/onboard.ts b/extensions/deepseek/onboard.ts index 897d1d1065c..12f0bf3a09a 100644 --- a/extensions/deepseek/onboard.ts +++ b/extensions/deepseek/onboard.ts @@ -1,3 +1,4 @@ +// Deepseek setup module handles plugin onboarding behavior. import { applyAgentDefaultModelPrimary, applyProviderConfigWithModelCatalog, diff --git a/extensions/deepseek/provider-catalog.ts b/extensions/deepseek/provider-catalog.ts index 2a0b7313bb1..afdff7887fb 100644 --- a/extensions/deepseek/provider-catalog.ts +++ b/extensions/deepseek/provider-catalog.ts @@ -1,3 +1,4 @@ +// Deepseek provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { buildDeepSeekModelDefinition, diff --git a/extensions/deepseek/provider-discovery.ts b/extensions/deepseek/provider-discovery.ts index cc00e65de85..02b63085097 100644 --- a/extensions/deepseek/provider-discovery.ts +++ b/extensions/deepseek/provider-discovery.ts @@ -1,3 +1,4 @@ +// Deepseek provider module implements model/runtime integration. import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; import { buildDeepSeekProvider } from "./provider-catalog.js"; diff --git a/extensions/deepseek/provider-policy-api.test.ts b/extensions/deepseek/provider-policy-api.test.ts index ddaca54bee6..fdbe4fd9e1e 100644 --- a/extensions/deepseek/provider-policy-api.test.ts +++ b/extensions/deepseek/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Deepseek tests cover provider policy api plugin behavior. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-types"; import { describe, expect, it } from "vitest"; import { normalizeConfig, resolveThinkingProfile } from "./provider-policy-api.js"; diff --git a/extensions/deepseek/provider-policy-api.ts b/extensions/deepseek/provider-policy-api.ts index f87c2e06be4..45c897231c1 100644 --- a/extensions/deepseek/provider-policy-api.ts +++ b/extensions/deepseek/provider-policy-api.ts @@ -1,3 +1,4 @@ +// Deepseek API module exposes the plugin public contract. import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-types"; import { DEEPSEEK_MODEL_CATALOG } from "./models.js"; diff --git a/extensions/deepseek/stream.ts b/extensions/deepseek/stream.ts index 6ae1c143358..be67c513620 100644 --- a/extensions/deepseek/stream.ts +++ b/extensions/deepseek/stream.ts @@ -1,3 +1,4 @@ +// Deepseek plugin module implements stream behavior. import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { createDeepSeekV4OpenAICompatibleThinkingWrapper } from "openclaw/plugin-sdk/provider-stream-shared"; import { isDeepSeekV4ModelRef } from "./models.js"; diff --git a/extensions/deepseek/thinking.ts b/extensions/deepseek/thinking.ts index 66906e6877c..f1ada4f5ce1 100644 --- a/extensions/deepseek/thinking.ts +++ b/extensions/deepseek/thinking.ts @@ -1,3 +1,4 @@ +// Deepseek plugin module implements thinking behavior. import type { ProviderThinkingProfile } from "openclaw/plugin-sdk/plugin-entry"; import { isDeepSeekV4ModelId } from "./models.js"; diff --git a/extensions/device-pair/api.ts b/extensions/device-pair/api.ts index 2ec7be950d4..7f32f67374a 100644 --- a/extensions/device-pair/api.ts +++ b/extensions/device-pair/api.ts @@ -1,3 +1,4 @@ +// Device Pair API module exposes the plugin public contract. export { approveDevicePairing, clearDeviceBootstrapTokens, diff --git a/extensions/device-pair/index.test.ts b/extensions/device-pair/index.test.ts index 1f5f2fba6d4..1ce1b9fb24c 100644 --- a/extensions/device-pair/index.test.ts +++ b/extensions/device-pair/index.test.ts @@ -1,3 +1,4 @@ +// Device Pair tests cover index plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/device-pair/index.ts b/extensions/device-pair/index.ts index eb36a766070..87412a695db 100644 --- a/extensions/device-pair/index.ts +++ b/extensions/device-pair/index.ts @@ -1,3 +1,4 @@ +// Device Pair plugin entrypoint registers its OpenClaw integration. import { rm } from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/device-pair/notify.test.ts b/extensions/device-pair/notify.test.ts index fa548fe6f9a..2a674713888 100644 --- a/extensions/device-pair/notify.test.ts +++ b/extensions/device-pair/notify.test.ts @@ -1,3 +1,4 @@ +// Device Pair tests cover notify plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/device-pair/notify.ts b/extensions/device-pair/notify.ts index 83d6be3c39c..54ca3781720 100644 --- a/extensions/device-pair/notify.ts +++ b/extensions/device-pair/notify.ts @@ -1,3 +1,4 @@ +// Device Pair plugin module implements notify behavior. import { promises as fs } from "node:fs"; import path from "node:path"; import type { OpenClawPluginService } from "openclaw/plugin-sdk/core"; diff --git a/extensions/device-pair/pair-command-approve.ts b/extensions/device-pair/pair-command-approve.ts index 6312b10a5cf..cd5018de949 100644 --- a/extensions/device-pair/pair-command-approve.ts +++ b/extensions/device-pair/pair-command-approve.ts @@ -1,3 +1,4 @@ +// Device Pair plugin module implements pair command approve behavior. import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, diff --git a/extensions/device-pair/pair-command-auth.test.ts b/extensions/device-pair/pair-command-auth.test.ts index 00295a2e125..402baf3ea30 100644 --- a/extensions/device-pair/pair-command-auth.test.ts +++ b/extensions/device-pair/pair-command-auth.test.ts @@ -1,3 +1,4 @@ +// Device Pair tests cover pair command auth plugin behavior. import { describe, expect, it } from "vitest"; import { resolvePairingCommandAuthState } from "./pair-command-auth.js"; diff --git a/extensions/device-pair/pair-command-auth.ts b/extensions/device-pair/pair-command-auth.ts index 21235fe6336..c053e6d9daf 100644 --- a/extensions/device-pair/pair-command-auth.ts +++ b/extensions/device-pair/pair-command-auth.ts @@ -1,3 +1,4 @@ +// Device Pair plugin module implements pair command auth behavior. type PairingCommandAuthParams = { channel: string; gatewayClientScopes?: readonly string[] | null; diff --git a/extensions/device-pair/qr-image.ts b/extensions/device-pair/qr-image.ts index 13914efca68..80ce085b0e9 100644 --- a/extensions/device-pair/qr-image.ts +++ b/extensions/device-pair/qr-image.ts @@ -1,3 +1,4 @@ +// Device Pair plugin module implements qr image behavior. export { renderQrPngBase64, renderQrPngDataUrl, diff --git a/extensions/diagnostics-otel/api.ts b/extensions/diagnostics-otel/api.ts index d06167958bc..1cd18e8d9f6 100644 --- a/extensions/diagnostics-otel/api.ts +++ b/extensions/diagnostics-otel/api.ts @@ -1,3 +1,4 @@ +// Diagnostics Otel API module exposes the plugin public contract. export { createChildDiagnosticTraceContext, createDiagnosticTraceContext, diff --git a/extensions/diagnostics-otel/index.ts b/extensions/diagnostics-otel/index.ts index b190269e2e1..7d00000de24 100644 --- a/extensions/diagnostics-otel/index.ts +++ b/extensions/diagnostics-otel/index.ts @@ -1,3 +1,4 @@ +// Diagnostics Otel plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createDiagnosticsOtelService } from "./src/service.js"; diff --git a/extensions/diagnostics-otel/src/service.test.ts b/extensions/diagnostics-otel/src/service.test.ts index e427a6d3b5c..06ebf7197a1 100644 --- a/extensions/diagnostics-otel/src/service.test.ts +++ b/extensions/diagnostics-otel/src/service.test.ts @@ -1,3 +1,4 @@ +// Diagnostics Otel tests cover service plugin behavior. import { afterAll, afterEach, beforeEach, describe, expect, test, vi } from "vitest"; const telemetryState = vi.hoisted(() => { diff --git a/extensions/diagnostics-otel/src/service.ts b/extensions/diagnostics-otel/src/service.ts index 4fac83490ac..679f9cc0beb 100644 --- a/extensions/diagnostics-otel/src/service.ts +++ b/extensions/diagnostics-otel/src/service.ts @@ -1,3 +1,4 @@ +// Diagnostics Otel plugin module implements service behavior. import { context as otelContextApi, metrics, diff --git a/extensions/diagnostics-prometheus/api.ts b/extensions/diagnostics-prometheus/api.ts index 90486748129..e9023f42573 100644 --- a/extensions/diagnostics-prometheus/api.ts +++ b/extensions/diagnostics-prometheus/api.ts @@ -1,3 +1,4 @@ +// Diagnostics Prometheus API module exposes the plugin public contract. export type { DiagnosticEventMetadata, DiagnosticEventPayload, diff --git a/extensions/diagnostics-prometheus/index.ts b/extensions/diagnostics-prometheus/index.ts index 70a13101747..aadc11efdae 100644 --- a/extensions/diagnostics-prometheus/index.ts +++ b/extensions/diagnostics-prometheus/index.ts @@ -1,3 +1,4 @@ +// Diagnostics Prometheus plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createDiagnosticsPrometheusExporter } from "./src/service.js"; diff --git a/extensions/diagnostics-prometheus/src/service.test.ts b/extensions/diagnostics-prometheus/src/service.test.ts index 28ffd42f25e..3ca270ef173 100644 --- a/extensions/diagnostics-prometheus/src/service.test.ts +++ b/extensions/diagnostics-prometheus/src/service.test.ts @@ -1,5 +1,6 @@ -import { describe, expect, it, vi } from "vitest"; import type { DiagnosticEventPrivateData } from "openclaw/plugin-sdk/diagnostic-runtime"; +// Diagnostics Prometheus tests cover service plugin behavior. +import { describe, expect, it, vi } from "vitest"; import type { DiagnosticEventMetadata, DiagnosticEventPayload } from "../api.js"; import { createDiagnosticsPrometheusExporter, testApi } from "./service.js"; @@ -328,9 +329,7 @@ describe("diagnostics-prometheus service", () => { expect(rendered).toContain( 'openclaw_webhook_duration_seconds_sum{channel="telegram",webhook="message"} 0.25', ); - expect(rendered).toContain( - 'openclaw_liveness_warning_total{reason="event_loop_delay:cpu"} 1', - ); + expect(rendered).toContain('openclaw_liveness_warning_total{reason="event_loop_delay:cpu"} 1'); expect(rendered).toContain('openclaw_liveness_sessions{state="active"} 2'); expect(rendered).toContain( 'openclaw_liveness_event_loop_delay_p99_seconds_sum{reason="event_loop_delay:cpu"} 0.25', diff --git a/extensions/diagnostics-prometheus/src/service.ts b/extensions/diagnostics-prometheus/src/service.ts index 710e1430079..e9eeb919388 100644 --- a/extensions/diagnostics-prometheus/src/service.ts +++ b/extensions/diagnostics-prometheus/src/service.ts @@ -1,3 +1,4 @@ +// Diagnostics Prometheus plugin module implements service behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import type { DiagnosticEventMetadata, diff --git a/extensions/diffs-language-pack/api.ts b/extensions/diffs-language-pack/api.ts index 51844dd73f7..be728719487 100644 --- a/extensions/diffs-language-pack/api.ts +++ b/extensions/diffs-language-pack/api.ts @@ -1,3 +1,4 @@ +// Diffs Language Pack API module exposes the plugin public contract. export { definePluginEntry, type OpenClawPluginApi, diff --git a/extensions/diffs-language-pack/index.ts b/extensions/diffs-language-pack/index.ts index 517d6182801..a35090a5695 100644 --- a/extensions/diffs-language-pack/index.ts +++ b/extensions/diffs-language-pack/index.ts @@ -1,3 +1,4 @@ +// Diffs Language Pack plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "./api.js"; import { registerDiffsLanguagePackPlugin } from "./src/plugin.js"; diff --git a/extensions/diffs-language-pack/src/plugin.ts b/extensions/diffs-language-pack/src/plugin.ts index f8b02246203..c3405b54640 100644 --- a/extensions/diffs-language-pack/src/plugin.ts +++ b/extensions/diffs-language-pack/src/plugin.ts @@ -1,3 +1,4 @@ +// Diffs Language Pack plugin module implements plugin behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import type { OpenClawPluginApi } from "../api.js"; import { VIEWER_ASSET_PREFIX, getServedViewerAsset } from "./viewer-assets.js"; diff --git a/extensions/diffs-language-pack/src/viewer-assets.ts b/extensions/diffs-language-pack/src/viewer-assets.ts index 9b11f8b99b9..03cda46006a 100644 --- a/extensions/diffs-language-pack/src/viewer-assets.ts +++ b/extensions/diffs-language-pack/src/viewer-assets.ts @@ -1,3 +1,4 @@ +// Diffs Language Pack plugin module implements viewer assets behavior. import crypto from "node:crypto"; import fs from "node:fs/promises"; import { fileURLToPath } from "node:url"; diff --git a/extensions/diffs/api.ts b/extensions/diffs/api.ts index d83d679f3ba..c14b245c84e 100644 --- a/extensions/diffs/api.ts +++ b/extensions/diffs/api.ts @@ -1,3 +1,4 @@ +// Diffs API module exposes the plugin public contract. export type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; export { definePluginEntry, diff --git a/extensions/diffs/index.ts b/extensions/diffs/index.ts index eb28fc00387..e73c5183ea5 100644 --- a/extensions/diffs/index.ts +++ b/extensions/diffs/index.ts @@ -1,3 +1,4 @@ +// Diffs plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "./api.js"; import { diffsPluginConfigSchema } from "./src/config.js"; import { registerDiffsPlugin } from "./src/plugin.js"; diff --git a/extensions/diffs/runtime-api.ts b/extensions/diffs/runtime-api.ts index 2f401c6b004..f4e8be614bf 100644 --- a/extensions/diffs/runtime-api.ts +++ b/extensions/diffs/runtime-api.ts @@ -1 +1,2 @@ +// Diffs API module exposes the plugin public contract. export { resolveRequestClientIp } from "openclaw/plugin-sdk/webhook-ingress"; diff --git a/extensions/diffs/src/browser.test.ts b/extensions/diffs/src/browser.test.ts index a4183ac21b8..ba1d9534728 100644 --- a/extensions/diffs/src/browser.test.ts +++ b/extensions/diffs/src/browser.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover browser plugin behavior. import fs from "node:fs/promises"; import type { IncomingMessage, ServerResponse } from "node:http"; import path from "node:path"; diff --git a/extensions/diffs/src/browser.ts b/extensions/diffs/src/browser.ts index e1e0b557baf..b04a75d5724 100644 --- a/extensions/diffs/src/browser.ts +++ b/extensions/diffs/src/browser.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements browser behavior. import { constants as fsConstants } from "node:fs"; import fs from "node:fs/promises"; import path from "node:path"; diff --git a/extensions/diffs/src/config.test.ts b/extensions/diffs/src/config.test.ts index 3d78342738c..a9a756a5ed9 100644 --- a/extensions/diffs/src/config.test.ts +++ b/extensions/diffs/src/config.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover config plugin behavior. import fs from "node:fs"; import os from "node:os"; import { join } from "node:path"; diff --git a/extensions/diffs/src/config.ts b/extensions/diffs/src/config.ts index bb61e05bd73..0b0efec768a 100644 --- a/extensions/diffs/src/config.ts +++ b/extensions/diffs/src/config.ts @@ -1,3 +1,4 @@ +// Diffs helper module supports config behavior. import { mapPluginConfigIssues } from "openclaw/plugin-sdk/extension-shared"; import { buildPluginConfigSchema } from "openclaw/plugin-sdk/plugin-entry"; import { z } from "zod"; diff --git a/extensions/diffs/src/http.ts b/extensions/diffs/src/http.ts index 028cbc7594c..620a8d05702 100644 --- a/extensions/diffs/src/http.ts +++ b/extensions/diffs/src/http.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements http behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime"; import type { PluginLogger } from "../api.js"; diff --git a/extensions/diffs/src/language-hints.test.ts b/extensions/diffs/src/language-hints.test.ts index 82cd9eeed1f..cdb50d0a091 100644 --- a/extensions/diffs/src/language-hints.test.ts +++ b/extensions/diffs/src/language-hints.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover language hints plugin behavior. import type { FileDiffMetadata } from "@pierre/diffs"; import { describe, expect, it } from "vitest"; import { diff --git a/extensions/diffs/src/language-hints.ts b/extensions/diffs/src/language-hints.ts index 42fafd029de..bea1ff0ca0f 100644 --- a/extensions/diffs/src/language-hints.ts +++ b/extensions/diffs/src/language-hints.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements language hints behavior. import { resolveLanguage } from "@pierre/diffs"; import type { FileContents, FileDiffMetadata, SupportedLanguages } from "@pierre/diffs"; import { diff --git a/extensions/diffs/src/manifest.test.ts b/extensions/diffs/src/manifest.test.ts index 8cd1b4a3645..05a3f477e4c 100644 --- a/extensions/diffs/src/manifest.test.ts +++ b/extensions/diffs/src/manifest.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover manifest plugin behavior. import fs from "node:fs"; import { describe, expect, it } from "vitest"; diff --git a/extensions/diffs/src/pierre-themes.ts b/extensions/diffs/src/pierre-themes.ts index ba6dc5c790a..6515dd1da62 100644 --- a/extensions/diffs/src/pierre-themes.ts +++ b/extensions/diffs/src/pierre-themes.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements pierre themes behavior. import { createRequire } from "node:module"; import type { ThemeRegistrationResolved } from "@pierre/diffs"; import { RegisteredCustomThemes, ResolvedThemes, ResolvingThemes } from "@pierre/diffs"; diff --git a/extensions/diffs/src/plugin.ts b/extensions/diffs/src/plugin.ts index 95201a6448c..d95db34b342 100644 --- a/extensions/diffs/src/plugin.ts +++ b/extensions/diffs/src/plugin.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements plugin behavior. import fs from "node:fs"; import path from "node:path"; import { resolveLivePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime"; diff --git a/extensions/diffs/src/prompt-guidance.ts b/extensions/diffs/src/prompt-guidance.ts index 37cbd501261..6e9e3415da5 100644 --- a/extensions/diffs/src/prompt-guidance.ts +++ b/extensions/diffs/src/prompt-guidance.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements prompt guidance behavior. export const DIFFS_AGENT_GUIDANCE = [ "When you need to show edits as a real diff, prefer the `diffs` tool instead of writing a manual summary.", "It accepts either `before` + `after` text or a unified `patch`.", diff --git a/extensions/diffs/src/render-target.test.ts b/extensions/diffs/src/render-target.test.ts index 3a4991c1e87..4e13fc7774d 100644 --- a/extensions/diffs/src/render-target.test.ts +++ b/extensions/diffs/src/render-target.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover render target plugin behavior. import { afterAll, beforeEach, describe, expect, it, vi } from "vitest"; const { preloadFileDiffMock, preloadMultiFileDiffMock } = vi.hoisted(() => ({ diff --git a/extensions/diffs/src/render.test.ts b/extensions/diffs/src/render.test.ts index 6e00ca88f0c..29eae55ee14 100644 --- a/extensions/diffs/src/render.test.ts +++ b/extensions/diffs/src/render.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover render plugin behavior. import { disposeHighlighter, RegisteredCustomThemes, diff --git a/extensions/diffs/src/render.ts b/extensions/diffs/src/render.ts index ce0020e3c28..db9b59fac93 100644 --- a/extensions/diffs/src/render.ts +++ b/extensions/diffs/src/render.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements render behavior. import type { FileContents, FileDiffMetadata, SupportedLanguages } from "@pierre/diffs"; import { parsePatchFiles } from "@pierre/diffs"; import { preloadFileDiff, preloadMultiFileDiff } from "@pierre/diffs/ssr"; diff --git a/extensions/diffs/src/shiki-curated-languages.ts b/extensions/diffs/src/shiki-curated-languages.ts index 198edbd43a1..065861a4a0a 100644 --- a/extensions/diffs/src/shiki-curated-languages.ts +++ b/extensions/diffs/src/shiki-curated-languages.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements shiki curated languages behavior. const javascript = () => import("@shikijs/langs/javascript"); const typescript = () => import("@shikijs/langs/typescript"); const tsx = () => import("@shikijs/langs/tsx"); diff --git a/extensions/diffs/src/store.test.ts b/extensions/diffs/src/store.test.ts index ba626768d54..87ee6478cec 100644 --- a/extensions/diffs/src/store.test.ts +++ b/extensions/diffs/src/store.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover store plugin behavior. import fs from "node:fs/promises"; import type { IncomingMessage } from "node:http"; import path from "node:path"; diff --git a/extensions/diffs/src/store.ts b/extensions/diffs/src/store.ts index 7f02128b62a..b6e7b95760f 100644 --- a/extensions/diffs/src/store.ts +++ b/extensions/diffs/src/store.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements store behavior. import crypto from "node:crypto"; import fs from "node:fs/promises"; import path from "node:path"; diff --git a/extensions/diffs/src/test-helpers.ts b/extensions/diffs/src/test-helpers.ts index 4f3ea65fc08..dbfa3fd763b 100644 --- a/extensions/diffs/src/test-helpers.ts +++ b/extensions/diffs/src/test-helpers.ts @@ -1,3 +1,4 @@ +// Diffs helper module supports test helpers behavior. import { execFile } from "node:child_process"; import fs from "node:fs/promises"; import path from "node:path"; diff --git a/extensions/diffs/src/tool-render-output.test.ts b/extensions/diffs/src/tool-render-output.test.ts index 33edfda98c5..6b5d588cdb6 100644 --- a/extensions/diffs/src/tool-render-output.test.ts +++ b/extensions/diffs/src/tool-render-output.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover tool render output plugin behavior. import fs from "node:fs/promises"; import path from "node:path"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; diff --git a/extensions/diffs/src/tool.test.ts b/extensions/diffs/src/tool.test.ts index c566c01380b..b8805776173 100644 --- a/extensions/diffs/src/tool.test.ts +++ b/extensions/diffs/src/tool.test.ts @@ -1,3 +1,4 @@ +// Diffs tests cover tool plugin behavior. import fs from "node:fs/promises"; import path from "node:path"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; diff --git a/extensions/diffs/src/tool.ts b/extensions/diffs/src/tool.ts index 1d341bef70a..42918a3f414 100644 --- a/extensions/diffs/src/tool.ts +++ b/extensions/diffs/src/tool.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements tool behavior. import fs from "node:fs/promises"; import { optionalFiniteNumberSchema, stringEnum } from "openclaw/plugin-sdk/channel-actions"; import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; diff --git a/extensions/diffs/src/types.ts b/extensions/diffs/src/types.ts index d217629d959..98b72158b7d 100644 --- a/extensions/diffs/src/types.ts +++ b/extensions/diffs/src/types.ts @@ -1,3 +1,4 @@ +// Diffs type declarations define plugin contracts. import type { FileContents, FileDiffMetadata, SupportedLanguages } from "@pierre/diffs"; export const DIFF_LAYOUTS = ["unified", "split"] as const; diff --git a/extensions/diffs/src/url.ts b/extensions/diffs/src/url.ts index 5b3e29b20ff..c842ebb33c6 100644 --- a/extensions/diffs/src/url.ts +++ b/extensions/diffs/src/url.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements url behavior. import type { OpenClawConfig } from "../api.js"; const DEFAULT_GATEWAY_PORT = 18789; diff --git a/extensions/diffs/src/viewer-assets.ts b/extensions/diffs/src/viewer-assets.ts index 36befa12dcf..387952ae5b2 100644 --- a/extensions/diffs/src/viewer-assets.ts +++ b/extensions/diffs/src/viewer-assets.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements viewer assets behavior. import crypto from "node:crypto"; import fs from "node:fs/promises"; import { fileURLToPath } from "node:url"; diff --git a/extensions/diffs/src/viewer-client.ts b/extensions/diffs/src/viewer-client.ts index 17f4096b0df..789f7e2d4b8 100644 --- a/extensions/diffs/src/viewer-client.ts +++ b/extensions/diffs/src/viewer-client.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements viewer client behavior. import { FileDiff, preloadHighlighter } from "@pierre/diffs"; import type { FileContents, diff --git a/extensions/diffs/src/viewer-payload.ts b/extensions/diffs/src/viewer-payload.ts index 7c29a4b5e1e..3cebf4c684c 100644 --- a/extensions/diffs/src/viewer-payload.ts +++ b/extensions/diffs/src/viewer-payload.ts @@ -1,3 +1,4 @@ +// Diffs plugin module implements viewer payload behavior. import { DIFF_INDICATORS, DIFF_LAYOUTS, DIFF_THEMES } from "./types.js"; import type { DiffViewerPayload } from "./types.js"; diff --git a/extensions/document-extract/document-extractor.test.ts b/extensions/document-extract/document-extractor.test.ts index d55d99ebd3f..f80c6e6a4dc 100644 --- a/extensions/document-extract/document-extractor.test.ts +++ b/extensions/document-extract/document-extractor.test.ts @@ -1,3 +1,4 @@ +// Document Extract tests cover document extractor plugin behavior. import { afterAll, beforeEach, describe, expect, it, vi } from "vitest"; const { createEngineMock, openPdfMock, pdfDocument } = vi.hoisted(() => ({ diff --git a/extensions/document-extract/document-extractor.ts b/extensions/document-extract/document-extractor.ts index a093eea9181..22059442ad5 100644 --- a/extensions/document-extract/document-extractor.ts +++ b/extensions/document-extract/document-extractor.ts @@ -1,3 +1,4 @@ +// Document Extract plugin module implements document extractor behavior. import type { PdfDocument, PdfEngine, PdfImage } from "clawpdf"; import type { DocumentExtractedImage, diff --git a/extensions/document-extract/index.ts b/extensions/document-extract/index.ts index d92af29dbc9..b2fc1aa0400 100644 --- a/extensions/document-extract/index.ts +++ b/extensions/document-extract/index.ts @@ -1,3 +1,4 @@ +// Document Extract plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; export default definePluginEntry({ diff --git a/extensions/duckduckgo/index.ts b/extensions/duckduckgo/index.ts index c5f0c45a57f..dd9c7de695a 100644 --- a/extensions/duckduckgo/index.ts +++ b/extensions/duckduckgo/index.ts @@ -1,3 +1,4 @@ +// Duckduckgo plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createDuckDuckGoWebSearchProvider } from "./src/ddg-search-provider.js"; diff --git a/extensions/duckduckgo/src/config.ts b/extensions/duckduckgo/src/config.ts index 86bd8cc9d10..bc13ccbe937 100644 --- a/extensions/duckduckgo/src/config.ts +++ b/extensions/duckduckgo/src/config.ts @@ -1,3 +1,4 @@ +// Duckduckgo helper module supports config behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime"; diff --git a/extensions/duckduckgo/src/ddg-client.ts b/extensions/duckduckgo/src/ddg-client.ts index 678dae26039..bcecbc7b4b0 100644 --- a/extensions/duckduckgo/src/ddg-client.ts +++ b/extensions/duckduckgo/src/ddg-client.ts @@ -1,3 +1,4 @@ +// Duckduckgo plugin module implements ddg client behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { DEFAULT_CACHE_TTL_MINUTES, diff --git a/extensions/duckduckgo/src/ddg-search-provider.shared.ts b/extensions/duckduckgo/src/ddg-search-provider.shared.ts index 573ec718cba..546c6ce0fdb 100644 --- a/extensions/duckduckgo/src/ddg-search-provider.shared.ts +++ b/extensions/duckduckgo/src/ddg-search-provider.shared.ts @@ -1,3 +1,4 @@ +// Duckduckgo provider module implements model/runtime integration. import { createWebSearchProviderContractFields } from "openclaw/plugin-sdk/provider-web-search-contract"; const DUCKDUCKGO_ONBOARDING_SCOPES: Array<"text-inference"> = ["text-inference"]; diff --git a/extensions/duckduckgo/src/ddg-search-provider.test.ts b/extensions/duckduckgo/src/ddg-search-provider.test.ts index b1fc45d0341..2728f3ca9a4 100644 --- a/extensions/duckduckgo/src/ddg-search-provider.test.ts +++ b/extensions/duckduckgo/src/ddg-search-provider.test.ts @@ -1,3 +1,4 @@ +// Duckduckgo tests cover ddg search provider plugin behavior. import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest"; import { createDuckDuckGoWebSearchProvider as createDuckDuckGoWebSearchContractProvider } from "../web-search-contract-api.js"; import { DEFAULT_DDG_SAFE_SEARCH, resolveDdgRegion, resolveDdgSafeSearch } from "./config.js"; diff --git a/extensions/duckduckgo/src/ddg-search-provider.ts b/extensions/duckduckgo/src/ddg-search-provider.ts index 239e00f7c78..9b05daa6dfc 100644 --- a/extensions/duckduckgo/src/ddg-search-provider.ts +++ b/extensions/duckduckgo/src/ddg-search-provider.ts @@ -1,3 +1,4 @@ +// Duckduckgo provider module implements model/runtime integration. import { readPositiveIntegerParam, readStringParam } from "openclaw/plugin-sdk/param-readers"; import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { createDuckDuckGoWebSearchProviderBase } from "./ddg-search-provider.shared.js"; diff --git a/extensions/duckduckgo/web-search-contract-api.ts b/extensions/duckduckgo/web-search-contract-api.ts index d60e84c2fde..987a9ca0127 100644 --- a/extensions/duckduckgo/web-search-contract-api.ts +++ b/extensions/duckduckgo/web-search-contract-api.ts @@ -1,3 +1,4 @@ +// Duckduckgo API module exposes the plugin public contract. import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { createDuckDuckGoWebSearchProviderBase } from "./src/ddg-search-provider.shared.js"; diff --git a/extensions/duckduckgo/web-search-provider.ts b/extensions/duckduckgo/web-search-provider.ts index 3c3644c219f..d8601013126 100644 --- a/extensions/duckduckgo/web-search-provider.ts +++ b/extensions/duckduckgo/web-search-provider.ts @@ -1 +1,2 @@ +// Duckduckgo provider module implements model/runtime integration. export { createDuckDuckGoWebSearchProvider } from "./src/ddg-search-provider.js"; diff --git a/extensions/elevenlabs/config-compat.test.ts b/extensions/elevenlabs/config-compat.test.ts index a9803cd1a99..da8e3c8616b 100644 --- a/extensions/elevenlabs/config-compat.test.ts +++ b/extensions/elevenlabs/config-compat.test.ts @@ -1,3 +1,4 @@ +// Elevenlabs tests cover config compat plugin behavior. import type fs from "node:fs"; import type os from "node:os"; import type path from "node:path"; diff --git a/extensions/elevenlabs/config-compat.ts b/extensions/elevenlabs/config-compat.ts index 5a90946fc66..e766638a082 100644 --- a/extensions/elevenlabs/config-compat.ts +++ b/extensions/elevenlabs/config-compat.ts @@ -1,3 +1,4 @@ +// Elevenlabs helper module supports config compat behavior. import fs from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/elevenlabs/contract-api.ts b/extensions/elevenlabs/contract-api.ts index f3486226b8c..a56d03bb5ce 100644 --- a/extensions/elevenlabs/contract-api.ts +++ b/extensions/elevenlabs/contract-api.ts @@ -1,3 +1,4 @@ +// Elevenlabs API module exposes the plugin public contract. export { ELEVENLABS_TALK_PROVIDER_ID, ELEVENLABS_TALK_LEGACY_CONFIG_RULES, diff --git a/extensions/elevenlabs/doctor-contract.ts b/extensions/elevenlabs/doctor-contract.ts index ae449f30c59..26d20af92df 100644 --- a/extensions/elevenlabs/doctor-contract.ts +++ b/extensions/elevenlabs/doctor-contract.ts @@ -1,3 +1,4 @@ +// Elevenlabs plugin module implements doctor contract behavior. import type { ChannelDoctorLegacyConfigRule } from "openclaw/plugin-sdk/channel-contract"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime"; diff --git a/extensions/elevenlabs/elevenlabs.live.test.ts b/extensions/elevenlabs/elevenlabs.live.test.ts index 340c371e1f6..5f3515356fd 100644 --- a/extensions/elevenlabs/elevenlabs.live.test.ts +++ b/extensions/elevenlabs/elevenlabs.live.test.ts @@ -1,3 +1,4 @@ +// Elevenlabs tests cover elevenlabs plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/elevenlabs/index.ts b/extensions/elevenlabs/index.ts index f64b7738a75..d9fbd6ea4c7 100644 --- a/extensions/elevenlabs/index.ts +++ b/extensions/elevenlabs/index.ts @@ -1,3 +1,4 @@ +// Elevenlabs plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { elevenLabsMediaUnderstandingProvider } from "./media-understanding-provider.js"; import { buildElevenLabsRealtimeTranscriptionProvider } from "./realtime-transcription-provider.js"; diff --git a/extensions/elevenlabs/media-understanding-provider.test.ts b/extensions/elevenlabs/media-understanding-provider.test.ts index 24e449b5d1d..5f0f501ac37 100644 --- a/extensions/elevenlabs/media-understanding-provider.test.ts +++ b/extensions/elevenlabs/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Elevenlabs tests cover media understanding provider plugin behavior. import { mockPinnedHostnameResolution } from "openclaw/plugin-sdk/test-env"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/elevenlabs/media-understanding-provider.ts b/extensions/elevenlabs/media-understanding-provider.ts index d16692646cf..a91807deb46 100644 --- a/extensions/elevenlabs/media-understanding-provider.ts +++ b/extensions/elevenlabs/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Elevenlabs provider module implements model/runtime integration. import type { AudioTranscriptionRequest, AudioTranscriptionResult, diff --git a/extensions/elevenlabs/realtime-transcription-provider.test.ts b/extensions/elevenlabs/realtime-transcription-provider.test.ts index e0f5069a423..fa00b798ef8 100644 --- a/extensions/elevenlabs/realtime-transcription-provider.test.ts +++ b/extensions/elevenlabs/realtime-transcription-provider.test.ts @@ -1,3 +1,4 @@ +// Elevenlabs tests cover realtime transcription provider plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { describe, expect, it } from "vitest"; import { diff --git a/extensions/elevenlabs/realtime-transcription-provider.ts b/extensions/elevenlabs/realtime-transcription-provider.ts index 9b5bda18232..f4f95bee5ce 100644 --- a/extensions/elevenlabs/realtime-transcription-provider.ts +++ b/extensions/elevenlabs/realtime-transcription-provider.ts @@ -1,3 +1,4 @@ +// Elevenlabs provider module implements model/runtime integration. import { createRealtimeTranscriptionWebSocketSession, type RealtimeTranscriptionProviderConfig, diff --git a/extensions/elevenlabs/setup-api.ts b/extensions/elevenlabs/setup-api.ts index 0a1e6cf5a42..848d043dde1 100644 --- a/extensions/elevenlabs/setup-api.ts +++ b/extensions/elevenlabs/setup-api.ts @@ -1,3 +1,4 @@ +// Elevenlabs API module exposes the plugin public contract. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { migrateElevenLabsLegacyTalkConfig } from "./config-compat.js"; diff --git a/extensions/elevenlabs/shared.ts b/extensions/elevenlabs/shared.ts index f412d2a4775..370e5844330 100644 --- a/extensions/elevenlabs/shared.ts +++ b/extensions/elevenlabs/shared.ts @@ -1,3 +1,4 @@ +// Elevenlabs plugin module implements shared behavior. export const DEFAULT_ELEVENLABS_BASE_URL = "https://api.elevenlabs.io"; export function isValidElevenLabsVoiceId(voiceId: string): boolean { diff --git a/extensions/elevenlabs/speech-provider.test.ts b/extensions/elevenlabs/speech-provider.test.ts index 67ff4a5fd5b..5994de4470a 100644 --- a/extensions/elevenlabs/speech-provider.test.ts +++ b/extensions/elevenlabs/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Elevenlabs tests cover speech provider plugin behavior. import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; import { buildElevenLabsSpeechProvider, isValidVoiceId } from "./speech-provider.js"; diff --git a/extensions/elevenlabs/speech-provider.ts b/extensions/elevenlabs/speech-provider.ts index 3d0a072b85c..68545b4ec68 100644 --- a/extensions/elevenlabs/speech-provider.ts +++ b/extensions/elevenlabs/speech-provider.ts @@ -1,3 +1,4 @@ +// Elevenlabs provider module implements model/runtime integration. import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; import { parseStrictFiniteNumber, parseStrictInteger } from "openclaw/plugin-sdk/number-runtime"; import { assertOkOrThrowProviderError } from "openclaw/plugin-sdk/provider-http"; diff --git a/extensions/elevenlabs/test-api.ts b/extensions/elevenlabs/test-api.ts index 0eeca5b5d18..717faaf0084 100644 --- a/extensions/elevenlabs/test-api.ts +++ b/extensions/elevenlabs/test-api.ts @@ -1,3 +1,4 @@ +// Elevenlabs API module exposes the plugin public contract. export { elevenLabsMediaUnderstandingProvider, transcribeElevenLabsAudio, diff --git a/extensions/elevenlabs/tts.test.ts b/extensions/elevenlabs/tts.test.ts index 75634f80105..21024399491 100644 --- a/extensions/elevenlabs/tts.test.ts +++ b/extensions/elevenlabs/tts.test.ts @@ -1,3 +1,4 @@ +// Elevenlabs tests cover tts plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { createStreamingErrorResponse } from "../test-support/streaming-error-response.js"; import { elevenLabsTTS, elevenLabsTTSStream } from "./tts.js"; diff --git a/extensions/elevenlabs/tts.ts b/extensions/elevenlabs/tts.ts index d1d6d476151..b5f0cf8a29b 100644 --- a/extensions/elevenlabs/tts.ts +++ b/extensions/elevenlabs/tts.ts @@ -1,3 +1,4 @@ +// Elevenlabs plugin module implements tts behavior. import { assertOkOrThrowProviderError, assertProviderBinaryResponseContent, diff --git a/extensions/exa/index.ts b/extensions/exa/index.ts index bc49e1f55d4..bac5876af80 100644 --- a/extensions/exa/index.ts +++ b/extensions/exa/index.ts @@ -1,3 +1,4 @@ +// Exa plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createExaWebSearchProvider } from "./src/exa-web-search-provider.js"; diff --git a/extensions/exa/src/exa-web-search-provider.runtime.ts b/extensions/exa/src/exa-web-search-provider.runtime.ts index fd908a94c82..b07913ea205 100644 --- a/extensions/exa/src/exa-web-search-provider.runtime.ts +++ b/extensions/exa/src/exa-web-search-provider.runtime.ts @@ -1,3 +1,4 @@ +// Exa provider module implements model/runtime integration. import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime"; import { buildSearchCacheKey, diff --git a/extensions/exa/src/exa-web-search-provider.shared.ts b/extensions/exa/src/exa-web-search-provider.shared.ts index 3d1a09ecd6c..10e118eec45 100644 --- a/extensions/exa/src/exa-web-search-provider.shared.ts +++ b/extensions/exa/src/exa-web-search-provider.shared.ts @@ -1,3 +1,4 @@ +// Exa provider module implements model/runtime integration. import { createWebSearchProviderContractFields } from "openclaw/plugin-sdk/provider-web-search-contract"; const EXA_CREDENTIAL_PATH = "plugins.entries.exa.config.webSearch.apiKey"; diff --git a/extensions/exa/src/exa-web-search-provider.test.ts b/extensions/exa/src/exa-web-search-provider.test.ts index a7e61d05ae8..00b8aef38ba 100644 --- a/extensions/exa/src/exa-web-search-provider.test.ts +++ b/extensions/exa/src/exa-web-search-provider.test.ts @@ -1,3 +1,4 @@ +// Exa tests cover exa web search provider plugin behavior. import { describe, expect, it } from "vitest"; import { testing } from "../test-api.js"; import { createExaWebSearchProvider as createContractExaWebSearchProvider } from "../web-search-contract-api.js"; diff --git a/extensions/exa/src/exa-web-search-provider.ts b/extensions/exa/src/exa-web-search-provider.ts index 8da66ae5447..e72ddda2078 100644 --- a/extensions/exa/src/exa-web-search-provider.ts +++ b/extensions/exa/src/exa-web-search-provider.ts @@ -1,3 +1,4 @@ +// Exa provider module implements model/runtime integration. import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { createExaWebSearchProviderBase } from "./exa-web-search-provider.shared.js"; diff --git a/extensions/exa/test-api.ts b/extensions/exa/test-api.ts index 24cf9a6c892..a479ec3fe23 100644 --- a/extensions/exa/test-api.ts +++ b/extensions/exa/test-api.ts @@ -1 +1,2 @@ +// Exa API module exposes the plugin public contract. export { testing, testing as __testing } from "./src/exa-web-search-provider.runtime.js"; diff --git a/extensions/exa/web-search-contract-api.ts b/extensions/exa/web-search-contract-api.ts index a71d47455f0..a9bb7efdd7b 100644 --- a/extensions/exa/web-search-contract-api.ts +++ b/extensions/exa/web-search-contract-api.ts @@ -1,3 +1,4 @@ +// Exa API module exposes the plugin public contract. import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { createExaWebSearchProviderBase } from "./src/exa-web-search-provider.shared.js"; diff --git a/extensions/exa/web-search-provider.ts b/extensions/exa/web-search-provider.ts index 55302ff6ebe..7359a4d0e1f 100644 --- a/extensions/exa/web-search-provider.ts +++ b/extensions/exa/web-search-provider.ts @@ -1 +1,2 @@ +// Exa provider module implements model/runtime integration. export { createExaWebSearchProvider } from "./src/exa-web-search-provider.js"; diff --git a/extensions/fal/http-config.ts b/extensions/fal/http-config.ts index 837b1e02fd0..99a6a35595d 100644 --- a/extensions/fal/http-config.ts +++ b/extensions/fal/http-config.ts @@ -1,3 +1,4 @@ +// Fal helper module supports http config behavior. import type { AuthProfileStore, OpenClawConfig } from "openclaw/plugin-sdk/provider-auth"; import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime"; import { diff --git a/extensions/fal/image-generation-provider.test.ts b/extensions/fal/image-generation-provider.test.ts index 4b54df7cdbe..613d78cf763 100644 --- a/extensions/fal/image-generation-provider.test.ts +++ b/extensions/fal/image-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Fal tests cover image generation provider plugin behavior. import * as providerAuth from "openclaw/plugin-sdk/provider-auth-runtime"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/fal/image-generation-provider.ts b/extensions/fal/image-generation-provider.ts index c9b086ca89d..68a1e2b541d 100644 --- a/extensions/fal/image-generation-provider.ts +++ b/extensions/fal/image-generation-provider.ts @@ -1,3 +1,4 @@ +// Fal provider module implements model/runtime integration. import type { GeneratedImageAsset, ImageGenerationProvider, diff --git a/extensions/fal/index.ts b/extensions/fal/index.ts index d46327ec7aa..dba0015aad9 100644 --- a/extensions/fal/index.ts +++ b/extensions/fal/index.ts @@ -1,3 +1,4 @@ +// Fal plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildFalImageGenerationProvider } from "./image-generation-provider.js"; import { buildFalMusicGenerationProvider } from "./music-generation-provider.js"; diff --git a/extensions/fal/music-generation-provider.test.ts b/extensions/fal/music-generation-provider.test.ts index b014d9d6c5a..4192f7d2f89 100644 --- a/extensions/fal/music-generation-provider.test.ts +++ b/extensions/fal/music-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Fal tests cover music generation provider plugin behavior. import { expectExplicitMusicGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts"; import { afterEach, describe, expect, it, vi } from "vitest"; import { buildFalMusicGenerationProvider } from "./music-generation-provider.js"; diff --git a/extensions/fal/music-generation-provider.ts b/extensions/fal/music-generation-provider.ts index de49144c6ed..2f352707f87 100644 --- a/extensions/fal/music-generation-provider.ts +++ b/extensions/fal/music-generation-provider.ts @@ -1,3 +1,4 @@ +// Fal provider module implements model/runtime integration. import { downloadGeneratedMusicAsset, extractGeneratedMusicFileCandidates, diff --git a/extensions/fal/onboard.ts b/extensions/fal/onboard.ts index 3478599ae59..993c9e49827 100644 --- a/extensions/fal/onboard.ts +++ b/extensions/fal/onboard.ts @@ -1,3 +1,4 @@ +// Fal setup module handles plugin onboarding behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-onboard"; export const FAL_DEFAULT_IMAGE_MODEL_REF = "fal/fal-ai/flux/dev"; diff --git a/extensions/fal/provider-contract-api.ts b/extensions/fal/provider-contract-api.ts index 0730d153d7e..660ed9bdcc5 100644 --- a/extensions/fal/provider-contract-api.ts +++ b/extensions/fal/provider-contract-api.ts @@ -1,3 +1,4 @@ +// Fal API module exposes the plugin public contract. import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; const PROVIDER_ID = "fal"; diff --git a/extensions/fal/provider-registration.ts b/extensions/fal/provider-registration.ts index 0cb67d50956..f45368e92f3 100644 --- a/extensions/fal/provider-registration.ts +++ b/extensions/fal/provider-registration.ts @@ -1,3 +1,4 @@ +// Fal provider module implements model/runtime integration. import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; import { applyFalConfig, FAL_DEFAULT_IMAGE_MODEL_REF } from "./onboard.js"; diff --git a/extensions/fal/test-api.ts b/extensions/fal/test-api.ts index 24caaec6e9f..8ac3da16449 100644 --- a/extensions/fal/test-api.ts +++ b/extensions/fal/test-api.ts @@ -1,3 +1,4 @@ +// Fal API module exposes the plugin public contract. export { buildFalImageGenerationProvider } from "./image-generation-provider.js"; export { buildFalMusicGenerationProvider } from "./music-generation-provider.js"; export { buildFalVideoGenerationProvider } from "./video-generation-provider.js"; diff --git a/extensions/fal/video-generation-provider.test.ts b/extensions/fal/video-generation-provider.test.ts index 744a865caaf..1b152a91d60 100644 --- a/extensions/fal/video-generation-provider.test.ts +++ b/extensions/fal/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Fal tests cover video generation provider plugin behavior. import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import * as providerAuth from "openclaw/plugin-sdk/provider-auth-runtime"; import * as providerHttp from "openclaw/plugin-sdk/provider-http"; diff --git a/extensions/fal/video-generation-provider.ts b/extensions/fal/video-generation-provider.ts index f5f3fc6b47c..f5873aaa314 100644 --- a/extensions/fal/video-generation-provider.ts +++ b/extensions/fal/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Fal provider module implements model/runtime integration. import { extensionForMime } from "openclaw/plugin-sdk/media-mime"; import { resolvePositiveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime"; import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; diff --git a/extensions/file-transfer/index.test.ts b/extensions/file-transfer/index.test.ts index e1bbbcc7fe5..c5b234fbc93 100644 --- a/extensions/file-transfer/index.test.ts +++ b/extensions/file-transfer/index.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover index plugin behavior. import { afterAll, describe, expect, it, vi } from "vitest"; import pluginEntry from "./index.js"; diff --git a/extensions/file-transfer/index.ts b/extensions/file-transfer/index.ts index abd2b368bf9..f8180d5cbe3 100644 --- a/extensions/file-transfer/index.ts +++ b/extensions/file-transfer/index.ts @@ -1,3 +1,4 @@ +// File Transfer plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type AnyAgentTool, diff --git a/extensions/file-transfer/src/node-host/dir-fetch.test.ts b/extensions/file-transfer/src/node-host/dir-fetch.test.ts index c2c0e54a951..d16626b458d 100644 --- a/extensions/file-transfer/src/node-host/dir-fetch.test.ts +++ b/extensions/file-transfer/src/node-host/dir-fetch.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover dir fetch plugin behavior. import crypto from "node:crypto"; import fs from "node:fs/promises"; import os from "node:os"; diff --git a/extensions/file-transfer/src/node-host/dir-fetch.ts b/extensions/file-transfer/src/node-host/dir-fetch.ts index b0729428d70..b1089a61261 100644 --- a/extensions/file-transfer/src/node-host/dir-fetch.ts +++ b/extensions/file-transfer/src/node-host/dir-fetch.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements dir fetch behavior. import { spawn } from "node:child_process"; import crypto from "node:crypto"; import path from "node:path"; diff --git a/extensions/file-transfer/src/node-host/dir-list.test.ts b/extensions/file-transfer/src/node-host/dir-list.test.ts index 93a855700cb..abcfc8aabe5 100644 --- a/extensions/file-transfer/src/node-host/dir-list.test.ts +++ b/extensions/file-transfer/src/node-host/dir-list.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover dir list plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/file-transfer/src/node-host/dir-list.ts b/extensions/file-transfer/src/node-host/dir-list.ts index 993a0f4b327..5b46df1fcb7 100644 --- a/extensions/file-transfer/src/node-host/dir-list.ts +++ b/extensions/file-transfer/src/node-host/dir-list.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements dir list behavior. import path from "node:path"; import { parseStrictNonNegativeInteger } from "openclaw/plugin-sdk/number-runtime"; import { root } from "openclaw/plugin-sdk/security-runtime"; diff --git a/extensions/file-transfer/src/node-host/file-fetch.test.ts b/extensions/file-transfer/src/node-host/file-fetch.test.ts index 3b388adcfc5..b7c3180384b 100644 --- a/extensions/file-transfer/src/node-host/file-fetch.test.ts +++ b/extensions/file-transfer/src/node-host/file-fetch.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover file fetch plugin behavior. import crypto from "node:crypto"; import fs from "node:fs/promises"; import os from "node:os"; diff --git a/extensions/file-transfer/src/node-host/file-fetch.ts b/extensions/file-transfer/src/node-host/file-fetch.ts index 7e8c326c367..ac5dee3b6a1 100644 --- a/extensions/file-transfer/src/node-host/file-fetch.ts +++ b/extensions/file-transfer/src/node-host/file-fetch.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements file fetch behavior. import crypto from "node:crypto"; import path from "node:path"; import { detectMime } from "openclaw/plugin-sdk/media-mime"; diff --git a/extensions/file-transfer/src/node-host/file-write.test.ts b/extensions/file-transfer/src/node-host/file-write.test.ts index 658c2a28e55..db4dc60666a 100644 --- a/extensions/file-transfer/src/node-host/file-write.test.ts +++ b/extensions/file-transfer/src/node-host/file-write.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover file write plugin behavior. import crypto from "node:crypto"; import fs from "node:fs/promises"; import os from "node:os"; diff --git a/extensions/file-transfer/src/node-host/file-write.ts b/extensions/file-transfer/src/node-host/file-write.ts index 3f5fb2fbec5..1461cc81a2c 100644 --- a/extensions/file-transfer/src/node-host/file-write.ts +++ b/extensions/file-transfer/src/node-host/file-write.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements file write behavior. import crypto from "node:crypto"; import fs from "node:fs/promises"; import path from "node:path"; diff --git a/extensions/file-transfer/src/node-host/path-errors.ts b/extensions/file-transfer/src/node-host/path-errors.ts index 5501903b4a6..6af2c7f23af 100644 --- a/extensions/file-transfer/src/node-host/path-errors.ts +++ b/extensions/file-transfer/src/node-host/path-errors.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements path errors behavior. import fs from "node:fs/promises"; import path from "node:path"; import { FsSafeError, resolveAbsolutePathForRead } from "openclaw/plugin-sdk/security-runtime"; diff --git a/extensions/file-transfer/src/shared/errors.test.ts b/extensions/file-transfer/src/shared/errors.test.ts index d5406635945..4484b38cf49 100644 --- a/extensions/file-transfer/src/shared/errors.test.ts +++ b/extensions/file-transfer/src/shared/errors.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover errors plugin behavior. import { describe, expect, it } from "vitest"; import { classifyFsError, err, throwFromNodePayload } from "./errors.js"; diff --git a/extensions/file-transfer/src/shared/lazy-node-invoke-policy.test.ts b/extensions/file-transfer/src/shared/lazy-node-invoke-policy.test.ts index 7b4349299ae..5bff72b90e6 100644 --- a/extensions/file-transfer/src/shared/lazy-node-invoke-policy.test.ts +++ b/extensions/file-transfer/src/shared/lazy-node-invoke-policy.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover lazy node invoke policy plugin behavior. import type { OpenClawPluginNodeInvokePolicy, OpenClawPluginNodeInvokePolicyContext, diff --git a/extensions/file-transfer/src/shared/lazy-node-invoke-policy.ts b/extensions/file-transfer/src/shared/lazy-node-invoke-policy.ts index 248e4067870..32278a485c5 100644 --- a/extensions/file-transfer/src/shared/lazy-node-invoke-policy.ts +++ b/extensions/file-transfer/src/shared/lazy-node-invoke-policy.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements lazy node invoke policy behavior. import type { OpenClawPluginNodeInvokePolicy } from "openclaw/plugin-sdk/plugin-entry"; import { FILE_TRANSFER_NODE_INVOKE_COMMANDS } from "./node-invoke-policy-commands.js"; diff --git a/extensions/file-transfer/src/shared/mime.test.ts b/extensions/file-transfer/src/shared/mime.test.ts index 85c4b6fbe5b..8a5e16e6cb8 100644 --- a/extensions/file-transfer/src/shared/mime.test.ts +++ b/extensions/file-transfer/src/shared/mime.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover mime plugin behavior. import { describe, expect, it } from "vitest"; import { IMAGE_MIME_INLINE_SET, diff --git a/extensions/file-transfer/src/shared/mime.ts b/extensions/file-transfer/src/shared/mime.ts index df7e6624bed..0b3615715b0 100644 --- a/extensions/file-transfer/src/shared/mime.ts +++ b/extensions/file-transfer/src/shared/mime.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements mime behavior. import { mimeTypeFromFilePath } from "openclaw/plugin-sdk/media-mime"; // MIME types we treat as inline-displayable images for vision-capable models. diff --git a/extensions/file-transfer/src/shared/node-invoke-policy-commands.ts b/extensions/file-transfer/src/shared/node-invoke-policy-commands.ts index 1579038819a..0c97b514bbe 100644 --- a/extensions/file-transfer/src/shared/node-invoke-policy-commands.ts +++ b/extensions/file-transfer/src/shared/node-invoke-policy-commands.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements node invoke policy commands behavior. export const FILE_TRANSFER_NODE_INVOKE_COMMANDS = [ "file.fetch", "dir.list", diff --git a/extensions/file-transfer/src/shared/node-invoke-policy.test.ts b/extensions/file-transfer/src/shared/node-invoke-policy.test.ts index c382385b12e..ba2b9681d5d 100644 --- a/extensions/file-transfer/src/shared/node-invoke-policy.test.ts +++ b/extensions/file-transfer/src/shared/node-invoke-policy.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover node invoke policy plugin behavior. import fs from "node:fs/promises"; import { gzipSync } from "node:zlib"; import type { OpenClawPluginNodeInvokePolicyContext } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/file-transfer/src/shared/node-invoke-policy.ts b/extensions/file-transfer/src/shared/node-invoke-policy.ts index 68bf389aed2..bafc15c3f6a 100644 --- a/extensions/file-transfer/src/shared/node-invoke-policy.ts +++ b/extensions/file-transfer/src/shared/node-invoke-policy.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements node invoke policy behavior. import { spawn } from "node:child_process"; import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers"; import type { diff --git a/extensions/file-transfer/src/shared/params.test.ts b/extensions/file-transfer/src/shared/params.test.ts index 88aa00756a8..988c1940faa 100644 --- a/extensions/file-transfer/src/shared/params.test.ts +++ b/extensions/file-transfer/src/shared/params.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover params plugin behavior. import { describe, expect, it } from "vitest"; import { readClampedInt, readGatewayCallOptions } from "./params.js"; diff --git a/extensions/file-transfer/src/shared/policy.test.ts b/extensions/file-transfer/src/shared/policy.test.ts index 0f3cea845e1..5a4e1df1148 100644 --- a/extensions/file-transfer/src/shared/policy.test.ts +++ b/extensions/file-transfer/src/shared/policy.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover policy plugin behavior. import os from "node:os"; import path from "node:path"; import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/file-transfer/src/tools/descriptors.ts b/extensions/file-transfer/src/tools/descriptors.ts index 41fa09ad20c..bad73d18a47 100644 --- a/extensions/file-transfer/src/tools/descriptors.ts +++ b/extensions/file-transfer/src/tools/descriptors.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements descriptors behavior. import { optionalPositiveIntegerSchema } from "openclaw/plugin-sdk/channel-actions"; import type { AnyAgentTool } from "openclaw/plugin-sdk/plugin-entry"; import { Type } from "typebox"; diff --git a/extensions/file-transfer/src/tools/dir-fetch-tool.test.ts b/extensions/file-transfer/src/tools/dir-fetch-tool.test.ts index 5186408c7c0..d49230fa0c4 100644 --- a/extensions/file-transfer/src/tools/dir-fetch-tool.test.ts +++ b/extensions/file-transfer/src/tools/dir-fetch-tool.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover dir fetch tool plugin behavior. import { spawn } from "node:child_process"; import { EventEmitter } from "node:events"; import fs from "node:fs/promises"; diff --git a/extensions/file-transfer/src/tools/dir-fetch-tool.ts b/extensions/file-transfer/src/tools/dir-fetch-tool.ts index 68460fe1edc..7ddb8e8bad5 100644 --- a/extensions/file-transfer/src/tools/dir-fetch-tool.ts +++ b/extensions/file-transfer/src/tools/dir-fetch-tool.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements dir fetch tool behavior. import { spawn } from "node:child_process"; import crypto from "node:crypto"; import fs from "node:fs/promises"; diff --git a/extensions/file-transfer/src/tools/dir-list-tool.ts b/extensions/file-transfer/src/tools/dir-list-tool.ts index 029a7c02d81..604823eab49 100644 --- a/extensions/file-transfer/src/tools/dir-list-tool.ts +++ b/extensions/file-transfer/src/tools/dir-list-tool.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements dir list tool behavior. import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness-runtime"; import { appendFileTransferAudit } from "../shared/audit.js"; import { readClampedInt } from "../shared/params.js"; diff --git a/extensions/file-transfer/src/tools/file-fetch-tool.test.ts b/extensions/file-transfer/src/tools/file-fetch-tool.test.ts index cf47d26a5e8..d4e27a9f7af 100644 --- a/extensions/file-transfer/src/tools/file-fetch-tool.test.ts +++ b/extensions/file-transfer/src/tools/file-fetch-tool.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover file fetch tool plugin behavior. import crypto from "node:crypto"; import { callGatewayTool, diff --git a/extensions/file-transfer/src/tools/file-fetch-tool.ts b/extensions/file-transfer/src/tools/file-fetch-tool.ts index 35215705fd5..df2e830bb87 100644 --- a/extensions/file-transfer/src/tools/file-fetch-tool.ts +++ b/extensions/file-transfer/src/tools/file-fetch-tool.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements file fetch tool behavior. import crypto from "node:crypto"; import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness-runtime"; import { saveMediaBuffer } from "openclaw/plugin-sdk/media-store"; diff --git a/extensions/file-transfer/src/tools/file-write-tool.test.ts b/extensions/file-transfer/src/tools/file-write-tool.test.ts index e6b47bb01b5..f4b8adb917c 100644 --- a/extensions/file-transfer/src/tools/file-write-tool.test.ts +++ b/extensions/file-transfer/src/tools/file-write-tool.test.ts @@ -1,3 +1,4 @@ +// File Transfer tests cover file write tool plugin behavior. import { callGatewayTool } from "openclaw/plugin-sdk/agent-harness-runtime"; import { describe, expect, it, vi } from "vitest"; import { createFileWriteTool } from "./file-write-tool.js"; diff --git a/extensions/file-transfer/src/tools/file-write-tool.ts b/extensions/file-transfer/src/tools/file-write-tool.ts index 7f2e61a38e0..00a6ffb1221 100644 --- a/extensions/file-transfer/src/tools/file-write-tool.ts +++ b/extensions/file-transfer/src/tools/file-write-tool.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements file write tool behavior. import crypto from "node:crypto"; import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness-runtime"; import { readMediaBuffer } from "openclaw/plugin-sdk/media-store"; diff --git a/extensions/file-transfer/src/tools/node-tool-invoke.ts b/extensions/file-transfer/src/tools/node-tool-invoke.ts index cf845231121..723c1e5924b 100644 --- a/extensions/file-transfer/src/tools/node-tool-invoke.ts +++ b/extensions/file-transfer/src/tools/node-tool-invoke.ts @@ -1,3 +1,4 @@ +// File Transfer plugin module implements node tool invoke behavior. import crypto from "node:crypto"; import { callGatewayTool, diff --git a/extensions/firecrawl/api.ts b/extensions/firecrawl/api.ts index 00c22058342..c6c814a8e50 100644 --- a/extensions/firecrawl/api.ts +++ b/extensions/firecrawl/api.ts @@ -1,3 +1,4 @@ +// Firecrawl API module exposes the plugin public contract. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { readStringValue } from "openclaw/plugin-sdk/string-coerce-runtime"; import { runFirecrawlScrape } from "./src/firecrawl-client.js"; diff --git a/extensions/firecrawl/index.ts b/extensions/firecrawl/index.ts index 63ace8e9935..abf1f0e5b2c 100644 --- a/extensions/firecrawl/index.ts +++ b/extensions/firecrawl/index.ts @@ -1,3 +1,4 @@ +// Firecrawl plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type AnyAgentTool } from "openclaw/plugin-sdk/plugin-entry"; import { createFirecrawlWebFetchProvider } from "./src/firecrawl-fetch-provider.js"; import { createFirecrawlScrapeTool } from "./src/firecrawl-scrape-tool.js"; diff --git a/extensions/firecrawl/src/config.ts b/extensions/firecrawl/src/config.ts index bbeac568d2b..6d5e7ac105f 100644 --- a/extensions/firecrawl/src/config.ts +++ b/extensions/firecrawl/src/config.ts @@ -1,3 +1,4 @@ +// Firecrawl helper module supports config behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { canResolveEnvSecretRefInReadOnlyPath } from "openclaw/plugin-sdk/extension-shared"; import { resolvePositiveTimeoutSeconds } from "openclaw/plugin-sdk/provider-web-fetch"; diff --git a/extensions/firecrawl/src/firecrawl-client.ts b/extensions/firecrawl/src/firecrawl-client.ts index b786a524938..dbbc12a4e4d 100644 --- a/extensions/firecrawl/src/firecrawl-client.ts +++ b/extensions/firecrawl/src/firecrawl-client.ts @@ -1,3 +1,4 @@ +// Firecrawl plugin module implements firecrawl client behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { DEFAULT_CACHE_TTL_MINUTES, diff --git a/extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts b/extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts index a76c4002e17..7ac3cfb5218 100644 --- a/extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts +++ b/extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts @@ -1,3 +1,4 @@ +// Firecrawl provider module implements model/runtime integration. import type { WebFetchProviderPlugin } from "openclaw/plugin-sdk/provider-web-fetch-contract"; function ensureRecord(target: Record, key: string): Record { diff --git a/extensions/firecrawl/src/firecrawl-fetch-provider.ts b/extensions/firecrawl/src/firecrawl-fetch-provider.ts index 87d90ddd3be..e4b628bdb26 100644 --- a/extensions/firecrawl/src/firecrawl-fetch-provider.ts +++ b/extensions/firecrawl/src/firecrawl-fetch-provider.ts @@ -1,3 +1,4 @@ +// Firecrawl provider module implements model/runtime integration. import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers"; import type { WebFetchProviderPlugin } from "openclaw/plugin-sdk/provider-web-fetch"; import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch"; diff --git a/extensions/firecrawl/src/firecrawl-scrape-tool.ts b/extensions/firecrawl/src/firecrawl-scrape-tool.ts index 00bd20ce194..ca9d679c08f 100644 --- a/extensions/firecrawl/src/firecrawl-scrape-tool.ts +++ b/extensions/firecrawl/src/firecrawl-scrape-tool.ts @@ -1,3 +1,4 @@ +// Firecrawl plugin module implements firecrawl scrape tool behavior. import { optionalStringEnum } from "openclaw/plugin-sdk/channel-actions"; import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-runtime"; import { diff --git a/extensions/firecrawl/src/firecrawl-search-provider.ts b/extensions/firecrawl/src/firecrawl-search-provider.ts index fba25399cb6..52b8b336d6e 100644 --- a/extensions/firecrawl/src/firecrawl-search-provider.ts +++ b/extensions/firecrawl/src/firecrawl-search-provider.ts @@ -1,3 +1,4 @@ +// Firecrawl provider module implements model/runtime integration. import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers"; import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { buildFirecrawlWebSearchProviderBase } from "../web-search-shared.js"; diff --git a/extensions/firecrawl/src/firecrawl-search-tool.ts b/extensions/firecrawl/src/firecrawl-search-tool.ts index e23850f2b43..0d912c3363b 100644 --- a/extensions/firecrawl/src/firecrawl-search-tool.ts +++ b/extensions/firecrawl/src/firecrawl-search-tool.ts @@ -1,3 +1,4 @@ +// Firecrawl plugin module implements firecrawl search tool behavior. import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-runtime"; import { jsonResult, diff --git a/extensions/firecrawl/src/firecrawl-tools.test.ts b/extensions/firecrawl/src/firecrawl-tools.test.ts index 2f3c4d0e43c..4807054869b 100644 --- a/extensions/firecrawl/src/firecrawl-tools.test.ts +++ b/extensions/firecrawl/src/firecrawl-tools.test.ts @@ -1,3 +1,4 @@ +// Firecrawl tests cover firecrawl tools plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { mockPinnedHostnameResolution } from "openclaw/plugin-sdk/test-env"; import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/firecrawl/web-fetch-contract-api.ts b/extensions/firecrawl/web-fetch-contract-api.ts index 050116943e0..e63d1e0e182 100644 --- a/extensions/firecrawl/web-fetch-contract-api.ts +++ b/extensions/firecrawl/web-fetch-contract-api.ts @@ -1,3 +1,4 @@ +// Firecrawl API module exposes the plugin public contract. import { enablePluginInConfig, type WebFetchProviderPlugin, diff --git a/extensions/firecrawl/web-fetch-provider.ts b/extensions/firecrawl/web-fetch-provider.ts index 800d1cdd9a9..96157a27b32 100644 --- a/extensions/firecrawl/web-fetch-provider.ts +++ b/extensions/firecrawl/web-fetch-provider.ts @@ -1 +1,2 @@ +// Firecrawl provider module implements model/runtime integration. export { createFirecrawlWebFetchProvider } from "./src/firecrawl-fetch-provider.js"; diff --git a/extensions/firecrawl/web-search-contract-api.ts b/extensions/firecrawl/web-search-contract-api.ts index 9291ffbabc7..6a2ee6ef716 100644 --- a/extensions/firecrawl/web-search-contract-api.ts +++ b/extensions/firecrawl/web-search-contract-api.ts @@ -1,3 +1,4 @@ +// Firecrawl API module exposes the plugin public contract. import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { buildFirecrawlWebSearchProviderBase } from "./web-search-shared.js"; diff --git a/extensions/firecrawl/web-search-provider.ts b/extensions/firecrawl/web-search-provider.ts index f86098cb1f6..0eb908180da 100644 --- a/extensions/firecrawl/web-search-provider.ts +++ b/extensions/firecrawl/web-search-provider.ts @@ -1 +1,2 @@ +// Firecrawl provider module implements model/runtime integration. export { createFirecrawlWebSearchProvider } from "./src/firecrawl-search-provider.js"; diff --git a/extensions/firecrawl/web-search-shared.ts b/extensions/firecrawl/web-search-shared.ts index 907dc475d88..f4c23b738c2 100644 --- a/extensions/firecrawl/web-search-shared.ts +++ b/extensions/firecrawl/web-search-shared.ts @@ -1,3 +1,4 @@ +// Firecrawl plugin module implements web search shared behavior. import { createWebSearchProviderContractFields, type WebSearchProviderPlugin, diff --git a/extensions/fireworks/index.test.ts b/extensions/fireworks/index.test.ts index c5850347760..331b8a44e14 100644 --- a/extensions/fireworks/index.test.ts +++ b/extensions/fireworks/index.test.ts @@ -1,3 +1,4 @@ +// Fireworks tests cover index plugin behavior. import type { ProviderRuntimeModel } from "openclaw/plugin-sdk/plugin-entry"; import { registerSingleProviderPlugin, diff --git a/extensions/fireworks/index.ts b/extensions/fireworks/index.ts index ef742cd7d59..9cd9480fc7a 100644 --- a/extensions/fireworks/index.ts +++ b/extensions/fireworks/index.ts @@ -1,3 +1,4 @@ +// Fireworks plugin entrypoint registers its OpenClaw integration. import type { ProviderResolveDynamicModelContext } from "openclaw/plugin-sdk/plugin-entry"; import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { diff --git a/extensions/fireworks/model-id.ts b/extensions/fireworks/model-id.ts index 9e9a20fcc6f..46fac5246c0 100644 --- a/extensions/fireworks/model-id.ts +++ b/extensions/fireworks/model-id.ts @@ -1,3 +1,4 @@ +// Fireworks plugin module implements model id behavior. export function isFireworksKimiModelId(modelId: string): boolean { const normalized = modelId.trim().toLowerCase(); const lastSegment = normalized.split("/").pop() ?? normalized; diff --git a/extensions/fireworks/onboard.ts b/extensions/fireworks/onboard.ts index f9adab0104b..48aa2dcda83 100644 --- a/extensions/fireworks/onboard.ts +++ b/extensions/fireworks/onboard.ts @@ -1,3 +1,4 @@ +// Fireworks setup module handles plugin onboarding behavior. import { createDefaultModelsPresetAppliers, type OpenClawConfig, diff --git a/extensions/fireworks/provider-catalog.ts b/extensions/fireworks/provider-catalog.ts index 129537f4a41..19e12505225 100644 --- a/extensions/fireworks/provider-catalog.ts +++ b/extensions/fireworks/provider-catalog.ts @@ -1,3 +1,4 @@ +// Fireworks provider module implements model/runtime integration. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig, diff --git a/extensions/fireworks/provider-policy-api.ts b/extensions/fireworks/provider-policy-api.ts index 10226656a21..1e4872f4dc0 100644 --- a/extensions/fireworks/provider-policy-api.ts +++ b/extensions/fireworks/provider-policy-api.ts @@ -1,3 +1,4 @@ +// Fireworks API module exposes the plugin public contract. import { resolveFireworksThinkingProfile } from "./thinking-policy.js"; export function resolveThinkingProfile(params: { diff --git a/extensions/fireworks/stream.test.ts b/extensions/fireworks/stream.test.ts index 12c4b53cbb2..9aa667f9e59 100644 --- a/extensions/fireworks/stream.test.ts +++ b/extensions/fireworks/stream.test.ts @@ -1,3 +1,4 @@ +// Fireworks tests cover stream plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { describe, expect, it } from "vitest"; diff --git a/extensions/fireworks/stream.ts b/extensions/fireworks/stream.ts index 9e7d1b69fe2..4fb1b16ead8 100644 --- a/extensions/fireworks/stream.ts +++ b/extensions/fireworks/stream.ts @@ -1,3 +1,4 @@ +// Fireworks plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import { streamSimple } from "openclaw/plugin-sdk/llm"; import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/fireworks/thinking-policy.ts b/extensions/fireworks/thinking-policy.ts index ec267be5201..a0b3bffbf3f 100644 --- a/extensions/fireworks/thinking-policy.ts +++ b/extensions/fireworks/thinking-policy.ts @@ -1,3 +1,4 @@ +// Fireworks plugin module implements thinking policy behavior. import type { ProviderThinkingProfile } from "openclaw/plugin-sdk/plugin-entry"; import { isFireworksKimiModelId } from "./model-id.js"; diff --git a/extensions/github-copilot/api.ts b/extensions/github-copilot/api.ts index bd0a8ba072a..eade8e3e3dc 100644 --- a/extensions/github-copilot/api.ts +++ b/extensions/github-copilot/api.ts @@ -1 +1,2 @@ +// Github Copilot API module exposes the plugin public contract. export { githubCopilotLoginCommand } from "./login.js"; diff --git a/extensions/github-copilot/auth.test.ts b/extensions/github-copilot/auth.test.ts index 2b46f564e65..21999f441d5 100644 --- a/extensions/github-copilot/auth.test.ts +++ b/extensions/github-copilot/auth.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover auth plugin behavior. import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest"; const ensureAuthProfileStoreMock = vi.hoisted(() => vi.fn()); diff --git a/extensions/github-copilot/auth.ts b/extensions/github-copilot/auth.ts index 755d58b01a0..dc1b70f337f 100644 --- a/extensions/github-copilot/auth.ts +++ b/extensions/github-copilot/auth.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements auth behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { coerceSecretRef, diff --git a/extensions/github-copilot/connection-bound-ids.live.test.ts b/extensions/github-copilot/connection-bound-ids.live.test.ts index 9708e77add6..6efc611edba 100644 --- a/extensions/github-copilot/connection-bound-ids.live.test.ts +++ b/extensions/github-copilot/connection-bound-ids.live.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover connection bound ids plugin behavior. import { stream as streamModel, type AssistantMessage, type Model } from "openclaw/plugin-sdk/llm"; import { describe, expect, it } from "vitest"; import { resolveFirstGithubToken } from "./auth.js"; diff --git a/extensions/github-copilot/connection-bound-ids.test.ts b/extensions/github-copilot/connection-bound-ids.test.ts index d34cd9e3ca4..21006491c19 100644 --- a/extensions/github-copilot/connection-bound-ids.test.ts +++ b/extensions/github-copilot/connection-bound-ids.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover connection bound ids plugin behavior. import { describe, expect, it } from "vitest"; import { rewriteCopilotConnectionBoundResponseIds, diff --git a/extensions/github-copilot/connection-bound-ids.ts b/extensions/github-copilot/connection-bound-ids.ts index d40f040b785..0524133234a 100644 --- a/extensions/github-copilot/connection-bound-ids.ts +++ b/extensions/github-copilot/connection-bound-ids.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements connection bound ids behavior. import { createHash } from "node:crypto"; // Copilot's OpenAI-compatible `/responses` endpoint can emit replay item IDs diff --git a/extensions/github-copilot/embeddings.test.ts b/extensions/github-copilot/embeddings.test.ts index 6c62981545d..c76df3e67a7 100644 --- a/extensions/github-copilot/embeddings.test.ts +++ b/extensions/github-copilot/embeddings.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover embeddings plugin behavior. import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest"; const resolveFirstGithubTokenMock = vi.hoisted(() => vi.fn()); diff --git a/extensions/github-copilot/embeddings.ts b/extensions/github-copilot/embeddings.ts index e43eb9d123e..1a6f4456a17 100644 --- a/extensions/github-copilot/embeddings.ts +++ b/extensions/github-copilot/embeddings.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements embeddings behavior. import { buildRemoteBaseUrlPolicy, sanitizeAndNormalizeEmbedding, diff --git a/extensions/github-copilot/index.test.ts b/extensions/github-copilot/index.test.ts index 13181467b8f..abce8f4d313 100644 --- a/extensions/github-copilot/index.test.ts +++ b/extensions/github-copilot/index.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover index plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/github-copilot/index.ts b/extensions/github-copilot/index.ts index af61509da38..a9a8a820160 100644 --- a/extensions/github-copilot/index.ts +++ b/extensions/github-copilot/index.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin entrypoint registers its OpenClaw integration. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { resolvePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime"; import { diff --git a/extensions/github-copilot/login.ts b/extensions/github-copilot/login.ts index bbaba15fe85..fa73ebe6068 100644 --- a/extensions/github-copilot/login.ts +++ b/extensions/github-copilot/login.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements login behavior. import { intro, note, outro, spinner } from "@clack/prompts"; import { stylePromptTitle } from "openclaw/plugin-sdk/cli-runtime"; import { logConfigUpdated, updateConfig } from "openclaw/plugin-sdk/config-mutation"; diff --git a/extensions/github-copilot/model-metadata.ts b/extensions/github-copilot/model-metadata.ts index 5dbe2fb3881..fbc4b2761fe 100644 --- a/extensions/github-copilot/model-metadata.ts +++ b/extensions/github-copilot/model-metadata.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements model metadata behavior. import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime"; diff --git a/extensions/github-copilot/models-defaults.ts b/extensions/github-copilot/models-defaults.ts index 945d5580971..894af2b9f9c 100644 --- a/extensions/github-copilot/models-defaults.ts +++ b/extensions/github-copilot/models-defaults.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements models defaults behavior. import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { resolveCopilotModelCompat, diff --git a/extensions/github-copilot/models.test.ts b/extensions/github-copilot/models.test.ts index cdbe7de4184..9f8ad65c199 100644 --- a/extensions/github-copilot/models.test.ts +++ b/extensions/github-copilot/models.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover models plugin behavior. import { createProviderUsageFetch, makeResponse } from "openclaw/plugin-sdk/test-env"; import { beforeEach, describe, expect, it, vi } from "vitest"; import { buildCopilotModelDefinition, getDefaultCopilotModelIds } from "./models-defaults.js"; diff --git a/extensions/github-copilot/models.ts b/extensions/github-copilot/models.ts index 05f2333b9b5..98ba9a4a352 100644 --- a/extensions/github-copilot/models.ts +++ b/extensions/github-copilot/models.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements models behavior. import type { ProviderResolveDynamicModelContext, ProviderRuntimeModel, diff --git a/extensions/github-copilot/provider-auth.contract.test.ts b/extensions/github-copilot/provider-auth.contract.test.ts index 15bc8acfc51..c0c006fdaa5 100644 --- a/extensions/github-copilot/provider-auth.contract.test.ts +++ b/extensions/github-copilot/provider-auth.contract.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover provider auth.contract plugin behavior. import { describeGithubCopilotProviderAuthContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeGithubCopilotProviderAuthContract(() => import("./index.js")); diff --git a/extensions/github-copilot/provider-discovery.contract.test.ts b/extensions/github-copilot/provider-discovery.contract.test.ts index c1488195525..7677598f308 100644 --- a/extensions/github-copilot/provider-discovery.contract.test.ts +++ b/extensions/github-copilot/provider-discovery.contract.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover provider discovery.contract plugin behavior. import { fileURLToPath } from "node:url"; import { describeGithubCopilotProviderDiscoveryContract } from "openclaw/plugin-sdk/provider-test-contracts"; diff --git a/extensions/github-copilot/provider-policy-api.test.ts b/extensions/github-copilot/provider-policy-api.test.ts index 230e11dfe06..931b26fb8d6 100644 --- a/extensions/github-copilot/provider-policy-api.test.ts +++ b/extensions/github-copilot/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover provider policy api plugin behavior. import { describe, expect, it } from "vitest"; import { resolveThinkingProfile } from "./provider-policy-api.js"; diff --git a/extensions/github-copilot/provider-policy-api.ts b/extensions/github-copilot/provider-policy-api.ts index 3cf9f475562..e55483d9dab 100644 --- a/extensions/github-copilot/provider-policy-api.ts +++ b/extensions/github-copilot/provider-policy-api.ts @@ -1,3 +1,4 @@ +// Github Copilot API module exposes the plugin public contract. import type { ProviderDefaultThinkingPolicyContext } from "openclaw/plugin-sdk/core"; import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime"; import { resolveStaticCopilotModelOverride } from "./model-metadata.js"; diff --git a/extensions/github-copilot/provider-runtime.contract.test.ts b/extensions/github-copilot/provider-runtime.contract.test.ts index 59f253a2d33..38c9f728018 100644 --- a/extensions/github-copilot/provider-runtime.contract.test.ts +++ b/extensions/github-copilot/provider-runtime.contract.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover provider runtime.contract plugin behavior. import { describeGithubCopilotProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeGithubCopilotProviderRuntimeContract(() => import("./index.js")); diff --git a/extensions/github-copilot/register.runtime.ts b/extensions/github-copilot/register.runtime.ts index 18bda014384..bc9ce3d80f9 100644 --- a/extensions/github-copilot/register.runtime.ts +++ b/extensions/github-copilot/register.runtime.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements register behavior. import { coerceSecretRef, ensureAuthProfileStore, diff --git a/extensions/github-copilot/replay-policy.ts b/extensions/github-copilot/replay-policy.ts index 718acfc62b9..bfcc1547a38 100644 --- a/extensions/github-copilot/replay-policy.ts +++ b/extensions/github-copilot/replay-policy.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements replay policy behavior. import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime"; export function buildGithubCopilotReplayPolicy(modelId?: string) { diff --git a/extensions/github-copilot/stream.test.ts b/extensions/github-copilot/stream.test.ts index d4955f29ce9..320f629e1d7 100644 --- a/extensions/github-copilot/stream.test.ts +++ b/extensions/github-copilot/stream.test.ts @@ -1,3 +1,4 @@ +// Github Copilot tests cover stream plugin behavior. import { describe, expect, it, vi } from "vitest"; import { buildCopilotDynamicHeaders } from "./stream.js"; import { diff --git a/extensions/github-copilot/stream.ts b/extensions/github-copilot/stream.ts index fc7d5217c53..91a3c3bf88a 100644 --- a/extensions/github-copilot/stream.ts +++ b/extensions/github-copilot/stream.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { Context } from "openclaw/plugin-sdk/llm"; import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/github-copilot/token.ts b/extensions/github-copilot/token.ts index 2e2aecf1b4b..2c8c59189be 100644 --- a/extensions/github-copilot/token.ts +++ b/extensions/github-copilot/token.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements token behavior. export { DEFAULT_COPILOT_API_BASE_URL, deriveCopilotApiBaseUrlFromToken, diff --git a/extensions/github-copilot/usage.ts b/extensions/github-copilot/usage.ts index 7efec13b2c2..c9957458f68 100644 --- a/extensions/github-copilot/usage.ts +++ b/extensions/github-copilot/usage.ts @@ -1,3 +1,4 @@ +// Github Copilot plugin module implements usage behavior. import { buildCopilotIdeHeaders } from "openclaw/plugin-sdk/provider-auth"; import { buildUsageHttpErrorSnapshot, diff --git a/extensions/gmi/index.test.ts b/extensions/gmi/index.test.ts index feddcd782c6..1059b566cae 100644 --- a/extensions/gmi/index.test.ts +++ b/extensions/gmi/index.test.ts @@ -1,3 +1,4 @@ +// Gmi tests cover index plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import plugin from "./index.js"; diff --git a/extensions/gmi/index.ts b/extensions/gmi/index.ts index 541b7f4dc4a..c84f38062cf 100644 --- a/extensions/gmi/index.ts +++ b/extensions/gmi/index.ts @@ -1,3 +1,4 @@ +// Gmi plugin entrypoint registers its OpenClaw integration. import { readConfiguredProviderCatalogEntries } from "openclaw/plugin-sdk/provider-catalog-shared"; import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/gmi/models.ts b/extensions/gmi/models.ts index b324f453ad2..cd83d90e9e4 100644 --- a/extensions/gmi/models.ts +++ b/extensions/gmi/models.ts @@ -1,3 +1,4 @@ +// Gmi plugin module implements models behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/gmi/provider-catalog.ts b/extensions/gmi/provider-catalog.ts index cc7a87ea246..f2f7492291d 100644 --- a/extensions/gmi/provider-catalog.ts +++ b/extensions/gmi/provider-catalog.ts @@ -1,3 +1,4 @@ +// Gmi provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { GMI_BASE_URL, GMI_MODEL_CATALOG, buildGmiModelDefinition } from "./models.js"; diff --git a/extensions/gradium/gradium.live.test.ts b/extensions/gradium/gradium.live.test.ts index 981277492a9..8fe39d9693f 100644 --- a/extensions/gradium/gradium.live.test.ts +++ b/extensions/gradium/gradium.live.test.ts @@ -1,3 +1,4 @@ +// Gradium tests cover gradium plugin behavior. import { writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join } from "node:path"; diff --git a/extensions/gradium/index.ts b/extensions/gradium/index.ts index 1b2a140af71..812cb4e0b92 100644 --- a/extensions/gradium/index.ts +++ b/extensions/gradium/index.ts @@ -1,3 +1,4 @@ +// Gradium plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildGradiumSpeechProvider } from "./speech-provider.js"; diff --git a/extensions/gradium/shared.ts b/extensions/gradium/shared.ts index b21e6b19199..347f2a4f55b 100644 --- a/extensions/gradium/shared.ts +++ b/extensions/gradium/shared.ts @@ -1,3 +1,4 @@ +// Gradium plugin module implements shared behavior. const DEFAULT_GRADIUM_BASE_URL = "https://api.gradium.ai"; export const DEFAULT_GRADIUM_VOICE_ID = "YTpq7expH9539ERJ"; diff --git a/extensions/gradium/speech-provider.test.ts b/extensions/gradium/speech-provider.test.ts index 3901eebf097..85ecf4323c3 100644 --- a/extensions/gradium/speech-provider.test.ts +++ b/extensions/gradium/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Gradium tests cover speech provider plugin behavior. import { installPinnedHostnameTestHooks } from "openclaw/plugin-sdk/test-env"; import { afterEach, describe, expect, it, vi } from "vitest"; import { buildGradiumSpeechProvider } from "./speech-provider.js"; diff --git a/extensions/gradium/speech-provider.ts b/extensions/gradium/speech-provider.ts index 56d55c50e2c..19589016ab4 100644 --- a/extensions/gradium/speech-provider.ts +++ b/extensions/gradium/speech-provider.ts @@ -1,3 +1,4 @@ +// Gradium provider module implements model/runtime integration. import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input"; import type { SpeechDirectiveTokenParseContext, diff --git a/extensions/gradium/tts.test.ts b/extensions/gradium/tts.test.ts index 5500479465c..0ef20484e21 100644 --- a/extensions/gradium/tts.test.ts +++ b/extensions/gradium/tts.test.ts @@ -1,3 +1,4 @@ +// Gradium tests cover tts plugin behavior. import { installPinnedHostnameTestHooks } from "openclaw/plugin-sdk/test-env"; import { afterEach, describe, expect, it, vi } from "vitest"; import { gradiumTTS } from "./tts.js"; diff --git a/extensions/gradium/tts.ts b/extensions/gradium/tts.ts index 63d437c007b..873a408071a 100644 --- a/extensions/gradium/tts.ts +++ b/extensions/gradium/tts.ts @@ -1,3 +1,4 @@ +// Gradium plugin module implements tts behavior. import { assertOkOrThrowProviderError } from "openclaw/plugin-sdk/provider-http"; import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime"; import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime"; diff --git a/extensions/groq/api.ts b/extensions/groq/api.ts index 10aa791d298..ac37556601d 100644 --- a/extensions/groq/api.ts +++ b/extensions/groq/api.ts @@ -1,3 +1,4 @@ +// Groq API module exposes the plugin public contract. import type { ModelCompatConfig } from "openclaw/plugin-sdk/provider-model-shared"; const GROQ_QWEN3_32B_ID = "qwen/qwen3-32b"; diff --git a/extensions/groq/index.test.ts b/extensions/groq/index.test.ts index 220cc4a3b5a..201afcf8732 100644 --- a/extensions/groq/index.test.ts +++ b/extensions/groq/index.test.ts @@ -1,3 +1,4 @@ +// Groq tests cover index plugin behavior. import { capturePluginRegistration } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import { resolveGroqReasoningCompatPatch } from "./api.js"; diff --git a/extensions/groq/index.ts b/extensions/groq/index.ts index a7de6b2e8f8..b9cf2f928e3 100644 --- a/extensions/groq/index.ts +++ b/extensions/groq/index.ts @@ -1,3 +1,4 @@ +// Groq plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { groqMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/groq/media-understanding-provider.ts b/extensions/groq/media-understanding-provider.ts index 1a8efb2d95f..fd33b9c4528 100644 --- a/extensions/groq/media-understanding-provider.ts +++ b/extensions/groq/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Groq provider module implements model/runtime integration. import { transcribeOpenAiCompatibleAudio, type MediaUnderstandingProvider, diff --git a/extensions/groq/test-api.ts b/extensions/groq/test-api.ts index 24bc9ceb6a6..4f07afeb1f5 100644 --- a/extensions/groq/test-api.ts +++ b/extensions/groq/test-api.ts @@ -1 +1,2 @@ +// Groq API module exposes the plugin public contract. export { groqMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/huggingface/api.ts b/extensions/huggingface/api.ts index 1ea86e0b2c7..7dc9fc3c05c 100644 --- a/extensions/huggingface/api.ts +++ b/extensions/huggingface/api.ts @@ -1,3 +1,4 @@ +// Huggingface API module exposes the plugin public contract. export { buildHuggingfaceModelDefinition, discoverHuggingfaceModels, diff --git a/extensions/huggingface/index.test.ts b/extensions/huggingface/index.test.ts index 8b091848dca..13926f5d9ea 100644 --- a/extensions/huggingface/index.test.ts +++ b/extensions/huggingface/index.test.ts @@ -1,3 +1,4 @@ +// Huggingface tests cover index plugin behavior. import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { afterAll, describe, expect, it, vi } from "vitest"; diff --git a/extensions/huggingface/index.ts b/extensions/huggingface/index.ts index e5ba953edc7..7ab83fa4bde 100644 --- a/extensions/huggingface/index.ts +++ b/extensions/huggingface/index.ts @@ -1,3 +1,4 @@ +// Huggingface plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyHuggingfaceConfig, HUGGINGFACE_DEFAULT_MODEL_REF } from "./onboard.js"; import { buildHuggingfaceProvider } from "./provider-catalog.js"; diff --git a/extensions/huggingface/model-discovery-env.ts b/extensions/huggingface/model-discovery-env.ts index a7906062027..c23868b8cd1 100644 --- a/extensions/huggingface/model-discovery-env.ts +++ b/extensions/huggingface/model-discovery-env.ts @@ -1,3 +1,4 @@ +// Huggingface plugin module implements model discovery env behavior. export function isHuggingfaceModelDiscoveryTestEnvironment( env: Record = process.env, ): boolean { diff --git a/extensions/huggingface/models.test.ts b/extensions/huggingface/models.test.ts index 40a8d723d85..60ae22001d3 100644 --- a/extensions/huggingface/models.test.ts +++ b/extensions/huggingface/models.test.ts @@ -1,3 +1,4 @@ +// Huggingface tests cover models plugin behavior. import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import { afterEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/huggingface/models.ts b/extensions/huggingface/models.ts index 49d30b845ee..462c682ed81 100644 --- a/extensions/huggingface/models.ts +++ b/extensions/huggingface/models.ts @@ -1,3 +1,4 @@ +// Huggingface plugin module implements models behavior. import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-types"; import { diff --git a/extensions/huggingface/onboard.ts b/extensions/huggingface/onboard.ts index b1d9e0c9937..ab6728af294 100644 --- a/extensions/huggingface/onboard.ts +++ b/extensions/huggingface/onboard.ts @@ -1,3 +1,4 @@ +// Huggingface setup module handles plugin onboarding behavior. import { createModelCatalogPresetAppliers, type OpenClawConfig, diff --git a/extensions/huggingface/provider-catalog.ts b/extensions/huggingface/provider-catalog.ts index 08cca3121f3..00ec5c1b8dd 100644 --- a/extensions/huggingface/provider-catalog.ts +++ b/extensions/huggingface/provider-catalog.ts @@ -1,3 +1,4 @@ +// Huggingface provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-types"; import { buildHuggingfaceModelDefinition, diff --git a/extensions/image-generation-core/api.ts b/extensions/image-generation-core/api.ts index 24b10106d57..74dce9ee93e 100644 --- a/extensions/image-generation-core/api.ts +++ b/extensions/image-generation-core/api.ts @@ -1,3 +1,4 @@ +// Image Generation Core API module exposes the plugin public contract. export type { AuthProfileStore } from "openclaw/plugin-sdk/image-generation-core"; export { buildNoCapabilityModelConfiguredMessage, diff --git a/extensions/image-generation-core/runtime-api.ts b/extensions/image-generation-core/runtime-api.ts index 1d82b764b40..98c88bc1028 100644 --- a/extensions/image-generation-core/runtime-api.ts +++ b/extensions/image-generation-core/runtime-api.ts @@ -1,3 +1,4 @@ +// Image Generation Core API module exposes the plugin public contract. export { generateImage, listRuntimeImageGenerationProviders, diff --git a/extensions/image-generation-core/src/runtime.test.ts b/extensions/image-generation-core/src/runtime.test.ts index 9fcc56e8852..c76f0e3e792 100644 --- a/extensions/image-generation-core/src/runtime.test.ts +++ b/extensions/image-generation-core/src/runtime.test.ts @@ -1,3 +1,4 @@ +// Image Generation Core tests cover runtime plugin behavior. import { afterAll, describe, expect, it, vi } from "vitest"; const sdkExports = vi.hoisted(() => ({ diff --git a/extensions/image-generation-core/src/runtime.ts b/extensions/image-generation-core/src/runtime.ts index 224489654ee..2e473e714be 100644 --- a/extensions/image-generation-core/src/runtime.ts +++ b/extensions/image-generation-core/src/runtime.ts @@ -1,3 +1,4 @@ +// Image Generation Core plugin module implements runtime behavior. export { generateImage, listRuntimeImageGenerationProviders, diff --git a/extensions/inworld/index.ts b/extensions/inworld/index.ts index 891e95109f6..ff2752b024e 100644 --- a/extensions/inworld/index.ts +++ b/extensions/inworld/index.ts @@ -1,3 +1,4 @@ +// Inworld plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildInworldSpeechProvider } from "./speech-provider.js"; diff --git a/extensions/inworld/inworld.live.test.ts b/extensions/inworld/inworld.live.test.ts index 279216ea0c6..f313cfb3ea7 100644 --- a/extensions/inworld/inworld.live.test.ts +++ b/extensions/inworld/inworld.live.test.ts @@ -1,3 +1,4 @@ +// Inworld tests cover inworld plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/inworld/speech-provider.test.ts b/extensions/inworld/speech-provider.test.ts index a6670ec1e06..f66e443cd3d 100644 --- a/extensions/inworld/speech-provider.test.ts +++ b/extensions/inworld/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Inworld tests cover speech provider plugin behavior. import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; const { inworldTTSMock, listInworldVoicesMock } = vi.hoisted(() => ({ diff --git a/extensions/inworld/speech-provider.ts b/extensions/inworld/speech-provider.ts index deebeb5d2ba..f1c77da66e1 100644 --- a/extensions/inworld/speech-provider.ts +++ b/extensions/inworld/speech-provider.ts @@ -1,3 +1,4 @@ +// Inworld provider module implements model/runtime integration. import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input"; import type { SpeechDirectiveTokenParseContext, diff --git a/extensions/inworld/tts.test.ts b/extensions/inworld/tts.test.ts index 2e2e9fddc3d..a9b0f50ac03 100644 --- a/extensions/inworld/tts.test.ts +++ b/extensions/inworld/tts.test.ts @@ -1,3 +1,4 @@ +// Inworld tests cover tts plugin behavior. import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; const { fetchWithSsrFGuardMock } = vi.hoisted(() => ({ diff --git a/extensions/inworld/tts.ts b/extensions/inworld/tts.ts index 3261f63073d..a0da553e44f 100644 --- a/extensions/inworld/tts.ts +++ b/extensions/inworld/tts.ts @@ -1,3 +1,4 @@ +// Inworld plugin module implements tts behavior. import type { SpeechVoiceOption } from "openclaw/plugin-sdk/speech-core"; import { fetchWithSsrFGuard, type SsrFPolicy } from "openclaw/plugin-sdk/ssrf-runtime"; diff --git a/extensions/kilocode/api.ts b/extensions/kilocode/api.ts index 1d73f53ad63..d91ecbda9bc 100644 --- a/extensions/kilocode/api.ts +++ b/extensions/kilocode/api.ts @@ -1,3 +1,4 @@ +// Kilocode API module exposes the plugin public contract. export { buildKilocodeProvider, buildKilocodeProviderWithDiscovery } from "./provider-catalog.js"; export { buildKilocodeModelDefinition, diff --git a/extensions/kilocode/implicit-provider.test.ts b/extensions/kilocode/implicit-provider.test.ts index 23d9d64f853..2917f09848b 100644 --- a/extensions/kilocode/implicit-provider.test.ts +++ b/extensions/kilocode/implicit-provider.test.ts @@ -1,3 +1,4 @@ +// Kilocode tests cover implicit provider plugin behavior. import { describe, expect, it } from "vitest"; import { buildKilocodeProvider } from "./provider-catalog.js"; diff --git a/extensions/kilocode/index.test.ts b/extensions/kilocode/index.test.ts index aa8ca7a1dac..fcfadbfd3a9 100644 --- a/extensions/kilocode/index.test.ts +++ b/extensions/kilocode/index.test.ts @@ -1,3 +1,4 @@ +// Kilocode tests cover index plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; diff --git a/extensions/kilocode/index.ts b/extensions/kilocode/index.ts index 4fbbf84aeca..f5bfb3ddf07 100644 --- a/extensions/kilocode/index.ts +++ b/extensions/kilocode/index.ts @@ -1,3 +1,4 @@ +// Kilocode plugin entrypoint registers its OpenClaw integration. import { readConfiguredProviderCatalogEntries } from "openclaw/plugin-sdk/provider-catalog-shared"; import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { PASSTHROUGH_GEMINI_REPLAY_HOOKS } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/kilocode/onboard.test.ts b/extensions/kilocode/onboard.test.ts index 897b63ca57e..90de1c7d472 100644 --- a/extensions/kilocode/onboard.test.ts +++ b/extensions/kilocode/onboard.test.ts @@ -1,3 +1,4 @@ +// Kilocode tests cover onboard plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { resolveEnvApiKey } from "openclaw/plugin-sdk/provider-auth-runtime"; import { resolveAgentModelPrimaryValue } from "openclaw/plugin-sdk/provider-onboard"; diff --git a/extensions/kilocode/onboard.ts b/extensions/kilocode/onboard.ts index f18023f3c98..581eb300a94 100644 --- a/extensions/kilocode/onboard.ts +++ b/extensions/kilocode/onboard.ts @@ -1,3 +1,4 @@ +// Kilocode setup module handles plugin onboarding behavior. import { createModelCatalogPresetAppliers, type OpenClawConfig, diff --git a/extensions/kilocode/provider-catalog.ts b/extensions/kilocode/provider-catalog.ts index c7e17a499da..2460a62c361 100644 --- a/extensions/kilocode/provider-catalog.ts +++ b/extensions/kilocode/provider-catalog.ts @@ -1,3 +1,4 @@ +// Kilocode provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { discoverKilocodeModels, diff --git a/extensions/kilocode/provider-models.test.ts b/extensions/kilocode/provider-models.test.ts index e624ba023b0..dcb77a16ca2 100644 --- a/extensions/kilocode/provider-models.test.ts +++ b/extensions/kilocode/provider-models.test.ts @@ -1,3 +1,4 @@ +// Kilocode tests cover provider models plugin behavior. import { afterAll, describe, expect, it, vi } from "vitest"; const { fetchWithSsrFGuardMock } = vi.hoisted(() => ({ diff --git a/extensions/kilocode/provider-models.ts b/extensions/kilocode/provider-models.ts index c07db08df0a..21f3af0eb92 100644 --- a/extensions/kilocode/provider-models.ts +++ b/extensions/kilocode/provider-models.ts @@ -1,3 +1,4 @@ +// Kilocode provider module implements model/runtime integration. import { readProviderJsonArrayFieldResponse } from "openclaw/plugin-sdk/provider-http"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { createSubsystemLogger } from "openclaw/plugin-sdk/runtime-env"; diff --git a/extensions/kilocode/stream.ts b/extensions/kilocode/stream.ts index d3f9892ff8a..e3a7fbce806 100644 --- a/extensions/kilocode/stream.ts +++ b/extensions/kilocode/stream.ts @@ -1,3 +1,4 @@ +// Kilocode plugin module implements stream behavior. import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { resolveProviderRequestHeaders } from "openclaw/plugin-sdk/provider-http"; import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime"; diff --git a/extensions/kimi-coding/api.ts b/extensions/kimi-coding/api.ts index 95617429cd0..94432ed0075 100644 --- a/extensions/kimi-coding/api.ts +++ b/extensions/kimi-coding/api.ts @@ -1,3 +1,4 @@ +// Kimi Coding API module exposes the plugin public contract. export { buildKimiCodingProvider, KIMI_CODING_BASE_URL, diff --git a/extensions/kimi-coding/implicit-provider.test.ts b/extensions/kimi-coding/implicit-provider.test.ts index 9d6421397ea..3a9cde833c6 100644 --- a/extensions/kimi-coding/implicit-provider.test.ts +++ b/extensions/kimi-coding/implicit-provider.test.ts @@ -1,3 +1,4 @@ +// Kimi Coding tests cover implicit provider plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import plugin from "./index.js"; diff --git a/extensions/kimi-coding/index.test.ts b/extensions/kimi-coding/index.test.ts index 4cfd6b891d8..ad5c7bee465 100644 --- a/extensions/kimi-coding/index.test.ts +++ b/extensions/kimi-coding/index.test.ts @@ -1,3 +1,4 @@ +// Kimi Coding tests cover index plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import plugin from "./index.js"; diff --git a/extensions/kimi-coding/index.ts b/extensions/kimi-coding/index.ts index da1fa248a3e..79cb733c46f 100644 --- a/extensions/kimi-coding/index.ts +++ b/extensions/kimi-coding/index.ts @@ -1,3 +1,4 @@ +// Kimi Coding plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/kimi-coding/onboard.test.ts b/extensions/kimi-coding/onboard.test.ts index a1df2668c47..20e9ac86d52 100644 --- a/extensions/kimi-coding/onboard.test.ts +++ b/extensions/kimi-coding/onboard.test.ts @@ -1,3 +1,4 @@ +// Kimi Coding tests cover onboard plugin behavior. import { resolveAgentModelPrimaryValue } from "openclaw/plugin-sdk/provider-onboard"; import { describe, expect, it } from "vitest"; import { diff --git a/extensions/kimi-coding/onboard.ts b/extensions/kimi-coding/onboard.ts index 1e8e6061af7..2fe7d51eafe 100644 --- a/extensions/kimi-coding/onboard.ts +++ b/extensions/kimi-coding/onboard.ts @@ -1,3 +1,4 @@ +// Kimi Coding setup module handles plugin onboarding behavior. import { createDefaultModelPresetAppliers, type OpenClawConfig, diff --git a/extensions/kimi-coding/provider-catalog.test.ts b/extensions/kimi-coding/provider-catalog.test.ts index c9d7469cf13..b60728b5798 100644 --- a/extensions/kimi-coding/provider-catalog.test.ts +++ b/extensions/kimi-coding/provider-catalog.test.ts @@ -1,3 +1,4 @@ +// Kimi Coding tests cover provider catalog plugin behavior. import { describe, expect, it } from "vitest"; import { buildKimiCodingProvider, normalizeKimiCodingModelId } from "./provider-catalog.js"; diff --git a/extensions/kimi-coding/provider-catalog.ts b/extensions/kimi-coding/provider-catalog.ts index 54af0a6650c..11a0e8ad07c 100644 --- a/extensions/kimi-coding/provider-catalog.ts +++ b/extensions/kimi-coding/provider-catalog.ts @@ -1,3 +1,4 @@ +// Kimi Coding provider module implements model/runtime integration. import type { ModelDefinitionConfig, ModelProviderConfig, diff --git a/extensions/kimi-coding/replay-policy.test.ts b/extensions/kimi-coding/replay-policy.test.ts index 3b86ad18d83..53320dc506c 100644 --- a/extensions/kimi-coding/replay-policy.test.ts +++ b/extensions/kimi-coding/replay-policy.test.ts @@ -1,3 +1,4 @@ +// Kimi Coding tests cover replay policy plugin behavior. import { describe, expect, it } from "vitest"; import { KIMI_REPLAY_POLICY } from "./replay-policy.js"; diff --git a/extensions/kimi-coding/replay-policy.ts b/extensions/kimi-coding/replay-policy.ts index c3c967b9f02..33e0b2ac4aa 100644 --- a/extensions/kimi-coding/replay-policy.ts +++ b/extensions/kimi-coding/replay-policy.ts @@ -1,3 +1,4 @@ +// Kimi Coding plugin module implements replay policy behavior. export const KIMI_REPLAY_POLICY = { preserveSignatures: false, }; diff --git a/extensions/kimi-coding/stream.test.ts b/extensions/kimi-coding/stream.test.ts index 63fd1e48186..cd1e06ce3f9 100644 --- a/extensions/kimi-coding/stream.test.ts +++ b/extensions/kimi-coding/stream.test.ts @@ -1,3 +1,4 @@ +// Kimi Coding tests cover stream plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { describe, expect, it } from "vitest"; diff --git a/extensions/kimi-coding/stream.ts b/extensions/kimi-coding/stream.ts index 4e84d1c0bae..7e112d23e0c 100644 --- a/extensions/kimi-coding/stream.ts +++ b/extensions/kimi-coding/stream.ts @@ -1,3 +1,4 @@ +// Kimi Coding plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import { streamSimple, diff --git a/extensions/litellm/api.ts b/extensions/litellm/api.ts index 0340b3ad5e8..b8f971f84b5 100644 --- a/extensions/litellm/api.ts +++ b/extensions/litellm/api.ts @@ -1,3 +1,4 @@ +// Litellm API module exposes the plugin public contract. export { applyLitellmConfig, applyLitellmProviderConfig, diff --git a/extensions/litellm/image-generation-provider.test.ts b/extensions/litellm/image-generation-provider.test.ts index e6a6997f920..965598e0976 100644 --- a/extensions/litellm/image-generation-provider.test.ts +++ b/extensions/litellm/image-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Litellm tests cover image generation provider plugin behavior. import { afterAll, afterEach, describe, expect, it, vi } from "vitest"; import { buildLitellmImageGenerationProvider } from "./image-generation-provider.js"; diff --git a/extensions/litellm/image-generation-provider.ts b/extensions/litellm/image-generation-provider.ts index fce768db132..76050744887 100644 --- a/extensions/litellm/image-generation-provider.ts +++ b/extensions/litellm/image-generation-provider.ts @@ -1,3 +1,4 @@ +// Litellm provider module implements model/runtime integration. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { createOpenAiCompatibleImageGenerationProvider, diff --git a/extensions/litellm/index.test.ts b/extensions/litellm/index.test.ts index 0b3bb581eb0..db2e97d1912 100644 --- a/extensions/litellm/index.test.ts +++ b/extensions/litellm/index.test.ts @@ -1,3 +1,4 @@ +// Litellm tests cover index plugin behavior. import { mkdtempSync, rmSync } from "node:fs"; import { tmpdir } from "node:os"; import { join } from "node:path"; diff --git a/extensions/litellm/index.ts b/extensions/litellm/index.ts index dfb18601a70..64d090f35ab 100644 --- a/extensions/litellm/index.ts +++ b/extensions/litellm/index.ts @@ -1,3 +1,4 @@ +// Litellm plugin entrypoint registers its OpenClaw integration. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { definePluginEntry, diff --git a/extensions/litellm/onboard.test.ts b/extensions/litellm/onboard.test.ts index 9f03f0ccc39..6be011c4a7b 100644 --- a/extensions/litellm/onboard.test.ts +++ b/extensions/litellm/onboard.test.ts @@ -1,3 +1,4 @@ +// Litellm tests cover onboard plugin behavior. import { expectProviderOnboardMergedLegacyConfig } from "openclaw/plugin-sdk/provider-test-contracts"; import { describe, expect, it } from "vitest"; import { applyLitellmProviderConfig } from "./onboard.js"; diff --git a/extensions/litellm/onboard.ts b/extensions/litellm/onboard.ts index f6f1c169faa..66fa85b62dd 100644 --- a/extensions/litellm/onboard.ts +++ b/extensions/litellm/onboard.ts @@ -1,3 +1,4 @@ +// Litellm setup module handles plugin onboarding behavior. import { createDefaultModelPresetAppliers, type ModelDefinitionConfig, diff --git a/extensions/litellm/provider-catalog.ts b/extensions/litellm/provider-catalog.ts index dc304b8f9ef..14400b018e6 100644 --- a/extensions/litellm/provider-catalog.ts +++ b/extensions/litellm/provider-catalog.ts @@ -1,3 +1,4 @@ +// Litellm provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { buildLitellmModelDefinition, LITELLM_BASE_URL } from "./onboard.js"; diff --git a/extensions/llm-task/api.ts b/extensions/llm-task/api.ts index a1ad56d8cc7..528238d1a35 100644 --- a/extensions/llm-task/api.ts +++ b/extensions/llm-task/api.ts @@ -1,3 +1,4 @@ +// Llm Task API module exposes the plugin public contract. export { resolvePreferredOpenClawTmpDir, withTempWorkspace } from "./src/runtime-api.js"; export { definePluginEntry, diff --git a/extensions/llm-task/index.ts b/extensions/llm-task/index.ts index 895af781a8b..eb36bd73b5b 100644 --- a/extensions/llm-task/index.ts +++ b/extensions/llm-task/index.ts @@ -1,3 +1,4 @@ +// Llm Task plugin entrypoint registers its OpenClaw integration. import { optionalPositiveIntegerSchema } from "openclaw/plugin-sdk/channel-actions"; import { defineToolPlugin } from "openclaw/plugin-sdk/tool-plugin"; import { Type } from "typebox"; diff --git a/extensions/llm-task/src/llm-task-tool.test.ts b/extensions/llm-task/src/llm-task-tool.test.ts index 62670931ae0..ba60d08c503 100644 --- a/extensions/llm-task/src/llm-task-tool.test.ts +++ b/extensions/llm-task/src/llm-task-tool.test.ts @@ -1,3 +1,4 @@ +// Llm Task tests cover llm task tool plugin behavior. import { afterAll, beforeEach, describe, expect, it, vi } from "vitest"; vi.mock("../api.js", async () => { diff --git a/extensions/llm-task/src/llm-task-tool.ts b/extensions/llm-task/src/llm-task-tool.ts index 55fdfe2b8f8..f6b17bea792 100644 --- a/extensions/llm-task/src/llm-task-tool.ts +++ b/extensions/llm-task/src/llm-task-tool.ts @@ -1,3 +1,4 @@ +// Llm Task plugin module implements llm task tool behavior. import path from "node:path"; import { buildModelAliasIndex, resolveModelRefFromString } from "openclaw/plugin-sdk/agent-runtime"; import { diff --git a/extensions/llm-task/src/runtime-api.ts b/extensions/llm-task/src/runtime-api.ts index cd2e8654f39..98e0043bf6c 100644 --- a/extensions/llm-task/src/runtime-api.ts +++ b/extensions/llm-task/src/runtime-api.ts @@ -1 +1,2 @@ +// Llm Task API module exposes the plugin public contract. export { resolvePreferredOpenClawTmpDir, withTempWorkspace } from "openclaw/plugin-sdk/temp-path"; diff --git a/extensions/lmstudio/api.ts b/extensions/lmstudio/api.ts index 162078e8e50..e0c3cda32a2 100644 --- a/extensions/lmstudio/api.ts +++ b/extensions/lmstudio/api.ts @@ -1,3 +1,4 @@ +// Lmstudio API module exposes the plugin public contract. export { buildLmstudioAuthHeaders, buildLmstudioModelName, diff --git a/extensions/lmstudio/index.test.ts b/extensions/lmstudio/index.test.ts index dd43e3d6bef..b4918bc4c93 100644 --- a/extensions/lmstudio/index.test.ts +++ b/extensions/lmstudio/index.test.ts @@ -1,3 +1,4 @@ +// Lmstudio tests cover index plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry"; import { capturePluginRegistration } from "openclaw/plugin-sdk/plugin-test-runtime"; import { CUSTOM_LOCAL_AUTH_MARKER } from "openclaw/plugin-sdk/provider-auth"; diff --git a/extensions/lmstudio/index.ts b/extensions/lmstudio/index.ts index 2e114242624..48f84ff1215 100644 --- a/extensions/lmstudio/index.ts +++ b/extensions/lmstudio/index.ts @@ -1,3 +1,4 @@ +// Lmstudio plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type OpenClawPluginApi, diff --git a/extensions/lmstudio/memory-embedding-adapter.ts b/extensions/lmstudio/memory-embedding-adapter.ts index ea3e9ffd7db..e188da0f2d6 100644 --- a/extensions/lmstudio/memory-embedding-adapter.ts +++ b/extensions/lmstudio/memory-embedding-adapter.ts @@ -1,3 +1,4 @@ +// Lmstudio plugin module implements memory embedding adapter behavior. import { sanitizeEmbeddingCacheHeaders, type MemoryEmbeddingProviderAdapter, diff --git a/extensions/lmstudio/runtime-api.ts b/extensions/lmstudio/runtime-api.ts index 58e47d6ea77..d3c54e068bc 100644 --- a/extensions/lmstudio/runtime-api.ts +++ b/extensions/lmstudio/runtime-api.ts @@ -1,3 +1,4 @@ +// Lmstudio API module exposes the plugin public contract. export { LMSTUDIO_DEFAULT_API_KEY_ENV_VAR, LMSTUDIO_DEFAULT_BASE_URL, diff --git a/extensions/lmstudio/src/api.ts b/extensions/lmstudio/src/api.ts index 135cd5a22e7..009311d61b9 100644 --- a/extensions/lmstudio/src/api.ts +++ b/extensions/lmstudio/src/api.ts @@ -1,3 +1,4 @@ +// Lmstudio API module exposes the plugin public contract. export { LMSTUDIO_DEFAULT_API_KEY_ENV_VAR, LMSTUDIO_DEFAULT_BASE_URL, diff --git a/extensions/lmstudio/src/embedding-provider.ts b/extensions/lmstudio/src/embedding-provider.ts index e56ac77be31..bcc906a1a61 100644 --- a/extensions/lmstudio/src/embedding-provider.ts +++ b/extensions/lmstudio/src/embedding-provider.ts @@ -1,3 +1,4 @@ +// Lmstudio provider module implements model/runtime integration. import { createSubsystemLogger } from "openclaw/plugin-sdk/logging-core"; import { buildRemoteBaseUrlPolicy, diff --git a/extensions/lmstudio/src/models.fetch.ts b/extensions/lmstudio/src/models.fetch.ts index 418902b1bd2..9bf67eacb1a 100644 --- a/extensions/lmstudio/src/models.fetch.ts +++ b/extensions/lmstudio/src/models.fetch.ts @@ -1,3 +1,4 @@ +// Lmstudio plugin module implements models.fetch behavior. import { createSubsystemLogger } from "openclaw/plugin-sdk/logging-core"; import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime"; import { readProviderJsonArrayFieldResponse } from "openclaw/plugin-sdk/provider-http"; diff --git a/extensions/lmstudio/src/models.test.ts b/extensions/lmstudio/src/models.test.ts index 8d9df900f4a..5de8dfd3b6c 100644 --- a/extensions/lmstudio/src/models.test.ts +++ b/extensions/lmstudio/src/models.test.ts @@ -1,3 +1,4 @@ +// Lmstudio tests cover models plugin behavior. import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import { SELF_HOSTED_DEFAULT_CONTEXT_WINDOW, diff --git a/extensions/lmstudio/src/models.ts b/extensions/lmstudio/src/models.ts index 8ac8494a830..e2efd7b7123 100644 --- a/extensions/lmstudio/src/models.ts +++ b/extensions/lmstudio/src/models.ts @@ -1,3 +1,4 @@ +// Lmstudio plugin module implements models behavior. import type { ModelDefinitionConfig, ModelProviderConfig, diff --git a/extensions/lmstudio/src/provider-auth.ts b/extensions/lmstudio/src/provider-auth.ts index 46737647e9e..92c88a7c76a 100644 --- a/extensions/lmstudio/src/provider-auth.ts +++ b/extensions/lmstudio/src/provider-auth.ts @@ -1,3 +1,4 @@ +// Lmstudio provider module implements model/runtime integration. import { CUSTOM_LOCAL_AUTH_MARKER, hasConfiguredSecretInput, diff --git a/extensions/lmstudio/src/runtime.test.ts b/extensions/lmstudio/src/runtime.test.ts index 3625c6e272f..10940288195 100644 --- a/extensions/lmstudio/src/runtime.test.ts +++ b/extensions/lmstudio/src/runtime.test.ts @@ -1,3 +1,4 @@ +// Lmstudio tests cover runtime plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-auth"; import { CUSTOM_LOCAL_AUTH_MARKER } from "openclaw/plugin-sdk/provider-auth"; import { afterAll, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/lmstudio/src/runtime.ts b/extensions/lmstudio/src/runtime.ts index aa3ffe8ba41..883d33bcbc9 100644 --- a/extensions/lmstudio/src/runtime.ts +++ b/extensions/lmstudio/src/runtime.ts @@ -1,3 +1,4 @@ +// Lmstudio plugin module implements runtime behavior. import { CUSTOM_LOCAL_AUTH_MARKER, isKnownEnvApiKeyMarker, diff --git a/extensions/lmstudio/src/setup.test.ts b/extensions/lmstudio/src/setup.test.ts index 57c02e6018c..98296ee0fe2 100644 --- a/extensions/lmstudio/src/setup.test.ts +++ b/extensions/lmstudio/src/setup.test.ts @@ -1,3 +1,4 @@ +// Lmstudio tests cover setup plugin behavior. import { CUSTOM_LOCAL_AUTH_MARKER } from "openclaw/plugin-sdk/provider-auth"; import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-auth"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/lmstudio/src/setup.ts b/extensions/lmstudio/src/setup.ts index 0320e9c01ba..7454244dcca 100644 --- a/extensions/lmstudio/src/setup.ts +++ b/extensions/lmstudio/src/setup.ts @@ -1,3 +1,4 @@ +// Lmstudio setup module handles plugin onboarding behavior. import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime"; import { removeProviderAuthProfilesWithLock, diff --git a/extensions/lmstudio/src/stream.test.ts b/extensions/lmstudio/src/stream.test.ts index b0de39698ec..479b5dc56d5 100644 --- a/extensions/lmstudio/src/stream.test.ts +++ b/extensions/lmstudio/src/stream.test.ts @@ -1,3 +1,4 @@ +// Lmstudio tests cover stream plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import { createAssistantMessageEventStream } from "openclaw/plugin-sdk/llm"; import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/lmstudio/src/stream.ts b/extensions/lmstudio/src/stream.ts index 270e4f0cf79..0f83e026205 100644 --- a/extensions/lmstudio/src/stream.ts +++ b/extensions/lmstudio/src/stream.ts @@ -1,3 +1,4 @@ +// Lmstudio plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import { streamSimple } from "openclaw/plugin-sdk/llm"; import { createSubsystemLogger } from "openclaw/plugin-sdk/logging-core"; diff --git a/extensions/lobster/index.ts b/extensions/lobster/index.ts index 901b9c7c546..78aaf14962d 100644 --- a/extensions/lobster/index.ts +++ b/extensions/lobster/index.ts @@ -1,3 +1,4 @@ +// Lobster plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import type { AnyAgentTool, OpenClawPluginApi, OpenClawPluginToolFactory } from "./runtime-api.js"; import { createLobsterTool } from "./src/lobster-tool.js"; diff --git a/extensions/lobster/runtime-api.ts b/extensions/lobster/runtime-api.ts index d883e0853b3..4725adf2ab9 100644 --- a/extensions/lobster/runtime-api.ts +++ b/extensions/lobster/runtime-api.ts @@ -1,3 +1,4 @@ +// Lobster API module exposes the plugin public contract. export { definePluginEntry } from "openclaw/plugin-sdk/core"; export type { AnyAgentTool, diff --git a/extensions/lobster/src/lobster-ajv-cache.ts b/extensions/lobster/src/lobster-ajv-cache.ts index f5a944733fb..e1a11f1be9b 100644 --- a/extensions/lobster/src/lobster-ajv-cache.ts +++ b/extensions/lobster/src/lobster-ajv-cache.ts @@ -1,3 +1,4 @@ +// Lobster plugin module implements lobster ajv cache behavior. import { createHash } from "node:crypto"; import { createRequire } from "node:module"; import { pathToFileURL } from "node:url"; diff --git a/extensions/lobster/src/lobster-core.d.ts b/extensions/lobster/src/lobster-core.d.ts index 5a16f0d4da9..bcf8efe91be 100644 --- a/extensions/lobster/src/lobster-core.d.ts +++ b/extensions/lobster/src/lobster-core.d.ts @@ -1,3 +1,4 @@ +// Lobster type declarations define plugin contracts. declare module "@clawdbot/lobster/core" { type LobsterApprovalRequest = { type: "approval_request"; diff --git a/extensions/lobster/src/lobster-runner.test.ts b/extensions/lobster/src/lobster-runner.test.ts index 0c432418db0..c813be2f72e 100644 --- a/extensions/lobster/src/lobster-runner.test.ts +++ b/extensions/lobster/src/lobster-runner.test.ts @@ -1,3 +1,4 @@ +// Lobster tests cover lobster runner plugin behavior. import fs from "node:fs/promises"; import { createRequire } from "node:module"; import os from "node:os"; diff --git a/extensions/lobster/src/lobster-runner.ts b/extensions/lobster/src/lobster-runner.ts index aaf134bde82..3f7181fc09a 100644 --- a/extensions/lobster/src/lobster-runner.ts +++ b/extensions/lobster/src/lobster-runner.ts @@ -1,3 +1,4 @@ +// Lobster plugin module implements lobster runner behavior. import { readFileSync } from "node:fs"; import { stat } from "node:fs/promises"; import { createRequire } from "node:module"; diff --git a/extensions/lobster/src/lobster-taskflow.test.ts b/extensions/lobster/src/lobster-taskflow.test.ts index 5a6ba1533de..fcbe7f24e42 100644 --- a/extensions/lobster/src/lobster-taskflow.test.ts +++ b/extensions/lobster/src/lobster-taskflow.test.ts @@ -1,3 +1,4 @@ +// Lobster tests cover lobster taskflow plugin behavior. import { describe, expect, it, vi } from "vitest"; import type { LobsterRunner } from "./lobster-runner.js"; import { resumeManagedLobsterFlow, runManagedLobsterFlow } from "./lobster-taskflow.js"; diff --git a/extensions/lobster/src/lobster-taskflow.ts b/extensions/lobster/src/lobster-taskflow.ts index 098ec7e10bb..70a5599ae49 100644 --- a/extensions/lobster/src/lobster-taskflow.ts +++ b/extensions/lobster/src/lobster-taskflow.ts @@ -1,3 +1,4 @@ +// Lobster plugin module implements lobster taskflow behavior. import type { OpenClawPluginApi } from "../runtime-api.js"; import type { LobsterEnvelope, LobsterRunner, LobsterRunnerParams } from "./lobster-runner.js"; diff --git a/extensions/lobster/src/lobster-tool.test.ts b/extensions/lobster/src/lobster-tool.test.ts index f336acb6a3a..9c6d0ff333b 100644 --- a/extensions/lobster/src/lobster-tool.test.ts +++ b/extensions/lobster/src/lobster-tool.test.ts @@ -1,3 +1,4 @@ +// Lobster tests cover lobster tool plugin behavior. import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { describe, expect, it, vi } from "vitest"; import type { OpenClawPluginApi, OpenClawPluginToolContext } from "../runtime-api.js"; diff --git a/extensions/lobster/src/lobster-tool.ts b/extensions/lobster/src/lobster-tool.ts index 50c66e03ecf..ce46a334c08 100644 --- a/extensions/lobster/src/lobster-tool.ts +++ b/extensions/lobster/src/lobster-tool.ts @@ -1,3 +1,4 @@ +// Lobster plugin module implements lobster tool behavior. import { optionalNonNegativeIntegerSchema, optionalPositiveIntegerSchema, diff --git a/extensions/lobster/src/taskflow-test-helpers.ts b/extensions/lobster/src/taskflow-test-helpers.ts index 90e8e28d51f..9587ab36fc2 100644 --- a/extensions/lobster/src/taskflow-test-helpers.ts +++ b/extensions/lobster/src/taskflow-test-helpers.ts @@ -1,3 +1,4 @@ +// Lobster helper module supports taskflow test helpers behavior. import { vi } from "vitest"; import type { OpenClawPluginApi } from "../runtime-api.js"; diff --git a/extensions/media-understanding-core/runtime-api.ts b/extensions/media-understanding-core/runtime-api.ts index 990b84fd348..b1ad9a1caee 100644 --- a/extensions/media-understanding-core/runtime-api.ts +++ b/extensions/media-understanding-core/runtime-api.ts @@ -1,3 +1,4 @@ +// Media Understanding Core API module exposes the plugin public contract. export { describeImageFile, describeImageFileWithModel, diff --git a/extensions/media-understanding-core/src/runtime.ts b/extensions/media-understanding-core/src/runtime.ts index 70862ad8f7f..87e783b612e 100644 --- a/extensions/media-understanding-core/src/runtime.ts +++ b/extensions/media-understanding-core/src/runtime.ts @@ -1,3 +1,4 @@ +// Media Understanding Core plugin module implements runtime behavior. export { describeImageFile, describeImageFileWithModel, diff --git a/extensions/memory-lancedb/api.ts b/extensions/memory-lancedb/api.ts index e0935591d64..682e624ec4b 100644 --- a/extensions/memory-lancedb/api.ts +++ b/extensions/memory-lancedb/api.ts @@ -1,2 +1,3 @@ +// Memory Lancedb API module exposes the plugin public contract. export { definePluginEntry, type OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry"; export { resolveStateDir } from "openclaw/plugin-sdk/state-paths"; diff --git a/extensions/memory-lancedb/cli-metadata.ts b/extensions/memory-lancedb/cli-metadata.ts index e0d12481a87..4241d653c3c 100644 --- a/extensions/memory-lancedb/cli-metadata.ts +++ b/extensions/memory-lancedb/cli-metadata.ts @@ -1,3 +1,4 @@ +// Memory Lancedb plugin module implements cli metadata behavior. import { definePluginEntry } from "openclaw/plugin-sdk/core"; export default definePluginEntry({ diff --git a/extensions/memory-lancedb/config.test.ts b/extensions/memory-lancedb/config.test.ts index 15e9b2c585b..139f61b255c 100644 --- a/extensions/memory-lancedb/config.test.ts +++ b/extensions/memory-lancedb/config.test.ts @@ -1,3 +1,4 @@ +// Memory Lancedb tests cover config plugin behavior. import fs from "node:fs"; import { type JsonSchemaObject, diff --git a/extensions/memory-lancedb/config.ts b/extensions/memory-lancedb/config.ts index 229a06339d5..d22e5498d2a 100644 --- a/extensions/memory-lancedb/config.ts +++ b/extensions/memory-lancedb/config.ts @@ -1,3 +1,4 @@ +// Memory Lancedb helper module supports config behavior. import fs from "node:fs"; import { homedir } from "node:os"; import { join } from "node:path"; diff --git a/extensions/memory-lancedb/lancedb-runtime.ts b/extensions/memory-lancedb/lancedb-runtime.ts index 45108515d65..4eae6fac538 100644 --- a/extensions/memory-lancedb/lancedb-runtime.ts +++ b/extensions/memory-lancedb/lancedb-runtime.ts @@ -1,3 +1,4 @@ +// Memory Lancedb plugin module implements lancedb runtime behavior. type LanceDbModule = typeof import("@lancedb/lancedb"); export type LanceDbRuntimeLogger = { diff --git a/extensions/memory-lancedb/memory-lancedb.live.test.ts b/extensions/memory-lancedb/memory-lancedb.live.test.ts index dd983ea2c7b..86d2758fe00 100644 --- a/extensions/memory-lancedb/memory-lancedb.live.test.ts +++ b/extensions/memory-lancedb/memory-lancedb.live.test.ts @@ -1,3 +1,4 @@ +// Memory Lancedb tests cover memory lancedb plugin behavior. import { describe, expect, test } from "vitest"; import { installTmpDirHarness } from "./test-helpers.js"; diff --git a/extensions/memory-lancedb/test-helpers.ts b/extensions/memory-lancedb/test-helpers.ts index 91df15bafb4..6d863f6db46 100644 --- a/extensions/memory-lancedb/test-helpers.ts +++ b/extensions/memory-lancedb/test-helpers.ts @@ -1,3 +1,4 @@ +// Memory Lancedb helper module supports test helpers behavior. import fs from "node:fs/promises"; import path from "node:path"; import { resolvePreferredOpenClawTmpDir } from "openclaw/plugin-sdk/temp-path"; diff --git a/extensions/microsoft-foundry/auth.ts b/extensions/microsoft-foundry/auth.ts index f4b01ab9bab..a91e0b89b17 100644 --- a/extensions/microsoft-foundry/auth.ts +++ b/extensions/microsoft-foundry/auth.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry plugin module implements auth behavior. import type { ProviderAuthContext, ProviderAuthMethod, diff --git a/extensions/microsoft-foundry/cli.ts b/extensions/microsoft-foundry/cli.ts index 517813280dd..ba1461f9d45 100644 --- a/extensions/microsoft-foundry/cli.ts +++ b/extensions/microsoft-foundry/cli.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry plugin module implements cli behavior. import { execFile, execFileSync, spawn } from "node:child_process"; import { normalizeOptionalString, diff --git a/extensions/microsoft-foundry/index.test.ts b/extensions/microsoft-foundry/index.test.ts index 5ab764b12f7..cab595c69a7 100644 --- a/extensions/microsoft-foundry/index.test.ts +++ b/extensions/microsoft-foundry/index.test.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry tests cover index plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/microsoft-foundry/index.ts b/extensions/microsoft-foundry/index.ts index db450301446..85a3ffbeca0 100644 --- a/extensions/microsoft-foundry/index.ts +++ b/extensions/microsoft-foundry/index.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildMicrosoftFoundryProvider } from "./provider.js"; diff --git a/extensions/microsoft-foundry/onboard.ts b/extensions/microsoft-foundry/onboard.ts index c67819188a0..d6b543fa00c 100644 --- a/extensions/microsoft-foundry/onboard.ts +++ b/extensions/microsoft-foundry/onboard.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry setup module handles plugin onboarding behavior. import type { ProviderAuthContext } from "openclaw/plugin-sdk/core"; import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime"; diff --git a/extensions/microsoft-foundry/provider.ts b/extensions/microsoft-foundry/provider.ts index ca497446e3f..727c8d63d6e 100644 --- a/extensions/microsoft-foundry/provider.ts +++ b/extensions/microsoft-foundry/provider.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry provider module implements model/runtime integration. import type { ProviderNormalizeResolvedModelContext } from "openclaw/plugin-sdk/core"; import type { ModelProviderConfig, diff --git a/extensions/microsoft-foundry/runtime.ts b/extensions/microsoft-foundry/runtime.ts index 2134fad9223..70cbbe30ef0 100644 --- a/extensions/microsoft-foundry/runtime.ts +++ b/extensions/microsoft-foundry/runtime.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry plugin module implements runtime behavior. import type { ProviderPrepareRuntimeAuthContext } from "openclaw/plugin-sdk/core"; import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; import { diff --git a/extensions/microsoft-foundry/shared-runtime.ts b/extensions/microsoft-foundry/shared-runtime.ts index eb32541388e..2dd68d3b7ce 100644 --- a/extensions/microsoft-foundry/shared-runtime.ts +++ b/extensions/microsoft-foundry/shared-runtime.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry plugin module implements shared runtime behavior. export { TOKEN_REFRESH_MARGIN_MS, buildFoundryProviderBaseUrl, diff --git a/extensions/microsoft-foundry/shared.ts b/extensions/microsoft-foundry/shared.ts index c7fdaf8bbf3..2fde2b03c8e 100644 --- a/extensions/microsoft-foundry/shared.ts +++ b/extensions/microsoft-foundry/shared.ts @@ -1,3 +1,4 @@ +// Microsoft Foundry plugin module implements shared behavior. import type { AuthConfig } from "openclaw/plugin-sdk/config-contracts"; import { applyAuthProfileConfig, diff --git a/extensions/microsoft/index.ts b/extensions/microsoft/index.ts index 04eff9d49a7..332f93d8ad4 100644 --- a/extensions/microsoft/index.ts +++ b/extensions/microsoft/index.ts @@ -1,3 +1,4 @@ +// Microsoft plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildMicrosoftSpeechProvider } from "./speech-provider.js"; diff --git a/extensions/microsoft/microsoft.live.test.ts b/extensions/microsoft/microsoft.live.test.ts index 8bef656d11b..a41ca69cecf 100644 --- a/extensions/microsoft/microsoft.live.test.ts +++ b/extensions/microsoft/microsoft.live.test.ts @@ -1,3 +1,4 @@ +// Microsoft tests cover microsoft plugin behavior. import { isLiveTestEnabled } from "openclaw/plugin-sdk/test-env"; import { describe, expect, it } from "vitest"; import { listMicrosoftVoices } from "./speech-provider.js"; diff --git a/extensions/microsoft/speech-provider.test.ts b/extensions/microsoft/speech-provider.test.ts index 8218ef750f2..8ebfc153a34 100644 --- a/extensions/microsoft/speech-provider.test.ts +++ b/extensions/microsoft/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Microsoft tests cover speech provider plugin behavior. import { mkdtempSync, writeFileSync } from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/microsoft/speech-provider.ts b/extensions/microsoft/speech-provider.ts index 78023ec3b26..2e4cdabebce 100644 --- a/extensions/microsoft/speech-provider.ts +++ b/extensions/microsoft/speech-provider.ts @@ -1,3 +1,4 @@ +// Microsoft provider module implements model/runtime integration. import { readFileSync } from "node:fs"; import path from "node:path"; import { diff --git a/extensions/microsoft/test-api.ts b/extensions/microsoft/test-api.ts index de5d2beeaa0..c9c584ca655 100644 --- a/extensions/microsoft/test-api.ts +++ b/extensions/microsoft/test-api.ts @@ -1 +1,2 @@ +// Microsoft API module exposes the plugin public contract. export { buildMicrosoftSpeechProvider } from "./speech-provider.js"; diff --git a/extensions/microsoft/tts.test.ts b/extensions/microsoft/tts.test.ts index d1ef605d3fd..74438a5a0d4 100644 --- a/extensions/microsoft/tts.test.ts +++ b/extensions/microsoft/tts.test.ts @@ -1,3 +1,4 @@ +// Microsoft tests cover tts plugin behavior. import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import path from "node:path"; diff --git a/extensions/microsoft/tts.ts b/extensions/microsoft/tts.ts index d735ebea76e..53f42b48d6a 100644 --- a/extensions/microsoft/tts.ts +++ b/extensions/microsoft/tts.ts @@ -1,3 +1,4 @@ +// Microsoft plugin module implements tts behavior. import { statSync, writeFileSync } from "node:fs"; import { mkdir } from "node:fs/promises"; import path from "node:path"; diff --git a/extensions/migrate-claude/apply.ts b/extensions/migrate-claude/apply.ts index 1347c8d4b6d..7139074117b 100644 --- a/extensions/migrate-claude/apply.ts +++ b/extensions/migrate-claude/apply.ts @@ -1,3 +1,4 @@ +// Migrate Claude plugin module implements apply behavior. import path from "node:path"; import { summarizeMigrationItems } from "openclaw/plugin-sdk/migration"; import { diff --git a/extensions/migrate-claude/config.ts b/extensions/migrate-claude/config.ts index 204911d8eaa..78fbfbb3068 100644 --- a/extensions/migrate-claude/config.ts +++ b/extensions/migrate-claude/config.ts @@ -1,3 +1,4 @@ +// Migrate Claude helper module supports config behavior. import { applyMigrationConfigPatchItem, applyMigrationManualItem, diff --git a/extensions/migrate-claude/helpers.ts b/extensions/migrate-claude/helpers.ts index f236e0ec17b..16c9bb6c0e0 100644 --- a/extensions/migrate-claude/helpers.ts +++ b/extensions/migrate-claude/helpers.ts @@ -1,3 +1,4 @@ +// Migrate Claude helper module supports helpers behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/migrate-claude/index.ts b/extensions/migrate-claude/index.ts index ac6d6331f0e..561d2711fac 100644 --- a/extensions/migrate-claude/index.ts +++ b/extensions/migrate-claude/index.ts @@ -1,3 +1,4 @@ +// Migrate Claude plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildClaudeMigrationProvider } from "./provider.js"; diff --git a/extensions/migrate-claude/memory.ts b/extensions/migrate-claude/memory.ts index 2f0d8cc7c7a..188bf62163c 100644 --- a/extensions/migrate-claude/memory.ts +++ b/extensions/migrate-claude/memory.ts @@ -1,3 +1,4 @@ +// Migrate Claude plugin module implements memory behavior. import path from "node:path"; import { createMigrationItem, MIGRATION_REASON_TARGET_EXISTS } from "openclaw/plugin-sdk/migration"; import type { MigrationItem } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/migrate-claude/plan.ts b/extensions/migrate-claude/plan.ts index f614ab13278..a4c916bf5be 100644 --- a/extensions/migrate-claude/plan.ts +++ b/extensions/migrate-claude/plan.ts @@ -1,3 +1,4 @@ +// Migrate Claude plugin module implements plan behavior. import { createMigrationItem, summarizeMigrationItems } from "openclaw/plugin-sdk/migration"; import type { MigrationItem, diff --git a/extensions/migrate-claude/provider.test.ts b/extensions/migrate-claude/provider.test.ts index 496ffc92388..01bb4440f6d 100644 --- a/extensions/migrate-claude/provider.test.ts +++ b/extensions/migrate-claude/provider.test.ts @@ -1,3 +1,4 @@ +// Migrate Claude tests cover provider plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/migrate-claude/provider.ts b/extensions/migrate-claude/provider.ts index acb86d2cbf2..f92589e83af 100644 --- a/extensions/migrate-claude/provider.ts +++ b/extensions/migrate-claude/provider.ts @@ -1,3 +1,4 @@ +// Migrate Claude provider module implements model/runtime integration. import type { MigrationPlan, MigrationProviderContext, diff --git a/extensions/migrate-claude/skills.ts b/extensions/migrate-claude/skills.ts index c4e9754a3be..792928b124f 100644 --- a/extensions/migrate-claude/skills.ts +++ b/extensions/migrate-claude/skills.ts @@ -1,3 +1,4 @@ +// Migrate Claude plugin module implements skills behavior. import fs from "node:fs/promises"; import path from "node:path"; import { diff --git a/extensions/migrate-claude/source.ts b/extensions/migrate-claude/source.ts index 1534e3b83de..8aa72ab824d 100644 --- a/extensions/migrate-claude/source.ts +++ b/extensions/migrate-claude/source.ts @@ -1,3 +1,4 @@ +// Migrate Claude plugin module implements source behavior. import os from "node:os"; import path from "node:path"; import { exists, isDirectory, readJsonObject, resolveHomePath } from "./helpers.js"; diff --git a/extensions/migrate-claude/targets.ts b/extensions/migrate-claude/targets.ts index c0e1923f821..c23440deb1d 100644 --- a/extensions/migrate-claude/targets.ts +++ b/extensions/migrate-claude/targets.ts @@ -1,3 +1,4 @@ +// Migrate Claude plugin module implements targets behavior. import path from "node:path"; import { resolveAgentConfig, diff --git a/extensions/migrate-claude/test/provider-helpers.ts b/extensions/migrate-claude/test/provider-helpers.ts index bc2a2c7607b..3d6c39844f8 100644 --- a/extensions/migrate-claude/test/provider-helpers.ts +++ b/extensions/migrate-claude/test/provider-helpers.ts @@ -1,3 +1,4 @@ +// Migrate Claude provider module implements model/runtime integration. import fs from "node:fs/promises"; import path from "node:path"; import type { MigrationProviderContext } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/migrate-hermes/apply.ts b/extensions/migrate-hermes/apply.ts index 358f7cc508a..2f34e86fbf7 100644 --- a/extensions/migrate-hermes/apply.ts +++ b/extensions/migrate-hermes/apply.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements apply behavior. import path from "node:path"; import { markMigrationItemSkipped, summarizeMigrationItems } from "openclaw/plugin-sdk/migration"; import { diff --git a/extensions/migrate-hermes/auth-config.ts b/extensions/migrate-hermes/auth-config.ts index 9fe29f0c5b3..7dd0146dcc4 100644 --- a/extensions/migrate-hermes/auth-config.ts +++ b/extensions/migrate-hermes/auth-config.ts @@ -1,3 +1,4 @@ +// Migrate Hermes helper module supports auth config behavior. import type { MigrationProviderContext } from "openclaw/plugin-sdk/plugin-entry"; import { applyAuthProfileConfig, type OpenClawConfig } from "openclaw/plugin-sdk/provider-auth"; diff --git a/extensions/migrate-hermes/auth.ts b/extensions/migrate-hermes/auth.ts index 7ae52c840c6..ada937a8250 100644 --- a/extensions/migrate-hermes/auth.ts +++ b/extensions/migrate-hermes/auth.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements auth behavior. import { createHash } from "node:crypto"; import { loadAuthProfileStoreWithoutExternalProfiles, diff --git a/extensions/migrate-hermes/config.test.ts b/extensions/migrate-hermes/config.test.ts index b94d48d07d4..b12853478f8 100644 --- a/extensions/migrate-hermes/config.test.ts +++ b/extensions/migrate-hermes/config.test.ts @@ -1,3 +1,4 @@ +// Migrate Hermes tests cover config plugin behavior. import path from "node:path"; import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-auth"; import { afterEach, describe, expect, it } from "vitest"; diff --git a/extensions/migrate-hermes/config.ts b/extensions/migrate-hermes/config.ts index 5ffee5ba876..91331c57537 100644 --- a/extensions/migrate-hermes/config.ts +++ b/extensions/migrate-hermes/config.ts @@ -1,3 +1,4 @@ +// Migrate Hermes helper module supports config behavior. import { applyMigrationConfigPatchItem, applyMigrationManualItem, diff --git a/extensions/migrate-hermes/files-and-skills.test.ts b/extensions/migrate-hermes/files-and-skills.test.ts index fb69b3f1d57..e0bffc9795e 100644 --- a/extensions/migrate-hermes/files-and-skills.test.ts +++ b/extensions/migrate-hermes/files-and-skills.test.ts @@ -1,3 +1,4 @@ +// Migrate Hermes tests cover files and skills plugin behavior. import fs from "node:fs/promises"; import path from "node:path"; import { loadAuthProfileStoreWithoutExternalProfiles } from "openclaw/plugin-sdk/agent-runtime"; diff --git a/extensions/migrate-hermes/helpers.ts b/extensions/migrate-hermes/helpers.ts index ac47be53c66..49f39beaf14 100644 --- a/extensions/migrate-hermes/helpers.ts +++ b/extensions/migrate-hermes/helpers.ts @@ -1,3 +1,4 @@ +// Migrate Hermes helper module supports helpers behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/migrate-hermes/index.ts b/extensions/migrate-hermes/index.ts index ff87eba7bb5..e52f17769e3 100644 --- a/extensions/migrate-hermes/index.ts +++ b/extensions/migrate-hermes/index.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildHermesMigrationProvider } from "./provider.js"; diff --git a/extensions/migrate-hermes/items.ts b/extensions/migrate-hermes/items.ts index 335413dd76a..88f603215ef 100644 --- a/extensions/migrate-hermes/items.ts +++ b/extensions/migrate-hermes/items.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements items behavior. import type { MigrationItem } from "openclaw/plugin-sdk/migration"; import { createMigrationItem, diff --git a/extensions/migrate-hermes/model.apply.test.ts b/extensions/migrate-hermes/model.apply.test.ts index 13b55195e97..1d21b1c95b8 100644 --- a/extensions/migrate-hermes/model.apply.test.ts +++ b/extensions/migrate-hermes/model.apply.test.ts @@ -1,3 +1,4 @@ +// Migrate Hermes tests cover model.apply plugin behavior. import path from "node:path"; import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-auth"; import { afterEach, describe, expect, it } from "vitest"; diff --git a/extensions/migrate-hermes/model.plan.test.ts b/extensions/migrate-hermes/model.plan.test.ts index 60ff0046810..efa58400cb2 100644 --- a/extensions/migrate-hermes/model.plan.test.ts +++ b/extensions/migrate-hermes/model.plan.test.ts @@ -1,3 +1,4 @@ +// Migrate Hermes tests cover model.plan plugin behavior. import path from "node:path"; import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-auth"; import { afterEach, describe, expect, it } from "vitest"; diff --git a/extensions/migrate-hermes/model.ts b/extensions/migrate-hermes/model.ts index 77857ec0fd1..47fae62dc35 100644 --- a/extensions/migrate-hermes/model.ts +++ b/extensions/migrate-hermes/model.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements model behavior. import { resolveAgentEffectiveModelPrimary, resolveDefaultAgentId, diff --git a/extensions/migrate-hermes/plan.ts b/extensions/migrate-hermes/plan.ts index 069af834cad..f3ba9461d3d 100644 --- a/extensions/migrate-hermes/plan.ts +++ b/extensions/migrate-hermes/plan.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements plan behavior. import path from "node:path"; import { createMigrationItem, diff --git a/extensions/migrate-hermes/provider.secret-failure.test.ts b/extensions/migrate-hermes/provider.secret-failure.test.ts index 7be912f1bdf..9f6bc93afb0 100644 --- a/extensions/migrate-hermes/provider.secret-failure.test.ts +++ b/extensions/migrate-hermes/provider.secret-failure.test.ts @@ -1,3 +1,4 @@ +// Migrate Hermes tests cover provider.secret failure plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/migrate-hermes/provider.test.ts b/extensions/migrate-hermes/provider.test.ts index 3ce7d5efd27..9445884a937 100644 --- a/extensions/migrate-hermes/provider.test.ts +++ b/extensions/migrate-hermes/provider.test.ts @@ -1,3 +1,4 @@ +// Migrate Hermes tests cover provider plugin behavior. import os from "node:os"; import path from "node:path"; import { createCapturedPluginRegistration } from "openclaw/plugin-sdk/plugin-test-runtime"; diff --git a/extensions/migrate-hermes/provider.ts b/extensions/migrate-hermes/provider.ts index 212cf237122..7e047a7aba4 100644 --- a/extensions/migrate-hermes/provider.ts +++ b/extensions/migrate-hermes/provider.ts @@ -1,3 +1,4 @@ +// Migrate Hermes provider module implements model/runtime integration. import type { MigrationPlan, MigrationProviderContext, diff --git a/extensions/migrate-hermes/secrets.test.ts b/extensions/migrate-hermes/secrets.test.ts index 0e345eae0b8..098c51ad3b3 100644 --- a/extensions/migrate-hermes/secrets.test.ts +++ b/extensions/migrate-hermes/secrets.test.ts @@ -1,3 +1,4 @@ +// Migrate Hermes tests cover secrets plugin behavior. import fs from "node:fs/promises"; import path from "node:path"; import { diff --git a/extensions/migrate-hermes/secrets.ts b/extensions/migrate-hermes/secrets.ts index 6f4909b0d56..2f1a18e05fe 100644 --- a/extensions/migrate-hermes/secrets.ts +++ b/extensions/migrate-hermes/secrets.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements secrets behavior. import { loadAuthProfileStoreWithoutExternalProfiles, resolveAuthStorePathForDisplay, diff --git a/extensions/migrate-hermes/skills.ts b/extensions/migrate-hermes/skills.ts index 16b0e30bf7f..c978a9c90cd 100644 --- a/extensions/migrate-hermes/skills.ts +++ b/extensions/migrate-hermes/skills.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements skills behavior. import fs from "node:fs/promises"; import path from "node:path"; import { createMigrationItem, MIGRATION_REASON_TARGET_EXISTS } from "openclaw/plugin-sdk/migration"; diff --git a/extensions/migrate-hermes/source.ts b/extensions/migrate-hermes/source.ts index ba2b6779deb..ffc5e22179f 100644 --- a/extensions/migrate-hermes/source.ts +++ b/extensions/migrate-hermes/source.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements source behavior. import path from "node:path"; import { exists, isDirectory, resolveHomePath } from "./helpers.js"; diff --git a/extensions/migrate-hermes/targets.ts b/extensions/migrate-hermes/targets.ts index c0e1923f821..f2284be1115 100644 --- a/extensions/migrate-hermes/targets.ts +++ b/extensions/migrate-hermes/targets.ts @@ -1,3 +1,4 @@ +// Migrate Hermes plugin module implements targets behavior. import path from "node:path"; import { resolveAgentConfig, diff --git a/extensions/migrate-hermes/test/provider-helpers.ts b/extensions/migrate-hermes/test/provider-helpers.ts index b0c703d6024..ad5dd0dc3ec 100644 --- a/extensions/migrate-hermes/test/provider-helpers.ts +++ b/extensions/migrate-hermes/test/provider-helpers.ts @@ -1,3 +1,4 @@ +// Migrate Hermes provider module implements model/runtime integration. import fs from "node:fs/promises"; import path from "node:path"; import type { MigrationProviderContext } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/mistral/api.test.ts b/extensions/mistral/api.test.ts index 2663afb65ff..1cde724db9c 100644 --- a/extensions/mistral/api.test.ts +++ b/extensions/mistral/api.test.ts @@ -1,3 +1,4 @@ +// Mistral tests cover api plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import { diff --git a/extensions/mistral/api.ts b/extensions/mistral/api.ts index 749c24dfe04..e8c56f9ecb0 100644 --- a/extensions/mistral/api.ts +++ b/extensions/mistral/api.ts @@ -1,3 +1,4 @@ +// Mistral API module exposes the plugin public contract. export { buildMistralProvider } from "./provider-catalog.js"; export { buildMistralModelDefinition, diff --git a/extensions/mistral/embedding-provider.ts b/extensions/mistral/embedding-provider.ts index 7635e9a64b0..68710d1fd80 100644 --- a/extensions/mistral/embedding-provider.ts +++ b/extensions/mistral/embedding-provider.ts @@ -1,3 +1,4 @@ +// Mistral provider module implements model/runtime integration. import { createRemoteEmbeddingProvider, normalizeEmbeddingModelWithPrefixes, diff --git a/extensions/mistral/index.ts b/extensions/mistral/index.ts index 8561c71f349..52f104e6c19 100644 --- a/extensions/mistral/index.ts +++ b/extensions/mistral/index.ts @@ -1,3 +1,4 @@ +// Mistral plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyMistralModelCompat, MISTRAL_SMALL_LATEST_ID, MISTRAL_MEDIUM_3_5_ID } from "./api.js"; import { mistralMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/mistral/media-understanding-provider.test.ts b/extensions/mistral/media-understanding-provider.test.ts index d8b38046f41..338c30ed8d2 100644 --- a/extensions/mistral/media-understanding-provider.test.ts +++ b/extensions/mistral/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Mistral tests cover media understanding provider plugin behavior. import { createRequestCaptureJsonFetch, installPinnedHostnameTestHooks, diff --git a/extensions/mistral/media-understanding-provider.ts b/extensions/mistral/media-understanding-provider.ts index 5ac1d29ff5c..e5a9b41a741 100644 --- a/extensions/mistral/media-understanding-provider.ts +++ b/extensions/mistral/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Mistral provider module implements model/runtime integration. import { transcribeOpenAiCompatibleAudio, type MediaUnderstandingProvider, diff --git a/extensions/mistral/memory-embedding-adapter.ts b/extensions/mistral/memory-embedding-adapter.ts index c52c5f96ad3..c2c89819c45 100644 --- a/extensions/mistral/memory-embedding-adapter.ts +++ b/extensions/mistral/memory-embedding-adapter.ts @@ -1,3 +1,4 @@ +// Mistral plugin module implements memory embedding adapter behavior. import { isMissingEmbeddingApiKeyError, type MemoryEmbeddingProviderAdapter, diff --git a/extensions/mistral/mistral.live.test.ts b/extensions/mistral/mistral.live.test.ts index a2fd390c632..edb358b145b 100644 --- a/extensions/mistral/mistral.live.test.ts +++ b/extensions/mistral/mistral.live.test.ts @@ -1,3 +1,4 @@ +// Mistral tests cover mistral plugin behavior. import { normalizeTranscriptForMatch, runRealtimeSttLiveTest, diff --git a/extensions/mistral/model-definitions.test.ts b/extensions/mistral/model-definitions.test.ts index 54a81e3097b..e085df2313d 100644 --- a/extensions/mistral/model-definitions.test.ts +++ b/extensions/mistral/model-definitions.test.ts @@ -1,3 +1,4 @@ +// Mistral tests cover model definitions plugin behavior. import { describe, expect, it } from "vitest"; import { buildMistralCatalogModels, diff --git a/extensions/mistral/model-definitions.ts b/extensions/mistral/model-definitions.ts index 7f68e839ff6..2e577316399 100644 --- a/extensions/mistral/model-definitions.ts +++ b/extensions/mistral/model-definitions.ts @@ -1,3 +1,4 @@ +// Mistral plugin module implements model definitions behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/mistral/onboard.test.ts b/extensions/mistral/onboard.test.ts index 573dd6bdac5..71cdf2fc3ec 100644 --- a/extensions/mistral/onboard.test.ts +++ b/extensions/mistral/onboard.test.ts @@ -1,3 +1,4 @@ +// Mistral tests cover onboard plugin behavior. import { expectProviderOnboardMergedLegacyConfig, expectProviderOnboardPrimaryAndFallbacks, diff --git a/extensions/mistral/onboard.ts b/extensions/mistral/onboard.ts index 8615fa9d6bd..b45e4831470 100644 --- a/extensions/mistral/onboard.ts +++ b/extensions/mistral/onboard.ts @@ -1,3 +1,4 @@ +// Mistral setup module handles plugin onboarding behavior. import { createDefaultModelPresetAppliers, type OpenClawConfig, diff --git a/extensions/mistral/provider-catalog.ts b/extensions/mistral/provider-catalog.ts index 056bd5767ed..fcf09811146 100644 --- a/extensions/mistral/provider-catalog.ts +++ b/extensions/mistral/provider-catalog.ts @@ -1,3 +1,4 @@ +// Mistral provider module implements model/runtime integration. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/mistral/realtime-transcription-provider.test.ts b/extensions/mistral/realtime-transcription-provider.test.ts index f86253b580a..fdb710a6819 100644 --- a/extensions/mistral/realtime-transcription-provider.test.ts +++ b/extensions/mistral/realtime-transcription-provider.test.ts @@ -1,3 +1,4 @@ +// Mistral tests cover realtime transcription provider plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { afterEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/mistral/realtime-transcription-provider.ts b/extensions/mistral/realtime-transcription-provider.ts index df1a8d24b1f..51a760bd0b0 100644 --- a/extensions/mistral/realtime-transcription-provider.ts +++ b/extensions/mistral/realtime-transcription-provider.ts @@ -1,3 +1,4 @@ +// Mistral provider module implements model/runtime integration. import { createRealtimeTranscriptionWebSocketSession, type RealtimeTranscriptionProviderConfig, diff --git a/extensions/mistral/test-api.ts b/extensions/mistral/test-api.ts index 007e600955f..2b08d78c1f2 100644 --- a/extensions/mistral/test-api.ts +++ b/extensions/mistral/test-api.ts @@ -1,2 +1,3 @@ +// Mistral API module exposes the plugin public contract. export { mistralMediaUnderstandingProvider } from "./media-understanding-provider.js"; export { buildMistralRealtimeTranscriptionProvider } from "./realtime-transcription-provider.js"; diff --git a/extensions/moonshot/api.ts b/extensions/moonshot/api.ts index ef700cd6825..21fde669a89 100644 --- a/extensions/moonshot/api.ts +++ b/extensions/moonshot/api.ts @@ -1,3 +1,4 @@ +// Moonshot API module exposes the plugin public contract. export { applyMoonshotNativeStreamingUsageCompat, buildMoonshotProvider, diff --git a/extensions/moonshot/index.test.ts b/extensions/moonshot/index.test.ts index fcc29a30f81..6580e033e4a 100644 --- a/extensions/moonshot/index.test.ts +++ b/extensions/moonshot/index.test.ts @@ -1,3 +1,4 @@ +// Moonshot tests cover index plugin behavior. import fs from "node:fs"; import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; diff --git a/extensions/moonshot/index.ts b/extensions/moonshot/index.ts index f5991c20094..7d7218d7946 100644 --- a/extensions/moonshot/index.ts +++ b/extensions/moonshot/index.ts @@ -1,3 +1,4 @@ +// Moonshot plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-model-shared"; import { MOONSHOT_THINKING_STREAM_HOOKS } from "openclaw/plugin-sdk/provider-stream-family"; diff --git a/extensions/moonshot/media-understanding-provider.test.ts b/extensions/moonshot/media-understanding-provider.test.ts index 07cdcb811c2..a8c9c6fb3c1 100644 --- a/extensions/moonshot/media-understanding-provider.test.ts +++ b/extensions/moonshot/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Moonshot tests cover media understanding provider plugin behavior. import { createRequestCaptureJsonFetch, installPinnedHostnameTestHooks, diff --git a/extensions/moonshot/media-understanding-provider.ts b/extensions/moonshot/media-understanding-provider.ts index bfa1c4f8761..6c0a4ffb6d9 100644 --- a/extensions/moonshot/media-understanding-provider.ts +++ b/extensions/moonshot/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Moonshot provider module implements model/runtime integration. import { buildOpenAiCompatibleVideoRequestBody, coerceOpenAiCompatibleVideoText, diff --git a/extensions/moonshot/moonshot.live.test.ts b/extensions/moonshot/moonshot.live.test.ts index 1e9e593c19c..26479df9ed7 100644 --- a/extensions/moonshot/moonshot.live.test.ts +++ b/extensions/moonshot/moonshot.live.test.ts @@ -1,3 +1,4 @@ +// Moonshot tests cover moonshot plugin behavior. import { isLiveTestEnabled } from "openclaw/plugin-sdk/test-env"; import { describe, expect, it } from "vitest"; import { createKimiWebSearchProvider } from "./src/kimi-web-search-provider.js"; diff --git a/extensions/moonshot/onboard.ts b/extensions/moonshot/onboard.ts index 1f90591288d..4877e7ed98f 100644 --- a/extensions/moonshot/onboard.ts +++ b/extensions/moonshot/onboard.ts @@ -1,3 +1,4 @@ +// Moonshot setup module handles plugin onboarding behavior. import { createDefaultModelPresetAppliers, type OpenClawConfig, diff --git a/extensions/moonshot/provider-catalog.test.ts b/extensions/moonshot/provider-catalog.test.ts index 4644acf91ad..b15962f019b 100644 --- a/extensions/moonshot/provider-catalog.test.ts +++ b/extensions/moonshot/provider-catalog.test.ts @@ -1,3 +1,4 @@ +// Moonshot tests cover provider catalog plugin behavior. import { describe, expect, it } from "vitest"; import { applyMoonshotNativeStreamingUsageCompat, diff --git a/extensions/moonshot/provider-catalog.ts b/extensions/moonshot/provider-catalog.ts index a4083434f28..fbcca26f092 100644 --- a/extensions/moonshot/provider-catalog.ts +++ b/extensions/moonshot/provider-catalog.ts @@ -1,3 +1,4 @@ +// Moonshot provider module implements model/runtime integration. import { buildManifestModelProviderConfig, applyProviderNativeStreamingUsageCompat, diff --git a/extensions/moonshot/provider-contract-api.ts b/extensions/moonshot/provider-contract-api.ts index ec034bf7176..3c2db7bb260 100644 --- a/extensions/moonshot/provider-contract-api.ts +++ b/extensions/moonshot/provider-contract-api.ts @@ -1,3 +1,4 @@ +// Moonshot API module exposes the plugin public contract. import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; const noopAuth = async () => ({ profiles: [] }); diff --git a/extensions/moonshot/provider-discovery.ts b/extensions/moonshot/provider-discovery.ts index 4b833aa738f..0297f1faa15 100644 --- a/extensions/moonshot/provider-discovery.ts +++ b/extensions/moonshot/provider-discovery.ts @@ -1,3 +1,4 @@ +// Moonshot provider module implements model/runtime integration. import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; import { buildMoonshotProvider } from "./provider-catalog.js"; diff --git a/extensions/moonshot/src/kimi-web-search-provider.runtime.ts b/extensions/moonshot/src/kimi-web-search-provider.runtime.ts index ee91512d4ab..84480fe0df1 100644 --- a/extensions/moonshot/src/kimi-web-search-provider.runtime.ts +++ b/extensions/moonshot/src/kimi-web-search-provider.runtime.ts @@ -1,3 +1,4 @@ +// Moonshot provider module implements model/runtime integration. import { createProviderHttpError, readProviderJsonObjectResponse, diff --git a/extensions/moonshot/src/kimi-web-search-provider.test.ts b/extensions/moonshot/src/kimi-web-search-provider.test.ts index db134ff7f3b..a082aac0bdc 100644 --- a/extensions/moonshot/src/kimi-web-search-provider.test.ts +++ b/extensions/moonshot/src/kimi-web-search-provider.test.ts @@ -1,3 +1,4 @@ +// Moonshot tests cover kimi web search provider plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-onboard"; import { withEnvAsync } from "openclaw/plugin-sdk/test-env"; import { afterEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/moonshot/src/kimi-web-search-provider.ts b/extensions/moonshot/src/kimi-web-search-provider.ts index c49ea7f2a0a..dc5e1587de6 100644 --- a/extensions/moonshot/src/kimi-web-search-provider.ts +++ b/extensions/moonshot/src/kimi-web-search-provider.ts @@ -1,3 +1,4 @@ +// Moonshot provider module implements model/runtime integration. import { createWebSearchProviderContractFields, type WebSearchProviderPlugin, diff --git a/extensions/moonshot/test-api.ts b/extensions/moonshot/test-api.ts index ffe4031c60b..3aca7e291d0 100644 --- a/extensions/moonshot/test-api.ts +++ b/extensions/moonshot/test-api.ts @@ -1,2 +1,3 @@ +// Moonshot API module exposes the plugin public contract. export { testing, testing as __testing } from "./src/kimi-web-search-provider.runtime.js"; export { moonshotMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/moonshot/web-search-contract-api.ts b/extensions/moonshot/web-search-contract-api.ts index 0bd12c74610..5a3761ac040 100644 --- a/extensions/moonshot/web-search-contract-api.ts +++ b/extensions/moonshot/web-search-contract-api.ts @@ -1,3 +1,4 @@ +// Moonshot API module exposes the plugin public contract. import { createWebSearchProviderContractFields, type WebSearchProviderPlugin, diff --git a/extensions/moonshot/web-search-provider.ts b/extensions/moonshot/web-search-provider.ts index a1e76763995..c37892d5c11 100644 --- a/extensions/moonshot/web-search-provider.ts +++ b/extensions/moonshot/web-search-provider.ts @@ -1 +1,2 @@ +// Moonshot provider module implements model/runtime integration. export { createKimiWebSearchProvider } from "./src/kimi-web-search-provider.js"; diff --git a/extensions/music-generation-providers.live.test.ts b/extensions/music-generation-providers.live.test.ts index 643167ebcaa..4aa078417f0 100644 --- a/extensions/music-generation-providers.live.test.ts +++ b/extensions/music-generation-providers.live.test.ts @@ -1,3 +1,4 @@ +// Music Generation Providers.Live.Test.Ts tests cover music generation providers plugin behavior. import { resolveApiKeyForProvider, resolveDefaultAgentDir, diff --git a/extensions/novita/index.test.ts b/extensions/novita/index.test.ts index bb392296f9d..6464f0bb53a 100644 --- a/extensions/novita/index.test.ts +++ b/extensions/novita/index.test.ts @@ -1,3 +1,4 @@ +// Novita tests cover index plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import plugin from "./index.js"; diff --git a/extensions/novita/index.ts b/extensions/novita/index.ts index 9c5bc37e33f..6f8a122b94b 100644 --- a/extensions/novita/index.ts +++ b/extensions/novita/index.ts @@ -1,3 +1,4 @@ +// Novita plugin entrypoint registers its OpenClaw integration. import { readConfiguredProviderCatalogEntries } from "openclaw/plugin-sdk/provider-catalog-shared"; import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/novita/models.ts b/extensions/novita/models.ts index 69310397fd7..94a9b3077bb 100644 --- a/extensions/novita/models.ts +++ b/extensions/novita/models.ts @@ -1,3 +1,4 @@ +// Novita plugin module implements models behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/novita/provider-catalog.ts b/extensions/novita/provider-catalog.ts index 35434b41436..2f1997efc71 100644 --- a/extensions/novita/provider-catalog.ts +++ b/extensions/novita/provider-catalog.ts @@ -1,3 +1,4 @@ +// Novita provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { NOVITA_BASE_URL, NOVITA_MODEL_CATALOG, buildNovitaModelDefinition } from "./models.js"; diff --git a/extensions/nvidia/api.ts b/extensions/nvidia/api.ts index bcbb874d54e..39922466440 100644 --- a/extensions/nvidia/api.ts +++ b/extensions/nvidia/api.ts @@ -1,3 +1,4 @@ +// Nvidia API module exposes the plugin public contract. export { buildNvidiaProvider, NVIDIA_DEFAULT_MODEL_ID } from "./provider-catalog.js"; export { applyNvidiaConfig, diff --git a/extensions/nvidia/index.test.ts b/extensions/nvidia/index.test.ts index c62427b8ede..7f864147800 100644 --- a/extensions/nvidia/index.test.ts +++ b/extensions/nvidia/index.test.ts @@ -1,3 +1,4 @@ +// Nvidia tests cover index plugin behavior. import fs from "node:fs"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { diff --git a/extensions/nvidia/index.ts b/extensions/nvidia/index.ts index 6e270fdfda1..9bcac3aaa04 100644 --- a/extensions/nvidia/index.ts +++ b/extensions/nvidia/index.ts @@ -1,3 +1,4 @@ +// Nvidia plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyNvidiaConfig, NVIDIA_DEFAULT_MODEL_REF } from "./onboard.js"; import { diff --git a/extensions/nvidia/onboard.test.ts b/extensions/nvidia/onboard.test.ts index b0523593eea..c320391dc8c 100644 --- a/extensions/nvidia/onboard.test.ts +++ b/extensions/nvidia/onboard.test.ts @@ -1,3 +1,4 @@ +// Nvidia tests cover onboard plugin behavior. import { expectProviderOnboardMergedLegacyConfig, expectProviderOnboardPrimaryModel, diff --git a/extensions/nvidia/onboard.ts b/extensions/nvidia/onboard.ts index 98f1e574ff5..ca527665473 100644 --- a/extensions/nvidia/onboard.ts +++ b/extensions/nvidia/onboard.ts @@ -1,3 +1,4 @@ +// Nvidia setup module handles plugin onboarding behavior. import { createDefaultModelsPresetAppliers, type OpenClawConfig, diff --git a/extensions/nvidia/provider-catalog.test.ts b/extensions/nvidia/provider-catalog.test.ts index 42b80fcdbf9..27892ac6c09 100644 --- a/extensions/nvidia/provider-catalog.test.ts +++ b/extensions/nvidia/provider-catalog.test.ts @@ -1,3 +1,4 @@ +// Nvidia tests cover provider catalog plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { buildLiveNvidiaProvider, diff --git a/extensions/nvidia/provider-catalog.ts b/extensions/nvidia/provider-catalog.ts index 473b9be33cb..c17754aa862 100644 --- a/extensions/nvidia/provider-catalog.ts +++ b/extensions/nvidia/provider-catalog.ts @@ -1,3 +1,4 @@ +// Nvidia provider module implements model/runtime integration. import { lookup as dnsLookup } from "node:dns/promises"; import { isFutureDateTimestampMs, diff --git a/extensions/open-prose/index.ts b/extensions/open-prose/index.ts index c86f309fcc4..158850e20fc 100644 --- a/extensions/open-prose/index.ts +++ b/extensions/open-prose/index.ts @@ -1,3 +1,4 @@ +// Open Prose plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type OpenClawPluginApi } from "./runtime-api.js"; export default definePluginEntry({ diff --git a/extensions/open-prose/runtime-api.ts b/extensions/open-prose/runtime-api.ts index f2aa0034a22..8afe533b953 100644 --- a/extensions/open-prose/runtime-api.ts +++ b/extensions/open-prose/runtime-api.ts @@ -1,2 +1,3 @@ +// Open Prose API module exposes the plugin public contract. export { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; export type { OpenClawPluginApi } from "openclaw/plugin-sdk/core"; diff --git a/extensions/opencode-go/api.ts b/extensions/opencode-go/api.ts index c61f4cfcfa4..849f655cb7c 100644 --- a/extensions/opencode-go/api.ts +++ b/extensions/opencode-go/api.ts @@ -1,3 +1,4 @@ +// Opencode Go API module exposes the plugin public contract. import { applyAgentDefaultModelPrimary, resolveAgentModelPrimaryValue, diff --git a/extensions/opencode-go/index.test.ts b/extensions/opencode-go/index.test.ts index 694b766b75f..b01f92a2241 100644 --- a/extensions/opencode-go/index.test.ts +++ b/extensions/opencode-go/index.test.ts @@ -1,3 +1,4 @@ +// Opencode Go tests cover index plugin behavior. import type { ProviderRuntimeModel } from "openclaw/plugin-sdk/plugin-entry"; import { registerProviderPlugin, diff --git a/extensions/opencode-go/index.ts b/extensions/opencode-go/index.ts index 5a28fe88744..7d80ae2f57d 100644 --- a/extensions/opencode-go/index.ts +++ b/extensions/opencode-go/index.ts @@ -1,3 +1,4 @@ +// Opencode Go plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { PASSTHROUGH_GEMINI_REPLAY_HOOKS } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/opencode-go/media-understanding-provider.test.ts b/extensions/opencode-go/media-understanding-provider.test.ts index 4fdd0e8e2e3..29faf9b898f 100644 --- a/extensions/opencode-go/media-understanding-provider.test.ts +++ b/extensions/opencode-go/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Opencode Go tests cover media understanding provider plugin behavior. import { describe, expect, it } from "vitest"; import { opencodeGoMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/opencode-go/media-understanding-provider.ts b/extensions/opencode-go/media-understanding-provider.ts index 85c2f2f3a87..96cd1482ae4 100644 --- a/extensions/opencode-go/media-understanding-provider.ts +++ b/extensions/opencode-go/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Opencode Go provider module implements model/runtime integration. import { describeImageWithModel, describeImagesWithModel, diff --git a/extensions/opencode-go/onboard.test.ts b/extensions/opencode-go/onboard.test.ts index 3182b4c59bd..9d6468828d1 100644 --- a/extensions/opencode-go/onboard.test.ts +++ b/extensions/opencode-go/onboard.test.ts @@ -1,3 +1,4 @@ +// Opencode Go tests cover onboard plugin behavior. import { expectProviderOnboardPrimaryAndFallbacks } from "openclaw/plugin-sdk/provider-test-contracts"; import { describe, expect, it } from "vitest"; import { applyOpencodeGoConfig, applyOpencodeGoProviderConfig } from "./onboard.js"; diff --git a/extensions/opencode-go/onboard.ts b/extensions/opencode-go/onboard.ts index 55b08fea48a..a639dc4ff0b 100644 --- a/extensions/opencode-go/onboard.ts +++ b/extensions/opencode-go/onboard.ts @@ -1,3 +1,4 @@ +// Opencode Go setup module handles plugin onboarding behavior. import { applyAgentDefaultModelPrimary, type OpenClawConfig, diff --git a/extensions/opencode-go/provider-catalog.ts b/extensions/opencode-go/provider-catalog.ts index d701f3f3b0a..6cc1d027e63 100644 --- a/extensions/opencode-go/provider-catalog.ts +++ b/extensions/opencode-go/provider-catalog.ts @@ -1,3 +1,4 @@ +// Opencode Go provider module implements model/runtime integration. import type { ModelCatalogEntry } from "openclaw/plugin-sdk/agent-runtime"; import type { ProviderRuntimeModel } from "openclaw/plugin-sdk/plugin-entry"; import { normalizeModelCompat } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/opencode-go/reasoning-sanitizer.test.ts b/extensions/opencode-go/reasoning-sanitizer.test.ts index 937f071abd2..94effcb2322 100644 --- a/extensions/opencode-go/reasoning-sanitizer.test.ts +++ b/extensions/opencode-go/reasoning-sanitizer.test.ts @@ -1,3 +1,4 @@ +// Opencode Go tests cover reasoning sanitizer plugin behavior. import { describe, expect, it } from "vitest"; import { stripOpencodeGoKimiReasoningPayload } from "./reasoning-sanitizer.js"; diff --git a/extensions/opencode-go/reasoning-sanitizer.ts b/extensions/opencode-go/reasoning-sanitizer.ts index e45648d8526..fcaa260fd5c 100644 --- a/extensions/opencode-go/reasoning-sanitizer.ts +++ b/extensions/opencode-go/reasoning-sanitizer.ts @@ -1,3 +1,4 @@ +// Opencode Go plugin module implements reasoning sanitizer behavior. const REASONING_REPLAY_FIELDS = [ "reasoning_details", "reasoning_content", diff --git a/extensions/opencode-go/stream.ts b/extensions/opencode-go/stream.ts index b080b7a129d..b7d00d39a1e 100644 --- a/extensions/opencode-go/stream.ts +++ b/extensions/opencode-go/stream.ts @@ -1,3 +1,4 @@ +// Opencode Go plugin module implements stream behavior. import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { createDeepSeekV4OpenAICompatibleThinkingWrapper, diff --git a/extensions/opencode/api.ts b/extensions/opencode/api.ts index 236a3112872..03230204d10 100644 --- a/extensions/opencode/api.ts +++ b/extensions/opencode/api.ts @@ -1,3 +1,4 @@ +// Opencode API module exposes the plugin public contract. export { applyOpencodeZenModelDefault, OPENCODE_ZEN_DEFAULT_MODEL, diff --git a/extensions/opencode/index.test.ts b/extensions/opencode/index.test.ts index 017e31852c7..bdf7232cedb 100644 --- a/extensions/opencode/index.test.ts +++ b/extensions/opencode/index.test.ts @@ -1,3 +1,4 @@ +// Opencode tests cover index plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/opencode/index.ts b/extensions/opencode/index.ts index b99e204d08e..3df5c7eceb9 100644 --- a/extensions/opencode/index.ts +++ b/extensions/opencode/index.ts @@ -1,3 +1,4 @@ +// Opencode plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { diff --git a/extensions/opencode/media-understanding-provider.test.ts b/extensions/opencode/media-understanding-provider.test.ts index 631210f9421..00e72403042 100644 --- a/extensions/opencode/media-understanding-provider.test.ts +++ b/extensions/opencode/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Opencode tests cover media understanding provider plugin behavior. import { describe, expect, it } from "vitest"; import { opencodeMediaUnderstandingProvider, diff --git a/extensions/opencode/media-understanding-provider.ts b/extensions/opencode/media-understanding-provider.ts index 6ddcacd34fd..d04db574bf6 100644 --- a/extensions/opencode/media-understanding-provider.ts +++ b/extensions/opencode/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Opencode provider module implements model/runtime integration. import type { ProviderStreamOptions } from "openclaw/plugin-sdk/llm"; import { describeImageWithModelPayloadTransform, diff --git a/extensions/opencode/onboard.test.ts b/extensions/opencode/onboard.test.ts index 10a246d77c2..70e55784799 100644 --- a/extensions/opencode/onboard.test.ts +++ b/extensions/opencode/onboard.test.ts @@ -1,3 +1,4 @@ +// Opencode tests cover onboard plugin behavior. import { expectProviderOnboardAllowlistAlias, expectProviderOnboardPrimaryAndFallbacks, diff --git a/extensions/opencode/onboard.ts b/extensions/opencode/onboard.ts index a12db243b7f..28ff844f309 100644 --- a/extensions/opencode/onboard.ts +++ b/extensions/opencode/onboard.ts @@ -1,3 +1,4 @@ +// Opencode setup module handles plugin onboarding behavior. import { applyAgentDefaultModelPrimary, withAgentModelAliases, diff --git a/extensions/opencode/opencode.live.test.ts b/extensions/opencode/opencode.live.test.ts index f9bfff3e50e..239c5c70e1f 100644 --- a/extensions/opencode/opencode.live.test.ts +++ b/extensions/opencode/opencode.live.test.ts @@ -1,3 +1,4 @@ +// Opencode tests cover opencode plugin behavior. import { completeSimple, type AssistantMessage, diff --git a/extensions/opencode/provider-policy-api.test.ts b/extensions/opencode/provider-policy-api.test.ts index cfd49674189..99b086e1124 100644 --- a/extensions/opencode/provider-policy-api.test.ts +++ b/extensions/opencode/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Opencode tests cover provider policy api plugin behavior. import { describe, expect, it } from "vitest"; import { resolveThinkingProfile } from "./provider-policy-api.js"; diff --git a/extensions/opencode/provider-policy-api.ts b/extensions/opencode/provider-policy-api.ts index cc1aedcdf23..72fe0de8344 100644 --- a/extensions/opencode/provider-policy-api.ts +++ b/extensions/opencode/provider-policy-api.ts @@ -1,3 +1,4 @@ +// Opencode API module exposes the plugin public contract. import { resolveClaudeThinkingProfile } from "openclaw/plugin-sdk/provider-model-shared"; export function resolveThinkingProfile(params: { provider?: string; modelId: string }) { diff --git a/extensions/openrouter/api.ts b/extensions/openrouter/api.ts index a853538b1d8..e0ff07a6362 100644 --- a/extensions/openrouter/api.ts +++ b/extensions/openrouter/api.ts @@ -1,3 +1,4 @@ +// Openrouter API module exposes the plugin public contract. export { buildOpenRouterImageGenerationProvider } from "./image-generation-provider.js"; export { buildOpenRouterMusicGenerationProvider } from "./music-generation-provider.js"; export { diff --git a/extensions/openrouter/image-generation-provider.test.ts b/extensions/openrouter/image-generation-provider.test.ts index e091b35073a..2dc0aa022c8 100644 --- a/extensions/openrouter/image-generation-provider.test.ts +++ b/extensions/openrouter/image-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover image generation provider plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { buildOpenRouterImageGenerationProvider, diff --git a/extensions/openrouter/image-generation-provider.ts b/extensions/openrouter/image-generation-provider.ts index 42c5a487033..a8c320b305c 100644 --- a/extensions/openrouter/image-generation-provider.ts +++ b/extensions/openrouter/image-generation-provider.ts @@ -1,3 +1,4 @@ +// Openrouter provider module implements model/runtime integration. import type { GeneratedImageAsset, ImageGenerationProvider, diff --git a/extensions/openrouter/index.test.ts b/extensions/openrouter/index.test.ts index 5596255a4e8..d47c299d9a3 100644 --- a/extensions/openrouter/index.test.ts +++ b/extensions/openrouter/index.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover index plugin behavior. import { registerProviderPlugin, registerSingleProviderPlugin, diff --git a/extensions/openrouter/index.ts b/extensions/openrouter/index.ts index 9771fb69428..eaafc3968d0 100644 --- a/extensions/openrouter/index.ts +++ b/extensions/openrouter/index.ts @@ -1,3 +1,4 @@ +// Openrouter plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type ProviderReplayPolicy, diff --git a/extensions/openrouter/media-understanding-provider.test.ts b/extensions/openrouter/media-understanding-provider.test.ts index 701298fb4ef..1b49047b6ce 100644 --- a/extensions/openrouter/media-understanding-provider.test.ts +++ b/extensions/openrouter/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover media understanding provider plugin behavior. import { describeImageWithModel, describeImagesWithModel, diff --git a/extensions/openrouter/media-understanding-provider.ts b/extensions/openrouter/media-understanding-provider.ts index 2a1d61bf997..ffdabd9c96a 100644 --- a/extensions/openrouter/media-understanding-provider.ts +++ b/extensions/openrouter/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Openrouter provider module implements model/runtime integration. import path from "node:path"; import { describeImageWithModel, diff --git a/extensions/openrouter/models.ts b/extensions/openrouter/models.ts index 52785d42ad2..a13469f3f2d 100644 --- a/extensions/openrouter/models.ts +++ b/extensions/openrouter/models.ts @@ -1,3 +1,4 @@ +// Openrouter plugin module implements models behavior. import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime"; const OPENROUTER_MISTRAL_MODEL_PREFIXES = [ diff --git a/extensions/openrouter/music-generation-provider.test.ts b/extensions/openrouter/music-generation-provider.test.ts index 923de475711..c3fc993e114 100644 --- a/extensions/openrouter/music-generation-provider.test.ts +++ b/extensions/openrouter/music-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover music generation provider plugin behavior. import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import { expectExplicitMusicGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/openrouter/music-generation-provider.ts b/extensions/openrouter/music-generation-provider.ts index 9b74c716cbc..458a6ea3e2e 100644 --- a/extensions/openrouter/music-generation-provider.ts +++ b/extensions/openrouter/music-generation-provider.ts @@ -1,3 +1,4 @@ +// Openrouter provider module implements model/runtime integration. import type { MusicGenerationProvider, MusicGenerationRequest, diff --git a/extensions/openrouter/onboard.test.ts b/extensions/openrouter/onboard.test.ts index 3ad77156403..9065616d787 100644 --- a/extensions/openrouter/onboard.test.ts +++ b/extensions/openrouter/onboard.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover onboard plugin behavior. import { expectProviderOnboardAllowlistAlias, expectProviderOnboardPrimaryAndFallbacks, diff --git a/extensions/openrouter/onboard.ts b/extensions/openrouter/onboard.ts index f5662399192..d4698baa0eb 100644 --- a/extensions/openrouter/onboard.ts +++ b/extensions/openrouter/onboard.ts @@ -1,3 +1,4 @@ +// Openrouter setup module handles plugin onboarding behavior. import { applyAgentDefaultModelPrimary, type OpenClawConfig, diff --git a/extensions/openrouter/openrouter.live.test.ts b/extensions/openrouter/openrouter.live.test.ts index aff58f5680f..5217a338b57 100644 --- a/extensions/openrouter/openrouter.live.test.ts +++ b/extensions/openrouter/openrouter.live.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover openrouter plugin behavior. import OpenAI from "openai"; import { AuthStorage, ModelRegistry } from "openclaw/plugin-sdk/agent-sessions"; import { diff --git a/extensions/openrouter/provider-catalog.ts b/extensions/openrouter/provider-catalog.ts index 8710e458cb3..62ddf1b229b 100644 --- a/extensions/openrouter/provider-catalog.ts +++ b/extensions/openrouter/provider-catalog.ts @@ -1,3 +1,4 @@ +// Openrouter provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; export const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"; diff --git a/extensions/openrouter/provider-contract-api.ts b/extensions/openrouter/provider-contract-api.ts index 4031472c64e..470e6a9973c 100644 --- a/extensions/openrouter/provider-contract-api.ts +++ b/extensions/openrouter/provider-contract-api.ts @@ -1,3 +1,4 @@ +// Openrouter API module exposes the plugin public contract. import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; export function createOpenrouterProvider(): ProviderPlugin { diff --git a/extensions/openrouter/provider-policy-api.ts b/extensions/openrouter/provider-policy-api.ts index ed27833b764..e31709741f4 100644 --- a/extensions/openrouter/provider-policy-api.ts +++ b/extensions/openrouter/provider-policy-api.ts @@ -1,3 +1,4 @@ +// Openrouter API module exposes the plugin public contract. import { resolveOpenRouterThinkingProfile } from "./thinking-policy.js"; export function resolveThinkingProfile(params: { provider?: string; modelId: string }) { diff --git a/extensions/openrouter/provider-routing.ts b/extensions/openrouter/provider-routing.ts index 4cfb034fb15..8c14ce30f4c 100644 --- a/extensions/openrouter/provider-routing.ts +++ b/extensions/openrouter/provider-routing.ts @@ -1,3 +1,4 @@ +// Openrouter provider module implements model/runtime integration. type OpenRouterExtraParamsContext = { config?: { models?: { diff --git a/extensions/openrouter/provider-runtime.contract.test.ts b/extensions/openrouter/provider-runtime.contract.test.ts index bd196d62e17..bdd3dcc5096 100644 --- a/extensions/openrouter/provider-runtime.contract.test.ts +++ b/extensions/openrouter/provider-runtime.contract.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover provider runtime.contract plugin behavior. import { describeOpenRouterProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeOpenRouterProviderRuntimeContract(() => import("./index.js")); diff --git a/extensions/openrouter/speech-provider.test.ts b/extensions/openrouter/speech-provider.test.ts index 9845ce88ff3..7ee5365dc34 100644 --- a/extensions/openrouter/speech-provider.test.ts +++ b/extensions/openrouter/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover speech provider plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { buildOpenRouterSpeechProvider } from "./speech-provider.js"; @@ -7,18 +8,18 @@ const { readProviderBinaryResponseMock, resolveProviderHttpRequestConfigMock, } = vi.hoisted(() => ({ - assertOkOrThrowHttpErrorMock: vi.fn(async () => {}), - postJsonRequestMock: vi.fn(), - readProviderBinaryResponseMock: vi.fn(async (response: Response) => { - return new Uint8Array(await response.arrayBuffer()); - }), - resolveProviderHttpRequestConfigMock: vi.fn((params: Record) => ({ - baseUrl: params.baseUrl ?? params.defaultBaseUrl ?? "https://openrouter.ai/api/v1", - allowPrivateNetwork: false, - headers: new Headers(params.defaultHeaders as HeadersInit | undefined), - dispatcherPolicy: undefined, - })), - })); + assertOkOrThrowHttpErrorMock: vi.fn(async () => {}), + postJsonRequestMock: vi.fn(), + readProviderBinaryResponseMock: vi.fn(async (response: Response) => { + return new Uint8Array(await response.arrayBuffer()); + }), + resolveProviderHttpRequestConfigMock: vi.fn((params: Record) => ({ + baseUrl: params.baseUrl ?? params.defaultBaseUrl ?? "https://openrouter.ai/api/v1", + allowPrivateNetwork: false, + headers: new Headers(params.defaultHeaders as HeadersInit | undefined), + dispatcherPolicy: undefined, + })), +})); vi.mock("openclaw/plugin-sdk/provider-http", () => ({ assertOkOrThrowHttpError: assertOkOrThrowHttpErrorMock, diff --git a/extensions/openrouter/speech-provider.ts b/extensions/openrouter/speech-provider.ts index 2b2faee61e6..7c3aa8980bd 100644 --- a/extensions/openrouter/speech-provider.ts +++ b/extensions/openrouter/speech-provider.ts @@ -1,3 +1,4 @@ +// Openrouter provider module implements model/runtime integration. import { asObject, createOpenAiCompatibleSpeechProvider, diff --git a/extensions/openrouter/stream.ts b/extensions/openrouter/stream.ts index 77634e39f9b..4626feb0b9e 100644 --- a/extensions/openrouter/stream.ts +++ b/extensions/openrouter/stream.ts @@ -1,3 +1,4 @@ +// Openrouter plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { OPENROUTER_THINKING_STREAM_HOOKS } from "openclaw/plugin-sdk/provider-stream-family"; diff --git a/extensions/openrouter/test-api.ts b/extensions/openrouter/test-api.ts index 2e864bdaa7b..513c9935cb0 100644 --- a/extensions/openrouter/test-api.ts +++ b/extensions/openrouter/test-api.ts @@ -1,3 +1,4 @@ +// Openrouter API module exposes the plugin public contract. export { buildOpenRouterImageGenerationProvider } from "./image-generation-provider.js"; export { buildOpenRouterMusicGenerationProvider } from "./music-generation-provider.js"; export { openrouterMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/openrouter/thinking-policy.ts b/extensions/openrouter/thinking-policy.ts index 6c16c77b726..4bc40599533 100644 --- a/extensions/openrouter/thinking-policy.ts +++ b/extensions/openrouter/thinking-policy.ts @@ -1,3 +1,4 @@ +// Openrouter plugin module implements thinking policy behavior. import type { ProviderThinkingProfile } from "openclaw/plugin-sdk/plugin-entry"; import { isOpenRouterDeepSeekV4ModelId } from "./models.js"; diff --git a/extensions/openrouter/video-generation-provider.test.ts b/extensions/openrouter/video-generation-provider.test.ts index 6bfab462cb6..3a512e612da 100644 --- a/extensions/openrouter/video-generation-provider.test.ts +++ b/extensions/openrouter/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Openrouter tests cover video generation provider plugin behavior. import { clearLiveCatalogCacheForTests } from "openclaw/plugin-sdk/provider-catalog-shared"; import { expectExplicitVideoGenerationCapabilities, diff --git a/extensions/openrouter/video-generation-provider.ts b/extensions/openrouter/video-generation-provider.ts index 5a0f619d37a..66e08202fda 100644 --- a/extensions/openrouter/video-generation-provider.ts +++ b/extensions/openrouter/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Openrouter provider module implements model/runtime integration. import { extensionForMime } from "openclaw/plugin-sdk/media-mime"; import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime"; diff --git a/extensions/openrouter/video-http.ts b/extensions/openrouter/video-http.ts index 3d877c9e296..4a8231cf7d0 100644 --- a/extensions/openrouter/video-http.ts +++ b/extensions/openrouter/video-http.ts @@ -1,3 +1,4 @@ +// Openrouter plugin module implements video http behavior. import { fetchWithTimeoutGuarded } from "openclaw/plugin-sdk/provider-http"; type GuardedFetchResult = Awaited>; diff --git a/extensions/openrouter/video-model-catalog.ts b/extensions/openrouter/video-model-catalog.ts index 3d63e1cf1c0..0a8a1473620 100644 --- a/extensions/openrouter/video-model-catalog.ts +++ b/extensions/openrouter/video-model-catalog.ts @@ -1,3 +1,4 @@ +// Openrouter plugin module implements video model catalog behavior. import type { UnifiedModelCatalogEntry, UnifiedModelCatalogProviderContext, diff --git a/extensions/openshell/index.ts b/extensions/openshell/index.ts index 4e99e683bde..ea839249590 100644 --- a/extensions/openshell/index.ts +++ b/extensions/openshell/index.ts @@ -1,3 +1,4 @@ +// Openshell plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { registerSandboxBackend } from "openclaw/plugin-sdk/sandbox"; import { diff --git a/extensions/openshell/src/backend.e2e.test.ts b/extensions/openshell/src/backend.e2e.test.ts index 57aa886a10b..b1a3f6ff045 100644 --- a/extensions/openshell/src/backend.e2e.test.ts +++ b/extensions/openshell/src/backend.e2e.test.ts @@ -1,3 +1,4 @@ +// Openshell tests cover backend plugin behavior. import { spawn } from "node:child_process"; import fs from "node:fs/promises"; import net from "node:net"; diff --git a/extensions/openshell/src/backend.test.ts b/extensions/openshell/src/backend.test.ts index 9c67329aed0..1d6b84adbad 100644 --- a/extensions/openshell/src/backend.test.ts +++ b/extensions/openshell/src/backend.test.ts @@ -1,3 +1,4 @@ +// Openshell tests cover backend plugin behavior. import { afterEach, describe, expect, it } from "vitest"; import { buildOpenShellSandboxName, buildOpenShellSshExecEnv } from "./backend.js"; diff --git a/extensions/openshell/src/backend.ts b/extensions/openshell/src/backend.ts index c4713eaa8c9..5e36f00c2f2 100644 --- a/extensions/openshell/src/backend.ts +++ b/extensions/openshell/src/backend.ts @@ -1,3 +1,4 @@ +// Openshell plugin module implements backend behavior. import fs from "node:fs/promises"; import path from "node:path"; import type { diff --git a/extensions/openshell/src/backend.types.ts b/extensions/openshell/src/backend.types.ts index 38c152ca524..437049abf0c 100644 --- a/extensions/openshell/src/backend.types.ts +++ b/extensions/openshell/src/backend.types.ts @@ -1,3 +1,4 @@ +// Openshell type declarations define plugin contracts. import type { RemoteShellSandboxHandle, SandboxBackendHandle } from "openclaw/plugin-sdk/sandbox"; export type OpenShellFsBridgeContext = Parameters< diff --git a/extensions/openshell/src/cli.ts b/extensions/openshell/src/cli.ts index 41fe3097af5..4e3fe0a4f67 100644 --- a/extensions/openshell/src/cli.ts +++ b/extensions/openshell/src/cli.ts @@ -1,3 +1,4 @@ +// Openshell plugin module implements cli behavior. import { createSshSandboxSessionFromConfigText, runPluginCommandWithTimeout, diff --git a/extensions/openshell/src/config.test.ts b/extensions/openshell/src/config.test.ts index 37923f7c477..94b4a3bab53 100644 --- a/extensions/openshell/src/config.test.ts +++ b/extensions/openshell/src/config.test.ts @@ -1,3 +1,4 @@ +// Openshell tests cover config plugin behavior. import fsSync from "node:fs"; import { describe, expect, it } from "vitest"; import { createOpenShellPluginConfigSchema, resolveOpenShellPluginConfig } from "./config.js"; diff --git a/extensions/openshell/src/config.ts b/extensions/openshell/src/config.ts index a1f4075ceff..2b2b6019709 100644 --- a/extensions/openshell/src/config.ts +++ b/extensions/openshell/src/config.ts @@ -1,3 +1,4 @@ +// Openshell helper module supports config behavior. import path from "node:path"; import { buildPluginConfigSchema, type OpenClawPluginConfigSchema } from "openclaw/plugin-sdk/core"; import { diff --git a/extensions/openshell/src/fs-bridge.ts b/extensions/openshell/src/fs-bridge.ts index 71333ae46b4..74b76354319 100644 --- a/extensions/openshell/src/fs-bridge.ts +++ b/extensions/openshell/src/fs-bridge.ts @@ -1,3 +1,4 @@ +// Openshell plugin module implements fs bridge behavior. import fsPromises from "node:fs/promises"; import path from "node:path"; import { root as fsRoot } from "openclaw/plugin-sdk/file-access-runtime"; diff --git a/extensions/openshell/src/mirror.test.ts b/extensions/openshell/src/mirror.test.ts index b3f03ffac25..106fdb244bb 100644 --- a/extensions/openshell/src/mirror.test.ts +++ b/extensions/openshell/src/mirror.test.ts @@ -1,3 +1,4 @@ +// Openshell tests cover mirror plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/openshell/src/mirror.ts b/extensions/openshell/src/mirror.ts index b9c9e4f080c..c811b28693c 100644 --- a/extensions/openshell/src/mirror.ts +++ b/extensions/openshell/src/mirror.ts @@ -1,3 +1,4 @@ +// Openshell plugin module implements mirror behavior. import fs from "node:fs/promises"; import path from "node:path"; import { movePathWithCopyFallback } from "openclaw/plugin-sdk/security-runtime"; diff --git a/extensions/openshell/src/openshell-core.test.ts b/extensions/openshell/src/openshell-core.test.ts index 7332dce4f64..332e5dce3dd 100644 --- a/extensions/openshell/src/openshell-core.test.ts +++ b/extensions/openshell/src/openshell-core.test.ts @@ -1,3 +1,4 @@ +// Openshell tests cover openshell core plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/perplexity/index.ts b/extensions/perplexity/index.ts index 4e1a57c259a..ef8049dbf34 100644 --- a/extensions/perplexity/index.ts +++ b/extensions/perplexity/index.ts @@ -1,3 +1,4 @@ +// Perplexity plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createPerplexityWebSearchProvider } from "./src/perplexity-web-search-provider.js"; diff --git a/extensions/perplexity/src/perplexity-web-search-provider.runtime.ts b/extensions/perplexity/src/perplexity-web-search-provider.runtime.ts index 5f0e606422c..2fe4de817fa 100644 --- a/extensions/perplexity/src/perplexity-web-search-provider.runtime.ts +++ b/extensions/perplexity/src/perplexity-web-search-provider.runtime.ts @@ -1,3 +1,4 @@ +// Perplexity provider module implements model/runtime integration. import { readPositiveIntegerParam, readStringArrayParam, diff --git a/extensions/perplexity/src/perplexity-web-search-provider.shared.ts b/extensions/perplexity/src/perplexity-web-search-provider.shared.ts index e94c48ae9c2..1b87b65fa51 100644 --- a/extensions/perplexity/src/perplexity-web-search-provider.shared.ts +++ b/extensions/perplexity/src/perplexity-web-search-provider.shared.ts @@ -1,3 +1,4 @@ +// Perplexity provider module implements model/runtime integration. import { createWebSearchProviderContractFields, mergeScopedSearchConfig, diff --git a/extensions/perplexity/src/perplexity-web-search-provider.test.ts b/extensions/perplexity/src/perplexity-web-search-provider.test.ts index 2f69fce7eb7..52ebd6bd85c 100644 --- a/extensions/perplexity/src/perplexity-web-search-provider.test.ts +++ b/extensions/perplexity/src/perplexity-web-search-provider.test.ts @@ -1,3 +1,4 @@ +// Perplexity tests cover perplexity web search provider plugin behavior. import { withEnv, withEnvAsync } from "openclaw/plugin-sdk/test-env"; import { describe, expect, it } from "vitest"; import { createPerplexityWebSearchProvider } from "./perplexity-web-search-provider.js"; diff --git a/extensions/perplexity/src/perplexity-web-search-provider.ts b/extensions/perplexity/src/perplexity-web-search-provider.ts index ed1d8ff2871..8133f87e96a 100644 --- a/extensions/perplexity/src/perplexity-web-search-provider.ts +++ b/extensions/perplexity/src/perplexity-web-search-provider.ts @@ -1,3 +1,4 @@ +// Perplexity provider module implements model/runtime integration. import { mergeScopedSearchConfig, resolveProviderWebSearchPluginConfig, diff --git a/extensions/perplexity/test-api.ts b/extensions/perplexity/test-api.ts index 277806c2246..ed109179168 100644 --- a/extensions/perplexity/test-api.ts +++ b/extensions/perplexity/test-api.ts @@ -1 +1,2 @@ +// Perplexity API module exposes the plugin public contract. export { testing, testing as __testing } from "./src/perplexity-web-search-provider.runtime.js"; diff --git a/extensions/perplexity/web-search-contract-api.ts b/extensions/perplexity/web-search-contract-api.ts index 2f0d8f2e225..268a024dbca 100644 --- a/extensions/perplexity/web-search-contract-api.ts +++ b/extensions/perplexity/web-search-contract-api.ts @@ -1,3 +1,4 @@ +// Perplexity API module exposes the plugin public contract. import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-config-contract"; import { createPerplexityWebSearchProviderBase, diff --git a/extensions/perplexity/web-search-provider.ts b/extensions/perplexity/web-search-provider.ts index 9200070af22..db5cbc2ab6c 100644 --- a/extensions/perplexity/web-search-provider.ts +++ b/extensions/perplexity/web-search-provider.ts @@ -1 +1,2 @@ +// Perplexity provider module implements model/runtime integration. export { createPerplexityWebSearchProvider } from "./src/perplexity-web-search-provider.js"; diff --git a/extensions/phone-control/doctor-contract-api.test.ts b/extensions/phone-control/doctor-contract-api.test.ts index f5b94e008fd..a7b4232e8dd 100644 --- a/extensions/phone-control/doctor-contract-api.test.ts +++ b/extensions/phone-control/doctor-contract-api.test.ts @@ -1,3 +1,4 @@ +// Phone Control tests cover doctor contract api plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/phone-control/doctor-contract-api.ts b/extensions/phone-control/doctor-contract-api.ts index d952f0867a5..5cef4ebd03e 100644 --- a/extensions/phone-control/doctor-contract-api.ts +++ b/extensions/phone-control/doctor-contract-api.ts @@ -1,3 +1,4 @@ +// Phone Control API module exposes the plugin public contract. import fs from "node:fs/promises"; import path from "node:path"; import type { PluginDoctorStateMigration } from "openclaw/plugin-sdk/runtime-doctor"; diff --git a/extensions/phone-control/index.test.ts b/extensions/phone-control/index.test.ts index fba3901f5c9..6c74ea86624 100644 --- a/extensions/phone-control/index.test.ts +++ b/extensions/phone-control/index.test.ts @@ -1,3 +1,4 @@ +// Phone Control tests cover index plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/phone-control/index.ts b/extensions/phone-control/index.ts index 4fb3a0cad2a..0c2be9df9c1 100644 --- a/extensions/phone-control/index.ts +++ b/extensions/phone-control/index.ts @@ -1,3 +1,4 @@ +// Phone Control plugin entrypoint registers its OpenClaw integration. import { asDateTimestampMs, resolveExpiresAtMsFromDurationMs, diff --git a/extensions/phone-control/runtime-api.ts b/extensions/phone-control/runtime-api.ts index 940bc8fe2ba..38e32cc601c 100644 --- a/extensions/phone-control/runtime-api.ts +++ b/extensions/phone-control/runtime-api.ts @@ -1,3 +1,4 @@ +// Phone Control API module exposes the plugin public contract. export { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; export type { OpenClawPluginApi, diff --git a/extensions/pixverse/constants.ts b/extensions/pixverse/constants.ts index 02407fda642..dfd249ccb91 100644 --- a/extensions/pixverse/constants.ts +++ b/extensions/pixverse/constants.ts @@ -1,3 +1,4 @@ +// Pixverse plugin module implements constants behavior. export const PIXVERSE_PROVIDER_ID = "pixverse"; export const PIXVERSE_BASE_URL_BY_REGION = { diff --git a/extensions/pixverse/index.test.ts b/extensions/pixverse/index.test.ts index 21bca753a3e..ebed934c0a0 100644 --- a/extensions/pixverse/index.test.ts +++ b/extensions/pixverse/index.test.ts @@ -1,3 +1,4 @@ +// Pixverse tests cover index plugin behavior. import { capturePluginRegistration } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/pixverse/index.ts b/extensions/pixverse/index.ts index c97240657d0..27a9542a69e 100644 --- a/extensions/pixverse/index.ts +++ b/extensions/pixverse/index.ts @@ -1,3 +1,4 @@ +// Pixverse plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { PIXVERSE_PROVIDER_ID } from "./constants.js"; import { buildPixVerseApiKeyAuthMethod } from "./onboard.js"; diff --git a/extensions/pixverse/onboard.ts b/extensions/pixverse/onboard.ts index c38c39caf21..6d9d0206960 100644 --- a/extensions/pixverse/onboard.ts +++ b/extensions/pixverse/onboard.ts @@ -1,3 +1,4 @@ +// Pixverse setup module handles plugin onboarding behavior. import type { ProviderAuthContext, ProviderAuthMethod, diff --git a/extensions/pixverse/video-generation-provider.test.ts b/extensions/pixverse/video-generation-provider.test.ts index 9300cd2c9ec..2be4916f629 100644 --- a/extensions/pixverse/video-generation-provider.test.ts +++ b/extensions/pixverse/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Pixverse tests cover video generation provider plugin behavior. import { getProviderHttpMocks, installProviderHttpMockCleanup, diff --git a/extensions/pixverse/video-generation-provider.ts b/extensions/pixverse/video-generation-provider.ts index c4de3fecfd9..a8ead596a27 100644 --- a/extensions/pixverse/video-generation-provider.ts +++ b/extensions/pixverse/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Pixverse provider module implements model/runtime integration. import { randomUUID } from "node:crypto"; import { extensionForMime } from "openclaw/plugin-sdk/media-mime"; import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; diff --git a/extensions/policy/api.ts b/extensions/policy/api.ts index 29801f01659..831bcd026c4 100644 --- a/extensions/policy/api.ts +++ b/extensions/policy/api.ts @@ -1 +1,2 @@ +// Policy API module exposes the plugin public contract. export { registerPolicyDoctorChecks } from "./src/doctor/register.js"; diff --git a/extensions/policy/index.ts b/extensions/policy/index.ts index 76c4e900c4b..506a7be7c62 100644 --- a/extensions/policy/index.ts +++ b/extensions/policy/index.ts @@ -1,3 +1,4 @@ +// Policy plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { registerPolicyCli } from "./src/cli.js"; import { registerPolicyDoctorChecks } from "./src/doctor/register.js"; diff --git a/extensions/policy/src/cli.test.ts b/extensions/policy/src/cli.test.ts index 485c9a14d39..45b69663519 100644 --- a/extensions/policy/src/cli.test.ts +++ b/extensions/policy/src/cli.test.ts @@ -1,3 +1,4 @@ +// Policy tests cover cli plugin behavior. import { promises as fs } from "node:fs"; import { tmpdir } from "node:os"; import { join } from "node:path"; diff --git a/extensions/policy/src/cli.ts b/extensions/policy/src/cli.ts index 3a6067e3e73..c48bc516d96 100644 --- a/extensions/policy/src/cli.ts +++ b/extensions/policy/src/cli.ts @@ -1,3 +1,4 @@ +// Policy plugin module implements cli behavior. import { isAbsolute, resolve } from "node:path"; import { setTimeout as sleep } from "node:timers/promises"; import type { Command } from "commander"; diff --git a/extensions/policy/src/doctor/register.test.ts b/extensions/policy/src/doctor/register.test.ts index bc301dbed2b..ed70ad7a9ed 100644 --- a/extensions/policy/src/doctor/register.test.ts +++ b/extensions/policy/src/doctor/register.test.ts @@ -1,3 +1,4 @@ +// Policy tests cover register plugin behavior. import { promises as fs } from "node:fs"; import { tmpdir } from "node:os"; import { join } from "node:path"; diff --git a/extensions/policy/src/doctor/register.ts b/extensions/policy/src/doctor/register.ts index 9082e2dd0fe..08d37c33b79 100644 --- a/extensions/policy/src/doctor/register.ts +++ b/extensions/policy/src/doctor/register.ts @@ -1,3 +1,4 @@ +// Policy plugin module implements register behavior. import { basename, isAbsolute, resolve } from "node:path"; import JSON5 from "json5"; import { diff --git a/extensions/policy/src/policy-conformance.ts b/extensions/policy/src/policy-conformance.ts index 7602cf591b6..0ed2116b125 100644 --- a/extensions/policy/src/policy-conformance.ts +++ b/extensions/policy/src/policy-conformance.ts @@ -1,3 +1,4 @@ +// Policy plugin module implements policy conformance behavior. import { promises as fs } from "node:fs"; import { basename, isAbsolute, resolve } from "node:path"; import JSON5 from "json5"; diff --git a/extensions/policy/src/policy-state.test.ts b/extensions/policy/src/policy-state.test.ts index 3678132d656..59bffad8964 100644 --- a/extensions/policy/src/policy-state.test.ts +++ b/extensions/policy/src/policy-state.test.ts @@ -1,3 +1,4 @@ +// Policy tests cover policy state plugin behavior. import { describe, expect, it } from "vitest"; import { scanPolicyChannels, scanPolicyTools } from "./policy-state.js"; diff --git a/extensions/policy/src/policy-state.ts b/extensions/policy/src/policy-state.ts index bb363b917c6..527a6649d51 100644 --- a/extensions/policy/src/policy-state.ts +++ b/extensions/policy/src/policy-state.ts @@ -1,3 +1,4 @@ +// Policy plugin module implements policy state behavior. import { createHash } from "node:crypto"; import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared"; import { normalizeAgentId } from "openclaw/plugin-sdk/routing"; diff --git a/extensions/policy/src/tool-policy-conformance.ts b/extensions/policy/src/tool-policy-conformance.ts index 235b8dc6827..b6e41df547c 100644 --- a/extensions/policy/src/tool-policy-conformance.ts +++ b/extensions/policy/src/tool-policy-conformance.ts @@ -1,3 +1,4 @@ +// Policy plugin module implements tool policy conformance behavior. export const POLICY_TOOL_GROUPS: Record = { "group:openclaw": [ "code_execution", diff --git a/extensions/qa-channel/api.ts b/extensions/qa-channel/api.ts index 803da22b4bc..fbcba2fc979 100644 --- a/extensions/qa-channel/api.ts +++ b/extensions/qa-channel/api.ts @@ -1,3 +1,4 @@ +// Qa Channel API module exposes the plugin public contract. export { DEFAULT_ACCOUNT_ID, listEnabledQaChannelAccounts, diff --git a/extensions/qa-channel/channel-plugin-api.ts b/extensions/qa-channel/channel-plugin-api.ts index 08854379e82..74ab5fdfdc5 100644 --- a/extensions/qa-channel/channel-plugin-api.ts +++ b/extensions/qa-channel/channel-plugin-api.ts @@ -1 +1,2 @@ +// Qa Channel API module exposes the plugin public contract. export { qaChannelPlugin } from "./src/channel.js"; diff --git a/extensions/qa-channel/index.ts b/extensions/qa-channel/index.ts index 6c708aa866e..45d4bbd2667 100644 --- a/extensions/qa-channel/index.ts +++ b/extensions/qa-channel/index.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin entrypoint registers its OpenClaw integration. import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract"; export default defineBundledChannelEntry({ diff --git a/extensions/qa-channel/runtime-api.ts b/extensions/qa-channel/runtime-api.ts index 81299320cd3..b4bcab232fe 100644 --- a/extensions/qa-channel/runtime-api.ts +++ b/extensions/qa-channel/runtime-api.ts @@ -1,3 +1,4 @@ +// Qa Channel API module exposes the plugin public contract. export { buildChannelConfigSchema, buildChannelOutboundSessionRoute, diff --git a/extensions/qa-channel/setup-entry.test.ts b/extensions/qa-channel/setup-entry.test.ts index ddb38e4883a..f441f64f69c 100644 --- a/extensions/qa-channel/setup-entry.test.ts +++ b/extensions/qa-channel/setup-entry.test.ts @@ -1,3 +1,4 @@ +// Qa Channel tests cover setup entry plugin behavior. import { beforeAll, describe, expect, it } from "vitest"; import setupEntry from "./setup-entry.js"; diff --git a/extensions/qa-channel/setup-entry.ts b/extensions/qa-channel/setup-entry.ts index 23f42cbfac9..6baec4d71b5 100644 --- a/extensions/qa-channel/setup-entry.ts +++ b/extensions/qa-channel/setup-entry.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements setup entry behavior. import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract"; export default defineBundledChannelSetupEntry({ diff --git a/extensions/qa-channel/src/accounts.ts b/extensions/qa-channel/src/accounts.ts index 8ff924ea4bf..7fa6eecc227 100644 --- a/extensions/qa-channel/src/accounts.ts +++ b/extensions/qa-channel/src/accounts.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements accounts behavior. import { createAccountListHelpers } from "openclaw/plugin-sdk/account-helpers"; import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id"; import { resolveMergedAccountConfig } from "openclaw/plugin-sdk/account-resolution-runtime"; diff --git a/extensions/qa-channel/src/bus-client.test.ts b/extensions/qa-channel/src/bus-client.test.ts index 59750c55735..cdcc66229e3 100644 --- a/extensions/qa-channel/src/bus-client.test.ts +++ b/extensions/qa-channel/src/bus-client.test.ts @@ -1,3 +1,4 @@ +// Qa Channel tests cover bus client plugin behavior. import { createServer } from "node:http"; import { afterEach, describe, expect, it } from "vitest"; import { buildQaTarget, getQaBusState, parseQaTarget, pollQaBus } from "./bus-client.js"; diff --git a/extensions/qa-channel/src/bus-client.ts b/extensions/qa-channel/src/bus-client.ts index 76a3554f3dd..9c3a4ddcdee 100644 --- a/extensions/qa-channel/src/bus-client.ts +++ b/extensions/qa-channel/src/bus-client.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements bus client behavior. import http from "node:http"; import https from "node:https"; import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime"; diff --git a/extensions/qa-channel/src/channel-actions.ts b/extensions/qa-channel/src/channel-actions.ts index ca257706466..047297d0441 100644 --- a/extensions/qa-channel/src/channel-actions.ts +++ b/extensions/qa-channel/src/channel-actions.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements channel actions behavior. import { jsonResult, readStringParam } from "openclaw/plugin-sdk/channel-actions"; import { extractToolSend } from "openclaw/plugin-sdk/tool-send"; import { Type } from "typebox"; diff --git a/extensions/qa-channel/src/channel-base.ts b/extensions/qa-channel/src/channel-base.ts index 540c7b87f48..96a9caa416e 100644 --- a/extensions/qa-channel/src/channel-base.ts +++ b/extensions/qa-channel/src/channel-base.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements channel base behavior. import { getChatChannelMeta } from "openclaw/plugin-sdk/channel-plugin-common"; import { listQaChannelAccountIds, diff --git a/extensions/qa-channel/src/channel.setup.ts b/extensions/qa-channel/src/channel.setup.ts index 4b58e612e34..fabaf07891b 100644 --- a/extensions/qa-channel/src/channel.setup.ts +++ b/extensions/qa-channel/src/channel.setup.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements channel.setup behavior. import type { ResolvedQaChannelAccount } from "./accounts.js"; import { createQaChannelPluginBase } from "./channel-base.js"; import type { ChannelPlugin } from "./runtime-api.js"; diff --git a/extensions/qa-channel/src/channel.test.ts b/extensions/qa-channel/src/channel.test.ts index 80a5e76ef51..52c8658db0f 100644 --- a/extensions/qa-channel/src/channel.test.ts +++ b/extensions/qa-channel/src/channel.test.ts @@ -1,3 +1,4 @@ +// Qa Channel tests cover channel plugin behavior. import path from "node:path"; import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound"; import { diff --git a/extensions/qa-channel/src/channel.ts b/extensions/qa-channel/src/channel.ts index 1457af73450..b66e5eb69c6 100644 --- a/extensions/qa-channel/src/channel.ts +++ b/extensions/qa-channel/src/channel.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements channel behavior. import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, diff --git a/extensions/qa-channel/src/config-schema.ts b/extensions/qa-channel/src/config-schema.ts index 47163dbe12e..5066e86f6d9 100644 --- a/extensions/qa-channel/src/config-schema.ts +++ b/extensions/qa-channel/src/config-schema.ts @@ -1,3 +1,4 @@ +// Qa Channel helper module supports config schema behavior. import { ToolPolicySchema, buildChannelConfigSchema, diff --git a/extensions/qa-channel/src/gateway.ts b/extensions/qa-channel/src/gateway.ts index 37bc1c9aed1..2f9f2145df8 100644 --- a/extensions/qa-channel/src/gateway.ts +++ b/extensions/qa-channel/src/gateway.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements gateway behavior. import { pollQaBus } from "./bus-client.js"; import { handleQaInbound } from "./inbound.js"; import type { ChannelGatewayContext } from "./runtime-api.js"; diff --git a/extensions/qa-channel/src/inbound.test.ts b/extensions/qa-channel/src/inbound.test.ts index 436c0188572..83ae38b0d6c 100644 --- a/extensions/qa-channel/src/inbound.test.ts +++ b/extensions/qa-channel/src/inbound.test.ts @@ -1,3 +1,4 @@ +// Qa Channel tests cover inbound plugin behavior. import { createPluginRuntimeMock } from "openclaw/plugin-sdk/channel-test-helpers"; import { describe, expect, it, vi } from "vitest"; import { setQaChannelRuntime } from "../api.js"; diff --git a/extensions/qa-channel/src/inbound.ts b/extensions/qa-channel/src/inbound.ts index 1af5134d6a9..41093403ce6 100644 --- a/extensions/qa-channel/src/inbound.ts +++ b/extensions/qa-channel/src/inbound.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements inbound behavior. import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { resolveInboundRouteEnvelopeBuilderWithRuntime } from "openclaw/plugin-sdk/inbound-envelope"; diff --git a/extensions/qa-channel/src/outbound.ts b/extensions/qa-channel/src/outbound.ts index 956a93a96bb..1a5695ffd14 100644 --- a/extensions/qa-channel/src/outbound.ts +++ b/extensions/qa-channel/src/outbound.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements outbound behavior. import { resolveQaChannelAccount } from "./accounts.js"; import { buildQaTarget, parseQaTarget, sendQaBusMessage } from "./bus-client.js"; import type { CoreConfig } from "./types.js"; diff --git a/extensions/qa-channel/src/protocol.ts b/extensions/qa-channel/src/protocol.ts index 8be30daea7f..9c34e425a19 100644 --- a/extensions/qa-channel/src/protocol.ts +++ b/extensions/qa-channel/src/protocol.ts @@ -1 +1,2 @@ +// Qa Channel plugin module implements protocol behavior. export type * from "openclaw/plugin-sdk/qa-channel-protocol"; diff --git a/extensions/qa-channel/src/runtime-api.ts b/extensions/qa-channel/src/runtime-api.ts index 613ebe90383..4d7da1368ae 100644 --- a/extensions/qa-channel/src/runtime-api.ts +++ b/extensions/qa-channel/src/runtime-api.ts @@ -1,3 +1,4 @@ +// Qa Channel API module exposes the plugin public contract. export type { ChannelMessageActionAdapter, ChannelMessageActionName, diff --git a/extensions/qa-channel/src/runtime.ts b/extensions/qa-channel/src/runtime.ts index 10196a8af24..88b139d78b2 100644 --- a/extensions/qa-channel/src/runtime.ts +++ b/extensions/qa-channel/src/runtime.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements runtime behavior. import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store"; import type { PluginRuntime } from "./runtime-api.js"; diff --git a/extensions/qa-channel/src/setup.ts b/extensions/qa-channel/src/setup.ts index b02dc32b83d..4cc8c476f9c 100644 --- a/extensions/qa-channel/src/setup.ts +++ b/extensions/qa-channel/src/setup.ts @@ -1,3 +1,4 @@ +// Qa Channel setup module handles plugin onboarding behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { DEFAULT_ACCOUNT_ID } from "./accounts.js"; import type { CoreConfig } from "./types.js"; diff --git a/extensions/qa-channel/src/status.ts b/extensions/qa-channel/src/status.ts index e0470955003..f85d3545851 100644 --- a/extensions/qa-channel/src/status.ts +++ b/extensions/qa-channel/src/status.ts @@ -1,3 +1,4 @@ +// Qa Channel plugin module implements status behavior. import { DEFAULT_ACCOUNT_ID } from "./accounts.js"; import { createComputedAccountStatusAdapter, diff --git a/extensions/qa-channel/src/types.ts b/extensions/qa-channel/src/types.ts index 49c54801c35..a48decb6984 100644 --- a/extensions/qa-channel/src/types.ts +++ b/extensions/qa-channel/src/types.ts @@ -1,3 +1,4 @@ +// Qa Channel type declarations define plugin contracts. type QaChannelActionConfig = { messages?: boolean; reactions?: boolean; diff --git a/extensions/qa-channel/test-api.ts b/extensions/qa-channel/test-api.ts index dc896f10fc4..2ae97f46e97 100644 --- a/extensions/qa-channel/test-api.ts +++ b/extensions/qa-channel/test-api.ts @@ -1,2 +1,3 @@ +// Qa Channel API module exposes the plugin public contract. export * from "./src/protocol.js"; export * from "./src/bus-client.js"; diff --git a/extensions/qianfan/api.ts b/extensions/qianfan/api.ts index 79a8808b21e..221bfe31c2e 100644 --- a/extensions/qianfan/api.ts +++ b/extensions/qianfan/api.ts @@ -1,3 +1,4 @@ +// Qianfan API module exposes the plugin public contract. export { QIANFAN_BASE_URL, QIANFAN_DEFAULT_MODEL_ID, diff --git a/extensions/qianfan/index.test.ts b/extensions/qianfan/index.test.ts index 52c308473de..eb1bc4c3a78 100644 --- a/extensions/qianfan/index.test.ts +++ b/extensions/qianfan/index.test.ts @@ -1,3 +1,4 @@ +// Qianfan tests cover index plugin behavior. import { registerSingleProviderPlugin, resolveProviderPluginChoice, diff --git a/extensions/qianfan/index.ts b/extensions/qianfan/index.ts index 5daa47f1fee..0b7685a585f 100644 --- a/extensions/qianfan/index.ts +++ b/extensions/qianfan/index.ts @@ -1,3 +1,4 @@ +// Qianfan plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyQianfanConfig, QIANFAN_DEFAULT_MODEL_REF } from "./onboard.js"; import { buildQianfanProvider } from "./provider-catalog.js"; diff --git a/extensions/qianfan/onboard.ts b/extensions/qianfan/onboard.ts index 269f4dd114a..89abfb61d77 100644 --- a/extensions/qianfan/onboard.ts +++ b/extensions/qianfan/onboard.ts @@ -1,3 +1,4 @@ +// Qianfan setup module handles plugin onboarding behavior. import { createDefaultModelsPresetAppliers, type ModelApi, diff --git a/extensions/qianfan/provider-catalog.ts b/extensions/qianfan/provider-catalog.ts index f5016ff74ce..3946f23fb3d 100644 --- a/extensions/qianfan/provider-catalog.ts +++ b/extensions/qianfan/provider-catalog.ts @@ -1,3 +1,4 @@ +// Qianfan provider module implements model/runtime integration. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/qwen/api.ts b/extensions/qwen/api.ts index 0117bad9128..0d0dd8a1c0e 100644 --- a/extensions/qwen/api.ts +++ b/extensions/qwen/api.ts @@ -1,3 +1,4 @@ +// Qwen API module exposes the plugin public contract. export { applyQwenNativeStreamingUsageCompat, buildQwenDefaultModelDefinition, diff --git a/extensions/qwen/index.test.ts b/extensions/qwen/index.test.ts index b0ee33f7b6a..968f70e7fd8 100644 --- a/extensions/qwen/index.test.ts +++ b/extensions/qwen/index.test.ts @@ -1,3 +1,4 @@ +// Qwen tests cover index plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/qwen/index.ts b/extensions/qwen/index.ts index c0ee5bb2441..e12267fc210 100644 --- a/extensions/qwen/index.ts +++ b/extensions/qwen/index.ts @@ -1,3 +1,4 @@ +// Qwen plugin entrypoint registers its OpenClaw integration. import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyQwenNativeStreamingUsageCompat } from "./api.js"; diff --git a/extensions/qwen/media-understanding-provider.test.ts b/extensions/qwen/media-understanding-provider.test.ts index 67e45141247..4bc4c558079 100644 --- a/extensions/qwen/media-understanding-provider.test.ts +++ b/extensions/qwen/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Qwen tests cover media understanding provider plugin behavior. import { createRequestCaptureJsonFetch, installPinnedHostnameTestHooks, diff --git a/extensions/qwen/media-understanding-provider.ts b/extensions/qwen/media-understanding-provider.ts index 544409d235f..5ecf5729ba9 100644 --- a/extensions/qwen/media-understanding-provider.ts +++ b/extensions/qwen/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Qwen provider module implements model/runtime integration. import { buildOpenAiCompatibleVideoRequestBody, coerceOpenAiCompatibleVideoText, diff --git a/extensions/qwen/model-definitions.ts b/extensions/qwen/model-definitions.ts index fc7e3cca99a..77848b4fa19 100644 --- a/extensions/qwen/model-definitions.ts +++ b/extensions/qwen/model-definitions.ts @@ -1,3 +1,4 @@ +// Qwen plugin module implements model definitions behavior. export { buildQwenDefaultModelDefinition, buildQwenModelDefinition, diff --git a/extensions/qwen/models.ts b/extensions/qwen/models.ts index 4ec1510b409..fa6cd699074 100644 --- a/extensions/qwen/models.ts +++ b/extensions/qwen/models.ts @@ -1,3 +1,4 @@ +// Qwen plugin module implements models behavior. import { applyProviderNativeStreamingUsageCompat, supportsNativeStreamingUsageCompat, diff --git a/extensions/qwen/onboard.ts b/extensions/qwen/onboard.ts index 6b7970bb486..e0c2957c764 100644 --- a/extensions/qwen/onboard.ts +++ b/extensions/qwen/onboard.ts @@ -1,3 +1,4 @@ +// Qwen setup module handles plugin onboarding behavior. import { createModelCatalogPresetAppliers, type OpenClawConfig, diff --git a/extensions/qwen/provider-catalog.test.ts b/extensions/qwen/provider-catalog.test.ts index ff3d6cd2bf5..b0ff17a8495 100644 --- a/extensions/qwen/provider-catalog.test.ts +++ b/extensions/qwen/provider-catalog.test.ts @@ -1,3 +1,4 @@ +// Qwen tests cover provider catalog plugin behavior. import { describe, expect, it } from "vitest"; import { applyQwenNativeStreamingUsageCompat, diff --git a/extensions/qwen/provider-catalog.ts b/extensions/qwen/provider-catalog.ts index dff177b1ec1..ae9f83f3678 100644 --- a/extensions/qwen/provider-catalog.ts +++ b/extensions/qwen/provider-catalog.ts @@ -1,3 +1,4 @@ +// Qwen provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { buildQwenModelCatalogForBaseUrl, diff --git a/extensions/qwen/provider-discovery.contract.test.ts b/extensions/qwen/provider-discovery.contract.test.ts index b50a25c549d..02ce74418a7 100644 --- a/extensions/qwen/provider-discovery.contract.test.ts +++ b/extensions/qwen/provider-discovery.contract.test.ts @@ -1,3 +1,4 @@ +// Qwen tests cover provider discovery.contract plugin behavior. import { describeModelStudioProviderDiscoveryContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeModelStudioProviderDiscoveryContract(() => import("./index.js")); diff --git a/extensions/qwen/stream.test.ts b/extensions/qwen/stream.test.ts index a67e5bb6343..21c8d557275 100644 --- a/extensions/qwen/stream.test.ts +++ b/extensions/qwen/stream.test.ts @@ -1,3 +1,4 @@ +// Qwen tests cover stream plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { describe, expect, it } from "vitest"; diff --git a/extensions/qwen/stream.ts b/extensions/qwen/stream.ts index 8c31c896184..82ad750f522 100644 --- a/extensions/qwen/stream.ts +++ b/extensions/qwen/stream.ts @@ -1,3 +1,4 @@ +// Qwen plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/qwen/test-api.ts b/extensions/qwen/test-api.ts index be5693f4f55..220d07acc18 100644 --- a/extensions/qwen/test-api.ts +++ b/extensions/qwen/test-api.ts @@ -1,2 +1,3 @@ +// Qwen API module exposes the plugin public contract. export { buildQwenMediaUnderstandingProvider } from "./media-understanding-provider.js"; export { buildQwenVideoGenerationProvider } from "./video-generation-provider.js"; diff --git a/extensions/qwen/video-generation-provider.test.ts b/extensions/qwen/video-generation-provider.test.ts index 93a58898a88..3f39d49b21b 100644 --- a/extensions/qwen/video-generation-provider.test.ts +++ b/extensions/qwen/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Qwen tests cover video generation provider plugin behavior. import { getProviderHttpMocks, installProviderHttpMockCleanup, diff --git a/extensions/qwen/video-generation-provider.ts b/extensions/qwen/video-generation-provider.ts index 6d7b3d96be2..c4a5aa368cd 100644 --- a/extensions/qwen/video-generation-provider.ts +++ b/extensions/qwen/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Qwen provider module implements model/runtime integration. import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime"; import { resolveProviderHttpRequestConfig } from "openclaw/plugin-sdk/provider-http"; diff --git a/extensions/runway/index.ts b/extensions/runway/index.ts index 29659956781..f4621d0335e 100644 --- a/extensions/runway/index.ts +++ b/extensions/runway/index.ts @@ -1,3 +1,4 @@ +// Runway plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildRunwayVideoGenerationProvider } from "./video-generation-provider.js"; diff --git a/extensions/runway/video-generation-provider.test.ts b/extensions/runway/video-generation-provider.test.ts index fd040876cdf..a93d3f3747f 100644 --- a/extensions/runway/video-generation-provider.test.ts +++ b/extensions/runway/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Runway tests cover video generation provider plugin behavior. import { getProviderHttpMocks, installProviderHttpMockCleanup, diff --git a/extensions/runway/video-generation-provider.ts b/extensions/runway/video-generation-provider.ts index 6c236ccc8cf..59a63c8e485 100644 --- a/extensions/runway/video-generation-provider.ts +++ b/extensions/runway/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Runway provider module implements model/runtime integration. import { extensionForMime } from "openclaw/plugin-sdk/media-mime"; import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime"; diff --git a/extensions/searxng/index.ts b/extensions/searxng/index.ts index 070c7d5346e..39f8cfbb43a 100644 --- a/extensions/searxng/index.ts +++ b/extensions/searxng/index.ts @@ -1,3 +1,4 @@ +// Searxng plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createSearxngWebSearchProvider } from "./src/searxng-search-provider.js"; diff --git a/extensions/searxng/src/config.ts b/extensions/searxng/src/config.ts index fd5f6e0a9ba..131886395e7 100644 --- a/extensions/searxng/src/config.ts +++ b/extensions/searxng/src/config.ts @@ -1,3 +1,4 @@ +// Searxng helper module supports config behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { normalizeResolvedSecretInputString, diff --git a/extensions/searxng/src/searxng-client.test.ts b/extensions/searxng/src/searxng-client.test.ts index 78f00e0ec9c..4ed889c403c 100644 --- a/extensions/searxng/src/searxng-client.test.ts +++ b/extensions/searxng/src/searxng-client.test.ts @@ -1,3 +1,4 @@ +// Searxng tests cover searxng client plugin behavior. import type { LookupFn } from "openclaw/plugin-sdk/ssrf-runtime"; import { beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/searxng/src/searxng-client.ts b/extensions/searxng/src/searxng-client.ts index 7a39d828588..e07e040676b 100644 --- a/extensions/searxng/src/searxng-client.ts +++ b/extensions/searxng/src/searxng-client.ts @@ -1,3 +1,4 @@ +// Searxng plugin module implements searxng client behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { DEFAULT_CACHE_TTL_MINUTES, diff --git a/extensions/searxng/src/searxng-search-provider.test.ts b/extensions/searxng/src/searxng-search-provider.test.ts index 3966f3e6fe9..e269c0ebb36 100644 --- a/extensions/searxng/src/searxng-search-provider.test.ts +++ b/extensions/searxng/src/searxng-search-provider.test.ts @@ -1,3 +1,4 @@ +// Searxng tests cover searxng search provider plugin behavior. import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest"; import { resolveSearxngBaseUrl, diff --git a/extensions/searxng/src/searxng-search-provider.ts b/extensions/searxng/src/searxng-search-provider.ts index 7781b845167..7a4f6e017ea 100644 --- a/extensions/searxng/src/searxng-search-provider.ts +++ b/extensions/searxng/src/searxng-search-provider.ts @@ -1,3 +1,4 @@ +// Searxng provider module implements model/runtime integration. import { readPositiveIntegerParam, readStringParam } from "openclaw/plugin-sdk/param-readers"; import { createWebSearchProviderContractFields, diff --git a/extensions/searxng/web-search-provider.ts b/extensions/searxng/web-search-provider.ts index 14ddec9bd4c..0273fc7ff10 100644 --- a/extensions/searxng/web-search-provider.ts +++ b/extensions/searxng/web-search-provider.ts @@ -1 +1,2 @@ +// Searxng provider module implements model/runtime integration. export { createSearxngWebSearchProvider } from "./src/searxng-search-provider.js"; diff --git a/extensions/senseaudio/index.ts b/extensions/senseaudio/index.ts index 8b6b32efe69..afea317e2c2 100644 --- a/extensions/senseaudio/index.ts +++ b/extensions/senseaudio/index.ts @@ -1,3 +1,4 @@ +// Senseaudio plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { senseaudioMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/senseaudio/media-understanding-provider.test.ts b/extensions/senseaudio/media-understanding-provider.test.ts index 6cfa195e49c..96562edd9f2 100644 --- a/extensions/senseaudio/media-understanding-provider.test.ts +++ b/extensions/senseaudio/media-understanding-provider.test.ts @@ -1,3 +1,4 @@ +// Senseaudio tests cover media understanding provider plugin behavior. import { spawnSync } from "node:child_process"; import { mkdtempSync, readFileSync, rmSync } from "node:fs"; import os from "node:os"; diff --git a/extensions/senseaudio/media-understanding-provider.ts b/extensions/senseaudio/media-understanding-provider.ts index 8525adf2bc5..1d4e1ce03e1 100644 --- a/extensions/senseaudio/media-understanding-provider.ts +++ b/extensions/senseaudio/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Senseaudio provider module implements model/runtime integration. import { transcribeOpenAiCompatibleAudio, type AudioTranscriptionRequest, diff --git a/extensions/senseaudio/test-api.ts b/extensions/senseaudio/test-api.ts index 7df611fa2b4..c69c3560c99 100644 --- a/extensions/senseaudio/test-api.ts +++ b/extensions/senseaudio/test-api.ts @@ -1 +1,2 @@ +// Senseaudio API module exposes the plugin public contract. export { senseaudioMediaUnderstandingProvider } from "./media-understanding-provider.js"; diff --git a/extensions/sglang/api.ts b/extensions/sglang/api.ts index 81f0bd62750..b91cca39c87 100644 --- a/extensions/sglang/api.ts +++ b/extensions/sglang/api.ts @@ -1,3 +1,4 @@ +// Sglang API module exposes the plugin public contract. export { SGLANG_DEFAULT_API_KEY_ENV_VAR, SGLANG_DEFAULT_BASE_URL, diff --git a/extensions/sglang/defaults.ts b/extensions/sglang/defaults.ts index d91355a8257..d239fc2670c 100644 --- a/extensions/sglang/defaults.ts +++ b/extensions/sglang/defaults.ts @@ -1,3 +1,4 @@ +// Sglang plugin module implements defaults behavior. export const SGLANG_DEFAULT_BASE_URL = "http://127.0.0.1:30000/v1"; export const SGLANG_PROVIDER_LABEL = "SGLang"; export const SGLANG_DEFAULT_API_KEY_ENV_VAR = "SGLANG_API_KEY"; diff --git a/extensions/sglang/index.test.ts b/extensions/sglang/index.test.ts index 4ce62b54bd9..b6547e9058e 100644 --- a/extensions/sglang/index.test.ts +++ b/extensions/sglang/index.test.ts @@ -1,3 +1,4 @@ +// Sglang tests cover index plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import plugin from "./index.js"; diff --git a/extensions/sglang/index.ts b/extensions/sglang/index.ts index f92bf8adf46..e1692adb8eb 100644 --- a/extensions/sglang/index.ts +++ b/extensions/sglang/index.ts @@ -1,3 +1,4 @@ +// Sglang plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type OpenClawPluginApi, diff --git a/extensions/sglang/models.ts b/extensions/sglang/models.ts index 471feb72cb1..2b5282bb84b 100644 --- a/extensions/sglang/models.ts +++ b/extensions/sglang/models.ts @@ -1,3 +1,4 @@ +// Sglang plugin module implements models behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { discoverOpenAICompatibleLocalModels } from "openclaw/plugin-sdk/provider-setup"; import { SGLANG_DEFAULT_BASE_URL, SGLANG_PROVIDER_LABEL } from "./defaults.js"; diff --git a/extensions/sglang/provider-discovery.contract.test.ts b/extensions/sglang/provider-discovery.contract.test.ts index e5ba54920af..d89f8a029c2 100644 --- a/extensions/sglang/provider-discovery.contract.test.ts +++ b/extensions/sglang/provider-discovery.contract.test.ts @@ -1,3 +1,4 @@ +// Sglang tests cover provider discovery.contract plugin behavior. import { fileURLToPath } from "node:url"; import { describeSglangProviderDiscoveryContract } from "openclaw/plugin-sdk/provider-test-contracts"; diff --git a/extensions/sms/api.ts b/extensions/sms/api.ts index 54b331ab435..67a8cf4e064 100644 --- a/extensions/sms/api.ts +++ b/extensions/sms/api.ts @@ -1 +1,2 @@ +// Sms API module exposes the plugin public contract. export { getSmsRuntime, setSmsRuntime } from "./src/runtime.js"; diff --git a/extensions/sms/channel-plugin-api.ts b/extensions/sms/channel-plugin-api.ts index 6725831f977..675f5f57c35 100644 --- a/extensions/sms/channel-plugin-api.ts +++ b/extensions/sms/channel-plugin-api.ts @@ -1 +1,2 @@ +// Sms API module exposes the plugin public contract. export { smsPlugin } from "./src/channel.js"; diff --git a/extensions/sms/contract-api.ts b/extensions/sms/contract-api.ts index bc8f64f050f..cf5b3b22e60 100644 --- a/extensions/sms/contract-api.ts +++ b/extensions/sms/contract-api.ts @@ -1,3 +1,4 @@ +// Sms API module exposes the plugin public contract. export { collectRuntimeConfigAssignments, secretTargetRegistryEntries, diff --git a/extensions/sms/index.ts b/extensions/sms/index.ts index 213a227591a..750af986710 100644 --- a/extensions/sms/index.ts +++ b/extensions/sms/index.ts @@ -1,3 +1,4 @@ +// Sms plugin entrypoint registers its OpenClaw integration. import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract"; export default defineBundledChannelEntry({ diff --git a/extensions/sms/secret-contract-api.ts b/extensions/sms/secret-contract-api.ts index 9f44ef28569..bb530efc306 100644 --- a/extensions/sms/secret-contract-api.ts +++ b/extensions/sms/secret-contract-api.ts @@ -1,3 +1,4 @@ +// Sms API module exposes the plugin public contract. export { channelSecrets, collectRuntimeConfigAssignments, diff --git a/extensions/sms/src/accounts.test.ts b/extensions/sms/src/accounts.test.ts index 4841f04b205..5a3913837ae 100644 --- a/extensions/sms/src/accounts.test.ts +++ b/extensions/sms/src/accounts.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover accounts plugin behavior. import { afterEach, describe, expect, it } from "vitest"; import { listSmsAccountIds, resolveSmsAccount } from "./accounts.js"; import { SmsConfigSchema } from "./config-schema.js"; diff --git a/extensions/sms/src/accounts.ts b/extensions/sms/src/accounts.ts index 245552457f4..121f09499f5 100644 --- a/extensions/sms/src/accounts.ts +++ b/extensions/sms/src/accounts.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements accounts behavior. import { normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-id"; import { DEFAULT_ACCOUNT_ID, diff --git a/extensions/sms/src/channel.test.ts b/extensions/sms/src/channel.test.ts index 9d2d5efabf3..1cfd4c26076 100644 --- a/extensions/sms/src/channel.test.ts +++ b/extensions/sms/src/channel.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover channel plugin behavior. import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; type ChannelModule = typeof import("./channel.js"); diff --git a/extensions/sms/src/channel.ts b/extensions/sms/src/channel.ts index a9d6ec00e19..b3edcd8c3cb 100644 --- a/extensions/sms/src/channel.ts +++ b/extensions/sms/src/channel.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements channel behavior. import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id"; import type { OpenClawConfig } from "openclaw/plugin-sdk/account-resolution"; import { diff --git a/extensions/sms/src/config-schema.ts b/extensions/sms/src/config-schema.ts index 6d8683d9148..e25282f78c5 100644 --- a/extensions/sms/src/config-schema.ts +++ b/extensions/sms/src/config-schema.ts @@ -1,3 +1,4 @@ +// Sms helper module supports config schema behavior. import { AllowFromListSchema, buildChannelConfigSchema, diff --git a/extensions/sms/src/gateway.test.ts b/extensions/sms/src/gateway.test.ts index da98d7a2f02..b2fddd6cd17 100644 --- a/extensions/sms/src/gateway.test.ts +++ b/extensions/sms/src/gateway.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover gateway plugin behavior. import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { registerSmsWebhookRoute } from "./gateway.js"; import type { SmsChannelRuntime } from "./inbound.js"; diff --git a/extensions/sms/src/gateway.ts b/extensions/sms/src/gateway.ts index a1cb1b63b2a..80e232d1663 100644 --- a/extensions/sms/src/gateway.ts +++ b/extensions/sms/src/gateway.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements gateway behavior. import { waitUntilAbort } from "openclaw/plugin-sdk/channel-outbound"; import { registerPluginHttpRoute } from "openclaw/plugin-sdk/webhook-ingress"; import type { ResolvedSmsAccount } from "./types.js"; diff --git a/extensions/sms/src/inbound.test.ts b/extensions/sms/src/inbound.test.ts index 207e0823a24..a5da91877f3 100644 --- a/extensions/sms/src/inbound.test.ts +++ b/extensions/sms/src/inbound.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover inbound plugin behavior. import { describe, expect, it, vi } from "vitest"; import { dispatchSmsInboundEvent, type SmsChannelRuntime } from "./inbound.js"; import type { sendSmsViaTwilio as sendSmsViaTwilioType } from "./twilio.js"; diff --git a/extensions/sms/src/inbound.ts b/extensions/sms/src/inbound.ts index a677359c909..a2b24a241ad 100644 --- a/extensions/sms/src/inbound.ts +++ b/extensions/sms/src/inbound.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements inbound behavior. import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime"; import { createChannelPairingChallengeIssuer } from "openclaw/plugin-sdk/channel-pairing"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; diff --git a/extensions/sms/src/phone.test.ts b/extensions/sms/src/phone.test.ts index 56c5a7b996e..d1e8f731e3a 100644 --- a/extensions/sms/src/phone.test.ts +++ b/extensions/sms/src/phone.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover phone plugin behavior. import { describe, expect, it } from "vitest"; import { looksLikeSmsPhoneNumber, diff --git a/extensions/sms/src/phone.ts b/extensions/sms/src/phone.ts index 09459657067..e6852cba260 100644 --- a/extensions/sms/src/phone.ts +++ b/extensions/sms/src/phone.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements phone behavior. export function normalizeSmsPhoneNumber(raw: string): string { const trimmed = raw.trim().replace(/^(?:sms|twilio-sms):/i, ""); if (!trimmed) { diff --git a/extensions/sms/src/runtime.ts b/extensions/sms/src/runtime.ts index efad81236a4..cb2c12b88eb 100644 --- a/extensions/sms/src/runtime.ts +++ b/extensions/sms/src/runtime.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements runtime behavior. import { createPluginRuntimeStore, type PluginRuntime } from "openclaw/plugin-sdk/runtime-store"; const { setRuntime: setSmsRuntime, getRuntime: getSmsRuntime } = diff --git a/extensions/sms/src/secret-contract.test.ts b/extensions/sms/src/secret-contract.test.ts index 443c92decda..bcc516390d9 100644 --- a/extensions/sms/src/secret-contract.test.ts +++ b/extensions/sms/src/secret-contract.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover secret contract plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { applyResolvedAssignments, diff --git a/extensions/sms/src/secret-contract.ts b/extensions/sms/src/secret-contract.ts index eff3ad4406c..38badf95dd5 100644 --- a/extensions/sms/src/secret-contract.ts +++ b/extensions/sms/src/secret-contract.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements secret contract behavior. import { collectConditionalChannelFieldAssignments, getChannelSurface, diff --git a/extensions/sms/src/send.test.ts b/extensions/sms/src/send.test.ts index 90bf58778f1..4dc9e584483 100644 --- a/extensions/sms/src/send.test.ts +++ b/extensions/sms/src/send.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover send plugin behavior. import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import type { ResolvedSmsAccount } from "./types.js"; diff --git a/extensions/sms/src/send.ts b/extensions/sms/src/send.ts index 495f3f010ea..dae1be580c6 100644 --- a/extensions/sms/src/send.ts +++ b/extensions/sms/src/send.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements send behavior. import { chunkTextForOutbound, stripMarkdown } from "openclaw/plugin-sdk/text-chunking"; import { sendSmsViaTwilio } from "./twilio.js"; import type { ResolvedSmsAccount, SmsSendResult } from "./types.js"; diff --git a/extensions/sms/src/status.test.ts b/extensions/sms/src/status.test.ts index 9eedf460123..2f9af21e987 100644 --- a/extensions/sms/src/status.test.ts +++ b/extensions/sms/src/status.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover status plugin behavior. import { describe, expect, it, vi } from "vitest"; import { formatSmsProbeLines, probeSmsAccount } from "./status.js"; import type { ResolvedSmsAccount } from "./types.js"; diff --git a/extensions/sms/src/status.ts b/extensions/sms/src/status.ts index e61e2deb6fd..79fc7b9521a 100644 --- a/extensions/sms/src/status.ts +++ b/extensions/sms/src/status.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements status behavior. import { listTwilioIncomingPhoneNumbers, listTwilioMessages, diff --git a/extensions/sms/src/twilio.test.ts b/extensions/sms/src/twilio.test.ts index dbc333ecab0..427fb444d81 100644 --- a/extensions/sms/src/twilio.test.ts +++ b/extensions/sms/src/twilio.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover twilio plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { buildTwilioInboundMessage, diff --git a/extensions/sms/src/twilio.ts b/extensions/sms/src/twilio.ts index d560ed259b1..4a985316d8e 100644 --- a/extensions/sms/src/twilio.ts +++ b/extensions/sms/src/twilio.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements twilio behavior. import { createHmac, timingSafeEqual } from "node:crypto"; import type { IncomingMessage, ServerResponse } from "node:http"; import * as querystring from "node:querystring"; diff --git a/extensions/sms/src/types.ts b/extensions/sms/src/types.ts index 4e667bc7be5..dee8c172380 100644 --- a/extensions/sms/src/types.ts +++ b/extensions/sms/src/types.ts @@ -1,3 +1,4 @@ +// Sms type declarations define plugin contracts. import type { SecretInput } from "openclaw/plugin-sdk/secret-input"; export type SmsChannelConfigFields = { diff --git a/extensions/sms/src/webhook.test.ts b/extensions/sms/src/webhook.test.ts index 0c57d436e66..d95c3a0bccc 100644 --- a/extensions/sms/src/webhook.test.ts +++ b/extensions/sms/src/webhook.test.ts @@ -1,3 +1,4 @@ +// Sms tests cover webhook plugin behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import { Readable } from "node:stream"; import { beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/sms/src/webhook.ts b/extensions/sms/src/webhook.ts index f3390fdc1df..fd4b73cba8d 100644 --- a/extensions/sms/src/webhook.ts +++ b/extensions/sms/src/webhook.ts @@ -1,3 +1,4 @@ +// Sms plugin module implements webhook behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { createFixedWindowRateLimiter } from "openclaw/plugin-sdk/webhook-ingress"; diff --git a/extensions/stepfun/index.test.ts b/extensions/stepfun/index.test.ts index 8394e715737..27b37c46001 100644 --- a/extensions/stepfun/index.test.ts +++ b/extensions/stepfun/index.test.ts @@ -1,3 +1,4 @@ +// Stepfun tests cover index plugin behavior. import { readFileSync } from "node:fs"; import { resolve } from "node:path"; import { diff --git a/extensions/stepfun/index.ts b/extensions/stepfun/index.ts index 75e71535716..1896824ca07 100644 --- a/extensions/stepfun/index.ts +++ b/extensions/stepfun/index.ts @@ -1,3 +1,4 @@ +// Stepfun plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type OpenClawConfig, diff --git a/extensions/stepfun/onboard.ts b/extensions/stepfun/onboard.ts index efb429e743c..eb20c5e8f17 100644 --- a/extensions/stepfun/onboard.ts +++ b/extensions/stepfun/onboard.ts @@ -1,3 +1,4 @@ +// Stepfun setup module handles plugin onboarding behavior. import { createModelCatalogPresetAppliers, type ModelProviderConfig, diff --git a/extensions/stepfun/provider-catalog.ts b/extensions/stepfun/provider-catalog.ts index cdc33f883dc..679ade78a31 100644 --- a/extensions/stepfun/provider-catalog.ts +++ b/extensions/stepfun/provider-catalog.ts @@ -1,3 +1,4 @@ +// Stepfun provider module implements model/runtime integration. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/synology-chat/api.ts b/extensions/synology-chat/api.ts index d6202994611..1addd8e4b28 100644 --- a/extensions/synology-chat/api.ts +++ b/extensions/synology-chat/api.ts @@ -1,3 +1,4 @@ +// Synology Chat API module exposes the plugin public contract. export { synologyChatPlugin } from "./src/channel.js"; export { setSynologyRuntime } from "./src/runtime.js"; export { collectSynologyChatSecurityAuditFindings } from "./src/security-audit.js"; diff --git a/extensions/synology-chat/channel-plugin-api.ts b/extensions/synology-chat/channel-plugin-api.ts index 3bfa6e74ac0..4fd1e2bc739 100644 --- a/extensions/synology-chat/channel-plugin-api.ts +++ b/extensions/synology-chat/channel-plugin-api.ts @@ -1 +1,2 @@ +// Synology Chat API module exposes the plugin public contract. export { synologyChatPlugin } from "./src/channel.js"; diff --git a/extensions/synology-chat/contract-api.ts b/extensions/synology-chat/contract-api.ts index 3836669cc09..498a2cb0cfe 100644 --- a/extensions/synology-chat/contract-api.ts +++ b/extensions/synology-chat/contract-api.ts @@ -1 +1,2 @@ +// Synology Chat API module exposes the plugin public contract. export { collectSynologyChatSecurityAuditFindings } from "./src/security-audit.js"; diff --git a/extensions/synology-chat/index.ts b/extensions/synology-chat/index.ts index 964ac50d3da..17ddc97b6e8 100644 --- a/extensions/synology-chat/index.ts +++ b/extensions/synology-chat/index.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin entrypoint registers its OpenClaw integration. import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract"; export default defineBundledChannelEntry({ diff --git a/extensions/synology-chat/setup-api.ts b/extensions/synology-chat/setup-api.ts index 7166027bfea..52715496c3b 100644 --- a/extensions/synology-chat/setup-api.ts +++ b/extensions/synology-chat/setup-api.ts @@ -1 +1,2 @@ +// Synology Chat API module exposes the plugin public contract. export { synologyChatSetupAdapter, synologyChatSetupWizard } from "./src/setup-surface.js"; diff --git a/extensions/synology-chat/setup-entry.ts b/extensions/synology-chat/setup-entry.ts index ba20bf1f3d3..28d3ec44998 100644 --- a/extensions/synology-chat/setup-entry.ts +++ b/extensions/synology-chat/setup-entry.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements setup entry behavior. import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract"; export default defineBundledChannelSetupEntry({ diff --git a/extensions/synology-chat/src/approval-auth.test.ts b/extensions/synology-chat/src/approval-auth.test.ts index 95d25472197..69f1e9bbdd5 100644 --- a/extensions/synology-chat/src/approval-auth.test.ts +++ b/extensions/synology-chat/src/approval-auth.test.ts @@ -1,3 +1,4 @@ +// Synology Chat tests cover approval auth plugin behavior. import { describe, expect, it } from "vitest"; import { synologyChatApprovalAuth } from "./approval-auth.js"; diff --git a/extensions/synology-chat/src/approval-auth.ts b/extensions/synology-chat/src/approval-auth.ts index e5ea780a5fa..f46cb2a3a38 100644 --- a/extensions/synology-chat/src/approval-auth.ts +++ b/extensions/synology-chat/src/approval-auth.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements approval auth behavior. import { createResolvedApproverActionAuthAdapter, resolveApprovalApprovers, diff --git a/extensions/synology-chat/src/channel.integration.test.ts b/extensions/synology-chat/src/channel.integration.test.ts index 058b7abef55..888376a51f8 100644 --- a/extensions/synology-chat/src/channel.integration.test.ts +++ b/extensions/synology-chat/src/channel.integration.test.ts @@ -1,3 +1,4 @@ +// Synology Chat tests cover channel.integration plugin behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest"; import { diff --git a/extensions/synology-chat/src/channel.test-mocks.ts b/extensions/synology-chat/src/channel.test-mocks.ts index 368eb8dc19c..5ff5d61f66d 100644 --- a/extensions/synology-chat/src/channel.test-mocks.ts +++ b/extensions/synology-chat/src/channel.test-mocks.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements channel mocks behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import type { Mock } from "vitest"; import { vi } from "vitest"; diff --git a/extensions/synology-chat/src/channel.test.ts b/extensions/synology-chat/src/channel.test.ts index e8e5eff2de9..b915f280eae 100644 --- a/extensions/synology-chat/src/channel.test.ts +++ b/extensions/synology-chat/src/channel.test.ts @@ -1,3 +1,4 @@ +// Synology Chat tests cover channel plugin behavior. import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound"; import { createPluginSetupWizardStatus } from "openclaw/plugin-sdk/plugin-test-runtime"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/synology-chat/src/client.test.ts b/extensions/synology-chat/src/client.test.ts index 3b0b212c46a..750a0bee8ea 100644 --- a/extensions/synology-chat/src/client.test.ts +++ b/extensions/synology-chat/src/client.test.ts @@ -1,3 +1,4 @@ +// Synology Chat tests cover client plugin behavior. import { EventEmitter } from "node:events"; import type { ClientRequest, IncomingMessage, RequestOptions } from "node:http"; import { describe, it, expect, vi, beforeAll, beforeEach, afterEach } from "vitest"; diff --git a/extensions/synology-chat/src/config-schema.ts b/extensions/synology-chat/src/config-schema.ts index 618d48a19b4..02ff6f536fb 100644 --- a/extensions/synology-chat/src/config-schema.ts +++ b/extensions/synology-chat/src/config-schema.ts @@ -1,3 +1,4 @@ +// Synology Chat helper module supports config schema behavior. import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema"; import { z } from "zod"; diff --git a/extensions/synology-chat/src/core.test.ts b/extensions/synology-chat/src/core.test.ts index 908121e961b..a49b031ea43 100644 --- a/extensions/synology-chat/src/core.test.ts +++ b/extensions/synology-chat/src/core.test.ts @@ -1,3 +1,4 @@ +// Synology Chat tests cover core plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import { diff --git a/extensions/synology-chat/src/gateway-runtime.ts b/extensions/synology-chat/src/gateway-runtime.ts index 7c9885b8826..d535b9ce3a4 100644 --- a/extensions/synology-chat/src/gateway-runtime.ts +++ b/extensions/synology-chat/src/gateway-runtime.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements gateway runtime behavior. import { DEFAULT_ACCOUNT_ID, type OpenClawConfig } from "openclaw/plugin-sdk/account-resolution"; import { registerPluginHttpRoute } from "openclaw/plugin-sdk/webhook-ingress"; import { listAccountIds, resolveAccount } from "./accounts.js"; diff --git a/extensions/synology-chat/src/inbound-context.ts b/extensions/synology-chat/src/inbound-context.ts index 10290870922..9f1161800c1 100644 --- a/extensions/synology-chat/src/inbound-context.ts +++ b/extensions/synology-chat/src/inbound-context.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements inbound context behavior. export type SynologyInboundMessage = { body: string; from: string; diff --git a/extensions/synology-chat/src/inbound-event.ts b/extensions/synology-chat/src/inbound-event.ts index 6ee91b7367d..77719efd3f8 100644 --- a/extensions/synology-chat/src/inbound-event.ts +++ b/extensions/synology-chat/src/inbound-event.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements inbound event behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { sendMessage } from "./client.js"; import type { SynologyInboundMessage } from "./inbound-context.js"; diff --git a/extensions/synology-chat/src/runtime.ts b/extensions/synology-chat/src/runtime.ts index 4376e8d2d9c..065e650cba6 100644 --- a/extensions/synology-chat/src/runtime.ts +++ b/extensions/synology-chat/src/runtime.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements runtime behavior. import { createPluginRuntimeStore, type PluginRuntime } from "openclaw/plugin-sdk/runtime-store"; const { setRuntime: setSynologyRuntime, getRuntime: getSynologyRuntime } = diff --git a/extensions/synology-chat/src/security-audit.test.ts b/extensions/synology-chat/src/security-audit.test.ts index d0f94ca8c9b..31efbb9600a 100644 --- a/extensions/synology-chat/src/security-audit.test.ts +++ b/extensions/synology-chat/src/security-audit.test.ts @@ -1,3 +1,4 @@ +// Synology Chat tests cover security audit plugin behavior. import { describe, expect, it } from "vitest"; import { collectSynologyChatSecurityAuditFindings } from "./security-audit.js"; import type { ResolvedSynologyChatAccount } from "./types.js"; diff --git a/extensions/synology-chat/src/security-audit.ts b/extensions/synology-chat/src/security-audit.ts index d1293ed26ad..4abe0d2fd5a 100644 --- a/extensions/synology-chat/src/security-audit.ts +++ b/extensions/synology-chat/src/security-audit.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements security audit behavior. import type { ResolvedSynologyChatAccount } from "./types.js"; export function collectSynologyChatSecurityAuditFindings(params: { diff --git a/extensions/synology-chat/src/session-key.ts b/extensions/synology-chat/src/session-key.ts index d5d0bf418fc..af517d20a9a 100644 --- a/extensions/synology-chat/src/session-key.ts +++ b/extensions/synology-chat/src/session-key.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements session key behavior. import { buildAgentSessionKey } from "openclaw/plugin-sdk/routing"; const CHANNEL_ID = "synology-chat"; diff --git a/extensions/synology-chat/src/setup-surface.ts b/extensions/synology-chat/src/setup-surface.ts index ffcac001306..5cdd711735c 100644 --- a/extensions/synology-chat/src/setup-surface.ts +++ b/extensions/synology-chat/src/setup-surface.ts @@ -1,3 +1,4 @@ +// Synology Chat plugin module implements setup surface behavior. import { createAllowFromSection, createSetupTranslator, diff --git a/extensions/synology-chat/src/test-http-utils.ts b/extensions/synology-chat/src/test-http-utils.ts index 0d51bfa78e9..2184212b14d 100644 --- a/extensions/synology-chat/src/test-http-utils.ts +++ b/extensions/synology-chat/src/test-http-utils.ts @@ -1,3 +1,4 @@ +// Synology Chat helper module supports test http utils behavior. import { EventEmitter } from "node:events"; import type { IncomingMessage, ServerResponse } from "node:http"; diff --git a/extensions/synology-chat/src/webhook-handler.test.ts b/extensions/synology-chat/src/webhook-handler.test.ts index 350c797db71..97138e8326e 100644 --- a/extensions/synology-chat/src/webhook-handler.test.ts +++ b/extensions/synology-chat/src/webhook-handler.test.ts @@ -1,3 +1,4 @@ +// Synology Chat tests cover webhook handler plugin behavior. import { describe, it, expect, vi, beforeEach } from "vitest"; import { makeFormBody, makeReq, makeRes, makeStalledReq } from "./test-http-utils.js"; import type { ResolvedSynologyChatAccount } from "./types.js"; diff --git a/extensions/synthetic/api.ts b/extensions/synthetic/api.ts index 46d4257076a..3b1a31e7eb4 100644 --- a/extensions/synthetic/api.ts +++ b/extensions/synthetic/api.ts @@ -1,3 +1,4 @@ +// Synthetic API module exposes the plugin public contract. export { applySyntheticConfig, applySyntheticProviderConfig } from "./onboard.js"; export { buildSyntheticModelDefinition, diff --git a/extensions/synthetic/index.ts b/extensions/synthetic/index.ts index 7ef2fa4688c..74adaca355a 100644 --- a/extensions/synthetic/index.ts +++ b/extensions/synthetic/index.ts @@ -1,3 +1,4 @@ +// Synthetic plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applySyntheticConfig, SYNTHETIC_DEFAULT_MODEL_REF } from "./onboard.js"; import { buildSyntheticProvider } from "./provider-catalog.js"; diff --git a/extensions/synthetic/models.ts b/extensions/synthetic/models.ts index 62433289d5a..5ed141d682a 100644 --- a/extensions/synthetic/models.ts +++ b/extensions/synthetic/models.ts @@ -1,3 +1,4 @@ +// Synthetic plugin module implements models behavior. import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; export const SYNTHETIC_BASE_URL = "https://api.synthetic.new/anthropic"; diff --git a/extensions/synthetic/onboard.test.ts b/extensions/synthetic/onboard.test.ts index 9c1ba64b845..ec8936b3a63 100644 --- a/extensions/synthetic/onboard.test.ts +++ b/extensions/synthetic/onboard.test.ts @@ -1,3 +1,4 @@ +// Synthetic tests cover onboard plugin behavior. import { resolveAgentModelPrimaryValue } from "openclaw/plugin-sdk/provider-onboard"; import { expectProviderOnboardMergedLegacyConfig } from "openclaw/plugin-sdk/provider-test-contracts"; import { beforeAll, describe, expect, it } from "vitest"; diff --git a/extensions/synthetic/onboard.ts b/extensions/synthetic/onboard.ts index 11f44c5c311..3e23d00aef6 100644 --- a/extensions/synthetic/onboard.ts +++ b/extensions/synthetic/onboard.ts @@ -1,3 +1,4 @@ +// Synthetic setup module handles plugin onboarding behavior. import { createModelCatalogPresetAppliers, type OpenClawConfig, diff --git a/extensions/synthetic/provider-catalog.ts b/extensions/synthetic/provider-catalog.ts index a98133265ab..cb9ec709ba6 100644 --- a/extensions/synthetic/provider-catalog.ts +++ b/extensions/synthetic/provider-catalog.ts @@ -1,3 +1,4 @@ +// Synthetic provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { buildSyntheticModelDefinition, diff --git a/extensions/talk-voice/api.ts b/extensions/talk-voice/api.ts index 0c898dbc95b..8273d584303 100644 --- a/extensions/talk-voice/api.ts +++ b/extensions/talk-voice/api.ts @@ -1,2 +1,3 @@ +// Talk Voice API module exposes the plugin public contract. export { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; export type { OpenClawPluginApi, PluginRuntime } from "openclaw/plugin-sdk/core"; diff --git a/extensions/talk-voice/index.test.ts b/extensions/talk-voice/index.test.ts index 9e4063744b2..1d98eac0ede 100644 --- a/extensions/talk-voice/index.test.ts +++ b/extensions/talk-voice/index.test.ts @@ -1,3 +1,4 @@ +// Talk Voice tests cover index plugin behavior. import type { OpenClawPluginCommandDefinition } from "openclaw/plugin-sdk/core"; import { describe, expect, it, vi } from "vitest"; import type { PluginRuntime } from "./api.js"; diff --git a/extensions/talk-voice/index.ts b/extensions/talk-voice/index.ts index 50a1f5fd96b..1400b8b774a 100644 --- a/extensions/talk-voice/index.ts +++ b/extensions/talk-voice/index.ts @@ -1,3 +1,4 @@ +// Talk Voice plugin entrypoint registers its OpenClaw integration. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime"; diff --git a/extensions/tavily/index.ts b/extensions/tavily/index.ts index 9fb207261a3..80b86be9d11 100644 --- a/extensions/tavily/index.ts +++ b/extensions/tavily/index.ts @@ -1,3 +1,4 @@ +// Tavily plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createTavilyExtractTool } from "./src/tavily-extract-tool.js"; import { createTavilyWebSearchProvider } from "./src/tavily-search-provider.js"; diff --git a/extensions/tavily/src/config.ts b/extensions/tavily/src/config.ts index be91c819760..39631d5f594 100644 --- a/extensions/tavily/src/config.ts +++ b/extensions/tavily/src/config.ts @@ -1,3 +1,4 @@ +// Tavily helper module supports config behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { resolvePositiveTimeoutSeconds } from "openclaw/plugin-sdk/provider-web-search"; import { diff --git a/extensions/tavily/src/tavily-client.test.ts b/extensions/tavily/src/tavily-client.test.ts index 95d41eacd02..d5e6c3cd26a 100644 --- a/extensions/tavily/src/tavily-client.test.ts +++ b/extensions/tavily/src/tavily-client.test.ts @@ -1,3 +1,4 @@ +// Tavily tests cover tavily client plugin behavior. import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest"; // Capture every call to postTrustedWebToolsJson so we can assert on extraHeaders. diff --git a/extensions/tavily/src/tavily-client.ts b/extensions/tavily/src/tavily-client.ts index 76035f746eb..63b1337cbcb 100644 --- a/extensions/tavily/src/tavily-client.ts +++ b/extensions/tavily/src/tavily-client.ts @@ -1,3 +1,4 @@ +// Tavily plugin module implements tavily client behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { DEFAULT_CACHE_TTL_MINUTES, diff --git a/extensions/tavily/src/tavily-extract-tool.ts b/extensions/tavily/src/tavily-extract-tool.ts index c50f8696573..6bd26253796 100644 --- a/extensions/tavily/src/tavily-extract-tool.ts +++ b/extensions/tavily/src/tavily-extract-tool.ts @@ -1,3 +1,4 @@ +// Tavily plugin module implements tavily extract tool behavior. import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-runtime"; import { jsonResult, diff --git a/extensions/tavily/src/tavily-search-provider.ts b/extensions/tavily/src/tavily-search-provider.ts index 7308a192247..068f1c9370f 100644 --- a/extensions/tavily/src/tavily-search-provider.ts +++ b/extensions/tavily/src/tavily-search-provider.ts @@ -1,3 +1,4 @@ +// Tavily provider module implements model/runtime integration. import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers"; import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { buildTavilyWebSearchProviderBase } from "../web-search-shared.js"; diff --git a/extensions/tavily/src/tavily-search-tool.ts b/extensions/tavily/src/tavily-search-tool.ts index f81cb7de14b..49703607cb0 100644 --- a/extensions/tavily/src/tavily-search-tool.ts +++ b/extensions/tavily/src/tavily-search-tool.ts @@ -1,3 +1,4 @@ +// Tavily plugin module implements tavily search tool behavior. import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-runtime"; import { jsonResult, diff --git a/extensions/tavily/src/tavily-tool-config.ts b/extensions/tavily/src/tavily-tool-config.ts index fcd74baa43d..4c1f451f541 100644 --- a/extensions/tavily/src/tavily-tool-config.ts +++ b/extensions/tavily/src/tavily-tool-config.ts @@ -1,3 +1,4 @@ +// Tavily helper module supports tavily tool config behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import type { OpenClawPluginToolContext } from "openclaw/plugin-sdk/plugin-entry"; import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-runtime"; diff --git a/extensions/tavily/src/tavily-tool-schema.ts b/extensions/tavily/src/tavily-tool-schema.ts index fc151460d14..411326a357c 100644 --- a/extensions/tavily/src/tavily-tool-schema.ts +++ b/extensions/tavily/src/tavily-tool-schema.ts @@ -1 +1,2 @@ +// Tavily helper module supports tavily tool schema behavior. export { optionalStringEnum } from "openclaw/plugin-sdk/channel-actions"; diff --git a/extensions/tavily/src/tavily-tools.test.ts b/extensions/tavily/src/tavily-tools.test.ts index eb39cdd93f7..9ff854a3396 100644 --- a/extensions/tavily/src/tavily-tools.test.ts +++ b/extensions/tavily/src/tavily-tools.test.ts @@ -1,3 +1,4 @@ +// Tavily tests cover tavily tools plugin behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-runtime"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; diff --git a/extensions/tavily/web-search-contract-api.ts b/extensions/tavily/web-search-contract-api.ts index 54266140b35..a8c6dbad097 100644 --- a/extensions/tavily/web-search-contract-api.ts +++ b/extensions/tavily/web-search-contract-api.ts @@ -1,3 +1,4 @@ +// Tavily API module exposes the plugin public contract. import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-contract"; import { buildTavilyWebSearchProviderBase } from "./web-search-shared.js"; diff --git a/extensions/tavily/web-search-provider.ts b/extensions/tavily/web-search-provider.ts index 3f5a22cc370..a198b27c658 100644 --- a/extensions/tavily/web-search-provider.ts +++ b/extensions/tavily/web-search-provider.ts @@ -1 +1,2 @@ +// Tavily provider module implements model/runtime integration. export { createTavilyWebSearchProvider } from "./src/tavily-search-provider.js"; diff --git a/extensions/tavily/web-search-shared.ts b/extensions/tavily/web-search-shared.ts index 1898f95a47f..0d180c8e406 100644 --- a/extensions/tavily/web-search-shared.ts +++ b/extensions/tavily/web-search-shared.ts @@ -1,3 +1,4 @@ +// Tavily plugin module implements web search shared behavior. import { createWebSearchProviderContractFields, type WebSearchProviderPlugin, diff --git a/extensions/tencent/api.ts b/extensions/tencent/api.ts index 92766a19178..a43cc49801f 100644 --- a/extensions/tencent/api.ts +++ b/extensions/tencent/api.ts @@ -1,3 +1,4 @@ +// Tencent API module exposes the plugin public contract. export { buildTokenHubModelDefinition, TOKENHUB_BASE_URL, diff --git a/extensions/tencent/index.ts b/extensions/tencent/index.ts index 42922553cff..f41efd09615 100644 --- a/extensions/tencent/index.ts +++ b/extensions/tencent/index.ts @@ -1,3 +1,4 @@ +// Tencent plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { buildSingleProviderApiKeyCatalog } from "openclaw/plugin-sdk/provider-catalog-shared"; diff --git a/extensions/tencent/models.ts b/extensions/tencent/models.ts index ca5cc3fd964..c2625d4759c 100644 --- a/extensions/tencent/models.ts +++ b/extensions/tencent/models.ts @@ -1,3 +1,4 @@ +// Tencent plugin module implements models behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/tencent/onboard.ts b/extensions/tencent/onboard.ts index b056342d94c..cb18a52b552 100644 --- a/extensions/tencent/onboard.ts +++ b/extensions/tencent/onboard.ts @@ -1,3 +1,4 @@ +// Tencent setup module handles plugin onboarding behavior. import { applyAgentDefaultModelPrimary, applyProviderConfigWithModelCatalog, diff --git a/extensions/tencent/provider-catalog.ts b/extensions/tencent/provider-catalog.ts index cd7c66a413c..56757de0f73 100644 --- a/extensions/tencent/provider-catalog.ts +++ b/extensions/tencent/provider-catalog.ts @@ -1,3 +1,4 @@ +// Tencent provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { buildTokenHubModelDefinition, diff --git a/extensions/tencent/provider-discovery.ts b/extensions/tencent/provider-discovery.ts index 55dc573aefd..66ca4f4e580 100644 --- a/extensions/tencent/provider-discovery.ts +++ b/extensions/tencent/provider-discovery.ts @@ -1,3 +1,4 @@ +// Tencent provider module implements model/runtime integration. import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; import { buildTokenHubProvider } from "./provider-catalog.js"; diff --git a/extensions/test-support/debug-proxy-env-test-helpers.ts b/extensions/test-support/debug-proxy-env-test-helpers.ts index 84d528e2cde..d81acb273b1 100644 --- a/extensions/test-support/debug-proxy-env-test-helpers.ts +++ b/extensions/test-support/debug-proxy-env-test-helpers.ts @@ -1,3 +1,4 @@ +// Test Support helper module supports debug proxy env test helpers behavior. import { afterEach, vi } from "vitest"; const DEBUG_PROXY_ENV_KEYS = [ diff --git a/extensions/test-support/generation-live-test-helpers.ts b/extensions/test-support/generation-live-test-helpers.ts index c1cdfd54611..99f604f4175 100644 --- a/extensions/test-support/generation-live-test-helpers.ts +++ b/extensions/test-support/generation-live-test-helpers.ts @@ -1 +1,2 @@ +// Test Support helper module supports generation live test helpers behavior. export { maybeLoadShellEnvForGenerationProviders } from "openclaw/plugin-sdk/test-env"; diff --git a/extensions/test-support/provider-model-test-helpers.ts b/extensions/test-support/provider-model-test-helpers.ts index 7599f03d3e8..451a8e8f2e3 100644 --- a/extensions/test-support/provider-model-test-helpers.ts +++ b/extensions/test-support/provider-model-test-helpers.ts @@ -1,3 +1,4 @@ +// Test Support provider module implements model/runtime integration. import type { ModelRegistry } from "openclaw/plugin-sdk/agent-sessions"; import type { ProviderCatalogContext, diff --git a/extensions/test-support/streaming-error-response.ts b/extensions/test-support/streaming-error-response.ts index 1ae8275c75d..ea2777c42d3 100644 --- a/extensions/test-support/streaming-error-response.ts +++ b/extensions/test-support/streaming-error-response.ts @@ -1,3 +1,4 @@ +// Test Support plugin module implements streaming error response behavior. export function createStreamingErrorResponse(params: { status: number; chunkCount: number; diff --git a/extensions/thread-ownership/api.ts b/extensions/thread-ownership/api.ts index d28c5a6a627..59c85018b25 100644 --- a/extensions/thread-ownership/api.ts +++ b/extensions/thread-ownership/api.ts @@ -1,3 +1,4 @@ +// Thread Ownership API module exposes the plugin public contract. export type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; export { definePluginEntry, type OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry"; export { diff --git a/extensions/thread-ownership/index.test.ts b/extensions/thread-ownership/index.test.ts index 04f493762bb..3804f65d5e6 100644 --- a/extensions/thread-ownership/index.test.ts +++ b/extensions/thread-ownership/index.test.ts @@ -1,3 +1,4 @@ +// Thread Ownership tests cover index plugin behavior. import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import type { OpenClawPluginApi } from "./api.js"; import register from "./index.js"; diff --git a/extensions/thread-ownership/index.ts b/extensions/thread-ownership/index.ts index ba3b8bf7998..2bef7b601e9 100644 --- a/extensions/thread-ownership/index.ts +++ b/extensions/thread-ownership/index.ts @@ -1,3 +1,4 @@ +// Thread Ownership plugin entrypoint registers its OpenClaw integration. import { resolveLivePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime"; import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime"; import { escapeRegExp } from "openclaw/plugin-sdk/text-utility-runtime"; diff --git a/extensions/together/api.ts b/extensions/together/api.ts index a61785f59d7..547bb02d0c8 100644 --- a/extensions/together/api.ts +++ b/extensions/together/api.ts @@ -1,3 +1,4 @@ +// Together API module exposes the plugin public contract. export { buildTogetherModelDefinition, TOGETHER_BASE_URL, diff --git a/extensions/together/index.ts b/extensions/together/index.ts index ae80b378d27..445a3750cde 100644 --- a/extensions/together/index.ts +++ b/extensions/together/index.ts @@ -1,3 +1,4 @@ +// Together plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyTogetherConfig, TOGETHER_DEFAULT_MODEL_REF } from "./onboard.js"; import { buildTogetherProvider } from "./provider-catalog.js"; diff --git a/extensions/together/models.ts b/extensions/together/models.ts index b5ca845d65a..c9c014b6f01 100644 --- a/extensions/together/models.ts +++ b/extensions/together/models.ts @@ -1,3 +1,4 @@ +// Together plugin module implements models behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/together/onboard.ts b/extensions/together/onboard.ts index 5b8f69d20a9..83c558ad186 100644 --- a/extensions/together/onboard.ts +++ b/extensions/together/onboard.ts @@ -1,3 +1,4 @@ +// Together setup module handles plugin onboarding behavior. import { createModelCatalogPresetAppliers, type OpenClawConfig, diff --git a/extensions/together/provider-catalog.ts b/extensions/together/provider-catalog.ts index acaa8480459..227c0916abe 100644 --- a/extensions/together/provider-catalog.ts +++ b/extensions/together/provider-catalog.ts @@ -1,3 +1,4 @@ +// Together provider module implements model/runtime integration. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/together/together.live.test.ts b/extensions/together/together.live.test.ts index dd27c605ff5..03d82d37e79 100644 --- a/extensions/together/together.live.test.ts +++ b/extensions/together/together.live.test.ts @@ -1,3 +1,4 @@ +// Together tests cover together plugin behavior. import { completeSimple, type Model } from "openclaw/plugin-sdk/llm"; import { describe, expect, it } from "vitest"; import { TOGETHER_BASE_URL, TOGETHER_MODEL_CATALOG } from "./models.js"; diff --git a/extensions/together/video-generation-provider.test.ts b/extensions/together/video-generation-provider.test.ts index ac2b3f540f8..cfac9012493 100644 --- a/extensions/together/video-generation-provider.test.ts +++ b/extensions/together/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Together tests cover video generation provider plugin behavior. import { getProviderHttpMocks, installProviderHttpMockCleanup, diff --git a/extensions/together/video-generation-provider.ts b/extensions/together/video-generation-provider.ts index d4c7a2e975f..4651b68f9b4 100644 --- a/extensions/together/video-generation-provider.ts +++ b/extensions/together/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Together provider module implements model/runtime integration. import { extensionForMime } from "openclaw/plugin-sdk/media-mime"; import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime"; diff --git a/extensions/tokenjuice/index.test.ts b/extensions/tokenjuice/index.test.ts index bbdd8711009..d878766a97d 100644 --- a/extensions/tokenjuice/index.test.ts +++ b/extensions/tokenjuice/index.test.ts @@ -1,3 +1,4 @@ +// Tokenjuice tests cover index plugin behavior. import fs from "node:fs"; import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/tokenjuice/index.ts b/extensions/tokenjuice/index.ts index 93792a415af..db98594d291 100644 --- a/extensions/tokenjuice/index.ts +++ b/extensions/tokenjuice/index.ts @@ -1,3 +1,4 @@ +// Tokenjuice plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createTokenjuiceAgentToolResultMiddleware } from "./tool-result-middleware.js"; diff --git a/extensions/tokenjuice/manifest.test.ts b/extensions/tokenjuice/manifest.test.ts index 6351bb2dd21..27dc50a0b24 100644 --- a/extensions/tokenjuice/manifest.test.ts +++ b/extensions/tokenjuice/manifest.test.ts @@ -1,3 +1,4 @@ +// Tokenjuice tests cover manifest plugin behavior. import fs from "node:fs"; import { describe, expect, it } from "vitest"; diff --git a/extensions/tokenjuice/runtime-api.ts b/extensions/tokenjuice/runtime-api.ts index 8bea9c69c37..7cbe9e2b684 100644 --- a/extensions/tokenjuice/runtime-api.ts +++ b/extensions/tokenjuice/runtime-api.ts @@ -1 +1,2 @@ +// Tokenjuice API module exposes the plugin public contract. export { createTokenjuiceOpenClawEmbeddedExtension } from "tokenjuice/openclaw"; diff --git a/extensions/tokenjuice/tool-result-middleware.ts b/extensions/tokenjuice/tool-result-middleware.ts index 9cfb0fffb23..a2392ee59dc 100644 --- a/extensions/tokenjuice/tool-result-middleware.ts +++ b/extensions/tokenjuice/tool-result-middleware.ts @@ -1,3 +1,4 @@ +// Tokenjuice plugin module implements tool result middleware behavior. import process from "node:process"; import type { AgentToolResultMiddleware, diff --git a/extensions/tts-local-cli/index.ts b/extensions/tts-local-cli/index.ts index 6b53e6af3fb..478da50a869 100644 --- a/extensions/tts-local-cli/index.ts +++ b/extensions/tts-local-cli/index.ts @@ -1,3 +1,4 @@ +// Tts Local Cli plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { buildCliSpeechProvider } from "./speech-provider.js"; diff --git a/extensions/tts-local-cli/speech-provider.test.ts b/extensions/tts-local-cli/speech-provider.test.ts index a960af0b76d..6080d7b4d73 100644 --- a/extensions/tts-local-cli/speech-provider.test.ts +++ b/extensions/tts-local-cli/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Tts Local Cli tests cover speech provider plugin behavior. import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/tts-local-cli/speech-provider.ts b/extensions/tts-local-cli/speech-provider.ts index 283057ce748..e1a05f8d023 100644 --- a/extensions/tts-local-cli/speech-provider.ts +++ b/extensions/tts-local-cli/speech-provider.ts @@ -1,3 +1,4 @@ +// Tts Local Cli provider module implements model/runtime integration. import { spawn } from "node:child_process"; import { existsSync, readdirSync, readFileSync } from "node:fs"; import path from "node:path"; diff --git a/extensions/twitch/api.ts b/extensions/twitch/api.ts index 21035a2baf9..539ec74283f 100644 --- a/extensions/twitch/api.ts +++ b/extensions/twitch/api.ts @@ -1,3 +1,4 @@ +// Twitch API module exposes the plugin public contract. export { type ChannelAccountSnapshot, type ChannelCapabilities, diff --git a/extensions/twitch/channel-plugin-api.ts b/extensions/twitch/channel-plugin-api.ts index 556e36458b3..56fde98a56f 100644 --- a/extensions/twitch/channel-plugin-api.ts +++ b/extensions/twitch/channel-plugin-api.ts @@ -1 +1,2 @@ +// Twitch API module exposes the plugin public contract. export { twitchPlugin } from "./src/plugin.js"; diff --git a/extensions/twitch/index.test.ts b/extensions/twitch/index.test.ts index 54e1b0e0f6d..c92aa77f3fd 100644 --- a/extensions/twitch/index.test.ts +++ b/extensions/twitch/index.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover index plugin behavior. import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers"; import { describe } from "vitest"; import entry from "./index.js"; diff --git a/extensions/twitch/index.ts b/extensions/twitch/index.ts index 86d45d23d3f..a7771a02ef8 100644 --- a/extensions/twitch/index.ts +++ b/extensions/twitch/index.ts @@ -1,3 +1,4 @@ +// Twitch plugin entrypoint registers its OpenClaw integration. import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract"; export default defineBundledChannelEntry({ diff --git a/extensions/twitch/setup-entry.ts b/extensions/twitch/setup-entry.ts index 2c06653ec9a..35b112c5950 100644 --- a/extensions/twitch/setup-entry.ts +++ b/extensions/twitch/setup-entry.ts @@ -1,3 +1,4 @@ +// Twitch plugin module implements setup entry behavior. import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract"; export default defineBundledChannelSetupEntry({ diff --git a/extensions/twitch/src/access-control.test.ts b/extensions/twitch/src/access-control.test.ts index 34ecd029304..fe3055f139b 100644 --- a/extensions/twitch/src/access-control.test.ts +++ b/extensions/twitch/src/access-control.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover access control plugin behavior. import { describe, expect, it } from "vitest"; import { checkTwitchAccessControl } from "./access-control.js"; import type { TwitchAccountConfig, TwitchChatMessage } from "./types.js"; diff --git a/extensions/twitch/src/access-control.ts b/extensions/twitch/src/access-control.ts index fe5ac8ceac5..12b57708641 100644 --- a/extensions/twitch/src/access-control.ts +++ b/extensions/twitch/src/access-control.ts @@ -1,3 +1,4 @@ +// Twitch plugin module implements access control behavior. import { createChannelIngressResolver, defineStableChannelIngressIdentity, diff --git a/extensions/twitch/src/actions.test.ts b/extensions/twitch/src/actions.test.ts index 592317e77bd..421077bfa18 100644 --- a/extensions/twitch/src/actions.test.ts +++ b/extensions/twitch/src/actions.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover actions plugin behavior. import { describe, expect, it, vi, beforeEach } from "vitest"; import { twitchMessageActions } from "./actions.js"; import type { ResolvedTwitchAccountContext } from "./config.js"; diff --git a/extensions/twitch/src/client-manager-registry.test.ts b/extensions/twitch/src/client-manager-registry.test.ts index 3fffe40da3a..721267ea771 100644 --- a/extensions/twitch/src/client-manager-registry.test.ts +++ b/extensions/twitch/src/client-manager-registry.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover client manager registry plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { clearRegistryForTest, diff --git a/extensions/twitch/src/config-schema.test.ts b/extensions/twitch/src/config-schema.test.ts index 1a63a2fcc32..0fd21cb0f1e 100644 --- a/extensions/twitch/src/config-schema.test.ts +++ b/extensions/twitch/src/config-schema.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover config schema plugin behavior. import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema"; import { validateJsonSchemaValue } from "openclaw/plugin-sdk/json-schema-runtime"; import { describe, expect, it } from "vitest"; diff --git a/extensions/twitch/src/config-schema.ts b/extensions/twitch/src/config-schema.ts index 623c569fc59..7884d9c22c6 100644 --- a/extensions/twitch/src/config-schema.ts +++ b/extensions/twitch/src/config-schema.ts @@ -1,3 +1,4 @@ +// Twitch helper module supports config schema behavior. import { MarkdownConfigSchema } from "openclaw/plugin-sdk/channel-config-primitives"; import { z } from "zod"; diff --git a/extensions/twitch/src/config.test.ts b/extensions/twitch/src/config.test.ts index d78a338bdef..7f1ef0ca2ff 100644 --- a/extensions/twitch/src/config.test.ts +++ b/extensions/twitch/src/config.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover config plugin behavior. import { describe, expect, it } from "vitest"; import { getAccountConfig, diff --git a/extensions/twitch/src/config.ts b/extensions/twitch/src/config.ts index e1f6a5f8a8d..d160123d73d 100644 --- a/extensions/twitch/src/config.ts +++ b/extensions/twitch/src/config.ts @@ -1,3 +1,4 @@ +// Twitch helper module supports config behavior. import { listCombinedAccountIds, normalizeAccountId, diff --git a/extensions/twitch/src/plugin.lifecycle.test.ts b/extensions/twitch/src/plugin.lifecycle.test.ts index b8e51f35e1e..373c55a03d6 100644 --- a/extensions/twitch/src/plugin.lifecycle.test.ts +++ b/extensions/twitch/src/plugin.lifecycle.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover plugin.lifecycle plugin behavior. import { createStartAccountContext, expectStopPendingUntilAbort, diff --git a/extensions/twitch/src/plugin.test.ts b/extensions/twitch/src/plugin.test.ts index a44b4c58aae..c26d5f68f23 100644 --- a/extensions/twitch/src/plugin.test.ts +++ b/extensions/twitch/src/plugin.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover plugin plugin behavior. import { describe, expect, it } from "vitest"; import type { OpenClawConfig } from "../api.js"; import { twitchPlugin } from "./plugin.js"; diff --git a/extensions/twitch/src/probe.test.ts b/extensions/twitch/src/probe.test.ts index 8b925786a32..5e58f3771fa 100644 --- a/extensions/twitch/src/probe.test.ts +++ b/extensions/twitch/src/probe.test.ts @@ -1,3 +1,4 @@ +// Twitch tests cover probe plugin behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { probeTwitch } from "./probe.js"; import type { TwitchAccountConfig } from "./types.js"; diff --git a/extensions/twitch/src/probe.ts b/extensions/twitch/src/probe.ts index 4a78c95ffb5..0df924a1eee 100644 --- a/extensions/twitch/src/probe.ts +++ b/extensions/twitch/src/probe.ts @@ -1,3 +1,4 @@ +// Twitch plugin module implements probe behavior. import { StaticAuthProvider } from "@twurple/auth"; import { ChatClient } from "@twurple/chat"; import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract"; diff --git a/extensions/twitch/src/runtime.ts b/extensions/twitch/src/runtime.ts index fa7573081dc..525447daeaa 100644 --- a/extensions/twitch/src/runtime.ts +++ b/extensions/twitch/src/runtime.ts @@ -1,3 +1,4 @@ +// Twitch plugin module implements runtime behavior. import type { PluginRuntime } from "openclaw/plugin-sdk/core"; import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store"; diff --git a/extensions/twitch/src/test-fixtures.ts b/extensions/twitch/src/test-fixtures.ts index b470b957d75..3367af47438 100644 --- a/extensions/twitch/src/test-fixtures.ts +++ b/extensions/twitch/src/test-fixtures.ts @@ -1,3 +1,4 @@ +// Twitch plugin module implements test fixtures behavior. import { afterEach, beforeEach, vi } from "vitest"; import type { OpenClawConfig } from "../runtime-api.js"; diff --git a/extensions/twitch/src/twitch-client.ts b/extensions/twitch/src/twitch-client.ts index cfa1ac285a6..348474b32c1 100644 --- a/extensions/twitch/src/twitch-client.ts +++ b/extensions/twitch/src/twitch-client.ts @@ -1,3 +1,4 @@ +// Twitch plugin module implements twitch client behavior. import { RefreshingAuthProvider, StaticAuthProvider } from "@twurple/auth"; import { ChatClient, LogLevel } from "@twurple/chat"; import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; diff --git a/extensions/twitch/src/utils/twitch.ts b/extensions/twitch/src/utils/twitch.ts index 9307cbb4330..ae208b47792 100644 --- a/extensions/twitch/src/utils/twitch.ts +++ b/extensions/twitch/src/utils/twitch.ts @@ -1,3 +1,4 @@ +// Twitch plugin module implements twitch behavior. import { randomUUID } from "node:crypto"; import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime"; diff --git a/extensions/venice/api.ts b/extensions/venice/api.ts index 3490e767a25..2633206e725 100644 --- a/extensions/venice/api.ts +++ b/extensions/venice/api.ts @@ -1,3 +1,4 @@ +// Venice API module exposes the plugin public contract. export { buildVeniceModelDefinition, discoverVeniceModels, diff --git a/extensions/venice/index.test.ts b/extensions/venice/index.test.ts index 981f8e533d1..5840db64251 100644 --- a/extensions/venice/index.test.ts +++ b/extensions/venice/index.test.ts @@ -1,3 +1,4 @@ +// Venice tests cover index plugin behavior. import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describe, expect, it } from "vitest"; import plugin from "./index.js"; diff --git a/extensions/venice/index.ts b/extensions/venice/index.ts index 0d89fc0b035..2c958c7bed9 100644 --- a/extensions/venice/index.ts +++ b/extensions/venice/index.ts @@ -1,3 +1,4 @@ +// Venice plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyModelCompatPatch, diff --git a/extensions/venice/models.test.ts b/extensions/venice/models.test.ts index ca3b442e998..c3f063919b9 100644 --- a/extensions/venice/models.test.ts +++ b/extensions/venice/models.test.ts @@ -1,3 +1,4 @@ +// Venice tests cover models plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; import { buildVeniceModelDefinition, diff --git a/extensions/venice/models.ts b/extensions/venice/models.ts index 66fc5841ff2..253390e5792 100644 --- a/extensions/venice/models.ts +++ b/extensions/venice/models.ts @@ -1,3 +1,4 @@ +// Venice plugin module implements models behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { createSubsystemLogger, retryAsync } from "openclaw/plugin-sdk/runtime-env"; diff --git a/extensions/venice/onboard.ts b/extensions/venice/onboard.ts index 11d5b42e094..98058035689 100644 --- a/extensions/venice/onboard.ts +++ b/extensions/venice/onboard.ts @@ -1,3 +1,4 @@ +// Venice setup module handles plugin onboarding behavior. import { createModelCatalogPresetAppliers, type OpenClawConfig, diff --git a/extensions/venice/provider-catalog.ts b/extensions/venice/provider-catalog.ts index 37a7eb7f047..82610c92084 100644 --- a/extensions/venice/provider-catalog.ts +++ b/extensions/venice/provider-catalog.ts @@ -1,3 +1,4 @@ +// Venice provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { discoverVeniceModels, VENICE_BASE_URL } from "./models.js"; diff --git a/extensions/venice/provider-runtime.contract.test.ts b/extensions/venice/provider-runtime.contract.test.ts index 4937d4fc46f..0a6137a355b 100644 --- a/extensions/venice/provider-runtime.contract.test.ts +++ b/extensions/venice/provider-runtime.contract.test.ts @@ -1,3 +1,4 @@ +// Venice tests cover provider runtime.contract plugin behavior. import { describeVeniceProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeVeniceProviderRuntimeContract(() => import("./index.js")); diff --git a/extensions/venice/stream.ts b/extensions/venice/stream.ts index 6ac0d554bd1..d6d3474c506 100644 --- a/extensions/venice/stream.ts +++ b/extensions/venice/stream.ts @@ -1,3 +1,4 @@ +// Venice plugin module implements stream behavior. import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { createPayloadPatchStreamWrapper } from "openclaw/plugin-sdk/provider-stream-shared"; diff --git a/extensions/vercel-ai-gateway/api.ts b/extensions/vercel-ai-gateway/api.ts index c7f2727d669..457a1897745 100644 --- a/extensions/vercel-ai-gateway/api.ts +++ b/extensions/vercel-ai-gateway/api.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway API module exposes the plugin public contract. export { discoverVercelAiGatewayModels, getStaticVercelAiGatewayModelCatalog, diff --git a/extensions/vercel-ai-gateway/index.ts b/extensions/vercel-ai-gateway/index.ts index 7a0d8db13bc..c14ffc33a76 100644 --- a/extensions/vercel-ai-gateway/index.ts +++ b/extensions/vercel-ai-gateway/index.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway plugin entrypoint registers its OpenClaw integration. import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry"; import { applyVercelAiGatewayConfig, VERCEL_AI_GATEWAY_DEFAULT_MODEL_REF } from "./onboard.js"; import { diff --git a/extensions/vercel-ai-gateway/models.ts b/extensions/vercel-ai-gateway/models.ts index 5e4a751368c..8be434828a4 100644 --- a/extensions/vercel-ai-gateway/models.ts +++ b/extensions/vercel-ai-gateway/models.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway plugin module implements models behavior. import { parseStrictFiniteNumber } from "openclaw/plugin-sdk/number-runtime"; import { readProviderJsonArrayFieldResponse } from "openclaw/plugin-sdk/provider-http"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/vercel-ai-gateway/onboard.ts b/extensions/vercel-ai-gateway/onboard.ts index 15d7f04a45a..609bb9c5629 100644 --- a/extensions/vercel-ai-gateway/onboard.ts +++ b/extensions/vercel-ai-gateway/onboard.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway setup module handles plugin onboarding behavior. import { applyAgentDefaultModelPrimary, type OpenClawConfig, diff --git a/extensions/vercel-ai-gateway/provider-catalog.test.ts b/extensions/vercel-ai-gateway/provider-catalog.test.ts index dcaba99b70b..4b69ff69c95 100644 --- a/extensions/vercel-ai-gateway/provider-catalog.test.ts +++ b/extensions/vercel-ai-gateway/provider-catalog.test.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway tests cover provider catalog plugin behavior. import { afterEach, describe, expect, it, vi } from "vitest"; const { fetchWithSsrFGuardMock } = vi.hoisted(() => ({ diff --git a/extensions/vercel-ai-gateway/provider-catalog.ts b/extensions/vercel-ai-gateway/provider-catalog.ts index 9327cc4668b..45a22a68077 100644 --- a/extensions/vercel-ai-gateway/provider-catalog.ts +++ b/extensions/vercel-ai-gateway/provider-catalog.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway provider module implements model/runtime integration. import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { discoverVercelAiGatewayModels, diff --git a/extensions/vercel-ai-gateway/thinking.test.ts b/extensions/vercel-ai-gateway/thinking.test.ts index cd6b7b33a0e..0113e872fa3 100644 --- a/extensions/vercel-ai-gateway/thinking.test.ts +++ b/extensions/vercel-ai-gateway/thinking.test.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway tests cover thinking plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/vercel-ai-gateway/thinking.ts b/extensions/vercel-ai-gateway/thinking.ts index 817e9308b69..76d6df41cad 100644 --- a/extensions/vercel-ai-gateway/thinking.ts +++ b/extensions/vercel-ai-gateway/thinking.ts @@ -1,3 +1,4 @@ +// Vercel Ai Gateway plugin module implements thinking behavior. import type { ProviderThinkingProfile } from "openclaw/plugin-sdk/core"; import { matchesExactOrPrefix, diff --git a/extensions/video-generation-core/api.ts b/extensions/video-generation-core/api.ts index c86f72b545a..44fe9b1b5f4 100644 --- a/extensions/video-generation-core/api.ts +++ b/extensions/video-generation-core/api.ts @@ -1,3 +1,4 @@ +// Video Generation Core API module exposes the plugin public contract. export type { AuthProfileStore } from "openclaw/plugin-sdk/video-generation-core"; export { buildNoCapabilityModelConfiguredMessage, diff --git a/extensions/video-generation-core/runtime-api.ts b/extensions/video-generation-core/runtime-api.ts index d3e66a4d5ce..87c1dc1fa54 100644 --- a/extensions/video-generation-core/runtime-api.ts +++ b/extensions/video-generation-core/runtime-api.ts @@ -1,3 +1,4 @@ +// Video Generation Core API module exposes the plugin public contract. export { generateVideo, listRuntimeVideoGenerationProviders, diff --git a/extensions/video-generation-core/src/runtime.test.ts b/extensions/video-generation-core/src/runtime.test.ts index 262283c8293..e22fa2af2c1 100644 --- a/extensions/video-generation-core/src/runtime.test.ts +++ b/extensions/video-generation-core/src/runtime.test.ts @@ -1,3 +1,4 @@ +// Video Generation Core tests cover runtime plugin behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { generateVideo, listRuntimeVideoGenerationProviders } from "./runtime.js"; diff --git a/extensions/video-generation-core/src/runtime.ts b/extensions/video-generation-core/src/runtime.ts index 40ff328f448..23fe24ea376 100644 --- a/extensions/video-generation-core/src/runtime.ts +++ b/extensions/video-generation-core/src/runtime.ts @@ -1,3 +1,4 @@ +// Video Generation Core plugin module implements runtime behavior. export { generateVideo, listRuntimeVideoGenerationProviders, diff --git a/extensions/video-generation-providers.live.test.ts b/extensions/video-generation-providers.live.test.ts index 915cf17c2b0..114bde3838c 100644 --- a/extensions/video-generation-providers.live.test.ts +++ b/extensions/video-generation-providers.live.test.ts @@ -1,3 +1,4 @@ +// Video Generation Providers.Live.Test.Ts tests cover video generation providers plugin behavior. import { resolveApiKeyForProvider, resolveDefaultAgentDir, diff --git a/extensions/vllm/api.ts b/extensions/vllm/api.ts index c8053f4e637..c1c0737ea0e 100644 --- a/extensions/vllm/api.ts +++ b/extensions/vllm/api.ts @@ -1,3 +1,4 @@ +// Vllm API module exposes the plugin public contract. export { VLLM_DEFAULT_API_KEY_ENV_VAR, VLLM_DEFAULT_BASE_URL, diff --git a/extensions/vllm/defaults.ts b/extensions/vllm/defaults.ts index 3f2498221f0..42ef27dbd75 100644 --- a/extensions/vllm/defaults.ts +++ b/extensions/vllm/defaults.ts @@ -1,3 +1,4 @@ +// Vllm plugin module implements defaults behavior. export const VLLM_DEFAULT_BASE_URL = "http://127.0.0.1:8000/v1"; export const VLLM_PROVIDER_LABEL = "vLLM"; export const VLLM_DEFAULT_API_KEY_ENV_VAR = "VLLM_API_KEY"; diff --git a/extensions/vllm/index.ts b/extensions/vllm/index.ts index f2116d2b1d4..85e82d38d2e 100644 --- a/extensions/vllm/index.ts +++ b/extensions/vllm/index.ts @@ -1,3 +1,4 @@ +// Vllm plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type OpenClawPluginApi, diff --git a/extensions/vllm/models.ts b/extensions/vllm/models.ts index 3621b369d3d..fb7b7aa10ed 100644 --- a/extensions/vllm/models.ts +++ b/extensions/vllm/models.ts @@ -1,3 +1,4 @@ +// Vllm plugin module implements models behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { discoverOpenAICompatibleLocalModels } from "openclaw/plugin-sdk/provider-setup"; import { VLLM_DEFAULT_BASE_URL, VLLM_PROVIDER_LABEL } from "./defaults.js"; diff --git a/extensions/vllm/provider-discovery.contract.test.ts b/extensions/vllm/provider-discovery.contract.test.ts index 46194aa3ca1..495bf4d1844 100644 --- a/extensions/vllm/provider-discovery.contract.test.ts +++ b/extensions/vllm/provider-discovery.contract.test.ts @@ -1,3 +1,4 @@ +// Vllm tests cover provider discovery.contract plugin behavior. import { fileURLToPath } from "node:url"; import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; import { describeVllmProviderDiscoveryContract } from "openclaw/plugin-sdk/provider-test-contracts"; diff --git a/extensions/vllm/provider-policy-api.test.ts b/extensions/vllm/provider-policy-api.test.ts index d9ff393b7bb..986f6a7bc1a 100644 --- a/extensions/vllm/provider-policy-api.test.ts +++ b/extensions/vllm/provider-policy-api.test.ts @@ -1,3 +1,4 @@ +// Vllm tests cover provider policy api plugin behavior. import { describe, expect, it } from "vitest"; import { resolveThinkingProfile } from "./provider-policy-api.js"; diff --git a/extensions/vllm/provider-policy-api.ts b/extensions/vllm/provider-policy-api.ts index edc2c861187..36ebe7ead99 100644 --- a/extensions/vllm/provider-policy-api.ts +++ b/extensions/vllm/provider-policy-api.ts @@ -1 +1,2 @@ +// Vllm API module exposes the plugin public contract. export { resolveThinkingProfile } from "./thinking-policy.js"; diff --git a/extensions/vllm/register.runtime.ts b/extensions/vllm/register.runtime.ts index b491169fb47..a8c26a7046d 100644 --- a/extensions/vllm/register.runtime.ts +++ b/extensions/vllm/register.runtime.ts @@ -1,3 +1,4 @@ +// Vllm plugin module implements register behavior. export { buildVllmProvider, VLLM_DEFAULT_API_KEY_ENV_VAR, diff --git a/extensions/vllm/stream.test.ts b/extensions/vllm/stream.test.ts index e8a578bd607..5bf1b46c373 100644 --- a/extensions/vllm/stream.test.ts +++ b/extensions/vllm/stream.test.ts @@ -1,3 +1,4 @@ +// Vllm tests cover stream plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { describe, expect, it } from "vitest"; diff --git a/extensions/vllm/stream.ts b/extensions/vllm/stream.ts index 5215ba28419..32da35bda72 100644 --- a/extensions/vllm/stream.ts +++ b/extensions/vllm/stream.ts @@ -1,3 +1,4 @@ +// Vllm plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared"; diff --git a/extensions/vllm/thinking-policy.ts b/extensions/vllm/thinking-policy.ts index 2f397bce1be..a92e28e5e01 100644 --- a/extensions/vllm/thinking-policy.ts +++ b/extensions/vllm/thinking-policy.ts @@ -1,3 +1,4 @@ +// Vllm plugin module implements thinking policy behavior. import type { ProviderDefaultThinkingPolicyContext, ProviderThinkingProfile, diff --git a/extensions/volcengine/api.ts b/extensions/volcengine/api.ts index 674c4f18abf..ede48c6d801 100644 --- a/extensions/volcengine/api.ts +++ b/extensions/volcengine/api.ts @@ -1,3 +1,4 @@ +// Volcengine API module exposes the plugin public contract. import type { ModelCompatConfig } from "openclaw/plugin-sdk/provider-model-shared"; import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime"; diff --git a/extensions/volcengine/index.test.ts b/extensions/volcengine/index.test.ts index a7420cf1a47..f60f43c24b3 100644 --- a/extensions/volcengine/index.test.ts +++ b/extensions/volcengine/index.test.ts @@ -1,3 +1,4 @@ +// Volcengine tests cover index plugin behavior. import { readFileSync } from "node:fs"; import { resolve } from "node:path"; import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime"; diff --git a/extensions/volcengine/index.ts b/extensions/volcengine/index.ts index baa213bf434..dc37ef63ab4 100644 --- a/extensions/volcengine/index.ts +++ b/extensions/volcengine/index.ts @@ -1,3 +1,4 @@ +// Volcengine plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { ensureModelAllowlistEntry } from "openclaw/plugin-sdk/provider-onboard"; diff --git a/extensions/volcengine/models.ts b/extensions/volcengine/models.ts index 975e4b2dca9..b79f8b8c293 100644 --- a/extensions/volcengine/models.ts +++ b/extensions/volcengine/models.ts @@ -1,3 +1,4 @@ +// Volcengine plugin module implements models behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/volcengine/provider-catalog.ts b/extensions/volcengine/provider-catalog.ts index e719bc2e18a..ae11289c427 100644 --- a/extensions/volcengine/provider-catalog.ts +++ b/extensions/volcengine/provider-catalog.ts @@ -1,3 +1,4 @@ +// Volcengine provider module implements model/runtime integration. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/volcengine/provider-discovery.ts b/extensions/volcengine/provider-discovery.ts index 69d2bce04ce..70d25dc4731 100644 --- a/extensions/volcengine/provider-discovery.ts +++ b/extensions/volcengine/provider-discovery.ts @@ -1,3 +1,4 @@ +// Volcengine provider module implements model/runtime integration. import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared"; import { buildDoubaoCodingProvider, buildDoubaoProvider } from "./provider-catalog.js"; diff --git a/extensions/volcengine/speech-provider.ts b/extensions/volcengine/speech-provider.ts index 84d0d77045a..f519b42e0a5 100644 --- a/extensions/volcengine/speech-provider.ts +++ b/extensions/volcengine/speech-provider.ts @@ -1,3 +1,4 @@ +// Volcengine provider module implements model/runtime integration. import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input"; import type { SpeechDirectiveTokenParseContext, diff --git a/extensions/volcengine/tts.live.test.ts b/extensions/volcengine/tts.live.test.ts index 5495c475e5e..ab4daad34ee 100644 --- a/extensions/volcengine/tts.live.test.ts +++ b/extensions/volcengine/tts.live.test.ts @@ -1,3 +1,4 @@ +// Volcengine tests cover tts plugin behavior. import { describe, expect, it } from "vitest"; import { volcengineTTS } from "./tts.js"; diff --git a/extensions/volcengine/tts.test.ts b/extensions/volcengine/tts.test.ts index fa97f0e25d4..b8906fe79ed 100644 --- a/extensions/volcengine/tts.test.ts +++ b/extensions/volcengine/tts.test.ts @@ -1,3 +1,4 @@ +// Volcengine tests cover tts plugin behavior. import { beforeEach, describe, expect, it, vi } from "vitest"; import { buildVolcengineSpeechProvider } from "./speech-provider.js"; import { volcengineTTS } from "./tts.js"; diff --git a/extensions/volcengine/tts.ts b/extensions/volcengine/tts.ts index 1ef82799fb0..ac7e409d716 100644 --- a/extensions/volcengine/tts.ts +++ b/extensions/volcengine/tts.ts @@ -1,3 +1,4 @@ +// Volcengine plugin module implements tts behavior. import * as crypto from "node:crypto"; import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime"; diff --git a/extensions/voyage/embedding-batch.ts b/extensions/voyage/embedding-batch.ts index 6e532251ae1..d65d8b2d6a0 100644 --- a/extensions/voyage/embedding-batch.ts +++ b/extensions/voyage/embedding-batch.ts @@ -1,3 +1,4 @@ +// Voyage plugin module implements embedding batch behavior. import { createInterface } from "node:readline"; import { Readable } from "node:stream"; import { diff --git a/extensions/voyage/embedding-provider.ts b/extensions/voyage/embedding-provider.ts index 519c6ce75d0..fe5b0598c88 100644 --- a/extensions/voyage/embedding-provider.ts +++ b/extensions/voyage/embedding-provider.ts @@ -1,3 +1,4 @@ +// Voyage provider module implements model/runtime integration. import { fetchRemoteEmbeddingVectors, normalizeEmbeddingModelWithPrefixes, diff --git a/extensions/voyage/index.ts b/extensions/voyage/index.ts index d3020f110bc..8fadd002c3b 100644 --- a/extensions/voyage/index.ts +++ b/extensions/voyage/index.ts @@ -1,3 +1,4 @@ +// Voyage plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { voyageMemoryEmbeddingProviderAdapter } from "./memory-embedding-adapter.js"; diff --git a/extensions/voyage/memory-embedding-adapter.ts b/extensions/voyage/memory-embedding-adapter.ts index 5d0e0a9841d..8ddeecc0550 100644 --- a/extensions/voyage/memory-embedding-adapter.ts +++ b/extensions/voyage/memory-embedding-adapter.ts @@ -1,3 +1,4 @@ +// Voyage plugin module implements memory embedding adapter behavior. import { isMissingEmbeddingApiKeyError, mapBatchEmbeddingsByIndex, diff --git a/extensions/vydra/image-generation-provider.test.ts b/extensions/vydra/image-generation-provider.test.ts index 9099b6c3db4..e98a21cdf99 100644 --- a/extensions/vydra/image-generation-provider.test.ts +++ b/extensions/vydra/image-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Vydra tests cover image generation provider plugin behavior. import { installPinnedHostnameTestHooks } from "openclaw/plugin-sdk/test-env"; import { afterEach, describe, expect, it, vi } from "vitest"; import { buildVydraImageGenerationProvider } from "./image-generation-provider.js"; diff --git a/extensions/vydra/image-generation-provider.ts b/extensions/vydra/image-generation-provider.ts index 066448e057c..e56e74002ba 100644 --- a/extensions/vydra/image-generation-provider.ts +++ b/extensions/vydra/image-generation-provider.ts @@ -1,3 +1,4 @@ +// Vydra provider module implements model/runtime integration. import type { ImageGenerationProvider } from "openclaw/plugin-sdk/image-generation"; import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { assertOkOrThrowHttpError, postJsonRequest } from "openclaw/plugin-sdk/provider-http"; diff --git a/extensions/vydra/index.ts b/extensions/vydra/index.ts index 2798fe24612..8944dca30d4 100644 --- a/extensions/vydra/index.ts +++ b/extensions/vydra/index.ts @@ -1,3 +1,4 @@ +// Vydra plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key"; import { buildVydraImageGenerationProvider } from "./image-generation-provider.js"; diff --git a/extensions/vydra/onboard.ts b/extensions/vydra/onboard.ts index ca24a42679e..e8800dc934f 100644 --- a/extensions/vydra/onboard.ts +++ b/extensions/vydra/onboard.ts @@ -1,3 +1,4 @@ +// Vydra setup module handles plugin onboarding behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-onboard"; export const VYDRA_DEFAULT_IMAGE_MODEL_REF = "vydra/grok-imagine"; diff --git a/extensions/vydra/provider-test-helpers.test.ts b/extensions/vydra/provider-test-helpers.test.ts index bdf73a8b2c2..76bdf1d4744 100644 --- a/extensions/vydra/provider-test-helpers.test.ts +++ b/extensions/vydra/provider-test-helpers.test.ts @@ -1,3 +1,4 @@ +// Vydra tests cover provider test helpers plugin behavior. import * as providerAuth from "openclaw/plugin-sdk/provider-auth-runtime"; import { vi } from "vitest"; diff --git a/extensions/vydra/shared.ts b/extensions/vydra/shared.ts index 04681915fb5..6532c9c073a 100644 --- a/extensions/vydra/shared.ts +++ b/extensions/vydra/shared.ts @@ -1,3 +1,4 @@ +// Vydra plugin module implements shared behavior. import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts"; import { extensionForMime } from "openclaw/plugin-sdk/media-mime"; import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime"; diff --git a/extensions/vydra/speech-provider.test.ts b/extensions/vydra/speech-provider.test.ts index 23d208f4616..f669afc0389 100644 --- a/extensions/vydra/speech-provider.test.ts +++ b/extensions/vydra/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Vydra tests cover speech provider plugin behavior. import { installPinnedHostnameTestHooks } from "openclaw/plugin-sdk/test-env"; import { afterEach, describe, expect, it, vi } from "vitest"; import { buildVydraSpeechProvider } from "./speech-provider.js"; diff --git a/extensions/vydra/speech-provider.ts b/extensions/vydra/speech-provider.ts index c60981f9f36..74e02e0c91a 100644 --- a/extensions/vydra/speech-provider.ts +++ b/extensions/vydra/speech-provider.ts @@ -1,3 +1,4 @@ +// Vydra provider module implements model/runtime integration. import { assertOkOrThrowHttpError, postJsonRequest, diff --git a/extensions/vydra/video-generation-provider.test.ts b/extensions/vydra/video-generation-provider.test.ts index 56926ec1a1a..c748bee5ccd 100644 --- a/extensions/vydra/video-generation-provider.test.ts +++ b/extensions/vydra/video-generation-provider.test.ts @@ -1,3 +1,4 @@ +// Vydra tests cover video generation provider plugin behavior. import { expectExplicitVideoGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts"; import { installPinnedHostnameTestHooks } from "openclaw/plugin-sdk/test-env"; import { afterEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/vydra/video-generation-provider.ts b/extensions/vydra/video-generation-provider.ts index 7503996a786..7e8e95816d5 100644 --- a/extensions/vydra/video-generation-provider.ts +++ b/extensions/vydra/video-generation-provider.ts @@ -1,3 +1,4 @@ +// Vydra provider module implements model/runtime integration. import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth"; import { assertOkOrThrowHttpError, diff --git a/extensions/vydra/vydra.live.test.ts b/extensions/vydra/vydra.live.test.ts index 944049335fd..db65f580662 100644 --- a/extensions/vydra/vydra.live.test.ts +++ b/extensions/vydra/vydra.live.test.ts @@ -1,3 +1,4 @@ +// Vydra tests cover vydra plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/web-readability/index.ts b/extensions/web-readability/index.ts index 5075210187f..cf417815635 100644 --- a/extensions/web-readability/index.ts +++ b/extensions/web-readability/index.ts @@ -1,3 +1,4 @@ +// Web Readability plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; export default definePluginEntry({ diff --git a/extensions/web-readability/web-content-extractor.test.ts b/extensions/web-readability/web-content-extractor.test.ts index 3eabc9fd860..2d58066b2be 100644 --- a/extensions/web-readability/web-content-extractor.test.ts +++ b/extensions/web-readability/web-content-extractor.test.ts @@ -1,3 +1,4 @@ +// Web Readability tests cover web content extractor plugin behavior. import { describe, expect, it } from "vitest"; import { createReadabilityWebContentExtractor } from "./web-content-extractor.js"; diff --git a/extensions/web-readability/web-content-extractor.ts b/extensions/web-readability/web-content-extractor.ts index c4ad62a7fcb..5a8679077d2 100644 --- a/extensions/web-readability/web-content-extractor.ts +++ b/extensions/web-readability/web-content-extractor.ts @@ -1,3 +1,4 @@ +// Web Readability plugin module implements web content extractor behavior. import type { WebContentExtractionRequest, WebContentExtractionResult, diff --git a/extensions/webhooks/api.ts b/extensions/webhooks/api.ts index 89c896a40cb..b4b025ef23f 100644 --- a/extensions/webhooks/api.ts +++ b/extensions/webhooks/api.ts @@ -1,3 +1,4 @@ +// Webhooks API module exposes the plugin public contract. export { definePluginEntry, type OpenClawPluginApi, diff --git a/extensions/webhooks/index.test.ts b/extensions/webhooks/index.test.ts index 732fbca042a..63b4f4c1548 100644 --- a/extensions/webhooks/index.test.ts +++ b/extensions/webhooks/index.test.ts @@ -1,3 +1,4 @@ +// Webhooks tests cover index plugin behavior. import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api"; import { describe, expect, it, vi } from "vitest"; import type { OpenClawPluginApi } from "./api.js"; diff --git a/extensions/webhooks/index.ts b/extensions/webhooks/index.ts index a3cc509d562..687cb5b4ec2 100644 --- a/extensions/webhooks/index.ts +++ b/extensions/webhooks/index.ts @@ -1,3 +1,4 @@ +// Webhooks plugin entrypoint registers its OpenClaw integration. import { definePluginEntry, type OpenClawPluginApi } from "./api.js"; import { resolveWebhooksPluginConfig } from "./src/config.js"; import { createTaskFlowWebhookRequestHandler, type TaskFlowWebhookTarget } from "./src/http.js"; diff --git a/extensions/webhooks/runtime-api.ts b/extensions/webhooks/runtime-api.ts index f6d2fa93858..e77e1c233c6 100644 --- a/extensions/webhooks/runtime-api.ts +++ b/extensions/webhooks/runtime-api.ts @@ -1,3 +1,4 @@ +// Webhooks API module exposes the plugin public contract. export { createFixedWindowRateLimiter, createWebhookInFlightLimiter, diff --git a/extensions/webhooks/src/config.test.ts b/extensions/webhooks/src/config.test.ts index 229eb5fcbe2..ec9eb57d918 100644 --- a/extensions/webhooks/src/config.test.ts +++ b/extensions/webhooks/src/config.test.ts @@ -1,3 +1,4 @@ +// Webhooks tests cover config plugin behavior. import { describe, expect, it } from "vitest"; import { resolveWebhooksPluginConfig } from "./config.js"; diff --git a/extensions/webhooks/src/config.ts b/extensions/webhooks/src/config.ts index 0d138853999..5e6e100f2b5 100644 --- a/extensions/webhooks/src/config.ts +++ b/extensions/webhooks/src/config.ts @@ -1,3 +1,4 @@ +// Webhooks helper module supports config behavior. import { z } from "zod"; import { normalizeWebhookPath } from "../runtime-api.js"; diff --git a/extensions/webhooks/src/http.test.ts b/extensions/webhooks/src/http.test.ts index 165de88eb27..da79f371166 100644 --- a/extensions/webhooks/src/http.test.ts +++ b/extensions/webhooks/src/http.test.ts @@ -1,3 +1,4 @@ +// Webhooks tests cover http plugin behavior. import { EventEmitter } from "node:events"; import type { IncomingMessage } from "node:http"; import { createRuntimeTaskFlow } from "openclaw/plugin-sdk/plugin-test-runtime"; diff --git a/extensions/webhooks/src/http.ts b/extensions/webhooks/src/http.ts index ae304ee2e2b..e63a0655f98 100644 --- a/extensions/webhooks/src/http.ts +++ b/extensions/webhooks/src/http.ts @@ -1,3 +1,4 @@ +// Webhooks plugin module implements http behavior. import type { IncomingMessage, ServerResponse } from "node:http"; import { safeEqualSecret } from "openclaw/plugin-sdk/security-runtime"; import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime"; diff --git a/extensions/workboard/api.ts b/extensions/workboard/api.ts index 786d7fa0d0c..96fe278f943 100644 --- a/extensions/workboard/api.ts +++ b/extensions/workboard/api.ts @@ -1 +1,2 @@ +// Workboard API module exposes the plugin public contract. export { definePluginEntry, type OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/workboard/doctor-contract-api.test.ts b/extensions/workboard/doctor-contract-api.test.ts index b7d7384518c..327bfbf59b6 100644 --- a/extensions/workboard/doctor-contract-api.test.ts +++ b/extensions/workboard/doctor-contract-api.test.ts @@ -1,3 +1,4 @@ +// Workboard tests cover doctor contract api plugin behavior. import fs from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/workboard/doctor-contract-api.ts b/extensions/workboard/doctor-contract-api.ts index 3754992cc71..f97f39a2231 100644 --- a/extensions/workboard/doctor-contract-api.ts +++ b/extensions/workboard/doctor-contract-api.ts @@ -1,3 +1,4 @@ +// Workboard API module exposes the plugin public contract. import type { PluginDoctorStateMigration, PluginDoctorStateMigrationContext, diff --git a/extensions/workboard/index.ts b/extensions/workboard/index.ts index 74a55b767f6..021f850f872 100644 --- a/extensions/workboard/index.ts +++ b/extensions/workboard/index.ts @@ -1,3 +1,4 @@ +// Workboard plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "./api.js"; import { registerWorkboardGatewayMethods } from "./runtime-api.js"; import { registerWorkboardCommand } from "./src/command.js"; diff --git a/extensions/workboard/runtime-api.ts b/extensions/workboard/runtime-api.ts index bb4714f7dee..43e3c85ac22 100644 --- a/extensions/workboard/runtime-api.ts +++ b/extensions/workboard/runtime-api.ts @@ -1,3 +1,4 @@ +// Workboard API module exposes the plugin public contract. export { registerWorkboardGatewayMethods } from "./src/gateway.js"; export type { WorkboardCard, diff --git a/extensions/workboard/src/card-lookup.ts b/extensions/workboard/src/card-lookup.ts index 5f87dd77952..a20409b4f45 100644 --- a/extensions/workboard/src/card-lookup.ts +++ b/extensions/workboard/src/card-lookup.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements card lookup behavior. import type { WorkboardCard } from "./types.js"; export type WorkboardCardLookupResult = diff --git a/extensions/workboard/src/cli.test.ts b/extensions/workboard/src/cli.test.ts index 829c3672797..feb3a7080cd 100644 --- a/extensions/workboard/src/cli.test.ts +++ b/extensions/workboard/src/cli.test.ts @@ -1,3 +1,4 @@ +// Workboard tests cover cli plugin behavior. import { Command } from "commander"; import { beforeEach, describe, expect, it, vi } from "vitest"; import { registerWorkboardCli } from "./cli.js"; diff --git a/extensions/workboard/src/cli.ts b/extensions/workboard/src/cli.ts index ffd9756dbad..f1f5c813dbe 100644 --- a/extensions/workboard/src/cli.ts +++ b/extensions/workboard/src/cli.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements cli behavior. import type { Command } from "commander"; import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; import { addGatewayClientOptions, callGatewayFromCli } from "openclaw/plugin-sdk/gateway-runtime"; diff --git a/extensions/workboard/src/command.test.ts b/extensions/workboard/src/command.test.ts index 32aa01abd97..308d2012a02 100644 --- a/extensions/workboard/src/command.test.ts +++ b/extensions/workboard/src/command.test.ts @@ -1,3 +1,4 @@ +// Workboard tests cover command plugin behavior. import { describe, expect, it, vi } from "vitest"; import { handleWorkboardCommand } from "./command.js"; import type { WorkboardSubagentRuntime } from "./dispatcher.js"; diff --git a/extensions/workboard/src/command.ts b/extensions/workboard/src/command.ts index 9ba54a92aa3..c2f1e90bb33 100644 --- a/extensions/workboard/src/command.ts +++ b/extensions/workboard/src/command.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements command behavior. import type { OpenClawPluginApi } from "../api.js"; import { resolveWorkboardCardByIdOrPrefix } from "./card-lookup.js"; import { dispatchAndStartWorkboardCards, type WorkboardSubagentRuntime } from "./dispatcher.js"; diff --git a/extensions/workboard/src/dispatcher.test.ts b/extensions/workboard/src/dispatcher.test.ts index 1f01532645e..c137bea15a0 100644 --- a/extensions/workboard/src/dispatcher.test.ts +++ b/extensions/workboard/src/dispatcher.test.ts @@ -1,3 +1,4 @@ +// Workboard tests cover dispatcher plugin behavior. import { describe, expect, it, vi } from "vitest"; import { dispatchAndStartWorkboardCards } from "./dispatcher.js"; import { WorkboardStore, type PersistedWorkboardCard, type WorkboardKeyedStore } from "./store.js"; diff --git a/extensions/workboard/src/dispatcher.ts b/extensions/workboard/src/dispatcher.ts index 5521907723b..998e3da2cc7 100644 --- a/extensions/workboard/src/dispatcher.ts +++ b/extensions/workboard/src/dispatcher.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements dispatcher behavior. import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; import type { PluginRuntime } from "openclaw/plugin-sdk/plugin-runtime"; import { WorkboardStore, type WorkboardDispatchResult } from "./store.js"; diff --git a/extensions/workboard/src/gateway.test.ts b/extensions/workboard/src/gateway.test.ts index f075efb6204..980d079eb96 100644 --- a/extensions/workboard/src/gateway.test.ts +++ b/extensions/workboard/src/gateway.test.ts @@ -1,3 +1,4 @@ +// Workboard tests cover gateway plugin behavior. import { describe, expect, it, vi } from "vitest"; import type { OpenClawPluginApi } from "../api.js"; import { registerWorkboardGatewayMethods } from "./gateway.js"; diff --git a/extensions/workboard/src/gateway.ts b/extensions/workboard/src/gateway.ts index e59945f8e24..c37e620f720 100644 --- a/extensions/workboard/src/gateway.ts +++ b/extensions/workboard/src/gateway.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements gateway behavior. import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime"; import type { OpenClawPluginApi } from "../api.js"; import { dispatchAndStartWorkboardCards } from "./dispatcher.js"; diff --git a/extensions/workboard/src/persistence-types.ts b/extensions/workboard/src/persistence-types.ts index 85147de2f25..98191e38ef5 100644 --- a/extensions/workboard/src/persistence-types.ts +++ b/extensions/workboard/src/persistence-types.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements persistence types behavior. import type { WorkboardAttachment, WorkboardBoardMetadata, diff --git a/extensions/workboard/src/sqlite-store.ts b/extensions/workboard/src/sqlite-store.ts index c4f9a891e71..cd1bca1b955 100644 --- a/extensions/workboard/src/sqlite-store.ts +++ b/extensions/workboard/src/sqlite-store.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements sqlite store behavior. import fs from "node:fs"; import path from "node:path"; import { DatabaseSync, type SQLInputValue } from "node:sqlite"; diff --git a/extensions/workboard/src/store.test.ts b/extensions/workboard/src/store.test.ts index cbcf4dbf70c..793e7bb8746 100644 --- a/extensions/workboard/src/store.test.ts +++ b/extensions/workboard/src/store.test.ts @@ -1,3 +1,4 @@ +// Workboard tests cover store plugin behavior. import fs from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/workboard/src/store.ts b/extensions/workboard/src/store.ts index 54fbae98c14..a17a3020115 100644 --- a/extensions/workboard/src/store.ts +++ b/extensions/workboard/src/store.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements store behavior. import { randomUUID } from "node:crypto"; import { isFutureDateTimestampMs, diff --git a/extensions/workboard/src/tools.test.ts b/extensions/workboard/src/tools.test.ts index ab703ced59a..9f7de46c040 100644 --- a/extensions/workboard/src/tools.test.ts +++ b/extensions/workboard/src/tools.test.ts @@ -1,3 +1,4 @@ +// Workboard tests cover tools plugin behavior. import { describe, expect, it, vi } from "vitest"; import type { OpenClawPluginApi } from "../api.js"; import { WorkboardStore, type PersistedWorkboardCard, type WorkboardKeyedStore } from "./store.js"; diff --git a/extensions/workboard/src/tools.ts b/extensions/workboard/src/tools.ts index 68d1e27b280..1a695b4604b 100644 --- a/extensions/workboard/src/tools.ts +++ b/extensions/workboard/src/tools.ts @@ -1,3 +1,4 @@ +// Workboard plugin module implements tools behavior. import { jsonResult, readStringParam } from "openclaw/plugin-sdk/core"; import type { AnyAgentTool, OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry"; import type { OpenClawPluginToolContext } from "openclaw/plugin-sdk/plugin-entry"; diff --git a/extensions/workboard/src/types.ts b/extensions/workboard/src/types.ts index 27783ab971c..bf60e839057 100644 --- a/extensions/workboard/src/types.ts +++ b/extensions/workboard/src/types.ts @@ -1,3 +1,4 @@ +// Workboard type declarations define plugin contracts. export const WORKBOARD_STATUSES = [ "triage", "backlog", diff --git a/extensions/xiaomi/api.ts b/extensions/xiaomi/api.ts index 88e4ba39954..13af84933c1 100644 --- a/extensions/xiaomi/api.ts +++ b/extensions/xiaomi/api.ts @@ -1,3 +1,4 @@ +// Xiaomi API module exposes the plugin public contract. export { XIAOMI_DEFAULT_MODEL_ID, buildXiaomiProvider } from "./provider-catalog.js"; export { applyXiaomiConfig, diff --git a/extensions/xiaomi/index.test.ts b/extensions/xiaomi/index.test.ts index db3345aa2d9..afa1d502b08 100644 --- a/extensions/xiaomi/index.test.ts +++ b/extensions/xiaomi/index.test.ts @@ -1,3 +1,4 @@ +// Xiaomi tests cover index plugin behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { Context, Model } from "openclaw/plugin-sdk/llm"; import { createAssistantMessageEventStream } from "openclaw/plugin-sdk/llm"; diff --git a/extensions/xiaomi/index.ts b/extensions/xiaomi/index.ts index 34158139bd7..8212b82e4fe 100644 --- a/extensions/xiaomi/index.ts +++ b/extensions/xiaomi/index.ts @@ -1,3 +1,4 @@ +// Xiaomi plugin entrypoint registers its OpenClaw integration. import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import type { OpenClawConfig, diff --git a/extensions/xiaomi/onboard.test.ts b/extensions/xiaomi/onboard.test.ts index 8def2826180..bfbf5490dc0 100644 --- a/extensions/xiaomi/onboard.test.ts +++ b/extensions/xiaomi/onboard.test.ts @@ -1,3 +1,4 @@ +// Xiaomi tests cover onboard plugin behavior. import { expectProviderOnboardMergedLegacyConfig, expectProviderOnboardPrimaryModel, diff --git a/extensions/xiaomi/onboard.ts b/extensions/xiaomi/onboard.ts index 6dd2b3b3bf6..edbebe57f2b 100644 --- a/extensions/xiaomi/onboard.ts +++ b/extensions/xiaomi/onboard.ts @@ -1,3 +1,4 @@ +// Xiaomi setup module handles plugin onboarding behavior. import { createDefaultModelsPresetAppliers, type OpenClawConfig, diff --git a/extensions/xiaomi/provider-catalog.ts b/extensions/xiaomi/provider-catalog.ts index a4b2095148f..233cce33ce2 100644 --- a/extensions/xiaomi/provider-catalog.ts +++ b/extensions/xiaomi/provider-catalog.ts @@ -1,3 +1,4 @@ +// Xiaomi provider module implements model/runtime integration. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/xiaomi/speech-provider.test.ts b/extensions/xiaomi/speech-provider.test.ts index 6f7a45d43c3..992c5e4c4bc 100644 --- a/extensions/xiaomi/speech-provider.test.ts +++ b/extensions/xiaomi/speech-provider.test.ts @@ -1,3 +1,4 @@ +// Xiaomi tests cover speech provider plugin behavior. import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; diff --git a/extensions/xiaomi/speech-provider.ts b/extensions/xiaomi/speech-provider.ts index f9bf7833bb3..6ba61dbb8bf 100644 --- a/extensions/xiaomi/speech-provider.ts +++ b/extensions/xiaomi/speech-provider.ts @@ -1,3 +1,4 @@ +// Xiaomi provider module implements model/runtime integration. import { transcodeAudioBufferToOpus } from "openclaw/plugin-sdk/media-runtime"; import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime"; import { assertOkOrThrowProviderError } from "openclaw/plugin-sdk/provider-http"; diff --git a/extensions/xiaomi/stream.ts b/extensions/xiaomi/stream.ts index 3c2349b56d8..a993b2222a9 100644 --- a/extensions/xiaomi/stream.ts +++ b/extensions/xiaomi/stream.ts @@ -1,3 +1,4 @@ +// Xiaomi plugin module implements stream behavior. import type { StreamFn } from "openclaw/plugin-sdk/agent-core"; import type { ProviderWrapStreamFnContext } from "openclaw/plugin-sdk/plugin-entry"; import { diff --git a/extensions/xiaomi/thinking.ts b/extensions/xiaomi/thinking.ts index 436109cbf82..34f34f7b26c 100644 --- a/extensions/xiaomi/thinking.ts +++ b/extensions/xiaomi/thinking.ts @@ -1,3 +1,4 @@ +// Xiaomi plugin module implements thinking behavior. import type { ProviderThinkingProfile } from "openclaw/plugin-sdk/plugin-entry"; import { XIAOMI_PROVIDER_ID, XIAOMI_TOKEN_PLAN_PROVIDER_ID } from "./provider-catalog.js"; diff --git a/extensions/xiaomi/xiaomi.live.test.ts b/extensions/xiaomi/xiaomi.live.test.ts index aac129a360a..9966f24e0df 100644 --- a/extensions/xiaomi/xiaomi.live.test.ts +++ b/extensions/xiaomi/xiaomi.live.test.ts @@ -1,3 +1,4 @@ +// Xiaomi tests cover xiaomi plugin behavior. import { registerProviderPlugin, requireRegisteredProvider, diff --git a/extensions/zai/api.ts b/extensions/zai/api.ts index 17acef6d2b6..2717c54f205 100644 --- a/extensions/zai/api.ts +++ b/extensions/zai/api.ts @@ -1,3 +1,4 @@ +// Zai API module exposes the plugin public contract. export { applyZaiConfig, applyZaiProviderConfig, ZAI_DEFAULT_MODEL_REF } from "./onboard.js"; export { detectZaiEndpoint, type ZaiDetectedEndpoint, type ZaiEndpointId } from "./detect.js"; export { diff --git a/extensions/zai/detect.test.ts b/extensions/zai/detect.test.ts index 3bfac35f551..119b7d462e2 100644 --- a/extensions/zai/detect.test.ts +++ b/extensions/zai/detect.test.ts @@ -1,3 +1,4 @@ +// Zai tests cover detect plugin behavior. import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime"; import { afterEach, describe, expect, it, vi } from "vitest"; import { detectZaiEndpoint } from "./detect.js"; diff --git a/extensions/zai/detect.ts b/extensions/zai/detect.ts index 729a5b6ab62..fb57c976944 100644 --- a/extensions/zai/detect.ts +++ b/extensions/zai/detect.ts @@ -1,3 +1,4 @@ +// Zai plugin module implements detect behavior. import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime"; import { ZAI_CN_BASE_URL, diff --git a/extensions/zai/index.test.ts b/extensions/zai/index.test.ts index d676d80f2aa..d9fbe9cdf5f 100644 --- a/extensions/zai/index.test.ts +++ b/extensions/zai/index.test.ts @@ -1,3 +1,4 @@ +// Zai tests cover index plugin behavior. import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/zai/index.ts b/extensions/zai/index.ts index 526f927c78a..b35d9cc0f7f 100644 --- a/extensions/zai/index.ts +++ b/extensions/zai/index.ts @@ -1,3 +1,4 @@ +// Zai plugin entrypoint registers its OpenClaw integration. import fs from "node:fs"; import os from "node:os"; import path from "node:path"; diff --git a/extensions/zai/media-understanding-provider.ts b/extensions/zai/media-understanding-provider.ts index 10b41f69362..da9ae7cba4b 100644 --- a/extensions/zai/media-understanding-provider.ts +++ b/extensions/zai/media-understanding-provider.ts @@ -1,3 +1,4 @@ +// Zai provider module implements model/runtime integration. import { describeImageWithModel, describeImagesWithModel, diff --git a/extensions/zai/model-definitions.test.ts b/extensions/zai/model-definitions.test.ts index 13a76280d5f..0dc8270ea45 100644 --- a/extensions/zai/model-definitions.test.ts +++ b/extensions/zai/model-definitions.test.ts @@ -1,3 +1,4 @@ +// Zai tests cover model definitions plugin behavior. import { describe, expect, it } from "vitest"; import { buildZaiModelDefinition, ZAI_DEFAULT_COST } from "./model-definitions.js"; diff --git a/extensions/zai/model-definitions.ts b/extensions/zai/model-definitions.ts index c5a4e043308..620efbede24 100644 --- a/extensions/zai/model-definitions.ts +++ b/extensions/zai/model-definitions.ts @@ -1,3 +1,4 @@ +// Zai plugin module implements model definitions behavior. import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared"; import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared"; import manifest from "./openclaw.plugin.json" with { type: "json" }; diff --git a/extensions/zai/onboard.test.ts b/extensions/zai/onboard.test.ts index 399f1a8f173..b8bf4f6daed 100644 --- a/extensions/zai/onboard.test.ts +++ b/extensions/zai/onboard.test.ts @@ -1,3 +1,4 @@ +// Zai tests cover onboard plugin behavior. import { resolveAgentModelPrimaryValue } from "openclaw/plugin-sdk/provider-onboard"; import { expectProviderOnboardPreservesPrimary } from "openclaw/plugin-sdk/provider-test-contracts"; import { beforeAll, describe, expect, it } from "vitest"; diff --git a/extensions/zai/onboard.ts b/extensions/zai/onboard.ts index f253c955f52..c2ff612ca2b 100644 --- a/extensions/zai/onboard.ts +++ b/extensions/zai/onboard.ts @@ -1,3 +1,4 @@ +// Zai setup module handles plugin onboarding behavior. import { applyProviderConfigWithModelCatalogPreset, type OpenClawConfig, diff --git a/extensions/zai/provider-runtime.contract.test.ts b/extensions/zai/provider-runtime.contract.test.ts index affb527cb35..4ba6864998d 100644 --- a/extensions/zai/provider-runtime.contract.test.ts +++ b/extensions/zai/provider-runtime.contract.test.ts @@ -1,3 +1,4 @@ +// Zai tests cover provider runtime.contract plugin behavior. import { describeZAIProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts"; describeZAIProviderRuntimeContract(() => import("./index.js")); diff --git a/extensions/zai/runtime-api.ts b/extensions/zai/runtime-api.ts index a521f66e95f..e0d11783e89 100644 --- a/extensions/zai/runtime-api.ts +++ b/extensions/zai/runtime-api.ts @@ -1 +1,2 @@ +// Zai API module exposes the plugin public contract. export { detectZaiEndpoint, type ZaiDetectedEndpoint, type ZaiEndpointId } from "./detect.js"; diff --git a/extensions/zai/test-api.ts b/extensions/zai/test-api.ts index 19ef1fbacf3..50b5cfa712f 100644 --- a/extensions/zai/test-api.ts +++ b/extensions/zai/test-api.ts @@ -1 +1,2 @@ +// Zai API module exposes the plugin public contract. export { zaiMediaUnderstandingProvider } from "./media-understanding-provider.js";