@teamclaws/teamclaw 2026.3.26-2 → 2026.4.2-1

package/src/types.ts

@@ -23,6 +23,10 @@ export type GitSyncMode = "shared" | "bundle" | "remote";
 
 export type WorkerProvisioningType = "none" | "process" | "docker" | "kubernetes";
 
+export type ProcessModel = "multi";
+
+export type AgentIsolationMode = "independent" | "main";
+
 export type ProvisionedWorkerStatus =
   | "launching"
   | "registered"
@@ -30,6 +34,11 @@ export type ProvisionedWorkerStatus =
   | "terminated"
   | "failed";
 
+export type ProvisioningReadinessStatus =
+  | "checking"
+  | "ready"
+  | "degraded";
+
 export type GitRepoState = {
   enabled: boolean;
   mode: GitSyncMode;
@@ -82,7 +91,7 @@ export type WorkerInfo = {
   role: RoleId;
   label: string;
   status: WorkerStatus;
-  transport?: "http" | "local";
+  transport?: "http";
   url: string;
   lastHeartbeat: number;
   capabilities: string[];
@@ -101,6 +110,7 @@ export type TaskInfo = {
   createdBy: string;
   recommendedSkills?: string[];
   controllerSessionKey?: string;
+  projectDir?: string;
   createdAt: number;
   updatedAt: number;
   startedAt?: number;
@@ -133,6 +143,7 @@ export type TaskAssignmentPayload = {
   description: string;
   priority?: TaskPriority;
   recommendedSkills?: string[];
+  projectDir?: string;
   executionSessionKey?: string;
   executionIdempotencyKey?: string;
   repo?: RepoSyncInfo;
@@ -146,6 +157,29 @@ export type WorkerTaskResultDeliverable = {
   kind: "file" | "directory" | "command" | "artifact" | "note";
   value: string;
   summary?: string;
+  artifactType?: "web-app" | "static-site" | "rest-api" | "binary" | "document";
+  previewCommand?: string;
+  previewCwd?: string;
+  previewReadyPath?: string;
+  liveUrl?: string;
+};
+
+export type DynamicPreviewRecord = {
+  id: string;
+  taskId: string;
+  deliverableIndex: number;
+  deliverableValue: string;
+  targetPort: number;
+  previewCommand: string;
+  previewCwd: string;
+  previewReadyPath: string;
+  liveUrl: string;
+  status: "launching" | "starting" | "healthy" | "stopped" | "failed";
+  pid?: number;
+  createdAt: number;
+  updatedAt: number;
+  lastHealthCheckAt?: number;
+  lastError?: string;
 };
 
 export type WorkerTaskResultFollowUp = {
@@ -164,6 +198,8 @@ export type WorkerTaskResultContract = {
   followUps: WorkerTaskResultFollowUp[];
   questions: string[];
   notes?: string;
+  /** Reusable codebase patterns discovered during this task (consolidated into workspace memory). */
+  discoveredPatterns?: string[];
 };
 
 export type WorkerProgressContract = {
@@ -204,6 +240,27 @@ export type TeamMessageContract = {
   references: string[];
 };
 
+export type KickoffAssessment = {
+  role: RoleId;
+  needed: boolean;
+  scope: string;
+  suggestedTasks: string[];
+  dependencies: string[];
+  risks: string[];
+  questions: string[];
+};
+
+export type KickoffPlan = {
+  /** Complexity level determined by controller's initial analysis. */
+  complexity: "simple" | "medium" | "complex";
+  /** Roles invited to the kickoff meeting. */
+  candidateRoles: RoleId[];
+  /** Collected assessments from each role (populated after kickoff). */
+  assessments: KickoffAssessment[];
+  /** Whether the kickoff phase has completed. */
+  completed: boolean;
+};
+
 export type ControllerManifestCreatedTask = {
   title: string;
   assignedRole?: RoleId;
@@ -217,16 +274,45 @@ export type ControllerManifestDeferredTask = {
   whenReady: string;
 };
 
+export type ClarificationQuestionKind = "single-select" | "multi-select" | "number" | "text";
+
+export type ClarificationQuestionOption = {
+  value: string;
+  label: string;
+  hint?: string;
+};
+
+export type ClarificationQuestionSchema = {
+  kind: ClarificationQuestionKind;
+  title: string;
+  description?: string;
+  required?: boolean;
+  options?: ClarificationQuestionOption[];
+  allowOther?: boolean;
+  placeholder?: string;
+  unit?: string;
+  min?: number;
+  max?: number;
+  step?: number;
+};
+
 export type ControllerOrchestrationManifest = {
   version: string;
+  /** Short, filesystem-safe project name chosen by the controller (e.g. "todo-rest-api", "stripe-payment-integration"). */
+  projectName?: string;
   requirementSummary: string;
   requiredRoles: RoleId[];
   clarificationsNeeded: boolean;
   clarificationQuestions: string[];
+  clarificationSchemas?: ClarificationQuestionSchema[];
   createdTasks: ControllerManifestCreatedTask[];
   deferredTasks: ControllerManifestDeferredTask[];
   handoffPlan?: string;
   notes?: string;
+  /** Controller signals that the entire human requirement is fully satisfied — no more tasks or follow-ups needed. */
+  requirementFullyComplete?: boolean;
+  /** Team kickoff plan — populated when controller uses collaborative planning. */
+  kickoffPlan?: KickoffPlan;
 };
 
 export type ControllerRunInfo = {
@@ -240,6 +326,7 @@ export type ControllerRunInfo = {
   request: string;
   reply?: string;
   error?: string;
+  projectDir?: string;
   createdTaskIds: string[];
   manifest?: ControllerOrchestrationManifest;
   status: TaskExecutionStatus;
@@ -289,14 +376,21 @@ export type ClarificationStatus = "pending" | "answered";
 export type ClarificationRequest = {
   id: string;
   taskId: string;
+  controllerRunId?: string;
+  controllerSessionKey?: string;
   requestedBy: string;
   requestedByWorkerId?: string;
   requestedByRole?: RoleId;
   question: string;
+  questionSchema?: ClarificationQuestionSchema;
   blockingReason: string;
   context?: string;
   status: ClarificationStatus;
   answer?: string;
+  answerValue?: string;
+  answerValues?: string[];
+  answerNumber?: number;
+  answerComment?: string;
   answeredBy?: string;
   createdAt: number;
   updatedAt: number;
@@ -332,8 +426,19 @@ export type ProvisionedWorkerRecord = {
   lastError?: string;
 };
 
+export type StartupProvisioningReadiness = {
+  status: ProvisioningReadinessStatus;
+  startedAt: number;
+  checkedAt: number;
+  attempts: number;
+  requiredRoles: RoleId[];
+  readyWorkerIds: string[];
+  message?: string;
+};
+
 export type TeamProvisioningState = {
   workers: Record<string, ProvisionedWorkerRecord>;
+  startupReadiness?: StartupProvisioningReadiness;
 };
 
 export type PluginConfig = {
@@ -343,14 +448,16 @@ export type PluginConfig = {
   controllerUrl: string;
   teamName: string;
   heartbeatIntervalMs: number;
-  localRoles: RoleId[];
+  processModel: ProcessModel;
   taskTimeoutMs: number;
   gitEnabled: boolean;
   gitRemoteUrl: string;
   gitDefaultBranch: string;
   gitAuthorName: string;
   gitAuthorEmail: string;
+  agentIsolationMode: AgentIsolationMode;
   workerProvisioningType: WorkerProvisioningType;
+  workerProvisioningDisabled: boolean;
   workerProvisioningControllerUrl: string;
   workerProvisioningRoles: RoleId[];
   workerProvisioningMinPerRole: number;
@@ -367,6 +474,7 @@ export type PluginConfig = {
   workerProvisioningKubernetesNamespace: string;
   workerProvisioningKubernetesContext: string;
   workerProvisioningKubernetesServiceAccount: string;
+  workerProvisioningKubernetesImagePullSecrets: string[];
   workerProvisioningKubernetesWorkspacePersistentVolumeClaim: string;
   workerProvisioningKubernetesLabels: Record<string, string>;
   workerProvisioningKubernetesAnnotations: Record<string, string>;
@@ -388,10 +496,24 @@ export type TeamState = {
   clarifications: Record<string, ClarificationRequest>;
   repo?: GitRepoState;
   provisioning?: TeamProvisioningState;
+  previews?: Record<string, DynamicPreviewRecord>;
+  reports?: Record<string, DeliveryReportRecord>;
   createdAt: number;
   updatedAt: number;
 };
 
+export type DeliveryReportRecord = {
+  id: string;
+  sessionKey: string;
+  generatedAt: number;
+  projectName: string;
+  requirementSummary: string;
+  status: "completed" | "partial" | "failed";
+  taskCount: number;
+  deliverableCount: number;
+  previewCount: number;
+};
+
 export type DiscoveryResult = {
   name: string;
   host: string;
@@ -434,13 +556,13 @@ export function parsePluginConfig(raw: Record<string, unknown> = {}): PluginConf
 
   const teamName = typeof raw.teamName === "string" && raw.teamName.trim()
     ? raw.teamName.trim()
-    : "default";
+    : "TeamClaw";
 
   const heartbeatIntervalMs = typeof raw.heartbeatIntervalMs === "number" && raw.heartbeatIntervalMs >= 1000
     ? raw.heartbeatIntervalMs
     : 10000;
 
-  const localRoles = parseRoleList(raw.localRoles);
+  const processModel: ProcessModel = "multi";
 
   const taskTimeoutMs = typeof raw.taskTimeoutMs === "number" && raw.taskTimeoutMs >= 1000
     ? raw.taskTimeoutMs
@@ -464,7 +586,24 @@ export function parsePluginConfig(raw: Record<string, unknown> = {}): PluginConf
     ? raw.gitAuthorEmail.trim()
     : "teamclaw@local";
 
-  const workerProvisioningType = parseProvisioningType(raw.workerProvisioningType);
+  const agentIsolationMode: AgentIsolationMode =
+    typeof raw.agentIsolationMode === "string" && (raw.agentIsolationMode === "independent" || raw.agentIsolationMode === "main")
+      ? raw.agentIsolationMode
+      : "independent";
+
+  const rawWorkerProvisioningType = parseProvisioningType(raw.workerProvisioningType);
+  const workerProvisioningDisabled = raw.workerProvisioningDisabled === true;
+  // Legacy local installs often persisted workerProvisioningType="none" without
+  // distinguishing "manual/no provisioning" from "same-host local controller".
+  // Keep an explicit escape hatch via workerProvisioningDisabled, but otherwise
+  // default multi-process controllers back to process provisioning.
+  const workerProvisioningType: WorkerProvisioningType =
+    mode === "controller" &&
+    rawWorkerProvisioningType === "none" &&
+    processModel === "multi" &&
+    !workerProvisioningDisabled
+      ? "process"
+      : rawWorkerProvisioningType;
   const workerProvisioningControllerUrl = typeof raw.workerProvisioningControllerUrl === "string"
     ? raw.workerProvisioningControllerUrl.trim()
     : "";
@@ -474,7 +613,7 @@ export function parsePluginConfig(raw: Record<string, unknown> = {}): PluginConf
     : 0;
   const rawProvisioningMaxPerRole = typeof raw.workerProvisioningMaxPerRole === "number" && raw.workerProvisioningMaxPerRole >= 1
     ? Math.floor(raw.workerProvisioningMaxPerRole)
-    : 1;
+    : 3;
   const workerProvisioningMaxPerRole = Math.max(rawProvisioningMaxPerRole, workerProvisioningMinPerRole);
   const workerProvisioningIdleTtlMs = typeof raw.workerProvisioningIdleTtlMs === "number" && raw.workerProvisioningIdleTtlMs >= 1000
     ? raw.workerProvisioningIdleTtlMs
@@ -512,6 +651,7 @@ export function parsePluginConfig(raw: Record<string, unknown> = {}): PluginConf
   const workerProvisioningKubernetesServiceAccount = typeof raw.workerProvisioningKubernetesServiceAccount === "string"
     ? raw.workerProvisioningKubernetesServiceAccount.trim()
     : "";
+  const workerProvisioningKubernetesImagePullSecrets = parseStringArray(raw.workerProvisioningKubernetesImagePullSecrets);
   const workerProvisioningKubernetesWorkspacePersistentVolumeClaim =
     typeof raw.workerProvisioningKubernetesWorkspacePersistentVolumeClaim === "string"
       ? raw.workerProvisioningKubernetesWorkspacePersistentVolumeClaim.trim()
@@ -530,14 +670,16 @@ export function parsePluginConfig(raw: Record<string, unknown> = {}): PluginConf
     controllerUrl,
     teamName,
     heartbeatIntervalMs,
-    localRoles,
+    processModel,
     taskTimeoutMs,
     gitEnabled,
     gitRemoteUrl,
     gitDefaultBranch,
     gitAuthorName,
     gitAuthorEmail,
+    agentIsolationMode,
     workerProvisioningType,
+    workerProvisioningDisabled,
     workerProvisioningControllerUrl,
     workerProvisioningRoles,
     workerProvisioningMinPerRole,
@@ -554,6 +696,7 @@ export function parsePluginConfig(raw: Record<string, unknown> = {}): PluginConf
     workerProvisioningKubernetesNamespace,
     workerProvisioningKubernetesContext,
     workerProvisioningKubernetesServiceAccount,
+    workerProvisioningKubernetesImagePullSecrets,
     workerProvisioningKubernetesWorkspacePersistentVolumeClaim,
     workerProvisioningKubernetesLabels,
     workerProvisioningKubernetesAnnotations,