@jingyi0605/codingns 0.3.6 → 0.5.0

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

@@ -1,8 +1,15 @@
+import type { AuthCallerKind } from "../auth/auth-service.js";
+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 { ButlerFollowUpService, CompleteButlerFollowUpTaskInput, ContinueButlerFollowUpTaskInput, FailButlerFollowUpTaskInput, WaitingUserButlerFollowUpTaskInput } from "../butler/butler-follow-up-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";
@@ -20,9 +27,10 @@ export interface AssistantCapabilityReceipt<TPayload> {
     ok: true;
     capability: string;
     auditId: string;
+    callerKind?: AuthCallerKind;
     timestamp: string;
     targetRef: {
-        kind: "project" | "session" | "terminal" | "workspace" | "worktree" | "debug_target" | "debug_runtime" | "none";
+        kind: "project" | "session" | "terminal" | "workspace" | "worktree" | "debug_target" | "debug_runtime" | "automation" | "sandbox" | "timer" | "follow_up" | "none";
         id: string | null;
     };
     payload: TPayload;
@@ -41,6 +49,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;
@@ -63,6 +99,132 @@ 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 ListAssistantFollowUpsInput {
+    userId: string;
+    status?: "active" | "waiting_user" | "completed" | "failed" | "cancelled";
+    projectId?: string | null;
+    sessionId?: string | null;
+    limit?: number | null;
+}
+interface CreateAssistantFollowUpInput {
+    userId: string;
+    projectId: string;
+    butlerSessionId: string;
+    providerId?: "codex" | "claude-code" | null;
+    objective: string;
+    completionCriteria?: string | null;
+    maxAutoContinueCount?: number | null;
+    checkIntervalSeconds?: number | null;
+}
+interface ContinueAssistantFollowUpInput extends ContinueButlerFollowUpTaskInput {
+    userId: string;
+    taskId: string;
+}
+interface WaitingUserAssistantFollowUpInput extends WaitingUserButlerFollowUpTaskInput {
+    userId: string;
+    taskId: string;
+}
+interface CompleteAssistantFollowUpInput extends CompleteButlerFollowUpTaskInput {
+    userId: string;
+    taskId: string;
+}
+interface FailAssistantFollowUpInput extends FailButlerFollowUpTaskInput {
+    userId: string;
+    taskId: string;
+}
+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" | "orphaned" | "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;
@@ -70,6 +232,7 @@ interface AnalyzeAssistantDebugTargetInput {
 }
 interface CreateAssistantDebugLaunchPlanInput {
     targetId: string;
+    userId: string;
     portRequests: DebugTargetPortRequest[];
 }
 interface RunAssistantDebugTargetInput {
@@ -109,6 +272,10 @@ interface CreateAssistantWorktreeInput {
 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;
@@ -118,7 +285,9 @@ export declare class AssistantCapabilityService {
     private readonly worktreeSyncService;
     private readonly worktreeMergeService;
     private readonly worktreeCleanupService;
-    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" | "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">);
+    private readonly sessionMessageOriginRepository;
+    private readonly butlerFollowUpService;
+    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" | "deleteSession">, 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, butlerFollowUpService?: Pick<ButlerFollowUpService, "listTasks" | "getTask" | "createTask" | "continueTask" | "markTaskWaitingUser" | "completeTask" | "failTask"> | null);
     listCapabilities(): AssistantCapabilityReceipt<{
         version: string;
         items: AssistantCapabilityDescriptor[];
@@ -134,6 +303,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"]>;
     }>;
@@ -155,6 +335,82 @@ export declare class AssistantCapabilityService {
     forkSession(input: ForkAssistantSessionInput): Promise<AssistantCapabilityReceipt<{
         session: Awaited<ReturnType<SessionHistoryService["forkSession"]>>;
     }>>;
+    deleteSession(sessionId: string, userId: string): Promise<AssistantCapabilityReceipt<{
+        sessionId: string;
+        deleted: true;
+    }>>;
+    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"]>;
+    }>;
+    listFollowUps(input: ListAssistantFollowUpsInput): AssistantCapabilityReceipt<{
+        items: ReturnType<ButlerFollowUpService["listTasks"]>;
+    }>;
+    getFollowUp(taskId: string): AssistantCapabilityReceipt<{
+        task: ReturnType<ButlerFollowUpService["getTask"]>;
+    }>;
+    createFollowUp(input: CreateAssistantFollowUpInput): Promise<AssistantCapabilityReceipt<{
+        task: Awaited<ReturnType<ButlerFollowUpService["createTask"]>>;
+    }>>;
+    continueFollowUp(input: ContinueAssistantFollowUpInput): Promise<AssistantCapabilityReceipt<{
+        task: Awaited<ReturnType<ButlerFollowUpService["continueTask"]>>;
+    }>>;
+    markFollowUpWaitingUser(input: WaitingUserAssistantFollowUpInput): Promise<AssistantCapabilityReceipt<{
+        task: Awaited<ReturnType<ButlerFollowUpService["markTaskWaitingUser"]>>;
+    }>>;
+    completeFollowUp(input: CompleteAssistantFollowUpInput): Promise<AssistantCapabilityReceipt<{
+        task: Awaited<ReturnType<ButlerFollowUpService["completeTask"]>>;
+    }>>;
+    failFollowUp(input: FailAssistantFollowUpInput): Promise<AssistantCapabilityReceipt<{
+        task: Awaited<ReturnType<ButlerFollowUpService["failTask"]>>;
+    }>>;
+    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"]>>;
@@ -242,5 +498,9 @@ export declare class AssistantCapabilityService {
         result: Awaited<ReturnType<WorktreeCleanupService["cleanup"]>>;
     }>>;
     private createReceipt;
+    private requireFollowUpService;
+    private resolveSessionLaunchConfig;
+    private resolveAssistantSessionTarget;
+    private createAutomaticSandboxTarget;
 }
 export {};