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

package/dist/WorkflowSpecSync.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @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 { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { type WorkflowSpec } 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 declare const RUN_WORKFLOW_JOB_TYPE = "Agent";
+/** Marker written into an owned row's `Configuration`, so ownership survives a rename. */
+export declare 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 declare const EXECUTE_AGENT_ACTION = "Execute Agent";
+/** Everything reconciliation needs beyond the spec itself. */
+export type WorkflowSyncContext = {
+    ContextUser: UserInfo;
+    Provider: IMetadataProvider;
+};
+/**
+ * Persists the Flow agent behind a workflow's graph.
+ *
+ * Injected rather than imported so this package does not depend on the agent-manager. The host
+ * supplies an implementation backed by `AgentSpecSync`, which is the one place that writes an agent.
+ */
+export type WorkflowAgentWriter = {
+    /** Creates or updates the Flow agent for this workflow. Returns its ID. */
+    PersistFlowAgent(spec: WorkflowSpec, context: WorkflowSyncContext): Promise<string>;
+};
+export type WorkflowSyncResult = {
+    Success: boolean;
+    /** The Flow agent the workflow's graph persisted as — the handle for everything downstream. */
+    AgentID?: string;
+    /** Scheduled Jobs created, updated or disabled by this reconciliation. */
+    ScheduledJobIDs: string[];
+    /** Triggers the spec asked for that this build cannot yet reconcile, stated rather than dropped. */
+    Unreconciled: string[];
+    ErrorMessage?: string;
+};
+export declare class WorkflowSpecSync {
+    private readonly agentWriter;
+    constructor(agentWriter?: WorkflowAgentWriter | null);
+    /**
+     * 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.
+     */
+    Persist(spec: WorkflowSpec, context: WorkflowSyncContext): Promise<WorkflowSyncResult>;
+    /**
+     * 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.
+     */
+    private reconcileTriggers;
+    /** Identity of a schedule within a workflow — cron plus zone, matching `TriggerKey`. */
+    private scheduleKey;
+    /** The same identity, read back off a persisted job. */
+    private scheduleKeyOf;
+    /**
+     * 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` is refused upstream by `ValidateWorkflowSpec` for the
+     * same reason — it cannot be honored yet, so it must not be quietly accepted.
+     */
+    private reconcileEntityEvent;
+    /**
+     * 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.
+     */
+    private resolveScope;
+    /**
+     * 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.
+     */
+    private upsertEntityAction;
+    /**
+     * 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.
+     */
+    private findOwnedEntityAction;
+    /** Finds or creates the invocation row that says which change fires the action. */
+    private upsertInvocation;
+    /**
+     * 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.
+     */
+    private upsertActionParam;
+    private resolveJobTypeID;
+    /**
+     * 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.
+     */
+    private findOwnedJobs;
+    /** Creates or updates one owned Scheduled Job so it matches the trigger. */
+    private upsertScheduledJob;
+}
+//# sourceMappingURL=WorkflowSpecSync.d.ts.map

package/dist/WorkflowSpecSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowSpecSync.d.ts","sourceRoot":"","sources":["../src/WorkflowSpecSync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,iBAAiB,EAAgC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAYjG,OAAO,EAOH,KAAK,YAAY,EACpB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAUpD,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG;IAC9B,WAAW,EAAE,QAAQ,CAAC;IACtB,QAAQ,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,2EAA2E;IAC3E,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oGAAoG;IACpG,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,qBAAa,gBAAgB;IACb,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,GAAE,mBAAmB,GAAG,IAAW;IAE3E;;;;;;OAMG;IACU,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgCnG;;;;;;;OAOG;YACW,iBAAiB;IA+C/B,wFAAwF;IACxF,OAAO,CAAC,WAAW;IAInB,wDAAwD;IACxD,OAAO,CAAC,aAAa;IAIrB;;;;;;;;;;;;;;;;;;OAkBG;YACW,oBAAoB;IAiDlC;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;;;;;;;;;;;;OAiBG;YACW,kBAAkB;IA+BhC;;;;;;;OAOG;YACW,qBAAqB;IAoCnC,mFAAmF;YACrE,gBAAgB;IAgC9B;;;;;OAKG;YACW,iBAAiB;YA4CjB,gBAAgB;IAkB9B;;;;;OAKG;YACW,aAAa;IAkB3B,4EAA4E;YAC9D,kBAAkB;CAoCnC"}

package/dist/WorkflowSpecSync.js

@@ -0,0 +1,393 @@
+/**
+ * @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 { 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` is refused upstream by `ValidateWorkflowSpec` for the
+     * same reason — it cannot be honored yet, so it must not be quietly accepted.
+     */
+    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);
+    }
+    /**
+     * 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,18 @@
+/**
+ * @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/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,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @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/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,iCAAiC,CAAC"}