actor-ts 0.9.0

package/dist/ActorContext.d.ts

@@ -0,0 +1,171 @@
+import type { ActorRef } from './ActorRef.js';
+import type { ActorPath } from './ActorPath.js';
+import type { ActorSystem } from './ActorSystem.js';
+import type { Props } from './Props.js';
+import type { Logger } from './Logger.js';
+import type { Option } from './util/Option.js';
+/** Behaviour is just a message handler. Used for become/unbecome. */
+export type Receive<T> = (message: T) => void | Promise<void>;
+/**
+ * Runtime API given to every Actor.  Access through `this.context` inside
+ * an Actor subclass.
+ */
+export interface ActorContext<TMsg = unknown> {
+    /** A reference to this actor. */
+    readonly self: ActorRef<TMsg>;
+    /** The ActorPath of this actor. */
+    readonly path: ActorPath;
+    /** The sender of the message currently being processed, or `None`. */
+    readonly sender: Option<ActorRef>;
+    /** The enclosing ActorSystem. */
+    readonly system: ActorSystem;
+    /** Parent actor, or `None` for the root guardian. */
+    readonly parent: Option<ActorRef>;
+    /** Snapshot of direct children. */
+    readonly children: ReadonlyArray<ActorRef>;
+    /** Logger bound to this actor's path. */
+    readonly log: Logger;
+    /**
+     * Spawn a child actor under this one with a deterministic
+     * caller-supplied name.  The name must be unique among siblings.
+     * For an auto-generated name, see {@link spawnAnonymous}.
+     */
+    spawn<T>(props: Props<T>, name: string): ActorRef<T>;
+    /**
+     * Spawn a child actor under this one with an auto-generated name.
+     * Useful for one-shot helpers and other transient children where
+     * the caller doesn't need a stable path.  For a deterministic
+     * name, see {@link spawn}.
+     */
+    spawnAnonymous<T>(props: Props<T>): ActorRef<T>;
+    /**
+     * Spawn a typed-Behavior child with a deterministic name — the
+     * Behavior-DSL counterpart to {@link spawn}.  Wraps the Behavior
+     * in `typedProps` internally so callers don't have to.
+     *
+     *     const child = this.context.spawnTyped(counter(0), 'counter');
+     */
+    spawnTyped<T>(behavior: import('./typed/Behavior.js').Behavior<T>, name: string): ActorRef<T>;
+    /**
+     * Anonymous variant of {@link spawnTyped} — the Behavior-DSL
+     * counterpart to {@link spawnAnonymous}.
+     */
+    spawnTypedAnonymous<T>(behavior: import('./typed/Behavior.js').Behavior<T>): ActorRef<T>;
+    /** Look up a direct child by name.  `None` if no such child exists. */
+    child(name: string): Option<ActorRef>;
+    /**
+     * Build an ActorSelection that resolves a full-path lookup.  Delegates to
+     * the enclosing ActorSystem — same semantics as `system.actorSelection`.
+     */
+    actorSelection(path: string): import('./ActorSelection.js').ActorSelection;
+    /** Ask the runtime to stop the given actor.  Equivalent to ref.stop(). */
+    stop(ref: ActorRef): void;
+    /** Stop this actor itself. */
+    stopSelf(): void;
+    /** Start death-watching an actor.  A Terminated message is sent when it stops. */
+    watch(ref: ActorRef): ActorRef;
+    /** Stop watching. */
+    unwatch(ref: ActorRef): ActorRef;
+    /**
+     * Replace the current behaviour.  When `discardOld` is false, the previous
+     * behaviour is pushed onto a stack and can be restored via unbecome().
+     */
+    become(behavior: Receive<TMsg>, discardOld?: boolean): void;
+    /** Pop the behaviour stack, restoring the previous behaviour. */
+    unbecome(): void;
+    /**
+     * Fire a ReceiveTimeout message when no user message has been received in
+     * `ms`.  Pass 0 to disable.
+     */
+    setReceiveTimeout(ms: number): void;
+    /** Disable the receive timeout. */
+    cancelReceiveTimeout(): void;
+    /**
+     * Buffer the message currently being handled.  It is reinserted into the
+     * mailbox when `unstashAll()` is called.  Throws if called outside a
+     * user-message handler or if the stash is full.
+     */
+    stash(): void;
+    /**
+     * Prepend every stashed message back onto the user mailbox in the order
+     * they were stashed.  The buffer is empty afterwards.
+     */
+    unstashAll(): void;
+    /** Number of currently-stashed messages. */
+    readonly stashSize: number;
+    /**
+     * Per-actor scheduling facade.  Timers are identified by user-supplied
+     * string keys and are automatically cancelled when the actor stops.
+     */
+    readonly timers: TimerScheduler<TMsg>;
+    /**
+     * Throttle this actor's user-message processing to a token-bucket
+     * rate (#83).  Every dequeue from the user mailbox consumes one
+     * token; when the bucket is empty the cell behaves per
+     * {@link ThrottleOnExcess}.  System messages (Terminated,
+     * supervision, watchNotify) are NOT throttled — they always run
+     * immediately, so timer fires and lifecycle events stay
+     * responsive.
+     *
+     * Calling `throttle` again replaces the existing limiter; pass
+     * `{ qps: Infinity }` or call {@link cancelThrottle} to remove one.
+     *
+     * Cluster-aware variants (split a budget across cluster-router
+     * routees, etc.) are out of scope here — this is per-actor only.
+     */
+    throttle(opts: ThrottleOptions): void;
+    /** Remove any active throttle, restoring unlimited dequeue rate. */
+    cancelThrottle(): void;
+}
+/**
+ * What to do with a user message dequeued while the actor's
+ * {@link ActorContext.throttle | throttle} bucket is empty.
+ */
+export type ThrottleOnExcess = 
+/**
+ * *(default)* Don't dequeue — pause the message-pump until tokens
+ * replenish, then resume normally.  Natural backpressure: the
+ * mailbox queues up, every message eventually processes, latency
+ * grows under load.
+ */
+'pause'
+/**
+ * Dequeue the message and discard it (with a debug log).  Useful
+ * for telemetry-style traffic where staleness is worse than loss.
+ */
+ | 'drop';
+export interface ThrottleOptions {
+    /** Token-refill rate, tokens per second.  Required; must be > 0. */
+    readonly qps: number;
+    /** Bucket capacity.  Default: `qps` (one second of refill). */
+    readonly burst?: number;
+    /** What to do when the bucket is empty.  Default: `'pause'`. */
+    readonly onExcess?: ThrottleOnExcess;
+    /** Time source — pass a deterministic clock for tests.  Default: `Date.now`. */
+    readonly now?: () => number;
+}
+/**
+ * Actor-scoped scheduler.  A fresh `startSingleTimer`/`startTimerWithFixedDelay`
+ * call with the same key replaces any existing timer under that key.
+ */
+export interface TimerScheduler<TMsg = unknown> {
+    /** Fire `message` once after `delayMs`. */
+    startSingleTimer(key: string, message: TMsg, delayMs: number): void;
+    /** Fire `message` every `intervalMs`, optionally preceded by `initialDelayMs`. */
+    startTimerWithFixedDelay(key: string, message: TMsg, intervalMs: number, initialDelayMs?: number): void;
+    /** Cancel a specific timer.  Returns true if a timer was actually running. */
+    cancel(key: string): boolean;
+    /** Cancel every timer this actor has started. */
+    cancelAll(): void;
+    /** True if the timer under `key` is still scheduled to fire. */
+    isTimerActive(key: string): boolean;
+    /** Names of active timers (diagnostics). */
+    activeKeys(): string[];
+}
+export declare class StashOverflowError extends Error {
+    constructor(capacity: number);
+}
+export declare class StashOutsideHandlerError extends Error {
+    constructor();
+}
+//# sourceMappingURL=ActorContext.d.ts.map

package/dist/ActorContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorContext.d.ts","sourceRoot":"","sources":["../src/ActorContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qEAAqE;AACrE,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,IAAI,GAAG,OAAO;IAC1C,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE9B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAElC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAElC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE3C,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAErD;;;;;OAKG;IACH,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEhD;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,qBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE9F;;;OAGG;IACH,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,qBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEzF,uEAAuE;IACvE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEtC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,qBAAqB,EAAE,cAAc,CAAC;IAE3E,0EAA0E;IAC1E,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE1B,8BAA8B;IAC9B,QAAQ,IAAI,IAAI,CAAC;IAEjB,kFAAkF;IAClF,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE/B,qBAAqB;IACrB,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAEjC;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE5D,iEAAiE;IACjE,QAAQ,IAAI,IAAI,CAAC;IAEjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,mCAAmC;IACnC,oBAAoB,IAAI,IAAI,CAAC;IAI7B;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAI3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IAItC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAEtC,oEAAoE;IACpE,cAAc,IAAI,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB;AAC1B;;;;;GAKG;AACD,OAAO;AACT;;;GAGG;GACD,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,gFAAgF;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,IAAI,GAAG,OAAO;IAC5C,2CAA2C;IAC3C,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpE,kFAAkF;IAClF,wBAAwB,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,IAAI,EACb,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CAAC;IAER,8EAA8E;IAC9E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B,iDAAiD;IACjD,SAAS,IAAI,IAAI,CAAC;IAElB,gEAAgE;IAChE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAEpC,4CAA4C;IAC5C,UAAU,IAAI,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD"}

package/dist/ActorContext.js

@@ -0,0 +1,13 @@
+export class StashOverflowError extends Error {
+    constructor(capacity) {
+        super(`Stash overflow: buffer is full (capacity=${capacity})`);
+        this.name = 'StashOverflowError';
+    }
+}
+export class StashOutsideHandlerError extends Error {
+    constructor() {
+        super('context.stash() must be called while handling a user message');
+        this.name = 'StashOutsideHandlerError';
+    }
+}
+//# sourceMappingURL=ActorContext.js.map

package/dist/ActorContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorContext.js","sourceRoot":"","sources":["../src/ActorContext.ts"],"names":[],"mappings":"AAoNA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,QAAgB;QAC1B,KAAK,CAAC,4CAA4C,QAAQ,GAAG,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD;QACE,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/ActorPath.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Hierarchical, unique path identifying an actor inside an ActorSystem.
+ * Format: actor-ts://<system>/<segment>/<segment>...
+ */
+export declare class ActorPath {
+    readonly name: string;
+    readonly parent: ActorPath | null;
+    readonly systemName: string;
+    readonly uid: number;
+    constructor(name: string, parent?: ActorPath | null, systemName?: string, uid?: number);
+    /** Create a child path under this one. */
+    child(name: string, uid?: number): ActorPath;
+    /** All path segments from root to this path (including root). */
+    elements(): string[];
+    /** Full depth of the path (root has depth 0). */
+    depth(): number;
+    /** True if this path is an ancestor of other. */
+    isAncestorOf(other: ActorPath): boolean;
+    equals(other: ActorPath): boolean;
+    /** Canonical URI form: actor-ts://system/user/foo/bar */
+    toString(): string;
+}
+//# sourceMappingURL=ActorPath.d.ts.map

package/dist/ActorPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorPath.d.ts","sourceRoot":"","sources":["../src/ActorPath.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAS;aAEF,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,SAAS,GAAG,IAAI;aACxB,UAAU,EAAE,MAAM;aAClB,GAAG,EAAE,MAAM;gBAHX,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,SAAS,GAAG,IAAW,EAC/B,UAAU,GAAE,MAAkB,EAC9B,GAAG,GAAE,MAAU;IAGjC,0CAA0C;IAC1C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,SAAS;IAI/C,iEAAiE;IACjE,QAAQ,IAAI,MAAM,EAAE;IAUpB,iDAAiD;IACjD,KAAK,IAAI,MAAM;IAIf,iDAAiD;IACjD,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IASvC,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIjC,yDAAyD;IACzD,QAAQ,IAAI,MAAM;CAMnB"}

package/dist/ActorPath.js

@@ -0,0 +1,56 @@
+/**
+ * Hierarchical, unique path identifying an actor inside an ActorSystem.
+ * Format: actor-ts://<system>/<segment>/<segment>...
+ */
+export class ActorPath {
+    name;
+    parent;
+    systemName;
+    uid;
+    constructor(name, parent = null, systemName = 'default', uid = 0) {
+        this.name = name;
+        this.parent = parent;
+        this.systemName = systemName;
+        this.uid = uid;
+    }
+    /** Create a child path under this one. */
+    child(name, uid = 0) {
+        return new ActorPath(name, this, this.systemName, uid);
+    }
+    /** All path segments from root to this path (including root). */
+    elements() {
+        const out = [];
+        let p = this;
+        while (p) {
+            out.unshift(p.name);
+            p = p.parent;
+        }
+        return out;
+    }
+    /** Full depth of the path (root has depth 0). */
+    depth() {
+        return this.parent ? this.parent.depth() + 1 : 0;
+    }
+    /** True if this path is an ancestor of other. */
+    isAncestorOf(other) {
+        let p = other.parent;
+        while (p) {
+            if (p.equals(this))
+                return true;
+            p = p.parent;
+        }
+        return false;
+    }
+    equals(other) {
+        return this.toString() === other.toString();
+    }
+    /** Canonical URI form: actor-ts://system/user/foo/bar */
+    toString() {
+        const segments = this.elements();
+        // First element is the system root name; render as actor-ts://<sys>/remainder
+        if (segments.length <= 1)
+            return `actor-ts://${this.systemName}/`;
+        return `actor-ts://${this.systemName}/${segments.slice(1).join('/')}`;
+    }
+}
+//# sourceMappingURL=ActorPath.js.map

package/dist/ActorPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorPath.js","sourceRoot":"","sources":["../src/ActorPath.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAS;IAEF;IACA;IACA;IACA;IAJlB,YACkB,IAAY,EACZ,SAA2B,IAAI,EAC/B,aAAqB,SAAS,EAC9B,MAAc,CAAC;QAHf,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAyB;QAC/B,eAAU,GAAV,UAAU,CAAoB;QAC9B,QAAG,GAAH,GAAG,CAAY;IAC9B,CAAC;IAEJ,0CAA0C;IAC1C,KAAK,CAAC,IAAY,EAAE,MAAc,CAAC;QACjC,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,iEAAiE;IACjE,QAAQ;QACN,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC,GAAqB,IAAI,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC;YACT,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACf,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,iDAAiD;IACjD,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,iDAAiD;IACjD,YAAY,CAAC,KAAgB;QAC3B,IAAI,CAAC,GAAqB,KAAK,CAAC,MAAM,CAAC;QACvC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,KAAgB;QACrB,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAED,yDAAyD;IACzD,QAAQ;QACN,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,8EAA8E;QAC9E,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,cAAc,IAAI,CAAC,UAAU,GAAG,CAAC;QAClE,OAAO,cAAc,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACxE,CAAC;CACF"}

package/dist/ActorRef.d.ts

@@ -0,0 +1,54 @@
+import { ActorPath } from './ActorPath.js';
+/**
+ * Drop `replyTo: ActorRef<...>` from any variant of a message union
+ * that declares one.  Distributes across unions: variants without
+ * `replyTo` pass through untouched; variants with `replyTo` lose just
+ * that field.  Used by `ActorRef.ask()` so callers never have to
+ * supply the `replyTo` field — the framework synthesises and injects
+ * one on every call.
+ */
+export type OmitReplyTo<TMsg> = TMsg extends {
+    replyTo: ActorRef<unknown>;
+} ? Omit<TMsg, 'replyTo'> : TMsg;
+/**
+ * Handle to an actor.  The only way to interact with an actor — you never
+ * hold a direct reference to the Actor instance itself.  tell() is fire-and-
+ * forget; ask() provides a request/response Promise.
+ */
+export declare abstract class ActorRef<TMsg = unknown> {
+    abstract readonly path: ActorPath;
+    /** Send a message to this actor. `sender` is surfaced as context.sender in the recipient. */
+    abstract tell(message: TMsg, sender?: ActorRef | null): void;
+    /** Alias for tell — useful if you want to pipe something. */
+    send(message: TMsg): void;
+    /**
+     * Request/response — send `message` and await the recipient's reply.
+     * The framework synthesises a one-shot reply ref, injects it as both
+     * the `sender` slot and as `message.replyTo`, and resolves the returned
+     * promise with the first reply (or rejects with `AskTimeoutError`).
+     *
+     * The caller never specifies `replyTo` on the message — the `OmitReplyTo`
+     * type subtracts it from the parameter type if the recipient declares it.
+     *
+     *     const value = await counter.ask<number>({ kind: 'get' });
+     */
+    ask<TRes = unknown>(message: OmitReplyTo<TMsg>, timeoutMs?: number): Promise<TRes>;
+    /** Gracefully stop this actor after it drains its mailbox. */
+    stop(): void;
+    /** Kill this actor — raises ActorKilledError through the normal supervision path. */
+    kill(): void;
+    toString(): string;
+    equals(other: ActorRef): boolean;
+}
+/**
+ * The ref that means "no actor here".  Any message tell()'d to Nobody is
+ * silently dropped (it does not even go to dead letters).
+ */
+export declare class NobodyRef extends ActorRef<unknown> {
+    static readonly instance: NobodyRef;
+    readonly path: ActorPath;
+    private constructor();
+    tell(): void;
+}
+export declare const Nobody: ActorRef;
+//# sourceMappingURL=ActorRef.d.ts.map

package/dist/ActorRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorRef.d.ts","sourceRoot":"","sources":["../src/ActorRef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI,IAAI,SAAS;IAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CAAE,GACvE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,GACrB,IAAI,CAAC;AAIT;;;;GAIG;AACH,8BAAsB,QAAQ,CAAC,IAAI,GAAG,OAAO;IAC3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAElC,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;IAE5D,6DAA6D;IAC7D,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI;IAEzB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzF,8DAA8D;IAC9D,IAAI,IAAI,IAAI;IAEZ,qFAAqF;IACrF,IAAI,IAAI,IAAI;IAEZ,QAAQ,IAAI,MAAM;IAElB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;CAGjC;AAiDD;;;GAGG;AACH,qBAAa,SAAU,SAAQ,QAAQ,CAAC,OAAO,CAAC;IAC9C,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAmB;IACtD,QAAQ,CAAC,IAAI,YAA6C;IAC1D,OAAO;IACP,IAAI,IAAI,IAAI;CACb;AAED,eAAO,MAAM,MAAM,EAAE,QAA6B,CAAC"}

package/dist/ActorRef.js

@@ -0,0 +1,105 @@
+import { ActorPath } from './ActorPath.js';
+import { AskTimeoutError, PoisonPill, Kill } from './SystemMessages.js';
+let askCounter = 0;
+/**
+ * Handle to an actor.  The only way to interact with an actor — you never
+ * hold a direct reference to the Actor instance itself.  tell() is fire-and-
+ * forget; ask() provides a request/response Promise.
+ */
+export class ActorRef {
+    /** Alias for tell — useful if you want to pipe something. */
+    send(message) { this.tell(message, null); }
+    /**
+     * Request/response — send `message` and await the recipient's reply.
+     * The framework synthesises a one-shot reply ref, injects it as both
+     * the `sender` slot and as `message.replyTo`, and resolves the returned
+     * promise with the first reply (or rejects with `AskTimeoutError`).
+     *
+     * The caller never specifies `replyTo` on the message — the `OmitReplyTo`
+     * type subtracts it from the parameter type if the recipient declares it.
+     *
+     *     const value = await counter.ask<number>({ kind: 'get' });
+     */
+    ask(message, timeoutMs = 5_000) {
+        const name = `askResp-${++askCounter}`;
+        const systemName = this.path.systemName;
+        const ref = new AskResponseRef(systemName, name, timeoutMs, this.path.toString());
+        // Inject `replyTo: ref` into the message so recipients that read
+        // `msg.replyTo` work without the caller supplying it.  Recipients
+        // that read `this.sender` see the same ref (passed via `tell`'s
+        // second arg).
+        const enriched = typeof message === 'object' && message !== null
+            ? { ...message, replyTo: ref }
+            : message;
+        this.tell(enriched, ref);
+        return ref.promise;
+    }
+    /** Gracefully stop this actor after it drains its mailbox. */
+    stop() { this.tell(PoisonPill.instance, null); }
+    /** Kill this actor — raises ActorKilledError through the normal supervision path. */
+    kill() { this.tell(Kill.instance, null); }
+    toString() { return this.path.toString(); }
+    equals(other) {
+        return this.path.toString() === other.path.toString();
+    }
+}
+/**
+ * Short-lived ref synthesised by {@link ActorRef.ask} to capture the
+ * recipient's reply.  Accepts the first message (success or `Error`-shaped
+ * failure) and either resolves or rejects its promise; further messages
+ * are dropped.  If `timeoutMs` elapses before a reply, rejects with
+ * {@link AskTimeoutError}.
+ *
+ * Lives in `ActorRef.ts` (not a separate file) so the abstract `ActorRef`
+ * class has a concrete reply-ref to instantiate without any module-cycle
+ * gymnastics — `AskResponseRef extends ActorRef`, both in the same file.
+ */
+class AskResponseRef extends ActorRef {
+    path;
+    promise;
+    resolveFn;
+    rejectFn;
+    settled = false;
+    timer = null;
+    constructor(systemName, name, timeoutMs, targetLabel) {
+        super();
+        this.path = new ActorPath(name, null, systemName);
+        this.promise = new Promise((resolve, reject) => {
+            this.resolveFn = resolve;
+            this.rejectFn = reject;
+        });
+        if (timeoutMs > 0) {
+            this.timer = setTimeout(() => {
+                if (!this.settled) {
+                    this.settled = true;
+                    this.rejectFn(new AskTimeoutError(`Ask timed out after ${timeoutMs}ms waiting for reply from ${targetLabel}`));
+                }
+            }, timeoutMs);
+        }
+    }
+    tell(message) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (message instanceof Error)
+            this.rejectFn(message);
+        else
+            this.resolveFn(message);
+    }
+}
+/**
+ * The ref that means "no actor here".  Any message tell()'d to Nobody is
+ * silently dropped (it does not even go to dead letters).
+ */
+export class NobodyRef extends ActorRef {
+    static instance = new NobodyRef();
+    path = new ActorPath('nobody', null, '<nobody>');
+    constructor() { super(); }
+    tell() { }
+}
+export const Nobody = NobodyRef.instance;
+//# sourceMappingURL=ActorRef.js.map

package/dist/ActorRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorRef.js","sourceRoot":"","sources":["../src/ActorRef.ts"],"names":[],"mappings":"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"}

package/dist/ActorSelection.d.ts

@@ -0,0 +1,48 @@
+import type { ActorPath } from './ActorPath.js';
+import type { ActorRef } from './ActorRef.js';
+import type { ActorSystem } from './ActorSystem.js';
+/**
+ * A lookup handle for a logical actor path.  Unlike `ActorRef`, which is a
+ * direct handle to a known actor, an `ActorSelection` is a description of
+ * where to look — resolving it walks the current actor tree (locally) or
+ * issues a remote lookup.
+ *
+ * For v1 we support exact paths only (no `*` wildcards).  Messages tell()'d
+ * to a selection are delivered synchronously to the first matching actor if
+ * it resolves immediately; otherwise they land in dead letters.
+ */
+export declare class ActorSelection {
+    private readonly system;
+    /** Segments after `/user/` or `/system/`, e.g. ['user', 'foo', 'bar']. */
+    readonly pathSegments: ReadonlyArray<string>;
+    /** Printable form, convenient for logging. */
+    readonly pathString: string;
+    constructor(system: ActorSystem, 
+    /** Segments after `/user/` or `/system/`, e.g. ['user', 'foo', 'bar']. */
+    pathSegments: ReadonlyArray<string>, 
+    /** Printable form, convenient for logging. */
+    pathString: string);
+    /**
+     * Resolve to a concrete ActorRef.  Retries until `timeoutMs` elapses if
+     * the intermediate cell is in the process of starting (so tests that race
+     * spawn+selection are stable).  Rejects with an Error on timeout.
+     */
+    resolveOne(timeoutMs?: number): Promise<ActorRef>;
+    /**
+     * Fire-and-forget: resolve immediately; if no match, drop to dead letters.
+     * For cases where you want asynchronous retry, use `resolveOne(...).then(r => r.tell(...))`.
+     */
+    tell(message: unknown, sender?: ActorRef | null): void;
+    toString(): string;
+}
+/**
+ * Parse an input string into path segments relative to `/`.  Accepts two
+ * shapes:
+ *   - absolute URI:   "actor-ts://<sys>/user/foo/bar"
+ *   - absolute path:  "/user/foo/bar" or "user/foo/bar"
+ *
+ * The system-name (if present) is verified to match the target system;
+ * mismatch returns null to indicate the path is meant for a different one.
+ */
+export declare function parseSelectionPath(system: ActorSystem, path: string | ActorPath): string[] | null;
+//# sourceMappingURL=ActorSelection.d.ts.map

package/dist/ActorSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorSelection.d.ts","sourceRoot":"","sources":["../src/ActorSelection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;GASG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAJV,MAAM,EAAE,WAAW;IACpC,0EAA0E;IACjE,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC;IAC5C,8CAA8C;IACrC,UAAU,EAAE,MAAM;IAG7B;;;;OAIG;IACG,UAAU,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYtD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,QAAQ,GAAG,IAAW,GAAG,IAAI;IAM5D,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,EAAE,GAAG,IAAI,CAcjB"}

package/dist/ActorSelection.js

@@ -0,0 +1,84 @@
+/**
+ * A lookup handle for a logical actor path.  Unlike `ActorRef`, which is a
+ * direct handle to a known actor, an `ActorSelection` is a description of
+ * where to look — resolving it walks the current actor tree (locally) or
+ * issues a remote lookup.
+ *
+ * For v1 we support exact paths only (no `*` wildcards).  Messages tell()'d
+ * to a selection are delivered synchronously to the first matching actor if
+ * it resolves immediately; otherwise they land in dead letters.
+ */
+export class ActorSelection {
+    system;
+    pathSegments;
+    pathString;
+    constructor(system, 
+    /** Segments after `/user/` or `/system/`, e.g. ['user', 'foo', 'bar']. */
+    pathSegments, 
+    /** Printable form, convenient for logging. */
+    pathString) {
+        this.system = system;
+        this.pathSegments = pathSegments;
+        this.pathString = pathString;
+    }
+    /**
+     * Resolve to a concrete ActorRef.  Retries until `timeoutMs` elapses if
+     * the intermediate cell is in the process of starting (so tests that race
+     * spawn+selection are stable).  Rejects with an Error on timeout.
+     */
+    async resolveOne(timeoutMs = 1_000) {
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            const refOpt = this.system._resolvePath(this.pathSegments);
+            if (refOpt.isSome())
+                return refOpt.value;
+            if (Date.now() >= deadline) {
+                throw new Error(`ActorSelection timed out after ${timeoutMs}ms: ${this.pathString}`);
+            }
+            await new Promise(r => setTimeout(r, 10));
+        }
+    }
+    /**
+     * Fire-and-forget: resolve immediately; if no match, drop to dead letters.
+     * For cases where you want asynchronous retry, use `resolveOne(...).then(r => r.tell(...))`.
+     */
+    tell(message, sender = null) {
+        const refOpt = this.system._resolvePath(this.pathSegments);
+        if (refOpt.isSome())
+            refOpt.value.tell(message, sender);
+        else
+            this.system.deadLetters.tell(message, sender);
+    }
+    toString() {
+        return `ActorSelection(${this.pathString})`;
+    }
+}
+/**
+ * Parse an input string into path segments relative to `/`.  Accepts two
+ * shapes:
+ *   - absolute URI:   "actor-ts://<sys>/user/foo/bar"
+ *   - absolute path:  "/user/foo/bar" or "user/foo/bar"
+ *
+ * The system-name (if present) is verified to match the target system;
+ * mismatch returns null to indicate the path is meant for a different one.
+ */
+export function parseSelectionPath(system, path) {
+    const text = typeof path === 'string' ? path : path.toString();
+    let rest = text;
+    if (rest.startsWith('actor-ts://')) {
+        const withoutScheme = rest.slice('actor-ts://'.length);
+        const firstSlash = withoutScheme.indexOf('/');
+        if (firstSlash < 0)
+            return null;
+        const sys = withoutScheme.slice(0, firstSlash);
+        if (sys !== system.name)
+            return null;
+        rest = withoutScheme.slice(firstSlash + 1);
+    }
+    if (rest.startsWith('/'))
+        rest = rest.slice(1);
+    if (rest.length === 0)
+        return [];
+    return rest.split('/').filter(s => s.length > 0);
+}
+//# sourceMappingURL=ActorSelection.js.map

package/dist/ActorSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorSelection.js","sourceRoot":"","sources":["../src/ActorSelection.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IAEN;IAER;IAEA;IALX,YACmB,MAAmB;IACpC,0EAA0E;IACjE,YAAmC;IAC5C,8CAA8C;IACrC,UAAkB;QAJV,WAAM,GAAN,MAAM,CAAa;QAE3B,iBAAY,GAAZ,YAAY,CAAuB;QAEnC,eAAU,GAAV,UAAU,CAAQ;IAC1B,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,SAAS,GAAG,KAAK;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3D,IAAI,MAAM,CAAC,MAAM,EAAE;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;YACzC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,OAAgB,EAAE,SAA0B,IAAI;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAgB,EAAE,MAAM,CAAC,CAAC;;YAC5D,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAgB,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,QAAQ;QACN,OAAO,kBAAkB,IAAI,CAAC,UAAU,GAAG,CAAC;IAC9C,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,IAAwB;IAExB,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC/D,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC/C,IAAI,GAAG,KAAK,MAAM,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC"}