@fabricorg/platform-host 3.0.0 → 4.0.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { ActorType, ActionId, ActionStatus, AgentActionRoute, AgentActionRiskTier, MutationFootprint, ExecutionPrincipal, GovernanceRuntimeEvidence, PolicyOutcome, AssetEventEnvelope, ExecutionAttestation, ExternalReconciliation, PolicyObligation, PolicyObligationStatus, ActionDefinition, AdapterImplementation, FabricRuntimeServices, AgentActionPolicyEvaluator, MutationGovernanceResolver, RuntimePolicyDefinition } from '@fabricorg/platform';
+import { ActorType, ActionId, ActionStatus, AgentActionRoute, AgentActionRiskTier, MutationFootprint, ExecutionPrincipal, GovernanceRuntimeEvidence, PolicyOutcome, AssetEventEnvelope, ExecutionAttestation, ExternalReconciliation, PolicyObligation, PolicyObligationStatus, ModuleRegistry, ActionDefinition, AdapterImplementation, FabricRuntimeServices, AgentActionPolicyEvaluator, MutationGovernanceResolver, RuntimePolicyDefinition } from '@fabricorg/platform';
 
 /** Durable Host lifecycle generation, independent from the npm package version. */
 declare const PLATFORM_HOST_CONTRACT_VERSION: 2;
-type InvocationSource = "sdui" | "api" | "agent" | "worker" | "system";
+type InvocationSource = "ui" | "api" | "agent" | "worker" | "system" | (string & {});
 type NamespacedAttributes = Record<string, string>;
 interface InvocationProvenance {
     source: InvocationSource;
@@ -431,6 +431,8 @@ interface PlatformActionWorkerCycleResult {
 interface PlatformHostOptions<TDb> {
     store: PlatformHostStore<TDb>;
     authorization: PlatformHostAuthorization;
+    /** Preferred explicit catalog assembled from this runtime's Fabric modules. */
+    registry?: Pick<ModuleRegistry<TDb>, "resolveAction" | "resolvePolicy" | "resolveStateMachine">;
     /** Resolve vertical- or runtime-local actions without mutating the process-wide registry. */
     resolveAction?: (actionId: ActionId) => ActionDefinition<TDb> | undefined;
     adapters?: readonly AdapterImplementation[];

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { ActorType, ActionId, ActionStatus, AgentActionRoute, AgentActionRiskTier, MutationFootprint, ExecutionPrincipal, GovernanceRuntimeEvidence, PolicyOutcome, AssetEventEnvelope, ExecutionAttestation, ExternalReconciliation, PolicyObligation, PolicyObligationStatus, ActionDefinition, AdapterImplementation, FabricRuntimeServices, AgentActionPolicyEvaluator, MutationGovernanceResolver, RuntimePolicyDefinition } from '@fabricorg/platform';
+import { ActorType, ActionId, ActionStatus, AgentActionRoute, AgentActionRiskTier, MutationFootprint, ExecutionPrincipal, GovernanceRuntimeEvidence, PolicyOutcome, AssetEventEnvelope, ExecutionAttestation, ExternalReconciliation, PolicyObligation, PolicyObligationStatus, ModuleRegistry, ActionDefinition, AdapterImplementation, FabricRuntimeServices, AgentActionPolicyEvaluator, MutationGovernanceResolver, RuntimePolicyDefinition } from '@fabricorg/platform';
 
 /** Durable Host lifecycle generation, independent from the npm package version. */
 declare const PLATFORM_HOST_CONTRACT_VERSION: 2;
-type InvocationSource = "sdui" | "api" | "agent" | "worker" | "system";
+type InvocationSource = "ui" | "api" | "agent" | "worker" | "system" | (string & {});
 type NamespacedAttributes = Record<string, string>;
 interface InvocationProvenance {
     source: InvocationSource;
@@ -431,6 +431,8 @@ interface PlatformActionWorkerCycleResult {
 interface PlatformHostOptions<TDb> {
     store: PlatformHostStore<TDb>;
     authorization: PlatformHostAuthorization;
+    /** Preferred explicit catalog assembled from this runtime's Fabric modules. */
+    registry?: Pick<ModuleRegistry<TDb>, "resolveAction" | "resolvePolicy" | "resolveStateMachine">;
     /** Resolve vertical- or runtime-local actions without mutating the process-wide registry. */
     resolveAction?: (actionId: ActionId) => ActionDefinition<TDb> | undefined;
     adapters?: readonly AdapterImplementation[];

package/dist/index.js

@@ -1,4 +1,4 @@
-import { AdapterRegistry, resolveAction, createFabricId, assertGovernanceRuntimeEvidence, FABRIC_GOVERNANCE_CONTRACT_VERSION, assertMutationGovernanceContext, evaluatePolicyDefinitions, aggregatePolicyOutcomes, validateTransition, executeWithAdapterRetry, resolveStateMachine } from '@fabricorg/platform';
+import { AdapterRegistry, createFabricId, assertGovernanceRuntimeEvidence, FABRIC_GOVERNANCE_CONTRACT_VERSION, assertMutationGovernanceContext, evaluatePolicyDefinitions, aggregatePolicyOutcomes, validateStateMachineTransition, executeWithAdapterRetry } from '@fabricorg/platform';
 import { createHash } from 'crypto';
 
 // src/host.ts
@@ -29,10 +29,10 @@ function digestParameters(parameters) {
   return createHash("sha256").update(canonicalJson(parameters)).digest("hex");
 }
 var ATTRIBUTE_NAME = /^[a-z][a-z0-9-]*(?:\.[A-Za-z][A-Za-z0-9_-]*)+$/;
-var INVOCATION_SOURCES = /* @__PURE__ */ new Set(["sdui", "api", "agent", "worker", "system"]);
+var INVOCATION_SOURCE = /^(?:ui|sdui|api|agent|worker|system|[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)+)$/;
 function normalizeProvenance(input, options) {
   if (!input) return void 0;
-  if (!INVOCATION_SOURCES.has(input.source)) throw new Error(`Invalid invocation provenance source: ${input.source}`);
+  if (!INVOCATION_SOURCE.test(input.source)) throw new Error(`Invalid invocation provenance source: ${input.source}`);
   const maxAttributes = options?.maxAttributes ?? 16;
   const maxValueLength = options?.maxValueLength ?? 256;
   const allowlist = new Set(options?.auditAttributeAllowlist ?? []);
@@ -81,7 +81,10 @@ function createGovernedActionHost(options) {
   for (const adapter of options.adapters ?? []) adapters.register(adapter);
   const now = options.now ?? (() => /* @__PURE__ */ new Date());
   const extractEvents = options.extractEvents ?? DEFAULT_EXTRACT_EVENTS;
-  const actionResolver = options.resolveAction ?? resolveAction;
+  const configuredActionResolver = options.resolveAction ?? options.registry?.resolveAction;
+  if (!configuredActionResolver) throw new Error("Platform Host requires an explicit module registry or resolveAction function.");
+  const actionResolver = configuredActionResolver;
+  const stateMachineResolver = options.registry?.resolveStateMachine ?? (() => void 0);
   const eventResultFields = options.eventResultFields ?? ["_events"];
   async function submitAction(input) {
     if (input.executionReason && !["initial", "offline_replay"].includes(input.executionReason)) {
@@ -386,6 +389,7 @@ function createGovernedActionHost(options) {
         parameters: parsed.data,
         db: options.store.db,
         services: options.services,
+        resolveCodePolicy: options.registry?.resolvePolicy,
         mode: "execute",
         now: now()
       });
@@ -438,10 +442,11 @@ function createGovernedActionHost(options) {
           spaceId,
           binding.entityType,
           entityId
-        ) ?? initialState(binding.entityType) : initialState(binding.entityType);
+        ) ?? initialState(stateMachineResolver(binding.entityType)) : initialState(stateMachineResolver(binding.entityType));
         const targetState = typeof binding.targetState === "function" ? binding.targetState(parsed.data) : binding.targetState;
         if (targetState !== "") {
-          const transition = validateTransition(
+          const transition = validateStateMachineTransition(
+            stateMachineResolver(binding.entityType),
             binding.entityType,
             currentState,
             targetState,
@@ -927,8 +932,7 @@ function declaredPolicies(policyIds) {
     codeEvaluatorPolicyId: policyId
   }));
 }
-function initialState(entityType) {
-  const machine = resolveStateMachine(entityType);
+function initialState(machine) {
   return Object.values(machine?.states ?? {}).find((state) => state.stateClass === "initial")?.id ?? "none";
 }
 function isTerminal(status) {