@tomradex/code-sessions 0.15.1 → 0.16.1

package/dist/drop.d.ts

@@ -0,0 +1,19 @@
+/** A path as Terminal.app types a dropped file: a backslash before blanks and the shell's special characters. */
+export declare function shellEscape(file: string): string;
+/**
+ * What a drop of files types into a terminal: their paths, escaped, one space apart and one after,
+ * as a bracketed paste (herdr drops the markers for a program that did not ask for them). Null when
+ * no file had a path on disk.
+ */
+export declare function droppedPaste(paths: readonly string[]): string | null;
+/**
+ * Whether a dropped file sits in the temp folder's TemporaryItems, where macOS keeps what is dragged out of a
+ * screenshot's thumbnail: only the app it was dropped on may read it there, not the programs in its terminals.
+ */
+export declare const heldForDrop: (file: string, tmp?: string) => boolean;
+/**
+ * The dropped paths as a terminal's programs can read them: each file held for Tomrade alone is copied, under
+ * its own name, into a new folder in `into`; one that cannot be copied keeps its own path.
+ */
+export declare function readableDrops(paths: readonly string[], into: string, tmp?: string): Promise<string[]>;
+//# sourceMappingURL=drop.d.ts.map

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

@@ -13,6 +13,18 @@ export interface SessionRow {
     activity: string | null;
     mode: "run" | "terminal";
     agent: string;
+    /** The agent's own name (Claude Code, Codex…), for a session with no ticket to go by; null when Tomrade does not know it. */
+    agentName: string | null;
+    /** What the agent herdr sees in the session's pane calls the conversation; null without one, or when a terminal row speaks for it. */
+    agentTitle: string | null;
+    /** What the conversation was called, kept after it ended: the agent's title, its pane's, or its first prompt. */
+    conversation: string | null;
+    /** The folder the agent ran in, as its hooks said. */
+    cwd: string | null;
+    /** Someone spoke to it. */
+    prompted: boolean;
+    /** Its agent can take it up again by its id in a new terminal. */
+    resumable: boolean;
     /** The herdr pane it runs in, on this machine; null when it has no terminal here. */
     pane: string | null;
     /** Where its terminal is: a herdr pane here, another terminal app here, another computer, or Tomrade running it. */
@@ -25,6 +37,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 +48,10 @@ 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;
+    /** With no agent in it: what runs in its foreground when that is not the shell, else the title its shell set. */
+    running: 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 +69,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,7 +83,10 @@ 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;
@@ -98,6 +121,13 @@ export interface WindowState {
         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 = {
@@ -108,10 +138,18 @@ export type WindowMessage = {
     rows: number;
 }
 /** The window names the new terminal's id, so its cell shows it before herdr has opened it. */
+/** The ended session a cell shows: its conversation, read from its agent's own record. */
+ | {
+    type: "conversation";
+    cell: string;
+    sessionId: string;
+}
+/** `resume`: a conversation's session, taken up again in the new terminal by its agent. */
  | {
     type: "newTerminal";
     terminalId: string;
     cwd: string | null;
+    resume?: string;
 } | {
     type: "closeTerminal";
     terminalId: string;
@@ -137,6 +175,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;
@@ -144,6 +190,12 @@ export type WindowMessage = {
     type: "input";
     cell: string;
     data: string;
+}
+/** Files dropped onto a cell's terminal, by their paths on disk: typed into it as a paste. */
+ | {
+    type: "drop";
+    cell: string;
+    paths: string[];
 } | {
     type: "resize";
     cell: string;
@@ -210,6 +262,23 @@ export type WindowPost = {
  | {
     type: "reattach";
     cell: string;
+}
+/** A session's conversation, read-only; `lines` null when its agent's record cannot be read. */
+ | {
+    type: "conversation";
+    cell: string;
+    sessionId: string;
+    lines: {
+        who: "person" | "agent" | "tool";
+        text: string;
+    }[] | null;
+    cut: boolean;
+}
+/** The pane the cell asked for streams in `other` already: one pane, one cell. */
+ | {
+    type: "shownIn";
+    cell: string;
+    other: 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";

package/package.json

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