zidane-ui 9.1.1 → 9.1.3

package/src/chat/headless/host.ts

@@ -1,264 +0,0 @@
-/**
- * The seam between the chat components and whatever runs the agent.
- *
- * A host is data (readable stores) plus actions. Everything optional is a
- * capability: when a host leaves a method out, the components hide the
- * control that would call it (no rename item without `sessions.rename`, no
- * stop button without `interrupt`). The desktop app, a server connection,
- * an agent running in the page and a recorded fixture all implement this.
- */
-import type { InteractionRequest, InteractionResponse, StreamEvent } from 'zidane/chat';
-import type { PromptSegmentRef } from 'zidane/chat/pure';
-
-import type { SessionRemoval } from './sidebar/directory';
-import type { SessionArchiveFilter, SidebarListSession } from './sidebar/types';
-import type { SidebarViewsHost } from './sidebar/view';
-import type { Readable } from './store';
-import type {
-  ChatBadgeActions,
-  ChatChipDetails,
-  ChatPaths,
-  ChatReferences,
-  ChatSearchSync,
-  ChatSiteIcons,
-} from './transcript-host';
-
-/** An attachment on a prompt, as the components can show it. */
-export interface ChatAttachment {
-  /** File name shown on the attachment chip. */
-  name: string;
-  /** MIME type, for example `image/png`. */
-  mediaType: string;
-  /** Size in bytes. */
-  size: number;
-  /** Where a preview loads the bytes from (images and PDFs): a `data:` URL, an object URL, or any URL the page can load. */
-  dataUrl?: string;
-}
-
-/**
- * zidane's canonical transcript event, plus what a live client knows and a
- * replay does not: attachment previews, arrival times, clipped outputs and
- * thinking durations. Every extra is optional; a replayed `StreamEvent`
- * list is a valid `ChatEvent` list.
- */
-export type ChatEvent = Omit<StreamEvent, 'attachments'> & {
-  attachments?: readonly ChatAttachment[];
-  /**
-   * Epoch ms the client received a `tool` / `tool-result` live. Times a call
-   * only when its host sent none (`startedAt` / `durationMs`, an older host).
-   */
-  receivedAt?: number;
-  /** The `tool-result` text was cut for transport; `host.toolOutput` fetches the whole of it. */
-  clipped?: true;
-  /** Epoch ms a live thinking segment opened (on its first event). */
-  thinkingStartedAt?: number;
-  /** A closed live thinking segment's duration, replacing `thinkingStartedAt`. */
-  thinkingMs?: number;
-};
-
-/** Run state of a session: `idle`, `running`, `completed`, or `error`. */
-export type ChatSessionStatus = 'idle' | 'running' | 'completed' | 'error';
-
-/** A session as the list shows it. */
-export interface ChatSession {
-  /** Stable session id. Passed to every host method that takes a `sessionId`. */
-  id: string;
-  /** Name shown in the list and used by the title search. */
-  title: string;
-  /** Run state, shown as the row's status dot. */
-  status: ChatSessionStatus;
-  /** Epoch milliseconds. */
-  createdAt: number;
-  /** Epoch milliseconds of the last activity. Drives recency sorting and relative times. */
-  updatedAt: number;
-  /** The session is archived. The list row shows an archive glyph. */
-  archived?: boolean;
-  /** Listed first, in the favorites section. */
-  favorite?: boolean;
-  /** Sessions sharing a group are listed together (a project, a folder, a host). */
-  group?: string;
-  /** Shown as the group's heading; defaults to `group`. */
-  groupLabel?: string;
-  /** Kept at the top of the list (the orchestrating main session). */
-  pinned?: boolean;
-  /** Id of the model the session uses, as listed in `host.models`. */
-  modelId?: string;
-}
-
-/** The state a {@link Transcript} store holds for one session. */
-export interface TranscriptState {
-  /** The events loaded so far, oldest first. */
-  events: readonly ChatEvent[];
-  /** A run is in flight: the last reply may still be streaming. */
-  running: boolean;
-  /** History has arrived (until then the transcript shows its loading state). */
-  hydrated: boolean;
-  /** Older events exist before `events[0]` (`loadEarlier` fetches them). */
-  hasEarlier?: boolean;
-  /** An earlier page of events is being fetched. */
-  loadingEarlier?: boolean;
-}
-
-/** A readable store of one session's {@link TranscriptState}. */
-export interface Transcript extends Readable<TranscriptState> {
-  /** Fetches older events and prepends them to `events`. Absent: the Earlier messages control is hidden. */
-  loadEarlier?(): void;
-}
-
-/** A request from the agent that waits for the user: a question, a plan, or an approval. */
-export interface ChatInteraction {
-  /** Id of the request. Pass it to `interactions.answer` or `interactions.cancel`. */
-  requestId: string;
-  /** Id of the session the request belongs to. */
-  sessionId: string;
-  /** The request itself: its kind and the content to show. */
-  request: InteractionRequest;
-  /** `false`: rehydrated from an earlier run, not raised by a run waiting right now (an inbox only badges it). Absent: live. */
-  live?: boolean;
-}
-
-/** A model a session can run. */
-export interface ChatModel {
-  /** Model id within its provider. Combined with the provider key as `provider/model` in {@link SendInput}. */
-  id: string;
-  /** Display name for pickers. */
-  label?: string;
-  /** Context window size in tokens. Drives the context meter. */
-  contextWindow?: number;
-  /** Supports extended thinking / reasoning effort. */
-  thinking?: boolean;
-  /** Feature toggles the model declares (fast mode), as the model options menu lists them. */
-  options?: readonly { id: string; label: string; description?: string }[];
-  /** Short facts the picker shows beside the name, before the window (a download size, `Cached`). */
-  details?: readonly string[];
-}
-
-/** A provider and the models it offers, as the model picker groups them. */
-export interface ChatModelProvider {
-  /** Provider id, the `provider` part of a `provider/model` reference. */
-  key: string;
-  /** Provider name shown as the group heading. */
-  label: string;
-  /** Models the provider offers. */
-  models: readonly ChatModel[];
-}
-
-/** What the composer sends to {@link ChatHost.send}. */
-export interface SendInput {
-  /** Id of the session to send to. */
-  sessionId: string;
-  /** The prompt text. */
-  prompt: string;
-  /** Files attached to the prompt. */
-  attachments?: readonly ChatAttachment[];
-  /** `provider/model` or a bare model id, as the host understands it. */
-  model?: string;
-  /** Reasoning effort for this prompt. `off` turns extended thinking off. */
-  thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
-  /** Skills picked through `/` completion, activated before the run. */
-  activatedSkills?: readonly string[];
-  /** The completions the prompt used (skills, files, chats), for its echo's chips. */
-  refs?: readonly PromptSegmentRef[];
-  /** `false`: a `/` command that shows its own header, so the prompt is not echoed. Default: echoed. */
-  echo?: boolean;
-  /** Sent from outside the composer (a retry, a palette prompt): the shared draft stays. */
-  keepDraft?: boolean;
-}
-
-/** A conversation whose content matched a search. */
-export interface SessionSearchHit {
-  /** The session that matched. */
-  sessionId: string;
-  /** Its title. */
-  title: string;
-  /** The matching text around the first hit. */
-  excerpt: string;
-  /** How many turns matched. */
-  matchCount: number;
-  /** The session's last activity, epoch ms. */
-  updatedAt: number;
-}
-
-/** The seam between the chat components and whatever runs the agent: readable stores plus optional actions. A component hides the control for any capability the host leaves out. */
-export interface ChatHost {
-  /** Session list and management. Each method left out hides its control (rename, archive, favorite, delete). */
-  sessions?: {
-    /** The sessions the list shows. */
-    list: Readable<readonly ChatSession[]>;
-    /** Creates a session, with an optional title, and resolves with it. */
-    create?(input?: { title?: string }): Promise<ChatSession>;
-    /** Sets a session's title. */
-    rename?(sessionId: string, title: string): Promise<void>;
-    /** Archives or restores a session. */
-    setArchived?(sessionId: string, archived: boolean): Promise<void>;
-    /** Marks or unmarks a session as a favorite. */
-    setFavorite?(sessionId: string, favorite: boolean): Promise<void>;
-    /** Deletes a session; resolves to `{ kept: true }` when its environment stayed on disk. */
-    remove?(sessionId: string): Promise<void | SessionRemoval>;
-    /**
-     * One host's sessions under an archive filter, with where each runs
-     * (folder, host, space): what the sidebar's session directory lists.
-     * `hostId` absent = this machine.
-     */
-    query?(filter: { archive: SessionArchiveFilter; hostId?: string }): Promise<readonly SidebarListSession[]>;
-    /** Moves a session to a space. */
-    setSpace?(sessionId: string, spaceId: string): Promise<void>;
-    /** Searches conversation content; hits for sessions the filter lists, best first. */
-    search?(query: string, filter?: { archive?: SessionArchiveFilter }): Promise<readonly SessionSearchHit[]>;
-    /** Fires (possibly in bursts) with a session whose row changed: created, renamed, moved, archived, deleted. */
-    onChanged?(listener: (sessionId: string) => void): () => void;
-    /**
-     * Fires with a session's facets when extensions computed new ones (`sessions:facets`): every value, keyed
-     * `<extensionId>.<key>`. Absent: facets change with the next read.
-     */
-    onFacets?(listener: (sessionId: string, facets: Readonly<Record<string, unknown>>) => void): () => void;
-    /** The sidebar's views, kept by the host so every window and device shares them. */
-    views?: SidebarViewsHost;
-    /** The orchestration Main session's id, created when missing; `null` while orchestration is off. */
-    main?(): Promise<string | null>;
-  };
-  /** Returns the transcript store for a session. */
-  transcript(sessionId: string): Transcript;
-  /** Sends a prompt to a session. Absent: the composer cannot send. */
-  send?(input: SendInput): Promise<void>;
-  /** Stops the run in flight in a session. Absent: no stop button. */
-  interrupt?(sessionId: string): void;
-  /**
-   * Runs a `!` shell command in the session's folder, outside any agent run; its run streams into the
-   * transcript. Absent: a `!` prompt goes to the model as text.
-   */
-  shell?(sessionId: string, command: string): Promise<void>;
-  /** Whether a model provider can answer a prompt sent from `cwd`. Absent: a send is never refused for want of one. */
-  providerReady?(cwd?: string): Promise<boolean>;
-  /** Add guidance to the run in flight. Resolves false when nothing was running. */
-  steer?(sessionId: string, message: string): Promise<boolean>;
-  /** Queue a prompt for when the run in flight ends. Resolves false when nothing was running. */
-  followUp?(sessionId: string, message: string): Promise<boolean>;
-  /** Pending questions, plans, and approvals, and the way to answer or dismiss them. */
-  interactions?: {
-    pending(sessionId: string): Readable<readonly ChatInteraction[]>;
-    /** Every session's pending requests, in arrival order (badges per session, the palette). Absent: only per session. */
-    all?(): Readable<readonly ChatInteraction[]>;
-    answer(requestId: string, response: InteractionResponse): Promise<void>;
-    /** Withdraw a request unanswered: the agent moves on without it. Absent: no Dismiss control. */
-    cancel?(requestId: string, reason?: string): Promise<void>;
-  };
-  /** Providers and models for the model picker. Absent: no picker. */
-  models?: Readable<readonly ChatModelProvider[]>;
-  /** A tool call's full output, when the event carries a preview only. */
-  toolOutput?(sessionId: string, callId: string): Promise<string | null>;
-  /** Stop a running tool call (a shell command). */
-  cancelTool?(sessionId: string, callId: string): void;
-  /** The transcript search a session's other windows share. Absent: the search stays in this window. */
-  searchSync?: ChatSearchSync;
-  /** Extension text references (ticket ids, issue links) in prose. Absent: they stay plain text. */
-  references?: ChatReferences;
-  /** What prose chips name on disk. Absent: a chip opens the path as written. */
-  paths?: ChatPaths;
-  /** What chip hover cards show (a commit, a `#chat`, a skill, a command). Absent: chips have no hover card. */
-  chips?: ChatChipDetails;
-  /** The badge menu's extension actions. Absent: the built-in actions only. */
-  badges?: ChatBadgeActions;
-  /** Site icons for link badges. Absent: links show the globe. */
-  siteIcons?: ChatSiteIcons;
-}

package/src/chat/headless/hosts.ts

@@ -1,55 +0,0 @@
-/**
- * The hosts a window runs sessions on: This computer and the servers saved
- * in the desktop app's Settings › Hosts, as its sidebar, session header and
- * new-chat picker read them. React-free.
- */
-import { DEFAULT_CHAT_LABELS, type ChatLabels } from './labels';
-
-/**
- * A host's connection. `local`: This computer, always reachable. The rest
- * mirror the TUI's statuses (`identity`: a different server answers at the
- * saved URL; `version-mismatch`: it speaks another protocol version).
- */
-export type HostStatus =
-  'local' | 'connecting' | 'connected' | 'reconnecting' | 'offline' | 'auth-refused' | 'identity' | 'version-mismatch';
-
-/** One host, as the kit's host parts show it. */
-export interface HostView {
-  /** `'local'` for This computer, else the server's host id. */
-  id: string;
-  /** This computer, or a saved server. */
-  kind: 'local' | 'server';
-  /** The name the sidebar and picker show. */
-  name: string;
-  /** The connection right now. */
-  status: HostStatus;
-  /** The server's URL. */
-  url?: string;
-  /** Why the last connect failed. */
-  error?: string;
-  /** The host's home folder, shown as `~` in its paths (`useDisplayPath`). Absent: its paths show in full. */
-  home?: string;
-}
-
-/**
- * Whether sessions on a host can be driven: This computer always, a server
- * only while connected. A host no longer saved (`undefined`) is not.
- *
- * @param host - The host, or `undefined` when it is not saved anymore.
- */
-export function hostReachable(host: HostView | undefined): boolean {
-  return host !== undefined && (host.kind === 'local' || host.status === 'connected');
-}
-
-/**
- * One word for a host's status, for dots and labels, as the TUI words it.
- *
- * @param host - The host.
- * @param labels - The label dictionary (default: the kit's English one).
- */
-export function hostStatusLabel(
-  host: HostView,
-  labels: Pick<ChatLabels, 'hostStatuses'> = DEFAULT_CHAT_LABELS,
-): string {
-  return labels.hostStatuses[host.status] ?? labels.hostStatuses.offline;
-}

package/src/chat/headless/index.ts

@@ -1,31 +0,0 @@
-/**
- * `zidane-ui/chat/headless`: the React-free chat model. The `ChatHost` seam
- * and its stores, the session-list model, the transcript pipeline, labels, the
- * session stream store (`createSessionStreams`), and the fixtures
- * (`createFixtureHost`, `DEMO_TRANSCRIPT`) the docs and demos run on.
- */
-export * from './host';
-export * from './transcript-host';
-export * from './composer-modes';
-export * from './chip-settle';
-export * from './badge-refs';
-export * from './file-chip';
-export * from './reference-store';
-export * from './path-resolver';
-export * from './chip-views';
-export * from './site-icons';
-export * from './store';
-export * from './labels';
-export * from './session-list';
-export * from './markdown-chunks';
-export * from './smooth-stream';
-export * from './hosts';
-export * from './transcript';
-export * from './streams';
-export * from './send-flow';
-export * from './draft-target';
-export * from './draft-scope';
-export * from './turn-prompt';
-export type { PromptOrigin } from './prompt-origin';
-export * from './sidebar';
-export * from './composer';