@makaio/framework 1.0.0-dev-1785407933303 → 1.0.0-dev-1786014320559

package/dist/{index-HsTxm-R3.d.mts → index-3eUIRy7T.d.mts}

@@ -19,6 +19,7 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
   startAgent: {
     request: _$zod.ZodUnion<readonly [_$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -323,6 +324,7 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -591,6 +593,7 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
       targetWorkingDirectory: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -895,6 +898,7 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -1160,6 +1164,7 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
       adapterSessionId: _$zod.ZodString;
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -1464,6 +1469,7 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -1737,6 +1743,10 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       success: _$zod.ZodLiteral<false>;
       message: _$zod.ZodString;
+      dispatch: _$zod.ZodEnum<{
+        "not-dispatched": "not-dispatched";
+        "dispatch-uncertain": "dispatch-uncertain";
+      }>;
     }, _$zod_v4_core0.$strip>], "success">;
   };
   infer: {
@@ -1867,6 +1877,14 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
     }, _$zod_v4_core0.$strip>;
     response: _$zod.ZodObject<{
       success: _$zod.ZodBoolean;
+      evidence: _$zod.ZodEnum<{
+        unknown: "unknown";
+        closed: "closed";
+        exited: "exited";
+        released: "released";
+        detached: "detached";
+      }>;
+      detail: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;
   };
   rehydrateAgent: {
@@ -1875,10 +1893,17 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
       agentId: _$zod.ZodString;
       cwd: _$zod.ZodOptional<_$zod.ZodString>;
       model: _$zod.ZodOptional<_$zod.ZodString>;
-      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
       resumeAdapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      callerOwnsAgentRow: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
     }, _$zod_v4_core0.$strip>;
-    response: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+      success: _$zod.ZodLiteral<true>;
+      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+      success: _$zod.ZodLiteral<false>;
+      message: _$zod.ZodString;
+      dispatch: _$zod.ZodLiteral<"not-dispatched">;
+    }, _$zod_v4_core0.$strip>], "success">;
   };
   getConfigSchema: {
     request: _$zod.ZodObject<{
@@ -1955,9 +1980,9 @@ declare const AdapterNamespace: _$_makaio_core0.BusNamespaceDefinition<"adapter"
     timestamp: _$zod.ZodNumber;
     level: _$zod.ZodOptional<_$zod.ZodEnum<{
       error: "error";
+      warn: "warn";
       debug: "debug";
       info: "info";
-      warn: "warn";
     }>>;
   }, _$zod_v4_core0.$strip>;
   error: _$zod.ZodObject<{
@@ -2003,6 +2028,7 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
   startAgent: {
     request: _$zod.ZodUnion<readonly [_$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -2307,6 +2333,7 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -2575,6 +2602,7 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
       targetWorkingDirectory: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -2879,6 +2907,7 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -3144,6 +3173,7 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
       adapterSessionId: _$zod.ZodString;
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -3448,6 +3478,7 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -3721,6 +3752,10 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       success: _$zod.ZodLiteral<false>;
       message: _$zod.ZodString;
+      dispatch: _$zod.ZodEnum<{
+        "not-dispatched": "not-dispatched";
+        "dispatch-uncertain": "dispatch-uncertain";
+      }>;
     }, _$zod_v4_core0.$strip>], "success">;
   };
   infer: {
@@ -3851,6 +3886,14 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
     }, _$zod_v4_core0.$strip>;
     response: _$zod.ZodObject<{
       success: _$zod.ZodBoolean;
+      evidence: _$zod.ZodEnum<{
+        unknown: "unknown";
+        closed: "closed";
+        exited: "exited";
+        released: "released";
+        detached: "detached";
+      }>;
+      detail: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;
   };
   rehydrateAgent: {
@@ -3859,10 +3902,17 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
       agentId: _$zod.ZodString;
       cwd: _$zod.ZodOptional<_$zod.ZodString>;
       model: _$zod.ZodOptional<_$zod.ZodString>;
-      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
       resumeAdapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      callerOwnsAgentRow: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
     }, _$zod_v4_core0.$strip>;
-    response: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+      success: _$zod.ZodLiteral<true>;
+      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+      success: _$zod.ZodLiteral<false>;
+      message: _$zod.ZodString;
+      dispatch: _$zod.ZodLiteral<"not-dispatched">;
+    }, _$zod_v4_core0.$strip>], "success">;
   };
   getConfigSchema: {
     request: _$zod.ZodObject<{
@@ -3939,9 +3989,9 @@ declare const AdapterSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
     timestamp: _$zod.ZodNumber;
     level: _$zod.ZodOptional<_$zod.ZodEnum<{
       error: "error";
+      warn: "warn";
       debug: "debug";
       info: "info";
-      warn: "warn";
     }>>;
   }, _$zod_v4_core0.$strip>;
   error: _$zod.ZodObject<{
@@ -4011,6 +4061,7 @@ declare const AdapterSchemas: {
   startAgent: {
     request: _$zod.ZodUnion<readonly [_$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -4315,6 +4366,7 @@ declare const AdapterSchemas: {
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -4583,6 +4635,7 @@ declare const AdapterSchemas: {
       targetWorkingDirectory: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -4887,6 +4940,7 @@ declare const AdapterSchemas: {
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -5152,6 +5206,7 @@ declare const AdapterSchemas: {
       adapterSessionId: _$zod.ZodString;
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       adapterId: _$zod.ZodString;
+      agentId: _$zod.ZodOptional<_$zod.ZodString>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
       clientId: _$zod.ZodOptional<_$zod.ZodString>;
       clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
@@ -5456,6 +5511,7 @@ declare const AdapterSchemas: {
             "native-attempt-failed": "native-attempt-failed";
             "agent-already-started": "agent-already-started";
             "fork-point-unresolvable": "fork-point-unresolvable";
+            "adapter-session-moved": "adapter-session-moved";
           }>;
         }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
           kind: _$zod.ZodLiteral<"foreign">;
@@ -5729,6 +5785,10 @@ declare const AdapterSchemas: {
     }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
       success: _$zod.ZodLiteral<false>;
       message: _$zod.ZodString;
+      dispatch: _$zod.ZodEnum<{
+        "not-dispatched": "not-dispatched";
+        "dispatch-uncertain": "dispatch-uncertain";
+      }>;
     }, _$zod_v4_core0.$strip>], "success">;
   };
   infer: {
@@ -5859,6 +5919,14 @@ declare const AdapterSchemas: {
     }, _$zod_v4_core0.$strip>;
     response: _$zod.ZodObject<{
       success: _$zod.ZodBoolean;
+      evidence: _$zod.ZodEnum<{
+        unknown: "unknown";
+        closed: "closed";
+        exited: "exited";
+        released: "released";
+        detached: "detached";
+      }>;
+      detail: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;
   };
   rehydrateAgent: {
@@ -5867,10 +5935,17 @@ declare const AdapterSchemas: {
       agentId: _$zod.ZodString;
       cwd: _$zod.ZodOptional<_$zod.ZodString>;
       model: _$zod.ZodOptional<_$zod.ZodString>;
-      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
       resumeAdapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      callerOwnsAgentRow: _$zod.ZodOptional<_$zod.ZodLiteral<true>>;
     }, _$zod_v4_core0.$strip>;
-    response: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+      success: _$zod.ZodLiteral<true>;
+      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+      success: _$zod.ZodLiteral<false>;
+      message: _$zod.ZodString;
+      dispatch: _$zod.ZodLiteral<"not-dispatched">;
+    }, _$zod_v4_core0.$strip>], "success">;
   };
   getConfigSchema: {
     request: _$zod.ZodObject<{
@@ -5947,9 +6022,9 @@ declare const AdapterSchemas: {
     timestamp: _$zod.ZodNumber;
     level: _$zod.ZodOptional<_$zod.ZodEnum<{
       error: "error";
+      warn: "warn";
       debug: "debug";
       info: "info";
-      warn: "warn";
     }>>;
   }, _$zod_v4_core0.$strip>;
   error: _$zod.ZodObject<{
@@ -6015,6 +6090,29 @@ declare const AdapterRuntimeOptionsSchema: z.ZodObject<{
 type AdapterRuntimeOptions$1 = z.infer<typeof AdapterRuntimeOptionsSchema>;
 //#endregion
 //#region core/contracts/src/adapter/schemas/start-agent.d.ts
+/**
+ * How far a failed start got, as evidence for the caller's cleanup decision.
+ *
+ * A caller that reserved provider-session ownership before dispatching has to
+ * decide between two incompatible cleanups: give the reservation back, or retire
+ * it as possibly-live debris. Only the adapter knows which, and a bare error
+ * message cannot carry it.
+ *
+ * Exactly two members, because a start has exactly two knowable outcomes. A
+ * thrown start carries no disposition at all and callers must treat it as
+ * `'dispatch-uncertain'`: the throw may come from anywhere in provider-context
+ * activation, agent creation or the connector start.
+ *
+ * `adapter.rehydrateAgent` is a second producer of this vocabulary. Its failure
+ * response narrows the field to `'not-dispatched'`, because a rehydrate that
+ * may have reached the provider always leaves by throwing.
+ */
+declare const AdapterStartDispositionSchema: z.ZodEnum<{
+  "not-dispatched": "not-dispatched";
+  "dispatch-uncertain": "dispatch-uncertain";
+}>;
+/** {@inheritDoc AdapterStartDispositionSchema} */
+type AdapterStartDisposition = z.infer<typeof AdapterStartDispositionSchema>;
 /**
  * Start a new agent with full lifecycle control.
  *
@@ -6034,6 +6132,7 @@ type AdapterRuntimeOptions$1 = z.infer<typeof AdapterRuntimeOptionsSchema>;
 declare const StartAgentSchema: {
   request: z.ZodUnion<readonly [z.ZodObject<{
     adapterId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
     harnessId: z.ZodOptional<z.ZodString>;
     clientId: z.ZodOptional<z.ZodString>;
     clientProfileName: z.ZodOptional<z.ZodString>;
@@ -6338,6 +6437,7 @@ declare const StartAgentSchema: {
           "native-attempt-failed": "native-attempt-failed";
           "agent-already-started": "agent-already-started";
           "fork-point-unresolvable": "fork-point-unresolvable";
+          "adapter-session-moved": "adapter-session-moved";
         }>;
       }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"foreign">;
@@ -6606,6 +6706,7 @@ declare const StartAgentSchema: {
     targetWorkingDirectory: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>, z.ZodObject<{
     adapterId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
     harnessId: z.ZodOptional<z.ZodString>;
     clientId: z.ZodOptional<z.ZodString>;
     clientProfileName: z.ZodOptional<z.ZodString>;
@@ -6910,6 +7011,7 @@ declare const StartAgentSchema: {
           "native-attempt-failed": "native-attempt-failed";
           "agent-already-started": "agent-already-started";
           "fork-point-unresolvable": "fork-point-unresolvable";
+          "adapter-session-moved": "adapter-session-moved";
         }>;
       }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"foreign">;
@@ -7175,6 +7277,7 @@ declare const StartAgentSchema: {
     adapterSessionId: z.ZodString;
   }, z.core.$strip>, z.ZodObject<{
     adapterId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
     harnessId: z.ZodOptional<z.ZodString>;
     clientId: z.ZodOptional<z.ZodString>;
     clientProfileName: z.ZodOptional<z.ZodString>;
@@ -7479,6 +7582,7 @@ declare const StartAgentSchema: {
           "native-attempt-failed": "native-attempt-failed";
           "agent-already-started": "agent-already-started";
           "fork-point-unresolvable": "fork-point-unresolvable";
+          "adapter-session-moved": "adapter-session-moved";
         }>;
       }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"foreign">;
@@ -7752,6 +7856,10 @@ declare const StartAgentSchema: {
   }, z.core.$strip>, z.ZodObject<{
     success: z.ZodLiteral<false>;
     message: z.ZodString;
+    dispatch: z.ZodEnum<{
+      "not-dispatched": "not-dispatched";
+      "dispatch-uncertain": "dispatch-uncertain";
+    }>;
   }, z.core.$strip>], "success">;
 };
 type StartAgentRequest = z.infer<typeof StartAgentSchema.request>;
@@ -7772,15 +7880,21 @@ type StartAgentResponse = z.infer<typeof StartAgentSchema.response>;
  * 2. Create a new connector with optional config overrides (cwd, model)
  * 3. Wire the new connector to the existing agent instance
  *
- * Success is implicit. Errors are thrown if:
- * - Agent not found
- * - Adapter not found
- * - Connector swap fails
+ * The response is a disposition union, mirroring `adapter.startAgent`. A refusal
+ * the adapter takes *before* anything reaches the provider — a disposed agent,
+ * or a provider session already claimed by another in-flight operation — is
+ * modelled as `{ success: false, dispatch: 'not-dispatched' }` so a caller that
+ * reserved provider-session ownership can give the reservation back cleanly
+ * instead of retiring it as possibly-live debris. Every other failure still
+ * throws, and a throw is `'dispatch-uncertain'` by construction: it can come
+ * from anywhere in provider-context activation, agent creation or the connector
+ * swap.
  * @param adapterId - Target adapter instance ID
  * @param agentId - Agent to rehydrate
  * @param cwd - Optional working directory override for new connector
  * @param model - Optional model override for new connector
- * @param adapterSessionId - Optional persisted native session ID for resume-capable connectors
+ * @param resumeAdapterSessionId - Optional provider session to natively resume
+ * @param callerOwnsAgentRow - Set when the caller owns the agent row's status transitions
  */
 declare const RehydrateAgentSchema: {
   request: z.ZodObject<{
@@ -7788,14 +7902,122 @@ declare const RehydrateAgentSchema: {
     agentId: z.ZodString;
     cwd: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
-    adapterSessionId: z.ZodOptional<z.ZodString>;
     resumeAdapterSessionId: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>; /** Empty response - success is implicit, errors throw */
-  response: z.ZodObject<{}, z.core.$strip>;
+    callerOwnsAgentRow: z.ZodOptional<z.ZodLiteral<true>>;
+  }, z.core.$strip>;
+  response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    dispatch: z.ZodLiteral<"not-dispatched">;
+  }, z.core.$strip>], "success">;
 };
 type RehydrateAgentRequest = z.infer<typeof RehydrateAgentSchema.request>;
 type RehydrateAgentResponse = z.infer<typeof RehydrateAgentSchema.response>;
 //#endregion
+//#region core/contracts/src/adapter/schemas/teardown.d.ts
+/**
+ * What a runtime observed about the end of a resource it was holding.
+ *
+ * Ordered from strongest to weakest evidence. The distinction that matters to
+ * every consumer is the boundary between the first three and the last two: the
+ * first three mean *nothing of ours is still talking to the provider*, the last
+ * two mean *we stopped holding it and cannot say more*.
+ *
+ * The per-member reasoning:
+ * - `exited` — an operating-system process this runtime spawned has terminated
+ *   and its termination was observed (an `exit`/`close` event, a settled spawn
+ *   promise, a reaped status). The strongest class available anywhere here.
+ * - `closed` — a connection this runtime owned is closed and the close was
+ *   acknowledged by the peer or reported by the OS. The peer process may
+ *   outlive it; what is proven is that *this* runtime can no longer speak on it.
+ * - `released` — an in-process object was released, every handle dropped and
+ *   every subscription cancelled, so no callback can arrive afterwards.
+ *   Provable locally and without a counterparty — which is exactly why it is
+ *   admissible: for a resource with no external end, "no further effects are
+ *   possible" is the whole of what closure means.
+ * - `detached` — the runtime gave up its handle, but something outside it may
+ *   still be running: a process it did not spawn, a server-side session it can
+ *   only *ask* to end, a detached supervisor. **Not** an error.
+ * - `unknown` — the teardown path threw, timed out, or was never reached.
+ *   Nothing is known.
+ */
+declare const TeardownEvidenceSchema: z.ZodEnum<{
+  unknown: "unknown";
+  closed: "closed";
+  exited: "exited";
+  released: "released";
+  detached: "detached";
+}>;
+/** One member of {@link TeardownEvidenceSchema}. */
+type TeardownEvidence$1 = z.infer<typeof TeardownEvidenceSchema>;
+/**
+ * Whether an evidence class proves this runtime has stopped speaking to the
+ * provider.
+ *
+ * The single predicate every consumer branches on, so the boundary is defined
+ * once. `detached` and `unknown` are **not** observed: the first because someone
+ * else may still be speaking, the second because nobody knows.
+ * @param evidence - Class reported by the teardown.
+ * @returns Whether the runtime provably released the provider conversation.
+ */
+declare function teardownWasObserved$1(evidence: TeardownEvidence$1): boolean;
+/**
+ * Result of tearing one connector down.
+ *
+ * Carries the class plus a human-readable `detail` for diagnostics. It is not an
+ * error type: a `detached` or `unknown` teardown is a *reported outcome*, and a
+ * consumer that treats it as a failure will start failing removals whenever an
+ * adapter is slow.
+ */
+declare const ConnectorTeardownResultSchema: z.ZodObject<{
+  evidence: z.ZodEnum<{
+    unknown: "unknown";
+    closed: "closed";
+    exited: "exited";
+    released: "released";
+    detached: "detached";
+  }>;
+  detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** One reported connector teardown. */
+type ConnectorTeardownResult$1 = z.infer<typeof ConnectorTeardownResultSchema>;
+/**
+ * Reduce a set of teardown classes to the one a caller may claim for all of
+ * them.
+ *
+ * **The wave's only aggregation rule**, so every layer that tears down more
+ * than one resource calls this instead of restating it: the reported class is
+ * the **weakest** in the set — `unknown` if any is `unknown`, else `detached` if
+ * any is `detached`, else the weakest of the observed three.
+ *
+ * A teardown of *nothing* reports `released`: there is provably nothing
+ * speaking, and that is the case consumers hit most often — a wrong default
+ * there is invisible.
+ * @param classes - Classes observed by the individual teardowns, in any order.
+ * @returns The weakest class in the set, or `released` for an empty set.
+ */
+declare function aggregateTeardownEvidence$1(classes: Iterable<TeardownEvidence$1>): TeardownEvidence$1;
+/**
+ * Reduce a set of reported teardowns to the one result standing for all of them.
+ *
+ * {@link aggregateTeardownEvidence} answers the class; this answers the whole
+ * *result*, because every layer that aggregates needs the second half too and had
+ * been restating it: the `detail`s of the members that reached no observed class
+ * are joined, so a caller told only `unknown` can still tell **which** of several
+ * resources produced it. Which members those are is not a second list of classes
+ * here — it is {@link teardownWasObserved} negated, so the boundary keeps having
+ * exactly one definition.
+ *
+ * Layers that carry more than the wire fields (a failure to rethrow, a per-resource
+ * breakdown) build on this result rather than beside it.
+ * @param results - Results reported by the individual teardowns, in any order.
+ * @returns The weakest class in the set, carrying the joined weak-class `detail`s.
+ */
+declare function aggregateTeardownResults$1(results: readonly ConnectorTeardownResult$1[]): ConnectorTeardownResult$1;
+//#endregion
 //#region core/contracts/src/adapter/schemas/session-usage.d.ts
 /**
  * Session-level cumulative usage metrics.
@@ -7976,11 +8198,18 @@ type AgentSelectionBase = z.infer<typeof AgentSelectionBaseSchema>;
  * Specifies the adapter driver to use. `adapterName` may be omitted when an
  * `adapterId` is provided for unambiguous multi-host targeting; startup paths
  * backfill the name when the runtime already knows it.
+ *
+ * **Naming an instance means naming its machine, and naming a machine means
+ * naming an instance.** The two are one key: an instance ID cannot be inverted
+ * back to the machine it was derived for, and a machine named on its own is read
+ * by nothing — see {@link AdapterSelectionSchema.machineId}. Either half alone is
+ * refused.
  * @example
  * ```typescript
  * const selection: AdapterSelection = {
  *   kind: 'adapter',
  *   adapterId: 'adapter-123',
+ *   machineId: 'machine-a',
  *   model: 'sonnet',
  * };
  * ```
@@ -8089,8 +8318,9 @@ declare const AdapterSelectionSchema: z.ZodObject<{
   kind: z.ZodLiteral<"adapter">;
   adapterName: z.ZodOptional<z.ZodString>;
   adapterId: z.ZodOptional<z.ZodString>;
+  machineId: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
-type AdapterSelection = z.infer<typeof AdapterSelectionSchema>;
+type AdapterSelection$1 = z.infer<typeof AdapterSelectionSchema>;
 /**
  * Interface map for the `AgentSelection` discriminated union.
  *
@@ -8111,7 +8341,7 @@ type AdapterSelection = z.infer<typeof AdapterSelectionSchema>;
  * registered kinds while keeping the Zod wire schema open (`kind: z.string()`).
  */
 interface AgentSelectionKindMap {
-  adapter: AdapterSelection;
+  adapter: AdapterSelection$1;
 }
 /**
  * Agent configuration selection for `sendMessage` and `agent.attach`.
@@ -8410,4 +8640,4 @@ type UnresolvedProviderContext = z.infer<typeof UnresolvedProviderContextSchema>
 /** Runtime provider context union. */
 type ProviderContext$1 = z.infer<typeof ProviderContextSchema$1>;
 //#endregion
-export { StartAgentSchema as C, AdapterNamespace as D, AdapterSchemas as E, AdapterSubjects$1 as O, StartAgentResponse as S, AdapterRuntimeOptionsSchema as T, SessionUsageSchema as _, UnresolvedProviderContext as a, RehydrateAgentSchema as b, AdapterSelectionSchema as c, AgentSelectionBaseSchema as d, AgentSelectionKindMap as f, SessionUsage as g, SessionDiscoveredSchema$1 as h, ResolvedProviderContextSchema$1 as i, AgentSelection as l, SessionDiscovered as m, ProviderContextSchema$1 as n, UnresolvedProviderContextSchema as o, AgentSelectionSchema as p, ResolvedProviderContext$1 as r, AdapterSelection as s, ProviderContext$1 as t, AgentSelectionBase as u, RehydrateAgentRequest as v, AdapterRuntimeOptions$1 as w, StartAgentRequest as x, RehydrateAgentResponse as y };
+export { StartAgentRequest as A, aggregateTeardownResults$1 as C, RehydrateAgentSchema as D, RehydrateAgentResponse as E, AdapterSchemas as F, AdapterNamespace as I, AdapterSubjects$1 as L, StartAgentSchema as M, AdapterRuntimeOptions$1 as N, AdapterStartDisposition as O, AdapterRuntimeOptionsSchema as P, aggregateTeardownEvidence$1 as S, RehydrateAgentRequest as T, SessionUsageSchema as _, UnresolvedProviderContext as a, TeardownEvidence$1 as b, AdapterSelectionSchema as c, AgentSelectionBaseSchema as d, AgentSelectionKindMap as f, SessionUsage as g, SessionDiscoveredSchema$1 as h, ResolvedProviderContextSchema$1 as i, StartAgentResponse as j, AdapterStartDispositionSchema as k, AgentSelection as l, SessionDiscovered as m, ProviderContextSchema$1 as n, UnresolvedProviderContextSchema as o, AgentSelectionSchema as p, ResolvedProviderContext$1 as r, AdapterSelection$1 as s, ProviderContext$1 as t, AgentSelectionBase as u, ConnectorTeardownResult$1 as v, teardownWasObserved$1 as w, TeardownEvidenceSchema as x, ConnectorTeardownResultSchema as y };

package/dist/{index-brqfk9JQ.d.mts → index-B4xdTT3c.d.mts}

@@ -193,8 +193,8 @@ declare const MaterializationSchemas: {
         template: z.ZodString;
       }, z.core.$strip>], "kind">;
       appliesTo: z.ZodArray<z.ZodEnum<{
-        artifact: "artifact";
         workpiece: "workpiece";
+        artifact: "artifact";
         surface: "surface";
       }>>;
       valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -235,8 +235,8 @@ declare const MaterializationSchemas: {
           template: z.ZodString;
         }, z.core.$strip>], "kind">;
         appliesTo: z.ZodArray<z.ZodEnum<{
-          artifact: "artifact";
           workpiece: "workpiece";
+          artifact: "artifact";
           surface: "surface";
         }>>;
         valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -431,8 +431,8 @@ declare const MaterializationNamespace: _$_makaio_core0.BusNamespaceDefinition<"
         template: z.ZodString;
       }, z.core.$strip>], "kind">;
       appliesTo: z.ZodArray<z.ZodEnum<{
-        artifact: "artifact";
         workpiece: "workpiece";
+        artifact: "artifact";
         surface: "surface";
       }>>;
       valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -473,8 +473,8 @@ declare const MaterializationNamespace: _$_makaio_core0.BusNamespaceDefinition<"
           template: z.ZodString;
         }, z.core.$strip>], "kind">;
         appliesTo: z.ZodArray<z.ZodEnum<{
-          artifact: "artifact";
           workpiece: "workpiece";
+          artifact: "artifact";
           surface: "surface";
         }>>;
         valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -681,8 +681,8 @@ declare const MaterializationSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_c
         template: z.ZodString;
       }, z.core.$strip>], "kind">;
       appliesTo: z.ZodArray<z.ZodEnum<{
-        artifact: "artifact";
         workpiece: "workpiece";
+        artifact: "artifact";
         surface: "surface";
       }>>;
       valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -723,8 +723,8 @@ declare const MaterializationSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_c
           template: z.ZodString;
         }, z.core.$strip>], "kind">;
         appliesTo: z.ZodArray<z.ZodEnum<{
-          artifact: "artifact";
           workpiece: "workpiece";
+          artifact: "artifact";
           surface: "surface";
         }>>;
         valueMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;