@baochunli/flakes 0.0.4 → 0.0.6

package/dist/node_modules/@flakes/store/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactRef, AcceptedOperationKind as CoreAcceptedOperationKind, DeclaredOutputs, FileWriteReservationSelector, GroupId, GroupKey, LiveTaskParentPromptMode, LiveTaskRoundStatus, LiveTaskState, PolicyEnvelope, RoundOutputSpecs, RoundOutputs, RunKey, RunState, SandboxDescriptor, SavedTaskRecord, SavedTaskUpsertInput, TaskGroupJoinRule, TaskGroupLimitConfig, TaskGroupOutcome, TaskGroupStatus, TaskGroupTerminalChildSummary, TaskGroupWaitResponse, TaskKey, TaskResult, TaskRuntimeOptions, TaskSpawnLimitConfig, TaskSpawnResponse, ToolGrant, TraceContext, WorkspaceBinding, WorkspaceHandle, WorkspaceInputs, WorkspacePathDigestMap, WorkspacePathSelector, WorkspaceReservationMetadata, WorkspaceSelectedRef } from "@flakes/core";
+import type { ArtifactRef, AcceptedOperationKind as CoreAcceptedOperationKind, DeclaredOutputs, FileWriteReservationSelector, GroupId, GroupKey, LiveTaskParentPromptMode, LiveTaskRoundStatus, LiveTaskState, PolicyEnvelope, ProjectId, ProjectKey, ProjectStatus, RoundOutputSpecs, RoundOutputs, RunKey, RunState, SandboxDescriptor, SavedTaskRecord, SavedTaskUpsertInput, TaskGroupJoinRule, TaskGroupLimitConfig, TaskGroupOutcome, TaskGroupStatus, TaskGroupTerminalChildSummary, TaskGroupWaitResponse, TaskKey, TaskResult, TaskRuntimeOptions, TaskSpawnLimitConfig, TaskSpawnResponse, ToolGrant, TraceContext, WorkspaceBinding, WorkspaceHandle, WorkspaceInputs, WorkspacePathDigestMap, WorkspacePathSelector, WorkspaceReservationMetadata, WorkspaceSelectedRef } from "@flakes/core";
 /** Opaque JSON payload persisted by the store without schema validation. */
 export type JsonValue = unknown;
 /** Clock dependency used to make assignment timing and metrics testable. */
@@ -38,7 +38,7 @@ export type HostCredentialTokenFamily = "host";
 /** Store-facing runtime credential scope for host agent tokens. */
 export type HostCredentialScope = "host";
 /** Lifecycle state for one managed sandbox daemon incarnation. */
-export type ManagedSandboxInstanceStatus = "pending_launch" | "launching" | "running" | "draining" | "stopping" | "stopped" | "failed" | "expired" | "cancelled";
+export type ManagedSandboxInstanceStatus = "pending_launch" | "launching" | "running" | "draining" | "stopping" | "deleting" | "stopped" | "failed" | "expired" | "cancelled";
 /** Host-agent provisioning action kind supported by the current public store API. */
 export type ProvisioningLeaseAction = "launch" | "provider_stop" | "provider_cleanup";
 /** Durable lifecycle state for a provisioning lease. */
@@ -54,9 +54,127 @@ export interface StoreOwnerFields {
     ownerId: string;
     ownerKey: string;
 }
+/** Stored owner-scoped product project. */
+export interface StoreProject extends StoreOwnerFields {
+    projectId: ProjectId;
+    projectKey: ProjectKey;
+    name: string;
+    status: ProjectStatus;
+    metadata?: Record<string, unknown> | undefined;
+    archivedAt?: string | undefined;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Project creation payload with immutable owner-scoped key. */
+export interface CreateProjectInput extends StoreOwnerFields {
+    projectId?: ProjectId | undefined;
+    projectKey: ProjectKey;
+    name: string;
+    metadata?: Record<string, unknown> | undefined;
+}
+/** Owner-scoped project lookup by durable ID. */
+export interface GetProjectByIdInput {
+    ownerKey: string;
+    projectId: ProjectId;
+}
+/** Owner-scoped project lookup by immutable key. */
+export interface GetProjectInput {
+    ownerKey: string;
+    projectKey: ProjectKey;
+}
+/** Owner-scoped project listing. */
+export interface ListProjectsInput {
+    ownerKey: string;
+    status?: ProjectStatus | undefined;
+}
+/** Owner-scoped project update for mutable display fields. */
+export interface UpdateProjectInput {
+    ownerKey: string;
+    projectKey: ProjectKey;
+    name?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}
+/** Owner-scoped project archival. */
+export interface ArchiveProjectInput {
+    ownerKey: string;
+    projectKey: ProjectKey;
+}
+/** Console-managed host-local root where project workspaces are derived. */
+export interface SetHostProjectWorkspaceRootInput {
+    ownerKey: string;
+    hostId: string;
+    projectWorkspaceRoot: string;
+}
+export type HostProjectBindingAvailability = "unknown" | "available" | "unavailable";
+/** Stored owner-host-project binding used by project-aware host placement. */
+export interface StoreHostProjectBinding extends StoreOwnerFields {
+    bindingId: string;
+    hostId: string;
+    projectId: ProjectId;
+    projectKey: ProjectKey;
+    allowedPoolKeys: string[];
+    availability: HostProjectBindingAvailability;
+    unavailableReason?: string | undefined;
+    lastValidatedAt?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Upserts an owner-host-project binding and its allowed pool key set. */
+export interface UpsertHostProjectBindingInput {
+    ownerKey: string;
+    hostId: string;
+    projectKey: ProjectKey;
+    allowedPoolKeys: readonly string[];
+    metadata?: Record<string, unknown> | undefined;
+}
+/** Lists project bindings for one owned host. */
+export interface ListHostProjectBindingsInput {
+    ownerKey: string;
+    hostId: string;
+}
+/** Records the latest host validation state for one project binding. */
+export interface UpdateHostProjectBindingAvailabilityInput {
+    ownerKey: string;
+    hostId: string;
+    bindingId: string;
+    availability: Exclude<HostProjectBindingAvailability, "unknown">;
+    unavailableReason?: string | undefined;
+}
+/** Marks host project bindings omitted from the current fenced host snapshot unavailable. */
+export interface MarkHostProjectBindingSnapshotOmissionsInput {
+    streamFence: HostStreamMutationFence;
+    activeBindingIds: readonly string[];
+    unavailableReason: string;
+}
+export type MarkHostProjectBindingSnapshotOmissionsResult = {
+    status: "applied";
+} | {
+    status: "stale_stream";
+};
+export interface HostProjectBindingValidationReport {
+    bindingId: string;
+    availability: Exclude<HostProjectBindingAvailability, "unknown">;
+    unavailableReason?: string | undefined;
+}
+/** Records one host validation report for the bindings sent on a fenced stream. */
+export interface RecordHostProjectBindingValidationReportInput {
+    streamFence: HostStreamMutationFence;
+    expectedBindingIds: readonly string[];
+    bindings: readonly HostProjectBindingValidationReport[];
+    omittedUnavailableReason: string;
+}
+export type RecordHostProjectBindingValidationReportResult = {
+    status: "applied";
+} | {
+    status: "rejected";
+} | {
+    status: "stale_stream";
+};
 /** Run creation payload, optionally idempotent within a client scope. */
 export interface CreateRunInput extends StoreOwnerFields {
     runId: string;
+    projectId?: ProjectId | undefined;
     name: string;
     clientScope?: string | undefined;
     idempotencyKey?: string | undefined;
@@ -77,6 +195,7 @@ export type TryCreateRunResult = {
 /** Stored run metadata and derived aggregate state. */
 export interface StoreRun extends StoreOwnerFields {
     runId: string;
+    projectId?: ProjectId | undefined;
     name: string;
     state: RunState;
     clientScope?: string | undefined;
@@ -97,6 +216,7 @@ export interface RunsListCursor {
 /** Filters and keyset cursor for listing one owner's runs newest-first. */
 export interface ListRunsInput {
     ownerKey: string;
+    projectId?: ProjectId | undefined;
     state?: RunState | undefined;
     cursor?: RunsListCursor | undefined;
     limit?: number | undefined;
@@ -900,6 +1020,7 @@ export interface CreateAgentInput {
 /** Accepted task payload before the store derives queue and dependency state. */
 export interface StoreTaskInput {
     taskId: string;
+    projectId?: ProjectId | undefined;
     agentId: string;
     agentInstanceId?: string | undefined;
     target?: {
@@ -953,6 +1074,7 @@ export interface SeedAcceptedTasksForTestInput {
 export interface StoreTask extends StoreOwnerFields {
     taskId: string;
     runId: string;
+    projectId?: ProjectId | undefined;
     agentId: string;
     agentInstanceId?: string | undefined;
     status: TaskStatus;
@@ -1554,6 +1676,7 @@ export interface StorePlacementDecision extends StoreOwnerFields {
     placementDecisionId: string;
     runId: string;
     taskId: string;
+    projectId?: ProjectId | undefined;
     sandboxId?: string | undefined;
     assignmentId?: string | undefined;
     decision: StorePlacementDecisionKind;
@@ -1880,6 +2003,7 @@ export interface StoreManagedSandboxInstance {
     ownerKind: StoreOwnerKind;
     ownerId: string;
     ownerKey: string;
+    projectId?: ProjectId | undefined;
     hostId: string;
     hostPoolId: string;
     sandboxId: string;
@@ -1893,6 +2017,8 @@ export interface StoreManagedSandboxInstance {
 /** Durable lease row used to fence host-agent provisioning work. */
 export interface StoreProvisioningLease extends StoreOwnerFields {
     leaseId: string;
+    projectId?: ProjectId | undefined;
+    hostProjectBindingId?: string | undefined;
     hostId: string;
     hostPoolId?: string | undefined;
     instanceId: string;
@@ -1919,6 +2045,8 @@ export interface StoreProvisioningLease extends StoreOwnerFields {
 /** Creates a pending launch lease after owner/link validation. */
 export interface CreatePendingLeaseInput extends StoreOwnerFields {
     leaseId?: string | undefined;
+    projectId?: ProjectId | undefined;
+    hostProjectBindingId?: string | undefined;
     action: ProvisioningLeaseAction;
     hostId: string;
     hostPoolId: string;
@@ -1948,6 +2076,8 @@ export interface CreatePendingCleanupLeaseInput extends StoreOwnerFields {
 /** Scheduler-created launch demand after live sandbox placement has no match. */
 export interface CreateLaunchLeaseFromQueuedDemandInput extends StoreOwnerFields {
     taskId: string;
+    projectId?: ProjectId | undefined;
+    hostProjectBindingId?: string | undefined;
     hostId: string;
     hostPoolId: string;
     maxAttempts: number;
@@ -2018,6 +2148,8 @@ export interface ClaimCleanupLeasesInput {
 export interface ClaimedLaunchLease {
     lease: StoreProvisioningLease;
     credential: StoreSandboxCredential;
+    hostProjectBindingId: string;
+    projectKey: ProjectKey;
 }
 /** One claimed provider stop lease ready for host-local execution. */
 export interface ClaimedStopLease {
@@ -2144,6 +2276,7 @@ export interface StoreHost extends StoreOwnerFields {
     hostId: string;
     name: string;
     status: HostStatus;
+    projectWorkspaceRoot?: string | undefined;
     lastSeenAt?: string | undefined;
     connectionId?: string | undefined;
     streamGeneration: number;
@@ -2397,6 +2530,7 @@ export interface MarkHostStreamOfflineResult {
 /** Creates durable pending state before invoking host-agent provisioning. */
 export interface CreateManagedSandboxInstanceInput extends StoreOwnerFields {
     instanceId?: string | undefined;
+    projectId?: ProjectId | undefined;
     hostId: string;
     hostPoolId: string;
     sandboxId: string;
@@ -2427,6 +2561,33 @@ export interface SetManagedSandboxInstanceLifecycleStatusResult {
     instance: StoreManagedSandboxInstance;
     clearedAssignments: number;
 }
+/** Owner-scoped managed sandbox deletion for stale rows that need no provider cleanup. */
+export interface DeleteManagedSandboxInstanceInput {
+    ownerKey: string;
+    sandboxId: string;
+    reason?: string | undefined;
+}
+export type DeleteManagedSandboxInstanceBlocker = "unsafe_status" | "live_sandbox" | "accepted_running_assignments" | "provider_cleanup_required";
+export type DeleteManagedSandboxInstanceResult = {
+    status: "deleted";
+    sandboxId: string;
+    instanceId: string;
+    clearedAssignments: number;
+} | {
+    status: "cleanup_queued";
+    sandboxId: string;
+    instanceId: string;
+    leaseId: string;
+    providerResourceId: string;
+    clearedAssignments: number;
+} | {
+    status: "blocked";
+    sandboxId: string;
+    blockers: DeleteManagedSandboxInstanceBlocker[];
+    clearedAssignments?: number | undefined;
+} | {
+    status: "not_found";
+};
 /** Filters for listing managed instance state for diagnostics and capacity accounting. */
 export interface ListManagedSandboxInstancesInput {
     ownerKey?: string | undefined;
@@ -2828,6 +2989,18 @@ export interface ExtractEvaluationMetricsInput {
 export interface DurableStore {
     /** Releases database resources held by this store instance. */
     close(): Promise<void>;
+    /** Creates an owner-scoped project with an immutable key. */
+    createProject(input: CreateProjectInput): Promise<StoreProject>;
+    /** Returns one owner-scoped project by immutable key. */
+    getProject(input: GetProjectInput): Promise<StoreProject | undefined>;
+    /** Returns one owner-scoped project by durable ID. */
+    getProjectById(input: GetProjectByIdInput): Promise<StoreProject | undefined>;
+    /** Lists projects for one owner. */
+    listProjects(input: ListProjectsInput): Promise<StoreProject[]>;
+    /** Updates mutable project display fields. */
+    updateProject(input: UpdateProjectInput): Promise<StoreProject | undefined>;
+    /** Archives one project without deleting it. */
+    archiveProject(input: ArchiveProjectInput): Promise<StoreProject | undefined>;
     /** Creates a run or replays the same idempotent creation request. */
     createRun(input: CreateRunInput): Promise<StoreRun>;
     /** Attempts to insert a run and reports whether this call created it. */
@@ -2943,6 +3116,18 @@ export interface DurableStore {
     disableHost(input: DisableHostInput): Promise<StoreHost | undefined>;
     /** Deletes one owned host only when active lifecycle state has drained. */
     deleteHost(input: DeleteHostInput): Promise<DeleteHostResult>;
+    /** Stores a console-managed host-local project workspace root. */
+    setHostProjectWorkspaceRoot(input: SetHostProjectWorkspaceRootInput): Promise<StoreHost | undefined>;
+    /** Upserts one project binding for an owned host. */
+    upsertHostProjectBinding(input: UpsertHostProjectBindingInput): Promise<StoreHostProjectBinding>;
+    /** Lists project bindings for an owned host. */
+    listHostProjectBindings(input: ListHostProjectBindingsInput): Promise<StoreHostProjectBinding[]>;
+    /** Updates host-reported availability for one project binding. */
+    updateHostProjectBindingAvailability(input: UpdateHostProjectBindingAvailabilityInput): Promise<StoreHostProjectBinding | undefined>;
+    /** Marks host project bindings omitted from the current fenced host snapshot unavailable. */
+    markHostProjectBindingSnapshotOmissions(input: MarkHostProjectBindingSnapshotOmissionsInput): Promise<MarkHostProjectBindingSnapshotOmissionsResult>;
+    /** Records one host validation report for the bindings sent on a fenced stream. */
+    recordHostProjectBindingValidationReport(input: RecordHostProjectBindingValidationReportInput): Promise<RecordHostProjectBindingValidationReportResult>;
     /** Creates a hashed host credential for one owner-bound host. */
     createHostCredential(input: CreateHostCredentialInput): Promise<StoreHostCredential>;
     /** Lists redacted host credentials scoped to one owner and host. */
@@ -2985,6 +3170,8 @@ export interface DurableStore {
     markManagedSandboxInstanceFailed(input: MarkManagedSandboxInstanceFailedInput): Promise<StoreManagedSandboxInstance | undefined>;
     /** Marks an owned running managed sandbox draining or stopping. */
     setManagedSandboxInstanceLifecycleStatus(input: SetManagedSandboxInstanceLifecycleStatusInput): Promise<SetManagedSandboxInstanceLifecycleStatusResult | undefined>;
+    /** Deletes one owner-scoped stale managed sandbox that needs no provider cleanup. */
+    deleteManagedSandboxInstance(input: DeleteManagedSandboxInstanceInput): Promise<DeleteManagedSandboxInstanceResult>;
     /** Returns one owner/host-scoped provisioning lease. */
     getProvisioningLease(input: GetProvisioningLeaseInput): Promise<StoreProvisioningLease | undefined>;
     /** Creates a pending provisioning lease and atomically links launch leases. */