@makaio/framework 1.0.0-dev-1781022866275 → 1.0.0-dev-1781023871421

package/dist/index-CGmcS0Ma.d.mts

@@ -0,0 +1,412 @@
+import * as _$zod from "zod";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region core/contracts/src/native-session-supervisor/namespace.d.ts
+/**
+ * Native Session Supervisor namespace definition.
+ *
+ * Defines the global `native-session-supervisor.*` subjects for launching,
+ * attaching to, stopping, and querying supervised native process runtimes.
+ * @packageDocumentation
+ */
+/**
+ * MakaioBus namespace definition under the `native-session-supervisor` prefix.
+ */
+declare const NativeSessionSupervisorNamespace: _$_makaio_core0.BusNamespaceDefinition<"native-session-supervisor", {
+  launch: {
+    request: _$zod.ZodObject<{
+      clientId: _$zod.ZodString;
+      cwd: _$zod.ZodString;
+      command: _$zod.ZodString;
+      args: _$zod.ZodArray<_$zod.ZodString>;
+      env: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+      sessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
+      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      metadata: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+      pid: _$zod.ZodNumber;
+    }, _$zod_v4_core0.$strip>;
+  };
+  attach: {
+    request: _$zod.ZodUnion<readonly [_$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      sessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      adapterSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>]>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+      supervisorSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      pid: _$zod.ZodOptional<_$zod.ZodNumber>;
+      terminalAttachment: _$zod.ZodOptional<_$zod.ZodObject<{
+        canAttach: _$zod.ZodBoolean;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  stop: {
+    request: _$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+      signal: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  status: {
+    request: _$zod.ZodUnion<readonly [_$zod.ZodObject<{}, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      sessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      adapterSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>]>;
+    response: _$zod.ZodObject<{
+      runtimes: _$zod.ZodArray<_$zod.ZodObject<{
+        supervisorSessionId: _$zod.ZodString;
+        clientId: _$zod.ZodString;
+        pid: _$zod.ZodNullable<_$zod.ZodNumber>;
+        status: _$zod.ZodEnum<{
+          unknown: "unknown";
+          running: "running";
+          stopped: "stopped";
+          exited: "exited";
+        }>;
+        cwd: _$zod.ZodString;
+        sessionId: _$zod.ZodOptional<_$zod.ZodString>;
+        adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+        startedAt: _$zod.ZodNumber;
+        stoppedAt: _$zod.ZodOptional<_$zod.ZodNumber>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+}>;
+/**
+ * Typed bus subjects for the native-session-supervisor namespace.
+ * @example
+ * ```typescript
+ * // Launch a new supervised runtime
+ * bus.emit(NativeSessionSupervisorSubjects.launch, {
+ *   clientId: 'claude-code',
+ *   cwd: '/home/user/project',
+ *   command: 'claude',
+ *   args: [],
+ * });
+ *
+ * // Query all running runtimes
+ * bus.emit(NativeSessionSupervisorSubjects.status, {});
+ * ```
+ */
+declare const NativeSessionSupervisorSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"native-session-supervisor", {
+  launch: {
+    request: _$zod.ZodObject<{
+      clientId: _$zod.ZodString;
+      cwd: _$zod.ZodString;
+      command: _$zod.ZodString;
+      args: _$zod.ZodArray<_$zod.ZodString>;
+      env: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+      sessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      clientProfileName: _$zod.ZodOptional<_$zod.ZodString>;
+      adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      metadata: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+      pid: _$zod.ZodNumber;
+    }, _$zod_v4_core0.$strip>;
+  };
+  attach: {
+    request: _$zod.ZodUnion<readonly [_$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      sessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      adapterSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>]>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+      supervisorSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+      pid: _$zod.ZodOptional<_$zod.ZodNumber>;
+      terminalAttachment: _$zod.ZodOptional<_$zod.ZodObject<{
+        canAttach: _$zod.ZodBoolean;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  stop: {
+    request: _$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+      signal: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  status: {
+    request: _$zod.ZodUnion<readonly [_$zod.ZodObject<{}, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      supervisorSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      sessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
+      adapterSessionId: _$zod.ZodString;
+    }, _$zod_v4_core0.$strict>]>;
+    response: _$zod.ZodObject<{
+      runtimes: _$zod.ZodArray<_$zod.ZodObject<{
+        supervisorSessionId: _$zod.ZodString;
+        clientId: _$zod.ZodString;
+        pid: _$zod.ZodNullable<_$zod.ZodNumber>;
+        status: _$zod.ZodEnum<{
+          unknown: "unknown";
+          running: "running";
+          stopped: "stopped";
+          exited: "exited";
+        }>;
+        cwd: _$zod.ZodString;
+        sessionId: _$zod.ZodOptional<_$zod.ZodString>;
+        adapterSessionId: _$zod.ZodOptional<_$zod.ZodString>;
+        startedAt: _$zod.ZodNumber;
+        stoppedAt: _$zod.ZodOptional<_$zod.ZodNumber>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+}>, "native-session-supervisor">;
+//#endregion
+//#region core/contracts/src/native-session-supervisor/schemas.d.ts
+/**
+ * Lifecycle status of a supervised runtime process.
+ *
+ * - `'running'`  — the process is currently active.
+ * - `'stopped'`  — the process was explicitly stopped via a `stop` request.
+ * - `'exited'`   — the process exited on its own (zero or non-zero exit code).
+ * - `'unknown'`  — the supervisor has no current status information.
+ */
+declare const SupervisorSessionStatusSchema: z.ZodEnum<{
+  unknown: "unknown";
+  running: "running";
+  stopped: "stopped";
+  exited: "exited";
+}>;
+type SupervisorSessionStatus = z.infer<typeof SupervisorSessionStatusSchema>;
+/**
+ * Request and response schemas for `native-session-supervisor.launch`.
+ *
+ * Launches a new supervised native process and returns a stable supervisor
+ * session ID together with the OS process ID of the spawned process.
+ *
+ * Subject: `native-session-supervisor.launch`
+ * Type: Request (RPC)
+ */
+declare const NativeSupervisorLaunchSchema: {
+  request: z.ZodObject<{
+    clientId: z.ZodString;
+    cwd: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodArray<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    clientProfileName: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>;
+  response: z.ZodObject<{
+    supervisorSessionId: z.ZodString;
+    pid: z.ZodNumber;
+  }, z.core.$strip>;
+};
+type NativeSupervisorLaunchRequest = z.infer<typeof NativeSupervisorLaunchSchema.request>;
+type NativeSupervisorLaunchResponse = z.infer<typeof NativeSupervisorLaunchSchema.response>;
+/**
+ * Request and response schemas for `native-session-supervisor.attach`.
+ *
+ * Requests attachment to an already-supervised runtime, identified by one of
+ * the three available locators.
+ *
+ * Subject: `native-session-supervisor.attach`
+ * Type: Request (RPC)
+ */
+declare const NativeSupervisorAttachSchema: {
+  request: z.ZodUnion<readonly [z.ZodObject<{
+    supervisorSessionId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    sessionId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    adapterSessionId: z.ZodString;
+  }, z.core.$strict>]>;
+  response: z.ZodObject<{
+    success: z.ZodBoolean;
+    supervisorSessionId: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    terminalAttachment: z.ZodOptional<z.ZodObject<{
+      canAttach: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+};
+type NativeSupervisorAttachRequest = z.infer<typeof NativeSupervisorAttachSchema.request>;
+type NativeSupervisorAttachResponse = z.infer<typeof NativeSupervisorAttachSchema.response>;
+/**
+ * Request and response schemas for `native-session-supervisor.stop`.
+ *
+ * Stops a supervised runtime process identified by its supervisor session ID.
+ *
+ * Subject: `native-session-supervisor.stop`
+ * Type: Request (RPC)
+ */
+declare const NativeSupervisorStopSchema: {
+  request: z.ZodObject<{
+    supervisorSessionId: z.ZodString;
+    signal: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  response: z.ZodObject<{
+    success: z.ZodBoolean;
+  }, z.core.$strip>;
+};
+type NativeSupervisorStopRequest = z.infer<typeof NativeSupervisorStopSchema.request>;
+type NativeSupervisorStopResponse = z.infer<typeof NativeSupervisorStopSchema.response>;
+/**
+ * A snapshot of a single supervised runtime returned by the status query.
+ */
+declare const SupervisorRuntimeSnapshotSchema: z.ZodObject<{
+  supervisorSessionId: z.ZodString;
+  clientId: z.ZodString;
+  pid: z.ZodNullable<z.ZodNumber>;
+  status: z.ZodEnum<{
+    unknown: "unknown";
+    running: "running";
+    stopped: "stopped";
+    exited: "exited";
+  }>;
+  cwd: z.ZodString;
+  sessionId: z.ZodOptional<z.ZodString>;
+  adapterSessionId: z.ZodOptional<z.ZodString>;
+  startedAt: z.ZodNumber;
+  stoppedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type SupervisorRuntimeSnapshot = z.infer<typeof SupervisorRuntimeSnapshotSchema>;
+/**
+ * Request and response schemas for `native-session-supervisor.status`.
+ *
+ * Queries status for one or all supervised runtimes.
+ *
+ * The request accepts exactly zero or one locator field:
+ * - No locator — returns all known runtimes.
+ * - One locator — returns the single runtime matching that field.
+ *
+ * Providing more than one locator is rejected by the schema so that callers
+ * cannot rely on an undocumented priority ordering between fields.
+ *
+ * Subject: `native-session-supervisor.status`
+ * Type: Request (RPC)
+ */
+declare const NativeSupervisorStatusSchema: {
+  request: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+    supervisorSessionId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    sessionId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    adapterSessionId: z.ZodString;
+  }, z.core.$strict>]>;
+  response: z.ZodObject<{
+    runtimes: z.ZodArray<z.ZodObject<{
+      supervisorSessionId: z.ZodString;
+      clientId: z.ZodString;
+      pid: z.ZodNullable<z.ZodNumber>;
+      status: z.ZodEnum<{
+        unknown: "unknown";
+        running: "running";
+        stopped: "stopped";
+        exited: "exited";
+      }>;
+      cwd: z.ZodString;
+      sessionId: z.ZodOptional<z.ZodString>;
+      adapterSessionId: z.ZodOptional<z.ZodString>;
+      startedAt: z.ZodNumber;
+      stoppedAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+};
+type NativeSupervisorStatusRequest = z.infer<typeof NativeSupervisorStatusSchema.request>;
+type NativeSupervisorStatusResponse = z.infer<typeof NativeSupervisorStatusSchema.response>;
+/**
+ * Native Session Supervisor namespace schemas.
+ *
+ * Maps dot-notation subject keys to their request/response schemas.
+ * Each key is prefixed with `native-session-supervisor.` on the bus.
+ */
+declare const NativeSessionSupervisorSchemas: {
+  launch: {
+    request: z.ZodObject<{
+      clientId: z.ZodString;
+      cwd: z.ZodString;
+      command: z.ZodString;
+      args: z.ZodArray<z.ZodString>;
+      env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+      sessionId: z.ZodOptional<z.ZodString>;
+      clientProfileName: z.ZodOptional<z.ZodString>;
+      adapterSessionId: z.ZodOptional<z.ZodString>;
+      metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      supervisorSessionId: z.ZodString;
+      pid: z.ZodNumber;
+    }, z.core.$strip>;
+  };
+  attach: {
+    request: z.ZodUnion<readonly [z.ZodObject<{
+      supervisorSessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+      sessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+      adapterSessionId: z.ZodString;
+    }, z.core.$strict>]>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+      supervisorSessionId: z.ZodOptional<z.ZodString>;
+      pid: z.ZodOptional<z.ZodNumber>;
+      terminalAttachment: z.ZodOptional<z.ZodObject<{
+        canAttach: z.ZodBoolean;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  stop: {
+    request: z.ZodObject<{
+      supervisorSessionId: z.ZodString;
+      signal: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  status: {
+    request: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+      supervisorSessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+      sessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+      adapterSessionId: z.ZodString;
+    }, z.core.$strict>]>;
+    response: z.ZodObject<{
+      runtimes: z.ZodArray<z.ZodObject<{
+        supervisorSessionId: z.ZodString;
+        clientId: z.ZodString;
+        pid: z.ZodNullable<z.ZodNumber>;
+        status: z.ZodEnum<{
+          unknown: "unknown";
+          running: "running";
+          stopped: "stopped";
+          exited: "exited";
+        }>;
+        cwd: z.ZodString;
+        sessionId: z.ZodOptional<z.ZodString>;
+        adapterSessionId: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodNumber;
+        stoppedAt: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+};
+//#endregion
+export { SupervisorSessionStatusSchema as _, NativeSupervisorLaunchRequest as a, NativeSupervisorStatusRequest as c, NativeSupervisorStopRequest as d, NativeSupervisorStopResponse as f, SupervisorSessionStatus as g, SupervisorRuntimeSnapshotSchema as h, NativeSupervisorAttachSchema as i, NativeSupervisorStatusResponse as l, SupervisorRuntimeSnapshot as m, NativeSupervisorAttachRequest as n, NativeSupervisorLaunchResponse as o, NativeSupervisorStopSchema as p, NativeSupervisorAttachResponse as r, NativeSupervisorLaunchSchema as s, NativeSessionSupervisorSchemas as t, NativeSupervisorStatusSchema as u, NativeSessionSupervisorNamespace as v, NativeSessionSupervisorSubjects as y };

package/dist/index-CHQ1SqT0.d.mts

@@ -0,0 +1,117 @@
+import { IMakaioBus } from "@makaio/framework/bus";
+
+//#region packages/kernel/src/providers/storage.d.ts
+/**
+ * Cleanup handle returned by storage registration.
+ */
+interface StorageCleanup {
+  /** Unregister all storage handlers from the bus. */
+  cleanup: () => void;
+  /** Database handle, if this provider uses a database (e.g., Drizzle). */
+  db?: unknown;
+}
+/**
+ * Platform-specific storage backend.
+ * Registers bus handlers that respond to storage namespace subjects.
+ */
+interface StorageProvider {
+  /**
+   * Register storage handlers on the bus.
+   * Called before app.start() in the composition root.
+   * @param bus - Bus instance to register handlers on
+   * @param machineId - Machine identifier for storage scoping
+   */
+  registerHandlers(bus: IMakaioBus, machineId: string): Promise<StorageCleanup>;
+  /** Release storage resources (close DB connections, etc.). */
+  dispose(): Promise<void>;
+}
+//#endregion
+//#region packages/kernel/src/providers/transport.d.ts
+/**
+ * Platform-specific bus transport (WebSocket server, client, none).
+ */
+interface TransportProvider {
+  /**
+   * Attach transport to the bus.
+   *
+   * For server transports, the HTTP server and Hono app are passed via
+   * constructor options — the provider only wires the WebSocket upgrade
+   * handler onto them.
+   * @param bus - Bus instance to attach transport to.
+   * @param machineId - Machine identifier for transport identification.
+   */
+  connect(bus: IMakaioBus, machineId: string): Promise<void>;
+  /** Disconnect and release transport resources. */
+  disconnect(): Promise<void>;
+}
+//#endregion
+//#region packages/kernel/src/providers/identity.d.ts
+/**
+ * Machine identity resolved by the platform.
+ */
+interface MachineIdentity {
+  /** Unique machine identifier. */
+  readonly machineId: string;
+}
+/**
+ * Platform-specific machine identity resolution.
+ * Node: persisted in ~/.makaio/keys/
+ * Container/Framework: ephemeral crypto.randomUUID()
+ */
+interface IdentityProvider {
+  /** Load or generate the machine identity. */
+  load(): Promise<MachineIdentity>;
+}
+//#endregion
+//#region packages/kernel/src/providers/memory-storage.d.ts
+/**
+ * No-op storage provider.
+ *
+ * Satisfies the {@link StorageProvider} interface when no platform-specific storage
+ * (e.g., Drizzle) is needed.
+ */
+declare class MemoryStorageProvider implements StorageProvider {
+  /**
+   * Returns a no-op cleanup handle.
+   *
+   * In-memory bus handler registration is performed by individual service
+   * storage factories before service construction.
+   * @param _bus - Unused bus instance
+   * @param _machineId - Unused machine identifier
+   * @returns A no-op cleanup handle
+   */
+  registerHandlers(_bus: IMakaioBus, _machineId: string): Promise<StorageCleanup>;
+  /** Nothing to dispose for in-memory storage. */
+  dispose(): Promise<void>;
+}
+//#endregion
+//#region packages/kernel/src/providers/no-transport.d.ts
+/**
+ * No-op transport provider for in-process-only bus usage.
+ * Used by framework users who don't need cross-process communication.
+ */
+declare class NoTransportProvider implements TransportProvider {
+  /**
+   * No-op — no transport to connect.
+   * @param _bus - Unused bus instance.
+   * @param _machineId - Unused machine identifier.
+   */
+  connect(_bus: IMakaioBus, _machineId: string): Promise<void>;
+  /** Nothing to disconnect. */
+  disconnect(): Promise<void>;
+}
+//#endregion
+//#region packages/kernel/src/providers/ephemeral-identity.d.ts
+/**
+ * Ephemeral identity provider — generates a new random UUID on each load.
+ * Used by framework users and containers that don't persist machine identity.
+ */
+declare class EphemeralIdentityProvider implements IdentityProvider {
+  /**
+   * Generate a fresh random UUID as the machine identity.
+   * @returns A new ephemeral machine identity
+   */
+  load(): Promise<MachineIdentity>;
+}
+//#endregion
+export { MachineIdentity as a, StorageProvider as c, IdentityProvider as i, NoTransportProvider as n, TransportProvider as o, MemoryStorageProvider as r, StorageCleanup as s, EphemeralIdentityProvider as t };