@copilotkit/core 1.56.5 → 1.57.0-canary.1778078321

package/dist/index.d.cts

@@ -93,11 +93,91 @@ type StaticSuggestionsConfig = {
 };
 type SuggestionsConfig = DynamicSuggestionsConfig | StaticSuggestionsConfig;
 //#endregion
+//#region src/agent.d.ts
+type ResolvedRuntimeMode = RuntimeMode$1 | "pending";
+interface ProxiedCopilotRuntimeAgentConfig extends Omit<HttpAgentConfig, "url"> {
+  runtimeUrl?: string;
+  transport?: CopilotRuntimeTransport;
+  credentials?: RequestCredentials;
+  runtimeMode?: ResolvedRuntimeMode;
+  intelligence?: IntelligenceRuntimeInfo$1;
+  capabilities?: AgentCapabilities;
+  debug?: ResolvedDebugConfig;
+  /**
+   * When set, runtime requests (HTTP path, single-route envelope, intelligence
+   * delegate) are routed to this agent on the runtime instead of `agentId`.
+   * The local `agentId` remains the registry key used for subscriber
+   * bookkeeping; only outbound routing is overridden.
+   */
+  runtimeAgentId?: string;
+}
+declare class ProxiedCopilotRuntimeAgent extends HttpAgent {
+  #private;
+  runtimeUrl?: string;
+  credentials?: RequestCredentials;
+  readonly runtimeAgentId?: string;
+  private transport;
+  private singleEndpointUrl?;
+  private runtimeMode;
+  private intelligence?;
+  private _capabilities?;
+  private delegate?;
+  private runtimeInfoPromise?;
+  constructor(config: ProxiedCopilotRuntimeAgentConfig);
+  /**
+   * The agent id used for outbound runtime requests — `runtimeAgentId` when
+   * set (manually-registered proxy), otherwise `agentId` (registry id
+   * matches runtime id). Subscriber bookkeeping keeps using `agentId`
+   * directly.
+   *
+   * Throws when both are unset: a proxy reaching an HTTP path with no
+   * routable id is a bug, and a missing id would otherwise produce a
+   * malformed `/agent//run` or `/agent/undefined/connect` URL silently.
+   */
+  private routedAgentId;
+  get capabilities(): AgentCapabilities | undefined;
+  getCapabilities(): Promise<AgentCapabilities>;
+  detachActiveRun(): Promise<void>;
+  abortRun(): void;
+  connectAgent(parameters?: RunAgentParameters, subscriber?: AgentSubscriber): Promise<RunAgentResult>;
+  connect(input: RunAgentInput): Observable<BaseEvent>;
+  run(input: RunAgentInput): Observable<BaseEvent>;
+  clone(): ProxiedCopilotRuntimeAgent;
+  private resolveDelegate;
+  private ensureRuntimeMode;
+  private fetchRuntimeInfo;
+  private fetchRuntimeInfoAutoDetect;
+  private createSingleRouteRequestInit;
+  private createIntelligenceDelegate;
+  private syncDelegate;
+}
+//#endregion
 //#region src/core/agent-registry.d.ts
 interface CopilotKitCoreAddAgentParams {
   id: string;
   agent: AbstractAgent;
 }
+/**
+ * Parameters for registering a proxied agent against an existing runtime agent.
+ */
+interface CopilotKitCoreRegisterProxiedAgentParams {
+  /**
+   * The local registry id under which the proxy is registered. Used by
+   * `useAgent`, state-manager subscriptions, and all subscriber bookkeeping.
+   * Must not collide with any existing local or runtime-discovered agent id.
+   */
+  agentId: string;
+  /**
+   * The id of the runtime agent that this proxy routes outbound HTTP requests
+   * to. Invisible to subscribers — only affects URL paths and single-route
+   * envelopes.
+   */
+  runtimeAgentId: string;
+}
+interface CopilotKitCoreRegisterProxiedAgentResult {
+  agent: ProxiedCopilotRuntimeAgent;
+  unregister: () => void;
+}
 /**
  * Manages agent registration, lifecycle, and runtime connectivity for CopilotKitCore.
  * Handles both local development agents and remote runtime agents.
@@ -156,6 +236,21 @@ declare class AgentRegistry {
    * Remove an agent by ID (for development use)
    */
   removeAgent__unsafe_dev_only(id: string): void;
+  /**
+   * Register a proxied agent that routes outbound runtime requests to an
+   * existing runtime agent (`runtimeAgentId`) while exposing a distinct local
+   * registry id (`agentId`). Throws if `agentId` is already taken by either a
+   * local or runtime-discovered agent.
+   *
+   * Use this to mount multiple frontend agents against a single runtime
+   * agent (e.g. a chat-1 / chat-2 pair both proxying to "default") without
+   * implicit per-thread cloning. The returned `unregister` removes the proxy
+   * from the registry and emits `onAgentsChanged`.
+   */
+  registerProxiedAgent({
+    agentId,
+    runtimeAgentId
+  }: CopilotKitCoreRegisterProxiedAgentParams): CopilotKitCoreRegisterProxiedAgentResult;
   /**
    * Get an agent by ID
    */
@@ -375,148 +470,451 @@ declare function ensureObjectArgs(parsed: unknown, toolName: string): Record<str
  */
 declare function parseToolArguments(rawArgs: unknown, toolName: string): Record<string, unknown>;
 //#endregion
-//#region src/core/core.d.ts
-/** Configuration options for `CopilotKitCore`. */
-interface CopilotKitCoreConfig {
-  /** The endpoint of the CopilotRuntime. */
-  runtimeUrl?: string;
-  /** Transport style for CopilotRuntime endpoints. Defaults to REST. */
-  runtimeTransport?: CopilotRuntimeTransport;
-  /** Mapping from agent name to its `AbstractAgent` instance. For development only - production requires CopilotRuntime. */
-  agents__unsafe_dev_only?: Record<string, AbstractAgent>;
-  /** Headers appended to every HTTP request made by `CopilotKitCore`. */
-  headers?: Record<string, string>;
-  /** Credentials mode for fetch requests (e.g., "include" for HTTP-only cookies). */
-  credentials?: RequestCredentials;
-  /** Properties sent as `forwardedProps` to the AG-UI agent. */
-  properties?: Record<string, unknown>;
-  /** Ordered collection of frontend tools available to the core. */
-  tools?: FrontendTool<any>[];
-  /** Suggestions config for the core. */
-  suggestionsConfig?: SuggestionsConfig[];
-  /** Enable debug logging for the client-side event pipeline. */
-  debug?: DebugConfig;
-}
-interface CopilotKitCoreStopAgentParams {
-  agent: AbstractAgent;
+//#region src/utils/micro-redux.d.ts
+/**
+ * The minimal action shape used by this micro-redux implementation.
+ */
+interface AnyAction {
+  type: string;
 }
-type CopilotKitCoreGetSuggestionsResult = {
-  suggestions: Suggestion[];
-  isLoading: boolean;
+/**
+ * A typed action creator function with a `type` literal and runtime matcher.
+ */
+type ActionCreator<Type extends string, Args extends unknown[] = unknown[], Action extends AnyAction & {
+  type: Type;
+} = {
+  type: Type;
+}> = ((...args: Args) => Action) & {
+  type: Type;
+  match(action: AnyAction): action is Action;
 };
-declare enum CopilotKitCoreErrorCode {
-  RUNTIME_INFO_FETCH_FAILED = "runtime_info_fetch_failed",
-  AGENT_CONNECT_FAILED = "agent_connect_failed",
-  AGENT_RUN_FAILED = "agent_run_failed",
-  AGENT_RUN_FAILED_EVENT = "agent_run_failed_event",
-  AGENT_RUN_ERROR_EVENT = "agent_run_error_event",
-  TOOL_ARGUMENT_PARSE_FAILED = "tool_argument_parse_failed",
-  TOOL_HANDLER_FAILED = "tool_handler_failed",
-  TOOL_NOT_FOUND = "tool_not_found",
-  AGENT_NOT_FOUND = "agent_not_found",
-  /**
-   * Emitted when an agent run fails because the thread is already locked
-   * by another active run.
-   *
-   * @example
-   * ```tsx
-   * <CopilotKitProvider
-   *   onError={({ code, error, context }) => {
-   *     if (code === "agent_thread_locked") {
-   *       // Show "Agent is busy, retry?" UI
-   *     }
-   *   }}
-   * />
-   * ```
-   */
-  AGENT_THREAD_LOCKED = "agent_thread_locked",
-  TRANSCRIPTION_FAILED = "transcription_failed",
-  TRANSCRIPTION_SERVICE_NOT_CONFIGURED = "transcription_service_not_configured",
-  TRANSCRIPTION_INVALID_AUDIO = "transcription_invalid_audio",
-  TRANSCRIPTION_RATE_LIMITED = "transcription_rate_limited",
-  TRANSCRIPTION_AUTH_FAILED = "transcription_auth_failed",
-  TRANSCRIPTION_NETWORK_ERROR = "transcription_network_error",
-  SUBSCRIBER_CALLBACK_FAILED = "subscriber_callback_failed"
+/**
+ * Extracts the action type produced by an action creator.
+ */
+type ActionFromCreator<T> = T extends ((...args: any[]) => infer A) ? A : never;
+/**
+ * Extracts a union of actions produced by a tuple/array of action creators.
+ */
+type ActionFromCreators<Creators extends readonly ActionCreator<string, any[], any>[]> = ActionFromCreator<Creators[number]>;
+/**
+ * A reducer transforms state in response to actions.
+ */
+type Reducer<State, Action extends AnyAction = AnyAction> = (state: State | undefined, action: Action) => State;
+/**
+ * A selector derives a value from state.
+ */
+type Selector<State, Result> = (state: State) => Result;
+/**
+ * Marker config for action creators that accept no payload.
+ */
+interface EmptyActionConfig {
+  readonly kind: "empty";
 }
-interface CopilotKitCoreSubscriber {
-  onRuntimeConnectionStatusChanged?: (event: {
-    copilotkit: CopilotKitCore;
-    status: CopilotKitCoreRuntimeConnectionStatus;
-  }) => void | Promise<void>;
-  onToolExecutionStart?: (event: {
-    copilotkit: CopilotKitCore;
-    toolCallId: string;
-    agentId: string;
-    toolName: string;
-    args: unknown;
-  }) => void | Promise<void>;
-  onToolExecutionEnd?: (event: {
-    copilotkit: CopilotKitCore;
-    toolCallId: string;
-    agentId: string;
-    toolName: string;
-    result: string;
-    error?: string;
-  }) => void | Promise<void>;
-  onAgentsChanged?: (event: {
-    copilotkit: CopilotKitCore;
-    agents: Readonly<Record<string, AbstractAgent>>;
-  }) => void | Promise<void>;
-  onContextChanged?: (event: {
-    copilotkit: CopilotKitCore;
-    context: Readonly<Record<string, Context>>;
-  }) => void | Promise<void>;
-  onSuggestionsConfigChanged?: (event: {
-    copilotkit: CopilotKitCore;
-    suggestionsConfig: Readonly<Record<string, SuggestionsConfig>>;
-  }) => void | Promise<void>;
-  onSuggestionsChanged?: (event: {
-    copilotkit: CopilotKitCore;
-    agentId: string;
-    suggestions: Suggestion[];
-  }) => void | Promise<void>;
-  onSuggestionsStartedLoading?: (event: {
-    copilotkit: CopilotKitCore;
-    agentId: string;
-  }) => void | Promise<void>;
-  onSuggestionsFinishedLoading?: (event: {
-    copilotkit: CopilotKitCore;
-    agentId: string;
-  }) => void | Promise<void>;
-  onPropertiesChanged?: (event: {
-    copilotkit: CopilotKitCore;
-    properties: Readonly<Record<string, unknown>>;
-  }) => void | Promise<void>;
-  onHeadersChanged?: (event: {
-    copilotkit: CopilotKitCore;
-    headers: Readonly<Record<string, string>>;
-  }) => void | Promise<void>;
-  onError?: (event: {
-    copilotkit: CopilotKitCore;
-    error: Error;
-    code: CopilotKitCoreErrorCode;
-    context: Record<string, any>;
-  }) => void | Promise<void>;
-  /**
-   * Fired when an agent run or connect begins. The `agent` may be a per-thread
-   * clone that is not present in `core.agents`. Subscribers (e.g. the inspector)
-   * can use this to subscribe to the clone's AG-UI events.
-   */
-  onAgentRunStarted?: (event: {
-    copilotkit: CopilotKitCore;
-    agent: AbstractAgent;
-  }) => void | Promise<void>;
+declare const PROPS_MARKER: unique symbol;
+/**
+ * Marker config for action creators that require payload props.
+ */
+interface PropsActionConfig<Props extends Record<string, unknown>> {
+  readonly kind: "props";
+  readonly [PROPS_MARKER]?: Props;
 }
-interface CopilotKitCoreSubscription {
-  unsubscribe: () => void;
+/**
+ * Supported action creator config node in an action group.
+ */
+type ActionConfig = EmptyActionConfig | PropsActionConfig<Record<string, unknown>>;
+/**
+ * Shape of an action group declaration object.
+ */
+type ActionGroupConfig = Record<string, ActionConfig>;
+/**
+ * Maps an action group declaration to a strongly typed action-creator object.
+ */
+type ActionGroupResult<Source extends string, Config extends ActionGroupConfig> = { [K in keyof Config & string]: Config[K] extends PropsActionConfig<infer P> ? ActionCreator<`[${Source}] ${K}`, [P], {
+  type: `[${Source}] ${K}`;
+} & P> : ActionCreator<`[${Source}] ${K}`, [], {
+  type: `[${Source}] ${K}`;
+}> };
+interface OnReducerEntry<State, Action extends AnyAction = AnyAction, Creators extends readonly ActionCreator<string, any[], any>[] = readonly ActionCreator<string, any[], any>[]> {
+  creators: Creators;
+  reducer: (state: State, action: Action) => State;
 }
+type ActionFromOnReducerEntry<TEntry> = TEntry extends OnReducerEntry<any, infer TAction, any> ? TAction : never;
 /**
- * The callback keys accepted by {@link CopilotKitCore.subscribeToAgentWithOptions}.
- * This tuple is the single source of truth — both the
- * `SubscribeToAgentSubscriber` type and the runtime `ALLOWED_KEYS` set
- * are derived from it, so they cannot desynchronise.
+ * Effect contract for streams that emit actions to dispatch.
  */
-declare const SUBSCRIBE_TO_AGENT_KEYS: readonly ["onMessagesChanged", "onStateChanged", "onRunInitialized", "onRunFinalized", "onRunFailed", "onRunErrorEvent"];
+interface DispatchingEffect<State, InputAction extends AnyAction = AnyAction, OutputAction extends AnyAction = AnyAction> {
+  run: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<OutputAction>;
+  dispatch: true;
+}
+/**
+ * Effect contract for side-effect-only streams whose emissions are ignored.
+ */
+interface NonDispatchingEffect<State, InputAction extends AnyAction = AnyAction> {
+  run: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<unknown>;
+  dispatch: false;
+}
+/**
+ * Union of supported effect shapes.
+ */
+type Effect<State, InputAction extends AnyAction = AnyAction, OutputAction extends AnyAction = AnyAction> = DispatchingEffect<State, InputAction, OutputAction> | NonDispatchingEffect<State, InputAction>;
+/**
+ * Lifecycle actions dispatched by the store.
+ */
+type StoreLifecycleAction = {
+  type: "@@micro-redux/init";
+} | {
+  type: "@@micro-redux/stop";
+};
+/**
+ * Options for a dispatching effect.
+ */
+interface DispatchingEffectOptions {
+  dispatch?: true;
+}
+/**
+ * Options for a non-dispatching effect.
+ */
+interface NonDispatchingEffectOptions {
+  dispatch: false;
+}
+/**
+ * Declares a payload-based action config for `createActionGroup`.
+ *
+ * @example
+ * ```ts
+ * const actions = createActionGroup("User", {
+ *   loaded: props<{ id: string }>(),
+ * });
+ * ```
+ */
+declare function props<Props extends Record<string, unknown>>(): PropsActionConfig<Props>;
+/**
+ * Declares a no-payload action config for `createActionGroup`.
+ *
+ * @example
+ * ```ts
+ * const actions = createActionGroup("User", {
+ *   reset: empty(),
+ * });
+ * ```
+ */
+declare function empty(): EmptyActionConfig;
+/**
+ * Creates a namespaced group of typed action creators.
+ *
+ * Action types are formatted as: `[Source] actionName`.
+ */
+declare function createActionGroup<const Source extends string, const Config extends ActionGroupConfig>(source: Source, config: Config): ActionGroupResult<Source, Config>;
+/**
+ * Registers one reducer handler for one or more action creators.
+ *
+ * @throws Error when called without at least one action creator and reducer.
+ */
+declare function on<State, const Creators extends readonly ActionCreator<string, any[], any>[], Action extends ActionFromCreators<Creators>>(...args: [...creators: Creators, reducer: (state: State, action: Action) => State]): OnReducerEntry<State, Action, Creators>;
+/**
+ * Creates a reducer from an initial state and `on(...)` handler entries.
+ *
+ * Unknown action types return the current state unchanged.
+ */
+declare function createReducer<State, const Entries extends readonly OnReducerEntry<any, any, any>[]>(initialState: State, ...entries: Entries): Reducer<State, ActionFromOnReducerEntry<Entries[number]>>;
+/**
+ * Creates a memoized selector from a single projector.
+ */
+declare function createSelector<State, Result>(projector: (state: State) => Result): Selector<State, Result>;
+/**
+ * Creates a memoized selector from input selectors and a projector.
+ *
+ * Memoization uses one-entry caching over the latest input selector values.
+ */
+declare function createSelector<State, const Selectors extends readonly Selector<State, unknown>[], Result>(...args: [...selectors: Selectors, projector: (...inputs: { [K in keyof Selectors]: ReturnType<Selectors[K]> }) => Result]): Selector<State, Result>;
+/**
+ * RxJS operator that maps state emissions through a selector and suppresses
+ * unchanged projected values via reference equality.
+ */
+declare function select<State, Result>(selector: Selector<State, Result>): OperatorFunction<State, Result>;
+/**
+ * RxJS operator that filters an action stream by action creators and narrows
+ * the output action type to the matched creator union.
+ *
+ * @throws Error when called without at least one action creator.
+ */
+declare function ofType<const Creators extends readonly ActionCreator<string, any[], AnyAction>[]>(...creators: Creators): OperatorFunction<AnyAction, ActionFromCreators<Creators>>;
+/**
+ * Creates a dispatching effect. Emitted actions are automatically dispatched.
+ */
+declare function createEffect<State, InputAction extends AnyAction, OutputAction extends AnyAction>(factory: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<OutputAction>, options?: DispatchingEffectOptions): DispatchingEffect<State, InputAction, OutputAction>;
+/**
+ * Creates a non-dispatching effect. Emitted values are ignored.
+ */
+declare function createEffect<State, InputAction extends AnyAction>(factory: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<unknown>, options: NonDispatchingEffectOptions): NonDispatchingEffect<State, InputAction>;
+/**
+ * Store interface returned by `createStore`.
+ */
+interface Store<State, Action extends AnyAction = AnyAction> {
+  dispatch(action: Action): void;
+  getState(): State;
+  readonly state$: Observable<State>;
+  readonly actions$: Observable<Action | StoreLifecycleAction>;
+  select<Result>(selector: Selector<State, Result>): Observable<Result>;
+  init(): void;
+  stop(): void;
+}
+/**
+ * Creates a small observable store with reducer + effects.
+ *
+ * Behavior:
+ * - `init()` starts effects and dispatches `@@micro-redux/init`.
+ * - `stop()` dispatches `@@micro-redux/stop` and unsubscribes all effects.
+ * - Effect action observation is scheduled on `asapScheduler` to avoid
+ *   synchronous re-entrancy in the effect loop.
+ * - Any effect error triggers fail-fast teardown and errors both `actions$`
+ *   and `state$`.
+ */
+declare function createStore<State, Action extends AnyAction = AnyAction>(options: {
+  reducer: Reducer<State, Action | StoreLifecycleAction>;
+  effects?: Array<Effect<State, Action | StoreLifecycleAction, Action>>;
+}): Store<State, Action>;
+//#endregion
+//#region src/threads.d.ts
+interface ThreadRecord {
+  id: string;
+  organizationId: string;
+  agentId: string;
+  createdById: string;
+  name: string | null;
+  archived: boolean;
+  createdAt: string;
+  updatedAt: string;
+  lastRunAt?: string;
+}
+interface ThreadRuntimeContext {
+  runtimeUrl: string;
+  headers: Record<string, string>;
+  wsUrl?: string;
+  agentId: string;
+  includeArchived?: boolean;
+  limit?: number;
+}
+type ThreadMetadataEvent = {
+  operation: "created" | "renamed" | "archived" | "unarchived" | "updated";
+  threadId: string;
+  userId: string;
+  organizationId: string;
+  occurredAt: string;
+  thread: ThreadRecord;
+} | {
+  operation: "deleted";
+  threadId: string;
+  userId: string;
+  organizationId: string;
+  occurredAt: string;
+  deleted: {
+    id: string;
+  };
+};
+interface ThreadEnvironment {
+  fetch: typeof fetch;
+}
+interface ThreadState {
+  threads: ThreadRecord[];
+  isLoading: boolean;
+  isFetchingNextPage: boolean;
+  error: Error | null;
+  context: ThreadRuntimeContext | null;
+  sessionId: number;
+  metadataCredentialsRequested: boolean;
+  metadataJoinCode: string | null;
+  nextCursor: string | null;
+}
+interface ThreadStore {
+  start(): void;
+  stop(): void;
+  setContext(context: ThreadRuntimeContext | null): void;
+  /** Re-fetches the thread list without resetting the current list to empty. */
+  refresh(): void;
+  fetchNextPage(): void;
+  renameThread(threadId: string, name: string): Promise<void>;
+  archiveThread(threadId: string): Promise<void>;
+  deleteThread(threadId: string): Promise<void>;
+  getState(): ThreadState;
+  select: Store<ThreadState>["select"];
+}
+declare function createThreadStore(environment: ThreadEnvironment): ThreadStore;
+type ɵThread = ThreadRecord;
+type ɵThreadRuntimeContext = ThreadRuntimeContext;
+type ɵThreadMetadataEvent = ThreadMetadataEvent;
+type ɵThreadEnvironment = ThreadEnvironment;
+type ɵThreadStore = ThreadStore;
+declare const ɵthreadAdapterEvents: any;
+declare const ɵselectThreads: any;
+declare const ɵselectThreadsIsLoading: any;
+declare const ɵselectThreadsError: any;
+declare const ɵselectHasNextPage: any;
+declare const ɵselectIsFetchingNextPage: any;
+/**
+ * Number of consecutive WebSocket connection failures after which the
+ * threads channel tears itself down rather than retrying indefinitely.
+ * Exposed for tests so they can assert teardown semantics without
+ * hardcoding the threshold separately from production.
+ */
+declare const ɵMAX_SOCKET_RETRIES = 5;
+//#endregion
+//#region src/core/core.d.ts
+/** Configuration options for `CopilotKitCore`. */
+interface CopilotKitCoreConfig {
+  /** The endpoint of the CopilotRuntime. */
+  runtimeUrl?: string;
+  /** Transport style for CopilotRuntime endpoints. Defaults to REST. */
+  runtimeTransport?: CopilotRuntimeTransport;
+  /** Mapping from agent name to its `AbstractAgent` instance. For development only - production requires CopilotRuntime. */
+  agents__unsafe_dev_only?: Record<string, AbstractAgent>;
+  /** Headers appended to every HTTP request made by `CopilotKitCore`. */
+  headers?: Record<string, string>;
+  /** Credentials mode for fetch requests (e.g., "include" for HTTP-only cookies). */
+  credentials?: RequestCredentials;
+  /** Properties sent as `forwardedProps` to the AG-UI agent. */
+  properties?: Record<string, unknown>;
+  /** Ordered collection of frontend tools available to the core. */
+  tools?: FrontendTool<any>[];
+  /** Suggestions config for the core. */
+  suggestionsConfig?: SuggestionsConfig[];
+  /** Enable debug logging for the client-side event pipeline. */
+  debug?: DebugConfig;
+}
+interface CopilotKitCoreStopAgentParams {
+  agent: AbstractAgent;
+}
+type CopilotKitCoreGetSuggestionsResult = {
+  suggestions: Suggestion[];
+  isLoading: boolean;
+};
+declare enum CopilotKitCoreErrorCode {
+  RUNTIME_INFO_FETCH_FAILED = "runtime_info_fetch_failed",
+  AGENT_CONNECT_FAILED = "agent_connect_failed",
+  AGENT_RUN_FAILED = "agent_run_failed",
+  AGENT_RUN_FAILED_EVENT = "agent_run_failed_event",
+  AGENT_RUN_ERROR_EVENT = "agent_run_error_event",
+  TOOL_ARGUMENT_PARSE_FAILED = "tool_argument_parse_failed",
+  TOOL_HANDLER_FAILED = "tool_handler_failed",
+  TOOL_NOT_FOUND = "tool_not_found",
+  AGENT_NOT_FOUND = "agent_not_found",
+  /**
+   * Emitted when an agent run fails because the thread is already locked
+   * by another active run.
+   *
+   * @example
+   * ```tsx
+   * <CopilotKitProvider
+   *   onError={({ code, error, context }) => {
+   *     if (code === "agent_thread_locked") {
+   *       // Show "Agent is busy, retry?" UI
+   *     }
+   *   }}
+   * />
+   * ```
+   */
+  AGENT_THREAD_LOCKED = "agent_thread_locked",
+  TRANSCRIPTION_FAILED = "transcription_failed",
+  TRANSCRIPTION_SERVICE_NOT_CONFIGURED = "transcription_service_not_configured",
+  TRANSCRIPTION_INVALID_AUDIO = "transcription_invalid_audio",
+  TRANSCRIPTION_RATE_LIMITED = "transcription_rate_limited",
+  TRANSCRIPTION_AUTH_FAILED = "transcription_auth_failed",
+  TRANSCRIPTION_NETWORK_ERROR = "transcription_network_error",
+  SUBSCRIBER_CALLBACK_FAILED = "subscriber_callback_failed"
+}
+interface CopilotKitCoreSubscriber {
+  onRuntimeConnectionStatusChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    status: CopilotKitCoreRuntimeConnectionStatus;
+  }) => void | Promise<void>;
+  onToolExecutionStart?: (event: {
+    copilotkit: CopilotKitCore;
+    toolCallId: string;
+    agentId: string;
+    toolName: string;
+    args: unknown;
+  }) => void | Promise<void>;
+  onToolExecutionEnd?: (event: {
+    copilotkit: CopilotKitCore;
+    toolCallId: string;
+    agentId: string;
+    toolName: string;
+    result: string;
+    error?: string;
+  }) => void | Promise<void>;
+  onAgentsChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    agents: Readonly<Record<string, AbstractAgent>>;
+  }) => void | Promise<void>;
+  onContextChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    context: Readonly<Record<string, Context>>;
+  }) => void | Promise<void>;
+  onSuggestionsConfigChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    suggestionsConfig: Readonly<Record<string, SuggestionsConfig>>;
+  }) => void | Promise<void>;
+  onSuggestionsChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    agentId: string;
+    suggestions: Suggestion[];
+  }) => void | Promise<void>;
+  onSuggestionsStartedLoading?: (event: {
+    copilotkit: CopilotKitCore;
+    agentId: string;
+  }) => void | Promise<void>;
+  onSuggestionsFinishedLoading?: (event: {
+    copilotkit: CopilotKitCore;
+    agentId: string;
+  }) => void | Promise<void>;
+  onPropertiesChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    properties: Readonly<Record<string, unknown>>;
+  }) => void | Promise<void>;
+  onHeadersChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    headers: Readonly<Record<string, string>>;
+  }) => void | Promise<void>;
+  onError?: (event: {
+    copilotkit: CopilotKitCore;
+    error: Error;
+    code: CopilotKitCoreErrorCode;
+    context: Record<string, any>;
+  }) => void | Promise<void>;
+  onThreadStoreRegistered?: (event: {
+    copilotkit: CopilotKitCore;
+    agentId: string;
+    store: ɵThreadStore;
+  }) => void | Promise<void>;
+  /**
+   * Fired when a thread store is removed from the registry, either by an
+   * explicit `unregister()` call or by a `register()` call that replaces an
+   * existing store for the same `agentId`.
+   *
+   * The previous store is delivered via `prevStore` so subscribers can tear
+   * down state that depends on the concrete instance (e.g. cancel an active
+   * subscription) without consulting the registry. By the time async
+   * subscribers resume after an `await`, a replacement `register()` may have
+   * already installed the new store under the same key, so calling
+   * `registry.get(agentId)` inside this callback is unsafe and may return
+   * the new store instead of the unregistered one.
+   */
+  onThreadStoreUnregistered?: (event: {
+    copilotkit: CopilotKitCore;
+    agentId: string;
+    prevStore: ɵThreadStore;
+  }) => void | Promise<void>;
+}
+interface CopilotKitCoreSubscription {
+  unsubscribe: () => void;
+}
+/**
+ * The callback keys accepted by {@link CopilotKitCore.subscribeToAgentWithOptions}.
+ * This tuple is the single source of truth — both the
+ * `SubscribeToAgentSubscriber` type and the runtime `ALLOWED_KEYS` set
+ * are derived from it, so they cannot desynchronise.
+ */
+declare const SUBSCRIBE_TO_AGENT_KEYS: readonly ["onMessagesChanged", "onStateChanged", "onRunInitialized", "onRunFinalized", "onRunFailed", "onRunErrorEvent"];
 /**
  * The subset of `AgentSubscriber` callbacks accepted by
  * {@link CopilotKitCore.subscribeToAgentWithOptions}. Only the callbacks
@@ -596,12 +994,6 @@ interface CopilotKitCoreFriendsAccess {
    * See CopilotKitCore.waitForPendingFrameworkUpdates for details.
    */
   waitForPendingFrameworkUpdates(): Promise<void>;
-  /**
-   * Subscribe the state manager to an agent (including per-thread clones).
-   * Called by RunHandler before executing an agent so that events from
-   * clones are tracked in stateByRun/messageToRun.
-   */
-  subscribeAgentToStateManager(agent: AbstractAgent): void;
 }
 declare class CopilotKitCore {
   private _headers;
@@ -615,6 +1007,14 @@ declare class CopilotKitCore {
   private suggestionEngine;
   private runHandler;
   private stateManager;
+  private threadStoreRegistry;
+  /**
+   * Tracks the agent IDs from the most recent `onAgentsChanged` notification.
+   * Used to gate thread-store auto-unregister so the FIRST empty-agents
+   * notification (before published agents are merged in) does not rip out a
+   * store that was registered prior to that initial notification.
+   */
+  private previousAgentIds;
   constructor({
     runtimeUrl,
     runtimeTransport,
@@ -688,12 +1088,39 @@ declare class CopilotKitCore {
   setAgents__unsafe_dev_only(agents: Record<string, AbstractAgent>): void;
   addAgent__unsafe_dev_only(params: CopilotKitCoreAddAgentParams): void;
   removeAgent__unsafe_dev_only(id: string): void;
+  /**
+   * Register a proxied agent against an existing runtime agent. The proxy is
+   * exposed under `agentId` (local registry id) and routes outbound runtime
+   * requests to `runtimeAgentId`. Throws if `agentId` is already taken.
+   *
+   * Returns the minted proxy and an `unregister` handle for cleanup.
+   *
+   * Use this to mount multiple frontend agents against a single runtime
+   * agent (e.g. one per chat window) without implicit per-thread cloning.
+   *
+   * @example
+   * const { agent, unregister } = copilotkit.registerProxiedAgent({
+   *   agentId: "chat-1",
+   *   runtimeAgentId: "default",
+   * });
+   * // ... <CopilotChat agentId="chat-1" />
+   * // on cleanup:
+   * unregister();
+   */
+  registerProxiedAgent(params: CopilotKitCoreRegisterProxiedAgentParams): CopilotKitCoreRegisterProxiedAgentResult;
   getAgent(id: string): AbstractAgent | undefined;
   /**
    * Context management (delegated to ContextStore)
    */
   addContext(context: Context): string;
   removeContext(id: string): void;
+  /**
+   * Thread store registry (delegated to ThreadStoreRegistry)
+   */
+  registerThreadStore(agentId: string, store: ɵThreadStore): void;
+  unregisterThreadStore(agentId: string): void;
+  getThreadStore(agentId: string): ɵThreadStore | undefined;
+  getThreadStores(): Readonly<Record<string, ɵThreadStore>>;
   /**
    * Suggestions management (delegated to SuggestionEngine)
    */
@@ -742,7 +1169,6 @@ declare class CopilotKitCore {
   getStateByRun(agentId: string, threadId: string, runId: string): State | undefined;
   getRunIdForMessage(agentId: string, threadId: string, messageId: string): string | undefined;
   getRunIdsForThread(agentId: string, threadId: string): string[];
-  subscribeAgentToStateManager(agent: AbstractAgent): void;
   /**
    * Internal method used by RunHandler to build frontend tools
    */
@@ -825,14 +1251,8 @@ declare class SuggestionEngine {
   /**
    * Reload suggestions for a specific agent
    * This triggers generation of new suggestions based on current configs
-   *
-   * @param agentId - The consumer agent ID
-   * @param consumerAgent - Optional: the specific agent instance whose messages should be used
-   *   for availability filtering and context. When running with per-thread clones, the thread
-   *   clone holds the conversation messages; passing it here ensures dynamic suggestions fire
-   *   after the first message even though the registry agent has an empty message list.
    */
-  reloadSuggestions(agentId: string, consumerAgent?: AbstractAgent): void;
+  reloadSuggestions(agentId: string): void;
   /**
    * Clear all suggestions for a specific agent
    */
@@ -897,23 +1317,10 @@ declare class StateManager {
   initialize(): void;
   /**
    * Subscribe to an agent's events to track state and messages.
-   *
-   * Registry agents (subscribed via `onAgentsChanged`) use the bare `agentId`
-   * key so that `unsubscribeFromAgent(agentId)` can remove them when they
-   * are replaced. Per-thread clones (subscribed via `subscribeAgentToStateManager`)
-   * pass `{ isClone: true }` to use a composite `agentId:threadId` key, keeping
-   * their subscription independent of the registry agent's.
-   */
-  subscribeToAgent(agent: AbstractAgent, /** @param isClone When true, uses a composite `agentId:threadId` key for per-thread isolation. */{
-    isClone
-  }?: {
-    isClone?: boolean;
-  }): void;
-  /**
-   * Unsubscribe a registry agent's subscription (bare `agentId` key).
-   * Per-thread clone subscriptions use composite `agentId:threadId` keys and
-   * are replaced (not removed) by subsequent subscribeToAgent(agent, { isClone: true })
-   * calls for the same (agentId, threadId) pair.
+   */
+  subscribeToAgent(agent: AbstractAgent): void;
+  /**
+   * Unsubscribe an agent's subscription.
    */
   unsubscribeFromAgent(agentId: string): void;
   /**
@@ -975,46 +1382,6 @@ declare class StateManager {
   clearThreadState(agentId: string, threadId: string): void;
 }
 //#endregion
-//#region src/agent.d.ts
-type ResolvedRuntimeMode = RuntimeMode$1 | "pending";
-interface ProxiedCopilotRuntimeAgentConfig extends Omit<HttpAgentConfig, "url"> {
-  runtimeUrl?: string;
-  transport?: CopilotRuntimeTransport;
-  credentials?: RequestCredentials;
-  runtimeMode?: ResolvedRuntimeMode;
-  intelligence?: IntelligenceRuntimeInfo$1;
-  capabilities?: AgentCapabilities;
-  debug?: ResolvedDebugConfig;
-}
-declare class ProxiedCopilotRuntimeAgent extends HttpAgent {
-  #private;
-  runtimeUrl?: string;
-  credentials?: RequestCredentials;
-  private transport;
-  private singleEndpointUrl?;
-  private runtimeMode;
-  private intelligence?;
-  private _capabilities?;
-  private delegate?;
-  private runtimeInfoPromise?;
-  constructor(config: ProxiedCopilotRuntimeAgentConfig);
-  get capabilities(): AgentCapabilities | undefined;
-  getCapabilities(): Promise<AgentCapabilities>;
-  detachActiveRun(): Promise<void>;
-  abortRun(): void;
-  connectAgent(parameters?: RunAgentParameters, subscriber?: AgentSubscriber): Promise<RunAgentResult>;
-  connect(input: RunAgentInput): Observable<BaseEvent>;
-  run(input: RunAgentInput): Observable<BaseEvent>;
-  clone(): ProxiedCopilotRuntimeAgent;
-  private resolveDelegate;
-  private ensureRuntimeMode;
-  private fetchRuntimeInfo;
-  private fetchRuntimeInfoAutoDetect;
-  private createSingleRouteRequestInit;
-  private createIntelligenceDelegate;
-  private syncDelegate;
-}
-//#endregion
 //#region src/utils/markdown.d.ts
 declare function completePartialMarkdown(input: string): string;
 //#endregion
@@ -1025,297 +1392,92 @@ interface IntelligenceAgentSharedState {
 declare class AgentThreadLockedError extends Error {
   constructor(threadId?: string);
 }
-interface IntelligenceAgentConfig {
-  /** Phoenix websocket URL, e.g. "ws://localhost:4000/socket" */
-  url: string;
-  /** Runtime REST URL, e.g. "http://localhost:4000" */
-  runtimeUrl: string;
-  /** Agent identifier for REST endpoints */
-  agentId: string;
-  /** Optional params sent on socket connect (e.g. auth token) */
-  socketParams?: Record<string, string>;
-  /** Optional headers sent with REST requests */
-  headers?: Record<string, string>;
-  /** Optional credentials mode for fetch requests */
-  credentials?: RequestCredentials;
-}
-declare class IntelligenceAgent extends AbstractAgent {
-  private config;
-  private socket;
-  private activeChannel;
-  private canonicalRunId;
-  private sharedState;
-  constructor(config: IntelligenceAgentConfig, sharedState?: IntelligenceAgentSharedState);
-  clone(): IntelligenceAgent;
-  /**
-   * Override of AbstractAgent.connectAgent that removes the `verifyEvents` step.
-   *
-   * Background: AbstractAgent's connectAgent pipeline runs events through
-   * `verifyEvents`, which validates that the stream follows the AG-UI protocol
-   * lifecycle — specifically, it expects a RUN_STARTED event before any content
-   * events and a RUN_FINISHED/RUN_ERROR event to complete the stream.
-   *
-   * IntelligenceAgent uses long-lived WebSocket connections rather than
-   * request-scoped SSE streams. When connecting to replay historical messages
-   * for an existing thread, the connection semantics don't map to a single
-   * agent run start/stop cycle. The replayed events may not include
-   * RUN_STARTED/RUN_FINISHED bookends (or may contain events from multiple
-   * past runs), which causes verifyEvents to either never complete or to
-   * error out.
-   *
-   * This override replicates the base connectAgent implementation exactly,
-   * substituting only `transformChunks` (which is still needed for message
-   * reassembly) and omitting `verifyEvents`.
-   *
-   * TODO: Remove this override once AG-UI's AbstractAgent supports opting out
-   * of verifyEvents for transports with different connection life-cycles.
-   */
-  connectAgent(parameters?: RunAgentParameters, subscriber?: AgentSubscriber): Promise<RunAgentResult>;
-  abortRun(): void;
-  /**
-   * Trigger the run via REST, then join the realtime thread channel and relay
-   * server-pushed AG-UI events to the Observable subscriber.
-   */
-  run(input: RunAgentInput): Observable<BaseEvent>;
-  /**
-   * Reconnect to an existing thread by fetching websocket credentials and
-   * joining the realtime thread channel.
-   */
-  protected connect(input: RunAgentInput): Observable<BaseEvent>;
-  /**
-   * Tear down a specific channel + socket pair that belongs to one pipeline.
-   * Only nulls instance references when they still point to the owned resource,
-   * so a concurrent pipeline's resources are never clobbered.
-   */
-  private cleanupOwned;
-  private cleanup;
-  private requestJoinCredentials$;
-  private normalizeJoinCredentials;
-  private observeThread$;
-  private observeThreadSession$;
-  private joinThreadChannel$;
-  private observeSocketHealth$;
-  private observeThreadEvents$;
-  private observeControlEvent$;
-  private observeChannelEvent$;
-  private createThreadNotifications;
-  private buildRuntimeUrl;
-  private createThreadChannelParams;
-  private getLastSeenEventId;
-  private getReconnectCursor;
-  private clearReconnectCursor;
-  private updateLastSeenEventId;
-  private updateLastSeenEventIdFromControl;
-  private readEventId;
-  private readControlEventId;
-  private applyCanonicalRunIdentity;
-  private isSocketReconnectExhaustedError;
-}
-//#endregion
-//#region src/utils/micro-redux.d.ts
-/**
- * The minimal action shape used by this micro-redux implementation.
- */
-interface AnyAction {
-  type: string;
-}
-/**
- * A typed action creator function with a `type` literal and runtime matcher.
- */
-type ActionCreator<Type extends string, Args extends unknown[] = unknown[], Action extends AnyAction & {
-  type: Type;
-} = {
-  type: Type;
-}> = ((...args: Args) => Action) & {
-  type: Type;
-  match(action: AnyAction): action is Action;
-};
-/**
- * Extracts the action type produced by an action creator.
- */
-type ActionFromCreator<T> = T extends ((...args: any[]) => infer A) ? A : never;
-/**
- * Extracts a union of actions produced by a tuple/array of action creators.
- */
-type ActionFromCreators<Creators extends readonly ActionCreator<string, any[], any>[]> = ActionFromCreator<Creators[number]>;
-/**
- * A reducer transforms state in response to actions.
- */
-type Reducer<State, Action extends AnyAction = AnyAction> = (state: State | undefined, action: Action) => State;
-/**
- * A selector derives a value from state.
- */
-type Selector<State, Result> = (state: State) => Result;
-/**
- * Marker config for action creators that accept no payload.
- */
-interface EmptyActionConfig {
-  readonly kind: "empty";
-}
-declare const PROPS_MARKER: unique symbol;
-/**
- * Marker config for action creators that require payload props.
- */
-interface PropsActionConfig<Props extends Record<string, unknown>> {
-  readonly kind: "props";
-  readonly [PROPS_MARKER]?: Props;
-}
-/**
- * Supported action creator config node in an action group.
- */
-type ActionConfig = EmptyActionConfig | PropsActionConfig<Record<string, unknown>>;
-/**
- * Shape of an action group declaration object.
- */
-type ActionGroupConfig = Record<string, ActionConfig>;
-/**
- * Maps an action group declaration to a strongly typed action-creator object.
- */
-type ActionGroupResult<Source extends string, Config extends ActionGroupConfig> = { [K in keyof Config & string]: Config[K] extends PropsActionConfig<infer P> ? ActionCreator<`[${Source}] ${K}`, [P], {
-  type: `[${Source}] ${K}`;
-} & P> : ActionCreator<`[${Source}] ${K}`, [], {
-  type: `[${Source}] ${K}`;
-}> };
-interface OnReducerEntry<State, Action extends AnyAction = AnyAction, Creators extends readonly ActionCreator<string, any[], any>[] = readonly ActionCreator<string, any[], any>[]> {
-  creators: Creators;
-  reducer: (state: State, action: Action) => State;
-}
-type ActionFromOnReducerEntry<TEntry> = TEntry extends OnReducerEntry<any, infer TAction, any> ? TAction : never;
-/**
- * Effect contract for streams that emit actions to dispatch.
- */
-interface DispatchingEffect<State, InputAction extends AnyAction = AnyAction, OutputAction extends AnyAction = AnyAction> {
-  run: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<OutputAction>;
-  dispatch: true;
-}
-/**
- * Effect contract for side-effect-only streams whose emissions are ignored.
- */
-interface NonDispatchingEffect<State, InputAction extends AnyAction = AnyAction> {
-  run: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<unknown>;
-  dispatch: false;
-}
-/**
- * Union of supported effect shapes.
- */
-type Effect<State, InputAction extends AnyAction = AnyAction, OutputAction extends AnyAction = AnyAction> = DispatchingEffect<State, InputAction, OutputAction> | NonDispatchingEffect<State, InputAction>;
-/**
- * Lifecycle actions dispatched by the store.
- */
-type StoreLifecycleAction = {
-  type: "@@micro-redux/init";
-} | {
-  type: "@@micro-redux/stop";
-};
-/**
- * Options for a dispatching effect.
- */
-interface DispatchingEffectOptions {
-  dispatch?: true;
-}
-/**
- * Options for a non-dispatching effect.
- */
-interface NonDispatchingEffectOptions {
-  dispatch: false;
-}
-/**
- * Declares a payload-based action config for `createActionGroup`.
- *
- * @example
- * ```ts
- * const actions = createActionGroup("User", {
- *   loaded: props<{ id: string }>(),
- * });
- * ```
- */
-declare function props<Props extends Record<string, unknown>>(): PropsActionConfig<Props>;
-/**
- * Declares a no-payload action config for `createActionGroup`.
- *
- * @example
- * ```ts
- * const actions = createActionGroup("User", {
- *   reset: empty(),
- * });
- * ```
- */
-declare function empty(): EmptyActionConfig;
-/**
- * Creates a namespaced group of typed action creators.
- *
- * Action types are formatted as: `[Source] actionName`.
- */
-declare function createActionGroup<const Source extends string, const Config extends ActionGroupConfig>(source: Source, config: Config): ActionGroupResult<Source, Config>;
-/**
- * Registers one reducer handler for one or more action creators.
- *
- * @throws Error when called without at least one action creator and reducer.
- */
-declare function on<State, const Creators extends readonly ActionCreator<string, any[], any>[], Action extends ActionFromCreators<Creators>>(...args: [...creators: Creators, reducer: (state: State, action: Action) => State]): OnReducerEntry<State, Action, Creators>;
-/**
- * Creates a reducer from an initial state and `on(...)` handler entries.
- *
- * Unknown action types return the current state unchanged.
- */
-declare function createReducer<State, const Entries extends readonly OnReducerEntry<any, any, any>[]>(initialState: State, ...entries: Entries): Reducer<State, ActionFromOnReducerEntry<Entries[number]>>;
-/**
- * Creates a memoized selector from a single projector.
- */
-declare function createSelector<State, Result>(projector: (state: State) => Result): Selector<State, Result>;
-/**
- * Creates a memoized selector from input selectors and a projector.
- *
- * Memoization uses one-entry caching over the latest input selector values.
- */
-declare function createSelector<State, const Selectors extends readonly Selector<State, unknown>[], Result>(...args: [...selectors: Selectors, projector: (...inputs: { [K in keyof Selectors]: ReturnType<Selectors[K]> }) => Result]): Selector<State, Result>;
-/**
- * RxJS operator that maps state emissions through a selector and suppresses
- * unchanged projected values via reference equality.
- */
-declare function select<State, Result>(selector: Selector<State, Result>): OperatorFunction<State, Result>;
-/**
- * RxJS operator that filters an action stream by action creators and narrows
- * the output action type to the matched creator union.
- *
- * @throws Error when called without at least one action creator.
- */
-declare function ofType<const Creators extends readonly ActionCreator<string, any[], AnyAction>[]>(...creators: Creators): OperatorFunction<AnyAction, ActionFromCreators<Creators>>;
-/**
- * Creates a dispatching effect. Emitted actions are automatically dispatched.
- */
-declare function createEffect<State, InputAction extends AnyAction, OutputAction extends AnyAction>(factory: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<OutputAction>, options?: DispatchingEffectOptions): DispatchingEffect<State, InputAction, OutputAction>;
-/**
- * Creates a non-dispatching effect. Emitted values are ignored.
- */
-declare function createEffect<State, InputAction extends AnyAction>(factory: (actions$: Observable<InputAction>, state$: Observable<State>) => Observable<unknown>, options: NonDispatchingEffectOptions): NonDispatchingEffect<State, InputAction>;
-/**
- * Store interface returned by `createStore`.
- */
-interface Store<State, Action extends AnyAction = AnyAction> {
-  dispatch(action: Action): void;
-  getState(): State;
-  readonly state$: Observable<State>;
-  readonly actions$: Observable<Action | StoreLifecycleAction>;
-  select<Result>(selector: Selector<State, Result>): Observable<Result>;
-  init(): void;
-  stop(): void;
+interface IntelligenceAgentConfig {
+  /** Phoenix websocket URL, e.g. "ws://localhost:4000/socket" */
+  url: string;
+  /** Runtime REST URL, e.g. "http://localhost:4000" */
+  runtimeUrl: string;
+  /** Agent identifier for REST endpoints */
+  agentId: string;
+  /** Optional params sent on socket connect (e.g. auth token) */
+  socketParams?: Record<string, string>;
+  /** Optional headers sent with REST requests */
+  headers?: Record<string, string>;
+  /** Optional credentials mode for fetch requests */
+  credentials?: RequestCredentials;
+}
+declare class IntelligenceAgent extends AbstractAgent {
+  private config;
+  private socket;
+  private activeChannel;
+  private canonicalRunId;
+  private sharedState;
+  constructor(config: IntelligenceAgentConfig, sharedState?: IntelligenceAgentSharedState);
+  clone(): IntelligenceAgent;
+  /**
+   * Override of AbstractAgent.connectAgent that removes the `verifyEvents` step.
+   *
+   * Background: AbstractAgent's connectAgent pipeline runs events through
+   * `verifyEvents`, which validates that the stream follows the AG-UI protocol
+   * lifecycle — specifically, it expects a RUN_STARTED event before any content
+   * events and a RUN_FINISHED/RUN_ERROR event to complete the stream.
+   *
+   * IntelligenceAgent uses long-lived WebSocket connections rather than
+   * request-scoped SSE streams. When connecting to replay historical messages
+   * for an existing thread, the connection semantics don't map to a single
+   * agent run start/stop cycle. The replayed events may not include
+   * RUN_STARTED/RUN_FINISHED bookends (or may contain events from multiple
+   * past runs), which causes verifyEvents to either never complete or to
+   * error out.
+   *
+   * This override replicates the base connectAgent implementation exactly,
+   * substituting only `transformChunks` (which is still needed for message
+   * reassembly) and omitting `verifyEvents`.
+   *
+   * TODO: Remove this override once AG-UI's AbstractAgent supports opting out
+   * of verifyEvents for transports with different connection life-cycles.
+   */
+  connectAgent(parameters?: RunAgentParameters, subscriber?: AgentSubscriber): Promise<RunAgentResult>;
+  abortRun(): void;
+  /**
+   * Trigger the run via REST, then join the realtime thread channel and relay
+   * server-pushed AG-UI events to the Observable subscriber.
+   */
+  run(input: RunAgentInput): Observable<BaseEvent>;
+  /**
+   * Reconnect to an existing thread by fetching websocket credentials and
+   * joining the realtime thread channel.
+   */
+  protected connect(input: RunAgentInput): Observable<BaseEvent>;
+  /**
+   * Tear down a specific channel + socket pair that belongs to one pipeline.
+   * Only nulls instance references when they still point to the owned resource,
+   * so a concurrent pipeline's resources are never clobbered.
+   */
+  private cleanupOwned;
+  private cleanup;
+  private requestJoinCredentials$;
+  private normalizeJoinCredentials;
+  private observeThread$;
+  private observeThreadSession$;
+  private joinThreadChannel$;
+  private observeSocketHealth$;
+  private observeThreadEvents$;
+  private observeControlEvent$;
+  private observeChannelEvent$;
+  private createThreadNotifications;
+  private buildRuntimeUrl;
+  private createThreadChannelParams;
+  private getLastSeenEventId;
+  private getReconnectCursor;
+  private clearReconnectCursor;
+  private updateLastSeenEventId;
+  private updateLastSeenEventIdFromControl;
+  private readEventId;
+  private readControlEventId;
+  private applyCanonicalRunIdentity;
+  private isSocketReconnectExhaustedError;
 }
-/**
- * Creates a small observable store with reducer + effects.
- *
- * Behavior:
- * - `init()` starts effects and dispatches `@@micro-redux/init`.
- * - `stop()` dispatches `@@micro-redux/stop` and unsubscribes all effects.
- * - Effect action observation is scheduled on `asapScheduler` to avoid
- *   synchronous re-entrancy in the effect loop.
- * - Any effect error triggers fail-fast teardown and errors both `actions$`
- *   and `state$`.
- */
-declare function createStore<State, Action extends AnyAction = AnyAction>(options: {
-  reducer: Reducer<State, Action | StoreLifecycleAction>;
-  effects?: Array<Effect<State, Action | StoreLifecycleAction, Action>>;
-}): Store<State, Action>;
 //#endregion
 //#region src/utils/phoenix-observable.d.ts
 /**
@@ -1432,80 +1594,5 @@ declare function ɵobservePhoenixSocketSignals$(socket$: Observable<ɵPhoenixSoc
  */
 declare function ɵobservePhoenixSocketHealth$(socketSignals$: Observable<ɵPhoenixSocketSignal>, maxConsecutiveErrors: number): Observable<never>;
 //#endregion
-//#region src/threads.d.ts
-interface ThreadRecord {
-  id: string;
-  organizationId: string;
-  agentId: string;
-  createdById: string;
-  name: string | null;
-  archived: boolean;
-  createdAt: string;
-  updatedAt: string;
-  lastRunAt?: string;
-}
-interface ThreadRuntimeContext {
-  runtimeUrl: string;
-  headers: Record<string, string>;
-  wsUrl?: string;
-  agentId: string;
-  includeArchived?: boolean;
-  limit?: number;
-}
-type ThreadMetadataEvent = {
-  operation: "created" | "renamed" | "archived" | "unarchived" | "updated";
-  threadId: string;
-  userId: string;
-  organizationId: string;
-  occurredAt: string;
-  thread: ThreadRecord;
-} | {
-  operation: "deleted";
-  threadId: string;
-  userId: string;
-  organizationId: string;
-  occurredAt: string;
-  deleted: {
-    id: string;
-  };
-};
-interface ThreadEnvironment {
-  fetch: typeof fetch;
-}
-interface ThreadState {
-  threads: ThreadRecord[];
-  isLoading: boolean;
-  isFetchingNextPage: boolean;
-  error: Error | null;
-  context: ThreadRuntimeContext | null;
-  sessionId: number;
-  metadataCredentialsRequested: boolean;
-  metadataJoinCode: string | null;
-  nextCursor: string | null;
-}
-interface ThreadStore {
-  start(): void;
-  stop(): void;
-  setContext(context: ThreadRuntimeContext | null): void;
-  fetchNextPage(): void;
-  renameThread(threadId: string, name: string): Promise<void>;
-  archiveThread(threadId: string): Promise<void>;
-  deleteThread(threadId: string): Promise<void>;
-  getState(): ThreadState;
-  select: Store<ThreadState>["select"];
-}
-declare function createThreadStore(environment: ThreadEnvironment): ThreadStore;
-type ɵThread = ThreadRecord;
-type ɵThreadRuntimeContext = ThreadRuntimeContext;
-type ɵThreadMetadataEvent = ThreadMetadataEvent;
-type ɵThreadEnvironment = ThreadEnvironment;
-type ɵThreadStore = ThreadStore;
-declare const ɵthreadAdapterEvents: any;
-declare const ɵselectThreads: any;
-declare const ɵselectThreadsIsLoading: any;
-declare const ɵselectThreadsError: any;
-declare const ɵselectHasNextPage: any;
-declare const ɵselectIsFetchingNextPage: any;
-//#endregion
-export { ActionConfig, ActionCreator, ActionFromCreator, ActionFromCreators, ActionGroupConfig, ActionGroupResult, AgentRegistry, AgentThreadLockedError, AnyAction, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, CopilotKitCoreErrorCode, CopilotKitCoreFriendsAccess, CopilotKitCoreGetSuggestionsResult, type CopilotKitCoreGetToolParams, type CopilotKitCoreRunAgentParams, type CopilotKitCoreRunToolParams, type CopilotKitCoreRunToolResult, CopilotKitCoreRuntimeConnectionStatus, CopilotKitCoreStopAgentParams, CopilotKitCoreSubscriber, CopilotKitCoreSubscription, CopilotRuntimeTransport, DispatchingEffect, DispatchingEffectOptions, DynamicSuggestionsConfig, Effect, EmptyActionConfig, FrontendTool, FrontendToolHandlerContext, IntelligenceAgent, IntelligenceAgentConfig, type IntelligenceRuntimeInfo, NonDispatchingEffect, NonDispatchingEffectOptions, PropsActionConfig, ProxiedCopilotRuntimeAgent, ProxiedCopilotRuntimeAgentConfig, Reducer, RunHandler, type RuntimeLicenseStatus, type RuntimeMode, Selector, StateManager, StaticSuggestionsConfig, Store, StoreLifecycleAction, SubscribeToAgentOptions, SubscribeToAgentSubscriber, Suggestion, SuggestionAvailability, SuggestionEngine, SuggestionsConfig, ToolCallStatus, completePartialMarkdown, createActionGroup, createEffect, createReducer, createSelector, createStore, empty, ensureObjectArgs, ofType, on, parseToolArguments, props, select, ɵPhoenixChannelLike, ɵPhoenixChannelOptions, ɵPhoenixChannelSession, ɵPhoenixJoinOutcome, ɵPhoenixPushLike, ɵPhoenixSocketLike, ɵPhoenixSocketOptions, ɵPhoenixSocketSession, ɵPhoenixSocketSignal, ɵThread, ɵThreadEnvironment, ɵThreadMetadataEvent, ɵThreadRuntimeContext, ɵThreadStore, createThreadStore as ɵcreateThreadStore, ɵjoinPhoenixChannel$, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents };
+export { ActionConfig, ActionCreator, ActionFromCreator, ActionFromCreators, ActionGroupConfig, ActionGroupResult, AgentRegistry, AgentThreadLockedError, AnyAction, ContextStore, CopilotKitCore, type CopilotKitCoreAddAgentParams, CopilotKitCoreConfig, type CopilotKitCoreConnectAgentParams, CopilotKitCoreErrorCode, CopilotKitCoreFriendsAccess, CopilotKitCoreGetSuggestionsResult, type CopilotKitCoreGetToolParams, type CopilotKitCoreRegisterProxiedAgentParams, type CopilotKitCoreRegisterProxiedAgentResult, type CopilotKitCoreRunAgentParams, type CopilotKitCoreRunToolParams, type CopilotKitCoreRunToolResult, CopilotKitCoreRuntimeConnectionStatus, CopilotKitCoreStopAgentParams, CopilotKitCoreSubscriber, CopilotKitCoreSubscription, CopilotRuntimeTransport, DispatchingEffect, DispatchingEffectOptions, DynamicSuggestionsConfig, Effect, EmptyActionConfig, FrontendTool, FrontendToolHandlerContext, IntelligenceAgent, IntelligenceAgentConfig, type IntelligenceRuntimeInfo, NonDispatchingEffect, NonDispatchingEffectOptions, PropsActionConfig, ProxiedCopilotRuntimeAgent, ProxiedCopilotRuntimeAgentConfig, Reducer, RunHandler, type RuntimeLicenseStatus, type RuntimeMode, Selector, StateManager, StaticSuggestionsConfig, Store, StoreLifecycleAction, SubscribeToAgentOptions, SubscribeToAgentSubscriber, Suggestion, SuggestionAvailability, SuggestionEngine, SuggestionsConfig, ToolCallStatus, completePartialMarkdown, createActionGroup, createEffect, createReducer, createSelector, createStore, empty, ensureObjectArgs, ofType, on, parseToolArguments, props, select, ɵMAX_SOCKET_RETRIES, ɵPhoenixChannelLike, ɵPhoenixChannelOptions, ɵPhoenixChannelSession, ɵPhoenixJoinOutcome, ɵPhoenixPushLike, ɵPhoenixSocketLike, ɵPhoenixSocketOptions, ɵPhoenixSocketSession, ɵPhoenixSocketSignal, ɵThread, ɵThreadEnvironment, ɵThreadMetadataEvent, ɵThreadRuntimeContext, ɵThreadStore, createThreadStore as ɵcreateThreadStore, ɵjoinPhoenixChannel$, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents };
 //# sourceMappingURL=index.d.cts.map