@kdonev/termscape 0.1.2 → 0.1.4

package/dist/protocol/inject.d.ts

@@ -19,11 +19,31 @@ export declare function sanitizeMessageBody(text: string): string;
 /** The visible, unspoofable prefix a receiving agent sees. */
 export declare function formatMessage(from: string, text: string): string;
 /**
- * Wire bytes for injecting `body` into a PTY.
+ * The keypress that submits an injected message.
+ *
+ * Deliberately not part of `encodeInjection`, and the split is the whole
+ * point of it. The CR used to be appended to the paste and written in the
+ * same go, on the reasonable-sounding grounds that a terminal sees the paste
+ * end and then an Enter. Agent TUIs do not behave that way: they debounce a
+ * paste - Claude Code among them, and deliberately, so that a pasted block
+ * full of newlines cannot fire off half-written prompts - and anything
+ * arriving inside that window is folded into the pasted text. A CR glued to
+ * the end of the paste therefore became a literal newline in the composer,
+ * and the message sat there fully typed and never sent. From the outside
+ * that looked like an agent messaging another and getting no answer, with
+ * its text plainly visible in the other's terminal.
+ *
+ * So it goes in on its own, once the paste has landed. `PtySession.inject`
+ * owns that timing.
+ */
+export declare const INJECT_SUBMIT = "\r";
+/**
+ * Wire bytes for injecting `body` into a PTY - the message itself, without
+ * the keypress that sends it.
  *
  * Bracketed paste makes a multi-line body arrive as one atomic paste rather
  * than as a line-by-line keystroke stream, so a CLI that reads line-at-a-time
- * does not act on a half-delivered message. The trailing CR submits it.
+ * does not act on a half-delivered message. `INJECT_SUBMIT` follows separately.
  */
 export declare function encodeInjection(body: string, mode: InjectMode): string;
 //# sourceMappingURL=inject.d.ts.map

package/dist/protocol/inject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,WAAW,gBAAc,CAAC;AACvC,eAAO,MAAM,SAAS,gBAAc,CAAC;AAErC,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,KAAK,CAAC;AAE7C,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAItE"}
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,WAAW,gBAAc,CAAC;AACvC,eAAO,MAAM,SAAS,gBAAc,CAAC;AAErC,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,KAAK,CAAC;AAE7C,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAItE"}

package/dist/protocol/inject.js

@@ -25,16 +25,36 @@ export function formatMessage(from, text) {
     return `[from ${from}] ${sanitizeMessageBody(text)}`;
 }
 /**
- * Wire bytes for injecting `body` into a PTY.
+ * The keypress that submits an injected message.
+ *
+ * Deliberately not part of `encodeInjection`, and the split is the whole
+ * point of it. The CR used to be appended to the paste and written in the
+ * same go, on the reasonable-sounding grounds that a terminal sees the paste
+ * end and then an Enter. Agent TUIs do not behave that way: they debounce a
+ * paste - Claude Code among them, and deliberately, so that a pasted block
+ * full of newlines cannot fire off half-written prompts - and anything
+ * arriving inside that window is folded into the pasted text. A CR glued to
+ * the end of the paste therefore became a literal newline in the composer,
+ * and the message sat there fully typed and never sent. From the outside
+ * that looked like an agent messaging another and getting no answer, with
+ * its text plainly visible in the other's terminal.
+ *
+ * So it goes in on its own, once the paste has landed. `PtySession.inject`
+ * owns that timing.
+ */
+export const INJECT_SUBMIT = '\r';
+/**
+ * Wire bytes for injecting `body` into a PTY - the message itself, without
+ * the keypress that sends it.
  *
  * Bracketed paste makes a multi-line body arrive as one atomic paste rather
  * than as a line-by-line keystroke stream, so a CLI that reads line-at-a-time
- * does not act on a half-delivered message. The trailing CR submits it.
+ * does not act on a half-delivered message. `INJECT_SUBMIT` follows separately.
  */
 export function encodeInjection(body, mode) {
     const clean = sanitizeMessageBody(body);
     if (mode === 'raw')
-        return `${clean}\r`;
-    return `${PASTE_START}${clean}${PASTE_END}\r`;
+        return clean;
+    return `${PASTE_START}${clean}${PASTE_END}`;
 }
 //# sourceMappingURL=inject.js.map

package/dist/protocol/inject.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject.js","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AAIrC,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI;SACR,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,0CAA0C;SAC/D,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,4CAA4C;SACpE,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;AAC7E,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IACtD,OAAO,SAAS,IAAI,KAAK,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAgB;IAC5D,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACxC,OAAO,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,IAAI,CAAC;AAChD,CAAC"}
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AAIrC,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI;SACR,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,0CAA0C;SAC/D,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,4CAA4C;SACpE,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;AAC7E,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IACtD,OAAO,SAAS,IAAI,KAAK,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAgB;IAC5D,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;AAC9C,CAAC"}

package/dist/protocol/mcp-tools.d.ts

@@ -27,9 +27,12 @@ export declare const SendMessageInput: z.ZodObject<{
 export declare const SpawnAgentInput: z.ZodObject<{
     profile: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
     workspace: z.ZodOptional<z.ZodString>;
     prompt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** No input: list_hosts always reports the whole canvas from wherever it is called. */
+export declare const ListHostsInput: z.ZodObject<{}, z.core.$strip>;
 export declare const ReadScreenInput: z.ZodObject<{
     address: z.ZodString;
     lines: z.ZodOptional<z.ZodNumber>;
@@ -62,6 +65,7 @@ export declare const ProposeTemplateInput: z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type WhoamiInput = z.infer<typeof WhoamiInput>;
+export type ListHostsInput = z.infer<typeof ListHostsInput>;
 export type ListAgentsInput = z.infer<typeof ListAgentsInput>;
 export type ListTemplatesInput = z.infer<typeof ListTemplatesInput>;
 export type SendMessageInput = z.infer<typeof SendMessageInput>;

package/dist/protocol/mcp-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,eAAO,MAAM,WAAW,gCAAe,CAAC;AAExC,eAAO,MAAM,eAAe;;iBAK1B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;iBAK7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;iBAK3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;iBAW1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,eAAO,MAAM,cAAc;;iBAEzB,CAAC;AAEH,eAAO,MAAM,cAAc;;iBAEzB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB;;;;;;;iBA4B/B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB;;;CAAyC,CAAC;AACzE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC"}
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,eAAO,MAAM,WAAW,gCAAe,CAAC;AAExC,eAAO,MAAM,eAAe;;iBAK1B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;iBAK7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;iBAY3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;iBAsB1B,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,cAAc,gCAAe,CAAC;AAE3C,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,eAAO,MAAM,cAAc;;iBAEzB,CAAC;AAEH,eAAO,MAAM,cAAc;;iBAEzB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB;;;;;;;iBA4B/B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB;;;CAAyC,CAAC;AACzE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC"}

package/dist/protocol/mcp-tools.js

@@ -30,20 +30,34 @@ export const SendMessageInput = z.object({
     to: z
         .string()
         .describe('Target agent address, "workspace/name". Use list_agents to discover.'),
-    text: z.string().min(1).max(8000).describe('Message body, injected into the target terminal.'),
+    text: z
+        .string()
+        .min(1)
+        .max(8000)
+        .describe('Message body, injected into the target terminal. If you need an answer, ask for ' +
+        'one here — say to reply with send_message — then end your turn and let it arrive.'),
 });
 export const SpawnAgentInput = z.object({
     profile: z.string().optional().describe('Agent profile id. Defaults to your own profile.'),
     name: z.string().optional().describe('Name for the new agent. Auto-generated if omitted.'),
+    host: z
+        .string()
+        .optional()
+        .describe('Machine to start it on, by the label list_hosts gives. The machine that ' +
+        'owns the canvas is called "canvas"; "local" always means your own. ' +
+        'Defaults to your own machine.'),
     workspace: z
         .string()
         .optional()
-        .describe('Workspace to spawn into. Defaults to your own workspace.'),
+        .describe('Workspace to spawn into. Defaults to your own workspace if it exists on the ' +
+        'target machine, else the only workspace there.'),
     prompt: z
         .string()
         .optional()
         .describe('First instruction, injected once the new agent is ready.'),
 });
+/** No input: list_hosts always reports the whole canvas from wherever it is called. */
+export const ListHostsInput = z.object({});
 export const ReadScreenInput = z.object({
     address: z.string().describe('Agent address to inspect.'),
     lines: z.number().int().positive().max(200).optional().describe('Trailing lines to return (default 40).'),

package/dist/protocol/mcp-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"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"}

package/dist/protocol/mouse.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Reading terminal input and output back as what it is, for tracing.
+ *
+ * Nothing here is on a hot path by itself — every caller is behind a debug
+ * switch — but it lives in the protocol package because the interesting
+ * question spans four processes. A wheel over a remote terminal is encoded in
+ * the browser, framed by the canvas hub, forwarded over the peer link, and
+ * written to a pty on another machine; each hop logs separately, and a trace
+ * is only worth reading if all four spell the same event the same way.
+ *
+ * The decoders are deliberately lenient. A log that says "6 bytes" for
+ * something it half-recognises is worse than one that says what it saw and
+ * lets the reader disagree.
+ */
+/** A byte burst as hex, capped so a paste cannot fill the log. */
+export declare function hexBytes(bytes: Uint8Array, limit?: number): string;
+/**
+ * One line describing a burst of terminal input.
+ *
+ * Mouse reports are named because they are what a scroll trace is looking
+ * for; everything else is shown as text plus hex, because the failure this
+ * exists to catch is a report arriving as the wrong bytes rather than not
+ * arriving at all.
+ */
+export declare function describeInput(bytes: Uint8Array): string;
+/** The same, for input a caller is holding as one-byte-per-code-unit text. */
+export declare function describeLatin1(data: string): string;
+export interface ModeChange {
+    mode: string;
+    name: string;
+    set: boolean;
+}
+/**
+ * Every mouse or screen mode the program flipped in this chunk of output.
+ *
+ * Read off the stream rather than off a terminal, because the interesting
+ * moment is often before any terminal exists to ask: the hub sees a session's
+ * whole life, a freshly mounted window sees only what arrives after it
+ * attached. Both ends log through this so the two views can be compared.
+ */
+export declare function modeChanges(text: string): ModeChange[];
+/** Those changes as one loggable phrase, or null when there were none. */
+export declare function describeModeChanges(text: string): string | null;
+/**
+ * What a serialized screen would restore, as far as scrolling is concerned.
+ *
+ * `@xterm/addon-serialize` replays the tracking mode but not the *encoding*
+ * one, so a snapshot can restore `?1003h` without `?1006h` and leave a
+ * reattached window sending X10 reports to a program that had been getting
+ * SGR ones. Worth being able to see in a trace, because the two ends of a
+ * remote session deliver their snapshots by different routes.
+ */
+export declare function describeSnapshotModes(serialized: string): string;
+//# sourceMappingURL=mouse.d.ts.map

package/dist/protocol/mouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../src/mouse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,SAAK,GAAG,MAAM,CAK9D;AAqED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIvD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AA4BD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAUtD;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIhE"}

package/dist/protocol/mouse.js

@@ -0,0 +1,187 @@
+/**
+ * Reading terminal input and output back as what it is, for tracing.
+ *
+ * Nothing here is on a hot path by itself — every caller is behind a debug
+ * switch — but it lives in the protocol package because the interesting
+ * question spans four processes. A wheel over a remote terminal is encoded in
+ * the browser, framed by the canvas hub, forwarded over the peer link, and
+ * written to a pty on another machine; each hop logs separately, and a trace
+ * is only worth reading if all four spell the same event the same way.
+ *
+ * The decoders are deliberately lenient. A log that says "6 bytes" for
+ * something it half-recognises is worse than one that says what it saw and
+ * lets the reader disagree.
+ */
+/** A byte burst as hex, capped so a paste cannot fill the log. */
+export function hexBytes(bytes, limit = 32) {
+    const shown = Array.from(bytes.subarray(0, limit))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join(' ');
+    return bytes.length > limit ? `${shown} … (${bytes.length}B)` : shown;
+}
+/** Printable rendering of an input burst, with escapes made visible. */
+function asText(bytes) {
+    let out = '';
+    for (const b of bytes) {
+        if (b === 0x1b)
+            out += '\\e';
+        else if (b === 0x0d)
+            out += '\\r';
+        else if (b === 0x0a)
+            out += '\\n';
+        else if (b === 0x09)
+            out += '\\t';
+        else if (b < 0x20 || b === 0x7f)
+            out += `\\x${b.toString(16).padStart(2, '0')}`;
+        else if (b < 0x7f)
+            out += String.fromCharCode(b);
+        else
+            out += `\\x${b.toString(16).padStart(2, '0')}`;
+    }
+    return out;
+}
+/**
+ * What one mouse button field means.
+ *
+ * The wheel is the reason this exists: it is not a button in the low two bits
+ * but bit 6, so a wheel report and a left-click differ by 64 and read
+ * identically to anyone counting buttons. Bits 2-4 are the modifiers.
+ */
+function describeButton(b) {
+    const motion = (b & 32) !== 0;
+    const wheel = (b & 64) !== 0;
+    const low = b & 3;
+    const mods = [
+        b & 4 ? 'shift' : '',
+        b & 8 ? 'meta' : '',
+        b & 16 ? 'ctrl' : '',
+    ].filter(Boolean);
+    let name;
+    if (wheel)
+        name = low === 0 ? 'wheel-up' : low === 1 ? 'wheel-down' : `wheel-${low}`;
+    else if (low === 3)
+        name = 'release';
+    else
+        name = ['left', 'middle', 'right'][low];
+    if (motion && !wheel)
+        name += '-motion';
+    return mods.length ? `${name}+${mods.join('+')}` : name;
+}
+/**
+ * An X10 mouse report: `ESC [ M b x y`, each of the last three offset by 32.
+ *
+ * This is the encoding a program gets when it enables tracking without also
+ * asking for SGR, and it is the one that cannot survive being treated as
+ * text: past column or row 95 the coordinate byte is above 0x7f, which is not
+ * UTF-8 at all. A trace that shows a two-byte coordinate where this expects
+ * one is looking at exactly that corruption.
+ */
+function decodeX10(bytes) {
+    if (bytes.length < 6)
+        return null;
+    if (bytes[0] !== 0x1b || bytes[1] !== 0x5b || bytes[2] !== 0x4d)
+        return null;
+    const b = bytes[3] - 32;
+    const col = bytes[4] - 32;
+    const row = bytes[5] - 32;
+    const tail = bytes.length > 6 ? ` +${bytes.length - 6}B` : '';
+    return `X10 ${describeButton(b)} col=${col} row=${row}${tail}`;
+}
+/** An SGR mouse report: `ESC [ < b ; col ; row M|m`, all in decimal. */
+function decodeSgr(bytes) {
+    const s = asText(bytes);
+    const m = /^\\e\[<(\d+);(\d+);(\d+)([Mm])/.exec(s);
+    if (!m)
+        return null;
+    const press = m[4] === 'M' ? 'press' : 'release';
+    return `SGR ${describeButton(Number(m[1]))} col=${m[2]} row=${m[3]} ${press}`;
+}
+/**
+ * One line describing a burst of terminal input.
+ *
+ * Mouse reports are named because they are what a scroll trace is looking
+ * for; everything else is shown as text plus hex, because the failure this
+ * exists to catch is a report arriving as the wrong bytes rather than not
+ * arriving at all.
+ */
+export function describeInput(bytes) {
+    const mouse = decodeX10(bytes) ?? decodeSgr(bytes);
+    if (mouse)
+        return `${mouse} [${hexBytes(bytes)}]`;
+    return `"${asText(bytes)}" [${hexBytes(bytes)}]`;
+}
+/** The same, for input a caller is holding as one-byte-per-code-unit text. */
+export function describeLatin1(data) {
+    const bytes = new Uint8Array(data.length);
+    for (let i = 0; i < data.length; i++)
+        bytes[i] = data.charCodeAt(i) & 0xff;
+    return describeInput(bytes);
+}
+/**
+ * The modes that decide whether a wheel is the program's business or the
+ * terminal's, named by what they do rather than by number.
+ *
+ * `?1049` is here because it is the one that explains a terminal with no
+ * scrollback at all: on the alternate screen there is nothing to scroll to,
+ * so a program that has not also asked for mouse reports cannot be scrolled
+ * by any means. That combination — alternate screen, no tracking — is the
+ * shape a stale CLI leaves behind, and it is worth being able to see it
+ * rather than infer it.
+ */
+const MODE_NAMES = {
+    '9': 'x10-mouse',
+    '1000': 'vt200-mouse',
+    '1002': 'drag-mouse',
+    '1003': 'any-motion-mouse',
+    '1004': 'focus-events',
+    '1005': 'utf8-mouse-encoding',
+    '1006': 'sgr-mouse-encoding',
+    '1015': 'urxvt-mouse-encoding',
+    '1016': 'sgr-pixel-encoding',
+    '1047': 'alt-screen',
+    '1049': 'alt-screen+cursor',
+    '47': 'alt-screen-legacy',
+};
+/**
+ * Every mouse or screen mode the program flipped in this chunk of output.
+ *
+ * Read off the stream rather than off a terminal, because the interesting
+ * moment is often before any terminal exists to ask: the hub sees a session's
+ * whole life, a freshly mounted window sees only what arrives after it
+ * attached. Both ends log through this so the two views can be compared.
+ */
+export function modeChanges(text) {
+    const out = [];
+    // A single DECSET/DECRST can carry several modes, e.g. `ESC [ ? 1002;1006 h`.
+    for (const m of text.matchAll(/\x1b\[\?([\d;]+)([hl])/g)) {
+        for (const mode of m[1].split(';')) {
+            const name = MODE_NAMES[mode];
+            if (name)
+                out.push({ mode, name, set: m[2] === 'h' });
+        }
+    }
+    return out;
+}
+/** Those changes as one loggable phrase, or null when there were none. */
+export function describeModeChanges(text) {
+    const changes = modeChanges(text);
+    if (changes.length === 0)
+        return null;
+    return changes.map((c) => `${c.set ? '+' : '-'}${c.name}(?${c.mode})`).join(' ');
+}
+/**
+ * What a serialized screen would restore, as far as scrolling is concerned.
+ *
+ * `@xterm/addon-serialize` replays the tracking mode but not the *encoding*
+ * one, so a snapshot can restore `?1003h` without `?1006h` and leave a
+ * reattached window sending X10 reports to a program that had been getting
+ * SGR ones. Worth being able to see in a trace, because the two ends of a
+ * remote session deliver their snapshots by different routes.
+ */
+export function describeSnapshotModes(serialized) {
+    const changes = modeChanges(serialized);
+    if (changes.length === 0)
+        return 'no mouse/screen modes';
+    return changes.map((c) => `${c.set ? '+' : '-'}${c.name}`).join(' ');
+}
+//# sourceMappingURL=mouse.js.map

package/dist/protocol/mouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.js","sourceRoot":"","sources":["../src/mouse.ts"],"names":[],"mappings":"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"}

package/dist/protocol/peer.d.ts

@@ -65,6 +65,21 @@ export declare const PeerRelayAsk: z.ZodDiscriminatedUnion<[z.ZodObject<{
     t: z.ZodLiteral<"readScreen">;
     address: z.ZodString;
     lines: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"listHosts">;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"spawn">;
+    from: z.ZodString;
+    host: z.ZodString;
+    workspace: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    agent: z.ZodString;
+    template: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    opening: z.ZodOptional<z.ZodString>;
+    promptGiven: z.ZodBoolean;
 }, z.core.$strip>], "t">;
 export type PeerRelayAsk = z.infer<typeof PeerRelayAsk>;
 export declare const PeerHello: z.ZodObject<{
@@ -77,6 +92,7 @@ export declare const PeerHello: z.ZodObject<{
         platform: z.ZodString;
         arch: z.ZodString;
         homeDir: z.ZodString;
+        machineId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const PeerRequest: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -89,6 +105,7 @@ export declare const PeerRequest: z.ZodDiscriminatedUnion<[z.ZodObject<{
         platform: z.ZodString;
         arch: z.ZodString;
         homeDir: z.ZodString;
+        machineId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"listSessions">;
@@ -147,6 +164,7 @@ export declare const PeerRequest: z.ZodDiscriminatedUnion<[z.ZodObject<{
         statusText: z.ZodNullable<z.ZodString>;
         host: z.ZodString;
     }, z.core.$strip>>;
+    youAre: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"relayResult">;
     id: z.ZodString;
@@ -178,12 +196,20 @@ export declare const PeerRequest: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
     address: z.ZodString;
     data: z.ZodString;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        utf8: "utf8";
+        binary: "binary";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"resize">;
     id: z.ZodString;
     address: z.ZodString;
     cols: z.ZodNumber;
     rows: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"checkFolder">;
+    id: z.ZodString;
+    path: z.ZodString;
 }, z.core.$strip>], "t">;
 export type PeerRequest = z.infer<typeof PeerRequest>;
 export declare const PeerResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -199,6 +225,11 @@ export declare const PeerResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
     t: z.ZodLiteral<"err">;
     id: z.ZodString;
     message: z.ZodString;
+    code: z.ZodOptional<z.ZodEnum<{
+        "unknown-token": "unknown-token";
+        "schema-mismatch": "schema-mismatch";
+        "bad-hello": "bad-hello";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"sessions">;
     sessions: z.ZodArray<z.ZodObject<{
@@ -330,12 +361,33 @@ export declare const PeerResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
         t: z.ZodLiteral<"readScreen">;
         address: z.ZodString;
         lines: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        t: z.ZodLiteral<"listHosts">;
+    }, z.core.$strip>, z.ZodObject<{
+        t: z.ZodLiteral<"spawn">;
+        from: z.ZodString;
+        host: z.ZodString;
+        workspace: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        agent: z.ZodString;
+        template: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        opening: z.ZodOptional<z.ZodString>;
+        promptGiven: z.ZodBoolean;
     }, z.core.$strip>], "t">;
 }, z.core.$strip>], "t">;
 export type PeerResponse = z.infer<typeof PeerResponse>;
 /**
  * Bumped whenever the peer protocol or the DB schema changes shape. Hubs
  * refuse to connect across a mismatch rather than corrupting each other.
+ *
+ * 9: added `checkFolder`. Required, not cosmetic — `peer-serve.ts` drops a
+ * frame it cannot parse silently, so a peer older than this would leave a
+ * `checkFolder` request hanging forever instead of refusing it; the version
+ * gate is what turns that into an honest refusal at the handshake instead.
+ * Consequence: every already-joined machine has to re-run the installer.
  */
-export declare const PEER_SCHEMA_VERSION = 6;
+export declare const PEER_SCHEMA_VERSION = 9;
 //# sourceMappingURL=peer.d.ts.map

package/dist/protocol/peer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../src/peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;iBASpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;;;;;;GAQG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;wBAcvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,SAAS;;;;;;;;;;;iBAkBpB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAyGtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA0BvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC"}
+{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../src/peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;iBASpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;;;;;;GAQG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;wBA2CvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,SAAS;;;;;;;;;;;;iBA+BpB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuItB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAyCvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC"}