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

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

@@ -1,4 +1,4 @@
-import { t as CapabilityService } from "./capability-service-DA9xdAyh.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-1y-PUD3B.d.mts → index-DFsJTTkS.d.mts}

@@ -1,4 +1,4 @@
-import { c as AdapterRuntimeSnapshotErrorCode } from "./schemas-Bw2-j1lm.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-D9CdrFKz2.d.mts → index-DI-1HK7v2.d.mts}

@@ -1,4 +1,4 @@
-import { t as ContractStorageNamespaceDefinition } from "./storage-namespace-definition-Dkxl1FGw.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-BDs5tDcM.d.mts → index-DlKxbLC9.d.mts}

@@ -1,5 +1,5 @@
-import { g as OwnedAdapterInstance, h as MachineScopedAdapterInstance, w as Turn$1 } from "./index-BlJbchHp.mjs";
-import { a as PipelineStep, o as SessionEditorAction, t as ActionCategory } from "./types-BWfAz9Sh.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";
@@ -6596,8 +6596,8 @@ declare const MessageRoutingNamespace: _$_makaio_storage_core0.StorageNamespaceD
       agentId: z.ZodString;
       status: z.ZodEnum<{
         completed: "completed";
-        acknowledged: "acknowledged";
         sent: "sent";
+        acknowledged: "acknowledged";
       }>;
       timestamp: z.ZodNumber;
       error: z.ZodOptional<z.ZodString>;
@@ -6622,8 +6622,8 @@ declare const MessageRoutingNamespace: _$_makaio_storage_core0.StorageNamespaceD
         agentId: z.ZodString;
         status: z.ZodEnum<{
           completed: "completed";
-          acknowledged: "acknowledged";
           sent: "sent";
+          acknowledged: "acknowledged";
         }>;
         timestamp: z.ZodNumber;
         error: z.ZodOptional<z.ZodString>;
@@ -6710,7 +6710,7 @@ declare const MessageRoutingNamespace: _$_makaio_storage_core0.StorageNamespaceD
           tableName: "message_routing";
           dataType: "string";
           columnType: "SQLiteText";
-          data: "completed" | "acknowledged" | "sent";
+          data: "completed" | "sent" | "acknowledged";
           driverParam: string;
           notNull: true;
           hasDefault: false;
@@ -6781,8 +6781,8 @@ declare const MessageRoutingSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core
       agentId: z.ZodString;
       status: z.ZodEnum<{
         completed: "completed";
-        acknowledged: "acknowledged";
         sent: "sent";
+        acknowledged: "acknowledged";
       }>;
       timestamp: z.ZodNumber;
       error: z.ZodOptional<z.ZodString>;
@@ -6807,8 +6807,8 @@ declare const MessageRoutingSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core
         agentId: z.ZodString;
         status: z.ZodEnum<{
           completed: "completed";
-          acknowledged: "acknowledged";
           sent: "sent";
+          acknowledged: "acknowledged";
         }>;
         timestamp: z.ZodNumber;
         error: z.ZodOptional<z.ZodString>;
@@ -6952,7 +6952,7 @@ declare const messageRouting: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<
       tableName: "message_routing";
       dataType: "string";
       columnType: "SQLiteText";
-      data: "completed" | "acknowledged" | "sent";
+      data: "completed" | "sent" | "acknowledged";
       driverParam: string;
       notNull: true;
       hasDefault: false;

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

@@ -1,4 +1,4 @@
-import { d as PiscinaCodeExecutionProviderOptions } from "./types-DDfy8LgJ.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-DmTBlEzu.d.mts → index-U0Fe0baO.d.mts}

@@ -1,4 +1,4 @@
-import { D as ClientDefinitionInput, E as ClientDefinition } from "./hook-responses-DK6uu35J.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";
@@ -507,8 +507,8 @@ declare const ClientSchemas: {
     machineId: z.ZodOptional<z.ZodString>;
     startMode: z.ZodOptional<z.ZodEnum<{
       fork: "fork";
-      resume: "resume";
       fresh: "fresh";
+      resume: "resume";
       clear: "clear";
       compact: "compact";
     }>>;
@@ -1487,8 +1487,8 @@ declare const CLIENT_SESSION_START_MODES: readonly ["fresh", "fork", "resume", "
 /** Zod schema for the client-reported session start mode. */
 declare const ClientSessionStartModeSchema: z.ZodEnum<{
   fork: "fork";
-  resume: "resume";
   fresh: "fresh";
+  resume: "resume";
   clear: "clear";
   compact: "compact";
 }>;
@@ -1506,8 +1506,8 @@ declare const ClientSessionStartedSchema: z.ZodObject<{
   machineId: z.ZodOptional<z.ZodString>;
   startMode: z.ZodOptional<z.ZodEnum<{
     fork: "fork";
-    resume: "resume";
     fresh: "fresh";
+    resume: "resume";
     clear: "clear";
     compact: "compact";
   }>>;
@@ -2077,8 +2077,8 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
     machineId: _$zod.ZodOptional<_$zod.ZodString>;
     startMode: _$zod.ZodOptional<_$zod.ZodEnum<{
       fork: "fork";
-      resume: "resume";
       fresh: "fresh";
+      resume: "resume";
       clear: "clear";
       compact: "compact";
     }>>;
@@ -2717,8 +2717,8 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
     machineId: _$zod.ZodOptional<_$zod.ZodString>;
     startMode: _$zod.ZodOptional<_$zod.ZodEnum<{
       fork: "fork";
-      resume: "resume";
       fresh: "fresh";
+      resume: "resume";
       clear: "clear";
       compact: "compact";
     }>>;

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

@@ -1,6 +1,6 @@
-import { a as JsonObjectContractSchema } from "./json-value-DbwI1AMR.mjs";
-import { o as ICapabilityProvider } from "./index-DmjyHIEH.mjs";
-import { Qt as WorkerContributionManifest, ln as WorkflowWorkerConfig } from "./index-DXv51ZIb.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";
@@ -3732,8 +3732,8 @@ type VoiceStatusState = z.infer<typeof VoiceStatusStateSchema>;
  */
 declare const VoicePipelineLegSchema: z.ZodObject<{
   runtime: z.ZodEnum<{
-    client: "client";
     server: "server";
+    client: "client";
   }>;
   providerId: z.ZodString;
   providerName: z.ZodString;
@@ -3752,16 +3752,16 @@ type VoicePipelineLegSchemaType = VoicePipelineLeg;
 declare const VoicePipelineStrategySchema: z.ZodObject<{
   stt: z.ZodObject<{
     runtime: z.ZodEnum<{
-      client: "client";
       server: "server";
+      client: "client";
     }>;
     providerId: z.ZodString;
     providerName: z.ZodString;
   }, z.core.$strip>;
   tts: z.ZodObject<{
     runtime: z.ZodEnum<{
-      client: "client";
       server: "server";
+      client: "client";
     }>;
     providerId: z.ZodString;
     providerName: z.ZodString;
@@ -3810,16 +3810,16 @@ declare const VoiceSchemas: {
       strategy: z.ZodObject<{
         stt: z.ZodObject<{
           runtime: z.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: z.ZodString;
           providerName: z.ZodString;
         }, z.core.$strip>;
         tts: z.ZodObject<{
           runtime: z.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: z.ZodString;
           providerName: z.ZodString;
@@ -3832,16 +3832,16 @@ declare const VoiceSchemas: {
       strategy: z.ZodObject<{
         stt: z.ZodObject<{
           runtime: z.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: z.ZodString;
           providerName: z.ZodString;
         }, z.core.$strip>;
         tts: z.ZodObject<{
           runtime: z.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: z.ZodString;
           providerName: z.ZodString;
@@ -3942,16 +3942,16 @@ declare const VoiceNamespace: _$_makaio_core0.BusNamespaceDefinition<"voice", {
       strategy: _$zod.ZodObject<{
         stt: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
         }, _$zod_v4_core0.$strip>;
         tts: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
@@ -3964,16 +3964,16 @@ declare const VoiceNamespace: _$_makaio_core0.BusNamespaceDefinition<"voice", {
       strategy: _$zod.ZodObject<{
         stt: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
         }, _$zod_v4_core0.$strip>;
         tts: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
@@ -4028,16 +4028,16 @@ declare const VoiceSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSub
       strategy: _$zod.ZodObject<{
         stt: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
         }, _$zod_v4_core0.$strip>;
         tts: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
@@ -4050,16 +4050,16 @@ declare const VoiceSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSub
       strategy: _$zod.ZodObject<{
         stt: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
         }, _$zod_v4_core0.$strip>;
         tts: _$zod.ZodObject<{
           runtime: _$zod.ZodEnum<{
-            client: "client";
             server: "server";
+            client: "client";
           }>;
           providerId: _$zod.ZodString;
           providerName: _$zod.ZodString;
@@ -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.
@@ -6727,9 +6781,9 @@ type OutcomeAckDecision = 'accepted' | 'duplicate' | 'conflict' | 'fenced';
  * Zod schema for outcome ACK decisions.
  */
 declare const OutcomeAckDecisionSchema: z.ZodEnum<{
-  fenced: "fenced";
-  duplicate: "duplicate";
   accepted: "accepted";
+  duplicate: "duplicate";
+  fenced: "fenced";
   conflict: "conflict";
 }>;
 /**