@cadenza.io/service 2.9.0 → 2.10.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _cadenza_io_core from '@cadenza.io/core';
-import { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, EmitOptions, CadenzaMode, Intent, TaskOptions, ActorSpec, ActorFactoryOptions, Actor, ActorDefinition, TaskFunction, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
+import { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, EmitOptions, CadenzaMode, Intent, Actor, TaskOptions, ActorSpec, ActorFactoryOptions, ActorDefinition, TaskFunction, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
 export { Actor, ActorConsistencyProfileName, ActorDefinition, ActorFactoryOptions, ActorInvocationOptions, ActorKeyDefinition, ActorKind, ActorLoadPolicy, ActorRuntimeReadGuard, ActorSpec, ActorStateDefinition, ActorStateReducer, ActorStateStore, ActorTaskBindingDefinition, ActorTaskBindingOptions, ActorTaskContext, ActorTaskHandler, ActorTaskMode, ActorWriteContract, AnyObject, DebounceOptions, DebounceTask, EphemeralTask, EphemeralTaskOptions, GraphRoutine, IdempotencyPolicy, RetryPolicy, SessionPolicy, Task, TaskFunction, TaskOptions, ThrottleTagGetter } from '@cadenza.io/core';
 
 /**
@@ -22223,6 +22223,8 @@ declare class CadenzaService {
      */
     static log(message: string, data?: any, level?: "info" | "warning" | "error" | "critical", subjectServiceName?: string | null, subjectServiceInstanceId?: string | null): 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;
     /**
      * Creates a new DeputyTask instance based on the provided routine name, service name, and options.
@@ -22858,6 +22860,8 @@ declare class SocketController {
     private readonly diagnosticsMaxClientEntries;
     private readonly destroyedDiagnosticsTtlMs;
     private readonly socketServerDefaultKey;
+    private readonly socketServerInitialSessionState;
+    private readonly socketClientInitialSessionState;
     private readonly socketServerActor;
     private readonly socketClientActor;
     private readonly socketClientDiagnosticsActor;
@@ -22865,8 +22869,6 @@ declare class SocketController {
     private registerDiagnosticsTasks;
     private registerSocketServerTasks;
     private registerSocketClientTasks;
-    private createInitialSocketServerSessionState;
-    private createInitialSocketClientSessionState;
     private resolveSocketServerKey;
     private resolveSocketClientFetchId;
     private resolveServicePort;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _cadenza_io_core from '@cadenza.io/core';
-import { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, EmitOptions, CadenzaMode, Intent, TaskOptions, ActorSpec, ActorFactoryOptions, Actor, ActorDefinition, TaskFunction, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
+import { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, EmitOptions, CadenzaMode, Intent, Actor, TaskOptions, ActorSpec, ActorFactoryOptions, ActorDefinition, TaskFunction, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
 export { Actor, ActorConsistencyProfileName, ActorDefinition, ActorFactoryOptions, ActorInvocationOptions, ActorKeyDefinition, ActorKind, ActorLoadPolicy, ActorRuntimeReadGuard, ActorSpec, ActorStateDefinition, ActorStateReducer, ActorStateStore, ActorTaskBindingDefinition, ActorTaskBindingOptions, ActorTaskContext, ActorTaskHandler, ActorTaskMode, ActorWriteContract, AnyObject, DebounceOptions, DebounceTask, EphemeralTask, EphemeralTaskOptions, GraphRoutine, IdempotencyPolicy, RetryPolicy, SessionPolicy, Task, TaskFunction, TaskOptions, ThrottleTagGetter } from '@cadenza.io/core';
 
 /**
@@ -22223,6 +22223,8 @@ declare class CadenzaService {
      */
     static log(message: string, data?: any, level?: "info" | "warning" | "error" | "critical", subjectServiceName?: string | null, subjectServiceInstanceId?: string | null): 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;
     /**
      * Creates a new DeputyTask instance based on the provided routine name, service name, and options.
@@ -22858,6 +22860,8 @@ declare class SocketController {
     private readonly diagnosticsMaxClientEntries;
     private readonly destroyedDiagnosticsTtlMs;
     private readonly socketServerDefaultKey;
+    private readonly socketServerInitialSessionState;
+    private readonly socketClientInitialSessionState;
     private readonly socketServerActor;
     private readonly socketClientActor;
     private readonly socketClientDiagnosticsActor;
@@ -22865,8 +22869,6 @@ declare class SocketController {
     private registerDiagnosticsTasks;
     private registerSocketServerTasks;
     private registerSocketClientTasks;
-    private createInitialSocketServerSessionState;
-    private createInitialSocketClientSessionState;
     private resolveSocketServerKey;
     private resolveSocketClientFetchId;
     private resolveServicePort;

package/dist/index.js

@@ -3346,6 +3346,44 @@ var SocketController = class _SocketController {
     this.diagnosticsMaxClientEntries = 500;
     this.destroyedDiagnosticsTtlMs = 15 * 6e4;
     this.socketServerDefaultKey = "socket-server-default";
+    this.socketServerInitialSessionState = {
+      serverKey: this.socketServerDefaultKey,
+      useSocket: false,
+      status: "inactive",
+      securityProfile: "medium",
+      networkType: "internal",
+      connectionCount: 0,
+      lastStartedAt: null,
+      lastConnectedAt: null,
+      lastDisconnectedAt: null,
+      lastShutdownAt: null,
+      updatedAt: 0
+    };
+    this.socketClientInitialSessionState = {
+      fetchId: "",
+      serviceInstanceId: "",
+      communicationTypes: [],
+      serviceName: "",
+      serviceAddress: "",
+      servicePort: 0,
+      protocol: "http",
+      url: "",
+      socketId: null,
+      connected: false,
+      handshake: false,
+      pendingDelegations: 0,
+      pendingTimers: 0,
+      reconnectAttempts: 0,
+      connectErrors: 0,
+      reconnectErrors: 0,
+      socketErrors: 0,
+      errorCount: 0,
+      destroyed: false,
+      lastHandshakeAt: null,
+      lastHandshakeError: null,
+      lastDisconnectAt: null,
+      updatedAt: 0
+    };
     this.socketServerActor = CadenzaService.createActor(
       {
         name: "SocketServerActor",
@@ -3354,9 +3392,7 @@ var SocketController = class _SocketController {
         keyResolver: (input) => this.resolveSocketServerKey(input),
         loadPolicy: "lazy",
         writeContract: "overwrite",
-        initState: this.createInitialSocketServerSessionState(
-          this.socketServerDefaultKey
-        )
+        initState: this.socketServerInitialSessionState
       },
       { isMeta: true }
     );
@@ -3368,7 +3404,7 @@ var SocketController = class _SocketController {
         keyResolver: (input) => this.resolveSocketClientFetchId(input),
         loadPolicy: "lazy",
         writeContract: "overwrite",
-        initState: this.createInitialSocketClientSessionState()
+        initState: this.socketClientInitialSessionState
       },
       { isMeta: true }
     );
@@ -4449,48 +4485,6 @@ var SocketController = class _SocketController {
       "Connects to a specified socket server and wires runtime tasks."
     ).doOn("meta.fetch.handshake_complete").emitsOnFail("meta.socket_client.connect_failed");
   }
-  createInitialSocketServerSessionState(serverKey) {
-    return {
-      serverKey,
-      useSocket: false,
-      status: "inactive",
-      securityProfile: "medium",
-      networkType: "internal",
-      connectionCount: 0,
-      lastStartedAt: null,
-      lastConnectedAt: null,
-      lastDisconnectedAt: null,
-      lastShutdownAt: null,
-      updatedAt: 0
-    };
-  }
-  createInitialSocketClientSessionState() {
-    return {
-      fetchId: "",
-      serviceInstanceId: "",
-      communicationTypes: [],
-      serviceName: "",
-      serviceAddress: "",
-      servicePort: 0,
-      protocol: "http",
-      url: "",
-      socketId: null,
-      connected: false,
-      handshake: false,
-      pendingDelegations: 0,
-      pendingTimers: 0,
-      reconnectAttempts: 0,
-      connectErrors: 0,
-      reconnectErrors: 0,
-      socketErrors: 0,
-      errorCount: 0,
-      destroyed: false,
-      lastHandshakeAt: null,
-      lastHandshakeError: null,
-      lastDisconnectAt: null,
-      updatedAt: 0
-    };
-  }
   resolveSocketServerKey(input) {
     return String(input.serverKey ?? input.__socketServerKey ?? this.socketServerDefaultKey).trim() || this.socketServerDefaultKey;
   }
@@ -5040,6 +5034,22 @@ var GraphMetadataController = class _GraphMetadataController {
       "Handles task execution relationship creation",
       { concurrency: 100, isSubMeta: true }
     ).doOn("meta.node.mapped", "meta.node.detected_previous_task_execution").emits("global.meta.graph_metadata.relationship_executed");
+    CadenzaService.createMetaTask("Handle actor creation", (ctx) => {
+      return {
+        data: {
+          ...ctx.data,
+          service_name: CadenzaService.serviceRegistry.serviceName
+        }
+      };
+    }).doOn("meta.actor.created").emits("global.meta.graph_metadata.actor_created");
+    CadenzaService.createMetaTask("Handle actor task association", (ctx) => {
+      return {
+        data: {
+          ...ctx.data,
+          service_name: CadenzaService.serviceRegistry.serviceName
+        }
+      };
+    }).doOn("meta.actor.task_associated").emits("global.meta.graph_metadata.actor_task_associated");
     CadenzaService.createMetaTask("Handle Intent Creation", (ctx) => {
       const intentName = ctx.data?.name;
       return {
@@ -6711,8 +6721,69 @@ function tableFieldTypeToSchemaType(type) {
 var import_uuid3 = require("uuid");
 
 // src/graph/controllers/GraphSyncController.ts
+var ACTOR_TASK_METADATA = /* @__PURE__ */ Symbol.for("@cadenza.io/core/actor-task-meta");
+function getActorTaskRuntimeMetadata(taskFunction) {
+  if (typeof taskFunction !== "function") {
+    return void 0;
+  }
+  return taskFunction[ACTOR_TASK_METADATA];
+}
+function sanitizeActorMetadataValue(value) {
+  if (value === null) {
+    return null;
+  }
+  if (value === void 0 || typeof value === "function") {
+    return void 0;
+  }
+  if (Array.isArray(value)) {
+    const items = [];
+    for (const item of value) {
+      const sanitizedItem = sanitizeActorMetadataValue(item);
+      if (sanitizedItem !== void 0) {
+        items.push(sanitizedItem);
+      }
+    }
+    return items;
+  }
+  if (typeof value === "object") {
+    const output = {};
+    for (const [key, nestedValue] of Object.entries(value)) {
+      const sanitizedNestedValue = sanitizeActorMetadataValue(nestedValue);
+      if (sanitizedNestedValue !== void 0) {
+        output[key] = sanitizedNestedValue;
+      }
+    }
+    return output;
+  }
+  return value;
+}
+function buildActorRegistrationData(actor) {
+  const definition = sanitizeActorMetadataValue(
+    typeof actor?.toDefinition === "function" ? actor.toDefinition() : {}
+  );
+  const stateDefinition = definition?.state && typeof definition.state === "object" ? definition.state : {};
+  const actorKind = typeof definition?.kind === "string" ? definition.kind : actor?.kind;
+  return {
+    name: definition?.name ?? actor?.spec?.name ?? "",
+    description: definition?.description ?? actor?.spec?.description ?? "",
+    default_key: definition?.defaultKey ?? actor?.spec?.defaultKey ?? "default",
+    load_policy: definition?.loadPolicy ?? actor?.spec?.loadPolicy ?? "eager",
+    write_contract: definition?.writeContract ?? actor?.spec?.writeContract ?? "overwrite",
+    runtime_read_guard: definition?.runtimeReadGuard ?? actor?.spec?.runtimeReadGuard ?? "none",
+    consistency_profile: definition?.consistencyProfile ?? actor?.spec?.consistencyProfile ?? null,
+    key_definition: definition?.key ?? null,
+    state_definition: stateDefinition,
+    retry_policy: definition?.retry ?? {},
+    idempotency_policy: definition?.idempotency ?? {},
+    session_policy: definition?.session ?? {},
+    is_meta: actorKind === "meta",
+    version: 1
+  };
+}
 var GraphSyncController = class _GraphSyncController {
   constructor() {
+    this.registeredActors = /* @__PURE__ */ new Set();
+    this.registeredActorTaskMaps = /* @__PURE__ */ new Set();
     this.isCadenzaDBReady = false;
   }
   static get instance() {
@@ -6970,6 +7041,120 @@ var GraphSyncController = class _GraphSyncController {
         )
       )
     );
+    this.splitActorsForRegistration = CadenzaService.createMetaTask(
+      "Split actors for registration",
+      function* (ctx) {
+        CadenzaService.debounce("meta.sync_controller.synced_resource", {
+          delayMs: 3e3
+        });
+        const actors = ctx.actors ?? [];
+        for (const actor of actors) {
+          const data = {
+            ...buildActorRegistrationData(actor),
+            service_name: CadenzaService.serviceRegistry.serviceName
+          };
+          if (!data.name) {
+            continue;
+          }
+          const registrationKey = `${data.name}|${data.version}|${data.service_name}`;
+          if (this.registeredActors.has(registrationKey)) {
+            continue;
+          }
+          yield {
+            data,
+            __actorRegistrationKey: registrationKey
+          };
+        }
+      }.bind(this)
+    ).then(
+      (this.isCadenzaDBReady ? CadenzaService.createCadenzaDBInsertTask(
+        "actor",
+        {
+          onConflict: {
+            target: ["name", "service_name", "version"],
+            action: {
+              do: "nothing"
+            }
+          }
+        },
+        { concurrency: 30 }
+      ) : CadenzaService.get("dbInsertActor"))?.then(
+        CadenzaService.createMetaTask("Record actor registration", (ctx) => {
+          if (!ctx.__syncing) {
+            return;
+          }
+          CadenzaService.debounce("meta.sync_controller.synced_resource", {
+            delayMs: 3e3
+          });
+          this.registeredActors.add(ctx.__actorRegistrationKey);
+          return true;
+        }).then(
+          CadenzaService.createUniqueMetaTask(
+            "Gather actor registration",
+            () => true
+          ).emits("meta.sync_controller.synced_actors")
+        )
+      )
+    );
+    this.registerActorTaskMapTask = CadenzaService.createMetaTask(
+      "Split actor task maps",
+      function* (ctx) {
+        const task = ctx.task;
+        if (task.hidden || !task.register) {
+          return;
+        }
+        const metadata = getActorTaskRuntimeMetadata(task.taskFunction);
+        if (!metadata?.actorName) {
+          return;
+        }
+        const registrationKey = `${metadata.actorName}|${task.name}|${task.version}|${CadenzaService.serviceRegistry.serviceName}`;
+        if (this.registeredActorTaskMaps.has(registrationKey)) {
+          return;
+        }
+        yield {
+          data: {
+            actor_name: metadata.actorName,
+            actor_version: 1,
+            task_name: task.name,
+            task_version: task.version,
+            service_name: CadenzaService.serviceRegistry.serviceName,
+            mode: metadata.mode,
+            description: task.description ?? metadata.actorDescription ?? "",
+            is_meta: metadata.actorKind === "meta" || task.isMeta === true
+          },
+          __actorTaskMapRegistrationKey: registrationKey
+        };
+      }.bind(this)
+    ).then(
+      (this.isCadenzaDBReady ? CadenzaService.createCadenzaDBInsertTask(
+        "actor_task_map",
+        {
+          onConflict: {
+            target: [
+              "actor_name",
+              "actor_version",
+              "task_name",
+              "task_version",
+              "service_name"
+            ],
+            action: {
+              do: "nothing"
+            }
+          }
+        },
+        { concurrency: 30 }
+      ) : CadenzaService.get("dbInsertActorTaskMap"))?.then(
+        CadenzaService.createMetaTask("Record actor task map registration", (ctx) => {
+          if (!ctx.__syncing) {
+            return;
+          }
+          CadenzaService.debounce("meta.sync_controller.synced_resource", {
+            delayMs: 3e3
+          });
+          this.registeredActorTaskMaps.add(ctx.__actorTaskMapRegistrationKey);
+        })
+      )
+    );
     const registerSignalTask = CadenzaService.createMetaTask(
       "Record signal registration",
       (ctx) => {
@@ -7211,12 +7396,19 @@ var GraphSyncController = class _GraphSyncController {
     ).then(this.splitSignalsTask);
     CadenzaService.registry.getAllTasks.clone().doOn("meta.sync_controller.synced_signals").then(this.splitTasksForRegistration);
     CadenzaService.registry.getAllRoutines.clone().doOn("meta.sync_controller.synced_tasks").then(this.splitRoutinesTask);
+    CadenzaService.createMetaTask("Get all actors", (ctx) => {
+      return {
+        ...ctx,
+        actors: CadenzaService.getAllActors()
+      };
+    }).doOn("meta.sync_controller.synced_tasks").then(this.splitActorsForRegistration);
     CadenzaService.registry.doForEachTask.clone().doOn("meta.sync_controller.synced_tasks").then(
       this.registerTaskMapTask,
       this.registerSignalToTaskMapTask,
       this.registerIntentToTaskMapTask,
       this.registerDeputyRelationshipTask
     );
+    CadenzaService.registry.doForEachTask.clone().doOn("meta.sync_controller.synced_tasks", "meta.sync_controller.synced_actors").then(this.registerActorTaskMapTask);
     CadenzaService.registry.getAllRoutines.clone().doOn("meta.sync_controller.synced_routines").then(this.splitTasksInRoutines);
     CadenzaService.createMetaTask("Finish sync", (ctx, emit) => {
       emit("global.meta.sync_controller.synced", {
@@ -7603,6 +7795,14 @@ var CadenzaService = class {
   static get(taskName) {
     return import_core3.default.get(taskName);
   }
+  static getActor(actorName) {
+    const cadenzaWithActors = import_core3.default;
+    return cadenzaWithActors.getActor?.(actorName);
+  }
+  static getAllActors() {
+    const cadenzaWithActors = import_core3.default;
+    return cadenzaWithActors.getAllActors?.() ?? [];
+  }
   static getRoutine(routineName) {
     return import_core3.default.getRoutine(routineName);
   }
@@ -8170,7 +8370,7 @@ var CadenzaService = class {
   }
   static createActor(spec, options = {}) {
     this.bootstrap();
-    return new import_core3.Actor(spec, options);
+    return import_core3.default.createActor(spec, options);
   }
   static createActorFromDefinition(definition, options = {}) {
     this.bootstrap();