@jingyi0605/codingns 0.3.5 → 0.4.0

package/dist/server/modules/assistant-capability/assistant-capability-service.d.ts

@@ -1,8 +1,19 @@
+import type { AssistantAutomationService } from "../butler/assistant-automation-service.js";
+import type { AssistantSandboxService } from "../butler/assistant-sandbox-service.js";
+import type { ButlerControlSessionService } from "../butler/butler-control-session-service.js";
+import type { ButlerControlTimerService } from "../butler/butler-control-timer-service.js";
 import type { ButlerProjectService } from "../butler/butler-project-service.js";
 import type { ButlerSessionService } from "../butler/butler-session-service.js";
+import type { DebugTargetPortRequest, DebugTargetService } from "../debug-target/debug-target-service.js";
 import type { SessionHistoryService } from "../sessions/session-history-service.js";
 import type { SessionLiveRuntimeService } from "../sessions/session-live-runtime-service.js";
+import type { SessionMessageOriginRepository } from "../../storage/repositories/session-message-origin-repository.js";
 import type { TerminalService } from "../terminal/terminal-service.js";
+import type { CloneWorkspaceInput, WorkspaceService } from "../workspace/workspace-service.js";
+import type { WorktreeManager } from "../worktree/worktree-manager.js";
+import type { WorktreeCleanupOptions, WorktreeCleanupService } from "../worktree/worktree-cleanup-service.js";
+import type { WorktreeMergeService } from "../worktree/worktree-merge-service.js";
+import type { WorktreeSyncService } from "../worktree/worktree-sync-service.js";
 type AssistantCapabilityMode = "read" | "proxy_execute";
 export interface AssistantCapabilityDescriptor {
     name: string;
@@ -16,7 +27,7 @@ export interface AssistantCapabilityReceipt<TPayload> {
     auditId: string;
     timestamp: string;
     targetRef: {
-        kind: "project" | "session" | "terminal" | "none";
+        kind: "project" | "session" | "terminal" | "workspace" | "worktree" | "debug_target" | "debug_runtime" | "automation" | "sandbox" | "timer" | "none";
         id: string | null;
     };
     payload: TPayload;
@@ -35,6 +46,34 @@ interface SendAssistantSessionMessageInput {
     reasoningLevel?: string | null;
     permissionMode?: string | null;
 }
+interface StartAssistantProjectSessionInput {
+    projectId: string;
+    userId: string;
+    content: string;
+    providerId?: "codex" | "claude-code" | null;
+    model?: string | null;
+    reasoningLevel?: string | null;
+    permissionMode?: string | null;
+}
+type AssistantSessionTarget = {
+    kind: "project";
+    projectId: string;
+} | {
+    kind: "workspace";
+    workspaceId: string;
+} | {
+    kind: "sandbox";
+    sandboxId: string;
+};
+interface StartAssistantSessionInput {
+    target?: AssistantSessionTarget | null;
+    userId: string;
+    content: string;
+    providerId?: "codex" | "claude-code" | null;
+    model?: string | null;
+    reasoningLevel?: string | null;
+    permissionMode?: string | null;
+}
 interface ForkAssistantSessionInput {
     sessionId: string;
     userId: string;
@@ -57,13 +96,161 @@ interface SendAssistantTerminalInput {
     terminalId: string;
     content: string;
 }
+interface CreateAssistantTimerInput {
+    userId: string;
+    controlSessionId?: string | null;
+    projectId?: string | null;
+    targetSessionId?: string | null;
+    title?: string | null;
+    content: string;
+    dueAt?: string | null;
+    afterSeconds?: number | null;
+}
+interface ListAssistantTimersInput {
+    userId: string;
+    status?: "active" | "completed" | "cancelled" | "failed";
+    controlSessionId?: string | null;
+    limit?: number | null;
+}
+interface ListAssistantAutomationsInput {
+    userId: string;
+    status?: "active" | "completed" | "cancelled" | "failed";
+    controlSessionId?: string | null;
+    limit?: number | null;
+}
+interface CreateAssistantAutomationInput {
+    userId: string;
+    controlSessionId?: string | null;
+    projectId?: string | null;
+    title?: string | null;
+    content: string;
+    triggerType?: "once" | "interval" | "cron" | "condition";
+    dueAt?: string | null;
+    afterSeconds?: number | null;
+    everySeconds?: number | null;
+    everyMinutes?: number | null;
+    everyHours?: number | null;
+    stopAt?: string | null;
+    cronMinute?: number | null;
+    cronHour?: number | null;
+    cronDaysOfWeek?: number[] | null;
+    conditionKind?: "git.remote_tag_changed" | "session.runtime_idle" | null;
+    repositoryUrl?: string | null;
+    pollIntervalSeconds?: number | null;
+    expiresAt?: string | null;
+    maxChecks?: number | null;
+    conditionSessionId?: string | null;
+    includeTriggerContext?: boolean;
+    targetSessionId?: string | null;
+}
+interface UpdateAssistantAutomationInput {
+    userId: string;
+    automationId: string;
+    title?: string | null;
+    content?: string;
+    includeTriggerContext?: boolean;
+    dueAt?: string | null;
+    everySeconds?: number | null;
+    everyMinutes?: number | null;
+    everyHours?: number | null;
+    stopAt?: string | null;
+    cronMinute?: number | null;
+    cronHour?: number | null;
+    cronDaysOfWeek?: number[] | null;
+    pollIntervalSeconds?: number | null;
+    expiresAt?: string | null;
+    maxChecks?: number | null;
+}
+interface ListAssistantAutomationRunsInput {
+    userId: string;
+    controlSessionId?: string | null;
+    limit?: number | null;
+}
+interface ListAssistantSandboxesInput {
+    userId: string;
+    status?: "active" | "archived" | "expired" | "deleted";
+    controlSessionId?: string | null;
+}
+interface CreateAssistantSandboxInput {
+    userId: string;
+    title?: string | null;
+    description?: string | null;
+    purpose?: string | null;
+    expiresAt?: string | null;
+    sourceKind: "blank" | "clone";
+    repositoryUrl?: string | null;
+    directoryName?: string | null;
+    auth?: CloneWorkspaceInput["auth"];
+}
+interface PromoteAssistantSandboxInput {
+    sandboxId: string;
+    userId: string;
+    mode?: "pin" | "project";
+    projectName?: string | null;
+    defaultProvider?: "codex" | "claude-code" | null;
+}
+interface AnalyzeAssistantDebugTargetInput {
+    workspaceId: string;
+    rootPath: string;
+    commandHints?: string[];
+}
+interface CreateAssistantDebugLaunchPlanInput {
+    targetId: string;
+    userId: string;
+    portRequests: DebugTargetPortRequest[];
+}
+interface RunAssistantDebugTargetInput {
+    targetId: string;
+    userId: string;
+    shell?: string | null;
+    runtimeType?: Parameters<DebugTargetService["run"]>[0]["runtimeType"];
+    portRequests: DebugTargetPortRequest[];
+}
+interface CreateAssistantWorkspaceDirectoryInput {
+    parentPath: string;
+    directoryName: string;
+}
+interface ImportAssistantWorkspaceInput {
+    path: string;
+    name?: string | null;
+}
+interface CloneAssistantWorkspaceInput {
+    repositoryUrl: string;
+    parentPath: string;
+    directoryName?: string | null;
+    name?: string | null;
+    auth?: CloneWorkspaceInput["auth"];
+}
+interface UpdateAssistantWorkspaceNavigationStateInput {
+    workspaceId: string;
+    userId: string;
+    collapsed?: boolean;
+    backgroundColor?: string | null;
+}
+interface CreateAssistantWorktreeInput {
+    sourceWorkspaceId: string;
+    branchName: string;
+    displayName?: string | null;
+    baseRef?: string | null;
+}
 export declare class AssistantCapabilityService {
     private readonly butlerProjectService;
     private readonly butlerSessionService;
+    private readonly butlerControlSessionService;
+    private readonly assistantAutomationService;
+    private readonly assistantSandboxService;
+    private readonly butlerControlTimerService;
     private readonly sessionHistoryService;
     private readonly sessionLiveRuntimeService;
     private readonly terminalService;
-    constructor(butlerProjectService: Pick<ButlerProjectService, "list" | "getById" | "getOverview">, butlerSessionService: Pick<ButlerSessionService, "listByProject" | "ensureProjectSessionsSynced">, sessionHistoryService: Pick<SessionHistoryService, "getSession" | "readSessionHistory" | "forkSession">, sessionLiveRuntimeService: Pick<SessionLiveRuntimeService, "getSessionRuntime" | "sendLiveMessage">, terminalService: Pick<TerminalService, "listTerminals" | "readTerminalHistory" | "writeInput">);
+    private readonly debugTargetService;
+    private readonly workspaceService;
+    private readonly worktreeManager;
+    private readonly worktreeSyncService;
+    private readonly worktreeMergeService;
+    private readonly worktreeCleanupService;
+    private readonly sessionMessageOriginRepository;
+    constructor(butlerProjectService: Pick<ButlerProjectService, "list" | "getById" | "getOverview">, butlerSessionService: Pick<ButlerSessionService, "listByProject" | "ensureProjectSessionsSynced" | "startSession">, butlerControlSessionService: Pick<ButlerControlSessionService, "getCurrentSession">, assistantAutomationService: Pick<AssistantAutomationService, "listTasks" | "getTask" | "createTask" | "updateTask" | "cancelTask" | "skipCurrentWait" | "listRuns" | "listRecentRuns">, assistantSandboxService: Pick<AssistantSandboxService, "listSandboxes" | "getSandbox" | "createSandbox" | "promoteSandbox" | "expireSandbox" | "removeSandbox" | "resolveWorkspaceId" | "markSandboxUsedByControlSession">, butlerControlTimerService: Pick<ButlerControlTimerService, "listTimers" | "getTimer" | "createTimer" | "cancelTimer">, sessionHistoryService: Pick<SessionHistoryService, "getSession" | "readSessionHistory" | "forkSession">, sessionLiveRuntimeService: Pick<SessionLiveRuntimeService, "getSessionRuntime" | "sendLiveMessage" | "startLiveSession">, terminalService: Pick<TerminalService, "listTerminals" | "readTerminalHistory" | "writeInput" | "closeTerminal">, debugTargetService: Pick<DebugTargetService, "analyze" | "getFrameworkAnalysis" | "refreshFrameworkAnalysis" | "createLaunchPlan" | "run" | "getLatestRuntimeDetail" | "getRecentRuntimeDetails" | "getRuntimeDetail" | "getCompatibilityMatrix">, workspaceService: Pick<WorkspaceService, "list" | "browseDirectories" | "createDirectory" | "importWorkspace" | "cloneWorkspace" | "reorderWorkspaces" | "getManagementSummary" | "removeWorkspace" | "updateNavigationState">, worktreeManager: Pick<WorktreeManager, "getTree" | "create">, worktreeSyncService: Pick<WorktreeSyncService, "syncRoot">, worktreeMergeService: Pick<WorktreeMergeService, "preview" | "apply">, worktreeCleanupService: Pick<WorktreeCleanupService, "cleanup">, sessionMessageOriginRepository?: Pick<SessionMessageOriginRepository, "upsert"> | null);
     listCapabilities(): AssistantCapabilityReceipt<{
         version: string;
         items: AssistantCapabilityDescriptor[];
@@ -79,6 +266,17 @@ export declare class AssistantCapabilityService {
     listProjectSessions(projectId: string, userId: string): Promise<AssistantCapabilityReceipt<{
         items: ReturnType<ButlerSessionService["listByProject"]>;
     }>>;
+    startProjectSession(input: StartAssistantProjectSessionInput): Promise<AssistantCapabilityReceipt<{
+        session: Awaited<ReturnType<ButlerSessionService["startSession"]>>;
+    }>>;
+    startSession(input: StartAssistantSessionInput): Promise<AssistantCapabilityReceipt<{
+        session: Awaited<ReturnType<ButlerSessionService["startSession"]>> | Awaited<ReturnType<SessionLiveRuntimeService["startLiveSession"]>>;
+        target: {
+            kind: AssistantSessionTarget["kind"];
+            id: string;
+            workspaceId: string;
+        };
+    }>>;
     getSession(sessionId: string, userId: string): AssistantCapabilityReceipt<{
         session: ReturnType<SessionHistoryService["getSession"]>;
     }>;
@@ -100,6 +298,57 @@ export declare class AssistantCapabilityService {
     forkSession(input: ForkAssistantSessionInput): Promise<AssistantCapabilityReceipt<{
         session: Awaited<ReturnType<SessionHistoryService["forkSession"]>>;
     }>>;
+    listTimers(input: ListAssistantTimersInput): AssistantCapabilityReceipt<{
+        items: ReturnType<ButlerControlTimerService["listTimers"]>;
+    }>;
+    listAutomations(input: ListAssistantAutomationsInput): AssistantCapabilityReceipt<{
+        items: ReturnType<AssistantAutomationService["listTasks"]>;
+    }>;
+    getAutomation(automationId: string, userId: string): AssistantCapabilityReceipt<{
+        automation: ReturnType<AssistantAutomationService["getTask"]>;
+    }>;
+    createAutomation(input: CreateAssistantAutomationInput): AssistantCapabilityReceipt<{
+        automation: ReturnType<AssistantAutomationService["createTask"]>;
+    }>;
+    updateAutomation(input: UpdateAssistantAutomationInput): AssistantCapabilityReceipt<{
+        automation: ReturnType<AssistantAutomationService["updateTask"]>;
+    }>;
+    cancelAutomation(automationId: string, userId: string): AssistantCapabilityReceipt<{
+        automation: ReturnType<AssistantAutomationService["cancelTask"]>;
+    }>;
+    skipAutomationWait(automationId: string, userId: string): AssistantCapabilityReceipt<{
+        automation: ReturnType<AssistantAutomationService["skipCurrentWait"]>;
+    }>;
+    listAutomationRuns(automationId: string, userId: string): AssistantCapabilityReceipt<{
+        items: ReturnType<AssistantAutomationService["listRuns"]>;
+    }>;
+    listRecentAutomationRuns(input: ListAssistantAutomationRunsInput): AssistantCapabilityReceipt<{
+        items: ReturnType<AssistantAutomationService["listRecentRuns"]>;
+    }>;
+    listSandboxes(input: ListAssistantSandboxesInput): AssistantCapabilityReceipt<{
+        items: ReturnType<AssistantSandboxService["listSandboxes"]>;
+    }>;
+    createSandbox(input: CreateAssistantSandboxInput): Promise<AssistantCapabilityReceipt<{
+        sandbox: Awaited<ReturnType<AssistantSandboxService["createSandbox"]>>;
+    }>>;
+    promoteSandbox(input: PromoteAssistantSandboxInput): AssistantCapabilityReceipt<{
+        sandbox: ReturnType<AssistantSandboxService["promoteSandbox"]>;
+    }>;
+    expireSandbox(sandboxId: string, userId: string): AssistantCapabilityReceipt<{
+        sandbox: ReturnType<AssistantSandboxService["expireSandbox"]>;
+    }>;
+    removeSandbox(sandboxId: string, userId: string): AssistantCapabilityReceipt<{
+        sandbox: ReturnType<AssistantSandboxService["removeSandbox"]>;
+    }>;
+    getTimer(timerId: string, userId: string): AssistantCapabilityReceipt<{
+        timer: ReturnType<ButlerControlTimerService["getTimer"]>;
+    }>;
+    createTimer(input: CreateAssistantTimerInput): AssistantCapabilityReceipt<{
+        timer: ReturnType<ButlerControlTimerService["createTimer"]>;
+    }>;
+    cancelTimer(timerId: string, userId: string): AssistantCapabilityReceipt<{
+        timer: ReturnType<ButlerControlTimerService["cancelTimer"]>;
+    }>;
     listTerminals(input: ListAssistantTerminalsInput): Promise<AssistantCapabilityReceipt<{
         workspaceId: string;
         items: Awaited<ReturnType<TerminalService["listTerminals"]>>;
@@ -110,6 +359,85 @@ export declare class AssistantCapabilityService {
     sendTerminalInput(input: SendAssistantTerminalInput): Promise<AssistantCapabilityReceipt<{
         result: Awaited<ReturnType<TerminalService["writeInput"]>>;
     }>>;
+    closeTerminal(terminalId: string): Promise<AssistantCapabilityReceipt<{
+        result: Awaited<ReturnType<TerminalService["closeTerminal"]>>;
+    }>>;
+    getDebugCompatibilityMatrix(): AssistantCapabilityReceipt<{
+        matrix: ReturnType<DebugTargetService["getCompatibilityMatrix"]>;
+    }>;
+    analyzeDebugTarget(input: AnalyzeAssistantDebugTargetInput): AssistantCapabilityReceipt<{
+        result: ReturnType<DebugTargetService["analyze"]>;
+    }>;
+    getDebugFrameworkAnalysis(targetId: string): AssistantCapabilityReceipt<{
+        result: ReturnType<DebugTargetService["getFrameworkAnalysis"]>;
+    }>;
+    refreshDebugFrameworkAnalysis(targetId: string): AssistantCapabilityReceipt<{
+        result: ReturnType<DebugTargetService["refreshFrameworkAnalysis"]>;
+    }>;
+    createDebugLaunchPlan(input: CreateAssistantDebugLaunchPlanInput): Promise<AssistantCapabilityReceipt<{
+        plan: Awaited<ReturnType<DebugTargetService["createLaunchPlan"]>>;
+    }>>;
+    runDebugTarget(input: RunAssistantDebugTargetInput): Promise<AssistantCapabilityReceipt<{
+        result: Awaited<ReturnType<DebugTargetService["run"]>>;
+    }>>;
+    getLatestDebugRuntime(targetId: string): Promise<AssistantCapabilityReceipt<{
+        runtime: Awaited<ReturnType<DebugTargetService["getLatestRuntimeDetail"]>>;
+    }>>;
+    listDebugRuntimes(input: {
+        targetId: string;
+        limit: number;
+    }): Promise<AssistantCapabilityReceipt<{
+        history: Awaited<ReturnType<DebugTargetService["getRecentRuntimeDetails"]>>;
+    }>>;
+    getDebugRuntime(runtimeId: string): Promise<AssistantCapabilityReceipt<{
+        runtime: Awaited<ReturnType<DebugTargetService["getRuntimeDetail"]>>;
+    }>>;
+    listWorkspaces(): AssistantCapabilityReceipt<{
+        items: ReturnType<WorkspaceService["list"]>;
+    }>;
+    browseWorkspaces(requestedPath?: string | null): AssistantCapabilityReceipt<{
+        result: ReturnType<WorkspaceService["browseDirectories"]>;
+    }>;
+    createWorkspaceDirectory(input: CreateAssistantWorkspaceDirectoryInput): AssistantCapabilityReceipt<{
+        result: ReturnType<WorkspaceService["createDirectory"]>;
+    }>;
+    importWorkspace(input: ImportAssistantWorkspaceInput): AssistantCapabilityReceipt<{
+        workspace: ReturnType<WorkspaceService["importWorkspace"]>;
+    }>;
+    cloneWorkspace(input: CloneAssistantWorkspaceInput): Promise<AssistantCapabilityReceipt<{
+        workspace: Awaited<ReturnType<WorkspaceService["cloneWorkspace"]>>;
+    }>>;
+    reorderWorkspaces(workspaceIds: string[]): AssistantCapabilityReceipt<{
+        items: ReturnType<WorkspaceService["reorderWorkspaces"]>;
+    }>;
+    getWorkspaceManagementSummary(workspaceId: string): Promise<AssistantCapabilityReceipt<{
+        summary: Awaited<ReturnType<WorkspaceService["getManagementSummary"]>>;
+    }>>;
+    updateWorkspaceNavigationState(input: UpdateAssistantWorkspaceNavigationStateInput): AssistantCapabilityReceipt<{
+        state: ReturnType<WorkspaceService["updateNavigationState"]>;
+    }>;
+    removeWorkspace(workspaceId: string): AssistantCapabilityReceipt<{
+        workspace: ReturnType<WorkspaceService["removeWorkspace"]>;
+    }>;
+    getWorktreeTree(rootWorkspaceId: string): Promise<AssistantCapabilityReceipt<{
+        rootWorkspaceId: string;
+        items: ReturnType<WorktreeManager["getTree"]>;
+    }>>;
+    createWorktree(input: CreateAssistantWorktreeInput): Promise<AssistantCapabilityReceipt<{
+        result: Awaited<ReturnType<WorktreeManager["create"]>>;
+    }>>;
+    getWorktreeMergePreview(workspaceId: string): Promise<AssistantCapabilityReceipt<{
+        preview: Awaited<ReturnType<WorktreeMergeService["preview"]>>;
+    }>>;
+    mergeWorktreeIntoParent(workspaceId: string): Promise<AssistantCapabilityReceipt<{
+        result: Awaited<ReturnType<WorktreeMergeService["apply"]>>;
+    }>>;
+    cleanupWorktree(workspaceId: string, userId: string, options: WorktreeCleanupOptions): Promise<AssistantCapabilityReceipt<{
+        result: Awaited<ReturnType<WorktreeCleanupService["cleanup"]>>;
+    }>>;
     private createReceipt;
+    private resolveSessionLaunchConfig;
+    private resolveAssistantSessionTarget;
+    private createAutomaticSandboxTarget;
 }
 export {};