@copilotkit/runtime 1.62.3 → 1.63.1

package/dist/v2/index.d.cts

@@ -1,20 +1,21 @@
-
+require("reflect-metadata");
 import { TranscribeFileOptions, TranscriptionService } from "./runtime/transcription-service/transcription-service.cjs";
 import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, supportsLocalThreadEndpoints } from "./runtime/runner/agent-runner.cjs";
 import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./runtime/intelligence-platform/client.cjs";
-import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, OpenGenerativeUIConfig, OpenGenerativeUIOptions, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./runtime/core/runtime.cjs";
+import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, OpenGenerativeUIConfig, OpenGenerativeUIOptions, RuntimeWithDeclaredChannels, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./runtime/core/runtime.cjs";
 import { CopilotCorsConfig } from "./runtime/core/fetch-cors.cjs";
 import { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./runtime/core/hooks.cjs";
-import { CopilotEndpointCorsConfig, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./runtime/endpoints/hono.cjs";
+import { ChannelStatus, ChannelsControl } from "./runtime/core/channel-manager.cjs";
+import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./runtime/endpoints/hono.cjs";
 import { createCopilotEndpointSingleRoute } from "./runtime/endpoints/hono-single.cjs";
-import { CopilotExpressEndpointParams, createCopilotExpressHandler } from "./runtime/endpoints/express.cjs";
+import { CopilotExpressEndpointParams, CopilotExpressRouter, createCopilotExpressHandler } from "./runtime/endpoints/express.cjs";
 import { createCopilotEndpointSingleRouteExpress } from "./runtime/endpoints/express-single.cjs";
 import { InMemoryAgentRunner, InMemoryThread } from "./runtime/runner/in-memory.cjs";
 import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runtime/runner/intelligence.cjs";
 import { finalizeRunEvents } from "./runtime/runner/index.cjs";
-import { CopilotRuntimeFetchHandler, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./runtime/core/fetch-handler.cjs";
+import { CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./runtime/core/fetch-handler.cjs";
 import { CopilotKitRequestHandler, MCPClient, MCPTransport } from "./runtime/index.cjs";
 import { convertAISDKStream } from "../agent/converters/aisdk.cjs";
 import { TanStackChatMessage, TanStackInputResult, convertInputToTanStackAI, convertTanStackStream } from "../agent/converters/tanstack.cjs";
 import { BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, InterruptSignal, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MessageConversionOptions, ModelSpecifier, OverridableProperty, ToolDefinition, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel } from "../agent/index.cjs";
-export { type AgentFactoryContext, AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, AgentsConfig, AgentsFactory, BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, CopilotCorsConfig, CopilotEndpointCorsConfig, CopilotExpressEndpointParams, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotKitIntelligence, CopilotKitIntelligenceConfig, CopilotKitRequestHandler, CopilotRuntime, CopilotRuntimeFetchHandler, CopilotRuntimeHandlerOptions, CopilotRuntimeHooks, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, CreateThreadRequest, ErrorHookContext, HandlerHookContext, HookContext, IdentifyUserCallback, InMemoryAgentRunner, InMemoryThread, IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, InterruptSignal, ListThreadsResponse, LocalThreadEndpointRecord, LocalThreadEndpointRunner, MCPClient, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MCPTransport, McpAppsConfig, McpAppsServerConfig, MessageConversionOptions, ModelSpecifier, OpenGenerativeUIConfig, OpenGenerativeUIOptions, OverridableProperty, ResponseHookContext, RouteInfo, RunnerStartupBoundary, SubscribeToThreadsRequest, SubscribeToThreadsResponse, TanStackChatMessage, TanStackInputResult, ThreadSummary, ToolDefinition, TranscribeFileOptions, TranscriptionService, UpdateThreadRequest, VERSION, convertAISDKStream, convertInputToTanStackAI, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertTanStackStream, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, createCopilotEndpoint, createCopilotExpressHandler as createCopilotEndpointExpress, createCopilotExpressHandler, createCopilotEndpointSingleRoute, createCopilotEndpointSingleRouteExpress, createCopilotHonoHandler, createCopilotRuntimeHandler, defineTool, finalizeRunEvents, isA2UIEnabled, isIntelligenceRuntime, resolveAgents, resolveModel, supportsLocalThreadEndpoints, toFetchCorsConfig };
+export { type AgentFactoryContext, AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, AgentsConfig, AgentsFactory, BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, ChannelStatus, ChannelsControl, CopilotCorsConfig, CopilotEndpointCorsConfig, CopilotExpressEndpointParams, CopilotExpressRouter, CopilotHonoApp, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotKitIntelligence, CopilotKitIntelligenceConfig, CopilotKitRequestHandler, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, CopilotRuntimeHooks, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, CreateThreadRequest, ErrorHookContext, HandlerHookContext, HookContext, IdentifyUserCallback, InMemoryAgentRunner, InMemoryThread, IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, InterruptSignal, ListThreadsResponse, LocalThreadEndpointRecord, LocalThreadEndpointRunner, MCPClient, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MCPTransport, McpAppsConfig, McpAppsServerConfig, MessageConversionOptions, ModelSpecifier, OpenGenerativeUIConfig, OpenGenerativeUIOptions, OverridableProperty, ResponseHookContext, RouteInfo, RunnerStartupBoundary, RuntimeWithDeclaredChannels, SubscribeToThreadsRequest, SubscribeToThreadsResponse, TanStackChatMessage, TanStackInputResult, ThreadSummary, ToolDefinition, TranscribeFileOptions, TranscriptionService, UpdateThreadRequest, VERSION, convertAISDKStream, convertInputToTanStackAI, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertTanStackStream, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, createCopilotEndpoint, createCopilotExpressHandler as createCopilotEndpointExpress, createCopilotExpressHandler, createCopilotEndpointSingleRoute, createCopilotEndpointSingleRouteExpress, createCopilotHonoHandler, createCopilotRuntimeHandler, defineTool, finalizeRunEvents, isA2UIEnabled, isIntelligenceRuntime, resolveAgents, resolveModel, supportsLocalThreadEndpoints, toFetchCorsConfig };

package/dist/v2/index.d.mts

@@ -2,19 +2,20 @@ import "reflect-metadata";
 import { TranscribeFileOptions, TranscriptionService } from "./runtime/transcription-service/transcription-service.mjs";
 import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, supportsLocalThreadEndpoints } from "./runtime/runner/agent-runner.mjs";
 import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./runtime/intelligence-platform/client.mjs";
-import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, OpenGenerativeUIConfig, OpenGenerativeUIOptions, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./runtime/core/runtime.mjs";
+import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, OpenGenerativeUIConfig, OpenGenerativeUIOptions, RuntimeWithDeclaredChannels, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./runtime/core/runtime.mjs";
 import { CopilotCorsConfig } from "./runtime/core/fetch-cors.mjs";
 import { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./runtime/core/hooks.mjs";
-import { CopilotEndpointCorsConfig, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./runtime/endpoints/hono.mjs";
+import { ChannelStatus, ChannelsControl } from "./runtime/core/channel-manager.mjs";
+import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./runtime/endpoints/hono.mjs";
 import { createCopilotEndpointSingleRoute } from "./runtime/endpoints/hono-single.mjs";
-import { CopilotExpressEndpointParams, createCopilotExpressHandler } from "./runtime/endpoints/express.mjs";
+import { CopilotExpressEndpointParams, CopilotExpressRouter, createCopilotExpressHandler } from "./runtime/endpoints/express.mjs";
 import { createCopilotEndpointSingleRouteExpress } from "./runtime/endpoints/express-single.mjs";
 import { InMemoryAgentRunner, InMemoryThread } from "./runtime/runner/in-memory.mjs";
 import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runtime/runner/intelligence.mjs";
 import { finalizeRunEvents } from "./runtime/runner/index.mjs";
-import { CopilotRuntimeFetchHandler, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./runtime/core/fetch-handler.mjs";
+import { CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./runtime/core/fetch-handler.mjs";
 import { CopilotKitRequestHandler, MCPClient, MCPTransport } from "./runtime/index.mjs";
 import { convertAISDKStream } from "../agent/converters/aisdk.mjs";
 import { TanStackChatMessage, TanStackInputResult, convertInputToTanStackAI, convertTanStackStream } from "../agent/converters/tanstack.mjs";
 import { BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, InterruptSignal, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MessageConversionOptions, ModelSpecifier, OverridableProperty, ToolDefinition, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, defineTool, resolveModel } from "../agent/index.mjs";
-export { type AgentFactoryContext, AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, AgentsConfig, AgentsFactory, BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, CopilotCorsConfig, CopilotEndpointCorsConfig, CopilotExpressEndpointParams, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotKitIntelligence, CopilotKitIntelligenceConfig, CopilotKitRequestHandler, CopilotRuntime, CopilotRuntimeFetchHandler, CopilotRuntimeHandlerOptions, CopilotRuntimeHooks, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, CreateThreadRequest, ErrorHookContext, HandlerHookContext, HookContext, IdentifyUserCallback, InMemoryAgentRunner, InMemoryThread, IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, InterruptSignal, ListThreadsResponse, LocalThreadEndpointRecord, LocalThreadEndpointRunner, MCPClient, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MCPTransport, McpAppsConfig, McpAppsServerConfig, MessageConversionOptions, ModelSpecifier, OpenGenerativeUIConfig, OpenGenerativeUIOptions, OverridableProperty, ResponseHookContext, RouteInfo, RunnerStartupBoundary, SubscribeToThreadsRequest, SubscribeToThreadsResponse, TanStackChatMessage, TanStackInputResult, ThreadSummary, ToolDefinition, TranscribeFileOptions, TranscriptionService, UpdateThreadRequest, VERSION, convertAISDKStream, convertInputToTanStackAI, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertTanStackStream, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, createCopilotEndpoint, createCopilotExpressHandler as createCopilotEndpointExpress, createCopilotExpressHandler, createCopilotEndpointSingleRoute, createCopilotEndpointSingleRouteExpress, createCopilotHonoHandler, createCopilotRuntimeHandler, defineTool, finalizeRunEvents, isA2UIEnabled, isIntelligenceRuntime, resolveAgents, resolveModel, supportsLocalThreadEndpoints, toFetchCorsConfig };
+export { type AgentFactoryContext, AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, AgentsConfig, AgentsFactory, BasicAgent, BasicAgentConfiguration, BuiltInAgent, BuiltInAgentAISDKFactoryConfig, BuiltInAgentClassicConfig, BuiltInAgentConfiguration, BuiltInAgentCustomFactoryConfig, BuiltInAgentFactoryConfig, BuiltInAgentModel, BuiltInAgentTanStackFactoryConfig, ChannelStatus, ChannelsControl, CopilotCorsConfig, CopilotEndpointCorsConfig, CopilotExpressEndpointParams, CopilotExpressRouter, CopilotHonoApp, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotKitIntelligence, CopilotKitIntelligenceConfig, CopilotKitRequestHandler, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, CopilotRuntimeHooks, CopilotRuntimeLike, CopilotRuntimeOptions, CopilotRuntimeUser, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, CreateThreadRequest, ErrorHookContext, HandlerHookContext, HookContext, IdentifyUserCallback, InMemoryAgentRunner, InMemoryThread, IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, InterruptSignal, ListThreadsResponse, LocalThreadEndpointRecord, LocalThreadEndpointRunner, MCPClient, MCPClientConfig, MCPClientConfigHTTP, MCPClientConfigSSE, MCPClientProvider, MCPTransport, McpAppsConfig, McpAppsServerConfig, MessageConversionOptions, ModelSpecifier, OpenGenerativeUIConfig, OpenGenerativeUIOptions, OverridableProperty, ResponseHookContext, RouteInfo, RunnerStartupBoundary, RuntimeWithDeclaredChannels, SubscribeToThreadsRequest, SubscribeToThreadsResponse, TanStackChatMessage, TanStackInputResult, ThreadSummary, ToolDefinition, TranscribeFileOptions, TranscriptionService, UpdateThreadRequest, VERSION, convertAISDKStream, convertInputToTanStackAI, convertJsonSchemaToZodSchema, convertMessagesToVercelAISDKMessages, convertTanStackStream, convertToolDefinitionsToVercelAITools, convertToolsToVercelAITools, createCopilotEndpoint, createCopilotExpressHandler as createCopilotEndpointExpress, createCopilotExpressHandler, createCopilotEndpointSingleRoute, createCopilotEndpointSingleRouteExpress, createCopilotHonoHandler, createCopilotRuntimeHandler, defineTool, finalizeRunEvents, isA2UIEnabled, isIntelligenceRuntime, resolveAgents, resolveModel, supportsLocalThreadEndpoints, toFetchCorsConfig };

package/dist/v2/node.d.cts

@@ -1,4 +1,4 @@
-
+require("reflect-metadata");
 import { NodeFetchHandler, createCopilotNodeHandler, createNodeFetchHandler } from "./runtime/endpoints/node-fetch-handler.cjs";
 import { createCopilotNodeListener } from "./runtime/endpoints/node.cjs";
 import "./runtime/node.cjs";

package/dist/v2/runtime/core/channel-activation-config.cjs

@@ -0,0 +1,93 @@
+require("reflect-metadata");
+
+//#region src/v2/runtime/core/channel-activation-config.ts
+/**
+* Error thrown when a Channel activation config cannot be derived — either the
+* Intelligence API key does not carry a project id in the expected
+* `cpk-{projectId}_...` format, or the {@link Channel} is missing a `name`.
+*/
+var ChannelConfigError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ChannelConfigError";
+	}
+};
+/** Matches the `cpk-{projectId}_...` Intelligence API key format. */
+const API_KEY_PROJECT_ID_PATTERN = /^cpk-(\d+)_/;
+/**
+* Parse the project id embedded in an Intelligence API key.
+*
+* Intelligence API keys are formatted `cpk-{projectId}_{rest}` — this
+* extracts and numerically parses the `{projectId}` segment.
+*
+* @param apiKey - The Intelligence API key to parse.
+* @returns The parsed, strictly-positive, safe-integer project id.
+* @throws {ChannelConfigError} If `apiKey` does not match the expected
+*   `cpk-{projectId}_...` format — a wrong/missing prefix or an absent project
+*   id segment all fail the same match — or if the parsed project id is not a
+*   strictly-positive safe integer.
+*/
+function parseProjectIdFromApiKey(apiKey) {
+	const match = API_KEY_PROJECT_ID_PATTERN.exec(apiKey);
+	if (!match) throw new ChannelConfigError("Could not parse a project id from the Intelligence API key — expected the \"cpk-{projectId}_...\" format (the key value is omitted here to avoid leaking secret material).");
+	const projectId = Number(match[1]);
+	if (!Number.isSafeInteger(projectId) || projectId <= 0) throw new ChannelConfigError(`Parsed an invalid project id (${projectId}) from the Intelligence API key — the project id in "cpk-{projectId}_..." must be a positive safe integer (the key value is omitted here to avoid leaking secret material).`);
+	return projectId;
+}
+/**
+* Derive the {@link ChannelActivationConfig} needed to activate `channel`
+* against the given Intelligence runtime configuration.
+*
+* @param args.intelligence - The Intelligence runtime client to pull the
+*   runner websocket URL and auth token from.
+* @param args.channel - The Channel being activated. Must have a `name`; its
+*   per-Channel `provider` selects the managed adapter declared to the gateway.
+* @param args.runtimeInstanceId - Identifier for the activating runtime
+*   instance, passed through unchanged.
+* @returns The resolved {@link ChannelActivationConfig}.
+* @throws {ChannelConfigError} If the Intelligence API key does not carry a
+*   parseable, strictly-positive project id, or if `channel.name` is
+*   missing/empty.
+*
+* The managed provider is a PER-CHANNEL choice read from `channel.provider`, so
+* one runtime can activate a Slack-backed Channel and a Teams-backed Channel
+* side by side. When `channel.provider` is unset the config adapter defaults to
+* `"slack"` — an explicit, documented default, not a silent global. The SDK
+* only DECLARES this provider to the Intelligence gateway on join; the gateway
+* resolves the actual connection and is the authority on which providers it
+* accepts (it accepts only `"slack"` today — Teams gateway support is tracked
+* in OSS-450).
+*
+* The Channel-name FORMAT rules (lowercase kebab-case, 3–64 chars) and the
+* reserved-name rule are NOT re-checked here. Their single source of truth is
+* the `@copilotkit/channels-intelligence` launcher
+* (`assertValidChannelRealtimeScope` + `assertValidChannelNames`), which
+* validates them at activation; a malformed name surfaces as a logged `error`
+* status via {@link ChannelManager.ready} rather than an up-front throw. An
+* empty/missing name is still rejected here because that is this config's own
+* precondition (it has no name to forward at all), not a downstream replica.
+*/
+function deriveChannelActivationConfig(args) {
+	const { intelligence, channel, runtimeInstanceId } = args;
+	if (!channel.name) throw new ChannelConfigError("Channel is missing a `name` — pass createChannel({ name }) to activate it.");
+	const channelName = channel.name;
+	const wsUrl = intelligence.ɵgetRunnerWsUrl();
+	const apiUrl = intelligence.ɵgetApiUrl();
+	const apiKey = intelligence.ɵgetRunnerAuthToken();
+	const projectId = parseProjectIdFromApiKey(apiKey);
+	const trimmedProvider = channel.provider?.trim();
+	return {
+		wsUrl,
+		apiUrl,
+		apiKey,
+		projectId,
+		channelName,
+		adapter: trimmedProvider ? trimmedProvider : "slack",
+		runtimeInstanceId
+	};
+}
+
+//#endregion
+exports.ChannelConfigError = ChannelConfigError;
+exports.deriveChannelActivationConfig = deriveChannelActivationConfig;
+//# sourceMappingURL=channel-activation-config.cjs.map

package/dist/v2/runtime/core/channel-activation-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.cjs","names":[],"sources":["../../../../src/v2/runtime/core/channel-activation-config.ts"],"sourcesContent":["import type { CopilotKitIntelligence } from \"../intelligence-platform\";\n// Type-only: @copilotkit/channels is pure-ESM, so a value import would break this\n// package's CJS output (see `runtime.ts` for the same constraint).\nimport type { Channel } from \"@copilotkit/channels\";\n\n/**\n * Error thrown when a Channel activation config cannot be derived — either the\n * Intelligence API key does not carry a project id in the expected\n * `cpk-{projectId}_...` format, or the {@link Channel} is missing a `name`.\n */\nexport class ChannelConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ChannelConfigError\";\n  }\n}\n\n/**\n * Resolved configuration needed to activate a single Channel against a\n * running Intelligence runtime instance.\n */\nexport interface ChannelActivationConfig {\n  /** Intelligence runner websocket URL the Channel connects to. */\n  wsUrl: string;\n  /** Intelligence API key used to authenticate the runner connection. */\n  apiKey: string;\n  /** Intelligence app-api HTTP base URL (`intelligence.ɵgetApiUrl()`), forwarded\n   * to the transport so the managed realtime path enables file/history parity\n   * (those are HTTP-only). Without it, Channels started by the normal runtime\n   * handler run with no history and no file support (OSS-476). */\n  apiUrl: string;\n  /** Project id parsed from {@link apiKey}. */\n  projectId: number;\n  /** The Channel's declared name (`createChannel({ name })`). */\n  channelName: string;\n  /**\n   * The managed provider this Channel declares to the Intelligence gateway on\n   * join, resolved from the Channel's per-Channel `provider` (e.g. `\"slack\"` or\n   * `\"teams\"`), defaulting to `\"slack\"`. Named `adapter` because that is the\n   * field the gateway's join payload expects; the gateway resolves the actual\n   * connection for the declared provider.\n   */\n  adapter: string;\n  /** Identifier for the runtime instance activating this Channel. */\n  runtimeInstanceId: string;\n}\n\n/** Matches the `cpk-{projectId}_...` Intelligence API key format. */\nconst API_KEY_PROJECT_ID_PATTERN = /^cpk-(\\d+)_/;\n\n/**\n * Parse the project id embedded in an Intelligence API key.\n *\n * Intelligence API keys are formatted `cpk-{projectId}_{rest}` — this\n * extracts and numerically parses the `{projectId}` segment.\n *\n * @param apiKey - The Intelligence API key to parse.\n * @returns The parsed, strictly-positive, safe-integer project id.\n * @throws {ChannelConfigError} If `apiKey` does not match the expected\n *   `cpk-{projectId}_...` format — a wrong/missing prefix or an absent project\n *   id segment all fail the same match — or if the parsed project id is not a\n *   strictly-positive safe integer.\n */\nexport function parseProjectIdFromApiKey(apiKey: string): number {\n  const match = API_KEY_PROJECT_ID_PATTERN.exec(apiKey);\n  if (!match) {\n    // The whole API key is a `cpk-…` secret — everything after the fixed `cpk-`\n    // namespace is sensitive, so a fixed-width slice (e.g. `apiKey.slice(0, 8)`)\n    // would echo secret bytes for a `cpk-_short_long`-shaped key. This message is\n    // logged and surfaced through `ready()`'s AggregateError, so echo NONE of the\n    // key value; name only the expected format to aid diagnosis.\n    throw new ChannelConfigError(\n      `Could not parse a project id from the Intelligence API key — expected the ` +\n        `\"cpk-{projectId}_...\" format (the key value is omitted here to avoid ` +\n        `leaking secret material).`,\n    );\n  }\n  const projectId = Number(match[1]);\n  // Validate the parser's OWN output: `cpk-0_...` matches the pattern but a\n  // non-positive project id would otherwise fail deep inside the launcher's\n  // `assertValidChannelRealtimeScope` (which requires a positive projectId).\n  // A very long digit run also matches `\\d+` but loses precision (or overflows\n  // to Infinity) once coerced to `Number`, so it must be rejected too even\n  // though it is `> 0` — `Number.isSafeInteger` catches both. This is the\n  // parser guarding its own contract, not a channel-name replica, so it\n  // belongs here. Reuse the same redaction: never echo the key value.\n  if (!Number.isSafeInteger(projectId) || projectId <= 0) {\n    throw new ChannelConfigError(\n      `Parsed an invalid project id (${projectId}) from the Intelligence API ` +\n        `key — the project id in \"cpk-{projectId}_...\" must be a positive safe ` +\n        `integer (the key value is omitted here to avoid leaking secret material).`,\n    );\n  }\n  return projectId;\n}\n\n/**\n * Derive the {@link ChannelActivationConfig} needed to activate `channel`\n * against the given Intelligence runtime configuration.\n *\n * @param args.intelligence - The Intelligence runtime client to pull the\n *   runner websocket URL and auth token from.\n * @param args.channel - The Channel being activated. Must have a `name`; its\n *   per-Channel `provider` selects the managed adapter declared to the gateway.\n * @param args.runtimeInstanceId - Identifier for the activating runtime\n *   instance, passed through unchanged.\n * @returns The resolved {@link ChannelActivationConfig}.\n * @throws {ChannelConfigError} If the Intelligence API key does not carry a\n *   parseable, strictly-positive project id, or if `channel.name` is\n *   missing/empty.\n *\n * The managed provider is a PER-CHANNEL choice read from `channel.provider`, so\n * one runtime can activate a Slack-backed Channel and a Teams-backed Channel\n * side by side. When `channel.provider` is unset the config adapter defaults to\n * `\"slack\"` — an explicit, documented default, not a silent global. The SDK\n * only DECLARES this provider to the Intelligence gateway on join; the gateway\n * resolves the actual connection and is the authority on which providers it\n * accepts (it accepts only `\"slack\"` today — Teams gateway support is tracked\n * in OSS-450).\n *\n * The Channel-name FORMAT rules (lowercase kebab-case, 3–64 chars) and the\n * reserved-name rule are NOT re-checked here. Their single source of truth is\n * the `@copilotkit/channels-intelligence` launcher\n * (`assertValidChannelRealtimeScope` + `assertValidChannelNames`), which\n * validates them at activation; a malformed name surfaces as a logged `error`\n * status via {@link ChannelManager.ready} rather than an up-front throw. An\n * empty/missing name is still rejected here because that is this config's own\n * precondition (it has no name to forward at all), not a downstream replica.\n */\nexport function deriveChannelActivationConfig(args: {\n  intelligence: CopilotKitIntelligence;\n  channel: Channel;\n  runtimeInstanceId: string;\n}): ChannelActivationConfig {\n  const { intelligence, channel, runtimeInstanceId } = args;\n\n  if (!channel.name) {\n    throw new ChannelConfigError(\n      \"Channel is missing a `name` — pass createChannel({ name }) to activate it.\",\n    );\n  }\n\n  const channelName = channel.name;\n\n  const wsUrl = intelligence.ɵgetRunnerWsUrl();\n  const apiUrl = intelligence.ɵgetApiUrl();\n  const apiKey = intelligence.ɵgetRunnerAuthToken();\n  const projectId = parseProjectIdFromApiKey(apiKey);\n\n  // Resolve the managed adapter declared to the gateway from the Channel's OWN\n  // `provider` — a per-Channel choice, not a manager-wide default. When\n  // `provider` is unset the adapter is the documented default `\"slack\"`; set\n  // `createChannel({ provider: \"teams\" })` to declare Teams instead. The value\n  // is trimmed so a padded runtime value (one that bypassed the typed union)\n  // resolves to its bare provider rather than being forwarded with whitespace,\n  // and a blank/whitespace-only provider falls back to `\"slack\"` (`??` alone\n  // would keep `\"\"`).\n  const trimmedProvider = channel.provider?.trim();\n\n  return {\n    wsUrl,\n    apiUrl,\n    apiKey,\n    projectId,\n    channelName,\n    adapter: trimmedProvider ? trimmedProvider : \"slack\",\n    runtimeInstanceId,\n  };\n}\n"],"mappings":";;;;;;;;AAUA,IAAa,qBAAb,cAAwC,MAAM;CAC5C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;AAmChB,MAAM,6BAA6B;;;;;;;;;;;;;;AAenC,SAAgB,yBAAyB,QAAwB;CAC/D,MAAM,QAAQ,2BAA2B,KAAK,OAAO;AACrD,KAAI,CAAC,MAMH,OAAM,IAAI,mBACR,6KAGD;CAEH,MAAM,YAAY,OAAO,MAAM,GAAG;AASlC,KAAI,CAAC,OAAO,cAAc,UAAU,IAAI,aAAa,EACnD,OAAM,IAAI,mBACR,iCAAiC,UAAU,6KAG5C;AAEH,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCT,SAAgB,8BAA8B,MAIlB;CAC1B,MAAM,EAAE,cAAc,SAAS,sBAAsB;AAErD,KAAI,CAAC,QAAQ,KACX,OAAM,IAAI,mBACR,6EACD;CAGH,MAAM,cAAc,QAAQ;CAE5B,MAAM,QAAQ,aAAa,iBAAiB;CAC5C,MAAM,SAAS,aAAa,YAAY;CACxC,MAAM,SAAS,aAAa,qBAAqB;CACjD,MAAM,YAAY,yBAAyB,OAAO;CAUlD,MAAM,kBAAkB,QAAQ,UAAU,MAAM;AAEhD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,SAAS,kBAAkB,kBAAkB;EAC7C;EACD"}

package/dist/v2/runtime/core/channel-activation-config.d.cts

@@ -0,0 +1,34 @@
+require("reflect-metadata");
+//#region src/v2/runtime/core/channel-activation-config.d.ts
+/**
+ * Resolved configuration needed to activate a single Channel against a
+ * running Intelligence runtime instance.
+ */
+interface ChannelActivationConfig {
+  /** Intelligence runner websocket URL the Channel connects to. */
+  wsUrl: string;
+  /** Intelligence API key used to authenticate the runner connection. */
+  apiKey: string;
+  /** Intelligence app-api HTTP base URL (`intelligence.ɵgetApiUrl()`), forwarded
+   * to the transport so the managed realtime path enables file/history parity
+   * (those are HTTP-only). Without it, Channels started by the normal runtime
+   * handler run with no history and no file support (OSS-476). */
+  apiUrl: string;
+  /** Project id parsed from {@link apiKey}. */
+  projectId: number;
+  /** The Channel's declared name (`createChannel({ name })`). */
+  channelName: string;
+  /**
+   * The managed provider this Channel declares to the Intelligence gateway on
+   * join, resolved from the Channel's per-Channel `provider` (e.g. `"slack"` or
+   * `"teams"`), defaulting to `"slack"`. Named `adapter` because that is the
+   * field the gateway's join payload expects; the gateway resolves the actual
+   * connection for the declared provider.
+   */
+  adapter: string;
+  /** Identifier for the runtime instance activating this Channel. */
+  runtimeInstanceId: string;
+}
+//#endregion
+export { ChannelActivationConfig };
+//# sourceMappingURL=channel-activation-config.d.cts.map

package/dist/v2/runtime/core/channel-activation-config.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.d.cts","names":[],"sources":["../../../../src/v2/runtime/core/channel-activation-config.ts"],"mappings":";;;;;;UAqBiB,uBAAA;;EAEf,KAAA;;EAEA,MAAA;;;;;EAKA,MAAA;;EAEA,SAAA;;EAEA,WAAA;;;;;;;;EAQA,OAAA;;EAEA,iBAAA;AAAA"}

package/dist/v2/runtime/core/channel-activation-config.d.mts

@@ -0,0 +1,34 @@
+import "reflect-metadata";
+//#region src/v2/runtime/core/channel-activation-config.d.ts
+/**
+ * Resolved configuration needed to activate a single Channel against a
+ * running Intelligence runtime instance.
+ */
+interface ChannelActivationConfig {
+  /** Intelligence runner websocket URL the Channel connects to. */
+  wsUrl: string;
+  /** Intelligence API key used to authenticate the runner connection. */
+  apiKey: string;
+  /** Intelligence app-api HTTP base URL (`intelligence.ɵgetApiUrl()`), forwarded
+   * to the transport so the managed realtime path enables file/history parity
+   * (those are HTTP-only). Without it, Channels started by the normal runtime
+   * handler run with no history and no file support (OSS-476). */
+  apiUrl: string;
+  /** Project id parsed from {@link apiKey}. */
+  projectId: number;
+  /** The Channel's declared name (`createChannel({ name })`). */
+  channelName: string;
+  /**
+   * The managed provider this Channel declares to the Intelligence gateway on
+   * join, resolved from the Channel's per-Channel `provider` (e.g. `"slack"` or
+   * `"teams"`), defaulting to `"slack"`. Named `adapter` because that is the
+   * field the gateway's join payload expects; the gateway resolves the actual
+   * connection for the declared provider.
+   */
+  adapter: string;
+  /** Identifier for the runtime instance activating this Channel. */
+  runtimeInstanceId: string;
+}
+//#endregion
+export { ChannelActivationConfig };
+//# sourceMappingURL=channel-activation-config.d.mts.map

package/dist/v2/runtime/core/channel-activation-config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.d.mts","names":[],"sources":["../../../../src/v2/runtime/core/channel-activation-config.ts"],"mappings":";;;;;;UAqBiB,uBAAA;;EAEf,KAAA;;EAEA,MAAA;;;;;EAKA,MAAA;;EAEA,SAAA;;EAEA,WAAA;;;;;;;;EAQA,OAAA;;EAEA,iBAAA;AAAA"}

package/dist/v2/runtime/core/channel-activation-config.mjs

@@ -0,0 +1,91 @@
+import "reflect-metadata";
+//#region src/v2/runtime/core/channel-activation-config.ts
+/**
+* Error thrown when a Channel activation config cannot be derived — either the
+* Intelligence API key does not carry a project id in the expected
+* `cpk-{projectId}_...` format, or the {@link Channel} is missing a `name`.
+*/
+var ChannelConfigError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ChannelConfigError";
+	}
+};
+/** Matches the `cpk-{projectId}_...` Intelligence API key format. */
+const API_KEY_PROJECT_ID_PATTERN = /^cpk-(\d+)_/;
+/**
+* Parse the project id embedded in an Intelligence API key.
+*
+* Intelligence API keys are formatted `cpk-{projectId}_{rest}` — this
+* extracts and numerically parses the `{projectId}` segment.
+*
+* @param apiKey - The Intelligence API key to parse.
+* @returns The parsed, strictly-positive, safe-integer project id.
+* @throws {ChannelConfigError} If `apiKey` does not match the expected
+*   `cpk-{projectId}_...` format — a wrong/missing prefix or an absent project
+*   id segment all fail the same match — or if the parsed project id is not a
+*   strictly-positive safe integer.
+*/
+function parseProjectIdFromApiKey(apiKey) {
+	const match = API_KEY_PROJECT_ID_PATTERN.exec(apiKey);
+	if (!match) throw new ChannelConfigError("Could not parse a project id from the Intelligence API key — expected the \"cpk-{projectId}_...\" format (the key value is omitted here to avoid leaking secret material).");
+	const projectId = Number(match[1]);
+	if (!Number.isSafeInteger(projectId) || projectId <= 0) throw new ChannelConfigError(`Parsed an invalid project id (${projectId}) from the Intelligence API key — the project id in "cpk-{projectId}_..." must be a positive safe integer (the key value is omitted here to avoid leaking secret material).`);
+	return projectId;
+}
+/**
+* Derive the {@link ChannelActivationConfig} needed to activate `channel`
+* against the given Intelligence runtime configuration.
+*
+* @param args.intelligence - The Intelligence runtime client to pull the
+*   runner websocket URL and auth token from.
+* @param args.channel - The Channel being activated. Must have a `name`; its
+*   per-Channel `provider` selects the managed adapter declared to the gateway.
+* @param args.runtimeInstanceId - Identifier for the activating runtime
+*   instance, passed through unchanged.
+* @returns The resolved {@link ChannelActivationConfig}.
+* @throws {ChannelConfigError} If the Intelligence API key does not carry a
+*   parseable, strictly-positive project id, or if `channel.name` is
+*   missing/empty.
+*
+* The managed provider is a PER-CHANNEL choice read from `channel.provider`, so
+* one runtime can activate a Slack-backed Channel and a Teams-backed Channel
+* side by side. When `channel.provider` is unset the config adapter defaults to
+* `"slack"` — an explicit, documented default, not a silent global. The SDK
+* only DECLARES this provider to the Intelligence gateway on join; the gateway
+* resolves the actual connection and is the authority on which providers it
+* accepts (it accepts only `"slack"` today — Teams gateway support is tracked
+* in OSS-450).
+*
+* The Channel-name FORMAT rules (lowercase kebab-case, 3–64 chars) and the
+* reserved-name rule are NOT re-checked here. Their single source of truth is
+* the `@copilotkit/channels-intelligence` launcher
+* (`assertValidChannelRealtimeScope` + `assertValidChannelNames`), which
+* validates them at activation; a malformed name surfaces as a logged `error`
+* status via {@link ChannelManager.ready} rather than an up-front throw. An
+* empty/missing name is still rejected here because that is this config's own
+* precondition (it has no name to forward at all), not a downstream replica.
+*/
+function deriveChannelActivationConfig(args) {
+	const { intelligence, channel, runtimeInstanceId } = args;
+	if (!channel.name) throw new ChannelConfigError("Channel is missing a `name` — pass createChannel({ name }) to activate it.");
+	const channelName = channel.name;
+	const wsUrl = intelligence.ɵgetRunnerWsUrl();
+	const apiUrl = intelligence.ɵgetApiUrl();
+	const apiKey = intelligence.ɵgetRunnerAuthToken();
+	const projectId = parseProjectIdFromApiKey(apiKey);
+	const trimmedProvider = channel.provider?.trim();
+	return {
+		wsUrl,
+		apiUrl,
+		apiKey,
+		projectId,
+		channelName,
+		adapter: trimmedProvider ? trimmedProvider : "slack",
+		runtimeInstanceId
+	};
+}
+
+//#endregion
+export { ChannelConfigError, deriveChannelActivationConfig };
+//# sourceMappingURL=channel-activation-config.mjs.map

package/dist/v2/runtime/core/channel-activation-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.mjs","names":[],"sources":["../../../../src/v2/runtime/core/channel-activation-config.ts"],"sourcesContent":["import type { CopilotKitIntelligence } from \"../intelligence-platform\";\n// Type-only: @copilotkit/channels is pure-ESM, so a value import would break this\n// package's CJS output (see `runtime.ts` for the same constraint).\nimport type { Channel } from \"@copilotkit/channels\";\n\n/**\n * Error thrown when a Channel activation config cannot be derived — either the\n * Intelligence API key does not carry a project id in the expected\n * `cpk-{projectId}_...` format, or the {@link Channel} is missing a `name`.\n */\nexport class ChannelConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ChannelConfigError\";\n  }\n}\n\n/**\n * Resolved configuration needed to activate a single Channel against a\n * running Intelligence runtime instance.\n */\nexport interface ChannelActivationConfig {\n  /** Intelligence runner websocket URL the Channel connects to. */\n  wsUrl: string;\n  /** Intelligence API key used to authenticate the runner connection. */\n  apiKey: string;\n  /** Intelligence app-api HTTP base URL (`intelligence.ɵgetApiUrl()`), forwarded\n   * to the transport so the managed realtime path enables file/history parity\n   * (those are HTTP-only). Without it, Channels started by the normal runtime\n   * handler run with no history and no file support (OSS-476). */\n  apiUrl: string;\n  /** Project id parsed from {@link apiKey}. */\n  projectId: number;\n  /** The Channel's declared name (`createChannel({ name })`). */\n  channelName: string;\n  /**\n   * The managed provider this Channel declares to the Intelligence gateway on\n   * join, resolved from the Channel's per-Channel `provider` (e.g. `\"slack\"` or\n   * `\"teams\"`), defaulting to `\"slack\"`. Named `adapter` because that is the\n   * field the gateway's join payload expects; the gateway resolves the actual\n   * connection for the declared provider.\n   */\n  adapter: string;\n  /** Identifier for the runtime instance activating this Channel. */\n  runtimeInstanceId: string;\n}\n\n/** Matches the `cpk-{projectId}_...` Intelligence API key format. */\nconst API_KEY_PROJECT_ID_PATTERN = /^cpk-(\\d+)_/;\n\n/**\n * Parse the project id embedded in an Intelligence API key.\n *\n * Intelligence API keys are formatted `cpk-{projectId}_{rest}` — this\n * extracts and numerically parses the `{projectId}` segment.\n *\n * @param apiKey - The Intelligence API key to parse.\n * @returns The parsed, strictly-positive, safe-integer project id.\n * @throws {ChannelConfigError} If `apiKey` does not match the expected\n *   `cpk-{projectId}_...` format — a wrong/missing prefix or an absent project\n *   id segment all fail the same match — or if the parsed project id is not a\n *   strictly-positive safe integer.\n */\nexport function parseProjectIdFromApiKey(apiKey: string): number {\n  const match = API_KEY_PROJECT_ID_PATTERN.exec(apiKey);\n  if (!match) {\n    // The whole API key is a `cpk-…` secret — everything after the fixed `cpk-`\n    // namespace is sensitive, so a fixed-width slice (e.g. `apiKey.slice(0, 8)`)\n    // would echo secret bytes for a `cpk-_short_long`-shaped key. This message is\n    // logged and surfaced through `ready()`'s AggregateError, so echo NONE of the\n    // key value; name only the expected format to aid diagnosis.\n    throw new ChannelConfigError(\n      `Could not parse a project id from the Intelligence API key — expected the ` +\n        `\"cpk-{projectId}_...\" format (the key value is omitted here to avoid ` +\n        `leaking secret material).`,\n    );\n  }\n  const projectId = Number(match[1]);\n  // Validate the parser's OWN output: `cpk-0_...` matches the pattern but a\n  // non-positive project id would otherwise fail deep inside the launcher's\n  // `assertValidChannelRealtimeScope` (which requires a positive projectId).\n  // A very long digit run also matches `\\d+` but loses precision (or overflows\n  // to Infinity) once coerced to `Number`, so it must be rejected too even\n  // though it is `> 0` — `Number.isSafeInteger` catches both. This is the\n  // parser guarding its own contract, not a channel-name replica, so it\n  // belongs here. Reuse the same redaction: never echo the key value.\n  if (!Number.isSafeInteger(projectId) || projectId <= 0) {\n    throw new ChannelConfigError(\n      `Parsed an invalid project id (${projectId}) from the Intelligence API ` +\n        `key — the project id in \"cpk-{projectId}_...\" must be a positive safe ` +\n        `integer (the key value is omitted here to avoid leaking secret material).`,\n    );\n  }\n  return projectId;\n}\n\n/**\n * Derive the {@link ChannelActivationConfig} needed to activate `channel`\n * against the given Intelligence runtime configuration.\n *\n * @param args.intelligence - The Intelligence runtime client to pull the\n *   runner websocket URL and auth token from.\n * @param args.channel - The Channel being activated. Must have a `name`; its\n *   per-Channel `provider` selects the managed adapter declared to the gateway.\n * @param args.runtimeInstanceId - Identifier for the activating runtime\n *   instance, passed through unchanged.\n * @returns The resolved {@link ChannelActivationConfig}.\n * @throws {ChannelConfigError} If the Intelligence API key does not carry a\n *   parseable, strictly-positive project id, or if `channel.name` is\n *   missing/empty.\n *\n * The managed provider is a PER-CHANNEL choice read from `channel.provider`, so\n * one runtime can activate a Slack-backed Channel and a Teams-backed Channel\n * side by side. When `channel.provider` is unset the config adapter defaults to\n * `\"slack\"` — an explicit, documented default, not a silent global. The SDK\n * only DECLARES this provider to the Intelligence gateway on join; the gateway\n * resolves the actual connection and is the authority on which providers it\n * accepts (it accepts only `\"slack\"` today — Teams gateway support is tracked\n * in OSS-450).\n *\n * The Channel-name FORMAT rules (lowercase kebab-case, 3–64 chars) and the\n * reserved-name rule are NOT re-checked here. Their single source of truth is\n * the `@copilotkit/channels-intelligence` launcher\n * (`assertValidChannelRealtimeScope` + `assertValidChannelNames`), which\n * validates them at activation; a malformed name surfaces as a logged `error`\n * status via {@link ChannelManager.ready} rather than an up-front throw. An\n * empty/missing name is still rejected here because that is this config's own\n * precondition (it has no name to forward at all), not a downstream replica.\n */\nexport function deriveChannelActivationConfig(args: {\n  intelligence: CopilotKitIntelligence;\n  channel: Channel;\n  runtimeInstanceId: string;\n}): ChannelActivationConfig {\n  const { intelligence, channel, runtimeInstanceId } = args;\n\n  if (!channel.name) {\n    throw new ChannelConfigError(\n      \"Channel is missing a `name` — pass createChannel({ name }) to activate it.\",\n    );\n  }\n\n  const channelName = channel.name;\n\n  const wsUrl = intelligence.ɵgetRunnerWsUrl();\n  const apiUrl = intelligence.ɵgetApiUrl();\n  const apiKey = intelligence.ɵgetRunnerAuthToken();\n  const projectId = parseProjectIdFromApiKey(apiKey);\n\n  // Resolve the managed adapter declared to the gateway from the Channel's OWN\n  // `provider` — a per-Channel choice, not a manager-wide default. When\n  // `provider` is unset the adapter is the documented default `\"slack\"`; set\n  // `createChannel({ provider: \"teams\" })` to declare Teams instead. The value\n  // is trimmed so a padded runtime value (one that bypassed the typed union)\n  // resolves to its bare provider rather than being forwarded with whitespace,\n  // and a blank/whitespace-only provider falls back to `\"slack\"` (`??` alone\n  // would keep `\"\"`).\n  const trimmedProvider = channel.provider?.trim();\n\n  return {\n    wsUrl,\n    apiUrl,\n    apiKey,\n    projectId,\n    channelName,\n    adapter: trimmedProvider ? trimmedProvider : \"slack\",\n    runtimeInstanceId,\n  };\n}\n"],"mappings":";;;;;;;AAUA,IAAa,qBAAb,cAAwC,MAAM;CAC5C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;AAmChB,MAAM,6BAA6B;;;;;;;;;;;;;;AAenC,SAAgB,yBAAyB,QAAwB;CAC/D,MAAM,QAAQ,2BAA2B,KAAK,OAAO;AACrD,KAAI,CAAC,MAMH,OAAM,IAAI,mBACR,6KAGD;CAEH,MAAM,YAAY,OAAO,MAAM,GAAG;AASlC,KAAI,CAAC,OAAO,cAAc,UAAU,IAAI,aAAa,EACnD,OAAM,IAAI,mBACR,iCAAiC,UAAU,6KAG5C;AAEH,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCT,SAAgB,8BAA8B,MAIlB;CAC1B,MAAM,EAAE,cAAc,SAAS,sBAAsB;AAErD,KAAI,CAAC,QAAQ,KACX,OAAM,IAAI,mBACR,6EACD;CAGH,MAAM,cAAc,QAAQ;CAE5B,MAAM,QAAQ,aAAa,iBAAiB;CAC5C,MAAM,SAAS,aAAa,YAAY;CACxC,MAAM,SAAS,aAAa,qBAAqB;CACjD,MAAM,YAAY,yBAAyB,OAAO;CAUlD,MAAM,kBAAkB,QAAQ,UAAU,MAAM;AAEhD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,SAAS,kBAAkB,kBAAkB;EAC7C;EACD"}