linkshell-cli 0.3.11 → 0.3.13

package/dist/cli/src/runtime/acp/agent-workspace.d.ts

@@ -46,6 +46,7 @@ export declare class AgentWorkspaceProxy {
     private commandForConversation;
     private executeCommand;
     private executeNativeCommand;
+    private executeGitNativeCommand;
     private handleRequest;
     private handleNotification;
     private handleAgentMessageDelta;

package/dist/cli/src/runtime/acp/agent-workspace.js

@@ -1,4 +1,5 @@
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { spawn } from "node:child_process";
 import { homedir } from "node:os";
 import { basename, join, relative } from "node:path";
 import { createEnvelope, parseTypedPayload, } from "@linkshell/protocol";
@@ -10,6 +11,8 @@ import { listCodexStoredSessions, loadCodexStoredTimeline } from "./codex-sessio
 import { resolveAgentCommand } from "./provider-resolver.js";
 const PERMISSION_TIMEOUT_MS = 5 * 60_000;
 const MAX_TIMELINE_ITEMS = 200;
+const MAX_SNAPSHOT_ITEMS = 80;
+const MAX_SNAPSHOT_TEXT_BYTES = 128 * 1024;
 function id(prefix) {
     return `${prefix}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 }
@@ -23,6 +26,62 @@ function stringify(value) {
         return String(value);
     }
 }
+function truncateUtf8(value, maxBytes = MAX_SNAPSHOT_TEXT_BYTES) {
+    if (!value)
+        return value;
+    if (Buffer.byteLength(value, "utf8") <= maxBytes)
+        return value;
+    let end = Math.min(value.length, maxBytes);
+    while (end > 0 && Buffer.byteLength(value.slice(0, end), "utf8") > maxBytes) {
+        end = Math.floor(end * 0.9);
+    }
+    return `${value.slice(0, end)}\n\n[truncated by LinkShell: original ${Buffer.byteLength(value, "utf8")} bytes]`;
+}
+function snapshotContentBlocks(blocks, options = {}) {
+    if (!blocks)
+        return undefined;
+    return blocks.map((block) => block.type === "image" && options.stripImages !== false
+        ? { ...block, data: undefined, text: block.text || "图片附件" }
+        : { ...block, text: truncateUtf8(block.text) });
+}
+function snapshotTimelineItem(item, options = {}) {
+    return {
+        ...item,
+        content: snapshotContentBlocks(item.content, options),
+        text: truncateUtf8(item.text),
+        toolCall: item.toolCall
+            ? {
+                ...item.toolCall,
+                input: truncateUtf8(item.toolCall.input),
+                output: truncateUtf8(item.toolCall.output),
+            }
+            : undefined,
+        commandExecution: item.commandExecution
+            ? {
+                ...item.commandExecution,
+                command: truncateUtf8(item.commandExecution.command, 16 * 1024),
+                output: truncateUtf8(item.commandExecution.output),
+            }
+            : undefined,
+        fileChange: item.fileChange
+            ? {
+                ...item.fileChange,
+                diff: truncateUtf8(item.fileChange.diff),
+                summary: truncateUtf8(item.fileChange.summary),
+            }
+            : undefined,
+        permission: item.permission
+            ? {
+                ...item.permission,
+                toolInput: truncateUtf8(item.permission.toolInput),
+                context: truncateUtf8(item.permission.context),
+            }
+            : undefined,
+    };
+}
+function snapshotTimelineItems(items) {
+    return items.slice(-MAX_SNAPSHOT_ITEMS).map((item) => snapshotTimelineItem(item));
+}
 function asRecord(value) {
     return typeof value === "object" && value ? value : undefined;
 }
@@ -558,6 +617,23 @@ function providerLabel(provider) {
 const ALL_REASONING_EFFORTS = ["none", "minimal", "low", "medium", "high", "xhigh"];
 const CLAUDE_REASONING_EFFORTS = ["low", "medium", "high", "xhigh"];
 const AGENT_PERMISSION_MODES = ["read_only", "workspace_write", "full_access"];
+const COMMAND_OUTPUT_MAX_BYTES = 96 * 1024;
+const LINKSHELL_NATIVE_COMMANDS = [
+    { name: "status", description: "Show current Agent and workspace status", category: "LinkShell", argsMode: "none" },
+    { name: "plan", description: "Enter Plan mode for the next turn", category: "Agent", argsMode: "none" },
+    { name: "exit-plan", description: "Exit Plan mode", category: "Agent", argsMode: "none" },
+    { name: "review", description: "Ask the Agent to review current local changes", category: "Agent", argsMode: "optional" },
+    { name: "subagents", description: "Ask the Agent to split work across subagents when useful", category: "Agent", argsMode: "optional" },
+    { name: "compact", description: "Compact the active Codex context", category: "Codex", argsMode: "none", providers: ["codex"] },
+    { name: "clear", description: "Start a fresh Agent context for this conversation", category: "Agent", argsMode: "none", destructive: true },
+    { name: "git-status", description: "Show branch and working tree status", category: "Git", argsMode: "none" },
+    { name: "git-diff", description: "Show a compact diffstat for current changes", category: "Git", argsMode: "none" },
+    { name: "git-commit", description: "Commit staged changes with the given message", category: "Git", argsMode: "required" },
+    { name: "git-pull", description: "Pull with fast-forward only", category: "Git", argsMode: "none" },
+    { name: "git-push", description: "Push the current branch", category: "Git", argsMode: "none" },
+    { name: "git-stash", description: "Stash current working tree changes", category: "Git", argsMode: "optional" },
+    { name: "git-stash-pop", description: "Pop the latest stash", category: "Git", argsMode: "none" },
+];
 const CLAUDE_REMOTE_HIDDEN_COMMANDS = new Set([
     "add-dir",
     "agents",
@@ -819,17 +895,30 @@ function customClaudeCommands(cwd) {
 }
 function defaultProviderCommands(provider, cwd, enabled) {
     const disabledReason = enabled ? undefined : `${providerLabel(provider)} 未安装或启动失败`;
+    const linkshellCommands = LINKSHELL_NATIVE_COMMANDS
+        .filter((command) => !command.providers || command.providers.includes(provider))
+        .map((command) => makeCommand({
+        provider,
+        name: command.name,
+        description: command.description,
+        source: "linkshell",
+        category: command.category,
+        argsMode: command.argsMode ?? "optional",
+        destructive: command.destructive,
+        disabledReason,
+        executionKind: "native",
+    }));
     if (provider === "codex") {
-        return [];
+        return linkshellCommands;
     }
     if (provider === "claude") {
         const custom = customClaudeCommands(cwd).map((command) => ({
             ...command,
             disabledReason: command.disabledReason ?? disabledReason,
         }));
-        return custom;
+        return [...linkshellCommands, ...custom];
     }
-    return [];
+    return linkshellCommands;
 }
 function mergeCommands(...groups) {
     const map = new Map();
@@ -846,6 +935,76 @@ function mergeCommands(...groups) {
     }
     return [...map.values()].sort((a, b) => a.name.localeCompare(b.name));
 }
+function isGitNativeCommand(name) {
+    return name === "git-status" ||
+        name === "git-diff" ||
+        name === "git-commit" ||
+        name === "git-pull" ||
+        name === "git-push" ||
+        name === "git-stash" ||
+        name === "git-stash-pop";
+}
+function gitCommandArgs(name, args) {
+    const message = args?.trim();
+    switch (name) {
+        case "git-status":
+            return { display: "git status --short --branch", argv: ["status", "--short", "--branch"] };
+        case "git-diff":
+            return { display: "git diff --stat", argv: ["diff", "--stat"] };
+        case "git-commit":
+            if (!message)
+                throw new Error("请先输入提交信息，例如 /git-commit fix mobile agent timeline");
+            return { display: `git commit -m ${JSON.stringify(message)}`, argv: ["commit", "-m", message] };
+        case "git-pull":
+            return { display: "git pull --ff-only", argv: ["pull", "--ff-only"] };
+        case "git-push":
+            return { display: "git push", argv: ["push"] };
+        case "git-stash":
+            return {
+                display: "git stash push -u",
+                argv: ["stash", "push", "-u", "-m", message || "LinkShell mobile stash"],
+            };
+        case "git-stash-pop":
+            return { display: "git stash pop", argv: ["stash", "pop"] };
+        default:
+            throw new Error(`未知 Git 命令：/${name}`);
+    }
+}
+function runProcess(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        const maxBytes = options.maxBytes ?? COMMAND_OUTPUT_MAX_BYTES;
+        let output = "";
+        let bytes = 0;
+        let truncated = false;
+        const append = (chunk) => {
+            if (bytes >= maxBytes) {
+                truncated = true;
+                return;
+            }
+            const remaining = maxBytes - bytes;
+            const slice = chunk.byteLength > remaining ? chunk.subarray(0, remaining) : chunk;
+            output += slice.toString("utf8");
+            bytes += slice.byteLength;
+            if (slice.byteLength < chunk.byteLength)
+                truncated = true;
+        };
+        child.stdout.on("data", append);
+        child.stderr.on("data", append);
+        child.once("error", reject);
+        child.once("close", (exitCode, signal) => {
+            resolve({
+                output: `${output.trimEnd()}${truncated ? "\n\n[truncated by LinkShell]" : ""}`,
+                exitCode,
+                signal,
+            });
+        });
+    });
+}
 function runtimeCommands(provider, value) {
     const raw = asRecord(value);
     const commandsValue = Array.isArray(value) ? value :
@@ -1308,7 +1467,7 @@ export class AgentWorkspaceProxy {
                 hostDeviceId: this.input.hostDeviceId,
                 payload: {
                     conversation: existingConversation,
-                    snapshot: this.timelines.get(existingConversation.id) ?? [],
+                    snapshot: snapshotTimelineItems(this.timelines.get(existingConversation.id) ?? []),
                 },
             }));
             return existingConversation;
@@ -1355,7 +1514,7 @@ export class AgentWorkspaceProxy {
             this.input.send(createEnvelope({
                 type: "agent.v2.conversation.opened",
                 hostDeviceId: this.input.hostDeviceId,
-                payload: { conversation, snapshot: this.timelines.get(conversation.id) ?? [] },
+                payload: { conversation, snapshot: snapshotTimelineItems(this.timelines.get(conversation.id) ?? []) },
             }));
             return conversation;
         }
@@ -1394,7 +1553,7 @@ export class AgentWorkspaceProxy {
         this.input.send(createEnvelope({
             type: "agent.v2.conversation.opened",
             hostDeviceId: this.input.hostDeviceId,
-            payload: { conversation, snapshot: this.timelines.get(conversation.id) ?? [] },
+            payload: { conversation, snapshot: snapshotTimelineItems(this.timelines.get(conversation.id) ?? []) },
         }));
         return conversation;
     }
@@ -1582,14 +1741,8 @@ export class AgentWorkspaceProxy {
                 this.emitStatus(conversation.id, conversation.status, `${providerLabel(conversation.provider)} · ${conversation.collaborationMode === "plan" ? "Plan mode" : "Default mode"} · ${conversation.cwd}`);
                 return;
             }
-            if (conversation.provider !== "codex") {
-                this.addItem(conversation.id, {
-                    id: id("error"),
-                    conversationId: conversation.id,
-                    type: "error",
-                    error: `${command.title} 暂无 ${providerLabel(conversation.provider)} 原生实现。`,
-                    createdAt: now,
-                });
+            if (isGitNativeCommand(command.name)) {
+                await this.executeGitNativeCommand(conversation, command.name, args);
                 return;
             }
             if (command.name === "plan" || command.name === "exit-plan") {
@@ -1604,6 +1757,21 @@ export class AgentWorkspaceProxy {
                     : "已退出 Plan mode。");
                 return;
             }
+            if (command.name === "review" || command.name === "subagents") {
+                const prompt = command.name === "review"
+                    ? args || "Review the current local changes."
+                    : args || "Run subagents for distinct tasks in parallel when useful, then synthesize the results.";
+                await this.sendPrompt({
+                    conversationId: conversation.id,
+                    clientMessageId: id(command.name),
+                    contentBlocks: [{ type: "text", text: prompt }],
+                    model: conversation.model,
+                    reasoningEffort: conversation.reasoningEffort,
+                    permissionMode: conversation.permissionMode,
+                    collaborationMode: conversation.collaborationMode,
+                });
+                return;
+            }
             if (command.name === "compact") {
                 if (!(client instanceof AcpClient))
                     throw new Error("当前 Codex runtime 不支持原生 compact。");
@@ -1642,21 +1810,6 @@ export class AgentWorkspaceProxy {
                 this.emitStatus(conversation.id, "idle", "上下文已重置，已创建新的 Codex thread。");
                 return;
             }
-            if (command.name === "review" || command.name === "subagents") {
-                const prompt = command.name === "review"
-                    ? args || "Review the current local changes."
-                    : args || "Run subagents for distinct tasks in parallel when useful, then synthesize the results.";
-                await this.sendPrompt({
-                    conversationId: conversation.id,
-                    clientMessageId: id(command.name),
-                    contentBlocks: [{ type: "text", text: prompt }],
-                    model: conversation.model,
-                    reasoningEffort: conversation.reasoningEffort,
-                    permissionMode: conversation.permissionMode,
-                    collaborationMode: conversation.collaborationMode,
-                });
-                return;
-            }
             throw new Error(`命令暂未实现：/${command.name}`);
         }
         catch (error) {
@@ -1671,6 +1824,41 @@ export class AgentWorkspaceProxy {
             });
         }
     }
+    async executeGitNativeCommand(conversation, commandName, args) {
+        const git = gitCommandArgs(commandName, args);
+        const toolId = id(commandName);
+        const now = Date.now();
+        conversation.status = "running";
+        conversation.lastMessagePreview = git.display;
+        conversation.lastActivityAt = now;
+        this.emitConversation(conversation);
+        this.upsertTool(conversation.id, {
+            id: toolId,
+            name: "命令",
+            input: `${git.display}\n\ncwd: ${conversation.cwd}`,
+            createdAt: now,
+            status: "running",
+        });
+        const result = await runProcess("git", git.argv, {
+            cwd: conversation.cwd,
+            maxBytes: COMMAND_OUTPUT_MAX_BYTES,
+        });
+        const ok = result.exitCode === 0;
+        this.upsertTool(conversation.id, {
+            id: toolId,
+            name: "命令",
+            input: `${git.display}\n\ncwd: ${conversation.cwd}`,
+            output: result.output || (ok ? "完成" : `退出码 ${result.exitCode ?? "unknown"}`),
+            createdAt: now,
+            status: ok ? "completed" : "failed",
+        });
+        conversation.status = ok ? "idle" : "error";
+        conversation.lastMessagePreview = ok
+            ? `${git.display} 完成`
+            : `${git.display} 失败`;
+        conversation.lastActivityAt = Date.now();
+        this.emitConversation(conversation);
+    }
     handleRequest(method, params) {
         if (method === "item/tool/requestUserInput" || method === "tool/requestUserInput") {
             return this.handleStructuredInput(params, true);
@@ -2550,7 +2738,7 @@ export class AgentWorkspaceProxy {
         this.input.send(createEnvelope({
             type: "agent.v2.event",
             hostDeviceId: this.input.hostDeviceId,
-            payload: { conversationId, conversation, item },
+            payload: { conversationId, conversation, item: snapshotTimelineItem(item, { stripImages: false }) },
         }));
     }
     emitConversation(conversation) {
@@ -2603,8 +2791,8 @@ export class AgentWorkspaceProxy {
         }
         const conversations = [...this.conversations.values()];
         const items = conversationId
-            ? this.timelines.get(conversationId) ?? []
-            : [...this.timelines.values()].flat();
+            ? snapshotTimelineItems(this.timelines.get(conversationId) ?? [])
+            : [];
         this.input.send(createEnvelope({
             type: "agent.v2.snapshot",
             hostDeviceId: this.input.hostDeviceId,