@ai-matrx/summon 0.1.7 → 0.1.9

package/dist/open.js

@@ -0,0 +1,375 @@
+// src/core/types.ts
+var DEFAULT_INSTANCE_ID = "default";
+function instanceKey(overlayId, instanceId = DEFAULT_INSTANCE_ID) {
+  return `${overlayId}:${instanceId}`;
+}
+function parseInstanceKey(key) {
+  const at = key.indexOf(":");
+  if (at <= 0 || at === key.length - 1) return null;
+  return { overlayId: key.slice(0, at), instanceId: key.slice(at + 1) };
+}
+function defaultWindowIdFor(meta) {
+  return meta.window?.windowId ?? meta.id;
+}
+
+// src/core/ports.ts
+var noop = () => {
+};
+var anonymousIdentity = {
+  current: () => ({ key: "anonymous", ready: true }),
+  subscribe: () => noop
+};
+var locationRouter = {
+  pathname: () => typeof window === "undefined" ? "/" : window.location.pathname,
+  search: () => typeof window === "undefined" ? "" : window.location.search,
+  replaceSearch: (nextSearch) => {
+    if (typeof window === "undefined") return;
+    const query = nextSearch && !nextSearch.startsWith("?") ? `?${nextSearch}` : nextSearch;
+    const url = `${window.location.pathname}${query}${window.location.hash}`;
+    window.history.replaceState(window.history.state, "", url);
+  },
+  subscribe: (listener) => {
+    if (typeof window === "undefined") return noop;
+    window.addEventListener("popstate", listener);
+    return () => window.removeEventListener("popstate", listener);
+  }
+};
+var consoleNotify = {
+  info: (message) => console.info(`[summon] ${message}`),
+  warn: (message) => console.warn(`[summon] ${message}`),
+  error: (message) => console.error(`[summon] ${message}`)
+};
+var consoleErrorSink = {
+  capture: (error, context) => console.error("[summon]", error, context)
+};
+var debugOff = { enabled: () => false };
+var DEFAULT_PORTS = {
+  identity: anonymousIdentity,
+  router: locationRouter,
+  notify: consoleNotify,
+  errors: consoleErrorSink,
+  debug: debugOff,
+  persistence: null
+};
+function resolvePorts(overrides) {
+  return { ...DEFAULT_PORTS, ...overrides };
+}
+
+// src/core/registry.ts
+import { globalSlot } from "@ai-matrx/kit/global-slot";
+var state = () => globalSlot("ai-matrx.summon.registry", () => ({
+  byId: /* @__PURE__ */ new Map(),
+  byLinkKey: /* @__PURE__ */ new Map(),
+  listeners: /* @__PURE__ */ new Set()
+}));
+function registerOverlayMeta(definitions) {
+  const s = state();
+  for (const def of definitions) {
+    s.byId.set(def.id, def);
+    const keys = def.link ? [def.link.key, ...def.link.aliases ?? []] : [];
+    for (const key of keys) {
+      const holder = s.byLinkKey.get(key);
+      if (holder && holder.id !== def.id) {
+        throw new Error(`[summon] link key "${key}" is claimed by both "${holder.id}" and "${def.id}"`);
+      }
+      s.byLinkKey.set(key, def);
+    }
+  }
+  for (const listener of s.listeners) listener();
+}
+function getOverlayMeta(overlayId) {
+  return state().byId.get(overlayId);
+}
+function getOverlayMetaByLinkKey(linkKey) {
+  return state().byLinkKey.get(linkKey);
+}
+function allOverlayMeta() {
+  return [...state().byId.values()];
+}
+function isRegisteredOverlay(overlayId) {
+  return state().byId.has(overlayId);
+}
+function subscribeToOverlayRegistry(listener) {
+  const s = state();
+  s.listeners.add(listener);
+  return () => s.listeners.delete(listener);
+}
+function resetOverlayRegistry() {
+  const s = state();
+  s.byId.clear();
+  s.byLinkKey.clear();
+}
+
+// src/open/actions.ts
+function creator(type, build) {
+  const create = (...args) => ({ type, payload: build(...args) });
+  return Object.assign(create, {
+    type,
+    toString: () => type,
+    match: (action) => typeof action === "object" && action !== null && action.type === type
+  });
+}
+function isPlainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stripFunctions(overlayId, data) {
+  if (!isPlainRecord(data)) return data;
+  const offenders = Object.keys(data).filter((key) => typeof data[key] === "function");
+  if (offenders.length === 0) return data;
+  console.error(
+    `[summon] BUG: function value(s) in openOverlay data for "${overlayId}" (keys: ${offenders.join(", ")}). Functions cannot travel through Redux \u2014 the handler would NEVER fire. Register a handle (@ai-matrx/summon/handles) and pass its id string instead. The offending key(s) were stripped from state.`
+  );
+  const cleaned = { ...data };
+  for (const key of offenders) delete cleaned[key];
+  return cleaned;
+}
+function rawOpen(payload) {
+  const raw = { overlayId: payload.overlayId };
+  if (payload.instanceId !== void 0) raw.instanceId = payload.instanceId;
+  if (payload.data !== void 0) raw.data = stripFunctions(payload.overlayId, payload.data);
+  const defaults = getOverlayMeta(payload.overlayId)?.defaults;
+  if (isPlainRecord(defaults)) raw.defaults = stripFunctions(payload.overlayId, defaults);
+  return raw;
+}
+var O = "overlays/";
+var openOverlay = creator(O + "openOverlay", (payload) => rawOpen(payload));
+var closeOverlay = creator(
+  O + "closeOverlay",
+  (payload) => payload.instanceId === void 0 ? { overlayId: payload.overlayId } : { overlayId: payload.overlayId, instanceId: payload.instanceId }
+);
+var toggleOverlay = creator(O + "toggleOverlay", (payload) => rawOpen(payload));
+var closeAllInstancesOfOverlay = creator(
+  O + "closeAllInstancesOfOverlay",
+  (payload) => ({ overlayId: payload.overlayId })
+);
+function overlayIdsBoundToPage() {
+  return allOverlayMeta().filter((meta) => meta.closesOnNavigation === true).map((meta) => meta.id);
+}
+var closeOverlaysBoundToPage = creator(
+  O + "closeOverlaysBoundToPage",
+  (payload) => ({
+    overlayIds: [...payload?.overlayIds ?? overlayIdsBoundToPage()]
+  })
+);
+var closeAllOverlays = creator(O + "closeAllOverlays", () => void 0);
+var pruneStaleInstances = creator(O + "pruneStaleInstances", (payload) => payload);
+var W = "windowManager/";
+var pass = () => (payload) => payload;
+var focusWindow = creator(W + "focusWindow", pass());
+var restoreWindow = creator(W + "restoreWindow", pass());
+var toggleWindowsHidden = creator(W + "toggleWindowsHidden", () => void 0);
+var restoreAll = creator(W + "restoreAll", () => void 0);
+var minimizeAll = creator(W + "minimizeAll", pass());
+var SUMMON_SLICE_KEYS = ["overlays", "windowManager", "urlSync", "overlayState"];
+function isSummonAction(action) {
+  if (typeof action !== "object" || action === null) return false;
+  const type = action.type;
+  if (typeof type !== "string") return false;
+  const slash = type.indexOf("/");
+  return slash > 0 && SUMMON_SLICE_KEYS.includes(type.slice(0, slash));
+}
+
+// src/open/selectors.ts
+import { globalSlot as globalSlot2 } from "@ai-matrx/kit/global-slot";
+var CLOSED = Object.freeze({ isOpen: false, data: null });
+var EMPTY = Object.freeze([]);
+var selectOverlay = (state2, overlayId, instanceId = DEFAULT_INSTANCE_ID) => state2.overlays?.overlays[overlayId]?.[instanceId] ?? CLOSED;
+var selectIsOverlayOpen = (state2, overlayId, instanceId = DEFAULT_INSTANCE_ID) => selectOverlay(state2, overlayId, instanceId).isOpen;
+var selectOverlayData = (state2, overlayId, instanceId = DEFAULT_INSTANCE_ID) => selectOverlay(state2, overlayId, instanceId).data;
+var openCache = () => globalSlot2("ai-matrx.summon.openInstances", () => /* @__PURE__ */ new Map());
+var selectOpenInstances = (state2, overlayId) => {
+  const bucket = state2.overlays?.overlays[overlayId];
+  const cache = openCache();
+  const hit = cache.get(overlayId);
+  if (hit && hit.bucket === bucket) return hit.result;
+  let result = EMPTY;
+  if (bucket) {
+    const open = [];
+    for (const [instanceId, inst] of Object.entries(bucket)) if (inst.isOpen) open.push({ instanceId, data: inst.data });
+    if (open.length > 0) result = open;
+  }
+  cache.set(overlayId, { bucket, result });
+  return result;
+};
+function listOpenInstanceKeys(state2) {
+  const keys = [];
+  for (const [overlayId, bucket] of Object.entries(state2.overlays?.overlays ?? {})) {
+    for (const [instanceId, inst] of Object.entries(bucket)) if (inst.isOpen) keys.push(`${overlayId}:${instanceId}`);
+  }
+  return keys;
+}
+function selectAnyOverlayTouched(state2) {
+  for (const _ in state2.overlays?.overlays ?? {}) return true;
+  return false;
+}
+var selectWindowsHidden = (state2) => state2.windowManager?.windowsHidden ?? false;
+
+// src/open/gate.ts
+import { globalSlot as globalSlot3 } from "@ai-matrx/kit/global-slot";
+var SUMMON_INSTALLED_ACTION = "@@summon/installed";
+var slot = () => globalSlot3("ai-matrx.summon.gate", () => ({ core: null, loading: null, gates: /* @__PURE__ */ new Set(), listeners: /* @__PURE__ */ new Set() }));
+function installSummonCore(core) {
+  const s = slot();
+  if (s.core) return;
+  s.core = core;
+  const gates = [...s.gates];
+  s.gates.clear();
+  for (const gate of gates) gate.install(core);
+  for (const listener of [...s.listeners]) listener();
+}
+function isSummonInstalled() {
+  return slot().core !== null;
+}
+function subscribeSummonInstalled(listener) {
+  const s = slot();
+  s.listeners.add(listener);
+  return () => s.listeners.delete(listener);
+}
+function ensureSummonRuntime() {
+  const s = slot();
+  if (s.core) return Promise.resolve();
+  s.loading ??= import("@ai-matrx/summon").then(
+    (core) => installSummonCore(core.summonCore),
+    (error) => {
+      s.loading = null;
+      throw error;
+    }
+  );
+  return s.loading;
+}
+function prefetchSummonRuntime() {
+  ensureSummonRuntime().catch(() => void 0);
+}
+function createSummonGate(options = {}) {
+  let inject = null;
+  let injected = false;
+  let api = null;
+  let next = null;
+  let chain = null;
+  const queue = [];
+  const settle = (core2, live) => {
+    if (inject && !injected) {
+      inject(core2.reducers);
+      injected = true;
+    }
+    if (!api || !next || chain) return;
+    const store = api;
+    let composed = next;
+    for (const middleware2 of [...core2.createMiddleware(options.ports)].reverse()) {
+      composed = middleware2(store)(composed);
+    }
+    chain = composed;
+    const flush = () => {
+      if (live) store.dispatch({ type: SUMMON_INSTALLED_ACTION });
+      for (const action of queue.splice(0)) store.dispatch(action);
+    };
+    if (live) flush();
+    else if (queue.length > 0) queueMicrotask(flush);
+  };
+  const internals = { install: (core2) => settle(core2, true) };
+  const core = () => slot().core;
+  const middleware = (storeApi) => {
+    api = storeApi;
+    return (nextDispatch) => {
+      next = nextDispatch;
+      const loaded = core();
+      if (loaded) settle(loaded, false);
+      else slot().gates.add(internals);
+      return (action) => {
+        if (chain) return chain(action);
+        if (!isSummonAction(action)) return nextDispatch(action);
+        queue.push(action);
+        void ensureSummonRuntime().catch((error) => {
+          console.error("[summon] the overlay runtime failed to load; queued requests are kept for the next try", error);
+        });
+        return action;
+      };
+    };
+  };
+  return {
+    middleware,
+    attachReducer(fn) {
+      inject = fn;
+      const loaded = core();
+      if (loaded) {
+        inject(loaded.reducers);
+        injected = true;
+      }
+    }
+  };
+}
+
+// src/open/channels.ts
+import { globalSlot as globalSlot4 } from "@ai-matrx/kit/global-slot";
+var pending = () => globalSlot4("ai-matrx.summon.pendingChannels", () => /* @__PURE__ */ new Map());
+function materializePendingChannels(createEventChannel) {
+  const map = pending();
+  for (const [id, entry] of [...map]) {
+    map.delete(id);
+    const channel = createEventChannel({ owner: entry.owner, id });
+    channel.subscribe((message) => entry.getHandlers()?.[message.type]?.(message.payload));
+  }
+}
+function openPendingEventChannel(owner, getHandlers) {
+  const id = `ch-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  pending().set(id, { owner, getHandlers });
+  void import("@ai-matrx/summon/handles").then(({ createEventChannel }) => materializePendingChannels(createEventChannel));
+  return id;
+}
+function dropPendingChannelsOf(owner) {
+  const map = pending();
+  for (const [id, entry] of [...map]) if (entry.owner === owner) map.delete(id);
+}
+export {
+  DEFAULT_INSTANCE_ID,
+  DEFAULT_PORTS,
+  SUMMON_INSTALLED_ACTION,
+  SUMMON_SLICE_KEYS,
+  allOverlayMeta,
+  anonymousIdentity,
+  closeAllInstancesOfOverlay,
+  closeAllOverlays,
+  closeOverlay,
+  closeOverlaysBoundToPage,
+  consoleErrorSink,
+  consoleNotify,
+  createSummonGate,
+  debugOff,
+  defaultWindowIdFor,
+  dropPendingChannelsOf,
+  ensureSummonRuntime,
+  focusWindow,
+  getOverlayMeta,
+  getOverlayMetaByLinkKey,
+  installSummonCore,
+  instanceKey,
+  isRegisteredOverlay,
+  isSummonAction,
+  isSummonInstalled,
+  listOpenInstanceKeys,
+  locationRouter,
+  materializePendingChannels,
+  minimizeAll,
+  openOverlay,
+  openPendingEventChannel,
+  overlayIdsBoundToPage,
+  parseInstanceKey,
+  prefetchSummonRuntime,
+  pruneStaleInstances,
+  registerOverlayMeta,
+  resetOverlayRegistry,
+  resolvePorts,
+  restoreAll,
+  restoreWindow,
+  selectAnyOverlayTouched,
+  selectIsOverlayOpen,
+  selectOpenInstances,
+  selectOverlay,
+  selectOverlayData,
+  selectWindowsHidden,
+  subscribeSummonInstalled,
+  subscribeToOverlayRegistry,
+  toggleOverlay,
+  toggleWindowsHidden
+};
+//# sourceMappingURL=open.js.map

package/dist/open.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types.ts","../src/core/ports.ts","../src/core/registry.ts","../src/open/actions.ts","../src/open/selectors.ts","../src/open/gate.ts","../src/open/channels.ts"],"sourcesContent":["/**\n * The shared vocabulary of @ai-matrx/summon. Framework-free: no React, no Redux imports.\n *\n * An OVERLAY is any component rendered on top of the app by dispatch — a window, dialog, sheet,\n * light floating window, toast-like card, anything. It is identified by an `OverlayId` and opened\n * as one or more INSTANCES (`instanceId`, \"default\" for single-instance overlays).\n */\n\n/**\n * The host's overlay registry: overlay id → the data its opener accepts. Hosts extend it by\n * module augmentation so every open call is type-checked:\n *\n *   declare module \"@ai-matrx/summon\" {\n *     interface OverlayRegistry { notesWindow: { noteId?: string } }\n *   }\n *\n * `defineOverlay` emits nothing at runtime for this; the augmentation is the host's one-line\n * declaration per overlay (the converter writes it next to each definition).\n */\n// Declared in ./augment (bundled only into the core's declarations, so `declare module\n// \"@ai-matrx/summon\"` merges into it); every section reads it through the package name.\nimport type { OverlayRegistry, OverlayHostTypes } from \"@ai-matrx/summon\";\nexport type { OverlayRegistry, OverlayHostTypes };\n\n/** Every registered overlay id; plain `string` until the host augments the registry. */\nexport type OverlayId = [keyof OverlayRegistry] extends [never]\n  ? string\n  : Extract<keyof OverlayRegistry, string>;\n\n/** The open-data type declared for an overlay id. */\nexport type OverlayDataOf<Id extends string> = Id extends keyof OverlayRegistry\n  ? OverlayRegistry[Id]\n  : Record<string, unknown>;\n\n/**\n * Data as it arrives at render time. It crossed Redux, a URL or storage, so it is NOT trusted to\n * match the opener's type: render code narrows it (or the definition supplies `parse`).\n */\nexport type OverlayRawData = Readonly<Record<string, unknown>> | null;\n\nexport const DEFAULT_INSTANCE_ID = \"default\";\n\n/** `single`: one instance (\"default\"). `multi`: any number, each with its own instanceId. */\nexport type InstanceMode = \"single\" | \"multi\";\n\n/**\n * What closing does to a mounted overlay (Arman, 2026-10-16, C38 R3):\n *   none    — unmount (default).\n *   hidden  — stay mounted but hidden; reopening shows the same live component (LRU-capped).\n *   restore — unmount, but values saved with `useOverlayState` come back on reopen.\n * Minimizing a window always keeps its component mounted, whatever this says.\n */\nexport type KeepAlive = \"none\" | \"hidden\" | \"restore\";\n\n/** `overlayId:instanceId` — the one key every subsystem uses for an open instance. */\nexport type InstanceKey = `${string}:${string}`;\n\nexport function instanceKey(overlayId: string, instanceId: string = DEFAULT_INSTANCE_ID): InstanceKey {\n  return `${overlayId}:${instanceId}`;\n}\n\nexport function parseInstanceKey(key: string): { overlayId: string; instanceId: string } | null {\n  const at = key.indexOf(\":\");\n  if (at <= 0 || at === key.length - 1) return null;\n  return { overlayId: key.slice(0, at), instanceId: key.slice(at + 1) };\n}\n\n// ── Window options (consumed by the window surface; inert for other surfaces) ──────────────────\n\nexport type MobilePresentation = \"fullscreen\" | \"drawer\" | \"card\" | \"hidden\";\n\n/**\n * Default-deny allowlist of the open data a window may save and restore. A window with no\n * preservation entry restores geometry only.\n */\nexport interface WindowPreservation {\n  readonly dataKeys: readonly string[];\n  readonly requiredDataKeys?: readonly string[];\n  readonly allowedDataValues?: Readonly<Record<string, readonly (string | number | boolean | null)[]>>;\n  /** Default 32 KiB. */\n  readonly maxDataBytes?: number;\n}\n\n/** One declared home for an unbidden (system-raised) window: a route prefix, or one exact page. */\nexport type UnbiddenHomeRoute = string | { readonly route: string; readonly exact: true };\n\nexport interface OverlayWindowOptions {\n  readonly mobile?: MobilePresentation;\n  readonly mobileSidebarAs?: \"drawer\" | \"inline\";\n  /** Never saved or restored (debug panels, one-shot tools, callback-bound editors). */\n  readonly ephemeral?: boolean;\n  readonly preservation?: WindowPreservation;\n  /**\n   * Values merged under saved data when a window is RESTORED (reload, another device). Unlike the\n   * definition's `defaults`, never applied to a normal open.\n   */\n  readonly restoreDefaults?: Readonly<Record<string, unknown>>;\n  /**\n   * The window-manager id the WindowPanel registers under for the default instance. Default: the\n   * overlay id. The render watchdog reveals and inspects this id until the panel acks its own.\n   */\n  readonly windowId?: string;\n  readonly deprecated?: { readonly replacement?: string; readonly reason?: string };\n  /**\n   * Where a window nobody opened (system-raised) may raise itself. Default deny: no home → it may\n   * not raise itself anywhere (`mayRaiseUnbidden` in the window section).\n   */\n  readonly unbiddenHome?: readonly UnbiddenHomeRoute[];\n}\n\n// ── Host types (augmentable) ────────────────────────────────────────────────────────────────\n\n/**\n * Host-specific types the package passes through untouched. A Redux host augments `dispatch`\n * with its thunk-aware dispatch so link hydrators can dispatch its thunks without casts:\n *\n *   declare module \"@ai-matrx/summon\" { interface OverlayHostTypes { dispatch: AppDispatch } }\n */\nexport type OverlayHostDispatch = OverlayHostTypes extends { dispatch: infer D } ? D : (action: unknown) => unknown;\n\n// ── Links (address-bar references) ──────────────────────────────────────────────────────────\n\nexport interface LinkHydrateContext<Data> {\n  /** The id segment of the link token (`notes:<id>`). */\n  readonly id: string;\n  /** Decoded `k-v` arguments of the token. */\n  readonly args: Readonly<Record<string, string>>;\n  /** Open this overlay. */\n  open(options?: { readonly instanceId?: string; readonly data?: Data }): void;\n  /** The host store's dispatch, for thunks a hydrator needs (loading a record first). Typed by\n   *  augmenting `OverlayHostTypes` with the host's dispatch type. */\n  readonly dispatch: OverlayHostDispatch;\n}\n\nexport interface OverlayLinkSpec<Data> {\n  /** The token type key in `?panels=key:id`. Unique across the host. */\n  readonly key: string;\n  /** Older keys that still resolve to this overlay. */\n  readonly aliases?: readonly string[];\n  /** Turn a link token into an open overlay (and its data). `\"refused\"` keeps the token and says why. */\n  hydrate(context: LinkHydrateContext<Data>): void | \"refused\" | Promise<void | \"refused\">;\n}\n\n// ── Definitions (framework-free half; the React half adds `render`) ─────────────────────────\n\nexport interface OverlayDefinitionMeta<Id extends string = string, Data = Record<string, unknown>> {\n  readonly id: Id;\n  /** Human label: tray, menus, diagnostics. */\n  readonly label: string;\n  readonly instance?: InstanceMode;\n  readonly keepAlive?: KeepAlive;\n  /** Close when the route changes — the overlay shows a piece of the page that opened it. */\n  readonly closesOnNavigation?: boolean;\n  /** Present only for overlays that render a WindowPanel. */\n  readonly window?: OverlayWindowOptions;\n  readonly link?: OverlayLinkSpec<Data>;\n  /** Defaults merged under open data (replaces the old per-overlay schema registry). */\n  readonly defaults?: Partial<Data>;\n}\n\n/** The window-manager id a singleton window overlay registers under (`window.windowId ?? id`). */\nexport function defaultWindowIdFor(meta: Pick<OverlayDefinitionMeta, \"id\" | \"window\">): string {\n  return meta.window?.windowId ?? meta.id;\n}\n","/**\n * Everything the overlays system needs from its host, as ports. Every port ships a working\n * default, so a bare host gets a working system with zero wiring (package standard rule 8); a\n * host overrides only what it has: identity, navigation, notifications, error sink, debug flag,\n * persistence. Framework-free.\n */\n\nexport type Unsubscribe = () => void;\n\n/** Who the person is, for isolating saved state. `key` changes → everything saved is swapped. */\nexport interface IdentityPort {\n  current(): { readonly key: string; readonly ready: boolean };\n  subscribe(listener: () => void): Unsubscribe;\n}\n\n/** The address bar: route changes (close-on-navigation) and the `?panels=` link channel. */\nexport interface RouterPort {\n  pathname(): string;\n  search(): string;\n  /** Replace the query string without navigating or remounting the page. */\n  replaceSearch(nextSearch: string): void;\n  subscribe(listener: () => void): Unsubscribe;\n}\n\nexport interface NotifyOptions {\n  readonly id?: string;\n  readonly description?: string;\n  /** How long the notice stays up (ms). Hosts without timed notices ignore it. */\n  readonly duration?: number;\n  /** One action button (e.g. the render watchdog's \"Show it\"). Hosts without actions ignore it. */\n  readonly action?: { readonly label: string; readonly onClick: () => void };\n}\n\nexport interface NotifyPort {\n  info(message: string, options?: NotifyOptions): void;\n  warn(message: string, options?: NotifyOptions): void;\n  error(message: string, options?: NotifyOptions): void;\n  /** Withdraw a notice by id (optional). */\n  dismiss?(id: string): void;\n}\n\nexport interface ErrorSinkPort {\n  capture(error: unknown, context: Readonly<Record<string, unknown>>): void;\n}\n\nexport interface DebugPort {\n  enabled(): boolean;\n  subscribe?(listener: () => void): Unsubscribe;\n}\n\n/** A stored value with its optimistic-concurrency version (0 when the store has none). */\nexport interface StoredValue<T = unknown> {\n  readonly value: T;\n  readonly version: number;\n}\n\n/**\n * Where saved overlay state lives when persistence is on. Keys are already scoped to the\n * identity by the caller (`<identityKey>/<key>`) for stores that are not per-person themselves.\n * Implementations: the browser-local store (`./persistence`), `@ai-matrx/data` over\n * `users.user_surface_state` (`./persistence/data`), or any host database.\n */\nexport interface OverlayPersistencePort {\n  /**\n   * True when the store is per-person itself (rows scoped to the signed-in person, e.g. the\n   * `@ai-matrx/data` adapter): the persistence section then passes plain keys (`workspace`,\n   * `state:<instanceKey>`) instead of `<identityKey>/<key>`, and defaults to `scope: \"person\"`.\n   */\n  readonly perPerson?: boolean;\n  load<T = unknown>(key: string): Promise<StoredValue<T> | null>;\n  save<T = unknown>(key: string, value: T, options?: { readonly expectedVersion?: number }): Promise<{ readonly version: number }>;\n  remove(key: string): Promise<void>;\n  list?(prefix: string): Promise<readonly string[]>;\n  /**\n   * Every saved value at once (key → value), for stores where one read is cheaper than several.\n   * When present, restoring an identity costs exactly this one call: the workspace and every\n   * saved component state come out of it, and `load`/`list` are not called on boot.\n   */\n  loadAll?(): Promise<ReadonlyMap<string, StoredValue>>;\n}\n\nexport interface SummonPorts {\n  readonly identity: IdentityPort;\n  readonly router: RouterPort;\n  readonly notify: NotifyPort;\n  readonly errors: ErrorSinkPort;\n  readonly debug: DebugPort;\n  /** `null` = persistence off (R6). */\n  readonly persistence: OverlayPersistencePort | null;\n}\n\nconst noop = (): void => {};\n\nexport const anonymousIdentity: IdentityPort = {\n  current: () => ({ key: \"anonymous\", ready: true }),\n  subscribe: () => noop,\n};\n\n/** `window.location` + `history.replaceState`; inert on the server. */\nexport const locationRouter: RouterPort = {\n  pathname: () => (typeof window === \"undefined\" ? \"/\" : window.location.pathname),\n  search: () => (typeof window === \"undefined\" ? \"\" : window.location.search),\n  replaceSearch: (nextSearch) => {\n    if (typeof window === \"undefined\") return;\n    const query = nextSearch && !nextSearch.startsWith(\"?\") ? `?${nextSearch}` : nextSearch;\n    const url = `${window.location.pathname}${query}${window.location.hash}`;\n    window.history.replaceState(window.history.state, \"\", url);\n  },\n  subscribe: (listener) => {\n    if (typeof window === \"undefined\") return noop;\n    window.addEventListener(\"popstate\", listener);\n    return () => window.removeEventListener(\"popstate\", listener);\n  },\n};\n\n/* eslint-disable no-console */\nexport const consoleNotify: NotifyPort = {\n  info: (message) => console.info(`[summon] ${message}`),\n  warn: (message) => console.warn(`[summon] ${message}`),\n  error: (message) => console.error(`[summon] ${message}`),\n};\n\nexport const consoleErrorSink: ErrorSinkPort = {\n  capture: (error, context) => console.error(\"[summon]\", error, context),\n};\n/* eslint-enable no-console */\n\nexport const debugOff: DebugPort = { enabled: () => false };\n\nexport const DEFAULT_PORTS: SummonPorts = {\n  identity: anonymousIdentity,\n  router: locationRouter,\n  notify: consoleNotify,\n  errors: consoleErrorSink,\n  debug: debugOff,\n  persistence: null,\n};\n\nexport function resolvePorts(overrides: Partial<SummonPorts> | undefined): SummonPorts {\n  return { ...DEFAULT_PORTS, ...overrides };\n}\n","/**\n * The process-wide registry of overlay definition metadata (the framework-free half of each\n * definition). The host registers its definitions once (`<SummonHost definitions>` does it);\n * reducers stay pure — middleware and hooks read this registry and put what reducers need in the\n * action payload (e.g. the ids bound to the page).\n *\n * State lives in a global slot so a duplicated module graph (ESM + CJS, unsplit bundles) sees one\n * registry (kit `globalSlot`, architecture D9).\n */\nimport { globalSlot } from \"@ai-matrx/kit/global-slot\";\nimport type { OverlayDefinitionMeta } from \"./types\";\n\n/**\n * A definition's meta with its data type erased, so definitions of every data shape share one\n * registry without casts. (`never` erasure made `defaults` unassignable.)\n */\nexport interface AnyOverlayMeta extends Omit<OverlayDefinitionMeta<string, unknown>, \"defaults\"> {\n  readonly defaults?: object | undefined;\n}\n\ntype AnyMeta = AnyOverlayMeta;\n\ninterface RegistryState {\n  readonly byId: Map<string, AnyMeta>;\n  readonly byLinkKey: Map<string, AnyMeta>;\n  readonly listeners: Set<() => void>;\n}\n\nconst state = (): RegistryState =>\n  globalSlot<RegistryState>(\"ai-matrx.summon.registry\", () => ({\n    byId: new Map(),\n    byLinkKey: new Map(),\n    listeners: new Set(),\n  }));\n\n/**\n * Register (or re-register) definitions. Re-registering an id replaces it (hot reload). A link\n * key claimed by two different ids is a host bug and throws, naming both.\n */\nexport function registerOverlayMeta(definitions: readonly AnyOverlayMeta[]): void {\n  const s = state();\n  for (const def of definitions) {\n    s.byId.set(def.id, def);\n    const keys = def.link ? [def.link.key, ...(def.link.aliases ?? [])] : [];\n    for (const key of keys) {\n      const holder = s.byLinkKey.get(key);\n      if (holder && holder.id !== def.id) {\n        throw new Error(`[summon] link key \"${key}\" is claimed by both \"${holder.id}\" and \"${def.id}\"`);\n      }\n      s.byLinkKey.set(key, def);\n    }\n  }\n  for (const listener of s.listeners) listener();\n}\n\nexport function getOverlayMeta(overlayId: string): AnyMeta | undefined {\n  return state().byId.get(overlayId);\n}\n\nexport function getOverlayMetaByLinkKey(linkKey: string): AnyMeta | undefined {\n  return state().byLinkKey.get(linkKey);\n}\n\nexport function allOverlayMeta(): readonly AnyMeta[] {\n  return [...state().byId.values()];\n}\n\nexport function isRegisteredOverlay(overlayId: string): boolean {\n  return state().byId.has(overlayId);\n}\n\nexport function subscribeToOverlayRegistry(listener: () => void): () => void {\n  const s = state();\n  s.listeners.add(listener);\n  return () => s.listeners.delete(listener);\n}\n\n/** Test-only. */\nexport function resetOverlayRegistry(): void {\n  const s = state();\n  s.byId.clear();\n  s.byLinkKey.clear();\n}\n","// The public action creators, light: plain objects with the slices' own type strings, so a file\n// that only opens or closes something never loads a slice. The slices (core) handle these exact\n// types; `actions.parity.test.ts` proves every creator here equals its slice twin.\n//\n// `openOverlay`/`toggleOverlay` keep the two guarantees the slice creators had: functions are\n// stripped from open data (they can never travel through Redux — the D33 dead-button class) and\n// the definition's registered `defaults` ride the payload, so the reducer stays pure.\nimport { getOverlayMeta, allOverlayMeta } from \"../core/registry\";\nimport { DEFAULT_INSTANCE_ID, type OverlayDataOf, type OverlayId } from \"../core/types\";\n\nexport interface OpenOverlayPayload<Id extends OverlayId = OverlayId> {\n  overlayId: Id;\n  instanceId?: string;\n  data?: OverlayDataOf<Id> | null;\n}\n\nexport interface CloseOverlayPayload<Id extends OverlayId = OverlayId> {\n  overlayId: Id;\n  instanceId?: string;\n}\n\nexport type ToggleOverlayPayload<Id extends OverlayId = OverlayId> = OpenOverlayPayload<Id>;\n\nexport interface CloseAllInstancesPayload<Id extends OverlayId = OverlayId> {\n  overlayId: Id;\n}\n\nexport interface CloseOverlaysBoundToPagePayload {\n  /** Overlay ids whose definitions say `closesOnNavigation`. */\n  overlayIds: readonly string[];\n}\n\nexport interface PruneStaleInstancesPayload {\n  olderThanMs: number;\n}\n\n/** Raw reducer payload: untyped ids + the registry defaults the creator resolved. */\nexport interface RawOpenPayload {\n  overlayId: string;\n  instanceId?: string;\n  data?: unknown;\n  defaults?: Readonly<Record<string, unknown>>;\n}\n\nexport interface SummonAction<P> {\n  type: string;\n  payload: P;\n  /** Structurally a Redux `UnknownAction`. */\n  [extra: string]: unknown;\n}\n\ntype Creator<Args extends unknown[], P> = ((...args: Args) => SummonAction<P>) & {\n  readonly type: string;\n  match(action: unknown): action is SummonAction<P>;\n};\n\nfunction creator<Args extends unknown[], P>(type: string, build: (...args: Args) => P): Creator<Args, P> {\n  const create = (...args: Args): SummonAction<P> => ({ type, payload: build(...args) });\n  return Object.assign(create, {\n    type,\n    toString: () => type,\n    match: (action: unknown): action is SummonAction<P> =>\n      typeof action === \"object\" && action !== null && (action as { type?: unknown }).type === type,\n  });\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction stripFunctions(overlayId: string, data: unknown): unknown {\n  if (!isPlainRecord(data)) return data;\n  const offenders = Object.keys(data).filter((key) => typeof data[key] === \"function\");\n  if (offenders.length === 0) return data;\n  // eslint-disable-next-line no-console\n  console.error(\n    `[summon] BUG: function value(s) in openOverlay data for \"${overlayId}\" (keys: ${offenders.join(\", \")}). ` +\n      `Functions cannot travel through Redux — the handler would NEVER fire. Register a handle ` +\n      `(@ai-matrx/summon/handles) and pass its id string instead. The offending key(s) were stripped from state.`,\n  );\n  const cleaned = { ...data };\n  for (const key of offenders) delete cleaned[key];\n  return cleaned;\n}\n\nfunction rawOpen(payload: { overlayId: string; instanceId?: string; data?: unknown }): RawOpenPayload {\n  const raw: RawOpenPayload = { overlayId: payload.overlayId };\n  if (payload.instanceId !== undefined) raw.instanceId = payload.instanceId;\n  if (payload.data !== undefined) raw.data = stripFunctions(payload.overlayId, payload.data);\n  const defaults: unknown = getOverlayMeta(payload.overlayId)?.defaults;\n  if (isPlainRecord(defaults)) raw.defaults = stripFunctions(payload.overlayId, defaults) as Record<string, unknown>;\n  return raw;\n}\n\nconst O = \"overlays/\";\n\nexport const openOverlay = creator(O + \"openOverlay\", <Id extends OverlayId>(payload: OpenOverlayPayload<Id>) => rawOpen(payload));\n\nexport const closeOverlay = creator(O + \"closeOverlay\", <Id extends OverlayId>(payload: CloseOverlayPayload<Id>) =>\n  payload.instanceId === undefined\n    ? { overlayId: payload.overlayId as string }\n    : { overlayId: payload.overlayId as string, instanceId: payload.instanceId },\n);\n\nexport const toggleOverlay = creator(O + \"toggleOverlay\", <Id extends OverlayId>(payload: ToggleOverlayPayload<Id>) => rawOpen(payload));\n\nexport const closeAllInstancesOfOverlay = creator(\n  O + \"closeAllInstancesOfOverlay\",\n  <Id extends OverlayId>(payload: CloseAllInstancesPayload<Id>) => ({ overlayId: payload.overlayId as string }),\n);\n\n/** Ids of every registered overlay whose definition says `closesOnNavigation`. */\nexport function overlayIdsBoundToPage(): string[] {\n  return allOverlayMeta()\n    .filter((meta) => meta.closesOnNavigation === true)\n    .map((meta) => meta.id);\n}\n\n/** Close page-bound overlays. Omit the ids to use the registry's `closesOnNavigation` list. */\nexport const closeOverlaysBoundToPage = creator(\n  O + \"closeOverlaysBoundToPage\",\n  (payload?: Partial<CloseOverlaysBoundToPagePayload>): CloseOverlaysBoundToPagePayload => ({\n    overlayIds: [...(payload?.overlayIds ?? overlayIdsBoundToPage())],\n  }),\n);\n\nexport const closeAllOverlays = creator(O + \"closeAllOverlays\", () => undefined);\nexport const pruneStaleInstances = creator(O + \"pruneStaleInstances\", (payload: PruneStaleInstancesPayload) => payload);\n\n// ── Window manager: the ones callers outside a window dispatch (menus, shortcuts, settings) ──\n\nconst W = \"windowManager/\";\nconst pass = <P>() => (payload: P) => payload;\n\nexport const focusWindow = creator(W + \"focusWindow\", pass<string>());\nexport const restoreWindow = creator(W + \"restoreWindow\", pass<string>());\nexport const toggleWindowsHidden = creator(W + \"toggleWindowsHidden\", () => undefined);\nexport const restoreAll = creator(W + \"restoreAll\", () => undefined);\nexport const minimizeAll = creator(W + \"minimizeAll\", pass<{ viewportWidth: number; viewportHeight: number }>());\n\n/** Every slice key the summon reducers own; an action under one of them needs the runtime. */\nexport const SUMMON_SLICE_KEYS = [\"overlays\", \"windowManager\", \"urlSync\", \"overlayState\"] as const;\n\nexport function isSummonAction(action: unknown): action is { type: string } {\n  if (typeof action !== \"object\" || action === null) return false;\n  const type = (action as { type?: unknown }).type;\n  if (typeof type !== \"string\") return false;\n  const slash = type.indexOf(\"/\");\n  return slash > 0 && (SUMMON_SLICE_KEYS as readonly string[]).includes(type.slice(0, slash));\n}\n\nexport { DEFAULT_INSTANCE_ID };\n","// The public overlay selectors, light and safe before the runtime: a host that loads the summon\n// slices on first use (the gate) has no `overlays` key until then, and every overlay reads closed.\nimport { DEFAULT_INSTANCE_ID } from \"../core/types\";\nimport { globalSlot } from \"@ai-matrx/kit/global-slot\";\n\nexport interface OverlayInstance {\n  isOpen: boolean;\n  data: unknown;\n  /** Unix ms of the last open (pruneStaleInstances reads it). */\n  lastUsedAt?: number;\n}\n\nexport interface OverlayState {\n  overlays: Record<string, Record<string, OverlayInstance>>;\n}\n\n/** The slice of any store these selectors need (absent until the summon runtime is installed). */\nexport type StateWithOverlays = { overlays?: OverlayState };\n\nexport interface OpenInstanceView {\n  instanceId: string;\n  data: unknown;\n}\n\nconst CLOSED: OverlayInstance = Object.freeze({ isOpen: false, data: null });\nconst EMPTY: readonly OpenInstanceView[] = Object.freeze([]);\n\nexport const selectOverlay = (state: StateWithOverlays, overlayId: string, instanceId: string = DEFAULT_INSTANCE_ID): OverlayInstance =>\n  state.overlays?.overlays[overlayId]?.[instanceId] ?? CLOSED;\n\nexport const selectIsOverlayOpen = (state: StateWithOverlays, overlayId: string, instanceId: string = DEFAULT_INSTANCE_ID): boolean =>\n  selectOverlay(state, overlayId, instanceId).isOpen;\n\nexport const selectOverlayData = (state: StateWithOverlays, overlayId: string, instanceId: string = DEFAULT_INSTANCE_ID): unknown =>\n  selectOverlay(state, overlayId, instanceId).data;\n\ninterface CachedOpen {\n  bucket: Record<string, OverlayInstance> | undefined;\n  result: readonly OpenInstanceView[];\n}\nconst openCache = (): Map<string, CachedOpen> => globalSlot(\"ai-matrx.summon.openInstances\", () => new Map<string, CachedOpen>());\n\n/** All open instances of an overlay id; the array reference is stable while the open set is unchanged. */\nexport const selectOpenInstances = (state: StateWithOverlays, overlayId: string): readonly OpenInstanceView[] => {\n  const bucket = state.overlays?.overlays[overlayId];\n  const cache = openCache();\n  const hit = cache.get(overlayId);\n  if (hit && hit.bucket === bucket) return hit.result;\n  let result: readonly OpenInstanceView[] = EMPTY;\n  if (bucket) {\n    const open: OpenInstanceView[] = [];\n    for (const [instanceId, inst] of Object.entries(bucket)) if (inst.isOpen) open.push({ instanceId, data: inst.data });\n    if (open.length > 0) result = open;\n  }\n  cache.set(overlayId, { bucket, result });\n  return result;\n};\n\n/** Every open instance key (`overlayId:instanceId`). */\nexport function listOpenInstanceKeys(state: StateWithOverlays): string[] {\n  const keys: string[] = [];\n  for (const [overlayId, bucket] of Object.entries(state.overlays?.overlays ?? {})) {\n    for (const [instanceId, inst] of Object.entries(bucket)) if (inst.isOpen) keys.push(`${overlayId}:${instanceId}`);\n  }\n  return keys;\n}\n\n/** True once anything has ever been opened in this store (a key exists in the slice). */\nexport function selectAnyOverlayTouched(state: StateWithOverlays): boolean {\n  for (const _ in state.overlays?.overlays ?? {}) return true;\n  return false;\n}\n\n/** The global hide-all flag (false before the runtime is installed). */\nexport const selectWindowsHidden = (state: { windowManager?: { windowsHidden: boolean } }): boolean =>\n  state.windowManager?.windowsHidden ?? false;\n","// The summon gate: a host store carries NONE of the summon slices or middleware until something\n// needs them. The gate is one middleware in the host chain. Before the core is loaded, every\n// summon action (open, close, a window action…) is queued and the first one starts ONE import()\n// of the core; when the core module evaluates it installs itself into every gate — the slices are\n// injected into the host's root reducer, the real middleware (close lifecycle, render watchdog)\n// joins the chain, and the queue replays in order. A host may also start the import early\n// (`prefetchSummonRuntime` on idle or pointer intent) so the first click opens at once.\n//\n// A module that needs the slices synchronously (the window section, links, persistence) imports\n// the core statically; the core installs at evaluation, so its state exists before it renders.\nimport type { Dispatch, Middleware, MiddlewareAPI, Reducer, UnknownAction } from \"@reduxjs/toolkit\";\nimport { globalSlot } from \"@ai-matrx/kit/global-slot\";\nimport type { SummonPorts } from \"../core/ports\";\nimport { isSummonAction } from \"./actions\";\n\n/** What the core hands the gate when it loads. */\nexport interface SummonCore {\n  readonly reducers: Readonly<Record<string, Reducer>>;\n  createMiddleware(ports?: Partial<SummonPorts>): Middleware[];\n}\n\n/** Dispatched once after the slices are injected into a live store, so they hold their initial state. */\nexport const SUMMON_INSTALLED_ACTION = \"@@summon/installed\";\n\ninterface GateInternals {\n  install(core: SummonCore): void;\n}\n\ninterface GateSlot {\n  core: SummonCore | null;\n  loading: Promise<void> | null;\n  readonly gates: Set<GateInternals>;\n  readonly listeners: Set<() => void>;\n}\n\nconst slot = (): GateSlot =>\n  globalSlot<GateSlot>(\"ai-matrx.summon.gate\", () => ({ core: null, loading: null, gates: new Set(), listeners: new Set() }));\n\n/** Called by the core module when it evaluates (idempotent). */\nexport function installSummonCore(core: SummonCore): void {\n  const s = slot();\n  if (s.core) return;\n  s.core = core;\n  const gates = [...s.gates];\n  s.gates.clear();\n  for (const gate of gates) gate.install(core);\n  for (const listener of [...s.listeners]) listener();\n}\n\nexport function isSummonInstalled(): boolean {\n  return slot().core !== null;\n}\n\nexport function subscribeSummonInstalled(listener: () => void): () => void {\n  const s = slot();\n  s.listeners.add(listener);\n  return () => s.listeners.delete(listener);\n}\n\n/** Load the summon core (one import(), shared by every caller). Resolves once it is installed. */\nexport function ensureSummonRuntime(): Promise<void> {\n  const s = slot();\n  if (s.core) return Promise.resolve();\n  s.loading ??= import(\"@ai-matrx/summon\").then(\n    (core) => installSummonCore(core.summonCore),\n    (error: unknown) => {\n      s.loading = null; // a failed chunk may be retried by the next request\n      throw error;\n    },\n  );\n  return s.loading;\n}\n\n/** Start loading the core without waiting (idle, pointer intent). Errors surface on the next real request. */\nexport function prefetchSummonRuntime(): void {\n  ensureSummonRuntime().catch(() => undefined);\n}\n\nexport interface SummonGate {\n  /** Put this in the host store's middleware chain. */\n  readonly middleware: Middleware;\n  /**\n   * Give the gate the host root reducer's inject function — before `configureStore`, so a core\n   * that is already loaded (a page that imported the window section) is injected before the\n   * store's first state exists.\n   */\n  attachReducer(inject: (reducers: Readonly<Record<string, Reducer>>) => void): void;\n}\n\nexport interface CreateSummonGateOptions {\n  /** Ports for the summon middleware (render watchdog: notify, errors, debug). */\n  readonly ports?: Partial<SummonPorts>;\n}\n\nexport function createSummonGate(options: CreateSummonGateOptions = {}): SummonGate {\n  let inject: ((reducers: Readonly<Record<string, Reducer>>) => void) | null = null;\n  let injected = false;\n  let api: MiddlewareAPI<Dispatch<UnknownAction>, unknown> | null = null;\n  let next: ((action: unknown) => unknown) | null = null;\n  let chain: ((action: unknown) => unknown) | null = null;\n  const queue: unknown[] = [];\n\n  const settle = (core: SummonCore, live: boolean) => {\n    if (inject && !injected) {\n      inject(core.reducers);\n      injected = true;\n    }\n    if (!api || !next || chain) return;\n    const store = api;\n    let composed: (action: unknown) => unknown = next;\n    for (const middleware of [...core.createMiddleware(options.ports)].reverse()) {\n      composed = middleware(store)(composed) as (action: unknown) => unknown;\n    }\n    chain = composed;\n    const flush = () => {\n      if (live) store.dispatch({ type: SUMMON_INSTALLED_ACTION });\n      for (const action of queue.splice(0)) store.dispatch(action as UnknownAction);\n    };\n    // Redux forbids dispatching while the middleware chain is being built.\n    if (live) flush();\n    else if (queue.length > 0) queueMicrotask(flush);\n  };\n\n  const internals: GateInternals = { install: (core) => settle(core, true) };\n  const core = () => slot().core;\n\n  const middleware: Middleware = (storeApi) => {\n    api = storeApi as MiddlewareAPI<Dispatch<UnknownAction>, unknown>;\n    return (nextDispatch) => {\n      next = nextDispatch as (action: unknown) => unknown;\n      const loaded = core();\n      if (loaded) settle(loaded, false);\n      else slot().gates.add(internals);\n      return (action) => {\n        if (chain) return chain(action);\n        if (!isSummonAction(action)) return nextDispatch(action);\n        queue.push(action);\n        void ensureSummonRuntime().catch((error: unknown) => {\n          // eslint-disable-next-line no-console\n          console.error(\"[summon] the overlay runtime failed to load; queued requests are kept for the next try\", error);\n        });\n        return action;\n      };\n    };\n  };\n\n  return {\n    middleware,\n    attachReducer(fn) {\n      inject = fn;\n      const loaded = core();\n      if (loaded) {\n        inject(loaded.reducers);\n        injected = true;\n      }\n    },\n  };\n}\n","// Callback-aware opening without loading the handles registry up front. The opener needs a\n// channel id synchronously (it rides open data); the channel itself is created when the handles\n// section arrives — one import() started by the first such open — or at once by whoever emits\n// first (the render tree has handles statically). Closing the owner before then drops it.\nimport { globalSlot } from \"@ai-matrx/kit/global-slot\";\nimport type { EventChannel } from \"../handles/helpers\";\n\ntype Handlers = Readonly<Record<string, ((payload: unknown) => void) | undefined>> | undefined;\n\ninterface PendingChannel {\n  readonly owner: string;\n  readonly getHandlers: () => Handlers;\n}\n\n/** The one message shape on an overlay's channel. */\nexport interface OverlayEventMessage {\n  readonly type: string;\n  readonly payload: unknown;\n}\n\ntype CreateChannel = (options: { owner?: string; id?: string }) => EventChannel<OverlayEventMessage>;\n\nconst pending = (): Map<string, PendingChannel> => globalSlot(\"ai-matrx.summon.pendingChannels\", () => new Map<string, PendingChannel>());\n\n/** Create every pending channel now (idempotent per id). */\nexport function materializePendingChannels(createEventChannel: CreateChannel): void {\n  const map = pending();\n  for (const [id, entry] of [...map]) {\n    map.delete(id);\n    const channel = createEventChannel({ owner: entry.owner, id });\n    channel.subscribe((message) => entry.getHandlers()?.[message.type]?.(message.payload));\n  }\n}\n\n/** Reserve a channel owned by `owner` whose events go to the handlers `getHandlers` returns at emit time. */\nexport function openPendingEventChannel(owner: string, getHandlers: () => Handlers): string {\n  const id = `ch-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n  pending().set(id, { owner, getHandlers });\n  void import(\"@ai-matrx/summon/handles\").then(({ createEventChannel }) => materializePendingChannels(createEventChannel));\n  return id;\n}\n\n/** The owner closed before its channel was created: forget it. */\nexport function dropPendingChannelsOf(owner: string): void {\n  const map = pending();\n  for (const [id, entry] of [...map]) if (entry.owner === owner) map.delete(id);\n}\n"],"mappings":"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","names":["globalSlot","state","globalSlot","globalSlot","core","middleware","globalSlot"]}