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

package/dist/runtime/core/hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.mjs","names":[],"sources":["../../../src/runtime/core/hooks.ts"],"sourcesContent":["/**\n * Lifecycle hooks for CopilotKit runtime request processing.\n *\n * Hooks let you intercept requests at various stages of the pipeline:\n * - `onRequest`: Before routing — auth, correlation IDs, header injection\n * - `onBeforeHandler`: After routing — route-specific authorization\n * - `onResponse`: After handler — add headers, log, set cookies\n * - `onError`: On error — custom error responses\n *\n * @example\n * ```typescript\n * const handler = createCopilotRuntimeHandler({\n *   runtime,\n *   hooks: {\n *     onRequest: async ({ request }) => {\n *       const token = request.headers.get(\"authorization\");\n *       if (!token) throw new Response(\"Unauthorized\", { status: 401 });\n *     },\n *     onResponse: async ({ response }) => {\n *       const headers = new Headers(response.headers);\n *       headers.set(\"x-copilot-version\", \"2.0\");\n *       return new Response(response.body, { ...response, headers });\n *     },\n *   },\n * });\n * ```\n */\n\nimport type { MaybePromise } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"./runtime\";\n\n/* ------------------------------------------------------------------------------------------------\n * Route info\n * --------------------------------------------------------------------------------------------- */\n\nexport type RouteInfo =\n  | { method: \"agent/run\"; agentId: string }\n  | { method: \"agent/suggest\"; agentId: string }\n  | { method: \"agent/connect\"; agentId: string }\n  | { method: \"trajectory/connect\"; trajectoryId: string }\n  | { method: \"agent/stop\"; agentId: string; threadId: string }\n  | { method: \"info\" }\n  | { method: \"inspector/metadata\" }\n  | { method: \"inspector/learning\" }\n  | { method: \"transcribe\" }\n  | { method: \"threads/list\" }\n  | { method: \"threads/subscribe\" }\n  | { method: \"threads/update\"; threadId: string }\n  | { method: \"threads/archive\"; threadId: string }\n  | { method: \"threads/messages\"; threadId: string }\n  | { method: \"threads/events\"; threadId: string }\n  | { method: \"threads/state\"; threadId: string }\n  | { method: \"threads/clear\" }\n  | { method: \"memories/list\" }\n  | { method: \"memories/recall\" }\n  | { method: \"memories/subscribe\" }\n  | { method: \"memories/mutate\"; memoryId: string }\n  | { method: \"annotate\" }\n  | { method: \"cpk-debug-events\" };\n\n/* ------------------------------------------------------------------------------------------------\n * Hook contexts\n * --------------------------------------------------------------------------------------------- */\n\nexport interface HookContext {\n  /** The incoming Fetch Request (possibly modified by prior hooks). */\n  request: Request;\n  /** The resolved URL pathname. */\n  path: string;\n  /** The CopilotRuntimeLike instance. */\n  runtime: CopilotRuntimeLike;\n}\n\nexport interface HandlerHookContext extends HookContext {\n  /** The resolved route information. */\n  route: RouteInfo;\n}\n\nexport interface ResponseHookContext extends HookContext {\n  /** The Response produced by the handler. */\n  response: Response;\n  /** The resolved route information. */\n  route: RouteInfo;\n}\n\nexport interface ErrorHookContext extends HookContext {\n  /** The error that occurred. */\n  error: unknown;\n  /** The route info, if routing had already succeeded. */\n  route?: RouteInfo;\n}\n\n/* ------------------------------------------------------------------------------------------------\n * Hooks interface\n * --------------------------------------------------------------------------------------------- */\n\nexport interface CopilotRuntimeHooks {\n  /**\n   * Called at the start of every request, before routing.\n   * Use to validate auth, attach headers, initialize correlation IDs, etc.\n   *\n   * Return a modified Request to replace the original, or void to continue.\n   * Throw a Response to short-circuit with an early response.\n   */\n  onRequest?: (ctx: HookContext) => MaybePromise<Request | void>;\n\n  /**\n   * Called after routing is resolved but before the handler executes.\n   * Receives the resolved route info (method, agentId, threadId).\n   *\n   * Use to do route-specific authorization, attach headers for agent calls, etc.\n   * Return a modified Request or void.\n   * Throw a Response to short-circuit.\n   */\n  onBeforeHandler?: (ctx: HandlerHookContext) => MaybePromise<Request | void>;\n\n  /**\n   * Called after the handler produces a Response, before it's sent to the client.\n   * Use to set cookies, add debugging headers, log, etc.\n   *\n   * Return a modified Response to replace the original, or void.\n   */\n  onResponse?: (ctx: ResponseHookContext) => MaybePromise<Response | void>;\n\n  /**\n   * Called when an error occurs during request processing.\n   * Return a Response to override the default error response, or void to use the default.\n   */\n  onError?: (ctx: ErrorHookContext) => MaybePromise<Response | void>;\n}\n\n/* ------------------------------------------------------------------------------------------------\n * Internal hook runners\n * --------------------------------------------------------------------------------------------- */\n\nexport async function runOnRequest(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: HookContext,\n): Promise<Request> {\n  if (!hooks?.onRequest) return ctx.request;\n  const result = await hooks.onRequest(ctx);\n  return result instanceof Request ? result : ctx.request;\n}\n\nexport async function runOnBeforeHandler(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: HandlerHookContext,\n): Promise<Request> {\n  if (!hooks?.onBeforeHandler) return ctx.request;\n  const result = await hooks.onBeforeHandler(ctx);\n  return result instanceof Request ? result : ctx.request;\n}\n\nexport async function runOnResponse(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: ResponseHookContext,\n): Promise<Response> {\n  if (!hooks?.onResponse) return ctx.response;\n  const result = await hooks.onResponse(ctx);\n  return result instanceof Response ? result : ctx.response;\n}\n\nexport async function runOnError(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: ErrorHookContext,\n): Promise<Response | void> {\n  if (!hooks?.onError) return;\n  return hooks.onError(ctx);\n}\n"],"mappings":";AAuIA,eAAsB,aACpB,OACA,KACkB;AAClB,KAAI,CAAC,OAAO,UAAW,QAAO,IAAI;CAClC,MAAM,SAAS,MAAM,MAAM,UAAU,IAAI;AACzC,QAAO,kBAAkB,UAAU,SAAS,IAAI;;AAGlD,eAAsB,mBACpB,OACA,KACkB;AAClB,KAAI,CAAC,OAAO,gBAAiB,QAAO,IAAI;CACxC,MAAM,SAAS,MAAM,MAAM,gBAAgB,IAAI;AAC/C,QAAO,kBAAkB,UAAU,SAAS,IAAI;;AAGlD,eAAsB,cACpB,OACA,KACmB;AACnB,KAAI,CAAC,OAAO,WAAY,QAAO,IAAI;CACnC,MAAM,SAAS,MAAM,MAAM,WAAW,IAAI;AAC1C,QAAO,kBAAkB,WAAW,SAAS,IAAI;;AAGnD,eAAsB,WACpB,OACA,KAC0B;AAC1B,KAAI,CAAC,OAAO,QAAS;AACrB,QAAO,MAAM,QAAQ,IAAI"}

package/dist/runtime/core/learning.cjs

@@ -0,0 +1,61 @@
+
+//#region src/runtime/core/learning.ts
+/** Checks configuration without invoking a selector that requires a real run. */
+function hasLearningContainerConfiguration(runtime) {
+	return runtime.intelligence?.ɵgetLearningContainerId?.() !== void 0 || runtime.learning?.containerId !== void 0;
+}
+/** Resolves bounded, validated Space IDs selected by application server code. */
+async function resolveTrajectoryLearningContainerIds(selector, input, signal) {
+	signal?.throwIfAborted();
+	if (!selector) return void 0;
+	const controller = new AbortController();
+	const onAbort = () => controller.abort(signal?.reason);
+	signal?.addEventListener("abort", onAbort, { once: true });
+	const timeout = setTimeout(() => controller.abort(/* @__PURE__ */ new Error("Trajectory Learning Container selection timed out")), 5e3);
+	let onCancelled;
+	try {
+		const cancelled = new Promise((_resolve, reject) => {
+			onCancelled = () => reject(controller.signal.reason);
+			controller.signal.addEventListener("abort", onCancelled, { once: true });
+		});
+		const selection = new Promise((resolve) => {
+			resolve(selector(input, controller.signal));
+		});
+		const value = await Promise.race([selection, cancelled]);
+		controller.signal.throwIfAborted();
+		if (value == null) return void 0;
+		if (!Array.isArray(value) || value.length > 100) throw new Error("Trajectory Learning Container selection must be an array of at most 100 IDs");
+		return [...new Set(Array.from(value, assertStableLearningContainerId))];
+	} finally {
+		clearTimeout(timeout);
+		signal?.removeEventListener("abort", onAbort);
+		if (onCancelled) controller.signal.removeEventListener("abort", onCancelled);
+	}
+}
+const STABLE_CONTAINER_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Validates and returns a stable Learning Container ID. */
+function assertStableLearningContainerId(value) {
+	if (typeof value !== "string" || value.length < 1 || value.length > 64 || !STABLE_CONTAINER_ID.test(value)) throw new Error("Learning Container must use a 1-64 character stable ID with lowercase letters, numbers, and single hyphens");
+	return value;
+}
+/** Resolves and validates a public Intelligence Learning Container selection. */
+async function resolveLearningContainerSelector(selector, input) {
+	const value = await selector(input);
+	if (value == null) return void 0;
+	return assertStableLearningContainerId(value);
+}
+/** Resolves the configured Container once for one web or Channel run. */
+async function resolveLearningContainerId(config, input) {
+	if (config === void 0) return void 0;
+	const value = typeof config.containerId === "function" ? await config.containerId(input) : config.containerId;
+	if (value == null) return void 0;
+	return assertStableLearningContainerId(value);
+}
+
+//#endregion
+exports.assertStableLearningContainerId = assertStableLearningContainerId;
+exports.hasLearningContainerConfiguration = hasLearningContainerConfiguration;
+exports.resolveLearningContainerId = resolveLearningContainerId;
+exports.resolveLearningContainerSelector = resolveLearningContainerSelector;
+exports.resolveTrajectoryLearningContainerIds = resolveTrajectoryLearningContainerIds;
+//# sourceMappingURL=learning.cjs.map

package/dist/runtime/core/learning.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.cjs","names":[],"sources":["../../../src/runtime/core/learning.ts"],"sourcesContent":["import type { RunAgentInput } from \"@ag-ui/client\";\nimport type { MaybePromise } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"./runtime\";\n\n/** Checks configuration without invoking a selector that requires a real run. */\nexport function hasLearningContainerConfiguration(\n  runtime: CopilotRuntimeLike,\n): boolean {\n  return (\n    runtime.intelligence?.ɵgetLearningContainerId?.() !== undefined ||\n    runtime.learning?.containerId !== undefined\n  );\n}\n\n/** Application user resolved by an Intelligence runtime. */\nexport interface CopilotRuntimeUser {\n  readonly id: string;\n  readonly name: string;\n}\n\n/** Context for choosing a Learning Container through the public Intelligence SDK. */\nexport type LearningContainerSelectorInput =\n  | {\n      readonly surface: \"web\";\n      readonly user: CopilotRuntimeUser;\n      readonly agentId: string;\n      readonly input: Readonly<RunAgentInput>;\n    }\n  | {\n      readonly surface: \"channel\";\n      readonly user: CopilotRuntimeUser | null;\n      readonly agentId: string;\n      readonly input: Readonly<RunAgentInput>;\n    };\n\n/** Chooses one developer-created Learning Container for an Intelligence run. */\nexport type GetLearningContainerId = (\n  input: LearningContainerSelectorInput,\n) => MaybePromise<string | null | undefined>;\n\n/**\n * Context for assigning browser activity to Learning Spaces. The Runtime\n * verifies `user`; the browser chooses `trajectoryId`, which is only checked\n * to be a UUID.\n */\nexport interface TrajectoryLearningContainerSelectorInput {\n  readonly trajectoryId: string;\n  readonly user: CopilotRuntimeUser;\n}\n\n/**\n * Selects existing Learning Spaces without requiring an agent run or Thread.\n * The optional signal cancels on request abort or the five-second deadline.\n */\nexport type GetTrajectoryLearningContainerIds = (\n  input: TrajectoryLearningContainerSelectorInput,\n  signal?: AbortSignal,\n) => MaybePromise<readonly string[] | null | undefined>;\n\n/** Resolves bounded, validated Space IDs selected by application server code. */\nexport async function resolveTrajectoryLearningContainerIds(\n  selector: GetTrajectoryLearningContainerIds | undefined,\n  input: TrajectoryLearningContainerSelectorInput,\n  signal?: AbortSignal,\n): Promise<readonly string[] | undefined> {\n  signal?.throwIfAborted();\n  if (!selector) return undefined;\n  const controller = new AbortController();\n  const onAbort = () => controller.abort(signal?.reason);\n  signal?.addEventListener(\"abort\", onAbort, { once: true });\n  const timeout = setTimeout(\n    () =>\n      controller.abort(\n        new Error(\"Trajectory Learning Container selection timed out\"),\n      ),\n    5_000,\n  );\n  let onCancelled: (() => void) | undefined;\n  try {\n    const cancelled = new Promise<never>((_resolve, reject) => {\n      onCancelled = () => reject(controller.signal.reason);\n      controller.signal.addEventListener(\"abort\", onCancelled, { once: true });\n    });\n    const selection = new Promise<readonly string[] | null | undefined>(\n      (resolve) => {\n        resolve(selector(input, controller.signal));\n      },\n    );\n    const value = await Promise.race([selection, cancelled]);\n    controller.signal.throwIfAborted();\n    if (value == null) return undefined;\n    if (!Array.isArray(value) || value.length > 100) {\n      throw new Error(\n        \"Trajectory Learning Container selection must be an array of at most 100 IDs\",\n      );\n    }\n    // Array.from visits holes in sparse arrays, so they fail validation.\n    return [...new Set(Array.from(value, assertStableLearningContainerId))];\n  } finally {\n    clearTimeout(timeout);\n    signal?.removeEventListener(\"abort\", onAbort);\n    if (onCancelled)\n      controller.signal.removeEventListener(\"abort\", onCancelled);\n  }\n}\n\n/** Context for choosing one Learning Container for an Intelligence run. */\nexport type CopilotRuntimeLearningContext =\n  | {\n      readonly surface: \"web\";\n      readonly request: Request;\n      readonly threadId: string;\n      readonly runId: string;\n      readonly agentId: string;\n      readonly userId: string;\n    }\n  | {\n      readonly surface: \"channel\";\n      readonly threadId: string;\n      readonly runId: string;\n      readonly agentId: string;\n      readonly userId: string;\n      readonly deliveryId: string;\n    };\n\n/** Assigns each Intelligence Thread to one developer-created Learning Container. */\nexport interface CopilotRuntimeLearningConfig {\n  readonly containerId:\n    | string\n    | ((\n        input: CopilotRuntimeLearningContext,\n      ) => MaybePromise<string | null | undefined>);\n}\n\nconst STABLE_CONTAINER_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\n/** Validates and returns a stable Learning Container ID. */\nexport function assertStableLearningContainerId(value: unknown): string {\n  if (\n    typeof value !== \"string\" ||\n    value.length < 1 ||\n    value.length > 64 ||\n    !STABLE_CONTAINER_ID.test(value)\n  ) {\n    throw new Error(\n      \"Learning Container must use a 1-64 character stable ID with lowercase letters, numbers, and single hyphens\",\n    );\n  }\n  return value;\n}\n\n/** Resolves and validates a public Intelligence Learning Container selection. */\nexport async function resolveLearningContainerSelector(\n  selector: GetLearningContainerId,\n  input: LearningContainerSelectorInput,\n): Promise<string | undefined> {\n  const value = await selector(input);\n  if (value == null) return undefined;\n  return assertStableLearningContainerId(value);\n}\n\n/** Resolves the configured Container once for one web or Channel run. */\nexport async function resolveLearningContainerId(\n  config: CopilotRuntimeLearningConfig | undefined,\n  input: CopilotRuntimeLearningContext,\n): Promise<string | undefined> {\n  if (config === undefined) return undefined;\n  const value =\n    typeof config.containerId === \"function\"\n      ? await config.containerId(input)\n      : config.containerId;\n  if (value == null) return undefined;\n  return assertStableLearningContainerId(value);\n}\n"],"mappings":";;;AAKA,SAAgB,kCACd,SACS;AACT,QACE,QAAQ,cAAc,2BAA2B,KAAK,UACtD,QAAQ,UAAU,gBAAgB;;;AAkDtC,eAAsB,sCACpB,UACA,OACA,QACwC;AACxC,SAAQ,gBAAgB;AACxB,KAAI,CAAC,SAAU,QAAO;CACtB,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,gBAAgB,WAAW,MAAM,QAAQ,OAAO;AACtD,SAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;CAC1D,MAAM,UAAU,iBAEZ,WAAW,sBACT,IAAI,MAAM,oDAAoD,CAC/D,EACH,IACD;CACD,IAAI;AACJ,KAAI;EACF,MAAM,YAAY,IAAI,SAAgB,UAAU,WAAW;AACzD,uBAAoB,OAAO,WAAW,OAAO,OAAO;AACpD,cAAW,OAAO,iBAAiB,SAAS,aAAa,EAAE,MAAM,MAAM,CAAC;IACxE;EACF,MAAM,YAAY,IAAI,SACnB,YAAY;AACX,WAAQ,SAAS,OAAO,WAAW,OAAO,CAAC;IAE9C;EACD,MAAM,QAAQ,MAAM,QAAQ,KAAK,CAAC,WAAW,UAAU,CAAC;AACxD,aAAW,OAAO,gBAAgB;AAClC,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,MAAM,SAAS,IAC1C,OAAM,IAAI,MACR,8EACD;AAGH,SAAO,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,gCAAgC,CAAC,CAAC;WAC/D;AACR,eAAa,QAAQ;AACrB,UAAQ,oBAAoB,SAAS,QAAQ;AAC7C,MAAI,YACF,YAAW,OAAO,oBAAoB,SAAS,YAAY;;;AAgCjE,MAAM,sBAAsB;;AAG5B,SAAgB,gCAAgC,OAAwB;AACtE,KACE,OAAO,UAAU,YACjB,MAAM,SAAS,KACf,MAAM,SAAS,MACf,CAAC,oBAAoB,KAAK,MAAM,CAEhC,OAAM,IAAI,MACR,6GACD;AAEH,QAAO;;;AAIT,eAAsB,iCACpB,UACA,OAC6B;CAC7B,MAAM,QAAQ,MAAM,SAAS,MAAM;AACnC,KAAI,SAAS,KAAM,QAAO;AAC1B,QAAO,gCAAgC,MAAM;;;AAI/C,eAAsB,2BACpB,QACA,OAC6B;AAC7B,KAAI,WAAW,OAAW,QAAO;CACjC,MAAM,QACJ,OAAO,OAAO,gBAAgB,aAC1B,MAAM,OAAO,YAAY,MAAM,GAC/B,OAAO;AACb,KAAI,SAAS,KAAM,QAAO;AAC1B,QAAO,gCAAgC,MAAM"}

package/dist/runtime/core/learning.d.cts

@@ -0,0 +1,61 @@
+import "./runtime.cjs";
+import { MaybePromise } from "@copilotkit/shared";
+import { RunAgentInput } from "@ag-ui/client";
+
+//#region src/runtime/core/learning.d.ts
+/** Application user resolved by an Intelligence runtime. */
+interface CopilotRuntimeUser {
+  readonly id: string;
+  readonly name: string;
+}
+/** Context for choosing a Learning Container through the public Intelligence SDK. */
+type LearningContainerSelectorInput = {
+  readonly surface: "web";
+  readonly user: CopilotRuntimeUser;
+  readonly agentId: string;
+  readonly input: Readonly<RunAgentInput>;
+} | {
+  readonly surface: "channel";
+  readonly user: CopilotRuntimeUser | null;
+  readonly agentId: string;
+  readonly input: Readonly<RunAgentInput>;
+};
+/** Chooses one developer-created Learning Container for an Intelligence run. */
+type GetLearningContainerId = (input: LearningContainerSelectorInput) => MaybePromise<string | null | undefined>;
+/**
+ * Context for assigning browser activity to Learning Spaces. The Runtime
+ * verifies `user`; the browser chooses `trajectoryId`, which is only checked
+ * to be a UUID.
+ */
+interface TrajectoryLearningContainerSelectorInput {
+  readonly trajectoryId: string;
+  readonly user: CopilotRuntimeUser;
+}
+/**
+ * Selects existing Learning Spaces without requiring an agent run or Thread.
+ * The optional signal cancels on request abort or the five-second deadline.
+ */
+type GetTrajectoryLearningContainerIds = (input: TrajectoryLearningContainerSelectorInput, signal?: AbortSignal) => MaybePromise<readonly string[] | null | undefined>;
+/** Context for choosing one Learning Container for an Intelligence run. */
+type CopilotRuntimeLearningContext = {
+  readonly surface: "web";
+  readonly request: Request;
+  readonly threadId: string;
+  readonly runId: string;
+  readonly agentId: string;
+  readonly userId: string;
+} | {
+  readonly surface: "channel";
+  readonly threadId: string;
+  readonly runId: string;
+  readonly agentId: string;
+  readonly userId: string;
+  readonly deliveryId: string;
+};
+/** Assigns each Intelligence Thread to one developer-created Learning Container. */
+interface CopilotRuntimeLearningConfig {
+  readonly containerId: string | ((input: CopilotRuntimeLearningContext) => MaybePromise<string | null | undefined>);
+}
+//#endregion
+export { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, GetTrajectoryLearningContainerIds, LearningContainerSelectorInput, TrajectoryLearningContainerSelectorInput };
+//# sourceMappingURL=learning.d.cts.map

package/dist/runtime/core/learning.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.d.cts","names":[],"sources":["../../../src/runtime/core/learning.ts"],"mappings":";;;;;AAeA;AAAA,UAAiB,kBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;AAAA;AAIX;AAAA,KAAY,8BAAA;EAAA,SAEG,OAAA;EAAA,SACA,IAAA,EAAM,kBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA,EAAO,QAAA,CAAS,aAAA;AAAA;EAAA,SAGhB,OAAA;EAAA,SACA,IAAA,EAAM,kBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA,EAAO,QAAA,CAAS,aAAA;AAAA;;KAInB,sBAAA,IACV,KAAA,EAAO,8BAAA,KACJ,YAAA;;;;;;UAOY,wCAAA;EAAA,SACN,YAAA;EAAA,SACA,IAAA,EAAM,kBAAA;AAAA;;;;;KAOL,iCAAA,IACV,KAAA,EAAO,wCAAA,EACP,MAAA,GAAS,WAAA,KACN,YAAA;;KAkDO,6BAAA;EAAA,SAEG,OAAA;EAAA,SACA,OAAA,EAAS,OAAA;EAAA,SACT,QAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA;AAAA;EAAA,SAGA,OAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA;EAAA,SACA,UAAA;AAAA;;UAIE,4BAAA;EAAA,SACN,WAAA,aAGH,KAAA,EAAO,6BAAA,KACJ,YAAA;AAAA"}

package/dist/runtime/core/learning.d.mts

@@ -0,0 +1,61 @@
+import "./runtime.mjs";
+import { MaybePromise } from "@copilotkit/shared";
+import { RunAgentInput } from "@ag-ui/client";
+
+//#region src/runtime/core/learning.d.ts
+/** Application user resolved by an Intelligence runtime. */
+interface CopilotRuntimeUser {
+  readonly id: string;
+  readonly name: string;
+}
+/** Context for choosing a Learning Container through the public Intelligence SDK. */
+type LearningContainerSelectorInput = {
+  readonly surface: "web";
+  readonly user: CopilotRuntimeUser;
+  readonly agentId: string;
+  readonly input: Readonly<RunAgentInput>;
+} | {
+  readonly surface: "channel";
+  readonly user: CopilotRuntimeUser | null;
+  readonly agentId: string;
+  readonly input: Readonly<RunAgentInput>;
+};
+/** Chooses one developer-created Learning Container for an Intelligence run. */
+type GetLearningContainerId = (input: LearningContainerSelectorInput) => MaybePromise<string | null | undefined>;
+/**
+ * Context for assigning browser activity to Learning Spaces. The Runtime
+ * verifies `user`; the browser chooses `trajectoryId`, which is only checked
+ * to be a UUID.
+ */
+interface TrajectoryLearningContainerSelectorInput {
+  readonly trajectoryId: string;
+  readonly user: CopilotRuntimeUser;
+}
+/**
+ * Selects existing Learning Spaces without requiring an agent run or Thread.
+ * The optional signal cancels on request abort or the five-second deadline.
+ */
+type GetTrajectoryLearningContainerIds = (input: TrajectoryLearningContainerSelectorInput, signal?: AbortSignal) => MaybePromise<readonly string[] | null | undefined>;
+/** Context for choosing one Learning Container for an Intelligence run. */
+type CopilotRuntimeLearningContext = {
+  readonly surface: "web";
+  readonly request: Request;
+  readonly threadId: string;
+  readonly runId: string;
+  readonly agentId: string;
+  readonly userId: string;
+} | {
+  readonly surface: "channel";
+  readonly threadId: string;
+  readonly runId: string;
+  readonly agentId: string;
+  readonly userId: string;
+  readonly deliveryId: string;
+};
+/** Assigns each Intelligence Thread to one developer-created Learning Container. */
+interface CopilotRuntimeLearningConfig {
+  readonly containerId: string | ((input: CopilotRuntimeLearningContext) => MaybePromise<string | null | undefined>);
+}
+//#endregion
+export { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, GetTrajectoryLearningContainerIds, LearningContainerSelectorInput, TrajectoryLearningContainerSelectorInput };
+//# sourceMappingURL=learning.d.mts.map

package/dist/runtime/core/learning.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.d.mts","names":[],"sources":["../../../src/runtime/core/learning.ts"],"mappings":";;;;;AAeA;AAAA,UAAiB,kBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;AAAA;AAIX;AAAA,KAAY,8BAAA;EAAA,SAEG,OAAA;EAAA,SACA,IAAA,EAAM,kBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA,EAAO,QAAA,CAAS,aAAA;AAAA;EAAA,SAGhB,OAAA;EAAA,SACA,IAAA,EAAM,kBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA,EAAO,QAAA,CAAS,aAAA;AAAA;;KAInB,sBAAA,IACV,KAAA,EAAO,8BAAA,KACJ,YAAA;;;;;;UAOY,wCAAA;EAAA,SACN,YAAA;EAAA,SACA,IAAA,EAAM,kBAAA;AAAA;;;;;KAOL,iCAAA,IACV,KAAA,EAAO,wCAAA,EACP,MAAA,GAAS,WAAA,KACN,YAAA;;KAkDO,6BAAA;EAAA,SAEG,OAAA;EAAA,SACA,OAAA,EAAS,OAAA;EAAA,SACT,QAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA;AAAA;EAAA,SAGA,OAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA;EAAA,SACA,UAAA;AAAA;;UAIE,4BAAA;EAAA,SACN,WAAA,aAGH,KAAA,EAAO,6BAAA,KACJ,YAAA;AAAA"}

package/dist/runtime/core/learning.mjs

@@ -0,0 +1,56 @@
+//#region src/runtime/core/learning.ts
+/** Checks configuration without invoking a selector that requires a real run. */
+function hasLearningContainerConfiguration(runtime) {
+	return runtime.intelligence?.ɵgetLearningContainerId?.() !== void 0 || runtime.learning?.containerId !== void 0;
+}
+/** Resolves bounded, validated Space IDs selected by application server code. */
+async function resolveTrajectoryLearningContainerIds(selector, input, signal) {
+	signal?.throwIfAborted();
+	if (!selector) return void 0;
+	const controller = new AbortController();
+	const onAbort = () => controller.abort(signal?.reason);
+	signal?.addEventListener("abort", onAbort, { once: true });
+	const timeout = setTimeout(() => controller.abort(/* @__PURE__ */ new Error("Trajectory Learning Container selection timed out")), 5e3);
+	let onCancelled;
+	try {
+		const cancelled = new Promise((_resolve, reject) => {
+			onCancelled = () => reject(controller.signal.reason);
+			controller.signal.addEventListener("abort", onCancelled, { once: true });
+		});
+		const selection = new Promise((resolve) => {
+			resolve(selector(input, controller.signal));
+		});
+		const value = await Promise.race([selection, cancelled]);
+		controller.signal.throwIfAborted();
+		if (value == null) return void 0;
+		if (!Array.isArray(value) || value.length > 100) throw new Error("Trajectory Learning Container selection must be an array of at most 100 IDs");
+		return [...new Set(Array.from(value, assertStableLearningContainerId))];
+	} finally {
+		clearTimeout(timeout);
+		signal?.removeEventListener("abort", onAbort);
+		if (onCancelled) controller.signal.removeEventListener("abort", onCancelled);
+	}
+}
+const STABLE_CONTAINER_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Validates and returns a stable Learning Container ID. */
+function assertStableLearningContainerId(value) {
+	if (typeof value !== "string" || value.length < 1 || value.length > 64 || !STABLE_CONTAINER_ID.test(value)) throw new Error("Learning Container must use a 1-64 character stable ID with lowercase letters, numbers, and single hyphens");
+	return value;
+}
+/** Resolves and validates a public Intelligence Learning Container selection. */
+async function resolveLearningContainerSelector(selector, input) {
+	const value = await selector(input);
+	if (value == null) return void 0;
+	return assertStableLearningContainerId(value);
+}
+/** Resolves the configured Container once for one web or Channel run. */
+async function resolveLearningContainerId(config, input) {
+	if (config === void 0) return void 0;
+	const value = typeof config.containerId === "function" ? await config.containerId(input) : config.containerId;
+	if (value == null) return void 0;
+	return assertStableLearningContainerId(value);
+}
+
+//#endregion
+export { assertStableLearningContainerId, hasLearningContainerConfiguration, resolveLearningContainerId, resolveLearningContainerSelector, resolveTrajectoryLearningContainerIds };
+//# sourceMappingURL=learning.mjs.map

package/dist/runtime/core/learning.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.mjs","names":[],"sources":["../../../src/runtime/core/learning.ts"],"sourcesContent":["import type { RunAgentInput } from \"@ag-ui/client\";\nimport type { MaybePromise } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"./runtime\";\n\n/** Checks configuration without invoking a selector that requires a real run. */\nexport function hasLearningContainerConfiguration(\n  runtime: CopilotRuntimeLike,\n): boolean {\n  return (\n    runtime.intelligence?.ɵgetLearningContainerId?.() !== undefined ||\n    runtime.learning?.containerId !== undefined\n  );\n}\n\n/** Application user resolved by an Intelligence runtime. */\nexport interface CopilotRuntimeUser {\n  readonly id: string;\n  readonly name: string;\n}\n\n/** Context for choosing a Learning Container through the public Intelligence SDK. */\nexport type LearningContainerSelectorInput =\n  | {\n      readonly surface: \"web\";\n      readonly user: CopilotRuntimeUser;\n      readonly agentId: string;\n      readonly input: Readonly<RunAgentInput>;\n    }\n  | {\n      readonly surface: \"channel\";\n      readonly user: CopilotRuntimeUser | null;\n      readonly agentId: string;\n      readonly input: Readonly<RunAgentInput>;\n    };\n\n/** Chooses one developer-created Learning Container for an Intelligence run. */\nexport type GetLearningContainerId = (\n  input: LearningContainerSelectorInput,\n) => MaybePromise<string | null | undefined>;\n\n/**\n * Context for assigning browser activity to Learning Spaces. The Runtime\n * verifies `user`; the browser chooses `trajectoryId`, which is only checked\n * to be a UUID.\n */\nexport interface TrajectoryLearningContainerSelectorInput {\n  readonly trajectoryId: string;\n  readonly user: CopilotRuntimeUser;\n}\n\n/**\n * Selects existing Learning Spaces without requiring an agent run or Thread.\n * The optional signal cancels on request abort or the five-second deadline.\n */\nexport type GetTrajectoryLearningContainerIds = (\n  input: TrajectoryLearningContainerSelectorInput,\n  signal?: AbortSignal,\n) => MaybePromise<readonly string[] | null | undefined>;\n\n/** Resolves bounded, validated Space IDs selected by application server code. */\nexport async function resolveTrajectoryLearningContainerIds(\n  selector: GetTrajectoryLearningContainerIds | undefined,\n  input: TrajectoryLearningContainerSelectorInput,\n  signal?: AbortSignal,\n): Promise<readonly string[] | undefined> {\n  signal?.throwIfAborted();\n  if (!selector) return undefined;\n  const controller = new AbortController();\n  const onAbort = () => controller.abort(signal?.reason);\n  signal?.addEventListener(\"abort\", onAbort, { once: true });\n  const timeout = setTimeout(\n    () =>\n      controller.abort(\n        new Error(\"Trajectory Learning Container selection timed out\"),\n      ),\n    5_000,\n  );\n  let onCancelled: (() => void) | undefined;\n  try {\n    const cancelled = new Promise<never>((_resolve, reject) => {\n      onCancelled = () => reject(controller.signal.reason);\n      controller.signal.addEventListener(\"abort\", onCancelled, { once: true });\n    });\n    const selection = new Promise<readonly string[] | null | undefined>(\n      (resolve) => {\n        resolve(selector(input, controller.signal));\n      },\n    );\n    const value = await Promise.race([selection, cancelled]);\n    controller.signal.throwIfAborted();\n    if (value == null) return undefined;\n    if (!Array.isArray(value) || value.length > 100) {\n      throw new Error(\n        \"Trajectory Learning Container selection must be an array of at most 100 IDs\",\n      );\n    }\n    // Array.from visits holes in sparse arrays, so they fail validation.\n    return [...new Set(Array.from(value, assertStableLearningContainerId))];\n  } finally {\n    clearTimeout(timeout);\n    signal?.removeEventListener(\"abort\", onAbort);\n    if (onCancelled)\n      controller.signal.removeEventListener(\"abort\", onCancelled);\n  }\n}\n\n/** Context for choosing one Learning Container for an Intelligence run. */\nexport type CopilotRuntimeLearningContext =\n  | {\n      readonly surface: \"web\";\n      readonly request: Request;\n      readonly threadId: string;\n      readonly runId: string;\n      readonly agentId: string;\n      readonly userId: string;\n    }\n  | {\n      readonly surface: \"channel\";\n      readonly threadId: string;\n      readonly runId: string;\n      readonly agentId: string;\n      readonly userId: string;\n      readonly deliveryId: string;\n    };\n\n/** Assigns each Intelligence Thread to one developer-created Learning Container. */\nexport interface CopilotRuntimeLearningConfig {\n  readonly containerId:\n    | string\n    | ((\n        input: CopilotRuntimeLearningContext,\n      ) => MaybePromise<string | null | undefined>);\n}\n\nconst STABLE_CONTAINER_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\n/** Validates and returns a stable Learning Container ID. */\nexport function assertStableLearningContainerId(value: unknown): string {\n  if (\n    typeof value !== \"string\" ||\n    value.length < 1 ||\n    value.length > 64 ||\n    !STABLE_CONTAINER_ID.test(value)\n  ) {\n    throw new Error(\n      \"Learning Container must use a 1-64 character stable ID with lowercase letters, numbers, and single hyphens\",\n    );\n  }\n  return value;\n}\n\n/** Resolves and validates a public Intelligence Learning Container selection. */\nexport async function resolveLearningContainerSelector(\n  selector: GetLearningContainerId,\n  input: LearningContainerSelectorInput,\n): Promise<string | undefined> {\n  const value = await selector(input);\n  if (value == null) return undefined;\n  return assertStableLearningContainerId(value);\n}\n\n/** Resolves the configured Container once for one web or Channel run. */\nexport async function resolveLearningContainerId(\n  config: CopilotRuntimeLearningConfig | undefined,\n  input: CopilotRuntimeLearningContext,\n): Promise<string | undefined> {\n  if (config === undefined) return undefined;\n  const value =\n    typeof config.containerId === \"function\"\n      ? await config.containerId(input)\n      : config.containerId;\n  if (value == null) return undefined;\n  return assertStableLearningContainerId(value);\n}\n"],"mappings":";;AAKA,SAAgB,kCACd,SACS;AACT,QACE,QAAQ,cAAc,2BAA2B,KAAK,UACtD,QAAQ,UAAU,gBAAgB;;;AAkDtC,eAAsB,sCACpB,UACA,OACA,QACwC;AACxC,SAAQ,gBAAgB;AACxB,KAAI,CAAC,SAAU,QAAO;CACtB,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,gBAAgB,WAAW,MAAM,QAAQ,OAAO;AACtD,SAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;CAC1D,MAAM,UAAU,iBAEZ,WAAW,sBACT,IAAI,MAAM,oDAAoD,CAC/D,EACH,IACD;CACD,IAAI;AACJ,KAAI;EACF,MAAM,YAAY,IAAI,SAAgB,UAAU,WAAW;AACzD,uBAAoB,OAAO,WAAW,OAAO,OAAO;AACpD,cAAW,OAAO,iBAAiB,SAAS,aAAa,EAAE,MAAM,MAAM,CAAC;IACxE;EACF,MAAM,YAAY,IAAI,SACnB,YAAY;AACX,WAAQ,SAAS,OAAO,WAAW,OAAO,CAAC;IAE9C;EACD,MAAM,QAAQ,MAAM,QAAQ,KAAK,CAAC,WAAW,UAAU,CAAC;AACxD,aAAW,OAAO,gBAAgB;AAClC,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,MAAM,SAAS,IAC1C,OAAM,IAAI,MACR,8EACD;AAGH,SAAO,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,gCAAgC,CAAC,CAAC;WAC/D;AACR,eAAa,QAAQ;AACrB,UAAQ,oBAAoB,SAAS,QAAQ;AAC7C,MAAI,YACF,YAAW,OAAO,oBAAoB,SAAS,YAAY;;;AAgCjE,MAAM,sBAAsB;;AAG5B,SAAgB,gCAAgC,OAAwB;AACtE,KACE,OAAO,UAAU,YACjB,MAAM,SAAS,KACf,MAAM,SAAS,MACf,CAAC,oBAAoB,KAAK,MAAM,CAEhC,OAAM,IAAI,MACR,6GACD;AAEH,QAAO;;;AAIT,eAAsB,iCACpB,UACA,OAC6B;CAC7B,MAAM,QAAQ,MAAM,SAAS,MAAM;AACnC,KAAI,SAAS,KAAM,QAAO;AAC1B,QAAO,gCAAgC,MAAM;;;AAI/C,eAAsB,2BACpB,QACA,OAC6B;AAC7B,KAAI,WAAW,OAAW,QAAO;CACjC,MAAM,QACJ,OAAO,OAAO,gBAAgB,aAC1B,MAAM,OAAO,YAAY,MAAM,GAC/B,OAAO;AACb,KAAI,SAAS,KAAM,QAAO;AAC1B,QAAO,gCAAgC,MAAM"}

package/dist/runtime/core/logger.cjs

@@ -0,0 +1,21 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let pino = require("pino");
+pino = require_runtime.__toESM(pino);
+let pino_pretty = require("pino-pretty");
+pino_pretty = require_runtime.__toESM(pino_pretty);
+
+//#region src/runtime/core/logger.ts
+function createLogger(options) {
+	const { level, component } = options || {};
+	const stream = (0, pino_pretty.default)({ colorize: true });
+	const logger = (0, pino.default)({
+		level: process.env.LOG_LEVEL || level || "error",
+		base: null
+	}, stream);
+	if (component) return logger.child({ component });
+	else return logger;
+}
+
+//#endregion
+exports.createLogger = createLogger;
+//# sourceMappingURL=logger.cjs.map

package/dist/runtime/core/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","names":[],"sources":["../../../src/runtime/core/logger.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime — CopilotRuntimeLogger:\n *   No 1:1 v2 replacement is available.\n *   Start at: @copilotkit/runtime\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — createLogger:\n *   No 1:1 v2 replacement is available.\n *   Start at: @copilotkit/runtime\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — LogLevel:\n *   No 1:1 v2 replacement is available.\n *   Start at: @copilotkit/runtime\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\nimport createPinoLogger from \"pino\";\nimport pretty from \"pino-pretty\";\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport type CopilotRuntimeLogger = ReturnType<typeof createLogger>;\n\nexport function createLogger(options?: {\n  level?: LogLevel;\n  component?: string;\n}) {\n  const { level, component } = options || {};\n  const stream = pretty({ colorize: true });\n\n  const logger = createPinoLogger(\n    {\n      level: process.env.LOG_LEVEL || level || \"error\",\n      // Drop `pid` and `hostname` with pino's own `base` switch rather than\n      // with `redact`. pino 9 validates every redact path by calling\n      // `Function(...)`, and edge runtimes such as Cloudflare Workers forbid\n      // code generation from strings. That throws while the logger is being\n      // built, and the validator reports the first path in the array, so the\n      // failure surfaces as the misleading \"redact paths array contains an\n      // invalid path (pid)\". `base: null` produces identical output and needs\n      // no code generation. See issue #2355.\n      base: null,\n    },\n    stream,\n  );\n\n  if (component) {\n    return logger.child({ component });\n  } else {\n    return logger;\n  }\n}\n"],"mappings":";;;;;;;AAqCA,SAAgB,aAAa,SAG1B;CACD,MAAM,EAAE,OAAO,cAAc,WAAW,EAAE;CAC1C,MAAM,kCAAgB,EAAE,UAAU,MAAM,CAAC;CAEzC,MAAM,2BACJ;EACE,OAAO,QAAQ,IAAI,aAAa,SAAS;EASzC,MAAM;EACP,EACD,OACD;AAED,KAAI,UACF,QAAO,OAAO,MAAM,EAAE,WAAW,CAAC;KAElC,QAAO"}

package/dist/runtime/core/logger.d.cts

@@ -0,0 +1,12 @@
+import createPinoLogger from "pino";
+
+//#region src/runtime/core/logger.d.ts
+type LogLevel = "debug" | "info" | "warn" | "error";
+type CopilotRuntimeLogger = ReturnType<typeof createLogger>;
+declare function createLogger(options?: {
+  level?: LogLevel;
+  component?: string;
+}): createPinoLogger.Logger<never, boolean>;
+//#endregion
+export { CopilotRuntimeLogger };
+//# sourceMappingURL=logger.d.cts.map

package/dist/runtime/core/logger.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.cts","names":[],"sources":["../../../src/runtime/core/logger.ts"],"mappings":";;;KAiCY,QAAA;AAAA,KAEA,oBAAA,GAAuB,UAAA,QAAkB,YAAA;AAAA,iBAErC,YAAA,CAAa,OAAA;EAC3B,KAAA,GAAQ,QAAA;EACR,SAAA;AAAA,IACD,gBAAA,CAAA,MAAA"}

package/dist/runtime/core/logger.d.mts

@@ -0,0 +1,12 @@
+import createPinoLogger from "pino";
+
+//#region src/runtime/core/logger.d.ts
+type LogLevel = "debug" | "info" | "warn" | "error";
+type CopilotRuntimeLogger = ReturnType<typeof createLogger>;
+declare function createLogger(options?: {
+  level?: LogLevel;
+  component?: string;
+}): createPinoLogger.Logger<never, boolean>;
+//#endregion
+export { CopilotRuntimeLogger };
+//# sourceMappingURL=logger.d.mts.map

package/dist/runtime/core/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../../../src/runtime/core/logger.ts"],"mappings":";;;KAiCY,QAAA;AAAA,KAEA,oBAAA,GAAuB,UAAA,QAAkB,YAAA;AAAA,iBAErC,YAAA,CAAa,OAAA;EAC3B,KAAA,GAAQ,QAAA;EACR,SAAA;AAAA,IACD,gBAAA,CAAA,MAAA"}

package/dist/runtime/core/logger.mjs

@@ -0,0 +1,18 @@
+import createPinoLogger from "pino";
+import pretty from "pino-pretty";
+
+//#region src/runtime/core/logger.ts
+function createLogger(options) {
+	const { level, component } = options || {};
+	const stream = pretty({ colorize: true });
+	const logger = createPinoLogger({
+		level: process.env.LOG_LEVEL || level || "error",
+		base: null
+	}, stream);
+	if (component) return logger.child({ component });
+	else return logger;
+}
+
+//#endregion
+export { createLogger };
+//# sourceMappingURL=logger.mjs.map

package/dist/runtime/core/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":[],"sources":["../../../src/runtime/core/logger.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime — CopilotRuntimeLogger:\n *   No 1:1 v2 replacement is available.\n *   Start at: @copilotkit/runtime\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — createLogger:\n *   No 1:1 v2 replacement is available.\n *   Start at: @copilotkit/runtime\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — LogLevel:\n *   No 1:1 v2 replacement is available.\n *   Start at: @copilotkit/runtime\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\nimport createPinoLogger from \"pino\";\nimport pretty from \"pino-pretty\";\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport type CopilotRuntimeLogger = ReturnType<typeof createLogger>;\n\nexport function createLogger(options?: {\n  level?: LogLevel;\n  component?: string;\n}) {\n  const { level, component } = options || {};\n  const stream = pretty({ colorize: true });\n\n  const logger = createPinoLogger(\n    {\n      level: process.env.LOG_LEVEL || level || \"error\",\n      // Drop `pid` and `hostname` with pino's own `base` switch rather than\n      // with `redact`. pino 9 validates every redact path by calling\n      // `Function(...)`, and edge runtimes such as Cloudflare Workers forbid\n      // code generation from strings. That throws while the logger is being\n      // built, and the validator reports the first path in the array, so the\n      // failure surfaces as the misleading \"redact paths array contains an\n      // invalid path (pid)\". `base: null` produces identical output and needs\n      // no code generation. See issue #2355.\n      base: null,\n    },\n    stream,\n  );\n\n  if (component) {\n    return logger.child({ component });\n  } else {\n    return logger;\n  }\n}\n"],"mappings":";;;;AAqCA,SAAgB,aAAa,SAG1B;CACD,MAAM,EAAE,OAAO,cAAc,WAAW,EAAE;CAC1C,MAAM,SAAS,OAAO,EAAE,UAAU,MAAM,CAAC;CAEzC,MAAM,SAAS,iBACb;EACE,OAAO,QAAQ,IAAI,aAAa,SAAS;EASzC,MAAM;EACP,EACD,OACD;AAED,KAAI,UACF,QAAO,OAAO,MAAM,EAAE,WAAW,CAAC;KAElC,QAAO"}

package/dist/runtime/core/middleware-sse-parser.cjs

@@ -0,0 +1,149 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/runtime/core/middleware-sse-parser.ts
+/**
+* Parse a cloned SSE Response body into structured messages.
+* Returns empty results for non-SSE responses.
+*/
+async function parseSSEResponse(response) {
+	if (!(response.headers.get("content-type") ?? "").includes("text/event-stream")) return { messages: [] };
+	let text;
+	try {
+		text = await response.text();
+	} catch {
+		_copilotkit_shared.logger.warn("Failed to read SSE response body in afterRequestMiddleware");
+		return { messages: [] };
+	}
+	if (!text.trim()) return { messages: [] };
+	let threadId;
+	let runId;
+	const messagesById = /* @__PURE__ */ new Map();
+	const toolCallsById = /* @__PURE__ */ new Map();
+	const toolCallParent = /* @__PURE__ */ new Map();
+	let snapshotMessages;
+	const linkToolCallParent = (toolCallId, parentMessageId) => {
+		const parent = parentMessageId ? messagesById.get(parentMessageId) : void 0;
+		const parentId = parentMessageId && (!parent || parent.role === "assistant") ? parentMessageId : toolCallId;
+		if (!messagesById.has(parentId)) messagesById.set(parentId, {
+			id: parentId,
+			role: "assistant"
+		});
+		toolCallParent.set(toolCallId, parentId);
+	};
+	for (const line of text.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed.startsWith("data:")) continue;
+		let event;
+		try {
+			event = JSON.parse(trimmed.slice(5).trim());
+		} catch {
+			continue;
+		}
+		switch (event.type) {
+			case "RUN_STARTED":
+				threadId = event.threadId;
+				runId = event.runId;
+				break;
+			case "MESSAGES_SNAPSHOT":
+				if (Array.isArray(event.messages)) snapshotMessages = event.messages;
+				break;
+			case "TEXT_MESSAGE_START":
+				messagesById.set(event.messageId, {
+					id: event.messageId,
+					role: event.role ?? "assistant",
+					content: ""
+				});
+				break;
+			case "TEXT_MESSAGE_CONTENT": {
+				const msg = messagesById.get(event.messageId);
+				if (msg) msg.content = (msg.content ?? "") + (event.delta ?? "");
+				break;
+			}
+			case "TEXT_MESSAGE_CHUNK":
+				if (event.messageId) {
+					const existing = messagesById.get(event.messageId);
+					if (existing) existing.content = (existing.content ?? "") + (event.delta ?? "");
+					else messagesById.set(event.messageId, {
+						id: event.messageId,
+						role: event.role ?? "assistant",
+						content: event.delta ?? ""
+					});
+				}
+				break;
+			case "TOOL_CALL_START": {
+				const tc = {
+					id: event.toolCallId,
+					name: event.toolCallName,
+					args: ""
+				};
+				toolCallsById.set(event.toolCallId, tc);
+				linkToolCallParent(event.toolCallId, event.parentMessageId);
+				break;
+			}
+			case "TOOL_CALL_ARGS": {
+				const tc = toolCallsById.get(event.toolCallId);
+				if (tc) tc.args += event.delta ?? "";
+				break;
+			}
+			case "TOOL_CALL_CHUNK":
+				if (event.toolCallId) {
+					let tc = toolCallsById.get(event.toolCallId);
+					if (!tc) {
+						tc = {
+							id: event.toolCallId,
+							name: event.toolCallName ?? "",
+							args: ""
+						};
+						toolCallsById.set(event.toolCallId, tc);
+						linkToolCallParent(event.toolCallId, event.parentMessageId);
+					}
+					if (event.toolCallName) tc.name = event.toolCallName;
+					tc.args += event.delta ?? "";
+				}
+				break;
+			case "TOOL_CALL_END": {
+				const tc = toolCallsById.get(event.toolCallId);
+				const parentId = toolCallParent.get(event.toolCallId);
+				if (tc && parentId) {
+					const parent = messagesById.get(parentId);
+					if (parent) {
+						parent.toolCalls = parent.toolCalls ?? [];
+						parent.toolCalls.push(tc);
+					}
+				}
+				break;
+			}
+			case "TOOL_CALL_RESULT": {
+				let resultContent = event.content;
+				if (Array.isArray(resultContent)) resultContent = resultContent.filter((part) => part && typeof part.text === "string").map((part) => part.text).join("");
+				messagesById.set(event.messageId, {
+					id: event.messageId,
+					role: "tool",
+					content: resultContent,
+					toolCallId: event.toolCallId
+				});
+				break;
+			}
+		}
+	}
+	for (const [toolCallId, tc] of toolCallsById) {
+		const parentId = toolCallParent.get(toolCallId);
+		if (!parentId) continue;
+		const parent = messagesById.get(parentId);
+		if (!parent) continue;
+		if (!parent.toolCalls?.some((t) => t.id === tc.id)) {
+			parent.toolCalls = parent.toolCalls ?? [];
+			parent.toolCalls.push(tc);
+		}
+	}
+	return {
+		messages: snapshotMessages ?? [...messagesById.values()],
+		threadId,
+		runId
+	};
+}
+
+//#endregion
+exports.parseSSEResponse = parseSSEResponse;
+//# sourceMappingURL=middleware-sse-parser.cjs.map

package/dist/runtime/core/middleware-sse-parser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-sse-parser.cjs","names":[],"sources":["../../../src/runtime/core/middleware-sse-parser.ts"],"sourcesContent":["import { logger } from \"@copilotkit/shared\";\n\nexport interface ParsedSSEResult {\n  messages: Message[];\n  threadId?: string;\n  runId?: string;\n}\n\n/** Minimal message shape reconstructed from AG-UI events. */\nexport interface Message {\n  id: string;\n  role: string;\n  content?: string;\n  toolCalls?: ToolCall[];\n  toolCallId?: string;\n}\n\ninterface ToolCall {\n  id: string;\n  name: string;\n  args: string;\n}\n\n/**\n * Parse a cloned SSE Response body into structured messages.\n * Returns empty results for non-SSE responses.\n */\nexport async function parseSSEResponse(\n  response: Response,\n): Promise<ParsedSSEResult> {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (!contentType.includes(\"text/event-stream\")) {\n    return { messages: [] };\n  }\n\n  let text: string;\n  try {\n    text = await response.text();\n  } catch {\n    logger.warn(\"Failed to read SSE response body in afterRequestMiddleware\");\n    return { messages: [] };\n  }\n\n  if (!text.trim()) {\n    return { messages: [] };\n  }\n\n  let threadId: string | undefined;\n  let runId: string | undefined;\n  const messagesById = new Map<string, Message>();\n  const toolCallsById = new Map<string, ToolCall>();\n  const toolCallParent = new Map<string, string>(); // toolCallId → messageId\n  let snapshotMessages: Message[] | undefined;\n\n  // Link a tool call to its assistant message the way @ag-ui/client does. A\n  // tool-only turn streams no TEXT_MESSAGE_START, so the parent may not exist\n  // yet; create it, keyed by toolCallId when parentMessageId is missing or\n  // names a non-assistant message.\n  const linkToolCallParent = (toolCallId: string, parentMessageId?: string) => {\n    const parent = parentMessageId\n      ? messagesById.get(parentMessageId)\n      : undefined;\n    const parentId =\n      parentMessageId && (!parent || parent.role === \"assistant\")\n        ? parentMessageId\n        : toolCallId;\n    if (!messagesById.has(parentId)) {\n      messagesById.set(parentId, { id: parentId, role: \"assistant\" });\n    }\n    toolCallParent.set(toolCallId, parentId);\n  };\n\n  for (const line of text.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (!trimmed.startsWith(\"data:\")) continue;\n\n    let event: Record<string, any>;\n    try {\n      event = JSON.parse(trimmed.slice(5).trim());\n    } catch {\n      continue;\n    }\n\n    switch (event.type) {\n      case \"RUN_STARTED\":\n        threadId = event.threadId;\n        runId = event.runId;\n        break;\n\n      case \"MESSAGES_SNAPSHOT\":\n        if (Array.isArray(event.messages)) {\n          snapshotMessages = event.messages;\n        }\n        break;\n\n      case \"TEXT_MESSAGE_START\":\n        messagesById.set(event.messageId, {\n          id: event.messageId,\n          role: event.role ?? \"assistant\",\n          content: \"\",\n        });\n        break;\n\n      case \"TEXT_MESSAGE_CONTENT\": {\n        const msg = messagesById.get(event.messageId);\n        if (msg) {\n          msg.content = (msg.content ?? \"\") + (event.delta ?? \"\");\n        }\n        break;\n      }\n\n      case \"TEXT_MESSAGE_CHUNK\": {\n        // Chunk format: combined start+content. First chunk creates the\n        // message, subsequent chunks append delta to content.\n        if (event.messageId) {\n          const existing = messagesById.get(event.messageId);\n          if (existing) {\n            existing.content = (existing.content ?? \"\") + (event.delta ?? \"\");\n          } else {\n            messagesById.set(event.messageId, {\n              id: event.messageId,\n              role: event.role ?? \"assistant\",\n              content: event.delta ?? \"\",\n            });\n          }\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_START\": {\n        const tc: ToolCall = {\n          id: event.toolCallId,\n          name: event.toolCallName,\n          args: \"\",\n        };\n        toolCallsById.set(event.toolCallId, tc);\n        linkToolCallParent(event.toolCallId, event.parentMessageId);\n        break;\n      }\n\n      case \"TOOL_CALL_ARGS\": {\n        const tc = toolCallsById.get(event.toolCallId);\n        if (tc) {\n          tc.args += event.delta ?? \"\";\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_CHUNK\": {\n        // Chunk format: combined start+args. First chunk for a given\n        // toolCallId creates the tool call, subsequent chunks append delta.\n        if (event.toolCallId) {\n          let tc = toolCallsById.get(event.toolCallId);\n          if (!tc) {\n            tc = {\n              id: event.toolCallId,\n              name: event.toolCallName ?? \"\",\n              args: \"\",\n            };\n            toolCallsById.set(event.toolCallId, tc);\n            linkToolCallParent(event.toolCallId, event.parentMessageId);\n          }\n          if (event.toolCallName) {\n            tc.name = event.toolCallName;\n          }\n          tc.args += event.delta ?? \"\";\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_END\": {\n        const tc = toolCallsById.get(event.toolCallId);\n        const parentId = toolCallParent.get(event.toolCallId);\n        if (tc && parentId) {\n          const parent = messagesById.get(parentId);\n          if (parent) {\n            parent.toolCalls = parent.toolCalls ?? [];\n            parent.toolCalls.push(tc);\n          }\n        }\n        break;\n      }\n\n      case \"TOOL_CALL_RESULT\": {\n        // langchain-mcp-adapters may send content as an array of\n        // {type:\"text\", text:string} objects instead of a plain string.\n        let resultContent = event.content;\n        if (Array.isArray(resultContent)) {\n          resultContent = resultContent\n            .filter((part: any) => part && typeof part.text === \"string\")\n            .map((part: any) => part.text)\n            .join(\"\");\n        }\n        messagesById.set(event.messageId, {\n          id: event.messageId,\n          role: \"tool\",\n          content: resultContent,\n          toolCallId: event.toolCallId,\n        });\n        break;\n      }\n    }\n  }\n\n  // Attach any tool calls not yet linked to their parent message.\n  // This handles TOOL_CALL_CHUNK flows which don't emit TOOL_CALL_END.\n  for (const [toolCallId, tc] of toolCallsById) {\n    const parentId = toolCallParent.get(toolCallId);\n    if (!parentId) continue;\n    const parent = messagesById.get(parentId);\n    if (!parent) continue;\n    const alreadyAttached = parent.toolCalls?.some((t) => t.id === tc.id);\n    if (!alreadyAttached) {\n      parent.toolCalls = parent.toolCalls ?? [];\n      parent.toolCalls.push(tc);\n    }\n  }\n\n  // Prefer MESSAGES_SNAPSHOT if present (contains full history).\n  // Otherwise reconstruct from individual events.\n  const messages = snapshotMessages ?? [...messagesById.values()];\n\n  return { messages, threadId, runId };\n}\n"],"mappings":"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"}

package/dist/runtime/core/middleware-sse-parser.d.cts

@@ -0,0 +1,21 @@
+//#region src/runtime/core/middleware-sse-parser.d.ts
+/** Minimal message shape reconstructed from AG-UI events. */
+interface Message {
+  id: string;
+  role: string;
+  content?: string;
+  toolCalls?: ToolCall[];
+  toolCallId?: string;
+}
+interface ToolCall {
+  id: string;
+  name: string;
+  args: string;
+}
+/**
+ * Parse a cloned SSE Response body into structured messages.
+ * Returns empty results for non-SSE responses.
+ */
+//#endregion
+export { Message };
+//# sourceMappingURL=middleware-sse-parser.d.cts.map

package/dist/runtime/core/middleware-sse-parser.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-sse-parser.d.cts","names":[],"sources":["../../../src/runtime/core/middleware-sse-parser.ts"],"mappings":";;UASiB,OAAA;EACf,EAAA;EACA,IAAA;EACA,OAAA;EACA,SAAA,GAAY,QAAA;EACZ,UAAA;AAAA;AAAA,UAGQ,QAAA;EACR,EAAA;EACA,IAAA;EACA,IAAA;AAAA"}

package/dist/runtime/core/middleware-sse-parser.d.mts

@@ -0,0 +1,21 @@
+//#region src/runtime/core/middleware-sse-parser.d.ts
+/** Minimal message shape reconstructed from AG-UI events. */
+interface Message {
+  id: string;
+  role: string;
+  content?: string;
+  toolCalls?: ToolCall[];
+  toolCallId?: string;
+}
+interface ToolCall {
+  id: string;
+  name: string;
+  args: string;
+}
+/**
+ * Parse a cloned SSE Response body into structured messages.
+ * Returns empty results for non-SSE responses.
+ */
+//#endregion
+export { Message };
+//# sourceMappingURL=middleware-sse-parser.d.mts.map

package/dist/runtime/core/middleware-sse-parser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-sse-parser.d.mts","names":[],"sources":["../../../src/runtime/core/middleware-sse-parser.ts"],"mappings":";;UASiB,OAAA;EACf,EAAA;EACA,IAAA;EACA,OAAA;EACA,SAAA,GAAY,QAAA;EACZ,UAAA;AAAA;AAAA,UAGQ,QAAA;EACR,EAAA;EACA,IAAA;EACA,IAAA;AAAA"}