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

package/dist/operations/TaskGraphDebugOperations.js

@@ -0,0 +1,310 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview Remote Operation implementations for the task-graph debug/runner control plane —
+ * pause, resume, single-step, breakpoints, edge overrides, and the step-level intervention verbs.
+ *
+ * Ships per the standing rule from #3576: every task-graph control verb is a Remote Operation, so
+ * the console UI, MCP callers, and an Action wrapper all reach the same typed call site. All logic
+ * stays in `TaskGraphService`; these are thin adapters.
+ *
+ * **Registration note.** These subclasses extend `BaseRemotableOperation` directly and declare
+ * their own `OperationKey`/`ExecutionMode`/`RequiredScope`, rather than extending a CodeGen-emitted
+ * base from `@memberjunction/core-entities` the way `TaskGraphOperations.ts` does. The metadata rows
+ * for these operations ship in `metadata/remote-operations/.remote-operations.json`; once
+ * `mj sync push` + `mj codegen` have run, CodeGen emits the typed bases and a follow-up may
+ * re-parent these classes onto them — the runtime contract (ClassFactory key + metadata
+ * invokability gate) is identical either way.
+ *
+ * **Authorization.** The debug verbs write through guarded SQL, not through entity permissions, so
+ * each one gates explicitly: the caller must be the graph's recorded owner or an Owner-type user.
+ * A graph with no recorded owner fails closed for everyone but Owner-type users.
+ *
+ * @module @memberjunction/task-graph
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { BaseRemotableOperation, RunView } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { ParseTaskGraphParentMetadata, TASK_TYPE_NAME, TaskGraphService } from '../TaskGraphService.js';
+// ── shared plumbing ────────────────────────────────────────────────────────
+function submitContext(provider, user) {
+    // EnvironmentID is empty on every debug path: the graph already exists, and the service reads
+    // the field only while persisting a new one.
+    return { EnvironmentID: '', ConversationDetailID: null, ContextUser: user, Provider: provider };
+}
+/**
+ * The caller must be the graph's recorded owner, or an Owner-type user.
+ *
+ * Explicit here because the debug verbs write through guarded SQL rather than entity saves, so
+ * entity permissions never see them. Fails closed: a graph with no recorded owner (submitted before
+ * ownership stamping) is controllable only by Owner-type users.
+ */
+async function authorizeGraphControl(parentTaskID, provider, user) {
+    if (user.Type?.trim().toLowerCase() === 'owner')
+        return null;
+    const parent = await provider.GetEntityObject('MJ: Tasks', user);
+    if (!(await parent.Load(parentTaskID)))
+        return 'No such workflow run.';
+    const owner = ParseTaskGraphParentMetadata(parent.InputPayload).submittedByUserID;
+    if (!owner || !UUIDsEqual(owner, user.ID)) {
+        return 'Only the workflow run\'s owner can control it.';
+    }
+    return null;
+}
+/**
+ * Resolves a child task's graph, so task-scoped verbs authorize against the same owner.
+ *
+ * **Proves the parent is a WORKFLOW graph, not merely that the task has one.** `MJ: Tasks` holds
+ * conversation tasks and users' personal to-dos alongside workflow steps, and both of those can be
+ * parented too — so "has a ParentID" is not "is a step of a workflow run". Without the type check
+ * the ownership gate below is the only thing standing between these verbs and any parented row in
+ * the table, and for an Owner-type caller that gate returns before loading anything. The guarded
+ * statements carry the same discriminator as a second layer; this is the first.
+ */
+async function graphOfTask(taskID, provider, user) {
+    const task = await provider.GetEntityObject('MJ: Tasks', user);
+    if (!(await task.Load(taskID)))
+        return { error: 'No such step.' };
+    if (!task.ParentID)
+        return { error: 'That task is not a step of a workflow run.' };
+    const parent = await provider.GetEntityObject('MJ: Tasks', user);
+    if (!(await parent.Load(task.ParentID)))
+        return { error: 'That step\'s workflow run could not be read.' };
+    const workflowTypeID = await resolveWorkflowTaskTypeID(provider, user);
+    if (!workflowTypeID || !UUIDsEqual(parent.TypeID ?? '', workflowTypeID)) {
+        return { error: 'That task is not a step of a workflow run.' };
+    }
+    return { parentTaskID: task.ParentID };
+}
+/**
+ * The `AI Workflow` task type's ID, or null when the row does not exist.
+ *
+ * Read rather than created: these verbs act on graphs that already exist, so an absent type row
+ * means there are no workflow graphs to act on — minting one from a debug verb would be a write on
+ * a read path, and would make the check it feeds vacuously pass.
+ */
+async function resolveWorkflowTaskTypeID(provider, user) {
+    const result = await RunView.FromMetadataProvider(provider).RunView({
+        EntityName: 'MJ: Task Types',
+        ExtraFilter: `Name='${TASK_TYPE_NAME}'`,
+        Fields: ['ID'],
+        ResultType: 'simple',
+        MaxRows: 1,
+    }, user);
+    return result.Success ? (result.Results?.[0]?.ID ?? null) : null;
+}
+function failed(errorMessage) {
+    return { success: false, errorMessage };
+}
+// ── the verbs ──────────────────────────────────────────────────────────────
+/** `TaskGraph.Pause` — nothing new starts; in-flight steps finish and their completions land. */
+let TaskGraphPauseServerOperation = class TaskGraphPauseServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.Pause';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.parentTaskID)
+            throw new Error('parentTaskID is required');
+        const denied = await authorizeGraphControl(input.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const result = await new TaskGraphService().PauseGraph(input.parentTaskID, submitContext(provider, user), user.ID);
+        return { success: result.Success, debug: result.Debug, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphPauseServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.Pause')
+], TaskGraphPauseServerOperation);
+export { TaskGraphPauseServerOperation };
+/** `TaskGraph.Resume` — claiming continues; breakpoints and overrides survive. */
+let TaskGraphResumeServerOperation = class TaskGraphResumeServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.Resume';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.parentTaskID)
+            throw new Error('parentTaskID is required');
+        const denied = await authorizeGraphControl(input.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const result = await new TaskGraphService().ResumeGraph(input.parentTaskID, submitContext(provider, user));
+        return { success: result.Success, debug: result.Debug, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphResumeServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.Resume')
+], TaskGraphResumeServerOperation);
+export { TaskGraphResumeServerOperation };
+/** `TaskGraph.Step` — arm a one-shot claim allowance on a paused workflow. */
+let TaskGraphStepServerOperation = class TaskGraphStepServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.Step';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.parentTaskID)
+            throw new Error('parentTaskID is required');
+        const denied = await authorizeGraphControl(input.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const target = input.target === 'wave' || input.target === 'one'
+            ? input.target
+            : input.target ? input.target : 'one';
+        const result = await new TaskGraphService().StepGraph(input.parentTaskID, target, submitContext(provider, user));
+        return { success: result.Success, debug: result.Debug, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphStepServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.Step')
+], TaskGraphStepServerOperation);
+export { TaskGraphStepServerOperation };
+/** `TaskGraph.SetBreakpoints` — replace the workflow's breakpoint set. */
+let TaskGraphSetBreakpointsServerOperation = class TaskGraphSetBreakpointsServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.SetBreakpoints';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.parentTaskID)
+            throw new Error('parentTaskID is required');
+        if (!Array.isArray(input.taskIDs))
+            throw new Error('taskIDs is required (empty array clears)');
+        const denied = await authorizeGraphControl(input.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const result = await new TaskGraphService().SetBreakpoints(input.parentTaskID, input.taskIDs, submitContext(provider, user));
+        return { success: result.Success, debug: result.Debug, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphSetBreakpointsServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.SetBreakpoints')
+], TaskGraphSetBreakpointsServerOperation);
+export { TaskGraphSetBreakpointsServerOperation };
+/** `TaskGraph.OverrideEdge` — answer a path the engine cannot decide (or decided wrongly). */
+let TaskGraphOverrideEdgeServerOperation = class TaskGraphOverrideEdgeServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.OverrideEdge';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.parentTaskID)
+            throw new Error('parentTaskID is required');
+        if (!input?.edgeID)
+            throw new Error('edgeID is required');
+        const denied = await authorizeGraphControl(input.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const verdict = input.verdict === 'true' || input.verdict === 'false' ? input.verdict : null;
+        const result = await new TaskGraphService().SetEdgeOverride(input.parentTaskID, input.edgeID, verdict, submitContext(provider, user));
+        return { success: result.Success, debug: result.Debug, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphOverrideEdgeServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.OverrideEdge')
+], TaskGraphOverrideEdgeServerOperation);
+export { TaskGraphOverrideEdgeServerOperation };
+/** `TaskGraph.SkipTask` — declare a Pending step not-taken; dependents proceed. */
+let TaskGraphSkipTaskServerOperation = class TaskGraphSkipTaskServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.SkipTask';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.taskID)
+            throw new Error('taskID is required');
+        const graph = await graphOfTask(input.taskID, provider, user);
+        if ('error' in graph)
+            return failed(graph.error);
+        const denied = await authorizeGraphControl(graph.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const result = await new TaskGraphService().SkipTask(input.taskID, submitContext(provider, user));
+        return { success: result.Success, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphSkipTaskServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.SkipTask')
+], TaskGraphSkipTaskServerOperation);
+export { TaskGraphSkipTaskServerOperation };
+/** `TaskGraph.ForceCompleteTask` — mark a wedged or externally-resolved step Complete with a supplied output. */
+let TaskGraphForceCompleteTaskServerOperation = class TaskGraphForceCompleteTaskServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.ForceCompleteTask';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.taskID)
+            throw new Error('taskID is required');
+        const graph = await graphOfTask(input.taskID, provider, user);
+        if ('error' in graph)
+            return failed(graph.error);
+        const denied = await authorizeGraphControl(graph.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const result = await new TaskGraphService().ForceCompleteTask(input.taskID, input.payload ?? null, submitContext(provider, user));
+        return { success: result.Success, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphForceCompleteTaskServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.ForceCompleteTask')
+], TaskGraphForceCompleteTaskServerOperation);
+export { TaskGraphForceCompleteTaskServerOperation };
+/** `TaskGraph.UpdateTaskInput` — replace a Pending step's input before stepping it. */
+let TaskGraphUpdateTaskInputServerOperation = class TaskGraphUpdateTaskInputServerOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'TaskGraph.UpdateTaskInput';
+        this.ExecutionMode = 'Sync';
+        this.RequiredScope = 'taskgraph:execute';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!input?.taskID)
+            throw new Error('taskID is required');
+        if (input.payload === undefined)
+            throw new Error('payload is required');
+        const graph = await graphOfTask(input.taskID, provider, user);
+        if ('error' in graph)
+            return failed(graph.error);
+        const denied = await authorizeGraphControl(graph.parentTaskID, provider, user);
+        if (denied)
+            return failed(denied);
+        const result = await new TaskGraphService().UpdateTaskInput(input.taskID, input.payload, submitContext(provider, user));
+        return { success: result.Success, errorMessage: result.ErrorMessage };
+    }
+};
+TaskGraphUpdateTaskInputServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'TaskGraph.UpdateTaskInput')
+], TaskGraphUpdateTaskInputServerOperation);
+export { TaskGraphUpdateTaskInputServerOperation };
+/** Prevents tree-shaking of the registered operation classes. */
+export function LoadTaskGraphDebugOperations() {
+    void TaskGraphPauseServerOperation;
+    void TaskGraphResumeServerOperation;
+    void TaskGraphStepServerOperation;
+    void TaskGraphSetBreakpointsServerOperation;
+    void TaskGraphOverrideEdgeServerOperation;
+    void TaskGraphSkipTaskServerOperation;
+    void TaskGraphForceCompleteTaskServerOperation;
+    void TaskGraphUpdateTaskInputServerOperation;
+}
+//# sourceMappingURL=TaskGraphDebugOperations.js.map

package/dist/operations/TaskGraphDebugOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskGraphDebugOperations.js","sourceRoot":"","sources":["../../src/operations/TaskGraphDebugOperations.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAqB,OAAO,EAAY,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,4BAA4B,EAAE,cAAc,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAmD7H,8EAA8E;AAE9E,SAAS,aAAa,CAAC,QAA2B,EAAE,IAAc;IAC9D,8FAA8F;IAC9F,6CAA6C;IAC7C,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACpG,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,qBAAqB,CAChC,YAAoB,EACpB,QAA2B,EAC3B,IAAc;IAEd,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAe,WAAW,EAAE,IAAI,CAAC,CAAC;IAC/E,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAAE,OAAO,uBAAuB,CAAC;IACvE,MAAM,KAAK,GAAG,4BAA4B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CAAC;IAClF,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,OAAO,gDAAgD,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,WAAW,CACtB,MAAc,EACd,QAA2B,EAC3B,IAAc;IAEd,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAe,WAAW,EAAE,IAAI,CAAC,CAAC;IAC7E,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAClE,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;IAEnF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAe,WAAW,EAAE,IAAI,CAAC,CAAC;IAC/E,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;IAC1G,MAAM,cAAc,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvE,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,yBAAyB,CAAC,QAA2B,EAAE,IAAc;IAChF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAC/D;QACI,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,SAAS,cAAc,GAAG;QACvC,MAAM,EAAE,CAAC,IAAI,CAAC;QACd,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,CAAC;KACb,EACD,IAAI,CACP,CAAC;IACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC;AAED,SAAS,MAAM,CAAC,YAAoB;IAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAE9E,iGAAiG;AAE1F,IAAM,6BAA6B,GAAnC,MAAM,6BAA8B,SAAQ,sBAAwE;IAApH;;QACa,iBAAY,GAAG,iBAAiB,CAAC;QACjC,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IASxD,CAAC;IAPa,KAAK,CAAC,eAAe,CAAC,KAA0B,EAAE,QAA2B,EAAE,IAAc;QACnG,IAAI,CAAC,KAAK,EAAE,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/F,CAAC;CACJ,CAAA;AAZY,6BAA6B;IADzC,aAAa,CAAC,sBAAsB,EAAE,iBAAiB,CAAC;GAC5C,6BAA6B,CAYzC;;AAED,kFAAkF;AAE3E,IAAM,8BAA8B,GAApC,MAAM,8BAA+B,SAAQ,sBAAwE;IAArH;;QACa,iBAAY,GAAG,kBAAkB,CAAC;QAClC,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IASxD,CAAC;IAPa,KAAK,CAAC,eAAe,CAAC,KAA0B,EAAE,QAA2B,EAAE,IAAc;QACnG,IAAI,CAAC,KAAK,EAAE,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3G,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/F,CAAC;CACJ,CAAA;AAZY,8BAA8B;IAD1C,aAAa,CAAC,sBAAsB,EAAE,kBAAkB,CAAC;GAC7C,8BAA8B,CAY1C;;AAED,8EAA8E;AAEvE,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,sBAAuE;IAAlH;;QACa,iBAAY,GAAG,gBAAgB,CAAC;QAChC,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IAYxD,CAAC;IAVa,KAAK,CAAC,eAAe,CAAC,KAAyB,EAAE,QAA2B,EAAE,IAAc;QAClG,IAAI,CAAC,KAAK,EAAE,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAe,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;YACxE,CAAC,CAAC,KAAK,CAAC,MAAM;YACd,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACjH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/F,CAAC;CACJ,CAAA;AAfY,4BAA4B;IADxC,aAAa,CAAC,sBAAsB,EAAE,gBAAgB,CAAC;GAC3C,4BAA4B,CAexC;;AAED,0EAA0E;AAEnE,IAAM,sCAAsC,GAA5C,MAAM,sCAAuC,SAAQ,sBAAiF;IAAtI;;QACa,iBAAY,GAAG,0BAA0B,CAAC;QAC1C,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IAUxD,CAAC;IARa,KAAK,CAAC,eAAe,CAAC,KAAmC,EAAE,QAA2B,EAAE,IAAc;QAC5G,IAAI,CAAC,KAAK,EAAE,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7H,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/F,CAAC;CACJ,CAAA;AAbY,sCAAsC;IADlD,aAAa,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;GACrD,sCAAsC,CAalD;;AAED,8FAA8F;AAEvF,IAAM,oCAAoC,GAA1C,MAAM,oCAAqC,SAAQ,sBAA+E;IAAlI;;QACa,iBAAY,GAAG,wBAAwB,CAAC;QACxC,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IAYxD,CAAC;IAVa,KAAK,CAAC,eAAe,CAAC,KAAiC,EAAE,QAA2B,EAAE,IAAc;QAC1G,IAAI,CAAC,KAAK,EAAE,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,OAAO,GACT,KAAK,CAAC,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACtI,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/F,CAAC;CACJ,CAAA;AAfY,oCAAoC;IADhD,aAAa,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;GACnD,oCAAoC,CAehD;;AAED,mFAAmF;AAE5E,IAAM,gCAAgC,GAAtC,MAAM,gCAAiC,SAAQ,sBAAmF;IAAlI;;QACa,iBAAY,GAAG,oBAAoB,CAAC;QACpC,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IAWxD,CAAC;IATa,KAAK,CAAC,eAAe,CAAC,KAAqC,EAAE,QAA2B,EAAE,IAAc;QAC9G,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,OAAO,IAAI,KAAK;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAClG,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC1E,CAAC;CACJ,CAAA;AAdY,gCAAgC;IAD5C,aAAa,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;GAC/C,gCAAgC,CAc5C;;AAED,iHAAiH;AAE1G,IAAM,yCAAyC,GAA/C,MAAM,yCAA0C,SAAQ,sBAAmF;IAA3I;;QACa,iBAAY,GAAG,6BAA6B,CAAC;QAC7C,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IAWxD,CAAC;IATa,KAAK,CAAC,eAAe,CAAC,KAAqC,EAAE,QAA2B,EAAE,IAAc;QAC9G,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,OAAO,IAAI,KAAK;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAClI,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC1E,CAAC;CACJ,CAAA;AAdY,yCAAyC;IADrD,aAAa,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;GACxD,yCAAyC,CAcrD;;AAED,uFAAuF;AAEhF,IAAM,uCAAuC,GAA7C,MAAM,uCAAwC,SAAQ,sBAAmF;IAAzI;;QACa,iBAAY,GAAG,2BAA2B,CAAC;QAC3C,kBAAa,GAAG,MAAe,CAAC;QAChC,kBAAa,GAAG,mBAAmB,CAAC;IAYxD,CAAC;IAVa,KAAK,CAAC,eAAe,CAAC,KAAqC,EAAE,QAA2B,EAAE,IAAc;QAC9G,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC1D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,OAAO,IAAI,KAAK;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACxH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IAC1E,CAAC;CACJ,CAAA;AAfY,uCAAuC;IADnD,aAAa,CAAC,sBAAsB,EAAE,2BAA2B,CAAC;GACtD,uCAAuC,CAenD;;AAED,iEAAiE;AACjE,MAAM,UAAU,4BAA4B;IACxC,KAAK,6BAA6B,CAAC;IACnC,KAAK,8BAA8B,CAAC;IACpC,KAAK,4BAA4B,CAAC;IAClC,KAAK,sCAAsC,CAAC;IAC5C,KAAK,oCAAoC,CAAC;IAC1C,KAAK,gCAAgC,CAAC;IACtC,KAAK,yCAAyC,CAAC;IAC/C,KAAK,uCAAuC,CAAC;AACjD,CAAC"}

package/dist/operations/TaskGraphOperations.d.ts

@@ -6,9 +6,25 @@ import { TaskGraphSubmitOperation, TaskGraphCancelOperation, TaskGraphRetryTaskO
  * 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.
+ *
+ * **REMAINING LIMITATION (C5/D1): a remote submission does not bind to an agent run.**
+ * `TaskGraphSubmitContext` carries `AgentRunID`, and this input deliberately has no field for it —
+ * whether a remote caller's graph should BIND to an agent run (cost rollup, `reinvoke` routing) is
+ * the D1 execution-identity design question, to be decided rather than defaulted. Until then a
+ * remote submission records `submittedByAgentRunID: null`: no cost rollup, and `reinvoke` degrades
+ * to a message. The other two fields the in-process path carries DO ride this operation now —
+ * `reinvokeDepth` (clamped; see below) so the runaway-loop cap counts remote hops, and the R3-3
+ * `invocation` envelope so `data.*`/`context.*` conditions evaluate against the invocation instead
+ * of nothing.
  */
 export declare class TaskGraphSubmitServerOperation extends TaskGraphSubmitOperation {
-    protected InternalExecute(input: TaskGraphSubmitInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphSubmitOutput>;
+    protected InternalExecute(input: TaskGraphSubmitInput & {
+        reinvokeDepth?: number;
+        invocation?: {
+            data?: unknown;
+            context?: unknown;
+        };
+    }, 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 {
@@ -21,7 +37,9 @@ export declare class TaskGraphCancelServerOperation extends TaskGraphCancelOpera
  * 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>;
+    protected InternalExecute(input: TaskGraphRetryInput & {
+        inputPayload?: Record<string, unknown> | string;
+    }, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphControlOutput>;
 }
 /**
  * `TaskGraph.GetStatus` — snapshot a graph's progress without waiting for anything.

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

@@ -1 +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"}
+{"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;AAwCvC;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,8BAA+B,SAAQ,wBAAwB;cACxD,eAAe,CAQ3B,KAAK,EAAE,oBAAoB,GAAG;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACtD,EACD,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,qBAAqB,CAAC;CAyBpC;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;CAgBrC;AAED;;;;;GAKG;AACH,qBACa,iCAAkC,SAAQ,2BAA2B;cAC9D,eAAe,CAI3B,KAAK,EAAE,mBAAmB,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;KAAE,EAChF,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,CAY9C"}

package/dist/operations/TaskGraphOperations.js

@@ -28,8 +28,9 @@ import { RegisterClass } from '@memberjunction/global';
 import { BaseRemotableOperation, RunView } from '@memberjunction/core';
 import { TaskGraphSubmitOperation, TaskGraphCancelOperation, TaskGraphRetryTaskOperation, TaskGraphGetStatusOperation, } from '@memberjunction/core-entities';
 import { ComputeParentRollup } from '@memberjunction/ai-core-plus';
-import { TaskGraphService } from '../TaskGraphService.js';
+import { ClampReinvokeDepth, TaskGraphService } from '../TaskGraphService.js';
 import { LoadWorkflowDraftOperation } from './WorkflowDraftOperation.js';
+import { LoadTaskGraphDebugOperations } from './TaskGraphDebugOperations.js';
 /**
  * Builds the service context from the operation's provider + user.
  *
@@ -51,15 +52,42 @@ function submitContext(provider, user, environmentID, conversationDetailID) {
  * 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.
+ *
+ * **REMAINING LIMITATION (C5/D1): a remote submission does not bind to an agent run.**
+ * `TaskGraphSubmitContext` carries `AgentRunID`, and this input deliberately has no field for it —
+ * whether a remote caller's graph should BIND to an agent run (cost rollup, `reinvoke` routing) is
+ * the D1 execution-identity design question, to be decided rather than defaulted. Until then a
+ * remote submission records `submittedByAgentRunID: null`: no cost rollup, and `reinvoke` degrades
+ * to a message. The other two fields the in-process path carries DO ride this operation now —
+ * `reinvokeDepth` (clamped; see below) so the runaway-loop cap counts remote hops, and the R3-3
+ * `invocation` envelope so `data.*`/`context.*` conditions evaluate against the invocation instead
+ * of nothing.
  */
 let TaskGraphSubmitServerOperation = class TaskGraphSubmitServerOperation extends TaskGraphSubmitOperation {
-    async InternalExecute(input, provider, user) {
+    async InternalExecute(
+    // Widened locally until CodeGen re-emits the base from the updated metadata row, the
+    // RetryTask precedent. Two of the three fields the in-process path carries now ride the
+    // remote one too: `reinvokeDepth`, because the runaway-loop cap is a safety bound that
+    // must count remote hops the same as local ones, and `invocation`, because a flow graph's
+    // documented `data.*`/`context.*` conditions (R3-3) are dead on arrival without it.
+    // `AgentRunID` stays deliberately absent — whether a remote caller's graph should BIND to
+    // an agent run is the D1 execution-identity design question, not a dropped field.
+    input, provider, user) {
         if (!input?.spec)
             throw new Error('spec is required');
         if (!input?.environmentID)
             throw new Error('environmentID is required');
         const spec = input.spec;
-        const result = await new TaskGraphService().Submit(spec, submitContext(provider, user, input.environmentID, input.conversationDetailID));
+        const invocation = input.invocation && (input.invocation.data !== undefined || input.invocation.context !== undefined)
+            ? { Data: input.invocation.data, Context: input.invocation.context }
+            : undefined;
+        const result = await new TaskGraphService().Submit(spec, {
+            ...submitContext(provider, user, input.environmentID, input.conversationDetailID),
+            // CLAMPED, not merely finite — see ClampReinvokeDepth: a negative caller-supplied
+            // seed would buy hops against the runaway-loop cap.
+            ReinvokeDepth: ClampReinvokeDepth(input.reinvokeDepth),
+            Invocation: invocation,
+        });
         return {
             success: result.Success,
             parentTaskID: result.ParentTaskID,
@@ -78,9 +106,12 @@ let TaskGraphCancelServerOperation = class TaskGraphCancelServerOperation extend
             throw new Error('parentTaskID is required');
         // EnvironmentID is unused on the cancel path — the graph already exists, so nothing new is
         // created that would need one.
-        const ok = await new TaskGraphService().Cancel(input.parentTaskID, submitContext(provider, user, ''));
-        if (!ok)
-            return { success: false, errorMessage: 'Cancel failed; see the server log for detail.' };
+        const result = await new TaskGraphService().Cancel(input.parentTaskID, submitContext(provider, user, ''));
+        // The verdict names what survived, so the caller can tell the user which parts of their
+        // workflow are still running rather than reporting a success the graph does not reflect.
+        if (!result.Success) {
+            return { success: false, errorMessage: result.ErrorMessage ?? 'Cancel failed; see the server log for detail.' };
+        }
         const parent = await provider.GetEntityObject('MJ: Tasks', user);
         const loaded = await parent.Load(input.parentTaskID);
         return { success: true, status: loaded ? parent.Status : undefined };
@@ -97,10 +128,14 @@ export { TaskGraphCancelServerOperation };
  * exactly as stuck as before, because nothing downstream ever becomes eligible again.
  */
 let TaskGraphRetryTaskServerOperation = class TaskGraphRetryTaskServerOperation extends TaskGraphRetryTaskOperation {
-    async InternalExecute(input, provider, user) {
+    async InternalExecute(
+    // Widened locally until CodeGen re-emits the base from the updated metadata row: the
+    // optional edited input rides the retry so an operator can correct the brief they watched
+    // fail. See the InputTypeDefinition on the `TaskGraph.RetryTask` metadata record.
+    input, provider, user) {
         if (!input?.taskID)
             throw new Error('taskID is required');
-        const ok = await new TaskGraphService().Retry(input.taskID, submitContext(provider, user, ''));
+        const ok = await new TaskGraphService().Retry(input.taskID, submitContext(provider, user, ''), input.inputPayload);
         if (!ok)
             return { success: false, errorMessage: 'Retry failed; the task may not be in a Failed state.' };
         const task = await provider.GetEntityObject('MJ: Tasks', user);
@@ -164,5 +199,9 @@ export function LoadTaskGraphOperations() {
     // Workflow authoring rides the same loader: a host that starts the dispatcher but never
     // registered these would accept a draft request and route it to the contract-only base.
     LoadWorkflowDraftOperation();
+    // The debug/runner control plane (pause, step, breakpoints, interventions) rides it too, for
+    // the same reason — a host with the dispatcher but no debug verbs would accept a console's
+    // pause request and route it to the throwing base.
+    LoadTaskGraphDebugOperations();
 }
 //# sourceMappingURL=TaskGraphOperations.js.map

package/dist/operations/TaskGraphOperations.js.map

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

package/dist/settlement-rescue.d.ts

@@ -0,0 +1,85 @@
+/** How long after settling a graph is still eligible for a normal continuation delivery. */
+export declare const UNSETTLED_SWEEP_WINDOW_HOURS = 24;
+/**
+ * How far back the ONE startup sweep looks.
+ *
+ * Wider than the steady-state window because a deployment gap is exactly the case the rescue exists
+ * for: nothing was running, so nothing swept, and the graphs stranded by whatever took the process
+ * down are older than a day by the time it returns. Runs once at `Start()`, so the cost of the wider
+ * scan is paid once per process, not once per poll.
+ */
+export declare const UNSETTLED_STARTUP_WINDOW_HOURS: number;
+/**
+ * How long a settled graph waits for its submitting run to park before giving up on it.
+ *
+ * `BaseAgent.finalizeAgentRun` parks the run within moments of the graph becoming dispatchable, so
+ * the honest window is seconds; anything beyond this means the submitting process is gone. Generous
+ * enough that a loaded machine does not trip it, short enough that a dead submitter cannot hold a
+ * completed workflow's announcement hostage for a day.
+ */
+export declare const SUBMITTER_PARK_GRACE_MS: number;
+/**
+ * Whether this pass's writes to the submitting run will mean anything yet.
+ *
+ * **The `Running` case is the whole point.** A graph can settle before the run that submitted it has
+ * parked at all: `finalizeAgentRun` sets `Paused` *after* the graph is durable and dispatchable, so
+ * a fast graph finishes first. Both of the settled branch's writes then land wrong — the lifecycle
+ * write silently returns (its guard is `Status === 'Paused'`), and the cost write is overwritten
+ * moments later by finalize's own full-row save carrying the nulls it held before the dispatcher
+ * wrote anything. Neither failure is visible, and the pass then claims the delivery marker, making
+ * itself the last pass ever to look at the graph. The run stays `Paused` forever.
+ *
+ * Every other status proceeds: `Paused` is the case settlement exists for, and a run already
+ * `Completed`/`Failed`/`Cancelled` reached that for its own reasons — the lifecycle write's own
+ * guard declines it, which is correct, and delivery should not be held up by it.
+ *
+ * **Bounded, because "not parked yet" and "the submitter died before parking" look identical from
+ * here.** Waiting forever on the second loses the outcome of work that actually completed, which is
+ * strictly worse than announcing it late — so past the grace period the caller proceeds and says
+ * why. The run stays `Running`, which is visibly wrong and belongs to whatever reconciles abandoned
+ * runs, not to the graph that finished correctly.
+ *
+ * @param settledForMs how long ago the graph reached its terminal status
+ */
+export declare function IsSubmittingRunReady(runStatus: string, settledForMs: number, graceMs?: number): boolean;
+/** The shape the third sweep arm selects — everything needed to judge "settled but undelivered". */
+export type UnsettledCandidate = {
+    ID: string | null;
+    InputPayload: string | null;
+};
+/**
+ * The oldest `__mj_UpdatedAt` still worth rescuing, as an ISO string for the SQL filter.
+ *
+ * The bound is on ABANDONMENT, not age: `__mj_UpdatedAt` advances on every settle attempt, so a
+ * graph something is still actively retrying keeps re-entering the window. What ages out is a graph
+ * nothing has touched — which is the only kind this sweep can help.
+ */
+export declare function SweepCutoff(now: Date, windowHours: number): string;
+/**
+ * Picks the graphs that reached a terminal status without delivering their continuation.
+ *
+ * Filtered here rather than in SQL because the delivery marker lives inside the parent's
+ * `InputPayload` JSON, and it lives there deliberately: one representation means the writer
+ * (`TryClaimContinuation`) and the reader are pinned to each other, and a graph settled before any
+ * of this existed is judged by the same parser as one settled after — which a new column plus a
+ * backfill could not promise.
+ *
+ * **An unreadable payload counts as undelivered.** It is selected, the claim then refuses it
+ * (`ISJSON` guard), and it is selected again next pass until it ages out of the window. That is the
+ * intended shape: we cannot prove such a graph was delivered, so we must not assume it, and the
+ * window is what keeps "cannot prove" from meaning "retry forever".
+ */
+export declare function SelectUnsettledGraphIDs(rows: readonly UnsettledCandidate[]): string[];
+/**
+ * Whether a settlement is too old to deliver as if it had just happened.
+ *
+ * A graph stranded by a crash and found days later should still settle its run and stop showing as
+ * `Paused` — but re-invoking the submitting agent on stale context, or messaging a conversation
+ * about work that finished last week, is worse than not delivering. So an expired settlement takes
+ * the same once-only claim and records itself as `expired`, which keeps the distinction visible
+ * afterwards instead of erasing it.
+ *
+ * A graph with no `CompletedAt` has not settled at all, so there is nothing to have expired.
+ */
+export declare function IsSettlementExpired(completedAt: Date | null | undefined, now: Date, windowHours?: number): boolean;
+//# sourceMappingURL=settlement-rescue.d.ts.map

package/dist/settlement-rescue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-rescue.d.ts","sourceRoot":"","sources":["../src/settlement-rescue.ts"],"names":[],"mappings":"AAoBA,4FAA4F;AAC5F,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,QAAU,CAAC;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,MAAgC,GAC1C,OAAO,CAGT;AAED,oGAAoG;AACpG,MAAM,MAAM,kBAAkB,GAAG;IAC7B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAQrF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EACpC,GAAG,EAAE,IAAI,EACT,WAAW,GAAE,MAAqC,GACnD,OAAO,CAGT"}