depa-actor 0.2.0 → 0.2.2

package/dist-cjs/dispatch/ActorDispatchAdapter.cjs

@@ -2,38 +2,123 @@
 /**
  * depa-actor — Dispatch Bridge
  *
- * Optional bridge to depa-processor DispatchEngine.
- * Only this file imports from depa-processor concepts.
- * No hard dependency — uses structural typing.
+ * Drives the depa-processor `DispatchEngine` (all 7 strategies) from the actor
+ * side. The envelope → DispatchRequest adaptation and the actor `tag` overlay
+ * live HERE, in depa-actor — the generic `DispatchEngine` / `DispatchStrategyConfig`
+ * stay free of any actor (`envelope` / `tag` / `ActorSelf`) knowledge.
+ *
+ * Two orthogonal axes:
+ *   1. `tag` — actor's first-level route (which mailbox). Selecting a handler by
+ *      tag is the actor system's job (`ActorDef.handlers[tag]`); a dispatch handler
+ *      built here is slotted UNDER a tag, so tag selection happens upstream.
+ *      `tag` is NOT a DispatchStrategyType — it is an orthogonal overlay dimension.
+ *   2. `strategy` — one of the 7 `DispatchStrategyType` values, used as the
+ *      second-level resolution within the selected tag.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDispatchHandler = createDispatchHandler;
-// ─── createDispatchHandler ───────────────────────────────────────────
+const depa_processor_1 = require("depa-processor");
+// ─── Internal helpers ────────────────────────────────────────────────
+function isStrategyConfig(routes) {
+    return routes instanceof depa_processor_1.DispatchStrategyConfig;
+}
 /**
- * Creates an ActorHandler that routes envelopes through dispatch routes.
- * Falls back to `defaultHandler` for tags not covered by any route.
+ * Build a `DispatchStrategyConfig<void>` from a plain key → handler map for the
+ * supported key-based strategies. The map values are pre-bound to `(self, envelope)`
+ * by capturing the current dispatch's `self` / `envelope` via a thunk.
  */
-function createDispatchHandler(routes, defaultHandler) {
-    // Build tag → route index for O(1) lookup
-    const tagIndex = new Map();
-    for (const route of routes) {
-        for (const tag of route.tags) {
-            tagIndex.set(tag, route);
-        }
+function buildKeyBasedConfig(strategy, routes, self, envelope) {
+    const handlerMap = new Map();
+    for (const [key, handler] of Object.entries(routes)) {
+        handlerMap.set(key, () => handler(self, envelope));
+    }
+    switch (strategy) {
+        case depa_processor_1.DispatchStrategyType.ROUTE_KEY:
+            return depa_processor_1.DispatchStrategyConfig.forRouteKeyStrategy({
+                handlerMap: handlerMap,
+            });
+        case depa_processor_1.DispatchStrategyType.ENUM:
+            return depa_processor_1.DispatchStrategyConfig.forEnumStrategy({
+                handlerMap,
+            });
+        case depa_processor_1.DispatchStrategyType.COMMAND_TABLE:
+            return depa_processor_1.DispatchStrategyConfig.forCommandStrategy({
+                commandConverter: (command) => handlerMap.has(command) ? command : null,
+                handlerExtractor: (commandEnum) => handlerMap.get(commandEnum) ?? null,
+            });
+        default:
+            throw new Error(`createDispatchHandler: strategy ${strategy} requires a prebuilt ` +
+                `DispatchStrategyConfig in 'routes' (plain key→handler maps support ` +
+                `ROUTE_KEY / ENUM / COMMAND_TABLE only).`);
+    }
+}
+/** Build the strategy-appropriate DispatchRequest from the envelope. */
+function buildRequest(strategy, envelope, extractors) {
+    const input = extractors?.inputOf ? extractors.inputOf(envelope) : envelope.payload;
+    const routeKey = extractors?.routeKeyOf
+        ? extractors.routeKeyOf(envelope)
+        : envelope.tag;
+    const path = extractors?.pathOf ? extractors.pathOf(envelope) : envelope.tag;
+    switch (strategy) {
+        case depa_processor_1.DispatchStrategyType.CLASS:
+            return (0, depa_processor_1.createClassDispatchRequest)(input);
+        case depa_processor_1.DispatchStrategyType.ROUTE_KEY:
+            return (0, depa_processor_1.createRouteKeyDispatchRequest)(routeKey, input, false);
+        case depa_processor_1.DispatchStrategyType.ENUM:
+            return (0, depa_processor_1.createEnumDispatchRequest)(extractors?.enumOf ? extractors.enumOf(envelope) : envelope.tag, input);
+        case depa_processor_1.DispatchStrategyType.ROUTE_KEY_TO_ENUM:
+            return (0, depa_processor_1.createRouteKeyToEnumDispatchRequest)(routeKey, input);
+        case depa_processor_1.DispatchStrategyType.COMMAND_TABLE:
+            return (0, depa_processor_1.createCommandDispatchRequest)(routeKey, input);
+        case depa_processor_1.DispatchStrategyType.PATH:
+            return (0, depa_processor_1.createPathDispatchRequest)({
+                runtime: undefined,
+                request: input,
+                path,
+            });
+        case depa_processor_1.DispatchStrategyType.ACTION_PATH:
+            return (0, depa_processor_1.createActionPathDispatchRequest)({
+                runtime: undefined,
+                request: input,
+                action: extractors?.actionOf ? extractors.actionOf(envelope) : undefined,
+                path,
+            });
+        default:
+            throw new Error(`createDispatchHandler: unknown strategy ${String(strategy)}`);
     }
+}
+// ─── createDispatchHandler ───────────────────────────────────────────
+/**
+ * Creates an ActorHandler that resolves an envelope to a sub-handler via one of
+ * the 7 depa-processor dispatch strategies (opt-in, per-handler — DX form C / B2).
+ *
+ * Object-param signature: `{ strategy, routes, defaultHandler?, extractors? }`.
+ *
+ * Composability:
+ *  - slot the returned handler under a `tag` in `ActorDef.handlers` → `tag` overlay
+ *    (first-level) + `strategy` (second-level), the two axes are orthogonal.
+ *  - the resolved sub-handler may itself be a `createPipelineHandler(...)` result,
+ *    so dispatch and pipeline nest freely.
+ *
+ * No declarative `ActorDef.dispatch` field and no global feature flag / enableXxx
+ * API exist — enabling rich dispatch is expressed purely by import + composition.
+ */
+function createDispatchHandler(params) {
+    const { strategy, routes, defaultHandler, extractors } = params;
     return async (self, envelope) => {
-        const route = tagIndex.get(envelope.tag);
-        if (route) {
-            const key = route.resolveKey(envelope);
-            const handler = route.routes[key];
-            if (handler) {
-                await handler(self, envelope);
-            }
-            else if (route.fallback) {
-                await route.fallback(self, envelope, key);
-            }
+        const config = isStrategyConfig(routes)
+            ? routes
+            : buildKeyBasedConfig(strategy, routes, self, envelope);
+        const engine = new depa_processor_1.DispatchEngine();
+        engine.registerStrategy(config);
+        const request = buildRequest(strategy, envelope, extractors);
+        const result = await engine.dispatch(request);
+        if (result.isHandled()) {
+            // Await the sub-handler's (possibly async) side effect.
+            await result.getResult();
+            return;
         }
-        else if (defaultHandler) {
+        if (defaultHandler) {
             await defaultHandler(self, envelope);
         }
     };

package/dist-cjs/index.cjs

@@ -1,8 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dispatchEffects = exports.createAiAgentSchedulerHooks = exports.scheduleOne = exports.selectNextFiberId = exports.computeEffectivePriority = exports.applyFailure = exports.reduceOrchestrator = exports.createOrchestratorState = exports.DEFAULT_ORCHESTRATOR_OPTIONS = exports.createDispatchHandler = exports.createPipelineHandler = exports.dispatchInstructions = exports.takeNextCommandFromGroup = exports.pushFrontCommandToGroup = exports.pushFrontCommand = exports.pushBackCommandToGroup = exports.pushBackCommand = exports.popSelectedCommandFromGroup = exports.popNextCommand = exports.popFrontCommand = exports.popBackCommand = exports.drainWhereCommandDequeFromGroup = exports.drainCommandDequeFromGroup = exports.defaultCommandDequeSelector = exports.createCommandDequeGroup = exports.createCommandDeque = exports.createOperandStack = exports.createInstructionStack = exports.createStackMachine = exports.createRuntimeIndexHook = exports.RuntimeIndexHook = exports.createPersistenceEffectPort = exports.createRecoveryHooks = exports.createSnapshotCodec = exports.createCompletionBindingRegistry = exports.createCompletionSignalRegistry = exports.CompletionBindingRegistry = exports.CompletionSignalRegistry = exports.ActorRuntime = exports.ActorSystem = void 0;
+exports.DEFAULT_ORCHESTRATOR_OPTIONS = exports.DispatchStrategyConfig = exports.DispatchStrategyType = exports.createDispatchHandler = exports.createPipelineHandler = exports.dispatchInstructions = exports.takeNextCommandFromGroup = exports.pushFrontCommandToGroup = exports.pushFrontCommand = exports.pushBackCommandToGroup = exports.pushBackCommand = exports.popSelectedCommandFromGroup = exports.popNextCommand = exports.popFrontCommand = exports.popBackCommand = exports.drainWhereCommandDequeFromGroup = exports.drainCommandDequeFromGroup = exports.defaultCommandDequeSelector = exports.createCommandDequeGroup = exports.createCommandDeque = exports.createOperandStack = exports.createInstructionStack = exports.createStackMachine = exports.createRuntimeIndexHook = exports.RuntimeIndexHook = exports.createPersistenceEffectPort = exports.createRecoveryHooks = exports.createSnapshotCodec = exports.createCompletionBindingRegistry = exports.createCompletionSignalRegistry = exports.CompletionBindingRegistry = exports.CompletionSignalRegistry = exports.ActorRuntime = exports.createActorRefEndpoint = exports.rebuildActorRegistrations = exports.unregisterActor = exports.dispatchActor = exports.resolveActor = exports.registerActor = exports.createLocalActorAddressingRuntime = exports.parseActorRegistrationReceipt = exports.parseActorOwnerSnapshot = exports.parseActorSelector = exports.parseActorAddress = exports.actorAddressKey = exports.ActorAddressingError = exports.ACTOR_REGISTRATION_SCHEMA_VERSION = exports.ACTOR_OWNER_SNAPSHOT_SCHEMA_VERSION = exports.ACTOR_ADDRESS_SCHEMA_VERSION = exports.ActorSystem = void 0;
+exports.dispatchEffects = exports.createAiAgentSchedulerHooks = exports.scheduleOne = exports.selectNextFiberId = exports.computeEffectivePriority = exports.applyFailure = exports.reduceOrchestrator = exports.createOrchestratorState = void 0;
 var ActorSystem_js_1 = require("./core/ActorSystem.cjs");
 Object.defineProperty(exports, "ActorSystem", { enumerable: true, get: function () { return ActorSystem_js_1.ActorSystem; } });
+var addressing_js_1 = require("./addressing.cjs");
+Object.defineProperty(exports, "ACTOR_ADDRESS_SCHEMA_VERSION", { enumerable: true, get: function () { return addressing_js_1.ACTOR_ADDRESS_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "ACTOR_OWNER_SNAPSHOT_SCHEMA_VERSION", { enumerable: true, get: function () { return addressing_js_1.ACTOR_OWNER_SNAPSHOT_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "ACTOR_REGISTRATION_SCHEMA_VERSION", { enumerable: true, get: function () { return addressing_js_1.ACTOR_REGISTRATION_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "ActorAddressingError", { enumerable: true, get: function () { return addressing_js_1.ActorAddressingError; } });
+Object.defineProperty(exports, "actorAddressKey", { enumerable: true, get: function () { return addressing_js_1.actorAddressKey; } });
+Object.defineProperty(exports, "parseActorAddress", { enumerable: true, get: function () { return addressing_js_1.parseActorAddress; } });
+Object.defineProperty(exports, "parseActorSelector", { enumerable: true, get: function () { return addressing_js_1.parseActorSelector; } });
+Object.defineProperty(exports, "parseActorOwnerSnapshot", { enumerable: true, get: function () { return addressing_js_1.parseActorOwnerSnapshot; } });
+Object.defineProperty(exports, "parseActorRegistrationReceipt", { enumerable: true, get: function () { return addressing_js_1.parseActorRegistrationReceipt; } });
+Object.defineProperty(exports, "createLocalActorAddressingRuntime", { enumerable: true, get: function () { return addressing_js_1.createLocalActorAddressingRuntime; } });
+Object.defineProperty(exports, "registerActor", { enumerable: true, get: function () { return addressing_js_1.registerActor; } });
+Object.defineProperty(exports, "resolveActor", { enumerable: true, get: function () { return addressing_js_1.resolveActor; } });
+Object.defineProperty(exports, "dispatchActor", { enumerable: true, get: function () { return addressing_js_1.dispatchActor; } });
+Object.defineProperty(exports, "unregisterActor", { enumerable: true, get: function () { return addressing_js_1.unregisterActor; } });
+Object.defineProperty(exports, "rebuildActorRegistrations", { enumerable: true, get: function () { return addressing_js_1.rebuildActorRegistrations; } });
+Object.defineProperty(exports, "createActorRefEndpoint", { enumerable: true, get: function () { return addressing_js_1.createActorRefEndpoint; } });
 var ActorRuntime_js_1 = require("./runtime/ActorRuntime.cjs");
 Object.defineProperty(exports, "ActorRuntime", { enumerable: true, get: function () { return ActorRuntime_js_1.ActorRuntime; } });
 var completion_js_1 = require("./runtime/completion.cjs");
@@ -40,6 +58,13 @@ var ActorPipeline_js_1 = require("./pipeline/ActorPipeline.cjs");
 Object.defineProperty(exports, "createPipelineHandler", { enumerable: true, get: function () { return ActorPipeline_js_1.createPipelineHandler; } });
 var ActorDispatchAdapter_js_1 = require("./dispatch/ActorDispatchAdapter.cjs");
 Object.defineProperty(exports, "createDispatchHandler", { enumerable: true, get: function () { return ActorDispatchAdapter_js_1.createDispatchHandler; } });
+// Dispatch strategy enum + the common-tier strategy config factories
+// (ROUTE_KEY / ENUM / COMMAND_TABLE). Advanced strategies (PATH / ACTION_PATH +
+// AntPathMatcher / PathActionMatchRule), manifest-* and router/ stay in
+// depa-processor and are imported directly by users who need them.
+var depa_processor_1 = require("depa-processor");
+Object.defineProperty(exports, "DispatchStrategyType", { enumerable: true, get: function () { return depa_processor_1.DispatchStrategyType; } });
+Object.defineProperty(exports, "DispatchStrategyConfig", { enumerable: true, get: function () { return depa_processor_1.DispatchStrategyConfig; } });
 var index_js_2 = require("./orchestration/index.cjs");
 Object.defineProperty(exports, "DEFAULT_ORCHESTRATOR_OPTIONS", { enumerable: true, get: function () { return index_js_2.DEFAULT_ORCHESTRATOR_OPTIONS; } });
 Object.defineProperty(exports, "createOrchestratorState", { enumerable: true, get: function () { return index_js_2.createOrchestratorState; } });

package/dist-cjs/pipeline/ActorPipeline.cjs

@@ -2,33 +2,43 @@
 /**
  * depa-actor — ActorPipeline
  *
- * Adapts the DOP 6-step pipeline (from depa-processor) to actor context.
+ * Adapts the DOP 6-step pipeline to actor context by REUSING the depa-processor
+ * `component` primitives (DEPA dimension chain Processor → Actor): the 6-step
+ * orchestration is delegated to `runByFuncStyleAdapter`, identity/null seams come
+ * from `stdMake*`, and the core-logic seam is `StdInnerLogic` verbatim — this module
+ * no longer re-implements a parallel copy of `component/types.ts`.
  *
- * Mapping:
+ * Mapping (outer dimension):
  *   OuterRuntime = ActorSelf
  *   OuterInput   = envelope payload
  *   OuterConfig  = actor state
  *
+ * Step 6 (output) is adapted with `TOuterOutput = void`: actor output is a side
+ * effect (write `self.state` / `self.send`), not a returned value. This thinly
+ * adapts depa-processor's pure-function `StdOuterOutputAdapter` without leaking
+ * actor semantics back into the generic primitive.
+ *
  * createPipelineHandler() wraps a pipeline definition into an ActorHandler.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPipelineHandler = createPipelineHandler;
+const depa_processor_1 = require("depa-processor");
 // ─── createPipelineHandler ───────────────────────────────────────────
+/**
+ * Wrap a pipeline definition into an ActorHandler by delegating the 6-step
+ * orchestration to depa-processor `runByFuncStyleAdapter`.
+ *
+ * Outer dimension: runtime = self, input = payload, config = state.
+ * Step 6 produces `void` — `runByFuncStyleAdapter` runs the output adapter for its
+ * side effects and the (void) return value is discarded.
+ */
 function createPipelineHandler(pipeline) {
     return async (self, envelope) => {
-        const payload = envelope.payload;
-        const state = self.state;
-        // Step 1: Compute derived
-        const derived = pipeline.computeDerived(self, payload, state);
-        // Step 2: Transform runtime
-        const innerRuntime = pipeline.innerRuntime(self, payload, state, derived);
-        // Step 3: Transform input
-        const innerInput = pipeline.innerInput(self, payload, state, derived);
-        // Step 4: Transform config
-        const innerConfig = pipeline.innerConfig(self, payload, state, derived);
-        // Step 5: Core logic
-        const innerOutput = await pipeline.coreLogic(innerRuntime, innerInput, innerConfig);
-        // Step 6: Output (side effects on actor state / send messages)
-        await pipeline.output(self, payload, state, derived, innerOutput);
+        // `runByFuncStyleAdapter` returns the output adapter's value verbatim (without
+        // awaiting it). Capture it and await so an async step-6 side effect (write
+        // state / send messages) is fully settled before the handler resolves —
+        // preserving the original `await pipeline.output(...)` semantics.
+        const outputResult = await (0, depa_processor_1.runByFuncStyleAdapter)(self, envelope.payload, self.state, pipeline.computeDerived, pipeline.innerRuntime, pipeline.innerInput, pipeline.innerConfig, pipeline.coreLogic, pipeline.output);
+        await outputResult;
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depa-actor",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "main": "./dist-cjs/index.cjs",
   "module": "./dist/index.js",
@@ -17,6 +17,9 @@
     "dist-cjs",
     "src"
   ],
+  "dependencies": {
+    "depa-processor": "0.1.1"
+  },
   "scripts": {
     "build": "tsc && tsc -p tsconfig.cjs.json && node scripts/build-cjs.mjs",
     "dev": "tsc --watch",