zidane-ui 9.0.4 → 9.1.3

package/dist/chat/headless/labels.js

@@ -11,7 +11,6 @@ import { RUN_WAITING_LABEL, runRetryingLabel } from "zidane/chat/pure";
 const DEFAULT_CHAT_LABELS = {
 	...DEFAULT_LABELS,
 	...TRANSCRIPT_LABELS,
-	throbberEllipsis: "reserves 3 char widths so the ellipsis cycle doesn't shift adjacent layout",
 	today: "Today",
 	yesterday: "Yesterday",
 	months: [
@@ -46,6 +45,7 @@ const DEFAULT_CHAT_LABELS = {
 	showMore: "Show more",
 	expandGroup: (label) => `Expand ${label}`,
 	collapseGroup: (label) => `Collapse ${label}`,
+	openGroup: (label) => `Open ${label}`,
 	newSessionIn: (label) => `New session in ${label}`,
 	newSession: "New session",
 	searchSessions: "Search sessions",
@@ -59,6 +59,13 @@ const DEFAULT_CHAT_LABELS = {
 	dotError: "Errored",
 	dotAttention: "Awaiting input",
 	dotAttached: "Attached",
+	estimateTitle: (left) => `About ${left.replace(/^~/, "")} left (estimated)`,
+	estimatePausedTitle: (left) => `About ${left.replace(/^~/, "")} left. Paused while the run waits for you`,
+	estimateDue: "almost done",
+	estimateDueTitle: "Past its estimate, so it should end soon",
+	estimateOver: "over",
+	estimateOverTitle: "Taking longer than estimated",
+	runningFor: (elapsed) => `Running for ${elapsed}`,
 	agent: "Agent",
 	stepRunning: "running",
 	stepFailed: "failed",
@@ -108,12 +115,70 @@ const DEFAULT_CHAT_LABELS = {
 	showOutput: "Show output",
 	inputCaption: "Input",
 	outputCaption: "Output",
+	/** Title of the chip that shows a script's `// @options` line. */
+	scriptOptions: "Script options",
+	/** The script's `timeout_ms`, in its options tooltip. */
+	scriptOptionTimeout: "Time limit",
+	/** The script's `max_output_tokens`, in its options tooltip. */
+	scriptOptionOutput: "Output budget",
+	scriptOptionTokens: (tokens) => `${tokens.toLocaleString("en-US")} tokens`,
+	/** Accessible name of the panel with the last lines a running script printed. */
+	scriptLiveOutput: "Live output",
+	/** Calls finished out of all the script makes, when each runs once at most. */
+	scriptCallsOf: (done, total) => `${done} of ${total}`,
+	scriptPercent: (percent) => `${percent}%`,
+	scriptCallsDone: (done) => `${done} done`,
+	scriptCallsRunning: (running) => `${running} running`,
+	scriptCallsFailed: (failed) => `${failed} failed`,
+	/** Accessible name of the script's progress bar. */
+	scriptProgress: "Script progress",
 	openNamedSession: (title) => `Open ${title}`,
+	/** A Mermaid diagram's accessible name, and its type when Pele detected one (`flowchart`). */
+	diagram: (type) => type ? `${type} diagram` : "Diagram",
+	/** The diagram frame's toggle to its Mermaid source. */
+	showDiagramSource: "Show source",
+	/** The diagram frame's toggle back to the drawing. */
+	showDiagram: "Show diagram",
+	/** The diagram frame's zoom controls. */
+	zoomInDiagram: "Zoom in",
+	zoomOutDiagram: "Zoom out",
+	fitDiagram: "Fit diagram",
+	/** Copy button of a diagram frame. */
+	copyDiagramSource: "Copy diagram source",
+	/** Under a fence that could not be drawn; `at` is `line 3, column 7` or empty. */
+	diagramError: (message, at) => at ? `Diagram not drawn (${at}): ${message}` : `Diagram not drawn: ${message}`,
+	/** Where a diagram error is. */
+	diagramErrorAt: (line, column) => column ? `line ${line}, column ${column}` : `line ${line}`,
 	stopCommand: "Stop command",
 	shellCancelled: "cancelled",
 	shellKilled: "killed",
 	shellExit: (code) => `exit ${code}`,
 	earlierLines: (count) => `… (+${count} earlier lines)`,
+	/** The block's run button, and the menu row that runs it under the block. */
+	blockRunHere: "Run here",
+	blockRunInTerminal: "Run in a terminal",
+	/** The caret beside the run button: the menu of ways to run. */
+	blockRunMenu: "Ways to run",
+	blockRunStop: "Stop",
+	/** A run in progress, in the panel under the block. */
+	blockRunning: "Running",
+	/** Accessible name of a run's output panel. */
+	blockRunOutput: "Run output",
+	blockRunAgain: "Run again",
+	blockRunCopy: "Copy output",
+	/** Stages the run's output as a text file on the message being written. */
+	blockRunAttach: "Add to message",
+	blockRunRemove: "Remove output",
+	/** The attachment's file name when the output is added to a message. */
+	blockRunAttachmentName: "run-output.md",
+	blockRunStopped: "stopped",
+	blockRunTimedOut: "timed out",
+	/** The output kept only its end. */
+	blockRunTruncated: "Earlier output was cut.",
+	/** The panel when the block could not run. */
+	blockRunFailed: (reason) => `Could not run: ${reason}`,
+	/** After a failed run: it may have wanted input, which a terminal gives. */
+	blockRunNeedsTerminal: "Needs input? Run it in a terminal.",
 	working: "Working",
 	foldSteps: (count) => `${count} steps`,
 	foldOutcomes: (ok, failed) => failed > 0 ? `${ok} succeeded, ${failed} failed` : `${ok} succeeded`,
@@ -185,7 +250,7 @@ const DEFAULT_CHAT_LABELS = {
 	modelsJumpHint: (provider, digit) => digit ? `${provider} (⌘${digit})` : provider,
 	modelsLoading: "Loading…",
 	modelsLoadFailed: (error) => `Failed to load models: ${error}`,
-	modelsNoProviders: "No provider is signed in. Sign in under Settings → Authentication.",
+	modelsNoProviders: "No provider is signed in. Sign in under Settings → Accounts.",
 	modelsNoMatch: (query) => `No model matches "${query}".`,
 	modelsTypeAnId: "Type any model id to use it. Put a provider first to pick one, for example \"xai grok-9\".",
 	modelsInUse: "In use",
@@ -271,7 +336,8 @@ const DEFAULT_CHAT_LABELS = {
 		host: "Per host",
 		none: "All projects",
 		date: "By date",
-		state: "By state"
+		state: "By state",
+		agent: "By agent"
 	},
 	filterStatuses: {
 		active: "Active",
@@ -293,6 +359,17 @@ const DEFAULT_CHAT_LABELS = {
 	filterAllProjects: "All",
 	filterAllProjectsOption: "All projects",
 	filterNoProjects: "No projects yet",
+	filterAgent: "Agent",
+	filterAllAgents: "All",
+	filterAllAgentsOption: "All agents",
+	filterNoAgents: "No agents yet",
+	/** A contributed select or multi filter with nothing picked. */
+	filterAny: "Any",
+	/** A contributed filter's value: how many options are picked. */
+	filterPicked: (count) => `${count} picked`,
+	/** A space's own grouping or sort, among the view's choices. */
+	filterSpaceDefault: "Space default",
+	filterSaveView: "Save view as space",
 	hostStatuses: {
 		local: "connected",
 		connected: "connected",

package/dist/chat/headless/session-list.d.ts

@@ -57,6 +57,8 @@ interface SessionListOptions<S> {
    * @default 'recency'
    */
   sortBy?: SessionSortBy;
+  /** Orders sessions in place of `sortBy` (a query sort an extension or a space defines). */
+  compare?: (a: S, b: S) => number;
   /** Header ids whose sessions are hidden. */
   collapsedGroups?: ReadonlySet<string>;
   /** Header ids whose capped group shows every session. */
@@ -109,7 +111,6 @@ interface CalendarOptions {
  * @param calendar - Pins the zone and locale the days are read in.
  */
 declare function dateBucket(at: number, now: number, labels?: {
-  throbberEllipsis: string;
   today: string;
   yesterday: string;
   months: readonly string[];
@@ -131,6 +132,7 @@ declare function dateBucket(at: number, now: number, labels?: {
   showMore: string;
   expandGroup: (label: string) => string;
   collapseGroup: (label: string) => string;
+  openGroup: (label: string) => string;
   newSessionIn: (label: string) => string;
   newSession: string;
   searchSessions: string;
@@ -144,6 +146,13 @@ declare function dateBucket(at: number, now: number, labels?: {
   dotError: string;
   dotAttention: string;
   dotAttached: string;
+  estimateTitle: (left: string) => string;
+  estimatePausedTitle: (left: string) => string;
+  estimateDue: string;
+  estimateDueTitle: string;
+  estimateOver: string;
+  estimateOverTitle: string;
+  runningFor: (elapsed: string) => string;
   agent: string;
   stepRunning: string;
   stepFailed: string;
@@ -188,12 +197,48 @@ declare function dateBucket(at: number, now: number, labels?: {
   showOutput: string;
   inputCaption: string;
   outputCaption: string;
+  scriptOptions: string;
+  scriptOptionTimeout: string;
+  scriptOptionOutput: string;
+  scriptOptionTokens: (tokens: number) => string;
+  scriptLiveOutput: string;
+  scriptCallsOf: (done: number, total: number) => string;
+  scriptPercent: (percent: number) => string;
+  scriptCallsDone: (done: number) => string;
+  scriptCallsRunning: (running: number) => string;
+  scriptCallsFailed: (failed: number) => string;
+  scriptProgress: string;
   openNamedSession: (title: string) => string;
+  diagram: (type: string | null) => string;
+  showDiagramSource: string;
+  showDiagram: string;
+  zoomInDiagram: string;
+  zoomOutDiagram: string;
+  fitDiagram: string;
+  copyDiagramSource: string;
+  diagramError: (message: string, at: string) => string;
+  diagramErrorAt: (line: number, column: number) => string;
   stopCommand: string;
   shellCancelled: string;
   shellKilled: string;
   shellExit: (code: number) => string;
   earlierLines: (count: number) => string;
+  blockRunHere: string;
+  blockRunInTerminal: string;
+  blockRunMenu: string;
+  blockRunStop: string;
+  blockRunning: string;
+  blockRunOutput: string;
+  blockRunAgain: string;
+  blockRunCopy: string;
+  blockRunAttach: string;
+  blockRunRemove: string;
+  blockRunAttachmentName: string;
+  blockRunStopped: string;
+  blockRunTimedOut: string;
+  blockRunTruncated: string;
+  blockRunFailed: (reason: string) => string;
+  blockRunNeedsTerminal: string;
   working: string;
   foldSteps: (count: number) => string;
   foldOutcomes: (ok: number, failed: number) => string;
@@ -352,6 +397,7 @@ declare function dateBucket(at: number, now: number, labels?: {
     none: string;
     date: string;
     state: string;
+    agent: string;
   };
   filterStatuses: {
     active: string;
@@ -373,6 +419,14 @@ declare function dateBucket(at: number, now: number, labels?: {
   filterAllProjects: string;
   filterAllProjectsOption: string;
   filterNoProjects: string;
+  filterAgent: string;
+  filterAllAgents: string;
+  filterAllAgentsOption: string;
+  filterNoAgents: string;
+  filterAny: string;
+  filterPicked: (count: number) => string;
+  filterSpaceDefault: string;
+  filterSaveView: string;
   hostStatuses: {
     local: string;
     connected: string;
@@ -438,6 +492,7 @@ declare function dateBucket(at: number, now: number, labels?: {
   interactionWaitingDecision: string;
   interactionWaitingAnswers: string;
   interactionDismissed: string;
+  interactionAnsweredBy: (who: string) => string;
   badgePathUnavailable: string;
   badgeNoComposer: string;
   badgeCopied: string;
@@ -572,6 +627,14 @@ declare function relativeTime(at: number, now: number, labels?: Pick<ChatLabels,
  * @param sec - Elapsed whole seconds.
  */
 declare function formatElapsedShort(sec: number): string;
+/**
+ * The order a sort puts two sessions in (negative: `a` first), as {@link buildSessionRows} sorts them.
+ *
+ * @param a - One session.
+ * @param b - The other.
+ * @param sort - The sort.
+ */
+declare function compareSessions(a: ListableSession, b: ListableSession, sort: SessionSortBy): number;
 /**
  * Builds the flat row list for a session list: favorites first, then groups with headers, collapse state, and "show more" caps for project groups. Pure: the same input gives the same rows.
  *
@@ -587,4 +650,4 @@ declare function buildSessionRows<S extends ListableSession>(sessions: readonly
  */
 declare function filterSessions<S extends ListableSession>(sessions: readonly S[], query: string): S[];
 //#endregion
-export { CalendarOptions, ListableSession, PROJECT_GROUP_CAP, RELATIVE_TIME_DATE_AFTER_DAYS, SessionGroupBy, SessionListOptions, SessionListRow, SessionSortBy, buildSessionRows, dateBucket, filterSessions, formatElapsedShort, relativeTime };
+export { CalendarOptions, ListableSession, PROJECT_GROUP_CAP, RELATIVE_TIME_DATE_AFTER_DAYS, SessionGroupBy, SessionListOptions, SessionListRow, SessionSortBy, buildSessionRows, compareSessions, dateBucket, filterSessions, formatElapsedShort, relativeTime };

package/dist/chat/headless/session-list.js

@@ -114,6 +114,13 @@ function formatElapsedShort(sec) {
 	const m = Math.floor(sec % 3600 / 60);
 	return `${Math.floor(sec / 3600)}h${m ? ` ${m}m` : ""}`;
 }
+/**
+* The order a sort puts two sessions in (negative: `a` first), as {@link buildSessionRows} sorts them.
+*
+* @param a - One session.
+* @param b - The other.
+* @param sort - The sort.
+*/
 function compareSessions(a, b, sort) {
 	switch (sort) {
 		case "alphabetical": return (a.title || "").localeCompare(b.title || "");
@@ -154,7 +161,8 @@ function buildSessionRows(sessions, options = {}) {
 		...DEFAULT_CHAT_LABELS,
 		...options.labels
 	};
-	const all = sessions.slice().sort((a, b) => compareSessions(a, b, options.sortBy ?? "recency"));
+	const compare = options.compare ?? ((a, b) => compareSessions(a, b, options.sortBy ?? "recency"));
+	const all = sessions.slice().sort(compare);
 	const favorites = options.isFavorite ? all.filter(options.isFavorite) : [];
 	const sorted = favorites.length > 0 ? all.filter((s) => !options.isFavorite(s)) : all;
 	const out = [];
@@ -272,4 +280,4 @@ function filterSessions(sessions, query) {
 	});
 }
 //#endregion
-export { PROJECT_GROUP_CAP, RELATIVE_TIME_DATE_AFTER_DAYS, buildSessionRows, dateBucket, filterSessions, formatElapsedShort, relativeTime };
+export { PROJECT_GROUP_CAP, RELATIVE_TIME_DATE_AFTER_DAYS, buildSessionRows, compareSessions, dateBucket, filterSessions, formatElapsedShort, relativeTime };

package/dist/chat/headless/sidebar/badges.d.ts

@@ -17,6 +17,8 @@ interface SessionBadgesSource {
   onArtifactsChanged?(listener: (sessionId: string) => void): () => void;
   /** Fires when the badge kinds may have changed (extensions reloaded or built). */
   onRegistryChanged?(listener: () => void): () => void;
+  /** Hears every session a row shows, once per change of the set (after the commit). Absent: not told. */
+  shown?(sessionIds: readonly string[]): void;
 }
 /** Every session's badges, outside React. */
 interface SessionBadgesStore {

package/dist/chat/headless/sidebar/badges.js

@@ -15,6 +15,21 @@ function createSessionBadges(source) {
 	const queued = /* @__PURE__ */ new Set();
 	let flushQueued = false;
 	let nextRead = 0;
+	let shownQueued = false;
+	/** The set last told to `source.shown`, so an unchanged one is not told again. */
+	let lastShown = "";
+	const reportShown = () => {
+		if (!source.shown || shownQueued) return;
+		shownQueued = true;
+		queueMicrotask(() => {
+			shownQueued = false;
+			const ids = [...listeners.keys()].sort();
+			const key = ids.join("\0");
+			if (key === lastShown) return;
+			lastShown = key;
+			source.shown?.(ids);
+		});
+	};
 	const notify = (sessionId) => {
 		for (const listener of listeners.get(sessionId) ?? []) listener();
 	};
@@ -84,11 +99,15 @@ function createSessionBadges(source) {
 			if (!group) {
 				group = /* @__PURE__ */ new Set();
 				listeners.set(sessionId, group);
+				reportShown();
 			}
 			group.add(listener);
 			return () => {
 				group.delete(listener);
-				if (group.size === 0 && listeners.get(sessionId) === group) listeners.delete(sessionId);
+				if (group.size === 0 && listeners.get(sessionId) === group) {
+					listeners.delete(sessionId);
+					reportShown();
+				}
 			};
 		},
 		request,

package/dist/chat/headless/sidebar/directory.d.ts

@@ -2,16 +2,18 @@ import { Readable } from "../store.js";
 import { SessionNotificationStore } from "./notifications.js";
 import { SessionActivityFilter, SessionArchiveFilter, SidebarListSession } from "./types.js";
 import { SidebarViews } from "./view.js";
-import { Space } from "zidane/chat/pure";
+import { SidebarContributions, SidebarSpace } from "./query.js";
 //#region src/chat/headless/sidebar/directory.d.ts
 /** A project as one space lists it: its path (`projectPathOf`), the host it is on, the space. */
 interface ProjectInSpace {
-  /** The project's folder ({@link projectPathOf}). */
+  /** The project's folder (`projectPathOf`). */
   path: string;
   /** A remote host's id; absent for this machine. */
   hostId?: string;
   /** The space it is listed in (an unknown or absent id is the default space). */
   spaceId?: string;
+  /** Its repository, when its group also lists the repository's sessions on other machines (`isProjectMember`). */
+  repoKey?: string;
 }
 /** What deleting a session did with its environment. */
 type SessionRemoval = {
@@ -41,6 +43,11 @@ interface SessionDirectorySource<S extends SidebarListSession, C = unknown> {
   remove?(sessionId: S['id']): Promise<void | SessionRemoval>;
   /** Fires (possibly in bursts) with a session whose row changed. */
   onChanged?(listener: (sessionId: S['id']) => void): () => void;
+  /**
+   * Fires with a session's facets when the extensions computed new ones (`sessions:facets`): every
+   * value, keyed `<extensionId>.<key>`. Absent: facets change only with a re-read.
+   */
+  onFacets?(listener: (sessionId: S['id'], facets: Readonly<Record<string, unknown>>) => void): () => void;
 }
 /** The slice of the session stream store the directory keeps in step. */
 interface SessionDirectoryStreams<K extends string, P> {
@@ -133,6 +140,13 @@ interface SessionDirectoryOptions<S extends SidebarListSession, P, C = unknown>
   onRemoved?(sessionId: S['id']): void;
   /** A refresh failed. */
   onError?(error: unknown): void;
+  /**
+   * What the extensions contribute to the sidebar (`sidebarContributionsOf(host.items)`). An app whose
+   * extensions host comes later attaches it then (`attachContributions`).
+   */
+  contributions?: Readable<SidebarContributions>;
+  /** Adds a space to the user's list (the settings' `spaceList`). Absent: a view can't be saved as a space. */
+  saveSpace?(space: SidebarSpace): Promise<void>;
 }
 /** The directory's state as one snapshot: a new object whenever any field changes. */
 interface SessionDirectoryState<S extends SidebarListSession> {
@@ -142,10 +156,20 @@ interface SessionDirectoryState<S extends SidebarListSession> {
   activeSessionId: S['id'] | null;
   /** Spaces are on. */
   spacesOn: boolean;
-  /** The spaces in switcher order, the default one always present. */
-  spaces: readonly Space[];
+  /** Every space, the default one always present: the user's in order, then the extensions'. */
+  spaces: readonly SidebarSpace[];
+  /** The spaces the switcher shows, in its order (the user's arrangement on top of `spaces`). */
+  switcherSpaces: readonly SidebarSpace[];
+  /**
+   * The spaces the user hid from the switcher on this device (`setSpaceHidden`), in `spaces` order:
+   * what the switcher's Hidden spaces menu offers to show again. A space hidden in the settings'
+   * space list (`hidden: true`) is not in it: the settings show it again.
+   */
+  hiddenSpaces: readonly SidebarSpace[];
   /** The space shown (the default one while spaces are off). */
-  activeSpace: Space;
+  activeSpace: SidebarSpace;
+  /** What the extensions contribute to the sidebar. */
+  contributions: SidebarContributions;
   /** The last space switch, for the list's slide. */
   spaceSlide: {
     spaceId: string;
@@ -202,6 +226,20 @@ interface SessionDirectory<S extends SidebarListSession, C = unknown> {
   stepSpace(delta: 1 | -1): boolean;
   /** Moves a session to a space, then re-reads. */
   setSessionSpace(sessionId: S['id'], spaceId: string): Promise<void>;
+  /** Hides a space from the switcher or shows it again; hiding the shown space shows the default one. */
+  setSpaceHidden(spaceId: string, hidden: boolean): void;
+  /** Moves a space one place left (-1) or right (1) in the switcher. */
+  moveSpace(spaceId: string, delta: 1 | -1): void;
+  /** Follow an extensions host's sidebar contributions from now on (replacing any); returns the detach. */
+  attachContributions(contributions: Readable<SidebarContributions>): () => void;
+  /**
+   * Saves the shown space's view as a new user space (its query, grouping and sort) and shows it.
+   * The query is `viewQuery`'s (`zidane/chat/pure`): the space's membership, then the project,
+   * activity, agent and contributed filters. Rejects with a `SessionQueryError` (nothing saved)
+   * when that query is not valid (too deep, too many nodes or values), and with `saveSpace`'s error.
+   * Undefined without `saveSpace`. The sidebar's `useSaveViewAsSpace` names the space and words a failure.
+   */
+  saveViewAsSpace?: (name: string) => Promise<SidebarSpace>;
   /** A project's sessions in its space (every archive state), read fresh from its host. */
   listProjectSessions(project: ProjectInSpace): Promise<S[]>;
   /** Move a project's sessions to another space; resolves to how many moved. */
@@ -214,7 +252,9 @@ interface SessionDirectory<S extends SidebarListSession, C = unknown> {
  */
 declare function createSessionDirectory<S extends SidebarListSession, P, C = unknown>(options: SessionDirectoryOptions<S, P, C>): SessionDirectory<S, C>;
 /**
- * The project filter's key for a session: its folder's name.
+ * The project filter's key for a session: its folder's name, as a query's
+ * `projectName` reads it (`projectNameOf`: `/` and `\` both separate), so a
+ * view saved from the filter matches the same sessions.
  *
  * @param session - Its folder and project root.
  */