depa-actor 0.1.0 → 0.1.2

package/dist/pipeline/ActorPipeline.js

@@ -0,0 +1,32 @@
+/**
+ * depa-actor — ActorPipeline
+ *
+ * Adapts the DOP 6-step pipeline (from depa-processor) to actor context.
+ *
+ * Mapping:
+ *   OuterRuntime = ActorSelf
+ *   OuterInput   = envelope payload
+ *   OuterConfig  = actor state
+ *
+ * createPipelineHandler() wraps a pipeline definition into an ActorHandler.
+ */
+// ─── createPipelineHandler ───────────────────────────────────────────
+export function createPipelineHandler(pipeline) {
+    return async (self, envelope) => {
+        const payload = envelope.payload;
+        const state = self.state;
+        // Step 1: Compute derived
+        const derived = pipeline.computeDerived(self, payload, state);
+        // Step 2: Transform runtime
+        const innerRuntime = pipeline.innerRuntime(self, payload, state, derived);
+        // Step 3: Transform input
+        const innerInput = pipeline.innerInput(self, payload, state, derived);
+        // Step 4: Transform config
+        const innerConfig = pipeline.innerConfig(self, payload, state, derived);
+        // Step 5: Core logic
+        const innerOutput = await pipeline.coreLogic(innerRuntime, innerInput, innerConfig);
+        // Step 6: Output (side effects on actor state / send messages)
+        await pipeline.output(self, payload, state, derived, innerOutput);
+    };
+}
+//# sourceMappingURL=ActorPipeline.js.map

package/dist/pipeline/ActorPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorPipeline.js","sourceRoot":"","sources":["../../src/pipeline/ActorPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiFH,wEAAwE;AAExE,MAAM,UAAU,qBAAqB,CAUnC,QAGC;IAED,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,0BAA0B;QAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAE9D,4BAA4B;QAC5B,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAE1E,0BAA0B;QAC1B,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAEtE,2BAA2B;QAC3B,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAExE,qBAAqB;QACrB,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAEpF,+DAA+D;QAC/D,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC"}

package/dist/runtime/ActorRuntime.d.ts

@@ -0,0 +1,35 @@
+/**
+ * depa-actor — ActorRuntime
+ *
+ * Lifecycle and plugin layer over ActorSystem.
+ * ActorSystem = engine, ActorRuntime = managed environment.
+ *
+ * Future AiAgentVm will hold an ActorRuntime instance.
+ */
+import type { MailboxSchema, ActorDef, ActorRef, ActorLogEntry } from '../core/types';
+import { ActorSystem } from '../core/ActorSystem';
+export interface ActorPlugin<TRuntime, TSchema extends MailboxSchema> {
+    name: string;
+    onRegister?: (id: string, def: ActorDef<TRuntime, TSchema, unknown>) => void;
+    onUnregister?: (id: string) => void;
+    onLog?: (entry: ActorLogEntry<TSchema>) => void;
+}
+export declare class ActorRuntime<TRuntime, TSchema extends MailboxSchema> {
+    readonly system: ActorSystem<TRuntime, TSchema>;
+    private plugins;
+    private facets;
+    constructor(getRuntime: () => TRuntime, plugins?: ActorPlugin<TRuntime, TSchema>[]);
+    addPlugin(plugin: ActorPlugin<TRuntime, TSchema>): void;
+    hasFacet(name: string): boolean;
+    getFacet<TFacet>(name: string): TFacet | undefined;
+    setFacet<TFacet>(name: string, facet: TFacet): TFacet;
+    ensureFacet<TFacet>(name: string, create: () => TFacet): TFacet;
+    register<TState = void>(id: string, def: ActorDef<TRuntime, TSchema, TState>): void;
+    unregister(id: string): void;
+    sendFrom<TTag extends keyof TSchema & string>(from: string, to: string, tag: TTag, payload: TSchema[TTag]): void;
+    refFrom(from: string, to: string): ActorRef<TSchema> | undefined;
+    ids(): string[];
+    has(id: string): boolean;
+    private handleLog;
+}
+//# sourceMappingURL=ActorRuntime.d.ts.map

package/dist/runtime/ActorRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorRuntime.d.ts","sourceRoot":"","sources":["../../src/runtime/ActorRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,aAAa,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlD,MAAM,WAAW,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,aAAa;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7E,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACjD;AAID,qBAAa,YAAY,CAAC,QAAQ,EAAE,OAAO,SAAS,aAAa;IAC/D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAA8B;gBAG1C,UAAU,EAAE,MAAM,QAAQ,EAC1B,OAAO,CAAC,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE;IAY5C,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIlD,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAKrD,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,GAAG,MAAM;IAY/D,QAAQ,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;IAOnF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,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;IAIP,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS;IAIhE,GAAG,IAAI,MAAM,EAAE;IAIf,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAMxB,OAAO,CAAC,SAAS;CAKlB"}

package/dist/runtime/ActorRuntime.js

@@ -0,0 +1,74 @@
+/**
+ * depa-actor — ActorRuntime
+ *
+ * Lifecycle and plugin layer over ActorSystem.
+ * ActorSystem = engine, ActorRuntime = managed environment.
+ *
+ * Future AiAgentVm will hold an ActorRuntime instance.
+ */
+import { ActorSystem } from '../core/ActorSystem';
+// ─── ActorRuntime ────────────────────────────────────────────────────
+export class ActorRuntime {
+    system;
+    plugins = [];
+    facets = new Map();
+    constructor(getRuntime, plugins) {
+        this.plugins = plugins ?? [];
+        this.system = new ActorSystem(getRuntime, (entry) => this.handleLog(entry));
+    }
+    // ── Plugin management ──
+    addPlugin(plugin) {
+        this.plugins.push(plugin);
+    }
+    hasFacet(name) {
+        return this.facets.has(name);
+    }
+    getFacet(name) {
+        return this.facets.get(name);
+    }
+    setFacet(name, facet) {
+        this.facets.set(name, facet);
+        return facet;
+    }
+    ensureFacet(name, create) {
+        const existing = this.facets.get(name);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const created = create();
+        this.facets.set(name, created);
+        return created;
+    }
+    // ── Delegated API (convenience) ──
+    register(id, def) {
+        this.system.register(id, def);
+        for (const p of this.plugins) {
+            p.onRegister?.(id, def);
+        }
+    }
+    unregister(id) {
+        this.system.unregister(id);
+        for (const p of this.plugins) {
+            p.onUnregister?.(id);
+        }
+    }
+    sendFrom(from, to, tag, payload) {
+        this.system.sendFrom(from, to, tag, payload);
+    }
+    refFrom(from, to) {
+        return this.system.refFrom(from, to);
+    }
+    ids() {
+        return this.system.ids();
+    }
+    has(id) {
+        return this.system.has(id);
+    }
+    // ── Internal ──
+    handleLog(entry) {
+        for (const p of this.plugins) {
+            p.onLog?.(entry);
+        }
+    }
+}
+//# sourceMappingURL=ActorRuntime.js.map

package/dist/runtime/ActorRuntime.js.map

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

package/dist/runtime/completion.d.ts

@@ -0,0 +1,21 @@
+export type CompletionWaiter<TResult> = (result: TResult) => void;
+export declare class CompletionSignalRegistry<TKey extends string, TResult> {
+    private readonly waiters;
+    subscribe(key: TKey, waiter: CompletionWaiter<TResult>): () => void;
+    resolve(key: TKey, result: TResult): void;
+    has(key: TKey): boolean;
+    count(key: TKey): number;
+    clear(key?: TKey): void;
+}
+export declare function createCompletionSignalRegistry<TKey extends string, TResult>(): CompletionSignalRegistry<TKey, TResult>;
+export declare class CompletionBindingRegistry<TKey extends string, TBinding> {
+    private readonly bindings;
+    constructor(initial?: Record<TKey, TBinding>);
+    get(key: TKey): TBinding | undefined;
+    set(key: TKey, binding: TBinding): void;
+    delete(key: TKey): void;
+    has(key: TKey): boolean;
+    snapshot(): Record<TKey, TBinding>;
+}
+export declare function createCompletionBindingRegistry<TKey extends string, TBinding>(initial?: Record<TKey, TBinding>): CompletionBindingRegistry<TKey, TBinding>;
+//# sourceMappingURL=completion.d.ts.map

package/dist/runtime/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/runtime/completion.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAElE,qBAAa,wBAAwB,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmD;IAE3E,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI;IAgBnE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAWzC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAIvB,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM;IAIxB,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI;CAOxB;AAED,wBAAgB,8BAA8B,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,KAAK,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAEtH;AAED,qBAAa,yBAAyB,CAAC,IAAI,SAAS,MAAM,EAAE,QAAQ;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;gBAEtC,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;IAI5C,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS;IAIpC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAIvC,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAIvB,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAIvB,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;CAGnC;AAED,wBAAgB,+BAA+B,CAAC,IAAI,SAAS,MAAM,EAAE,QAAQ,EAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAC/B,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAE3C"}

package/dist/runtime/completion.js

@@ -0,0 +1,69 @@
+export class CompletionSignalRegistry {
+    waiters = new Map();
+    subscribe(key, waiter) {
+        const current = this.waiters.get(key) ?? new Set();
+        current.add(waiter);
+        this.waiters.set(key, current);
+        return () => {
+            const next = this.waiters.get(key);
+            if (!next) {
+                return;
+            }
+            next.delete(waiter);
+            if (next.size === 0) {
+                this.waiters.delete(key);
+            }
+        };
+    }
+    resolve(key, result) {
+        const waiters = this.waiters.get(key);
+        if (!waiters || waiters.size === 0) {
+            return;
+        }
+        this.waiters.delete(key);
+        for (const waiter of Array.from(waiters)) {
+            waiter(result);
+        }
+    }
+    has(key) {
+        return (this.waiters.get(key)?.size ?? 0) > 0;
+    }
+    count(key) {
+        return this.waiters.get(key)?.size ?? 0;
+    }
+    clear(key) {
+        if (key !== undefined) {
+            this.waiters.delete(key);
+            return;
+        }
+        this.waiters.clear();
+    }
+}
+export function createCompletionSignalRegistry() {
+    return new CompletionSignalRegistry();
+}
+export class CompletionBindingRegistry {
+    bindings;
+    constructor(initial) {
+        this.bindings = Object.assign(Object.create(null), initial ?? {});
+    }
+    get(key) {
+        return this.bindings[key];
+    }
+    set(key, binding) {
+        this.bindings[key] = binding;
+    }
+    delete(key) {
+        delete this.bindings[key];
+    }
+    has(key) {
+        return key in this.bindings;
+    }
+    snapshot() {
+        return { ...this.bindings };
+    }
+}
+export function createCompletionBindingRegistry(initial) {
+    return new CompletionBindingRegistry(initial);
+}
+//# sourceMappingURL=completion.js.map

package/dist/runtime/completion.js.map

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

package/dist/runtime/indexing.d.ts

@@ -0,0 +1,12 @@
+export declare class RuntimeIndexHook<TKey extends string, TValue> {
+    private readonly entries;
+    constructor(initial?: Record<TKey, TValue>);
+    get(key: TKey): TValue | undefined;
+    set(key: TKey, value: TValue): void;
+    delete(key: TKey): void;
+    has(key: TKey): boolean;
+    values(): TValue[];
+    snapshot(): Record<TKey, TValue>;
+}
+export declare function createRuntimeIndexHook<TKey extends string, TValue>(initial?: Record<TKey, TValue>): RuntimeIndexHook<TKey, TValue>;
+//# sourceMappingURL=indexing.d.ts.map

package/dist/runtime/indexing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.d.ts","sourceRoot":"","sources":["../../src/runtime/indexing.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;gBAEvC,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;IAM1C,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS;IAIlC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAIvB,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAIvB,MAAM,IAAI,MAAM,EAAE;IAIlB,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;CAGjC;AAED,wBAAgB,sBAAsB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAChE,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAC7B,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAEhC"}

package/dist/runtime/indexing.js

@@ -0,0 +1,30 @@
+export class RuntimeIndexHook {
+    entries = new Map();
+    constructor(initial) {
+        for (const [key, value] of Object.entries(initial ?? {})) {
+            this.entries.set(key, value);
+        }
+    }
+    get(key) {
+        return this.entries.get(key);
+    }
+    set(key, value) {
+        this.entries.set(key, value);
+    }
+    delete(key) {
+        this.entries.delete(key);
+    }
+    has(key) {
+        return this.entries.has(key);
+    }
+    values() {
+        return Array.from(this.entries.values());
+    }
+    snapshot() {
+        return Object.fromEntries(this.entries.entries());
+    }
+}
+export function createRuntimeIndexHook(initial) {
+    return new RuntimeIndexHook(initial);
+}
+//# sourceMappingURL=indexing.js.map

package/dist/runtime/indexing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.js","sourceRoot":"","sources":["../../src/runtime/indexing.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAgB;IACV,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEnD,YAAY,OAA8B;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAA0B,EAAE,CAAC;YAClF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAS,EAAE,KAAa;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,GAAS;QACd,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,QAAQ;QACN,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAyB,CAAC;IAC5E,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CACpC,OAA8B;IAE9B,OAAO,IAAI,gBAAgB,CAAe,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/runtime/snapshot.d.ts

@@ -0,0 +1,76 @@
+export type SnapshotRecoveryState = {
+    restoredFromSnapshot: boolean;
+    snapshotVersion?: number;
+    restoredAt?: number;
+};
+export type RuntimeSnapshotManifestBase = {
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    actorKeys: string[];
+    fiberIds: string[];
+    indexFiles: string[];
+    derivedIndexFiles?: string[];
+    savedAt?: number;
+    vmFile: string;
+    actorFiles: Record<string, string>;
+    fiberFiles: Record<string, string>;
+};
+export type RuntimeRootSnapshotBase = {
+    version: number;
+    controlActorKey: string;
+    actorKeys: string[];
+    updatedAt: string;
+    recovery?: SnapshotRecoveryState;
+};
+export type ActorSnapshotBase<TActorType extends string = string> = {
+    version: number;
+    key: string;
+    id: string;
+    type: TActorType;
+    parentKey?: string;
+    updatedAt?: string;
+    recovery?: SnapshotRecoveryState;
+};
+export type FiberSnapshotBase = {
+    version: number;
+    fiberId: string;
+    actorKey?: string;
+    actorId?: string;
+    parentFiberId?: string;
+    status?: string;
+    lane?: string;
+    workloadKind?: string;
+    kind?: string;
+    waitingReason?: string | null;
+    createdAt?: number;
+    lastRunAt?: number | null;
+    lastYieldAt?: number | null;
+    resumeMetadata?: Record<string, unknown> | null;
+    updatedAt?: string;
+    workload?: string;
+    metadata?: Record<string, unknown>;
+};
+export interface SnapshotCodec<TState, TSnapshot> {
+    serialize: (state: TState) => TSnapshot;
+    hydrate: (snapshot: TSnapshot) => TState;
+}
+export interface RecoveryHooks<TState, TSnapshot> {
+    beforeSerialize?: (state: TState) => TState;
+    beforeHydrate?: (snapshot: TSnapshot) => TSnapshot;
+    afterHydrate?: (state: TState) => TState;
+}
+export interface PersistenceEffectPort<TManifest, TSnapshotState> {
+    save: (params: {
+        manifest: TManifest;
+        state: TSnapshotState;
+    }) => Promise<void>;
+    load: () => Promise<{
+        manifest: TManifest;
+        state: TSnapshotState;
+    } | null>;
+}
+export declare function createSnapshotCodec<TState, TSnapshot>(codec: SnapshotCodec<TState, TSnapshot>): SnapshotCodec<TState, TSnapshot>;
+export declare function createRecoveryHooks<TState, TSnapshot>(hooks: RecoveryHooks<TState, TSnapshot>): RecoveryHooks<TState, TSnapshot>;
+export declare function createPersistenceEffectPort<TManifest, TSnapshotState>(port: PersistenceEffectPort<TManifest, TSnapshotState>): PersistenceEffectPort<TManifest, TSnapshotState>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/runtime/snapshot.d.ts.map

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

package/dist/runtime/snapshot.js

@@ -0,0 +1,10 @@
+export function createSnapshotCodec(codec) {
+    return codec;
+}
+export function createRecoveryHooks(hooks) {
+    return hooks;
+}
+export function createPersistenceEffectPort(port) {
+    return port;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/runtime/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/runtime/snapshot.ts"],"names":[],"mappings":"AA0EA,MAAM,UAAU,mBAAmB,CACjC,KAAuC;IAEvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAuC;IAEvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,IAAsD;IAEtD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depa-actor",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -24,5 +24,13 @@
   "devDependencies": {
     "typescript": "^5.8.3"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seerkong/depa-actor.git"
+  },
+  "bugs": {
+    "url": "https://github.com/seerkong/depa-actor/issues"
+  },
+  "homepage": "https://github.com/seerkong/depa-actor#readme",
   "license": "MIT"
 }