zidane-ui 9.1.4 → 9.1.6

package/dist/session/SecretsPanel.js

@@ -0,0 +1,241 @@
+import { IconButton } from "../components/IconButton.js";
+import { PanelEmpty, PanelLoading } from "../components/PanelEmpty.js";
+import { PANEL_ROW, PANEL_ROW_HOVER } from "../components/PanelRows.js";
+import { useMinuteTick } from "../hooks/useMinuteTick.js";
+import { useSessionHost, useSessionSecrets } from "./SessionProvider.js";
+import { useSessionLabels } from "./useSessionLabels.js";
+import { BTN_GHOST, BTN_PRIMARY, CardError, INPUT } from "../chat/interactions/card-ui.js";
+import { secretTimeLeft } from "../chat/headless/secrets.js";
+import { SecretInput } from "../chat/interactions/SecretInput.js";
+import { Tutorial } from "../onboarding/tutorials.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useRef, useState } from "react";
+import { DEFAULT_SECRET_TTL, isSecretName } from "zidane/chat/pure";
+//#region src/session/SecretsPanel.tsx
+/**
+* The Secrets panel body: the saved secrets of a session's project (API keys,
+* tokens), by name, with when each expires and whether this session saved
+* it. Values never come back: a row can be revoked or replaced, and a secret
+* can be added by hand (name, password field, TTL). The list follows the
+* host's change signal (`secrets:changed`); a refused save (the setting is
+* off, a plain-text link from another machine) shows the host's reason.
+*
+* The app offers the tab only while `Settings.secrets` is on
+* (`SECRETS_PANEL_ID`, core's `buildPanelCatalog({ showSecrets })`), and
+* `SecretsAttention` opens it the first time the session saves a secret.
+*/
+/**
+* Renders a session project's saved secrets, with revoke, replace and add.
+*
+* @param props - The `sessionId`, `className` and `style`.
+*/
+function SecretsPanel({ sessionId, className = "", style }) {
+	const labels = useSessionLabels();
+	const entries = useSessionSecrets(sessionId);
+	const host = useSessionHost().secrets;
+	const refresh = host?.refresh;
+	const revoke = host?.revoke;
+	const canSave = Boolean(host?.save);
+	const [error, setError] = useState(null);
+	const [editing, setEditing] = useState(null);
+	useMinuteTick();
+	const empty = entries !== null && entries.length === 0 && editing === null;
+	const addButton = /* @__PURE__ */ jsxs("button", {
+		type: "button",
+		className: BTN_GHOST,
+		onClick: () => setEditing(""),
+		children: [/* @__PURE__ */ jsx("span", {
+			"aria-hidden": true,
+			className: "i-ph-plus"
+		}), labels.secretsAdd]
+	});
+	useEffect(() => {
+		refresh?.(sessionId).catch((err) => setError(err.message));
+	}, [refresh, sessionId]);
+	const onRevoke = revoke ? (name) => {
+		setError(null);
+		revoke(sessionId, name).catch((err) => setError(err.message));
+	} : void 0;
+	return /* @__PURE__ */ jsxs("div", {
+		className: `flex-1 min-h-0 flex flex-col ${className}`,
+		style,
+		"aria-label": labels.secretsLabel,
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex-1 min-h-0 flex flex-col overflow-y-auto px-3 pt-3 pb-3",
+			children: [
+				error && /* @__PURE__ */ jsx("div", {
+					className: "text-xs text-[var(--zg-warn)] mb-2",
+					role: "alert",
+					children: error
+				}),
+				entries === null ? /* @__PURE__ */ jsx(PanelLoading, {}) : empty ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(PanelEmpty, {
+					icon: "i-ph-key",
+					title: labels.secretsEmpty,
+					hint: labels.secretsEmptyHint
+				}), /* @__PURE__ */ jsx(Tutorial, {
+					topic: "secrets",
+					surface: "raised",
+					className: "mt-4",
+					...canSave ? { actions: addButton } : {}
+				})] }) : /* @__PURE__ */ jsxs("div", {
+					className: "flex flex-col gap-2",
+					children: [/* @__PURE__ */ jsx("p", {
+						className: "m-0 text-zg-meta leading-4 text-[var(--zg-text-muted)] zg-pretty",
+						children: labels.secretsNote
+					}), /* @__PURE__ */ jsx("ul", {
+						className: "m-0 p-0 list-none flex flex-col",
+						"aria-label": labels.secretsListLabel,
+						children: entries.map((entry) => /* @__PURE__ */ jsx(SecretRow, {
+							entry,
+							sessionId,
+							onRevoke: onRevoke ? () => onRevoke(entry.name) : void 0,
+							onReplace: canSave ? () => setEditing(entry.name) : void 0
+						}, entry.name))
+					})]
+				}),
+				canSave && editing !== null && /* @__PURE__ */ jsx(AddSecretForm, {
+					sessionId,
+					initialName: editing,
+					saved: entries ?? [],
+					onDone: () => setEditing(null)
+				}, editing)
+			]
+		}), canSave && editing === null && !empty && /* @__PURE__ */ jsx("div", {
+			className: "shrink-0 flex px-3 py-2",
+			children: addButton
+		})]
+	});
+}
+function SecretRow({ entry, sessionId, onRevoke, onReplace }) {
+	const labels = useSessionLabels();
+	const left = secretTimeLeft(entry.expiresAt, Date.now());
+	return /* @__PURE__ */ jsxs("li", {
+		className: `${PANEL_ROW} ${PANEL_ROW_HOVER} items-center`,
+		"data-secret-name": entry.name,
+		children: [
+			/* @__PURE__ */ jsx("span", {
+				"aria-hidden": true,
+				className: "i-ph-key shrink-0 text-[var(--zg-text-muted)]"
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex-1 min-w-0 flex flex-col",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "truncate font-mono text-zg-ui text-[var(--zg-text)]",
+					children: entry.name
+				}), /* @__PURE__ */ jsxs("span", {
+					className: "flex flex-col zg-meta",
+					children: [/* @__PURE__ */ jsx("span", {
+						className: left.kind === "expired" ? "text-[var(--zg-warn)]" : void 0,
+						children: labels.secretExpiry(left)
+					}), entry.sessionId !== void 0 && /* @__PURE__ */ jsx("span", { children: entry.sessionId === sessionId ? labels.secretSavedHere : labels.secretSavedElsewhere })]
+				})]
+			}),
+			onReplace && /* @__PURE__ */ jsx(IconButton, {
+				icon: "i-ph-pencil-simple",
+				label: labels.secretReplace(entry.name),
+				onClick: onReplace
+			}),
+			onRevoke && /* @__PURE__ */ jsx(IconButton, {
+				icon: "i-ph-trash",
+				label: labels.secretRevoke(entry.name),
+				onClick: onRevoke
+			})
+		]
+	});
+}
+function AddSecretForm({ sessionId, initialName, saved, onDone }) {
+	const labels = useSessionLabels();
+	const save = useSessionHost().secrets?.save;
+	const id = useId();
+	const [name, setName] = useState(initialName);
+	const [ttl, setTtl] = useState(DEFAULT_SECRET_TTL);
+	const value = useRef("");
+	const [filled, setFilled] = useState(false);
+	const [busy, setBusy] = useState(false);
+	const [error, setError] = useState(null);
+	const nameOk = isSecretName(name);
+	const replaces = saved.some((entry) => entry.name === name);
+	const submit = async (event) => {
+		event?.preventDefault();
+		if (!save || busy || !nameOk || !filled) return;
+		setBusy(true);
+		setError(null);
+		try {
+			await save(sessionId, {
+				name,
+				value: value.current,
+				ttl
+			});
+			value.current = "";
+			onDone();
+		} catch (err) {
+			setError(err instanceof Error ? err.message : String(err));
+			setBusy(false);
+		}
+	};
+	return /* @__PURE__ */ jsxs("form", {
+		className: "zg-raised border mt-3 flex flex-col gap-2 rounded-zg-xl px-3 py-2.5",
+		onSubmit: (e) => void submit(e),
+		children: [
+			/* @__PURE__ */ jsx("label", {
+				htmlFor: `${id}-name`,
+				className: "text-zg-label font-medium text-[var(--zg-text-muted)]",
+				children: labels.secretNameLabel
+			}),
+			/* @__PURE__ */ jsx("input", {
+				id: `${id}-name`,
+				value: name,
+				onChange: (e) => setName(e.target.value.toUpperCase()),
+				placeholder: labels.secretNamePlaceholder,
+				autoComplete: "off",
+				spellCheck: false,
+				"aria-invalid": name !== "" && !nameOk ? true : void 0,
+				"aria-describedby": `${id}-name-hint`,
+				className: `${INPUT} h-8 font-mono`
+			}),
+			/* @__PURE__ */ jsx("span", {
+				id: `${id}-name-hint`,
+				className: "text-zg-meta leading-4 text-[var(--zg-text-muted)]",
+				children: name !== "" && !nameOk ? labels.secretNameInvalid : replaces ? labels.secretReplacesSaved(name) : null
+			}),
+			/* @__PURE__ */ jsx("label", {
+				htmlFor: `${id}-value`,
+				className: "text-zg-label font-medium text-[var(--zg-text-muted)]",
+				children: labels.secretValueLabel
+			}),
+			/* @__PURE__ */ jsx(SecretInput, {
+				id: `${id}-value`,
+				ttl,
+				required: true,
+				onChange: (typed, picked) => {
+					value.current = typed;
+					setFilled(typed.trim() !== "");
+					setTtl(picked);
+				},
+				onSubmit: () => void submit()
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-2 pt-1",
+				children: [
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: BTN_GHOST,
+						onClick: onDone,
+						disabled: busy,
+						children: labels.secretCancel
+					}),
+					/* @__PURE__ */ jsx(CardError, { error }),
+					/* @__PURE__ */ jsx("span", { className: "flex-1" }),
+					/* @__PURE__ */ jsx("button", {
+						type: "submit",
+						className: BTN_PRIMARY,
+						disabled: busy || !nameOk || !filled,
+						children: labels.secretSave
+					})
+				]
+			})
+		]
+	});
+}
+//#endregion
+export { SecretsPanel };

package/dist/session/SessionProvider.d.ts

@@ -1,10 +1,10 @@
-import { QueuedMessage, RunningWorkItem, SessionArtifactGroup, SessionHost, TodosSnapshot } from "./headless/host.js";
+import { PlansSnapshot, QueuedMessage, RunningWorkItem, Schedule, SchedulesStatus, SessionArtifactGroup, SessionHost, SessionSecretEntry } from "./headless/host.js";
 import { SessionLabels } from "./headless/labels.js";
 import { ReactNode } from "react";
 //#region src/session/SessionProvider.d.ts
 /** Props for {@link SessionProvider}. */
 interface SessionProviderProps {
-  /** The host the session panels below read todos, queues and artifacts from. */
+  /** The host the session panels below read plans, queues and artifacts from. */
   host: SessionHost;
   /** Overrides for the built-in strings. Keys you leave out keep the default English label. */
   labels?: Partial<SessionLabels>;
@@ -20,12 +20,33 @@ declare function SessionProvider({ host, labels, children }: SessionProviderProp
 /** Returns the {@link SessionHost} from the nearest {@link SessionProvider}. Throws when called outside one. */
 declare function useSessionHost(): SessionHost;
 /**
- * A session's todo snapshot (`null` until read, or without a session or a `todos` host). Re-renders only when that
+ * Whether reminders are on (`null` until read, or without a `schedules` host). The first read asks the host. Nothing
+ * about reminders shows unless this is `enabled`.
+ */
+declare function useSchedulesStatus(): SchedulesStatus | null;
+/**
+ * The reminders whose prompt goes to a session (`null` until read, while off, or without a session or a
+ * `schedules` host). Re-renders only when that session's reminders change.
+ *
+ * @param sessionId - The session, or nothing.
+ */
+declare function useSessionSchedules(sessionId: string | null | undefined): readonly Schedule[] | null;
+/** Every reminder of the host (`null` until read, while off, or without a `schedules` host). */
+declare function useAllSchedules(): readonly Schedule[] | null;
+/**
+ * A session project's saved secrets, by name (`null` until read, or without a session or a `secrets` host).
+ * Re-renders only when that session's list changes.
+ *
+ * @param sessionId - The session, or nothing.
+ */
+declare function useSessionSecrets(sessionId: string | null | undefined): readonly SessionSecretEntry[] | null;
+/**
+ * A session's plans snapshot (`null` until read, or without a session or a `plans` host). Re-renders only when that
  * session's snapshot changes.
  *
  * @param sessionId - The session, or nothing.
  */
-declare function useSessionTodos(sessionId: string | null | undefined): TodosSnapshot | null;
+declare function useSessionPlans(sessionId: string | null | undefined): PlansSnapshot | null;
 /**
  * A session's queued messages, in delivery order (empty without a session or a `queue` host). Re-renders only when
  * that session's queue changes.
@@ -48,4 +69,4 @@ declare function useSessionArtifacts(sessionId: string | null | undefined): read
  */
 declare function useSessionRunningWork(sessionId: string | null | undefined): readonly RunningWorkItem[];
 //#endregion
-export { SessionProvider, SessionProviderProps, useSessionArtifacts, useSessionHost, useSessionQueue, useSessionRunningWork, useSessionTodos };
+export { SessionProvider, SessionProviderProps, useAllSchedules, useSchedulesStatus, useSessionArtifacts, useSessionHost, useSessionPlans, useSessionQueue, useSessionRunningWork, useSessionSchedules, useSessionSecrets };

package/dist/session/SessionProvider.js

@@ -32,19 +32,64 @@ function useSessionHost() {
 	if (!host) throw new Error("zidane-ui/session: wrap the session panels in <SessionProvider host={…}>");
 	return host;
 }
-const NO_TODOS = constant(null);
+const NO_PLANS = constant(null);
 const NO_QUEUE = constant([]);
 const NO_ARTIFACTS = constant(null);
 const NO_WORK = constant([]);
+const NO_SECRETS = constant(null);
+const NO_SCHEDULES = constant(null);
+const NO_SCHEDULES_STATUS = constant(null);
 /**
-* A session's todo snapshot (`null` until read, or without a session or a `todos` host). Re-renders only when that
+* Whether reminders are on (`null` until read, or without a `schedules` host). The first read asks the host. Nothing
+* about reminders shows unless this is `enabled`.
+*/
+function useSchedulesStatus() {
+	const schedules = useSessionHost().schedules;
+	useEffect(() => {
+		schedules?.ensure();
+	}, [schedules]);
+	return useReadable(schedules ? schedules.status : NO_SCHEDULES_STATUS);
+}
+/**
+* The reminders whose prompt goes to a session (`null` until read, while off, or without a session or a
+* `schedules` host). Re-renders only when that session's reminders change.
+*
+* @param sessionId - The session, or nothing.
+*/
+function useSessionSchedules(sessionId) {
+	const schedules = useSessionHost().schedules;
+	useEffect(() => {
+		if (sessionId) schedules?.ensure();
+	}, [schedules, sessionId]);
+	return useReadable(sessionId && schedules ? schedules.forSession(sessionId) : NO_SCHEDULES);
+}
+/** Every reminder of the host (`null` until read, while off, or without a `schedules` host). */
+function useAllSchedules() {
+	const schedules = useSessionHost().schedules;
+	useEffect(() => {
+		schedules?.ensure();
+	}, [schedules]);
+	return useReadable(schedules ? schedules.all : NO_SCHEDULES);
+}
+/**
+* A session project's saved secrets, by name (`null` until read, or without a session or a `secrets` host).
+* Re-renders only when that session's list changes.
+*
+* @param sessionId - The session, or nothing.
+*/
+function useSessionSecrets(sessionId) {
+	const secrets = useSessionHost().secrets;
+	return useReadable(sessionId && secrets ? secrets.entries(sessionId) : NO_SECRETS);
+}
+/**
+* A session's plans snapshot (`null` until read, or without a session or a `plans` host). Re-renders only when that
 * session's snapshot changes.
 *
 * @param sessionId - The session, or nothing.
 */
-function useSessionTodos(sessionId) {
-	const todos = useSessionHost().todos;
-	return useReadable(sessionId && todos ? todos.snapshot(sessionId) : NO_TODOS);
+function useSessionPlans(sessionId) {
+	const plans = useSessionHost().plans;
+	return useReadable(sessionId && plans ? plans.snapshot(sessionId) : NO_PLANS);
 }
 /**
 * A session's queued messages, in delivery order (empty without a session or a `queue` host). Re-renders only when
@@ -80,4 +125,4 @@ function useSessionRunningWork(sessionId) {
 	return useReadable(sessionId && work ? work.items(sessionId) : NO_WORK);
 }
 //#endregion
-export { SessionProvider, useSessionArtifacts, useSessionHost, useSessionQueue, useSessionRunningWork, useSessionTodos };
+export { SessionProvider, useAllSchedules, useSchedulesStatus, useSessionArtifacts, useSessionHost, useSessionPlans, useSessionQueue, useSessionRunningWork, useSessionSchedules, useSessionSecrets };

package/dist/session/StepStatusIcon.d.ts

@@ -0,0 +1,24 @@
+import { CSSProperties } from "react";
+import { TodoStatus } from "zidane/chat";
+//#region src/session/StepStatusIcon.d.ts
+/** What a {@link StepStatusIcon} shows: a todo status, or `stopped` for the step a stopped plan halted at. */
+type StepIconState = TodoStatus | 'stopped';
+/** Props for {@link StepStatusIcon}. */
+interface StepStatusIconProps {
+  /** The status to show. */
+  state: StepIconState;
+  /** Accessible name and tooltip. */
+  label: string;
+  /** Extra classes on the root element, such as a text size. */
+  className?: string;
+  /** Inline styles on the root element, merged after the component's own. */
+  style?: CSSProperties;
+}
+/**
+ * Renders a step's status as an icon that cross-fades and pops between states.
+ *
+ * @param props - The {@link StepStatusIconProps}.
+ */
+declare function StepStatusIcon({ state, label, className, style }: StepStatusIconProps): import("react").JSX.Element;
+//#endregion
+export { StepIconState, StepStatusIcon, StepStatusIconProps };

package/dist/session/StepStatusIcon.js

@@ -0,0 +1,50 @@
+import { jsx } from "react/jsx-runtime";
+import { useState } from "react";
+//#region src/session/StepStatusIcon.tsx
+/**
+* A plan step's or todo's status as an icon: an empty circle while pending,
+* the kit's spin ring while in progress, a check when done, a cross when
+* cancelled, a warning on the step a stopped plan halted at. The glyphs
+* stack in one box and cross-fade (`.zg-swap`); a status that changes while
+* shown pops its glyph in (`zg-pop` on `snap`, `.zg-step-icon-layer`
+* in styles/motion.css). The first render never pops, so opening a finished
+* plan reads still.
+*/
+const GLYPHS = {
+	pending: "i-ph-circle text-[var(--zg-text-subtle)]",
+	in_progress: "zg-spin-ring zg-loop text-[var(--zg-accent)]",
+	completed: "i-ph-check-circle-fill text-zg-success",
+	cancelled: "i-ph-x-circle text-[var(--zg-text-muted)]",
+	stopped: "i-ph-warning-circle-fill text-[var(--zg-warn)]"
+};
+const STATES = Object.keys(GLYPHS);
+/**
+* Renders a step's status as an icon that cross-fades and pops between states.
+*
+* @param props - The {@link StepStatusIconProps}.
+*/
+function StepStatusIcon({ state, label, className, style }) {
+	const [shown, setShown] = useState(state);
+	const [moved, setMoved] = useState(false);
+	if (shown !== state) {
+		setShown(state);
+		setMoved(true);
+	}
+	return /* @__PURE__ */ jsx("span", {
+		role: "img",
+		"aria-label": label,
+		title: label,
+		"data-state": state,
+		className: ["zg-swap shrink-0", className].filter(Boolean).join(" "),
+		style,
+		children: STATES.map((k) => /* @__PURE__ */ jsx("span", {
+			"aria-hidden": true,
+			className: "zg-step-icon-layer",
+			"data-on": k === state ? "" : void 0,
+			"data-landed": moved && k === state ? "" : void 0,
+			children: /* @__PURE__ */ jsx("span", { className: GLYPHS[k] })
+		}, k))
+	});
+}
+//#endregion
+export { StepStatusIcon };

package/dist/session/TodoList.d.ts

@@ -1,5 +1,6 @@
+import { TodoTallyCounts } from "./headless/plans.js";
 import { CSSProperties } from "react";
-import { TodoStatus, TodoTally as TodoTally$1 } from "zidane/chat";
+import { TodoStatus } from "zidane/chat";
 //#region src/session/TodoList.d.ts
 /** A flat todo row: no box of its own, the hover wash only. */
 declare const TODO_ROW_CLASS = "flex items-center gap-2.5 px-2 py-1 rounded-zg-md";
@@ -41,8 +42,8 @@ interface TodoListViewProps {
 declare function TodoListView({ items, className, style }: TodoListViewProps): import("react").JSX.Element;
 /** Props for {@link TodoTally}. */
 interface TodoTallyProps {
-  /** Items per status. */
-  tally: TodoTally$1;
+  /** Items per status (`planTally` of a plan). */
+  tally: TodoTallyCounts;
   /** Extra classes on the root element. */
   className?: string;
   /** Inline styles on the root element, merged after the component's own. */

package/dist/session/TodoList.js

@@ -1,7 +1,7 @@
 import { MetaChip } from "../components/Form.js";
 import { useSessionLabels } from "./useSessionLabels.js";
+import { StepStatusIcon } from "./StepStatusIcon.js";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { TODO_STATUS_GLYPHS } from "zidane/chat/pure";
 //#region src/session/TodoList.tsx
 /** A flat todo row: no box of its own, the hover wash only. */
 const TODO_ROW_CLASS = "flex items-center gap-2.5 px-2 py-1 rounded-zg-md";
@@ -27,16 +27,17 @@ function isDoneTodo(status) {
 * @param props - The {@link TodoListViewProps}.
 */
 function TodoListView({ items, className, style }) {
+	const labels = useSessionLabels();
 	return /* @__PURE__ */ jsx("ul", {
 		className: ["flex flex-col gap-px m-0 p-0 list-none", className].filter(Boolean).join(" "),
 		style,
 		children: items.map((todo) => /* @__PURE__ */ jsxs("li", {
 			"data-status": todo.status,
 			className: TODO_ROW_CLASS,
-			children: [/* @__PURE__ */ jsx("span", {
-				className: `text-zg-ui leading-6 w-4 shrink-0 ${todoGlyphTone(todo.status)}`,
-				title: todo.status,
-				children: TODO_STATUS_GLYPHS[todo.status]
+			children: [/* @__PURE__ */ jsx(StepStatusIcon, {
+				state: todo.status,
+				label: labels.todoStatus(todo.status),
+				className: "text-zg-ui"
 			}), /* @__PURE__ */ jsx("span", {
 				className: `flex-1 min-w-0 text-zg-ui leading-6 truncate ${isDoneTodo(todo.status) ? "text-[var(--zg-text-muted)] line-through" : "text-[var(--zg-text)]"}`,
 				title: todo.content,

package/dist/session/headless/fixture-host.d.ts

@@ -1,6 +1,7 @@
-import { ProviderUsageSnapshot, UsageRange, UsageSummary } from "./usage.js";
-import { PromptAttachment as PromptAttachment$1, RunningWorkItem, SessionArtifactRow, SessionHost, SessionTurn, TodosSnapshot as TodosSnapshot$1 } from "./host.js";
-import { TodoItem, TodoTally } from "zidane/chat";
+import { ProviderUsageSnapshot as ProviderUsageSnapshot$1, UsageRange, UsageSummary } from "./usage.js";
+import { PromptAttachment as PromptAttachment$1, RunningWorkItem, SessionArtifactRow, SessionHost, SessionSecretEntry, SessionTurn } from "./host.js";
+import { Schedule, ScheduleFire } from "zidane/chat/pure";
+import { PlanView, TodoItem } from "zidane/chat";
 //#region src/session/headless/fixture-host.d.ts
 /** A queued entry the fixture holds, with its attachments' bytes. */
 interface FixtureQueuedEntry {
@@ -13,7 +14,9 @@ interface FixtureQueuedEntry {
 }
 /** What a fixture session host starts with, per session id. */
 interface SessionFixture {
-  /** The todo list per session. */
+  /** The plans per session, oldest first (`possiblyInterrupted` shows an applying plan with no live run). */
+  plans?: Readonly<Record<string, readonly PlanView[]>>;
+  /** The task list per session as the agent wrote it (`todowrite`), over `plans`: an applying plan. */
   todos?: Readonly<Record<string, readonly TodoItem[]>>;
   /** The queued messages per session. */
   queue?: Readonly<Record<string, readonly FixtureQueuedEntry[]>>;
@@ -28,41 +31,48 @@ interface SessionFixture {
   /** The usage summary per range. Absent: no `usage.summary`. */
   usage?: Partial<Record<UsageRange, UsageSummary>>;
   /** The providers' subscription snapshots. Absent: no `usage.providers`. */
-  providerUsage?: readonly ProviderUsageSnapshot[];
+  providerUsage?: readonly ProviderUsageSnapshot$1[];
   /** GitHub's API limits. Absent: no `usage.github`. */
-  githubUsage?: readonly ProviderUsageSnapshot[];
+  githubUsage?: readonly ProviderUsageSnapshot$1[];
   /** Each session's side chat id, by the parent's id. Absent: no `side`. */
   sides?: Readonly<Record<string, string>>;
+  /** The saved secrets per session (as the session's project holds them). Absent: no `secrets`. */
+  secrets?: Readonly<Record<string, readonly SessionSecretEntry[]>>;
+  /** `secrets.save` rejects with this message (a plain-text remote link refusing values). */
+  secretsSaveError?: string;
+  /** The stored reminders (zidane's schedules), oldest first. Absent: no `schedules`. */
+  schedules?: readonly Schedule[];
+  /** Each reminder's fires, newest first, by schedule id. */
+  scheduleFires?: Readonly<Record<string, readonly ScheduleFire[]>>;
+  /** `Settings.schedules`. @default true */
+  schedulesEnabled?: boolean;
 }
 /** Changes a fixture's data from outside and announces it, as the agent or another window would. */
 interface FixtureSessionControl {
-  /** Replaces a session's todo list. */
-  setTodos(sessionId: string, items: readonly TodoItem[]): void;
+  /** The agent's `todowrite`: updates the applying plan, starts one, or resumes a stopped one with the same step ids. */
+  writeTodos(sessionId: string, items: readonly TodoItem[]): void;
+  /** The session's run ended: the plan it applied stops. */
+  endRun(sessionId: string, outcome?: 'completed' | 'aborted' | 'error'): void;
+  /** Replaces a session's plans. */
+  setPlans(sessionId: string, plans: readonly PlanView[]): void;
   /** Replaces a session's queue. */
   setQueue(sessionId: string, entries: readonly FixtureQueuedEntry[]): void;
   /** Records an artifact (newest first). */
   recordArtifact(sessionId: string, row: SessionArtifactRow): void;
   /** Replaces a session's running work. */
   setWork(sessionId: string, items: readonly RunningWorkItem[]): void;
+  /** Replaces a session's saved secrets (the agent saved one, another window revoked one). */
+  setSecrets(sessionId: string, entries: readonly SessionSecretEntry[]): void;
+  /** Replaces the stored reminders (the agent set one, one fired) and announces the change. */
+  setSchedules(list: readonly Schedule[]): void;
+  /** Turns the Reminders setting on or off and announces it. */
+  setSchedulesEnabled(enabled: boolean): void;
 }
 /** The fixture host: a full `SessionHost` plus its `control`. */
 interface FixtureSessionHost extends SessionHost {
   /** Changes the data from outside. */
   control: FixtureSessionControl;
 }
-/**
- * Counts todo items by status.
- *
- * @param items - The todo list.
- */
-declare function tallyTodos(items: readonly TodoItem[]): TodoTally;
-/**
- * A todo snapshot of a list, as a backend broadcasts it.
- *
- * @param items - The live list.
- * @param archive - The last non-empty list (shown read-only when the live one is empty).
- */
-declare function todosSnapshotOf(items: readonly TodoItem[], archive?: readonly TodoItem[]): TodosSnapshot$1;
 /**
  * Creates a {@link FixtureSessionHost} over the fixture's data.
  *
@@ -70,4 +80,4 @@ declare function todosSnapshotOf(items: readonly TodoItem[], archive?: readonly
  */
 declare function createFixtureSessionHost(fixture?: SessionFixture): FixtureSessionHost;
 //#endregion
-export { FixtureQueuedEntry, FixtureSessionControl, FixtureSessionHost, SessionFixture, createFixtureSessionHost, tallyTodos, todosSnapshotOf };
+export { FixtureQueuedEntry, FixtureSessionControl, FixtureSessionHost, SessionFixture, createFixtureSessionHost };