linkshell-cli 0.5.41 → 0.6.0

package/dist/host/src/drivers/claude/transcript.d.ts

@@ -0,0 +1,335 @@
+import type { SessionUpdate, ToolDetail, ToolKind } from "@linkshell/wire";
+type Json = Record<string, unknown>;
+export declare function claudeConfigDir(env?: NodeJS.ProcessEnv): string;
+/** Claude's project directory name for a cwd: every non-alphanumeric character becomes "-". */
+export declare function encodeProjectDir(cwd: string): string;
+export declare function findTranscript(configDir: string, sessionId: string, cwd?: string): string | undefined;
+/** A readable title and kind for a Claude Code tool call. */
+export declare function describeClaudeTool(name: string, input: Json): {
+    title: string;
+    kind: ToolKind;
+    detail?: ToolDetail;
+};
+export interface TranscriptLineResult {
+    updates: SessionUpdate[];
+    /** When the line was written (ms). */
+    ts?: number;
+    /** A title set by /rename or generated by Claude. */
+    title?: string;
+}
+/** Converts one transcript line to wire updates. Sub-agent files pass `sidechain`. */
+export declare function transcriptLine(raw: string, options?: {
+    sidechain?: boolean;
+}): TranscriptLineResult;
+/** Parses a whole transcript file. */
+/** When each transcript update happened, for history import. */
+export declare const transcriptTimes: WeakMap<{
+    content: {
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        mimeType: string;
+        data?: string | undefined;
+        uri?: string | undefined;
+    } | {
+        type: "resource_link";
+        name: string;
+        uri: string;
+        kind?: "file" | "agent" | "skill" | undefined;
+    };
+    sessionUpdate: "user_message_chunk";
+    messageId?: string | undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        mimeType: string;
+        data?: string | undefined;
+        uri?: string | undefined;
+    } | {
+        type: "resource_link";
+        name: string;
+        uri: string;
+        kind?: "file" | "agent" | "skill" | undefined;
+    };
+    messageId: string;
+    sessionUpdate: "agent_message_chunk";
+    parentToolCallId?: string | undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        mimeType: string;
+        data?: string | undefined;
+        uri?: string | undefined;
+    } | {
+        type: "resource_link";
+        name: string;
+        uri: string;
+        kind?: "file" | "agent" | "skill" | undefined;
+    };
+    messageId: string;
+    sessionUpdate: "agent_thought_chunk";
+    parentToolCallId?: string | undefined;
+} | {
+    status: "pending" | "completed" | "failed" | "in_progress";
+    kind: "search" | "other" | "read" | "edit" | "delete" | "move" | "execute" | "think" | "fetch";
+    title: string;
+    toolCallId: string;
+    sessionUpdate: "tool_call";
+    content?: ({
+        type: "content";
+        content: {
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            mimeType: string;
+            data?: string | undefined;
+            uri?: string | undefined;
+        } | {
+            type: "resource_link";
+            name: string;
+            uri: string;
+            kind?: "file" | "agent" | "skill" | undefined;
+        };
+    } | {
+        path: string;
+        type: "diff";
+        newText: string;
+        oldText?: string | null | undefined;
+    } | {
+        path: string;
+        type: "patch";
+        diff: string;
+        change: "add" | "update" | "delete";
+        movePath?: string | undefined;
+    } | {
+        type: "terminal";
+        terminalId: string;
+    })[] | undefined;
+    detail?: {
+        type: "mcp";
+        tool: string;
+        server: string;
+    } | {
+        type: "subagent";
+        action: "message" | "spawn" | "resume" | "stop" | "wait" | "list";
+        model?: string | undefined;
+        task?: string | undefined;
+        agentType?: string | undefined;
+    } | {
+        type: "skill";
+        name: string;
+        description?: string | undefined;
+    } | {
+        type: "web_search";
+        query?: string | undefined;
+    } | {
+        type: "image_generation";
+        prompt?: string | undefined;
+    } | {
+        type: "compaction";
+    } | {
+        type: "review";
+        phase: "finished" | "started";
+    } | undefined;
+    rawInput?: unknown;
+    parentToolCallId?: string | undefined;
+    locations?: {
+        path: string;
+        line?: number | undefined;
+    }[] | undefined;
+} | {
+    toolCallId: string;
+    sessionUpdate: "tool_call_update";
+    status?: "pending" | "completed" | "failed" | "in_progress" | undefined;
+    content?: ({
+        type: "content";
+        content: {
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            mimeType: string;
+            data?: string | undefined;
+            uri?: string | undefined;
+        } | {
+            type: "resource_link";
+            name: string;
+            uri: string;
+            kind?: "file" | "agent" | "skill" | undefined;
+        };
+    } | {
+        path: string;
+        type: "diff";
+        newText: string;
+        oldText?: string | null | undefined;
+    } | {
+        path: string;
+        type: "patch";
+        diff: string;
+        change: "add" | "update" | "delete";
+        movePath?: string | undefined;
+    } | {
+        type: "terminal";
+        terminalId: string;
+    })[] | undefined;
+    title?: string | undefined;
+    detail?: {
+        type: "mcp";
+        tool: string;
+        server: string;
+    } | {
+        type: "subagent";
+        action: "message" | "spawn" | "resume" | "stop" | "wait" | "list";
+        model?: string | undefined;
+        task?: string | undefined;
+        agentType?: string | undefined;
+    } | {
+        type: "skill";
+        name: string;
+        description?: string | undefined;
+    } | {
+        type: "web_search";
+        query?: string | undefined;
+    } | {
+        type: "image_generation";
+        prompt?: string | undefined;
+    } | {
+        type: "compaction";
+    } | {
+        type: "review";
+        phase: "finished" | "started";
+    } | undefined;
+    rawOutput?: unknown;
+    parentToolCallId?: string | undefined;
+    appendOutput?: string | undefined;
+} | {
+    entries: {
+        status: "pending" | "completed" | "in_progress";
+        content: string;
+        priority: "low" | "medium" | "high";
+    }[];
+    sessionUpdate: "plan";
+} | {
+    sessionUpdate: "available_commands_update";
+    availableCommands: {
+        name: string;
+        description: string;
+        hint?: string | undefined;
+    }[];
+} | {
+    sessionUpdate: "current_mode_update";
+    currentModeId: string;
+} | {
+    sessionUpdate: "session_info_update";
+    title?: string | undefined;
+    model?: string | undefined;
+} | {
+    sessionUpdate: "usage_update";
+    contextWindow?: number | undefined;
+    usedTokens?: number | undefined;
+} | {
+    role: "user" | "agent" | "thought";
+    messageId: string;
+    sessionUpdate: "ls_message_done";
+    parentToolCallId?: string | undefined;
+} | {
+    options: {
+        values: {
+            value: string;
+            name: string;
+            description?: string | undefined;
+        }[];
+        id: string;
+        name: string;
+        category: "mode" | "other" | "model" | "effort";
+        current: string;
+    }[];
+    sessionUpdate: "ls_config";
+} | {
+    title: string;
+    sessionUpdate: "ls_notice";
+    level: "info" | "warning";
+    detail?: string | undefined;
+} | {
+    state: "started" | "ended";
+    sessionUpdate: "ls_turn";
+    turnId?: string | undefined;
+    parentToolCallId?: string | undefined;
+    stopReason?: "error" | "cancelled" | "end_turn" | "max_tokens" | "refusal" | undefined;
+} | {
+    options: {
+        name: string;
+        kind: "allow_once" | "allow_always" | "reject_once" | "reject_always";
+        optionId: string;
+    }[];
+    requestId: string;
+    title: string;
+    sessionUpdate: "ls_permission";
+    detail?: string | undefined;
+    toolCallId?: string | undefined;
+} | {
+    requestId: string;
+    sessionUpdate: "ls_permission_resolved";
+    optionId?: string | undefined;
+} | {
+    sessionUpdate: "ls_driver";
+    driver: "none" | "desktop" | "remote";
+    deviceId?: string | undefined;
+} | {
+    state: "idle" | "error" | "running" | "waiting" | "offline";
+    sessionUpdate: "ls_status";
+} | {
+    code: string;
+    message: string;
+    sessionUpdate: "ls_error";
+    hint?: string | undefined;
+}, number>;
+/**
+ * Claude Code keeps each sub-agent's transcript next to the session:
+ * `<session>/subagents/agent-<id>.jsonl`, with `agent-<id>.meta.json` naming
+ * the Agent/Task tool call that spawned it. Returns the sub-agents' work as
+ * updates nested under those calls (their prompt is the call's own input).
+ */
+export declare function readSubagents(transcriptPath: string): SessionUpdate[];
+/** Interleaves sub-agent updates into the session's by time, keeping each list's order. */
+export declare function mergeByTime(main: SessionUpdate[], nested: SessionUpdate[]): SessionUpdate[];
+export declare function readTranscript(path: string): {
+    updates: SessionUpdate[];
+    title?: string;
+    size: number;
+};
+/**
+ * Follows a transcript from a byte offset by polling (Claude only appends).
+ * `locate` is retried until the file exists, for sessions with no messages yet.
+ */
+export declare class TranscriptTail {
+    private readonly options;
+    private offset;
+    private carry;
+    private timer?;
+    private paused;
+    private path?;
+    constructor(options: {
+        locate: () => string | undefined;
+        offset: number;
+        onLine: (line: string) => void;
+        pollMs?: number;
+    });
+    start(): void;
+    stop(): void;
+    /** Stops emitting (the remote driver is writing); `resumeAtEnd` skips what was written meanwhile. */
+    pause(): void;
+    resumeAtEnd(): void;
+    /** Reads whatever is new right now. */
+    poll(): void;
+    private resolve;
+}
+export {};