@granular-software/sdk 0.4.72 → 0.4.73

package/dist/index.js

@@ -4300,8 +4300,8 @@ function normalizeFeedItems(values) {
   return { items: Object.freeze(items), error };
 }
 function normalizeTransients(values) {
-  const record2 = asRecord(values);
-  if (!record2) {
+  const record3 = asRecord(values);
+  if (!record3) {
     return {
       items: [],
       error: new Error("Canonical feed transientById is not an object.")
@@ -4310,7 +4310,7 @@ function normalizeTransients(values) {
   let error = null;
   const byId = /* @__PURE__ */ new Map();
   const idByOrdinal = /* @__PURE__ */ new Map();
-  for (const [key, value] of Object.entries(record2)) {
+  for (const [key, value] of Object.entries(record3)) {
     const item = normalizeTransientFeedItem(value);
     if (!item || item.id !== key) {
       error ||= new Error("Canonical feed contains an invalid transient item.");
@@ -5183,11 +5183,11 @@ function operationId(prefix) {
   return randomUuid ? `${prefix}_${randomUuid}` : `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2)}`;
 }
 function unwrapPublishedItem(value) {
-  const record2 = asRecord(value);
-  const directItems = Array.isArray(record2?.items) ? record2.items : [];
-  const durable = asRecord(record2?.durable);
+  const record3 = asRecord(value);
+  const directItems = Array.isArray(record3?.items) ? record3.items : [];
+  const durable = asRecord(record3?.durable);
   const durableItems = Array.isArray(durable?.items) ? durable.items : [];
-  return record2?.item || directItems[0] || durableItems[0] || value;
+  return record3?.item || directItems[0] || durableItems[0] || value;
 }
 function requireFeedbackItem(value) {
   const item = normalizeFeedItem(unwrapPublishedItem(value));
@@ -5309,9 +5309,9 @@ var DEFAULT_MAX_RECONNECT_ATTEMPTS = 5;
 var DOCUMENT_RESYNC_CLOSE_CODE = 4e3;
 var DOCUMENT_RESYNC_CLOSE_REASON = "Document resync required";
 function documentVersion(document) {
-  const record2 = document;
-  const epochValue = record2.documentEpoch;
-  const revisionValue = record2.documentRevision;
+  const record3 = document;
+  const epochValue = record3.documentEpoch;
+  const revisionValue = record3.documentRevision;
   const epoch = epochValue === void 0 ? 0 : epochValue;
   const revision = revisionValue === void 0 ? 0 : revisionValue;
   if (!Number.isSafeInteger(epoch) || Number(epoch) < 0 || !Number.isSafeInteger(revision) || Number(revision) < 0) {
@@ -5333,9 +5333,9 @@ function stableDocumentFingerprint(value) {
   if (Array.isArray(value)) {
     return `[${value.map(stableDocumentFingerprint).join(",")}]`;
   }
-  const record2 = value;
-  return `{${Object.keys(record2).sort().map(
-    (key) => `${JSON.stringify(key)}:${stableDocumentFingerprint(record2[key])}`
+  const record3 = value;
+  return `{${Object.keys(record3).sort().map(
+    (key) => `${JSON.stringify(key)}:${stableDocumentFingerprint(record3[key])}`
   ).join(",")}}`;
 }
 function canonicalDocumentFingerprint(value) {
@@ -5345,9 +5345,9 @@ function canonicalDocumentFingerprint(value) {
     if (Array.isArray(input)) {
       return input.map((entry) => stripPresentation(entry, path));
     }
-    const record2 = input;
+    const record3 = input;
     const output = {};
-    for (const [key, entry] of Object.entries(record2)) {
+    for (const [key, entry] of Object.entries(record3)) {
       if (path.length === 1 && path[0] === "feed" && [
         "transientById",
         "feedbackUsageByJob",
@@ -6451,30 +6451,30 @@ function parseJsonPromptChoiceOption(option) {
 }
 function normalizePromptChoiceOption(option) {
   if (typeof option === "string") {
-    const record3 = parseJsonPromptChoiceOption(option);
-    if (!record3) {
+    const record4 = parseJsonPromptChoiceOption(option);
+    if (!record4) {
       return { value: option, label: option };
     }
-    const value2 = typeof record3.value === "string" ? record3.value : typeof record3.id === "string" ? record3.id : typeof record3.label === "string" ? record3.label : JSON.stringify(record3);
+    const value2 = typeof record4.value === "string" ? record4.value : typeof record4.id === "string" ? record4.id : typeof record4.label === "string" ? record4.label : JSON.stringify(record4);
     return {
       value: value2,
-      label: typeof record3.label === "string" ? record3.label : value2,
-      description: typeof record3.description === "string" ? record3.description : void 0
+      label: typeof record4.label === "string" ? record4.label : value2,
+      description: typeof record4.description === "string" ? record4.description : void 0
     };
   }
-  const record2 = option;
-  if (!record2) {
+  const record3 = option;
+  if (!record3) {
     return { value: "", label: "" };
   }
-  const nestedJson = (typeof record2.value === "string" ? parseJsonPromptChoiceOption(record2.value) : null) || (typeof record2.label === "string" ? parseJsonPromptChoiceOption(record2.label) : null);
+  const nestedJson = (typeof record3.value === "string" ? parseJsonPromptChoiceOption(record3.value) : null) || (typeof record3.label === "string" ? parseJsonPromptChoiceOption(record3.label) : null);
   if (nestedJson) {
     return normalizePromptChoiceOption(nestedJson);
   }
-  const value = typeof record2.value === "string" ? record2.value : typeof record2.label === "string" ? record2.label : JSON.stringify(record2);
+  const value = typeof record3.value === "string" ? record3.value : typeof record3.label === "string" ? record3.label : JSON.stringify(record3);
   return {
     value,
-    label: typeof record2.label === "string" ? record2.label : value,
-    description: typeof record2.description === "string" ? record2.description : void 0
+    label: typeof record3.label === "string" ? record3.label : value,
+    description: typeof record3.description === "string" ? record3.description : void 0
   };
 }
 function scorePromptChoiceMatch(answer, answerTokens, option) {
@@ -7982,8 +7982,8 @@ function artifactRecordsById(liveDoc) {
   const byId = asRecord3(artifacts?.byId) || {};
   return Object.fromEntries(
     Object.entries(byId).map(([artifactId, value]) => {
-      const record2 = asRecord3(value);
-      return record2 ? [artifactId, record2] : null;
+      const record3 = asRecord3(value);
+      return record3 ? [artifactId, record3] : null;
     }).filter((entry) => Boolean(entry))
   );
 }
@@ -8016,8 +8016,8 @@ function latestInputEditSummary(metadata) {
   ].filter(Boolean);
   return `lastEdit=${source}${actor ? ` by ${actor}` : ""}${changed.length ? ` (${changed.join("; ")})` : ""}`;
 }
-function artifactIssueSummary(record2) {
-  const validation = asRecord3(record2.validation);
+function artifactIssueSummary(record3) {
+  const validation = asRecord3(record3.validation);
   if (!validation) return null;
   const issues = Array.isArray(validation.issues) ? validation.issues.map((issue) => asRecord3(issue)).filter((issue) => Boolean(issue)).slice(0, 3) : [];
   if (issues.length > 0) {
@@ -8064,18 +8064,18 @@ function artifactStatePathSummary(metadata) {
   ].filter(Boolean);
   return pieces.length ? pieces.join("; ") : null;
 }
-function artifactSummaryLine(artifactId, record2) {
-  if (!record2) return `- ${artifactId}: unavailable in session artifact store`;
-  const label = trimString(record2.label) || artifactId;
-  const kind = asString(record2.kind) || "artifact";
-  const status = asString(record2.status) || "unknown";
-  const createdByJobId = asString(record2.createdByJobId);
-  const target = asRecord3(record2.target);
-  const metadata = asRecord3(record2.metadata) || {};
-  const subArtifactIds = Array.isArray(record2.subArtifactIds) ? record2.subArtifactIds.filter(
+function artifactSummaryLine(artifactId, record3) {
+  if (!record3) return `- ${artifactId}: unavailable in session artifact store`;
+  const label = trimString(record3.label) || artifactId;
+  const kind = asString(record3.kind) || "artifact";
+  const status = asString(record3.status) || "unknown";
+  const createdByJobId = asString(record3.createdByJobId);
+  const target = asRecord3(record3.target);
+  const metadata = asRecord3(record3.metadata) || {};
+  const subArtifactIds = Array.isArray(record3.subArtifactIds) ? record3.subArtifactIds.filter(
     (id) => typeof id === "string" && id.trim().length > 0
   ).slice(0, 8) : [];
-  const relationships = compactJson(record2.relationships, 220);
+  const relationships = compactJson(record3.relationships, 220);
   const pieces = [
     `kind=${kind}`,
     `status=${status}`,
@@ -8083,7 +8083,7 @@ function artifactSummaryLine(artifactId, record2) {
     target ? `target=${asString(target.className) || "record"}:${asString(target.id) || "unknown"}${asString(target.label) ? ` (${asString(target.label)})` : ""}` : null,
     artifactStatePathSummary(metadata),
     artifactExecutionSummary(metadata),
-    artifactIssueSummary(record2),
+    artifactIssueSummary(record3),
     latestInputEditSummary(metadata),
     subArtifactIds.length ? `subArtifacts=${subArtifactIds.join(",")}` : null,
     relationships ? `relationships=${relationships}` : null
@@ -13194,6 +13194,300 @@ var effectBehaviorsMetamodelPackage = defineMetamodelPackage({
   }
 });
 
+// src/record-snapshot-projection.ts
+function stableValue(value) {
+  if (Array.isArray(value)) return value.map(stableValue);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).filter(([, item]) => item !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => [key, stableValue(item)])
+    );
+  }
+  return value;
+}
+function stableJson(value) {
+  return JSON.stringify(stableValue(value));
+}
+function recordKey(record3) {
+  return `${record3.className}\0${record3.id}`;
+}
+function recordReference(className, id) {
+  return { className, id };
+}
+function changedRecordSnapshots(beforeRecords, afterRecords) {
+  const before = new Map(
+    beforeRecords.map((record3) => [recordKey(record3), record3])
+  );
+  const after = new Map(
+    afterRecords.map((record3) => [recordKey(record3), record3])
+  );
+  const changedKeys = /* @__PURE__ */ new Set();
+  for (const key of /* @__PURE__ */ new Set([...before.keys(), ...after.keys()])) {
+    if (stableJson(before.get(key)) !== stableJson(after.get(key))) {
+      changedKeys.add(key);
+    }
+  }
+  return {
+    beforeRecords: beforeRecords.filter(
+      (record3) => changedKeys.has(recordKey(record3))
+    ),
+    afterRecords: afterRecords.filter(
+      (record3) => changedKeys.has(recordKey(record3))
+    )
+  };
+}
+function relationshipTargets(manifest) {
+  const targets = /* @__PURE__ */ new Map();
+  for (const volume of manifest.volumes) {
+    for (const operation of volume.operations) {
+      const relationship = operation.defineRelationship;
+      if (!relationship) continue;
+      targets.set(`${relationship.left}\0${relationship.leftSubmodel}`, {
+        className: relationship.right
+      });
+      targets.set(`${relationship.right}\0${relationship.rightSubmodel}`, {
+        className: relationship.left
+      });
+    }
+  }
+  return targets;
+}
+function stateName(value) {
+  return typeof value === "string" ? value : value.state;
+}
+function asIds(value) {
+  return value === void 0 ? [] : Array.isArray(value) ? value : [value];
+}
+function changedObjectProjection(before, after) {
+  const beforeFields = before?.fields || {};
+  const afterFields = after.fields || {};
+  const fields = { ...afterFields };
+  for (const fieldName of Object.keys(beforeFields)) {
+    if (!(fieldName in afterFields)) fields[fieldName] = null;
+  }
+  if (before && before.label === after.label && stableJson(beforeFields) === stableJson(afterFields)) {
+    return null;
+  }
+  return {
+    kind: "object",
+    operation: before ? "updated" : "created",
+    record: {
+      className: after.className,
+      id: after.id,
+      ...after.label !== void 0 ? { label: after.label } : {},
+      fields
+    }
+  };
+}
+function projectionChanges(input) {
+  const before = new Map(
+    input.beforeRecords.map((record3) => [recordKey(record3), record3])
+  );
+  const after = new Map(
+    input.afterRecords.map((record3) => [recordKey(record3), record3])
+  );
+  const targets = relationshipTargets(input.manifest);
+  const changes = [];
+  for (const record3 of input.afterRecords) {
+    const previous = before.get(recordKey(record3));
+    const objectChange = changedObjectProjection(previous, record3);
+    if (objectChange) changes.push(objectChange);
+    const relationshipNames = /* @__PURE__ */ new Set([
+      ...Object.keys(previous?.relationships || {}),
+      ...Object.keys(record3.relationships || {})
+    ]);
+    for (const relationshipName of [...relationshipNames].sort()) {
+      const target = targets.get(
+        `${record3.className}\0${relationshipName}`
+      );
+      if (!target) {
+        throw new Error(
+          `No ontology relationship target is declared for ${record3.className}.${relationshipName}`
+        );
+      }
+      const previousIds = new Set(
+        asIds(previous?.relationships?.[relationshipName])
+      );
+      const currentIds = new Set(
+        asIds(record3.relationships?.[relationshipName])
+      );
+      for (const id of [...previousIds].sort()) {
+        if (currentIds.has(id)) continue;
+        changes.push({
+          kind: "relationship",
+          operation: "disconnected",
+          relationship: relationshipName,
+          from: recordReference(record3.className, record3.id),
+          to: recordReference(target.className, id)
+        });
+      }
+      for (const id of [...currentIds].sort()) {
+        if (previousIds.has(id)) continue;
+        changes.push({
+          kind: "relationship",
+          operation: "connected",
+          relationship: relationshipName,
+          from: recordReference(record3.className, record3.id),
+          to: recordReference(target.className, id)
+        });
+      }
+    }
+    const machines = /* @__PURE__ */ new Set([
+      ...Object.keys(previous?.states || {}),
+      ...Object.keys(record3.states || {})
+    ]);
+    for (const machine of [...machines].sort()) {
+      const next = record3.states?.[machine];
+      if (next === void 0) continue;
+      const prior = previous?.states?.[machine];
+      if (prior !== void 0 && stateName(prior) === stateName(next)) continue;
+      if (input.transition && input.transition.className === record3.className && input.transition.objectId === record3.id && input.transition.machine === machine) {
+        continue;
+      }
+      changes.push({
+        kind: "state_observation",
+        target: recordReference(record3.className, record3.id),
+        machine,
+        state: stateName(next)
+      });
+    }
+  }
+  for (const record3 of input.beforeRecords) {
+    if (after.has(recordKey(record3))) continue;
+    changes.push({
+      kind: "object",
+      operation: "deleted",
+      target: recordReference(record3.className, record3.id)
+    });
+  }
+  return changes;
+}
+function valueAtPath(value, path) {
+  return path.split(".").filter(Boolean).reduce((current, segment) => {
+    if (!current || typeof current !== "object" || Array.isArray(current)) {
+      return void 0;
+    }
+    return current[segment];
+  }, value);
+}
+function primaryTarget(input) {
+  if (input.transition) {
+    return recordReference(
+      input.transition.className,
+      input.transition.objectId
+    );
+  }
+  const creates = input.effect.metamodels?.creates;
+  if (creates) {
+    const declaration = typeof creates === "string" ? { className: creates } : creates;
+    const id = declaration.idPath ? valueAtPath(input.result, declaration.idPath) : void 0;
+    if (typeof id === "string" && id) {
+      return recordReference(declaration.className, id);
+    }
+  }
+  if (input.effect.className && !input.effect.static) {
+    const objectId = input.effectInput && typeof input.effectInput === "object" && !Array.isArray(input.effectInput) ? input.effectInput._objectId : void 0;
+    if (typeof objectId === "string" && objectId) {
+      return recordReference(input.effect.className, objectId);
+    }
+  }
+  const created = input.changes.filter(
+    (change) => change.kind === "object" && change.operation === "created"
+  );
+  const onlyCreated = created.length === 1 ? created[0] : void 0;
+  return onlyCreated ? recordReference(onlyCreated.record.className, onlyCreated.record.id) : void 0;
+}
+function assertRecordSnapshotTransitionMapping(transition) {
+  if (!transition)
+    throw new Error("A transition commit has no authored transition context.");
+  if (!transition.outcomes || !Object.keys(transition.outcomes).length) {
+    throw new Error(
+      "Automatic product-state mapping requires at least one declared outcome."
+    );
+  }
+  const destinations = /* @__PURE__ */ new Map();
+  for (const [key, outcome] of Object.entries(transition.outcomes)) {
+    if (!outcome || typeof outcome.to !== "string" || !outcome.to) {
+      throw new Error(
+        `Automatic product-state mapping requires a destination for outcome ${key}.`
+      );
+    }
+    const destination = outcome.to === "$current" ? transition.from : outcome.to;
+    const previous = destinations.get(destination);
+    if (previous !== void 0) {
+      throw new Error(
+        `Ambiguous product-state mapping for ${transition.machine}.${transition.transition}: outcomes ${previous} and ${key} both resolve to ${destination}; automatic mapping requires distinct outcome destinations.`
+      );
+    }
+    destinations.set(destination, key);
+  }
+}
+function transitionOutcome(transition, afterRecords) {
+  assertRecordSnapshotTransitionMapping(transition);
+  const target = afterRecords.find(
+    (record3) => record3.className === transition.className && record3.id === transition.objectId
+  );
+  const observed = target?.states?.[transition.machine];
+  if (!observed) {
+    throw new Error(
+      `The product result did not expose ${transition.className}:${transition.objectId}.${transition.machine}`
+    );
+  }
+  const finalState = stateName(observed);
+  const matches = Object.entries(transition.outcomes).filter(
+    ([, outcome]) => outcome.to === finalState || outcome.to === "$current" && finalState === transition.from
+  );
+  if (matches.length !== 1) {
+    throw new Error(
+      `Product state ${finalState} maps to ${matches.length} authored outcomes for ${transition.machine}.${transition.transition}`
+    );
+  }
+  const [key, declaration] = matches[0];
+  return {
+    key,
+    ...declaration.disposition === "error" ? {
+      error: {
+        code: `product_outcome_${key}`,
+        message: declaration.label || `The product completed in ${finalState} instead of continuing.`,
+        retryable: false
+      }
+    } : {}
+  };
+}
+function projectRecordSnapshotMutation(input) {
+  const changes = projectionChanges({
+    manifest: input.manifest,
+    beforeRecords: input.source.beforeRecords,
+    afterRecords: input.source.afterRecords,
+    transition: input.transition
+  });
+  const target = primaryTarget({
+    effect: input.effect,
+    effectInput: input.effectInput,
+    result: input.result,
+    changes,
+    transition: input.transition
+  });
+  const base = {
+    source: {
+      reference: input.source.reference,
+      ...input.source.version ? { version: input.source.version } : {},
+      ...input.source.versionScope ? { versionScope: input.source.versionScope } : {}
+    },
+    ...target ? { primaryTarget: target } : {},
+    changes,
+    safeSummary: {
+      effect: input.effect.name,
+      affectedChanges: changes.length
+    }
+  };
+  if (input.commitKind === "effect") return base;
+  return {
+    ...base,
+    outcome: transitionOutcome(input.transition, input.source.afterRecords)
+  };
+}
+projectRecordSnapshotMutation.validateTransition = assertRecordSnapshotTransitionMapping;
+
 // src/commit.ts
 var MAX_PROJECTION_CHANGES = 1e3;
 var MAX_SAFE_SUMMARY_KEYS = 32;
@@ -13287,18 +13581,18 @@ function validateScalarRecord(value, path) {
 }
 function validateProjectedRecord(value, path) {
   validateObjectReference(value, path);
-  const record2 = value;
-  if (record2.label !== void 0) {
-    if (typeof record2.label !== "string") {
+  const record3 = value;
+  if (record3.label !== void 0) {
+    if (typeof record3.label !== "string") {
       throw new Error(`${path}.label must be a string`);
     }
-    if (record2.label.length > MAX_SAFE_TEXT_LENGTH) {
+    if (record3.label.length > MAX_SAFE_TEXT_LENGTH) {
       throw new Error(
         `${path}.label exceeds ${MAX_SAFE_TEXT_LENGTH} characters`
       );
     }
   }
-  validateScalarRecord(record2.fields, `${path}.fields`);
+  validateScalarRecord(record3.fields, `${path}.fields`);
 }
 function validateBoundedJson(value, path, depth = 0) {
   if (depth > 12) throw new Error(`${path} is nested too deeply`);
@@ -13802,6 +14096,11 @@ async function invokeRegisteredEffect(effectMap, request, options = {}) {
       `Transition effect ${request.effectKey} has no resolved transition context; customer code was not invoked`
     );
   }
+  if (commitRequired && declaration?.kind === "transition" && declaration.outcomeSelection === "product_state") {
+    assertRecordSnapshotTransitionMapping(
+      request.context?.invocation?.transition
+    );
+  }
   const idempotencyKey = commitRequired ? await resolveInvocationIdempotencyKey(request) : request.context?.idempotencyKey;
   let commitStarted = false;
   let commitPromise = null;
@@ -16365,7 +16664,7 @@ function stateTransitionSteps(artifact) {
       {
         index: typeof step.index === "number" ? step.index : fallbackIndex,
         transition,
-        label: text(step.label) || humanize(transition),
+        label: text(transitionDescription?.label) || text(step.label) || humanize(transition),
         description: text(step.description) || text(record(step.expectedOutcome)?.summary) || null,
         status: text(step.status) || "pending",
         // State plans may contain bookkeeping transitions that are necessary
@@ -17047,17 +17346,17 @@ function planRecordObjectsChunks(records, batchSize) {
   }
   return plans;
 }
-function preserveRecordObjectRealId(record2) {
-  const realId = record2.id.trim();
+function preserveRecordObjectRealId(record3) {
+  const realId = record3.id.trim();
   if (!realId) {
-    return record2;
+    return record3;
   }
-  const fields = record2.fields || {};
+  const fields = record3.fields || {};
   if (typeof fields.real_id === "string" && fields.real_id.trim()) {
-    return record2;
+    return record3;
   }
   return {
-    ...record2,
+    ...record3,
     fields: {
       ...fields,
       real_id: realId
@@ -17389,7 +17688,7 @@ var Environment = class _Environment {
   }
   get data() {
     return {
-      record: async (record2) => this.recordObject(record2),
+      record: async (record3) => this.recordObject(record3),
       recordMany: async (records, options) => this.recordObjects(records, options),
       import: async (records, options) => this.enqueueRecordImport(records, options),
       listImports: async (status) => this.listRecordImports(status),
@@ -17886,6 +18185,11 @@ var Environment = class _Environment {
         classNames: options.classNames?.length ? options.classNames : []
       }
     );
+    if (response.errors?.length) {
+      throw new Error(
+        `Record search failed: ${response.errors.map((error) => error.message).join("; ")}`
+      );
+    }
     const seen = /* @__PURE__ */ new Set();
     const results = (response.data?.record_search || []).flatMap((entry) => {
       const className = entry.className?.trim();
@@ -21044,13 +21348,13 @@ var Granular = class _Granular {
    * Permission Profile management for sandboxes
    */
   get permissionProfiles() {
-    const profileSourceFromRecord = (record2) => {
-      const profile = record2.profile || record2.rules || {};
+    const profileSourceFromRecord = (record3) => {
+      const profile = record3.profile || record3.rules || {};
       return {
         ...profile,
         schemaVersion: profile.schemaVersion || 1,
-        name: profile.name || record2.name,
-        description: profile.description || record2.description
+        name: profile.name || record3.name,
+        description: profile.description || record3.description
       };
     };
     return {
@@ -21620,276 +21924,6 @@ async function pollEnvironmentSetup(input) {
   }
 }
 
-// src/record-snapshot-projection.ts
-function stableValue(value) {
-  if (Array.isArray(value)) return value.map(stableValue);
-  if (value && typeof value === "object") {
-    return Object.fromEntries(
-      Object.entries(value).filter(([, item]) => item !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => [key, stableValue(item)])
-    );
-  }
-  return value;
-}
-function stableJson(value) {
-  return JSON.stringify(stableValue(value));
-}
-function recordKey(record2) {
-  return `${record2.className}\0${record2.id}`;
-}
-function recordReference(className, id) {
-  return { className, id };
-}
-function changedRecordSnapshots(beforeRecords, afterRecords) {
-  const before = new Map(
-    beforeRecords.map((record2) => [recordKey(record2), record2])
-  );
-  const after = new Map(
-    afterRecords.map((record2) => [recordKey(record2), record2])
-  );
-  const changedKeys = /* @__PURE__ */ new Set();
-  for (const key of /* @__PURE__ */ new Set([...before.keys(), ...after.keys()])) {
-    if (stableJson(before.get(key)) !== stableJson(after.get(key))) {
-      changedKeys.add(key);
-    }
-  }
-  return {
-    beforeRecords: beforeRecords.filter(
-      (record2) => changedKeys.has(recordKey(record2))
-    ),
-    afterRecords: afterRecords.filter(
-      (record2) => changedKeys.has(recordKey(record2))
-    )
-  };
-}
-function relationshipTargets(manifest) {
-  const targets = /* @__PURE__ */ new Map();
-  for (const volume of manifest.volumes) {
-    for (const operation of volume.operations) {
-      const relationship = operation.defineRelationship;
-      if (!relationship) continue;
-      targets.set(`${relationship.left}\0${relationship.leftSubmodel}`, {
-        className: relationship.right
-      });
-      targets.set(`${relationship.right}\0${relationship.rightSubmodel}`, {
-        className: relationship.left
-      });
-    }
-  }
-  return targets;
-}
-function stateName(value) {
-  return typeof value === "string" ? value : value.state;
-}
-function asIds(value) {
-  return value === void 0 ? [] : Array.isArray(value) ? value : [value];
-}
-function changedObjectProjection(before, after) {
-  const beforeFields = before?.fields || {};
-  const afterFields = after.fields || {};
-  const fields = { ...afterFields };
-  for (const fieldName of Object.keys(beforeFields)) {
-    if (!(fieldName in afterFields)) fields[fieldName] = null;
-  }
-  if (before && before.label === after.label && stableJson(beforeFields) === stableJson(afterFields)) {
-    return null;
-  }
-  return {
-    kind: "object",
-    operation: before ? "updated" : "created",
-    record: {
-      className: after.className,
-      id: after.id,
-      ...after.label !== void 0 ? { label: after.label } : {},
-      fields
-    }
-  };
-}
-function projectionChanges(input) {
-  const before = new Map(
-    input.beforeRecords.map((record2) => [recordKey(record2), record2])
-  );
-  const after = new Map(
-    input.afterRecords.map((record2) => [recordKey(record2), record2])
-  );
-  const targets = relationshipTargets(input.manifest);
-  const changes = [];
-  for (const record2 of input.afterRecords) {
-    const previous = before.get(recordKey(record2));
-    const objectChange = changedObjectProjection(previous, record2);
-    if (objectChange) changes.push(objectChange);
-    const relationshipNames = /* @__PURE__ */ new Set([
-      ...Object.keys(previous?.relationships || {}),
-      ...Object.keys(record2.relationships || {})
-    ]);
-    for (const relationshipName of [...relationshipNames].sort()) {
-      const target = targets.get(
-        `${record2.className}\0${relationshipName}`
-      );
-      if (!target) {
-        throw new Error(
-          `No ontology relationship target is declared for ${record2.className}.${relationshipName}`
-        );
-      }
-      const previousIds = new Set(
-        asIds(previous?.relationships?.[relationshipName])
-      );
-      const currentIds = new Set(
-        asIds(record2.relationships?.[relationshipName])
-      );
-      for (const id of [...previousIds].sort()) {
-        if (currentIds.has(id)) continue;
-        changes.push({
-          kind: "relationship",
-          operation: "disconnected",
-          relationship: relationshipName,
-          from: recordReference(record2.className, record2.id),
-          to: recordReference(target.className, id)
-        });
-      }
-      for (const id of [...currentIds].sort()) {
-        if (previousIds.has(id)) continue;
-        changes.push({
-          kind: "relationship",
-          operation: "connected",
-          relationship: relationshipName,
-          from: recordReference(record2.className, record2.id),
-          to: recordReference(target.className, id)
-        });
-      }
-    }
-    const machines = /* @__PURE__ */ new Set([
-      ...Object.keys(previous?.states || {}),
-      ...Object.keys(record2.states || {})
-    ]);
-    for (const machine of [...machines].sort()) {
-      const next = record2.states?.[machine];
-      if (next === void 0) continue;
-      const prior = previous?.states?.[machine];
-      if (prior !== void 0 && stateName(prior) === stateName(next)) continue;
-      if (input.transition && input.transition.className === record2.className && input.transition.objectId === record2.id && input.transition.machine === machine) {
-        continue;
-      }
-      changes.push({
-        kind: "state_observation",
-        target: recordReference(record2.className, record2.id),
-        machine,
-        state: stateName(next)
-      });
-    }
-  }
-  for (const record2 of input.beforeRecords) {
-    if (after.has(recordKey(record2))) continue;
-    changes.push({
-      kind: "object",
-      operation: "deleted",
-      target: recordReference(record2.className, record2.id)
-    });
-  }
-  return changes;
-}
-function valueAtPath(value, path) {
-  return path.split(".").filter(Boolean).reduce((current, segment) => {
-    if (!current || typeof current !== "object" || Array.isArray(current)) {
-      return void 0;
-    }
-    return current[segment];
-  }, value);
-}
-function primaryTarget(input) {
-  if (input.transition) {
-    return recordReference(
-      input.transition.className,
-      input.transition.objectId
-    );
-  }
-  const creates = input.effect.metamodels?.creates;
-  if (creates) {
-    const declaration = typeof creates === "string" ? { className: creates } : creates;
-    const id = declaration.idPath ? valueAtPath(input.result, declaration.idPath) : void 0;
-    if (typeof id === "string" && id) {
-      return recordReference(declaration.className, id);
-    }
-  }
-  if (input.effect.className && !input.effect.static) {
-    const objectId = input.effectInput && typeof input.effectInput === "object" && !Array.isArray(input.effectInput) ? input.effectInput._objectId : void 0;
-    if (typeof objectId === "string" && objectId) {
-      return recordReference(input.effect.className, objectId);
-    }
-  }
-  const created = input.changes.filter(
-    (change) => change.kind === "object" && change.operation === "created"
-  );
-  const onlyCreated = created.length === 1 ? created[0] : void 0;
-  return onlyCreated ? recordReference(onlyCreated.record.className, onlyCreated.record.id) : void 0;
-}
-function transitionOutcome(transition, afterRecords) {
-  if (!transition) {
-    throw new Error("A transition commit has no authored transition context.");
-  }
-  const target = afterRecords.find(
-    (record2) => record2.className === transition.className && record2.id === transition.objectId
-  );
-  const observed = target?.states?.[transition.machine];
-  if (!observed) {
-    throw new Error(
-      `The product result did not expose ${transition.className}:${transition.objectId}.${transition.machine}`
-    );
-  }
-  const finalState = stateName(observed);
-  const matches = Object.entries(transition.outcomes).filter(
-    ([, outcome]) => outcome.to === finalState || outcome.to === "$current" && finalState === transition.from
-  );
-  if (matches.length !== 1) {
-    throw new Error(
-      `Product state ${finalState} maps to ${matches.length} authored outcomes for ${transition.machine}.${transition.transition}`
-    );
-  }
-  const [key, declaration] = matches[0];
-  return {
-    key,
-    ...declaration.disposition === "error" ? {
-      error: {
-        code: `product_outcome_${key}`,
-        message: declaration.label || `The product completed in ${finalState} instead of continuing.`,
-        retryable: false
-      }
-    } : {}
-  };
-}
-function projectRecordSnapshotMutation(input) {
-  const changes = projectionChanges({
-    manifest: input.manifest,
-    beforeRecords: input.source.beforeRecords,
-    afterRecords: input.source.afterRecords,
-    transition: input.transition
-  });
-  const target = primaryTarget({
-    effect: input.effect,
-    effectInput: input.effectInput,
-    result: input.result,
-    changes,
-    transition: input.transition
-  });
-  const base = {
-    source: {
-      reference: input.source.reference,
-      ...input.source.version ? { version: input.source.version } : {},
-      ...input.source.versionScope ? { versionScope: input.source.versionScope } : {}
-    },
-    ...target ? { primaryTarget: target } : {},
-    changes,
-    safeSummary: {
-      effect: input.effect.name,
-      affectedChanges: changes.length
-    }
-  };
-  if (input.commitKind === "effect") return base;
-  return {
-    ...base,
-    outcome: transitionOutcome(input.transition, input.source.afterRecords)
-  };
-}
-
 // src/agent-harness-templates/action-presentation/0.1.0/manifest.json
 var manifest_default = {
   id: "action-presentation",
@@ -22045,29 +22079,29 @@ function requireRecord(value, context) {
   }
   return value;
 }
-function requiredString(record2, key, context) {
-  const value = record2[key];
+function requiredString(record3, key, context) {
+  const value = record3[key];
   if (typeof value !== "string" || !value.trim()) {
     throw new Error(`${context}.${key} must be a non-empty string.`);
   }
   return value;
 }
-function requiredNumber(record2, key, context) {
-  const value = record2[key];
+function requiredNumber(record3, key, context) {
+  const value = record3[key];
   if (typeof value !== "number" || !Number.isFinite(value)) {
     throw new Error(`${context}.${key} must be a finite number.`);
   }
   return value;
 }
-function requiredStringArray(record2, key, context) {
-  const value = record2[key];
+function requiredStringArray(record3, key, context) {
+  const value = record3[key];
   if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || !item.trim())) {
     throw new Error(`${context}.${key} must be an array of non-empty strings.`);
   }
   return [...value];
 }
-function requiredNumberRecord(record2, key, context) {
-  const value = requireRecord(record2[key], `${context}.${key}`);
+function requiredNumberRecord(record3, key, context) {
+  const value = requireRecord(record3[key], `${context}.${key}`);
   const output = {};
   for (const [entryKey, entryValue] of Object.entries(value)) {
     if (typeof entryValue !== "number" || !Number.isFinite(entryValue) || entryValue < 0 || entryValue > 1) {
@@ -22080,22 +22114,22 @@ function requiredNumberRecord(record2, key, context) {
   return output;
 }
 function validateHarnessTemplateManifest(value, context = "HarnessTemplateManifest") {
-  const record2 = requireRecord(value, context);
-  const status = requiredString(record2, "status", context);
+  const record3 = requireRecord(value, context);
+  const status = requiredString(record3, "status", context);
   if (!HARNESS_TEMPLATE_STATUSES.includes(status)) {
     throw new Error(
       `${context}.status must be one of ${HARNESS_TEMPLATE_STATUSES.join(", ")}.`
     );
   }
-  const createdAt = requiredString(record2, "createdAt", context);
+  const createdAt = requiredString(record3, "createdAt", context);
   if (Number.isNaN(Date.parse(createdAt))) {
     throw new Error(`${context}.createdAt must be an ISO timestamp.`);
   }
   const compatibility = requireRecord(
-    record2.compatibility,
+    record3.compatibility,
     `${context}.compatibility`
   );
-  const evalGates = requireRecord(record2.evalGates, `${context}.evalGates`);
+  const evalGates = requireRecord(record3.evalGates, `${context}.evalGates`);
   const maxRegressionPct = requiredNumber(
     evalGates,
     "maxRegressionPct",
@@ -22107,23 +22141,23 @@ function validateHarnessTemplateManifest(value, context = "HarnessTemplateManife
     );
   }
   return {
-    id: requiredString(record2, "id", context),
-    version: requiredString(record2, "version", context),
+    id: requiredString(record3, "id", context),
+    version: requiredString(record3, "version", context),
     status,
-    owner: requiredString(record2, "owner", context),
+    owner: requiredString(record3, "owner", context),
     createdAt,
-    changelog: requiredString(record2, "changelog", context),
-    promptBuilder: requiredString(record2, "promptBuilder", context),
-    continuationBuilder: requiredString(record2, "continuationBuilder", context),
+    changelog: requiredString(record3, "changelog", context),
+    promptBuilder: requiredString(record3, "promptBuilder", context),
+    continuationBuilder: requiredString(record3, "continuationBuilder", context),
     modelOutputInstruction: requiredString(
-      record2,
+      record3,
       "modelOutputInstruction",
       context
     ),
-    codeReviewPolicy: requiredString(record2, "codeReviewPolicy", context),
-    defaultModel: requiredString(record2, "defaultModel", context),
-    modelMatrix: requiredStringArray(record2, "modelMatrix", context),
-    temperature: requiredNumber(record2, "temperature", context),
+    codeReviewPolicy: requiredString(record3, "codeReviewPolicy", context),
+    defaultModel: requiredString(record3, "defaultModel", context),
+    modelMatrix: requiredStringArray(record3, "modelMatrix", context),
+    temperature: requiredNumber(record3, "temperature", context),
     compatibility: {
       minSdkVersion: requiredString(
         compatibility,
@@ -22268,8 +22302,8 @@ function stableStringify(value) {
   if (Array.isArray(value)) {
     return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
   }
-  const record2 = value;
-  return `{${Object.keys(record2).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(record2[key])}`).join(",")}}`;
+  const record3 = value;
+  return `{${Object.keys(record3).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(record3[key])}`).join(",")}}`;
 }
 function renderConstBlock(name, value) {
   return `const ${name} = ${JSON.stringify(value, null, 2)} as const;`;
@@ -22865,9 +22899,9 @@ function getLatestClosure(liveDoc) {
   }
   const closures = [];
   for (const [closureId, value] of Object.entries(closuresById)) {
-    const record2 = asRecord4(value);
-    if (!record2) continue;
-    closures.push({ ...record2, closureId });
+    const record3 = asRecord4(value);
+    if (!record3) continue;
+    closures.push({ ...record3, closureId });
   }
   closures.sort(
     (left, right) => (Number(right.createdAt) || 0) - (Number(left.createdAt) || 0)
@@ -22905,9 +22939,9 @@ function getJobRecords(liveDoc) {
   const jobsById = asRecord4(asRecord4(liveDoc?.jobs)?.byId) || {};
   const jobs = [];
   for (const [jobId, value] of Object.entries(jobsById)) {
-    const record2 = asRecord4(value);
-    if (!record2) continue;
-    jobs.push({ ...record2, jobId });
+    const record3 = asRecord4(value);
+    if (!record3) continue;
+    jobs.push({ ...record3, jobId });
   }
   jobs.sort(
     (left, right) => getJobTimestamp(right) - getJobTimestamp(left)
@@ -23093,8 +23127,8 @@ function hasOpenPrompt(liveDoc, pendingPrompts) {
     const prompts = asRecord4(asRecord4(job)?.prompts);
     if (!prompts) continue;
     for (const prompt of Object.values(prompts)) {
-      const record2 = asRecord4(prompt);
-      if (record2?.status === "open") return true;
+      const record3 = asRecord4(prompt);
+      if (record3?.status === "open") return true;
     }
   }
   return false;
@@ -23153,13 +23187,13 @@ function projectLoopSummary(liveDoc, pendingPrompts = [], options) {
       title: typeof decision.title === "string" && decision.title.trim() ? decision.title.trim() : "Decision",
       status,
       candidates: status === "open" ? asArray(decision.candidates).slice(0, 5).map((candidate) => {
-        const record2 = asRecord4(candidate);
-        if (!record2) return null;
+        const record3 = asRecord4(candidate);
+        if (!record3) return null;
         return {
-          id: typeof record2.id === "string" ? record2.id : "unknown",
-          label: typeof record2.label === "string" && record2.label.trim() ? record2.label.trim() : null,
-          description: typeof record2.description === "string" && record2.description.trim() ? record2.description.trim() : null,
-          metadata: asRecord4(record2.metadata)
+          id: typeof record3.id === "string" ? record3.id : "unknown",
+          label: typeof record3.label === "string" && record3.label.trim() ? record3.label.trim() : null,
+          description: typeof record3.description === "string" && record3.description.trim() ? record3.description.trim() : null,
+          metadata: asRecord4(record3.metadata)
         };
       }).filter(Boolean) : [],
       selected: status === "open" ? null : {
@@ -23794,11 +23828,11 @@ function normalizeJsonSchema(value) {
   return asRecord4(value);
 }
 function jsonSchemaTypeName(schema) {
-  const record2 = normalizeJsonSchema(schema);
-  if (!record2) return "unknown";
-  const type = record2.type;
-  if (record2.format === "date-time") return "date-time";
-  if (record2.format === "date" || type === "date" || Array.isArray(type) && type.includes("date")) {
+  const record3 = normalizeJsonSchema(schema);
+  if (!record3) return "unknown";
+  const type = record3.type;
+  if (record3.format === "date-time") return "date-time";
+  if (record3.format === "date" || type === "date" || Array.isArray(type) && type.includes("date")) {
     return "date";
   }
   if (typeof type === "string") {
@@ -23809,12 +23843,12 @@ function jsonSchemaTypeName(schema) {
   return "unknown";
 }
 function summarizeObjectSchema(schema) {
-  const record2 = normalizeJsonSchema(schema);
-  const properties = asRecord4(record2?.properties);
+  const record3 = normalizeJsonSchema(schema);
+  const properties = asRecord4(record3?.properties);
   if (!properties || Object.keys(properties).length === 0) {
-    return record2 ? "{}" : null;
+    return record3 ? "{}" : null;
   }
-  const required = new Set(asArray(record2?.required));
+  const required = new Set(asArray(record3?.required));
   const fields = Object.entries(properties).slice(0, 8).map(([name, property]) => {
     const marker = required.has(name) ? "*" : "?";
     return `${name}${marker}: ${jsonSchemaTypeName(property)}`;
@@ -24578,39 +24612,39 @@ function pushStringArray(target, value) {
     pushString(target, item);
   }
 }
-function collectReferencesFromRecord(record2, refs) {
+function collectReferencesFromRecord(record3, refs) {
   for (const key of ENTRY_KEY_CANDIDATES)
-    pushString(refs.entryPaths, record2[key]);
+    pushString(refs.entryPaths, record3[key]);
   for (const key of ENTRY_ARRAY_KEY_CANDIDATES)
-    pushStringArray(refs.entryPaths, record2[key]);
+    pushStringArray(refs.entryPaths, record3[key]);
   for (const key of LIST_KEY_CANDIDATES)
-    pushString(refs.listNames, record2[key]);
+    pushString(refs.listNames, record3[key]);
   for (const key of LIST_ARRAY_KEY_CANDIDATES)
-    pushStringArray(refs.listNames, record2[key]);
+    pushStringArray(refs.listNames, record3[key]);
   for (const key of VARIABLE_KEY_CANDIDATES)
-    pushString(refs.variableNames, record2[key]);
+    pushString(refs.variableNames, record3[key]);
   for (const key of VARIABLE_ARRAY_KEY_CANDIDATES)
-    pushStringArray(refs.variableNames, record2[key]);
+    pushStringArray(refs.variableNames, record3[key]);
 }
-function stringValue(record2, keys) {
+function stringValue(record3, keys) {
   for (const key of keys) {
-    const value = record2[key];
+    const value = record3[key];
     if (typeof value === "string" && value.trim()) {
       return value.trim();
     }
   }
   return null;
 }
-function findEntryPathForRecord(record2, heap) {
-  const directPath = stringValue(record2, ["entryPath", "path"]);
+function findEntryPathForRecord(record3, heap) {
+  const directPath = stringValue(record3, ["entryPath", "path"]);
   if (directPath && heap.entriesByPath?.[directPath]) {
     return directPath;
   }
-  const id = stringValue(record2, ["id", "_id", "recordId", "objectId"]);
+  const id = stringValue(record3, ["id", "_id", "recordId", "objectId"]);
   if (!id) {
     return null;
   }
-  const className = stringValue(record2, [
+  const className = stringValue(record3, [
     "className",
     "_className",
     "__className",
@@ -24644,17 +24678,17 @@ function scanForHeapReferences(value, heap, refs, depth = 0, seen = /* @__PURE__
     }
     return;
   }
-  const record2 = asRecord5(value);
-  if (!record2) return;
+  const record3 = asRecord5(value);
+  if (!record3) return;
   seen.add(value);
-  const entryPath = findEntryPathForRecord(record2, heap);
+  const entryPath = findEntryPathForRecord(record3, heap);
   if (entryPath) refs.entryPaths.add(entryPath);
-  collectReferencesFromRecord(record2, refs);
+  collectReferencesFromRecord(record3, refs);
   for (const key of UI_CONTAINER_KEYS) {
-    const nested = asRecord5(record2[key]);
+    const nested = asRecord5(record3[key]);
     if (nested) collectReferencesFromRecord(nested, refs);
   }
-  for (const nested of Object.values(record2).slice(0, 24)) {
+  for (const nested of Object.values(record3).slice(0, 24)) {
     scanForHeapReferences(nested, heap, refs, depth + 1, seen);
   }
 }
@@ -24803,8 +24837,8 @@ var OPENAI_MODEL_PRICING_USD_PER_MILLION = {
 function asRecord6(value) {
   return value && typeof value === "object" ? value : null;
 }
-function numberField(record2, key) {
-  const value = record2?.[key];
+function numberField(record3, key) {
+  const value = record3?.[key];
   return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function microsPerMillion(usdPerMillion) {
@@ -24908,6 +24942,39 @@ function calculateOpenAITokenSpend(model, rawUsage) {
   };
 }
 
+// src/artifact-action-review.ts
+function artifactReviewedOperation(artifact, inputValues = artifact.inputValues || {}, relationships = artifact.relationships || {}) {
+  const metadata = artifact.metadata || {};
+  const statePlan = { ...record2(metadata.statePlan) };
+  delete statePlan.approvedTransitions;
+  delete statePlan.approvalDecisions;
+  return {
+    artifactId: artifact.artifactId,
+    sessionId: artifact.sessionId || null,
+    environmentId: artifact.environmentId || null,
+    subjectId: artifact.subjectId || null,
+    buildId: artifact.buildId || null,
+    buildVersionNumber: artifact.buildVersionNumber ?? null,
+    kind: artifact.kind,
+    target: artifact.target || null,
+    policy: artifact.policy ?? null,
+    inputSchema: artifact.inputSchema || null,
+    inputValues,
+    relationships,
+    effectKey: metadata.effectKey || metadata.toolName || null,
+    effect: metadata.effect || null,
+    statePlan,
+    draftRecord: metadata.draftRecord || null,
+    relationshipCreate: metadata.relationshipCreate || null,
+    autonomy: metadata.autonomy || null,
+    batch: metadata.batch || null,
+    subArtifactIds: artifact.subArtifactIds || []
+  };
+}
+function record2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+
 // src/artifact-surface.ts
 function operationNode(workflow) {
   return getArtifactWorkflowNodes(workflow).find(
@@ -25127,6 +25194,7 @@ exports.OntologyHandle = OntologyHandle;
 exports.Session = Session;
 exports.SessionFeedController = SessionFeedController;
 exports.WSClient = WSClient;
+exports.artifactReviewedOperation = artifactReviewedOperation;
 exports.assertArtifactWorkflow = assertArtifactWorkflow;
 exports.buildContinuationInstruction = buildContinuationInstruction;
 exports.buildContinuationInstructionFromTemplate = buildContinuationInstructionFromTemplate;