@copilotkit/runtime 2.0.0-next.1 → 2.0.0-rc.0

package/dist/internal/learned-skills.cjs

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_learned_skills = require('../runtime/intelligence-platform/learned-skills.cjs');
+const require_errors = require('../runtime/intelligence-platform/skill-registry/errors.cjs');
+const require_archive = require('../runtime/intelligence-platform/skill-registry/archive.cjs');
+const require_config = require('../runtime/intelligence-platform/skill-registry/config.cjs');
+const require_snapshot = require('../runtime/intelligence-platform/skill-registry/snapshot.cjs');
+const require_registry = require('../runtime/intelligence-platform/skill-registry/registry.cjs');
+const require_skill_content = require('../runtime/intelligence-platform/skill-registry/skill-content.cjs');
+
+exports.MAX_ARCHIVE_ENTRIES = require_archive.MAX_ARCHIVE_ENTRIES;
+exports.MAX_SNAPSHOT_BYTES = require_archive.MAX_SNAPSHOT_BYTES;
+exports.SkillDeliveryError = require_learned_skills.LearnedSkillsError;
+exports.SkillRegistry = require_registry.SkillRegistry;
+exports.formatSkillCatalog = require_skill_content.formatSkillCatalog;
+exports.invalidSnapshot = require_errors.invalidSnapshot;
+exports.loadSkill = require_skill_content.loadSkill;
+exports.readArchive = require_archive.readArchive;
+exports.readSkillFile = require_skill_content.readSkillFile;
+exports.resolveRegistryConfig = require_config.resolveRegistryConfig;
+exports.safeRelativePath = require_archive.safeRelativePath;
+exports.validateSnapshot = require_snapshot.validateSnapshot;

package/dist/internal/learned-skills.d.cts

@@ -0,0 +1,9 @@
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../runtime/intelligence-platform/learned-skills.cjs";
+import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "../runtime/intelligence-platform/skill-registry/archive.cjs";
+import { RegistryConfig, SingleContainerConfig, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, resolveRegistryConfig } from "../runtime/intelligence-platform/skill-registry/config.cjs";
+import { invalidSnapshot } from "../runtime/intelligence-platform/skill-registry/errors.cjs";
+import { SnapshotFile, SnapshotSkill, VerifiedSnapshot, validateSnapshot } from "../runtime/intelligence-platform/skill-registry/snapshot.cjs";
+import { SkillRegistry, SkillRegistryStatus } from "../runtime/intelligence-platform/skill-registry/registry.cjs";
+import { formatSkillCatalog, loadSkill, readSkillFile } from "../runtime/intelligence-platform/skill-registry/skill-content.cjs";
+import "../runtime/intelligence-platform/skill-registry/index.cjs";
+export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, RegistryConfig, SingleContainerConfig, LearnedSkillsError as SkillDeliveryError, LearnedSkillsErrorCode as SkillDeliveryErrorCode, SkillRegistry, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, SkillRegistryStatus, SnapshotFile, SnapshotSkill, VerifiedSnapshot, formatSkillCatalog, invalidSnapshot, loadSkill, readArchive, readSkillFile, resolveRegistryConfig, safeRelativePath, validateSnapshot };

package/dist/internal/learned-skills.d.mts

@@ -0,0 +1,9 @@
+import { LearnedSkillsError, LearnedSkillsErrorCode } from "../runtime/intelligence-platform/learned-skills.mjs";
+import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "../runtime/intelligence-platform/skill-registry/archive.mjs";
+import { RegistryConfig, SingleContainerConfig, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, resolveRegistryConfig } from "../runtime/intelligence-platform/skill-registry/config.mjs";
+import { invalidSnapshot } from "../runtime/intelligence-platform/skill-registry/errors.mjs";
+import { SnapshotFile, SnapshotSkill, VerifiedSnapshot, validateSnapshot } from "../runtime/intelligence-platform/skill-registry/snapshot.mjs";
+import { SkillRegistry, SkillRegistryStatus } from "../runtime/intelligence-platform/skill-registry/registry.mjs";
+import { formatSkillCatalog, loadSkill, readSkillFile } from "../runtime/intelligence-platform/skill-registry/skill-content.mjs";
+import "../runtime/intelligence-platform/skill-registry/index.mjs";
+export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, RegistryConfig, SingleContainerConfig, LearnedSkillsError as SkillDeliveryError, LearnedSkillsErrorCode as SkillDeliveryErrorCode, SkillRegistry, SkillRegistryCommonOptions, SkillRegistryContainer, SkillRegistryOptions, SkillRegistryStatus, SnapshotFile, SnapshotSkill, VerifiedSnapshot, formatSkillCatalog, invalidSnapshot, loadSkill, readArchive, readSkillFile, resolveRegistryConfig, safeRelativePath, validateSnapshot };

package/dist/internal/learned-skills.mjs

@@ -0,0 +1,9 @@
+import { LearnedSkillsError } from "../runtime/intelligence-platform/learned-skills.mjs";
+import { invalidSnapshot } from "../runtime/intelligence-platform/skill-registry/errors.mjs";
+import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "../runtime/intelligence-platform/skill-registry/archive.mjs";
+import { resolveRegistryConfig } from "../runtime/intelligence-platform/skill-registry/config.mjs";
+import { validateSnapshot } from "../runtime/intelligence-platform/skill-registry/snapshot.mjs";
+import { SkillRegistry } from "../runtime/intelligence-platform/skill-registry/registry.mjs";
+import { formatSkillCatalog, loadSkill, readSkillFile } from "../runtime/intelligence-platform/skill-registry/skill-content.mjs";
+
+export { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, LearnedSkillsError as SkillDeliveryError, SkillRegistry, formatSkillCatalog, invalidSnapshot, loadSkill, readArchive, readSkillFile, resolveRegistryConfig, safeRelativePath, validateSnapshot };

package/dist/node.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_node_fetch_handler = require('./runtime/endpoints/node-fetch-handler.cjs');
+const require_node = require('./runtime/endpoints/node.cjs');
+
+exports.createCopilotNodeHandler = require_node_fetch_handler.createCopilotNodeHandler;
+exports.createCopilotNodeListener = require_node.createCopilotNodeListener;
+exports.createNodeFetchHandler = require_node_fetch_handler.createNodeFetchHandler;

package/dist/node.d.cts

@@ -0,0 +1,4 @@
+import { NodeFetchHandler, createCopilotNodeHandler, createNodeFetchHandler } from "./runtime/endpoints/node-fetch-handler.cjs";
+import { NodeCopilotListener, NodeCopilotListenerWithChannels, createCopilotNodeListener } from "./runtime/endpoints/node.cjs";
+import "./runtime/node.cjs";
+export { NodeCopilotListener, NodeCopilotListenerWithChannels, NodeFetchHandler, createCopilotNodeHandler, createCopilotNodeListener, createNodeFetchHandler };

package/dist/node.d.mts

@@ -0,0 +1,4 @@
+import { NodeFetchHandler, createCopilotNodeHandler, createNodeFetchHandler } from "./runtime/endpoints/node-fetch-handler.mjs";
+import { NodeCopilotListener, NodeCopilotListenerWithChannels, createCopilotNodeListener } from "./runtime/endpoints/node.mjs";
+import "./runtime/node.mjs";
+export { NodeCopilotListener, NodeCopilotListenerWithChannels, NodeFetchHandler, createCopilotNodeHandler, createCopilotNodeListener, createNodeFetchHandler };

package/dist/node.mjs

@@ -0,0 +1,4 @@
+import { createCopilotNodeHandler, createNodeFetchHandler } from "./runtime/endpoints/node-fetch-handler.mjs";
+import { createCopilotNodeListener } from "./runtime/endpoints/node.mjs";
+
+export { createCopilotNodeHandler, createCopilotNodeListener, createNodeFetchHandler };

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

@@ -0,0 +1,87 @@
+
+//#region src/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
+*   `showToolStatus` optionally overrides managed tool-call visibility.
+* @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.
+*
+* Provider declarations do not belong in this per-Channel config. One managed
+* activation declares every supported managed provider over its single control
+* connection; the Intelligence gateway selects the provider from each trusted
+* prepared delivery.
+*
+* 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.ɵgetChannelsWsUrl();
+	const apiUrl = intelligence.ɵgetApiUrl();
+	const apiKey = intelligence.ɵgetRunnerAuthToken();
+	return {
+		wsUrl,
+		apiUrl,
+		apiKey,
+		projectId: parseProjectIdFromApiKey(apiKey),
+		channelName,
+		...channel.showToolStatus !== void 0 ? { showToolStatus: channel.showToolStatus } : {},
+		...channel.replyContinuation !== void 0 ? { replyContinuation: channel.replyContinuation } : {},
+		runtimeInstanceId
+	};
+}
+
+//#endregion
+exports.ChannelConfigError = ChannelConfigError;
+exports.deriveChannelActivationConfig = deriveChannelActivationConfig;
+//# sourceMappingURL=channel-activation-config.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.cjs","names":[],"sources":["../../../src/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 {\n  Channel,\n  ReplyContinuationOptions,\n} from \"@copilotkit/channels-core\";\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   * Optional per-Channel override for visible managed tool-call progress.\n   * Unset Slack routes default to hidden; other providers retain their existing\n   * default.\n   */\n  showToolStatus?: boolean;\n  /**\n   * Optional per-Channel tuning for splitting a long reply across continuation\n   * messages. Unset leaves the provider renderer's defaults in place.\n   */\n  replyContinuation?: ReplyContinuationOptions;\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 *   `showToolStatus` optionally overrides managed tool-call visibility.\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 * Provider declarations do not belong in this per-Channel config. One managed\n * activation declares every supported managed provider over its single control\n * connection; the Intelligence gateway selects the provider from each trusted\n * prepared delivery.\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.ɵgetChannelsWsUrl();\n  const apiUrl = intelligence.ɵgetApiUrl();\n  const apiKey = intelligence.ɵgetRunnerAuthToken();\n  const projectId = parseProjectIdFromApiKey(apiKey);\n\n  return {\n    wsUrl,\n    apiUrl,\n    apiKey,\n    projectId,\n    channelName,\n    ...(channel.showToolStatus !== undefined\n      ? { showToolStatus: channel.showToolStatus }\n      : {}),\n    ...(channel.replyContinuation !== undefined\n      ? { replyContinuation: channel.replyContinuation }\n      : {}),\n    runtimeInstanceId,\n  };\n}\n"],"mappings":";;;;;;;AAaA,IAAa,qBAAb,cAAwC,MAAM;CAC5C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;AAsChB,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCT,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,mBAAmB;CAC9C,MAAM,SAAS,aAAa,YAAY;CACxC,MAAM,SAAS,aAAa,qBAAqB;AAGjD,QAAO;EACL;EACA;EACA;EACA,WANgB,yBAAyB,OAAO;EAOhD;EACA,GAAI,QAAQ,mBAAmB,SAC3B,EAAE,gBAAgB,QAAQ,gBAAgB,GAC1C,EAAE;EACN,GAAI,QAAQ,sBAAsB,SAC9B,EAAE,mBAAmB,QAAQ,mBAAmB,GAChD,EAAE;EACN;EACD"}

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

@@ -0,0 +1,39 @@
+import "../intelligence-platform/index.cjs";
+import { Channel, ReplyContinuationOptions } from "@copilotkit/channels-core";
+
+//#region src/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;
+  /**
+   * Optional per-Channel override for visible managed tool-call progress.
+   * Unset Slack routes default to hidden; other providers retain their existing
+   * default.
+   */
+  showToolStatus?: boolean;
+  /**
+   * Optional per-Channel tuning for splitting a long reply across continuation
+   * messages. Unset leaves the provider renderer's defaults in place.
+   */
+  replyContinuation?: ReplyContinuationOptions;
+  /** Identifier for the runtime instance activating this Channel. */
+  runtimeInstanceId: string;
+}
+//#endregion
+export { ChannelActivationConfig };
+//# sourceMappingURL=channel-activation-config.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.d.cts","names":[],"sources":["../../../src/runtime/core/channel-activation-config.ts"],"mappings":";;;;;;;;UAwBiB,uBAAA;EAwBK;EAtBpB,KAAA;EAwBiB;EAtBjB,MAAA;;;;;EAKA,MAAA;;EAEA,SAAA;;EAEA,WAAA;;;;;;EAMA,cAAA;;;;;EAKA,iBAAA,GAAoB,wBAAA;;EAEpB,iBAAA;AAAA"}

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

@@ -0,0 +1,39 @@
+import "../intelligence-platform/index.mjs";
+import { Channel, ReplyContinuationOptions } from "@copilotkit/channels-core";
+
+//#region src/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;
+  /**
+   * Optional per-Channel override for visible managed tool-call progress.
+   * Unset Slack routes default to hidden; other providers retain their existing
+   * default.
+   */
+  showToolStatus?: boolean;
+  /**
+   * Optional per-Channel tuning for splitting a long reply across continuation
+   * messages. Unset leaves the provider renderer's defaults in place.
+   */
+  replyContinuation?: ReplyContinuationOptions;
+  /** Identifier for the runtime instance activating this Channel. */
+  runtimeInstanceId: string;
+}
+//#endregion
+export { ChannelActivationConfig };
+//# sourceMappingURL=channel-activation-config.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.d.mts","names":[],"sources":["../../../src/runtime/core/channel-activation-config.ts"],"mappings":";;;;;;;;UAwBiB,uBAAA;EAwBK;EAtBpB,KAAA;EAwBiB;EAtBjB,MAAA;;;;;EAKA,MAAA;;EAEA,SAAA;;EAEA,WAAA;;;;;;EAMA,cAAA;;;;;EAKA,iBAAA,GAAoB,wBAAA;;EAEpB,iBAAA;AAAA"}

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

@@ -0,0 +1,85 @@
+//#region src/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
+*   `showToolStatus` optionally overrides managed tool-call visibility.
+* @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.
+*
+* Provider declarations do not belong in this per-Channel config. One managed
+* activation declares every supported managed provider over its single control
+* connection; the Intelligence gateway selects the provider from each trusted
+* prepared delivery.
+*
+* 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.ɵgetChannelsWsUrl();
+	const apiUrl = intelligence.ɵgetApiUrl();
+	const apiKey = intelligence.ɵgetRunnerAuthToken();
+	return {
+		wsUrl,
+		apiUrl,
+		apiKey,
+		projectId: parseProjectIdFromApiKey(apiKey),
+		channelName,
+		...channel.showToolStatus !== void 0 ? { showToolStatus: channel.showToolStatus } : {},
+		...channel.replyContinuation !== void 0 ? { replyContinuation: channel.replyContinuation } : {},
+		runtimeInstanceId
+	};
+}
+
+//#endregion
+export { ChannelConfigError, deriveChannelActivationConfig };
+//# sourceMappingURL=channel-activation-config.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-activation-config.mjs","names":[],"sources":["../../../src/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 {\n  Channel,\n  ReplyContinuationOptions,\n} from \"@copilotkit/channels-core\";\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   * Optional per-Channel override for visible managed tool-call progress.\n   * Unset Slack routes default to hidden; other providers retain their existing\n   * default.\n   */\n  showToolStatus?: boolean;\n  /**\n   * Optional per-Channel tuning for splitting a long reply across continuation\n   * messages. Unset leaves the provider renderer's defaults in place.\n   */\n  replyContinuation?: ReplyContinuationOptions;\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 *   `showToolStatus` optionally overrides managed tool-call visibility.\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 * Provider declarations do not belong in this per-Channel config. One managed\n * activation declares every supported managed provider over its single control\n * connection; the Intelligence gateway selects the provider from each trusted\n * prepared delivery.\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.ɵgetChannelsWsUrl();\n  const apiUrl = intelligence.ɵgetApiUrl();\n  const apiKey = intelligence.ɵgetRunnerAuthToken();\n  const projectId = parseProjectIdFromApiKey(apiKey);\n\n  return {\n    wsUrl,\n    apiUrl,\n    apiKey,\n    projectId,\n    channelName,\n    ...(channel.showToolStatus !== undefined\n      ? { showToolStatus: channel.showToolStatus }\n      : {}),\n    ...(channel.replyContinuation !== undefined\n      ? { replyContinuation: channel.replyContinuation }\n      : {}),\n    runtimeInstanceId,\n  };\n}\n"],"mappings":";;;;;;AAaA,IAAa,qBAAb,cAAwC,MAAM;CAC5C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;AAsChB,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCT,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,mBAAmB;CAC9C,MAAM,SAAS,aAAa,YAAY;CACxC,MAAM,SAAS,aAAa,qBAAqB;AAGjD,QAAO;EACL;EACA;EACA;EACA,WANgB,yBAAyB,OAAO;EAOhD;EACA,GAAI,QAAQ,mBAAmB,SAC3B,EAAE,gBAAgB,QAAQ,gBAAgB,GAC1C,EAAE;EACN,GAAI,QAAQ,sBAAsB,SAC9B,EAAE,mBAAmB,QAAQ,mBAAmB,GAChD,EAAE;EACN;EACD"}