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

package/dist/debug-state.d.ts

@@ -0,0 +1,102 @@
+/** What a step allowance permits: one task, the current frontier, or one named task. */
+export type StepTarget = 'one' | 'wave' | string;
+/** A user's answer for an edge whose condition they have overridden. */
+export type EdgeOverrideVerdict = 'true' | 'false';
+/**
+ * The durable debug state of one graph.
+ *
+ * Everything optional: the empty object is "no debugging", and a graph submitted before this existed
+ * parses to exactly that.
+ */
+export type TaskGraphDebugState = {
+    /** Nothing new is claimed while true. In-flight tasks finish naturally. */
+    paused?: boolean;
+    /** Who paused it — informational, for the console and the frame. */
+    pausedBy?: string | null;
+    /** Whether a person paused it or a breakpoint did. */
+    pausedReason?: 'user' | 'breakpoint';
+    /** The task whose breakpoint fired, when `pausedReason` is `'breakpoint'`. */
+    pausedAtTaskID?: string | null;
+    /** Task IDs the dispatcher pauses the graph on, before claiming them. */
+    breakpoints?: string[];
+    /**
+     * One-shot claim allowance while paused. Consumed atomically (CAS) by the instance that honors
+     * it, so two dispatchers polling the same paused graph release work exactly once.
+     */
+    step?: StepTarget;
+    /**
+     * Continue from a breakpoint: this task's breakpoint is ignored for one claim so the stopped
+     * step actually runs. Without this, Resume clears `paused` and the next poll re-hits the same
+     * still-eligible breakpoint without claiming anything — a ForEach on the last step never starts.
+     */
+    skipBreakpointTaskID?: string | null;
+    /**
+     * Authored verdicts for edges whose conditions the user has overridden, keyed by
+     * `MJ: Task Dependencies` row ID. `'false'` drops the edge (branch not taken → skip cascade);
+     * `'true'` satisfies it. The operator-grade escape hatch for a held graph — durable, so it
+     * survives restarts and is honored by every instance.
+     */
+    edgeOverrides?: Record<string, EdgeOverrideVerdict>;
+};
+/** What the claim gate decided for one graph on one pass. */
+export type ClaimGateDecision = 
+/** Not paused, no breakpoint in the eligible set — claim normally. */
+{
+    mode: 'open';
+}
+/** Paused with no step allowance — claim nothing, notify nobody. */
+ | {
+    mode: 'closed';
+}
+/**
+ * Paused with a step allowance — the caller may claim `taskIDs` this pass (after consuming the
+ * marker CAS-style; a lost consume means another instance is stepping).
+ */
+ | {
+    mode: 'step';
+    taskIDs: string[];
+}
+/**
+ * An eligible task has a breakpoint — the caller should pause the graph (CAS), announce
+ * `BreakpointHit`, and claim nothing this pass.
+ */
+ | {
+    mode: 'breakpoint';
+    taskID: string;
+};
+/**
+ * Parses a parent Task's debug state from its `InputPayload` bag.
+ *
+ * Mirrors `ParseTaskGraphParentMetadata`'s posture exactly: unparseable input is a legitimate state
+ * (a row predating this, a hand edit), and the right reading of "I don't know" is "not being
+ * debugged" — never a throw, and never a guess that could gate real work on garbage.
+ */
+export declare function ParseTaskGraphDebugState(raw: string | null | undefined): TaskGraphDebugState;
+/**
+ * Decides what the claim filter may do for one graph this pass, given its debug state and the tasks
+ * that are otherwise eligible.
+ *
+ * Pure by design — the CAS writes (consuming the step marker, pausing at the breakpoint) stay with
+ * the dispatcher, and this function only says which of them to attempt. Precedence:
+ *
+ *  1. **Paused** wins over everything, including breakpoints — a paused graph claims nothing unless
+ *     a step allowance releases work, and a breakpoint inside a paused graph is moot.
+ *  2. **Breakpoints** fire before any claim: the FIRST eligible task carrying one pauses the whole
+ *     graph, so no sibling of the breakpointed task starts either. That is what "pause here" means
+ *     on a parallel graph — the alternative (claim the siblings, hold only the one task) turns a
+ *     breakpoint into a per-task hold, which `holdTaskIDs` already is.
+ *  3. Otherwise the gate is open.
+ *
+ * A named-step target that is not currently eligible releases nothing — the allowance stays for the
+ * caller to keep or clear; stepping a task that cannot run must not release an arbitrary other one.
+ */
+export declare function DecideClaimGate(debug: TaskGraphDebugState, eligibleTaskIDs: readonly string[]): ClaimGateDecision;
+/**
+ * The verdict an edge override dictates, if one exists for this edge.
+ *
+ * Consulted BEFORE the condition is evaluated: an override exists precisely because the condition
+ * cannot be answered (or answered wrongly), so evaluating first would re-produce the hold the
+ * override exists to end.
+ */
+export declare function OverrideVerdictFor(debug: TaskGraphDebugState, edgeID: string): EdgeOverrideVerdict | undefined;
+//# sourceMappingURL=debug-state.d.ts.map

package/dist/debug-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-state.d.ts","sourceRoot":"","sources":["../src/debug-state.ts"],"names":[],"mappings":"AA0BA,wFAAwF;AACxF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,wEAAwE;AACxE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACrC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACvD,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB;AACzB,sEAAsE;AACpE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB,oEAAoE;GAClE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE;AACpB;;;GAGG;GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AACrC;;;GAGG;GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAS7C;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,mBAAmB,CAiC5F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAkBjH;AAOD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,MAAM,GACf,mBAAmB,GAAG,SAAS,CAEjC"}

package/dist/debug-state.js

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Debug/runner state for a task graph — pause, single-step, breakpoints, and edge
+ * overrides — expressed as durable, declarative state the dispatcher's claim filter consults.
+ *
+ * **Why state, not hooks.** The dispatcher is multi-instance and survives restarts; a callback
+ * registered in one process gates nothing on the peer that actually wins a claim, and dies with the
+ * process. A flag on the parent row gates every instance uniformly, works when "start paused" is set
+ * before any dispatcher has seen the graph, and holds across a deploy. The debugger and the
+ * dispatcher never talk directly — they rendezvous on the row, which is this engine's native
+ * coordination idiom (the claim protocol itself is nothing but CAS'd shared state).
+ *
+ * **Why every control is a gate on CLAIMING, never on running.** A claimed task can never be
+ * interrupted mid-flight anyway — only the next claim can be prevented. So `paused` means "nothing
+ * new starts; in-flight work finishes and its completions land", a breakpoint is an authored hold
+ * (the exact mechanism `holdTaskIDs` already implements for unevaluable conditions, driven by user
+ * intent instead of a broken guard), and `step` is a one-shot claim allowance consumed CAS-style so
+ * exactly one instance honors it.
+ *
+ * The state lives under `$.debug` in the parent Task's `InputPayload` bag, beside the continuation
+ * marker, and is written only through `TaskClaimStore`'s guarded `JSON_MODIFY` statements — the same
+ * two-writer discipline that protects the marker.
+ *
+ * @module @memberjunction/task-graph
+ */
+import { UUIDsEqual } from '@memberjunction/global';
+const UUID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** True for values JSON round-trips or hand edits commonly produce for a boolean. */
+function readBool(value) {
+    return value === true || value === 'true';
+}
+/**
+ * Parses a parent Task's debug state from its `InputPayload` bag.
+ *
+ * Mirrors `ParseTaskGraphParentMetadata`'s posture exactly: unparseable input is a legitimate state
+ * (a row predating this, a hand edit), and the right reading of "I don't know" is "not being
+ * debugged" — never a throw, and never a guess that could gate real work on garbage.
+ */
+export function ParseTaskGraphDebugState(raw) {
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        const debug = parsed && typeof parsed === 'object' ? parsed.debug : undefined;
+        if (!debug || typeof debug !== 'object')
+            return {};
+        const d = debug;
+        const state = {};
+        if (readBool(d.paused))
+            state.paused = true;
+        if (typeof d.pausedBy === 'string')
+            state.pausedBy = d.pausedBy;
+        if (d.pausedReason === 'user' || d.pausedReason === 'breakpoint')
+            state.pausedReason = d.pausedReason;
+        if (typeof d.pausedAtTaskID === 'string')
+            state.pausedAtTaskID = d.pausedAtTaskID;
+        if (typeof d.skipBreakpointTaskID === 'string')
+            state.skipBreakpointTaskID = d.skipBreakpointTaskID;
+        if (Array.isArray(d.breakpoints)) {
+            const ids = d.breakpoints.filter((b) => typeof b === 'string' && UUID_SHAPE.test(b));
+            if (ids.length > 0)
+                state.breakpoints = ids;
+        }
+        if (d.step === 'one' || d.step === 'wave' || (typeof d.step === 'string' && UUID_SHAPE.test(d.step))) {
+            state.step = d.step;
+        }
+        if (d.edgeOverrides && typeof d.edgeOverrides === 'object') {
+            const overrides = {};
+            for (const [edgeID, verdict] of Object.entries(d.edgeOverrides)) {
+                if (UUID_SHAPE.test(edgeID) && (verdict === 'true' || verdict === 'false')) {
+                    overrides[edgeID] = verdict;
+                }
+            }
+            if (Object.keys(overrides).length > 0)
+                state.edgeOverrides = overrides;
+        }
+        return state;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Decides what the claim filter may do for one graph this pass, given its debug state and the tasks
+ * that are otherwise eligible.
+ *
+ * Pure by design — the CAS writes (consuming the step marker, pausing at the breakpoint) stay with
+ * the dispatcher, and this function only says which of them to attempt. Precedence:
+ *
+ *  1. **Paused** wins over everything, including breakpoints — a paused graph claims nothing unless
+ *     a step allowance releases work, and a breakpoint inside a paused graph is moot.
+ *  2. **Breakpoints** fire before any claim: the FIRST eligible task carrying one pauses the whole
+ *     graph, so no sibling of the breakpointed task starts either. That is what "pause here" means
+ *     on a parallel graph — the alternative (claim the siblings, hold only the one task) turns a
+ *     breakpoint into a per-task hold, which `holdTaskIDs` already is.
+ *  3. Otherwise the gate is open.
+ *
+ * A named-step target that is not currently eligible releases nothing — the allowance stays for the
+ * caller to keep or clear; stepping a task that cannot run must not release an arbitrary other one.
+ */
+export function DecideClaimGate(debug, eligibleTaskIDs) {
+    if (debug.paused) {
+        if (!debug.step)
+            return { mode: 'closed' };
+        if (debug.step === 'wave')
+            return { mode: 'step', taskIDs: [...eligibleTaskIDs] };
+        if (debug.step === 'one') {
+            return eligibleTaskIDs.length > 0 ? { mode: 'step', taskIDs: [eligibleTaskIDs[0]] } : { mode: 'closed' };
+        }
+        // A named task steps only itself, and only when it is genuinely eligible.
+        const named = eligibleTaskIDs.find((id) => UUIDsEqual(id, debug.step));
+        return named ? { mode: 'step', taskIDs: [named] } : { mode: 'closed' };
+    }
+    if (debug.breakpoints && debug.breakpoints.length > 0) {
+        const bp = eligibleTaskIDs.find((id) => isArmedBreakpoint(debug, id));
+        if (bp)
+            return { mode: 'breakpoint', taskID: bp };
+    }
+    return { mode: 'open' };
+}
+function isArmedBreakpoint(debug, taskID) {
+    if (debug.skipBreakpointTaskID && UUIDsEqual(debug.skipBreakpointTaskID, taskID))
+        return false;
+    return (debug.breakpoints ?? []).some((id) => UUIDsEqual(id, taskID));
+}
+/**
+ * The verdict an edge override dictates, if one exists for this edge.
+ *
+ * Consulted BEFORE the condition is evaluated: an override exists precisely because the condition
+ * cannot be answered (or answered wrongly), so evaluating first would re-produce the hold the
+ * override exists to end.
+ */
+export function OverrideVerdictFor(debug, edgeID) {
+    return debug.edgeOverrides?.[edgeID];
+}
+//# sourceMappingURL=debug-state.js.map

package/dist/debug-state.js.map

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

package/dist/index.d.ts

@@ -7,13 +7,19 @@
  * `@memberjunction/ai-core-plus`, which both this dispatcher and the in-run executor consume.
  */
 export * from './types.js';
+export * from './debug-state.js';
 export * from './TaskGraphService.js';
 export * from './TaskClaimStore.js';
+export * from './settlement-rescue.js';
+export * from './condition-gate.js';
+export * from './task-predicates.js';
 export * from './DispatcherConditionEvaluator.js';
 export * from './TaskGraphDispatcher.js';
+export * from './task-graph-kick.js';
 export * from './TaskGraphSubmitterImpl.js';
 export * from './WorkflowSpecSync.js';
 export * from './operations/TaskGraphOperations.js';
+export * from './operations/TaskGraphDebugOperations.js';
 export * from './operations/WorkflowDraftOperation.js';
 export * from './operations/WorkflowOperations.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -7,13 +7,19 @@
  * `@memberjunction/ai-core-plus`, which both this dispatcher and the in-run executor consume.
  */
 export * from './types.js';
+export * from './debug-state.js';
 export * from './TaskGraphService.js';
 export * from './TaskClaimStore.js';
+export * from './settlement-rescue.js';
+export * from './condition-gate.js';
+export * from './task-predicates.js';
 export * from './DispatcherConditionEvaluator.js';
 export * from './TaskGraphDispatcher.js';
+export * from './task-graph-kick.js';
 export * from './TaskGraphSubmitterImpl.js';
 export * from './WorkflowSpecSync.js';
 export * from './operations/TaskGraphOperations.js';
+export * from './operations/TaskGraphDebugOperations.js';
 export * from './operations/WorkflowDraftOperation.js';
 export * from './operations/WorkflowOperations.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC"}

package/dist/operations/TaskGraphDebugOperations.d.ts

@@ -0,0 +1,99 @@
+import { BaseRemotableOperation, IMetadataProvider, UserInfo } from '@memberjunction/core';
+import type { TaskGraphDebugState } from '../debug-state.js';
+/** Input for `TaskGraph.Pause` and `TaskGraph.Resume`. */
+export interface TaskGraphPauseInput {
+    /** Parent task ID identifying the workflow run. */
+    parentTaskID: string;
+}
+/** Input for `TaskGraph.Step`. */
+export interface TaskGraphStepInput {
+    parentTaskID: string;
+    /** `'one'` (default) releases the next eligible step, `'wave'` the current frontier, a task ID exactly that step. */
+    target?: string;
+}
+/** Input for `TaskGraph.SetBreakpoints`. */
+export interface TaskGraphSetBreakpointsInput {
+    parentTaskID: string;
+    /** The full breakpoint set — replaces what was there. Empty clears all breakpoints. */
+    taskIDs: string[];
+}
+/** Input for `TaskGraph.OverrideEdge`. */
+export interface TaskGraphOverrideEdgeInput {
+    parentTaskID: string;
+    /** The `MJ: Task Dependencies` row being answered. */
+    edgeID: string;
+    /** `'false'` = branch not taken, `'true'` = gate open, omitted/null = remove the override. */
+    verdict?: 'true' | 'false' | null;
+}
+/** Input for `TaskGraph.SkipTask`, `TaskGraph.ForceCompleteTask` and `TaskGraph.UpdateTaskInput`. */
+export interface TaskGraphTaskInterventionInput {
+    taskID: string;
+    /** ForceCompleteTask: the output downstream paths evaluate against. UpdateTaskInput: the new input. */
+    payload?: Record<string, unknown> | string | null;
+}
+/** Output of the debug control verbs — what happened and the debug state now in force. */
+export interface TaskGraphDebugControlOutput {
+    success: boolean;
+    /** The graph's debug state after the verb (pause/step/breakpoints/overrides). */
+    debug?: TaskGraphDebugState;
+    errorMessage?: string;
+}
+/** `TaskGraph.Pause` — nothing new starts; in-flight steps finish and their completions land. */
+export declare class TaskGraphPauseServerOperation extends BaseRemotableOperation<TaskGraphPauseInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.Pause";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphPauseInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** `TaskGraph.Resume` — claiming continues; breakpoints and overrides survive. */
+export declare class TaskGraphResumeServerOperation extends BaseRemotableOperation<TaskGraphPauseInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.Resume";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphPauseInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** `TaskGraph.Step` — arm a one-shot claim allowance on a paused workflow. */
+export declare class TaskGraphStepServerOperation extends BaseRemotableOperation<TaskGraphStepInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.Step";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphStepInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** `TaskGraph.SetBreakpoints` — replace the workflow's breakpoint set. */
+export declare class TaskGraphSetBreakpointsServerOperation extends BaseRemotableOperation<TaskGraphSetBreakpointsInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.SetBreakpoints";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphSetBreakpointsInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** `TaskGraph.OverrideEdge` — answer a path the engine cannot decide (or decided wrongly). */
+export declare class TaskGraphOverrideEdgeServerOperation extends BaseRemotableOperation<TaskGraphOverrideEdgeInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.OverrideEdge";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphOverrideEdgeInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** `TaskGraph.SkipTask` — declare a Pending step not-taken; dependents proceed. */
+export declare class TaskGraphSkipTaskServerOperation extends BaseRemotableOperation<TaskGraphTaskInterventionInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.SkipTask";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphTaskInterventionInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** `TaskGraph.ForceCompleteTask` — mark a wedged or externally-resolved step Complete with a supplied output. */
+export declare class TaskGraphForceCompleteTaskServerOperation extends BaseRemotableOperation<TaskGraphTaskInterventionInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.ForceCompleteTask";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphTaskInterventionInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** `TaskGraph.UpdateTaskInput` — replace a Pending step's input before stepping it. */
+export declare class TaskGraphUpdateTaskInputServerOperation extends BaseRemotableOperation<TaskGraphTaskInterventionInput, TaskGraphDebugControlOutput> {
+    readonly OperationKey = "TaskGraph.UpdateTaskInput";
+    readonly ExecutionMode: "Sync";
+    readonly RequiredScope = "taskgraph:execute";
+    protected InternalExecute(input: TaskGraphTaskInterventionInput, provider: IMetadataProvider, user: UserInfo): Promise<TaskGraphDebugControlOutput>;
+}
+/** Prevents tree-shaking of the registered operation classes. */
+export declare function LoadTaskGraphDebugOperations(): void;
+//# sourceMappingURL=TaskGraphDebugOperations.d.ts.map

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

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