@jingyi0605/codingns 0.1.4 → 0.1.5

package/dist/server/modules/butler/butler-controller.d.ts

@@ -0,0 +1,367 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { ButlerControlSessionService, SendButlerControlMessageInput, StartButlerControlSessionInput } from "./butler-control-session-service.js";
+import type { ButlerControlActionService, ResumeButlerProjectSessionActionInput, StartButlerPatrolActionInput, StartButlerVerificationActionInput } from "./butler-control-action-service.js";
+import type { ButlerProfilePatchInput, ButlerProfileService } from "./butler-profile-service.js";
+import type { ButlerFollowUpService, CreateButlerFollowUpTaskInput } from "./butler-follow-up-service.js";
+import type { ButlerActionContextService } from "./butler-action-context-service.js";
+import type { ButlerInboxService } from "./butler-inbox-service.js";
+import type { ButlerNotificationService } from "./butler-notification-service.js";
+import type { ButlerContextAggregator } from "./context-aggregator.js";
+import type { ButlerProjectService } from "./butler-project-service.js";
+import type { ButlerSessionService } from "./butler-session-service.js";
+import type { PatrolPlanService } from "./patrol-plan-service.js";
+import type { PatrolExecutionService } from "./patrol-execution-service.js";
+import type { PatrolRunService } from "./patrol-run-service.js";
+import type { ProjectMemoryService } from "./project-memory-service.js";
+import type { VerificationRunService } from "./verification-run-service.js";
+interface ButlerProjectListQuery {
+    workspaceId?: string;
+    status?: "active" | "paused" | "archived";
+    riskLevel?: "low" | "medium" | "high";
+}
+interface ButlerSearchQuery {
+    q?: string;
+    projectId?: string;
+    includeArchived?: string;
+}
+interface ButlerSessionTargetQuery {
+    sessionId?: string;
+}
+interface ButlerSessionActionContextQuery {
+    sessionId?: string;
+}
+interface ButlerInboxListQuery {
+    workspaceId?: string;
+    projectId?: string;
+    status?: "pending" | "in_progress" | "closed";
+    itemType?: "bug" | "feature" | "change" | "task";
+}
+interface ButlerFollowUpTaskListQuery {
+    status?: "active" | "waiting_user" | "completed" | "failed" | "cancelled";
+    projectId?: string;
+    sessionId?: string;
+}
+interface ButlerProjectParams {
+    projectId: string;
+}
+interface ButlerInboxItemParams {
+    itemId: string;
+}
+interface ButlerNotificationParams {
+    notificationId: string;
+}
+interface ButlerFollowUpTaskParams {
+    taskId: string;
+}
+interface CancelButlerFollowUpTaskBody {
+    reason?: string;
+}
+interface ButlerMemoryParams extends ButlerProjectParams {
+    memoryId: string;
+}
+interface ButlerPlanParams extends ButlerProjectParams {
+    planId: string;
+}
+interface ButlerRunParams extends ButlerProjectParams {
+    runId: string;
+}
+interface ButlerVerificationParams extends ButlerProjectParams {
+    verificationId: string;
+}
+interface ButlerSessionParams extends ButlerProjectParams {
+    butlerSessionId: string;
+}
+interface CreateButlerProjectBody {
+    workspaceId?: string;
+    name?: string;
+    repoRoot?: string;
+    defaultProvider?: string;
+    approvalMode?: "readonly" | "controlled" | "auto";
+    config?: Record<string, unknown>;
+}
+interface UpdateButlerProjectBody {
+    name?: string;
+    defaultProvider?: string | null;
+    approvalMode?: "readonly" | "controlled" | "auto";
+    lifecycleStatus?: "active" | "paused" | "archived";
+    riskLevel?: "low" | "medium" | "high";
+    config?: Record<string, unknown>;
+}
+interface ImportButlerSessionBody {
+    sessionId?: string;
+    role?: "patrol" | "execution" | "verification" | "adhoc";
+    ownershipMode?: "managed" | "observed";
+}
+interface StartButlerSessionBody {
+    providerId?: "codex" | "claude-code";
+    role?: "patrol" | "execution" | "verification" | "adhoc";
+    ownershipMode?: "managed" | "observed";
+    content?: string;
+    model?: string | null;
+    reasoningLevel?: string | null;
+    permissionMode?: string | null;
+}
+interface CaptureButlerSessionSnapshotBody {
+    sourceKind?: "snapshot" | "manual";
+}
+interface ButlerMemoryListQuery {
+    status?: "candidate" | "active" | "superseded" | "archived";
+    memoryType?: "arch" | "rule" | "decision" | "incident" | "verify" | "note";
+    scopePath?: string;
+    q?: string;
+}
+interface CreateButlerMemoryBody {
+    title?: string;
+    scopePath?: string | null;
+    content?: string;
+    tags?: string[];
+    confidence?: number;
+    status?: "candidate" | "active" | "superseded" | "archived";
+    memoryType?: "arch" | "rule" | "decision" | "incident" | "verify" | "note";
+    evidence?: Record<string, unknown>;
+}
+interface UpdateButlerMemoryBody extends CreateButlerMemoryBody {
+}
+interface CreateButlerInboxItemBody {
+    projectId?: string;
+    itemType?: "bug" | "feature" | "change" | "task";
+    title?: string;
+    content?: string;
+    priority?: "low" | "medium" | "high";
+    status?: "pending" | "in_progress" | "closed";
+}
+interface UpdateButlerInboxItemBody extends CreateButlerInboxItemBody {
+}
+interface UpdateButlerNotificationArchiveBody {
+    archived?: boolean;
+}
+interface CreateButlerFollowUpTaskBody extends CreateButlerFollowUpTaskInput {
+}
+interface ButlerPatrolPlanListQuery {
+    enabled?: "true" | "false";
+    executionMode?: "readonly" | "controlled";
+}
+interface CreatePatrolPlanBody {
+    name?: string;
+    triggerType?: "manual" | "interval" | "cron";
+    triggerConfig?: Record<string, unknown>;
+    executionMode?: "readonly" | "controlled";
+    patrolScope?: Record<string, unknown>;
+    enabled?: boolean;
+}
+interface UpdatePatrolPlanBody {
+    name?: string;
+    triggerConfig?: Record<string, unknown>;
+    executionMode?: "readonly" | "controlled";
+    patrolScope?: Record<string, unknown>;
+    enabled?: boolean;
+    lastScheduledAt?: string | null;
+    nextRunAt?: string | null;
+}
+interface ButlerPatrolRunListQuery {
+    status?: "queued" | "running" | "succeeded" | "failed" | "cancelled";
+}
+interface StartPatrolRunBody {
+    planId?: string | null;
+    triggeredBy?: "scheduler" | "user" | "system";
+    triggerRef?: string | null;
+    butlerSessionId?: string | null;
+    suggestions?: string[];
+}
+interface ButlerVerificationListQuery {
+    status?: "queued" | "running" | "passed" | "failed" | "skipped";
+    verificationType?: "test" | "health" | "browser" | "visual" | "metric";
+}
+interface StartVerificationRunBody {
+    verificationType?: "test" | "health" | "browser" | "visual" | "metric";
+    targetRef?: string | null;
+    butlerSessionId?: string | null;
+    sourcePatrolRunId?: string | null;
+    spec?: Record<string, unknown>;
+}
+interface StartButlerControlSessionBody extends StartButlerControlSessionInput {
+}
+interface SendButlerControlMessageBody extends SendButlerControlMessageInput {
+}
+interface OpenButlerProjectActionBody {
+    projectId?: string;
+}
+interface ResumeButlerProjectSessionActionBody extends ResumeButlerProjectSessionActionInput {
+}
+interface StartButlerPatrolActionBody extends StartButlerPatrolActionInput {
+}
+interface StartButlerVerificationActionBody extends StartButlerVerificationActionInput {
+}
+export declare class ButlerController {
+    private readonly butlerProfileService;
+    private readonly butlerControlSessionService;
+    private readonly butlerControlActionService;
+    private readonly butlerContextAggregator;
+    private readonly butlerFollowUpService;
+    private readonly butlerInboxService;
+    private readonly butlerNotificationService;
+    private readonly butlerProjectService;
+    private readonly butlerSessionService;
+    private readonly projectMemoryService;
+    private readonly patrolPlanService;
+    private readonly patrolRunService;
+    private readonly patrolExecutionService;
+    private readonly verificationRunService;
+    private readonly butlerActionContextService?;
+    constructor(butlerProfileService: ButlerProfileService, butlerControlSessionService: ButlerControlSessionService, butlerControlActionService: Pick<ButlerControlActionService, "listCurrentEvents" | "openProject" | "resumeProjectSession" | "startPatrol" | "startVerification">, butlerContextAggregator: Pick<ButlerContextAggregator, "getOverview" | "getSnapshot" | "getProjectContext" | "searchSummaries">, butlerFollowUpService: ButlerFollowUpService, butlerInboxService: ButlerInboxService, butlerNotificationService: ButlerNotificationService, butlerProjectService: ButlerProjectService, butlerSessionService: ButlerSessionService, projectMemoryService: ProjectMemoryService, patrolPlanService: PatrolPlanService, patrolRunService: PatrolRunService, patrolExecutionService: PatrolExecutionService, verificationRunService: VerificationRunService, butlerActionContextService?: Pick<ButlerActionContextService, "getSessionActionContext" | "invalidateSessionActionContext"> | undefined);
+    readonly getProfile: (_request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly initProfile: (request: FastifyRequest<{
+        Body: ButlerProfilePatchInput;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateProfile: (request: FastifyRequest<{
+        Body: ButlerProfilePatchInput;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getCurrentControlSession: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly listControlSessionEvents: (_request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly resetControlSession: (_request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly startControlSession: (request: FastifyRequest<{
+        Body: StartButlerControlSessionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly resumeControlSession: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly sendControlMessage: (request: FastifyRequest<{
+        Body: SendButlerControlMessageBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getOverview: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly listInboxItems: (request: FastifyRequest<{
+        Querystring: ButlerInboxListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listFollowUpTasks: (request: FastifyRequest<{
+        Querystring: ButlerFollowUpTaskListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createFollowUpTask: (request: FastifyRequest<{
+        Body: CreateButlerFollowUpTaskBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getFollowUpTask: (request: FastifyRequest<{
+        Params: ButlerFollowUpTaskParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly cancelFollowUpTask: (request: FastifyRequest<{
+        Params: ButlerFollowUpTaskParams;
+        Body: CancelButlerFollowUpTaskBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createInboxItem: (request: FastifyRequest<{
+        Body: CreateButlerInboxItemBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateInboxItem: (request: FastifyRequest<{
+        Params: ButlerInboxItemParams;
+        Body: UpdateButlerInboxItemBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly deleteInboxItem: (request: FastifyRequest<{
+        Params: ButlerInboxItemParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listNotificationArchives: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly updateNotificationArchive: (request: FastifyRequest<{
+        Params: ButlerNotificationParams;
+        Body: UpdateButlerNotificationArchiveBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getContextSnapshot: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly getProjectContext: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly searchSummaries: (request: FastifyRequest<{
+        Querystring: ButlerSearchQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getSessionTarget: (request: FastifyRequest<{
+        Querystring: ButlerSessionTargetQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getSessionActionContext: (request: FastifyRequest<{
+        Querystring: ButlerSessionActionContextQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly openProjectAction: (request: FastifyRequest<{
+        Body: OpenButlerProjectActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly resumeProjectSessionAction: (request: FastifyRequest<{
+        Body: ResumeButlerProjectSessionActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly startPatrolAction: (request: FastifyRequest<{
+        Body: StartButlerPatrolActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly startVerificationAction: (request: FastifyRequest<{
+        Body: StartButlerVerificationActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listProjects: (request: FastifyRequest<{
+        Querystring: ButlerProjectListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createProject: (request: FastifyRequest<{
+        Body: CreateButlerProjectBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getProject: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateProject: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Body: UpdateButlerProjectBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getProjectOverview: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listProjectSessions: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly importProjectSession: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Body: ImportButlerSessionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly startProjectSession: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Body: StartButlerSessionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly captureProjectSessionSnapshot: (request: FastifyRequest<{
+        Params: ButlerSessionParams;
+        Body: CaptureButlerSessionSnapshotBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly resumeProjectSession: (request: FastifyRequest<{
+        Params: ButlerSessionParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listProjectMemories: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Querystring: ButlerMemoryListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createProjectMemory: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Body: CreateButlerMemoryBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateProjectMemory: (request: FastifyRequest<{
+        Params: ButlerMemoryParams;
+        Body: UpdateButlerMemoryBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listPatrolPlans: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Querystring: ButlerPatrolPlanListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createPatrolPlan: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Body: CreatePatrolPlanBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updatePatrolPlan: (request: FastifyRequest<{
+        Params: ButlerPlanParams;
+        Body: UpdatePatrolPlanBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listPatrolRuns: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Querystring: ButlerPatrolRunListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly startPatrolRun: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Body: StartPatrolRunBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getPatrolRun: (request: FastifyRequest<{
+        Params: ButlerRunParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listVerificationRuns: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Querystring: ButlerVerificationListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly startVerificationRun: (request: FastifyRequest<{
+        Params: ButlerProjectParams;
+        Body: StartVerificationRunBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getVerificationRun: (request: FastifyRequest<{
+        Params: ButlerVerificationParams;
+    }>, reply: FastifyReply) => Promise<void>;
+}
+export {};