@agentxm/workspace-operations 0.28.6 → 0.28.7

package/dist/src/index.d.ts

@@ -16,7 +16,7 @@ export { AtomicityClassSchema, OperationOutcomeSchema, OperationPhaseSchema, Uni
 export type { AtomicityClass, MakeOperationResolutionArgs, OperationAtomicity, OperationBlock, OperationFootprintEntry, OperationInterruption, OperationOutcome, OperationPhase, OperationRecovery, OperationResolution, ResolvedUnit, UnitDisposition, UnitState, UnitStateCounts, } from "./plan/operation-resolution.js";
 export { OperationJournal, appendResolvedUnit, appendStartedUnit, recordJournalPhase, getOperationJournal, makeOperationJournal, recordOperationJournal, updateOperationJournal, type OperationJournalService, type OperationJournalState, } from "./plan/operation-journal.js";
 export { applyPlan, type ApplyPlanOptions, type OperationHandler } from "./plan/apply-plan.js";
-export { CurrentOperationUnit, OperationEventSchema, OperationLifecycle, OperationModeSchema, ProgressUnitSchema, SettledOutcomeSchema, awaitDrained, lifecycleEvents, makeOperationLifecycle, makeThrottledUnitProgress, observeUnit, publishOperationEvent, publishPhaseStarted, publishUnitProgress, publishWaitEnded, publishWaiting, settleOperation, subscribeLossless, type ObservedUnit, type OperationEvent, type OperationEventEncoded, type OperationEventInput, type OperationLifecycleService, type OperationMode, type ProgressUnit, type SettledOutcome, } from "./plan/operation-events.js";
+export { CurrentOperationUnit, OperationEventSchema, OperationLifecycle, OperationModeSchema, ProgressUnitSchema, SettledOutcomeSchema, awaitDrained, lifecycleEvents, makeOperationLifecycle, makeThrottledUnitProgress, observeChildUnit, observeUnit, publishOperationEvent, publishPhaseStarted, publishUnitProgress, publishWaitEnded, publishWaiting, settleOperation, subscribeLossless, type ObservedUnit, type OperationEvent, type OperationEventEncoded, type OperationEventInput, type OperationLifecycleService, type OperationMode, type ProgressUnit, type SettledOutcome, } from "./plan/operation-events.js";
 export { ApprovalRecoveryMissing, CandidateFingerprintFailed, OPERATION_ERROR_CATEGORIES, OperationErrorCategorySchema, PlanInteractionFailed, STALE_CANDIDATE_DETAIL, StaleExecutionCandidate, StepFailure, type OperationErrorCategory, } from "./plan/errors.js";
 export { previewOrApplyPlan } from "./plan/resolve-plan.js";
 export { ResolvePlanInteraction, type ApplyConfirmation, type ResolvePlanInteractionService, } from "./plan/resolve-plan-interaction.js";

package/dist/src/index.js

@@ -20,7 +20,7 @@ export { OperationJournal, appendResolvedUnit, appendStartedUnit, recordJournalP
 // Apply plan + operation handler registry
 export { applyPlan } from "./plan/apply-plan.js";
 // Operation lifecycle events — the live contract every observer subscribes to.
-export { CurrentOperationUnit, OperationEventSchema, OperationLifecycle, OperationModeSchema, ProgressUnitSchema, SettledOutcomeSchema, awaitDrained, lifecycleEvents, makeOperationLifecycle, makeThrottledUnitProgress, observeUnit, publishOperationEvent, publishPhaseStarted, publishUnitProgress, publishWaitEnded, publishWaiting, settleOperation, subscribeLossless, } from "./plan/operation-events.js";
+export { CurrentOperationUnit, OperationEventSchema, OperationLifecycle, OperationModeSchema, ProgressUnitSchema, SettledOutcomeSchema, awaitDrained, lifecycleEvents, makeOperationLifecycle, makeThrottledUnitProgress, observeChildUnit, observeUnit, publishOperationEvent, publishPhaseStarted, publishUnitProgress, publishWaitEnded, publishWaiting, settleOperation, subscribeLossless, } from "./plan/operation-events.js";
 // Serialized error vocabulary and the plan-family tagged errors.
 export { ApprovalRecoveryMissing, CandidateFingerprintFailed, OPERATION_ERROR_CATEGORIES, OperationErrorCategorySchema, PlanInteractionFailed, STALE_CANDIDATE_DETAIL, StaleExecutionCandidate, StepFailure, } from "./plan/errors.js";
 // Interactive preview/apply orchestration over the workspace read model.

package/dist/src/plan/operation-events.d.ts

@@ -233,21 +233,37 @@ export declare const makeThrottledUnitProgress: (options: {
     readonly unit: ProgressUnit;
     readonly intervalMs?: number | undefined;
 }) => Effect.Effect<(done: number, total?: number | undefined) => Effect.Effect<void>>;
-export interface ObservedUnit {
+export interface ObservedUnit<A = never> {
     readonly id: string;
     readonly label: string;
     /** Planned position; assigned by the service when the caller has none. */
     readonly index?: number | undefined;
     readonly total?: number | undefined;
     readonly parentUnitId?: string | undefined;
+    /**
+     * The label the unit settles with, read from the value it produced. A unit
+     * that exists to resolve a fact reports that fact here, so its settlement
+     * names the answer instead of repeating the question. Only a successful
+     * exit has a value to read; a failed or interrupted unit settles with the
+     * label it started with.
+     */
+    readonly resolvedLabel?: (value: A) => string;
 }
 /**
  * Run one unit of work under the lifecycle: `UnitStarted` before, then
  * `UnitResolved` with the state the exit proves (`committed`, `failed`, or
- * `interrupted`). The unit identity is provided to the run so nested producers
- * can publish progress. No-op wrapper without a broadcast.
+ * `interrupted`) and the label the unit settles with. The unit identity is
+ * provided to the run so nested producers can publish progress. No-op wrapper
+ * without a broadcast.
+ */
+export declare const observeUnit: <A, E, R>(unit: ObservedUnit<A>, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Run a unit as a child of the unit currently in progress, so work a step
+ * delegates nests under the step that delegated it. Identical to
+ * `observeUnit` when no unit is in progress, and when the caller states its
+ * own parent that statement wins.
  */
-export declare const observeUnit: <A, E, R>(unit: ObservedUnit, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+export declare const observeChildUnit: <A, E, R>(unit: ObservedUnit<A>, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 /** Publish the terminal event once. No-op without a broadcast. */
 export declare const settleOperation: (outcome: SettledOutcome) => Effect.Effect<void>;
 /**

package/dist/src/plan/operation-events.js

@@ -234,8 +234,9 @@ const unitStateForExit = (exit) => Exit.isSuccess(exit)
 /**
  * Run one unit of work under the lifecycle: `UnitStarted` before, then
  * `UnitResolved` with the state the exit proves (`committed`, `failed`, or
- * `interrupted`). The unit identity is provided to the run so nested producers
- * can publish progress. No-op wrapper without a broadcast.
+ * `interrupted`) and the label the unit settles with. The unit identity is
+ * provided to the run so nested producers can publish progress. No-op wrapper
+ * without a broadcast.
  */
 export const observeUnit = (unit, effect) => Effect.flatMap(Effect.serviceOption(OperationLifecycle), (service) => {
     if (Option.isNone(service))
@@ -259,13 +260,24 @@ export const observeUnit = (unit, effect) => Effect.flatMap(Effect.serviceOption
             seq,
             atMs,
             unitId: unit.id,
-            label: unit.label,
+            label: Exit.isSuccess(exit) && unit.resolvedLabel !== undefined
+                ? unit.resolvedLabel(exit.value)
+                : unit.label,
             state: unitStateForExit(exit),
             index,
             ...total,
         }))));
     });
 });
+/**
+ * Run a unit as a child of the unit currently in progress, so work a step
+ * delegates nests under the step that delegated it. Identical to
+ * `observeUnit` when no unit is in progress, and when the caller states its
+ * own parent that statement wins.
+ */
+export const observeChildUnit = (unit, effect) => Effect.flatMap(Effect.serviceOption(CurrentOperationUnit), (parent) => observeUnit(unit.parentUnitId !== undefined || Option.isNone(parent)
+    ? unit
+    : { ...unit, parentUnitId: parent.value.unitId }, effect));
 /** Publish the terminal event once. No-op without a broadcast. */
 export const settleOperation = (outcome) => withLifecycle((service) => service.settle(outcome), () => Effect.void);
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxm/workspace-operations",
-  "version": "0.28.6",
+  "version": "0.28.7",
   "description": "AXM workspace operations kernel: plans, execution candidates, operation resolutions, and workspace transactions for the axm CLI. Unstable and unsupported — use the axm.sh CLI.",
   "type": "module",
   "license": "FSL-1.1-MIT",
@@ -48,9 +48,9 @@
   "dependencies": {
     "effect": "4.0.0-rc.112",
     "proper-lockfile": "^4.1.2",
-    "@agentxm/extension-model": "^0.28.6",
-    "@agentxm/workspace-state": "^0.28.6",
-    "@agentxm/registry-protocol": "^0.28.6"
+    "@agentxm/registry-protocol": "^0.28.7",
+    "@agentxm/workspace-state": "^0.28.7",
+    "@agentxm/extension-model": "^0.28.7"
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.0-rc.112",