zidane-ui 9.1.4 → 9.1.6

package/dist/session/testing/contract.js

@@ -1,3 +1,4 @@
+import { displayedPlan } from "../headless/plans.js";
 import { createSessionActions } from "../headless/session-actions.js";
 import { afterEach, describe, expect, it, vi } from "vitest";
 //#region src/session/testing/contract.ts
@@ -6,29 +7,34 @@ import { afterEach, describe, expect, it, vi } from "vitest";
 * (`createFixtureSessionHost`), zidane-server (`createServerSessionHost`), the desktop app's IPC host.
 *
 * An implementation's test calls {@link describeSessionHostContract} with a harness factory. The
-* contract hands it a {@link SessionHostContractBackend}: the todo lists, queues and artifacts the
+* contract hands it a {@link SessionHostContractBackend}: the plans, queues and artifacts the
 * backend holds. The harness builds the host over a backend that holds them and behaves as below, and
 * returns a {@link SessionHostContractControl} that changes the backend from outside (the agent wrote
 * its todos, another window queued a message, an artifact landed). The capabilities list says which
 * optional members the host offers: the suite checks the others are left out (undefined, never a
 * throwing stub) and skips the behaviours that need them.
 *
-* The backend: `todos.set` replaces the list and announces the new snapshot; every session is mid-run,
+* The backend: plans change through zidane's plan gate (`applyPlanEvent`; `createFixturePlansBackend` is one):
+* `plans.edit` and `plans.control` apply the user's change, answer the snapshot and announce it, and reject
+* with the gate's reason; every session is mid-run,
 * so a message added to the queue waits there (delivered `queued`); removing, editing or pushing an
 * entry announces the queue; pushing an entry that is gone answers `missing`; removing an artifact
 * announces the change; cancelling work removes it (`all`: every item) and announces the session's work;
 * a fork answers a new session id; editing a turn's text replaces its text blocks; deleting a turn removes
 * it; generating a title answers a non-empty title, an export a path; the usage summary of a range covers
-* that range. The session actions over the host (`createSessionActions`) offer what it offers and run.
+* that range; saving a secret stores its entry (name, expiry, the saving session; never the value) and
+* announces a change, revoking one removes it and announces a change; the reminders are served as
+* `createFixtureScheduleBackend` does (the setting on, a create validated, a pause clears the next time). The session actions over the host (`createSessionActions`) offer what it offers and run.
 *
 *   describeSessionHostContract('createFixtureSessionHost', (backend) => ({ host, control }), [
-*     'todos', 'todos.set', 'queue', 'queue.add', 'artifacts',
+*     'plans', 'plans.edit', 'plans.control', 'queue', 'queue.add', 'artifacts',
 *   ]);
 */
 const CAPABILITIES = [
-	"todos",
-	"todos.set",
-	"todos.retry",
+	"plans",
+	"plans.edit",
+	"plans.control",
+	"plans.retry",
 	"queue",
 	"queue.add",
 	"queue.remove",
@@ -58,7 +64,16 @@ const CAPABILITIES = [
 	"usage.github",
 	"usage.redeemReset",
 	"side",
-	"side.subscribe"
+	"side.subscribe",
+	"secrets",
+	"secrets.save",
+	"secrets.revoke",
+	"schedules",
+	"schedules.create",
+	"schedules.update",
+	"schedules.remove",
+	"schedules.runNow",
+	"schedules.fires"
 ];
 const artifact = (id, kind, label) => ({
 	id,
@@ -129,9 +144,81 @@ function contractBackend() {
 			}],
 			createdAt: 2
 		}] },
-		sides: { "s-1": "side-1" }
+		sides: { "s-1": "side-1" },
+		secrets: { "s-1": [{
+			name: "GITHUB_TOKEN",
+			createdAt: 1,
+			expiresAt: null,
+			sessionId: "s-1"
+		}, {
+			name: "API_KEY",
+			createdAt: 2,
+			expiresAt: 41024448e5,
+			sessionId: "s-2"
+		}] },
+		schedules: [
+			schedule("sch-1", {
+				kind: "at",
+				at: FAR
+			}, {
+				kind: "prompt",
+				sessionId: "s-1",
+				text: "Check the CI"
+			}, { kind: "user" }),
+			{
+				...schedule("sch-2", {
+					kind: "every",
+					everyMs: 36e5,
+					anchor: 1
+				}, {
+					kind: "prompt",
+					sessionId: "s-1",
+					text: "Look at the queue"
+				}, {
+					kind: "agent",
+					sessionId: "s-1"
+				}),
+				expiresAt: FAR + 6e4
+			},
+			schedule("sch-3", {
+				kind: "at",
+				at: FAR
+			}, {
+				kind: "prompt",
+				sessionId: "s-2",
+				text: "Ship it"
+			}, { kind: "user" })
+		],
+		scheduleFires: { "sch-2": [{
+			id: "f2",
+			scheduleId: "sch-2",
+			dueAt: 20,
+			firedAt: 20,
+			outcome: "queued",
+			sessionId: "s-1"
+		}, {
+			id: "f1",
+			scheduleId: "sch-2",
+			dueAt: 10,
+			firedAt: 11,
+			outcome: "sent",
+			sessionId: "s-1"
+		}] }
 	};
 }
+/** A time far ahead (2100), so a reminder never fires during a test. */
+const FAR = 41024448e5;
+const schedule = (id, trigger, action, createdBy) => ({
+	id,
+	trigger,
+	action,
+	catchUp: trigger.kind === "at" ? "once" : "skip",
+	enabled: true,
+	createdBy,
+	createdAt: 1,
+	updatedAt: 1,
+	nextFireAt: FAR
+});
 function member(host, capability) {
 	const [head, tail] = capability.split(".");
 	const value = host[head];
@@ -175,7 +262,7 @@ function describeSessionHostContract(name, makeHarness, capabilities) {
 				}
 				expect(typeof value, capability).toBe(capability.includes(".") ? "function" : "object");
 			}
-			if (has("todos")) expect(typeof host.todos?.snapshot).toBe("function");
+			if (has("plans")) expect(typeof host.plans?.snapshot).toBe("function");
 			if (has("queue")) expect(typeof host.queue?.items).toBe("function");
 			if (has("artifacts")) expect(typeof host.artifacts?.groups).toBe("function");
 			if (has("runningWork")) {
@@ -203,51 +290,113 @@ function describeSessionHostContract(name, makeHarness, capabilities) {
 			if (actions.fork) expect(await actions.fork("s-1", "u1")).not.toBe("s-1");
 			expect(onError).not.toHaveBeenCalled();
 		});
-		describe.skipIf(!has("todos"))("todos", () => {
-			it("reads a session list and hears the backend replace it", async () => {
+		describe.skipIf(!has("plans"))("plans", () => {
+			const shown = (host) => {
+				const snap = host.plans.snapshot("s-1").get();
+				return snap ? displayedPlan(snap.plans) : null;
+			};
+			const titles = (host) => shown(host)?.steps.map((s) => s.title);
+			it("reads a session plan and hears the agent write it again", async () => {
 				const { host, control } = await setup();
-				const snap = watch(host.todos.snapshot("s-1"));
-				expect(host.todos.snapshot("s-1")).toBe(snap);
-				await host.todos.refresh("s-1");
-				expect(snap.get()?.todos.map((t) => t.content)).toEqual([
+				const snap = watch(host.plans.snapshot("s-1"));
+				expect(host.plans.snapshot("s-1")).toBe(snap);
+				await host.plans.refresh("s-1");
+				expect(titles(host)).toEqual([
 					"First",
 					"Second",
 					"Third"
 				]);
-				expect(snap.get()?.tally).toEqual({
-					pending: 1,
-					in_progress: 1,
-					completed: 1,
-					cancelled: 0
+				expect(shown(host)?.state).toBe("applying");
+				expect(snap.get()?.active).toMatchObject({
+					state: "applying",
+					progress: {
+						completed: 1,
+						total: 3
+					}
 				});
-				control.setTodos("s-1", [{
-					id: "n",
-					content: "Only",
-					status: "pending"
-				}]);
-				await waitFor(() => expect(snap.get()?.todos.map((t) => t.content)).toEqual(["Only"]));
+				control.writeTodos("s-1", [
+					{
+						id: "t1",
+						content: "First",
+						status: "completed"
+					},
+					{
+						id: "t2",
+						content: "Second",
+						status: "completed"
+					},
+					{
+						id: "t3",
+						content: "Third",
+						status: "in_progress"
+					}
+				]);
+				await waitFor(() => expect(snap.get()?.active?.progress.completed).toBe(2));
 			});
-			it("reads null for a session without a list, and never rejects", async () => {
+			it("reads null for a session without plans, and never rejects", async () => {
 				const { host } = await setup();
-				await expect(host.todos.refresh("s-none")).resolves.toBeUndefined();
-				expect(host.todos.snapshot("s-none").get()).toBeNull();
+				await expect(host.plans.refresh("s-none")).resolves.toBeUndefined();
+				expect(host.plans.snapshot("s-none").get()).toBeNull();
 			});
-			it.skipIf(!has("todos.set"))("set replaces the list and the snapshot follows", async () => {
+			it.skipIf(!has("plans.edit"))("edit adds, renames and cancels a step; the snapshot follows", async () => {
 				const { host } = await setup();
-				const snap = watch(host.todos.snapshot("s-1"));
-				await host.todos.refresh("s-1");
-				const applied = await host.todos.set("s-1", [{
-					id: "x",
-					content: "Edited",
-					status: "completed"
-				}]);
-				expect(applied).toBe(true);
-				await waitFor(() => expect(snap.get()?.todos.map((t) => t.content)).toEqual(["Edited"]));
-				expect(snap.get()?.tally.completed).toBe(1);
+				watch(host.plans.snapshot("s-1"));
+				await host.plans.refresh("s-1");
+				const planId = shown(host).id;
+				await host.plans.edit("s-1", planId, {
+					kind: "add",
+					title: "Fourth"
+				});
+				await waitFor(() => expect(titles(host)).toEqual([
+					"First",
+					"Second",
+					"Third",
+					"Fourth"
+				]));
+				expect(shown(host)?.steps[3]).toMatchObject({
+					status: "pending",
+					added: true
+				});
+				await host.plans.edit("s-1", planId, {
+					kind: "rename",
+					stepId: "t3",
+					title: "Third, renamed"
+				});
+				await waitFor(() => expect(titles(host)?.[2]).toBe("Third, renamed"));
+				await host.plans.edit("s-1", planId, {
+					kind: "cancel",
+					stepId: "t2"
+				});
+				await waitFor(() => expect(shown(host)?.steps[1]).toMatchObject({
+					status: "cancelled",
+					cancelledBy: "user"
+				}));
+			});
+			it.skipIf(!has("plans.edit"))("edit rejects with the backend's reason", async () => {
+				const { host } = await setup();
+				await host.plans.refresh("s-1");
+				await expect(host.plans.edit("s-1", shown(host).id, {
+					kind: "cancel",
+					stepId: "t1"
+				})).rejects.toThrow(/already completed/);
 			});
-			it.skipIf(!has("todos.retry"))("retry resolves", async () => {
+			it.skipIf(!has("plans.control"))("control stops, then drops the plan; the snapshot follows", async () => {
 				const { host } = await setup();
-				await expect(host.todos.retry("s-1", "Retry: Second")).resolves.toBeUndefined();
+				watch(host.plans.snapshot("s-1"));
+				await host.plans.refresh("s-1");
+				const planId = shown(host).id;
+				await host.plans.control("s-1", planId, "stop");
+				await waitFor(() => expect(shown(host)).toMatchObject({
+					state: "stopped",
+					stopReason: "user"
+				}));
+				await host.plans.control("s-1", planId, "drop");
+				await waitFor(() => expect(shown(host)?.state).toBe("dropped"));
+				await expect(host.plans.control("s-1", planId, "stop")).rejects.toThrow();
+			});
+			it.skipIf(!has("plans.retry"))("retry resolves", async () => {
+				const { host } = await setup();
+				await expect(host.plans.retry("s-1", "Retry step t2")).resolves.toBeUndefined();
 			});
 		});
 		describe.skipIf(!has("queue"))("queue", () => {
@@ -363,6 +512,165 @@ function describeSessionHostContract(name, makeHarness, capabilities) {
 				await expect(host.artifacts.refreshRow("s-1", row.artifact, { force: true })).resolves.toBeUndefined();
 			});
 		});
+		describe.skipIf(!has("secrets"))("secrets", () => {
+			const names = (host, sessionId = "s-1") => host.secrets.entries(sessionId).get()?.map((e) => e.name) ?? null;
+			it("reads the session secrets by name, never a value, and hears a change", async () => {
+				const { host, control } = await setup();
+				const entries = watch(host.secrets.entries("s-1"));
+				expect(entries.get()).toBeNull();
+				await host.secrets.refresh("s-1");
+				expect(names(host)).toEqual(["API_KEY", "GITHUB_TOKEN"]);
+				for (const entry of entries.get()) expect(entry).not.toHaveProperty("value");
+				control.setSecrets("s-1", [{
+					name: "NPM_TOKEN",
+					createdAt: 3,
+					expiresAt: null,
+					sessionId: "s-1"
+				}]);
+				await waitFor(() => expect(names(host)).toEqual(["NPM_TOKEN"]));
+			});
+			it("reads an empty list for a session without secrets", async () => {
+				const { host } = await setup();
+				await host.secrets.refresh("s-none");
+				expect(host.secrets.entries("s-none").get()).toEqual([]);
+			});
+			it.skipIf(!has("secrets.save"))("save stores a secret for the session and the list follows", async () => {
+				const { host } = await setup();
+				watch(host.secrets.entries("s-1"));
+				await host.secrets.refresh("s-1");
+				const entry = await host.secrets.save("s-1", {
+					name: "NEW_TOKEN",
+					value: "hunter2",
+					ttl: "never"
+				});
+				expect(entry).toMatchObject({
+					name: "NEW_TOKEN",
+					expiresAt: null
+				});
+				expect(JSON.stringify(entry)).not.toContain("hunter2");
+				await waitFor(() => expect(names(host)).toContain("NEW_TOKEN"));
+				expect(JSON.stringify(host.secrets.entries("s-1").get())).not.toContain("hunter2");
+			});
+			it.skipIf(!has("secrets.revoke"))("revoke removes a secret and the list follows", async () => {
+				const { host } = await setup();
+				watch(host.secrets.entries("s-1"));
+				await host.secrets.refresh("s-1");
+				expect(await host.secrets.revoke("s-1", "API_KEY")).toBe(true);
+				await waitFor(() => expect(names(host)).toEqual(["GITHUB_TOKEN"]));
+				expect(await host.secrets.revoke("s-1", "API_KEY")).toBe(false);
+			});
+		});
+		describe.skipIf(!has("schedules"))("schedules", () => {
+			const ids = (list) => list?.map((s) => s.id) ?? null;
+			it("reads the status and every schedule, and cuts a session view", async () => {
+				const { host } = await setup();
+				const schedules = host.schedules;
+				const all = watch(schedules.all);
+				const mine = watch(schedules.forSession("s-1"));
+				expect(schedules.forSession("s-1")).toBe(mine);
+				await schedules.refresh();
+				expect(schedules.status.get()).toEqual({
+					enabled: true,
+					supported: true
+				});
+				expect(ids(all.get())).toEqual([
+					"sch-1",
+					"sch-2",
+					"sch-3"
+				]);
+				expect(ids(mine.get())).toEqual(["sch-1", "sch-2"]);
+				expect(ids(schedules.forSession("s-none").get())).toEqual([]);
+			});
+			it("hears the backend change the list", async () => {
+				const { host, control } = await setup();
+				if (!control.setSchedules) return;
+				const all = watch(host.schedules.all);
+				await host.schedules.refresh();
+				control.setSchedules([contractBackend().schedules[2]]);
+				await waitFor(() => expect(ids(all.get())).toEqual(["sch-3"]));
+			});
+			it.skipIf(!has("schedules.create"))("create stores an exact trigger and the session view follows", async () => {
+				const { host } = await setup();
+				const mine = watch(host.schedules.forSession("s-1"));
+				await host.schedules.refresh();
+				const at = Date.now() + 36e5;
+				const created = await host.schedules.create({
+					trigger: {
+						kind: "at",
+						at
+					},
+					action: {
+						kind: "prompt",
+						sessionId: "s-1",
+						text: "Run the tests"
+					}
+				});
+				expect(created).toMatchObject({
+					enabled: true,
+					nextFireAt: at,
+					createdBy: { kind: "user" }
+				});
+				await waitFor(() => expect(ids(mine.get())).toContain(created.id));
+			});
+			it.skipIf(!has("schedules.create"))("create rejects a time in the past", async () => {
+				const { host } = await setup();
+				await expect(host.schedules.create({
+					trigger: {
+						kind: "at",
+						at: 1e3
+					},
+					action: {
+						kind: "prompt",
+						sessionId: "s-1",
+						text: "Too late"
+					}
+				})).rejects.toThrow();
+			});
+			it.skipIf(!has("schedules.update"))("update pauses, resumes and keeps an agent repeat for good", async () => {
+				const { host } = await setup();
+				const all = watch(host.schedules.all);
+				await host.schedules.refresh();
+				const paused = await host.schedules.update("sch-2", { enabled: false });
+				expect(paused).toMatchObject({
+					id: "sch-2",
+					enabled: false,
+					nextFireAt: null
+				});
+				await waitFor(() => expect(all.get()?.find((s) => s.id === "sch-2")?.enabled).toBe(false));
+				const resumed = await host.schedules.update("sch-2", { enabled: true });
+				expect(resumed.enabled).toBe(true);
+				expect(resumed.nextFireAt).not.toBeNull();
+				const kept = await host.schedules.update("sch-2", { expiresAt: null });
+				expect(kept.expiresAt).toBeUndefined();
+			});
+			it.skipIf(!has("schedules.remove"))("remove deletes a schedule and the list follows", async () => {
+				const { host } = await setup();
+				const all = watch(host.schedules.all);
+				await host.schedules.refresh();
+				expect(await host.schedules.remove("sch-1")).toBe(true);
+				await waitFor(() => expect(ids(all.get())).toEqual(["sch-2", "sch-3"]));
+				expect(await host.schedules.remove("sch-1")).toBe(false);
+			});
+			it.skipIf(!has("schedules.runNow"))("runNow answers the fire it made", async () => {
+				const { host } = await setup();
+				const fire = await host.schedules.runNow("sch-1");
+				expect(fire).toMatchObject({
+					scheduleId: "sch-1",
+					sessionId: "s-1"
+				});
+				expect([
+					"sent",
+					"queued",
+					"merged"
+				]).toContain(fire.outcome);
+				if (has("schedules.fires")) expect((await host.schedules.fires("sch-1"))[0]?.id).toBe(fire.id);
+			});
+			it.skipIf(!has("schedules.fires"))("fires answers the history, newest first", async () => {
+				const { host } = await setup();
+				expect((await host.schedules.fires("sch-2")).map((f) => f.id)).toEqual(["f2", "f1"]);
+				expect(await host.schedules.fires("sch-1")).toEqual([]);
+			});
+		});
 		describe.skipIf(!has("runningWork"))("runningWork", () => {
 			const work = (host) => host.runningWork.items("s-1").get().map((w) => w.id);
 			it("reads a session work and hears the backend change it; ensure reads once", async () => {

package/dist/session/testing/index.d.ts

@@ -1,3 +1,5 @@
-import { FixtureQueuedEntry, FixtureSessionControl, FixtureSessionHost, SessionFixture, createFixtureSessionHost, tallyTodos, todosSnapshotOf } from "../headless/fixture-host.js";
+import { FixtureQueuedEntry, FixtureSessionControl, FixtureSessionHost, SessionFixture, createFixtureSessionHost } from "../headless/fixture-host.js";
+import { FixturePlansBackend, FixturePlansSeed, createFixturePlansBackend, planOf, plansSnapshotOf, tallyTodos } from "../headless/fixture-plans.js";
+import { FixtureScheduleBackend, FixtureScheduleOptions, SCHEDULES_OFF_MESSAGE, createFixtureScheduleBackend } from "../headless/fixture-schedules.js";
 import { DEMO_ARTIFACT_KIND_LABELS, DEMO_GITHUB_USAGE, DEMO_PROVIDER_USAGE, DEMO_SESSION_FIXTURE, DEMO_TURNS, demoUsageSummary } from "./demo.js";
-export { DEMO_ARTIFACT_KIND_LABELS, DEMO_GITHUB_USAGE, DEMO_PROVIDER_USAGE, DEMO_SESSION_FIXTURE, DEMO_TURNS, FixtureQueuedEntry, FixtureSessionControl, FixtureSessionHost, SessionFixture, createFixtureSessionHost, demoUsageSummary, tallyTodos, todosSnapshotOf };
+export { DEMO_ARTIFACT_KIND_LABELS, DEMO_GITHUB_USAGE, DEMO_PROVIDER_USAGE, DEMO_SESSION_FIXTURE, DEMO_TURNS, FixturePlansBackend, FixturePlansSeed, FixtureQueuedEntry, FixtureScheduleBackend, FixtureScheduleOptions, FixtureSessionControl, FixtureSessionHost, SCHEDULES_OFF_MESSAGE, SessionFixture, createFixturePlansBackend, createFixtureScheduleBackend, createFixtureSessionHost, demoUsageSummary, planOf, plansSnapshotOf, tallyTodos };

package/dist/session/testing/index.js

@@ -1,3 +1,5 @@
-import { createFixtureSessionHost, tallyTodos, todosSnapshotOf } from "../headless/fixture-host.js";
+import { SCHEDULES_OFF_MESSAGE, createFixtureScheduleBackend } from "../headless/fixture-schedules.js";
+import { createFixturePlansBackend, planOf, plansSnapshotOf, tallyTodos } from "../headless/fixture-plans.js";
+import { createFixtureSessionHost } from "../headless/fixture-host.js";
 import { DEMO_ARTIFACT_KIND_LABELS, DEMO_GITHUB_USAGE, DEMO_PROVIDER_USAGE, DEMO_SESSION_FIXTURE, DEMO_TURNS, demoUsageSummary } from "./demo.js";
-export { DEMO_ARTIFACT_KIND_LABELS, DEMO_GITHUB_USAGE, DEMO_PROVIDER_USAGE, DEMO_SESSION_FIXTURE, DEMO_TURNS, createFixtureSessionHost, demoUsageSummary, tallyTodos, todosSnapshotOf };
+export { DEMO_ARTIFACT_KIND_LABELS, DEMO_GITHUB_USAGE, DEMO_PROVIDER_USAGE, DEMO_SESSION_FIXTURE, DEMO_TURNS, SCHEDULES_OFF_MESSAGE, createFixturePlansBackend, createFixtureScheduleBackend, createFixtureSessionHost, demoUsageSummary, planOf, plansSnapshotOf, tallyTodos };

package/dist/settings/headless/catalog.js

@@ -7,7 +7,8 @@ import { APPROVAL_MODE_OPTIONS, DEFAULT_SETTINGS, DURABILITY_OPTIONS, SETTINGS_T
 */
 const GUI_GREYED_BY = {
 	browserAgent: "browser",
-	browserAutoShow: "browser"
+	browserAutoShow: "browser",
+	schedulesAgent: "schedules"
 };
 /** The GUI's copy and order, gated (`requires`, `killSwitchEnv`) exactly as canonical `SETTINGS_TOGGLES` says. */
 function withCanonicalGates(rows) {
@@ -65,6 +66,16 @@ const SETTINGS_TOGGLES = withCanonicalGates([
 		label: "Start from last session",
 		description: "Open the last session on launch instead of the sessions list."
 	},
+	{
+		key: "schedules",
+		label: "Reminders",
+		description: "Send a prompt to a session at a set time, once or on a repeat. Extensions can schedule their own reminders."
+	},
+	{
+		key: "schedulesAgent",
+		label: "Agent can set reminders",
+		description: "Give the agent a tool to schedule prompts to its own session, such as \"check the CI in 20 minutes\". Needs Reminders."
+	},
 	{
 		key: "hideSubagentOutput",
 		label: "Collapse subagents",
@@ -140,6 +151,11 @@ const SETTINGS_TOGGLES = withCanonicalGates([
 		label: "Web search",
 		description: "Let the agent search the web for docs, errors and recent changes."
 	},
+	{
+		key: "secrets",
+		label: "Secrets",
+		description: "Let the agent ask you for an API key or a token. It is kept in a private file for this project, out of the chat, and hidden in tool output."
+	},
 	{
 		key: "sandbox",
 		label: "Sandbox shell commands",

package/dist/settings/headless/index.d.ts

@@ -1,5 +1,5 @@
 import { SettingsCatalogEntries, SettingsCatalogInstallKind, SettingsCatalogKind, SettingsEnvironmentsHost, SettingsExtension, SettingsExtensionAction, SettingsExtensionActionResult, SettingsExtensionActionStatus, SettingsExtensionCreate, SettingsExtensionCreated, SettingsExtensionInstall, SettingsExtensionsHost, SettingsFile, SettingsFileWrite, SettingsHostCatalog, SettingsInstallScope, SettingsInstructionsHost, SettingsLoad, SettingsLogsHost, SettingsPaths, SettingsPlugin, SettingsPluginsHost, SettingsResource, SettingsSkillInstall, SettingsSkillsHost } from "./sections-host.js";
-import { SettingsCredential, SettingsPreferredCredential, SettingsProvider, SettingsProviderField, SettingsProvidersHost, SettingsSignInOptions, hasCredentialChoice } from "./providers.js";
+import { SettingsCredential, SettingsPreferredCredential, SettingsProvider, SettingsProviderField, SettingsProvidersHost, SettingsSignInOptions, accountsFocusId, accountsKeyFocusId, hasCredentialChoice } from "./providers.js";
 import { SettingsMcpAuthState, SettingsMcpBadge, SettingsMcpHost, SettingsMcpInstance, SettingsMcpRunning, SettingsMcpServer, SettingsMcpTest, SettingsMcpTool, enabledMcpTools, enabledMcpsAfterAdd, mcpBadge, mcpRunning, mcpSettingsAfterRemove, mcpShareable, mcpSharedNow, mcpSharingWith, settingsMcpServerOf, toggleMcpTool } from "./mcp.js";
 import { SettingsDecisionModel, SettingsModelTest, SettingsModelsHost } from "./models.js";
 import { SettingsClaudeImportCopy, SettingsClaudeImportDetect, SettingsClaudeImportHost, SettingsClaudeImportSelection, SettingsClaudeImportSummary } from "./claude-import.js";
@@ -14,4 +14,4 @@ import { DEFAULT_SETTINGS_LABELS, SettingsLabels } from "./labels.js";
 import { SettingsResourceOptions, createSettingsResource, keyedSettingsResources } from "./resource.js";
 import { listLength, settingsPageCounts } from "./page-counts.js";
 import { LayoutSectionsOptions, layoutSections } from "./layout-sections.js";
-export { BooleanSettingKey, DEFAULT_SETTINGS, DEFAULT_SETTINGS_LABELS, HIDDEN_TABLE_KEYS, LayoutSearchContext, LayoutSectionsOptions, PERF_HISTORY, PerfChannel, PerfChannelDirection, PerfGpu, PerfHotFunction, PerfLag, PerfMonitor, PerfMonitorState, PerfOrigin, PerfOsThread, PerfProcess, PerfProcessKind, PerfProcessMcp, PerfProcessNode, PerfProcessRow, PerfProcessSession, PerfProfile, PerfProfileError, PerfProfileOutcome, PerfProfileTarget, PerfSample, PerfSessionGroup, PerfSlowFrame, PerfThread, PerfTotals, PerfWatchError, SETTINGS_CHOICES, SETTINGS_CHOICE_BY_KEY, SETTINGS_PAGES, SETTINGS_TOGGLES, SETTINGS_TOGGLE_BY_KEY, SettingsAction, SettingsActionId, SettingsCatalogEntries, SettingsCatalogInstallKind, SettingsCatalogKind, SettingsChoice, SettingsClaudeImportCopy, SettingsClaudeImportDetect, SettingsClaudeImportHost, SettingsClaudeImportSelection, SettingsClaudeImportSummary, SettingsCredential, SettingsCustomRowId, SettingsDecisionModel, SettingsDocument, SettingsEnabledListKey, SettingsEnvironmentsHost, SettingsError, SettingsErrorKind, SettingsExtension, SettingsExtensionAction, SettingsExtensionActionResult, SettingsExtensionActionStatus, SettingsExtensionCreate, SettingsExtensionCreated, SettingsExtensionInstall, SettingsExtensionsHost, SettingsFile, SettingsFileWrite, SettingsHost, SettingsHostCatalog, SettingsInstallScope, SettingsInstructionsHost, SettingsLabels, SettingsLoad, SettingsLogsHost, SettingsMcpAuthState, SettingsMcpBadge, SettingsMcpHost, SettingsMcpInstance, SettingsMcpRunning, SettingsMcpServer, SettingsMcpTest, SettingsMcpTool, SettingsModelTest, SettingsModelsHost, SettingsPage, SettingsPageSection, SettingsPanelId, SettingsPanelPage, SettingsPaths, SettingsPerformanceHost, SettingsPlugin, SettingsPluginsHost, SettingsPreferredCredential, SettingsProvider, SettingsProviderField, SettingsProvidersHost, SettingsResource, SettingsResourceOptions, SettingsRow, SettingsSearchEntry, SettingsSearchHit, SettingsSection, SettingsSectionNoteId, SettingsSectionsPage, SettingsSectionsPageId, SettingsSignInOptions, SettingsSkillInstall, SettingsSkillsHost, SettingsTabId, SettingsToggle, SettingsTopId, createPerfMonitor, createSettingsResource, describedOn, enabledMcpTools, enabledMcpsAfterAdd, enabledNames, formatDuration, formatMemory, formatPercent, hasCredentialChoice, hasLaunched, isPanelPage, isSettingsError, keyedSettingsResources, layoutSearchEntries, layoutSections, listLength, mcpBadge, mcpRunning, mcpSettingsAfterRemove, mcpShareable, mcpSharedNow, mcpSharingWith, nestProcesses, nextOption, perfSeries, processGroups, processTree, searchSettings, sectionSearchHits, sessionGroups, settingsCount, settingsMcpServerOf, settingsPageCounts, settingsSearchHits, shown, toSettingsError, toggleEnabled, toggleMcpTool, visiblePages };
+export { BooleanSettingKey, DEFAULT_SETTINGS, DEFAULT_SETTINGS_LABELS, HIDDEN_TABLE_KEYS, LayoutSearchContext, LayoutSectionsOptions, PERF_HISTORY, PerfChannel, PerfChannelDirection, PerfGpu, PerfHotFunction, PerfLag, PerfMonitor, PerfMonitorState, PerfOrigin, PerfOsThread, PerfProcess, PerfProcessKind, PerfProcessMcp, PerfProcessNode, PerfProcessRow, PerfProcessSession, PerfProfile, PerfProfileError, PerfProfileOutcome, PerfProfileTarget, PerfSample, PerfSessionGroup, PerfSlowFrame, PerfThread, PerfTotals, PerfWatchError, SETTINGS_CHOICES, SETTINGS_CHOICE_BY_KEY, SETTINGS_PAGES, SETTINGS_TOGGLES, SETTINGS_TOGGLE_BY_KEY, SettingsAction, SettingsActionId, SettingsCatalogEntries, SettingsCatalogInstallKind, SettingsCatalogKind, SettingsChoice, SettingsClaudeImportCopy, SettingsClaudeImportDetect, SettingsClaudeImportHost, SettingsClaudeImportSelection, SettingsClaudeImportSummary, SettingsCredential, SettingsCustomRowId, SettingsDecisionModel, SettingsDocument, SettingsEnabledListKey, SettingsEnvironmentsHost, SettingsError, SettingsErrorKind, SettingsExtension, SettingsExtensionAction, SettingsExtensionActionResult, SettingsExtensionActionStatus, SettingsExtensionCreate, SettingsExtensionCreated, SettingsExtensionInstall, SettingsExtensionsHost, SettingsFile, SettingsFileWrite, SettingsHost, SettingsHostCatalog, SettingsInstallScope, SettingsInstructionsHost, SettingsLabels, SettingsLoad, SettingsLogsHost, SettingsMcpAuthState, SettingsMcpBadge, SettingsMcpHost, SettingsMcpInstance, SettingsMcpRunning, SettingsMcpServer, SettingsMcpTest, SettingsMcpTool, SettingsModelTest, SettingsModelsHost, SettingsPage, SettingsPageSection, SettingsPanelId, SettingsPanelPage, SettingsPaths, SettingsPerformanceHost, SettingsPlugin, SettingsPluginsHost, SettingsPreferredCredential, SettingsProvider, SettingsProviderField, SettingsProvidersHost, SettingsResource, SettingsResourceOptions, SettingsRow, SettingsSearchEntry, SettingsSearchHit, SettingsSection, SettingsSectionNoteId, SettingsSectionsPage, SettingsSectionsPageId, SettingsSignInOptions, SettingsSkillInstall, SettingsSkillsHost, SettingsTabId, SettingsToggle, SettingsTopId, accountsFocusId, accountsKeyFocusId, createPerfMonitor, createSettingsResource, describedOn, enabledMcpTools, enabledMcpsAfterAdd, enabledNames, formatDuration, formatMemory, formatPercent, hasCredentialChoice, hasLaunched, isPanelPage, isSettingsError, keyedSettingsResources, layoutSearchEntries, layoutSections, listLength, mcpBadge, mcpRunning, mcpSettingsAfterRemove, mcpShareable, mcpSharedNow, mcpSharingWith, nestProcesses, nextOption, perfSeries, processGroups, processTree, searchSettings, sectionSearchHits, sessionGroups, settingsCount, settingsMcpServerOf, settingsPageCounts, settingsSearchHits, shown, toSettingsError, toggleEnabled, toggleMcpTool, visiblePages };

package/dist/settings/headless/index.js

@@ -1,13 +1,13 @@
 import { DEFAULT_SETTINGS, SETTINGS_CHOICES, SETTINGS_TOGGLES, nextOption } from "./catalog.js";
-import { DEFAULT_SETTINGS_LABELS } from "./labels.js";
 import { isSettingsError, toSettingsError } from "./host.js";
 import { createSettingsResource, keyedSettingsResources } from "./resource.js";
 import { enabledMcpTools, enabledMcpsAfterAdd, mcpBadge, mcpRunning, mcpSettingsAfterRemove, mcpShareable, mcpSharedNow, mcpSharingWith, settingsMcpServerOf, toggleMcpTool } from "./mcp.js";
-import { hasCredentialChoice } from "./providers.js";
+import { DEFAULT_SETTINGS_LABELS } from "./labels.js";
+import { accountsFocusId, accountsKeyFocusId, hasCredentialChoice } from "./providers.js";
 import { enabledNames, toggleEnabled } from "./enabled.js";
 import { HIDDEN_TABLE_KEYS, SETTINGS_PAGES, describedOn, isPanelPage, settingsCount, shown, visiblePages } from "./layout.js";
 import { SETTINGS_CHOICE_BY_KEY, SETTINGS_TOGGLE_BY_KEY, layoutSearchEntries, searchSettings, sectionSearchHits, settingsSearchHits } from "./search.js";
 import { PERF_HISTORY, createPerfMonitor, formatDuration, formatMemory, formatPercent, hasLaunched, nestProcesses, perfSeries, processGroups, processTree, sessionGroups } from "./performance.js";
 import { listLength, settingsPageCounts } from "./page-counts.js";
 import { layoutSections } from "./layout-sections.js";
-export { DEFAULT_SETTINGS, DEFAULT_SETTINGS_LABELS, HIDDEN_TABLE_KEYS, PERF_HISTORY, SETTINGS_CHOICES, SETTINGS_CHOICE_BY_KEY, SETTINGS_PAGES, SETTINGS_TOGGLES, SETTINGS_TOGGLE_BY_KEY, createPerfMonitor, createSettingsResource, describedOn, enabledMcpTools, enabledMcpsAfterAdd, enabledNames, formatDuration, formatMemory, formatPercent, hasCredentialChoice, hasLaunched, isPanelPage, isSettingsError, keyedSettingsResources, layoutSearchEntries, layoutSections, listLength, mcpBadge, mcpRunning, mcpSettingsAfterRemove, mcpShareable, mcpSharedNow, mcpSharingWith, nestProcesses, nextOption, perfSeries, processGroups, processTree, searchSettings, sectionSearchHits, sessionGroups, settingsCount, settingsMcpServerOf, settingsPageCounts, settingsSearchHits, shown, toSettingsError, toggleEnabled, toggleMcpTool, visiblePages };
+export { DEFAULT_SETTINGS, DEFAULT_SETTINGS_LABELS, HIDDEN_TABLE_KEYS, PERF_HISTORY, SETTINGS_CHOICES, SETTINGS_CHOICE_BY_KEY, SETTINGS_PAGES, SETTINGS_TOGGLES, SETTINGS_TOGGLE_BY_KEY, accountsFocusId, accountsKeyFocusId, createPerfMonitor, createSettingsResource, describedOn, enabledMcpTools, enabledMcpsAfterAdd, enabledNames, formatDuration, formatMemory, formatPercent, hasCredentialChoice, hasLaunched, isPanelPage, isSettingsError, keyedSettingsResources, layoutSearchEntries, layoutSections, listLength, mcpBadge, mcpRunning, mcpSettingsAfterRemove, mcpShareable, mcpSharedNow, mcpSharingWith, nestProcesses, nextOption, perfSeries, processGroups, processTree, searchSettings, sectionSearchHits, sessionGroups, settingsCount, settingsMcpServerOf, settingsPageCounts, settingsSearchHits, shown, toSettingsError, toggleEnabled, toggleMcpTool, visiblePages };

package/dist/settings/headless/labels.d.ts

@@ -18,8 +18,6 @@ declare const DEFAULT_SETTINGS_LABELS: {
   settingsKilled: (env: string) => string;
   /** A toggle off because a kill switch is engaged: its tooltip. */
   settingsKilledTitle: (env: string) => string;
-  /** A toggle that needs another one on: the note under it. */
-  settingsBlocked: (requirement: string) => string;
   /** A toggle that needs another one on: its tooltip. */
   settingsBlockedTitle: (requirement: string) => string;
   /** The value a choice row shows while the host can't apply its setting. */

package/dist/settings/headless/labels.js

@@ -17,8 +17,6 @@ const DEFAULT_SETTINGS_LABELS = {
 	settingsKilled: (env) => `Turned off by ${env}=1. Unset it to change this.`,
 	/** A toggle off because a kill switch is engaged: its tooltip. */
 	settingsKilledTitle: (env) => `${env}=1`,
-	/** A toggle that needs another one on: the note under it. */
-	settingsBlocked: (requirement) => `Turn on "${requirement}" first.`,
 	/** A toggle that needs another one on: its tooltip. */
 	settingsBlockedTitle: (requirement) => `Needs "${requirement}"`,
 	/** The value a choice row shows while the host can't apply its setting. */

package/dist/settings/headless/layout.js

@@ -16,7 +16,12 @@ const SETTINGS_PAGES = [
 		sections: [
 			{
 				title: "Sessions",
-				rows: [{ key: "resumeLastSession" }, { key: "durability" }]
+				rows: [
+					{ key: "resumeLastSession" },
+					{ key: "schedules" },
+					{ key: "schedulesAgent" },
+					{ key: "durability" }
+				]
 			},
 			{
 				title: "Updates",
@@ -128,6 +133,7 @@ const SETTINGS_PAGES = [
 				rows: [
 					{ key: "approvalMode" },
 					{ action: "safelist" },
+					{ key: "secrets" },
 					{ key: "sandbox" },
 					{ key: "sandboxNetwork" },
 					{ key: "loadProjectExtensions" },

package/dist/settings/headless/providers.d.ts

@@ -13,6 +13,8 @@ interface SettingsCredential {
   key?: string;
   /** An OAuth account's name. */
   label?: string;
+  /** Its stable id (it stays put when another account is promoted): what a failed sign-in names. Absent: not stored, or stored before ids. */
+  id?: string;
 }
 /** A configuration field a provider asks for instead of an API key (an endpoint, a project id). */
 interface SettingsProviderField {
@@ -91,6 +93,20 @@ interface SettingsProvidersHost {
   /** Starts a browser sign-in; once it is done, `list` shows the account. Absent: keys only. */
   signIn?(provider: string, options?: SettingsSignInOptions): SignInFlow;
 }
+/**
+ * A provider's row on Settings › Accounts, as a deep link's focus names it
+ * (`SettingsShell`'s `initialFocus`).
+ *
+ * @param provider - The provider's key.
+ */
+declare function accountsFocusId(provider: string): string;
+/**
+ * A provider's API key field on Settings › Accounts, as a deep link's focus
+ * names it: the row opens on its key form.
+ *
+ * @param provider - The provider's key.
+ */
+declare function accountsKeyFocusId(provider: string): string;
 /**
  * Whether a provider holds more than one stored credential, so there is a
  * choice of which one is in use (the TUI's expandable auth rows).
@@ -99,4 +115,4 @@ interface SettingsProvidersHost {
  */
 declare function hasCredentialChoice(provider: Pick<SettingsProvider, 'methods'>): boolean;
 //#endregion
-export { SettingsCredential, SettingsPreferredCredential, SettingsProvider, SettingsProviderField, SettingsProvidersHost, SettingsSignInOptions, hasCredentialChoice };
+export { SettingsCredential, SettingsPreferredCredential, SettingsProvider, SettingsProviderField, SettingsProvidersHost, SettingsSignInOptions, accountsFocusId, accountsKeyFocusId, hasCredentialChoice };