@ours.network/fleet 1.2.0-nightly.2 → 1.2.0-nightly.21

package/dist/application/task-room-service.d.ts

@@ -1,3 +1,6 @@
+import type { AddMemberRequest } from '../rooms-tasks/add-member.js';
+import { TaskLayouts } from './task-layouts.js';
+import { type LiveReadinessDeps, type TaskReadinessIssue } from '../rooms-tasks/live-readiness.js';
 import { type FleetConfig } from '../config.js';
 import { type CoworkAdapter } from '../rooms-tasks/cowork-adapter.js';
 import { provisionMembers } from '../rooms-tasks/provision.js';
@@ -57,9 +60,9 @@ export interface TaskProvisioningOutcome {
 /** Repairable terminal observation derived entirely from durable Task/Room state. */
 export declare function recordTaskProvisioningOutcome(outcome: TaskProvisioningOutcome): void;
 export declare class TaskRoomApplicationError extends Error {
-    readonly code: 'template_not_found' | 'task_template_drift' | 'template_mismatch' | 'task_terminal' | 'task_terminal_already' | 'task_non_resumable' | 'task_deleting' | 'room_not_found' | 'room_record_not_found';
+    readonly code: 'template_not_found' | 'task_template_drift' | 'template_mismatch' | 'task_terminal' | 'task_terminal_already' | 'task_non_resumable' | 'task_deleting' | 'room_not_found' | 'room_record_not_found' | 'task_not_ready';
     readonly fields: Readonly<Record<string, string>>;
-    constructor(code: 'template_not_found' | 'task_template_drift' | 'template_mismatch' | 'task_terminal' | 'task_terminal_already' | 'task_non_resumable' | 'task_deleting' | 'room_not_found' | 'room_record_not_found', message: string, fields?: Readonly<Record<string, string>>);
+    constructor(code: 'template_not_found' | 'task_template_drift' | 'template_mismatch' | 'task_terminal' | 'task_terminal_already' | 'task_non_resumable' | 'task_deleting' | 'room_not_found' | 'room_record_not_found' | 'task_not_ready', message: string, fields?: Readonly<Record<string, string>>);
 }
 export interface CreateTaskRequest {
     actor: TaskRoomActor;
@@ -74,6 +77,8 @@ export interface CreateTaskRequest {
     list?: string;
     members?: MemberOverrides;
     anonymous?: boolean;
+    /** Room Layout name: the task's rooms and participants come from a layout run. */
+    layout?: string;
 }
 export interface CreateRoomRequest {
     actor: TaskRoomActor;
@@ -87,8 +92,12 @@ export interface CreateRoomRequest {
 }
 export declare function resolveRoomLaunchPolicy(template: TemplateSnapshot | undefined, override: boolean | undefined): RoomLaunchPolicy;
 export interface TaskRoomServiceDeps {
+    taskLayouts?: TaskLayouts;
+    liveReadiness?: LiveReadinessDeps;
     loadConfiguration?(path?: string): FleetConfig;
-    cowork?(config: FleetConfig): CoworkAdapter;
+    cowork?(config: FleetConfig, options?: {
+        timeoutMs: number;
+    }): CoworkAdapter;
     binPath?(): string;
     provisionMembers?: typeof provisionMembers;
     moveTaskToList?: typeof moveTaskToList;
@@ -101,6 +110,67 @@ export declare class TaskRoomApplicationService {
     private readonly configurationPath?;
     private readonly deps;
     constructor(configurationPath?: string | undefined, deps?: TaskRoomServiceDeps);
+    addMember(taskId: string, request: AddMemberRequest): Promise<{
+        requestId: string;
+        taskId: string;
+        roleId: string;
+        state: "running" | "succeeded" | "attention" | "failed";
+        error?: string;
+    } | {
+        state: string;
+        error: string;
+        requestId: string;
+        taskId: string;
+        roleId: string;
+    }>;
+    memberAddition(taskId: string, requestId: string): Promise<{
+        requestId: string;
+        taskId: string;
+        roleId: string;
+        state: "running" | "succeeded" | "attention" | "failed";
+        error?: string;
+    } | {
+        state: string;
+        error: string;
+        requestId: string;
+        taskId: string;
+        roleId: string;
+    }>;
+    private layouts;
+    private createLayoutTask;
+    /** Layout tasks never provision the legacy single room; their run is a local snapshot. */
+    private ensureLayoutWork;
+    /** Compact room list for task listings; never fails the listing on an unreadable run. */
+    withLayoutRooms<T extends TaskRecord>(task: T): T & {
+        layout_rooms?: Array<{
+            key: string;
+            state: string;
+            room_id?: string;
+            identity_cid?: string;
+        }>;
+    };
+    /** Backlog only: choose, change or clear the task's Room Layout before it starts. */
+    setTaskLayout(input: {
+        actor: TaskRoomActor;
+        taskId: string;
+        layout: string | null;
+        expectedLayout: string | null;
+    }): Promise<TaskRecord>;
+    taskLayout(taskId: string): import("./task-layouts.js").TaskLayoutView;
+    launchTaskLayoutOperation(input: {
+        actor: TaskRoomActor;
+        taskId: string;
+        operation: 'open' | 'close-room';
+        room: string;
+    }): Promise<import("./task-layouts.js").TaskLayoutOperationRecord>;
+    /** Worker entry for detached layout operations. */
+    runTaskLayoutOperation(input: {
+        actor: TaskRoomActor;
+        taskId: string;
+        operation: 'open' | 'close-room' | 'close';
+        room?: string;
+        operationId?: string;
+    }): Promise<import("./task-layouts.js").TaskLayoutView>;
     createTask(request: CreateTaskRequest): Promise<TaskRecord>;
     createRoom(request: CreateRoomRequest): Promise<RoomOrchestrationRecord>;
     startTask(input: {
@@ -147,10 +217,17 @@ export declare class TaskRoomApplicationService {
         moved: number;
         destination?: TaskListRecord;
     }>;
+    editTaskDescription(input: {
+        actor: TaskRoomActor;
+        taskId: string;
+        brief: string;
+        expectedBrief: string;
+    }): TaskRecord;
     getTask(taskId: string): {
         task: TaskRecord;
         orchestration: RoomOrchestrationRecord | undefined;
     };
+    /** Durable provisioning progress only; use active task start/work for a live readiness check. */
     taskProvisioningOutcome(taskId: string): TaskProvisioningOutcome;
     awaitTaskProvisioning(input: {
         actor: TaskRoomActor;
@@ -209,10 +286,20 @@ export declare class TaskRoomApplicationService {
         taskId: string;
         outcome?: TaskOutcome;
     }): Promise<TaskSettlementPlan>;
+    /** Terminal layout tasks archive their rooms and retire only agents their run created. */
+    private withLayoutCleanup;
+    /** Retry terminal layout cleanup for known resources (e.g. after a failed close). */
+    retryTaskLayoutCleanup(input: {
+        actor: TaskRoomActor;
+        taskId: string;
+    }): Promise<import("./task-layouts.js").TaskLayoutOperationRecord>;
     cancelTask(input: {
         actor: TaskRoomActor;
         taskId: string;
     }): Promise<TaskSettlementPlan>;
+    /** Continue accepted operations outside the HTTP connection's lifetime. */
+    launchTaskSettlement(taskId: string): Promise<TaskRecord>;
+    launchTaskProvisioning(taskId: string): Promise<TaskProvisioningOutcome>;
     settleTask(input: {
         actor: {
             kind: 'internal_worker';
@@ -279,6 +366,9 @@ export declare class TaskRoomApplicationService {
         actor: TaskRoomActor;
         roomId: string;
     }): Promise<{
+        room: undefined;
+        settlementRequired: true;
+    } | {
         room: RoomOrchestrationRecord;
         settlementRequired: true;
     }>;
@@ -300,6 +390,12 @@ export declare class TaskRoomApplicationService {
         taskId: string;
         outcome?: TaskOutcome;
     }): Promise<TaskSettlementPlan>;
+    /** Point-in-time health, separate from durable provisioning and lifecycle. */
+    observeTaskReadiness(taskId: string): Promise<{
+        state: 'ready';
+    } | TaskReadinessIssue>;
+    private observeLiveReadiness;
+    private assertTaskLiveReadiness;
     ensureTaskWork(input: {
         actor: TaskRoomActor;
         taskId: string;