@makaio/framework 1.0.0-dev-1779046984397

package/dist/schemas-qmn5SWPU.d.mts

@@ -0,0 +1,312 @@
+import { z } from "zod";
+
+//#region packages/services/core/src/worker/schemas.d.ts
+/**
+ * Worker Definition - User-configured template stored in settings.
+ */
+declare const WorkerDefinitionSchema: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  adapterName: z.ZodString;
+  providerConfigId: z.ZodOptional<z.ZodString>;
+  model: z.ZodOptional<z.ZodString>;
+  systemPrompt: z.ZodOptional<z.ZodString>;
+  contextMode: z.ZodDefault<z.ZodEnum<{
+    fork: "fork";
+    fresh: "fresh";
+  }>>;
+  allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  scope: z.ZodString;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  createdAt: z.ZodNumber;
+  updatedAt: z.ZodNumber;
+}, z.core.$strip>;
+type WorkerDefinition = z.infer<typeof WorkerDefinitionSchema>;
+/**
+ * Summary schema for listing workers.
+ */
+declare const WorkerDefinitionSummarySchema: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  adapterName: z.ZodString;
+  model: z.ZodOptional<z.ZodString>;
+  enabled: z.ZodBoolean;
+}, z.core.$strip>;
+type WorkerDefinitionSummary = z.infer<typeof WorkerDefinitionSummarySchema>;
+/**
+ * Schema for creating a new worker definition.
+ * Omits server-managed fields: id, scope, createdAt, updatedAt.
+ */
+declare const WorkerDefinitionCreateSchema: z.ZodObject<{
+  name: z.ZodString;
+  adapterName: z.ZodString;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  providerConfigId: z.ZodOptional<z.ZodString>;
+  model: z.ZodOptional<z.ZodString>;
+  systemPrompt: z.ZodOptional<z.ZodString>;
+  allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  contextMode: z.ZodDefault<z.ZodEnum<{
+    fork: "fork";
+    fresh: "fresh";
+  }>>;
+}, z.core.$strip>;
+type WorkerDefinitionCreate = z.infer<typeof WorkerDefinitionCreateSchema>;
+/**
+ * Schema for updating a worker definition.
+ */
+declare const WorkerDefinitionUpdateSchema: z.ZodObject<{
+  id: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  name: z.ZodOptional<z.ZodString>;
+  adapterName: z.ZodOptional<z.ZodString>;
+  providerConfigId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  systemPrompt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  contextMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+    fork: "fork";
+    fresh: "fresh";
+  }>>>;
+  allowedTools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  disallowedTools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  allowedDirectories: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  scope: z.ZodOptional<z.ZodString>;
+  enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  createdAt: z.ZodOptional<z.ZodNumber>;
+  updatedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type WorkerDefinitionUpdate = z.infer<typeof WorkerDefinitionUpdateSchema>;
+/**
+ * Schema-only worker definition CRUD subjects used by the settings layer.
+ *
+ * Keeping these in the pure schema module avoids accidentally registering the
+ * runtime worker namespace when settings code only needs the request/response
+ * contracts for `settings:worker.*`.
+ */
+declare const WorkerSettingsSchemas: {
+  list: {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      definitions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        adapterName: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodBoolean;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  get: {
+    request: z.ZodObject<{
+      id: z.ZodOptional<z.ZodString>;
+      name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      adapterName: z.ZodString;
+      providerConfigId: z.ZodOptional<z.ZodString>;
+      model: z.ZodOptional<z.ZodString>;
+      systemPrompt: z.ZodOptional<z.ZodString>;
+      contextMode: z.ZodDefault<z.ZodEnum<{
+        fork: "fork";
+        fresh: "fresh";
+      }>>;
+      allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      scope: z.ZodString;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      createdAt: z.ZodNumber;
+      updatedAt: z.ZodNumber;
+    }, z.core.$strip>;
+  };
+  create: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      adapterName: z.ZodString;
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      providerConfigId: z.ZodOptional<z.ZodString>;
+      model: z.ZodOptional<z.ZodString>;
+      systemPrompt: z.ZodOptional<z.ZodString>;
+      allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      contextMode: z.ZodDefault<z.ZodEnum<{
+        fork: "fork";
+        fresh: "fresh";
+      }>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      id: z.ZodString;
+    }, z.core.$strip>;
+  };
+  update: {
+    request: z.ZodObject<{
+      id: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+      name: z.ZodOptional<z.ZodString>;
+      adapterName: z.ZodOptional<z.ZodString>;
+      providerConfigId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      systemPrompt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+      contextMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        fork: "fork";
+        fresh: "fresh";
+      }>>>;
+      allowedTools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+      disallowedTools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+      allowedDirectories: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+      scope: z.ZodOptional<z.ZodString>;
+      enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+      createdAt: z.ZodOptional<z.ZodNumber>;
+      updatedAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  delete: {
+    request: z.ZodObject<{
+      id: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+};
+/**
+ * Worker Instance - Running execution backed by SubagentManager.
+ */
+declare const WorkerInstanceSchema: z.ZodObject<{
+  instanceId: z.ZodString;
+  definitionId: z.ZodString;
+  definitionName: z.ZodString;
+  subagentId: z.ZodString;
+  childSessionId: z.ZodString;
+  status: z.ZodEnum<{
+    completed: "completed";
+    cancelled: "cancelled";
+    running: "running";
+    waiting_input: "waiting_input";
+    failed: "failed";
+  }>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+type WorkerInstance = z.infer<typeof WorkerInstanceSchema>;
+/**
+ * Schema for spawning a worker.
+ */
+declare const WorkerSpawnRequestSchema: z.ZodObject<{
+  workerName: z.ZodString;
+  prompt: z.ZodString;
+  sessionId: z.ZodString;
+  overrides: z.ZodOptional<z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type WorkerSpawnRequest = z.infer<typeof WorkerSpawnRequestSchema>;
+/**
+ * Schema for worker instance status query.
+ */
+declare const WorkerInstanceStatusSchema: z.ZodObject<{
+  instanceId: z.ZodString;
+  definitionName: z.ZodString;
+  subagentId: z.ZodString;
+  status: z.ZodEnum<{
+    completed: "completed";
+    cancelled: "cancelled";
+    running: "running";
+    waiting_input: "waiting_input";
+    failed: "failed";
+  }>;
+  result: z.ZodOptional<z.ZodString>;
+  error: z.ZodOptional<z.ZodString>;
+  progress: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type WorkerInstanceStatus = z.infer<typeof WorkerInstanceStatusSchema>;
+declare const WorkerSpawnedEventSchema: z.ZodObject<{
+  instanceId: z.ZodString;
+  workerName: z.ZodString;
+}, z.core.$strip>;
+declare const WorkerCompletedEventSchema: z.ZodObject<{
+  instanceId: z.ZodString;
+  success: z.ZodBoolean;
+  result: z.ZodOptional<z.ZodString>;
+  error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema-only worker runtime subjects.
+ *
+ * The runtime namespace registration lives in `./namespace.ts`; this export is
+ * safe to import from settings or tests that only need the contracts.
+ */
+declare const WorkerKernelSchemas: {
+  spawn: {
+    request: z.ZodObject<{
+      workerName: z.ZodString;
+      prompt: z.ZodString;
+      sessionId: z.ZodString;
+      overrides: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      instanceId: z.ZodString;
+    }, z.core.$strip>;
+  };
+  get: {
+    request: z.ZodObject<{
+      instanceId: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      instanceId: z.ZodString;
+      definitionName: z.ZodString;
+      subagentId: z.ZodString;
+      status: z.ZodEnum<{
+        completed: "completed";
+        cancelled: "cancelled";
+        running: "running";
+        waiting_input: "waiting_input";
+        failed: "failed";
+      }>;
+      result: z.ZodOptional<z.ZodString>;
+      error: z.ZodOptional<z.ZodString>;
+      progress: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+  };
+  send: {
+    request: z.ZodObject<{
+      instanceId: z.ZodString;
+      content: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      sent: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  kill: {
+    request: z.ZodObject<{
+      instanceId: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      killed: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  spawned: z.ZodObject<{
+    instanceId: z.ZodString;
+    workerName: z.ZodString;
+  }, z.core.$strip>;
+  completed: z.ZodObject<{
+    instanceId: z.ZodString;
+    success: z.ZodBoolean;
+    result: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+};
+//#endregion
+export { WorkerSpawnRequestSchema as _, WorkerDefinitionSchema as a, WorkerDefinitionUpdate as c, WorkerInstanceSchema as d, WorkerInstanceStatus as f, WorkerSpawnRequest as g, WorkerSettingsSchemas as h, WorkerDefinitionCreateSchema as i, WorkerDefinitionUpdateSchema as l, WorkerKernelSchemas as m, WorkerDefinition as n, WorkerDefinitionSummary as o, WorkerInstanceStatusSchema as p, WorkerDefinitionCreate as r, WorkerDefinitionSummarySchema as s, WorkerCompletedEventSchema as t, WorkerInstance as u, WorkerSpawnedEventSchema as v };

package/dist/schemas-sshQEF3l.d.mts

@@ -0,0 +1,237 @@
+import { z } from "zod";
+
+//#region packages/services/core/src/compression/schemas.d.ts
+/**
+ * Bug entry extracted from conversation.
+ */
+declare const BugEntrySchema: z.ZodObject<{
+  issue: z.ZodString;
+  location: z.ZodString;
+  impact: z.ZodString;
+}, z.core.$strip>;
+type BugEntry = z.infer<typeof BugEntrySchema>;
+/**
+ * Todo entry extracted from conversation.
+ */
+declare const TodoEntrySchema: z.ZodObject<{
+  issue: z.ZodString;
+  location: z.ZodString;
+  priority: z.ZodOptional<z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+  }>>;
+}, z.core.$strip>;
+type TodoEntry = z.infer<typeof TodoEntrySchema>;
+/**
+ * Technical details extracted from conversation.
+ */
+declare const TechnicalDetailsSchema: z.ZodObject<{
+  files: z.ZodArray<z.ZodString>;
+  schemas: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  apis: z.ZodArray<z.ZodString>;
+  config: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+type TechnicalDetails = z.infer<typeof TechnicalDetailsSchema>;
+/**
+ * Full extracted context from compression.
+ * This is the structured JSON that replaces raw conversation.
+ */
+declare const ExtractedContextSchema: z.ZodObject<{
+  resolved_items: z.ZodArray<z.ZodString>;
+  known_bugs: z.ZodArray<z.ZodObject<{
+    issue: z.ZodString;
+    location: z.ZodString;
+    impact: z.ZodString;
+  }, z.core.$strip>>;
+  todos: z.ZodArray<z.ZodObject<{
+    issue: z.ZodString;
+    location: z.ZodString;
+    priority: z.ZodOptional<z.ZodEnum<{
+      low: "low";
+      medium: "medium";
+      high: "high";
+    }>>;
+  }, z.core.$strip>>;
+  key_decisions_and_rationale: z.ZodArray<z.ZodString>;
+  technical_details: z.ZodObject<{
+    files: z.ZodArray<z.ZodString>;
+    schemas: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    apis: z.ZodArray<z.ZodString>;
+    config: z.ZodRecord<z.ZodString, z.ZodString>;
+  }, z.core.$strip>;
+  constraints_and_requirements: z.ZodArray<z.ZodString>;
+  current_state: z.ZodString;
+  roadmap: z.ZodArray<z.ZodString>;
+  data_flows: z.ZodArray<z.ZodString>;
+  component_interactions: z.ZodRecord<z.ZodString, z.ZodString>;
+  key_files: z.ZodRecord<z.ZodString, z.ZodString>;
+  helpful_hint: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ExtractedContext = z.infer<typeof ExtractedContextSchema>;
+/**
+ * Compression event for audit trail.
+ */
+declare const CompressionEventSchema: z.ZodObject<{
+  timestamp: z.ZodNumber;
+  type: z.ZodEnum<{
+    full: "full";
+    incremental: "incremental";
+    rehydrate: "rehydrate";
+  }>;
+  sourceTokens: z.ZodNumber;
+  resultTokens: z.ZodNumber;
+  model: z.ZodString;
+  promptVersion: z.ZodString;
+  depth: z.ZodNumber;
+}, z.core.$strip>;
+type CompressionEvent = z.infer<typeof CompressionEventSchema>;
+/**
+ * Request to compress a session.
+ */
+declare const CompressRequestSchema: z.ZodObject<{
+  sessionId: z.ZodString;
+  upToTurnId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CompressRequest = z.infer<typeof CompressRequestSchema>;
+/**
+ * Response after compression completes.
+ */
+declare const CompressResponseSchema: z.ZodObject<{
+  sessionId: z.ZodString;
+  extractedContext: z.ZodObject<{
+    resolved_items: z.ZodArray<z.ZodString>;
+    known_bugs: z.ZodArray<z.ZodObject<{
+      issue: z.ZodString;
+      location: z.ZodString;
+      impact: z.ZodString;
+    }, z.core.$strip>>;
+    todos: z.ZodArray<z.ZodObject<{
+      issue: z.ZodString;
+      location: z.ZodString;
+      priority: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+      }>>;
+    }, z.core.$strip>>;
+    key_decisions_and_rationale: z.ZodArray<z.ZodString>;
+    technical_details: z.ZodObject<{
+      files: z.ZodArray<z.ZodString>;
+      schemas: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      apis: z.ZodArray<z.ZodString>;
+      config: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>;
+    constraints_and_requirements: z.ZodArray<z.ZodString>;
+    current_state: z.ZodString;
+    roadmap: z.ZodArray<z.ZodString>;
+    data_flows: z.ZodArray<z.ZodString>;
+    component_interactions: z.ZodRecord<z.ZodString, z.ZodString>;
+    key_files: z.ZodRecord<z.ZodString, z.ZodString>;
+    helpful_hint: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  compressionEvent: z.ZodObject<{
+    timestamp: z.ZodNumber;
+    type: z.ZodEnum<{
+      full: "full";
+      incremental: "incremental";
+      rehydrate: "rehydrate";
+    }>;
+    sourceTokens: z.ZodNumber;
+    resultTokens: z.ZodNumber;
+    model: z.ZodString;
+    promptVersion: z.ZodString;
+    depth: z.ZodNumber;
+  }, z.core.$strip>;
+  newTokenCount: z.ZodNumber;
+}, z.core.$strip>;
+type CompressResponse = z.infer<typeof CompressResponseSchema>;
+/**
+ * Bus subject schemas for compression.
+ */
+declare const CompressionSchemas: {
+  /**
+   * Request compression of a session.
+   * Subject: compression.compress
+   */
+  compress: {
+    request: z.ZodObject<{
+      sessionId: z.ZodString;
+      upToTurnId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      sessionId: z.ZodString;
+      extractedContext: z.ZodObject<{
+        resolved_items: z.ZodArray<z.ZodString>;
+        known_bugs: z.ZodArray<z.ZodObject<{
+          issue: z.ZodString;
+          location: z.ZodString;
+          impact: z.ZodString;
+        }, z.core.$strip>>;
+        todos: z.ZodArray<z.ZodObject<{
+          issue: z.ZodString;
+          location: z.ZodString;
+          priority: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+          }>>;
+        }, z.core.$strip>>;
+        key_decisions_and_rationale: z.ZodArray<z.ZodString>;
+        technical_details: z.ZodObject<{
+          files: z.ZodArray<z.ZodString>;
+          schemas: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          apis: z.ZodArray<z.ZodString>;
+          config: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>;
+        constraints_and_requirements: z.ZodArray<z.ZodString>;
+        current_state: z.ZodString;
+        roadmap: z.ZodArray<z.ZodString>;
+        data_flows: z.ZodArray<z.ZodString>;
+        component_interactions: z.ZodRecord<z.ZodString, z.ZodString>;
+        key_files: z.ZodRecord<z.ZodString, z.ZodString>;
+        helpful_hint: z.ZodArray<z.ZodString>;
+      }, z.core.$strip>;
+      compressionEvent: z.ZodObject<{
+        timestamp: z.ZodNumber;
+        type: z.ZodEnum<{
+          full: "full";
+          incremental: "incremental";
+          rehydrate: "rehydrate";
+        }>;
+        sourceTokens: z.ZodNumber;
+        resultTokens: z.ZodNumber;
+        model: z.ZodString;
+        promptVersion: z.ZodString;
+        depth: z.ZodNumber;
+      }, z.core.$strip>;
+      newTokenCount: z.ZodNumber;
+    }, z.core.$strip>;
+  };
+  /**
+   * Get compression history for a session.
+   * Subject: compression.getHistory
+   */
+  getHistory: {
+    request: z.ZodObject<{
+      sessionId: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      events: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodNumber;
+        type: z.ZodEnum<{
+          full: "full";
+          incremental: "incremental";
+          rehydrate: "rehydrate";
+        }>;
+        sourceTokens: z.ZodNumber;
+        resultTokens: z.ZodNumber;
+        model: z.ZodString;
+        promptVersion: z.ZodString;
+        depth: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+};
+//#endregion
+export { CompressResponse as a, CompressionEventSchema as c, ExtractedContextSchema as d, TechnicalDetails as f, TodoEntrySchema as h, CompressRequestSchema as i, CompressionSchemas as l, TodoEntry as m, BugEntrySchema as n, CompressResponseSchema as o, TechnicalDetailsSchema as p, CompressRequest as r, CompressionEvent as s, BugEntry as t, ExtractedContext as u };

package/dist/server-lifecycle-Cf_SZ27k.d.mts

@@ -0,0 +1,160 @@
+import { BusTransport, IMakaioBus } from "@makaio/framework/bus";
+import { TransportAuth, WebSocketServerLike } from "@makaio/framework/node/transports";
+
+//#region packages/bus-server/src/types.d.ts
+/**
+ * Configuration for creating a bus server instance.
+ */
+interface BusServerConfig {
+  /**
+   * WebSocket server instance (e.g., from 'ws' package).
+   */
+  websocket: WebSocketServerLike;
+  /**
+   * Optional bus instance (defaults to global singleton).
+   *
+   * Useful for tests or custom contexts.
+   */
+  bus?: IMakaioBus;
+  /**
+   * Optional authentication provider for connection validation.
+   */
+  auth?: TransportAuth;
+  /**
+   * Enable debug logging.
+   *
+   * Defaults to false.
+   */
+  debug?: boolean;
+  /**
+   * Registry name for the loopback relay transport.
+   *
+   * When set, a loopback transport is registered under this name alongside
+   * the primary `'websocket'` transport. This enables cross-client relay:
+   * when a WebSocket client sends a request, the relay excludes `'websocket'`
+   * as the source but still reaches this loopback target, whose `send()`
+   * routes the request to subscribed clients on the same server.
+   */
+  loopbackName?: string;
+}
+/**
+ * Bus server instance with lifecycle management.
+ *
+ * Provides a clean API for starting/stopping the server and accessing
+ * the underlying transport.
+ */
+interface BusServer {
+  /**
+   * The underlying transport instance.
+   *
+   * Use this to access transport-specific functionality or for testing.
+   */
+  transport: BusTransport;
+  /**
+   * Start accepting WebSocket connections.
+   *
+   * This registers the transport with MakaioBus and begins listening
+   * for client connections.
+   * @throws Error if start is called when already started
+   */
+  start(): Promise<void>;
+  /**
+   * Stop accepting connections and disconnect all clients.
+   *
+   * This unregisters the transport from MakaioBus and closes all
+   * active connections.
+   */
+  stop(): Promise<void>;
+  /**
+   * Get the current number of fully authenticated and connected clients.
+   * @returns Number of connected clients
+   */
+  getConnectionCount(): number;
+}
+//#endregion
+//#region packages/bus-server/src/server-lifecycle.d.ts
+/**
+ * Options for starting the bus server.
+ */
+interface StartBusServerOptions {
+  /**
+   * WebSocket server instance.
+   *
+   * Accepts any {@link WebSocketServerLike} implementation, including the
+   * concrete `ws.WebSocketServer` and {@link HonoWebSocketBridge}.
+   */
+  websocket: WebSocketServerLike;
+  /**
+   * Shared secret for HMAC authentication.
+   *
+   * Optional. When omitted and `auth` is not provided, no authentication is
+   * enforced (dev mode). Ignored when `auth` is provided.
+   * IMPORTANT: Use a strong secret in production.
+   */
+  secret?: string;
+  /**
+   * Custom auth strategy.
+   *
+   * When provided, bypasses the default HMAC auth creation from `secret`.
+   * Use this to supply a `DispatchingAuth` (or any other `TransportAuth`)
+   * when multiple auth protocols must be supported on a single port.
+   */
+  auth?: TransportAuth;
+  /**
+   * Enable debug logging.
+   *
+   * Defaults to false.
+   */
+  debug?: boolean;
+  /**
+   * Optional bus instance (defaults to global singleton).
+   *
+   * Use this when you have a runtime-specific bus instance.
+   */
+  bus?: IMakaioBus;
+  /**
+   * Registry name for the loopback relay transport.
+   *
+   * When set, a loopback transport is registered under this name alongside
+   * the primary `'websocket'` transport. This enables cross-client relay:
+   * when a WebSocket client sends a request, the relay excludes `'websocket'`
+   * as the source but still reaches this loopback target, whose `send()`
+   * routes the request to subscribed clients on the same server.
+   */
+  loopbackName?: string;
+}
+/**
+ * Start the bus server with WebSocket transport.
+ *
+ * This function:
+ * 1. Resolves the auth strategy: explicit `auth` option, then `secret`-based HMAC, then none
+ * 2. Creates and starts the bus server
+ * 3. Returns the server instance for lifecycle management
+ *
+ * NOTE: Adapters should be initialized separately via MakaioRuntime
+ * before calling this function. The runtime handles adapter discovery,
+ * loading, and registration with MakaioBus.
+ * @param options - Server configuration options
+ * @returns BusServer instance with start/stop/getConnectionCount methods
+ * @throws Error if server startup fails
+ * @example
+ * ```typescript
+ * import { WebSocketServer } from 'ws';
+ * import { startBusServer } from '@makaio/framework/node/bus-server/server-lifecycle';
+ *
+ * const wss = new WebSocketServer({ port: 3000 });
+ * const busServer = await startBusServer({
+ *   websocket: wss,
+ *   secret: process.env.BUS_SECRET,
+ *   debug: true,
+ * });
+ *
+ * console.debug('Connected clients:', busServer.getConnectionCount());
+ *
+ * // Later...
+ * await busServer.stop();
+ * ```
+ */
+declare function startBusServer(options: StartBusServerOptions): Promise<BusServer>;
+//#endregion
+export { BusServerConfig as i, startBusServer as n, BusServer as r, StartBusServerOptions as t };