@jingyi0605/codingns 0.1.4 → 0.1.5

package/dist/server/storage/sqlite/schema.sql

@@ -163,6 +163,24 @@ CREATE INDEX IF NOT EXISTS idx_session_message_attachments_message
 CREATE INDEX IF NOT EXISTS idx_session_message_attachments_client_request
   ON session_message_attachments(session_id, client_request_id);
 
+CREATE TABLE IF NOT EXISTS session_message_origins (
+  session_id TEXT NOT NULL,
+  client_request_id TEXT NOT NULL,
+  message_id TEXT,
+  origin TEXT NOT NULL CHECK (origin IN ('butler_proxy', 'system')),
+  origin_ref TEXT,
+  content TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (session_id, client_request_id),
+  FOREIGN KEY (session_id) REFERENCES session_bindings(session_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_session_message_origins_message
+  ON session_message_origins(session_id, message_id);
+CREATE INDEX IF NOT EXISTS idx_session_message_origins_origin
+  ON session_message_origins(session_id, origin, updated_at DESC);
+
 CREATE TABLE IF NOT EXISTS session_send_queue (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL,
@@ -367,6 +385,312 @@ CREATE TABLE IF NOT EXISTS terminal_command_templates (
 CREATE INDEX IF NOT EXISTS idx_terminal_templates_workspace_id
   ON terminal_command_templates(workspace_id);
 
+CREATE TABLE IF NOT EXISTS butler_profiles (
+  id TEXT PRIMARY KEY CHECK (id = 'default'),
+  display_name TEXT NOT NULL,
+  provider_id TEXT NOT NULL CHECK (provider_id IN ('codex', 'claude-code')),
+  workspace_path TEXT NOT NULL,
+  agents_mode TEXT NOT NULL CHECK (agents_mode IN ('inline', 'file')),
+  agents_file_path TEXT,
+  agents_content TEXT NOT NULL,
+  persona_json TEXT NOT NULL,
+  focus_json TEXT NOT NULL,
+  initialized_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS butler_control_sessions (
+  id TEXT PRIMARY KEY,
+  provider_id TEXT NOT NULL CHECK (provider_id IN ('codex', 'claude-code')),
+  session_id TEXT NOT NULL UNIQUE,
+  status TEXT NOT NULL CHECK (status IN ('idle', 'running', 'failed', 'closed')),
+  last_context_version TEXT,
+  last_summary TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (session_id) REFERENCES session_bindings(session_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_control_sessions_provider
+  ON butler_control_sessions(provider_id, updated_at DESC, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS butler_control_events (
+  id TEXT PRIMARY KEY,
+  control_session_id TEXT NOT NULL,
+  kind TEXT NOT NULL CHECK (kind IN ('action')),
+  action_type TEXT NOT NULL CHECK (
+    action_type IN ('open-project', 'resume-session', 'start-patrol', 'start-verification')
+  ),
+  status TEXT NOT NULL CHECK (status IN ('succeeded', 'failed')),
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  related_refs_json TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (control_session_id) REFERENCES butler_control_sessions(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_control_events_session_created_at
+  ON butler_control_events(control_session_id, created_at ASC);
+
+CREATE TABLE IF NOT EXISTS butler_inbox_items (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  item_type TEXT NOT NULL CHECK (item_type IN ('bug', 'feature', 'change', 'task')),
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  priority TEXT NOT NULL CHECK (priority IN ('low', 'medium', 'high')),
+  status TEXT NOT NULL CHECK (status IN ('pending', 'in_progress', 'closed')),
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  closed_at TEXT,
+  FOREIGN KEY (project_id) REFERENCES butler_projects(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_inbox_items_project_updated_at
+  ON butler_inbox_items(project_id, updated_at DESC, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_butler_inbox_items_status_updated_at
+  ON butler_inbox_items(status, updated_at DESC, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS butler_notification_archives (
+  user_id TEXT NOT NULL,
+  notification_id TEXT NOT NULL,
+  archived_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (user_id, notification_id),
+  FOREIGN KEY (user_id) REFERENCES auth_users(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_notification_archives_user_updated_at
+  ON butler_notification_archives(user_id, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS butler_projects (
+  id TEXT PRIMARY KEY,
+  workspace_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  repo_root TEXT NOT NULL,
+  default_provider TEXT,
+  instruction_profile_id TEXT,
+  approval_mode TEXT NOT NULL CHECK (approval_mode IN ('readonly', 'controlled', 'auto')),
+  lifecycle_status TEXT NOT NULL CHECK (lifecycle_status IN ('active', 'paused', 'archived')),
+  risk_level TEXT NOT NULL CHECK (risk_level IN ('low', 'medium', 'high')),
+  config_json TEXT NOT NULL,
+  last_patrol_at TEXT,
+  last_verification_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  archived_at TEXT,
+  FOREIGN KEY (workspace_id) REFERENCES workspaces(id),
+  UNIQUE (workspace_id, repo_root)
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_projects_workspace_id
+  ON butler_projects(workspace_id);
+CREATE INDEX IF NOT EXISTS idx_butler_projects_status
+  ON butler_projects(lifecycle_status, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS butler_sessions (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  session_id TEXT NOT NULL UNIQUE,
+  role TEXT NOT NULL CHECK (role IN ('patrol', 'execution', 'verification', 'adhoc')),
+  ownership_mode TEXT NOT NULL CHECK (ownership_mode IN ('managed', 'observed')),
+  status TEXT NOT NULL CHECK (status IN ('idle', 'running', 'blocked', 'failed', 'closed')),
+  last_summary TEXT,
+  last_checkpoint_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (project_id) REFERENCES butler_projects(id) ON DELETE CASCADE,
+  FOREIGN KEY (session_id) REFERENCES session_bindings(session_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_sessions_project_id
+  ON butler_sessions(project_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_butler_sessions_status
+  ON butler_sessions(status, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS butler_follow_up_tasks (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  butler_session_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  created_by_user_id TEXT NOT NULL,
+  objective TEXT NOT NULL,
+  completion_criteria TEXT NOT NULL DEFAULT '',
+  max_auto_continue_count INTEGER NOT NULL DEFAULT 5,
+  status TEXT NOT NULL CHECK (
+    status IN ('active', 'waiting_user', 'completed', 'failed', 'cancelled')
+  ),
+  check_interval_seconds INTEGER NOT NULL,
+  last_checked_at TEXT,
+  next_check_at TEXT,
+  last_observed_running_state TEXT,
+  last_observed_message_at TEXT,
+  last_observed_message_count INTEGER NOT NULL DEFAULT 0,
+  last_automation_summary TEXT,
+  last_automation_at TEXT,
+  auto_continue_count INTEGER NOT NULL DEFAULT 0,
+  waiting_reason TEXT,
+  rounds_json TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  completed_at TEXT,
+  FOREIGN KEY (project_id) REFERENCES butler_projects(id) ON DELETE CASCADE,
+  FOREIGN KEY (butler_session_id) REFERENCES butler_sessions(id) ON DELETE CASCADE,
+  FOREIGN KEY (session_id) REFERENCES session_bindings(session_id) ON DELETE CASCADE,
+  FOREIGN KEY (created_by_user_id) REFERENCES auth_users(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_follow_up_tasks_status
+  ON butler_follow_up_tasks(status, next_check_at ASC, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_butler_follow_up_tasks_session
+  ON butler_follow_up_tasks(butler_session_id, status, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS butler_session_summary_states (
+  butler_session_id TEXT PRIMARY KEY,
+  source_message_count INTEGER NOT NULL DEFAULT 0,
+  source_last_message_at TEXT,
+  last_summarized_at TEXT,
+  last_summarized_sequence INTEGER,
+  debounce_until TEXT,
+  status TEXT NOT NULL CHECK (status IN ('idle', 'scheduled', 'running', 'failed')),
+  error_detail TEXT,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (butler_session_id) REFERENCES butler_sessions(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_butler_session_summary_states_status
+  ON butler_session_summary_states(status, debounce_until ASC, updated_at ASC);
+
+CREATE TABLE IF NOT EXISTS session_checkpoints (
+  id TEXT PRIMARY KEY,
+  butler_session_id TEXT NOT NULL,
+  checkpoint_seq INTEGER NOT NULL,
+  source_kind TEXT NOT NULL CHECK (
+    source_kind IN ('snapshot', 'summary', 'verification', 'manual')
+  ),
+  progress_state TEXT NOT NULL CHECK (
+    progress_state IN ('unknown', 'working', 'blocked', 'done')
+  ),
+  summary TEXT NOT NULL,
+  risk_flags_json TEXT NOT NULL,
+  next_action_json TEXT NOT NULL,
+  captured_at TEXT NOT NULL,
+  FOREIGN KEY (butler_session_id) REFERENCES butler_sessions(id) ON DELETE CASCADE,
+  UNIQUE (butler_session_id, checkpoint_seq)
+);
+
+CREATE INDEX IF NOT EXISTS idx_session_checkpoints_session_id
+  ON session_checkpoints(butler_session_id, checkpoint_seq DESC);
+CREATE INDEX IF NOT EXISTS idx_session_checkpoints_captured_at
+  ON session_checkpoints(captured_at DESC);
+
+CREATE TABLE IF NOT EXISTS project_memories (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  source_butler_session_id TEXT,
+  source_checkpoint_id TEXT,
+  memory_type TEXT NOT NULL CHECK (
+    memory_type IN ('arch', 'rule', 'decision', 'incident', 'verify', 'note')
+  ),
+  title TEXT NOT NULL,
+  scope_path TEXT,
+  content TEXT NOT NULL,
+  tags_json TEXT NOT NULL,
+  confidence REAL NOT NULL CHECK (confidence >= 0 AND confidence <= 1),
+  status TEXT NOT NULL CHECK (
+    status IN ('candidate', 'active', 'superseded', 'archived')
+  ),
+  evidence_json TEXT NOT NULL,
+  superseded_by TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (project_id) REFERENCES butler_projects(id) ON DELETE CASCADE,
+  FOREIGN KEY (source_butler_session_id) REFERENCES butler_sessions(id),
+  FOREIGN KEY (source_checkpoint_id) REFERENCES session_checkpoints(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_project_memories_project_id
+  ON project_memories(project_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_project_memories_project_status
+  ON project_memories(project_id, status, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_project_memories_project_scope
+  ON project_memories(project_id, scope_path, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS patrol_plans (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  trigger_type TEXT NOT NULL CHECK (trigger_type IN ('manual', 'interval', 'cron')),
+  trigger_config_json TEXT NOT NULL,
+  execution_mode TEXT NOT NULL CHECK (execution_mode IN ('readonly', 'controlled')),
+  patrol_scope_json TEXT NOT NULL,
+  enabled INTEGER NOT NULL CHECK (enabled IN (0, 1)),
+  last_scheduled_at TEXT,
+  next_run_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (project_id) REFERENCES butler_projects(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_patrol_plans_project_id
+  ON patrol_plans(project_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_patrol_plans_enabled_next_run_at
+  ON patrol_plans(enabled, next_run_at);
+
+CREATE TABLE IF NOT EXISTS patrol_runs (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  plan_id TEXT,
+  triggered_by TEXT NOT NULL CHECK (triggered_by IN ('scheduler', 'user', 'system')),
+  trigger_ref TEXT,
+  butler_session_id TEXT,
+  status TEXT NOT NULL CHECK (
+    status IN ('queued', 'running', 'succeeded', 'failed', 'cancelled')
+  ),
+  summary TEXT,
+  risk_level TEXT CHECK (risk_level IS NULL OR risk_level IN ('low', 'medium', 'high')),
+  suggestions_json TEXT NOT NULL,
+  started_at TEXT,
+  finished_at TEXT,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (project_id) REFERENCES butler_projects(id) ON DELETE CASCADE,
+  FOREIGN KEY (plan_id) REFERENCES patrol_plans(id),
+  FOREIGN KEY (butler_session_id) REFERENCES butler_sessions(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_patrol_runs_project_started_at
+  ON patrol_runs(project_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_patrol_runs_project_status
+  ON patrol_runs(project_id, status, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS verification_runs (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  butler_session_id TEXT,
+  source_patrol_run_id TEXT,
+  verification_type TEXT NOT NULL CHECK (
+    verification_type IN ('test', 'health', 'browser', 'visual', 'metric')
+  ),
+  status TEXT NOT NULL CHECK (
+    status IN ('queued', 'running', 'passed', 'failed', 'skipped')
+  ),
+  target_ref TEXT,
+  spec_json TEXT NOT NULL,
+  artifact_refs_json TEXT NOT NULL,
+  result_json TEXT NOT NULL,
+  summary TEXT,
+  started_at TEXT,
+  finished_at TEXT,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (project_id) REFERENCES butler_projects(id) ON DELETE CASCADE,
+  FOREIGN KEY (butler_session_id) REFERENCES butler_sessions(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_verification_runs_project_created_at
+  ON verification_runs(project_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_verification_runs_project_status
+  ON verification_runs(project_id, status, created_at DESC);
+
 INSERT INTO bootstrap_state (id, initialized)
 VALUES ('default', 0)
 ON CONFLICT(id) DO NOTHING;

package/dist/server/types/domain.d.ts

@@ -107,6 +107,17 @@ export interface SessionMessageAttachmentRecord {
     storagePath: string;
     createdAt: string;
 }
+export type SessionMessageOrigin = "butler_proxy" | "system";
+export interface SessionMessageOriginRecord {
+    sessionId: string;
+    clientRequestId: string;
+    messageId: string | null;
+    origin: SessionMessageOrigin;
+    originRef: string | null;
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+}
 export type SessionSendQueueStatus = "queued" | "dispatching" | "failed";
 export interface SessionSendQueueItemRecord {
     id: string;
@@ -198,7 +209,7 @@ export interface UserQuickPhrasePreferenceRecord {
     createdAt: string;
     updatedAt: string;
 }
-export type PreferenceProviderId = "claude-code" | "codex" | "opencode";
+export type PreferenceProviderId = "claude-code" | "codex" | "opencode" | "gemini" | "kimi";
 export type UserPreferenceLanguage = "zh-CN" | "en-US";
 export type UserPreferenceTheme = "light" | "dark" | "sky-blue" | "eye-green";
 export type UserPreferencePermissionMode = "default" | "acceptEdits" | "bypassPermissions";
@@ -218,6 +229,255 @@ export interface UserPreferenceProfileRecord extends UserPreferenceProfile {
     createdAt: string;
     updatedAt: string;
 }
+export type ButlerProfileProviderId = "codex" | "claude-code";
+export type ButlerAgentsMode = "inline" | "file";
+export type ButlerControlSessionStatus = "idle" | "running" | "failed" | "closed";
+export type ButlerControlEventKind = "action";
+export type ButlerControlActionType = "open-project" | "resume-session" | "start-patrol" | "start-verification";
+export type ButlerControlEventStatus = "succeeded" | "failed";
+export interface ButlerPersonaProfile {
+    tone: string;
+    language: string;
+    summaryStyle: string;
+    [key: string]: unknown;
+}
+export interface ButlerFocusProfile {
+    projectIds: string[];
+    riskPreference: string;
+    reportPriority: string[];
+    summaryDebounceSeconds: number;
+    [key: string]: unknown;
+}
+export type ButlerApprovalMode = "readonly" | "controlled" | "auto";
+export type ButlerLifecycleStatus = "active" | "paused" | "archived";
+export type ButlerRiskLevel = "low" | "medium" | "high";
+export type ButlerSessionRole = "patrol" | "execution" | "verification" | "adhoc";
+export type ButlerSessionOwnershipMode = "managed" | "observed";
+export type ButlerSessionStatus = "idle" | "running" | "blocked" | "failed" | "closed";
+export type ButlerSessionSummaryStatus = "idle" | "scheduled" | "running" | "failed";
+export type ButlerCheckpointSourceKind = "snapshot" | "summary" | "verification" | "manual";
+export type ButlerCheckpointProgressState = "unknown" | "working" | "blocked" | "done";
+export type ButlerInboxItemType = "bug" | "feature" | "change" | "task";
+export type ButlerInboxItemStatus = "pending" | "in_progress" | "closed";
+export type ButlerInboxItemPriority = "low" | "medium" | "high";
+export type ButlerFollowUpTaskStatus = "active" | "waiting_user" | "completed" | "failed" | "cancelled";
+export type ProjectMemoryType = "arch" | "rule" | "decision" | "incident" | "verify" | "note";
+export type ProjectMemoryStatus = "candidate" | "active" | "superseded" | "archived";
+export type PatrolTriggerType = "manual" | "interval" | "cron";
+export type PatrolExecutionMode = "readonly" | "controlled";
+export type PatrolRunTriggeredBy = "scheduler" | "user" | "system";
+export type PatrolRunStatus = "queued" | "running" | "succeeded" | "failed" | "cancelled";
+export type VerificationType = "test" | "health" | "browser" | "visual" | "metric";
+export type VerificationRunStatus = "queued" | "running" | "passed" | "failed" | "skipped";
+export interface ButlerProfile {
+    id: "default";
+    displayName: string;
+    providerId: ButlerProfileProviderId;
+    workspacePath: string;
+    agentsMode: ButlerAgentsMode;
+    agentsFilePath: string | null;
+    agentsContent: string;
+    persona: ButlerPersonaProfile;
+    focus: ButlerFocusProfile;
+    initializedAt: string;
+    updatedAt: string;
+}
+export interface ButlerControlSession {
+    id: string;
+    providerId: ButlerProfileProviderId;
+    sessionId: string;
+    status: ButlerControlSessionStatus;
+    lastContextVersion: string | null;
+    lastSummary: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ButlerControlRelatedRef {
+    kind: "project" | "butler-session" | "session" | "patrol-run" | "verification-run" | "workspace";
+    id: string;
+    label: string;
+    routePath: string | null;
+    workspaceId: string | null;
+    projectId: string | null;
+}
+export interface ButlerControlEvent {
+    id: string;
+    controlSessionId: string;
+    kind: ButlerControlEventKind;
+    actionType: ButlerControlActionType;
+    status: ButlerControlEventStatus;
+    title: string;
+    content: string;
+    relatedRefs: ButlerControlRelatedRef[];
+    createdAt: string;
+}
+export interface ButlerProject {
+    id: string;
+    workspaceId: string;
+    name: string;
+    repoRoot: string;
+    defaultProvider: ProviderId | null;
+    instructionProfileId: string | null;
+    approvalMode: ButlerApprovalMode;
+    lifecycleStatus: ButlerLifecycleStatus;
+    riskLevel: ButlerRiskLevel;
+    config: Record<string, unknown>;
+    lastPatrolAt: string | null;
+    lastVerificationAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt: string | null;
+}
+export interface ButlerSession {
+    id: string;
+    projectId: string;
+    sessionId: string;
+    role: ButlerSessionRole;
+    ownershipMode: ButlerSessionOwnershipMode;
+    status: ButlerSessionStatus;
+    lastSummary: string | null;
+    lastCheckpointAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ButlerInboxItem {
+    id: string;
+    projectId: string;
+    itemType: ButlerInboxItemType;
+    title: string;
+    content: string;
+    priority: ButlerInboxItemPriority;
+    status: ButlerInboxItemStatus;
+    createdAt: string;
+    updatedAt: string;
+    closedAt: string | null;
+}
+export interface ButlerNotificationArchiveRecord {
+    userId: string;
+    notificationId: string;
+    archivedAt: string;
+    updatedAt: string;
+}
+export interface ButlerFollowUpTask {
+    id: string;
+    projectId: string;
+    butlerSessionId: string;
+    sessionId: string;
+    createdByUserId: string;
+    objective: string;
+    completionCriteria: string;
+    maxAutoContinueCount: number;
+    status: ButlerFollowUpTaskStatus;
+    checkIntervalSeconds: number;
+    lastCheckedAt: string | null;
+    nextCheckAt: string | null;
+    lastObservedRunningState: SessionRunningState | null;
+    lastObservedMessageAt: string | null;
+    lastObservedMessageCount: number;
+    lastAutomationSummary: string | null;
+    lastAutomationAt: string | null;
+    autoContinueCount: number;
+    waitingReason: string | null;
+    rounds: ButlerFollowUpRound[];
+    createdAt: string;
+    updatedAt: string;
+    completedAt: string | null;
+}
+export type ButlerFollowUpRoundKind = "started" | "continue" | "queued" | "waiting_user" | "completed" | "failed" | "cancelled" | "limit_reached";
+export interface ButlerFollowUpRound {
+    roundNumber: number;
+    kind: ButlerFollowUpRoundKind;
+    status: ButlerFollowUpTaskStatus;
+    summary: string;
+    waitingReason: string | null;
+    continuePrompt: string | null;
+    observedRunningState: SessionRunningState | null;
+    autoContinueCount: number;
+    createdAt: string;
+}
+export interface ButlerSessionSummaryState {
+    butlerSessionId: string;
+    sourceMessageCount: number;
+    sourceLastMessageAt: string | null;
+    lastSummarizedAt: string | null;
+    lastSummarizedSequence: number | null;
+    debounceUntil: string | null;
+    status: ButlerSessionSummaryStatus;
+    errorDetail: string | null;
+    updatedAt: string;
+}
+export interface SessionCheckpoint {
+    id: string;
+    butlerSessionId: string;
+    checkpointSeq: number;
+    sourceKind: ButlerCheckpointSourceKind;
+    progressState: ButlerCheckpointProgressState;
+    summary: string;
+    riskFlags: string[];
+    nextActions: string[];
+    capturedAt: string;
+}
+export interface ProjectMemory {
+    id: string;
+    projectId: string;
+    sourceButlerSessionId: string | null;
+    sourceCheckpointId: string | null;
+    memoryType: ProjectMemoryType;
+    title: string;
+    scopePath: string | null;
+    content: string;
+    tags: string[];
+    confidence: number;
+    status: ProjectMemoryStatus;
+    evidence: Record<string, unknown>;
+    supersededBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PatrolPlan {
+    id: string;
+    projectId: string;
+    name: string;
+    triggerType: PatrolTriggerType;
+    triggerConfig: Record<string, unknown>;
+    executionMode: PatrolExecutionMode;
+    patrolScope: Record<string, unknown>;
+    enabled: boolean;
+    lastScheduledAt: string | null;
+    nextRunAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PatrolRun {
+    id: string;
+    projectId: string;
+    planId: string | null;
+    triggeredBy: PatrolRunTriggeredBy;
+    triggerRef: string | null;
+    butlerSessionId: string | null;
+    status: PatrolRunStatus;
+    summary: string | null;
+    riskLevel: ButlerRiskLevel | null;
+    suggestions: string[];
+    startedAt: string | null;
+    finishedAt: string | null;
+    createdAt: string;
+}
+export interface VerificationRun {
+    id: string;
+    projectId: string;
+    butlerSessionId: string | null;
+    sourcePatrolRunId: string | null;
+    verificationType: VerificationType;
+    status: VerificationRunStatus;
+    targetRef: string | null;
+    summary: string | null;
+    artifactRefs: Array<Record<string, unknown>>;
+    result: Record<string, unknown>;
+    startedAt: string | null;
+    finishedAt: string | null;
+    createdAt: string;
+}
 export interface FileContextBinding {
     id: string;
     sessionId: string;

package/dist/server/ws/ws-server.d.ts

@@ -2,6 +2,7 @@ import type { IncomingMessage, Server } from "node:http";
 import { type WebSocket } from "ws";
 import type { SessionHistoryEnvelope, SessionHistoryService } from "../modules/sessions/session-history-service.js";
 import type { SessionLiveRuntimeService } from "../modules/sessions/session-live-runtime-service.js";
+import type { ButlerActionContextService } from "../modules/butler/butler-action-context-service.js";
 import type { TerminalWsHub } from "./terminal-ws-hub.js";
 import type { WorkbenchWsHub } from "./workbench-ws-hub.js";
 import type { WsAuthGuard } from "./ws-auth-guard.js";
@@ -13,7 +14,7 @@ interface SeenMessageEntry {
     contentPreview: string;
     toolCallStatus: "running" | "completed" | "failed" | null;
 }
-export declare function createWsServer(server: Server, wsAuthGuard: WsAuthGuard, sessionHistoryService: SessionHistoryService, sessionLiveRuntimeService: SessionLiveRuntimeService, terminalWsHub: TerminalWsHub, workbenchWsHub: WorkbenchWsHub): {
+export declare function createWsServer(server: Server, wsAuthGuard: WsAuthGuard, sessionHistoryService: SessionHistoryService, sessionLiveRuntimeService: SessionLiveRuntimeService, terminalWsHub: TerminalWsHub, workbenchWsHub: WorkbenchWsHub, butlerActionContextService?: Pick<ButlerActionContextService, "preloadSessionActionContext">): {
     wss: import("ws").Server<typeof WebSocket, typeof IncomingMessage>;
     close: () => Promise<void>;
 };

package/dist/server/ws/ws-server.js

@@ -3,7 +3,7 @@ import { AppError } from "../shared/errors/app-error.js";
 import { hashContent } from "../shared/utils/hash.js";
 const MAX_TRACKED_MESSAGES_PER_SUBSCRIPTION = 2_048;
 const MAX_STORED_MESSAGE_PREVIEW_CHARS = 2_048;
-export function createWsServer(server, wsAuthGuard, sessionHistoryService, sessionLiveRuntimeService, terminalWsHub, workbenchWsHub) {
+export function createWsServer(server, wsAuthGuard, sessionHistoryService, sessionLiveRuntimeService, terminalWsHub, workbenchWsHub, butlerActionContextService) {
     const wss = new WebSocketServer({
         noServer: true
     });
@@ -95,6 +95,7 @@ export function createWsServer(server, wsAuthGuard, sessionHistoryService, sessi
                 type: "session.subscribed",
                 sessionId: payload.sessionId
             }));
+            butlerActionContextService?.preloadSessionActionContext(payload.sessionId, authContext.user.userId);
             const seenMessages = new Map();
             const forwardEnvelope = async (envelope) => {
                 const deduped = dedupeEnvelopeMessages(envelope, seenMessages);