@tomradex/code-sessions 0.16.2 → 0.17.0

package/dist/drop.d.ts

@@ -11,9 +11,16 @@ export declare function droppedPaste(paths: readonly string[]): string | null;
  * 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;
+export declare const PRIVATE_COPY_MAX: number;
+/**
+ * The folders macOS keeps to the apps the person allowed and to the app a file from them was dropped on (Tomrade).
+ * A terminal's programs count as whichever app started herdr, often neither. None off macOS.
+ */
+export declare function privateFolders(home?: string | null): string[];
 /**
  * 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.
+ * its own name, into a new folder in `into` — anything held for a drop, and from a private folder a file up to
+ * PRIVATE_COPY_MAX. One that cannot be copied, and a folder or bigger file from a private folder, keeps its own path.
  */
-export declare function readableDrops(paths: readonly string[], into: string, tmp?: string): Promise<string[]>;
+export declare function readableDrops(paths: readonly string[], into: string, tmp?: string, folders?: string[]): Promise<string[]>;
 //# sourceMappingURL=drop.d.ts.map

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
 import type { Context } from "cordis";
 import { z } from "zod";
 import { type CodeLink } from "@tomradex/code-link";
-import type { Layout, SessionRow } from "./protocol.js";
+import type { Layout, SessionRow, TerminalRow } from "./protocol.js";
 export type * from "./protocol.js";
 export declare const Config: z.ZodObject<{
     document: z.ZodString;
@@ -29,6 +29,11 @@ export declare function sessionRows(codeLink: Pick<CodeLink, "sessionsOf" | "lin
         title: string;
     } | null | undefined;
 }, projectId: string, now?: number, device?: string, platform?: NodeJS.Platform): SessionRow[];
+/**
+ * The row an ended session's pane goes on as, when it does: a terminal opened here on it, else the newest live session
+ * on it — the agent working another ticket in the same pane. Null once nothing of the window runs there.
+ */
+export declare function continuedIn(pane: string | null, sessions: SessionRow[], terminals: TerminalRow[]): string | null;
 /**
  * A window per project for its code sessions: the list with live status, and
  * their terminals side by side — streamed from herdr's panes through core,

package/dist/protocol.d.ts

@@ -1,4 +1,4 @@
-import type { HerdrBridge, TerminalMouse, TerminalScroll } from "@tomradex/herdr";
+import type { HerdrBridge, HerdrScroll, TerminalMouse, TerminalScroll } from "@tomradex/herdr";
 /** One code session as the window lists it. */
 export interface SessionRow {
     id: string;
@@ -39,6 +39,8 @@ export interface SessionRow {
     startedAt: number;
     /** When it ended; null while it lives. */
     endedAt: number | null;
+    /** Ended while its pane goes on here as another of the window's rows (another ticket of the same agent): that row's id; null otherwise. */
+    continuedIn: string | 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 {
@@ -50,6 +52,8 @@ export interface TerminalRow {
     startedAt: number;
     /** What the agent herdr sees in it calls the conversation; null without one. */
     agentTitle: string | null;
+    /** How herdr reads that agent; null without one, or when herdr cannot tell. */
+    agentStatus: "working" | "blocked" | "idle" | "done" | 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. */
@@ -93,6 +97,8 @@ export interface WindowState {
     /** The app's language, so the window speaks it even before the main window says how it looks. */
     locale: string;
     bridge: HerdrBridge;
+    /** A herdr client of its own runs on this machine: "Show in herdr" has a window to show the pane in. */
+    herdrClient: boolean;
     /** 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. */
@@ -204,7 +210,13 @@ export type WindowMessage = {
 } | ({
     type: "scroll";
     cell: string;
-} & TerminalScroll) | ({
+} & TerminalScroll)
+/** Dragging the cell's scrollbar: its pane's view, this many rows above the bottom of the scrollback. */
+ | {
+    type: "scrollTo";
+    cell: string;
+    offset: number;
+} | ({
     type: "mouse";
     cell: string;
 } & TerminalMouse) | {
@@ -234,6 +246,11 @@ export type WindowMessage = {
     type: "install";
 } | {
     type: "openGuide";
+}
+/** A link clicked in a terminal: opened in the system browser. */
+ | {
+    type: "openLink";
+    url: string;
 } | {
     type: "switchTerminal";
     switch: boolean;
@@ -258,6 +275,11 @@ export type WindowPost = {
     cell: string;
     reason: string | null;
 }
+/** Where the cell's pane is in its scrollback, in rows, for its scrollbar. */
+ | ({
+    type: "scrolled";
+    cell: string;
+} & HerdrScroll)
 /** herdr's server is back: attach the cell's pane again. */
  | {
     type: "reattach";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomradex/code-sessions",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "type": "module",
   "author": "Haoyuan Tang",
   "engines": {
@@ -27,14 +27,15 @@
     "dist"
   ],
   "dependencies": {
-    "@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.2",
-    "@tomradex/items": "0.16.2",
-    "@tomradex/settings": "0.16.2",
+    "@tomradex/code-link": "0.17.0",
+    "@tomradex/contracts": "0.17.0",
+    "@tomradex/contributions": "0.17.0",
+    "@tomradex/db": "0.17.0",
+    "@tomradex/desktop-surface": "0.17.0",
+    "@tomradex/domain": "0.2.24",
+    "@tomradex/herdr": "0.17.0",
+    "@tomradex/items": "0.17.0",
+    "@tomradex/settings": "0.17.0",
     "cordis": "4.0.0-rc.8",
     "zod": "^4.4.3"
   }