@orgloop/core 0.1.5 → 0.1.7

package/README.md

@@ -1,6 +1,6 @@
 # @orgloop/core
 
-OrgLoop runtime engine -- library-first event routing for autonomous AI organizations. Load a config, wire up sources/actors/transforms/loggers, and run the event loop.
+OrgLoop runtime engine -- library-first event routing for autonomous AI organizations. Multi-module runtime with independent module lifecycle, shared infrastructure, and backward-compatible single-module API.
 
 ## Install
 
@@ -10,34 +10,67 @@ npm install @orgloop/core
 
 ## Usage
 
+### Multi-module (Runtime)
+
 ```typescript
-import { OrgLoop, loadConfig, InMemoryBus } from '@orgloop/core';
+import { Runtime, InMemoryBus } from '@orgloop/core';
 
-// Load and validate an orgloop.yaml
-const config = await loadConfig('./orgloop.yaml');
+const runtime = new Runtime({ bus: new InMemoryBus() });
+await runtime.start();
 
-// Create and start the engine
-const engine = new OrgLoop({
-  config,
-  bus: new InMemoryBus(),
-  sources: { github: myGitHubSource },
-  actors: { reviewer: myReviewerActor },
-});
+// Load modules dynamically
+await runtime.loadModule(
+  { name: 'engineering', sources: [...], actors: [...], routes: [...], transforms: [], loggers: [] },
+  { sources: mySourcesMap, actors: myActorsMap }
+);
+
+// Load more modules without restarting
+await runtime.loadModule(anotherModuleConfig, anotherConnectors);
+
+// Manage modules at runtime
+await runtime.reloadModule('engineering');
+await runtime.unloadModule('engineering');
+
+await runtime.stop();
+```
+
+### Single-module (OrgLoop wrapper)
 
-await engine.start();
+```typescript
+import { OrgLoop, loadConfig } from '@orgloop/core';
+
+// Backward-compatible API -- creates a Runtime with one "default" module
+const config = await loadConfig('./orgloop.yaml');
+const loop = new OrgLoop(config, {
+  sources: mySourcesMap,
+  actors: myActorsMap,
+});
 
-// Later...
-await engine.stop();
+await loop.start();
+await loop.stop();
 ```
 
 ## API
 
-### Engine
+### Runtime (multi-module)
 
-- `OrgLoop` -- main engine class (extends EventEmitter)
+- `Runtime` -- multi-module runtime class (extends EventEmitter)
+- `RuntimeOptions` -- runtime constructor options (bus, httpPort, circuitBreaker, dataDir)
+- `LoadModuleOptions` -- options for loadModule() (sources, actors, transforms, loggers, checkpointStore)
+
+### Engine (single-module wrapper)
+
+- `OrgLoop` -- backward-compatible wrapper around Runtime (extends EventEmitter)
 - `OrgLoopOptions` -- engine constructor options
 - `EngineStatus` -- runtime status type
 
+### Module lifecycle
+
+- `ModuleInstance` -- per-module resource container with lifecycle (loading/active/unloading/removed)
+- `ModuleRegistry` -- singleton module name registry
+- `ModuleConfig` -- module configuration type
+- `ModuleContext` -- module-scoped context
+
 ### Config
 
 - `loadConfig(path, options?)` -- load and validate YAML config with env var substitution
@@ -62,11 +95,12 @@ await engine.stop();
 
 - `Scheduler` -- manages poll intervals with graceful start/stop
 - `LoggerManager` -- fan-out to multiple loggers, error-isolated
-- `WebhookServer` -- HTTP server for webhook-based sources
+- `WebhookServer` -- HTTP server for webhook sources and control API
 
 ### Errors
 
 - `OrgLoopError`, `ConfigError`, `ConnectorError`, `TransformError`, `DeliveryError`, `SchemaError`
+- `ModuleConflictError`, `ModuleNotFoundError`, `RuntimeError`
 
 ## Documentation
 

package/dist/engine.d.ts

@@ -1,14 +1,17 @@
 /**
- * OrgLoop — the main runtime engine.
+ * OrgLoop — backward-compatible wrapper around Runtime.
  *
  * Library-first API:
  *   const loop = new OrgLoop(config);
  *   await loop.start();
  *   await loop.stop();
+ *
+ * Internally delegates to a Runtime instance, converting the flat
+ * OrgLoopConfig into a single module. Preserves the original public API
+ * for existing callers and tests.
  */
 import { EventEmitter } from 'node:events';
-import type { ActorConnector, Logger, OrgLoopConfig, OrgLoopEvent, SourceConnector, SourceHealthState } from '@orgloop/sdk';
-import type { Transform } from '@orgloop/sdk';
+import type { ActorConnector, Logger, OrgLoopConfig, OrgLoopEvent, SourceConnector, SourceHealthState, Transform } from '@orgloop/sdk';
 import type { EventBus } from './bus.js';
 import { LoggerManager } from './logger.js';
 import type { CheckpointStore } from './store.js';
@@ -57,22 +60,9 @@ export interface OrgLoopEvents {
 }
 export declare class OrgLoop extends EventEmitter {
     private readonly config;
-    private readonly sources;
-    private readonly actors;
-    private readonly packageTransforms;
-    private readonly resolvedLoggers;
-    private readonly bus;
-    private readonly checkpointStore;
-    private readonly loggerManager;
-    private readonly scheduler;
-    private readonly httpPort;
-    private webhookServer;
-    private readonly webhookSources;
-    private running;
-    private startedAt;
-    private readonly healthStates;
-    private readonly circuitBreakerOpts;
-    private readonly circuitRetryTimers;
+    private readonly runtime;
+    private readonly moduleConfig;
+    private readonly loadOptions;
     constructor(config: OrgLoopConfig, options?: OrgLoopOptions);
     /**
      * Start the engine: initialize connectors, start scheduler, begin processing.
@@ -96,14 +86,10 @@ export declare class OrgLoop extends EventEmitter {
      * Get health state for all sources.
      */
     health(): SourceHealthState[];
-    private pollSource;
     /**
-     * Schedule a single retry poll after the backoff period.
-     * If it succeeds, resume normal polling. If not, stay in circuit-open state.
+     * Internal: poll a single source (used by health-tracking tests).
+     * @internal
      */
-    private scheduleCircuitRetry;
-    private processEvent;
-    private deliverToActor;
-    private emitLog;
+    private pollSource;
 }
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACX,cAAc,EACd,MAAM,EACN,aAAa,EACb,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,2BAA2B;IAC3C,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC9B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,oEAAoE;IACpE,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,sDAAsD;IACtD,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,8BAA8B;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAID,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC;IACtB,QAAQ,EAAE,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CACf;AAQD,qBAAa,OAAQ,SAAQ,YAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAM1B;gBAEU,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc;IAqC3D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;IACH,MAAM,IAAI,YAAY;IAetB,6DAA6D;IAC7D,IAAI,OAAO,IAAI,aAAa,CAG3B;IAED;;OAEG;IACH,MAAM,IAAI,iBAAiB,EAAE;IAM7B;;;OAGG;YACW,UAAU;CAIxB"}