@makaio/framework 1.0.0-dev-1788897280508 → 1.0.0-dev-1788909333961

package/dist/{index-PTp68NH1.d.mts → index-CpdRe5df.d.mts}

@@ -1,6 +1,6 @@
-import { C as ArtifactRevision$1 } from "./schemas-C5FreSE0.mjs";
-import { n as AutomationTriggerBinding$1, o as AutomationTriggerParams, u as DefinedAutomationTrigger } from "./definition-BgY763Q4.mjs";
-import { a as JsonObjectContractSchema, l as JsonValue$1 } from "./json-value-C57MkQrB.mjs";
+import { C as ArtifactRevision$1 } from "./schemas-B9yLU2jM.mjs";
+import { n as AutomationTriggerBinding$1, o as AutomationTriggerParams, u as DefinedAutomationTrigger } from "./definition-Bs5hzhsT.mjs";
+import { a as JsonObjectContractSchema, l as JsonValue$1 } from "./json-value-DyMQrwGz.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
 import { ExtractSubjectPayload, PayloadFilter, SubjectDefinition, TypedPayloadFilter } from "@makaio/framework/core";
@@ -964,8 +964,8 @@ declare const WorkflowResolvedRoleSchema: z.ZodObject<{
   harnessId: z.ZodOptional<z.ZodString>;
   systemPrompt: z.ZodOptional<z.ZodString>;
   contextMode: z.ZodOptional<z.ZodEnum<{
-    fresh: "fresh";
     fork: "fork";
+    fresh: "fresh";
   }>>;
   providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
     state: z.ZodLiteral<"resolved">;
@@ -1075,8 +1075,8 @@ declare const WorkflowResolvedAgentSchema: z.ZodObject<{
   harnessId: z.ZodOptional<z.ZodString>;
   systemPrompt: z.ZodOptional<z.ZodString>;
   contextMode: z.ZodOptional<z.ZodEnum<{
-    fresh: "fresh";
     fork: "fork";
+    fresh: "fresh";
   }>>;
   providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
     state: z.ZodLiteral<"resolved">;
@@ -4085,8 +4085,8 @@ declare const WorkflowSchemas: {
       harnessId: z.ZodOptional<z.ZodString>;
       systemPrompt: z.ZodOptional<z.ZodString>;
       contextMode: z.ZodOptional<z.ZodEnum<{
-        fresh: "fresh";
         fork: "fork";
+        fresh: "fresh";
       }>>;
       providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         state: z.ZodLiteral<"resolved">;
@@ -4196,8 +4196,8 @@ declare const WorkflowSchemas: {
       harnessId: z.ZodOptional<z.ZodString>;
       systemPrompt: z.ZodOptional<z.ZodString>;
       contextMode: z.ZodOptional<z.ZodEnum<{
-        fresh: "fresh";
         fork: "fork";
+        fresh: "fresh";
       }>>;
       providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         state: z.ZodLiteral<"resolved">;
@@ -6817,8 +6817,8 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
       harnessId: z.ZodOptional<z.ZodString>;
       systemPrompt: z.ZodOptional<z.ZodString>;
       contextMode: z.ZodOptional<z.ZodEnum<{
-        fresh: "fresh";
         fork: "fork";
+        fresh: "fresh";
       }>>;
       providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         state: z.ZodLiteral<"resolved">;
@@ -6928,8 +6928,8 @@ declare const WorkflowNamespace$1: _$_makaio_core0.BusNamespaceDefinition<"workf
       harnessId: z.ZodOptional<z.ZodString>;
       systemPrompt: z.ZodOptional<z.ZodString>;
       contextMode: z.ZodOptional<z.ZodEnum<{
-        fresh: "fresh";
         fork: "fork";
+        fresh: "fresh";
       }>>;
       providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         state: z.ZodLiteral<"resolved">;
@@ -9549,8 +9549,8 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       harnessId: z.ZodOptional<z.ZodString>;
       systemPrompt: z.ZodOptional<z.ZodString>;
       contextMode: z.ZodOptional<z.ZodEnum<{
-        fresh: "fresh";
         fork: "fork";
+        fresh: "fresh";
       }>>;
       providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         state: z.ZodLiteral<"resolved">;
@@ -9660,8 +9660,8 @@ declare const WorkflowSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       harnessId: z.ZodOptional<z.ZodString>;
       systemPrompt: z.ZodOptional<z.ZodString>;
       contextMode: z.ZodOptional<z.ZodEnum<{
-        fresh: "fresh";
         fork: "fork";
+        fresh: "fresh";
       }>>;
       providerContext: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         state: z.ZodLiteral<"resolved">;
@@ -12146,8 +12146,8 @@ type IterateHandler<TTrigger = unknown, TPreviousSteps extends Record<string, Pr
  * - fresh: Start with clean context
  */
 declare const ContextModeSchema$1: z.ZodEnum<{
-  fresh: "fresh";
   fork: "fork";
+  fresh: "fresh";
 }>;
 type ContextMode = z.infer<typeof ContextModeSchema$1>;
 /**
@@ -12282,8 +12282,8 @@ declare const SubagentConfigSchema$1: z.ZodObject<{
     "extra-high": "extra-high";
   }>>;
   contextMode: z.ZodDefault<z.ZodEnum<{
-    fresh: "fresh";
     fork: "fork";
+    fresh: "fresh";
   }>>;
   tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
   disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -12452,8 +12452,8 @@ declare const SpawnSubagentRpcRequestSchema$1: z.ZodObject<{
       "extra-high": "extra-high";
     }>>;
     contextMode: z.ZodDefault<z.ZodEnum<{
-      fresh: "fresh";
       fork: "fork";
+      fresh: "fresh";
     }>>;
     tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/{index-CQtttPGm.d.mts → index-D7j6v0-L.d.mts}

@@ -1,4 +1,4 @@
-import { t as CapabilityService } from "./capability-service-BlYnun2M.mjs";
+import { t as CapabilityService } from "./capability-service-CsWaOwvH.mjs";
 import { IMakaioBus } from "@makaio/framework/bus";
 import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
 import { MakaioNodeExtension } from "@makaio/framework/contracts";

package/dist/{index-Cau0jTTM.d.mts → index-DFsJTTkS.d.mts}

@@ -1,4 +1,4 @@
-import { c as AdapterRuntimeSnapshotErrorCode } from "./schemas-DmE-a0kN.mjs";
+import { c as AdapterRuntimeSnapshotErrorCode } from "./schemas-BfMFZ6J5.mjs";
 import { IMakaioBus } from "@makaio/framework/bus";
 import { ProviderContext, ResolvedProviderContext } from "@makaio/framework/contracts";
 

package/dist/{index-mylsCg6V2.d.mts → index-DI-1HK7v2.d.mts}

@@ -1,4 +1,4 @@
-import { t as ContractStorageNamespaceDefinition } from "./storage-namespace-definition-C0mnpnC_.mjs";
+import { t as ContractStorageNamespaceDefinition } from "./storage-namespace-definition-NBw1Y8Pa.mjs";
 import * as _$zod from "zod";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";

package/dist/{index-DJ0Muy2s.d.mts → index-DlKxbLC9.d.mts}

@@ -1,5 +1,5 @@
-import { g as OwnedAdapterInstance, h as MachineScopedAdapterInstance, w as Turn$1 } from "./index-BZtasAZP.mjs";
-import { a as PipelineStep, o as SessionEditorAction, t as ActionCategory } from "./types-DJuxNrac.mjs";
+import { g as OwnedAdapterInstance, h as MachineScopedAdapterInstance, w as Turn$1 } from "./index-BjcJH3I-.mjs";
+import { a as PipelineStep, o as SessionEditorAction, t as ActionCategory } from "./types-BcGXdeva.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
 import { ExtractSubjectPayload, SubjectDefinition } from "@makaio/framework/core";

package/dist/{index-D0DfEO45.d.mts → index-OP6Aw5jN.d.mts}

@@ -1,4 +1,4 @@
-import { d as PiscinaCodeExecutionProviderOptions } from "./types-eCGV_g6P.mjs";
+import { d as PiscinaCodeExecutionProviderOptions } from "./types-CUCFeisO.mjs";
 import { CodeExecutionOutcome, CodeExecutionProviderContext, CodeExecutionRequest, CodeExecutionTrustLevel, ICodeExecutionProvider } from "@makaio/framework/contracts";
 
 //#region runtimes/node/src/code-execution/piscina-code-execution-provider.d.ts

package/dist/{index-CDLHgV7v.d.mts → index-U0Fe0baO.d.mts}

@@ -1,4 +1,4 @@
-import { D as ClientDefinitionInput, E as ClientDefinition } from "./hook-responses-BSCAdJ3i.mjs";
+import { D as ClientDefinitionInput, E as ClientDefinition } from "./hook-responses-Cs8A07ZP.mjs";
 import * as _$zod from "zod";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
@@ -506,9 +506,9 @@ declare const ClientSchemas: {
     cwd: z.ZodOptional<z.ZodString>;
     machineId: z.ZodOptional<z.ZodString>;
     startMode: z.ZodOptional<z.ZodEnum<{
+      fork: "fork";
       fresh: "fresh";
       resume: "resume";
-      fork: "fork";
       clear: "clear";
       compact: "compact";
     }>>;
@@ -688,8 +688,8 @@ declare const ClientSchemas: {
     reason: z.ZodEnum<{
       update: "update";
       install: "install";
-      "set-active": "set-active";
       uninstall: "uninstall";
+      "set-active": "set-active";
     }>;
   }, z.core.$strip>;
   resolveBinary: {
@@ -1246,8 +1246,8 @@ declare const ClientVersionChangedSchema: z.ZodObject<{
   reason: z.ZodEnum<{
     update: "update";
     install: "install";
-    "set-active": "set-active";
     uninstall: "uninstall";
+    "set-active": "set-active";
   }>;
 }, z.core.$strip>;
 type ClientVersionChanged = z.infer<typeof ClientVersionChangedSchema>;
@@ -1486,9 +1486,9 @@ type ClientSessionObservedBase = z.infer<typeof ClientSessionObservedBaseSchema>
 declare const CLIENT_SESSION_START_MODES: readonly ["fresh", "fork", "resume", "clear", "compact"];
 /** Zod schema for the client-reported session start mode. */
 declare const ClientSessionStartModeSchema: z.ZodEnum<{
+  fork: "fork";
   fresh: "fresh";
   resume: "resume";
-  fork: "fork";
   clear: "clear";
   compact: "compact";
 }>;
@@ -1505,9 +1505,9 @@ declare const ClientSessionStartedSchema: z.ZodObject<{
   cwd: z.ZodOptional<z.ZodString>;
   machineId: z.ZodOptional<z.ZodString>;
   startMode: z.ZodOptional<z.ZodEnum<{
+    fork: "fork";
     fresh: "fresh";
     resume: "resume";
-    fork: "fork";
     clear: "clear";
     compact: "compact";
   }>>;
@@ -2076,9 +2076,9 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
     cwd: _$zod.ZodOptional<_$zod.ZodString>;
     machineId: _$zod.ZodOptional<_$zod.ZodString>;
     startMode: _$zod.ZodOptional<_$zod.ZodEnum<{
+      fork: "fork";
       fresh: "fresh";
       resume: "resume";
-      fork: "fork";
       clear: "clear";
       compact: "compact";
     }>>;
@@ -2258,8 +2258,8 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
     reason: _$zod.ZodEnum<{
       update: "update";
       install: "install";
-      "set-active": "set-active";
       uninstall: "uninstall";
+      "set-active": "set-active";
     }>;
   }, _$zod_v4_core0.$strip>;
   resolveBinary: {
@@ -2716,9 +2716,9 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
     cwd: _$zod.ZodOptional<_$zod.ZodString>;
     machineId: _$zod.ZodOptional<_$zod.ZodString>;
     startMode: _$zod.ZodOptional<_$zod.ZodEnum<{
+      fork: "fork";
       fresh: "fresh";
       resume: "resume";
-      fork: "fork";
       clear: "clear";
       compact: "compact";
     }>>;
@@ -2898,8 +2898,8 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
     reason: _$zod.ZodEnum<{
       update: "update";
       install: "install";
-      "set-active": "set-active";
       uninstall: "uninstall";
+      "set-active": "set-active";
     }>;
   }, _$zod_v4_core0.$strip>;
   resolveBinary: {

package/dist/{index-F6hV4tWI.d.mts → index-VAJBIJUb.d.mts}

@@ -1,6 +1,6 @@
-import { a as JsonObjectContractSchema } from "./json-value-C57MkQrB.mjs";
-import { o as ICapabilityProvider } from "./index-CUHWylh4.mjs";
-import { Qt as WorkerContributionManifest, ln as WorkflowWorkerConfig } from "./index-PTp68NH1.mjs";
+import { a as JsonObjectContractSchema } from "./json-value-DyMQrwGz.mjs";
+import { o as ICapabilityProvider } from "./index-D3_QOfke.mjs";
+import { Qt as WorkerContributionManifest, ln as WorkflowWorkerConfig } from "./index-CpdRe5df.mjs";
 import * as _$zod from "zod";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
@@ -2053,13 +2053,13 @@ declare const ReviewSchemas: {
           dismissed: "dismissed";
           deferred: "deferred";
         }>;
-        sourceId: z.ZodString;
         severity: z.ZodEnum<{
           critical: "critical";
           major: "major";
           minor: "minor";
           nitpick: "nitpick";
         }>;
+        sourceId: z.ZodString;
         reviewer: z.ZodString;
         threadId: z.ZodNullable<z.ZodString>;
         startLine: z.ZodNullable<z.ZodNumber>;
@@ -2730,13 +2730,13 @@ declare const ReviewNamespace: _$_makaio_core0.BusNamespaceDefinition<"review",
           dismissed: "dismissed";
           deferred: "deferred";
         }>;
-        sourceId: _$zod.ZodString;
         severity: _$zod.ZodEnum<{
           critical: "critical";
           major: "major";
           minor: "minor";
           nitpick: "nitpick";
         }>;
+        sourceId: _$zod.ZodString;
         reviewer: _$zod.ZodString;
         threadId: _$zod.ZodNullable<_$zod.ZodString>;
         startLine: _$zod.ZodNullable<_$zod.ZodNumber>;
@@ -3182,13 +3182,13 @@ declare const ReviewSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
           dismissed: "dismissed";
           deferred: "deferred";
         }>;
-        sourceId: _$zod.ZodString;
         severity: _$zod.ZodEnum<{
           critical: "critical";
           major: "major";
           minor: "minor";
           nitpick: "nitpick";
         }>;
+        sourceId: _$zod.ZodString;
         reviewer: _$zod.ZodString;
         threadId: _$zod.ZodNullable<_$zod.ZodString>;
         startLine: _$zod.ZodNullable<_$zod.ZodNumber>;
@@ -6159,9 +6159,9 @@ type AllocationState = z.infer<typeof AllocationStateSchema>;
 /**
  * Zod schema for the result of inspecting a provider allocation.
  *
- * Contains the infrastructure state, the allocation reference that was
- * inspected, and optional non-secret provider evidence (e.g. exit code,
- * timestamps, termination reason).
+ * Contains the infrastructure state, the inspected allocation's reference
+ * (possibly refined by correlation), optional non-secret provider evidence (e.g. exit code,
+ * timestamps, termination reason), and optional positive completion evidence.
  *
  * Framework code treats `evidence` as opaque; only the originating provider
  * interprets its contents.
@@ -6182,13 +6182,20 @@ declare const AllocationInspectionSchema: z.ZodObject<{
     providerData: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
   }, z.core.$strict>;
   evidence: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+  completionEvidence: z.ZodOptional<z.ZodObject<{
+    source: z.ZodString;
+    summary: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    code: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
 }, z.core.$strip>;
 /**
  * Result of inspecting a provider allocation.
  *
  * Reports infrastructure evidence only. A terminal allocation without an
  * acknowledged worker outcome is an infrastructure failure, not a workflow
- * success or failure.
+ * success or failure; terminal state alone also does not prove provider
+ * completion.
  */
 type AllocationInspection = z.infer<typeof AllocationInspectionSchema>;
 /**
@@ -6404,8 +6411,9 @@ interface WorkerInfrastructureConclusion {
 /**
  * In-process handle for a provisioned Worker allocation.
  *
- * Returned as part of the {@link IWorkerProvider.provision} result and
- * held by the caller until the allocation is no longer needed.
+ * Returned as part of the {@link IWorkerProvider.provision} result and held
+ * only while its current host owns local observation or control resources. A
+ * handoff may release that local handle while provider-side work remains open.
  *
  * The handle controls allocation infrastructure only. It does NOT expose a
  * `ready` promise or a `waitForResult()` method. Readiness is signaled through
@@ -6428,17 +6436,20 @@ interface WorkerHandle {
    */
   terminate(): Promise<void>;
   /**
-   * Release provider-owned resources associated with this allocation.
+   * Release local resources retained for this allocation.
    *
-   * Called after the workflow outcome has settled (success, failure, or
-   * cancellation) to free credentials, listeners, and other per-allocation
-   * state that should not persist for the lifetime of the host process.
+   * Releases only local, process-bound resources such as listeners or retained
+   * handles. It is safe during a host handoff: it must NOT cancel a running
+   * allocation, alter its outcome, revoke the attempt's active bus identity or
+   * credentials, or claim that provider work completed. A provider may release
+   * final allocation credentials only after its own positive completion or a
+   * definitive terminal path established that they cannot be needed for an
+   * outcome submission.
    *
-   * Release is a resource-disposal signal, distinct from infrastructure
-   * cancellation: it must NOT cancel a running allocation or alter the
-   * workflow outcome. Implementations must be idempotent — calling
-   * `release()` multiple times is safe and has no additional effect.
-   * @returns Promise that resolves when provider resources have been released.
+   * Release is a local resource-disposal signal, distinct from infrastructure
+   * cancellation. Implementations must be idempotent — calling `release()`
+   * multiple times is safe and has no additional effect.
+   * @returns Promise that resolves when local resources have been released.
    */
   release(): Promise<void>;
   /**
@@ -6448,11 +6459,45 @@ interface WorkerHandle {
    * state. The callback never carries readiness or a workflow result.
    * If the provider reached a conclusion before registration, it replays that
    * same conclusion to this observer synchronously. Each observer receives at
-   * most one conclusion.
+   * most one conclusion. A terminal conclusion does not end completion
+   * observation: a controller that needs provider completion keeps its
+   * completion and observation-loss observers until one reports or it releases
+   * the handle.
    * @param observer - Callback invoked at most once for a terminal conclusion.
    * @returns Cleanup function that stops observing the provider signal.
    */
   observeInfrastructureConclusion?(observer: (conclusion: WorkerInfrastructureConclusion) => void): () => void;
+  /**
+   * Observe positive provider completion evidence for this allocation.
+   *
+   * This differs from {@link observeInfrastructureConclusion}: a terminal
+   * worker process can leave provider cleanup or retention duties open. A
+   * provider exposes this observer only when it can prove all of its
+   * allocation responsibilities are complete. If that proof was available
+   * before registration, the handle replays it synchronously. Each observer
+   * receives at most one completion proof. For one handle, a delivered proof
+   * and {@link observeLocalObservationLoss} are mutually exclusive final
+   * observation results.
+   * @param observer - Callback invoked at most once with durable completion evidence.
+   * @returns Cleanup function that stops observing the provider signal.
+   */
+  observeProviderCompletion?(observer: (evidence: BoundedRecoveryEvidence) => void): () => void;
+  /**
+   * Observe that this handle permanently lost its own local monitoring.
+   *
+   * This reports that the handle can no longer observe a completion proof; it
+   * is not remote teardown success, provider terminality, or provider
+   * completion, and it does not revoke credentials. It tells the current claim
+   * holder to hand the still-open provider operation to durable recovery. For
+   * one handle, this signal and {@link observeProviderCompletion} are mutually
+   * exclusive final observation results. If loss happened before registration,
+   * the handle replays it synchronously. Explicit release only detaches local
+   * observation; callers still fence callbacks that race that detachment with
+   * their current claim.
+   * @param observer - Callback invoked at most once when local monitoring is lost.
+   * @returns Cleanup function that stops observing the local-loss signal.
+   */
+  observeLocalObservationLoss?(observer: () => void): () => void;
   /**
    * Observe a refined allocation reference for this allocation.
    *
@@ -6658,19 +6703,24 @@ interface IWorkerRecoveryCapability {
    */
   discoverProvisioning(request: WorkerProviderContext, signal: AbortSignal): Promise<ProvisioningDiscovery>;
   /**
-   * Re-attach to an existing allocation for the same attempt.
+   * Re-attach to a known allocation's provider operation for the same attempt.
    *
    * Creates a fresh in-process {@link WorkerHandle} without creating a
    * new provider resource. Used after an Authority restart to regain
-   * infrastructure control of a still-running allocation.
+   * infrastructure control or finish outstanding allocation-scoped cleanup.
    *
-   * This is same-attempt controller recovery, not workflow resume. The
-   * returned handle controls the same allocation that was originally
-   * provisioned.
+   * This is same-attempt controller recovery, not workflow resume. It may
+   * attach to a terminal or already absent allocation when provider cleanup is
+   * still outstanding. Recovery of absent-resource cleanup requires a settled
+   * attempt with an unresolved provider operation. The handle refers to the
+   * known allocation; it does not assert that compute is running. Attaching
+   * never creates, resumes, restarts, or deletes a resource and never announces
+   * runtime readiness. A provider may confirm completion only after its
+   * remaining duties are fulfilled; absence alone is not completion proof.
    * @param allocationRef - Validated allocation reference from a prior provision.
    * @param request - Durable attempt context for provider-side correlation.
    * @param signal - AbortSignal for cooperative cancellation of the attach operation.
-   * @returns Fresh infrastructure handle for the existing allocation.
+   * @returns Fresh control and observation handle for the known allocation's remaining duties.
    */
   attach(allocationRef: ProviderAllocationRef, request: WorkerProviderContext, signal: AbortSignal): Promise<WorkerHandle>;
   /**
@@ -6680,6 +6730,10 @@ interface IWorkerRecoveryCapability {
    * acknowledged worker outcome is an infrastructure failure, not a workflow
    * success or failure. The returned {@link AllocationInspection} includes
    * the allocation state and optional non-secret provider evidence.
+   * Inspection may refine the reference as correlation identifies the same
+   * allocation more precisely. It remains read-only: the provider neither
+   * persists that refinement nor creates, restarts, or deletes infrastructure.
+   * The claim-owning host records the refinement before further control.
    * @param allocationRef - Validated allocation reference to inspect.
    * @param request - Freshly resolved provider context for the same attempt.
    * @param signal - AbortSignal for cooperative cancellation of the inspect operation.
@@ -6729,8 +6783,8 @@ type OutcomeAckDecision = 'accepted' | 'duplicate' | 'conflict' | 'fenced';
 declare const OutcomeAckDecisionSchema: z.ZodEnum<{
   accepted: "accepted";
   duplicate: "duplicate";
-  conflict: "conflict";
   fenced: "fenced";
+  conflict: "conflict";
 }>;
 /**
  * Allocation acknowledgment returned by the dispatch RPC.