posipaki 0.24.0 → 0.26.0

package/dist/index.js

@@ -1,4 +1,4 @@
 import { i as runDispatch } from "./util-FmOqPdg-.js";
-import { a as AsyncProcess, c as asyncify, i as spawn, n as defineMessages, o as runDispatchAsync, r as Process, s as spawnAsync, t as defineActor } from "./src-DZ_eeXBA.js";
+import { a as AsyncProcess, c as asyncify, i as spawn, n as defineMessages, o as runDispatchAsync, r as Process, s as spawnAsync, t as defineActor } from "./src-tbH9wapj.js";
 import { a as stopPropagation, n as chainHook, r as mergeConfigs, t as callHook } from "./hooks-V-PEPJHv.js";
 export { AsyncProcess, Process, asyncify, callHook, chainHook, defineActor, defineMessages, mergeConfigs, runDispatch, runDispatchAsync, spawn, spawnAsync, stopPropagation };

package/dist/plugins/tree-introspection.d.ts

@@ -1,3 +1,4 @@
+import { p as AnyProcess } from "../types-RfSUSvKp.js";
 import { d as ActorPlugin } from "../hooks-rduh9LzW.js";
 
 //#region src/plugins/tree-introspection.d.ts
@@ -5,13 +6,15 @@ declare module "../index" {
   interface ActorReflection {
     "inspect.getTree": TreeReflectionMethods["inspect.getTree"];
     "inspect.getState": TreeReflectionMethods["inspect.getState"];
-    "inspect.stop": TreeReflectionMethods["inspect.stop"];
+    "inspect.find": TreeReflectionMethods["inspect.find"];
+    "inspect.exit": TreeReflectionMethods["inspect.exit"];
   }
 }
 interface TreeReflectionMethods {
   "inspect.getTree": (prefix?: string) => TreeNode;
   "inspect.getState": () => unknown;
-  "inspect.stop": () => void;
+  "inspect.find": (pname: string) => AnyProcess | null;
+  "inspect.exit": () => void;
 }
 interface TreeNode {
   pname: string;

package/dist/plugins/tree-introspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-introspection.d.ts","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"mappings":";;;;YAKY,eAAA;IACR,iBAAA,EAAmB,qBAAA;IACnB,kBAAA,EAAoB,qBAAA;IACpB,cAAA,EAAgB,qBAAA;EAAA;AAAA;AAAA,UAIV,qBAAA;EACR,iBAAA,GAAoB,MAAA,cAAoB,QAAQ;EAChD,kBAAA;EACA,cAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA;EACA,UAAA;EACA,QAAA,EAAU,QAAQ;EAClB,MAAA;AAAA;AAAA,iBAGc,OAAA,IAAW,WAAW"}
+{"version":3,"file":"tree-introspection.d.ts","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"mappings":";;;;;YAMY,eAAA;IACR,iBAAA,EAAmB,qBAAA;IACnB,kBAAA,EAAoB,qBAAA;IACpB,cAAA,EAAgB,qBAAA;IAChB,cAAA,EAAgB,qBAAA;EAAA;AAAA;AAAA,UAIV,qBAAA;EACR,iBAAA,GAAoB,MAAA,cAAoB,QAAA;EACxC,kBAAA;EACA,cAAA,GAAiB,KAAA,aAAkB,UAAU;EAC7C,cAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA;EACA,UAAA;EACA,QAAA,EAAU,QAAQ;EAClB,MAAA;AAAA;AAAA,iBAac,OAAA,IAAW,WAAW"}

package/dist/plugins/tree-introspection.js

@@ -1,5 +1,14 @@
 import { r as mergeConfigs } from "../hooks-V-PEPJHv.js";
 //#region src/plugins/tree-introspection.ts
+/** Depth-first search for a live process by its full `pname`. */
+function findProcess(procs, pname) {
+	for (const proc of procs) {
+		if (proc.pname === pname) return proc;
+		const found = findProcess(proc.children, pname);
+		if (found) return found;
+	}
+	return null;
+}
 function inspect() {
 	return async function inspectPlugin(config) {
 		return mergeConfigs(config, { $reflectionMethods: {
@@ -32,7 +41,11 @@ function inspect() {
 			"inspect.getState": function() {
 				return this.state;
 			},
-			"inspect.stop": function() {
+			"inspect.find": function(pname) {
+				const selfCtx = this.ctx;
+				return findProcess(selfCtx.children, pname);
+			},
+			"inspect.exit": function() {
 				this.exit("inspector");
 			}
 		} });

package/dist/plugins/tree-introspection.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree-introspection.js","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"sourcesContent":["import { mergeConfigs } from \"../hooks.js\";\nimport type { ActorPlugin, ActorReflection as AR } from \"../hooks.js\";\nimport { AnyProcessCtx } from \"../types.js\";\n\ndeclare module \"../index\" {\n  interface ActorReflection {\n    \"inspect.getTree\": TreeReflectionMethods[\"inspect.getTree\"];\n    \"inspect.getState\": TreeReflectionMethods[\"inspect.getState\"];\n    \"inspect.stop\": TreeReflectionMethods[\"inspect.stop\"];\n  }\n}\n\ninterface TreeReflectionMethods {\n  \"inspect.getTree\": (prefix?: string) => TreeNode;\n  \"inspect.getState\": () => unknown;\n  \"inspect.stop\": () => void;\n}\n\nexport interface TreeNode {\n  pname: string;\n  parentName: string | null;\n  children: TreeNode[];\n  status: \"running\" | \"no introspection\";\n}\n\nexport function inspect(): ActorPlugin {\n  return async function inspectPlugin(config) {\n    return mergeConfigs(config, {\n      $reflectionMethods: {\n        ...config.$reflectionMethods,\n        \"inspect.getTree\": function (prefix?: string) {\n          const children: TreeNode[] = [];\n          for (const child of this.ctx.children) {\n            const cr = child.$reflection as AR;\n            if (typeof cr[\"inspect.getTree\"] === \"function\") {\n              const sub = cr[\"inspect.getTree\"](prefix) as TreeNode;\n              if (!prefix || sub.pname.startsWith(prefix)) children.push(sub);\n            } else {\n              const n = child.pname;\n              if (!prefix || n.startsWith(prefix))\n                children.push({\n                  pname: n,\n                  parentName: this.name,\n                  children: [],\n                  status: \"no introspection\",\n                });\n            }\n          }\n          const selfCtx = this.ctx as AnyProcessCtx;\n          return {\n            pname: selfCtx.pname,\n            parentName: selfCtx.parentName,\n            children,\n            status: \"running\" as const,\n          } satisfies TreeNode;\n        },\n        \"inspect.getState\": function () {\n          const state = this.state as unknown;\n          return state;\n        },\n        \"inspect.stop\": function () {\n          this.exit(\"inspector\");\n        },\n      },\n    });\n  };\n}\n"],"mappings":";;AAyBA,SAAgB,UAAuB;CACrC,OAAO,eAAe,cAAc,QAAQ;EAC1C,OAAO,aAAa,QAAQ,EAC1B,oBAAoB;GAClB,GAAG,OAAO;GACV,mBAAmB,SAAU,QAAiB;IAC5C,MAAM,WAAuB,CAAC;IAC9B,KAAK,MAAM,SAAS,KAAK,IAAI,UAAU;KACrC,MAAM,KAAK,MAAM;KACjB,IAAI,OAAO,GAAG,uBAAuB,YAAY;MAC/C,MAAM,MAAM,GAAG,mBAAmB,MAAM;MACxC,IAAI,CAAC,UAAU,IAAI,MAAM,WAAW,MAAM,GAAG,SAAS,KAAK,GAAG;KAChE,OAAO;MACL,MAAM,IAAI,MAAM;MAChB,IAAI,CAAC,UAAU,EAAE,WAAW,MAAM,GAChC,SAAS,KAAK;OACZ,OAAO;OACP,YAAY,KAAK;OACjB,UAAU,CAAC;OACX,QAAQ;MACV,CAAC;KACL;IACF;IACA,MAAM,UAAU,KAAK;IACrB,OAAO;KACL,OAAO,QAAQ;KACf,YAAY,QAAQ;KACpB;KACA,QAAQ;IACV;GACF;GACA,oBAAoB,WAAY;IAE9B,OADc,KAAK;GAErB;GACA,gBAAgB,WAAY;IAC1B,KAAK,KAAK,WAAW;GACvB;EACF,EACF,CAAC;CACH;AACF"}
+{"version":3,"file":"tree-introspection.js","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"sourcesContent":["import { mergeConfigs } from \"../hooks.js\";\nimport type { ActorPlugin, ActorReflection as AR } from \"../hooks.js\";\nimport { AnyProcessCtx } from \"../types.js\";\nimport type { AnyProcess } from \"../process.async.js\";\n\ndeclare module \"../index\" {\n  interface ActorReflection {\n    \"inspect.getTree\": TreeReflectionMethods[\"inspect.getTree\"];\n    \"inspect.getState\": TreeReflectionMethods[\"inspect.getState\"];\n    \"inspect.find\": TreeReflectionMethods[\"inspect.find\"];\n    \"inspect.exit\": TreeReflectionMethods[\"inspect.exit\"];\n  }\n}\n\ninterface TreeReflectionMethods {\n  \"inspect.getTree\": (prefix?: string) => TreeNode;\n  \"inspect.getState\": () => unknown;\n  \"inspect.find\": (pname: string) => AnyProcess | null;\n  \"inspect.exit\": () => void;\n}\n\nexport interface TreeNode {\n  pname: string;\n  parentName: string | null;\n  children: TreeNode[];\n  status: \"running\" | \"no introspection\";\n}\n\n/** Depth-first search for a live process by its full `pname`. */\nfunction findProcess(procs: Iterable<AnyProcess>, pname: string): AnyProcess | null {\n  for (const proc of procs) {\n    if (proc.pname === pname) return proc;\n    const found = findProcess(proc.children, pname);\n    if (found) return found;\n  }\n  return null;\n}\n\nexport function inspect(): ActorPlugin {\n  return async function inspectPlugin(config) {\n    return mergeConfigs(config, {\n      $reflectionMethods: {\n        ...config.$reflectionMethods,\n        \"inspect.getTree\": function (prefix?: string) {\n          const children: TreeNode[] = [];\n          for (const child of this.ctx.children) {\n            const cr = child.$reflection as AR;\n            if (typeof cr[\"inspect.getTree\"] === \"function\") {\n              const sub = cr[\"inspect.getTree\"](prefix) as TreeNode;\n              if (!prefix || sub.pname.startsWith(prefix)) children.push(sub);\n            } else {\n              const n = child.pname;\n              if (!prefix || n.startsWith(prefix))\n                children.push({\n                  pname: n,\n                  parentName: this.name,\n                  children: [],\n                  status: \"no introspection\",\n                });\n            }\n          }\n          const selfCtx = this.ctx as AnyProcessCtx;\n          return {\n            pname: selfCtx.pname,\n            parentName: selfCtx.parentName,\n            children,\n            status: \"running\" as const,\n          } satisfies TreeNode;\n        },\n        \"inspect.getState\": function () {\n          const state = this.state as unknown;\n          return state;\n        },\n        \"inspect.find\": function (pname: string) {\n          const selfCtx = this.ctx as AnyProcessCtx;\n          return findProcess(selfCtx.children, pname);\n        },\n        \"inspect.exit\": function () {\n          this.exit(\"inspector\");\n        },\n      },\n    });\n  };\n}\n"],"mappings":";;;AA6BA,SAAS,YAAY,OAA6B,OAAkC;CAClF,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,UAAU,OAAO,OAAO;EACjC,MAAM,QAAQ,YAAY,KAAK,UAAU,KAAK;EAC9C,IAAI,OAAO,OAAO;CACpB;CACA,OAAO;AACT;AAEA,SAAgB,UAAuB;CACrC,OAAO,eAAe,cAAc,QAAQ;EAC1C,OAAO,aAAa,QAAQ,EAC1B,oBAAoB;GAClB,GAAG,OAAO;GACV,mBAAmB,SAAU,QAAiB;IAC5C,MAAM,WAAuB,CAAC;IAC9B,KAAK,MAAM,SAAS,KAAK,IAAI,UAAU;KACrC,MAAM,KAAK,MAAM;KACjB,IAAI,OAAO,GAAG,uBAAuB,YAAY;MAC/C,MAAM,MAAM,GAAG,mBAAmB,MAAM;MACxC,IAAI,CAAC,UAAU,IAAI,MAAM,WAAW,MAAM,GAAG,SAAS,KAAK,GAAG;KAChE,OAAO;MACL,MAAM,IAAI,MAAM;MAChB,IAAI,CAAC,UAAU,EAAE,WAAW,MAAM,GAChC,SAAS,KAAK;OACZ,OAAO;OACP,YAAY,KAAK;OACjB,UAAU,CAAC;OACX,QAAQ;MACV,CAAC;KACL;IACF;IACA,MAAM,UAAU,KAAK;IACrB,OAAO;KACL,OAAO,QAAQ;KACf,YAAY,QAAQ;KACpB;KACA,QAAQ;IACV;GACF;GACA,oBAAoB,WAAY;IAE9B,OADc,KAAK;GAErB;GACA,gBAAgB,SAAU,OAAe;IACvC,MAAM,UAAU,KAAK;IACrB,OAAO,YAAY,QAAQ,UAAU,KAAK;GAC5C;GACA,gBAAgB,WAAY;IAC1B,KAAK,KAAK,WAAW;GACvB;EACF,EACF,CAAC;CACH;AACF"}

package/dist/remote/index.js

@@ -1,4 +1,4 @@
-import { s as spawnAsync, t as defineActor } from "../src-DZ_eeXBA.js";
+import { s as spawnAsync, t as defineActor } from "../src-tbH9wapj.js";
 import { a as stopPropagation } from "../hooks-V-PEPJHv.js";
 import { open, unlink } from "node:fs/promises";
 import { createReadStream } from "node:fs";

package/dist/{src-DZ_eeXBA.js → src-tbH9wapj.js}

@@ -58,6 +58,11 @@ var AsyncProcess = class AsyncProcess {
 		this.pvtReady = makeWaiter();
 		this.pvtResolveReady = this.pvtReady.resolve;
 	}
+	/** Compact handle for `util.inspect` — actor state often holds process
+	*  references, and dumping the internals would be unreadable. */
+	[Symbol.for("nodejs.util.inspect.custom")]() {
+		return `AsyncProcess<${this.pname}>`;
+	}
 	/** Promise that resolves once the initial state is available. */
 	ready() {
 		return this.pvtReady.promise;
@@ -637,4 +642,4 @@ function defineActor(config) {
 //#endregion
 export { AsyncProcess as a, asyncify as c, spawn as i, defineMessages as n, runDispatchAsync as o, Process as r, spawnAsync as s, defineActor as t };
 
-//# sourceMappingURL=src-DZ_eeXBA.js.map
+//# sourceMappingURL=src-tbH9wapj.js.map

package/dist/{src-DZ_eeXBA.js.map → src-tbH9wapj.js.map}

@@ -1 +1 @@
-{"version":3,"file":"src-DZ_eeXBA.js","names":[],"sources":["../src/adapters.ts","../src/process.async.ts","../src/process.ts","../src/define-actor.ts","../src/index.ts"],"sourcesContent":["import type { ProcessFn, AsyncProcessFn, Message } from \"./types.js\"\n\nexport function asyncify<A, S, IM extends Message, OM extends Message>(\n  fn: ProcessFn<A, S, IM, OM>,\n): AsyncProcessFn<A, S, IM, OM> {\n  return async function* (ctx, args) {\n    yield* fn(ctx, args) as any\n  }\n}\n","import { defer, makeWaiter, debugLog, withTimeout } from \"./util.js\";\nimport type { DeferredCall, Waiter } from \"./util.js\";\nimport type {\n  Message,\n  WithSender,\n  SenderInfo,\n  ExitMessage,\n  StopMessage,\n  ProcessCtx,\n  AsyncProcessFn,\n  ProcessFn,\n} from \"./types.js\";\nimport { asyncify } from \"./adapters.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/** An async iterator over process state. Receives `WithSender<InMessage | StopMessage>`. */\ntype AsyncProcessGenerator<\n  ProcessState,\n  InMessage extends Message,\n> = AsyncGenerator<\n  ProcessState | null,\n  void,\n  WithSender<InMessage | StopMessage>\n>;\n\ntype NotifyFn = () => void;\n\n// ---- runDispatchAsync -------------------------------------------------------\n\ntype AsyncReducer<M> = (msg: M) => Promise<void>;\ntype ReadyFn = () => boolean;\n\n/**\n * Async equivalent of `runDispatch`. Loops, yielding `null` and feeding\n * each incoming message to an `async` reducer. Exits when `readyFn()`\n * returns true.\n */\nexport async function* runDispatchAsync<M>(\n  name: string,\n  fn: AsyncReducer<M>,\n  readyFn: ReadyFn = () => false,\n  debugLevel = false,\n): AsyncGenerator<null, void, M> {\n  let msg: M;\n  while (!readyFn()) {\n    msg = yield null;\n    debugLog(debugLevel, \"msg\", name, \" <- \", msg);\n    await fn(msg);\n  }\n}\n\n// ---- AsyncProcess -----------------------------------------------------------\n\n/** A subscriber to this process's message channel: receives the message and\n *  its sender separately (not a `WithSender` tuple). */\ntype MessageCallback<M extends Message> = (msg: M, from: SenderInfo) => void;\n\n\n/** How long a parent waits for a child to stop before continuing shutdown. */\nconst CHILD_STOP_TIMEOUT_MS = 1_000;\n\n/**\n * A process driven by an async generator. Functionally identical to\n * {@link Process} but supports `await` inside reducers.\n *\n * Messages are processed **one at a time** — if a tick is already\n * in-flight, new messages are buffered and processed when the current\n * tick completes.\n */\nexport class AsyncProcess<\n  Args,\n  State,\n  InMessage extends Message,\n  OutMessage extends Message,\n  ReflectionMethods extends object,\n> {\n  /** Reflection methods.  Empty by default — defineActor fills in configured methods. */\n  $reflection: ReflectionMethods = {} as ReflectionMethods;\n  pgenerator: AsyncProcessFn<Args, State, InMessage, OutMessage>;\n  pname: string;\n  /** Subscribers to this process's message channel (`ctx.toParent`). */\n  private messageSubscribers: Array<MessageCallback<OutMessage>> = [];\n  id: symbol;\n  state: State | null;\n\n  private current: AsyncProcessGenerator<State, InMessage> | null = null;\n  /** Every buffered message carries sender provenance. */\n  private buffer: Array<WithSender<InMessage | StopMessage>> = [];\n  private nextTick: DeferredCall | null = null;\n  /** Child processes forked from this one (any fork method). */\n  children: Array<\n    AsyncProcess<unknown, unknown, Message, Message, {}>\n  > = [];\n  /** Children inherited from a child that exited (see ctx-orphans proposal). */\n  orphans: Array<\n    AsyncProcess<unknown, unknown, Message, Message, {}>\n  > = [];\n  private stateSubscribers: Array<NotifyFn> = [];\n  /** Unsubscribe handles for outgoing message subscriptions (monitor only). */\n  private pvtOutgoingSubscriptions: Array<() => void> = [];\n  /** Unsubscribe handles for adopt (ownership) subscriptions, keyed by child id. */\n  private pvtAdoptUnsubs: Map<symbol, () => void> = new Map();\n  /** Live buffer while this process is an unowned orphan mid-handoff. */\n  private pvtPending: Array<WithSender<Message>> | null = null;\n  /** Unsubscribe for the collector currently buffering into pvtPending. */\n  private pvtCollectorUnsub: (() => void) | null = null;\n  private exitWaiter: Waiter;\n  private pvtIsPaused: boolean = false;\n  private pvtDead: boolean = false;\n  private pvtTickInProgress: boolean = false;\n  private pvtExitReject: ((e: unknown) => void) | null = null;\n  private pvtReady!: Waiter;\n  private pvtResolveReady!: () => void;\n\n  constructor(\n    fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n    pname: string,\n    toParent?: MessageCallback<OutMessage>,\n  ) {\n    this.pgenerator = fn;\n    this.pname = pname;\n    if (toParent) this.messageSubscribers.push(toParent);\n    this.id = Symbol(pname);\n    this.state = null;\n    this.exitWaiter = makeWaiter();\n    this.pvtReady = makeWaiter();\n    this.pvtResolveReady = this.pvtReady.resolve;\n  }\n\n  /** Promise that resolves once the initial state is available. */\n  ready(): Promise<void> {\n    return this.pvtReady.promise;\n  }\n\n  // ---- lifecycle ------------------------------------------------------------\n\n  /**\n   * Kick off the async generator. The first `yield` sets the initial\n   * state; for async generators this happens in a microtask.\n   */\n  start(arg0: Args, parentName?: string | null, parentId?: symbol | null) {\n    const selfCtx: SenderInfo = { fromName: this.pname, fromId: this.id };\n\n    const ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage> = {\n      pname: this.pname,\n      id: this.id,\n      parentName: parentName ?? null,\n      parentId: parentId ?? null,\n      fork: this.fork.bind(this),\n      forkSync: this.forkSync.bind(this),\n      children: this.children,\n      orphans: this.orphans,\n      adopt: this.adopt.bind(this),\n      monitor: this.monitor.bind(this),\n      sendSelf: (msg) => {\n        this.send([msg, selfCtx]);\n      },\n      toParent: (msg) => {\n        this.messageSubscribers.forEach((cb) => cb(msg as OutMessage, selfCtx));\n      },\n    };\n\n    this.current = this.pvtWatchExit(ctx, arg0);\n    void this.current.next().then((ret: IteratorResult<State | null, void>) => {\n      this.state = ret.value ?? null;\n      this.pvtResolveReady();\n      if (ret.done) {\n        this.exitWaiter.resolve();\n        return;\n      }\n      // Advance past the initial yield so the pvtWatchExit generator\n      // runs its finally block (EXIT/STOP) and the inner generator\n      // enters its dispatch loop.\n      const advance: WithSender<InMessage | StopMessage> = [\n        { type: \"__ADVANCE__\" } as InMessage,\n        {\n          fromName: \"__internal__\",\n          fromId: Symbol(\"__internal__\"),\n        } as SenderInfo,\n      ];\n      this.pvtEatResult(this.current!.next(advance));\n    });\n    return this;\n  }\n\n  /** Wrap the user's generator so EXIT/STOP logic fires on completion. */\n  private async *pvtWatchExit(\n    ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage>,\n    arg0: Args,\n  ): AsyncProcessGenerator<State, InMessage> {\n    try {\n      yield* this.pgenerator(ctx, arg0);\n    } finally {\n      // Cascade: stop every child (nice) and collect the refusers as orphans.\n      const orphans: Array<AnyProcess> = [...this.orphans];\n      const parentSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      const stopPromises = this.children.map(async (child) => {\n        const stopped = await child.stop({ from: parentSender });\n        if (!stopped) {\n          orphans.push(child);\n          console.warn(\n            `posipaki: child \"${child.pname}\" did not stop within ${CHILD_STOP_TIMEOUT_MS}ms; continuing shutdown`,\n          );\n        }\n      });\n\n      await Promise.all(stopPromises);\n      // Hand surviving children and inherited orphans up to the parent for adoption (see ctx-orphans proposal).\n      // In-process only.\n      this.pvtPrepareHandoff(orphans);\n      ctx.toParent({ type: \"EXIT\", orphans });\n      // Unsubscribe from children/monitored processes so a dead parent\n      // doesn't keep receiving their messages (handoff collectors stay on the orphans).\n      this.pvtUnsubscribeAll();\n      if (ctx.afterExit) await ctx.afterExit();\n    }\n  }\n\n  // ---- fork -----------------------------------------------------------------\n\n  fork<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    fn: AsyncProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (\n    args: ChildArgs,\n  ) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return (args: ChildArgs) => {\n      const child = new AsyncProcess<\n        ChildArgs,\n        ChildState,\n        ChildIM,\n        ChildOM,\n        {}\n      >(fn, pname);\n      this.adopt(child);\n      child.start(args, this.pname, this.id);\n      return child;\n    };\n  }\n\n  forkSync<\n    ChildArgs,\n    ChildState,\n    ChildIM extends Message,\n    ChildOM extends InMessage,\n  >(\n    fn: ProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (\n    args: ChildArgs,\n  ) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return this.fork(asyncify(fn), pname);\n  }\n\n  // ---- message processing ---------------------------------------------------\n\n  protected async pvtTick(): Promise<void> {\n    if (!this.current || this.pvtTickInProgress) return;\n\n    this.pvtTickInProgress = true;\n    try {\n      let msgAndSender: WithSender<InMessage | StopMessage> | undefined;\n      let ret: IteratorResult<State | null, void> | null = null;\n      while ((msgAndSender = this.buffer.shift()) !== undefined) {\n        ret = await this.pvtSafeNext(msgAndSender);\n        if (!ret || ret.done) break;\n      }\n      this.notify();\n      this.pvtEatResult(ret);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n    } finally {\n      this.pvtTickInProgress = false;\n    }\n  }\n\n  /** Call `.next()` and redirect unhandled rejections. */\n  private async pvtSafeNext(\n    msgAndSender: WithSender<InMessage | StopMessage>,\n  ): Promise<IteratorResult<State | null, void> | null> {\n    try {\n      return await this.current!.next(msgAndSender);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n      return { done: true, value: undefined };\n    }\n  }\n\n  private pvtEatResult(\n    ret:\n      | IteratorResult<State | null, void>\n      | Promise<IteratorResult<State | null, void>>\n      | null,\n  ): void {\n    if (!ret) return;\n    Promise.resolve(ret).then((r) => {\n      if (r.done) {\n        this.exitWaiter.resolve();\n      }\n    });\n  }\n\n  /** Broadcast a message to all children. */\n  toAllChildren(msg: Message): void {\n    const stamp: SenderInfo = { fromName: this.pname, fromId: this.id };\n    this.children.forEach((p) => p.send([msg, stamp] as WithSender<Message>));\n  }\n\n  /** Stamp and enqueue a message from a named sender (external API). */\n  send(msg: InMessage | StopMessage, from?: SenderInfo): void;\n  /** Enqueue a pre-stamped message (internal: fromChild, toAllChildren). */\n  send(msgAndSender: WithSender<InMessage | StopMessage>): void;\n  send(\n    msgOrTuple: InMessage | StopMessage | WithSender<InMessage | StopMessage>,\n    from?: SenderInfo,\n  ): void {\n    if (this.pvtDead) return;\n    if (\"type\" in msgOrTuple) {\n      this.buffer.push([\n        msgOrTuple as InMessage | StopMessage,\n        from as SenderInfo,\n      ]);\n    } else {\n      this.buffer.push(msgOrTuple as WithSender<InMessage | StopMessage>);\n    }\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Synchronously flush the buffer. For sync processes use {@link Process.tick};\n   * for async processes this is **not guaranteed** to process everything\n   * immediately if reducers contain `await`. Prefer `send()` + `await proc.wait()`.\n   */\n  tick(): void {\n    this.nextTick?.flush();\n    this.nextTick = null;\n  }\n\n  private pvtScheduleTick(): void {\n    if (this.pvtIsPaused || this.pvtDead) return;\n\n    this.nextTick?.cancel();\n    this.nextTick = defer(() => {\n      this.nextTick = null;\n      void this.pvtTick();\n    });\n  }\n\n  // ---- subscribers ----------------------------------------------------------\n\n  notify(): void {\n    this.stateSubscribers.forEach((f) => f());\n  }\n\n  get isListenedTo(): boolean {\n    return this.stateSubscribers.length > 0;\n  }\n\n  subscribe(channel: \"message\", cb: MessageCallback<OutMessage>): () => void;\n  subscribe(channel: \"state\", cb: NotifyFn): () => void;\n  /** @deprecated Use `subscribe(\"state\", cb)`. */\n  subscribe(cb: NotifyFn): () => void;\n  subscribe(\n    channelOrCb: \"message\" | \"state\" | NotifyFn,\n    cb?: MessageCallback<OutMessage> | NotifyFn,\n  ): () => void {\n    if (typeof channelOrCb === \"function\") {\n      return this.subscribe(\"state\", channelOrCb);\n    }\n    if (channelOrCb === \"message\") {\n      const fn = cb as MessageCallback<OutMessage>;\n      this.messageSubscribers.push(fn);\n      return () => this.pvtUnsubscribe(this.messageSubscribers, fn);\n    }\n    const fn = cb as NotifyFn;\n    this.stateSubscribers.push(fn);\n    return () => this.pvtUnsubscribe(this.stateSubscribers, fn);\n  }\n\n  private pvtUnsubscribe<T>(list: Array<T>, fn: T): void {\n    const idx = list.indexOf(fn);\n    if (idx >= 0) list.splice(idx, 1);\n  }\n\n  // ---- pause / resume -------------------------------------------------------\n\n  /**\n   * Freeze dispatch: no further ticks are scheduled, so the process stops\n   * *processing* incoming messages.  This is half-working as a \"quiesce\"\n   * primitive — it does not stop the process from *emitting* via async\n   * callbacks (timers, fetch) that bypass the dispatch loop.\n   */\n  pause(): void {\n    this.nextTick?.cancel();\n    this.nextTick = null;\n    this.pvtIsPaused = true;\n  }\n\n  resume(): void {\n    this.pvtIsPaused = false;\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Hard-kill this process: abandon the generator without running its\n   * `finally` (no EXIT, no STOP cascade), drop the inbox and observers,\n   * unsubscribe from children/monitors, and settle `wait()`/`ready()`.\n   *\n   * There is nothing to observe afterward — callers remove the process from\n   * their `children`/`orphans` lists imperatively.  Does not cascade to this\n   * process's own children; they are abandoned (force-stop them separately if\n   * owned).\n   *\n   * Best-effort: an idle generator (suspended at `yield`) is abandoned\n   * cleanly; a generator mid-`await` completes its `finally` when that await\n   * settles, because JS offers no way to cancel a pending promise.\n   */\n  forceStop(opts?: { cascade?: boolean }): void {\n    if (this.pvtDead) return;\n    this.pvtDead = true;\n\n    // Abandon the generator so its finally block never runs.\n    this.current = null;\n\n    // Drop the inbox and stop scheduling.\n    this.buffer.length = 0;\n    this.nextTick?.cancel();\n    this.nextTick = null;\n\n    // Release incoming observers and outgoing subscriptions.\n    this.messageSubscribers.length = 0;\n    this.stateSubscribers.length = 0;\n    this.pvtUnsubscribeAll();\n    // Drop any handoff state this process carried as an unowned orphan.\n    this.unparent();\n\n    // Settle waiters.\n    this.pvtResolveReady();\n    this.exitWaiter.resolve();\n    this.pvtExitReject = null;\n\n    if (opts?.cascade) {\n      // Stop the children too, starting with the nice stop (fire-and-forget:\n      // the hard kill itself does not block on their graceful exit).\n      const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      for (const child of this.children) {\n        void child.stop({ force: true, from: selfSender }).catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Stop this process.  Sends STOP (the nice way — the generator cooperates\n   * and its `finally` runs) and awaits on a best-effort basis.\n   *\n   * With `{ force: true }`, when the process refuses (does not exit within the\n   * timeout) it escalates: fires `generator.return()` *without awaiting* (throw\n   * the generator away for GC to find), cascades to children with the same\n   * ladder, then hard-kills itself.\n   *\n   * Resolves `true` if the process stopped (gracefully or forced), `false` if\n   * it refused and `force` was not requested.\n   */\n  async stop(opts?: { force?: boolean; from?: SenderInfo }): Promise<boolean> {\n    if (this.pvtDead) return true;\n\n    this.send({ type: \"STOP\" } as StopMessage, opts?.from);\n\n    try {\n      await withTimeout(this.wait(), CHILD_STOP_TIMEOUT_MS, 'stop');\n      return true;\n    } catch (e) {\n      if ((e as Error)?.message !== 'Timeout:stop') throw e;\n      // refused to stop within the timeout\n    }\n\n    if (!opts?.force) return false;\n\n    // Escalate: give the finally a chance to run (fire-and-forget), but do not\n    // block on it — the process may be stuck awaiting a dead promise.\n    void this.current?.return(undefined);\n\n    // Cascade to children with the same ladder, stamped from this process.\n    const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n    await Promise.all(\n      [...this.children].map((child) => child.stop({ force: true, from: selfSender })),\n    );\n\n    this.forceStop();\n    return true;\n  }\n\n  // ---- waiting --------------------------------------------------------------\n\n  /**\n   * Returns a promise that resolves when the generator completes, or\n   * rejects if an unhandled error occurs during message processing.\n   */\n  wait(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      this.pvtExitReject = reject;\n\n      this.exitWaiter.promise.then(\n        () => {\n          this.pvtExitReject = null;\n          resolve();\n        },\n        (e) => {\n          this.pvtExitReject = null;\n          reject(e);\n        },\n      );\n    });\n  }\n\n  // ---- child messages -------------------------------------------------------\n\n  /**\n   * Tap another process's message channel: every message it emits is fed\n   * into this process's incoming queue.  No ownership — the sender's EXIT\n   * does not touch `children`/`orphans`.\n   */\n  monitor<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.send([msg, from] as WithSender<InMessage | StopMessage>);\n    });\n    this.pvtOutgoingSubscriptions.push(unsub);\n    return unsub;\n  }\n\n  /**\n   * Claim another process as a child: its messages are routed here and its\n   * EXIT removes it from `children` (collecting its orphans).  Generalizes\n   * what `fork` does — used for both spawning and orphan adoption.\n   */\n  adopt<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    this.children.push(child as unknown as AnyProcess);\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.pvtChildMessage(msg, from);\n    });\n    this.pvtAdoptUnsubs.set(child.id, unsub);\n    // Lossless handoff: drain a pending buffer left by the previous parent.\n    this.pvtDrainPending(child as unknown as AnyProcess);\n    return unsub;\n  }\n\n  /** Handles a child's emitted message: EXIT cleanup + forward to the queue. */\n  private pvtChildMessage(msg: Message, sender: SenderInfo): void {\n    if (msg.type === \"EXIT\") {\n      // sender.fromId === child's id (stamped by the child's ctx.toParent)\n      // Mutate in place so ctx.children (a live reference) stays consistent.\n      const idx = this.children.findIndex((p) => p.id === sender.fromId);\n      if (idx >= 0) this.children.splice(idx, 1);\n      const orphans = (msg as ExitMessage).orphans;\n      if (orphans && orphans.length > 0) {\n        this.orphans.push(...orphans);\n      }\n    }\n    this.send([msg, sender] as WithSender<InMessage | StopMessage>);\n  }\n\n  // ---- orphan handoff -------------------------------------------------------\n\n  /** Unsubscribe from all outgoing subscriptions (monitors + adopt). */\n  private pvtUnsubscribeAll(): void {\n    for (const unsub of this.pvtOutgoingSubscriptions) unsub();\n    this.pvtOutgoingSubscriptions = [];\n    for (const unsub of this.pvtAdoptUnsubs.values()) unsub();\n    this.pvtAdoptUnsubs.clear();\n  }\n\n  /** Prepare surviving children and inherited orphans for a lossless handoff:\n   *  recover undrained messages and install a collector on each orphan. */\n  private pvtPrepareHandoff(orphans: Array<AnyProcess>): void {\n    for (const orphan of orphans) {\n      this.pvtBackFeed(orphan);\n      if (!orphan.pvtCollectorUnsub) {\n        this.pvtSwapToCollector(orphan);\n      }\n    }\n  }\n\n  /** Recover messages the orphan emitted into my inbox that I never drained. */\n  private pvtBackFeed(orphan: AnyProcess): void {\n    const fromOrphan: Array<WithSender<Message>> = [];\n    this.buffer = this.buffer.filter((entry) => {\n      if (entry[1].fromId === orphan.id) {\n        fromOrphan.push(entry);\n        return false;\n      }\n      return true;\n    });\n    if (fromOrphan.length === 0) return;\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    orphan.pvtPending.unshift(...fromOrphan);\n  }\n\n  /** Replace my ownership subscription to `orphan` with a handoff collector. */\n  private pvtSwapToCollector(orphan: AnyProcess): void {\n    const mine = this.pvtAdoptUnsubs.get(orphan.id);\n    if (mine) {\n      mine();\n      this.pvtAdoptUnsubs.delete(orphan.id);\n    }\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    const pending = orphan.pvtPending;\n    orphan.pvtCollectorUnsub = orphan.subscribe(\"message\", (msg, from) => {\n      pending.push([msg, from]);\n    });\n  }\n\n  /** Drain a handed-off orphan's pending buffer into my inbox (lossless adopt). */\n  private pvtDrainPending(orphan: AnyProcess): void {\n    if (orphan.pvtCollectorUnsub) {\n      orphan.pvtCollectorUnsub();\n      orphan.pvtCollectorUnsub = null;\n    }\n    const pending = orphan.pvtPending;\n    if (!pending) return;\n    orphan.pvtPending = null;\n    for (const [msg, from] of pending) {\n      this.pvtChildMessage(msg, from);\n    }\n  }\n\n  /**\n   * Drop this process's handoff state (collector + pending buffer) without\n   * stopping it.  Used by `onOrphan`'s \"unparent\" decision: the orphan keeps\n   * running and stays in the orphans list, but its in-flight buffer is gone.\n   */\n  unparent(): void {\n    if (this.pvtCollectorUnsub) {\n      this.pvtCollectorUnsub();\n      this.pvtCollectorUnsub = null;\n    }\n    this.pvtPending = null;\n  }\n}\nexport type AnyProcess = AsyncProcess<unknown, unknown, Message, Message, {}>;\n// ---- spawnAsync -------------------------------------------------------------\n\n/**\n * Spawn a new async process. Accepts both sync and async process\n * functions — sync ones are automatically wrapped with {@link asyncify}.\n */\nexport function spawnAsync<\n  Args,\n  State,\n  InMessage extends Message = Message,\n  OutMessage extends Message = ExitMessage,\n>(\n  fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n  pname: string,\n  toParent?: MessageCallback<OutMessage>,\n): (args: Args) => AsyncProcess<Args, State, InMessage, OutMessage, {}> {\n  return (args: Args) => {\n    const proc = new AsyncProcess<Args, State, InMessage, OutMessage, {}>(\n      fn,\n      pname,\n      toParent,\n    );\n    proc.start(args);\n    return proc;\n  };\n}\n","import { AsyncProcess } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\nimport type { Message, SenderInfo, ExitMessage, ProcessFn } from \"./types.js\";\n\nexport type { Message, ProcessFn, ProcessCtx } from \"./types.js\";\nexport { runDispatch } from \"./util.js\";\n\n/** @deprecated Use {@link spawnAsync} instead. */\nexport function spawn<\n  A,\n  S,\n  IM extends Message = Message,\n  OM extends Message = ExitMessage,\n>(\n  fn: ProcessFn<A, S, IM, OM>,\n  pname: string,\n  tp?: (m: OM, from: SenderInfo) => void,\n): (a: A) => Process<A, S, IM, OM> {\n  return (a: A) => new Process(fn, pname, tp).start(a);\n}\n\n/** @deprecated Use {@link AsyncProcess} instead. Sync processes are\n *  wrapped via asyncify internally; spawnAsync handles both. */\nclass Process<\n  A,\n  S,\n  IM extends Message,\n  OM extends Message,\n> extends AsyncProcess<A, S, IM, OM, {}> {\n  constructor(\n    fn: ProcessFn<A, S, IM, OM>,\n    pname: string,\n    tp?: (m: OM, from: SenderInfo) => void,\n  ) {\n    super(asyncify(fn), pname, tp);\n  }\n\n  start(a: A) {\n    super.start(a);\n    return this;\n  }\n  tick(): Promise<void> {\n    return super.pvtTick();\n  }\n}\n\nexport { Process };\n","// ── defineActor — high-level actor wrapper ───────────────────────────────────\n//\n// Compiles a declarative config into an AsyncProcessFn.  Built on top of\n// the existing runDispatchAsync / spawnAsync primitives.\n//\nimport {\n  type AsyncProcess,\n  runDispatchAsync,\n  spawnAsync,\n  AnyProcess,\n} from \"./process.async.js\";\nimport type {\n  WithSender,\n  SenderInfo,\n  AsyncProcessFn,\n  Message,\n  ExitMessage,\n  ProcessCtx,\n} from \"./types.js\";\nimport type {\n  ActorDefinition,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  ActorMessages,\n  HandlerOptions,\n  HandlerFn,\n  ReflectionOptions,\n  AnyConfig,\n  HidePrivate,\n} from \"./actor-types.js\";\nimport { STOP_SENTINEL } from \"./actor-types.js\";\nimport {\n  ActorDecorated,\n  type ActorPlugin,\n  ActorReflection,\n  callHook,\n} from \"./hooks.js\";\n\nexport function defineMessages<\n  OutMsg extends Message = Message,\n>(): ActorMessages<OutMsg> {\n  return undefined as unknown as ActorMessages<OutMsg>;\n}\n\nfunction hidePrivate<T>(value: T): HidePrivate<T> {\n  if (\n    value &&\n    typeof value === \"object\" &&\n    \"private\" in value &&\n    \"public\" in value\n  ) {\n    return value.public as HidePrivate<T>;\n  }\n  return value as HidePrivate<T>;\n}\n\nfunction resolvePlugins(\n  raw: ActorPlugin[] | ((parents: ActorPlugin[]) => ActorPlugin[]) | undefined,\n  parentPlugins?: ActorPlugin[],\n  addPlugins?: ActorPlugin[],\n): ActorPlugin[] {\n  const resolved =\n    !raw ? (parentPlugins ? [...parentPlugins] : [])\n    : Array.isArray(raw) ? [...raw]\n    : raw(parentPlugins ?? []);\n\n  const combined = addPlugins ? [...resolved, ...addPlugins] : resolved;\n\n  // Deduplicate by function name\n  const seen = new Set<string>();\n  return combined.filter((p) => {\n    const name = p.name;\n    if (!name) {\n      console.warn(\"posipaki: plugin has no name, dedup won't work\");\n      return true;\n    }\n    if (seen.has(name)) return false;\n    seen.add(name);\n    return true;\n  });\n}\n\nasync function assembleActor<C>(config: C, plugins: ActorPlugin[], addPlugins?: ActorPlugin[]): Promise<C> {\n  // Work with the default ActorPlugin type internally, cast back on return\n  let cur = config as AnyConfig;\n  for (const p of plugins) {\n    try {\n          cur = await p(cur);\n    } catch (e: unknown) {\n      console.error(\n        `[assembleActor] plugin \"${p.name || \"?\"}\" failed:`,\n        e,\n      );\n    }\n  }\n  cur.resolvedPlugins = plugins;\n  if (addPlugins) cur.addPlugins = addPlugins;\n  return cur as C;\n}\n\nexport function defineActor<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n>(\n  config: ActorConfig<\n    Args,\n    InternalState,\n    InMsg,\n    OutMsg,\n    Methods,\n    Handlers,\n    ReflectionMethods\n  >,\n): ActorDefinition<Args, InternalState, InMsg, OutMsg, ReflectionMethods> {\n  const actorCtxMap = new Map<\n    symbol,\n    ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods\n    >\n  >();\n\n  function makeRuntime(\n    assembly: ActorConfig<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods\n    >,\n  ): AsyncProcessFn<Args, HidePrivate<InternalState>, InMsg, OutMsg> {\n    return async function* (\n      ctx,\n      args,\n    ): AsyncGenerator<\n      HidePrivate<InternalState | null>,\n      void,\n      WithSender<InMsg>\n    > {\n      let done = false;\n      let exitReason: unknown;\n      let rawState: InternalState = undefined as unknown as InternalState;\n\n      const decorated = new Map();\n      const self: ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      > = {\n        ctx,\n        ...((assembly.methods || {}) as Methods),\n        ...((assembly.$decorate || {}) as ActorDecorated),\n        reflection: {} as ReflectionMethods & ActorReflection,\n        state: rawState,\n        name: ctx.pname,\n        id: ctx.id,\n        async emit(msg: OutMsg) {\n          await callHook(assembly.onEmit, undefined, self, msg, {\n            fromName: ctx.pname,\n            fromId: ctx.id,\n          });\n          ctx.toParent(msg);\n        },\n        agreeToStop() {\n          exitReason = \"stopped\";\n          done = true;\n        },\n        exit(reason: unknown) {\n          exitReason = reason;\n          done = true;\n        },\n        $child: {} as Record<string, AnyProcess>,\n        decorators: {},\n        fork: async <\n          A,\n          S,\n          IM extends Message,\n          OM extends InMsg,\n          R extends ReflectionOptions,\n        >(\n          childActor: ActorDefinition<A, S, IM, OM, R>,\n          childArgs?: A,\n          forkOpts?: { name?: string; addPlugins?: ActorPlugin[] },\n        ): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>> => {\n          let child: AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>;\n          const childName =\n            forkOpts?.name ??\n            childActor?.name ??\n            `child-${Object.keys(self.$child).length}`;\n          const treeName = `${ctx.pname}:${childName}`;\n          const childAddPlugins = [\n            ...(assembly.addPlugins || []),\n            ...(forkOpts?.addPlugins || []),\n          ];\n          child = await childActor.spawnAsChild(\n            ctx,\n            childArgs!,\n            {\n              name: treeName,\n              parentPlugins: assembly.resolvedPlugins || [],\n              ...(childAddPlugins.length ? { addPlugins: childAddPlugins } : {}),\n            },\n          );\n          self.$child[child.pname] = child as unknown as AnyProcess;\n          return child;\n        },\n      };\n      actorCtxMap.set(ctx.id, self);\n      ctx.afterExit = async () => {\n        await callHook(assembly.afterEnd, assembly.onError, self, exitReason);\n      };\n\n      for (const [k, v] of decorated) {\n        (self as Record<string, unknown>)[k] = v;\n      }\n\n      await callHook(\n        assembly.beforeStart,\n        assembly.onError,\n        self as ActorContext<\n          Args,\n          never, // state not set yet\n          InMsg,\n          OutMsg,\n          Methods,\n          Handlers,\n          ReflectionMethods & ActorReflection\n        >,\n      );\n\n      if (assembly.setup) {\n        rawState = await assembly.setup.call(\n          self as ActorContext<\n            Args,\n            never, // break inference cycle here\n            InMsg,\n            OutMsg,\n            Methods,\n            Handlers,\n            ReflectionMethods & ActorReflection\n          >,\n          args,\n        );\n      } else {\n        rawState = null as InternalState;\n      }\n      self.state = rawState;\n      yield hidePrivate(rawState);\n      await callHook(assembly.afterStart, assembly.onError, self);\n\n      yield* runDispatchAsync<WithSender<InMsg | ExitMessage>>(\n        ctx.pname,\n        async (stamped) => {\n          const [msg, sender] = stamped;\n          if (msg.type === \"STOP\") {\n            if (assembly.onStopRequested) {\n              await callHook(assembly.onStopRequested, assembly.onError, self);\n              // Hook may call agreeToStop(). If not, actor keeps running.\n            } else {\n              exitReason = \"stopped\";\n              done = true;\n            }\n            return;\n          }\n          if (msg.type === \"EXIT\") {\n            const childName = sender.fromName;\n            if (childName && self.$child[childName]) {\n              delete self.$child[childName];\n            }\n            await callHook(\n              assembly.onChildExit,\n              assembly.onError,\n              self,\n              childName,\n              msg as ExitMessage,\n            );\n            // Orphan policy: a child that exits may leave still-running\n            // grandchildren behind (see ctx-orphans / orphan-policy).\n            const orphans = (msg as ExitMessage).orphans;\n            if (orphans && orphans.length > 0) {\n              for (const orphan of orphans) {\n                // Default when no hook is defined: hard-kill the orphan.\n                const decision = assembly.onOrphan\n                  ? await callHook(\n                      assembly.onOrphan,\n                      assembly.onError,\n                      self,\n                      orphan,\n                    )\n                  : \"force-stop\";\n                if (decision === \"adopt\") {\n                  ctx.adopt(orphan);\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                  self.$child[orphan.pname] = orphan;\n                } else if (decision === \"force-stop\") {\n                  orphan.forceStop({ cascade: true });\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                } else if (decision === \"unparent\") {\n                  orphan.unparent();\n                }\n                // 'leave' (or undefined) → do nothing; it propagates on exit.\n              }\n            }\n          }\n          let hookStopped = false;\n          if (\n            msg.type !== \"STOP\" &&\n            msg.type !== \"EXIT\" &&\n            assembly.onMessage\n          ) {\n            const result = await callHook(\n              assembly.onMessage,\n              assembly.onError,\n              self,\n              msg as InMsg,\n              sender,\n            );\n            if (result === STOP_SENTINEL) hookStopped = true;\n          }\n          if (msg.type !== \"STOP\" && !hookStopped) {\n            const handler =\n              ((assembly.handlers || ({} as Handlers))[\n                msg.type as keyof Handlers\n              ] as HandlerFn<InMsg>) || assembly.onUnhandled;\n\n            await callHook(\n              handler,\n              assembly.onError,\n              self,\n              msg as InMsg,\n              sender,\n            );\n          }\n        },\n        () => done,\n      );\n\n      await callHook(assembly.beforeEnd, assembly.onError, self, exitReason);\n    };\n  }\n\n  type ReflectableProcess = {\n    id: symbol;\n    $reflection: Record<string, Function>;\n  };\n  function attachReflection(\n    proc: ReflectableProcess,\n    reflectionMethods: ReflectionMethods | undefined,\n  ): void {\n    if (!reflectionMethods) return;\n    const self = actorCtxMap.get(proc.id);\n    const refl = proc.$reflection as Record<string, Function>;\n    for (const [k, m] of Object.entries(reflectionMethods)) {\n      refl[k] = m.bind(self);\n    }\n  }\n\n  return {\n    fn: makeRuntime(config),\n    name: config.name,\n    pvtPluginsRaw: config.plugins,\n    inMessages: config.inMessages,\n    outMessages: config.outMessages,\n    async spawn(\n      args: Args,\n      opts?: {\n        name?: string;\n        toParent?: (msg: OutMsg, from: SenderInfo) => void;\n        addPlugins?: ActorPlugin[];\n      },\n    ): Promise<\n      AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >\n    > {\n      const plugs = resolvePlugins(config.plugins, undefined, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = spawnAsync(runtime, opts?.name ?? assembly.name ?? \"actor\", opts?.toParent)(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n    async spawnAsChild(\n      ctx: ProcessCtx<unknown, unknown, OutMsg, Message>,\n      args: Args,\n      opts?: {\n        name?: string;\n        parentPlugins?: ActorPlugin[];\n        addPlugins?: ActorPlugin[];\n      },\n    ) {\n      const plugs = resolvePlugins(config.plugins, opts?.parentPlugins, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = ctx.fork(runtime, opts?.name ?? assembly.name ?? \"child\")(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n  };\n}\n","/**\n * Posipaki — Erlang-inspired lightweight actor processes built on\n * generator functions. Processes communicate via message-passing,\n * can fork children, and expose their state reactively.\n *\n * @module\n */\n\nimport { Process, spawn } from \"./process.js\";\nimport { runDispatch } from \"./util.js\";\nimport { AsyncProcess, spawnAsync, runDispatchAsync } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\n\nexport { Process, spawn, runDispatch };\nexport { AsyncProcess, spawnAsync, runDispatchAsync, asyncify };\nexport type { AnyProcess } from \"./process.async.js\";\n\nexport type {\n  Message,\n  WithSender,\n  WithoutSender,\n  ExitMessage,\n  StopMessage,\n  ProcessFn,\n  ProcessCtx,\n  AsyncProcessFn,\n  PipeState,\n  SupervisorState,\n  SenderOrigin,\n  SenderInfo,\n} from \"./types.js\";\n\nexport { defineActor, defineMessages } from \"./define-actor.js\";\nexport type {\n  ActorDefinition,\n  SpawnedFrom,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  HandlerOptions,\n  HandlerFn,\n} from \"./actor-types.js\";\n\n// ── hooks ─────────────────────────────────────────────────────────────────\n\nexport { stopPropagation, mergeConfigs, chainHook, callHook } from \"./hooks.js\";\nexport type {\n  HookResult,\n  ActorPlugin,\n  ActorDecorated,\n  ActorReflection,\n  PluginTransform,\n} from \"./hooks.js\";\n"],"mappings":"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"}
+{"version":3,"file":"src-tbH9wapj.js","names":[],"sources":["../src/adapters.ts","../src/process.async.ts","../src/process.ts","../src/define-actor.ts","../src/index.ts"],"sourcesContent":["import type { ProcessFn, AsyncProcessFn, Message } from \"./types.js\"\n\nexport function asyncify<A, S, IM extends Message, OM extends Message>(\n  fn: ProcessFn<A, S, IM, OM>,\n): AsyncProcessFn<A, S, IM, OM> {\n  return async function* (ctx, args) {\n    yield* fn(ctx, args) as any\n  }\n}\n","import { defer, makeWaiter, debugLog, withTimeout } from \"./util.js\";\nimport type { DeferredCall, Waiter } from \"./util.js\";\nimport type {\n  Message,\n  WithSender,\n  SenderInfo,\n  ExitMessage,\n  StopMessage,\n  ProcessCtx,\n  AsyncProcessFn,\n  ProcessFn,\n} from \"./types.js\";\nimport { asyncify } from \"./adapters.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/** An async iterator over process state. Receives `WithSender<InMessage | StopMessage>`. */\ntype AsyncProcessGenerator<\n  ProcessState,\n  InMessage extends Message,\n> = AsyncGenerator<\n  ProcessState | null,\n  void,\n  WithSender<InMessage | StopMessage>\n>;\n\ntype NotifyFn = () => void;\n\n// ---- runDispatchAsync -------------------------------------------------------\n\ntype AsyncReducer<M> = (msg: M) => Promise<void>;\ntype ReadyFn = () => boolean;\n\n/**\n * Async equivalent of `runDispatch`. Loops, yielding `null` and feeding\n * each incoming message to an `async` reducer. Exits when `readyFn()`\n * returns true.\n */\nexport async function* runDispatchAsync<M>(\n  name: string,\n  fn: AsyncReducer<M>,\n  readyFn: ReadyFn = () => false,\n  debugLevel = false,\n): AsyncGenerator<null, void, M> {\n  let msg: M;\n  while (!readyFn()) {\n    msg = yield null;\n    debugLog(debugLevel, \"msg\", name, \" <- \", msg);\n    await fn(msg);\n  }\n}\n\n// ---- AsyncProcess -----------------------------------------------------------\n\n/** A subscriber to this process's message channel: receives the message and\n *  its sender separately (not a `WithSender` tuple). */\ntype MessageCallback<M extends Message> = (msg: M, from: SenderInfo) => void;\n\n\n/** How long a parent waits for a child to stop before continuing shutdown. */\nconst CHILD_STOP_TIMEOUT_MS = 1_000;\n\n/**\n * A process driven by an async generator. Functionally identical to\n * {@link Process} but supports `await` inside reducers.\n *\n * Messages are processed **one at a time** — if a tick is already\n * in-flight, new messages are buffered and processed when the current\n * tick completes.\n */\nexport class AsyncProcess<\n  Args,\n  State,\n  InMessage extends Message,\n  OutMessage extends Message,\n  ReflectionMethods extends object,\n> {\n  /** Reflection methods.  Empty by default — defineActor fills in configured methods. */\n  $reflection: ReflectionMethods = {} as ReflectionMethods;\n  pgenerator: AsyncProcessFn<Args, State, InMessage, OutMessage>;\n  pname: string;\n  /** Subscribers to this process's message channel (`ctx.toParent`). */\n  private messageSubscribers: Array<MessageCallback<OutMessage>> = [];\n  id: symbol;\n  state: State | null;\n\n  private current: AsyncProcessGenerator<State, InMessage> | null = null;\n  /** Every buffered message carries sender provenance. */\n  private buffer: Array<WithSender<InMessage | StopMessage>> = [];\n  private nextTick: DeferredCall | null = null;\n  /** Child processes forked from this one (any fork method). */\n  children: Array<\n    AsyncProcess<unknown, unknown, Message, Message, {}>\n  > = [];\n  /** Children inherited from a child that exited (see ctx-orphans proposal). */\n  orphans: Array<\n    AsyncProcess<unknown, unknown, Message, Message, {}>\n  > = [];\n  private stateSubscribers: Array<NotifyFn> = [];\n  /** Unsubscribe handles for outgoing message subscriptions (monitor only). */\n  private pvtOutgoingSubscriptions: Array<() => void> = [];\n  /** Unsubscribe handles for adopt (ownership) subscriptions, keyed by child id. */\n  private pvtAdoptUnsubs: Map<symbol, () => void> = new Map();\n  /** Live buffer while this process is an unowned orphan mid-handoff. */\n  private pvtPending: Array<WithSender<Message>> | null = null;\n  /** Unsubscribe for the collector currently buffering into pvtPending. */\n  private pvtCollectorUnsub: (() => void) | null = null;\n  private exitWaiter: Waiter;\n  private pvtIsPaused: boolean = false;\n  private pvtDead: boolean = false;\n  private pvtTickInProgress: boolean = false;\n  private pvtExitReject: ((e: unknown) => void) | null = null;\n  private pvtReady!: Waiter;\n  private pvtResolveReady!: () => void;\n\n  constructor(\n    fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n    pname: string,\n    toParent?: MessageCallback<OutMessage>,\n  ) {\n    this.pgenerator = fn;\n    this.pname = pname;\n    if (toParent) this.messageSubscribers.push(toParent);\n    this.id = Symbol(pname);\n    this.state = null;\n    this.exitWaiter = makeWaiter();\n    this.pvtReady = makeWaiter();\n    this.pvtResolveReady = this.pvtReady.resolve;\n  }\n\n  /** Compact handle for `util.inspect` — actor state often holds process\n   *  references, and dumping the internals would be unreadable. */\n  [Symbol.for(\"nodejs.util.inspect.custom\")](): string {\n    return `AsyncProcess<${this.pname}>`;\n  }\n\n  /** Promise that resolves once the initial state is available. */\n  ready(): Promise<void> {\n    return this.pvtReady.promise;\n  }\n\n  // ---- lifecycle ------------------------------------------------------------\n\n  /**\n   * Kick off the async generator. The first `yield` sets the initial\n   * state; for async generators this happens in a microtask.\n   */\n  start(arg0: Args, parentName?: string | null, parentId?: symbol | null) {\n    const selfCtx: SenderInfo = { fromName: this.pname, fromId: this.id };\n\n    const ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage> = {\n      pname: this.pname,\n      id: this.id,\n      parentName: parentName ?? null,\n      parentId: parentId ?? null,\n      fork: this.fork.bind(this),\n      forkSync: this.forkSync.bind(this),\n      children: this.children,\n      orphans: this.orphans,\n      adopt: this.adopt.bind(this),\n      monitor: this.monitor.bind(this),\n      sendSelf: (msg) => {\n        this.send([msg, selfCtx]);\n      },\n      toParent: (msg) => {\n        this.messageSubscribers.forEach((cb) => cb(msg as OutMessage, selfCtx));\n      },\n    };\n\n    this.current = this.pvtWatchExit(ctx, arg0);\n    void this.current.next().then((ret: IteratorResult<State | null, void>) => {\n      this.state = ret.value ?? null;\n      this.pvtResolveReady();\n      if (ret.done) {\n        this.exitWaiter.resolve();\n        return;\n      }\n      // Advance past the initial yield so the pvtWatchExit generator\n      // runs its finally block (EXIT/STOP) and the inner generator\n      // enters its dispatch loop.\n      const advance: WithSender<InMessage | StopMessage> = [\n        { type: \"__ADVANCE__\" } as InMessage,\n        {\n          fromName: \"__internal__\",\n          fromId: Symbol(\"__internal__\"),\n        } as SenderInfo,\n      ];\n      this.pvtEatResult(this.current!.next(advance));\n    });\n    return this;\n  }\n\n  /** Wrap the user's generator so EXIT/STOP logic fires on completion. */\n  private async *pvtWatchExit(\n    ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage>,\n    arg0: Args,\n  ): AsyncProcessGenerator<State, InMessage> {\n    try {\n      yield* this.pgenerator(ctx, arg0);\n    } finally {\n      // Cascade: stop every child (nice) and collect the refusers as orphans.\n      const orphans: Array<AnyProcess> = [...this.orphans];\n      const parentSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      const stopPromises = this.children.map(async (child) => {\n        const stopped = await child.stop({ from: parentSender });\n        if (!stopped) {\n          orphans.push(child);\n          console.warn(\n            `posipaki: child \"${child.pname}\" did not stop within ${CHILD_STOP_TIMEOUT_MS}ms; continuing shutdown`,\n          );\n        }\n      });\n\n      await Promise.all(stopPromises);\n      // Hand surviving children and inherited orphans up to the parent for adoption (see ctx-orphans proposal).\n      // In-process only.\n      this.pvtPrepareHandoff(orphans);\n      ctx.toParent({ type: \"EXIT\", orphans });\n      // Unsubscribe from children/monitored processes so a dead parent\n      // doesn't keep receiving their messages (handoff collectors stay on the orphans).\n      this.pvtUnsubscribeAll();\n      if (ctx.afterExit) await ctx.afterExit();\n    }\n  }\n\n  // ---- fork -----------------------------------------------------------------\n\n  fork<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    fn: AsyncProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (\n    args: ChildArgs,\n  ) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return (args: ChildArgs) => {\n      const child = new AsyncProcess<\n        ChildArgs,\n        ChildState,\n        ChildIM,\n        ChildOM,\n        {}\n      >(fn, pname);\n      this.adopt(child);\n      child.start(args, this.pname, this.id);\n      return child;\n    };\n  }\n\n  forkSync<\n    ChildArgs,\n    ChildState,\n    ChildIM extends Message,\n    ChildOM extends InMessage,\n  >(\n    fn: ProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (\n    args: ChildArgs,\n  ) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return this.fork(asyncify(fn), pname);\n  }\n\n  // ---- message processing ---------------------------------------------------\n\n  protected async pvtTick(): Promise<void> {\n    if (!this.current || this.pvtTickInProgress) return;\n\n    this.pvtTickInProgress = true;\n    try {\n      let msgAndSender: WithSender<InMessage | StopMessage> | undefined;\n      let ret: IteratorResult<State | null, void> | null = null;\n      while ((msgAndSender = this.buffer.shift()) !== undefined) {\n        ret = await this.pvtSafeNext(msgAndSender);\n        if (!ret || ret.done) break;\n      }\n      this.notify();\n      this.pvtEatResult(ret);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n    } finally {\n      this.pvtTickInProgress = false;\n    }\n  }\n\n  /** Call `.next()` and redirect unhandled rejections. */\n  private async pvtSafeNext(\n    msgAndSender: WithSender<InMessage | StopMessage>,\n  ): Promise<IteratorResult<State | null, void> | null> {\n    try {\n      return await this.current!.next(msgAndSender);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n      return { done: true, value: undefined };\n    }\n  }\n\n  private pvtEatResult(\n    ret:\n      | IteratorResult<State | null, void>\n      | Promise<IteratorResult<State | null, void>>\n      | null,\n  ): void {\n    if (!ret) return;\n    Promise.resolve(ret).then((r) => {\n      if (r.done) {\n        this.exitWaiter.resolve();\n      }\n    });\n  }\n\n  /** Broadcast a message to all children. */\n  toAllChildren(msg: Message): void {\n    const stamp: SenderInfo = { fromName: this.pname, fromId: this.id };\n    this.children.forEach((p) => p.send([msg, stamp] as WithSender<Message>));\n  }\n\n  /** Stamp and enqueue a message from a named sender (external API). */\n  send(msg: InMessage | StopMessage, from?: SenderInfo): void;\n  /** Enqueue a pre-stamped message (internal: fromChild, toAllChildren). */\n  send(msgAndSender: WithSender<InMessage | StopMessage>): void;\n  send(\n    msgOrTuple: InMessage | StopMessage | WithSender<InMessage | StopMessage>,\n    from?: SenderInfo,\n  ): void {\n    if (this.pvtDead) return;\n    if (\"type\" in msgOrTuple) {\n      this.buffer.push([\n        msgOrTuple as InMessage | StopMessage,\n        from as SenderInfo,\n      ]);\n    } else {\n      this.buffer.push(msgOrTuple as WithSender<InMessage | StopMessage>);\n    }\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Synchronously flush the buffer. For sync processes use {@link Process.tick};\n   * for async processes this is **not guaranteed** to process everything\n   * immediately if reducers contain `await`. Prefer `send()` + `await proc.wait()`.\n   */\n  tick(): void {\n    this.nextTick?.flush();\n    this.nextTick = null;\n  }\n\n  private pvtScheduleTick(): void {\n    if (this.pvtIsPaused || this.pvtDead) return;\n\n    this.nextTick?.cancel();\n    this.nextTick = defer(() => {\n      this.nextTick = null;\n      void this.pvtTick();\n    });\n  }\n\n  // ---- subscribers ----------------------------------------------------------\n\n  notify(): void {\n    this.stateSubscribers.forEach((f) => f());\n  }\n\n  get isListenedTo(): boolean {\n    return this.stateSubscribers.length > 0;\n  }\n\n  subscribe(channel: \"message\", cb: MessageCallback<OutMessage>): () => void;\n  subscribe(channel: \"state\", cb: NotifyFn): () => void;\n  /** @deprecated Use `subscribe(\"state\", cb)`. */\n  subscribe(cb: NotifyFn): () => void;\n  subscribe(\n    channelOrCb: \"message\" | \"state\" | NotifyFn,\n    cb?: MessageCallback<OutMessage> | NotifyFn,\n  ): () => void {\n    if (typeof channelOrCb === \"function\") {\n      return this.subscribe(\"state\", channelOrCb);\n    }\n    if (channelOrCb === \"message\") {\n      const fn = cb as MessageCallback<OutMessage>;\n      this.messageSubscribers.push(fn);\n      return () => this.pvtUnsubscribe(this.messageSubscribers, fn);\n    }\n    const fn = cb as NotifyFn;\n    this.stateSubscribers.push(fn);\n    return () => this.pvtUnsubscribe(this.stateSubscribers, fn);\n  }\n\n  private pvtUnsubscribe<T>(list: Array<T>, fn: T): void {\n    const idx = list.indexOf(fn);\n    if (idx >= 0) list.splice(idx, 1);\n  }\n\n  // ---- pause / resume -------------------------------------------------------\n\n  /**\n   * Freeze dispatch: no further ticks are scheduled, so the process stops\n   * *processing* incoming messages.  This is half-working as a \"quiesce\"\n   * primitive — it does not stop the process from *emitting* via async\n   * callbacks (timers, fetch) that bypass the dispatch loop.\n   */\n  pause(): void {\n    this.nextTick?.cancel();\n    this.nextTick = null;\n    this.pvtIsPaused = true;\n  }\n\n  resume(): void {\n    this.pvtIsPaused = false;\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Hard-kill this process: abandon the generator without running its\n   * `finally` (no EXIT, no STOP cascade), drop the inbox and observers,\n   * unsubscribe from children/monitors, and settle `wait()`/`ready()`.\n   *\n   * There is nothing to observe afterward — callers remove the process from\n   * their `children`/`orphans` lists imperatively.  Does not cascade to this\n   * process's own children; they are abandoned (force-stop them separately if\n   * owned).\n   *\n   * Best-effort: an idle generator (suspended at `yield`) is abandoned\n   * cleanly; a generator mid-`await` completes its `finally` when that await\n   * settles, because JS offers no way to cancel a pending promise.\n   */\n  forceStop(opts?: { cascade?: boolean }): void {\n    if (this.pvtDead) return;\n    this.pvtDead = true;\n\n    // Abandon the generator so its finally block never runs.\n    this.current = null;\n\n    // Drop the inbox and stop scheduling.\n    this.buffer.length = 0;\n    this.nextTick?.cancel();\n    this.nextTick = null;\n\n    // Release incoming observers and outgoing subscriptions.\n    this.messageSubscribers.length = 0;\n    this.stateSubscribers.length = 0;\n    this.pvtUnsubscribeAll();\n    // Drop any handoff state this process carried as an unowned orphan.\n    this.unparent();\n\n    // Settle waiters.\n    this.pvtResolveReady();\n    this.exitWaiter.resolve();\n    this.pvtExitReject = null;\n\n    if (opts?.cascade) {\n      // Stop the children too, starting with the nice stop (fire-and-forget:\n      // the hard kill itself does not block on their graceful exit).\n      const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      for (const child of this.children) {\n        void child.stop({ force: true, from: selfSender }).catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Stop this process.  Sends STOP (the nice way — the generator cooperates\n   * and its `finally` runs) and awaits on a best-effort basis.\n   *\n   * With `{ force: true }`, when the process refuses (does not exit within the\n   * timeout) it escalates: fires `generator.return()` *without awaiting* (throw\n   * the generator away for GC to find), cascades to children with the same\n   * ladder, then hard-kills itself.\n   *\n   * Resolves `true` if the process stopped (gracefully or forced), `false` if\n   * it refused and `force` was not requested.\n   */\n  async stop(opts?: { force?: boolean; from?: SenderInfo }): Promise<boolean> {\n    if (this.pvtDead) return true;\n\n    this.send({ type: \"STOP\" } as StopMessage, opts?.from);\n\n    try {\n      await withTimeout(this.wait(), CHILD_STOP_TIMEOUT_MS, 'stop');\n      return true;\n    } catch (e) {\n      if ((e as Error)?.message !== 'Timeout:stop') throw e;\n      // refused to stop within the timeout\n    }\n\n    if (!opts?.force) return false;\n\n    // Escalate: give the finally a chance to run (fire-and-forget), but do not\n    // block on it — the process may be stuck awaiting a dead promise.\n    void this.current?.return(undefined);\n\n    // Cascade to children with the same ladder, stamped from this process.\n    const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n    await Promise.all(\n      [...this.children].map((child) => child.stop({ force: true, from: selfSender })),\n    );\n\n    this.forceStop();\n    return true;\n  }\n\n  // ---- waiting --------------------------------------------------------------\n\n  /**\n   * Returns a promise that resolves when the generator completes, or\n   * rejects if an unhandled error occurs during message processing.\n   */\n  wait(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      this.pvtExitReject = reject;\n\n      this.exitWaiter.promise.then(\n        () => {\n          this.pvtExitReject = null;\n          resolve();\n        },\n        (e) => {\n          this.pvtExitReject = null;\n          reject(e);\n        },\n      );\n    });\n  }\n\n  // ---- child messages -------------------------------------------------------\n\n  /**\n   * Tap another process's message channel: every message it emits is fed\n   * into this process's incoming queue.  No ownership — the sender's EXIT\n   * does not touch `children`/`orphans`.\n   */\n  monitor<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.send([msg, from] as WithSender<InMessage | StopMessage>);\n    });\n    this.pvtOutgoingSubscriptions.push(unsub);\n    return unsub;\n  }\n\n  /**\n   * Claim another process as a child: its messages are routed here and its\n   * EXIT removes it from `children` (collecting its orphans).  Generalizes\n   * what `fork` does — used for both spawning and orphan adoption.\n   */\n  adopt<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    this.children.push(child as unknown as AnyProcess);\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.pvtChildMessage(msg, from);\n    });\n    this.pvtAdoptUnsubs.set(child.id, unsub);\n    // Lossless handoff: drain a pending buffer left by the previous parent.\n    this.pvtDrainPending(child as unknown as AnyProcess);\n    return unsub;\n  }\n\n  /** Handles a child's emitted message: EXIT cleanup + forward to the queue. */\n  private pvtChildMessage(msg: Message, sender: SenderInfo): void {\n    if (msg.type === \"EXIT\") {\n      // sender.fromId === child's id (stamped by the child's ctx.toParent)\n      // Mutate in place so ctx.children (a live reference) stays consistent.\n      const idx = this.children.findIndex((p) => p.id === sender.fromId);\n      if (idx >= 0) this.children.splice(idx, 1);\n      const orphans = (msg as ExitMessage).orphans;\n      if (orphans && orphans.length > 0) {\n        this.orphans.push(...orphans);\n      }\n    }\n    this.send([msg, sender] as WithSender<InMessage | StopMessage>);\n  }\n\n  // ---- orphan handoff -------------------------------------------------------\n\n  /** Unsubscribe from all outgoing subscriptions (monitors + adopt). */\n  private pvtUnsubscribeAll(): void {\n    for (const unsub of this.pvtOutgoingSubscriptions) unsub();\n    this.pvtOutgoingSubscriptions = [];\n    for (const unsub of this.pvtAdoptUnsubs.values()) unsub();\n    this.pvtAdoptUnsubs.clear();\n  }\n\n  /** Prepare surviving children and inherited orphans for a lossless handoff:\n   *  recover undrained messages and install a collector on each orphan. */\n  private pvtPrepareHandoff(orphans: Array<AnyProcess>): void {\n    for (const orphan of orphans) {\n      this.pvtBackFeed(orphan);\n      if (!orphan.pvtCollectorUnsub) {\n        this.pvtSwapToCollector(orphan);\n      }\n    }\n  }\n\n  /** Recover messages the orphan emitted into my inbox that I never drained. */\n  private pvtBackFeed(orphan: AnyProcess): void {\n    const fromOrphan: Array<WithSender<Message>> = [];\n    this.buffer = this.buffer.filter((entry) => {\n      if (entry[1].fromId === orphan.id) {\n        fromOrphan.push(entry);\n        return false;\n      }\n      return true;\n    });\n    if (fromOrphan.length === 0) return;\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    orphan.pvtPending.unshift(...fromOrphan);\n  }\n\n  /** Replace my ownership subscription to `orphan` with a handoff collector. */\n  private pvtSwapToCollector(orphan: AnyProcess): void {\n    const mine = this.pvtAdoptUnsubs.get(orphan.id);\n    if (mine) {\n      mine();\n      this.pvtAdoptUnsubs.delete(orphan.id);\n    }\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    const pending = orphan.pvtPending;\n    orphan.pvtCollectorUnsub = orphan.subscribe(\"message\", (msg, from) => {\n      pending.push([msg, from]);\n    });\n  }\n\n  /** Drain a handed-off orphan's pending buffer into my inbox (lossless adopt). */\n  private pvtDrainPending(orphan: AnyProcess): void {\n    if (orphan.pvtCollectorUnsub) {\n      orphan.pvtCollectorUnsub();\n      orphan.pvtCollectorUnsub = null;\n    }\n    const pending = orphan.pvtPending;\n    if (!pending) return;\n    orphan.pvtPending = null;\n    for (const [msg, from] of pending) {\n      this.pvtChildMessage(msg, from);\n    }\n  }\n\n  /**\n   * Drop this process's handoff state (collector + pending buffer) without\n   * stopping it.  Used by `onOrphan`'s \"unparent\" decision: the orphan keeps\n   * running and stays in the orphans list, but its in-flight buffer is gone.\n   */\n  unparent(): void {\n    if (this.pvtCollectorUnsub) {\n      this.pvtCollectorUnsub();\n      this.pvtCollectorUnsub = null;\n    }\n    this.pvtPending = null;\n  }\n}\nexport type AnyProcess = AsyncProcess<unknown, unknown, Message, Message, {}>;\n// ---- spawnAsync -------------------------------------------------------------\n\n/**\n * Spawn a new async process. Accepts both sync and async process\n * functions — sync ones are automatically wrapped with {@link asyncify}.\n */\nexport function spawnAsync<\n  Args,\n  State,\n  InMessage extends Message = Message,\n  OutMessage extends Message = ExitMessage,\n>(\n  fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n  pname: string,\n  toParent?: MessageCallback<OutMessage>,\n): (args: Args) => AsyncProcess<Args, State, InMessage, OutMessage, {}> {\n  return (args: Args) => {\n    const proc = new AsyncProcess<Args, State, InMessage, OutMessage, {}>(\n      fn,\n      pname,\n      toParent,\n    );\n    proc.start(args);\n    return proc;\n  };\n}\n","import { AsyncProcess } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\nimport type { Message, SenderInfo, ExitMessage, ProcessFn } from \"./types.js\";\n\nexport type { Message, ProcessFn, ProcessCtx } from \"./types.js\";\nexport { runDispatch } from \"./util.js\";\n\n/** @deprecated Use {@link spawnAsync} instead. */\nexport function spawn<\n  A,\n  S,\n  IM extends Message = Message,\n  OM extends Message = ExitMessage,\n>(\n  fn: ProcessFn<A, S, IM, OM>,\n  pname: string,\n  tp?: (m: OM, from: SenderInfo) => void,\n): (a: A) => Process<A, S, IM, OM> {\n  return (a: A) => new Process(fn, pname, tp).start(a);\n}\n\n/** @deprecated Use {@link AsyncProcess} instead. Sync processes are\n *  wrapped via asyncify internally; spawnAsync handles both. */\nclass Process<\n  A,\n  S,\n  IM extends Message,\n  OM extends Message,\n> extends AsyncProcess<A, S, IM, OM, {}> {\n  constructor(\n    fn: ProcessFn<A, S, IM, OM>,\n    pname: string,\n    tp?: (m: OM, from: SenderInfo) => void,\n  ) {\n    super(asyncify(fn), pname, tp);\n  }\n\n  start(a: A) {\n    super.start(a);\n    return this;\n  }\n  tick(): Promise<void> {\n    return super.pvtTick();\n  }\n}\n\nexport { Process };\n","// ── defineActor — high-level actor wrapper ───────────────────────────────────\n//\n// Compiles a declarative config into an AsyncProcessFn.  Built on top of\n// the existing runDispatchAsync / spawnAsync primitives.\n//\nimport {\n  type AsyncProcess,\n  runDispatchAsync,\n  spawnAsync,\n  AnyProcess,\n} from \"./process.async.js\";\nimport type {\n  WithSender,\n  SenderInfo,\n  AsyncProcessFn,\n  Message,\n  ExitMessage,\n  ProcessCtx,\n} from \"./types.js\";\nimport type {\n  ActorDefinition,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  ActorMessages,\n  HandlerOptions,\n  HandlerFn,\n  ReflectionOptions,\n  AnyConfig,\n  HidePrivate,\n} from \"./actor-types.js\";\nimport { STOP_SENTINEL } from \"./actor-types.js\";\nimport {\n  ActorDecorated,\n  type ActorPlugin,\n  ActorReflection,\n  callHook,\n} from \"./hooks.js\";\n\nexport function defineMessages<\n  OutMsg extends Message = Message,\n>(): ActorMessages<OutMsg> {\n  return undefined as unknown as ActorMessages<OutMsg>;\n}\n\nfunction hidePrivate<T>(value: T): HidePrivate<T> {\n  if (\n    value &&\n    typeof value === \"object\" &&\n    \"private\" in value &&\n    \"public\" in value\n  ) {\n    return value.public as HidePrivate<T>;\n  }\n  return value as HidePrivate<T>;\n}\n\nfunction resolvePlugins(\n  raw: ActorPlugin[] | ((parents: ActorPlugin[]) => ActorPlugin[]) | undefined,\n  parentPlugins?: ActorPlugin[],\n  addPlugins?: ActorPlugin[],\n): ActorPlugin[] {\n  const resolved =\n    !raw ? (parentPlugins ? [...parentPlugins] : [])\n    : Array.isArray(raw) ? [...raw]\n    : raw(parentPlugins ?? []);\n\n  const combined = addPlugins ? [...resolved, ...addPlugins] : resolved;\n\n  // Deduplicate by function name\n  const seen = new Set<string>();\n  return combined.filter((p) => {\n    const name = p.name;\n    if (!name) {\n      console.warn(\"posipaki: plugin has no name, dedup won't work\");\n      return true;\n    }\n    if (seen.has(name)) return false;\n    seen.add(name);\n    return true;\n  });\n}\n\nasync function assembleActor<C>(config: C, plugins: ActorPlugin[], addPlugins?: ActorPlugin[]): Promise<C> {\n  // Work with the default ActorPlugin type internally, cast back on return\n  let cur = config as AnyConfig;\n  for (const p of plugins) {\n    try {\n          cur = await p(cur);\n    } catch (e: unknown) {\n      console.error(\n        `[assembleActor] plugin \"${p.name || \"?\"}\" failed:`,\n        e,\n      );\n    }\n  }\n  cur.resolvedPlugins = plugins;\n  if (addPlugins) cur.addPlugins = addPlugins;\n  return cur as C;\n}\n\nexport function defineActor<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n>(\n  config: ActorConfig<\n    Args,\n    InternalState,\n    InMsg,\n    OutMsg,\n    Methods,\n    Handlers,\n    ReflectionMethods\n  >,\n): ActorDefinition<Args, InternalState, InMsg, OutMsg, ReflectionMethods> {\n  const actorCtxMap = new Map<\n    symbol,\n    ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods\n    >\n  >();\n\n  function makeRuntime(\n    assembly: ActorConfig<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods\n    >,\n  ): AsyncProcessFn<Args, HidePrivate<InternalState>, InMsg, OutMsg> {\n    return async function* (\n      ctx,\n      args,\n    ): AsyncGenerator<\n      HidePrivate<InternalState | null>,\n      void,\n      WithSender<InMsg>\n    > {\n      let done = false;\n      let exitReason: unknown;\n      let rawState: InternalState = undefined as unknown as InternalState;\n\n      const decorated = new Map();\n      const self: ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      > = {\n        ctx,\n        ...((assembly.methods || {}) as Methods),\n        ...((assembly.$decorate || {}) as ActorDecorated),\n        reflection: {} as ReflectionMethods & ActorReflection,\n        state: rawState,\n        name: ctx.pname,\n        id: ctx.id,\n        async emit(msg: OutMsg) {\n          await callHook(assembly.onEmit, undefined, self, msg, {\n            fromName: ctx.pname,\n            fromId: ctx.id,\n          });\n          ctx.toParent(msg);\n        },\n        agreeToStop() {\n          exitReason = \"stopped\";\n          done = true;\n        },\n        exit(reason: unknown) {\n          exitReason = reason;\n          done = true;\n        },\n        $child: {} as Record<string, AnyProcess>,\n        decorators: {},\n        fork: async <\n          A,\n          S,\n          IM extends Message,\n          OM extends InMsg,\n          R extends ReflectionOptions,\n        >(\n          childActor: ActorDefinition<A, S, IM, OM, R>,\n          childArgs?: A,\n          forkOpts?: { name?: string; addPlugins?: ActorPlugin[] },\n        ): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>> => {\n          let child: AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>;\n          const childName =\n            forkOpts?.name ??\n            childActor?.name ??\n            `child-${Object.keys(self.$child).length}`;\n          const treeName = `${ctx.pname}:${childName}`;\n          const childAddPlugins = [\n            ...(assembly.addPlugins || []),\n            ...(forkOpts?.addPlugins || []),\n          ];\n          child = await childActor.spawnAsChild(\n            ctx,\n            childArgs!,\n            {\n              name: treeName,\n              parentPlugins: assembly.resolvedPlugins || [],\n              ...(childAddPlugins.length ? { addPlugins: childAddPlugins } : {}),\n            },\n          );\n          self.$child[child.pname] = child as unknown as AnyProcess;\n          return child;\n        },\n      };\n      actorCtxMap.set(ctx.id, self);\n      ctx.afterExit = async () => {\n        await callHook(assembly.afterEnd, assembly.onError, self, exitReason);\n      };\n\n      for (const [k, v] of decorated) {\n        (self as Record<string, unknown>)[k] = v;\n      }\n\n      await callHook(\n        assembly.beforeStart,\n        assembly.onError,\n        self as ActorContext<\n          Args,\n          never, // state not set yet\n          InMsg,\n          OutMsg,\n          Methods,\n          Handlers,\n          ReflectionMethods & ActorReflection\n        >,\n      );\n\n      if (assembly.setup) {\n        rawState = await assembly.setup.call(\n          self as ActorContext<\n            Args,\n            never, // break inference cycle here\n            InMsg,\n            OutMsg,\n            Methods,\n            Handlers,\n            ReflectionMethods & ActorReflection\n          >,\n          args,\n        );\n      } else {\n        rawState = null as InternalState;\n      }\n      self.state = rawState;\n      yield hidePrivate(rawState);\n      await callHook(assembly.afterStart, assembly.onError, self);\n\n      yield* runDispatchAsync<WithSender<InMsg | ExitMessage>>(\n        ctx.pname,\n        async (stamped) => {\n          const [msg, sender] = stamped;\n          if (msg.type === \"STOP\") {\n            if (assembly.onStopRequested) {\n              await callHook(assembly.onStopRequested, assembly.onError, self);\n              // Hook may call agreeToStop(). If not, actor keeps running.\n            } else {\n              exitReason = \"stopped\";\n              done = true;\n            }\n            return;\n          }\n          if (msg.type === \"EXIT\") {\n            const childName = sender.fromName;\n            if (childName && self.$child[childName]) {\n              delete self.$child[childName];\n            }\n            await callHook(\n              assembly.onChildExit,\n              assembly.onError,\n              self,\n              childName,\n              msg as ExitMessage,\n            );\n            // Orphan policy: a child that exits may leave still-running\n            // grandchildren behind (see ctx-orphans / orphan-policy).\n            const orphans = (msg as ExitMessage).orphans;\n            if (orphans && orphans.length > 0) {\n              for (const orphan of orphans) {\n                // Default when no hook is defined: hard-kill the orphan.\n                const decision = assembly.onOrphan\n                  ? await callHook(\n                      assembly.onOrphan,\n                      assembly.onError,\n                      self,\n                      orphan,\n                    )\n                  : \"force-stop\";\n                if (decision === \"adopt\") {\n                  ctx.adopt(orphan);\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                  self.$child[orphan.pname] = orphan;\n                } else if (decision === \"force-stop\") {\n                  orphan.forceStop({ cascade: true });\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                } else if (decision === \"unparent\") {\n                  orphan.unparent();\n                }\n                // 'leave' (or undefined) → do nothing; it propagates on exit.\n              }\n            }\n          }\n          let hookStopped = false;\n          if (\n            msg.type !== \"STOP\" &&\n            msg.type !== \"EXIT\" &&\n            assembly.onMessage\n          ) {\n            const result = await callHook(\n              assembly.onMessage,\n              assembly.onError,\n              self,\n              msg as InMsg,\n              sender,\n            );\n            if (result === STOP_SENTINEL) hookStopped = true;\n          }\n          if (msg.type !== \"STOP\" && !hookStopped) {\n            const handler =\n              ((assembly.handlers || ({} as Handlers))[\n                msg.type as keyof Handlers\n              ] as HandlerFn<InMsg>) || assembly.onUnhandled;\n\n            await callHook(\n              handler,\n              assembly.onError,\n              self,\n              msg as InMsg,\n              sender,\n            );\n          }\n        },\n        () => done,\n      );\n\n      await callHook(assembly.beforeEnd, assembly.onError, self, exitReason);\n    };\n  }\n\n  type ReflectableProcess = {\n    id: symbol;\n    $reflection: Record<string, Function>;\n  };\n  function attachReflection(\n    proc: ReflectableProcess,\n    reflectionMethods: ReflectionMethods | undefined,\n  ): void {\n    if (!reflectionMethods) return;\n    const self = actorCtxMap.get(proc.id);\n    const refl = proc.$reflection as Record<string, Function>;\n    for (const [k, m] of Object.entries(reflectionMethods)) {\n      refl[k] = m.bind(self);\n    }\n  }\n\n  return {\n    fn: makeRuntime(config),\n    name: config.name,\n    pvtPluginsRaw: config.plugins,\n    inMessages: config.inMessages,\n    outMessages: config.outMessages,\n    async spawn(\n      args: Args,\n      opts?: {\n        name?: string;\n        toParent?: (msg: OutMsg, from: SenderInfo) => void;\n        addPlugins?: ActorPlugin[];\n      },\n    ): Promise<\n      AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >\n    > {\n      const plugs = resolvePlugins(config.plugins, undefined, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = spawnAsync(runtime, opts?.name ?? assembly.name ?? \"actor\", opts?.toParent)(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n    async spawnAsChild(\n      ctx: ProcessCtx<unknown, unknown, OutMsg, Message>,\n      args: Args,\n      opts?: {\n        name?: string;\n        parentPlugins?: ActorPlugin[];\n        addPlugins?: ActorPlugin[];\n      },\n    ) {\n      const plugs = resolvePlugins(config.plugins, opts?.parentPlugins, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = ctx.fork(runtime, opts?.name ?? assembly.name ?? \"child\")(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n  };\n}\n","/**\n * Posipaki — Erlang-inspired lightweight actor processes built on\n * generator functions. Processes communicate via message-passing,\n * can fork children, and expose their state reactively.\n *\n * @module\n */\n\nimport { Process, spawn } from \"./process.js\";\nimport { runDispatch } from \"./util.js\";\nimport { AsyncProcess, spawnAsync, runDispatchAsync } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\n\nexport { Process, spawn, runDispatch };\nexport { AsyncProcess, spawnAsync, runDispatchAsync, asyncify };\nexport type { AnyProcess } from \"./process.async.js\";\n\nexport type {\n  Message,\n  WithSender,\n  WithoutSender,\n  ExitMessage,\n  StopMessage,\n  ProcessFn,\n  ProcessCtx,\n  AsyncProcessFn,\n  PipeState,\n  SupervisorState,\n  SenderOrigin,\n  SenderInfo,\n} from \"./types.js\";\n\nexport { defineActor, defineMessages } from \"./define-actor.js\";\nexport type {\n  ActorDefinition,\n  SpawnedFrom,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  HandlerOptions,\n  HandlerFn,\n} from \"./actor-types.js\";\n\n// ── hooks ─────────────────────────────────────────────────────────────────\n\nexport { stopPropagation, mergeConfigs, chainHook, callHook } from \"./hooks.js\";\nexport type {\n  HookResult,\n  ActorPlugin,\n  ActorDecorated,\n  ActorReflection,\n  PluginTransform,\n} from \"./hooks.js\";\n"],"mappings":"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"}

package/dist/testing/index.d.ts

@@ -6,17 +6,38 @@ type Matcher<M extends Message> = (msg: M, history: M[]) => boolean;
 type MatchSpec<M extends Message> = Matcher<M> | Partial<M> | Array<Partial<M>>;
 /** Convert a matcher spec to a canonical matcher function. */
 declare function toMatcher<M extends Message>(spec: MatchSpec<M>): Matcher<M>;
+/**
+ * Occurrence matcher: matches when at least `n` messages in the history
+ * satisfy `spec`.  This is the canonical form for "Nth occurrence" waits:
+ *
+ *   const c = createCollector<PongMsg>({ type: "PONG" });
+ *   await c.next(times({ type: "PONG" }, 3));  // wait for the 3rd PONG
+ *
+ * Note: `history` accumulates, so this counts occurrences over the whole
+ * collected history, not since the previous `next()`.  Use `reset()` with a
+ * fresh collector for windowed counts.
+ */
+declare function times<M extends Message>(spec: Partial<M> | Matcher<M>, n: number): Matcher<M>;
 //#endregion
 //#region src/testing/test-plugin.d.ts
 interface MatchResult {
   ok: boolean;
+  /** Human-readable diagnosis on failure (timeout / exit-before-match). */
   detail?: string;
 }
 interface Collector<M extends Message> {
   plugin: ActorPlugin;
   messages: M[];
-  resolved(): Promise<MatchResult>;
-  next(filter: MatchSpec<M>): Promise<MatchResult>;
+  /**
+   * Wait until the collected history matches the current filter.
+   *
+   * @param timeoutMs - optional deadline.  Without one, the promise settles
+   *   when the actor exits (with `ok: false`) — pass a timeout for a hard
+   *   failure with a diagnostic instead of relying on the test runner's
+   *   global timeout.
+   */
+  resolved(timeoutMs?: number): Promise<MatchResult>;
+  next(filter: MatchSpec<M>, timeoutMs?: number): Promise<MatchResult>;
   reset(filter?: MatchSpec<M>): void;
 }
 interface RootTracker {
@@ -32,5 +53,5 @@ declare function createRootTracker(): RootTracker;
 /** True if `name` matches any of `patterns`. */
 declare function pnameMatch(name: string, patterns: string[]): boolean;
 //#endregion
-export { type Collector, type MatchResult, type MatchSpec, type Matcher, type RootTracker, createCollector, createRootTracker, pnameMatch, toMatcher };
+export { type Collector, type MatchResult, type MatchSpec, type Matcher, type RootTracker, createCollector, createRootTracker, pnameMatch, times, toMatcher };
 //# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/test-plugin.ts","../../src/testing/pname-match.ts"],"mappings":";;;;KAaY,OAAA,WAAkB,OAAA,KAAY,GAAA,EAAK,CAAA,EAAG,OAAA,EAAS,CAAA;AAAA,KAE/C,SAAA,WAAoB,OAAA,IAC5B,OAAA,CAAQ,CAAA,IACR,OAAA,CAAQ,CAAA,IACR,KAAA,CAAM,OAAA,CAAQ,CAAA;;iBAUF,SAAA,WAAoB,OAAA,EAAS,IAAA,EAAM,SAAA,CAAU,CAAA,IAAK,OAAA,CAAQ,CAAA;;;UChBzD,WAAA;EACf,EAAA;EACA,MAAM;AAAA;AAAA,UAGS,SAAA,WAAoB,OAAA;EACnC,MAAA,EAAQ,WAAA;EACR,QAAA,EAAU,CAAA;EACV,QAAA,IAAY,OAAA,CAAQ,WAAA;EACpB,IAAA,CAAK,MAAA,EAAQ,SAAA,CAAU,CAAA,IAAK,OAAA,CAAQ,WAAA;EACpC,KAAA,CAAM,MAAA,GAAS,SAAA,CAAU,CAAA;AAAA;AAAA,UAGV,WAAA;EACf,MAAA,EAAQ,WAAA;EACR,OAAA,IAAW,OAAO;AAAA;AAAA,iBAKJ,eAAA,WAA0B,OAAA,EACxC,MAAA,EAAQ,SAAA,CAAU,CAAA,GAClB,IAAA;EAAS,KAAA;AAAA,IACR,SAAA,CAAU,CAAA;AAAA,iBAwEG,iBAAA,IAAqB,WAAW;;;;iBCjGhC,UAAA,CAAW,IAAA,UAAc,QAAkB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/test-plugin.ts","../../src/testing/pname-match.ts"],"mappings":";;;;KAaY,OAAA,WAAkB,OAAA,KAAY,GAAA,EAAK,CAAA,EAAG,OAAA,EAAS,CAAA;AAAA,KAE/C,SAAA,WAAoB,OAAA,IAC5B,OAAA,CAAQ,CAAA,IACR,OAAA,CAAQ,CAAA,IACR,KAAA,CAAM,OAAA,CAAQ,CAAA;;iBAUF,SAAA,WAAoB,OAAA,EAAS,IAAA,EAAM,SAAA,CAAU,CAAA,IAAK,OAAA,CAAQ,CAAA;;;;;;;;;;;;iBA2B1D,KAAA,WAAgB,OAAA,EAC9B,IAAA,EAAM,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA,GAC3B,CAAA,WACC,OAAA,CAAQ,CAAA;;;UCxCM,WAAA;EACf,EAAA;EDNiB;ECQjB,MAAM;AAAA;AAAA,UAGS,SAAA,WAAoB,OAAA;EACnC,MAAA,EAAQ,WAAA;EACR,QAAA,EAAU,CAAA;EDbgD;;;;;;;;ECsB1D,QAAA,CAAS,SAAA,YAAqB,OAAA,CAAQ,WAAA;EACtC,IAAA,CAAK,MAAA,EAAQ,SAAA,CAAU,CAAA,GAAI,SAAA,YAAqB,OAAA,CAAQ,WAAA;EACxD,KAAA,CAAM,MAAA,GAAS,SAAA,CAAU,CAAA;AAAA;AAAA,UAGV,WAAA;EACf,MAAA,EAAQ,WAAA;EACR,OAAA,IAAW,OAAO;AAAA;AAAA,iBAoBJ,eAAA,WAA0B,OAAA,EACxC,MAAA,EAAQ,SAAA,CAAU,CAAA,GAClB,IAAA;EAAS,KAAA;AAAA,IACR,SAAA,CAAU,CAAA;AAAA,iBAiGG,iBAAA,IAAqB,WAAW;;;;iBCxJhC,UAAA,CAAW,IAAA,UAAc,QAAkB"}

package/dist/testing/index.js

@@ -14,6 +14,21 @@ function toMatcher(spec) {
 	};
 	return (msg) => shallowMatch(msg, spec);
 }
+/**
+* Occurrence matcher: matches when at least `n` messages in the history
+* satisfy `spec`.  This is the canonical form for "Nth occurrence" waits:
+*
+*   const c = createCollector<PongMsg>({ type: "PONG" });
+*   await c.next(times({ type: "PONG" }, 3));  // wait for the 3rd PONG
+*
+* Note: `history` accumulates, so this counts occurrences over the whole
+* collected history, not since the previous `next()`.  Use `reset()` with a
+* fresh collector for windowed counts.
+*/
+function times(spec, n) {
+	const single = typeof spec === "function" ? spec : (m) => shallowMatch(m, spec);
+	return (_msg, history) => history.filter((m) => single(m, history)).length >= n;
+}
 //#endregion
 //#region src/testing/pname-match.ts
 /** True if `name` matches any of `patterns`. */
@@ -29,12 +44,27 @@ function pnameMatch(name, patterns) {
 }
 //#endregion
 //#region src/testing/test-plugin.ts
+function describeSpec(spec) {
+	if (typeof spec === "function") return "predicate";
+	if (Array.isArray(spec)) return `sequence [${spec.map((s) => JSON.stringify(s)).join(" → ")}]`;
+	return JSON.stringify(spec);
+}
+function lastSummary(messages) {
+	const last = messages[messages.length - 1];
+	if (last === void 0) return "none";
+	return JSON.stringify(last).slice(0, 120);
+}
 function createCollector(filter, opts) {
 	const messages = [];
 	let matcher = toMatcher(filter);
+	let currentSpec = filter;
 	let defaultScope = [];
 	let installed = false;
 	let waiters = [];
+	function setSpec(spec) {
+		currentSpec = spec;
+		matcher = toMatcher(spec);
+	}
 	function scopePatterns() {
 		if (opts?.scope === void 0) return defaultScope;
 		return Array.isArray(opts.scope) ? opts.scope : [opts.scope];
@@ -46,14 +76,27 @@ function createCollector(filter, opts) {
 			for (const w of ws) w({ ok: true });
 		}
 	}
-	function resolved() {
+	function resolved(timeoutMs) {
 		return new Promise((resolve) => {
 			const last = messages[messages.length - 1];
 			if (last !== void 0 && matcher(last, messages)) {
 				resolve({ ok: true });
 				return;
 			}
-			waiters.push(resolve);
+			let timer;
+			const settle = (result) => {
+				const i = waiters.indexOf(settle);
+				if (i >= 0) waiters.splice(i, 1);
+				if (timer) clearTimeout(timer);
+				resolve(result);
+			};
+			waiters.push(settle);
+			if (timeoutMs !== void 0) timer = setTimeout(() => {
+				settle({
+					ok: false,
+					detail: `timeout after ${timeoutMs}ms — expected: ${describeSpec(currentSpec)} — received ${messages.length} message(s), last: ${lastSummary(messages)}`
+				});
+			}, timeoutMs);
 		});
 	}
 	const collectorPlugin = (config) => {
@@ -82,12 +125,12 @@ function createCollector(filter, opts) {
 		plugin: collectorPlugin,
 		messages,
 		resolved,
-		next(nextFilter) {
-			matcher = toMatcher(nextFilter);
-			return resolved();
+		next(nextFilter, timeoutMs) {
+			setSpec(nextFilter);
+			return resolved(timeoutMs);
 		},
 		reset(newFilter) {
-			if (newFilter) matcher = toMatcher(newFilter);
+			if (newFilter) setSpec(newFilter);
 		}
 	};
 }
@@ -113,6 +156,6 @@ function createRootTracker() {
 	};
 }
 //#endregion
-export { createCollector, createRootTracker, pnameMatch, toMatcher };
+export { createCollector, createRootTracker, pnameMatch, times, toMatcher };
 
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/pname-match.ts","../../src/testing/test-plugin.ts"],"sourcesContent":["// ── Message Matcher ──────────────────────────────────────────────────────\n//\n// Canonical form: `fn(msg, history) => boolean`.  `msg` is the just-arrived\n// message (also the last element of `history`); `history` is the full\n// accumulated list *including* `msg`.\n//\n// Two shortcuts:\n//   - a message literal `{ type: \"X\" }`  → matches the latest message\n//   - a list `[{...}, {...}]`            → matches the tail of history,\n//                                           in order, from oldest to newest\n\nimport type { Message } from \"../types.js\";\n\nexport type Matcher<M extends Message> = (msg: M, history: M[]) => boolean;\n\nexport type MatchSpec<M extends Message> =\n  | Matcher<M>\n  | Partial<M>\n  | Array<Partial<M>>;\n\nfunction shallowMatch<M extends Message>(msg: M, spec: Partial<M>): boolean {\n  for (const key of Object.keys(spec) as Array<keyof M>) {\n    if (msg[key] !== spec[key]) return false;\n  }\n  return true;\n}\n\n/** Convert a matcher spec to a canonical matcher function. */\nexport function toMatcher<M extends Message>(spec: MatchSpec<M>): Matcher<M> {\n  if (typeof spec === \"function\") return spec as Matcher<M>;\n\n  if (Array.isArray(spec)) {\n    // Sequence: the tail of history must equal `spec`, in order.\n    return (_msg, history) => {\n      if (history.length < spec.length) return false;\n      const tail = history.slice(-spec.length);\n      return spec.every((s, i) => shallowMatch(tail[i], s));\n    };\n  }\n\n  // Single literal: the latest message must shallow-match.\n  return (msg) => shallowMatch(msg, spec);\n}\n","// ── Process Name Match ───────────────────────────────────────────────────\n//\n// Tree-prefix matching for posipaki process names (`parent:child:...`).\n//\n// Pattern language (same as debug-logger's DEBUG env filtering):\n//   - \"*\"            matches any name\n//   - \"name\"         matches exactly\n//   - \"prefix:*\"     matches `prefix` and `prefix:` + anything below it\n\n/** True if `name` matches any of `patterns`. */\nexport function pnameMatch(name: string, patterns: string[]): boolean {\n  for (const p of patterns) {\n    if (p === \"*\") return true;\n    if (p.endsWith(\":*\")) {\n      const prefix = p.slice(0, -2);\n      if (name === prefix || name.startsWith(prefix + \":\")) return true;\n    } else if (p === name) {\n      return true;\n    }\n  }\n  return false;\n}\n","// ── Test Plugins ─────────────────────────────────────────────────────────\n//\n// createCollector: per-actor message collector plugin.\n// createRootTracker: global process tracker for cleanup.\n\nimport { mergeConfigs, type ActorPlugin } from \"../hooks.js\";\nimport type { Message, StopMessage, SenderInfo, ProcessCtx } from \"../types.js\";\nimport { toMatcher, type MatchSpec } from \"./msg-matcher.js\";\nimport { pnameMatch } from \"./pname-match.js\";\n\n// ── types ────────────────────────────────────────────────────────────────\n\nexport interface MatchResult {\n  ok: boolean;\n  detail?: string;\n}\n\nexport interface Collector<M extends Message> {\n  plugin: ActorPlugin;\n  messages: M[];\n  resolved(): Promise<MatchResult>;\n  next(filter: MatchSpec<M>): Promise<MatchResult>;\n  reset(filter?: MatchSpec<M>): void;\n}\n\nexport interface RootTracker {\n  plugin: ActorPlugin;\n  stopAll(): Promise<void>;\n}\n\n// ── createCollector ──────────────────────────────────────────────────────\n\nexport function createCollector<M extends Message>(\n  filter: MatchSpec<M>,\n  opts?: { scope?: string | string[] },\n): Collector<M> {\n  const messages: M[] = [];\n  let matcher = toMatcher(filter);\n  // Captured from the root's beforeStart; used as the default scope.\n  let defaultScope: string[] = [];\n  // The plugin is installed on the root first (spawn assembles before any\n  // child is forked), so the first install's beforeStart is the root.\n  let installed = false;\n  let waiters: Array<(result: MatchResult) => void> = [];\n\n  function scopePatterns(): string[] {\n    if (opts?.scope === undefined) return defaultScope;\n    return Array.isArray(opts.scope) ? opts.scope : [opts.scope];\n  }\n\n  function checkAndNotify() {\n    const last = messages[messages.length - 1];\n    if (last !== undefined && matcher(last, messages)) {\n      const ws = waiters.splice(0);\n      for (const w of ws) w({ ok: true });\n    }\n  }\n\n  function resolved(): Promise<MatchResult> {\n    return new Promise((resolve) => {\n      const last = messages[messages.length - 1];\n      if (last !== undefined && matcher(last, messages)) {\n        resolve({ ok: true });\n        return;\n      }\n      waiters.push(resolve);\n    });\n  }\n\n  const collectorPlugin: ActorPlugin = (config) => {\n    const isRoot = !installed;\n    installed = true;\n    return mergeConfigs(config, {\n      beforeStart() {\n        if (isRoot) defaultScope = [this.name];\n      },\n      onEmit(msg: Message, sender: SenderInfo) {\n        if (!pnameMatch(sender.fromName, scopePatterns())) return;\n        messages.push(msg as M);\n        checkAndNotify();\n      },\n      beforeEnd() {\n        const ws = waiters.splice(0);\n        for (const w of ws) w({ ok: false, detail: \"actor exited before match\" });\n      },\n    });\n  };\n\n  // Named function so framework deduplication works.\n  Object.defineProperty(collectorPlugin, \"name\", { value: \"messageCollector\" });\n\n  return {\n    plugin: collectorPlugin,\n    messages,\n    resolved,\n    next(nextFilter) {\n      matcher = toMatcher(nextFilter);\n      return resolved();\n    },\n    reset(newFilter) {\n      if (newFilter) matcher = toMatcher(newFilter);\n    },\n  };\n}\n\n// ── createRootTracker ────────────────────────────────────────────────────\n\nexport function createRootTracker(): RootTracker {\n  const roots = new Set<{ sendSelf: (msg: StopMessage) => void }>();\n\n  const rootTrackerPlugin: ActorPlugin = (config) =>\n    mergeConfigs(config, {\n      beforeStart(this: { ctx: ProcessCtx<unknown, unknown, Message, Message> }) {\n        roots.add(this.ctx);\n      },\n      afterEnd(this: { ctx: ProcessCtx<unknown, unknown, Message, Message> }) {\n        roots.delete(this.ctx);\n      },\n    });\n\n  Object.defineProperty(rootTrackerPlugin, \"name\", { value: \"rootTracker\" });\n\n  return {\n    plugin: rootTrackerPlugin,\n    async stopAll() {\n      for (const root of roots) {\n        try {\n          root.sendSelf({ type: \"STOP\" });\n        } catch {}\n      }\n      roots.clear();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/pname-match.ts","../../src/testing/test-plugin.ts"],"sourcesContent":["// ── Message Matcher ──────────────────────────────────────────────────────\n//\n// Canonical form: `fn(msg, history) => boolean`.  `msg` is the just-arrived\n// message (also the last element of `history`); `history` is the full\n// accumulated list *including* `msg`.\n//\n// Two shortcuts:\n//   - a message literal `{ type: \"X\" }`  → matches the latest message\n//   - a list `[{...}, {...}]`            → matches the tail of history,\n//                                           in order, from oldest to newest\n\nimport type { Message } from \"../types.js\";\n\nexport type Matcher<M extends Message> = (msg: M, history: M[]) => boolean;\n\nexport type MatchSpec<M extends Message> =\n  | Matcher<M>\n  | Partial<M>\n  | Array<Partial<M>>;\n\nfunction shallowMatch<M extends Message>(msg: M, spec: Partial<M>): boolean {\n  for (const key of Object.keys(spec) as Array<keyof M>) {\n    if (msg[key] !== spec[key]) return false;\n  }\n  return true;\n}\n\n/** Convert a matcher spec to a canonical matcher function. */\nexport function toMatcher<M extends Message>(spec: MatchSpec<M>): Matcher<M> {\n  if (typeof spec === \"function\") return spec as Matcher<M>;\n\n  if (Array.isArray(spec)) {\n    // Sequence: the tail of history must equal `spec`, in order.\n    return (_msg, history) => {\n      if (history.length < spec.length) return false;\n      const tail = history.slice(-spec.length);\n      return spec.every((s, i) => shallowMatch(tail[i], s));\n    };\n  }\n\n  // Single literal: the latest message must shallow-match.\n  return (msg) => shallowMatch(msg, spec);\n}\n\n/**\n * Occurrence matcher: matches when at least `n` messages in the history\n * satisfy `spec`.  This is the canonical form for \"Nth occurrence\" waits:\n *\n *   const c = createCollector<PongMsg>({ type: \"PONG\" });\n *   await c.next(times({ type: \"PONG\" }, 3));  // wait for the 3rd PONG\n *\n * Note: `history` accumulates, so this counts occurrences over the whole\n * collected history, not since the previous `next()`.  Use `reset()` with a\n * fresh collector for windowed counts.\n */\nexport function times<M extends Message>(\n  spec: Partial<M> | Matcher<M>,\n  n: number,\n): Matcher<M> {\n  const single: Matcher<M> =\n    typeof spec === \"function\" ? spec : (m) => shallowMatch(m, spec);\n  return (_msg, history) => history.filter((m) => single(m, history)).length >= n;\n}\n","// ── Process Name Match ───────────────────────────────────────────────────\n//\n// Tree-prefix matching for posipaki process names (`parent:child:...`).\n//\n// Pattern language (same as debug-logger's DEBUG env filtering):\n//   - \"*\"            matches any name\n//   - \"name\"         matches exactly\n//   - \"prefix:*\"     matches `prefix` and `prefix:` + anything below it\n\n/** True if `name` matches any of `patterns`. */\nexport function pnameMatch(name: string, patterns: string[]): boolean {\n  for (const p of patterns) {\n    if (p === \"*\") return true;\n    if (p.endsWith(\":*\")) {\n      const prefix = p.slice(0, -2);\n      if (name === prefix || name.startsWith(prefix + \":\")) return true;\n    } else if (p === name) {\n      return true;\n    }\n  }\n  return false;\n}\n","// ── Test Plugins ─────────────────────────────────────────────────────────\n//\n// createCollector: per-actor message collector plugin.\n// createRootTracker: global process tracker for cleanup.\n//\n// Observation model: the collector is a plugin installed on the root.  It\n// sees every message that flows through the process's onEmit, filtered by\n// a pname scope (default: the root and everything below it).  Waiting is\n// event-driven — `resolved()` settles when a matching message arrives, the\n// actor exits, or an explicit timeout fires.  No polling.\n\nimport { mergeConfigs, type ActorPlugin } from \"../hooks.js\";\nimport type { Message, StopMessage, SenderInfo, ProcessCtx } from \"../types.js\";\nimport { toMatcher, type MatchSpec } from \"./msg-matcher.js\";\nimport { pnameMatch } from \"./pname-match.js\";\n\n// ── types ────────────────────────────────────────────────────────────────\n\nexport interface MatchResult {\n  ok: boolean;\n  /** Human-readable diagnosis on failure (timeout / exit-before-match). */\n  detail?: string;\n}\n\nexport interface Collector<M extends Message> {\n  plugin: ActorPlugin;\n  messages: M[];\n  /**\n   * Wait until the collected history matches the current filter.\n   *\n   * @param timeoutMs - optional deadline.  Without one, the promise settles\n   *   when the actor exits (with `ok: false`) — pass a timeout for a hard\n   *   failure with a diagnostic instead of relying on the test runner's\n   *   global timeout.\n   */\n  resolved(timeoutMs?: number): Promise<MatchResult>;\n  next(filter: MatchSpec<M>, timeoutMs?: number): Promise<MatchResult>;\n  reset(filter?: MatchSpec<M>): void;\n}\n\nexport interface RootTracker {\n  plugin: ActorPlugin;\n  stopAll(): Promise<void>;\n}\n\n// ── diagnostics helpers ──────────────────────────────────────────────────\n\nfunction describeSpec<M extends Message>(spec: MatchSpec<M>): string {\n  if (typeof spec === \"function\") return \"predicate\";\n  if (Array.isArray(spec))\n    return `sequence [${spec.map((s) => JSON.stringify(s)).join(\" → \")}]`;\n  return JSON.stringify(spec);\n}\n\nfunction lastSummary<M extends Message>(messages: M[]): string {\n  const last = messages[messages.length - 1];\n  if (last === undefined) return \"none\";\n  return JSON.stringify(last).slice(0, 120);\n}\n\n// ── createCollector ──────────────────────────────────────────────────────\n\nexport function createCollector<M extends Message>(\n  filter: MatchSpec<M>,\n  opts?: { scope?: string | string[] },\n): Collector<M> {\n  const messages: M[] = [];\n  let matcher = toMatcher(filter);\n  // The spec currently active — kept in sync with `matcher` so timeout\n  // diagnostics can say what was expected.\n  let currentSpec: MatchSpec<M> = filter;\n  // Captured from the root's beforeStart; used as the default scope.\n  let defaultScope: string[] = [];\n  // The plugin is installed on the root first (spawn assembles before any\n  // child is forked), so the first install's beforeStart is the root.\n  let installed = false;\n  let waiters: Array<(result: MatchResult) => void> = [];\n\n  function setSpec(spec: MatchSpec<M>) {\n    currentSpec = spec;\n    matcher = toMatcher(spec);\n  }\n\n  function scopePatterns(): string[] {\n    if (opts?.scope === undefined) return defaultScope;\n    return Array.isArray(opts.scope) ? opts.scope : [opts.scope];\n  }\n\n  function checkAndNotify() {\n    const last = messages[messages.length - 1];\n    if (last !== undefined && matcher(last, messages)) {\n      const ws = waiters.splice(0);\n      for (const w of ws) w({ ok: true });\n    }\n  }\n\n  function resolved(timeoutMs?: number): Promise<MatchResult> {\n    return new Promise((resolve) => {\n      const last = messages[messages.length - 1];\n      if (last !== undefined && matcher(last, messages)) {\n        resolve({ ok: true });\n        return;\n      }\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const settle = (result: MatchResult) => {\n        const i = waiters.indexOf(settle);\n        if (i >= 0) waiters.splice(i, 1);\n        if (timer) clearTimeout(timer);\n        resolve(result);\n      };\n      waiters.push(settle);\n      if (timeoutMs !== undefined) {\n        timer = setTimeout(() => {\n          settle({\n            ok: false,\n            detail:\n              `timeout after ${timeoutMs}ms — expected: ${describeSpec(currentSpec)} ` +\n              `— received ${messages.length} message(s), last: ${lastSummary(messages)}`,\n          });\n        }, timeoutMs);\n      }\n    });\n  }\n\n  const collectorPlugin: ActorPlugin = (config) => {\n    const isRoot = !installed;\n    installed = true;\n    return mergeConfigs(config, {\n      beforeStart() {\n        if (isRoot) defaultScope = [this.name];\n      },\n      onEmit(msg: Message, sender: SenderInfo) {\n        if (!pnameMatch(sender.fromName, scopePatterns())) return;\n        messages.push(msg as M);\n        checkAndNotify();\n      },\n      beforeEnd() {\n        const ws = waiters.splice(0);\n        for (const w of ws) w({ ok: false, detail: \"actor exited before match\" });\n      },\n    });\n  };\n\n  // Named function so framework deduplication works.\n  Object.defineProperty(collectorPlugin, \"name\", { value: \"messageCollector\" });\n\n  return {\n    plugin: collectorPlugin,\n    messages,\n    resolved,\n    next(nextFilter, timeoutMs) {\n      setSpec(nextFilter);\n      return resolved(timeoutMs);\n    },\n    reset(newFilter) {\n      if (newFilter) setSpec(newFilter);\n    },\n  };\n}\n\n// ── createRootTracker ────────────────────────────────────────────────────\n\nexport function createRootTracker(): RootTracker {\n  const roots = new Set<{ sendSelf: (msg: StopMessage) => void }>();\n\n  const rootTrackerPlugin: ActorPlugin = (config) =>\n    mergeConfigs(config, {\n      beforeStart(this: { ctx: ProcessCtx<unknown, unknown, Message, Message> }) {\n        roots.add(this.ctx);\n      },\n      afterEnd(this: { ctx: ProcessCtx<unknown, unknown, Message, Message> }) {\n        roots.delete(this.ctx);\n      },\n    });\n\n  Object.defineProperty(rootTrackerPlugin, \"name\", { value: \"rootTracker\" });\n\n  return {\n    plugin: rootTrackerPlugin,\n    async stopAll() {\n      for (const root of roots) {\n        try {\n          root.sendSelf({ type: \"STOP\" });\n        } catch {}\n      }\n      roots.clear();\n    },\n  };\n}\n"],"mappings":";;AAoBA,SAAS,aAAgC,KAAQ,MAA2B;CAC1E,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,GAChC,IAAI,IAAI,SAAS,KAAK,MAAM,OAAO;CAErC,OAAO;AACT;;AAGA,SAAgB,UAA6B,MAAgC;CAC3E,IAAI,OAAO,SAAS,YAAY,OAAO;CAEvC,IAAI,MAAM,QAAQ,IAAI,GAEpB,QAAQ,MAAM,YAAY;EACxB,IAAI,QAAQ,SAAS,KAAK,QAAQ,OAAO;EACzC,MAAM,OAAO,QAAQ,MAAM,CAAC,KAAK,MAAM;EACvC,OAAO,KAAK,OAAO,GAAG,MAAM,aAAa,KAAK,IAAI,CAAC,CAAC;CACtD;CAIF,QAAQ,QAAQ,aAAa,KAAK,IAAI;AACxC;;;;;;;;;;;;AAaA,SAAgB,MACd,MACA,GACY;CACZ,MAAM,SACJ,OAAO,SAAS,aAAa,QAAQ,MAAM,aAAa,GAAG,IAAI;CACjE,QAAQ,MAAM,YAAY,QAAQ,QAAQ,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,UAAU;AAChF;;;;ACpDA,SAAgB,WAAW,MAAc,UAA6B;CACpE,KAAK,MAAM,KAAK,UAAU;EACxB,IAAI,MAAM,KAAK,OAAO;EACtB,IAAI,EAAE,SAAS,IAAI,GAAG;GACpB,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;GAC5B,IAAI,SAAS,UAAU,KAAK,WAAW,SAAS,GAAG,GAAG,OAAO;EAC/D,OAAO,IAAI,MAAM,MACf,OAAO;CAEX;CACA,OAAO;AACT;;;AC0BA,SAAS,aAAgC,MAA4B;CACnE,IAAI,OAAO,SAAS,YAAY,OAAO;CACvC,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,aAAa,KAAK,KAAK,MAAM,KAAK,UAAU,CAAC,CAAC,EAAE,KAAK,KAAK,EAAE;CACrE,OAAO,KAAK,UAAU,IAAI;AAC5B;AAEA,SAAS,YAA+B,UAAuB;CAC7D,MAAM,OAAO,SAAS,SAAS,SAAS;CACxC,IAAI,SAAS,KAAA,GAAW,OAAO;CAC/B,OAAO,KAAK,UAAU,IAAI,EAAE,MAAM,GAAG,GAAG;AAC1C;AAIA,SAAgB,gBACd,QACA,MACc;CACd,MAAM,WAAgB,CAAC;CACvB,IAAI,UAAU,UAAU,MAAM;CAG9B,IAAI,cAA4B;CAEhC,IAAI,eAAyB,CAAC;CAG9B,IAAI,YAAY;CAChB,IAAI,UAAgD,CAAC;CAErD,SAAS,QAAQ,MAAoB;EACnC,cAAc;EACd,UAAU,UAAU,IAAI;CAC1B;CAEA,SAAS,gBAA0B;EACjC,IAAI,MAAM,UAAU,KAAA,GAAW,OAAO;EACtC,OAAO,MAAM,QAAQ,KAAK,KAAK,IAAI,KAAK,QAAQ,CAAC,KAAK,KAAK;CAC7D;CAEA,SAAS,iBAAiB;EACxB,MAAM,OAAO,SAAS,SAAS,SAAS;EACxC,IAAI,SAAS,KAAA,KAAa,QAAQ,MAAM,QAAQ,GAAG;GACjD,MAAM,KAAK,QAAQ,OAAO,CAAC;GAC3B,KAAK,MAAM,KAAK,IAAI,EAAE,EAAE,IAAI,KAAK,CAAC;EACpC;CACF;CAEA,SAAS,SAAS,WAA0C;EAC1D,OAAO,IAAI,SAAS,YAAY;GAC9B,MAAM,OAAO,SAAS,SAAS,SAAS;GACxC,IAAI,SAAS,KAAA,KAAa,QAAQ,MAAM,QAAQ,GAAG;IACjD,QAAQ,EAAE,IAAI,KAAK,CAAC;IACpB;GACF;GACA,IAAI;GACJ,MAAM,UAAU,WAAwB;IACtC,MAAM,IAAI,QAAQ,QAAQ,MAAM;IAChC,IAAI,KAAK,GAAG,QAAQ,OAAO,GAAG,CAAC;IAC/B,IAAI,OAAO,aAAa,KAAK;IAC7B,QAAQ,MAAM;GAChB;GACA,QAAQ,KAAK,MAAM;GACnB,IAAI,cAAc,KAAA,GAChB,QAAQ,iBAAiB;IACvB,OAAO;KACL,IAAI;KACJ,QACE,iBAAiB,UAAU,iBAAiB,aAAa,WAAW,EAAE,cACxD,SAAS,OAAO,qBAAqB,YAAY,QAAQ;IAC3E,CAAC;GACH,GAAG,SAAS;EAEhB,CAAC;CACH;CAEA,MAAM,mBAAgC,WAAW;EAC/C,MAAM,SAAS,CAAC;EAChB,YAAY;EACZ,OAAO,aAAa,QAAQ;GAC1B,cAAc;IACZ,IAAI,QAAQ,eAAe,CAAC,KAAK,IAAI;GACvC;GACA,OAAO,KAAc,QAAoB;IACvC,IAAI,CAAC,WAAW,OAAO,UAAU,cAAc,CAAC,GAAG;IACnD,SAAS,KAAK,GAAQ;IACtB,eAAe;GACjB;GACA,YAAY;IACV,MAAM,KAAK,QAAQ,OAAO,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,EAAE;KAAE,IAAI;KAAO,QAAQ;IAA4B,CAAC;GAC1E;EACF,CAAC;CACH;CAGA,OAAO,eAAe,iBAAiB,QAAQ,EAAE,OAAO,mBAAmB,CAAC;CAE5E,OAAO;EACL,QAAQ;EACR;EACA;EACA,KAAK,YAAY,WAAW;GAC1B,QAAQ,UAAU;GAClB,OAAO,SAAS,SAAS;EAC3B;EACA,MAAM,WAAW;GACf,IAAI,WAAW,QAAQ,SAAS;EAClC;CACF;AACF;AAIA,SAAgB,oBAAiC;CAC/C,MAAM,wBAAQ,IAAI,IAA8C;CAEhE,MAAM,qBAAkC,WACtC,aAAa,QAAQ;EACnB,cAA2E;GACzE,MAAM,IAAI,KAAK,GAAG;EACpB;EACA,WAAwE;GACtE,MAAM,OAAO,KAAK,GAAG;EACvB;CACF,CAAC;CAEH,OAAO,eAAe,mBAAmB,QAAQ,EAAE,OAAO,cAAc,CAAC;CAEzE,OAAO;EACL,QAAQ;EACR,MAAM,UAAU;GACd,KAAK,MAAM,QAAQ,OACjB,IAAI;IACF,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;GAChC,QAAQ,CAAC;GAEX,MAAM,MAAM;EACd;CACF;AACF"}

package/dist/types-RfSUSvKp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types-RfSUSvKp.d.ts","names":[],"sources":["../src/process.async.ts","../src/types.ts"],"mappings":";KA0BK,QAAA;AAAA,KAIA,YAAA,OAAmB,GAAA,EAAK,CAAA,KAAM,OAAO;AAAA,KACrC,OAAA;;AALQ;AAAA;;;iBAYU,gBAAA,IACrB,IAAA,UACA,EAAA,EAAI,YAAA,CAAa,CAAA,GACjB,OAAA,GAAS,OAAA,EACT,UAAA,aACC,cAAA,aAA2B,CAAA;;;KAazB,eAAA,WAA0B,OAAA,KAAY,GAAA,EAAK,CAAA,EAAG,IAAA,EAAM,UAAA;;;AA1Bf;AAAA;;;;AAC9B;cAuCC,YAAA,gCAGO,OAAA,qBACC,OAAA;EApCkB;EAwCrC,WAAA,EAAa,iBAAA;EACb,UAAA,EAAY,cAAA,CAAe,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA;EACnD,KAAA;EAvCS;EAAA,QAyCD,kBAAA;EACR,EAAA;EACA,KAAA,EAAO,KAAA;EAAA,QAEC,OAAA;EAhD8B;EAAA,QAkD9B,MAAA;EAAA,QACA,QAAA;EAjDS;EAmDjB,QAAA,EAAU,KAAA,CACR,YAAA,mBAA+B,OAAA,EAAS,OAAA;EAnDjC;EAsDT,OAAA,EAAS,KAAA,CACP,YAAA,mBAA+B,OAAA,EAAS,OAAA;EAAA,QAElC,gBAAA;EAvDP;EAAA,QAyDO,wBAAA;EAzDqB;EAAA,QA2DrB,cAAA;EA9CL;EAAA,QAgDK,UAAA;EAhDU;EAAA,QAkDV,iBAAA;EAAA,QACA,UAAA;EAAA,QACA,WAAA;EAAA,QACA,OAAA;EAAA,QACA,iBAAA;EAAA,QACA,aAAA;EAAA,QACA,QAAA;EAAA,QACA,eAAA;cAGN,EAAA,EAAI,cAAA,CAAe,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA,GAC3C,KAAA,UACA,QAAA,GAAW,eAAA,CAAgB,UAAA;EA9D0B;EA2EvD,KAAA,IAAS,OAAA;EA3EwD;AAAA;AAcnE;;EAuEE,KAAA,CAAM,IAAA,EAAM,IAAA,EAAM,UAAA,kBAA4B,QAAA;EApE5B;EAAA,QAkHH,YAAA;EAkCf,IAAA,wCAA4C,OAAA,kBAAyB,OAAA,EACnE,EAAA,EAAI,cAAA,CAAe,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,OAAA,GACnD,KAAA,YAEA,IAAA,EAAM,SAAA,KACH,YAAA,CAAa,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,OAAA;EAelD,QAAA,wCAGkB,OAAA,kBACA,SAAA,EAEhB,EAAA,EAAI,SAAA,CAAU,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,OAAA,GAC9C,KAAA,YAEA,IAAA,EAAM,SAAA,KACH,YAAA,CAAa,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,OAAA;EAAA,UAMlC,OAAA,IAAW,OAAA;EAlLa;EAAA,QAwM1B,WAAA;EAAA,QAYN,YAAA;EA/MD;EA8NP,aAAA,CAAc,GAAA,EAAK,OAAA;EAtNuB;EA4N1C,IAAA,CAAK,GAAA,EAAK,SAAA,GAAY,WAAA,EAAa,IAAA,GAAO,UAAA;EA7NhC;EA+NV,IAAA,CAAK,YAAA,EAAc,UAAA,CAAW,SAAA,GAAY,WAAA;EA1NA;;;;;EAgP1C,IAAA;EAAA,QAKQ,eAAA;EAYR,MAAA;EAAA,IAII,YAAA;EAIJ,SAAA,CAAU,OAAA,aAAoB,EAAA,EAAI,eAAA,CAAgB,UAAA;EAClD,SAAA,CAAU,OAAA,WAAkB,EAAA,EAAI,QAAA;EA7NpB;EA+NZ,SAAA,CAAU,EAAA,EAAI,QAAA;EAAA,QAkBN,cAAA;EAhKa;;;;;;EA6KrB,KAAA;EAMA,MAAA;EA/KyC;;;;;;;;;;;;;;EAkMzC,SAAA,CAAU,IAAA;IAAS,OAAA;EAAA;EAlHA;;;;;;;;;;;;EAgKb,IAAA,CAAK,IAAA;IAAS,KAAA;IAAiB,IAAA,GAAO,UAAA;EAAA,IAAe,OAAA;EA4DrC;;;;EAzBtB,IAAA,IAAQ,OAAA;EAuCqC;;;;;EAf7C,OAAA,wCAA+C,OAAA,kBAAyB,OAAA,EACtE,KAAA,EAAO,YAAA,CAAa,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,OAAA;EAe7C;;;;;EADT,KAAA,wCAA6C,OAAA,kBAAyB,OAAA,EACpE,KAAA,EAAO,YAAA,CAAa,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,OAAA;EApdpC;EAAA,QAieV,eAAA;EAheW;EAAA,QAifX,iBAAA;EA7eR;;EAAA,QAsfQ,iBAAA;EArfI;EAAA,QA+fJ,WAAA;EA/fyB;EAAA,QA8gBzB,kBAAA;EA9gB2C;EAAA,QA4hB3C,eAAA;EAzhBA;;;;;EA2iBR,QAAA;AAAA;AAAA,KAQU,UAAA,GAAa,YAAA,mBAA+B,OAAA,EAAS,OAAA;;;;;iBAOjD,UAAA,gCAGI,OAAA,GAAU,OAAA,qBACT,OAAA,GAAU,WAAA,EAE7B,EAAA,EAAI,cAAA,CAAe,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA,GAC3C,KAAA,UACA,QAAA,GAAW,eAAA,CAAgB,UAAA,KACzB,IAAA,EAAM,IAAA,KAAS,YAAA,CAAa,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA;;;AA3nB3C;;AAAA,UCfI,OAAA;EACf,IAAI;AAAA;;UAMW,UAAA;EACf,QAAA;EACA,MAAM;AAAA;ADUkC;;;AAAA,KCF9B,UAAA,WAAqB,OAAA,KAAY,CAAA,EAAG,UAAA;ADGpC;AAAA,KCAA,aAAA,WAAwB,UAAA,SAAmB,CAAC;;;KAM5C,WAAA;EACV,IAAA;EDGS;;ECAT,OAAA,GAAU,KAAK,CAAC,UAAA;AAAA;AAAA,KAGN,WAAA;EACV,IAAI;AAAA;AAAA,KAKM,SAAA,gCAGQ,OAAA,qBACC,OAAA,KAEnB,GAAA,EAAK,UAAA,CAAW,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA,GACxC,IAAA,EAAM,IAAA,KACH,SAAA,CAAU,KAAA,eAAoB,UAAA,CAAW,SAAA,GAAY,WAAA;AAAA,KAI9C,cAAA,gCAGQ,OAAA,GAAU,OAAA,qBACT,OAAA,GAAU,OAAA,KAE7B,GAAA,EAAK,UAAA,CAAW,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA,GACxC,IAAA,EAAM,IAAA,KACH,cAAA,CAAe,KAAA,eAAoB,UAAA,CAAW,SAAA,GAAY,WAAA;;;KAMnD,YAAA,GACV,UAAA,mBAA6B,OAAA,EAAS,OAAA;AAAA,KAInC,gBAAA,OAAuB,GAAA,EAAK,CAAC;;;AD/BjC;AAAA,KC4DW,UAAA,yBAAmC,OAAA,aAAoB,OAAA;EACjE,KAAA;EACA,EAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA,GAAW,GAAA,EAAK,EAAA,GAAK,WAAA;EACrB,QAAA,EAAU,gBAAA,CAAiB,EAAA;ED5DR;;EC+DnB,SAAA,SAAkB,OAAA;AAAA,IAChB,IAAA,CAAK,YAAA,CAAa,IAAA,EAAM,KAAA,EAAO,EAAA,EAAI,EAAA;;UAMtB,SAAA;EACf,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,MAAM;EACd,OAAA;AAAA;;UAMe,eAAA;EACf,SAAA;EACA,KAAK;AAAA"}
+{"version":3,"file":"types-RfSUSvKp.d.ts","names":[],"sources":["../src/process.async.ts","../src/types.ts"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "posipaki",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [