chore(release): ship OpenClawKit 2026.2.5 parity

Author: MarcoDotIO

.gitignore

@@ -7,4 +7,5 @@ DerivedData/
 .swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
 .netrc
 .env
-.cursor
+.cursor
+.codex/

CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## Unreleased
+
+## 2026.2.5 - 2026-04-25
+
+### Added
+
+- OpenClaw `2026.4.25` SDK/control-plane parity pinned to `.codex/openclaw`
+  commit `6b0c72bec8`, including regenerated gateway protocol models and
+  compatibility shims for existing OpenClawKit gateway payloads.
+- Generated protocol coverage for new upstream request/result surfaces:
+  message actions, session creation/send/abort, session compaction checkpoints,
+  talk realtime/speech requests, command/tool catalog requests, skill
+  search/detail requests, and approval control-plane payloads.
+- Provider catalog parity for the `2026.4.25` train, including
+  `anthropic-vertex`, `amazon-bedrock-mantle`, `arcee`, `chutes`,
+  `copilot-proxy`, `deepseek`, `fireworks`, `lmstudio`,
+  `microsoft-foundry`, `qwen`, `stepfun`, `stepfun-plan`, and
+  `tencent-tokenhub`.
+- Capability-aware provider metadata for upstream media, speech, embedding,
+  web-search, image-generation, video-generation, and music-generation plugin
+  providers that are metadata/config-visible without native Swift runtime
+  adapters.
+- Channel metadata parity for upstream plugin channels including `feishu`,
+  `irc`, `matrix`, `mattermost`, `nextcloud-talk`, `nostr`, `qqbot`,
+  `synology-chat`, `tlon`, `twitch`, `zalo`, `zalouser`, and `qa-channel`,
+  with native transport availability explicitly marked.
+
+### Changed
+
+- `openai-codex` now defaults to upstream `gpt-5.5` for the pinned parity
+  snapshot.
+- The in-process gateway server now recognizes and decodes newly known
+  control-plane methods, returning explicit unavailable responses for
+  metadata-only or unconfigured Swift behavior instead of treating them as
+  unknown requests.
+- `.codex/` is ignored so the embedded upstream reference checkout remains a
+  local-only parity input.
+
+### Tests
+
+- Added snapshot and fixture coverage for new protocol payloads, provider
+  capabilities, channel metadata, plugin-channel secret auditing, and known
+  gateway-method unavailable/error-code mapping.
+- `swift test` remains locally blocked by the machine/toolchain error
+  `no such module 'Testing'`; `swift build -Xswiftc -warnings-as-errors`
+  passes for the package source.
+
 ## 2026.2.4 - 2026-03-14
 
 ### Added

README.md

@@ -22,8 +22,8 @@ The repository currently ships:
 
 Current baseline:
 
-- latest tagged release: `2026.2.4`
-- OpenClaw parity target: upstream `2026.3.13`
+- latest tagged release: `2026.2.5`
+- current development parity target: upstream `2026.4.25` at `.codex/openclaw` commit `6b0c72bec8`
 - direct OpenAI and Codex-backed OpenAI paths run through `OpenAIKit 3.0.0`
 - public docs site: [marcodotio.github.io/OpenClawKit](https://marcodotio.github.io/OpenClawKit/)
 
@@ -40,7 +40,7 @@ Add the package with Swift Package Manager:
 
 ```swift
 dependencies: [
-    .package(url: "https://github.com/MarcoDotIO/OpenClawKit.git", from: "2026.2.4")
+    .package(url: "https://github.com/MarcoDotIO/OpenClawKit.git", from: "2026.2.5")
 ]
 ```
 

Scripts/protocol-gen-swift.mjs

@@ -10,10 +10,9 @@ const execFileAsync = promisify(execFile);
 const here = path.dirname(fileURLToPath(import.meta.url));
 const root = path.resolve(here, "..");
 const outPath = path.join(root, "Sources", "OpenClawProtocol", "GatewayModels.swift");
-const upstreamRepoPath = path.join(root, ".cursor", "openclaw");
-const upstreamTag = "v2026.3.13";
-const upstreamTagObject = "61cd3a6e446c3d181a0a75861fd85d459c068a3d";
-const upstreamCommit = "f6e5b6758e74608f825218de264c96b224fe2e81";
+const upstreamRepoPath = path.join(root, ".codex", "openclaw");
+const upstreamLabel = "OpenClaw 2026.4.25";
+const upstreamCommit = "6b0c72bec8";
 const upstreamSourcePath = path.posix.join(
   "apps",
   "shared",
@@ -37,13 +36,13 @@ async function readUpstreamSnapshot() {
   } catch (error) {
     const detail = error instanceof Error ? error.message : String(error);
     throw new Error(
-      `Failed to read ${upstreamTag} protocol snapshot (${upstreamCommit}) from ${upstreamRepoPath}: ${detail}`,
+      `Failed to read ${upstreamLabel} protocol snapshot (${upstreamCommit}) from ${upstreamRepoPath}: ${detail}`,
     );
   }
 }
 
 const body = await readUpstreamSnapshot();
 await fs.writeFile(outPath, body);
 console.log(
-  `Synced ${outPath} from OpenClaw ${upstreamTag} (tag ${upstreamTagObject}, commit ${upstreamCommit})`,
+  `Synced ${outPath} from ${upstreamLabel} (${upstreamCommit})`,
 );

Sources/OpenClawChannels/ChannelAdapter.swift

@@ -18,6 +18,92 @@ public enum ChannelID: String, CaseIterable, Sendable {
     case msteams
     case line
     case webchat
+    case feishu
+    case irc
+    case matrix
+    case mattermost
+    case nextcloudTalk = "nextcloud-talk"
+    case nostr
+    case qqbot
+    case synologyChat = "synology-chat"
+    case tlon
+    case twitch
+    case zalo
+    case zalouser
+    case qaChannel = "qa-channel"
+}
+
+/// Channel metadata for upstream channel plugins and native Swift adapters.
+public struct ChannelMetadataEntry: Sendable, Equatable {
+    /// Stable channel identifier.
+    public var id: ChannelID
+    /// Human-facing channel label.
+    public var label: String
+    /// Optional upstream documentation path.
+    public var docsPath: String?
+    /// Additional accepted upstream identifiers.
+    public var aliases: [String]
+    /// Whether OpenClawKit currently provides a native Swift transport adapter.
+    public var nativeTransportAvailable: Bool
+
+    /// Creates a channel metadata entry.
+    public init(
+        id: ChannelID,
+        label: String,
+        docsPath: String? = nil,
+        aliases: [String] = [],
+        nativeTransportAvailable: Bool
+    ) {
+        self.id = id
+        self.label = label
+        self.docsPath = docsPath
+        self.aliases = aliases
+        self.nativeTransportAvailable = nativeTransportAvailable
+    }
+}
+
+/// Channel metadata catalog aligned with the pinned OpenClaw upstream plugin set.
+public enum OpenClawChannelMetadataCatalog {
+    /// Known channel metadata entries, including plugin-only channels without Swift transports.
+    public static let entries: [ChannelMetadataEntry] = [
+        native(.whatsapp, "WhatsApp", docsPath: "/channels/whatsapp"),
+        native(.telegram, "Telegram", docsPath: "/channels/telegram"),
+        native(.slack, "Slack", docsPath: "/channels/slack"),
+        native(.googlechat, "Google Chat", docsPath: "/channels/googlechat"),
+        native(.discord, "Discord", docsPath: "/channels/discord"),
+        native(.signal, "Signal", docsPath: "/channels/signal"),
+        native(.bluebubbles, "BlueBubbles", docsPath: "/channels/bluebubbles"),
+        native(.imessage, "iMessage", docsPath: "/channels/imessage"),
+        native(.msteams, "Microsoft Teams", docsPath: "/channels/msteams"),
+        native(.webchat, "WebChat", docsPath: "/channels/webchat"),
+        plugin(.line, "LINE", docsPath: "/channels/line"),
+        plugin(.feishu, "Feishu", docsPath: "/channels/feishu"),
+        plugin(.irc, "IRC", docsPath: "/channels/irc"),
+        plugin(.matrix, "Matrix", docsPath: "/channels/matrix"),
+        plugin(.mattermost, "Mattermost", docsPath: "/channels/mattermost"),
+        plugin(.nextcloudTalk, "Nextcloud Talk", docsPath: "/channels/nextcloud-talk"),
+        plugin(.nostr, "Nostr", docsPath: "/channels/nostr"),
+        plugin(.qqbot, "QQ Bot", docsPath: "/channels/qqbot"),
+        plugin(.synologyChat, "Synology Chat", docsPath: "/channels/synology-chat"),
+        plugin(.tlon, "Tlon", docsPath: "/channels/tlon"),
+        plugin(.twitch, "Twitch", docsPath: "/channels/twitch"),
+        plugin(.zalo, "Zalo", docsPath: "/channels/zalo"),
+        plugin(.zalouser, "Zalo User", docsPath: "/channels/zalouser"),
+        plugin(.qaChannel, "QA Channel", docsPath: "/channels/qa-channel"),
+    ]
+
+    /// Returns channel metadata for one identifier.
+    public static func entry(for id: ChannelID) -> ChannelMetadataEntry? {
+        self.entries.first { $0.id == id }
+    }
+
+    private static func native(_ id: ChannelID, _ label: String, docsPath: String? = nil) -> ChannelMetadataEntry {
+        ChannelMetadataEntry(id: id, label: label, docsPath: docsPath, nativeTransportAvailable: true)
+    }
+
+    private static func plugin(_ id: ChannelID, _ label: String, docsPath: String? = nil) -> ChannelMetadataEntry {
+        ChannelMetadataEntry(id: id, label: label, docsPath: docsPath, nativeTransportAvailable: false)
+    }
 }
 
 /// Normalized inbound message envelope delivered to the runtime.

Sources/OpenClawCore/OpenClawConfig.swift

@@ -538,6 +538,7 @@ public struct ChannelsConfig: Codable, Sendable, Equatable {
     public var imessage: IMessageChannelConfig
     public var msteams: MicrosoftTeamsChannelConfig
     public var webchat: WebChatChannelConfig
+    public var pluginChannels: [String: PluginChannelConfig]
 
     /// Creates channel config.
     /// - Parameter discord: Discord channel settings.
@@ -550,6 +551,7 @@ public struct ChannelsConfig: Codable, Sendable, Equatable {
     /// - Parameter imessage: iMessage channel settings.
     /// - Parameter msteams: Microsoft Teams channel settings.
     /// - Parameter webchat: WebChat channel settings.
+    /// - Parameter pluginChannels: Metadata/config blocks for upstream plugin-only channels.
     public init(
         discord: DiscordChannelConfig = DiscordChannelConfig(),
         telegram: TelegramChannelConfig = TelegramChannelConfig(),
@@ -560,7 +562,8 @@ public struct ChannelsConfig: Codable, Sendable, Equatable {
         bluebubbles: BlueBubblesChannelConfig = BlueBubblesChannelConfig(),
         imessage: IMessageChannelConfig = IMessageChannelConfig(),
         msteams: MicrosoftTeamsChannelConfig = MicrosoftTeamsChannelConfig(),
-        webchat: WebChatChannelConfig = WebChatChannelConfig()
+        webchat: WebChatChannelConfig = WebChatChannelConfig(),
+        pluginChannels: [String: PluginChannelConfig] = [:]
     ) {
         self.discord = discord
         self.telegram = telegram
@@ -572,6 +575,7 @@ public struct ChannelsConfig: Codable, Sendable, Equatable {
         self.imessage = imessage
         self.msteams = msteams
         self.webchat = webchat
+        self.pluginChannels = pluginChannels
     }
 
     private enum CodingKeys: String, CodingKey {
@@ -585,6 +589,7 @@ public struct ChannelsConfig: Codable, Sendable, Equatable {
         case imessage
         case msteams
         case webchat
+        case pluginChannels
     }
 
     public init(from decoder: Decoder) throws {
@@ -599,6 +604,10 @@ public struct ChannelsConfig: Codable, Sendable, Equatable {
         self.imessage = try container.decodeIfPresent(IMessageChannelConfig.self, forKey: .imessage) ?? IMessageChannelConfig()
         self.msteams = try container.decodeIfPresent(MicrosoftTeamsChannelConfig.self, forKey: .msteams) ?? MicrosoftTeamsChannelConfig()
         self.webchat = try container.decodeIfPresent(WebChatChannelConfig.self, forKey: .webchat) ?? WebChatChannelConfig()
+        self.pluginChannels = try container.decodeIfPresent(
+            [String: PluginChannelConfig].self,
+            forKey: .pluginChannels
+        ) ?? [:]
     }
 
     public func encode(to encoder: Encoder) throws {
@@ -613,6 +622,33 @@ public struct ChannelsConfig: Codable, Sendable, Equatable {
         try container.encode(self.imessage, forKey: .imessage)
         try container.encode(self.msteams, forKey: .msteams)
         try container.encode(self.webchat, forKey: .webchat)
+        try container.encode(self.pluginChannels, forKey: .pluginChannels)
+    }
+}
+
+/// Generic config block for upstream plugin-only channels.
+public struct PluginChannelConfig: Codable, Sendable, Equatable {
+    public var enabled: Bool
+    public var packageName: String?
+    public var config: [String: String]
+    public var secrets: [String: String]
+
+    /// Creates plugin-channel settings.
+    /// - Parameters:
+    ///   - enabled: Whether the host should attempt to activate this channel plugin.
+    ///   - packageName: Optional upstream package/plugin package name.
+    ///   - config: Non-secret plugin config values.
+    ///   - secrets: Secret values or secret references required by the plugin.
+    public init(
+        enabled: Bool = false,
+        packageName: String? = nil,
+        config: [String: String] = [:],
+        secrets: [String: String] = [:]
+    ) {
+        self.enabled = enabled
+        self.packageName = packageName
+        self.config = config
+        self.secrets = secrets
     }
 }
 

Sources/OpenClawCore/SecurityAuditReport.swift

@@ -217,6 +217,19 @@ public enum SecurityAuditRunner {
                 exposedKeys.append("models.providers.\(normalizedID).\(secretField)")
             }
         }
+        for (channelID, channelConfig) in config.channels.pluginChannels {
+            let normalizedID = channelID.trimmingCharacters(in: .whitespacesAndNewlines)
+            guard !normalizedID.isEmpty else {
+                continue
+            }
+            for (secretKey, secretValue) in channelConfig.secrets {
+                let normalizedSecretKey = secretKey.trimmingCharacters(in: .whitespacesAndNewlines)
+                let normalizedSecretValue = secretValue.trimmingCharacters(in: .whitespacesAndNewlines)
+                if !normalizedSecretKey.isEmpty, !normalizedSecretValue.isEmpty {
+                    exposedKeys.append("channels.pluginChannels.\(normalizedID).secrets.\(normalizedSecretKey)")
+                }
+            }
+        }
 
         guard !exposedKeys.isEmpty else {
             return []

Sources/OpenClawCore/SessionControls.swift

@@ -11,9 +11,11 @@ public enum ThinkLevel: String, Sendable, Equatable, CaseIterable, Codable {
     case adaptive
 
     private static let xhighModelRefs: Set<String> = [
+        "openai/gpt-5.5",
         "openai/gpt-5.4",
         "openai/gpt-5.4-pro",
         "openai/gpt-5.2",
+        "openai-codex/gpt-5.5",
         "openai-codex/gpt-5.4",
         "openai-codex/gpt-5.3-codex",
         "openai-codex/gpt-5.3-codex-spark",