@copilotkit/core 1.62.1 → 1.62.2-canary.1784333495

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as _ag_ui_client0 from "@ag-ui/client";
 import { AbstractAgent, AgentCapabilities, AgentSubscriber, BaseEvent, Context, HttpAgent, HttpAgentConfig, Message, ResumeEntry, RunAgentInput, RunAgentParameters, RunAgentResult, State, Tool, ToolCall } from "@ag-ui/client";
 import { DebugConfig, IntelligenceRuntimeInfo, IntelligenceRuntimeInfo as IntelligenceRuntimeInfo$1, ResolvedDebugConfig, RuntimeLicenseStatus, RuntimeLicenseStatus as RuntimeLicenseStatus$1, RuntimeMode, RuntimeMode as RuntimeMode$1, StandardSchemaV1, ThreadEndpointRuntimeInfo, ThreadEndpointRuntimeInfo as ThreadEndpointRuntimeInfo$1 } from "@copilotkit/shared";
-import { Observable, OperatorFunction } from "rxjs";
+import { Observable, OperatorFunction, Subscription } from "rxjs";
 
 //#region src/types.d.ts
 /**
@@ -388,6 +388,11 @@ declare class ContextStore {
 interface CopilotKitCoreRunAgentParams {
   agent: AbstractAgent;
   forwardedProps?: Record<string, unknown>;
+  /**
+   * Optional caller-supplied run identifier forwarded to the underlying AG-UI
+   * agent. When omitted, the agent creates one.
+   */
+  runId?: string;
   /**
    * Per-interrupt responses addressing every open AG-UI interrupt from the
    * previous run. Forwarded to the agent as the standard `resume` array.
@@ -466,7 +471,9 @@ declare class RunHandler {
    * downstream churn into duplicate `cpki_event_id` rows in the
    * inspector and intermittent "Message not found" toasts.
    */
-  private _lastConnectedThreadId;
+  private _lastConnectedThreadIdsByAgent;
+  private _anonymousAgentIds;
+  private _nextAnonymousAgentId;
   constructor(core: CopilotKitCore);
   /**
    * Abort the current run. Called by `CopilotKitCore.stopAgent()` to signal
@@ -479,6 +486,12 @@ declare class RunHandler {
    * Centralises the single unavoidable cast so call-sites stay clean.
    */
   private get _internal();
+  /**
+   * Return a stable restore-tracking key for the logical agent being
+   * connected. Named agents share their last-thread marker across proxy
+   * instances; anonymous agents fall back to object identity.
+   */
+  private getConnectRestoreKey;
   /**
    * Get all tools as a readonly array
    */
@@ -517,7 +530,8 @@ declare class RunHandler {
   runAgent({
     agent,
     forwardedProps,
-    resume
+    resume,
+    runId
   }: CopilotKitCoreRunAgentParams): Promise<RunAgentResult>;
   /**
    * Process agent result and execute tools
@@ -577,6 +591,62 @@ declare function ensureObjectArgs(parsed: unknown, toolName: string): Record<str
  */
 declare function parseToolArguments(rawArgs: unknown, toolName: string): Record<string, unknown>;
 //#endregion
+//#region src/core/subagent-registry.d.ts
+type SubagentStatus = "running" | "finished" | "error";
+/**
+ * The observed lifecycle state of a single subagent invocation, keyed in the
+ * registry by its `subagentId`. `name`/`description` come from SUBAGENT_STARTED
+ * so the UI can show a friendly label instead of the opaque id.
+ */
+interface SubagentState {
+  subagentId: string;
+  name: string;
+  description?: string;
+  parentSubagentId?: string;
+  status: SubagentStatus;
+  /** Set only when `status === "error"` (from SUBAGENT_ERROR.message). */
+  error?: string;
+}
+/**
+ * Tracks subagent lifecycle events (SUBAGENT_STARTED / FINISHED / ERROR) per
+ * owning agent so consumers can resolve a message's `subagentId` to a name,
+ * description, and running status.
+ *
+ * Modeled on {@link SuggestionEngine}: an in-memory `Record` keyed by (owning)
+ * agentId, mutated from streamed AG-UI events, made reactive by calling
+ * `notifySubscribers(onSubagentsChanged)` after every change. It owns its own
+ * per-agent `agent.subscribe` (like {@link StateManager}) so it is fully
+ * self-contained and adds no coupling to the state/message tracking path.
+ *
+ * No-op for runs without subagents (a normal LangGraph run never emits
+ * SUBAGENT_* events), so the registry simply stays empty.
+ */
+declare class SubagentRegistry {
+  private core;
+  private _subagents;
+  private agentSubscriptions;
+  constructor(core: CopilotKitCore);
+  /**
+   * Subscribe to an agent's subagent lifecycle events. Idempotent per agentId:
+   * an existing subscription for the same agent is revoked and replaced.
+   */
+  subscribeToAgent(agent: AbstractAgent): void;
+  /**
+   * Unsubscribe an agent's subscription (symmetric with StateManager cleanup).
+   */
+  unsubscribeFromAgent(agentId: string): void;
+  /**
+   * Get the subagents observed for an owning agent, keyed by subagentId.
+   * Returns a fresh shallow copy each call so consumers (and React state) see
+   * a new reference when anything changed.
+   */
+  getSubagents(agentId: string): Record<string, SubagentState>;
+  private handleStarted;
+  private handleFinished;
+  private handleError;
+  private notifySubagentsChanged;
+}
+//#endregion
 //#region src/utils/micro-redux.d.ts
 /**
  * The minimal action shape used by this micro-redux implementation.
@@ -819,6 +889,18 @@ type ThreadMetadataEvent = {
     id: string;
   };
 };
+/**
+ * Internal notification emitted when Intelligence observes new run activity
+ * for a thread without changing that thread's metadata row.
+ */
+type ThreadRunActivityNotification = {
+  type: "thread_run_activity";
+  threadId: string;
+  agentId?: string;
+  runId?: string;
+  eventType: string;
+  latestEventId?: string;
+};
 interface ThreadEnvironment {
   fetch: typeof fetch;
   /**
@@ -836,6 +918,14 @@ interface ThreadState {
   isLoading: boolean;
   isFetchingNextPage: boolean;
   error: Error | null;
+  /**
+   * Error from the most recent failed next-page (`fetchMore`) load, or `null`.
+   * Tracked SEPARATELY from `error` so a paginated-load failure surfaces an
+   * inline "couldn't load more" affordance without replacing the already-loaded
+   * list with a full-panel error. Cleared when a fetch-more is retried or when
+   * one succeeds; reset on context change / stop.
+   */
+  fetchMoreError: Error | null;
   context: ThreadRuntimeContext | null;
   sessionId: number;
   metadataCredentialsRequested: boolean;
@@ -861,6 +951,7 @@ interface ThreadSelectors {
   threads: (state: ThreadState) => ThreadRecord[];
   isLoading: (state: ThreadState) => boolean;
   error: (state: ThreadState) => Error | null;
+  fetchMoreError: (state: ThreadState) => Error | null;
   hasNextPage: (state: ThreadState) => boolean;
   isFetchingNextPage: (state: ThreadState) => boolean;
   isMutating: (state: ThreadState) => boolean;
@@ -904,6 +995,11 @@ interface ThreadStore {
   archiveThread(threadId: string): Promise<void>;
   unarchiveThread(threadId: string): Promise<void>;
   deleteThread(threadId: string): Promise<void>;
+  /**
+   * Subscribes to synthetic run-activity notifications without changing the
+   * thread metadata list.
+   */
+  subscribeToRunActivity?(callback: (notification: ThreadRunActivityNotification) => void): Subscription;
   getState(): ThreadState;
   /**
    * Returns a stable initial snapshot for server-side rendering.
@@ -963,6 +1059,7 @@ declare const ɵcreateThreadSelectors: typeof createThreadSelectors;
 declare const ɵselectThreads: (state: ThreadState) => ThreadRecord[];
 declare const ɵselectThreadsIsLoading: (state: ThreadState) => boolean;
 declare const ɵselectThreadsError: (state: ThreadState) => Error | null;
+declare const ɵselectFetchMoreError: (state: ThreadState) => Error | null;
 declare const ɵselectHasNextPage: (state: ThreadState) => boolean;
 declare const ɵselectIsFetchingNextPage: (state: ThreadState) => boolean;
 declare const ɵselectIsMutating: (state: ThreadState) => boolean;
@@ -974,6 +1071,383 @@ declare const ɵselectIsMutating: (state: ThreadState) => boolean;
  */
 declare const ɵMAX_SOCKET_RETRIES = 5;
 //#endregion
+//#region src/memory-errors.d.ts
+/**
+ * Memory error registry — stable codes for the errors the memory store throws.
+ *
+ * The memory store (`memory.ts`) used to throw bare `new Error("Failed to fetch
+ * memories: 500")` / `"Request timed out"` / `"Request failed: <status>"`. Those
+ * reach the `error` selector (and the consumer UI via `useMemories` /
+ * `injectMemories`) verbatim, with no machine-readable `code`/`category`/
+ * `retryable`, so they cannot be grouped in observability or branched on by
+ * consumers.
+ *
+ * Per the repo's error-handling architecture standard (AGENTS.md: "Each project
+ * must maintain an explicit error registry"), this file is the explicit registry
+ * for the memory feature. It is deliberately scoped to memory — not a repo-wide
+ * registry refactor — because `packages/core` has no pre-existing
+ * code/category/retryable registry convention to plug into (the runtime's
+ * `lib/error-messages.ts` is a message-templating table, not a typed
+ * code/category/retryable registry). It mirrors the existing
+ * `AgentThreadLockedError extends Error` precedent in
+ * `intelligence-agent.ts`: a real `Error` subclass so `instanceof Error` holds
+ * and the public `MemoryState.error: Error | null` contract is preserved.
+ *
+ * `docsPath` is recorded per entry per the standard; there is no
+ * `docs/errors/<project>.md` in this repo, so this docblock plus the registry
+ * are the source of truth.
+ *
+ * Each registry entry carries:
+ * - `code`: stable identifier (e.g. `MEMORY_LIST_FAILED`).
+ * - `category`: one of the standard categories
+ *   (`validation`|`auth`|`permission`|`not_found`|`conflict`|`rate_limit`|`internal`|`dependency`).
+ * - `retryable`: whether a retry could plausibly succeed (timeouts + transient
+ *   dependency failures are retryable; client-caused 4xx are not).
+ * - `message`: the default human-readable message (callers may override with a
+ *   status-bearing string to preserve the prior wording).
+ * - `docsPath`: documentation pointer for the code.
+ */
+/** Standard error categories from the repo error-handling architecture. */
+type MemoryErrorCategory = "validation" | "auth" | "permission" | "not_found" | "conflict" | "rate_limit" | "internal" | "dependency";
+/** Stable codes for the memory store's surfaced errors. */
+type MemoryErrorCode = "MEMORY_LIST_FAILED" | "MEMORY_CREDENTIALS_FAILED" | "MEMORY_MUTATION_FAILED" | "MEMORY_REQUEST_TIMEOUT";
+/** A single registry entry describing one memory error code. */
+interface MemoryErrorRegistryEntry {
+  readonly code: MemoryErrorCode;
+  readonly category: MemoryErrorCategory;
+  readonly retryable: boolean;
+  readonly message: string;
+  readonly docsPath: string;
+}
+/**
+ * The memory error registry: the single source of truth for memory error
+ * metadata. Keyed by `code` so a code maps to exactly one category/retryable
+ * default.
+ *
+ * Categories/retryable rationale:
+ * - List/credentials/mutation failures are `dependency` (the runtime/platform
+ *   the store calls failed). A 5xx is transient (`retryable: true`); a 4xx is
+ *   caller-caused, so the helpers below downgrade those to non-retryable.
+ * - Timeouts are `dependency` and `retryable: true` (the request may simply be
+ *   slow).
+ */
+declare const MEMORY_ERROR_REGISTRY: Readonly<Record<MemoryErrorCode, MemoryErrorRegistryEntry>>;
+/**
+ * An `Error` carrying a stable memory error `code`, `category`, and `retryable`
+ * flag so consumers and observability can branch on it without string-matching
+ * the message.
+ *
+ * It is a real `Error` subclass: `instanceof Error` is true, so the public
+ * `MemoryState.error: Error | null` contract (and the `error: Error | null`
+ * surfaced by `useMemories` / `injectMemories`) holds unchanged. Existing
+ * consumers that only read `.message` keep working; the richer fields are
+ * additive.
+ */
+declare class MemoryError extends Error {
+  /** Stable, machine-readable error identifier. */
+  readonly code: MemoryErrorCode;
+  /** Coarse error category for grouping/observability. */
+  readonly category: MemoryErrorCategory;
+  /** Whether retrying the operation could plausibly succeed. */
+  readonly retryable: boolean;
+  /**
+   * @param code - Registry code identifying this error.
+   * @param options - Optional overrides:
+   *   - `message`: human-readable message (defaults to the registry message;
+   *     callers pass a status-bearing string to preserve prior wording).
+   *   - `retryable`: overrides the registry default (e.g. a 4xx list failure is
+   *     not retryable even though the code's default is).
+   *   - `cause`: the underlying error, preserved for debugging.
+   */
+  constructor(code: MemoryErrorCode, options?: {
+    message?: string;
+    retryable?: boolean;
+    cause?: unknown;
+  });
+}
+/**
+ * Narrows an HTTP status to whether the failure is worth retrying: a 5xx (or a
+ * missing/0 status) is a transient dependency failure and retryable; a 4xx is
+ * caller-caused and not. Used so a `MEMORY_LIST_FAILED`/`MEMORY_MUTATION_FAILED`
+ * carries an accurate `retryable` flag derived from the response status.
+ */
+declare function isRetryableStatus(status: number): boolean;
+//#endregion
+//#region src/memory.d.ts
+/** Public, customer-facing memory kind vocabulary (single taxonomy, no mapping). */
+type MemoryKind = "topical" | "episodic" | "operational";
+/** Visibility scope of a memory. */
+type MemoryScope = "user" | "project";
+/**
+ * Health of the realtime (`user_meta:memories:<code>`) connection that streams
+ * live `memory_metadata` deltas. Distinct from `available`/`error`, which
+ * describe the REST list route: `realtimeStatus` reports ONLY whether the
+ * realtime socket/channel is live so the UI can stop showing a "live" indicator
+ * over a frozen snapshot once the socket permanently gives up.
+ *
+ * - `"connecting"` — fetching join credentials / opening the socket / joining
+ *   the channel (the default, and the state every `contextChanged`/`stopped`
+ *   resets to).
+ * - `"connected"` — the channel join succeeded; live deltas are flowing.
+ * - `"unavailable"` — the socket exhausted its retries or the join failed
+ *   permanently; the snapshot is frozen and no deltas will arrive. This is a
+ *   silent degrade for `available`/`error` (those stay untouched) — only this
+ *   signal flips.
+ */
+type MemoryRealtimeStatus = "connecting" | "connected" | "unavailable";
+/**
+ * A memory as projected across the public REST/realtime boundary — the minimal
+ * shape the SDK surfaces. Mirrors the server's `PublicMemory` projection.
+ */
+interface Memory {
+  id: string;
+  kind: MemoryKind;
+  scope: MemoryScope;
+  content: string;
+  sourceThreadIds: readonly string[];
+  invalidatedAt: string | null;
+}
+/** Input for creating a memory; `scope` defaults to `"user"` (v1 is user-scoped). */
+interface NewMemory {
+  content: string;
+  kind: MemoryKind;
+  scope?: MemoryScope;
+  sourceThreadIds?: readonly string[];
+}
+/**
+ * New values for superseding (updating) a memory — same shape as create.
+ *
+ * Supersede is a FULL replacement, not a partial patch: this is the complete
+ * definition of the new memory that replaces the old one. `content` and `kind`
+ * are required and must be re-supplied, and an omitted `sourceThreadIds` resets
+ * the new memory's source threads to `[]` — it does NOT preserve the prior
+ * memory's value.
+ */
+type MemoryChanges = NewMemory;
+/** Outcome of a mutation, tracked so the caller's promise resolves/rejects. */
+type MemoryMutationOutcome = {
+  requestId: string;
+  sessionId: number;
+  ok: true;
+  memory: Memory | null;
+} | {
+  requestId: string;
+  sessionId: number;
+  ok: false;
+  error: Error;
+};
+/**
+ * Runtime wiring for the memory store: where to reach the REST surface and the
+ * headers (auth + `X-Cpki-User-Id`) to send. Scoped to the current user; v1
+ * surfaces user-scoped memories only.
+ */
+interface MemoryRuntimeContext {
+  runtimeUrl: string;
+  /** WebSocket URL for the realtime gateway (e.g. `wss://gw.example.com/client`). */
+  wsUrl: string;
+  headers: Record<string, string>;
+  includeInvalidated?: boolean;
+}
+/**
+ * In-memory state for the memory store. Session-guarded like the thread store:
+ * `sessionId` is bumped whenever the runtime context changes so that responses
+ * and realtime deltas from a previous context are ignored.
+ */
+interface MemoryState {
+  memories: Memory[];
+  isLoading: boolean;
+  inFlightMutationCount: number;
+  error: Error | null;
+  context: MemoryRuntimeContext | null;
+  sessionId: number;
+  available: boolean;
+  realtimeStatus: MemoryRealtimeStatus;
+}
+declare const memoryDomainEvents: ActionGroupResult<"Memory Domain", {
+  readonly memoryUpserted: PropsActionConfig<{
+    sessionId: number;
+    memory: Memory;
+  }>;
+  readonly memoryInvalidated: PropsActionConfig<{
+    sessionId: number;
+    memoryId: string;
+  }>;
+  readonly realtimeConnecting: PropsActionConfig<{
+    sessionId: number;
+  }>;
+  readonly realtimeConnected: PropsActionConfig<{
+    sessionId: number;
+  }>;
+  readonly realtimeUnavailable: PropsActionConfig<{
+    sessionId: number;
+  }>;
+}>;
+/** Wire shape of a memory inside a `memory_metadata` payload (carries tenant ids). */
+interface MemoryMetadataPayloadMemory extends Memory {
+  organizationId: string;
+  projectId: string;
+}
+/**
+ * The realtime `memory_metadata` event broadcast on the `user_meta` channel:
+ * `created`/`updated` carry the full memory, `invalidated` carries only its id.
+ * The gateway strips `userId` before broadcasting and only delivers
+ * user-scoped memories, so this is always the current user's stream.
+ */
+type MemoryMetadataEvent = {
+  operation: "created" | "updated";
+  memoryId: string;
+  organizationId: string;
+  projectId: string;
+  occurredAt: string;
+  memory: MemoryMetadataPayloadMemory;
+} | {
+  operation: "invalidated";
+  memoryId: string;
+  organizationId: string;
+  projectId: string;
+  occurredAt: string;
+  invalidated: {
+    id: string;
+  };
+};
+/**
+ * Maps a realtime `memory_metadata` event to the domain action that applies it:
+ * `created`/`updated` upsert the projected memory, `invalidated` removes it by
+ * id. Carries the current `sessionId` so the reducer's session guard can drop
+ * deltas left over from a previous context.
+ */
+declare function mapMemoryMetadataEvent(event: MemoryMetadataEvent, sessionId: number): ReturnType<typeof memoryDomainEvents.memoryUpserted> | ReturnType<typeof memoryDomainEvents.memoryInvalidated>;
+/**
+ * Dependencies injected into the memory store. The store opens its own
+ * `user_meta:memories:<joinCode>` socket/channel and does not share the
+ * thread store's socket, so only a `fetch` implementation is required.
+ */
+interface MemoryEnvironment {
+  fetch: typeof fetch;
+}
+interface MemoryStore {
+  start(): void;
+  stop(): void;
+  setContext(context: MemoryRuntimeContext | null): void;
+  /**
+   * Re-fetches the REST snapshot without clearing the current list. Resolves
+   * once the re-pull settles (success or failure) for the current context, so
+   * callers (e.g. a `useMemories` `refresh()`) can await it. Resolves
+   * immediately when no context is set.
+   */
+  refresh(): Promise<void>;
+  /** Creates a memory; resolves to the stored memory (server-authoritative). */
+  addMemory(input: NewMemory): Promise<Memory>;
+  /** Supersedes a memory; resolves to the new memory (its id changes). */
+  updateMemory(id: string, changes: MemoryChanges): Promise<Memory>;
+  /** Retires a memory (non-lossy delete). */
+  removeMemory(id: string): Promise<void>;
+  getState(): MemoryState;
+  /**
+   * Stable, render-safe state for SSR/prerender. React's
+   * `useSyncExternalStore` requires a `getServerSnapshot` during SSR/prerender
+   * (e.g. Next.js); without one React throws "Missing getServerSnapshot". The
+   * returned reference is stable across calls so React does not loop. There is
+   * no client-side memory data during prerender, so this is the empty initial
+   * state (no memories, not loading, no error).
+   */
+  getServerState(): MemoryState;
+  select: Store<MemoryState>["select"];
+}
+/**
+ * Creates the framework-agnostic memory store: a REST snapshot on `setContext`,
+ * server-authoritative add/update/remove mutations, and realtime
+ * `memory_metadata` deltas off the injected `user_meta` event source — all
+ * reduced into observable state.
+ */
+declare function createMemoryStore(environment: MemoryEnvironment): MemoryStore;
+type ɵMemoryState = MemoryState;
+type ɵMemoryRuntimeContext = MemoryRuntimeContext;
+type ɵMemoryMetadataEvent = MemoryMetadataEvent;
+type ɵMemoryEnvironment = MemoryEnvironment;
+type ɵMemoryStore = MemoryStore;
+declare const ɵmemoryAdapterEvents: ActionGroupResult<"Memory Adapter", {
+  readonly started: EmptyActionConfig;
+  readonly stopped: EmptyActionConfig;
+  readonly contextChanged: PropsActionConfig<{
+    context: MemoryRuntimeContext | null;
+  }>;
+  readonly addRequested: PropsActionConfig<{
+    requestId: string;
+    input: NewMemory;
+  }>;
+  readonly updateRequested: PropsActionConfig<{
+    requestId: string;
+    id: string;
+    changes: MemoryChanges;
+  }>;
+  readonly removeRequested: PropsActionConfig<{
+    requestId: string;
+    id: string;
+  }>;
+}>;
+declare const ɵmemoryRestEvents: ActionGroupResult<"Memory REST", {
+  readonly listRequested: PropsActionConfig<{
+    sessionId: number;
+  }>;
+  readonly listSucceeded: PropsActionConfig<{
+    sessionId: number;
+    memories: Memory[];
+  }>;
+  readonly listFailed: PropsActionConfig<{
+    sessionId: number;
+    error: Error;
+  }>;
+  readonly listUnavailable: PropsActionConfig<{
+    sessionId: number;
+  }>;
+  readonly mutationFinished: PropsActionConfig<{
+    outcome: MemoryMutationOutcome;
+  }>;
+  readonly credentialsRequested: PropsActionConfig<{
+    sessionId: number;
+  }>;
+  readonly credentialsSucceeded: PropsActionConfig<{
+    sessionId: number;
+    joinToken: string;
+    joinCode: string;
+  }>;
+  readonly credentialsFailed: PropsActionConfig<{
+    sessionId: number;
+    error: Error;
+  }>;
+  readonly credentialsUnavailable: PropsActionConfig<{
+    sessionId: number;
+  }>;
+}>;
+declare const ɵmemoryDomainEvents: ActionGroupResult<"Memory Domain", {
+  readonly memoryUpserted: PropsActionConfig<{
+    sessionId: number;
+    memory: Memory;
+  }>;
+  readonly memoryInvalidated: PropsActionConfig<{
+    sessionId: number;
+    memoryId: string;
+  }>;
+  readonly realtimeConnecting: PropsActionConfig<{
+    sessionId: number;
+  }>;
+  readonly realtimeConnected: PropsActionConfig<{
+    sessionId: number;
+  }>;
+  readonly realtimeUnavailable: PropsActionConfig<{
+    sessionId: number;
+  }>;
+}>;
+declare const ɵmemoryReducer: Reducer<MemoryState>;
+declare const ɵmapMemoryMetadataEvent: typeof mapMemoryMetadataEvent;
+declare const ɵselectMemories: Selector<MemoryState, Memory[]>;
+declare const ɵselectMemoriesIsLoading: Selector<MemoryState, boolean>;
+declare const ɵselectMemoriesError: Selector<MemoryState, Error | null>;
+declare const ɵselectMemoriesIsMutating: Selector<MemoryState, boolean>;
+declare const ɵselectMemoriesAvailable: Selector<MemoryState, boolean>;
+declare const ɵselectMemoriesRealtimeStatus: Selector<MemoryState, MemoryRealtimeStatus>;
+//#endregion
 //#region src/core/core.d.ts
 /** Configuration options for `CopilotKitCore`. */
 interface CopilotKitCoreConfig {
@@ -1096,6 +1570,11 @@ interface CopilotKitCoreSubscriber {
     copilotkit: CopilotKitCore;
     agentId: string;
   }) => void | Promise<void>;
+  onSubagentsChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    agentId: string;
+    subagents: Readonly<Record<string, SubagentState>>;
+  }) => void | Promise<void>;
   onPropertiesChanged?: (event: {
     copilotkit: CopilotKitCore;
     properties: Readonly<Record<string, unknown>>;
@@ -1244,7 +1723,15 @@ declare class CopilotKitCore {
   private suggestionEngine;
   private runHandler;
   private stateManager;
+  private subagentRegistry;
   private threadStoreRegistry;
+  /**
+   * The single core-owned memory store, created lazily on first
+   * `getMemoryStore()` and kept user-scoped for the lifetime of the core.
+   * Its runtime context is wired by the core itself (see `syncMemoryContext`),
+   * so callers never register or look it up by `agentId`.
+   */
+  private _memoryStore?;
   /**
    * Tracks the agent IDs from the most recent `onAgentsChanged` notification.
    * Used to gate thread-store auto-unregister so the FIRST empty-agents
@@ -1416,6 +1903,29 @@ declare class CopilotKitCore {
   unregisterThreadStore(agentId: string): void;
   getThreadStore(agentId: string): ɵThreadStore | undefined;
   getThreadStores(): Readonly<Record<string, ɵThreadStore>>;
+  /**
+   * Returns the single core-owned, user-scoped memory store, creating and
+   * starting it on first access. Unlike thread stores, memory is not scoped per
+   * agent: there is exactly one store whose runtime context the core wires
+   * itself (see `syncMemoryContext`), so consumers (e.g. a `useMemories`
+   * binding) just read this store rather than registering one.
+   */
+  getMemoryStore(): ɵMemoryStore;
+  /**
+   * Lazily creates, starts, and context-syncs the core-owned memory store on
+   * first access, then returns it. Subsequent calls return the existing store.
+   * The store is constructed with a bound `globalThis.fetch` and immediately
+   * has its runtime context synced from the current connection state.
+   */
+  private ensureMemoryStore;
+  /**
+   * Pushes the current runtime wiring into the memory store. When the runtime
+   * is connected and both the intelligence WebSocket URL and runtime URL are
+   * available, the store receives a context (runtime URL, WebSocket URL, and a
+   * copy of the current headers); otherwise its context is cleared. No-op when
+   * the store has not been created yet.
+   */
+  private syncMemoryContext;
   /**
    * Suggestions management (delegated to SuggestionEngine)
    */
@@ -1424,6 +1934,14 @@ declare class CopilotKitCore {
   reloadSuggestions(agentId: string): void;
   clearSuggestions(agentId: string): void;
   getSuggestions(agentId: string): CopilotKitCoreGetSuggestionsResult;
+  /**
+   * Subagent registry (delegated to SubagentRegistry).
+   *
+   * Returns the subagents observed for an owning agent during its run(s),
+   * keyed by `subagentId`, each carrying `name` / `description` / `status`.
+   * Empty for runs that never emit SUBAGENT_* events.
+   */
+  getSubagents(agentId: string): Readonly<Record<string, SubagentState>>;
   /**
    * Tool management (delegated to RunHandler)
    */
@@ -1787,8 +2305,11 @@ declare class IntelligenceAgent extends AbstractAgent {
   clearReconnectCursor(threadId: string): void;
   private updateLastSeenEventId;
   private updateLastSeenEventIdFromControl;
+  private advanceLastSeenEventId;
   private readEventId;
   private readControlEventId;
+  private readDurableEventId;
+  private canFallbackCompleteConnect;
   private applyCanonicalRunIdentity;
   private isSocketReconnectExhaustedError;
 }
@@ -1948,5 +2469,5 @@ type ɵCopilotKitFeature = (typeof ɵCOPILOTKIT_FEATURES)[number];
  */
 declare function ɵisCopilotKitFeature(name: string): name is ɵCopilotKitFeature;
 //#endregion
-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, RunCompletionAware, RunHandler, type RuntimeLicenseStatus, type RuntimeMode, ScopedContext, Selector, StateManager, StaticSuggestionsConfig, Store, StoreLifecycleAction, SubscribeToAgentOptions, SubscribeToAgentSubscriber, Suggestion, SuggestionAvailability, SuggestionEngine, SuggestionsConfig, type ThreadEndpointRuntimeInfo, ToolCallStatus, completePartialMarkdown, createActionGroup, createEffect, createReducer, createSelector, createStore, empty, ensureObjectArgs, isRunCompletionAware, ofType, on, parseToolArguments, props, select, ɵCOPILOTKIT_FEATURES, ɵCopilotKitFeature, ɵMAX_SOCKET_RETRIES, ɵPhoenixChannelLike, ɵPhoenixChannelOptions, ɵPhoenixChannelSession, ɵPhoenixJoinOutcome, ɵPhoenixPushLike, ɵPhoenixSocketLike, ɵPhoenixSocketOptions, ɵPhoenixSocketSession, ɵPhoenixSocketSignal, ɵThread, ɵThreadEnvironment, ɵThreadMetadataEvent, ɵThreadRuntimeContext, ɵThreadSelectors, ɵThreadStore, ɵcreateThreadSelectors, createThreadStore as ɵcreateThreadStore, ɵisCopilotKitFeature, ɵjoinPhoenixChannel$, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵ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, MEMORY_ERROR_REGISTRY, Memory, MemoryChanges, MemoryError, type MemoryErrorCategory, type MemoryErrorCode, type MemoryErrorRegistryEntry, MemoryKind, MemoryRealtimeStatus, MemoryScope, NewMemory, NonDispatchingEffect, NonDispatchingEffectOptions, PropsActionConfig, ProxiedCopilotRuntimeAgent, ProxiedCopilotRuntimeAgentConfig, Reducer, RunCompletionAware, RunHandler, type RuntimeLicenseStatus, type RuntimeMode, ScopedContext, Selector, StateManager, StaticSuggestionsConfig, Store, StoreLifecycleAction, SubagentRegistry, SubagentState, SubagentStatus, SubscribeToAgentOptions, SubscribeToAgentSubscriber, Suggestion, SuggestionAvailability, SuggestionEngine, SuggestionsConfig, type ThreadEndpointRuntimeInfo, ThreadRunActivityNotification, ToolCallStatus, completePartialMarkdown, createActionGroup, createEffect, createReducer, createSelector, createStore, empty, ensureObjectArgs, isRunCompletionAware, ofType, on, parseToolArguments, props, select, ɵCOPILOTKIT_FEATURES, ɵCopilotKitFeature, ɵMAX_SOCKET_RETRIES, ɵMemoryEnvironment, ɵMemoryMetadataEvent, ɵMemoryRuntimeContext, ɵMemoryState, ɵMemoryStore, ɵPhoenixChannelLike, ɵPhoenixChannelOptions, ɵPhoenixChannelSession, ɵPhoenixJoinOutcome, ɵPhoenixPushLike, ɵPhoenixSocketLike, ɵPhoenixSocketOptions, ɵPhoenixSocketSession, ɵPhoenixSocketSignal, ɵThread, ɵThreadEnvironment, ɵThreadMetadataEvent, ɵThreadRuntimeContext, ɵThreadSelectors, ɵThreadStore, createMemoryStore as ɵcreateMemoryStore, ɵcreateThreadSelectors, createThreadStore as ɵcreateThreadStore, ɵisCopilotKitFeature, isRetryableStatus as ɵisRetryableMemoryStatus, ɵjoinPhoenixChannel$, ɵmapMemoryMetadataEvent, ɵmemoryAdapterEvents, ɵmemoryDomainEvents, ɵmemoryReducer, ɵmemoryRestEvents, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesIsMutating, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents };
 //# sourceMappingURL=index.d.cts.map