@cadenza.io/core 3.22.0 → 3.24.0

package/dist/index.d.mts

@@ -1854,6 +1854,8 @@ interface SessionPolicy {
     idleTtlMs?: number;
     absoluteTtlMs?: number;
     extendIdleTtlOnRead?: boolean;
+    persistDurableState?: boolean;
+    persistenceTimeoutMs?: number;
 }
 /**
  * Task retry policy metadata for actor definitions/specs.
@@ -2046,6 +2048,21 @@ interface ActorTaskContext<D extends Record<string, any>, R = AnyObject> {
  * Handler signature used by `actor.task(...)`.
  */
 type ActorTaskHandler<D extends Record<string, any>, R = AnyObject> = (context: ActorTaskContext<D, R>) => TaskResult | ActorStateReducer<D> | Promise<TaskResult | ActorStateReducer<D>>;
+/**
+ * Metadata attached to wrapped actor task functions.
+ */
+interface ActorTaskRuntimeMetadata {
+    actorName: string;
+    actorDescription?: string;
+    actorKind: ActorKind;
+    mode: ActorTaskMode;
+    forceMeta: boolean;
+}
+declare const META_ACTOR_SESSION_STATE_PERSIST_INTENT = "meta-actor-session-state-persist";
+/**
+ * Reads actor metadata from a wrapped task function if available.
+ */
+declare function getActorTaskRuntimeMetadata(taskFunction: TaskFunction): ActorTaskRuntimeMetadata | undefined;
 /**
  * In-memory actor runtime.
  *
@@ -2112,6 +2129,8 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private touchSession;
     private runWithOptionalIdempotency;
     private getActiveIdempotencyRecord;
+    private persistDurableStateIfConfigured;
+    private emitActorCreatedSignal;
 }
 
 interface TaskOptions {
@@ -2145,6 +2164,7 @@ declare class Cadenza {
     static metaRunner: GraphRunner;
     static registry: GraphRegistry;
     private static taskCache;
+    private static actorCache;
     static isBootstrapped: boolean;
     static mode: CadenzaMode;
     /**
@@ -2185,6 +2205,7 @@ declare class Cadenza {
      */
     static validateName(name: string): void;
     private static resolveTaskOptionsForActorTask;
+    private static registerActor;
     /**
      * Executes the specified task or GraphRoutine with the given context using an internal runner.
      *
@@ -2226,6 +2247,8 @@ declare class Cadenza {
     static interval(taskName: string, context: AnyObject, intervalMs: number, leading?: boolean, startDateTime?: Date): void;
     static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
+    static getActor<D extends Record<string, any> = AnyObject, R = AnyObject>(actorName: string): Actor<D, R> | undefined;
+    static getAllActors<D extends Record<string, any> = AnyObject, R = AnyObject>(): Actor<D, R>[];
     static getRoutine(routineName: string): GraphRoutine | undefined;
     static defineIntent(intent: Intent): Intent;
     static inquire(inquiry: string, context: AnyObject, options?: InquiryOptions): Promise<any>;
@@ -2594,4 +2617,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };

package/dist/index.d.ts

@@ -1854,6 +1854,8 @@ interface SessionPolicy {
     idleTtlMs?: number;
     absoluteTtlMs?: number;
     extendIdleTtlOnRead?: boolean;
+    persistDurableState?: boolean;
+    persistenceTimeoutMs?: number;
 }
 /**
  * Task retry policy metadata for actor definitions/specs.
@@ -2046,6 +2048,21 @@ interface ActorTaskContext<D extends Record<string, any>, R = AnyObject> {
  * Handler signature used by `actor.task(...)`.
  */
 type ActorTaskHandler<D extends Record<string, any>, R = AnyObject> = (context: ActorTaskContext<D, R>) => TaskResult | ActorStateReducer<D> | Promise<TaskResult | ActorStateReducer<D>>;
+/**
+ * Metadata attached to wrapped actor task functions.
+ */
+interface ActorTaskRuntimeMetadata {
+    actorName: string;
+    actorDescription?: string;
+    actorKind: ActorKind;
+    mode: ActorTaskMode;
+    forceMeta: boolean;
+}
+declare const META_ACTOR_SESSION_STATE_PERSIST_INTENT = "meta-actor-session-state-persist";
+/**
+ * Reads actor metadata from a wrapped task function if available.
+ */
+declare function getActorTaskRuntimeMetadata(taskFunction: TaskFunction): ActorTaskRuntimeMetadata | undefined;
 /**
  * In-memory actor runtime.
  *
@@ -2112,6 +2129,8 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private touchSession;
     private runWithOptionalIdempotency;
     private getActiveIdempotencyRecord;
+    private persistDurableStateIfConfigured;
+    private emitActorCreatedSignal;
 }
 
 interface TaskOptions {
@@ -2145,6 +2164,7 @@ declare class Cadenza {
     static metaRunner: GraphRunner;
     static registry: GraphRegistry;
     private static taskCache;
+    private static actorCache;
     static isBootstrapped: boolean;
     static mode: CadenzaMode;
     /**
@@ -2185,6 +2205,7 @@ declare class Cadenza {
      */
     static validateName(name: string): void;
     private static resolveTaskOptionsForActorTask;
+    private static registerActor;
     /**
      * Executes the specified task or GraphRoutine with the given context using an internal runner.
      *
@@ -2226,6 +2247,8 @@ declare class Cadenza {
     static interval(taskName: string, context: AnyObject, intervalMs: number, leading?: boolean, startDateTime?: Date): void;
     static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
+    static getActor<D extends Record<string, any> = AnyObject, R = AnyObject>(actorName: string): Actor<D, R> | undefined;
+    static getAllActors<D extends Record<string, any> = AnyObject, R = AnyObject>(): Actor<D, R>[];
     static getRoutine(routineName: string): GraphRoutine | undefined;
     static defineIntent(intent: Intent): Intent;
     static inquire(inquiry: string, context: AnyObject, options?: InquiryOptions): Promise<any>;
@@ -2594,4 +2617,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };