@jingyi0605/codingns 0.3.5 → 0.4.0

package/dist/server/modules/assistant-capability/assistant-capability-service.js

@@ -1,5 +1,7 @@
 import { createId } from "../../shared/utils/id.js";
+import { AppError } from "../../shared/errors/app-error.js";
 import { nowIso } from "../../shared/utils/time.js";
+import { recordButlerProxyMessageOrigin } from "../sessions/session-message-origin-utils.js";
 const ASSISTANT_CAPABILITIES = [
     {
         name: "capabilities.list",
@@ -25,6 +27,18 @@ const ASSISTANT_CAPABILITIES = [
         enabled: true,
         summary: "列出指定项目下可操作的会话"
     },
+    {
+        name: "projects.sessions.start",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "按当前助手配置为项目新建真实会话"
+    },
+    {
+        name: "sessions.start",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "按 project/workspace/sandbox 目标新建真实会话；未指定目标时自动创建沙箱"
+    },
     {
         name: "sessions.get",
         mode: "read",
@@ -55,6 +69,90 @@ const ASSISTANT_CAPABILITIES = [
         enabled: true,
         summary: "从指定会话或消息点 fork 新会话"
     },
+    {
+        name: "automations.list",
+        mode: "read",
+        enabled: true,
+        summary: "列出当前助手自动化任务"
+    },
+    {
+        name: "automations.get",
+        mode: "read",
+        enabled: true,
+        summary: "读取单个助手自动化任务详情"
+    },
+    {
+        name: "automations.create",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "创建正式助手自动化任务"
+    },
+    {
+        name: "automations.cancel",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "取消助手自动化任务"
+    },
+    {
+        name: "automations.runs.list",
+        mode: "read",
+        enabled: true,
+        summary: "读取助手自动化执行记录"
+    },
+    {
+        name: "sandboxes.list",
+        mode: "read",
+        enabled: true,
+        summary: "列出当前助手沙箱"
+    },
+    {
+        name: "sandboxes.create",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "创建新的助手沙箱"
+    },
+    {
+        name: "sandboxes.promote",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "保留或晋升助手沙箱"
+    },
+    {
+        name: "sandboxes.expire",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "标记助手沙箱过期"
+    },
+    {
+        name: "sandboxes.remove",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "清理助手沙箱"
+    },
+    {
+        name: "timers.list",
+        mode: "read",
+        enabled: true,
+        summary: "列出当前助手会话相关的计时器"
+    },
+    {
+        name: "timers.get",
+        mode: "read",
+        enabled: true,
+        summary: "读取单个助手计时器详情"
+    },
+    {
+        name: "timers.create",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "创建助手控制会话的定时继续任务"
+    },
+    {
+        name: "timers.cancel",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "取消助手控制会话计时器"
+    },
     {
         name: "terminals.list",
         mode: "read",
@@ -72,27 +170,193 @@ const ASSISTANT_CAPABILITIES = [
         mode: "proxy_execute",
         enabled: true,
         summary: "向受控终端发送输入"
+    },
+    {
+        name: "terminals.close",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "关闭指定受控终端"
+    },
+    {
+        name: "debug-targets.compatibility-matrix.get",
+        mode: "read",
+        enabled: true,
+        summary: "读取调试框架兼容矩阵"
+    },
+    {
+        name: "debug-targets.analyze",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "分析工作区调试目标和服务"
+    },
+    {
+        name: "debug-targets.framework-analysis.get",
+        mode: "read",
+        enabled: true,
+        summary: "读取调试目标框架分析结果"
+    },
+    {
+        name: "debug-targets.framework-analysis.refresh",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "刷新调试目标框架分析结果"
+    },
+    {
+        name: "debug-targets.launch-plan.create",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "生成调试目标启动计划，支持显式端口请求"
+    },
+    {
+        name: "debug-targets.run",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "启动调试目标，支持显式端口请求"
+    },
+    {
+        name: "debug-targets.runtime-latest.get",
+        mode: "read",
+        enabled: true,
+        summary: "读取调试目标最近一次运行态"
+    },
+    {
+        name: "debug-targets.runtimes.list",
+        mode: "read",
+        enabled: true,
+        summary: "读取调试目标运行历史"
+    },
+    {
+        name: "debug-runtimes.get",
+        mode: "read",
+        enabled: true,
+        summary: "读取指定调试运行时详情"
+    },
+    {
+        name: "workspaces.list",
+        mode: "read",
+        enabled: true,
+        summary: "列出当前可见工作区"
+    },
+    {
+        name: "workspaces.browse",
+        mode: "read",
+        enabled: true,
+        summary: "浏览可导入的本地目录"
+    },
+    {
+        name: "workspaces.directory.create",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "创建新的工作区目录"
+    },
+    {
+        name: "workspaces.import",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "把已有目录导入成工作区"
+    },
+    {
+        name: "workspaces.clone",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "克隆仓库并导入成工作区"
+    },
+    {
+        name: "workspaces.reorder",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "调整工作区显示顺序"
+    },
+    {
+        name: "workspaces.management.get",
+        mode: "read",
+        enabled: true,
+        summary: "读取工作区管理摘要"
+    },
+    {
+        name: "workspaces.navigation-state.update",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "更新工作区导航状态"
+    },
+    {
+        name: "workspaces.remove",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "移除工作区入口"
+    },
+    {
+        name: "worktrees.tree",
+        mode: "read",
+        enabled: true,
+        summary: "读取工作树结构"
+    },
+    {
+        name: "worktrees.create",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "创建子工作树"
+    },
+    {
+        name: "worktrees.merge-preview",
+        mode: "read",
+        enabled: true,
+        summary: "读取子工作树合并预览"
+    },
+    {
+        name: "worktrees.merge-into-parent",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "把子工作树合并回父工作区"
+    },
+    {
+        name: "worktrees.cleanup",
+        mode: "proxy_execute",
+        enabled: true,
+        summary: "清理子工作树"
     }
 ];
 export class AssistantCapabilityService {
     butlerProjectService;
     butlerSessionService;
+    butlerControlSessionService;
+    assistantAutomationService;
+    assistantSandboxService;
+    butlerControlTimerService;
     sessionHistoryService;
     sessionLiveRuntimeService;
     terminalService;
-    constructor(butlerProjectService, butlerSessionService, sessionHistoryService, sessionLiveRuntimeService, terminalService) {
+    debugTargetService;
+    workspaceService;
+    worktreeManager;
+    worktreeSyncService;
+    worktreeMergeService;
+    worktreeCleanupService;
+    sessionMessageOriginRepository;
+    constructor(butlerProjectService, butlerSessionService, butlerControlSessionService, assistantAutomationService, assistantSandboxService, butlerControlTimerService, sessionHistoryService, sessionLiveRuntimeService, terminalService, debugTargetService, workspaceService, worktreeManager, worktreeSyncService, worktreeMergeService, worktreeCleanupService, sessionMessageOriginRepository = null) {
         this.butlerProjectService = butlerProjectService;
         this.butlerSessionService = butlerSessionService;
+        this.butlerControlSessionService = butlerControlSessionService;
+        this.assistantAutomationService = assistantAutomationService;
+        this.assistantSandboxService = assistantSandboxService;
+        this.butlerControlTimerService = butlerControlTimerService;
         this.sessionHistoryService = sessionHistoryService;
         this.sessionLiveRuntimeService = sessionLiveRuntimeService;
         this.terminalService = terminalService;
+        this.debugTargetService = debugTargetService;
+        this.workspaceService = workspaceService;
+        this.worktreeManager = worktreeManager;
+        this.worktreeSyncService = worktreeSyncService;
+        this.worktreeMergeService = worktreeMergeService;
+        this.worktreeCleanupService = worktreeCleanupService;
+        this.sessionMessageOriginRepository = sessionMessageOriginRepository;
     }
     listCapabilities() {
         return this.createReceipt("capabilities.list", {
             kind: "none",
             id: null
         }, {
-            version: "2026-04-14",
+            version: "2026-04-16",
             items: ASSISTANT_CAPABILITIES
         });
     }
@@ -133,6 +397,72 @@ export class AssistantCapabilityService {
             items
         });
     }
+    async startProjectSession(input) {
+        const config = this.resolveSessionLaunchConfig(input);
+        const session = await this.butlerSessionService.startSession(input.projectId, {
+            role: "adhoc",
+            ownershipMode: "managed",
+            content: input.content.trim(),
+            providerId: config.providerId,
+            model: config.model,
+            reasoningLevel: config.reasoningLevel,
+            permissionMode: config.permissionMode
+        }, input.userId);
+        return this.createReceipt("projects.sessions.start", {
+            kind: "project",
+            id: input.projectId
+        }, {
+            session
+        });
+    }
+    async startSession(input) {
+        const config = this.resolveSessionLaunchConfig(input);
+        const currentControlSession = this.butlerControlSessionService.getCurrentSession(input.userId);
+        const target = input.target
+            ? this.resolveAssistantSessionTarget(input.target, input.userId)
+            : await this.createAutomaticSandboxTarget(input, currentControlSession);
+        if (target.kind === "project") {
+            const session = await this.butlerSessionService.startSession(target.id, {
+                role: "adhoc",
+                ownershipMode: "managed",
+                content: input.content.trim(),
+                providerId: config.providerId,
+                model: config.model,
+                reasoningLevel: config.reasoningLevel,
+                permissionMode: config.permissionMode
+            }, input.userId);
+            return this.createReceipt("sessions.start", {
+                kind: "project",
+                id: target.id
+            }, {
+                session,
+                target
+            });
+        }
+        const session = await this.sessionLiveRuntimeService.startLiveSession({
+            workspaceId: target.workspaceId,
+            userId: input.userId,
+            provider: config.providerId,
+            content: input.content.trim(),
+            clientRequestId: null,
+            runtimeOptions: {
+                model: config.model,
+                reasoningLevel: config.reasoningLevel,
+                permissionMode: config.permissionMode,
+                attachments: []
+            }
+        });
+        if (target.kind === "sandbox") {
+            this.assistantSandboxService.markSandboxUsedByControlSession(target.id, input.userId, currentControlSession?.id ?? null);
+        }
+        return this.createReceipt("sessions.start", {
+            kind: target.kind,
+            id: target.id
+        }, {
+            session,
+            target
+        });
+    }
     getSession(sessionId, userId) {
         const session = this.sessionHistoryService.getSession(sessionId, userId);
         return this.createReceipt("sessions.get", {
@@ -161,11 +491,19 @@ export class AssistantCapabilityService {
         });
     }
     async sendSessionMessage(input) {
+        const requestedAt = nowIso();
+        const clientRequestId = recordButlerProxyMessageOrigin(this.sessionMessageOriginRepository, {
+            sessionId: input.sessionId,
+            clientRequestId: input.clientRequestId?.trim() || null,
+            content: input.content,
+            createdAt: requestedAt,
+            fallbackKey: `assistant-send:${input.sessionId}:${requestedAt}`
+        });
         const result = await this.sessionLiveRuntimeService.sendLiveMessage({
             sessionId: input.sessionId,
             userId: input.userId,
             content: input.content,
-            clientRequestId: input.clientRequestId?.trim() || null,
+            clientRequestId,
             runtimeOptions: {
                 model: input.model?.trim() || null,
                 reasoningLevel: input.reasoningLevel?.trim() || null,
@@ -173,6 +511,14 @@ export class AssistantCapabilityService {
                 attachments: []
             }
         });
+        recordButlerProxyMessageOrigin(this.sessionMessageOriginRepository, {
+            sessionId: input.sessionId,
+            clientRequestId,
+            messageId: result.message?.messageId ?? null,
+            content: input.content,
+            createdAt: result.acceptedAt,
+            fallbackKey: `assistant-send:${input.sessionId}:${result.acceptedAt}`
+        });
         return this.createReceipt("sessions.message.send", {
             kind: "session",
             id: input.sessionId
@@ -196,6 +542,229 @@ export class AssistantCapabilityService {
             session
         });
     }
+    listTimers(input) {
+        const items = this.butlerControlTimerService.listTimers({
+            userId: input.userId,
+            statuses: input.status ? [input.status] : undefined,
+            controlSessionId: input.controlSessionId ?? null,
+            limit: input.limit ?? undefined
+        });
+        return this.createReceipt("timers.list", {
+            kind: "none",
+            id: null
+        }, {
+            items
+        });
+    }
+    listAutomations(input) {
+        const items = this.assistantAutomationService.listTasks({
+            userId: input.userId,
+            statuses: input.status ? [input.status] : undefined,
+            controlSessionId: input.controlSessionId ?? null
+        });
+        return this.createReceipt("automations.list", {
+            kind: "none",
+            id: null
+        }, {
+            items
+        });
+    }
+    getAutomation(automationId, userId) {
+        const automation = this.assistantAutomationService.getTask(automationId, userId);
+        return this.createReceipt("automations.get", {
+            kind: "automation",
+            id: automationId
+        }, {
+            automation
+        });
+    }
+    createAutomation(input) {
+        const triggerType = input.triggerType ?? "once";
+        const automation = this.assistantAutomationService.createTask({
+            userId: input.userId,
+            controlSessionId: input.controlSessionId,
+            projectId: input.projectId,
+            title: input.title,
+            trigger: buildAssistantAutomationTriggerInput(triggerType, input),
+            action: {
+                type: "send_control_message",
+                content: input.content,
+                includeTriggerContext: input.includeTriggerContext ?? triggerType === "condition",
+                targetSessionId: input.targetSessionId ?? null
+            }
+        });
+        return this.createReceipt("automations.create", {
+            kind: "automation",
+            id: automation.id
+        }, {
+            automation
+        });
+    }
+    updateAutomation(input) {
+        const automation = this.assistantAutomationService.updateTask({
+            taskId: input.automationId,
+            userId: input.userId,
+            title: input.title,
+            content: input.content,
+            includeTriggerContext: input.includeTriggerContext,
+            dueAt: input.dueAt,
+            everySeconds: input.everySeconds,
+            everyMinutes: input.everyMinutes,
+            everyHours: input.everyHours,
+            stopAt: input.stopAt,
+            cronMinute: input.cronMinute,
+            cronHour: input.cronHour,
+            cronDaysOfWeek: input.cronDaysOfWeek,
+            pollIntervalSeconds: input.pollIntervalSeconds,
+            expiresAt: input.expiresAt,
+            maxChecks: input.maxChecks
+        });
+        return this.createReceipt("automations.update", {
+            kind: "automation",
+            id: input.automationId
+        }, {
+            automation
+        });
+    }
+    cancelAutomation(automationId, userId) {
+        const automation = this.assistantAutomationService.cancelTask(automationId, userId);
+        return this.createReceipt("automations.cancel", {
+            kind: "automation",
+            id: automationId
+        }, {
+            automation
+        });
+    }
+    skipAutomationWait(automationId, userId) {
+        const automation = this.assistantAutomationService.skipCurrentWait(automationId, userId);
+        return this.createReceipt("automations.wait.skip", {
+            kind: "automation",
+            id: automationId
+        }, {
+            automation
+        });
+    }
+    listAutomationRuns(automationId, userId) {
+        const items = this.assistantAutomationService.listRuns(automationId, userId);
+        return this.createReceipt("automations.runs.list", {
+            kind: "automation",
+            id: automationId
+        }, {
+            items
+        });
+    }
+    listRecentAutomationRuns(input) {
+        const items = this.assistantAutomationService.listRecentRuns({
+            userId: input.userId,
+            controlSessionId: input.controlSessionId ?? null,
+            limit: input.limit ?? undefined
+        });
+        return this.createReceipt("automations.runs.recent", {
+            kind: "none",
+            id: null
+        }, {
+            items
+        });
+    }
+    listSandboxes(input) {
+        const items = this.assistantSandboxService.listSandboxes({
+            userId: input.userId,
+            controlSessionId: input.controlSessionId ?? null,
+            statuses: input.status ? [input.status] : undefined
+        });
+        return this.createReceipt("sandboxes.list", {
+            kind: "none",
+            id: null
+        }, {
+            items
+        });
+    }
+    async createSandbox(input) {
+        const currentControlSession = this.butlerControlSessionService.getCurrentSession(input.userId);
+        const sandbox = await this.assistantSandboxService.createSandbox({
+            userId: input.userId,
+            controlSessionId: currentControlSession?.id ?? null,
+            title: input.title,
+            description: input.description,
+            purpose: input.purpose,
+            expiresAt: input.expiresAt,
+            source: input.sourceKind === "clone"
+                ? {
+                    kind: "clone",
+                    repositoryUrl: requireAssistantRepositoryUrl(input.repositoryUrl),
+                    directoryName: input.directoryName,
+                    auth: input.auth
+                }
+                : {
+                    kind: "blank",
+                    directoryName: input.directoryName
+                }
+        });
+        return this.createReceipt("sandboxes.create", {
+            kind: "sandbox",
+            id: sandbox.id
+        }, {
+            sandbox
+        });
+    }
+    promoteSandbox(input) {
+        const sandbox = this.assistantSandboxService.promoteSandbox(input.sandboxId, input.userId, {
+            mode: input.mode,
+            projectName: input.projectName,
+            defaultProvider: input.defaultProvider
+        });
+        return this.createReceipt("sandboxes.promote", {
+            kind: "sandbox",
+            id: input.sandboxId
+        }, {
+            sandbox
+        });
+    }
+    expireSandbox(sandboxId, userId) {
+        const sandbox = this.assistantSandboxService.expireSandbox(sandboxId, userId);
+        return this.createReceipt("sandboxes.expire", {
+            kind: "sandbox",
+            id: sandboxId
+        }, {
+            sandbox
+        });
+    }
+    removeSandbox(sandboxId, userId) {
+        const sandbox = this.assistantSandboxService.removeSandbox(sandboxId, userId);
+        return this.createReceipt("sandboxes.remove", {
+            kind: "sandbox",
+            id: sandboxId
+        }, {
+            sandbox
+        });
+    }
+    getTimer(timerId, userId) {
+        const timer = this.butlerControlTimerService.getTimer(timerId, userId);
+        return this.createReceipt("timers.get", {
+            kind: "timer",
+            id: timerId
+        }, {
+            timer
+        });
+    }
+    createTimer(input) {
+        const timer = this.butlerControlTimerService.createTimer(input);
+        return this.createReceipt("timers.create", {
+            kind: "timer",
+            id: timer.id
+        }, {
+            timer
+        });
+    }
+    cancelTimer(timerId, userId) {
+        const timer = this.butlerControlTimerService.cancelTimer(timerId, userId);
+        return this.createReceipt("timers.cancel", {
+            kind: "timer",
+            id: timerId
+        }, {
+            timer
+        });
+    }
     async listTerminals(input) {
         const workspaceId = input.projectId?.trim()
             ? this.butlerProjectService.getById(input.projectId).workspaceId
@@ -227,6 +796,243 @@ export class AssistantCapabilityService {
             result
         });
     }
+    async closeTerminal(terminalId) {
+        const result = await this.terminalService.closeTerminal(terminalId);
+        return this.createReceipt("terminals.close", {
+            kind: "terminal",
+            id: terminalId
+        }, {
+            result
+        });
+    }
+    getDebugCompatibilityMatrix() {
+        return this.createReceipt("debug-targets.compatibility-matrix.get", {
+            kind: "none",
+            id: null
+        }, {
+            matrix: this.debugTargetService.getCompatibilityMatrix()
+        });
+    }
+    analyzeDebugTarget(input) {
+        const result = this.debugTargetService.analyze({
+            workspaceId: input.workspaceId,
+            rootPath: input.rootPath,
+            commandHints: input.commandHints ?? []
+        });
+        return this.createReceipt("debug-targets.analyze", {
+            kind: "debug_target",
+            id: result.target.id
+        }, {
+            result
+        });
+    }
+    getDebugFrameworkAnalysis(targetId) {
+        return this.createReceipt("debug-targets.framework-analysis.get", {
+            kind: "debug_target",
+            id: targetId
+        }, {
+            result: this.debugTargetService.getFrameworkAnalysis(targetId)
+        });
+    }
+    refreshDebugFrameworkAnalysis(targetId) {
+        return this.createReceipt("debug-targets.framework-analysis.refresh", {
+            kind: "debug_target",
+            id: targetId
+        }, {
+            result: this.debugTargetService.refreshFrameworkAnalysis(targetId)
+        });
+    }
+    async createDebugLaunchPlan(input) {
+        const plan = await this.debugTargetService.createLaunchPlan(input.targetId, input.portRequests, input.userId);
+        return this.createReceipt("debug-targets.launch-plan.create", {
+            kind: "debug_target",
+            id: input.targetId
+        }, {
+            plan
+        });
+    }
+    async runDebugTarget(input) {
+        const result = await this.debugTargetService.run({
+            targetId: input.targetId,
+            userId: input.userId,
+            shell: input.shell ?? undefined,
+            runtimeType: input.runtimeType ?? undefined,
+            portRequests: input.portRequests
+        });
+        return this.createReceipt("debug-targets.run", {
+            kind: "debug_target",
+            id: input.targetId
+        }, {
+            result
+        });
+    }
+    async getLatestDebugRuntime(targetId) {
+        const runtime = await this.debugTargetService.getLatestRuntimeDetail(targetId);
+        return this.createReceipt("debug-targets.runtime-latest.get", {
+            kind: "debug_target",
+            id: targetId
+        }, {
+            runtime
+        });
+    }
+    async listDebugRuntimes(input) {
+        const history = await this.debugTargetService.getRecentRuntimeDetails(input.targetId, input.limit);
+        return this.createReceipt("debug-targets.runtimes.list", {
+            kind: "debug_target",
+            id: input.targetId
+        }, {
+            history
+        });
+    }
+    async getDebugRuntime(runtimeId) {
+        const runtime = await this.debugTargetService.getRuntimeDetail(runtimeId);
+        return this.createReceipt("debug-runtimes.get", {
+            kind: "debug_runtime",
+            id: runtimeId
+        }, {
+            runtime
+        });
+    }
+    listWorkspaces() {
+        return this.createReceipt("workspaces.list", {
+            kind: "none",
+            id: null
+        }, {
+            items: this.workspaceService.list()
+        });
+    }
+    browseWorkspaces(requestedPath) {
+        return this.createReceipt("workspaces.browse", {
+            kind: "none",
+            id: null
+        }, {
+            result: this.workspaceService.browseDirectories(requestedPath?.trim() || undefined)
+        });
+    }
+    createWorkspaceDirectory(input) {
+        const result = this.workspaceService.createDirectory(input.parentPath, input.directoryName);
+        return this.createReceipt("workspaces.directory.create", {
+            kind: "none",
+            id: null
+        }, {
+            result
+        });
+    }
+    importWorkspace(input) {
+        const workspace = this.workspaceService.importWorkspace(input.path, input.name ?? undefined);
+        return this.createReceipt("workspaces.import", {
+            kind: "workspace",
+            id: workspace.id
+        }, {
+            workspace
+        });
+    }
+    async cloneWorkspace(input) {
+        const workspace = await this.workspaceService.cloneWorkspace({
+            repositoryUrl: input.repositoryUrl,
+            parentPath: input.parentPath,
+            directoryName: input.directoryName ?? undefined,
+            name: input.name ?? undefined,
+            auth: input.auth ?? undefined
+        });
+        return this.createReceipt("workspaces.clone", {
+            kind: "workspace",
+            id: workspace.id
+        }, {
+            workspace
+        });
+    }
+    reorderWorkspaces(workspaceIds) {
+        const items = this.workspaceService.reorderWorkspaces(workspaceIds);
+        return this.createReceipt("workspaces.reorder", {
+            kind: "none",
+            id: null
+        }, {
+            items
+        });
+    }
+    async getWorkspaceManagementSummary(workspaceId) {
+        const summary = await this.workspaceService.getManagementSummary(workspaceId);
+        return this.createReceipt("workspaces.management.get", {
+            kind: "workspace",
+            id: workspaceId
+        }, {
+            summary
+        });
+    }
+    updateWorkspaceNavigationState(input) {
+        const state = this.workspaceService.updateNavigationState(input.workspaceId, input.userId, {
+            collapsed: input.collapsed,
+            backgroundColor: input.backgroundColor
+        });
+        return this.createReceipt("workspaces.navigation-state.update", {
+            kind: "workspace",
+            id: input.workspaceId
+        }, {
+            state
+        });
+    }
+    removeWorkspace(workspaceId) {
+        const workspace = this.workspaceService.removeWorkspace(workspaceId);
+        return this.createReceipt("workspaces.remove", {
+            kind: "workspace",
+            id: workspaceId
+        }, {
+            workspace
+        });
+    }
+    async getWorktreeTree(rootWorkspaceId) {
+        await this.worktreeSyncService.syncRoot(rootWorkspaceId);
+        const items = this.worktreeManager.getTree(rootWorkspaceId);
+        return this.createReceipt("worktrees.tree", {
+            kind: "workspace",
+            id: rootWorkspaceId
+        }, {
+            rootWorkspaceId,
+            items
+        });
+    }
+    async createWorktree(input) {
+        const result = await this.worktreeManager.create({
+            sourceWorkspaceId: input.sourceWorkspaceId,
+            branchName: input.branchName,
+            displayName: input.displayName ?? undefined,
+            baseRef: input.baseRef ?? undefined
+        });
+        return this.createReceipt("worktrees.create", {
+            kind: "worktree",
+            id: result.workspace.id
+        }, {
+            result
+        });
+    }
+    async getWorktreeMergePreview(workspaceId) {
+        const preview = await this.worktreeMergeService.preview(workspaceId);
+        return this.createReceipt("worktrees.merge-preview", {
+            kind: "worktree",
+            id: workspaceId
+        }, {
+            preview
+        });
+    }
+    async mergeWorktreeIntoParent(workspaceId) {
+        const result = await this.worktreeMergeService.apply(workspaceId);
+        return this.createReceipt("worktrees.merge-into-parent", {
+            kind: "worktree",
+            id: workspaceId
+        }, {
+            result
+        });
+    }
+    async cleanupWorktree(workspaceId, userId, options) {
+        const result = await this.worktreeCleanupService.cleanup(workspaceId, userId, options);
+        return this.createReceipt("worktrees.cleanup", {
+            kind: "worktree",
+            id: workspaceId
+        }, {
+            result
+        });
+    }
     createReceipt(capability, targetRef, payload) {
         return {
             ok: true,
@@ -237,5 +1043,154 @@ export class AssistantCapabilityService {
             payload
         };
     }
+    resolveSessionLaunchConfig(input) {
+        const controlSession = this.butlerControlSessionService.getCurrentSession(input.userId);
+        const providerId = input.providerId?.trim()
+            ?? controlSession?.providerId
+            ?? undefined;
+        if (!providerId) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "ASSISTANT_CONTROL_SESSION_NOT_FOUND",
+                detail: "当前没有可用的助手控制会话，无法继承默认 provider"
+            });
+        }
+        return {
+            providerId,
+            model: normalizeAssistantText(input.model) ?? controlSession?.model ?? null,
+            reasoningLevel: normalizeAssistantText(input.reasoningLevel) ?? controlSession?.reasoningLevel ?? null,
+            permissionMode: normalizeAssistantText(input.permissionMode) ?? controlSession?.permissionMode ?? null
+        };
+    }
+    resolveAssistantSessionTarget(target, userId) {
+        if (target.kind === "project") {
+            const project = this.butlerProjectService.getById(target.projectId);
+            return {
+                kind: "project",
+                id: project.id,
+                workspaceId: project.workspaceId
+            };
+        }
+        if (target.kind === "workspace") {
+            return {
+                kind: "workspace",
+                id: target.workspaceId,
+                workspaceId: target.workspaceId
+            };
+        }
+        return {
+            kind: "sandbox",
+            id: target.sandboxId,
+            workspaceId: this.assistantSandboxService.resolveWorkspaceId(target.sandboxId, userId)
+        };
+    }
+    async createAutomaticSandboxTarget(input, controlSession) {
+        const sandbox = await this.assistantSandboxService.createSandbox({
+            userId: input.userId,
+            controlSessionId: controlSession?.id ?? null,
+            title: inferAutomaticSandboxTitle(controlSession, input.content),
+            purpose: "当前任务未指定工作区，系统自动创建",
+            source: {
+                kind: "blank"
+            }
+        });
+        return {
+            kind: "sandbox",
+            id: sandbox.id,
+            workspaceId: sandbox.workspaceId
+        };
+    }
+}
+function normalizeAssistantText(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : null;
+}
+function inferAutomaticSandboxTitle(controlSession, content) {
+    return normalizeAssistantText(controlSession?.title)
+        ?? normalizeAssistantText(controlSession?.lastSummary)
+        ?? summarizeAssistantText(content)
+        ?? "助手临时沙箱";
+}
+function summarizeAssistantText(content) {
+    const normalized = normalizeAssistantText(content);
+    if (!normalized) {
+        return null;
+    }
+    return normalized.length > 48 ? `${normalized.slice(0, 45)}...` : normalized;
+}
+function buildAssistantAutomationTriggerInput(triggerType, input) {
+    switch (triggerType) {
+        case "once":
+            return {
+                type: "once",
+                dueAt: input.dueAt ?? null,
+                afterSeconds: input.afterSeconds ?? null
+            };
+        case "interval":
+            return {
+                type: "interval",
+                seconds: input.everySeconds ?? null,
+                minutes: input.everyMinutes ?? null,
+                hours: input.everyHours ?? null,
+                stopAt: input.stopAt ?? null
+            };
+        case "cron":
+            return {
+                type: "cron",
+                minute: input.cronMinute ?? null,
+                hour: input.cronHour ?? null,
+                daysOfWeek: input.cronDaysOfWeek ?? null,
+                stopAt: input.stopAt ?? null
+            };
+        case "condition": {
+            const conditionKind = input.conditionKind;
+            if (conditionKind === "git.remote_tag_changed") {
+                return {
+                    type: "condition",
+                    conditionKind,
+                    repositoryUrl: input.repositoryUrl ?? null,
+                    pollIntervalSeconds: input.pollIntervalSeconds ?? null,
+                    expiresAt: input.expiresAt ?? null,
+                    maxChecks: input.maxChecks ?? null
+                };
+            }
+            return {
+                type: "condition",
+                conditionKind: requireAssistantConditionKind(conditionKind),
+                sessionId: input.conditionSessionId ?? null,
+                pollIntervalSeconds: input.pollIntervalSeconds ?? null,
+                expiresAt: input.expiresAt ?? null,
+                maxChecks: input.maxChecks ?? null
+            };
+        }
+        default:
+            return assertNeverAssistantAutomationTriggerType(triggerType);
+    }
+}
+function requireAssistantRepositoryUrl(value) {
+    const normalized = normalizeAssistantText(value);
+    if (!normalized) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "clone 沙箱必须提供 repositoryUrl",
+            field: "repositoryUrl"
+        });
+    }
+    return normalized;
+}
+function requireAssistantConditionKind(value) {
+    if (value === "git.remote_tag_changed" || value === "session.runtime_idle") {
+        return value;
+    }
+    throw new AppError({
+        statusCode: 400,
+        errorCode: "INVALID_INPUT",
+        detail: "condition 自动化必须提供 conditionKind",
+        field: "conditionKind"
+    });
+}
+function assertNeverAssistantAutomationTriggerType(value) {
+    throw new Error(`Unexpected assistant automation triggerType: ${String(value)}`);
 }
 //# sourceMappingURL=assistant-capability-service.js.map