@linkshell/wire 0.2.31 → 0.2.32

package/dist/rpc.d.ts

@@ -923,6 +923,23 @@ declare const coreMethods: {
         }, z.core.$strip>;
         readonly result: z.ZodObject<{}, z.core.$loose>;
     };
+    /** Opens a local path in the chosen desktop editor, file manager, or terminal (local only). */
+    readonly "desktop.openPath": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            app: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                terminal: "terminal";
+                reveal: "reveal";
+                cursor: "cursor";
+                vscode: "vscode";
+                zed: "zed";
+            }>>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            ok: z.ZodBoolean;
+        }, z.core.$strip>;
+    };
     readonly "usage.summary": {
         readonly params: z.ZodObject<{
             days: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<7>, z.ZodLiteral<30>]>>;
@@ -1248,6 +1265,7 @@ declare const coreMethods: {
         readonly params: z.ZodObject<{
             limit: z.ZodOptional<z.ZodNumber>;
             before: z.ZodOptional<z.ZodNumber>;
+            beforeId: z.ZodOptional<z.ZodString>;
             includeArchived: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
         readonly result: z.ZodObject<{
@@ -1557,6 +1575,319 @@ declare const coreMethods: {
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
             nextBefore: z.ZodOptional<z.ZodNumber>;
+            nextBeforeId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly "sessions.get": {
+        readonly params: z.ZodObject<{
+            sessionId: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            session: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                agent: z.ZodString;
+                nativeId: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                preview: z.ZodOptional<z.ZodString>;
+                cwd: z.ZodString;
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    error: "error";
+                    running: "running";
+                    idle: "idle";
+                    waiting: "waiting";
+                    offline: "offline";
+                }>;
+                driver: z.ZodOptional<z.ZodEnum<{
+                    remote: "remote";
+                    desktop: "desktop";
+                    none: "none";
+                }>>;
+                pendingPermissions: z.ZodNumber;
+                model: z.ZodOptional<z.ZodString>;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+                lastSeq: z.ZodNumber;
+                archived: z.ZodBoolean;
+                activity: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        thinking: "thinking";
+                        responding: "responding";
+                        tool: "tool";
+                    }>;
+                    title: z.ZodOptional<z.ZodString>;
+                    toolKind: z.ZodOptional<z.ZodEnum<{
+                        search: "search";
+                        delete: "delete";
+                        read: "read";
+                        edit: "edit";
+                        move: "move";
+                        execute: "execute";
+                        think: "think";
+                        fetch: "fetch";
+                        switch_mode: "switch_mode";
+                        other: "other";
+                    }>>;
+                }, z.core.$strip>>;
+                permission: z.ZodOptional<z.ZodObject<{
+                    requestId: z.ZodString;
+                    childSessionId: z.ZodOptional<z.ZodString>;
+                    toolCallId: z.ZodOptional<z.ZodString>;
+                    title: z.ZodString;
+                    detail: z.ZodOptional<z.ZodString>;
+                    tool: z.ZodOptional<z.ZodObject<{
+                        title: z.ZodOptional<z.ZodString>;
+                        kind: z.ZodOptional<z.ZodEnum<{
+                            search: "search";
+                            delete: "delete";
+                            read: "read";
+                            edit: "edit";
+                            move: "move";
+                            execute: "execute";
+                            think: "think";
+                            fetch: "fetch";
+                            switch_mode: "switch_mode";
+                            other: "other";
+                        }>>;
+                        rawInput: z.ZodOptional<z.ZodUnknown>;
+                        content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"content">;
+                            content: z.ZodType<{
+                                type: "text";
+                                text: string;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                            } | {
+                                type: "image";
+                                mimeType: string;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                                data?: string | undefined;
+                                uri?: string | undefined;
+                            } | {
+                                type: "audio";
+                                mimeType: string;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                                data?: string | undefined;
+                                uri?: string | undefined;
+                            } | {
+                                type: "resource";
+                                resource: {
+                                    uri: string;
+                                    mimeType?: string | undefined;
+                                    text?: string | undefined;
+                                    blob?: string | undefined;
+                                    assetUri?: string | undefined;
+                                    _meta?: Record<string, unknown> | undefined;
+                                };
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                            } | {
+                                type: "resource_link";
+                                uri: string;
+                                name: string;
+                                kind?: "file" | "agent" | "skill" | undefined;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                                title?: string | undefined;
+                                description?: string | undefined;
+                                mimeType?: string | undefined;
+                                size?: number | undefined;
+                            }, unknown, z.core.$ZodTypeInternals<{
+                                type: "text";
+                                text: string;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                            } | {
+                                type: "image";
+                                mimeType: string;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                                data?: string | undefined;
+                                uri?: string | undefined;
+                            } | {
+                                type: "audio";
+                                mimeType: string;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                                data?: string | undefined;
+                                uri?: string | undefined;
+                            } | {
+                                type: "resource";
+                                resource: {
+                                    uri: string;
+                                    mimeType?: string | undefined;
+                                    text?: string | undefined;
+                                    blob?: string | undefined;
+                                    assetUri?: string | undefined;
+                                    _meta?: Record<string, unknown> | undefined;
+                                };
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                            } | {
+                                type: "resource_link";
+                                uri: string;
+                                name: string;
+                                kind?: "file" | "agent" | "skill" | undefined;
+                                annotations?: {
+                                    [x: string]: unknown;
+                                    audience?: ("user" | "assistant")[] | undefined;
+                                    priority?: number | undefined;
+                                    lastModified?: string | undefined;
+                                } | undefined;
+                                _meta?: Record<string, unknown> | undefined;
+                                title?: string | undefined;
+                                description?: string | undefined;
+                                mimeType?: string | undefined;
+                                size?: number | undefined;
+                            }, unknown>>;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"diff">;
+                            path: z.ZodString;
+                            oldText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            newText: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"patch">;
+                            path: z.ZodString;
+                            change: z.ZodEnum<{
+                                add: "add";
+                                delete: "delete";
+                                update: "update";
+                            }>;
+                            movePath: z.ZodOptional<z.ZodString>;
+                            diff: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"terminal">;
+                            terminalId: z.ZodString;
+                        }, z.core.$strip>], "type">>>;
+                        locations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            path: z.ZodString;
+                            line: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$strip>>>;
+                    }, z.core.$strip>>;
+                    url: z.ZodOptional<z.ZodObject<{
+                        url: z.ZodString;
+                        elicitationId: z.ZodString;
+                    }, z.core.$strip>>;
+                    options: z.ZodArray<z.ZodObject<{
+                        optionId: z.ZodString;
+                        name: z.ZodString;
+                        kind: z.ZodEnum<{
+                            allow_once: "allow_once";
+                            allow_always: "allow_always";
+                            reject_once: "reject_once";
+                            reject_always: "reject_always";
+                        }>;
+                    }, z.core.$strip>>;
+                    questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        constraints: z.ZodOptional<z.ZodObject<{
+                            type: z.ZodEnum<{
+                                string: "string";
+                                number: "number";
+                                boolean: "boolean";
+                                array: "array";
+                                integer: "integer";
+                            }>;
+                            minimum: z.ZodOptional<z.ZodNumber>;
+                            maximum: z.ZodOptional<z.ZodNumber>;
+                            minLength: z.ZodOptional<z.ZodNumber>;
+                            maxLength: z.ZodOptional<z.ZodNumber>;
+                            minItems: z.ZodOptional<z.ZodNumber>;
+                            maxItems: z.ZodOptional<z.ZodNumber>;
+                            pattern: z.ZodOptional<z.ZodString>;
+                            format: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                        defaults: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        header: z.ZodOptional<z.ZodString>;
+                        text: z.ZodString;
+                        kind: z.ZodEnum<{
+                            text: "text";
+                            choice: "choice";
+                            choices: "choices";
+                        }>;
+                        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            value: z.ZodString;
+                            label: z.ZodString;
+                            description: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>>;
+                        other: z.ZodOptional<z.ZodBoolean>;
+                        secret: z.ZodOptional<z.ZodBoolean>;
+                        required: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+                asyncQuestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    options: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>>>;
+                queue: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    clientMessageId: z.ZodString;
+                    text: z.ZodString;
+                    images: z.ZodNumber;
+                }, z.core.$strip>>>;
+                worktree: z.ZodOptional<z.ZodObject<{
+                    branch: z.ZodString;
+                    source: z.ZodString;
+                }, z.core.$strip>>;
+                parentId: z.ZodOptional<z.ZodString>;
+                forkedFrom: z.ZodOptional<z.ZodString>;
+                appId: z.ZodOptional<z.ZodString>;
+                subagents: z.ZodOptional<z.ZodObject<{
+                    total: z.ZodNumber;
+                    running: z.ZodNumber;
+                }, z.core.$strip>>;
+                tasks: z.ZodOptional<z.ZodObject<{
+                    total: z.ZodNumber;
+                    running: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
     };
     /**
@@ -1749,6 +2080,7 @@ declare const coreMethods: {
                 size?: number | undefined;
             }, unknown>>>>;
             clientMessageId: z.ZodOptional<z.ZodString>;
+            requestId: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
             config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             worktree: z.ZodOptional<z.ZodBoolean>;
@@ -3139,6 +3471,7 @@ declare const coreMethods: {
                         mimeType?: string | undefined;
                         size?: number | undefined;
                     }, unknown>>;
+                    replace: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>, z.ZodObject<{
                     sessionUpdate: z.ZodLiteral<"agent_thought_chunk">;
                     parentToolCallId: z.ZodOptional<z.ZodString>;
@@ -3278,6 +3611,7 @@ declare const coreMethods: {
                         mimeType?: string | undefined;
                         size?: number | undefined;
                     }, unknown>>;
+                    replace: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>, z.ZodObject<{
                     sessionUpdate: z.ZodLiteral<"tool_call">;
                     toolCallId: z.ZodString;
@@ -4830,6 +5164,7 @@ declare const coreMethods: {
                         mimeType?: string | undefined;
                         size?: number | undefined;
                     }, unknown>>;
+                    replace: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>, z.ZodObject<{
                     sessionUpdate: z.ZodLiteral<"agent_thought_chunk">;
                     parentToolCallId: z.ZodOptional<z.ZodString>;
@@ -4969,6 +5304,7 @@ declare const coreMethods: {
                         mimeType?: string | undefined;
                         size?: number | undefined;
                     }, unknown>>;
+                    replace: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>, z.ZodObject<{
                     sessionUpdate: z.ZodLiteral<"tool_call">;
                     toolCallId: z.ZodString;
@@ -7304,6 +7640,20 @@ declare const coreMethods: {
             ok: z.ZodBoolean;
         }, z.core.$strip>;
     };
+    /** Commits staged or specified paths inside `cwd`'s repository. */
+    readonly "git.commit": {
+        readonly params: z.ZodObject<{
+            cwd: z.ZodString;
+            message: z.ZodString;
+            stageAll: z.ZodOptional<z.ZodBoolean>;
+            paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            sha: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            summary: z.ZodString;
+        }, z.core.$strip>;
+    };
     /** The worktrees LinkShell made, newest first. */
     readonly "worktrees.list": {
         readonly params: z.ZodObject<{}, z.core.$loose>;
@@ -7395,13 +7745,16 @@ declare const coreMethods: {
     };
     /**
      * Saves a file from the device into `dir`. A name that's taken gets a
-     * numbered suffix ("photo 2.jpg") rather than overwriting.
+     * numbered suffix ("photo 2.jpg") rather than overwriting; subsequent chunks
+     * pass `appendPath` and `offset` so each chunk stays below the relay frame cap.
      */
     readonly "fs.upload": {
         readonly params: z.ZodObject<{
             dir: z.ZodString;
             name: z.ZodString;
             data: z.ZodString;
+            offset: z.ZodOptional<z.ZodNumber>;
+            appendPath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         readonly result: z.ZodObject<{
             path: z.ZodString;
@@ -8485,6 +8838,7 @@ export declare const notifications: {
                 mimeType?: string | undefined;
                 size?: number | undefined;
             }, unknown>>;
+            replace: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             sessionUpdate: z.ZodLiteral<"agent_thought_chunk">;
             parentToolCallId: z.ZodOptional<z.ZodString>;
@@ -8624,6 +8978,7 @@ export declare const notifications: {
                 mimeType?: string | undefined;
                 size?: number | undefined;
             }, unknown>>;
+            replace: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             sessionUpdate: z.ZodLiteral<"tool_call">;
             toolCallId: z.ZodString;

package/dist/rpc.js

@@ -122,6 +122,14 @@ const acpMethods = {
 };
 const coreMethods = {
     "desktop.shutdown": { params: z.object({ pid: z.number().int().positive() }), result: empty },
+    /** Opens a local path in the chosen desktop editor, file manager, or terminal (local only). */
+    "desktop.openPath": {
+        params: z.object({
+            path: z.string().min(1),
+            app: z.enum(["default", "reveal", "cursor", "vscode", "zed", "terminal"]).optional(),
+        }),
+        result: z.object({ ok: z.boolean() }),
+    },
     "usage.summary": { params: usageQuerySchema, result: usageReportSchema },
     "liveActivities.subscribe": {
         params: liveActivitySubscriptionSchema,
@@ -158,13 +166,20 @@ const coreMethods = {
             limit: z.number().int().positive().max(200).optional(),
             /** Only sessions updated strictly before this timestamp (pagination). */
             before: z.number().optional(),
+            /** Tie-breaker session id when multiple sessions share the `before` timestamp. */
+            beforeId: z.string().optional(),
             includeArchived: z.boolean().optional(),
         }),
         result: z.object({
             sessions: z.array(sessionSummarySchema),
             nextBefore: z.number().optional(),
+            nextBeforeId: z.string().optional(),
         }),
     },
+    "sessions.get": {
+        params: z.object({ sessionId: z.string().min(1) }),
+        result: z.object({ session: sessionSummarySchema.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`).
@@ -198,6 +213,8 @@ const coreMethods = {
             cwd: z.string().min(1),
             prompt: z.array(contentBlockSchema).optional(),
             clientMessageId: z.string().optional(),
+            /** Client-generated idempotency key so a retried create does not spawn a duplicate session. */
+            requestId: z.string().max(128).optional(),
             /** One of `agents.models`' values; absent: the agent's own default. */
             model: z.string().optional(),
             /** Explicit choices from agents.models.config, applied before the first prompt. */
@@ -532,6 +549,20 @@ const coreMethods = {
         params: z.object({ cwd: z.string().min(1), path: z.string().min(1) }),
         result: z.object({ ok: z.boolean() }),
     },
+    /** Commits staged or specified paths inside `cwd`'s repository. */
+    "git.commit": {
+        params: z.object({
+            cwd: z.string().min(1),
+            message: z.string().min(1).max(4000),
+            stageAll: z.boolean().optional(),
+            paths: z.array(z.string().min(1)).max(500).optional(),
+        }),
+        result: z.object({
+            sha: z.string(),
+            branch: z.string().optional(),
+            summary: z.string(),
+        }),
+    },
     /** The worktrees LinkShell made, newest first. */
     "worktrees.list": { params: empty, result: z.object({ worktrees: z.array(worktreeEntrySchema) }) },
     /** Removes a worktree and its branch. Refused (`busy`) while a session uses it, or (`dirty`) when work in it would be lost, unless `force`. */
@@ -600,14 +631,17 @@ const coreMethods = {
     },
     /**
      * Saves a file from the device into `dir`. A name that's taken gets a
-     * numbered suffix ("photo 2.jpg") rather than overwriting.
+     * numbered suffix ("photo 2.jpg") rather than overwriting; subsequent chunks
+     * pass `appendPath` and `offset` so each chunk stays below the relay frame cap.
      */
     "fs.upload": {
         params: z.object({
             dir: z.string().min(1),
             name: z.string().min(1).max(255),
-            /** base64; up to ~30 MB of file. */
-            data: z.string().max(40_000_000),
+            /** base64; up to ~20 MB single-shot upload (smaller when chunked via `offset`/`appendPath`). */
+            data: z.string().max(30_000_000),
+            offset: z.number().int().nonnegative().optional(),
+            appendPath: z.string().optional(),
         }),
         result: z.object({ path: z.string(), size: z.number().int() }),
     },