@tomradex/code-sessions 0.16.0 → 0.16.2

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

@@ -13,6 +13,8 @@ export type Config = z.infer<typeof Config>;
 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;
+/** The most typing a cell holds while its terminal attaches. */
+export declare const HELD_INPUT_MAX: number;
 /** Whether a stored value is a layout the window can draw. */
 export declare function isLayout(value: unknown): value is Layout;
 /**

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. */
@@ -38,6 +50,8 @@ export interface TerminalRow {
     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. */
@@ -124,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;
@@ -168,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;
@@ -234,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

@@ -20,5 +20,6 @@ export declare const CODE_SESSIONS_WORDS: import("@tomradex/domain").WordBook<{
     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";
+    readonly notSent: "What you typed while the terminal was connecting was not sent";
 }>;
 //# sourceMappingURL=words.d.ts.map

package/package.json

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