@linkshell/wire 0.2.21 → 0.2.22

package/src/rpc.ts

@@ -22,6 +22,7 @@ import {
 } from "./model.js";
 import { contentBlockSchema, sessionEventSchema, sessionNoticeSchema } from "./updates.js";
 import { sideChatSchema } from "./side.js";
+import { mcpMethods } from "./rpc-mcp.js";
 
 // ── JSON-RPC 2.0 framing ─────────────────────────────────────────────
 
@@ -73,8 +74,9 @@ export const RPC_APP_ERROR = -32000;
  * methods or notifications an app may rely on, so an app can tell the
  * computer is older than itself and say so (an absent revision is 0).
  * 1: side conversations (`sessions.side`), `machine.info.protocol` itself.
+ * 2: session terminals (`terminals.create` `sessionId`, `TerminalInfo.sessionId`).
  */
-export const HOST_PROTOCOL = 1;
+export const HOST_PROTOCOL = 2;
 
 const empty = z.object({}).passthrough();
 
@@ -149,12 +151,36 @@ const coreMethods = {
       nextBefore: z.number().optional(),
     }),
   },
+  /**
+   * The models a new session of `agent` can start on, for choosing one before
+   * there is a session (whose own list comes later, in its `ls_config`).
+   * `current` is the one the agent takes when `sessions.create` names none:
+   * its own default, which a new session keeps unless another is picked.
+   * Agents that tell their models only to a session give what they said in
+   * the latest one opened on this computer; never asked by starting one, so
+   * empty until there has been one (`current` too may be missing then).
+   * With an empty list `sessions.create` takes no model. Hosts older than
+   * this method answer "method not found".
+   */
+  "agents.models": {
+    params: z.object({
+      agent: z.string().min(1),
+      /** Where the session will work: an agent's project settings can choose another model. */
+      cwd: z.string().optional(),
+    }),
+    result: z.object({
+      /** As a session's model option lists them (`group`: the heading some agents put models under). */
+      models: z.array(z.object({ value: z.string(), name: z.string(), description: z.string().optional(), group: z.string().optional() })),
+      current: z.string().optional(),
+    }),
+  },
   "sessions.create": {
     params: z.object({
       agent: z.string().min(1),
       cwd: z.string().min(1),
       prompt: z.array(contentBlockSchema).optional(),
       clientMessageId: z.string().optional(),
+      /** One of `agents.models`' values; absent: the agent's own default. */
       model: z.string().optional(),
       /**
        * Start in a new git worktree of `cwd`'s repository (its own branch, from
@@ -566,6 +592,8 @@ const coreMethods = {
   "terminals.create": {
     params: z.object({
       cwd: z.string().optional(),
+      /** Open it for this session, in its directory unless `cwd` says otherwise (see `TerminalInfo.sessionId`). */
+      sessionId: z.string().optional(),
       /** Run this in the shell right away (the shell stays open after it). */
       command: z.string().max(4000).optional(),
       cols: z.number().int().min(10).max(1000).default(80),
@@ -700,7 +728,7 @@ const coreMethods = {
   },
 } as const;
 
-export const methods: typeof coreMethods & typeof acpMethods = { ...coreMethods, ...acpMethods };
+export const methods: typeof coreMethods & typeof acpMethods & typeof mcpMethods = { ...coreMethods, ...acpMethods, ...mcpMethods };
 
 export type MethodName = keyof typeof methods;
 export type MethodParams<M extends MethodName> = z.input<(typeof methods)[M]["params"]>;

package/src/updates.ts

@@ -21,8 +21,22 @@ export type ToolCallLocation = z.infer<typeof toolCallLocationSchema>;
  * Host drivers fill it from each agent's own tool names; clients render it the
  * same way for every agent and fall back to `title` + `kind` without it.
  */
+export const mcpAppDisplayModeSchema = z.enum(["inline", "fullscreen"]);
+
 export const toolDetailSchema = z.discriminatedUnion("type", [
-  z.object({ type: z.literal("mcp"), server: z.string(), tool: z.string() }),
+  z.object({
+    type: z.literal("mcp"),
+    server: z.string(),
+    tool: z.string(),
+    /**
+     * The tool has a page of its own (an MCP App), which `mcp.resource` reads.
+     * Codex sessions only. It may arrive in a later `tool_call_update` than the
+     * call's card, when the host had to look the tool up first. `connector`:
+     * the Codex connector (server `codex_apps`) the page belongs to, which
+     * `mcp.call` needs for that server.
+     */
+    app: z.object({ resourceUri: z.string(), displayMode: mcpAppDisplayModeSchema.optional(), connector: z.string().optional() }).optional(),
+  }),
   z.object({
     type: z.literal("subagent"),
     /** spawn starts a sub-agent (its work nests under this call); the rest talk to one. */