linkshell-cli 0.10.74 → 0.10.76

package/dist/host/src/hub.d.ts

@@ -1,4 +1,4 @@
-import { type GoalChange, type BackgroundTask, type AgentInfo, type ContentBlock, type SessionEvent, type SessionSummary, type SubagentInfo, type QuestionAnswer, type GitInfo, type ProjectSummary, type WorktreeEntry, type SessionNotice, type AcpAgentSettings, type AcpRemoteAgent, type PendingPermissionSummary, type EditorRequest, type SideChat } from "@linkshell/wire";
+import { type GoalChange, type BackgroundTask, type AgentInfo, type ContentBlock, type SessionEvent, type SessionSummary, type SubagentInfo, type QuestionAnswer, type GitInfo, type ProjectSummary, type WorktreeEntry, type SessionNotice, type AcpAgentSettings, type AcpRemoteAgent, type PendingPermissionSummary, type EditorRequest, type SideChat, type MethodResult } from "@linkshell/wire";
 import type { AcpSettingsStore } from "./acp-settings.js";
 import type { AgentDriver, DesktopController, DesktopLaunchContext, DriverHost, LaunchSpec } from "./drivers/types.js";
 import { type HostStore } from "./store.js";
@@ -9,6 +9,17 @@ export interface Subscriber {
     /** The backlog that follows starts after `startSeq`, not where the subscriber left off. */
     window?(startSeq: number): void;
 }
+/**
+ * Archived here or in the app, unless it was unarchived here after the app
+ * archived it (`local.at` 0: chosen before times were kept, so it never outranks the app).
+ */
+export declare function mergedArchive(local: {
+    archived: boolean;
+    at: number;
+}, app: {
+    archived: boolean;
+    since: number;
+} | undefined): boolean;
 /**
  * The host's source of truth for sessions. Drivers push native events in;
  * the hub logs them with a per-session seq, keeps summaries current and fans
@@ -77,47 +88,53 @@ export declare class SessionHub {
     pendingInteractions(): {
         agent: string;
         request: {
+            requestId: string;
+            title: string;
             options: {
-                kind: "allow_once" | "allow_always" | "reject_once" | "reject_always";
-                name: string;
                 optionId: string;
+                name: string;
+                kind: "allow_once" | "allow_always" | "reject_once" | "reject_always";
             }[];
-            title: string;
-            requestId: string;
+            childSessionId?: string | undefined;
             toolCallId?: string | undefined;
+            detail?: string | undefined;
             tool?: {
-                kind?: "search" | "delete" | "other" | "read" | "edit" | "move" | "execute" | "think" | "fetch" | "switch_mode" | undefined;
                 title?: string | undefined;
+                kind?: "search" | "delete" | "other" | "read" | "edit" | "move" | "execute" | "think" | "fetch" | "switch_mode" | undefined;
+                rawInput?: unknown;
                 content?: ({
                     type: "content";
                     content: {
                         type: "text";
                         text: string;
-                        annotations?: import("zod").objectOutputType<{
-                            audience: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodEnum<["user", "assistant"]>, "many">>>, ("user" | "assistant")[] | undefined, ("user" | "assistant")[] | null | undefined>;
-                            priority: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>, number | undefined, number | null | undefined>;
-                            lastModified: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>, string | undefined, string | null | undefined>;
-                        }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+                        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?: import("zod").objectOutputType<{
-                            audience: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodEnum<["user", "assistant"]>, "many">>>, ("user" | "assistant")[] | undefined, ("user" | "assistant")[] | null | undefined>;
-                            priority: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>, number | undefined, number | null | undefined>;
-                            lastModified: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>, string | undefined, string | null | undefined>;
-                        }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+                        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?: import("zod").objectOutputType<{
-                            audience: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodEnum<["user", "assistant"]>, "many">>>, ("user" | "assistant")[] | undefined, ("user" | "assistant")[] | null | undefined>;
-                            priority: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>, number | undefined, number | null | undefined>;
-                            lastModified: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>, string | undefined, string | null | undefined>;
-                        }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+                        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;
@@ -125,68 +142,66 @@ export declare class SessionHub {
                         type: "resource";
                         resource: {
                             uri: string;
-                            text?: string | undefined;
-                            _meta?: Record<string, unknown> | undefined;
                             mimeType?: string | undefined;
+                            text?: string | undefined;
                             blob?: string | undefined;
                             assetUri?: string | undefined;
+                            _meta?: Record<string, unknown> | undefined;
                         };
-                        annotations?: import("zod").objectOutputType<{
-                            audience: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodEnum<["user", "assistant"]>, "many">>>, ("user" | "assistant")[] | undefined, ("user" | "assistant")[] | null | undefined>;
-                            priority: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>, number | undefined, number | null | undefined>;
-                            lastModified: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>, string | undefined, string | null | undefined>;
-                        }, import("zod").ZodTypeAny, "passthrough"> | 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" | "skill" | "agent" | undefined;
-                        annotations?: import("zod").objectOutputType<{
-                            audience: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodEnum<["user", "assistant"]>, "many">>>, ("user" | "assistant")[] | undefined, ("user" | "assistant")[] | null | undefined>;
-                            priority: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>, number | undefined, number | null | undefined>;
-                            lastModified: import("zod").ZodEffects<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>, string | undefined, string | null | undefined>;
-                        }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+                        annotations?: {
+                            [x: string]: unknown;
+                            audience?: ("user" | "assistant")[] | undefined;
+                            priority?: number | undefined;
+                            lastModified?: string | undefined;
+                        } | undefined;
                         _meta?: Record<string, unknown> | undefined;
-                        mimeType?: string | undefined;
                         title?: string | undefined;
                         description?: string | undefined;
+                        mimeType?: string | undefined;
                         size?: number | undefined;
                     };
                 } | {
-                    path: string;
                     type: "diff";
+                    path: string;
                     newText: string;
                     oldText?: string | null | undefined;
                 } | {
-                    path: string;
                     type: "patch";
-                    diff: string;
+                    path: string;
                     change: "add" | "delete" | "update";
+                    diff: string;
                     movePath?: string | undefined;
                 } | {
                     type: "terminal";
                     terminalId: string;
                 })[] | undefined;
-                rawInput?: unknown;
                 locations?: {
                     path: string;
                     line?: number | undefined;
                 }[] | undefined;
             } | undefined;
-            detail?: string | undefined;
+            url?: {
+                url: string;
+                elicitationId: string;
+            } | undefined;
             questions?: {
-                kind: "text" | "choice" | "choices";
-                text: string;
                 id: string;
-                options?: {
-                    value: string;
-                    label: string;
-                    description?: string | undefined;
-                }[] | undefined;
-                other?: boolean | undefined;
+                text: string;
+                kind: "text" | "choice" | "choices";
                 constraints?: {
-                    type: "string" | "number" | "boolean" | "integer" | "array";
+                    type: "string" | "number" | "boolean" | "array" | "integer";
                     minimum?: number | undefined;
                     maximum?: number | undefined;
                     minLength?: number | undefined;
@@ -198,42 +213,24 @@ export declare class SessionHub {
                 } | undefined;
                 defaults?: string[] | undefined;
                 header?: string | undefined;
+                options?: {
+                    value: string;
+                    label: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                other?: boolean | undefined;
                 secret?: boolean | undefined;
                 required?: boolean | undefined;
             }[] | undefined;
-            childSessionId?: string | undefined;
-            url?: {
-                url: string;
-                elicitationId: string;
-            } | undefined;
         };
     }[];
     editor(input: EditorRequest): Promise<{
+        editorId?: string | undefined;
         path?: string | undefined;
         text?: string | undefined;
         version?: number | undefined;
-        preview?: {
-            kind: "edit" | "jump" | "searchAndReplace";
-            path: string;
-            id: string;
-            before: string;
-            after: string;
-            position?: {
-                line: number;
-                character: number;
-            } | undefined;
-        } | undefined;
-        position?: {
-            line: number;
-            character: number;
-        } | undefined;
-        editorId?: string | undefined;
         suggestions?: ({
-            kind: "edit";
-            uri: string;
-            id: string;
             edits: {
-                newText: string;
                 range: {
                     start: {
                         line: number;
@@ -244,36 +241,55 @@ export declare class SessionHub {
                         character: number;
                     };
                 };
+                newText: string;
             }[];
+            id: string;
+            uri: string;
+            kind: "edit";
             cursorPosition?: {
                 line: number;
                 character: number;
             } | null | undefined;
         } | {
-            kind: "jump";
-            uri: string;
-            id: string;
             position: {
                 line: number;
                 character: number;
             };
-        } | {
-            kind: "rename";
-            uri: string;
             id: string;
+            uri: string;
+            kind: "jump";
+        } | {
             position: {
                 line: number;
                 character: number;
             };
             newName: string;
+            id: string;
+            uri: string;
+            kind: "rename";
         } | {
-            replace: string;
             search: string;
-            kind: "searchAndReplace";
-            uri: string;
+            replace: string;
             id: string;
+            uri: string;
+            kind: "searchAndReplace";
             isRegex?: boolean | null | undefined;
         })[] | undefined;
+        preview?: {
+            id: string;
+            path: string;
+            before: string;
+            after: string;
+            kind: "edit" | "jump" | "searchAndReplace";
+            position?: {
+                line: number;
+                character: number;
+            } | undefined;
+        } | undefined;
+        position?: {
+            line: number;
+            character: number;
+        } | undefined;
     }>;
     configureAcp(agent: string, settings: AcpAgentSettings, sessionId?: string): Promise<void>;
     authenticate(agent: string, methodId?: string, logout?: boolean): Promise<{
@@ -289,9 +305,9 @@ export declare class SessionHub {
         baseUrl?: string;
         headers?: Record<string, string>;
     }): Promise<{
-        required: boolean;
         providerId: string;
         supported: string[];
+        required: boolean;
         current?: {
             apiType: string;
             baseUrl: string;
@@ -315,6 +331,11 @@ export declare class SessionHub {
     /** Asked for every project each time the list is: remembered for a moment. */
     private branchOf;
     getSession(sessionId: string): SessionSummary;
+    /** A session and its agent's driver, unchecked: for what one driver offers itself (`mcp.*`), which says what it needs of it. */
+    sessionDriver(sessionId: string): {
+        session: SessionSummary;
+        driver: AgentDriver | undefined;
+    };
     /** Adds the live-only fields (current activity, first pending permission) to a stored summary. */
     /** Marks a session that works in one of LinkShell's worktrees. */
     private withWorktree;
@@ -322,7 +343,20 @@ export declare class SessionHub {
     private worktrees;
     private readonly pendingQuestions;
     private questionsOf;
+    /** Per session, the session it was forked from (null: none), read from the store once. */
+    private readonly forkOrigins;
+    /** Per session, the sessions whose lineage names it: their rows change when it comes or goes. */
+    private readonly related;
+    private forkOrigin;
+    /** Where the session came from, naming only sessions this host has: a list can't nest under one it doesn't show. */
+    private withLineage;
+    /** As the Claude app nests: a session still in use stands alone when the one it came from is archived. */
+    private firstKnown;
+    /** The session came, went or was (un)archived: the rows that name it as parent or origin say so now. */
+    private announceRelated;
     private decorate;
+    /** What a new session of `agent` could run on (see `agents.models`): nothing from a driver that can't tell before a session exists. */
+    agentModels(agent: string, cwd?: string): Promise<MethodResult<"agents.models">>;
     createSession(input: {
         agent: string;
         cwd: string;
@@ -416,6 +450,9 @@ export declare class SessionHub {
     private sendHeld;
     onRemoved(listener: (sessionId: string) => void): () => void;
     archive(sessionId: string, archived: boolean): Promise<SessionSummary>;
+    /** Folds in the archive state of the agent's app that LinkShell only reads (see `mergedArchive`). */
+    private reconcileAppArchive;
+    private localArchive;
     rename(sessionId: string, title: string): Promise<SessionSummary>;
     /**
      * Deletes a session. A worktree only it used goes too when nothing in it