@makaio/framework 1.0.0-dev-1779046984397

package/dist/kernel/cli/index.d.mts

@@ -0,0 +1,141 @@
+import { a as CliSubcommandDefinition, c as INTERACTIVE_SUBCOMMAND, d as requireBus, i as CliContribution, l as OutputWriter, n as BeforeRunContext, o as CliSubcommandEntry, r as BeforeRunResult, s as CommandContext, t as ALWAYS_PROCEED, u as defineCliSubcommand } from "../../types-DYF5LxZY.mjs";
+import * as _$zod from "zod";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import { CliArgManifest } from "@makaio/framework/contracts/extension";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region packages/kernel/src/cli/schema-introspection.d.ts
+/**
+ * Convert a Zod object schema into serializable CLI argument manifests.
+ *
+ * Walks the schema's shape, reads `.meta()` from each field (unwrapping
+ * optional/default wrappers), and produces a {@link CliArgManifest} per field.
+ * This is the serialization counterpart to `schema-adapter.ts`'s registration
+ * logic — same introspection, different output format.
+ * @param schema - A Zod object schema defining a subcommand's arguments.
+ * @returns An array of serializable argument manifests.
+ */
+declare function toCliArgManifests(schema: z.ZodObject<z.ZodRawShape>): CliArgManifest[];
+//#endregion
+//#region packages/kernel/src/cli/schema-utils.d.ts
+/**
+ * Zod 4's `ZodRawShape[string]` resolves to the internal `$ZodType` which
+ * lacks public API methods (`.meta()`, `.isOptional()`).  At runtime these
+ * methods exist — this type alias restores access.
+ */
+type FieldSchema = z.ZodType;
+/**
+ * Extract `.meta()` from a Zod schema, unwrapping optionals/defaults.
+ *
+ * Recursively follows `unwrap()` so that meta attached to the inner schema
+ * of `z.optional(z.string().meta({…}))` is still found.
+ * @param schema - The Zod schema to inspect.
+ * @returns The resolved Zod global metadata or `undefined`.
+ */
+declare function getMeta(schema: FieldSchema): z.GlobalMeta | undefined;
+/**
+ * Check if a Zod schema resolves to a boolean type, unwrapping wrappers
+ * recursively.
+ * @param schema - The Zod schema to inspect.
+ * @returns `true` if the schema represents a boolean value.
+ */
+declare function isBooleanSchema(schema: FieldSchema): boolean;
+/**
+ * Check if a Zod schema resolves to a number type, unwrapping wrappers
+ * recursively.
+ * @param schema - The Zod schema to inspect.
+ * @returns `true` if the schema represents a numeric value.
+ */
+declare function isNumberSchema(schema: FieldSchema): boolean;
+//#endregion
+//#region packages/kernel/src/bus/cli/namespace.d.ts
+/** CLI bus namespace — `cli.*` subjects. */
+declare const CliNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel:cli", {
+  listContributions: {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      contributions: _$zod.ZodArray<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        description: _$zod.ZodString;
+        subcommands: _$zod.ZodOptional<_$zod.ZodReadonly<_$zod.ZodArray<_$zod.ZodObject<{
+          name: _$zod.ZodString;
+          description: _$zod.ZodString;
+          args: _$zod.ZodOptional<_$zod.ZodReadonly<_$zod.ZodArray<_$zod.ZodObject<{
+            name: _$zod.ZodString;
+            description: _$zod.ZodString;
+            required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            positional: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            short: _$zod.ZodOptional<_$zod.ZodString>;
+            type: _$zod.ZodOptional<_$zod.ZodEnum<{
+              string: "string";
+              number: "number";
+              boolean: "boolean";
+            }>>;
+          }, _$zod_v4_core0.$strip>>>>;
+        }, _$zod_v4_core0.$strip>>>>;
+        hasInteractive: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  execute: {
+    request: _$zod.ZodObject<{
+      command: _$zod.ZodString;
+      subcommand: _$zod.ZodString;
+      args: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      exitCode: _$zod.ZodNumber;
+      stdout: _$zod.ZodArray<_$zod.ZodString>;
+      stderr: _$zod.ZodArray<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+  };
+}>;
+/**
+ * Typed subjects for CLI RPC operations.
+ *
+ * - `CliRpcSubjects.listContributions` — discover extension CLI commands
+ * - `CliRpcSubjects.execute` — run a subcommand on the server
+ */
+declare const CliRpcSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"kernel:cli", {
+  listContributions: {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      contributions: _$zod.ZodArray<_$zod.ZodObject<{
+        name: _$zod.ZodString;
+        description: _$zod.ZodString;
+        subcommands: _$zod.ZodOptional<_$zod.ZodReadonly<_$zod.ZodArray<_$zod.ZodObject<{
+          name: _$zod.ZodString;
+          description: _$zod.ZodString;
+          args: _$zod.ZodOptional<_$zod.ZodReadonly<_$zod.ZodArray<_$zod.ZodObject<{
+            name: _$zod.ZodString;
+            description: _$zod.ZodString;
+            required: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            positional: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            short: _$zod.ZodOptional<_$zod.ZodString>;
+            type: _$zod.ZodOptional<_$zod.ZodEnum<{
+              string: "string";
+              number: "number";
+              boolean: "boolean";
+            }>>;
+          }, _$zod_v4_core0.$strip>>>>;
+        }, _$zod_v4_core0.$strip>>>>;
+        hasInteractive: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  execute: {
+    request: _$zod.ZodObject<{
+      command: _$zod.ZodString;
+      subcommand: _$zod.ZodString;
+      args: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      exitCode: _$zod.ZodNumber;
+      stdout: _$zod.ZodArray<_$zod.ZodString>;
+      stderr: _$zod.ZodArray<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+  };
+}>, "kernel:cli">;
+//#endregion
+export { ALWAYS_PROCEED, type BeforeRunContext, type BeforeRunResult, type CliContribution, CliNamespace, CliRpcSubjects, type CliSubcommandDefinition, type CliSubcommandEntry, type CommandContext, type FieldSchema, INTERACTIVE_SUBCOMMAND, type OutputWriter, defineCliSubcommand, getMeta, isBooleanSchema, isNumberSchema, requireBus, toCliArgManifests };

package/dist/kernel/cli/index.mjs

@@ -0,0 +1 @@
+import{a as e,i as t,n,o as r,r as i,t as a}from"../../schema-introspection-D61TT_7b.mjs";const o=`__interactive__`,s={proceed:!0};function c(e){if(!e.bus)throw Error(`This command requires a running Makaio server.`);return e.bus}function l(e,t,n,r){return{name:e,description:t,schema:n,handler:r}}export{s as ALWAYS_PROCEED,e as CliNamespace,r as CliRpcSubjects,o as INTERACTIVE_SUBCOMMAND,l as defineCliSubcommand,n as getMeta,i as isBooleanSchema,t as isNumberSchema,c as requireBus,a as toCliArgManifests};

package/dist/kernel/cli/schemas.d.mts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+
+//#region packages/kernel/src/bus/cli/schemas.d.ts
+/**
+ * CLI namespace schema definitions.
+ *
+ * Both subjects are request/response RPCs — no fire-and-forget events.
+ */
+declare const CliSchemas: {
+  /**
+   * List all CLI contributions from loaded extensions.
+   *
+   * Returns CLI manifest objects (serializable metadata only, no
+   * handler code). The CLI uses this to register remote commands and
+   * generate `--help` output.
+   */
+  listContributions: {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      contributions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        subcommands: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          description: z.ZodString;
+          args: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            positional: z.ZodOptional<z.ZodBoolean>;
+            short: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<{
+              string: "string";
+              number: "number";
+              boolean: "boolean";
+            }>>;
+          }, z.core.$strip>>>>;
+        }, z.core.$strip>>>>;
+        hasInteractive: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Execute a CLI subcommand on the server.
+   *
+   * The server validates args through the subcommand's Zod schema, runs the
+   * handler with a buffering output writer, and returns captured output.
+   */
+  execute: {
+    request: z.ZodObject<{
+      command: z.ZodString;
+      subcommand: z.ZodString;
+      args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      exitCode: z.ZodNumber;
+      stdout: z.ZodArray<z.ZodString>;
+      stderr: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+  };
+};
+//#endregion
+export { CliSchemas };

package/dist/kernel/cli/schemas.mjs

@@ -0,0 +1 @@
+import{t as e}from"../../schemas-CLxtoKFy.mjs";export{e as CliSchemas};

package/dist/kernel/extension/index.d.mts

@@ -0,0 +1,2 @@
+import { a as ExtensionCoordinatorOptions, c as KernelMakaioExtension, i as ContributionProcessor, l as RuntimeCapability, n as filterEligibleExtensions, o as ExtensionRuntimeSurface, r as ExtensionCoordinator, s as KernelExtensionContext, t as coalesceExtensionOverrides, u as RuntimeEnvironment } from "../../index-Bv15sNLn.mjs";
+export { ContributionProcessor, ExtensionCoordinator, ExtensionCoordinatorOptions, ExtensionRuntimeSurface, KernelExtensionContext, KernelMakaioExtension, RuntimeCapability, RuntimeEnvironment, coalesceExtensionOverrides, filterEligibleExtensions };

package/dist/kernel/extension/index.mjs

@@ -0,0 +1 @@
+import{n as e,r as t,t as n}from"../../extension-COqwS-2Q.mjs";export{n as ExtensionCoordinator,e as coalesceExtensionOverrides,t as filterEligibleExtensions};

package/dist/kernel/index.d.mts

@@ -0,0 +1,296 @@
+import { c as ExtensionInfo, f as ServiceInfo, i as ComponentInfo, l as ExtensionInfoSchema, n as ExtensionSubjects, o as ComponentState, p as ServiceInfoSchema, s as ComponentStateSchema, t as ExtensionNamespace } from "../index-DubqLGH8.mjs";
+import { c as KernelMakaioExtension, i as ContributionProcessor, l as RuntimeCapability, n as filterEligibleExtensions, o as ExtensionRuntimeSurface, r as ExtensionCoordinator, s as KernelExtensionContext, t as coalesceExtensionOverrides, u as RuntimeEnvironment } from "../index-Bv15sNLn.mjs";
+import { i as WindowStyle, n as WindowRegistration, r as WindowRegistry, t as STYLE_DEFAULTS } from "../window-registry-C_IJmY8_.mjs";
+import { a as KernelSchemas, i as setWorkflowTriggerTypeRegistry, n as KernelSubjects, r as getWorkflowTriggerTypeRegistry, t as KernelNamespace } from "../index-6lyShOoU.mjs";
+import { a as MachineIdentity, c as StorageProvider, i as IdentityProvider, n as NoTransportProvider, o as TransportProvider, r as MemoryStorageProvider, s as StorageCleanup, t as EphemeralIdentityProvider } from "../index-SzSiyG61.mjs";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+
+//#region packages/kernel/src/boot-namespace.d.ts
+/**
+ * Boot namespace for bus operations.
+ */
+declare const BootNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel:boot", {
+  /**
+   * Request the current boot state for late subscribers.
+   *
+   * Subject: `kernel:boot.getState`
+   * Type: RPC (request/response)
+   * Purpose: Allows clients that connect after boot has started (or completed)
+   * to retrieve the current boot state. Returns the same shape as `progress`
+   * plus additional fields indicating whether boot is complete and any failures.
+   */
+  getState: {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      complete: z.ZodBoolean;
+      completedCount: z.ZodNumber;
+      totalCount: z.ZodNumber;
+      currentService: z.ZodOptional<z.ZodString>;
+      failedServices: z.ZodArray<z.ZodString>;
+      skippedServices: z.ZodDefault<z.ZodArray<z.ZodString>>;
+      totalDurationMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Signal that a service has begun its startup sequence.
+   *
+   * Subject: `kernel:boot.service.starting`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted immediately before a service's `create()` method is invoked.
+   * Allows observers to track which services are actively starting.
+   */
+  'service.starting': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+  }, z.core.$strip>;
+  /**
+   * Signal that a service has successfully completed startup.
+   *
+   * Subject: `kernel:boot.service.ready`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted after a service's `create()` method resolves successfully.
+   * Includes elapsed startup duration for performance monitoring.
+   * @param durationMs - Elapsed time in milliseconds from `service.starting` to ready.
+   */
+  'service.ready': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    durationMs: z.ZodNumber;
+  }, z.core.$strip>;
+  /**
+   * Signal that a service failed to start.
+   *
+   * Subject: `kernel:boot.service.failed`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted when a service's `create()` method throws or rejects.
+   * Carries the error message for diagnostics and UI error display.
+   * @param errorMessage - Stringified error from the failed startup attempt.
+   */
+  'service.failed': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    errorMessage: z.ZodString;
+  }, z.core.$strip>;
+  /**
+   * Signal that a service intentionally skipped startup.
+   *
+   * Subject: `kernel:boot.service.skipped`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted when a service's `create()` throws a {@link ServiceSkipError},
+   * indicating the service opted out due to role, feature flag, or environment
+   * mismatch — not an error condition.
+   * @param reason - Human-readable explanation from the ServiceSkipError.
+   */
+  'service.skipped': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    reason: z.ZodString;
+  }, z.core.$strip>;
+  /**
+   * Signal the current boot progress across all services.
+   *
+   * Subject: `kernel:boot.progress`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted after each service completes (successfully or not).
+   * Used by progress indicators to show startup completion percentage.
+   * @param completedCount - Number of services that have finished (ready or failed).
+   * @param totalCount - Total number of services registered for this boot sequence.
+   * @param currentService - Display name of the service currently starting, if any.
+   */
+  progress: z.ZodObject<{
+    completedCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    currentService: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  /**
+   * Signal that all services have completed their startup attempts.
+   *
+   * Subject: `kernel:boot.complete`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted once all registered services have resolved or rejected.
+   * Carries the total boot duration and names of any failed services.
+   * @param totalDurationMs - Elapsed time in milliseconds for the entire boot sequence.
+   * @param failedServices - Array of service names that failed to start (may be empty).
+   */
+  complete: z.ZodObject<{
+    totalDurationMs: z.ZodNumber;
+    failedServices: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+}>;
+/**
+ * Boot subjects for type-safe bus operations.
+ *
+ * Subjects:
+ * - `getState`         — RPC to retrieve the current boot state for late subscribers
+ * - `service.starting` — event: emitted before a service begins startup
+ * - `service.ready`    — event: emitted when a service finishes startup successfully
+ * - `service.failed`   — event: emitted when a service startup throws an unexpected error
+ * - `service.skipped`  — event: emitted when a service throws ServiceSkipError (intentional opt-out)
+ * - `progress`         — event: emitted after each service completes, with overall progress
+ * - `complete`         — event: emitted once all services have settled
+ *
+ * Dot-notation keys produce nested access:
+ * ```typescript
+ * BootSubjects.service.starting
+ * BootSubjects.complete
+ * ```
+ */
+declare const BootSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"kernel:boot", {
+  /**
+   * Request the current boot state for late subscribers.
+   *
+   * Subject: `kernel:boot.getState`
+   * Type: RPC (request/response)
+   * Purpose: Allows clients that connect after boot has started (or completed)
+   * to retrieve the current boot state. Returns the same shape as `progress`
+   * plus additional fields indicating whether boot is complete and any failures.
+   */
+  getState: {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      complete: z.ZodBoolean;
+      completedCount: z.ZodNumber;
+      totalCount: z.ZodNumber;
+      currentService: z.ZodOptional<z.ZodString>;
+      failedServices: z.ZodArray<z.ZodString>;
+      skippedServices: z.ZodDefault<z.ZodArray<z.ZodString>>;
+      totalDurationMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Signal that a service has begun its startup sequence.
+   *
+   * Subject: `kernel:boot.service.starting`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted immediately before a service's `create()` method is invoked.
+   * Allows observers to track which services are actively starting.
+   */
+  'service.starting': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+  }, z.core.$strip>;
+  /**
+   * Signal that a service has successfully completed startup.
+   *
+   * Subject: `kernel:boot.service.ready`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted after a service's `create()` method resolves successfully.
+   * Includes elapsed startup duration for performance monitoring.
+   * @param durationMs - Elapsed time in milliseconds from `service.starting` to ready.
+   */
+  'service.ready': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    durationMs: z.ZodNumber;
+  }, z.core.$strip>;
+  /**
+   * Signal that a service failed to start.
+   *
+   * Subject: `kernel:boot.service.failed`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted when a service's `create()` method throws or rejects.
+   * Carries the error message for diagnostics and UI error display.
+   * @param errorMessage - Stringified error from the failed startup attempt.
+   */
+  'service.failed': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    errorMessage: z.ZodString;
+  }, z.core.$strip>;
+  /**
+   * Signal that a service intentionally skipped startup.
+   *
+   * Subject: `kernel:boot.service.skipped`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted when a service's `create()` throws a {@link ServiceSkipError},
+   * indicating the service opted out due to role, feature flag, or environment
+   * mismatch — not an error condition.
+   * @param reason - Human-readable explanation from the ServiceSkipError.
+   */
+  'service.skipped': z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    reason: z.ZodString;
+  }, z.core.$strip>;
+  /**
+   * Signal the current boot progress across all services.
+   *
+   * Subject: `kernel:boot.progress`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted after each service completes (successfully or not).
+   * Used by progress indicators to show startup completion percentage.
+   * @param completedCount - Number of services that have finished (ready or failed).
+   * @param totalCount - Total number of services registered for this boot sequence.
+   * @param currentService - Display name of the service currently starting, if any.
+   */
+  progress: z.ZodObject<{
+    completedCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    currentService: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  /**
+   * Signal that all services have completed their startup attempts.
+   *
+   * Subject: `kernel:boot.complete`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted once all registered services have resolved or rejected.
+   * Carries the total boot duration and names of any failed services.
+   * @param totalDurationMs - Elapsed time in milliseconds for the entire boot sequence.
+   * @param failedServices - Array of service names that failed to start (may be empty).
+   */
+  complete: z.ZodObject<{
+    totalDurationMs: z.ZodNumber;
+    failedServices: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+}>, "kernel:boot">;
+//#endregion
+//#region packages/kernel/src/service-skip-error.d.ts
+/**
+ * Thrown from a service factory to signal that the service intentionally opts
+ * out of starting in the current runtime context (e.g. wrong role, disabled
+ * feature flag).
+ *
+ * {@link ExtensionCoordinator} catches this error and routes the package to
+ * the skipped list instead of the failed list, emitting
+ * `kernel:boot.service.skipped` instead of `kernel:boot.service.failed`.
+ *
+ * **Contract:** Only valid for non-critical services.
+ * Throwing `ServiceSkipError` from a critical service is treated as a real
+ * failure to prevent silent startup holes.
+ * @example
+ * ```typescript
+ * factory: async (ctx) => {
+ *   const { config } = await ctx.bus.request(ConfigSubjects.get, {});
+ *   if (config.role !== 'main-dev-machine') {
+ *     throw new ServiceSkipError(`role=${String(config.role)}, expected main-dev-machine`);
+ *   }
+ *   return new CronTriggerEvaluator(ctx.bus);
+ * }
+ * ```
+ */
+declare class ServiceSkipError extends Error {
+  /**
+   * Human-readable reason why the service chose to skip.
+   * Included in the `service.skipped` bus event.
+   */
+  readonly reason: string;
+  /**
+   * @param reason - Human-readable explanation for why the service is skipping
+   */
+  constructor(reason: string);
+}
+//#endregion
+//#region packages/kernel/src/shutdown.d.ts
+/**
+ * Create an ordered, idempotent shutdown sequence.
+ *
+ * Steps run in the order provided. Errors in individual steps are logged
+ * but do not prevent subsequent steps from running. Concurrent calls to
+ * the returned function share the same promise (idempotent).
+ * @param steps - Cleanup functions in shutdown order (typically reverse-startup).
+ * @returns An async function that executes all steps once.
+ */
+declare function createShutdownSequence(steps: ReadonlyArray<() => Promise<void> | void>): () => Promise<void>;
+//#endregion
+export { BootNamespace, BootSubjects, type ComponentInfo, type ComponentState, ComponentStateSchema, type ContributionProcessor, EphemeralIdentityProvider, ExtensionCoordinator, type ExtensionInfo, ExtensionInfoSchema, ExtensionNamespace, type ExtensionRuntimeSurface, ExtensionSubjects, type IdentityProvider, type KernelExtensionContext, type KernelMakaioExtension, KernelNamespace, KernelSchemas, KernelSubjects, type MachineIdentity, MemoryStorageProvider, NoTransportProvider, type RuntimeCapability, type RuntimeEnvironment, STYLE_DEFAULTS, type ServiceInfo, ServiceInfoSchema, ServiceSkipError, type StorageCleanup, type StorageProvider, type TransportProvider, type WindowRegistration, WindowRegistry, type WindowStyle, coalesceExtensionOverrides, createShutdownSequence, filterEligibleExtensions, getWorkflowTriggerTypeRegistry, setWorkflowTriggerTypeRegistry };

package/dist/kernel/index.mjs

@@ -0,0 +1 @@
+import{a as e,i as t,n,r,t as i}from"../namespace-0yuzAKlr.mjs";import{n as a,t as o}from"../window-registry-CUftmDr3.mjs";import"./window/index.mjs";import{n as s,r as c,t as l}from"../providers-Cr4Za8a1.mjs";import{a as u,i as d,n as f,o as p,r as m,t as h}from"../extension-COqwS-2Q.mjs";import{a as g,c as _,n as v,o as y,t as b}from"../extension-namespace-zaGKi6Qj.mjs";import"./observability/index.mjs";function x(e){let t=null;return()=>t||(t=(async()=>{for(let t of e)try{await t()}catch(e){console.warn(`[shutdown]`,e)}})(),t)}export{u as BootNamespace,p as BootSubjects,g as ComponentStateSchema,l as EphemeralIdentityProvider,h as ExtensionCoordinator,y as ExtensionInfoSchema,b as ExtensionNamespace,v as ExtensionSubjects,i as KernelNamespace,e as KernelSchemas,n as KernelSubjects,c as MemoryStorageProvider,s as NoTransportProvider,o as STYLE_DEFAULTS,_ as ServiceInfoSchema,d as ServiceSkipError,a as WindowRegistry,f as coalesceExtensionOverrides,x as createShutdownSequence,m as filterEligibleExtensions,r as getWorkflowTriggerTypeRegistry,t as setWorkflowTriggerTypeRegistry};

package/dist/kernel/namespace/index.d.mts

@@ -0,0 +1,2 @@
+import { a as KernelSchemas, i as setWorkflowTriggerTypeRegistry, n as KernelSubjects, r as getWorkflowTriggerTypeRegistry, t as KernelNamespace } from "../../index-6lyShOoU.mjs";
+export { KernelNamespace, KernelSchemas, KernelSubjects, getWorkflowTriggerTypeRegistry, setWorkflowTriggerTypeRegistry };

package/dist/kernel/namespace/index.mjs

@@ -0,0 +1 @@
+import{a as e,i as t,n,r,t as i}from"../../namespace-0yuzAKlr.mjs";export{i as KernelNamespace,e as KernelSchemas,n as KernelSubjects,r as getWorkflowTriggerTypeRegistry,t as setWorkflowTriggerTypeRegistry};

package/dist/kernel/observability/index.d.mts

@@ -0,0 +1,2 @@
+import { a as ComponentInfoSchema, c as ExtensionInfo, d as ExtensionWarningEntrySchema, f as ServiceInfo, i as ComponentInfo, l as ExtensionInfoSchema, n as ExtensionSubjects, o as ComponentState, p as ServiceInfoSchema, r as ComponentIdentitySchema, s as ComponentStateSchema, t as ExtensionNamespace, u as ExtensionWarningEntry } from "../../index-DubqLGH8.mjs";
+export { ComponentIdentitySchema, ComponentInfo, ComponentInfoSchema, ComponentState, ComponentStateSchema, ExtensionInfo, ExtensionInfoSchema, ExtensionNamespace, ExtensionSubjects, ExtensionWarningEntry, ExtensionWarningEntrySchema, ServiceInfo, ServiceInfoSchema };

package/dist/kernel/observability/index.mjs

@@ -0,0 +1 @@
+import{a as e,c as t,i as n,n as r,o as i,r as a,s as o,t as s}from"../../extension-namespace-zaGKi6Qj.mjs";export{a as ComponentIdentitySchema,n as ComponentInfoSchema,e as ComponentStateSchema,i as ExtensionInfoSchema,s as ExtensionNamespace,r as ExtensionSubjects,o as ExtensionWarningEntrySchema,t as ServiceInfoSchema};

package/dist/kernel/providers/index.d.mts

@@ -0,0 +1,2 @@
+import { a as MachineIdentity, c as StorageProvider, i as IdentityProvider, n as NoTransportProvider, o as TransportProvider, r as MemoryStorageProvider, s as StorageCleanup, t as EphemeralIdentityProvider } from "../../index-SzSiyG61.mjs";
+export { EphemeralIdentityProvider, IdentityProvider, MachineIdentity, MemoryStorageProvider, NoTransportProvider, StorageCleanup, StorageProvider, TransportProvider };

package/dist/kernel/providers/index.mjs

@@ -0,0 +1 @@
+import{n as e,r as t,t as n}from"../../providers-Cr4Za8a1.mjs";export{n as EphemeralIdentityProvider,t as MemoryStorageProvider,e as NoTransportProvider};

package/dist/kernel/window/index.d.mts

@@ -0,0 +1,2 @@
+import { i as WindowStyle, n as WindowRegistration, r as WindowRegistry, t as STYLE_DEFAULTS } from "../../window-registry-C_IJmY8_.mjs";
+export { STYLE_DEFAULTS, type WindowRegistration, WindowRegistry, type WindowStyle };

package/dist/kernel/window/index.mjs

@@ -0,0 +1 @@
+import{n as e,t}from"../../window-registry-CUftmDr3.mjs";export{t as STYLE_DEFAULTS,e as WindowRegistry};

package/dist/model-registry-BNzpR6TU.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{createBusNamespace as t}from"@makaio/framework/core";const n=e.object({name:e.string(),friendlyName:e.string().optional(),contextWindowSize:e.number().int().nonnegative(),provider:e.string()}),r={supportedModels:{request:e.object({}),response:e.object({models:e.array(n)})}},i=t(`modelRegistry:public`,r),a=i.subjects;export{n as i,a as n,r,i as t};

package/dist/model-registry-CIscwC52.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{createBusNamespace as t}from"@makaio/framework/core";import{AIModelSchema as n,ProviderAIModelSchema as r}from"@makaio/framework/contracts";import{BaseService as i}from"@makaio/framework/service-base";import{ModelRegistryPublicSubjects as a}from"@makaio/framework/contracts/model-registry";const o=e.object({name:e.string(),models:e.array(n)}),s=n.partial().extend({canonicalModel:e.string().optional(),name:e.never({error:`Provider model overrides cannot include identity fields`}).optional(),labId:e.never({error:`Provider model overrides cannot include identity fields`}).optional()}),c=e.object({name:e.string(),models:e.record(e.string(),s)}),l=e.object({$schema:e.literal(`makaio/model-registry/v2`),updatedAt:e.string().datetime(),labs:e.record(e.string(),o),providers:e.record(e.string(),c)}).superRefine((e,t)=>{let n=new Map;for(let[r,i]of Object.entries(e.labs))for(let[e,a]of i.models.entries()){a.labId!==r&&t.addIssue({code:`custom`,path:[`labs`,r,`models`,e,`labId`],message:`Lab model labId "${a.labId}" does not match lab key "${r}"`});let i=n.get(a.name);if(i!==void 0){t.addIssue({code:`custom`,path:[`labs`,r,`models`,e,`name`],message:`Duplicate canonical model name "${a.name}" appears in labs "${i}" and "${r}"`});continue}n.set(a.name,r)}for(let[r,i]of Object.entries(e.providers)){let e=new Map;for(let[a,o]of Object.entries(i.models)){let i=o.canonicalModel??a,s=e.get(i);if(s!==void 0){t.addIssue({code:`custom`,path:[`providers`,r,`models`,a,`canonicalModel`],message:`Duplicate canonical model reference "${i}" for provider "${r}" via models "${s}" and "${a}"`});continue}e.set(i,a),n.has(i)||t.addIssue({code:`custom`,path:[`providers`,r,`models`,a],message:`Unknown provider model reference "${i}" for provider "${r}"`+(i===a?``:` model "${a}"`)})}}}),u={getForProvider:{request:e.object({providerId:e.string(),model:e.string()}),response:e.object({model:r.optional()})},getLabModels:{request:e.object({labId:e.string()}),response:e.object({models:e.array(n)})},getProviderModels:{request:e.object({providerId:e.string()}),response:e.object({models:e.array(r)})},refresh:{request:e.object({}),response:e.object({success:e.boolean(),error:e.string().optional()})},checkModelInProviders:{request:e.object({providerIds:e.array(e.string()),model:e.string()}),response:e.object({matches:e.record(e.string(),r)})},changed:e.object({})},d=t(`modelRegistry`,u),f=d.subjects;function p(e){let t={...e};return e.capabilities!==void 0&&(t.capabilities=m(e.capabilities)),e.pricing!==void 0&&(t.pricing=h(e.pricing)),t}function m(e){let t={...e};return e.speechToText!==void 0&&(t.speechToText={...e.speechToText,modes:[...e.speechToText.modes]}),e.textToSpeech!==void 0&&(t.textToSpeech={...e.textToSpeech,modes:[...e.textToSpeech.modes]},e.textToSpeech.outputFormats!==void 0&&(t.textToSpeech.outputFormats=[...e.textToSpeech.outputFormats])),t}function h(e){let t={...e};return e.token!==void 0&&(t.token={...e.token}),e.request!==void 0&&(t.request={...e.request}),t}function g(e,t){return t===void 0?e===void 0?void 0:p(e):p(e===void 0?t:{...e,...t,capabilities:t.capabilities??e.capabilities,pricing:t.pricing??e.pricing})}var _=class extends Error{providerId;constructor(e){super(`Provider "${e}" is not present in the model registry`),this.name=`ModelRegistryProviderNotFoundError`,this.providerId=e}},v=class extends i{fetcher;registry=null;labModelIndex=null;fetchPromise=null;refreshPromise=null;fetchGeneration=0;constructor(e){super(e.bus),this.fetcher=e.fetcher}onInit(){this.registerHandler(f.getForProvider,async e=>{let{providerId:t,model:n}=e.payload,{registry:r,index:i}=await this.ensureRegistryWithIndex(),a=this.resolveProviderModel(r,i,t,n);e.setResult({model:a})}),this.registerHandler(f.getLabModels,async e=>{let{labId:t}=e.payload,{registry:n}=await this.ensureRegistryWithIndex(),r=n.labs[t];e.setResult({models:r?.models.map(e=>this.cloneModel(e))??[]})}),this.registerHandler(f.getProviderModels,async e=>{let{providerId:t}=e.payload,{registry:n,index:r}=await this.ensureRegistryWithIndex(),i=this.resolveAllProviderModels(n,r,t);e.setResult({models:i})}),this.registerHandler(a.supportedModels,async e=>{let{registry:t,index:n}=await this.ensureRegistryWithIndex();e.setResult({models:this.resolveSupportedModels(t,n)})}),this.registerHandler(f.checkModelInProviders,async e=>{let{providerIds:t,model:n}=e.payload,{registry:r,index:i}=await this.ensureRegistryWithIndex(),a={};for(let e of t){let t=this.resolveProviderModelByCanonicalName(r,i,e,n);t!==void 0&&(a[e]=t)}e.setResult({matches:a})}),this.registerHandler(f.refresh,async e=>{try{await this.refreshRegistry(),e.setResult({success:!0})}catch(t){e.setResult({success:!1,error:t instanceof Error?t.message:`Unknown error`})}})}onDestroy(){this.fetchGeneration+=1,this.registry=null,this.labModelIndex=null,this.fetchPromise=null,this.refreshPromise=null}async ensureRegistryWithIndex(){if(this.registry!==null)return{registry:this.registry,index:this.labModelIndex};if(this.fetchPromise!==null){let e=await this.fetchPromise,t=this.labModelIndex??this.buildLabModelIndex(e.registry);return{registry:e.registry,index:t}}let e=this.fetchGeneration,t=this.startRegistryFetch(e);this.fetchPromise=t;let n=await t,r=this.labModelIndex??this.buildLabModelIndex(n.registry);return{registry:n.registry,index:r}}async refreshRegistry(){if(this.refreshPromise!==null){await this.refreshPromise;return}let e=this.fetchPromise===null?this.runRefresh():this.awaitActiveFetchForRefresh(this.fetchPromise);this.refreshPromise=e;try{await e}finally{this.refreshPromise===e&&(this.refreshPromise=null)}}async awaitActiveFetchForRefresh(e){if(!(await e).committed)throw Error(`Model registry refresh completed without committing a registry`);await this.emitRegistryChanged()}async runRefresh(){let e=this.fetchGeneration+1;this.fetchGeneration=e,this.registry=null,this.labModelIndex=null;let t=this.startRegistryFetch(e);if(this.fetchPromise=t,!(await t).committed)throw Error(`Model registry refresh completed without committing a registry`);await this.emitRegistryChanged()}async emitRegistryChanged(){try{await this.bus.emit(f.changed,{})}catch(e){console.warn(`[ModelRegistryService] Failed to notify model registry change:`,e)}}startRegistryFetch(e){let t={promise:null};return t.promise=(async()=>{try{let t=await this.fetcher.fetch();return{registry:t,committed:this.commitRegistry(e,t)}}finally{e===this.fetchGeneration&&this.fetchPromise===t.promise&&(this.fetchPromise=null)}})(),t.promise}commitRegistry(e,t){return e===this.fetchGeneration?(this.registry=t,this.labModelIndex=this.buildLabModelIndex(t),!0):!1}resolveProviderModel(e,t,n,r){let i=e.providers[n];if(!i)return;let a=i.models[r];if(a===void 0)return;let o=t.get(a.canonicalModel??r);if(o)return this.mergeModel(r,o,a)}resolveProviderModelByCanonicalName(e,t,n,r){let i=e.providers[n];if(i)for(let[e,n]of Object.entries(i.models)){if((n.canonicalModel??e)!==r)continue;let i=t.get(r);return i?this.mergeModel(e,i,n):void 0}}resolveAllProviderModels(e,t,n){let r=e.providers[n];if(!r)throw new _(n);let i=[];for(let[e,n]of Object.entries(r.models)){let r=t.get(n.canonicalModel??e);r&&i.push(this.mergeModel(e,r,n))}return i}resolveSupportedModels(e,t){let n=[];for(let r of Object.keys(e.providers))for(let i of this.resolveAllProviderModels(e,t,r))n.push({name:i.name,...i.friendlyName!==void 0&&{friendlyName:i.friendlyName},contextWindowSize:i.contextWindowSize,provider:r});return n.sort((e,t)=>e.provider===t.provider?e.name===t.name?0:e.name<t.name?-1:1:e.provider<t.provider?-1:1)}buildLabModelIndex(e){let t=new Map;for(let n of Object.values(e.labs))for(let e of n.models)t.set(e.name,e);return t}mergeModel(e,t,n){if(Object.keys(n).length===0)return{...this.cloneProviderModel(t),name:e};let{canonicalModel:r,metadata:i,...a}=n,o={...this.cloneProviderModel(t),...a,name:e};a.supportedReasoningLevels!==void 0&&(o.supportedReasoningLevels={...a.supportedReasoningLevels});let s=g(t.metadata,i);return s!==void 0&&(o.metadata=s),o}cloneProviderModel(e){return{...this.cloneModel(e),labId:e.labId}}cloneModel(e){let t={...e};return e.supportedReasoningLevels!==void 0&&(t.supportedReasoningLevels={...e.supportedReasoningLevels}),e.metadata!==void 0&&(t.metadata=p(e.metadata)),t}},y=class{fetchers;constructor(e){if(e.length===0)throw Error(`FallbackRegistryFetcher requires at least one fetcher`);this.fetchers=e}async fetch(){let e;for(let t of this.fetchers)try{return await t.fetch()}catch(t){e=t instanceof Error?t:Error(String(t))}throw e}},b=class{inner;cache;constructor(e,t){this.inner=e,this.cache=t}async fetch(){try{let e=await this.inner.fetch();return await this.cache.set(e).catch(e=>{console.warn(`[CachedRegistryFetcher] Failed to write cache:`,e)}),e}catch(e){let t=await this.cache.get();if(t!==null)return t;throw e}}};export{g as a,l as c,v as i,u as l,y as n,d as o,_ as r,f as s,b as t,s as u};

package/dist/namespace-0yuzAKlr.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{createBusNamespace as t}from"@makaio/framework/core";import{localSubject as n}from"@makaio/framework/bus";const r=e.object({machineId:e.string()}),i={isReady:{request:e.object({}),response:e.object({ready:e.boolean(),machineId:e.string()})},"phase.busCreated":r,"phase.coreReady":r,"phase.servicesReady":r,"phase.coordinatorReady":n({request:r,response:e.object({})}),ready:r,"lifecycle.start":{request:e.object({machineId:e.string()}),response:e.object({})},"lifecycle.shutdown":{request:e.object({}),response:e.object({})}},a=t(`kernel`,i),o=a.subjects;let s;function c(e){if(e!==void 0&&s!==void 0&&s!==e)throw Error(`Workflow trigger type registry is already set. Clear it with setWorkflowTriggerTypeRegistry(undefined) before replacing it.`);s=e}function l(){return s}export{i as a,c as i,o as n,l as r,a as t};

package/dist/namespace-8cNguvIp.mjs

@@ -0,0 +1 @@
+import{sessions as e}from"./services/session/storage/schema.mjs";import{t}from"./schema-CAw_BqaG.mjs";import{SessionEventStorageNamespace as n,SessionEventStorageSubjects as r}from"@makaio/framework/contracts";import{index as i,integer as a,sqliteTable as o,text as s}from"drizzle-orm/sqlite-core";const c=o(`session_events`,{id:a(`id`).primaryKey({autoIncrement:!0}),sessionId:s(`session_id`).notNull().references(()=>e.sessionId,{onDelete:`cascade`}),eventId:s(`event_id`).notNull().unique(),timestamp:a(`timestamp`).notNull(),type:s(`type`).notNull(),agentId:s(`agent_id`),adapterId:s(`adapter_id`),originatingMessageId:s(`originating_message_id`),messageId:s(`message_id`).references(()=>t.messageId,{onDelete:`cascade`}),turnId:s(`turn_id`),contentText:s(`content_text`),payload:s(`payload`).notNull()},e=>[i(`idx_events_session_ts`).on(e.sessionId,e.timestamp),i(`idx_events_session_type`).on(e.sessionId,e.type),i(`idx_events_turn`).on(e.turnId),i(`idx_events_originating_message`).on(e.originatingMessageId)]),l={...n,extensions:{drizzle:{sessionEvents:c}}};export{r as n,c as r,l as t};