@tomradex/code-sessions 0.15.0 → 0.16.0

package/dist/index.d.ts

@@ -9,8 +9,8 @@ export declare const Config: z.ZodObject<{
     stateFile: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Config = z.infer<typeof Config>;
-/** Ended sessions stay listed this long, so the last look at one is a click away. */
-export declare const ENDED_SHOWN_MS: number;
+/** A session that ended in herdr this recently may come back with herdr's server: the window starts it for them. */
+export declare const RECENTLY_ENDED_MS: number;
 /** How often an open window asks herdr how it is, besides every session change. */
 export declare const BRIDGE_POLL_MS = 10000;
 /** Whether a stored value is a layout the window can draw. */
@@ -20,7 +20,7 @@ export declare function isLayout(value: unknown): value is Layout;
  * the folder, or a PowerShell window there when it is not installed. Resolves with the app it opened.
  */
 export declare function openSystemTerminal(cwd: string, platform?: NodeJS.Platform, launch?: typeof spawn): Promise<string>;
-/** A project's code sessions as the window lists them: live ones first, then the ones ended in the last day. */
+/** A project's code sessions, live ones first and needs-you before the rest, then every ended one code link keeps. */
 export declare function sessionRows(codeLink: Pick<CodeLink, "sessionsOf" | "links">, items: {
     get(projectId: string, id: string): {
         key: string;

package/dist/protocol.d.ts

@@ -25,6 +25,8 @@ export interface SessionRow {
     prUrl: string | null;
     worktree: string | null;
     startedAt: number;
+    /** When it ended; null while it lives. */
+    endedAt: number | null;
 }
 /** A plain terminal the window opened: a herdr pane of the person's, with no ticket or code-link session behind it. */
 export interface TerminalRow {
@@ -34,6 +36,8 @@ export interface TerminalRow {
     /** Null while herdr is still opening it. */
     pane: string | null;
     startedAt: number;
+    /** What the agent herdr sees in it calls the conversation; null without one. */
+    agentTitle: string | null;
     /** The code session its agent claimed a ticket for: the cell shows that session, on the same pane. */
     sessionId: string | null;
     /** Why it stays a plain terminal although an agent claimed a ticket, when Tomrade cannot tell which terminal that was. */
@@ -51,10 +55,12 @@ export interface LayoutPreset {
     layout: Layout;
 }
 /** A cell of the window's layout: one session or terminal (by its id), or a split of two. */
+/** A leaf `locked` keeps its session until the person unlocks or closes it. */
 export type Layout = {
     type: "leaf";
     id: string;
     sessionId: string | null;
+    locked?: true;
 } | {
     type: "split";
     id: string;
@@ -63,13 +69,18 @@ export type Layout = {
     a: Layout;
     b: Layout;
 };
-/** What the window shows, set as its whole state. */
+/**
+ * What the window shows, set as its whole state. `sessions` holds the live ones and the ended ones a cell still
+ * shows; the rest are in `archive`.
+ */
 export interface WindowState {
     projectId: string;
     projectName: string;
     /** The app's language, so the window speaks it even before the main window says how it looks. */
     locale: string;
     bridge: HerdrBridge;
+    /** herdr's server went away under this window's terminals: being started again, or that did not work (the person can retry). */
+    revive: "starting" | "failed" | null;
     /** How herdr installs here, when it is missing: the command shown on the button, or only the guide. */
     install: {
         command: string | null;
@@ -91,6 +102,18 @@ export interface WindowState {
     defaultPreset: string | null;
     /** New sessions and terminals go to the first empty cell. */
     autoPlace: boolean;
+    /** A session asked to be shown, from outside the window: put in a cell and selected once; `at` tells a new ask from one done. */
+    reveal: {
+        sessionId: string;
+        at: number;
+    } | null;
+    /** Ended sessions, put away: how many, and the rows themselves only while the window has the archive open, newest first. */
+    archive: {
+        count: number;
+        rows: SessionRow[] | null;
+    };
+    /** The sidebar folded to a strip, as this project's window was left. */
+    folded: boolean;
 }
 /** What the window asks for. */
 export type WindowMessage = {
@@ -130,6 +153,14 @@ export type WindowMessage = {
 } | {
     type: "autoPlace";
     on: boolean;
+}
+/** The archive opened or closed: its rows come with the state while it is open. */
+ | {
+    type: "archive";
+    open: boolean;
+} | {
+    type: "fold";
+    folded: boolean;
 } | {
     type: "detach";
     cell: string;
@@ -178,6 +209,10 @@ export type WindowMessage = {
 } | {
     type: "switchTerminal";
     switch: boolean;
+}
+/** Start herdr's server again after it would not come up. */
+ | {
+    type: "startHerdr";
 } | {
     type: "refresh";
 };
@@ -194,6 +229,11 @@ export type WindowPost = {
     type: "closed";
     cell: string;
     reason: string | null;
+}
+/** herdr's server is back: attach the cell's pane again. */
+ | {
+    type: "reattach";
+    cell: string;
 } | {
     type: "toast";
     text: string;

package/dist/words.d.ts

@@ -3,7 +3,7 @@ export declare const CODE_SESSIONS_WORDS: import("@tomradex/domain").WordBook<{
     readonly open: "Open terminal";
     readonly group: "Code link";
     readonly sidebar: "Terminal";
-    readonly windowTitle: "Terminal — {{project}}";
+    readonly windowTitle: "{{project}} — Terminal";
     readonly openProject: "Open a project first";
     readonly noTerminal: "This session has no herdr terminal on this computer";
     readonly noTicket: "This session has no ticket";
@@ -19,5 +19,6 @@ export declare const CODE_SESSIONS_WORDS: import("@tomradex/domain").WordBook<{
     readonly switchFailed: "Could not bring {{app}} forward";
     readonly openedOutside: "Opened in {{app}}. An agent you start there shows up here as a session";
     readonly outsideFailed: "Could not open a terminal: {{reason}}";
+    readonly herdrRestarting: "herdr's server stopped — starting it again, this terminal comes back on its own";
 }>;
 //# sourceMappingURL=words.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomradex/code-sessions",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "type": "module",
   "author": "Haoyuan Tang",
   "engines": {
@@ -27,14 +27,14 @@
     "dist"
   ],
   "dependencies": {
-    "@tomradex/code-link": "0.15.0",
-    "@tomradex/contributions": "0.15.0",
-    "@tomradex/db": "0.15.0",
-    "@tomradex/desktop-surface": "0.15.0",
+    "@tomradex/code-link": "0.16.0",
+    "@tomradex/contributions": "0.16.0",
+    "@tomradex/db": "0.16.0",
+    "@tomradex/desktop-surface": "0.16.0",
     "@tomradex/domain": "0.2.18",
-    "@tomradex/herdr": "0.15.0",
-    "@tomradex/items": "0.15.0",
-    "@tomradex/settings": "0.15.0",
+    "@tomradex/herdr": "0.16.0",
+    "@tomradex/items": "0.16.0",
+    "@tomradex/settings": "0.16.0",
     "cordis": "4.0.0-rc.8",
     "zod": "^4.4.3"
   }