@highstate/backend 0.19.1 → 0.20.0

package/src/database/_generated/project/models/Operation.ts

@@ -210,6 +210,7 @@ export type OperationWhereInput = {
   finishedAt?: Prisma.DateTimeNullableFilter<"Operation"> | Date | string | null
   operationStates?: Prisma.InstanceOperationStateListRelationFilter
   logs?: Prisma.OperationLogListRelationFilter
+  entitySnapshots?: Prisma.EntitySnapshotListRelationFilter
 }
 
 export type OperationOrderByWithRelationInput = {
@@ -225,6 +226,7 @@ export type OperationOrderByWithRelationInput = {
   finishedAt?: Prisma.SortOrderInput | Prisma.SortOrder
   operationStates?: Prisma.InstanceOperationStateOrderByRelationAggregateInput
   logs?: Prisma.OperationLogOrderByRelationAggregateInput
+  entitySnapshots?: Prisma.EntitySnapshotOrderByRelationAggregateInput
 }
 
 export type OperationWhereUniqueInput = Prisma.AtLeast<{
@@ -243,6 +245,7 @@ export type OperationWhereUniqueInput = Prisma.AtLeast<{
   finishedAt?: Prisma.DateTimeNullableFilter<"Operation"> | Date | string | null
   operationStates?: Prisma.InstanceOperationStateListRelationFilter
   logs?: Prisma.OperationLogListRelationFilter
+  entitySnapshots?: Prisma.EntitySnapshotListRelationFilter
 }, "id">
 
 export type OperationOrderByWithAggregationInput = {
@@ -290,6 +293,7 @@ export type OperationCreateInput = {
   finishedAt?: Date | string | null
   operationStates?: Prisma.InstanceOperationStateCreateNestedManyWithoutOperationInput
   logs?: Prisma.OperationLogCreateNestedManyWithoutOperationInput
+  entitySnapshots?: Prisma.EntitySnapshotCreateNestedManyWithoutOperationInput
 }
 
 export type OperationUncheckedCreateInput = {
@@ -305,6 +309,7 @@ export type OperationUncheckedCreateInput = {
   finishedAt?: Date | string | null
   operationStates?: Prisma.InstanceOperationStateUncheckedCreateNestedManyWithoutOperationInput
   logs?: Prisma.OperationLogUncheckedCreateNestedManyWithoutOperationInput
+  entitySnapshots?: Prisma.EntitySnapshotUncheckedCreateNestedManyWithoutOperationInput
 }
 
 export type OperationUpdateInput = {
@@ -320,6 +325,7 @@ export type OperationUpdateInput = {
   finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
   operationStates?: Prisma.InstanceOperationStateUpdateManyWithoutOperationNestedInput
   logs?: Prisma.OperationLogUpdateManyWithoutOperationNestedInput
+  entitySnapshots?: Prisma.EntitySnapshotUpdateManyWithoutOperationNestedInput
 }
 
 export type OperationUncheckedUpdateInput = {
@@ -335,6 +341,7 @@ export type OperationUncheckedUpdateInput = {
   finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
   operationStates?: Prisma.InstanceOperationStateUncheckedUpdateManyWithoutOperationNestedInput
   logs?: Prisma.OperationLogUncheckedUpdateManyWithoutOperationNestedInput
+  entitySnapshots?: Prisma.EntitySnapshotUncheckedUpdateManyWithoutOperationNestedInput
 }
 
 export type OperationCreateManyInput = {
@@ -376,6 +383,11 @@ export type OperationUncheckedUpdateManyInput = {
   finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
 }
 
+export type OperationScalarRelationFilter = {
+  is?: Prisma.OperationWhereInput
+  isNot?: Prisma.OperationWhereInput
+}
+
 export type OperationCountOrderByAggregateInput = {
   id?: Prisma.SortOrder
   meta?: Prisma.SortOrder
@@ -407,9 +419,18 @@ export type OperationMinOrderByAggregateInput = {
   finishedAt?: Prisma.SortOrder
 }
 
-export type OperationScalarRelationFilter = {
-  is?: Prisma.OperationWhereInput
-  isNot?: Prisma.OperationWhereInput
+export type OperationCreateNestedOneWithoutEntitySnapshotsInput = {
+  create?: Prisma.XOR<Prisma.OperationCreateWithoutEntitySnapshotsInput, Prisma.OperationUncheckedCreateWithoutEntitySnapshotsInput>
+  connectOrCreate?: Prisma.OperationCreateOrConnectWithoutEntitySnapshotsInput
+  connect?: Prisma.OperationWhereUniqueInput
+}
+
+export type OperationUpdateOneRequiredWithoutEntitySnapshotsNestedInput = {
+  create?: Prisma.XOR<Prisma.OperationCreateWithoutEntitySnapshotsInput, Prisma.OperationUncheckedCreateWithoutEntitySnapshotsInput>
+  connectOrCreate?: Prisma.OperationCreateOrConnectWithoutEntitySnapshotsInput
+  upsert?: Prisma.OperationUpsertWithoutEntitySnapshotsInput
+  connect?: Prisma.OperationWhereUniqueInput
+  update?: Prisma.XOR<Prisma.XOR<Prisma.OperationUpdateToOneWithWhereWithoutEntitySnapshotsInput, Prisma.OperationUpdateWithoutEntitySnapshotsInput>, Prisma.OperationUncheckedUpdateWithoutEntitySnapshotsInput>
 }
 
 export type EnumOperationTypeFieldUpdateOperationsInput = {
@@ -452,6 +473,82 @@ export type OperationUpdateOneRequiredWithoutLogsNestedInput = {
   update?: Prisma.XOR<Prisma.XOR<Prisma.OperationUpdateToOneWithWhereWithoutLogsInput, Prisma.OperationUpdateWithoutLogsInput>, Prisma.OperationUncheckedUpdateWithoutLogsInput>
 }
 
+export type OperationCreateWithoutEntitySnapshotsInput = {
+  id?: string
+  meta:PrismaJson.OperationMeta
+  type: $Enums.OperationType
+  status?: $Enums.OperationStatus
+  options:PrismaJson.OperationOptions
+  requestedInstanceIds:PrismaJson.InstanceIds
+  phases?:PrismaJson.OperationPhase[] | Prisma.NullableJsonNullValueInput
+  startedAt?: Date | string
+  updatedAt?: Date | string
+  finishedAt?: Date | string | null
+  operationStates?: Prisma.InstanceOperationStateCreateNestedManyWithoutOperationInput
+  logs?: Prisma.OperationLogCreateNestedManyWithoutOperationInput
+}
+
+export type OperationUncheckedCreateWithoutEntitySnapshotsInput = {
+  id?: string
+  meta:PrismaJson.OperationMeta
+  type: $Enums.OperationType
+  status?: $Enums.OperationStatus
+  options:PrismaJson.OperationOptions
+  requestedInstanceIds:PrismaJson.InstanceIds
+  phases?:PrismaJson.OperationPhase[] | Prisma.NullableJsonNullValueInput
+  startedAt?: Date | string
+  updatedAt?: Date | string
+  finishedAt?: Date | string | null
+  operationStates?: Prisma.InstanceOperationStateUncheckedCreateNestedManyWithoutOperationInput
+  logs?: Prisma.OperationLogUncheckedCreateNestedManyWithoutOperationInput
+}
+
+export type OperationCreateOrConnectWithoutEntitySnapshotsInput = {
+  where: Prisma.OperationWhereUniqueInput
+  create: Prisma.XOR<Prisma.OperationCreateWithoutEntitySnapshotsInput, Prisma.OperationUncheckedCreateWithoutEntitySnapshotsInput>
+}
+
+export type OperationUpsertWithoutEntitySnapshotsInput = {
+  update: Prisma.XOR<Prisma.OperationUpdateWithoutEntitySnapshotsInput, Prisma.OperationUncheckedUpdateWithoutEntitySnapshotsInput>
+  create: Prisma.XOR<Prisma.OperationCreateWithoutEntitySnapshotsInput, Prisma.OperationUncheckedCreateWithoutEntitySnapshotsInput>
+  where?: Prisma.OperationWhereInput
+}
+
+export type OperationUpdateToOneWithWhereWithoutEntitySnapshotsInput = {
+  where?: Prisma.OperationWhereInput
+  data: Prisma.XOR<Prisma.OperationUpdateWithoutEntitySnapshotsInput, Prisma.OperationUncheckedUpdateWithoutEntitySnapshotsInput>
+}
+
+export type OperationUpdateWithoutEntitySnapshotsInput = {
+  id?: Prisma.StringFieldUpdateOperationsInput | string
+  meta?:PrismaJson.OperationMeta
+  type?: Prisma.EnumOperationTypeFieldUpdateOperationsInput | $Enums.OperationType
+  status?: Prisma.EnumOperationStatusFieldUpdateOperationsInput | $Enums.OperationStatus
+  options?:PrismaJson.OperationOptions
+  requestedInstanceIds?:PrismaJson.InstanceIds
+  phases?:PrismaJson.OperationPhase[] | Prisma.NullableJsonNullValueInput
+  startedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
+  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
+  finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
+  operationStates?: Prisma.InstanceOperationStateUpdateManyWithoutOperationNestedInput
+  logs?: Prisma.OperationLogUpdateManyWithoutOperationNestedInput
+}
+
+export type OperationUncheckedUpdateWithoutEntitySnapshotsInput = {
+  id?: Prisma.StringFieldUpdateOperationsInput | string
+  meta?:PrismaJson.OperationMeta
+  type?: Prisma.EnumOperationTypeFieldUpdateOperationsInput | $Enums.OperationType
+  status?: Prisma.EnumOperationStatusFieldUpdateOperationsInput | $Enums.OperationStatus
+  options?:PrismaJson.OperationOptions
+  requestedInstanceIds?:PrismaJson.InstanceIds
+  phases?:PrismaJson.OperationPhase[] | Prisma.NullableJsonNullValueInput
+  startedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
+  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
+  finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
+  operationStates?: Prisma.InstanceOperationStateUncheckedUpdateManyWithoutOperationNestedInput
+  logs?: Prisma.OperationLogUncheckedUpdateManyWithoutOperationNestedInput
+}
+
 export type OperationCreateWithoutOperationStatesInput = {
   id?: string
   meta:PrismaJson.OperationMeta
@@ -464,6 +561,7 @@ export type OperationCreateWithoutOperationStatesInput = {
   updatedAt?: Date | string
   finishedAt?: Date | string | null
   logs?: Prisma.OperationLogCreateNestedManyWithoutOperationInput
+  entitySnapshots?: Prisma.EntitySnapshotCreateNestedManyWithoutOperationInput
 }
 
 export type OperationUncheckedCreateWithoutOperationStatesInput = {
@@ -478,6 +576,7 @@ export type OperationUncheckedCreateWithoutOperationStatesInput = {
   updatedAt?: Date | string
   finishedAt?: Date | string | null
   logs?: Prisma.OperationLogUncheckedCreateNestedManyWithoutOperationInput
+  entitySnapshots?: Prisma.EntitySnapshotUncheckedCreateNestedManyWithoutOperationInput
 }
 
 export type OperationCreateOrConnectWithoutOperationStatesInput = {
@@ -508,6 +607,7 @@ export type OperationUpdateWithoutOperationStatesInput = {
   updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
   finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
   logs?: Prisma.OperationLogUpdateManyWithoutOperationNestedInput
+  entitySnapshots?: Prisma.EntitySnapshotUpdateManyWithoutOperationNestedInput
 }
 
 export type OperationUncheckedUpdateWithoutOperationStatesInput = {
@@ -522,6 +622,7 @@ export type OperationUncheckedUpdateWithoutOperationStatesInput = {
   updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
   finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
   logs?: Prisma.OperationLogUncheckedUpdateManyWithoutOperationNestedInput
+  entitySnapshots?: Prisma.EntitySnapshotUncheckedUpdateManyWithoutOperationNestedInput
 }
 
 export type OperationCreateWithoutLogsInput = {
@@ -536,6 +637,7 @@ export type OperationCreateWithoutLogsInput = {
   updatedAt?: Date | string
   finishedAt?: Date | string | null
   operationStates?: Prisma.InstanceOperationStateCreateNestedManyWithoutOperationInput
+  entitySnapshots?: Prisma.EntitySnapshotCreateNestedManyWithoutOperationInput
 }
 
 export type OperationUncheckedCreateWithoutLogsInput = {
@@ -550,6 +652,7 @@ export type OperationUncheckedCreateWithoutLogsInput = {
   updatedAt?: Date | string
   finishedAt?: Date | string | null
   operationStates?: Prisma.InstanceOperationStateUncheckedCreateNestedManyWithoutOperationInput
+  entitySnapshots?: Prisma.EntitySnapshotUncheckedCreateNestedManyWithoutOperationInput
 }
 
 export type OperationCreateOrConnectWithoutLogsInput = {
@@ -580,6 +683,7 @@ export type OperationUpdateWithoutLogsInput = {
   updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
   finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
   operationStates?: Prisma.InstanceOperationStateUpdateManyWithoutOperationNestedInput
+  entitySnapshots?: Prisma.EntitySnapshotUpdateManyWithoutOperationNestedInput
 }
 
 export type OperationUncheckedUpdateWithoutLogsInput = {
@@ -594,6 +698,7 @@ export type OperationUncheckedUpdateWithoutLogsInput = {
   updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
   finishedAt?: Prisma.NullableDateTimeFieldUpdateOperationsInput | Date | string | null
   operationStates?: Prisma.InstanceOperationStateUncheckedUpdateManyWithoutOperationNestedInput
+  entitySnapshots?: Prisma.EntitySnapshotUncheckedUpdateManyWithoutOperationNestedInput
 }
 
 
@@ -604,11 +709,13 @@ export type OperationUncheckedUpdateWithoutLogsInput = {
 export type OperationCountOutputType = {
   operationStates: number
   logs: number
+  entitySnapshots: number
 }
 
 export type OperationCountOutputTypeSelect<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
   operationStates?: boolean | OperationCountOutputTypeCountOperationStatesArgs
   logs?: boolean | OperationCountOutputTypeCountLogsArgs
+  entitySnapshots?: boolean | OperationCountOutputTypeCountEntitySnapshotsArgs
 }
 
 /**
@@ -635,6 +742,13 @@ export type OperationCountOutputTypeCountLogsArgs<ExtArgs extends runtime.Types.
   where?: Prisma.OperationLogWhereInput
 }
 
+/**
+ * OperationCountOutputType without action
+ */
+export type OperationCountOutputTypeCountEntitySnapshotsArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  where?: Prisma.EntitySnapshotWhereInput
+}
+
 
 export type OperationSelect<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
   id?: boolean
@@ -649,6 +763,7 @@ export type OperationSelect<ExtArgs extends runtime.Types.Extensions.InternalArg
   finishedAt?: boolean
   operationStates?: boolean | Prisma.Operation$operationStatesArgs<ExtArgs>
   logs?: boolean | Prisma.Operation$logsArgs<ExtArgs>
+  entitySnapshots?: boolean | Prisma.Operation$entitySnapshotsArgs<ExtArgs>
   _count?: boolean | Prisma.OperationCountOutputTypeDefaultArgs<ExtArgs>
 }, ExtArgs["result"]["operation"]>
 
@@ -695,6 +810,7 @@ export type OperationOmit<ExtArgs extends runtime.Types.Extensions.InternalArgs
 export type OperationInclude<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
   operationStates?: boolean | Prisma.Operation$operationStatesArgs<ExtArgs>
   logs?: boolean | Prisma.Operation$logsArgs<ExtArgs>
+  entitySnapshots?: boolean | Prisma.Operation$entitySnapshotsArgs<ExtArgs>
   _count?: boolean | Prisma.OperationCountOutputTypeDefaultArgs<ExtArgs>
 }
 export type OperationIncludeCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {}
@@ -711,6 +827,10 @@ export type $OperationPayload<ExtArgs extends runtime.Types.Extensions.InternalA
      * The logs of the operation.
      */
     logs: Prisma.$OperationLogPayload<ExtArgs>[]
+    /**
+     * The entity snapshots created by this operation.
+     */
+    entitySnapshots: Prisma.$EntitySnapshotPayload<ExtArgs>[]
   }
   scalars: runtime.Types.Extensions.GetPayloadResult<{
     /**
@@ -1157,6 +1277,7 @@ export interface Prisma__OperationClient<T, Null = never, ExtArgs extends runtim
   readonly [Symbol.toStringTag]: "PrismaPromise"
   operationStates<T extends Prisma.Operation$operationStatesArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.Operation$operationStatesArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$InstanceOperationStatePayload<ExtArgs>, T, "findMany", GlobalOmitOptions> | Null>
   logs<T extends Prisma.Operation$logsArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.Operation$logsArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$OperationLogPayload<ExtArgs>, T, "findMany", GlobalOmitOptions> | Null>
+  entitySnapshots<T extends Prisma.Operation$entitySnapshotsArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.Operation$entitySnapshotsArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$EntitySnapshotPayload<ExtArgs>, T, "findMany", GlobalOmitOptions> | Null>
   /**
    * Attaches callbacks for the resolution and/or rejection of the Promise.
    * @param onfulfilled The callback to execute when the Promise is resolved.
@@ -1629,6 +1750,30 @@ export type Operation$logsArgs<ExtArgs extends runtime.Types.Extensions.Internal
   distinct?: Prisma.OperationLogScalarFieldEnum | Prisma.OperationLogScalarFieldEnum[]
 }
 
+/**
+ * Operation.entitySnapshots
+ */
+export type Operation$entitySnapshotsArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the EntitySnapshot
+   */
+  select?: Prisma.EntitySnapshotSelect<ExtArgs> | null
+  /**
+   * Omit specific fields from the EntitySnapshot
+   */
+  omit?: Prisma.EntitySnapshotOmit<ExtArgs> | null
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.EntitySnapshotInclude<ExtArgs> | null
+  where?: Prisma.EntitySnapshotWhereInput
+  orderBy?: Prisma.EntitySnapshotOrderByWithRelationInput | Prisma.EntitySnapshotOrderByWithRelationInput[]
+  cursor?: Prisma.EntitySnapshotWhereUniqueInput
+  take?: number
+  skip?: number
+  distinct?: Prisma.EntitySnapshotScalarFieldEnum | Prisma.EntitySnapshotScalarFieldEnum[]
+}
+
 /**
  * Operation without action
  */

package/src/database/_generated/project/models/OperationLog.ts

@@ -405,10 +405,6 @@ export type OperationLogUncheckedUpdateManyWithoutOperationNestedInput = {
   deleteMany?: Prisma.OperationLogScalarWhereInput | Prisma.OperationLogScalarWhereInput[]
 }
 
-export type BoolFieldUpdateOperationsInput = {
-  set?: boolean
-}
-
 export type OperationLogCreateWithoutStateInput = {
   id: string
   isSystem?: boolean

package/src/database/_generated/project/models.ts

@@ -11,6 +11,10 @@
 export type * from './models/ApiKey.ts'
 export type * from './models/Artifact.ts'
 export type * from './models/InstanceCustomStatus.ts'
+export type * from './models/Entity.ts'
+export type * from './models/EntitySnapshot.ts'
+export type * from './models/EntitySnapshotReference.ts'
+export type * from './models/EntitySnapshotContent.ts'
 export type * from './models/InstanceEvaluationState.ts'
 export type * from './models/InstanceState.ts'
 export type * from './models/UserProjectViewport.ts'

package/src/database/migration.ts

@@ -23,6 +23,7 @@ export const migrationPacks = {
     migrationNames: [
       //
       "20250928124105_initial_migration",
+      "20260222113554_add_object_tracking",
     ],
   },
   project: {
@@ -32,6 +33,8 @@ export const migrationPacks = {
       //
       "20250928130725_initial_migration",
       "20260123000000_add_instance_state_self_hash",
+      "20260301210131_add_entity_tracking",
+      "20260302212734_add_resource_hooks_flag",
     ],
   },
 }

package/src/library/worker/evaluator.ts

@@ -11,6 +11,12 @@ import {
 import { mapValues } from "remeda"
 import { errorToString } from "../../common"
 
+function toCloneSafeInstanceModel(instance: InstanceModel): InstanceModel {
+  // Runtime instances may contain Proxy-based accessors in outputs/resolvedOutputs.
+  // Serialize to plain data so worker thread postMessage can structured-clone it.
+  return JSON.parse(JSON.stringify(instance)) as InstanceModel
+}
+
 export function evaluateProject(
   logger: Logger,
   components: Readonly<Record<string, Component>>,
@@ -42,7 +48,7 @@ export function evaluateProject(
     success: true,
 
     virtualInstances: getRuntimeInstances()
-      .map(instance => instance.instance)
+      .map(instance => toCloneSafeInstanceModel(instance.instance))
       // only include top-level composite instances and their children
       .filter(instance => instance.kind === "composite" || !allInstancesMap.has(instance.id)),
 

package/src/orchestrator/manager.ts

@@ -1,6 +1,7 @@
 import type { InstanceId } from "@highstate/contract"
 import type { Logger } from "pino"
 import type {
+  EntitySnapshotService,
   InstanceLockService,
   InstanceStateService,
   OperationService,
@@ -8,6 +9,7 @@ import type {
   ProjectUnlockService,
   SecretService,
   UnitExtraService,
+  UnitOutputService,
 } from "../business"
 import type { ArtifactService } from "../business/artifact"
 import type { DatabaseManager, Operation, Project } from "../database"
@@ -37,6 +39,8 @@ export class OperationManager {
     private readonly instanceStateService: InstanceStateService,
     private readonly projectModelService: ProjectModelService,
     private readonly unitExtraService: UnitExtraService,
+    private readonly entitySnapshotService: EntitySnapshotService,
+    private readonly unitOutputService: UnitOutputService,
     private readonly database: DatabaseManager,
     private readonly logger: Logger,
   ) {
@@ -71,6 +75,7 @@ export class OperationManager {
       this.libraryBackend,
       this.instanceStateService,
       this.projectModelService,
+      undefined,
       this.logger,
     )
 
@@ -141,6 +146,8 @@ export class OperationManager {
       this.instanceStateService,
       this.projectModelService,
       this.unitExtraService,
+      this.entitySnapshotService,
+      this.unitOutputService,
       this.logger.child({ operationId: operation.id }),
     )
 

package/src/orchestrator/operation-context.captured-outputs.test.ts

@@ -0,0 +1,118 @@
+import pino from "pino"
+import { describe, expect, test } from "vitest"
+import { OperationContext } from "./operation-context"
+
+describe("OperationContext.updateCapturedOutputValuesFromUnitOutputs", () => {
+  test("captures single + multiple outputs and clears missing ones", () => {
+    const context = new (
+      OperationContext as unknown as {
+        new (...args: unknown[]): OperationContext
+      }
+    )(
+      { id: "project" },
+      {
+        components: {
+          "component.v1": {
+            outputs: {
+              single: { type: "entity.single.v1" },
+              multi: { type: "entity.multi.v1", multiple: true },
+            },
+          },
+        },
+        entities: {},
+      },
+      pino({ level: "silent" }),
+    )
+
+    context.updateCapturedOutputValuesFromUnitOutputs({
+      instanceId: "component.v1:one",
+      instanceType: "component.v1",
+      outputs: {
+        single: { value: { a: 1 } },
+        multi: { value: [{ b: 2 }, { b: 3 }] },
+      },
+    })
+
+    expect(context.getCapturedOutputValues("component.v1:one", "single")).toEqual([
+      { ok: true, value: { a: 1 } },
+    ])
+    expect(context.getCapturedOutputValues("component.v1:one", "multi")).toEqual([
+      { ok: true, value: { b: 2 } },
+      { ok: true, value: { b: 3 } },
+    ])
+
+    context.updateCapturedOutputValuesFromUnitOutputs({
+      instanceId: "component.v1:one",
+      instanceType: "component.v1",
+      outputs: {
+        single: { value: null },
+        multi: { value: undefined },
+      },
+    })
+
+    expect(context.getCapturedOutputValues("component.v1:one", "single")).toEqual([])
+    expect(context.getCapturedOutputValues("component.v1:one", "multi")).toEqual([])
+  })
+
+  test("throws when multiple output is not an array", () => {
+    const context = new (
+      OperationContext as unknown as {
+        new (...args: unknown[]): OperationContext
+      }
+    )(
+      { id: "project" },
+      {
+        components: {
+          "component.v1": {
+            outputs: {
+              multi: { type: "entity.multi.v1", multiple: true },
+            },
+          },
+        },
+        entities: {},
+      },
+      pino({ level: "silent" }),
+    )
+
+    expect(() =>
+      context.updateCapturedOutputValuesFromUnitOutputs({
+        instanceId: "component.v1:one",
+        instanceType: "component.v1",
+        outputs: {
+          multi: { value: { b: 1 } },
+        },
+      }),
+    ).toThrow('Output "multi" for instance "component.v1:one" must be an array')
+  })
+
+  test("throws when output item is not an object", () => {
+    const context = new (
+      OperationContext as unknown as {
+        new (...args: unknown[]): OperationContext
+      }
+    )(
+      { id: "project" },
+      {
+        components: {
+          "component.v1": {
+            outputs: {
+              multi: { type: "entity.multi.v1", multiple: true },
+            },
+          },
+        },
+        entities: {},
+      },
+      pino({ level: "silent" }),
+    )
+
+    expect(() =>
+      context.updateCapturedOutputValuesFromUnitOutputs({
+        instanceId: "component.v1:one",
+        instanceType: "component.v1",
+        outputs: {
+          multi: { value: [123] },
+        },
+      }),
+    ).toThrow('Output "multi" for instance "component.v1:one" must contain objects')
+  })
+})