linkshell-cli 0.10.73 → 0.10.75

package/dist/host/src/drivers/codex/mcp-apps.js

@@ -0,0 +1,340 @@
+import { RpcError } from "@linkshell/wire";
+import { connectorOf, descriptorPage, isPageUri, itemHasPage, mcpPage } from "./mapper.js";
+const str = (value) => (typeof value === "string" ? value : undefined);
+const obj = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+const arr = (value) => (Array.isArray(value) ? value : []);
+/** Where Codex's connectors (Figma, GitHub, …) are served from: one server, each connector's tools under its own namespace. */
+const CONNECTORS = "codex_apps";
+/** A page is a few hundred KB; this keeps a runaway resource off the tunnel. */
+const MAX_RESOURCE = 4 * 1024 * 1024;
+/** The list is ~1 MB from Codex's connectors alone: not re-read for every unknown tool. */
+const REFRESH_COOLDOWN_MS = 30_000;
+/** How old a list `mcp.apps` answers from: someone opening the menu may just have installed a plugin. */
+const APPS_MAX_AGE_MS = 30_000;
+const MAX_PENDING = 200;
+const MAX_PAGES = 20;
+/** `plugin/installed` waits on remote marketplaces (30 s when one doesn't answer): the list doesn't wait longer than this for it. */
+const PLUGIN_WAIT_MS = 1500;
+const PLUGIN_MAX_AGE_MS = 5 * 60_000;
+export class CodexMcpApps {
+    options;
+    servers = new Map();
+    loadedAt;
+    /** When the list was last asked for, read or not: misses wait out the cooldown from then. */
+    triedAt;
+    loading;
+    timer;
+    missed = new Map();
+    /**
+     * Tools a read didn't find for a call (uninstalled since): history is mapped
+     * again and again (a thread read from disk, every few seconds), and each time
+     * would have the list read again. Found again by any later read.
+     */
+    absent = new Set();
+    /** Plugins' display names by id, as last read. */
+    plugins = new Map();
+    pluginsAskedAt;
+    pluginsReading;
+    pluginsAnswered = false;
+    cooldown;
+    constructor(options) {
+        this.options = options;
+        this.cooldown = options.refreshCooldownMs ?? REFRESH_COOLDOWN_MS;
+    }
+    /**
+     * Looks up the tools of a thread's calls. A tool that isn't known has the
+     * list read again, and a page found then reaches the call's card late.
+     */
+    lookup(threadId) {
+        return (item) => {
+            const server = str(item.server);
+            const tool = str(item.tool);
+            if (!server || !tool)
+                return undefined;
+            const found = this.find(server, tool, str(obj(item.appContext)?.connectorId));
+            if (found || itemHasPage(item) || this.absent.has(`${server}\n${tool}`))
+                return found;
+            const id = str(item.id);
+            if (id)
+                this.miss(threadId, id, item);
+            return undefined;
+        };
+    }
+    async apps(_nativeId) {
+        if (this.loadedAt === undefined || Date.now() - this.loadedAt > APPS_MAX_AGE_MS)
+            await this.load();
+        const plugins = await this.pluginNames();
+        const apps = [];
+        for (const [serverName, server] of this.servers) {
+            for (const tool of server.tools.values()) {
+                const meta = tool._meta;
+                const entrypoints = arr(obj(meta?.["openai/ui"])?.entrypoints).flatMap((entry) => str(obj(entry)?.type) ?? []);
+                const app = descriptorPage(meta);
+                if (!app || !entrypoints.includes("thread"))
+                    continue;
+                const visibility = obj(meta?.ui)?.visibility;
+                apps.push({
+                    server: serverName,
+                    tool: tool.name,
+                    // "StupidMirror" says more than "show_screen".
+                    title: str(meta?.connector_name) ?? (server.pluginId ? plugins.get(server.pluginId) : undefined) ?? tool.title ?? server.title ?? tool.name,
+                    ...(tool.description ? { description: tool.description } : {}),
+                    resourceUri: app.resourceUri,
+                    entrypoints,
+                    ...(Array.isArray(visibility) ? { visibility: visibility.filter((entry) => typeof entry === "string") } : {}),
+                    ...(app.displayMode ? { displayMode: app.displayMode } : {}),
+                    ...(app.connector ? { connector: app.connector } : {}),
+                });
+            }
+        }
+        return apps;
+    }
+    async resource(nativeId, request) {
+        if (!isPageUri(request.uri))
+            throw RpcError.app("invalid_params", "只能读取插件页面（ui:// 开头的地址）");
+        // The thread's own MCP connection, where there is one to reach; Codex reads a page without it too.
+        const threadId = this.options.reach(nativeId) === "joined" ? nativeId : undefined;
+        const result = await this.codex("mcpServer/resource/read", { ...(threadId ? { threadId } : {}), server: request.server, uri: request.uri, ...(request.connector ? { connectorId: request.connector } : {}) }, threadId, "读取插件页面");
+        const first = obj(arr(result.contents)[0]);
+        if (!first)
+            throw RpcError.app("not_found", "插件没有给出这个页面");
+        const text = str(first.text);
+        const blob = str(first.blob);
+        const size = (text?.length ?? 0) + (blob?.length ?? 0);
+        if (size > MAX_RESOURCE)
+            throw RpcError.app("too_large", `插件页面有 ${(size / 1024 / 1024).toFixed(1)} MB，超过了 ${MAX_RESOURCE / 1024 / 1024} MB 的上限`);
+        return {
+            ...(str(first.mimeType) ? { mimeType: str(first.mimeType) } : {}),
+            ...(text !== undefined ? { text } : {}),
+            ...(blob !== undefined ? { blob } : {}),
+            ...(first._meta !== undefined ? { meta: first._meta } : {}),
+        };
+    }
+    async call(nativeId, request) {
+        if (this.options.reach(nativeId) === "held") {
+            throw RpcError.app("not_supported", "这个会话开在电脑的另一个 Codex 里，插件页面不能从这里调用工具");
+        }
+        const { server, tool, connector } = request;
+        if (server === CONNECTORS && !connector)
+            throw RpcError.app("invalid_params", "调用 codex_apps 的工具要说明是哪个插件（connector）");
+        let descriptor = this.find(server, tool, connector);
+        // A tool installed since the list was read: read it again, once.
+        if (!descriptor) {
+            await this.load();
+            descriptor = this.find(server, tool, connector);
+        }
+        if (!descriptor)
+            throw RpcError.app("not_found", `MCP 服务 ${server} 没有工具 ${tool}`);
+        const meta = descriptor._meta;
+        // Least privilege: a page may call its own server's tools, and only a server that has pages has them.
+        if (!this.hasPage(server, connector))
+            throw RpcError.app("forbidden", `MCP 服务 ${server} 没有插件页面，不能从页面调用它的工具`);
+        if (server === CONNECTORS && connectorOf(meta) !== connector)
+            throw RpcError.app("forbidden", "这个工具属于另一个插件，当前页面不能调用");
+        if (meta?.["openai/fileParams"] !== undefined)
+            throw RpcError.app("forbidden", "这个工具要读写电脑上的文件，插件页面不能直接调用");
+        const visibility = obj(meta?.ui)?.visibility;
+        if (Array.isArray(visibility) && !visibility.includes("app"))
+            throw RpcError.app("forbidden", "这个工具只给 Codex 自己调用，插件页面不能调用");
+        const result = await this.codex("mcpServer/tool/call", 
+        // The name as the server lists it: a `codex_apps` page may leave out its connector's namespace.
+        { threadId: nativeId, server, tool: descriptor.name, ...(request.arguments ? { arguments: request.arguments } : {}) }, nativeId, "调用插件工具");
+        return {
+            content: arr(result.content),
+            ...(result.structuredContent != null ? { structuredContent: result.structuredContent } : {}),
+            ...(typeof result.isError === "boolean" ? { isError: result.isError } : {}),
+            ...(result._meta != null ? { meta: result._meta } : {}),
+        };
+    }
+    stop() {
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        this.missed.clear();
+    }
+    /**
+     * A tool by the name a call or a page gives it. `codex_apps` lists its tools
+     * under their connector's namespace (`figma.generate_deck`), which a call or
+     * a page may leave out.
+     */
+    find(server, tool, connector) {
+        const tools = this.servers.get(server)?.tools;
+        if (!tools)
+            return undefined;
+        const exact = tools.get(tool);
+        if (exact && (!connector || server !== CONNECTORS || connectorOf(exact._meta) === connector))
+            return exact;
+        let match;
+        for (const [name, descriptor] of tools) {
+            if (!name.endsWith(`.${tool}`) || (connector && connectorOf(descriptor._meta) !== connector))
+                continue;
+            // Two connectors' tools of the same name: which one was meant isn't known.
+            if (match)
+                return undefined;
+            match = descriptor;
+        }
+        return match ?? exact;
+    }
+    hasPage(server, connector) {
+        for (const tool of this.servers.get(server)?.tools.values() ?? []) {
+            if ((server !== CONNECTORS || connectorOf(tool._meta) === connector) && descriptorPage(tool._meta))
+                return true;
+        }
+        return false;
+    }
+    miss(threadId, toolCallId, item) {
+        // What finding its page needs, not the whole result.
+        const result = obj(item.result);
+        this.missed.delete(toolCallId);
+        this.missed.set(toolCallId, {
+            threadId,
+            item: { id: toolCallId, server: item.server, tool: item.tool, appContext: item.appContext, mcpAppUi: item.mcpAppUi, mcpAppResourceUri: item.mcpAppResourceUri, ...(result ? { result: { _meta: result._meta } } : {}) },
+        });
+        if (this.missed.size > MAX_PENDING)
+            this.missed.delete(this.missed.keys().next().value);
+        this.schedule();
+    }
+    schedule() {
+        if (this.loading || this.timer || this.missed.size === 0)
+            return;
+        const wait = this.triedAt === undefined ? 0 : Math.max(0, this.triedAt + this.cooldown - Date.now());
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            void this.load().catch(() => { });
+        }, wait);
+        this.timer.unref?.();
+    }
+    /** Reads every server's tools again. Concurrent callers share one read. */
+    load() {
+        if (this.loading)
+            return this.loading;
+        const asked = new Set(this.missed.keys());
+        this.triedAt = Date.now();
+        this.loading = this.read()
+            .then((servers) => {
+            this.servers = servers;
+            this.loadedAt = Date.now();
+            this.settle(asked);
+        })
+            .catch((error) => {
+            // (An older Codex without the list fails every time: the calls it was read for get no page.)
+            for (const toolCallId of asked)
+                this.missed.delete(toolCallId);
+            this.options.log(`[codex] couldn't list MCP tools: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        })
+            .finally(() => {
+            this.loading = undefined;
+            // Calls that came in while the list was being read may name tools it predates.
+            this.schedule();
+        });
+        return this.loading;
+    }
+    async read() {
+        const servers = new Map();
+        let cursor;
+        for (let page = 0; page < MAX_PAGES; page++) {
+            const result = await this.codex("mcpServerStatus/list", 
+            // Tools and their metadata are enough; resources would add every server's inventory.
+            { detail: "toolsAndAuthOnly", limit: 100, ...(cursor ? { cursor } : {}) }, undefined, "列出 MCP 工具");
+            for (const raw of arr(result.data)) {
+                const entry = obj(raw);
+                const name = str(entry?.name);
+                if (!entry || !name)
+                    continue;
+                const tools = new Map();
+                for (const [key, value] of Object.entries(obj(entry.tools) ?? {})) {
+                    const tool = obj(value);
+                    if (!tool)
+                        continue;
+                    // Only what pages need: the input schemas are most of the megabyte.
+                    tools.set(key, {
+                        name: str(tool.name) ?? key,
+                        ...(str(tool.title) ? { title: str(tool.title) } : {}),
+                        ...(str(tool.description) ? { description: str(tool.description) } : {}),
+                        ...(obj(tool._meta) ? { _meta: obj(tool._meta) } : {}),
+                    });
+                }
+                servers.set(name, { pluginId: str(entry.pluginId), title: str(obj(entry.serverInfo)?.title), tools });
+            }
+            cursor = str(result.nextCursor);
+            if (!cursor)
+                break;
+        }
+        return servers;
+    }
+    /** Sends the pages found for the calls that were waiting; drops the ones the list was read for and that still aren't known. */
+    settle(asked) {
+        for (const [toolCallId, missed] of [...this.missed]) {
+            const server = str(missed.item.server);
+            const tool = str(missed.item.tool);
+            const descriptor = server && tool ? this.find(server, tool, str(obj(missed.item.appContext)?.connectorId)) : undefined;
+            if (!descriptor && !asked.has(toolCallId))
+                continue;
+            this.missed.delete(toolCallId);
+            if (!descriptor) {
+                this.absent.add(`${server}\n${tool}`);
+                if (this.absent.size > MAX_PENDING)
+                    this.absent.delete(this.absent.values().next().value);
+            }
+            const app = descriptor ? mcpPage(missed.item, () => descriptor) : undefined;
+            if (app)
+                this.options.lateDetail(missed.threadId, toolCallId, { type: "mcp", server: server, tool: tool, app });
+        }
+    }
+    /**
+     * Plugins' display names by id: what was last read, or what a read answers
+     * shortly. A read that takes longer goes on for the next list; until then
+     * titles fall back to the tools' own.
+     */
+    async pluginNames() {
+        if (!this.pluginsReading && (this.pluginsAskedAt === undefined || Date.now() - this.pluginsAskedAt > PLUGIN_MAX_AGE_MS)) {
+            this.pluginsAskedAt = Date.now();
+            this.pluginsReading = this.options
+                .request("plugin/installed", {})
+                .then((result) => {
+                const names = new Map();
+                for (const marketplace of arr(result.marketplaces)) {
+                    for (const raw of arr(obj(marketplace)?.plugins)) {
+                        const plugin = obj(raw);
+                        const id = str(plugin?.id);
+                        const name = str(obj(plugin?.interface)?.displayName);
+                        if (id && name)
+                            names.set(id, name);
+                    }
+                }
+                // A marketplace that didn't answer this time still had its plugins' names.
+                this.plugins = new Map([...this.plugins, ...names]);
+                this.pluginsAnswered = true;
+            })
+                .catch(() => {
+                // An older Codex without it: titles stay the tools' own.
+            })
+                .finally(() => {
+                this.pluginsReading = undefined;
+            });
+        }
+        // Names read before are good enough while they are read again.
+        if (this.pluginsReading && !this.pluginsAnswered) {
+            let timer;
+            await Promise.race([this.pluginsReading, new Promise((resolve) => (timer = setTimeout(resolve, PLUGIN_WAIT_MS)))]);
+            clearTimeout(timer);
+        }
+        return this.plugins;
+    }
+    /** A Codex request, its failures said in the user's words. */
+    async codex(method, params, threadId, what) {
+        try {
+            return await this.options.request(method, params, threadId);
+        }
+        catch (error) {
+            if (error instanceof RpcError && error.appCode === "agent_unavailable")
+                throw RpcError.app("agent_unavailable", "电脑上的 Codex 现在没有运行");
+            if (error instanceof RpcError && error.appCode === "timeout")
+                throw RpcError.app("timeout", `Codex ${what}超时`);
+            if (error instanceof RpcError && error.appCode)
+                throw error;
+            throw RpcError.app("agent_error", `Codex 没能${what}：${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=mcp-apps.js.map

package/dist/host/src/drivers/codex/mcp-apps.js.map

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

package/dist/host/src/drivers/codex/settings.d.ts

@@ -54,6 +54,19 @@ export declare function effective(settings: CodexSettings, overrides: CodexOverr
     effort: string | undefined;
     permissions: string | undefined;
 };
+/**
+ * What a new thread can be started on (`agents.models`): the same list a
+ * thread's model option shows, and `configured` (config.toml's model) or else
+ * Codex's default as the one `thread/start` without a model would use.
+ */
+export declare function newThreadModels(models: CodexModel[], configured: string | undefined): {
+    models: {
+        value: string;
+        name: string;
+        description?: string;
+    }[];
+    current?: string;
+};
 export declare function configOptions(settings: CodexSettings, overrides: CodexOverrides, models: CodexModel[]): SessionConfigOption[];
 /** `turn/start` parameters for the pending overrides. `current` is what the thread runs with (a mode names its model). */
 export declare function turnOverrides(overrides: CodexOverrides, current?: {

package/dist/host/src/drivers/codex/settings.js

@@ -73,16 +73,32 @@ export function effective(settings, overrides, models) {
     const permissions = overrides.permissions ?? presetOf(settings);
     return { model, info, effort, permissions };
 }
+/** The models to choose from while `current` is in use: hidden ones only when it is one, and `current` even if Codex doesn't list it. */
+function modelValues(models, current) {
+    const visible = models.filter((m) => !m.hidden || m.model === current);
+    if (!current || visible.length === 0)
+        return [];
+    const values = visible.map((m) => ({ value: m.model, name: m.displayName || m.model, description: m.description || undefined }));
+    if (!values.some((v) => v.value === current))
+        values.unshift({ value: current, name: current, description: undefined });
+    return values;
+}
+/**
+ * What a new thread can be started on (`agents.models`): the same list a
+ * thread's model option shows, and `configured` (config.toml's model) or else
+ * Codex's default as the one `thread/start` without a model would use.
+ */
+export function newThreadModels(models, configured) {
+    const { model } = effective({ model: configured }, {}, models);
+    const values = modelValues(models, model);
+    return values.length > 0 ? { models: values, current: model } : { models: [] };
+}
 export function configOptions(settings, overrides, models) {
     const { model, info, effort, permissions } = effective(settings, overrides, models);
     const options = [];
-    const visible = models.filter((m) => !m.hidden || m.model === model);
-    if (model && visible.length > 0) {
-        const values = visible.map((m) => ({ value: m.model, name: m.displayName || m.model, description: m.description || undefined }));
-        if (!values.some((v) => v.value === model))
-            values.unshift({ value: model, name: model, description: undefined });
+    const values = modelValues(models, model);
+    if (model && values.length > 0)
         options.push({ id: "model", name: "Model", category: "model", current: model, values });
-    }
     const efforts = info?.supportedReasoningEfforts ?? [];
     if (effort && efforts.length > 1) {
         options.push({

package/dist/host/src/drivers/codex/settings.js.map

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

package/dist/host/src/drivers/types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentAuth, AsyncQuestion, GoalChange, SessionGoal, AgentCapabilities, AgentTier, BackgroundTask, ContentBlock, QueuedMessage, QuestionAnswer, SessionState, SessionUpdate, SessionNotice, AcpAgentSettings, AcpFeatures, AcpProvider, PendingPermissionSummary, EditorRequest, EditorResult } from "@linkshell/wire";
+import type { AgentAuth, AsyncQuestion, GoalChange, SessionGoal, AgentCapabilities, AgentTier, BackgroundTask, ContentBlock, QueuedMessage, QuestionAnswer, SessionState, SessionUpdate, SessionNotice, AcpAgentSettings, AcpFeatures, AcpProvider, PendingPermissionSummary, EditorRequest, EditorResult, MethodParams, MethodResult } from "@linkshell/wire";
 import type { PreviewInput } from "../computer-preview.js";
 import type { DriverBehavior } from "./behavior.js";
 /** A session the agent knows about, however it was created. */
@@ -14,6 +14,17 @@ export interface DiscoveredSession {
     /** When supplied, the agent's own archive state is authoritative. */
     archived?: boolean;
     asyncQuestions?: AsyncQuestion[];
+    /** The native id of the session (of the same agent) this one was forked from, when the agent records it. Kept by the host once seen. */
+    forkedFrom?: string;
+}
+/** Where a session came from, as native ids of the same agent, most likely first (the host takes the first it has). */
+export interface SessionLineage {
+    /** The session that started this one. */
+    parent?: string[];
+    /** The session this one was forked from. */
+    forkedFrom?: string[];
+    /** The id an app of the agent's knows the session by (the Claude app's `local_…`). */
+    appId?: string;
 }
 /**
  * One completed item of native history (a message, a tool call, …) expressed as
@@ -78,6 +89,8 @@ export interface DriverHost {
     queue(agent: string, nativeId: string, items: QueuedMessage[]): void;
     /** The agent deleted a session itself (e.g. from its own UI). */
     removed(agent: string, nativeId: string): void;
+    /** What `lineage` or `appArchive` says of these sessions changed (the agent's records did): the host takes it in and tells clients. */
+    nativeRecordsChanged?(agent: string, nativeIds: string[]): void;
     /** The background tasks the host has on record for the session (from `ls_task` updates), to reconcile with what the agent says now. */
     tasks(agent: string, nativeId: string): BackgroundTask[];
     /** The terminal currently driving a handoff session, if any. */
@@ -87,11 +100,33 @@ export interface DriverHost {
         get(key: string): string | undefined;
         set(key: string, value: string): void;
     };
+    /** Durable values for the agent as a whole, not one session (survive host restarts). */
+    agentState?(agent: string): {
+        get(key: string): string | undefined;
+        set(key: string, value: string): void;
+    };
     log(message: string): void;
 }
 export interface AttachContext {
     cwd: string;
 }
+export interface SideRequest {
+    sideId: string;
+    /** The session's directory. */
+    cwd: string;
+    question: string;
+    /** The side conversation so far, for an agent that doesn't keep it itself. */
+    history: {
+        question: string;
+        answer: string;
+    }[];
+}
+/** Where a side answer goes as it is written. */
+export interface SideOutput {
+    text(delta: string): void;
+    /** One step of the agent's on the way (a file read, a search). */
+    activity(line: string): void;
+}
 /** A terminal running an agent's native UI via `linkshell <agent>`. */
 export interface DesktopController {
     /** Asks the terminal to exit its native UI; resolves once it has (or went away). */
@@ -118,6 +153,12 @@ export interface LaunchSpec {
     args: string[];
     env?: Record<string, string>;
 }
+/** A session's MCP Apps, by the session's native id (see `mcp.*` in the wire). */
+export interface McpAppsSupport {
+    apps(nativeId: string): Promise<MethodResult<"mcp.apps">["apps"]>;
+    resource(nativeId: string, request: Omit<MethodParams<"mcp.resource">, "sessionId">): Promise<MethodResult<"mcp.resource">>;
+    call(nativeId: string, request: Omit<MethodParams<"mcp.call">, "sessionId">): Promise<MethodResult<"mcp.call">>;
+}
 export interface AgentDriver {
     readonly id: string;
     readonly label: string;
@@ -151,6 +192,8 @@ export interface AgentDriver {
         baseUrl?: string;
         headers?: Record<string, string>;
     }): Promise<AcpProvider[]>;
+    /** MCP tools with pages of their own (`mcp.*`); only Codex offers them. */
+    readonly mcpApps?: McpAppsSupport;
     listSessions(limit: number): Promise<DiscoveredSession[]>;
     /** Native archives, including sessions that disappeared from recent discovery. Never implies deletion. */
     archivedSessions?(): Promise<string[]>;
@@ -158,6 +201,29 @@ export interface AgentDriver {
     sessionExists?(nativeId: string, cwd: string): boolean;
     /** Missing native history can be hidden reversibly; an unreadable store is not proof of deletion. */
     nativeSessionAvailability?(nativeId: string, cwd: string): "available" | "missing" | "unknown";
+    /**
+     * Where a session came from, by records the agent keeps outside the
+     * session (the Claude desktop app's). Asked for every summary sent, so it
+     * answers from memory; `nativeRecordsChanged` says when an answer changes.
+     */
+    lineage?(nativeId: string): SessionLineage | undefined;
+    /**
+     * Whether an app of the agent's that LinkShell can only read (the Claude
+     * desktop app) has the session archived, and the latest time it can have
+     * changed. Undefined when that app doesn't have the session, or isn't read
+     * yet. From memory, like `lineage`; the host merges it with its own flag.
+     */
+    appArchive?(nativeId: string): {
+        archived: boolean;
+        at: number;
+    } | undefined;
+    /**
+     * The models a new session could start on, and the one it starts on when
+     * `createSession` is given none (`cwd`: where it would work). Only what the
+     * driver can say without starting a session or a turn; absent, or an empty
+     * list, where it can't.
+     */
+    listModels?(cwd?: string): Promise<MethodResult<"agents.models">>;
     createSession(options: {
         cwd: string;
         model?: string;
@@ -174,6 +240,12 @@ export interface AgentDriver {
      * while someone is looking.
      */
     watched?(nativeId: string, open: boolean): void;
+    /**
+     * Following an attached session costs this driver something for as long as
+     * it is attached (Claude polls the transcript): the host detaches one nobody
+     * has open and nothing runs in, and attaches it again when it is opened.
+     */
+    readonly detachWhenIdle?: boolean;
     /**
      * `context`: what the agent should know before this message without it
      * being part of what the user said — the earlier conversation, for a session
@@ -206,6 +278,15 @@ export interface AgentDriver {
     taskOutput?(nativeId: string, taskId: string, before: number | undefined, limit: number): TaskOutput | undefined;
     /** Stops one background task (one whose record says `canStop`), leaving the turn and the other tasks alone. */
     stopTask?(nativeId: string, taskId: string): Promise<void>;
+    /**
+     * Answers a question in a side conversation of the session, the agent's own
+     * way (present only where the agent has one; `capabilities.side` says so).
+     * Nothing of it enters the session. Resolves when the answer is complete;
+     * `signal` stops it.
+     */
+    sideAsk?(nativeId: string, request: SideRequest, out: SideOutput, signal: AbortSignal): Promise<void>;
+    /** The side conversation is over: let go of whatever the agent keeps for it. */
+    sideClose?(nativeId: string, sideId: string): Promise<void>;
     archive?(nativeId: string, archived: boolean): Promise<void>;
     rename?(nativeId: string, title: string): Promise<void>;
     /** Deletes the agent's own record of the session. */

package/dist/host/src/host.js

@@ -3,7 +3,7 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "n
 import { homedir, hostname, platform } from "node:os";
 import { join } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
-import { DEFAULT_ICE_SERVERS } from "@linkshell/wire";
+import { DEFAULT_ICE_SERVERS, HOST_PROTOCOL } from "@linkshell/wire";
 import { defaultDrivers, remoteDriver } from "./drivers/registry.js";
 import { AcpSettingsStore } from "./acp-settings.js";
 import { SessionHub } from "./hub.js";
@@ -127,6 +127,7 @@ export async function startHost(options) {
         hostname: process.env.LINKSHELL_MACHINE_NAME || hostname(),
         platform: platform(),
         hostVersion: options.version,
+        protocol: HOST_PROTOCOL,
         home: homedir(),
         agents: hub.agents(),
         // LINKSHELL_ICE_SERVERS: STUN servers for the direct channel, comma separated ("off": never direct).