@makaio/framework 1.0.0-dev-1784154668798 → 1.0.0-dev-1784706768858

package/dist/{index-Du-AJm69.d.mts → index-0Ju2i8gV.d.mts}

@@ -168,8 +168,8 @@ type ContainerRuntime = z.infer<typeof ContainerRuntimeSchema>;
  * Container state.
  */
 declare const ContainerStateSchema: z.ZodEnum<{
-  created: "created";
   running: "running";
+  created: "created";
   stopped: "stopped";
   destroyed: "destroyed";
 }>;
@@ -381,8 +381,8 @@ type StatusRequest = z.infer<typeof StatusRequestSchema>;
  */
 declare const StatusResponseSchema: z.ZodObject<{
   state: z.ZodEnum<{
-    created: "created";
     running: "running";
+    created: "created";
     stopped: "stopped";
     destroyed: "destroyed";
   }>;
@@ -433,6 +433,13 @@ declare const CONTAINER_BOOTSTRAP_CHANNEL_ENDPOINT = "docker-bootstrap";
  * Canonical Docker namespace.
  */
 declare const DockerNamespace: _$_makaio_core0.BusNamespaceDefinition<"docker", {
+  /**
+   * Spawn a container from one mode-specific public descriptor.
+   *
+   * `container-local` requires `repoPath` and `baseBranch`.
+   * `container-isolated` requires `repoUrl` and `busMode`. Fields belonging
+   * only to the other mode are rejected by the strict discriminated union.
+   */
   'container.spawn': {
     request: z.ZodDiscriminatedUnion<[z.ZodObject<{
       sessionId: z.ZodString;
@@ -587,8 +594,8 @@ declare const DockerNamespace: _$_makaio_core0.BusNamespaceDefinition<"docker",
     }, z.core.$strip>;
     response: z.ZodObject<{
       state: z.ZodEnum<{
-        created: "created";
         running: "running";
+        created: "created";
         stopped: "stopped";
         destroyed: "destroyed";
       }>;
@@ -620,6 +627,13 @@ declare const DockerNamespace: _$_makaio_core0.BusNamespaceDefinition<"docker",
  * Typed Docker subjects.
  */
 declare const DockerSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"docker", {
+  /**
+   * Spawn a container from one mode-specific public descriptor.
+   *
+   * `container-local` requires `repoPath` and `baseBranch`.
+   * `container-isolated` requires `repoUrl` and `busMode`. Fields belonging
+   * only to the other mode are rejected by the strict discriminated union.
+   */
   'container.spawn': {
     request: z.ZodDiscriminatedUnion<[z.ZodObject<{
       sessionId: z.ZodString;
@@ -774,8 +788,8 @@ declare const DockerSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
     }, z.core.$strip>;
     response: z.ZodObject<{
       state: z.ZodEnum<{
-        created: "created";
         running: "running";
+        created: "created";
         stopped: "stopped";
         destroyed: "destroyed";
       }>;
@@ -959,8 +973,8 @@ declare const ContainerSpawnNamespace: _$_makaio_core0.BusNamespaceDefinition<"d
     }, _$zod_v4_core0.$strip>;
     response: _$zod.ZodObject<{
       state: _$zod.ZodEnum<{
-        created: "created";
         running: "running";
+        created: "created";
         stopped: "stopped";
         destroyed: "destroyed";
       }>;
@@ -1142,8 +1156,8 @@ declare const ContainerSpawnSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core
     }, _$zod_v4_core0.$strip>;
     response: _$zod.ZodObject<{
       state: _$zod.ZodEnum<{
-        created: "created";
         running: "running";
+        created: "created";
         stopped: "stopped";
         destroyed: "destroyed";
       }>;

package/dist/{index-DD9inq5h.d.mts → index-4NQLoI7R.d.mts}

@@ -41,9 +41,9 @@ declare const StructuredOutputValidationErrorSchema: z.ZodObject<{
  * - `enforced` – A structured-output enforcement handler produced conformant output.
  */
 declare const StructuredOutputValidationStatusSchema: z.ZodEnum<{
+  failed: "failed";
   passed: "passed";
   enforced: "enforced";
-  failed: "failed";
 }>;
 /**
  * Full validation result emitted after a turn completes when a

package/dist/{index-DAVLhzkq.d.mts → index-8fJ6dkzR.d.mts}

@@ -714,11 +714,12 @@ type AgentDispatchOutcome = {
  * @param turnManager - Required ledger owner for direct terminal outcomes
  * @param sessionContext - Optional shared session context forwarded to all agents
  * @param responseSchema - Optional structured output descriptor for the turn
+ * @param assertDispatch - Optional synchronous authority check at the provider-dispatch linearization point
  * @returns Durable dispatch outcomes after direct routing failures terminalize.
  */
 declare function routeToAgentsCore(bus: IMakaioBus, session: IMakaioSession, agents: ReadonlyArray<{
   agentId: string;
   adapterId: string;
-}>, message: MessageInput, messageId: string, turn: Turn$1, deliveryMode: 'enqueue' | 'immediate' | undefined, onTurnComplete: TurnCompleteCallback, turnManager: TurnCompletionRecorder, sessionContext?: SessionContext, responseSchema?: ResponseSchemaDescriptor): Promise<readonly AgentDispatchOutcome[]>;
+}>, message: MessageInput, messageId: string, turn: Turn$1, deliveryMode: 'enqueue' | 'immediate' | undefined, onTurnComplete: TurnCompleteCallback, turnManager: TurnCompletionRecorder, sessionContext?: SessionContext, responseSchema?: ResponseSchemaDescriptor, assertDispatch?: () => void): Promise<readonly AgentDispatchOutcome[]>;
 //#endregion
 export { registerCompressHandler as a, SessionTurnManager as c, TurnContext as d, TurnPairStateChange as f, registerForkHandler as i, Turn$1 as l, TurnResult as m, routeToAgents as n, registerAttachHandler as o, TurnPairTerminalOutcome as p, registerMergeHandler as r, registerAbandonHandler as s, routeToAgentsCore as t, TurnConfig as u };

package/dist/{index-BdsuBxEz.d.mts → index-BHQXXd-O.d.mts}

@@ -146,7 +146,6 @@ declare const HarnessDefinitionCreateSchema: z.ZodObject<{
     enabled: z.ZodArray<z.ZodString>;
     disabled: z.ZodArray<z.ZodString>;
   }, z.core.$strip>;
-  credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   registryTools: z.ZodObject<{
     enabled: z.ZodArray<z.ZodString>;
     disabled: z.ZodArray<z.ZodString>;
@@ -176,6 +175,7 @@ declare const HarnessDefinitionCreateSchema: z.ZodObject<{
     "always-ask": "always-ask";
     "full-access": "full-access";
   }>>>;
+  credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   approvalPolicy: z.ZodOptional<z.ZodEnum<{
     reject: "reject";
     "always-ask": "always-ask";
@@ -322,7 +322,6 @@ declare const HarnessSchemas: {
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
       }, z.core.$strip>;
-      credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       registryTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
@@ -352,6 +351,7 @@ declare const HarnessSchemas: {
         "always-ask": "always-ask";
         "full-access": "full-access";
       }>>>;
+      credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       approvalPolicy: z.ZodOptional<z.ZodEnum<{
         reject: "reject";
         "always-ask": "always-ask";
@@ -765,7 +765,6 @@ declare const HarnessNamespace: _$_makaio_core0.BusNamespaceDefinition<"harness"
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
       }, z.core.$strip>;
-      credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       registryTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
@@ -795,6 +794,7 @@ declare const HarnessNamespace: _$_makaio_core0.BusNamespaceDefinition<"harness"
         "always-ask": "always-ask";
         "full-access": "full-access";
       }>>>;
+      credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       approvalPolicy: z.ZodOptional<z.ZodEnum<{
         reject: "reject";
         "always-ask": "always-ask";
@@ -1208,7 +1208,6 @@ declare const HarnessSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatS
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
       }, z.core.$strip>;
-      credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       registryTools: z.ZodObject<{
         enabled: z.ZodArray<z.ZodString>;
         disabled: z.ZodArray<z.ZodString>;
@@ -1238,6 +1237,7 @@ declare const HarnessSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatS
         "always-ask": "always-ask";
         "full-access": "full-access";
       }>>>;
+      credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       approvalPolicy: z.ZodOptional<z.ZodEnum<{
         reject: "reject";
         "always-ask": "always-ask";

package/dist/{index-ZGPSCZdC.d.mts → index-BKeJ-Act.d.mts}

@@ -1,13 +1,13 @@
-import { H as ArtifactLifecycleHookEvent, N as AnyArtifactKindDefinition, U as ArtifactLifecycleHookRegistration$1 } from "./index-DoJRv-c3.mjs";
-import { s as AdapterProviderAuth$1 } from "./adapter-binding-DQ1HrGcH.mjs";
-import { A as VersionRange, O as VersionLiteral$1, r as ClientDefinition$1 } from "./definition-ClKlXenJ.mjs";
-import { c as ProviderDefinitionInput$1, r as ProtocolId$1 } from "./definition-BZrouYAq.mjs";
-import { t as RequiredTimeoutConfig } from "./index-BOlzcjwS.mjs";
-import { H as SessionMessage$1, b as SESSION_EVENT_TYPES, i as MakaioSessionEvent$1 } from "./types-DiZJnwN0.mjs";
-import { D as EntityUIConfig$1, I as FormFieldProps } from "./index-DD9inq5h.mjs";
-import { n as ExtensionTransitionRulesContribution, t as ExtensionTransitionActionsContribution, y as WorkflowBlockCollection$1 } from "./transition-CukPcOG5.mjs";
-import { l as FacetNamespaceDefinition } from "./index-DE29b4QM.mjs";
-import { p as ExtensionArtifactViewBuildersContribution, z as SurfaceBindingDefinition } from "./view-builder-DQiA4wDH.mjs";
+import { H as ArtifactLifecycleHookEvent, N as AnyArtifactKindDefinition, U as ArtifactLifecycleHookRegistration$1 } from "./index-CFqShlHD.mjs";
+import { s as AdapterProviderAuth$1 } from "./adapter-binding-Dfk_g-lP.mjs";
+import { E as ClientDefinition$1, Q as VersionLiteral$1, et as VersionRange, f as ExtensionClientHookResponsesContribution } from "./hook-responses-mmqRa2Dq.mjs";
+import { c as ProviderDefinitionInput$1, r as ProtocolId$1 } from "./definition-BEvV7tbD.mjs";
+import { t as RequiredTimeoutConfig } from "./index-pgYFJ5h6.mjs";
+import { H as SessionMessage$1, b as SESSION_EVENT_TYPES, i as MakaioSessionEvent$1 } from "./types-CtSkJqzV.mjs";
+import { D as EntityUIConfig$1, I as FormFieldProps } from "./index-4NQLoI7R.mjs";
+import { n as ExtensionTransitionRulesContribution, t as ExtensionTransitionActionsContribution, y as WorkflowBlockCollection$1 } from "./transition-BMYk_IVK.mjs";
+import { l as FacetNamespaceDefinition } from "./index-CzKLLQLw.mjs";
+import { G as SurfaceBindingDefinition, p as ExtensionArtifactViewBuildersContribution } from "./view-builder-CpKzgyS2.mjs";
 import { z } from "zod";
 import { MakaioBusLike, PayloadFilter, RegistrableBusNamespaceDefinition, SubjectSchema } from "@makaio/framework/core";
 import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
@@ -3636,6 +3636,20 @@ interface MakaioExtension$1<THostContext extends ExtensionContext$1 = NodeExtens
    * is discovery metadata only.
    */
   readonly clients?: readonly ClientDefinition$1[];
+  /**
+   * Client hook response contribution surface for this extension.
+   *
+   * When present, the runtime calls `createContributors(ctx)` once during
+   * extension activation and validates the returned contributor definitions
+   * against the active provider contract catalog before installing them in
+   * the hook response pipeline.
+   *
+   * Contributors declared here respond to client hook events with canonical
+   * effects (e.g. `context.append`) or provider-specific contribution
+   * envelopes. Descriptor metadata is discovery-only; executable callbacks
+   * are not serialized.
+   */
+  readonly clientHookResponses?: ExtensionClientHookResponsesContribution;
   /**
    * Provider definitions contributed by this extension.
    *

package/dist/{index-BPBSMsc8.d.mts → index-BWvTZJxe.d.mts}

@@ -1,4 +1,4 @@
-import { i as ClientDefinitionInput, r as ClientDefinition } from "./definition-ClKlXenJ.mjs";
+import { D as ClientDefinitionInput, E as ClientDefinition } from "./hook-responses-mmqRa2Dq.mjs";
 import * as _$zod from "zod";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
@@ -17,8 +17,8 @@ declare const ClientExecutionContextSchema: z.ZodObject<{
   env: z.ZodRecord<z.ZodString, z.ZodString>;
   configDir: z.ZodNullable<z.ZodString>;
   source: z.ZodEnum<{
-    managed: "managed";
     global: "global";
+    managed: "managed";
   }>;
   version: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -39,8 +39,8 @@ declare const ClientResolveBinarySchema: {
     sessionId: z.ZodOptional<z.ZodString>;
     projectDir: z.ZodOptional<z.ZodString>;
     preferSource: z.ZodOptional<z.ZodEnum<{
-      managed: "managed";
       global: "global";
+      managed: "managed";
     }>>;
     harnessId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
@@ -49,8 +49,8 @@ declare const ClientResolveBinarySchema: {
     env: z.ZodRecord<z.ZodString, z.ZodString>;
     configDir: z.ZodNullable<z.ZodString>;
     source: z.ZodEnum<{
-      managed: "managed";
       global: "global";
+      managed: "managed";
     }>;
     version: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
@@ -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";
     }>>;
@@ -648,8 +648,8 @@ declare const ClientSchemas: {
       "signed-binary-bucket": "signed-binary-bucket";
     }>;
     stage: z.ZodEnum<{
-      resolving: "resolving";
       downloading: "downloading";
+      resolving: "resolving";
       verifying: "verifying";
       extracting: "extracting";
       installing: "installing";
@@ -698,8 +698,8 @@ declare const ClientSchemas: {
       sessionId: z.ZodOptional<z.ZodString>;
       projectDir: z.ZodOptional<z.ZodString>;
       preferSource: z.ZodOptional<z.ZodEnum<{
-        managed: "managed";
         global: "global";
+        managed: "managed";
       }>>;
       harnessId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
@@ -708,8 +708,8 @@ declare const ClientSchemas: {
       env: z.ZodRecord<z.ZodString, z.ZodString>;
       configDir: z.ZodNullable<z.ZodString>;
       source: z.ZodEnum<{
-        managed: "managed";
         global: "global";
+        managed: "managed";
       }>;
       version: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
@@ -1159,8 +1159,8 @@ type ClientSetActiveResponse = z.infer<typeof ClientSetActiveSchema.response>;
  * - `'activating'`   — marking the installed version as active.
  */
 declare const InstallStageSchema: z.ZodEnum<{
-  resolving: "resolving";
   downloading: "downloading";
+  resolving: "resolving";
   verifying: "verifying";
   extracting: "extracting";
   installing: "installing";
@@ -1183,8 +1183,8 @@ declare const ClientInstallProgressSchema: z.ZodObject<{
     "signed-binary-bucket": "signed-binary-bucket";
   }>;
   stage: z.ZodEnum<{
-    resolving: "resolving";
     downloading: "downloading";
+    resolving: "resolving";
     verifying: "verifying";
     extracting: "extracting";
     installing: "installing";
@@ -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";
     }>>;
@@ -2218,8 +2218,8 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
       "signed-binary-bucket": "signed-binary-bucket";
     }>;
     stage: _$zod.ZodEnum<{
-      resolving: "resolving";
       downloading: "downloading";
+      resolving: "resolving";
       verifying: "verifying";
       extracting: "extracting";
       installing: "installing";
@@ -2268,8 +2268,8 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
       sessionId: _$zod.ZodOptional<_$zod.ZodString>;
       projectDir: _$zod.ZodOptional<_$zod.ZodString>;
       preferSource: _$zod.ZodOptional<_$zod.ZodEnum<{
-        managed: "managed";
         global: "global";
+        managed: "managed";
       }>>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;
@@ -2278,8 +2278,8 @@ declare const ClientNamespace: _$_makaio_core0.BusNamespaceDefinition<"client",
       env: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>;
       configDir: _$zod.ZodNullable<_$zod.ZodString>;
       source: _$zod.ZodEnum<{
-        managed: "managed";
         global: "global";
+        managed: "managed";
       }>;
       version: _$zod.ZodNullable<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;
@@ -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";
     }>>;
@@ -2858,8 +2858,8 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
       "signed-binary-bucket": "signed-binary-bucket";
     }>;
     stage: _$zod.ZodEnum<{
-      resolving: "resolving";
       downloading: "downloading";
+      resolving: "resolving";
       verifying: "verifying";
       extracting: "extracting";
       installing: "installing";
@@ -2908,8 +2908,8 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
       sessionId: _$zod.ZodOptional<_$zod.ZodString>;
       projectDir: _$zod.ZodOptional<_$zod.ZodString>;
       preferSource: _$zod.ZodOptional<_$zod.ZodEnum<{
-        managed: "managed";
         global: "global";
+        managed: "managed";
       }>>;
       harnessId: _$zod.ZodOptional<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;
@@ -2918,8 +2918,8 @@ declare const ClientSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSu
       env: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>;
       configDir: _$zod.ZodNullable<_$zod.ZodString>;
       source: _$zod.ZodEnum<{
-        managed: "managed";
         global: "global";
+        managed: "managed";
       }>;
       version: _$zod.ZodNullable<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;