depa-actor 0.1.0 → 0.1.2

package/dist/core/ActorSystem.d.ts

@@ -0,0 +1,34 @@
+/**
+ * depa-actor — ActorSystem
+ *
+ * Multi-mailbox actor system with priority-based drain.
+ * Evolved from depa-data-graph ActorSystem with MailboxSchema support.
+ */
+import type { MailboxSchema, ActorLogEntry, ActorDef, ActorRef } from './types';
+export declare class ActorSystem<TRuntime, TSchema extends MailboxSchema> {
+    private getRuntime;
+    private onLog?;
+    private seq;
+    private cells;
+    constructor(getRuntime: () => TRuntime, onLog?: ((entry: ActorLogEntry<TSchema>) => void) | undefined);
+    ids(): string[];
+    has(id: string): boolean;
+    register<TState = void>(id: string, def: ActorDef<TRuntime, TSchema, TState>): void;
+    unregister(id: string): void;
+    refFrom(from: string, to: string): ActorRef<TSchema> | undefined;
+    sendFrom<TTag extends keyof TSchema & string>(from: string, to: string, tag: TTag, payload: TSchema[TTag]): void;
+    broadcastFrom<TTag extends keyof TSchema & string>(from: string, tag: TTag, payload: TSchema[TTag], opts?: {
+        excludeSelf?: boolean;
+    }): void;
+    private scheduleDrain;
+    /**
+     * Priority-based drain: sorts pending messages by tag priority,
+     * then processes sequentially. Per-tag handlers take precedence.
+     */
+    private drain;
+    /** Route envelope to per-tag handler or unified handler */
+    private dispatch;
+    /** Construct ActorSelf with selective receive capabilities */
+    private makeSelf;
+}
+//# sourceMappingURL=ActorSystem.d.ts.map

package/dist/core/ActorSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorSystem.d.ts","sourceRoot":"","sources":["../../src/core/ActorSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACb,QAAQ,EACR,QAAQ,EAIT,MAAM,SAAS,CAAC;AAcjB,qBAAa,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,aAAa;IAK5D,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,KAAK,CAAC;IALhB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,KAAK,CAA4D;gBAG/D,UAAU,EAAE,MAAM,QAAQ,EAC1B,KAAK,CAAC,GAAE,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,IAAI,aAAA;IAKzD,GAAG,IAAI,MAAM,EAAE;IAIf,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAMxB,QAAQ,CAAC,MAAM,GAAG,IAAI,EACpB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GACvC,IAAI;IAgBP,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAM5B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS;IAQhE,QAAQ,CAAC,IAAI,SAAS,MAAM,OAAO,GAAG,MAAM,EAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GACrB,IAAI;IAqBP,aAAa,CAAC,IAAI,SAAS,MAAM,OAAO,GAAG,MAAM,EAC/C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,IAAI;IASP,OAAO,CAAC,aAAa;IAQrB;;;OAGG;YACW,KAAK;IA8BnB,2DAA2D;YAC7C,QAAQ;IAuBtB,8DAA8D;IAC9D,OAAO,CAAC,QAAQ;CAiCjB"}

package/dist/core/ActorSystem.js

@@ -0,0 +1,169 @@
+/**
+ * depa-actor — ActorSystem
+ *
+ * Multi-mailbox actor system with priority-based drain.
+ * Evolved from depa-data-graph ActorSystem with MailboxSchema support.
+ */
+// ─── ActorSystem ─────────────────────────────────────────────────────
+export class ActorSystem {
+    getRuntime;
+    onLog;
+    seq = 0;
+    cells = new Map();
+    constructor(getRuntime, onLog) {
+        this.getRuntime = getRuntime;
+        this.onLog = onLog;
+    }
+    // ── Query ──
+    ids() {
+        return Array.from(this.cells.keys()).sort();
+    }
+    has(id) {
+        return this.cells.has(id);
+    }
+    // ── Registration ──
+    register(id, def) {
+        if (this.cells.has(id)) {
+            throw new Error(`Actor already registered: ${id}`);
+        }
+        if (!def.handler && !def.handlers) {
+            throw new Error(`Actor "${id}" must have at least handler or handlers`);
+        }
+        this.cells.set(id, {
+            id,
+            def: def,
+            state: def.initialState,
+            queue: [],
+            processing: false,
+        });
+    }
+    unregister(id) {
+        this.cells.delete(id);
+    }
+    // ── Messaging ──
+    refFrom(from, to) {
+        if (!this.cells.has(to))
+            return undefined;
+        return {
+            id: to,
+            send: (tag, payload) => this.sendFrom(from, to, tag, payload),
+        };
+    }
+    sendFrom(from, to, tag, payload) {
+        const target = this.cells.get(to);
+        const envelope = {
+            id: ++this.seq,
+            ts: Date.now(),
+            from,
+            to,
+            tag,
+            payload,
+        };
+        if (!target) {
+            this.onLog?.({ kind: 'error', ...envelope, error: `Unknown actor: ${to}` });
+            return;
+        }
+        this.onLog?.({ kind: 'send', ...envelope });
+        target.queue.push(envelope);
+        this.scheduleDrain(target);
+    }
+    broadcastFrom(from, tag, payload, opts) {
+        for (const id of this.cells.keys()) {
+            if (opts?.excludeSelf && id === from)
+                continue;
+            this.sendFrom(from, id, tag, payload);
+        }
+    }
+    // ── Drain ──
+    scheduleDrain(cell) {
+        if (cell.processing)
+            return;
+        cell.processing = true;
+        queueMicrotask(() => {
+            void this.drain(cell);
+        });
+    }
+    /**
+     * Priority-based drain: sorts pending messages by tag priority,
+     * then processes sequentially. Per-tag handlers take precedence.
+     */
+    async drain(cell) {
+        try {
+            while (cell.queue.length > 0) {
+                // Sort by priority (lower = higher priority, default 100)
+                const priorities = cell.def.priority ?? {};
+                cell.queue.sort((a, b) => {
+                    const pa = priorities[a.tag] ?? 100;
+                    const pb = priorities[b.tag] ?? 100;
+                    return pa - pb;
+                });
+                const envelope = cell.queue.shift();
+                const self = this.makeSelf(cell);
+                try {
+                    await this.dispatch(cell, self, envelope);
+                    this.onLog?.({ kind: 'deliver', ...envelope });
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    this.onLog?.({ kind: 'error', ...envelope, error: message });
+                }
+            }
+        }
+        finally {
+            cell.processing = false;
+            if (cell.queue.length > 0) {
+                this.scheduleDrain(cell);
+            }
+        }
+    }
+    /** Route envelope to per-tag handler or unified handler */
+    async dispatch(cell, self, envelope) {
+        const tagHandler = cell.def.handlers?.[envelope.tag];
+        if (tagHandler) {
+            await tagHandler(self, envelope);
+        }
+        else if (cell.def.handler) {
+            await cell.def.handler(self, envelope);
+        }
+        else {
+            // No handler for this tag — log and skip
+            this.onLog?.({
+                kind: 'error',
+                ...envelope,
+                error: `No handler for tag "${envelope.tag}" on actor "${cell.id}"`,
+            });
+        }
+    }
+    /** Construct ActorSelf with selective receive capabilities */
+    makeSelf(cell) {
+        return {
+            id: cell.id,
+            ref: {
+                id: cell.id,
+                send: (tag, payload) => this.sendFrom(cell.id, cell.id, tag, payload),
+            },
+            runtime: this.getRuntime(),
+            state: cell.state,
+            send: (to, tag, payload) => this.sendFrom(cell.id, to, tag, payload),
+            broadcast: (tag, payload, opts) => this.broadcastFrom(cell.id, tag, payload, opts),
+            // Selective receive
+            hasPending: (tag) => cell.queue.some((e) => e.tag === tag),
+            drainMailbox: (tag) => {
+                const matching = [];
+                const remaining = [];
+                for (const e of cell.queue) {
+                    if (e.tag === tag) {
+                        matching.push(e);
+                    }
+                    else {
+                        remaining.push(e);
+                    }
+                }
+                cell.queue.length = 0;
+                cell.queue.push(...remaining);
+                return matching;
+            },
+        };
+    }
+}
+//# sourceMappingURL=ActorSystem.js.map

package/dist/core/ActorSystem.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * depa-actor — Core Type Definitions
+ *
+ * Synthesizes:
+ * - depa-data-graph ActorSystem (true actor model, mailbox queue, microtask drain)
+ * - depa-processor (dispatch routing, DOP pipeline)
+ * - OneAgentActor domain needs (multi-mailbox, typed tags)
+ */
+export type MailboxSchema = Record<string, unknown>;
+export interface ActorEnvelope<TSchema extends MailboxSchema = MailboxSchema> {
+    id: number;
+    ts: number;
+    from: string;
+    to: string;
+    tag: keyof TSchema & string;
+    payload: TSchema[keyof TSchema & string];
+}
+/** Type-safe envelope for a specific tag */
+export type TaggedEnvelope<TSchema extends MailboxSchema, TTag extends keyof TSchema & string> = Omit<ActorEnvelope<TSchema>, 'tag' | 'payload'> & {
+    tag: TTag;
+    payload: TSchema[TTag];
+};
+export type MailboxPriority<TSchema extends MailboxSchema> = {
+    [K in keyof TSchema & string]?: number;
+};
+export interface ActorRef<TSchema extends MailboxSchema = MailboxSchema> {
+    readonly id: string;
+    send<TTag extends keyof TSchema & string>(tag: TTag, payload: TSchema[TTag]): void;
+}
+export interface ActorSelf<TRuntime, TSchema extends MailboxSchema, TState = void> {
+    readonly id: string;
+    readonly ref: ActorRef<TSchema>;
+    readonly runtime: TRuntime;
+    state: TState;
+    /** Send to a specific actor */
+    send(to: string, tag: keyof TSchema & string, payload: TSchema[keyof TSchema & string]): void;
+    /** Broadcast to all actors */
+    broadcast(tag: keyof TSchema & string, payload: TSchema[keyof TSchema & string], opts?: {
+        excludeSelf?: boolean;
+    }): void;
+    /** Check if there are pending messages for a specific tag */
+    hasPending<TTag extends keyof TSchema & string>(tag: TTag): boolean;
+    /** Drain all pending messages for a specific tag (removes them from queue) */
+    drainMailbox<TTag extends keyof TSchema & string>(tag: TTag): TaggedEnvelope<TSchema, TTag>[];
+}
+/** Unified handler — receives all envelopes, switch on tag */
+export type ActorHandler<TRuntime, TSchema extends MailboxSchema, TState = void> = (self: ActorSelf<TRuntime, TSchema, TState>, envelope: ActorEnvelope<TSchema>) => void | Promise<void>;
+/** Per-tag handler — handles a single tag */
+export type TagHandler<TRuntime, TSchema extends MailboxSchema, TState, TTag extends keyof TSchema & string> = (self: ActorSelf<TRuntime, TSchema, TState>, envelope: TaggedEnvelope<TSchema, TTag>) => void | Promise<void>;
+export interface ActorDef<TRuntime, TSchema extends MailboxSchema, TState = void> {
+    initialState: TState;
+    /** Mailbox priority — lower number = higher priority. Default: 100 */
+    priority?: MailboxPriority<TSchema>;
+    /** Unified handler (fallback for tags not in `handlers`) */
+    handler?: ActorHandler<TRuntime, TSchema, TState>;
+    /** Per-tag handlers — takes precedence over `handler` for matching tags */
+    handlers?: {
+        [TTag in keyof TSchema & string]?: TagHandler<TRuntime, TSchema, TState, TTag>;
+    };
+}
+export type ActorLogKind = 'send' | 'deliver' | 'error';
+export interface ActorLogEntry<TSchema extends MailboxSchema = MailboxSchema> extends ActorEnvelope<TSchema> {
+    kind: ActorLogKind;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,10 @@
+/**
+ * depa-actor — Core Type Definitions
+ *
+ * Synthesizes:
+ * - depa-data-graph ActorSystem (true actor model, mailbox queue, microtask drain)
+ * - depa-processor (dispatch routing, DOP pipeline)
+ * - OneAgentActor domain needs (multi-mailbox, typed tags)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/dispatch/ActorDispatchAdapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * depa-actor — Dispatch Bridge
+ *
+ * Optional bridge to depa-processor DispatchEngine.
+ * Only this file imports from depa-processor concepts.
+ * No hard dependency — uses structural typing.
+ */
+import type { MailboxSchema, ActorSelf, ActorEnvelope, ActorHandler } from '../core/types';
+/**
+ * A dispatch route maps a tag to a dispatch key and handler.
+ * This is a structural interface — no dependency on depa-processor.
+ */
+export interface DispatchRoute<TRuntime, TSchema extends MailboxSchema, TState> {
+    /** Which tags this route handles */
+    tags: (keyof TSchema & string)[];
+    /** Resolve dispatch key from envelope */
+    resolveKey: (envelope: ActorEnvelope<TSchema>) => string;
+    /** Route table: dispatch key → handler */
+    routes: Record<string, (self: ActorSelf<TRuntime, TSchema, TState>, envelope: ActorEnvelope<TSchema>) => void | Promise<void>>;
+    /** Fallback if no route matches */
+    fallback?: (self: ActorSelf<TRuntime, TSchema, TState>, envelope: ActorEnvelope<TSchema>, key: string) => void | Promise<void>;
+}
+/**
+ * Creates an ActorHandler that routes envelopes through dispatch routes.
+ * Falls back to `defaultHandler` for tags not covered by any route.
+ */
+export declare function createDispatchHandler<TRuntime, TSchema extends MailboxSchema, TState>(routes: DispatchRoute<TRuntime, TSchema, TState>[], defaultHandler?: ActorHandler<TRuntime, TSchema, TState>): ActorHandler<TRuntime, TSchema, TState>;
+//# sourceMappingURL=ActorDispatchAdapter.d.ts.map

package/dist/dispatch/ActorDispatchAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorDispatchAdapter.d.ts","sourceRoot":"","sources":["../../src/dispatch/ActorDispatchAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,YAAY,EACb,MAAM,eAAe,CAAC;AAIvB;;;GAGG;AACH,MAAM,WAAW,aAAa,CAC5B,QAAQ,EACR,OAAO,SAAS,aAAa,EAC7B,MAAM;IAEN,oCAAoC;IACpC,IAAI,EAAE,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IAEjC,yCAAyC;IACzC,UAAU,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;IAEzD,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CACrB,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAC1C,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,CACT,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAC1C,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,GAAG,EAAE,MAAM,KACR,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EACR,OAAO,SAAS,aAAa,EAC7B,MAAM,EAEN,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAClD,cAAc,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GACvD,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAwBzC"}

package/dist/dispatch/ActorDispatchAdapter.js

@@ -0,0 +1,38 @@
+/**
+ * depa-actor — Dispatch Bridge
+ *
+ * Optional bridge to depa-processor DispatchEngine.
+ * Only this file imports from depa-processor concepts.
+ * No hard dependency — uses structural typing.
+ */
+// ─── createDispatchHandler ───────────────────────────────────────────
+/**
+ * Creates an ActorHandler that routes envelopes through dispatch routes.
+ * Falls back to `defaultHandler` for tags not covered by any route.
+ */
+export function createDispatchHandler(routes, defaultHandler) {
+    // Build tag → route index for O(1) lookup
+    const tagIndex = new Map();
+    for (const route of routes) {
+        for (const tag of route.tags) {
+            tagIndex.set(tag, route);
+        }
+    }
+    return async (self, envelope) => {
+        const route = tagIndex.get(envelope.tag);
+        if (route) {
+            const key = route.resolveKey(envelope);
+            const handler = route.routes[key];
+            if (handler) {
+                await handler(self, envelope);
+            }
+            else if (route.fallback) {
+                await route.fallback(self, envelope, key);
+            }
+        }
+        else if (defaultHandler) {
+            await defaultHandler(self, envelope);
+        }
+    };
+}
+//# sourceMappingURL=ActorDispatchAdapter.js.map

package/dist/dispatch/ActorDispatchAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorDispatchAdapter.js","sourceRoot":"","sources":["../../src/dispatch/ActorDispatchAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwCH,wEAAwE;AAExE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAKnC,MAAkD,EAClD,cAAwD;IAExD,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoD,CAAC;IAC7E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC1B,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;aAAM,IAAI,cAAc,EAAE,CAAC;YAC1B,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { MailboxSchema, ActorEnvelope, TaggedEnvelope, MailboxPriority, ActorRef, ActorSelf, ActorHandler, TagHandler, ActorDef, ActorLogKind, ActorLogEntry, } from './core/types';
+export { ActorSystem } from './core/ActorSystem';
+export type { ActorPlugin } from './runtime/ActorRuntime';
+export { ActorRuntime } from './runtime/ActorRuntime';
+export { CompletionSignalRegistry, CompletionBindingRegistry, createCompletionSignalRegistry, createCompletionBindingRegistry, } from './runtime/completion';
+export type { CompletionWaiter, } from './runtime/completion';
+export type { SnapshotRecoveryState, RuntimeSnapshotManifestBase, RuntimeRootSnapshotBase, ActorSnapshotBase, FiberSnapshotBase, SnapshotCodec, RecoveryHooks, PersistenceEffectPort, } from './runtime/snapshot';
+export { createSnapshotCodec, createRecoveryHooks, createPersistenceEffectPort, } from './runtime/snapshot';
+export { RuntimeIndexHook, createRuntimeIndexHook } from './runtime/indexing';
+export type { ActorPipelineDef, PipelineDerivedAdapter, PipelineInnerRuntimeAdapter, PipelineInnerInputAdapter, PipelineInnerConfigAdapter, PipelineCoreLogic, PipelineOutputAdapter, } from './pipeline/ActorPipeline';
+export { createPipelineHandler } from './pipeline/ActorPipeline';
+export type { DispatchRoute } from './dispatch/ActorDispatchAdapter';
+export { createDispatchHandler } from './dispatch/ActorDispatchAdapter';
+export type { FiberId, FiberStatus, FiberWaitingReason, SuspendPolicy, SchedulerHooks, FiberStep, FiberRecord, SpawnFiberInput, DeadLetterRecord, OrchestratorOptions, OrchestratorState, FiberAction, FiberEffect, ReduceResult, ScheduleResult, } from './orchestration';
+export { DEFAULT_ORCHESTRATOR_OPTIONS, createOrchestratorState, reduceOrchestrator, applyFailure, computeEffectivePriority, selectNextFiberId, scheduleOne, createAiAgentSchedulerHooks, dispatchEffects, } from './orchestration';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAG9E,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,SAAS,EACT,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,2BAA2B,EAC3B,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { ActorSystem } from './core/ActorSystem';
+export { ActorRuntime } from './runtime/ActorRuntime';
+export { CompletionSignalRegistry, CompletionBindingRegistry, createCompletionSignalRegistry, createCompletionBindingRegistry, } from './runtime/completion';
+export { createSnapshotCodec, createRecoveryHooks, createPersistenceEffectPort, } from './runtime/snapshot';
+export { RuntimeIndexHook, createRuntimeIndexHook } from './runtime/indexing';
+export { createPipelineHandler } from './pipeline/ActorPipeline';
+export { createDispatchHandler } from './dispatch/ActorDispatchAdapter';
+export { DEFAULT_ORCHESTRATOR_OPTIONS, createOrchestratorState, reduceOrchestrator, applyFailure, computeEffectivePriority, selectNextFiberId, scheduleOne, createAiAgentSchedulerHooks, dispatchEffects, } from './orchestration';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAc9B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAY9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAqBxE,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,2BAA2B,EAC3B,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/orchestration/index.d.ts

@@ -0,0 +1,9 @@
+export type { FiberId, FiberStatus, FiberWaitingReason, SuspendPolicy, SchedulerHooks, FiberStep, FiberRecord, SpawnFiberInput, DeadLetterRecord, OrchestratorOptions, OrchestratorState, FiberAction, FiberEffect, ReduceResult, } from './types';
+export { DEFAULT_ORCHESTRATOR_OPTIONS } from './types';
+export { createOrchestratorState, reduceOrchestrator } from './reducer';
+export { applyFailure } from './recovery';
+export { computeEffectivePriority, selectNextFiberId, scheduleOne, } from './scheduler';
+export type { ScheduleResult } from './scheduler';
+export { createAiAgentSchedulerHooks } from './presets/aiAgent';
+export { dispatchEffects } from './runtimeAdapter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,SAAS,EACT,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/orchestration/index.js

@@ -0,0 +1,8 @@
+// depa-actor — Orchestration (Fiber Scheduling)
+export { DEFAULT_ORCHESTRATOR_OPTIONS } from './types';
+export { createOrchestratorState, reduceOrchestrator } from './reducer';
+export { applyFailure } from './recovery';
+export { computeEffectivePriority, selectNextFiberId, scheduleOne, } from './scheduler';
+export { createAiAgentSchedulerHooks } from './presets/aiAgent';
+export { dispatchEffects } from './runtimeAdapter';
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAmBhD,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/orchestration/presets/aiAgent.d.ts

@@ -0,0 +1,4 @@
+import type { MailboxSchema } from '../../core/types';
+import type { SchedulerHooks } from '../types';
+export declare function createAiAgentSchedulerHooks<TSchema extends MailboxSchema>(): SchedulerHooks<TSchema>;
+//# sourceMappingURL=aiAgent.d.ts.map

package/dist/orchestration/presets/aiAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiAgent.d.ts","sourceRoot":"","sources":["../../../src/orchestration/presets/aiAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAkC,cAAc,EAAiB,MAAM,UAAU,CAAC;AAoC9F,wBAAgB,2BAA2B,CAAC,OAAO,SAAS,aAAa,KAAK,cAAc,CAAC,OAAO,CAAC,CASpG"}

package/dist/orchestration/presets/aiAgent.js

@@ -0,0 +1,38 @@
+function isAiHumanWaitReason(reason) {
+    return reason === 'human_clarification' || reason === 'human_approval' || reason === 'human_answer';
+}
+function getEffectiveSuspendPolicy(fiber) {
+    const raw = fiber?.suspendPolicy;
+    return raw === 'continue_others' || raw === 'pause_all' ? raw : undefined;
+}
+function isBlockingLaneForPauseAll(lane) {
+    // Treat any non-background lane as blocking by default.
+    if (lane === 'background' || lane === 'collective') {
+        return false;
+    }
+    return true;
+}
+function isAllowedLaneDuringPauseAll(lane) {
+    return lane === 'background' || lane === 'collective';
+}
+function hasPauseAllHumanWaitInBlockingLane(state) {
+    return Object.values(state.fibers).some((fiber) => {
+        return (fiber?.status === 'suspended' &&
+            isAiHumanWaitReason(fiber?.waitingReason) &&
+            getEffectiveSuspendPolicy(fiber) === 'pause_all' &&
+            isBlockingLaneForPauseAll(fiber?.lane));
+    });
+}
+// AIAgent-compatible scheduling hooks:
+// - When a pause_all human wait exists in a blocking lane (interactive/member), only allow background/collective lanes.
+export function createAiAgentSchedulerHooks() {
+    return {
+        filterCandidate: ({ state, fiber }) => {
+            if (!hasPauseAllHumanWaitInBlockingLane(state)) {
+                return true;
+            }
+            return isAllowedLaneDuringPauseAll(fiber?.lane);
+        },
+    };
+}
+//# sourceMappingURL=aiAgent.js.map

package/dist/orchestration/presets/aiAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiAgent.js","sourceRoot":"","sources":["../../../src/orchestration/presets/aiAgent.ts"],"names":[],"mappings":"AAIA,SAAS,mBAAmB,CAAC,MAAe;IAC1C,OAAO,MAAM,KAAK,qBAAqB,IAAI,MAAM,KAAK,gBAAgB,IAAI,MAAM,KAAK,cAAc,CAAC;AACtG,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAiC;IAClE,MAAM,GAAG,GAAI,KAAa,EAAE,aAAa,CAAC;IAC1C,OAAO,GAAG,KAAK,iBAAiB,IAAI,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAa;IAC9C,wDAAwD;IACxD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAa;IAChD,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY,CAAC;AACxD,CAAC;AAED,SAAS,kCAAkC,CAAgC,KAAiC;IAC1G,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAa,CAAC,CAAC,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE;QAC5D,OAAO,CACL,KAAK,EAAE,MAAM,KAAK,WAAW;YAC7B,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC;YACzC,yBAAyB,CAAC,KAAmC,CAAC,KAAK,WAAW;YAC9E,yBAAyB,CAAC,KAAK,EAAE,IAAI,CAAC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uCAAuC;AACvC,wHAAwH;AACxH,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,eAAe,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;YACpC,IAAI,CAAC,kCAAkC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,2BAA2B,CAAE,KAAa,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/orchestration/recovery.d.ts

@@ -0,0 +1,4 @@
+import type { MailboxSchema } from '../core/types';
+import type { FiberId, OrchestratorState, ReduceResult } from './types';
+export declare function applyFailure<TSchema extends MailboxSchema>(state: OrchestratorState<TSchema>, fiberId: FiberId, now: number, error: string): ReduceResult<TSchema>;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/orchestration/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/orchestration/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAe,OAAO,EAAe,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA6ClG,wBAAgB,YAAY,CAAC,OAAO,SAAS,aAAa,EACxD,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,EACjC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,YAAY,CAAC,OAAO,CAAC,CA4FvB"}

package/dist/orchestration/recovery.js

@@ -0,0 +1,110 @@
+function cloneFiberMap(state) {
+    return { ...state.fibers };
+}
+function buildDeadLetterEffects(state, fiber, reason) {
+    const effects = [
+        {
+            kind: 'dead_letter',
+            fiberId: fiber.id,
+            reason,
+        },
+    ];
+    const route = state.options.deadLetterFactory?.(fiber, reason);
+    if (route) {
+        effects.push({
+            kind: 'dead_letter',
+            fiberId: fiber.id,
+            reason,
+            to: route.to,
+            step: route.step,
+        });
+    }
+    return effects;
+}
+function computeRetryDelay(retryDelayMs, retryBackoffMultiplier, attempts) {
+    const base = Math.max(0, retryDelayMs);
+    const multiplier = Math.max(1, retryBackoffMultiplier);
+    return Math.floor(base * Math.pow(multiplier, Math.max(0, attempts - 1)));
+}
+export function applyFailure(state, fiberId, now, error) {
+    const fiber = state.fibers[fiberId];
+    if (!fiber) {
+        return { state, effects: [] };
+    }
+    if (fiber.status === 'completed' || fiber.status === 'cancelled' || fiber.status === 'dead_letter') {
+        return { state, effects: [] };
+    }
+    const nextFibers = cloneFiberMap(state);
+    if (state.options.retryEnabled && fiber.attempts < fiber.maxAttempts) {
+        const nextAttempts = fiber.attempts + 1;
+        const delay = computeRetryDelay(state.options.retryDelayMs, state.options.retryBackoffMultiplier, nextAttempts);
+        const updated = {
+            ...fiber,
+            status: 'suspended',
+            waitingReason: 'retry_backoff',
+            suspendPolicy: undefined,
+            retryAt: now + delay,
+            timeoutAt: undefined,
+            attempts: nextAttempts,
+            lastError: error,
+            updatedAt: now,
+        };
+        nextFibers[fiberId] = updated;
+        return {
+            state: {
+                ...state,
+                fibers: nextFibers,
+            },
+            effects: [],
+        };
+    }
+    if (state.options.deadLetterEnabled) {
+        const updated = {
+            ...fiber,
+            status: 'dead_letter',
+            waitingReason: undefined,
+            suspendPolicy: undefined,
+            retryAt: undefined,
+            lastError: error,
+            updatedAt: now,
+        };
+        nextFibers[fiberId] = updated;
+        const deadLetters = [
+            ...state.deadLetters,
+            {
+                fiberId: fiber.id,
+                actorId: fiber.actorId,
+                reason: error,
+                at: now,
+                attempts: fiber.attempts,
+                step: fiber.step,
+            },
+        ];
+        return {
+            state: {
+                ...state,
+                fibers: nextFibers,
+                deadLetters,
+            },
+            effects: buildDeadLetterEffects(state, updated, error),
+        };
+    }
+    const updated = {
+        ...fiber,
+        status: 'failed',
+        waitingReason: undefined,
+        suspendPolicy: undefined,
+        retryAt: undefined,
+        lastError: error,
+        updatedAt: now,
+    };
+    nextFibers[fiberId] = updated;
+    return {
+        state: {
+            ...state,
+            fibers: nextFibers,
+        },
+        effects: [],
+    };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/orchestration/recovery.js.map

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