@memberjunction/task-graph 0.0.0 → 6.1.0-edge.2

package/dist/WorkflowSpecSync.js

@@ -0,0 +1,474 @@
+/**
+ * @fileoverview Persists a `WorkflowSpec` by **reconciling substrates that already exist**.
+ *
+ * **The central design constraint: no new storage.** There is no `Workflow` table and there will not
+ * be one. A workflow's WHAT is a Flow agent (the graph); its WHEN is a Scheduled Job or an Entity
+ * Action binding. Inventing a parallel `Workflow` row would create a second definition of "a
+ * scheduled thing", and the scheduler would then have two masters that can disagree — which is
+ * exactly the class of divergence this whole program has been removing.
+ *
+ * So this is a **reconciler**, not a writer. It follows the pattern
+ * `MJRecordProcessEntityServer.Save()` already proved: resolve the job type, find the rows this
+ * definition owns, then upsert or disable them so the substrate matches the spec. Rows are matched
+ * by a marker in their own `Configuration`, which is what makes ownership survive a rename.
+ *
+ * **Agent persistence crosses a seam.** Writing the Flow agent behind the graph is `AgentSpecSync`'s
+ * job — it already owns atomic multi-entity agent writes and the mutation audit. Importing it here
+ * would pull the agent-manager package into the execution substrate, so the host injects it instead.
+ * A caller with no agent writer still gets correct trigger reconciliation and an honest error rather
+ * than a half-persisted workflow.
+ *
+ * @module @memberjunction/task-graph
+ */
+import { LogError, LogStatus, RunView } from '@memberjunction/core';
+import { SafeJSONParse, UUIDsEqual } from '@memberjunction/global';
+import { BuildChangeFilterCode } from '@memberjunction/actions-base';
+import { FormatWorkflowValidationErrors, NormalizeInvocationType, NormalizeTriggers, ValidateWorkflowSpec, } from '@memberjunction/ai-core-plus';
+/**
+ * Scheduled Job Type that runs a workflow's Flow agent.
+ *
+ * `'Agent'` is an existing seeded type backed by `AgentScheduledJobDriver` — a workflow's schedule
+ * reuses it rather than introducing a parallel one. `ScheduledJobType.DriverClass` is UNIQUE, so a
+ * second type for the same driver is not merely redundant, it is impossible; discovering that is
+ * what confirmed the substrate was already there and only the authoring surface was missing.
+ */
+export const RUN_WORKFLOW_JOB_TYPE = 'Agent';
+/** Marker written into an owned row's `Configuration`, so ownership survives a rename. */
+export const WORKFLOW_OWNER_KEY = 'WorkflowAgentID';
+/**
+ * The Action an entity-change trigger dispatches to.
+ *
+ * `Execute Agent` already exists and was written for exactly this: "a concrete dispatch target for
+ * `AIAgent.ExposeAsAction`". Entity-action *invocation* is likewise already wired — the save pipeline
+ * fires validate / before-save / after-save / before-delete / after-delete through
+ * `HandleEntityActions`. So an entity-change trigger needs no new machinery at all; it needs a
+ * binding row, which is what this creates.
+ */
+export const EXECUTE_AGENT_ACTION = 'Execute Agent';
+export class WorkflowSpecSync {
+    constructor(agentWriter = null) {
+        this.agentWriter = agentWriter;
+    }
+    /**
+     * Reconciles every substrate a workflow owns, so they match the spec.
+     *
+     * Order matters: the agent is persisted first because a Scheduled Job needs its ID to point at,
+     * and a job pointing at an agent that does not exist would be a scheduled no-op — the failure
+     * mode where everything looks configured and nothing ever runs.
+     */
+    async Persist(spec, context) {
+        const validation = ValidateWorkflowSpec(spec);
+        if (!validation.Valid) {
+            const message = `Workflow "${spec?.name}" is invalid:\n${FormatWorkflowValidationErrors(validation.Errors)}`;
+            LogError(`[WorkflowSpecSync] ${message}`);
+            return { Success: false, ScheduledJobIDs: [], Unreconciled: [], ErrorMessage: message };
+        }
+        if (!this.agentWriter) {
+            const message = 'No workflow agent writer is registered on this host, so the workflow could not be saved. ' +
+                'Persisting a workflow requires the agent-authoring package to be loaded.';
+            LogError(`[WorkflowSpecSync] ${message}`);
+            return { Success: false, ScheduledJobIDs: [], Unreconciled: [], ErrorMessage: message };
+        }
+        try {
+            const agentID = await this.agentWriter.PersistFlowAgent(spec, context);
+            const { ScheduledJobIDs, Unreconciled } = await this.reconcileTriggers(spec, agentID, context);
+            LogStatus(`[WorkflowSpecSync] Saved "${spec.name}" as agent ${agentID}; ` +
+                `${ScheduledJobIDs.length} scheduled job(s) reconciled.`);
+            return { Success: true, AgentID: agentID, ScheduledJobIDs, Unreconciled };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            LogError(`[WorkflowSpecSync] Persist failed for "${spec.name}": ${message}`);
+            return { Success: false, ScheduledJobIDs: [], Unreconciled: [], ErrorMessage: message };
+        }
+    }
+    /**
+     * Brings the workflow's owned trigger rows in line with its spec.
+     *
+     * A trigger the spec no longer names has its owned row **disabled rather than deleted**. Deleting
+     * would destroy the run history attached to it, and a workflow whose schedule someone removed by
+     * mistake should be recoverable — the row carries counts, last-run and next-run that are the only
+     * record that it ever fired.
+     */
+    async reconcileTriggers(spec, agentID, context) {
+        const triggers = NormalizeTriggers(spec);
+        const schedules = triggers.filter((t) => t.type === 'Schedule');
+        const events = triggers.filter((t) => t.type === 'EntityEvent');
+        const unreconciled = [];
+        for (const event of events) {
+            try {
+                await this.reconcileEntityEvent(event, agentID, context);
+            }
+            catch (e) {
+                // Reported, never dropped: a user who asked for "run this when an invoice changes"
+                // and got a workflow that never fires has no way to discover why from the UI.
+                unreconciled.push(`EntityEvent on ${event.entityName}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        const typeID = await this.resolveJobTypeID(context);
+        const owned = await this.findOwnedJobs(typeID, agentID, context);
+        const jobIDs = [];
+        const keep = new Set();
+        for (const schedule of schedules) {
+            const key = this.scheduleKey(schedule);
+            keep.add(key);
+            const existing = owned.find((j) => this.scheduleKeyOf(j) === key) ?? null;
+            jobIDs.push(await this.upsertScheduledJob(spec, agentID, typeID, schedule, existing, context));
+        }
+        for (const job of owned) {
+            if (keep.has(this.scheduleKeyOf(job) ?? ''))
+                continue;
+            if (job.Status === 'Disabled')
+                continue;
+            job.Status = 'Disabled';
+            if (await job.Save()) {
+                jobIDs.push(job.ID);
+                LogStatus(`[WorkflowSpecSync] Disabled scheduled job ${job.ID} — its trigger is no longer in the workflow.`);
+            }
+            else {
+                LogError(`[WorkflowSpecSync] Could not disable scheduled job ${job.ID}: ${job.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+        }
+        return { ScheduledJobIDs: jobIDs, Unreconciled: unreconciled };
+    }
+    /** Identity of a schedule within a workflow — cron plus zone, matching `TriggerKey`. */
+    scheduleKey(trigger) {
+        return `${trigger.cron}|${trigger.timezone ?? ''}`;
+    }
+    /** The same identity, read back off a persisted job. */
+    scheduleKeyOf(job) {
+        return job.CronExpression ? `${job.CronExpression}|${job.Timezone ?? ''}` : null;
+    }
+    /**
+     * Binds an entity-change trigger by creating the Entity Action rows the save pipeline already
+     * reads.
+     *
+     * Nothing here teaches the platform a new trick. `HandleEntityActions` has fired entity actions
+     * from the save pipeline all along; what was missing was a row saying "when an Invoice is
+     * updated, run Execute Agent with this agent". Three rows express that: the `EntityAction`
+     * (which entity, which action), the `EntityActionInvocation` (which change fires it), and an
+     * `EntityActionParam` carrying the agent to run.
+     *
+     * Idempotent by lookup rather than by delete-and-recreate: re-saving a workflow must not detach
+     * and re-attach a live trigger, because a change landing in that window would be missed.
+     *
+     * **Scope reconciles onto the binding's own `ScopeEntityID`/`ScopeRecordID`.** Those columns and
+     * the engine's scope resolver already exist for exactly this; leaving them unset while the spec
+     * declared a scope produced a workflow firing on every record of the entity while its author
+     * believed it was watching one. `filter` reconciles the same way — onto an `ActionFilter` bound
+     * through `EntityActionFilter`, the row the invocation path already consults.
+     */
+    async reconcileEntityEvent(trigger, agentID, context) {
+        const rv = RunView.FromMetadataProvider(context.Provider);
+        const entity = context.Provider.EntityByName(trigger.entityName);
+        if (!entity)
+            throw new Error(`entity "${trigger.entityName}" not found in metadata`);
+        const scope = this.resolveScope(trigger, context);
+        const actionResult = await rv.RunView({ EntityName: 'MJ: Actions', ExtraFilter: `Name='${EXECUTE_AGENT_ACTION}'`, ResultType: 'entity_object' }, context.ContextUser);
+        const action = actionResult.Results?.[0];
+        if (!action)
+            throw new Error(`the '${EXECUTE_AGENT_ACTION}' action is not present — has the metadata seed been pushed?`);
+        // Resolved through the shared normalizer so the shorthand an author writes ("Update") and
+        // the name the platform fires ("AfterUpdate") cannot drift apart.
+        const invocationName = NormalizeInvocationType(trigger.invocationType);
+        if (!invocationName)
+            throw new Error(`invocation type "${trigger.invocationType}" is not one this platform fires`);
+        const invocationResult = await rv.RunView({
+            EntityName: 'MJ: Entity Action Invocation Types',
+            ExtraFilter: `Name='${invocationName}'`,
+            ResultType: 'entity_object',
+        }, context.ContextUser);
+        const invocationType = invocationResult.Results?.[0];
+        if (!invocationType)
+            throw new Error(`invocation type "${invocationName}" is not seeded`);
+        const entityAction = await this.upsertEntityAction(entity.ID, action.ID, agentID, scope, context);
+        await this.upsertInvocation(entityAction.ID, invocationType.ID, context);
+        // Which agent to run — fixed for the life of the binding.
+        await this.upsertActionParam(entityAction.ID, action.ID, 'AgentID', 'Static', agentID, context);
+        // WHICH RECORD changed. Without this the trigger fires and the agent has no idea what it is
+        // looking at — a workflow that runs on every invoice update knowing nothing about any
+        // invoice. `Entity Object Data` rather than `Entity Object` is not a preference: a
+        // BaseEntity serializes to `{}` because its fields are getters, not enumerable own
+        // properties, so the live instance would arrive empty. `GetAll()` is what survives the wire.
+        await this.upsertActionParam(entityAction.ID, action.ID, 'Data', 'Entity Object Data', null, context);
+        await this.reconcileTriggerFilter(entityAction.ID, trigger.filter ?? null, context);
+    }
+    /**
+     * Brings the binding's filter row in line with the trigger's predicate.
+     *
+     * The trigger's `filter` is an expression; what the platform evaluates is an `ActionFilter.Code`
+     * bound through `EntityActionFilter`. That indirection is what lets a workflow narrow *when* it
+     * fires without the workflow layer inventing an evaluator of its own — `RunSingleFilter` already
+     * compiles, caches and fail-closes this code, and the change context it hands the expression is
+     * the same one every other entity action sees.
+     *
+     * **Removing a filter disables the binding rather than deleting the row.** The `ActionFilter`
+     * survives with its code intact, so re-adding the predicate is recoverable and the audit trail of
+     * what this trigger used to be narrowed by does not evaporate on a save. A `Disabled` binding is
+     * genuinely inert — {@link EntityActionInvocationSingleRecord.ResolveFilters} skips it, which
+     * matters because filters fail closed, so a disabled-but-honored filter would not be a no-op, it
+     * would be a permanent block.
+     */
+    async reconcileTriggerFilter(entityActionID, filter, context) {
+        const rv = RunView.FromMetadataProvider(context.Provider);
+        const bindingResult = await rv.RunView({
+            EntityName: 'MJ: Entity Action Filters',
+            ExtraFilter: `EntityActionID='${entityActionID}'`,
+            OrderBy: 'Sequence ASC',
+            ResultType: 'entity_object',
+        }, context.ContextUser);
+        const binding = bindingResult.Results?.[0] ?? null;
+        const expression = filter?.trim() ?? '';
+        if (!expression) {
+            if (binding && binding.Status !== 'Disabled') {
+                binding.Status = 'Disabled';
+                if (!(await binding.Save())) {
+                    throw new Error(`could not clear the trigger's filter: ${binding.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+            }
+            return;
+        }
+        const filterRow = await this.upsertActionFilter(binding?.ActionFilterID ?? null, expression, context);
+        const row = binding
+            ?? await context.Provider.GetEntityObject('MJ: Entity Action Filters', context.ContextUser);
+        if (!binding)
+            row.NewRecord();
+        row.EntityActionID = entityActionID;
+        row.ActionFilterID = filterRow.ID;
+        row.Sequence = 1;
+        row.Status = 'Active';
+        if (!(await row.Save())) {
+            throw new Error(`could not bind the trigger's filter: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+    }
+    /**
+     * Writes the filter row holding the generated predicate.
+     *
+     * Reuses the row the binding already points at, so editing a workflow's filter edits one row
+     * rather than accumulating an orphan per save. `UserDescription` keeps the author's expression
+     * verbatim next to the generated code — without it, reading the row back tells you what the
+     * machine produced but not what the person asked for.
+     */
+    async upsertActionFilter(existingID, expression, context) {
+        const row = await context.Provider.GetEntityObject('MJ: Action Filters', context.ContextUser);
+        if (existingID) {
+            if (!(await row.Load(existingID))) {
+                // The binding pointed at a row that is gone. Falling back to a fresh row is right:
+                // the alternative is refusing to save a workflow because of a dangling reference the
+                // author never created and cannot see.
+                row.NewRecord();
+            }
+        }
+        else {
+            row.NewRecord();
+        }
+        row.Code = BuildChangeFilterCode(expression);
+        row.UserDescription = expression;
+        row.CodeExplanation =
+            'Generated from a workflow trigger filter. The expression is evaluated against the record change ' +
+                'that fired the trigger; the run proceeds only when it is true.';
+        if (!(await row.Save())) {
+            throw new Error(`could not save the trigger's filter: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        return row;
+    }
+    /**
+     * Turn the spec's scope names into the IDs the binding stores.
+     *
+     * A scope that names an entity the instance does not have is an error rather than a silent
+     * widening: "watch this one invoice" degrading to "watch every invoice" is the failure the
+     * scope columns exist to prevent.
+     */
+    resolveScope(trigger, context) {
+        if (!trigger.scopeEntityName?.trim()) {
+            return { EntityID: null, RecordID: null };
+        }
+        const scopeEntity = context.Provider.EntityByName(trigger.scopeEntityName);
+        if (!scopeEntity)
+            throw new Error(`scope entity "${trigger.scopeEntityName}" not found in metadata`);
+        return { EntityID: scopeEntity.ID, RecordID: trigger.scopeRecordID?.trim() || null };
+    }
+    /**
+     * Finds or creates the Entity Action binding this workflow needs.
+     *
+     * **Each workflow owns its own binding row.** `Execute Agent` is one shared action, so every
+     * workflow watching a given entity would otherwise land on the same `(EntityID, ActionID)` pair
+     * — and reusing that row means rewriting its `AgentID`, which silently repoints the first
+     * workflow's trigger at the second workflow's agent. Workflow A keeps looking configured, keeps
+     * showing its trigger, and never runs again.
+     *
+     * That shape was briefly impossible: `UQ_EntityAction_ActionID_EntityID`, added by the v5.37.x
+     * junction sweep, permitted one binding per (entity, action). The sweep's own stated scope was
+     * "pure junction tables ... with no other meaningful data columns", which `EntityAction` — with
+     * Status, Sequence, LoggingMode, scope columns and three owned child collections — never met.
+     * `V202608080100__v6.1.x__Drop_EntityAction_Uniqueness` removes it, which also unblocks the
+     * ordinary case of one action bound to one entity at two different events with different params.
+     *
+     * Ownership is therefore matched on the agent and the scope, not on entity + action alone.
+     */
+    async upsertEntityAction(entityID, actionID, agentID, scope, context) {
+        const existing = await this.findOwnedEntityAction(entityID, actionID, agentID, scope, context);
+        if (existing) {
+            if (existing.Status !== 'Active') {
+                existing.Status = 'Active';
+                if (!(await existing.Save())) {
+                    throw new Error(`could not reactivate the entity-action binding: ${existing.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+            }
+            return existing;
+        }
+        const row = await context.Provider.GetEntityObject('MJ: Entity Actions', context.ContextUser);
+        row.NewRecord();
+        row.EntityID = entityID;
+        row.ActionID = actionID;
+        row.ScopeEntityID = scope.EntityID;
+        row.ScopeRecordID = scope.RecordID;
+        row.Status = 'Active';
+        if (!(await row.Save())) {
+            throw new Error(`could not create the entity-action binding: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        return row;
+    }
+    /**
+     * This workflow's own binding at this scope, if it already has one.
+     *
+     * Ownership lives in the `AgentID` param rather than on the binding row, so candidates are
+     * narrowed in SQL by entity + action + scope and then matched on that param. Scope is part of
+     * the identity because narrowing a trigger to a different record is a *different* subscription,
+     * not an edit of the existing one — matching without it would silently re-point the old binding.
+     */
+    async findOwnedEntityAction(entityID, actionID, agentID, scope, context) {
+        const rv = RunView.FromMetadataProvider(context.Provider);
+        const scopeFilter = `AND ScopeEntityID ${scope.EntityID ? `= '${scope.EntityID}'` : 'IS NULL'} ` +
+            `AND ScopeRecordID ${scope.RecordID ? `= '${scope.RecordID}'` : 'IS NULL'}`;
+        const result = await rv.RunView({
+            EntityName: 'MJ: Entity Actions',
+            ExtraFilter: `EntityID='${entityID}' AND ActionID='${actionID}' ${scopeFilter}`,
+            ResultType: 'entity_object',
+        }, context.ContextUser);
+        const candidates = result.Results ?? [];
+        if (candidates.length === 0)
+            return null;
+        const params = await rv.RunView({
+            EntityName: 'MJ: Entity Action Params',
+            ExtraFilter: `ActionParam='AgentID' AND EntityActionID IN (${candidates.map((c) => `'${c.ID}'`).join(',')})`,
+            ResultType: 'entity_object',
+        }, context.ContextUser);
+        const mine = (params.Results ?? []).find((p) => p.Value != null && UUIDsEqual(p.Value, agentID));
+        return mine ? candidates.find((c) => UUIDsEqual(c.ID, mine.EntityActionID)) ?? null : null;
+    }
+    /** Finds or creates the invocation row that says which change fires the action. */
+    async upsertInvocation(entityActionID, invocationTypeID, context) {
+        const result = await RunView.FromMetadataProvider(context.Provider).RunView({
+            EntityName: 'MJ: Entity Action Invocations',
+            ExtraFilter: `EntityActionID='${entityActionID}' AND InvocationTypeID='${invocationTypeID}'`,
+            ResultType: 'entity_object',
+        }, context.ContextUser);
+        const existing = result.Results?.[0];
+        if (existing) {
+            if (existing.Status !== 'Active') {
+                existing.Status = 'Active';
+                await existing.Save();
+            }
+            return;
+        }
+        const row = await context.Provider.GetEntityObject('MJ: Entity Action Invocations', context.ContextUser);
+        row.NewRecord();
+        row.EntityActionID = entityActionID;
+        row.InvocationTypeID = invocationTypeID;
+        row.Status = 'Active';
+        if (!(await row.Save())) {
+            throw new Error(`could not create the invocation binding: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+    }
+    /**
+     * Finds or creates one Entity Action Param binding.
+     *
+     * `value` is null for value types the platform derives at invocation time (`Entity Object Data`,
+     * `Entity Object`, `Entity Field`) — for those the ValueType *is* the instruction.
+     */
+    async upsertActionParam(entityActionID, actionID, paramName, valueType, value, context) {
+        const rv = RunView.FromMetadataProvider(context.Provider);
+        const paramResult = await rv.RunView({
+            EntityName: 'MJ: Action Params',
+            ExtraFilter: `ActionID='${actionID}' AND Name='${paramName}'`,
+            ResultType: 'entity_object',
+        }, context.ContextUser);
+        const actionParam = paramResult.Results?.[0];
+        if (!actionParam) {
+            // Surfaced rather than left as a trigger that fires and does nothing useful.
+            throw new Error(`the '${EXECUTE_AGENT_ACTION}' action has no ${paramName} parameter to bind`);
+        }
+        const existingResult = await rv.RunView({
+            EntityName: 'MJ: Entity Action Params',
+            ExtraFilter: `EntityActionID='${entityActionID}' AND ActionParamID='${actionParam.ID}'`,
+            ResultType: 'entity_object',
+        }, context.ContextUser);
+        const row = existingResult.Results?.[0]
+            ?? await context.Provider.GetEntityObject('MJ: Entity Action Params', context.ContextUser);
+        if (!existingResult.Results?.[0])
+            row.NewRecord();
+        row.EntityActionID = entityActionID;
+        row.ActionParamID = actionParam.ID;
+        row.ValueType = valueType;
+        row.Value = value;
+        if (!(await row.Save())) {
+            throw new Error(`could not bind ${paramName} to the trigger: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+    }
+    async resolveJobTypeID(context) {
+        const result = await RunView.FromMetadataProvider(context.Provider).RunView({
+            EntityName: 'MJ: Scheduled Job Types',
+            ExtraFilter: `Name='${RUN_WORKFLOW_JOB_TYPE}'`,
+            Fields: ['ID'],
+            ResultType: 'simple',
+        }, context.ContextUser);
+        if (!result.Success || (result.Results?.length ?? 0) === 0) {
+            throw new Error(`Scheduled Job Type '${RUN_WORKFLOW_JOB_TYPE}' not found — has the metadata seed been pushed?`);
+        }
+        return result.Results[0].ID;
+    }
+    /**
+     * Finds the Scheduled Jobs this workflow owns.
+     *
+     * Matched on a marker inside `Configuration` rather than on name, so renaming a workflow does not
+     * orphan its schedule and leave a second one firing alongside the new row.
+     */
+    async findOwnedJobs(typeID, agentID, context) {
+        const result = await RunView.FromMetadataProvider(context.Provider).RunView({ EntityName: 'MJ: Scheduled Jobs', ExtraFilter: `JobTypeID='${typeID}'`, ResultType: 'entity_object' }, context.ContextUser);
+        if (!result.Success)
+            return [];
+        return (result.Results ?? []).filter((job) => {
+            const cfg = SafeJSONParse(job.Configuration ?? '');
+            const owner = cfg?.[WORKFLOW_OWNER_KEY];
+            return !!owner && UUIDsEqual(owner, agentID);
+        });
+    }
+    /** Creates or updates one owned Scheduled Job so it matches the trigger. */
+    async upsertScheduledJob(spec, agentID, typeID, trigger, existing, context) {
+        const job = existing ?? await context.Provider.GetEntityObject('MJ: Scheduled Jobs', context.ContextUser);
+        if (!existing) {
+            job.NewRecord();
+            if (context.ContextUser?.ID)
+                job.OwnerUserID = context.ContextUser.ID;
+        }
+        job.JobTypeID = typeID;
+        job.Name = `Workflow: ${spec.name}`;
+        job.Description = spec.description ?? null;
+        job.CronExpression = trigger.cron;
+        job.Timezone = trigger.timezone ?? null;
+        job.Configuration = JSON.stringify({ [WORKFLOW_OWNER_KEY]: agentID, AgentID: agentID });
+        // The spec's own status governs. A Draft or Paused workflow persists its schedule but does
+        // not fire — which is what lets someone build the whole thing, look at it, and then turn it on.
+        job.Status = spec.status === 'Active' ? 'Active' : 'Disabled';
+        if (spec.notifications) {
+            job.NotifyOnFailure = true;
+            job.NotifyOnSuccess = spec.notifications.condition === 'Always';
+        }
+        if (!(await job.Save())) {
+            throw new Error(`Could not save the schedule for workflow "${spec.name}": ${job.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        return job.ID;
+    }
+}
+//# sourceMappingURL=WorkflowSpecSync.js.map

package/dist/WorkflowSpecSync.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @memberjunction/task-graph — producer-agnostic submission and durable execution of
+ * dependency-ordered task graphs.
+ *
+ * Deliberately not AI-prefixed (D11): an LLM, deterministic code, or a human UI can all construct
+ * and submit a DAG. The graph semantics themselves live in the pure algorithms in
+ * `@memberjunction/ai-core-plus`, which both this dispatcher and the in-run executor consume.
+ */
+export * from './types.js';
+export * from './TaskGraphService.js';
+export * from './TaskClaimStore.js';
+export * from './DispatcherConditionEvaluator.js';
+export * from './TaskGraphDispatcher.js';
+export * from './TaskGraphSubmitterImpl.js';
+export * from './WorkflowSpecSync.js';
+export * from './operations/TaskGraphOperations.js';
+export * from './operations/WorkflowDraftOperation.js';
+export * from './operations/WorkflowOperations.js';
+//# 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":"AAAA;;;;;;;GAOG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @memberjunction/task-graph — producer-agnostic submission and durable execution of
+ * dependency-ordered task graphs.
+ *
+ * Deliberately not AI-prefixed (D11): an LLM, deterministic code, or a human UI can all construct
+ * and submit a DAG. The graph semantics themselves live in the pure algorithms in
+ * `@memberjunction/ai-core-plus`, which both this dispatcher and the in-run executor consume.
+ */
+export * from './types.js';
+export * from './TaskGraphService.js';
+export * from './TaskClaimStore.js';
+export * from './DispatcherConditionEvaluator.js';
+export * from './TaskGraphDispatcher.js';
+export * from './TaskGraphSubmitterImpl.js';
+export * from './WorkflowSpecSync.js';
+export * from './operations/TaskGraphOperations.js';
+export * from './operations/WorkflowDraftOperation.js';
+export * from './operations/WorkflowOperations.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC"}

package/dist/operations/TaskGraphOperations.d.ts

@@ -0,0 +1,39 @@
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { TaskGraphSubmitOperation, TaskGraphCancelOperation, TaskGraphRetryTaskOperation, TaskGraphGetStatusOperation, type TaskGraphSubmitInput, type TaskGraphSubmitOutput, type TaskGraphControlInput, type TaskGraphControlOutput, type TaskGraphRetryInput, type TaskGraphStatusOutput } from '@memberjunction/core-entities';
+/**
+ * `TaskGraph.Submit` — validate and durably persist a graph, returning immediately.
+ *
+ * Returning before execution is the point: the caller is freed the moment the work is safe, and the
+ * dispatcher owns it from there. That is what lets an agent submit a graph over MCP without holding
+ * anything open.
+ */
+export declare class TaskGraphSubmitServerOperation extends TaskGraphSubmitOperation {
+    protected InternalExecute(input: TaskGraphSubmitInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphSubmitOutput>;
+}
+/** `TaskGraph.Cancel` — cancel a graph and every task in it that has not already settled. */
+export declare class TaskGraphCancelServerOperation extends TaskGraphCancelOperation {
+    protected InternalExecute(input: TaskGraphControlInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphControlOutput>;
+}
+/**
+ * `TaskGraph.RetryTask` — return a failed task to `Pending` and unblock its dependents.
+ *
+ * Unblocking is not optional: retrying a task while its dependents remain `Blocked` leaves the graph
+ * exactly as stuck as before, because nothing downstream ever becomes eligible again.
+ */
+export declare class TaskGraphRetryTaskServerOperation extends TaskGraphRetryTaskOperation {
+    protected InternalExecute(input: TaskGraphRetryInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphControlOutput>;
+}
+/**
+ * `TaskGraph.GetStatus` — snapshot a graph's progress without waiting for anything.
+ *
+ * This is the observation half of making execution durable. Once nobody holds a request open, a
+ * caller — a client re-attaching after reload, an agent checking work it submitted, an external MCP
+ * caller — needs a way to ask "where is it?". The rollup uses the same pure algorithm the dispatcher
+ * uses, so the reported status cannot disagree with the engine's own view.
+ */
+export declare class TaskGraphGetStatusServerOperation extends TaskGraphGetStatusOperation {
+    protected InternalExecute(input: TaskGraphControlInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphStatusOutput>;
+}
+/** Prevents tree-shaking of the registered operation classes. */
+export declare function LoadTaskGraphOperations(): void;
+//# sourceMappingURL=TaskGraphOperations.d.ts.map

package/dist/operations/TaskGraphOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskGraphOperations.d.ts","sourceRoot":"","sources":["../../src/operations/TaskGraphOperations.ts"],"names":[],"mappings":"AAqBA,OAAO,EAA0B,iBAAiB,EAAW,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAEH,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC7B,MAAM,+BAA+B,CAAC;AAuCvC;;;;;;GAMG;AACH,qBACa,8BAA+B,SAAQ,wBAAwB;cACxD,eAAe,CAC3B,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,qBAAqB,CAAC;CAepC;AAED,6FAA6F;AAC7F,qBACa,8BAA+B,SAAQ,wBAAwB;cACxD,eAAe,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC;CAYrC;AAED;;;;;GAKG;AACH,qBACa,iCAAkC,SAAQ,2BAA2B;cAC9D,eAAe,CAC3B,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC;CAUrC;AAED;;;;;;;GAOG;AACH,qBACa,iCAAkC,SAAQ,2BAA2B;cAC9D,eAAe,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,qBAAqB,CAAC;CAkCpC;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,IAAI,IAAI,CAQ9C"}