@paradow/ledge 0.4.0 → 0.5.0

package/dist/cli/{chunk-YT4T7DL2.js → chunk-Y4ODVTTN.js}

@@ -1,5 +1,5 @@
 // ../protocol/src/messages.ts
-import { z as z4 } from "zod";
+import { z as z7 } from "zod";
 
 // ../protocol/src/session.ts
 import { z } from "zod";
@@ -10,6 +10,8 @@ var PendingSchema = z.object({
   text: z.string(),
   tool: z.string().optional(),
   options: z.array(z.string()).optional(),
+  /** Each option's description, by index ('' when it has none); left out when no option has one. */
+  optionDetails: z.array(z.string()).optional(),
   source: z.enum(["hook", "pane"]),
   /** Set when the request comes from a helper (subagent): it is routed through its parent. */
   helperId: z.string().optional(),
@@ -28,6 +30,10 @@ var HelperSchema = z.object({
 });
 var TopicSourceSchema = z.enum(["user", "pane", "prompt"]);
 var SessionSchema = z.object({
+  /** Origin is annotated by the overlay, never used as an unqualified session id on the wire. */
+  machineId: z.string().optional(),
+  machineName: z.string().optional(),
+  repoId: z.string().optional(),
   id: z.string().min(1),
   name: z.string().min(1),
   tool: ToolSchema,
@@ -82,6 +88,9 @@ var ChatRelaySchema = z2.object({
   error: z2.string().optional()
 });
 var ChatTurnSchema = z2.object({
+  machineId: z2.string().optional(),
+  machineName: z2.string().optional(),
+  choices: z2.array(z2.object({ id: z2.string(), label: z2.string() })).optional(),
   qid: z2.string().min(1),
   question: z2.string(),
   askedAt: z2.string().datetime(),
@@ -102,6 +111,7 @@ var DocumentReadSchema = z3.object({
   type: z3.literal("document.read"),
   requestId,
   path,
+  machineId: z3.string().optional(),
   sessionId: z3.string().min(1).optional(),
   basePath: path.optional()
 });
@@ -132,90 +142,152 @@ var DocumentErrorSchema = z3.object({
   code: DocumentErrorCodeSchema
 });
 
+// ../protocol/src/routing.ts
+import { z as z4 } from "zod";
+var MachineInventorySchema = z4.object({
+  id: z4.string().min(1).max(80),
+  label: z4.string().min(1).max(120),
+  online: z4.boolean(),
+  local: z4.boolean(),
+  sessions: z4.array(z4.object({ id: z4.string(), name: z4.string(), project: z4.string(), cwd: z4.string(), topic: z4.string().optional(), state: z4.string(), readOnly: z4.boolean() })).max(500),
+  folders: z4.array(z4.object({ project: z4.string(), cwd: z4.string() })).max(100)
+});
+var RoutingContextSchema = z4.object({
+  machines: z4.array(MachineInventorySchema).min(1).max(20),
+  history: z4.array(z4.object({ question: z4.string().max(2e4), answer: z4.string().max(2e4).optional(), machineId: z4.string().optional() })).max(50)
+});
+var RouteResultSchema = z4.object({
+  /** Null means an answer or a clarification, never an implicit local destination. */
+  machineId: z4.string().nullable(),
+  text: z4.string().min(1).max(2e4),
+  choices: z4.array(z4.string()).max(20).optional()
+});
+
+// ../protocol/src/ssh.ts
+import { z as z5 } from "zod";
+var SshAliasSchema = z5.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$/);
+
+// ../protocol/src/thread.ts
+import { z as z6 } from "zod";
+var ToolStatusSchema = z6.enum(["running", "success", "failed", "unknown"]);
+var FileChangeSchema = z6.object({ path: z6.string().min(1), change: z6.enum(["add", "edit", "delete", "write"]), diff: z6.string().optional() });
+var base = { id: z6.string().min(1), at: z6.string().datetime(), turn: z6.number().int().nonnegative(), helperId: z6.string().optional() };
+var ThreadItemSchema = z6.discriminatedUnion("kind", [
+  z6.object({ kind: z6.literal("prompt"), ...base, text: z6.string() }),
+  z6.object({ kind: z6.literal("message"), ...base, text: z6.string() }),
+  /** `id` is the harness's tool_use_id when it gives one, so the result updates the same row. */
+  z6.object({ kind: z6.literal("tool"), ...base, tool: z6.string(), label: z6.string(), input: z6.string().optional(), output: z6.string().optional(), error: z6.string().optional(), status: ToolStatusSchema, durationMs: z6.number().nonnegative().optional(), files: z6.array(FileChangeSchema).default([]) }),
+  /** `unknown`: answered in the terminal, the daemon only saw the prompt go away. */
+  z6.object({ kind: z6.literal("permission"), ...base, tool: z6.string(), text: z6.string(), decision: z6.enum(["accept", "deny", "unknown"]).optional() }),
+  z6.object({ kind: z6.literal("reply"), ...base, text: z6.string() }),
+  z6.object({ kind: z6.literal("helper"), ...base, task: z6.string(), agentType: z6.string().optional(), state: z6.enum(["working", "exited"]) })
+]);
+
 // ../protocol/src/messages.ts
 var PROTOCOL_PORT = 47831;
-var SessionEventSchema = z4.object({
-  name: z4.enum(["SessionStart", "UserPromptSubmit", "PreToolUse", "PermissionRequest", "Notification", "Stop", "SessionEnd", "PaneChanged", "PaneGone", "PanePrompt", "PaneIdle", "InjectFailed", "Decided", "PostToolUse", "PostToolUseFailure", "StopFailure", "SubagentStart", "SubagentStop", "PaneTitle", "Renamed"]),
-  at: z4.string().datetime(),
-  source: z4.enum(["hook", "pane", "daemon"]),
-  tool: z4.string().optional(),
-  text: z4.string().optional(),
-  options: z4.array(z4.string()).optional(),
-  kind: z4.enum(["question", "permission", "plan", "diff"]).optional(),
-  exitCode: z4.number().int().nullable().optional(),
-  helperId: z4.string().optional(),
+var SessionEventSchema = z7.object({
+  name: z7.enum(["SessionStart", "UserPromptSubmit", "PreToolUse", "PermissionRequest", "Notification", "Stop", "SessionEnd", "PaneChanged", "PaneGone", "PanePrompt", "PaneIdle", "InjectFailed", "Decided", "PostToolUse", "PostToolUseFailure", "StopFailure", "SubagentStart", "SubagentStop", "PaneTitle", "Renamed"]),
+  at: z7.string().datetime(),
+  source: z7.enum(["hook", "pane", "daemon"]),
+  tool: z7.string().optional(),
+  text: z7.string().optional(),
+  options: z7.array(z7.string()).optional(),
+  /** Each option's description, by index ('' when it has none); left out when no option has one. */
+  optionDetails: z7.array(z7.string()).optional(),
+  kind: z7.enum(["question", "permission", "plan", "diff"]).optional(),
+  exitCode: z7.number().int().nullable().optional(),
+  helperId: z7.string().optional(),
   /** The helper's description, once known (Claude Code: its `.meta.json`, written after SubagentStart). */
-  task: z4.string().optional(),
+  task: z7.string().optional(),
   /** PostToolUseFailure: the user interrupted the turn (Esc); Claude then waits for input with no Stop. */
-  interrupt: z4.boolean().optional()
+  interrupt: z7.boolean().optional(),
+  /** Native tracking (spec 2026-10-13 §2): the harness's id of the tool call, so its result lands on the same row. */
+  toolUseId: z7.string().optional(),
+  /** The tool's input as the harness gave it, every string capped by the hook. */
+  toolInput: z7.record(z7.string(), z7.unknown()).optional(),
+  /** PostToolUse: the result as text; SubagentStop: nothing (the report travels in `text`). */
+  output: z7.string().optional(),
+  durationMs: z7.number().nonnegative().optional(),
+  /** PostToolUseFailure: the harness's error message. */
+  error: z7.string().optional(),
+  /** The session's transcript, or the helper's on SubagentStop; the daemon reads its tail for the agent's messages. */
+  transcriptPath: z7.string().optional(),
+  /** Decided: what was chosen when the daemon knows it. */
+  decision: z7.enum(["accept", "deny"]).optional()
 });
-var RecentSchema = z4.object({ cwd: z4.string().min(1), project: z4.string().min(1), lastAt: z4.string().datetime() });
+var RecentSchema = z7.object({ cwd: z7.string().min(1), project: z7.string().min(1), lastAt: z7.string().datetime() });
 var SEMVER = /^\d+\.\d+\.\d+$/;
-var DaemonInfoSchema = z4.object({ version: z4.string(), install: z4.enum(["npm", "git", "unknown"]), systemd: z4.boolean(), manual: z4.string().optional() });
-var UpdateFailureSchema = z4.enum(["git-install", "no-systemd", "sessions-at-risk", "npm-failed", "busy"]);
-var ServerMessageSchema = z4.discriminatedUnion("type", [
+var DaemonInfoSchema = z7.object({ version: z7.string(), install: z7.enum(["npm", "git", "unknown"]), systemd: z7.boolean(), manual: z7.string().optional(), routing: z7.boolean().optional() });
+var UpdateFailureSchema = z7.enum(["git-install", "no-systemd", "sessions-at-risk", "npm-failed", "busy"]);
+var ServerMessageSchema = z7.discriminatedUnion("type", [
+  z7.object({ type: z7.literal("chat.routed"), qid: z7.string(), result: RouteResultSchema }),
   DocumentContentSchema,
   DocumentErrorSchema,
   /** `recents`: the folders of past sessions, most recent first. `launcher`: the command that runs `ledge` inside WSL
    *  (`[node, cli]`), so the overlay can attach a terminal to a session with `<launcher> attach <id>`. `daemon`: absent
    *  from daemons older than the auto-update. */
-  z4.object({ type: z4.literal("snapshot"), sessions: z4.array(SessionSchema), recents: z4.array(RecentSchema).optional(), launcher: z4.array(z4.string()).optional(), daemon: DaemonInfoSchema.optional() }),
-  z4.object({ type: z4.literal("session.updated"), session: SessionSchema }),
-  z4.object({ type: z4.literal("session.removed"), id: z4.string() }),
-  z4.object({ type: z4.literal("session.preview"), id: z4.string(), lines: z4.array(z4.string()) }),
+  z7.object({ type: z7.literal("snapshot"), sessions: z7.array(SessionSchema), recents: z7.array(RecentSchema).optional(), launcher: z7.array(z7.string()).optional(), daemon: DaemonInfoSchema.optional(), sshAlias: SshAliasSchema.optional() }),
+  z7.object({ type: z7.literal("session.updated"), session: SessionSchema }),
+  z7.object({ type: z7.literal("session.removed"), id: z7.string() }),
+  z7.object({ type: z7.literal("session.preview"), id: z7.string(), lines: z7.array(z7.string()) }),
+  /** A session's thread, on request (spec 2026-10-13 §5); then each created or updated item, broadcast. */
+  z7.object({ type: z7.literal("session.thread"), id: z7.string(), items: z7.array(ThreadItemSchema) }),
+  z7.object({ type: z7.literal("session.thread.item"), id: z7.string(), item: ThreadItemSchema }),
   /** Answer to the requester of a `session.launch`: the session exists (its `session.updated` is broadcast as usual). */
-  z4.object({ type: z4.literal("session.launched"), id: z4.string() }),
-  z4.object({ type: z4.literal("recents"), recents: z4.array(RecentSchema) }),
+  z7.object({ type: z7.literal("session.launched"), id: z7.string() }),
+  z7.object({ type: z7.literal("recents"), recents: z7.array(RecentSchema) }),
   /** Answer to the requester of a `folder.list` or `folder.create`: `path` resolved (`~` expanded), `parent` null at the
    *  root, `entries` its subfolders by name (hidden ones left out). A failure keeps the asked path and says why in `error`,
    *  never in an `error` message, which the launch form reads as a failed launch. */
-  z4.object({ type: z4.literal("folder.listing"), path: z4.string(), parent: z4.string().nullable(), entries: z4.array(z4.string()), error: z4.string().optional() }),
+  z7.object({ type: z7.literal("folder.listing"), path: z7.string(), parent: z7.string().nullable(), entries: z7.array(z7.string()), error: z7.string().optional() }),
   /** The chat (spec 2026-10-11 §5): what Ledge reads, its words as they come, the final text, or why it stopped; the day's turns after each snapshot. */
-  z4.object({ type: z4.literal("chat.step"), qid: z4.string(), step: ChatStepSchema }),
-  z4.object({ type: z4.literal("chat.delta"), qid: z4.string(), text: z4.string() }),
-  z4.object({ type: z4.literal("chat.done"), qid: z4.string(), text: z4.string(), at: z4.string().datetime(), proposal: ChatProposalSchema.optional(), relay: ChatRelaySchema.optional() }),
-  z4.object({ type: z4.literal("chat.error"), qid: z4.string(), message: z4.string() }),
-  z4.object({ type: z4.literal("chat.history"), turns: z4.array(ChatTurnSchema) }),
+  z7.object({ type: z7.literal("chat.step"), qid: z7.string(), step: ChatStepSchema }),
+  z7.object({ type: z7.literal("chat.delta"), qid: z7.string(), text: z7.string() }),
+  z7.object({ type: z7.literal("chat.done"), qid: z7.string(), text: z7.string(), at: z7.string().datetime(), proposal: ChatProposalSchema.optional(), relay: ChatRelaySchema.optional() }),
+  z7.object({ type: z7.literal("chat.error"), qid: z7.string(), message: z7.string() }),
+  z7.object({ type: z7.literal("chat.history"), turns: z7.array(ChatTurnSchema) }),
   /** The daemon updating itself: npm is running, then the service restarts (the socket closes right after). */
-  z4.object({ type: z4.literal("update.progress"), version: z4.string(), step: z4.enum(["installing", "restarting"]) }),
+  z7.object({ type: z7.literal("update.progress"), version: z7.string(), step: z7.enum(["installing", "restarting"]) }),
   /** Nothing was changed. `detail`: the useful end of npm's output; `command`: what the person can run instead. */
-  z4.object({ type: z4.literal("update.failed"), version: z4.string(), reason: UpdateFailureSchema, detail: z4.string().optional(), command: z4.string().optional() }),
-  z4.object({ type: z4.literal("error"), message: z4.string(), id: z4.string().optional() })
+  z7.object({ type: z7.literal("update.failed"), version: z7.string(), reason: UpdateFailureSchema, detail: z7.string().optional(), command: z7.string().optional() }),
+  z7.object({ type: z7.literal("error"), message: z7.string(), id: z7.string().optional() })
 ]);
-var ClientMessageSchema = z4.discriminatedUnion("type", [
+var ClientMessageSchema = z7.discriminatedUnion("type", [
+  z7.object({ type: z7.literal("chat.route"), qid: z7.string().min(1).max(100), text: z7.string().min(1).max(2e4), tool: ToolSchema.optional(), context: RoutingContextSchema }),
   DocumentReadSchema,
   /** The overlay starts a session: `cwd` is a WSL path (`~` allowed), `name` a preferred bot name (the daemon picks a
    *  free one otherwise), `prompt` the agent's first instruction, `continue` resumes the folder's last conversation.
    *  With `qid` it is the chat card of that turn: the daemon launches the turn's proposal and ignores the other fields. */
-  z4.object({ type: z4.literal("session.launch"), tool: ToolSchema, cwd: z4.string().min(1), name: z4.string().optional(), prompt: z4.string().optional(), continue: z4.boolean().optional(), qid: z4.string().min(1).optional() }),
+  z7.object({ type: z7.literal("session.launch"), tool: ToolSchema, cwd: z7.string().min(1), name: z7.string().optional(), prompt: z7.string().optional(), continue: z7.boolean().optional(), qid: z7.string().min(1).optional() }),
   /** The launch form's folder browser: list a folder's subfolders (home when no `path`), or make `name` inside `parent`
    *  and list it. Both are answered with a `folder.listing`. */
-  z4.object({ type: z4.literal("folder.list"), path: z4.string().optional() }),
-  z4.object({ type: z4.literal("folder.create"), parent: z4.string().min(1), name: z4.string().min(1) }),
-  z4.object({ type: z4.literal("session.reply"), id: z4.string(), text: z4.string().min(1) }),
+  z7.object({ type: z7.literal("folder.list"), path: z7.string().optional() }),
+  z7.object({ type: z7.literal("folder.create"), parent: z7.string().min(1), name: z7.string().min(1) }),
+  z7.object({ type: z7.literal("session.reply"), id: z7.string(), text: z7.string().min(1) }),
   /** The chat card's instruction (spec 2026-10-12 relay §4): sent now if the session is free, else queued until it is. */
-  z4.object({ type: z4.literal("session.relay"), qid: z4.string().min(1) }),
+  z7.object({ type: z7.literal("session.relay"), qid: z7.string().min(1) }),
   /** Takes the card's queued instruction back out of the queue. */
-  z4.object({ type: z4.literal("session.relay.cancel"), qid: z4.string().min(1) }),
-  z4.object({ type: z4.literal("session.decide"), id: z4.string(), decision: z4.enum(["accept", "deny"]) }),
-  z4.object({ type: z4.literal("session.focus"), id: z4.string() }),
-  z4.object({ type: z4.literal("session.kill"), id: z4.string() }),
-  z4.object({ type: z4.literal("session.interrupt"), id: z4.string() }),
+  z7.object({ type: z7.literal("session.relay.cancel"), qid: z7.string().min(1) }),
+  z7.object({ type: z7.literal("session.decide"), id: z7.string(), decision: z7.enum(["accept", "deny"]) }),
+  z7.object({ type: z7.literal("session.focus"), id: z7.string() }),
+  z7.object({ type: z7.literal("session.kill"), id: z7.string() }),
+  z7.object({ type: z7.literal("session.interrupt"), id: z7.string() }),
   /** Removes a finished (exited) or read-only (hook_only) session from the list; refused for a live launcher session. */
-  z4.object({ type: z4.literal("session.dismiss"), id: z4.string() }),
+  z7.object({ type: z7.literal("session.dismiss"), id: z7.string() }),
   /** The user names the session's topic from the overlay (500 characters at most, the hook's prompt cap); an empty topic hands back to the automatic sources. */
-  z4.object({ type: z4.literal("session.rename"), id: z4.string(), topic: z4.string().max(500) }),
-  z4.object({ type: z4.literal("session.register"), session: SessionSchema }),
+  z7.object({ type: z7.literal("session.rename"), id: z7.string(), topic: z7.string().max(500) }),
+  z7.object({ type: z7.literal("session.thread"), id: z7.string() }),
+  z7.object({ type: z7.literal("session.register"), session: SessionSchema }),
   /** `agent` and `cwd` describe the session when the daemon does not know it yet (a hook from an agent started without ledge). */
-  z4.object({ type: z4.literal("session.event"), id: z4.string(), event: SessionEventSchema, agent: ToolSchema.optional(), cwd: z4.string().optional() }),
-  z4.object({ type: z4.literal("session.unregister"), id: z4.string(), exitCode: z4.number().int().nullable() }),
-  z4.object({ type: z4.literal("snapshot.request") }),
-  z4.object({ type: z4.literal("chat.ask"), qid: z4.string().min(1), text: z4.string().min(1), tool: ToolSchema.optional() }),
-  z4.object({ type: z4.literal("chat.cancel"), qid: z4.string().min(1) }),
+  z7.object({ type: z7.literal("session.event"), id: z7.string(), event: SessionEventSchema, agent: ToolSchema.optional(), cwd: z7.string().optional() }),
+  z7.object({ type: z7.literal("session.unregister"), id: z7.string(), exitCode: z7.number().int().nullable() }),
+  z7.object({ type: z7.literal("snapshot.request") }),
+  z7.object({ type: z7.literal("chat.ask"), qid: z7.string().min(1), text: z7.string().min(1), tool: ToolSchema.optional() }),
+  z7.object({ type: z7.literal("chat.cancel"), qid: z7.string().min(1) }),
   /** Starts a new conversation with Ledge: the day's turns are cleared and the next question opens a new harness session. */
-  z4.object({ type: z4.literal("chat.reset") }),
+  z7.object({ type: z7.literal("chat.reset") }),
   /** Installs `@paradow/ledge@version` and restarts the service (spec 2026-10-12 auto-update §6). */
-  z4.object({ type: z4.literal("update.daemon"), version: z4.string().regex(SEMVER) })
+  z7.object({ type: z7.literal("update.daemon"), version: z7.string().regex(SEMVER) })
 ]);
 function parseClientMessage(raw) {
   return ClientMessageSchema.parse(raw);
@@ -297,9 +369,9 @@ function pickName(taken, preferred) {
   const free = (n) => !used.has(n);
   const wanted = preferred?.trim();
   if (wanted) {
-    const base = cap(wanted);
-    if (free(base)) return base;
-    for (let i = 2; ; i++) if (free(`${base}-${i}`)) return `${base}-${i}`;
+    const base2 = cap(wanted);
+    if (free(base2)) return base2;
+    for (let i = 2; ; i++) if (free(`${base2}-${i}`)) return `${base2}-${i}`;
   }
   const first = NAMES.find(free);
   if (first) return first;
@@ -307,9 +379,9 @@ function pickName(taken, preferred) {
 }
 
 // ../protocol/src/proposal.ts
-import { z as z5 } from "zod";
-var ProposalBlockSchema = z5.object({ cwd: z5.string().trim().min(1), prompt: z5.string().optional() });
-var RelayBlockSchema = z5.object({ session: z5.string().trim().min(1), text: z5.string().trim().min(1) });
+import { z as z8 } from "zod";
+var ProposalBlockSchema = z8.object({ cwd: z8.string().trim().min(1), prompt: z8.string().optional() });
+var RelayBlockSchema = z8.object({ session: z8.string().trim().min(1), text: z8.string().trim().min(1) });
 var BLOCK = /```ledge-(session|relay)[ \t]*\n?([\s\S]*?)(?:```|$)/g;
 function extractProposal(answer) {
   const found = [];
@@ -351,6 +423,8 @@ function sessionTitle(s) {
 export {
   SessionSchema,
   DOCUMENT_MAX_BYTES,
+  RouteResultSchema,
+  SshAliasSchema,
   PROTOCOL_PORT,
   RecentSchema,
   parseClientMessage,