@agimon-ai/po-web-dashboard 0.0.0-alpha.0

package/dist/web/stores/sessionsStore.cjs

@@ -0,0 +1,272 @@
+let _agimon_ai_po_core_web = require("@agimon-ai/po-core/web");
+let _tanstack_store = require("@tanstack/store");
+let _tanstack_react_store = require("@tanstack/react-store");
+let _agimon_ai_po_core_hubChannel = require("@agimon-ai/po-core/hubChannel");
+//#region src/web/stores/sessionsStore.ts
+const initialState = {
+	order: [],
+	byId: {},
+	activeId: null,
+	transferringToId: null,
+	hydrated: false
+};
+const sessionsStore = new _tanstack_store.Store(initialState);
+(0, _agimon_ai_po_core_web.bindSessionApiWorkspace)((sessionId) => sessionsStore.state.byId[sessionId]?.summary.workspaceId);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asSummary(value) {
+	if (!isRecord(value) || typeof value.id !== "string" || value.id === "") return void 0;
+	return value;
+}
+/**
+* The parent this session nests under, or undefined when it renders at the top
+* level.
+*
+* A parent that has since closed, this session itself, a parent in another
+* workspace, or a cycle all resolve to undefined. The only safe failure is to
+* render the row where it can still be seen rather than to hide or duplicate it.
+*/
+function resolveParentId(byId, id) {
+	const parent = byId[id]?.summary.parentSessionId;
+	if (parent === void 0 || parent === id || byId[parent] === void 0 || byId[parent].summary.workspaceId !== byId[id].summary.workspaceId) return void 0;
+	let hops = 0;
+	const limit = Object.keys(byId).length;
+	for (let at = parent; at !== void 0; at = byId[at]?.summary.parentSessionId) {
+		if (at === id) return void 0;
+		if (++hops > limit) return void 0;
+	}
+	return parent;
+}
+/** A session read somewhere other than the rail: a workflow step's, or a workflow dispatcher's. */
+function railHidden(meta) {
+	const provenance = meta.summary.sessionProvenance;
+	return provenance === _agimon_ai_po_core_hubChannel.WORKFLOW_STEP_SESSION_PROVENANCE || provenance === _agimon_ai_po_core_hubChannel.WORKFLOW_DISPATCHER_SESSION_PROVENANCE;
+}
+/**
+* Where a session sits in the rail: under its nearest ancestor the rail shows.
+*
+* A fork or worktree a step session opens is a real session, and under a
+* parent the rail leaves out it would never be listed, so it moves up to the
+* first ancestor that is, or becomes a root.
+*/
+function railParentId(byId, id) {
+	let parent = resolveParentId(byId, id);
+	let hops = 0;
+	const limit = Object.keys(byId).length;
+	while (parent !== void 0 && railHidden(byId[parent]) && hops++ <= limit) parent = resolveParentId(byId, parent);
+	return parent;
+}
+/**
+* The rail's order: roots by creation, each immediately followed by its own
+* children.
+*
+* Ordinal shortcuts index this array positionally, which is why a child sits
+* directly after its parent instead of in a separate group: a worktree spawned
+* from the focused session lands on the next digit. With no lineage present
+* every session is a root and this produces exactly the flat creation sort it
+* replaces.
+*/
+function sortedOrder(byId) {
+	const byCreation = (left, right) => {
+		const a = byId[left].summary;
+		const b = byId[right].summary;
+		return a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id);
+	};
+	const children = /* @__PURE__ */ new Map();
+	const roots = [];
+	for (const id of Object.keys(byId)) {
+		if (railHidden(byId[id])) continue;
+		const parent = railParentId(byId, id);
+		if (parent === void 0) {
+			roots.push(id);
+			continue;
+		}
+		const siblings = children.get(parent);
+		if (siblings === void 0) children.set(parent, [id]);
+		else siblings.push(id);
+	}
+	roots.sort(byCreation);
+	for (const siblings of children.values()) siblings.sort(byCreation);
+	const order = [];
+	const visit = (id) => {
+		order.push(id);
+		for (const child of children.get(id) ?? []) visit(child);
+	};
+	for (const root of roots) visit(root);
+	return order;
+}
+function mergeSummary(previous, summary) {
+	const sticky = previous?.attach === "refused" && summary.attach === "connecting";
+	return {
+		summary,
+		attach: sticky ? "refused" : summary.attach,
+		reason: sticky ? previous.reason : summary.attachReason ?? "",
+		replayed: previous?.replayed ?? 0,
+		dropped: previous?.dropped ?? 0
+	};
+}
+function applySessionsSnapshot(frame) {
+	if (!Array.isArray(frame.sessions)) return;
+	const summaries = frame.sessions.map(asSummary).filter((summary) => Boolean(summary));
+	sessionsStore.setState((state) => {
+		const byId = {};
+		for (const summary of summaries) byId[summary.id] = mergeSummary(state.byId[summary.id], summary);
+		return {
+			...state,
+			byId,
+			order: sortedOrder(byId),
+			hydrated: true
+		};
+	});
+}
+function applySessionUpsert(frame) {
+	const summary = asSummary(frame.session);
+	if (!summary) return;
+	sessionsStore.setState((state) => {
+		const byId = {
+			...state.byId,
+			[summary.id]: mergeSummary(state.byId[summary.id], summary)
+		};
+		return {
+			...state,
+			byId,
+			order: sortedOrder(byId)
+		};
+	});
+}
+function applySessionRemoved(frame) {
+	const sessionId = frame.sessionId;
+	if (typeof sessionId !== "string") return;
+	sessionsStore.setState((state) => {
+		if (!(sessionId in state.byId)) return state;
+		const byId = { ...state.byId };
+		delete byId[sessionId];
+		return {
+			...state,
+			byId,
+			order: sortedOrder(byId)
+		};
+	});
+}
+/** Records what the hub replayed into this page when a subscription started. */
+function applySessionBacklog(sessionId, replayed, dropped) {
+	sessionsStore.setState((state) => {
+		const meta = state.byId[sessionId];
+		if (!meta) return state;
+		return {
+			...state,
+			byId: {
+				...state.byId,
+				[sessionId]: {
+					...meta,
+					replayed,
+					dropped
+				}
+			}
+		};
+	});
+}
+/**
+* The page socket died; every session is unreachable until it comes back.
+* Self-healing: the snapshot on reconnect restores the real states.
+*/
+function markSocketClosed() {
+	sessionsStore.setState((state) => {
+		const byId = {};
+		for (const [id, meta] of Object.entries(state.byId)) byId[id] = {
+			...meta,
+			attach: "offline",
+			reason: "The cockpit lost its bridge."
+		};
+		return {
+			...state,
+			byId
+		};
+	});
+}
+const APPEAR_TIMEOUT_MS = 15e3;
+/**
+* Resolves once the session shows up in the rail, or false on timeout.
+*
+* A freshly created session exists on disk before its upsert reaches this
+* page; navigating to it too early trips the unknown-session fallback and
+* bounces the user back. Waiting here is what makes "create, then land on it"
+* one motion.
+*/
+function waitForSession(sessionId, timeoutMs = APPEAR_TIMEOUT_MS) {
+	if (sessionId in sessionsStore.state.byId) return Promise.resolve(true);
+	return new Promise((resolve) => {
+		const finish = (found) => {
+			clearTimeout(timer);
+			subscription.unsubscribe();
+			resolve(found);
+		};
+		const subscription = sessionsStore.subscribe(() => {
+			if (sessionId in sessionsStore.state.byId) finish(true);
+		});
+		const timer = setTimeout(() => finish(false), timeoutMs);
+	});
+}
+/** Reads the focused session's rail entry, or null while nothing is focused. */
+function useActiveSessionMeta() {
+	return (0, _tanstack_react_store.useStore)(sessionsStore, (state) => state.activeId !== null ? state.byId[state.activeId] ?? null : null);
+}
+/**
+* True once the hub has answered and reported no sessions at all.
+*
+* Several surfaces stand down on this, so the rule is named once rather than
+* spelled out at each of them. The hydration half is what keeps it honest: an
+* empty order before the first snapshot only means the hub has not answered
+* yet, and treating that as "no sessions" would flash an onboarding screen at
+* someone who has ten.
+*/
+function noSessions(state) {
+	return state.hydrated && state.order.length === 0;
+}
+function useNoSessions() {
+	return (0, _tanstack_react_store.useStore)(sessionsStore, noSessions);
+}
+function setActiveSession(sessionId) {
+	sessionsStore.setState((state) => state.activeId === sessionId ? state : {
+		...state,
+		activeId: sessionId
+	});
+}
+function beginSessionTransfer(sessionId) {
+	sessionsStore.setState((state) => state.transferringToId === sessionId ? state : {
+		...state,
+		transferringToId: sessionId
+	});
+}
+function completeSessionTransfer(sessionId) {
+	sessionsStore.setState((state) => state.transferringToId === sessionId ? {
+		...state,
+		transferringToId: null
+	} : state);
+}
+function activeSessionId() {
+	return sessionsStore.state.activeId;
+}
+function resetSessions() {
+	sessionsStore.setState(() => initialState);
+}
+//#endregion
+exports.activeSessionId = activeSessionId;
+exports.applySessionBacklog = applySessionBacklog;
+exports.applySessionRemoved = applySessionRemoved;
+exports.applySessionUpsert = applySessionUpsert;
+exports.applySessionsSnapshot = applySessionsSnapshot;
+exports.beginSessionTransfer = beginSessionTransfer;
+exports.completeSessionTransfer = completeSessionTransfer;
+exports.markSocketClosed = markSocketClosed;
+exports.noSessions = noSessions;
+exports.resetSessions = resetSessions;
+exports.resolveParentId = resolveParentId;
+exports.sessionsStore = sessionsStore;
+exports.setActiveSession = setActiveSession;
+exports.useActiveSessionMeta = useActiveSessionMeta;
+exports.useNoSessions = useNoSessions;
+exports.waitForSession = waitForSession;
+
+//# sourceMappingURL=sessionsStore.cjs.map

package/dist/web/stores/sessionsStore.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionsStore.cjs","names":["Store","bindSessionApiWorkspace","WORKFLOW_STEP_SESSION_PROVENANCE","WORKFLOW_DISPATCHER_SESSION_PROVENANCE","useStore"],"sources":["../../../src/web/stores/sessionsStore.ts"],"sourcesContent":["import {\n  WORKFLOW_DISPATCHER_SESSION_PROVENANCE,\n  WORKFLOW_STEP_SESSION_PROVENANCE,\n} from '@agimon-ai/po-core/hubChannel';\nimport { bindSessionApiWorkspace } from '@agimon-ai/po-core/web';\nimport { useStore } from '@tanstack/react-store';\nimport { Store } from '@tanstack/store';\n\nimport type { SessionSummary } from '../../types/hub';\nimport type { AttachPhase } from '../lib/sessionSummary';\n\n/** One rail entry: the hub's summary plus this page's view of its connection. */\nexport interface SessionMeta {\n  summary: SessionSummary;\n  /** summary.attach adjusted for sticky refusals and a lost page socket. */\n  attach: AttachPhase;\n  reason: string;\n  /** Frames replayed into this page's timeline on the last subscribe. */\n  replayed: number;\n  /** Frames the hub's bounded ring lost before this page subscribed. */\n  dropped: number;\n}\n\nexport interface SessionsState {\n  /** Session ids in rail order: each parent immediately followed by its children. */\n  order: string[];\n  byId: Record<string, SessionMeta>;\n  activeId: string | null;\n  /** Destination shown while an autonomous voice handoff changes route and media ownership. */\n  transferringToId: string | null;\n  /** False until the first snapshot; routing waits for it before redirecting. */\n  hydrated: boolean;\n}\n\nconst initialState: SessionsState = { order: [], byId: {}, activeId: null, transferringToId: null, hydrated: false };\n\nexport const sessionsStore = new Store<SessionsState>(initialState);\nbindSessionApiWorkspace((sessionId) => sessionsStore.state.byId[sessionId]?.summary.workspaceId);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction asSummary(value: unknown): SessionSummary | undefined {\n  if (!isRecord(value) || typeof value.id !== 'string' || value.id === '') return undefined;\n  return value as unknown as SessionSummary;\n}\n\n/**\n * The parent this session nests under, or undefined when it renders at the top\n * level.\n *\n * A parent that has since closed, this session itself, a parent in another\n * workspace, or a cycle all resolve to undefined. The only safe failure is to\n * render the row where it can still be seen rather than to hide or duplicate it.\n */\nexport function resolveParentId(byId: Record<string, SessionMeta>, id: string): string | undefined {\n  const parent = byId[id]?.summary.parentSessionId;\n  if (\n    parent === undefined ||\n    parent === id ||\n    byId[parent] === undefined ||\n    byId[parent].summary.workspaceId !== byId[id].summary.workspaceId\n  )\n    return undefined;\n  let hops = 0;\n  const limit = Object.keys(byId).length;\n  for (let at: string | undefined = parent; at !== undefined; at = byId[at]?.summary.parentSessionId) {\n    if (at === id) return undefined;\n    if (++hops > limit) return undefined;\n  }\n  return parent;\n}\n\n/** A session read somewhere other than the rail: a workflow step's, or a workflow dispatcher's. */\nfunction railHidden(meta: SessionMeta): boolean {\n  const provenance = meta.summary.sessionProvenance;\n  return provenance === WORKFLOW_STEP_SESSION_PROVENANCE || provenance === WORKFLOW_DISPATCHER_SESSION_PROVENANCE;\n}\n\n/**\n * Where a session sits in the rail: under its nearest ancestor the rail shows.\n *\n * A fork or worktree a step session opens is a real session, and under a\n * parent the rail leaves out it would never be listed, so it moves up to the\n * first ancestor that is, or becomes a root.\n */\nfunction railParentId(byId: Record<string, SessionMeta>, id: string): string | undefined {\n  let parent = resolveParentId(byId, id);\n  let hops = 0;\n  const limit = Object.keys(byId).length;\n  while (parent !== undefined && railHidden(byId[parent]) && hops++ <= limit) parent = resolveParentId(byId, parent);\n  return parent;\n}\n\n/**\n * The rail's order: roots by creation, each immediately followed by its own\n * children.\n *\n * Ordinal shortcuts index this array positionally, which is why a child sits\n * directly after its parent instead of in a separate group: a worktree spawned\n * from the focused session lands on the next digit. With no lineage present\n * every session is a root and this produces exactly the flat creation sort it\n * replaces.\n */\nfunction sortedOrder(byId: Record<string, SessionMeta>): string[] {\n  // A workflow step's session is read inside its workflow, never from the rail, so it\n  // takes no row and no ordinal. It stays in `byId` for that view to follow. A\n  // workflow dispatcher is a short-lived helper whose runs belong to its parent.\n  const byCreation = (left: string, right: string): number => {\n    const a = byId[left].summary;\n    const b = byId[right].summary;\n    return a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id);\n  };\n  const children = new Map<string, string[]>();\n  const roots: string[] = [];\n  for (const id of Object.keys(byId)) {\n    if (railHidden(byId[id])) continue;\n    const parent = railParentId(byId, id);\n    if (parent === undefined) {\n      roots.push(id);\n      continue;\n    }\n    const siblings = children.get(parent);\n    if (siblings === undefined) children.set(parent, [id]);\n    else siblings.push(id);\n  }\n  roots.sort(byCreation);\n  for (const siblings of children.values()) siblings.sort(byCreation);\n  const order: string[] = [];\n  const visit = (id: string): void => {\n    order.push(id);\n    for (const child of children.get(id) ?? []) visit(child);\n  };\n  for (const root of roots) visit(root);\n  return order;\n}\n\nfunction mergeSummary(previous: SessionMeta | undefined, summary: SessionSummary): SessionMeta {\n  // A refusal is sticky: the hub keeps retrying underneath, and reporting each\n  // attempt would flicker the card between \"refused\" and \"connecting\" while\n  // nothing has actually changed. Only a successful attach clears it.\n  const sticky = previous?.attach === 'refused' && summary.attach === 'connecting';\n  return {\n    summary,\n    attach: sticky ? 'refused' : summary.attach,\n    reason: sticky ? previous.reason : (summary.attachReason ?? ''),\n    replayed: previous?.replayed ?? 0,\n    dropped: previous?.dropped ?? 0,\n  };\n}\n\nexport function applySessionsSnapshot(frame: Record<string, unknown>): void {\n  if (!Array.isArray(frame.sessions)) return;\n  const summaries = frame.sessions.map(asSummary).filter((summary): summary is SessionSummary => Boolean(summary));\n  sessionsStore.setState((state) => {\n    const byId: Record<string, SessionMeta> = {};\n    for (const summary of summaries) byId[summary.id] = mergeSummary(state.byId[summary.id], summary);\n    return { ...state, byId, order: sortedOrder(byId), hydrated: true };\n  });\n}\n\nexport function applySessionUpsert(frame: Record<string, unknown>): void {\n  const summary = asSummary(frame.session);\n  if (!summary) return;\n  sessionsStore.setState((state) => {\n    const byId = { ...state.byId, [summary.id]: mergeSummary(state.byId[summary.id], summary) };\n    return { ...state, byId, order: sortedOrder(byId) };\n  });\n}\n\nexport function applySessionRemoved(frame: Record<string, unknown>): void {\n  const sessionId = frame.sessionId;\n  if (typeof sessionId !== 'string') return;\n  sessionsStore.setState((state) => {\n    if (!(sessionId in state.byId)) return state;\n    const byId = { ...state.byId };\n    delete byId[sessionId];\n    return { ...state, byId, order: sortedOrder(byId) };\n  });\n}\n\n/** Records what the hub replayed into this page when a subscription started. */\nexport function applySessionBacklog(sessionId: string, replayed: number, dropped: number): void {\n  sessionsStore.setState((state) => {\n    const meta = state.byId[sessionId];\n    if (!meta) return state;\n    return { ...state, byId: { ...state.byId, [sessionId]: { ...meta, replayed, dropped } } };\n  });\n}\n\n/**\n * The page socket died; every session is unreachable until it comes back.\n * Self-healing: the snapshot on reconnect restores the real states.\n */\nexport function markSocketClosed(): void {\n  sessionsStore.setState((state) => {\n    const byId: Record<string, SessionMeta> = {};\n    for (const [id, meta] of Object.entries(state.byId)) {\n      byId[id] = { ...meta, attach: 'offline', reason: 'The cockpit lost its bridge.' };\n    }\n    return { ...state, byId };\n  });\n}\n\nconst APPEAR_TIMEOUT_MS = 15_000;\n\n/**\n * Resolves once the session shows up in the rail, or false on timeout.\n *\n * A freshly created session exists on disk before its upsert reaches this\n * page; navigating to it too early trips the unknown-session fallback and\n * bounces the user back. Waiting here is what makes \"create, then land on it\"\n * one motion.\n */\nexport function waitForSession(sessionId: string, timeoutMs = APPEAR_TIMEOUT_MS): Promise<boolean> {\n  if (sessionId in sessionsStore.state.byId) return Promise.resolve(true);\n  return new Promise((resolve) => {\n    const finish = (found: boolean): void => {\n      clearTimeout(timer);\n      subscription.unsubscribe();\n      resolve(found);\n    };\n    const subscription = sessionsStore.subscribe(() => {\n      if (sessionId in sessionsStore.state.byId) finish(true);\n    });\n    const timer = setTimeout(() => finish(false), timeoutMs);\n  });\n}\n\n/** Reads the focused session's rail entry, or null while nothing is focused. */\nexport function useActiveSessionMeta(): SessionMeta | null {\n  return useStore(sessionsStore, (state) => (state.activeId !== null ? (state.byId[state.activeId] ?? null) : null));\n}\n\n/**\n * True once the hub has answered and reported no sessions at all.\n *\n * Several surfaces stand down on this, so the rule is named once rather than\n * spelled out at each of them. The hydration half is what keeps it honest: an\n * empty order before the first snapshot only means the hub has not answered\n * yet, and treating that as \"no sessions\" would flash an onboarding screen at\n * someone who has ten.\n */\nexport function noSessions(state: SessionsState): boolean {\n  return state.hydrated && state.order.length === 0;\n}\n\nexport function useNoSessions(): boolean {\n  return useStore(sessionsStore, noSessions);\n}\n\nexport function setActiveSession(sessionId: string | null): void {\n  sessionsStore.setState((state) => (state.activeId === sessionId ? state : { ...state, activeId: sessionId }));\n}\n\nexport function beginSessionTransfer(sessionId: string): void {\n  sessionsStore.setState((state) =>\n    state.transferringToId === sessionId ? state : { ...state, transferringToId: sessionId },\n  );\n}\n\nexport function completeSessionTransfer(sessionId: string): void {\n  sessionsStore.setState((state) =>\n    state.transferringToId === sessionId ? { ...state, transferringToId: null } : state,\n  );\n}\n\nexport function activeSessionId(): string | null {\n  return sessionsStore.state.activeId;\n}\n\nexport function resetSessions(): void {\n  sessionsStore.setState(() => initialState);\n}\n"],"mappings":"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"}

package/dist/web/stores/sessionsStore.d.mts

@@ -0,0 +1,74 @@
+import { SessionSummary } from "../../types/hub.mjs";
+import { AttachPhase } from "../lib/sessionSummary.mjs";
+import { Store } from "@tanstack/store";
+//#region src/web/stores/sessionsStore.d.ts
+/** One rail entry: the hub's summary plus this page's view of its connection. */
+export interface SessionMeta {
+  summary: SessionSummary;
+  /** summary.attach adjusted for sticky refusals and a lost page socket. */
+  attach: AttachPhase;
+  reason: string;
+  /** Frames replayed into this page's timeline on the last subscribe. */
+  replayed: number;
+  /** Frames the hub's bounded ring lost before this page subscribed. */
+  dropped: number;
+}
+export interface SessionsState {
+  /** Session ids in rail order: each parent immediately followed by its children. */
+  order: string[];
+  byId: Record<string, SessionMeta>;
+  activeId: string | null;
+  /** Destination shown while an autonomous voice handoff changes route and media ownership. */
+  transferringToId: string | null;
+  /** False until the first snapshot; routing waits for it before redirecting. */
+  hydrated: boolean;
+}
+export declare const sessionsStore: Store<SessionsState, never>;
+/**
+ * The parent this session nests under, or undefined when it renders at the top
+ * level.
+ *
+ * A parent that has since closed, this session itself, a parent in another
+ * workspace, or a cycle all resolve to undefined. The only safe failure is to
+ * render the row where it can still be seen rather than to hide or duplicate it.
+ */
+export declare function resolveParentId(byId: Record<string, SessionMeta>, id: string): string | undefined;
+export declare function applySessionsSnapshot(frame: Record<string, unknown>): void;
+export declare function applySessionUpsert(frame: Record<string, unknown>): void;
+export declare function applySessionRemoved(frame: Record<string, unknown>): void;
+/** Records what the hub replayed into this page when a subscription started. */
+export declare function applySessionBacklog(sessionId: string, replayed: number, dropped: number): void;
+/**
+ * The page socket died; every session is unreachable until it comes back.
+ * Self-healing: the snapshot on reconnect restores the real states.
+ */
+export declare function markSocketClosed(): void;
+/**
+ * Resolves once the session shows up in the rail, or false on timeout.
+ *
+ * A freshly created session exists on disk before its upsert reaches this
+ * page; navigating to it too early trips the unknown-session fallback and
+ * bounces the user back. Waiting here is what makes "create, then land on it"
+ * one motion.
+ */
+export declare function waitForSession(sessionId: string, timeoutMs?: number): Promise<boolean>;
+/** Reads the focused session's rail entry, or null while nothing is focused. */
+export declare function useActiveSessionMeta(): SessionMeta | null;
+/**
+ * True once the hub has answered and reported no sessions at all.
+ *
+ * Several surfaces stand down on this, so the rule is named once rather than
+ * spelled out at each of them. The hydration half is what keeps it honest: an
+ * empty order before the first snapshot only means the hub has not answered
+ * yet, and treating that as "no sessions" would flash an onboarding screen at
+ * someone who has ten.
+ */
+export declare function noSessions(state: SessionsState): boolean;
+export declare function useNoSessions(): boolean;
+export declare function setActiveSession(sessionId: string | null): void;
+export declare function beginSessionTransfer(sessionId: string): void;
+export declare function completeSessionTransfer(sessionId: string): void;
+export declare function activeSessionId(): string | null;
+export declare function resetSessions(): void;
+//#endregion
+//# sourceMappingURL=sessionsStore.d.mts.map

package/dist/web/stores/sessionsStore.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionsStore.d.mts","names":[],"sources":["../../../src/web/stores/sessionsStore.ts"],"mappings":";;;;;iBAYiB;EACf,SAAS;;EAET,QAAQ;EACR;;EAEA;;EAEA;;iBAGe;;EAEf;EACA,MAAM,eAAe;EACrB;;EAEA;;EAEA;;qBAKW,eAAa,MAAA;;;;;;;;;wBAoBV,gBAAgB,MAAM,eAAe,cAAc;wBAgGnD,sBAAsB,OAAO;wBAU7B,mBAAmB,OAAO;wBAS1B,oBAAoB,OAAO;;wBAY3B,oBAAoB,mBAAmB,kBAAkB;;;;;wBAYzD;;;;;;;;;wBAoBA,eAAe,mBAAmB,qBAAgC;;wBAgBlE,wBAAwB;;;;;;;;;;wBAaxB,WAAW,OAAO;wBAIlB;wBAIA,iBAAiB;wBAIjB,qBAAqB;wBAMrB,wBAAwB;wBAMxB;wBAIA"}

package/dist/web/stores/sessionsStore.mjs

@@ -0,0 +1,257 @@
+import { bindSessionApiWorkspace } from "@agimon-ai/po-core/web";
+import { Store } from "@tanstack/store";
+import { useStore } from "@tanstack/react-store";
+import { WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE } from "@agimon-ai/po-core/hubChannel";
+//#region src/web/stores/sessionsStore.ts
+const initialState = {
+	order: [],
+	byId: {},
+	activeId: null,
+	transferringToId: null,
+	hydrated: false
+};
+const sessionsStore = new Store(initialState);
+bindSessionApiWorkspace((sessionId) => sessionsStore.state.byId[sessionId]?.summary.workspaceId);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asSummary(value) {
+	if (!isRecord(value) || typeof value.id !== "string" || value.id === "") return void 0;
+	return value;
+}
+/**
+* The parent this session nests under, or undefined when it renders at the top
+* level.
+*
+* A parent that has since closed, this session itself, a parent in another
+* workspace, or a cycle all resolve to undefined. The only safe failure is to
+* render the row where it can still be seen rather than to hide or duplicate it.
+*/
+function resolveParentId(byId, id) {
+	const parent = byId[id]?.summary.parentSessionId;
+	if (parent === void 0 || parent === id || byId[parent] === void 0 || byId[parent].summary.workspaceId !== byId[id].summary.workspaceId) return void 0;
+	let hops = 0;
+	const limit = Object.keys(byId).length;
+	for (let at = parent; at !== void 0; at = byId[at]?.summary.parentSessionId) {
+		if (at === id) return void 0;
+		if (++hops > limit) return void 0;
+	}
+	return parent;
+}
+/** A session read somewhere other than the rail: a workflow step's, or a workflow dispatcher's. */
+function railHidden(meta) {
+	const provenance = meta.summary.sessionProvenance;
+	return provenance === WORKFLOW_STEP_SESSION_PROVENANCE || provenance === WORKFLOW_DISPATCHER_SESSION_PROVENANCE;
+}
+/**
+* Where a session sits in the rail: under its nearest ancestor the rail shows.
+*
+* A fork or worktree a step session opens is a real session, and under a
+* parent the rail leaves out it would never be listed, so it moves up to the
+* first ancestor that is, or becomes a root.
+*/
+function railParentId(byId, id) {
+	let parent = resolveParentId(byId, id);
+	let hops = 0;
+	const limit = Object.keys(byId).length;
+	while (parent !== void 0 && railHidden(byId[parent]) && hops++ <= limit) parent = resolveParentId(byId, parent);
+	return parent;
+}
+/**
+* The rail's order: roots by creation, each immediately followed by its own
+* children.
+*
+* Ordinal shortcuts index this array positionally, which is why a child sits
+* directly after its parent instead of in a separate group: a worktree spawned
+* from the focused session lands on the next digit. With no lineage present
+* every session is a root and this produces exactly the flat creation sort it
+* replaces.
+*/
+function sortedOrder(byId) {
+	const byCreation = (left, right) => {
+		const a = byId[left].summary;
+		const b = byId[right].summary;
+		return a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id);
+	};
+	const children = /* @__PURE__ */ new Map();
+	const roots = [];
+	for (const id of Object.keys(byId)) {
+		if (railHidden(byId[id])) continue;
+		const parent = railParentId(byId, id);
+		if (parent === void 0) {
+			roots.push(id);
+			continue;
+		}
+		const siblings = children.get(parent);
+		if (siblings === void 0) children.set(parent, [id]);
+		else siblings.push(id);
+	}
+	roots.sort(byCreation);
+	for (const siblings of children.values()) siblings.sort(byCreation);
+	const order = [];
+	const visit = (id) => {
+		order.push(id);
+		for (const child of children.get(id) ?? []) visit(child);
+	};
+	for (const root of roots) visit(root);
+	return order;
+}
+function mergeSummary(previous, summary) {
+	const sticky = previous?.attach === "refused" && summary.attach === "connecting";
+	return {
+		summary,
+		attach: sticky ? "refused" : summary.attach,
+		reason: sticky ? previous.reason : summary.attachReason ?? "",
+		replayed: previous?.replayed ?? 0,
+		dropped: previous?.dropped ?? 0
+	};
+}
+function applySessionsSnapshot(frame) {
+	if (!Array.isArray(frame.sessions)) return;
+	const summaries = frame.sessions.map(asSummary).filter((summary) => Boolean(summary));
+	sessionsStore.setState((state) => {
+		const byId = {};
+		for (const summary of summaries) byId[summary.id] = mergeSummary(state.byId[summary.id], summary);
+		return {
+			...state,
+			byId,
+			order: sortedOrder(byId),
+			hydrated: true
+		};
+	});
+}
+function applySessionUpsert(frame) {
+	const summary = asSummary(frame.session);
+	if (!summary) return;
+	sessionsStore.setState((state) => {
+		const byId = {
+			...state.byId,
+			[summary.id]: mergeSummary(state.byId[summary.id], summary)
+		};
+		return {
+			...state,
+			byId,
+			order: sortedOrder(byId)
+		};
+	});
+}
+function applySessionRemoved(frame) {
+	const sessionId = frame.sessionId;
+	if (typeof sessionId !== "string") return;
+	sessionsStore.setState((state) => {
+		if (!(sessionId in state.byId)) return state;
+		const byId = { ...state.byId };
+		delete byId[sessionId];
+		return {
+			...state,
+			byId,
+			order: sortedOrder(byId)
+		};
+	});
+}
+/** Records what the hub replayed into this page when a subscription started. */
+function applySessionBacklog(sessionId, replayed, dropped) {
+	sessionsStore.setState((state) => {
+		const meta = state.byId[sessionId];
+		if (!meta) return state;
+		return {
+			...state,
+			byId: {
+				...state.byId,
+				[sessionId]: {
+					...meta,
+					replayed,
+					dropped
+				}
+			}
+		};
+	});
+}
+/**
+* The page socket died; every session is unreachable until it comes back.
+* Self-healing: the snapshot on reconnect restores the real states.
+*/
+function markSocketClosed() {
+	sessionsStore.setState((state) => {
+		const byId = {};
+		for (const [id, meta] of Object.entries(state.byId)) byId[id] = {
+			...meta,
+			attach: "offline",
+			reason: "The cockpit lost its bridge."
+		};
+		return {
+			...state,
+			byId
+		};
+	});
+}
+const APPEAR_TIMEOUT_MS = 15e3;
+/**
+* Resolves once the session shows up in the rail, or false on timeout.
+*
+* A freshly created session exists on disk before its upsert reaches this
+* page; navigating to it too early trips the unknown-session fallback and
+* bounces the user back. Waiting here is what makes "create, then land on it"
+* one motion.
+*/
+function waitForSession(sessionId, timeoutMs = APPEAR_TIMEOUT_MS) {
+	if (sessionId in sessionsStore.state.byId) return Promise.resolve(true);
+	return new Promise((resolve) => {
+		const finish = (found) => {
+			clearTimeout(timer);
+			subscription.unsubscribe();
+			resolve(found);
+		};
+		const subscription = sessionsStore.subscribe(() => {
+			if (sessionId in sessionsStore.state.byId) finish(true);
+		});
+		const timer = setTimeout(() => finish(false), timeoutMs);
+	});
+}
+/** Reads the focused session's rail entry, or null while nothing is focused. */
+function useActiveSessionMeta() {
+	return useStore(sessionsStore, (state) => state.activeId !== null ? state.byId[state.activeId] ?? null : null);
+}
+/**
+* True once the hub has answered and reported no sessions at all.
+*
+* Several surfaces stand down on this, so the rule is named once rather than
+* spelled out at each of them. The hydration half is what keeps it honest: an
+* empty order before the first snapshot only means the hub has not answered
+* yet, and treating that as "no sessions" would flash an onboarding screen at
+* someone who has ten.
+*/
+function noSessions(state) {
+	return state.hydrated && state.order.length === 0;
+}
+function useNoSessions() {
+	return useStore(sessionsStore, noSessions);
+}
+function setActiveSession(sessionId) {
+	sessionsStore.setState((state) => state.activeId === sessionId ? state : {
+		...state,
+		activeId: sessionId
+	});
+}
+function beginSessionTransfer(sessionId) {
+	sessionsStore.setState((state) => state.transferringToId === sessionId ? state : {
+		...state,
+		transferringToId: sessionId
+	});
+}
+function completeSessionTransfer(sessionId) {
+	sessionsStore.setState((state) => state.transferringToId === sessionId ? {
+		...state,
+		transferringToId: null
+	} : state);
+}
+function activeSessionId() {
+	return sessionsStore.state.activeId;
+}
+function resetSessions() {
+	sessionsStore.setState(() => initialState);
+}
+//#endregion
+export { activeSessionId, applySessionBacklog, applySessionRemoved, applySessionUpsert, applySessionsSnapshot, beginSessionTransfer, completeSessionTransfer, markSocketClosed, noSessions, resetSessions, resolveParentId, sessionsStore, setActiveSession, useActiveSessionMeta, useNoSessions, waitForSession };
+
+//# sourceMappingURL=sessionsStore.mjs.map

package/dist/web/stores/sessionsStore.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionsStore.mjs","names":[],"sources":["../../../src/web/stores/sessionsStore.ts"],"sourcesContent":["import {\n  WORKFLOW_DISPATCHER_SESSION_PROVENANCE,\n  WORKFLOW_STEP_SESSION_PROVENANCE,\n} from '@agimon-ai/po-core/hubChannel';\nimport { bindSessionApiWorkspace } from '@agimon-ai/po-core/web';\nimport { useStore } from '@tanstack/react-store';\nimport { Store } from '@tanstack/store';\n\nimport type { SessionSummary } from '../../types/hub';\nimport type { AttachPhase } from '../lib/sessionSummary';\n\n/** One rail entry: the hub's summary plus this page's view of its connection. */\nexport interface SessionMeta {\n  summary: SessionSummary;\n  /** summary.attach adjusted for sticky refusals and a lost page socket. */\n  attach: AttachPhase;\n  reason: string;\n  /** Frames replayed into this page's timeline on the last subscribe. */\n  replayed: number;\n  /** Frames the hub's bounded ring lost before this page subscribed. */\n  dropped: number;\n}\n\nexport interface SessionsState {\n  /** Session ids in rail order: each parent immediately followed by its children. */\n  order: string[];\n  byId: Record<string, SessionMeta>;\n  activeId: string | null;\n  /** Destination shown while an autonomous voice handoff changes route and media ownership. */\n  transferringToId: string | null;\n  /** False until the first snapshot; routing waits for it before redirecting. */\n  hydrated: boolean;\n}\n\nconst initialState: SessionsState = { order: [], byId: {}, activeId: null, transferringToId: null, hydrated: false };\n\nexport const sessionsStore = new Store<SessionsState>(initialState);\nbindSessionApiWorkspace((sessionId) => sessionsStore.state.byId[sessionId]?.summary.workspaceId);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction asSummary(value: unknown): SessionSummary | undefined {\n  if (!isRecord(value) || typeof value.id !== 'string' || value.id === '') return undefined;\n  return value as unknown as SessionSummary;\n}\n\n/**\n * The parent this session nests under, or undefined when it renders at the top\n * level.\n *\n * A parent that has since closed, this session itself, a parent in another\n * workspace, or a cycle all resolve to undefined. The only safe failure is to\n * render the row where it can still be seen rather than to hide or duplicate it.\n */\nexport function resolveParentId(byId: Record<string, SessionMeta>, id: string): string | undefined {\n  const parent = byId[id]?.summary.parentSessionId;\n  if (\n    parent === undefined ||\n    parent === id ||\n    byId[parent] === undefined ||\n    byId[parent].summary.workspaceId !== byId[id].summary.workspaceId\n  )\n    return undefined;\n  let hops = 0;\n  const limit = Object.keys(byId).length;\n  for (let at: string | undefined = parent; at !== undefined; at = byId[at]?.summary.parentSessionId) {\n    if (at === id) return undefined;\n    if (++hops > limit) return undefined;\n  }\n  return parent;\n}\n\n/** A session read somewhere other than the rail: a workflow step's, or a workflow dispatcher's. */\nfunction railHidden(meta: SessionMeta): boolean {\n  const provenance = meta.summary.sessionProvenance;\n  return provenance === WORKFLOW_STEP_SESSION_PROVENANCE || provenance === WORKFLOW_DISPATCHER_SESSION_PROVENANCE;\n}\n\n/**\n * Where a session sits in the rail: under its nearest ancestor the rail shows.\n *\n * A fork or worktree a step session opens is a real session, and under a\n * parent the rail leaves out it would never be listed, so it moves up to the\n * first ancestor that is, or becomes a root.\n */\nfunction railParentId(byId: Record<string, SessionMeta>, id: string): string | undefined {\n  let parent = resolveParentId(byId, id);\n  let hops = 0;\n  const limit = Object.keys(byId).length;\n  while (parent !== undefined && railHidden(byId[parent]) && hops++ <= limit) parent = resolveParentId(byId, parent);\n  return parent;\n}\n\n/**\n * The rail's order: roots by creation, each immediately followed by its own\n * children.\n *\n * Ordinal shortcuts index this array positionally, which is why a child sits\n * directly after its parent instead of in a separate group: a worktree spawned\n * from the focused session lands on the next digit. With no lineage present\n * every session is a root and this produces exactly the flat creation sort it\n * replaces.\n */\nfunction sortedOrder(byId: Record<string, SessionMeta>): string[] {\n  // A workflow step's session is read inside its workflow, never from the rail, so it\n  // takes no row and no ordinal. It stays in `byId` for that view to follow. A\n  // workflow dispatcher is a short-lived helper whose runs belong to its parent.\n  const byCreation = (left: string, right: string): number => {\n    const a = byId[left].summary;\n    const b = byId[right].summary;\n    return a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id);\n  };\n  const children = new Map<string, string[]>();\n  const roots: string[] = [];\n  for (const id of Object.keys(byId)) {\n    if (railHidden(byId[id])) continue;\n    const parent = railParentId(byId, id);\n    if (parent === undefined) {\n      roots.push(id);\n      continue;\n    }\n    const siblings = children.get(parent);\n    if (siblings === undefined) children.set(parent, [id]);\n    else siblings.push(id);\n  }\n  roots.sort(byCreation);\n  for (const siblings of children.values()) siblings.sort(byCreation);\n  const order: string[] = [];\n  const visit = (id: string): void => {\n    order.push(id);\n    for (const child of children.get(id) ?? []) visit(child);\n  };\n  for (const root of roots) visit(root);\n  return order;\n}\n\nfunction mergeSummary(previous: SessionMeta | undefined, summary: SessionSummary): SessionMeta {\n  // A refusal is sticky: the hub keeps retrying underneath, and reporting each\n  // attempt would flicker the card between \"refused\" and \"connecting\" while\n  // nothing has actually changed. Only a successful attach clears it.\n  const sticky = previous?.attach === 'refused' && summary.attach === 'connecting';\n  return {\n    summary,\n    attach: sticky ? 'refused' : summary.attach,\n    reason: sticky ? previous.reason : (summary.attachReason ?? ''),\n    replayed: previous?.replayed ?? 0,\n    dropped: previous?.dropped ?? 0,\n  };\n}\n\nexport function applySessionsSnapshot(frame: Record<string, unknown>): void {\n  if (!Array.isArray(frame.sessions)) return;\n  const summaries = frame.sessions.map(asSummary).filter((summary): summary is SessionSummary => Boolean(summary));\n  sessionsStore.setState((state) => {\n    const byId: Record<string, SessionMeta> = {};\n    for (const summary of summaries) byId[summary.id] = mergeSummary(state.byId[summary.id], summary);\n    return { ...state, byId, order: sortedOrder(byId), hydrated: true };\n  });\n}\n\nexport function applySessionUpsert(frame: Record<string, unknown>): void {\n  const summary = asSummary(frame.session);\n  if (!summary) return;\n  sessionsStore.setState((state) => {\n    const byId = { ...state.byId, [summary.id]: mergeSummary(state.byId[summary.id], summary) };\n    return { ...state, byId, order: sortedOrder(byId) };\n  });\n}\n\nexport function applySessionRemoved(frame: Record<string, unknown>): void {\n  const sessionId = frame.sessionId;\n  if (typeof sessionId !== 'string') return;\n  sessionsStore.setState((state) => {\n    if (!(sessionId in state.byId)) return state;\n    const byId = { ...state.byId };\n    delete byId[sessionId];\n    return { ...state, byId, order: sortedOrder(byId) };\n  });\n}\n\n/** Records what the hub replayed into this page when a subscription started. */\nexport function applySessionBacklog(sessionId: string, replayed: number, dropped: number): void {\n  sessionsStore.setState((state) => {\n    const meta = state.byId[sessionId];\n    if (!meta) return state;\n    return { ...state, byId: { ...state.byId, [sessionId]: { ...meta, replayed, dropped } } };\n  });\n}\n\n/**\n * The page socket died; every session is unreachable until it comes back.\n * Self-healing: the snapshot on reconnect restores the real states.\n */\nexport function markSocketClosed(): void {\n  sessionsStore.setState((state) => {\n    const byId: Record<string, SessionMeta> = {};\n    for (const [id, meta] of Object.entries(state.byId)) {\n      byId[id] = { ...meta, attach: 'offline', reason: 'The cockpit lost its bridge.' };\n    }\n    return { ...state, byId };\n  });\n}\n\nconst APPEAR_TIMEOUT_MS = 15_000;\n\n/**\n * Resolves once the session shows up in the rail, or false on timeout.\n *\n * A freshly created session exists on disk before its upsert reaches this\n * page; navigating to it too early trips the unknown-session fallback and\n * bounces the user back. Waiting here is what makes \"create, then land on it\"\n * one motion.\n */\nexport function waitForSession(sessionId: string, timeoutMs = APPEAR_TIMEOUT_MS): Promise<boolean> {\n  if (sessionId in sessionsStore.state.byId) return Promise.resolve(true);\n  return new Promise((resolve) => {\n    const finish = (found: boolean): void => {\n      clearTimeout(timer);\n      subscription.unsubscribe();\n      resolve(found);\n    };\n    const subscription = sessionsStore.subscribe(() => {\n      if (sessionId in sessionsStore.state.byId) finish(true);\n    });\n    const timer = setTimeout(() => finish(false), timeoutMs);\n  });\n}\n\n/** Reads the focused session's rail entry, or null while nothing is focused. */\nexport function useActiveSessionMeta(): SessionMeta | null {\n  return useStore(sessionsStore, (state) => (state.activeId !== null ? (state.byId[state.activeId] ?? null) : null));\n}\n\n/**\n * True once the hub has answered and reported no sessions at all.\n *\n * Several surfaces stand down on this, so the rule is named once rather than\n * spelled out at each of them. The hydration half is what keeps it honest: an\n * empty order before the first snapshot only means the hub has not answered\n * yet, and treating that as \"no sessions\" would flash an onboarding screen at\n * someone who has ten.\n */\nexport function noSessions(state: SessionsState): boolean {\n  return state.hydrated && state.order.length === 0;\n}\n\nexport function useNoSessions(): boolean {\n  return useStore(sessionsStore, noSessions);\n}\n\nexport function setActiveSession(sessionId: string | null): void {\n  sessionsStore.setState((state) => (state.activeId === sessionId ? state : { ...state, activeId: sessionId }));\n}\n\nexport function beginSessionTransfer(sessionId: string): void {\n  sessionsStore.setState((state) =>\n    state.transferringToId === sessionId ? state : { ...state, transferringToId: sessionId },\n  );\n}\n\nexport function completeSessionTransfer(sessionId: string): void {\n  sessionsStore.setState((state) =>\n    state.transferringToId === sessionId ? { ...state, transferringToId: null } : state,\n  );\n}\n\nexport function activeSessionId(): string | null {\n  return sessionsStore.state.activeId;\n}\n\nexport function resetSessions(): void {\n  sessionsStore.setState(() => initialState);\n}\n"],"mappings":"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"}