- New seams: backwards-compatible, documented, versioned. Third-party plugins exist.

- Channels: `src/channels/**` is implementation; plugin authors get SDK seams.

- Providers: core owns generic loop; provider plugins own auth/catalog/runtime hooks.

- Request-time runtime resolution: when a path already knows the provider id, model ref, channel id, outbound target, capability family, or attachment class, carry that as a prepared runtime fact instead of rediscovering it later.

- Prepared runtime facts should be small typed values produced once near startup, reply dispatch, model selection, tool planning, or channel resolution, then passed through context to consumers. Prefer `AgentRuntimePlan`, `ProviderRuntimePluginHandle`, scoped model/catalog helpers, active/runtime registries, manifest/public-artifact lookups, single-provider resolvers, and lazy registry construction.

- Avoid broad request-time rediscovery: hot reply/tool/outbound/media paths should not call broad plugin/provider/channel/capability loaders such as `loadOpenClawPlugins`, `resolveProviderPluginsForHooks`, `resolvePluginCapabilityProviders`, `resolvePluginDiscoveryProvidersRuntime`, `getChannelPlugin`, or broad model/tool/media registry builders just to answer a question the caller already knows. Do not build multimodal/provider registries for document-only or otherwise non-participating paths.

- Compatibility fallbacks are allowed only for startup/setup/admin/standalone/legacy callers that genuinely lack prepared facts. Keep them explicit, tested, and outside migrated hot reply/tool/outbound paths.

- Do not fix repeated request-time discovery by adding scattered cache layers. Move the canonical fact earlier, reuse the existing prepared-runtime object, and delete duplicate lookup branches when the last migrated caller stops needing them.

- Gateway protocol changes: additive first; incompatible needs versioning/docs/client follow-through.

- Config contract: exported types, schema/help, metadata, baselines, docs aligned. Retired public keys stay retired; compat in raw migration/doctor.

- Direction: manifest-first control plane; targeted runtime loaders; no hidden contract bypasses; broad mutable registries transitional.

- Control UI/chat: add an agent-first filter to the chat session picker, keep chat controls/composer responsive across phone/tablet/desktop widths, keep desktop chat controls on one row, avoid duplicate avatar refreshes during initial chat load, and hide that row while scrolling down the transcript. Thanks @BunsDev.

- Control UI/chat: collapse consecutive duplicate text messages into one bubble with a count so repeated text-only messages stay compact without hiding nearby context.

- Control UI/chat and Sessions: label inherited thinking defaults separately from explicit overrides while preserving provider-supplied option labels. Fixes #77581. Thanks @BunsDev and @Beandon13.

- Agents/runtime: add prepared runtime foundation contracts for carrying provider, model, tool, TTS, and outbound runtime facts through later reply-path migrations. Thanks @mcaxtr.

- Agents/subagents: preserve every grouped child result when direct completion fallback has to bypass the requester-agent announce turn. Thanks @vincentkoc.

- TTS/telephony: honor provider voice/model overrides in telephony synthesis providers so Google Meet agent speech logs match the backend that actually produced the audio. Thanks @vincentkoc.

- Voice Call/realtime: bound the paced Twilio audio queue and close overloaded realtime streams before provider audio can pile up behind the websocket backpressure guard. Thanks @vincentkoc.

259c4d22d5fe84ca6b27f9d061dddca4459e4eddd516729564f250d823dbd819 plugin-sdk-api-baseline.json

b2bf16d3c5859b06240b5f41ed5803af8e82338da3e56ace1569520ac0732a5a plugin-sdk-api-baseline.jsonl

28e280d21693216c99cfa8da553589b41741d37c0ada956e316ee01d3d6c202c plugin-sdk-api-baseline.json

633dae33da97f6a073c5561709c57d5c0b7ff67af0512d0261f05455c24b38de plugin-sdk-api-baseline.jsonl

"runtime-store": {

category: "runtime",

},

"agent-runtime": {

category: "runtime",

},

"speech-core": {

category: "provider",

},

"tts-runtime": {

category: "runtime",

},

"allow-from": {

category: "utilities",

},

import type { OpenClawConfig } from "../config/types.openclaw.js";

import { findNormalizedProviderValue, normalizeProviderId } from "./provider-id.js";

function dedupeCatalogScopeRefs(values: Array<string | undefined>): string[] {

const refs = new Set<string>();

for (const value of values) {

const trimmed = value?.trim();

if (trimmed) {

refs.add(trimmed);

}

}

return [...refs];

}

function providerFromModelRef(value: string | undefined): string | undefined {

const trimmed = value?.trim();

if (!trimmed) {

return undefined;

}

const slash = trimmed.indexOf("/");

if (slash <= 0) {

return undefined;

}

const provider = normalizeProviderId(trimmed.slice(0, slash));

return provider || undefined;

}

export function resolveModelCatalogScope(params: {

cfg?: OpenClawConfig;

provider: string;

model: string;

}): { providerRefs: string[]; modelRefs: string[] } {

const provider = params.provider.trim();

const model = params.model.trim();

const providerConfig = findNormalizedProviderValue(params.cfg?.models?.providers, provider);

return {

providerRefs: dedupeCatalogScopeRefs([provider, providerConfig?.api]),

modelRefs: dedupeCatalogScopeRefs([provider && model ? `${provider}/${model}` : model, model]),

};

}

export function resolveProviderDiscoveryProviderIdsForCatalogScope(params: {

providerRefs?: readonly string[];

modelRefs?: readonly string[];

}): string[] | undefined {

const providerIds = dedupeCatalogScopeRefs([

...(params.providerRefs ?? []),

...(params.modelRefs ?? []).map(providerFromModelRef),

]);

return providerIds.length > 0 ? providerIds : undefined;

}

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import {

prepareProviderExtraParams as prepareProviderExtraParamsRuntime,

type ProviderRuntimePluginHandle,

resolveProviderExtraParamsForTransport as resolveProviderExtraParamsForTransportRuntime,

wrapProviderStreamFn as wrapProviderStreamFnRuntime,

} from "../../plugins/provider-hook-runtime.js";

resolvedExtraParams?: Record<string, unknown>;

model?: ProviderRuntimeModel;

resolvedTransport?: SupportedTransport;

providerRuntimeHandle?: ProviderRuntimePluginHandle;

}): Record<string, unknown> {

const resolvedExtraParams =

params.resolvedExtraParams ??

provider: params.provider,

config: params.cfg,

workspaceDir: params.workspaceDir,

runtimeHandle: params.providerRuntimeHandle,

context: {

config: params.cfg,

agentDir: params.agentDir,

provider: params.provider,

config: params.cfg,

workspaceDir: params.workspaceDir,

runtimeHandle: params.providerRuntimeHandle,

context: {

config: params.cfg,

agentDir: params.agentDir,

provider: "anthropic",

modelId: "test-model",

resolveSystemPromptContribution: vi.fn(),

transformSystemPrompt: vi.fn((context) => context.systemPrompt),

},

transcript: {

policy: transcriptPolicy,

import type { AgentTool } from "@mariozechner/pi-agent-core";

import type { TSchema } from "typebox";

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import type { ProviderRuntimePluginHandle } from "../../plugins/provider-hook-runtime.js";

import type { ProviderRuntimeModel } from "../../plugins/provider-runtime-model.types.js";

import {

inspectProviderToolSchemasWithPlugin,

modelId?: string;

modelApi?: string | null;

model?: ProviderRuntimeModel;

runtimeHandle?: ProviderRuntimePluginHandle;

};

function buildProviderToolSchemaContext<TSchemaType extends TSchema = TSchema, TResult = unknown>(

config: params.config,

workspaceDir: params.workspaceDir,

env: params.env,

runtimeHandle: params.runtimeHandle,

context: buildProviderToolSchemaContext(params, provider),

});

return Array.isArray(pluginNormalized)

config: params.config,

workspaceDir: params.workspaceDir,

env: params.env,

runtimeHandle: params.runtimeHandle,

context: buildProviderToolSchemaContext(params, provider),

});

if (!Array.isArray(diagnostics)) {