@linkshell/wire 0.2.20 → 0.2.22

package/dist/envelopes.d.ts

@@ -0,0 +1,53 @@
+/** Something attached to a message, shown as a chip beside the words. */
+export interface UserContext {
+    kind: "file" | "image" | "pasted" | "selection" | "comments" | "checks" | "annotations" | "browser" | "review" | "pull-request" | "merge" | "history" | "other";
+    label: string;
+    /** A path, or the start of the attached text. */
+    detail?: string;
+}
+/** A message that is an event, not something said: one line in the conversation. */
+export type UserEvent = {
+    kind: "ci";
+    count: number;
+} | {
+    kind: "github";
+    count: number;
+} | {
+    kind: "sessions";
+    sessions: {
+        id?: string;
+        title: string;
+    }[];
+} | {
+    kind: "scheduled";
+    name: string;
+    detail?: string;
+};
+export interface UserTextView {
+    /** The words to show; empty when the message is only context, an event or a command's output. */
+    text: string;
+    context: UserContext[];
+    /** A shell command run from the prompt (Claude's `!` mode), and what it printed. */
+    shell?: {
+        command?: string;
+        stdout?: string;
+        stderr?: string;
+    };
+    /** What a local slash command printed (`/cost`, `/context`). */
+    output?: string;
+    event?: UserEvent;
+    /** Nothing in it is for a reader. */
+    hidden: boolean;
+}
+/** The text without what is for the model only; `keepPeers` keeps mail from other sessions and agents. */
+export declare function stripHiddenContext(text: string, { keepPeers }?: {
+    keepPeers?: boolean;
+}): string;
+/**
+ * How to show a person's message: its words, what came with it, or the one event it is. `images`
+ * is how many pictures the message carries besides its text, so an envelope naming them doesn't
+ * also chip them.
+ */
+export declare function readUserText(raw: string, { images }?: {
+    images?: number;
+}): UserTextView;

package/dist/envelopes.js

@@ -0,0 +1,251 @@
+// What agents and their desktop clients wrap around a person's words. Claude Code adds reminders
+// and IDE state, the Claude app adds session events and peer mail, Codex Desktop adds the files,
+// selection and browser state it attached: context for the model, not what the person typed.
+// Readers show the words, and the context as a chip or an event line where it means something to
+// them, the way Claude's and Codex's own apps do. Shared by the host (titles, previews, what it
+// keeps from Claude's transcripts) and every client.
+/** Tags whose whole content is for the model only: the Claude app's own list, then Codex's. */
+const HIDDEN_TAGS = [
+    "system-reminder",
+    "task-notification",
+    "slack_context",
+    "uploaded_files",
+    "available-deferred-tools",
+    "new-diagnostics",
+    "critical_user_preferences_reminder",
+    "persisted-output",
+    "local-command-caveat",
+    "tick",
+    "goal",
+    "mcp-resource",
+    "mcp-resource-update",
+    "mcp-polling-update",
+    "teammate-message",
+    "cross-session-message",
+    "launch-selected-element",
+    "connected_office_files",
+    "thinking",
+    "ide_opened_file",
+    "ide_selection",
+    "ide_diagnostics",
+    "browser_instruction",
+    "cell",
+    "cell_type",
+    "language",
+    "command-message",
+    "command-args",
+    "no-action-needed",
+    "comprehensive-mode-instructions",
+    "cu_window_hints",
+    "widget_context_hint",
+    "preview-annotation-context",
+    "terminal-selection",
+    "environment_context",
+    "user_instructions",
+    "turn_aborted",
+    "subagent_notification",
+    "external_codex_apps_open_page",
+];
+const hiddenPattern = (tags) => new RegExp(`<(${tags.join("|")})(?:\\s[^>]*)?>[\\s\\S]*?</\\1>`, "gi");
+const HIDDEN = hiddenPattern(HIDDEN_TAGS);
+/** Mail between sessions and agents: hidden in a person's bubble, but a message of its own when it is the whole message. */
+const PEER_TAGS = ["teammate-message", "cross-session-message"];
+const HIDDEN_BUT_PEERS = hiddenPattern(HIDDEN_TAGS.filter((tag) => !PEER_TAGS.includes(tag)));
+/** The text without what is for the model only; `keepPeers` keeps mail from other sessions and agents. */
+export function stripHiddenContext(text, { keepPeers = false } = {}) {
+    return text
+        .replace(/\r\n/g, "\n")
+        .replace(keepPeers ? HIDDEN_BUT_PEERS : HIDDEN, "")
+        .replace(/<\/?tool_use_error>/g, "")
+        // Claude's pointers to a background task's files, for itself.
+        .replace(/^(?:Full transcript available at|Read the output file to retrieve the result):.*$/gm, "")
+        .replace(/\s*\[event:[\da-f-]{36}\]\s*$/i, "")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+const ANSI = /\u001b\[[\d;?]*[ -/]*[@-~]/g;
+function tagText(source, tag) {
+    const match = new RegExp(`<${tag}(?:\\s[^>]*)?>([\\s\\S]*?)</${tag}>`, "i").exec(source);
+    return match ? match[1] : undefined;
+}
+function attribute(attrs, name) {
+    const match = new RegExp(`\\b${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`, "i").exec(attrs);
+    return match ? (match[1] ?? match[2]) : undefined;
+}
+const EVENT_TAGS = ["side-sessions-event", "ci-monitor-event", "github-webhook-activity"];
+const EVENT_PATTERNS = new Map(EVENT_TAGS.map((tag) => [tag, new RegExp(`<${tag}\\b[^>]*>[\\s\\S]*?</${tag}>`, "gi")]));
+/** A message made only of one kind of tag, repeated: the count, else undefined. */
+function only(text, tag) {
+    if (!text.startsWith(`<${tag}`))
+        return undefined;
+    const pattern = EVENT_PATTERNS.get(tag);
+    const all = text.match(pattern);
+    if (!all)
+        return undefined;
+    return text.replace(pattern, "").trim() ? undefined : all.length;
+}
+/** Codex Desktop's sections before "## My request:", by heading. */
+const CONTEXT_SECTIONS = {
+    "Files mentioned by the user": "file",
+    "Files pasted by the user": "pasted",
+    "Selected text": "selection",
+    "Diff comments": "comments",
+    "Browser comments": "comments",
+    "Failing PR checks": "checks",
+    "Response annotations": "annotations",
+};
+const MODES = {
+    "Code review guidelines": ["review", "审查模式"],
+    "Pull request fix": ["pull-request", "PR 修复"],
+    "Auto resolve merge": ["merge", "自动解决冲突"],
+    "Prior conversation with Codex": ["history", "参考历史对话"],
+};
+const SECTION_LABELS = {
+    "Selected text": "选中的文本",
+    "Diff comments": "差异评论",
+    "Browser comments": "浏览器评论",
+    "Failing PR checks": "失败的 PR 检查",
+    "Response annotations": "回复批注",
+};
+const REQUEST = /^## My request(?: for Codex)?:[ \t]*$/gm;
+const baseName = (path) => path.split(/[\\/]/).filter(Boolean).at(-1) ?? path;
+function codexContext(text, images) {
+    const start = /^(#{1,2}) ([^\n:]+):[ \t]*$/m.exec(text);
+    // Only an envelope Codex wrote: it opens the message with one of its own headings.
+    if (!start || start.index !== 0)
+        return undefined;
+    const heading = start[2];
+    if (!(start[1] === "#" ? heading in CONTEXT_SECTIONS : heading in MODES || /^My request(?: for Codex)?$/.test(heading)))
+        return undefined;
+    let cut = -1;
+    let after = 0;
+    for (const match of text.matchAll(REQUEST)) {
+        cut = match.index;
+        after = match.index + match[0].length;
+    }
+    const preface = cut < 0 ? text : text.slice(0, cut);
+    const request = cut < 0 ? "" : text.slice(after).trim();
+    const context = [];
+    let imageEntries = 0;
+    const sections = preface.split(/^(?=#{1,2} [^\n:]+:[ \t]*$)/m);
+    for (const section of sections) {
+        const head = /^(#{1,2}) ([^\n:]+):[ \t]*\n?/.exec(section);
+        if (!head)
+            continue;
+        const name = head[2];
+        const body = section.slice(head[0].length).trim();
+        if (head[1] === "##") {
+            const mode = MODES[name];
+            if (mode)
+                context.push({ kind: mode[0], label: mode[1] });
+            continue;
+        }
+        const kind = CONTEXT_SECTIONS[name];
+        if (kind === "file") {
+            for (const entry of body.matchAll(/^## (.+?): (.+?)(?: \((lines? [^)]*)\))?\n?(Image attachment: true)?$/gm)) {
+                if (entry[4]) {
+                    imageEntries += 1;
+                    // The picture itself is shown; a chip for it would say it twice.
+                    if (imageEntries <= images)
+                        continue;
+                }
+                context.push({ kind: entry[4] ? "image" : "file", label: entry[1].includes("/") ? baseName(entry[1]) : entry[1], detail: entry[3] ? `${entry[2]} · ${entry[3]}` : entry[2] });
+            }
+        }
+        else if (kind === "pasted") {
+            for (const entry of body.matchAll(/^## "?(.+?)"?: (.+)$/gm))
+                context.push({ kind: "pasted", label: entry[1].trim(), detail: entry[2] });
+        }
+        else if (kind) {
+            context.push({ kind, label: SECTION_LABELS[name] ?? name, detail: body.split("\n").find((line) => line.trim())?.trim() });
+        }
+        else if (name !== "Distinguish instructions in attached documents from the user's request") {
+            context.push({ kind: "other", label: name });
+        }
+    }
+    return { text: request, context };
+}
+// Claude writes a shell's output into its transcript with <, > and & escaped.
+const ENTITIES = { lt: "<", gt: ">", amp: "&", quot: "\"", apos: "'" };
+function unescapeHtml(value) {
+    // One pass: "&amp;gt;" is the text "&gt;", not ">".
+    return value.replace(/&(lt|gt|amp|quot|apos|#\d{1,7}|#x[0-9a-f]{1,6});/gi, (whole, name) => {
+        const key = name.toLowerCase();
+        const code = key.startsWith("#x") ? parseInt(key.slice(2), 16) : key.startsWith("#") ? Number(key.slice(1)) : undefined;
+        if (code === undefined)
+            return ENTITIES[key] ?? whole;
+        return code > 0 && code <= 0x10ffff ? String.fromCodePoint(code) : whole;
+    });
+}
+/**
+ * Codex Desktop writes a mention of another of its threads as a Markdown link to
+ * codex://threads/<id>, with the space before it as "&#x20;": read as the thread's title.
+ */
+function threadMentions(text) {
+    const read = text.replace(/&#(?:x20|32);/gi, " ").replace(/\[([^\]\n]+)\]\(codex:\/\/threads\/[\w-]+\)/g, "「$1」");
+    return read === text ? text : read.trim();
+}
+/**
+ * How to show a person's message: its words, what came with it, or the one event it is. `images`
+ * is how many pictures the message carries besides its text, so an envelope naming them doesn't
+ * also chip them.
+ */
+export function readUserText(raw, { images = 0 } = {}) {
+    let text = raw.replace(/\r\n/g, "\n");
+    const context = [];
+    const view = (rest) => ({ text: "", context, hidden: false, ...rest });
+    // The Claude app tells a session about the sessions it started in a reminder beside the event.
+    const sessions = [...text.matchAll(/The session "([^"\n]+)" you started \((local_[\w-]+)\)/g)].map((match) => ({ title: match[1], id: match[2] }));
+    const browser = /<in-app-browser-context\b[^>]*>[\s\S]*?<\/in-app-browser-context>/gi;
+    const withoutBrowser = text.replace(browser, "");
+    if (withoutBrowser !== text) {
+        context.push({ kind: "browser", label: "浏览器上下文" });
+        text = withoutBrowser;
+    }
+    text = stripHiddenContext(text);
+    if (only(text, "side-sessions-event"))
+        return view({ event: { kind: "sessions", sessions } });
+    if (!text)
+        return view({ hidden: images === 0 && context.length === 0 });
+    if (/^\[Request interrupted by user(?: for tool use)?\]$/.test(text))
+        return view({ hidden: true });
+    const ci = only(text, "ci-monitor-event");
+    if (ci)
+        return view({ event: { kind: "ci", count: ci } });
+    const github = only(text, "github-webhook-activity");
+    if (github)
+        return view({ event: { kind: "github", count: github } });
+    const scheduled = /^<scheduled-task\b([^>]*)>([\s\S]*?)<\/scheduled-task>$/i.exec(text);
+    if (scheduled) {
+        const name = attribute(scheduled[1], "name") ?? baseName(attribute(scheduled[1], "file") ?? "").replace(/\.md$/i, "");
+        return view({ event: { kind: "scheduled", name: name || "定时任务", detail: scheduled[2].trim() || undefined } });
+    }
+    if (/^<bash-(?:input|stdout|stderr)>/.test(text)) {
+        const clean = (value) => (value === undefined ? undefined : unescapeHtml(value).replace(ANSI, "").replace(/\n+$/, "")) || undefined;
+        const command = clean(tagText(text, "bash-input"))?.trim();
+        const stdout = clean(tagText(text, "bash-stdout"));
+        const stderr = clean(tagText(text, "bash-stderr"));
+        const rest = text.replace(/<(bash-(?:input|stdout|stderr|exit-code))>[\s\S]*?<\/\1>/g, "").trim();
+        return view({ shell: { command, stdout, stderr }, text: rest, hidden: !command && !stdout && !stderr && !rest });
+    }
+    if (/^<local-command-(?:stdout|stderr)>/.test(text)) {
+        const raw = [tagText(text, "local-command-stdout"), tagText(text, "local-command-stderr")]
+            .filter((part) => !!part?.trim())
+            .join("\n")
+            .replace(ANSI, "");
+        const output = unescapeHtml(raw).trim();
+        // /model's confirmation: the Claude app doesn't show the switch as a line either.
+        return view({ output: output || undefined, hidden: !output || /^Set model to\b/.test(output) });
+    }
+    // Slash-command plumbing the host couldn't read as a command, and notifications it didn't match.
+    if (/^<(?:command-name|local-command-|task-notification)/.test(text))
+        return view({ hidden: true });
+    const codex = codexContext(text, images);
+    if (codex) {
+        context.push(...codex.context);
+        const words = threadMentions(codex.text);
+        return view({ text: words, hidden: !words && images === 0 && context.length === 0 });
+    }
+    return view({ text: threadMentions(text) });
+}
+//# sourceMappingURL=envelopes.js.map

package/dist/envelopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelopes.js","sourceRoot":"","sources":["../src/envelopes.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,iGAAiG;AACjG,6FAA6F;AAC7F,iGAAiG;AACjG,gGAAgG;AAChG,qDAAqD;AAErD,+FAA+F;AAC/F,MAAM,WAAW,GAAG;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,gBAAgB;IAChB,0BAA0B;IAC1B,iBAAiB;IACjB,oCAAoC;IACpC,kBAAkB;IAClB,sBAAsB;IACtB,MAAM;IACN,MAAM;IACN,cAAc;IACd,qBAAqB;IACrB,oBAAoB;IACpB,kBAAkB;IAClB,uBAAuB;IACvB,yBAAyB;IACzB,wBAAwB;IACxB,UAAU;IACV,iBAAiB;IACjB,eAAe;IACf,iBAAiB;IACjB,qBAAqB;IACrB,MAAM;IACN,WAAW;IACX,UAAU;IACV,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,iCAAiC;IACjC,iBAAiB;IACjB,qBAAqB;IACrB,4BAA4B;IAC5B,oBAAoB;IACpB,qBAAqB;IACrB,mBAAmB;IACnB,cAAc;IACd,uBAAuB;IACvB,+BAA+B;CAChC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iCAAiC,EAAE,IAAI,CAAC,CAAC;AACjH,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAC1C,4HAA4H;AAC5H,MAAM,SAAS,GAAG,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;AAChE,MAAM,gBAAgB,GAAG,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AA8B9F,0GAA0G;AAC1G,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,EAAE,SAAS,GAAG,KAAK,KAA8B,EAAE;IAClG,OAAO,IAAI;SACR,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAClD,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC;QACpC,8DAA8D;SAC7D,OAAO,CAAC,qFAAqF,EAAE,EAAE,CAAC;SAClG,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC;SAC7C,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,IAAI,GAAG,6BAA6B,CAAC;AAE3C,SAAS,OAAO,CAAC,MAAc,EAAE,GAAW;IAC1C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,+BAA+B,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,kCAAkC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,yBAAyB,CAAU,CAAC;AACnG,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,IAAI,GAAG,wBAAwB,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAExH,mFAAmF;AACnF,SAAS,IAAI,CAAC,IAAY,EAAE,GAAgC;IAC1D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;AACnE,CAAC;AAED,oEAAoE;AACpE,MAAM,gBAAgB,GAAwC;IAC5D,6BAA6B,EAAE,MAAM;IACrC,0BAA0B,EAAE,QAAQ;IACpC,eAAe,EAAE,WAAW;IAC5B,eAAe,EAAE,UAAU;IAC3B,kBAAkB,EAAE,UAAU;IAC9B,mBAAmB,EAAE,QAAQ;IAC7B,sBAAsB,EAAE,aAAa;CACtC,CAAC;AACF,MAAM,KAAK,GAAkD;IAC3D,wBAAwB,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC5C,kBAAkB,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC;IAC7C,oBAAoB,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;IACzC,+BAA+B,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;CACvD,CAAC;AACF,MAAM,cAAc,GAA2B;IAC7C,eAAe,EAAE,OAAO;IACxB,eAAe,EAAE,MAAM;IACvB,kBAAkB,EAAE,OAAO;IAC3B,mBAAmB,EAAE,WAAW;IAChC,sBAAsB,EAAE,MAAM;CAC/B,CAAC;AACF,MAAM,OAAO,GAAG,yCAAyC,CAAC;AAE1D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAEtF,SAAS,YAAY,CAAC,IAAY,EAAE,MAAc;IAChD,MAAM,KAAK,GAAG,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,mFAAmF;IACnF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAC1B,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,OAAO,IAAI,KAAK,IAAI,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1I,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,GAAG,GAAG,KAAK,CAAC,KAAM,CAAC;QACnB,KAAK,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACzC,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC/D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1D,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,yEAAyE,CAAC,EAAE,CAAC;gBAC7G,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACb,YAAY,IAAI,CAAC,CAAC;oBAClB,iEAAiE;oBACjE,IAAI,YAAY,IAAI,MAAM;wBAAE,SAAS;gBACvC,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnL,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3I,CAAC;aAAM,IAAI,IAAI,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5H,CAAC;aAAM,IAAI,IAAI,KAAK,wEAAwE,EAAE,CAAC;YAC7F,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,MAAM,QAAQ,GAA2B,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC/F,SAAS,YAAY,CAAC,KAAa;IACjC,oDAAoD;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,oDAAoD,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QACjG,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxH,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;QACtD,OAAO,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,8CAA8C,EAAE,MAAM,CAAC,CAAC;IAClH,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,EAAE,MAAM,GAAG,CAAC,KAA0B,EAAE;IAChF,IAAI,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,IAA2B,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAE5G,+FAA+F;IAC/F,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,yDAAyD,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpJ,MAAM,OAAO,GAAG,qEAAqE,CAAC;IACtF,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,IAAI,GAAG,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC9F,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;IACzE,IAAI,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACpG,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC1C,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;IACrD,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,0DAA0D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxH,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,IAAI,SAAS,EAAE,EAAE,CAAC,CAAC;IACjH,CAAC;IAED,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC;QAC7I,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,2DAA2D,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAClG,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnH,CAAC;IACD,IAAI,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,sBAAsB,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;aACvF,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;aAChD,IAAI,CAAC,IAAI,CAAC;aACV,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,kFAAkF;QAClF,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,iGAAiG;IACjG,IAAI,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpG,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -17,3 +17,6 @@ export * from "./editor.js";
 export * from "./live-activity.js";
 export * from "./watch.js";
 export * from "./usage.js";
+export * from "./side.js";
+export * from "./rpc-mcp.js";
+export * from "./envelopes.js";

package/dist/index.js

@@ -17,4 +17,7 @@ export * from "./editor.js";
 export * from "./live-activity.js";
 export * from "./watch.js";
 export * from "./usage.js";
+export * from "./side.js";
+export * from "./rpc-mcp.js";
+export * from "./envelopes.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/live-activity.d.ts

@@ -17,8 +17,8 @@ export declare const liveActivityActionSchema: z.ZodObject<{
     kind: "permission" | "answer" | "async-answer";
     optionId: string;
     requestId: string;
-    role: "choice" | "stop" | "reject" | "allow" | "always";
     sessionId: string;
+    role: "choice" | "stop" | "reject" | "allow" | "always";
     computerKey: string;
     questionId?: string | undefined;
 }, {
@@ -27,8 +27,8 @@ export declare const liveActivityActionSchema: z.ZodObject<{
     kind: "permission" | "answer" | "async-answer";
     optionId: string;
     requestId: string;
-    role: "choice" | "stop" | "reject" | "allow" | "always";
     sessionId: string;
+    role: "choice" | "stop" | "reject" | "allow" | "always";
     computerKey: string;
     questionId?: string | undefined;
 }>;
@@ -137,8 +137,8 @@ export declare const liveActivityContentSchema: z.ZodObject<{
         kind: "permission" | "answer" | "async-answer";
         optionId: string;
         requestId: string;
-        role: "choice" | "stop" | "reject" | "allow" | "always";
         sessionId: string;
+        role: "choice" | "stop" | "reject" | "allow" | "always";
         computerKey: string;
         questionId?: string | undefined;
     }, {
@@ -147,8 +147,8 @@ export declare const liveActivityContentSchema: z.ZodObject<{
         kind: "permission" | "answer" | "async-answer";
         optionId: string;
         requestId: string;
-        role: "choice" | "stop" | "reject" | "allow" | "always";
         sessionId: string;
+        role: "choice" | "stop" | "reject" | "allow" | "always";
         computerKey: string;
         questionId?: string | undefined;
     }>, "many">>;
@@ -209,8 +209,8 @@ export declare const liveActivityContentSchema: z.ZodObject<{
         kind: "permission" | "answer" | "async-answer";
         optionId: string;
         requestId: string;
-        role: "choice" | "stop" | "reject" | "allow" | "always";
         sessionId: string;
+        role: "choice" | "stop" | "reject" | "allow" | "always";
         computerKey: string;
         questionId?: string | undefined;
     }[] | undefined;
@@ -242,8 +242,8 @@ export declare const liveActivityContentSchema: z.ZodObject<{
         kind: "permission" | "answer" | "async-answer";
         optionId: string;
         requestId: string;
-        role: "choice" | "stop" | "reject" | "allow" | "always";
         sessionId: string;
+        role: "choice" | "stop" | "reject" | "allow" | "always";
         computerKey: string;
         questionId?: string | undefined;
     }[] | undefined;

package/dist/model.d.ts

@@ -28,6 +28,8 @@ export declare const agentCapabilitiesSchema: z.ZodObject<{
      * shows the conversation and its agent is told it as text.
      */
     fork: z.ZodBoolean;
+    /** The agent has a side conversation of its own (`sessions.side`). Absent from older hosts. */
+    side: z.ZodOptional<z.ZodBoolean>;
     models: z.ZodBoolean;
     modes: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
@@ -41,6 +43,7 @@ export declare const agentCapabilitiesSchema: z.ZodObject<{
     acp?: boolean | undefined;
     audio?: boolean | undefined;
     embeddedContext?: boolean | undefined;
+    side?: boolean | undefined;
 }, {
     interrupt: boolean;
     steer: boolean;
@@ -52,6 +55,7 @@ export declare const agentCapabilitiesSchema: z.ZodObject<{
     acp?: boolean | undefined;
     audio?: boolean | undefined;
     embeddedContext?: boolean | undefined;
+    side?: boolean | undefined;
 }>;
 export type AgentCapabilities = z.infer<typeof agentCapabilitiesSchema>;
 /**
@@ -115,6 +119,8 @@ export declare const agentInfoSchema: z.ZodObject<{
          * shows the conversation and its agent is told it as text.
          */
         fork: z.ZodBoolean;
+        /** The agent has a side conversation of its own (`sessions.side`). Absent from older hosts. */
+        side: z.ZodOptional<z.ZodBoolean>;
         models: z.ZodBoolean;
         modes: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
@@ -128,6 +134,7 @@ export declare const agentInfoSchema: z.ZodObject<{
         acp?: boolean | undefined;
         audio?: boolean | undefined;
         embeddedContext?: boolean | undefined;
+        side?: boolean | undefined;
     }, {
         interrupt: boolean;
         steer: boolean;
@@ -139,6 +146,7 @@ export declare const agentInfoSchema: z.ZodObject<{
         acp?: boolean | undefined;
         audio?: boolean | undefined;
         embeddedContext?: boolean | undefined;
+        side?: boolean | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     id: string;
@@ -156,6 +164,7 @@ export declare const agentInfoSchema: z.ZodObject<{
         acp?: boolean | undefined;
         audio?: boolean | undefined;
         embeddedContext?: boolean | undefined;
+        side?: boolean | undefined;
     };
     version?: string | undefined;
     problem?: string | undefined;
@@ -180,6 +189,7 @@ export declare const agentInfoSchema: z.ZodObject<{
         acp?: boolean | undefined;
         audio?: boolean | undefined;
         embeddedContext?: boolean | undefined;
+        side?: boolean | undefined;
     };
     version?: string | undefined;
     problem?: string | undefined;
@@ -2026,6 +2036,25 @@ export declare const sessionSummarySchema: z.ZodObject<{
         branch: string;
         source: string;
     }>>;
+    /**
+     * The LinkShell session that started this one (e.g. a Claude desktop
+     * session's start_session or hand-off): the sidebar nests it there. Set
+     * only when this host has that session too. Absent from older hosts.
+     */
+    parentId: z.ZodOptional<z.ZodString>;
+    /**
+     * The LinkShell session this one was forked from (made here with
+     * `sessions.fork`, or recorded by the agent), when this host has it. Kept
+     * apart from `parentId`: a fork is a copy, not something that session
+     * started, so whether it nests is the list's choice.
+     */
+    forkedFrom: z.ZodOptional<z.ZodString>;
+    /**
+     * The id an app of the agent's knows the session by (the Claude desktop
+     * app's `local_…`): mail between its sessions names the sender by it, so a
+     * client can open the sender. Absent from older hosts.
+     */
+    appId: z.ZodOptional<z.ZodString>;
     /** Live only, for sessions that started sub-agents: how many, and how many are working now (`sessions.subagents` lists them). */
     subagents: z.ZodOptional<z.ZodObject<{
         total: z.ZodNumber;
@@ -2213,6 +2242,9 @@ export declare const sessionSummarySchema: z.ZodObject<{
         branch: string;
         source: string;
     } | undefined;
+    parentId?: string | undefined;
+    forkedFrom?: string | undefined;
+    appId?: string | undefined;
     subagents?: {
         running: number;
         total: number;
@@ -2324,6 +2356,9 @@ export declare const sessionSummarySchema: z.ZodObject<{
         branch: string;
         source: string;
     } | undefined;
+    parentId?: string | undefined;
+    forkedFrom?: string | undefined;
+    appId?: string | undefined;
     subagents?: {
         running: number;
         total: number;
@@ -2419,6 +2454,8 @@ export declare const machineInfoSchema: z.ZodObject<{
     hostname: z.ZodString;
     platform: z.ZodString;
     hostVersion: z.ZodString;
+    /** The host's RPC revision (`HOST_PROTOCOL`); absent from hosts older than it. */
+    protocol: z.ZodOptional<z.ZodNumber>;
     /** The host user's home directory, so apps can show paths as `~/…`. */
     home: z.ZodOptional<z.ZodString>;
     agents: z.ZodArray<z.ZodObject<{
@@ -2461,6 +2498,8 @@ export declare const machineInfoSchema: z.ZodObject<{
              * shows the conversation and its agent is told it as text.
              */
             fork: z.ZodBoolean;
+            /** The agent has a side conversation of its own (`sessions.side`). Absent from older hosts. */
+            side: z.ZodOptional<z.ZodBoolean>;
             models: z.ZodBoolean;
             modes: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
@@ -2474,6 +2513,7 @@ export declare const machineInfoSchema: z.ZodObject<{
             acp?: boolean | undefined;
             audio?: boolean | undefined;
             embeddedContext?: boolean | undefined;
+            side?: boolean | undefined;
         }, {
             interrupt: boolean;
             steer: boolean;
@@ -2485,6 +2525,7 @@ export declare const machineInfoSchema: z.ZodObject<{
             acp?: boolean | undefined;
             audio?: boolean | undefined;
             embeddedContext?: boolean | undefined;
+            side?: boolean | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
         id: string;
@@ -2502,6 +2543,7 @@ export declare const machineInfoSchema: z.ZodObject<{
             acp?: boolean | undefined;
             audio?: boolean | undefined;
             embeddedContext?: boolean | undefined;
+            side?: boolean | undefined;
         };
         version?: string | undefined;
         problem?: string | undefined;
@@ -2526,6 +2568,7 @@ export declare const machineInfoSchema: z.ZodObject<{
             acp?: boolean | undefined;
             audio?: boolean | undefined;
             embeddedContext?: boolean | undefined;
+            side?: boolean | undefined;
         };
         version?: string | undefined;
         problem?: string | undefined;
@@ -2565,6 +2608,7 @@ export declare const machineInfoSchema: z.ZodObject<{
             acp?: boolean | undefined;
             audio?: boolean | undefined;
             embeddedContext?: boolean | undefined;
+            side?: boolean | undefined;
         };
         version?: string | undefined;
         problem?: string | undefined;
@@ -2578,6 +2622,7 @@ export declare const machineInfoSchema: z.ZodObject<{
     hostname: string;
     platform: string;
     hostVersion: string;
+    protocol?: number | undefined;
     home?: string | undefined;
     direct?: {
         iceServers: string[];
@@ -2600,6 +2645,7 @@ export declare const machineInfoSchema: z.ZodObject<{
             acp?: boolean | undefined;
             audio?: boolean | undefined;
             embeddedContext?: boolean | undefined;
+            side?: boolean | undefined;
         };
         version?: string | undefined;
         problem?: string | undefined;
@@ -2613,6 +2659,7 @@ export declare const machineInfoSchema: z.ZodObject<{
     hostname: string;
     platform: string;
     hostVersion: string;
+    protocol?: number | undefined;
     home?: string | undefined;
     direct?: {
         iceServers: string[];
@@ -2665,6 +2712,11 @@ export declare const terminalInfoSchema: z.ZodObject<{
     exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     /** Ended without an exit code: the host stopped while it ran. */
     interrupted: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * The session it was opened for. Such a terminal belongs to the session: it closes when its
+     * shell exits or the session is archived or deleted, and isn't kept across a host restart.
+     */
+    sessionId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     title: string;
@@ -2676,6 +2728,7 @@ export declare const terminalInfoSchema: z.ZodObject<{
     command?: string | undefined;
     exitCode?: number | null | undefined;
     interrupted?: boolean | undefined;
+    sessionId?: string | undefined;
 }, {
     id: string;
     title: string;
@@ -2687,6 +2740,7 @@ export declare const terminalInfoSchema: z.ZodObject<{
     command?: string | undefined;
     exitCode?: number | null | undefined;
     interrupted?: boolean | undefined;
+    sessionId?: string | undefined;
 }>;
 export type TerminalInfo = z.infer<typeof terminalInfoSchema>;
 /** The host's link to a v2 gateway, for `linkshell status` and the app's computer page. */