@tsconfigdotjson/vibe-os 0.2.0 → 0.3.0

package/shared/wire.ts

@@ -10,13 +10,25 @@
  * Types only, deliberately. Every import of this file is an `import type` and
  * erases at build time, so nothing here has to be packaged, compiled into the
  * standalone binary, or resolved at runtime by either side. Runtime values that
- * happen to describe the same things — `PALETTE`, `HARNESSES` — stay in
- * `server/profiles.ts`, where they are used, and are shipped to the browser as
- * data on `ClientConfig` rather than duplicated as a second literal.
+ * happen to describe the same things — `PALETTE`, the harness specs — stay on
+ * the server, where they are used, and are shipped to the browser as data
+ * rather than duplicated as a second literal.
  */
 
-/** Which program a profile launches. */
-export type Harness = "claude" | "hermes" | "cursor" | "shell" | "custom";
+/**
+ * Which program a profile launches: a harness id from `GET /api/harnesses`,
+ * or `shell` or `custom`.
+ */
+export type Harness = string;
+
+export type {
+  ChoiceOption,
+  Field,
+  FlagSettings,
+  HarnessReport,
+  HarnessSpec,
+  McpMode,
+} from "./harness";
 
 /** Whether a window has been handed off to a real terminal. */
 export type Handoff = "ssh" | null;
@@ -45,99 +57,29 @@ export interface ClientConfig {
   themeColor: string;
   /** Colour tokens a profile may use; `--profile-<token>` resolves each one. */
   palette: readonly string[];
+  /** The scope limits a window gets when its profile sets none. */
+  memory: { high: string | null; max: string | null; swapMax: string | null };
 }
 
-/** `GET /api/harness/claude` — what the installed Claude CLI accepts. */
-export interface HarnessInfo {
-  available: boolean;
-  version: string | null;
+/** `GET /api/workspaces/:id/memory` — what the box has and each window costs. */
+export interface MemoryReport {
+  box: {
+    total: number;
+    available: number;
+    swapTotal: number;
+    swapFree: number;
+    pressure: { some10: number; full10: number } | null;
+  } | null;
   /**
-   * Aliases like `opus`, which always resolve to the newest model of that tier.
-   *
-   * These are the right default for a profile precisely because they do not
-   * pin: a role called "Backend Manager" wants the best Opus, not the one that
-   * was current the day it was written.
+   * What opening another agent would be warned with right now, or null when
+   * there is room. The dock shows it, so it never disagrees with the question.
    */
-  aliases: string[];
-  /** Full model ids, for pinning a profile to one exact model. */
-  models: string[];
-  /** Values `--permission-mode` accepts. */
-  permissionModes: string[];
-  /** Values `--effort` accepts, weakest first — the order is the scale. */
-  effortLevels: string[];
-}
-
-/**
- * Where Hermes' browser tools will land, and whether they will be the good ones.
- *
- * Hermes takes its CDP target from `browser.cdp_url` in `~/.hermes/config.yaml`
- * and offers no per-invocation flag for it, so this is a property of the box
- * rather than of a profile. The editor reads it to say which browser a role will
- * drive instead of implying a choice it does not have.
- */
-export interface HermesBrowser {
-  /** `browser.cdp_url` as configured, or null when nothing is set. */
-  cdpUrl: string | null;
-  /** `browser.backend`, or null when unset, which means Browser Use mode. */
-  backend: string | null;
-  /** The port the installed Chrome unit actually opened, when there is one. */
-  cdpPort: number | null;
-  /** Whether `cdpUrl` names that port. False is the whole reason this exists. */
-  connected: boolean;
-  /**
-   * Whether the `browser-use` CLI could run, directly or through `uvx`.
-   *
-   * Without it Hermes quietly keeps its twelve built-in browser tools, which
-   * works but costs the token saving that Browser Use mode is for.
-   */
-  browserUse: boolean;
-}
-
-/** `GET /api/harness/hermes` — what the installed Hermes CLI is set up for. */
-export interface HermesInfo {
-  available: boolean;
-  version: string | null;
-  /**
-   * Providers to offer in the datalist.
-   *
-   * A floor of the ones Hermes ships support for, merged with whatever its own
-   * config reports. `hermes model` is an interactive wizard with no listing
-   * mode, so unlike the Claude harness there is nothing authoritative to read.
-   */
-  providers: string[];
-  /** The provider `hermes chat` would use with no `--provider`, if readable. */
-  defaultProvider: string | null;
-  /** The model `hermes chat` would use with no `--model`, if readable. */
-  defaultModel: string | null;
-  /** Values `--reasoning` accepts, weakest first — the order is the scale. */
-  reasoningLevels: string[];
-  browser: HermesBrowser;
-}
-
-/** `GET /api/harness/cursor` — what the installed Cursor CLI is set up for. */
-export interface CursorInfo {
-  available: boolean;
-  version: string | null;
-  /**
-   * Model ids `cursor-agent models` reports, in the order it printed them.
-   *
-   * Unlike Hermes, Cursor has a real listing mode — but the list is the
-   * account's, not the binary's: it needs a login and sometimes the network,
-   * so an empty list means "could not read", never "no models exist". The
-   * editor keeps the field free text with these as suggestions.
-   */
-  models: string[];
-  /** The model `models` marked as current, when it marked one. */
-  defaultModel: string | null;
-  /**
-   * Whether `cursor-agent status` says someone is logged in.
-   *
-   * Three-valued on purpose: null is "could not tell", which covers a status
-   * output this build cannot read as well as a command that failed to run.
-   * Only a definite false is worth warning about — a profile launched while
-   * logged out opens a window that sits at the login prompt.
-   */
-  loggedIn: boolean | null;
+  warning: string | null;
+  /** Keyed by window id. A window with no live session is absent. */
+  windows: Record<
+    string,
+    { bytes: number; high: number | null; max: number | null; scoped: boolean }
+  >;
 }
 
 /**
@@ -204,6 +146,9 @@ export interface Profile {
   /** argv tokens, already split and validated by the server. */
   args: string[];
   prompt: string;
+  /** systemd sizes (`2G`, `40%`, `infinity`), or null for the server default. */
+  memoryHigh: string | null;
+  memoryMax: string | null;
   position: number;
   createdAt: number;
 }
@@ -222,5 +167,71 @@ export interface ProfileInput {
   command?: string | null;
   args?: string;
   prompt?: string;
+  /** Empty or null goes back to the server default. */
+  memoryHigh?: string | null;
+  memoryMax?: string | null;
   position?: number;
 }
+
+/** `GET /api/workspaces` — every workspace on the box, with its project. */
+export interface WorkspaceSummary {
+  id: string;
+  name: string;
+  branch: string;
+  path: string;
+  projectId: string;
+  project: string;
+  lastOpenedAt: number;
+}
+
+/** `GET /api/windows` — every window on the box, and whether it is running. */
+export interface WindowSummary {
+  id: string;
+  /** What `vibe-os attach` takes: `quiet-amber-otter-1`. */
+  ref: string;
+  session: string;
+  workspace: string;
+  project: string;
+  /** The profile it was opened as, or null for a plain terminal. */
+  role: string | null;
+  /** Its session is running. Always false with `--no-sessions`. */
+  live: boolean;
+  /** What the program in it is doing. Null when it is not running. */
+  state: Activity | null;
+  /** When it last drew anything, in ms since the epoch, if seen since the server started. */
+  lastOutputAt: number | null;
+  /** The caller's own tag for the window, set when it was opened. */
+  label: string | null;
+}
+
+/**
+ * What the program in a window is doing.
+ *
+ * `busy` is drawing right now, `question` is stopped on a dialog or a yes/no
+ * question, and `idle` is quiet at its prompt or finished.
+ */
+export type Activity = "busy" | "idle" | "question";
+
+/** `POST /api/windows/:id/send` */
+export interface SendInput {
+  /** The text to paste. Absent means the window's profile prompt. */
+  text?: string;
+  /** Values for the profile prompt's `{{blanks}}`, by label. */
+  blanks?: Record<string, string>;
+  /** Press Enter after the paste. */
+  submit?: boolean;
+  /** Paste even when the window is stopped on a question. */
+  force?: boolean;
+}
+
+/** What a send did. */
+export interface SendResult {
+  /** The session was started for this send. */
+  started: boolean;
+  /** The text went in and the window drew it. */
+  delivered: boolean;
+  /** What the window was doing when the text went in, or why it did not. */
+  state: Activity;
+  /** Why it was not delivered. */
+  reason?: string;
+}