@memberjunction/ai-agents 5.38.0 → 5.40.0

package/dist/agent-run-watchdog.d.ts

@@ -0,0 +1,109 @@
+import { BaseSingleton, IShutdownable } from '@memberjunction/global';
+import { DatabaseProviderBase, UserInfo } from '@memberjunction/core';
+/**
+ * Tuning for the agent-run watchdog. All durations are in their named units. Defaults are
+ * deliberately conservative: the stale threshold is many heartbeat intervals wide, so a
+ * momentarily-slow-but-alive process is never mistaken for a dead one.
+ */
+export interface AgentRunWatchdogConfig {
+    /** How often the owning process stamps a liveness heartbeat for its in-flight runs. */
+    heartbeatIntervalMs: number;
+    /** How often this process re-scans for orphaned runs (mid-life, without waiting for a restart). */
+    sweepIntervalMs: number;
+    /** A Running run whose heartbeat is older than this (or NULL with an older StartedAt) is force-failed. */
+    staleThresholdMinutes: number;
+}
+/**
+ * Process-wide watchdog that guarantees no `AIAgentRun` is left stuck in `Status='Running'`
+ * after the owning process dies (restart, crash, OOM) or its terminal-state write fails.
+ *
+ * Three cooperating mechanisms, all anchored to the **database clock** so they remain correct
+ * across multiple MJAPI instances behind a load balancer (no instance trusts its own clock):
+ *
+ * 1. **Heartbeat** — while a run is in flight, the owning process stamps `LastHeartbeatAt`
+ *    every {@link AgentRunWatchdogConfig.heartbeatIntervalMs} via {@link SP_HEARTBEAT}.
+ * 2. **Sweep** — {@link SweepOrphanedRuns} force-fails any `Running` run whose heartbeat has
+ *    gone stale, via {@link SP_SWEEP} (one atomic, set-based `UPDATE … WHERE Status='Running'
+ *    AND <stale>` inside the proc — so concurrent sweeps from multiple instances are harmless
+ *    and a run another instance is still heart-beating can't be caught mid-sweep). Run once on
+ *    boot (closes restart-orphans) and on a timer (closes mid-life orphans).
+ * 3. **Graceful shutdown** — on SIGTERM/SIGINT (via {@link ShutdownRegistry}) this process marks
+ *    the runs *it* owns `Cancelled` via {@link SP_CANCEL}, closing the deploy case instantly.
+ *
+ * Every proc filters `Status='Running'` only — `Paused` and `AwaitingFeedback` are
+ * legitimately-not-progressing states and are never touched. The watchdog accesses the DB only
+ * through these stored procedures (writes) and the base view (reads) — never the base table —
+ * so it works as the regular runtime DB user, not just the elevated CodeGen user. Proc calls are
+ * built through the provider's {@link Dialect.ProcedureCallSyntax}, so they run on SQL Server and
+ * PostgreSQL unchanged.
+ */
+export declare class AgentRunWatchdog extends BaseSingleton<AgentRunWatchdog> implements IShutdownable {
+    private _config;
+    private _trackedRuns;
+    private _provider;
+    private _contextUser;
+    private _heartbeatTimer;
+    private _sweepTimer;
+    private _registered;
+    protected constructor();
+    static get Instance(): AgentRunWatchdog;
+    readonly ShutdownName = "AgentRunWatchdog";
+    /** Overrides the default tuning. Safe to call before or after runs start tracking. */
+    Configure(config: Partial<AgentRunWatchdogConfig>): void;
+    /**
+     * Begin guarding a run. The owning agent calls this immediately after the run row is saved
+     * (so it has a stable ID). Idempotent per run ID. Capturing the provider/user lets the
+     * central heartbeat + shutdown statements run without each run re-supplying them.
+     */
+    Track(runID: string, provider: DatabaseProviderBase, contextUser: UserInfo): void;
+    /** Stop guarding a run. Optional — the periodic prune drops terminal runs automatically — but
+     *  callers may invoke it for prompt cleanup right after writing a terminal state. */
+    Untrack(runID: string): void;
+    /** Number of runs this process is currently guarding (primarily for tests/diagnostics). */
+    get TrackedCount(): number;
+    /**
+     * IShutdownable: on graceful shutdown, mark every run this process still owns as `Cancelled`
+     * (via {@link SP_CANCEL}) so it doesn't linger as a phantom `Running` row until the next sweep.
+     * Idempotent and never throws — a failed cancel just falls through to the staleness sweep later.
+     */
+    Shutdown(): Promise<void>;
+    /**
+     * Force-fail any `Running` agent run whose liveness heartbeat has gone stale (or that never
+     * beat and was started long ago), via the dedicated {@link SP_SWEEP} proc. The proc does the
+     * whole thing as one atomic, set-based `UPDATE` and returns the count, so it's safe to run on
+     * every boot and on a timer, on every instance: the predicate is staleness-based (never "fail
+     * all Running") and re-evaluated at write time, so it cannot touch a run a healthy instance is
+     * still heart-beating. Returns the number of rows failed.
+     */
+    static SweepOrphanedRuns(provider: DatabaseProviderBase, contextUser: UserInfo, config?: Partial<AgentRunWatchdogConfig>): Promise<number>;
+    /** Start the heartbeat + sweep timers and register for graceful shutdown, exactly once. */
+    private ensureStarted;
+    private stopTimers;
+    /** Stamp LastHeartbeatAt for every run this process is guarding, via {@link SP_HEARTBEAT}.
+     *  Never throws (runs on a timer); a per-run failure is logged and the rest still beat. */
+    private heartbeat;
+    /** Periodic tick: force-fail orphans, then prune any terminal runs out of the tracked set. */
+    private periodicSweep;
+    /**
+     * Drop any tracked run that is no longer `Running` so the in-memory set can't grow unbounded
+     * over a long-lived process. A single SELECT (against the base VIEW — the runtime user has no
+     * table access) of the still-running subset; the rest are pruned.
+     */
+    private pruneTerminalRuns;
+    /** Validated, lowercased UUIDs this process is guarding (for per-run proc calls). */
+    private trackedIds;
+    /**
+     * Build a single batched SQL string of one proc call per id, newline-separated, so a set of
+     * per-run writes goes to the DB as one round-trip instead of N. Each id is already a validated
+     * UUID and is quoted as a string literal before interpolation. Runs unchanged on SQL Server and
+     * PostgreSQL because the call form comes from {@link Dialect.ProcedureCallSyntax}.
+     */
+    private static buildProcBatch;
+    /** Comma-joined, quoted, validated UUID list for an `ID IN (...)` clause, or '' if none. */
+    private trackedIdList;
+    /** Schema that owns the AIAgentRun objects (for qualifying proc calls), or null if unresolved. */
+    private static schemaOf;
+    /** Fully-qualified, dialect-quoted base VIEW for AIAgentRun reads, or null if unresolved. */
+    private static viewOf;
+}
+//# sourceMappingURL=agent-run-watchdog.d.ts.map

package/dist/agent-run-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-watchdog.d.ts","sourceRoot":"","sources":["../src/agent-run-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAuB,MAAM,sBAAsB,CAAC;AAM3F;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC,uFAAuF;IACvF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mGAAmG;IACnG,eAAe,EAAE,MAAM,CAAC;IACxB,0GAA0G;IAC1G,qBAAqB,EAAE,MAAM,CAAC;CACjC;AAsBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,gBAAiB,SAAQ,aAAa,CAAC,gBAAgB,CAAE,YAAW,aAAa;IAC1F,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,WAAW,CAAS;IAE5B,SAAS;IAIT,WAAkB,QAAQ,IAAI,gBAAgB,CAE7C;IAED,SAAgB,YAAY,sBAAsB;IAElD,sFAAsF;IAC/E,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAI/D;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,WAAW,EAAE,QAAQ,GAAG,IAAI;IAUxF;yFACqF;IAC9E,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMnC,2FAA2F;IAC3F,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED;;;;OAIG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtC;;;;;;;OAOG;WACiB,iBAAiB,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,QAAQ,EACrB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IA0BlB,2FAA2F;IAC3F,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,UAAU;IAWlB;+FAC2F;YAC7E,SAAS;IAsBvB,8FAA8F;YAChF,aAAa;IAQ3B;;;;OAIG;YACW,iBAAiB;IAiC/B,qFAAqF;IACrF,OAAO,CAAC,UAAU;IAIlB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,4FAA4F;IAC5F,OAAO,CAAC,aAAa;IAIrB,kGAAkG;IAClG,OAAO,CAAC,MAAM,CAAC,QAAQ;IAKvB,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,MAAM;CAQxB"}

package/dist/agent-run-watchdog.js

@@ -0,0 +1,278 @@
+import { BaseSingleton, ShutdownRegistry } from '@memberjunction/global';
+import { LogError, LogStatus } from '@memberjunction/core';
+const DEFAULT_CONFIG = {
+    heartbeatIntervalMs: 30_000,
+    sweepIntervalMs: 5 * 60_000,
+    staleThresholdMinutes: 5,
+};
+/** Matches a canonical UUID. Tracked IDs come from provider-generated PKs, but we validate
+ *  before ever interpolating into SQL so a proc argument can never become an injection vector. */
+const UUID_RE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+/** The one MJ entity whose runs this watchdog guards. */
+const AGENT_RUN_ENTITY = 'MJ: AI Agent Runs';
+/** Dedicated maintenance stored procedures (see the watchdog sprocs migration). The runtime DB
+ *  user has EXECUTE on these + SELECT on the base view, but no direct table access — so all of
+ *  the watchdog's writes go through these procs and its reads go through the view. */
+const SP_HEARTBEAT = 'spStampAIAgentRunHeartbeat';
+const SP_SWEEP = 'spSweepStaleAIAgentRuns';
+const SP_CANCEL = 'spCancelAIAgentRun';
+/**
+ * Process-wide watchdog that guarantees no `AIAgentRun` is left stuck in `Status='Running'`
+ * after the owning process dies (restart, crash, OOM) or its terminal-state write fails.
+ *
+ * Three cooperating mechanisms, all anchored to the **database clock** so they remain correct
+ * across multiple MJAPI instances behind a load balancer (no instance trusts its own clock):
+ *
+ * 1. **Heartbeat** — while a run is in flight, the owning process stamps `LastHeartbeatAt`
+ *    every {@link AgentRunWatchdogConfig.heartbeatIntervalMs} via {@link SP_HEARTBEAT}.
+ * 2. **Sweep** — {@link SweepOrphanedRuns} force-fails any `Running` run whose heartbeat has
+ *    gone stale, via {@link SP_SWEEP} (one atomic, set-based `UPDATE … WHERE Status='Running'
+ *    AND <stale>` inside the proc — so concurrent sweeps from multiple instances are harmless
+ *    and a run another instance is still heart-beating can't be caught mid-sweep). Run once on
+ *    boot (closes restart-orphans) and on a timer (closes mid-life orphans).
+ * 3. **Graceful shutdown** — on SIGTERM/SIGINT (via {@link ShutdownRegistry}) this process marks
+ *    the runs *it* owns `Cancelled` via {@link SP_CANCEL}, closing the deploy case instantly.
+ *
+ * Every proc filters `Status='Running'` only — `Paused` and `AwaitingFeedback` are
+ * legitimately-not-progressing states and are never touched. The watchdog accesses the DB only
+ * through these stored procedures (writes) and the base view (reads) — never the base table —
+ * so it works as the regular runtime DB user, not just the elevated CodeGen user. Proc calls are
+ * built through the provider's {@link Dialect.ProcedureCallSyntax}, so they run on SQL Server and
+ * PostgreSQL unchanged.
+ */
+export class AgentRunWatchdog extends BaseSingleton {
+    constructor() {
+        super();
+        this._config = DEFAULT_CONFIG;
+        this._trackedRuns = new Set();
+        this._provider = null;
+        this._contextUser = null;
+        this._heartbeatTimer = null;
+        this._sweepTimer = null;
+        this._registered = false;
+        this.ShutdownName = 'AgentRunWatchdog';
+    }
+    static get Instance() {
+        return super.getInstance();
+    }
+    /** Overrides the default tuning. Safe to call before or after runs start tracking. */
+    Configure(config) {
+        this._config = { ...this._config, ...config };
+    }
+    /**
+     * Begin guarding a run. The owning agent calls this immediately after the run row is saved
+     * (so it has a stable ID). Idempotent per run ID. Capturing the provider/user lets the
+     * central heartbeat + shutdown statements run without each run re-supplying them.
+     */
+    Track(runID, provider, contextUser) {
+        if (!runID || !UUID_RE.test(runID)) {
+            return;
+        }
+        this._provider = provider;
+        this._contextUser = contextUser;
+        this._trackedRuns.add(runID.toLowerCase());
+        this.ensureStarted();
+    }
+    /** Stop guarding a run. Optional — the periodic prune drops terminal runs automatically — but
+     *  callers may invoke it for prompt cleanup right after writing a terminal state. */
+    Untrack(runID) {
+        if (runID) {
+            this._trackedRuns.delete(runID.toLowerCase());
+        }
+    }
+    /** Number of runs this process is currently guarding (primarily for tests/diagnostics). */
+    get TrackedCount() {
+        return this._trackedRuns.size;
+    }
+    /**
+     * IShutdownable: on graceful shutdown, mark every run this process still owns as `Cancelled`
+     * (via {@link SP_CANCEL}) so it doesn't linger as a phantom `Running` row until the next sweep.
+     * Idempotent and never throws — a failed cancel just falls through to the staleness sweep later.
+     */
+    async Shutdown() {
+        this.stopTimers();
+        const ids = this.trackedIds();
+        this._trackedRuns.clear();
+        if (!ids.length || !this._provider) {
+            return;
+        }
+        const schema = AgentRunWatchdog.schemaOf(this._provider);
+        if (!schema) {
+            return;
+        }
+        const d = this._provider.Dialect;
+        // One batched round-trip (one EXEC per id, newline-separated) rather than a call per run.
+        const sql = AgentRunWatchdog.buildProcBatch(d, schema, SP_CANCEL, ids);
+        try {
+            await this._provider.ExecuteSQL(sql, undefined, { isMutation: true, description: 'AgentRunWatchdog graceful-shutdown cancel' }, this._contextUser ?? undefined);
+        }
+        catch (err) {
+            LogError(`AgentRunWatchdog.Shutdown failed to cancel runs [${ids.join(', ')}]: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Force-fail any `Running` agent run whose liveness heartbeat has gone stale (or that never
+     * beat and was started long ago), via the dedicated {@link SP_SWEEP} proc. The proc does the
+     * whole thing as one atomic, set-based `UPDATE` and returns the count, so it's safe to run on
+     * every boot and on a timer, on every instance: the predicate is staleness-based (never "fail
+     * all Running") and re-evaluated at write time, so it cannot touch a run a healthy instance is
+     * still heart-beating. Returns the number of rows failed.
+     */
+    static async SweepOrphanedRuns(provider, contextUser, config) {
+        const threshold = config?.staleThresholdMinutes ?? DEFAULT_CONFIG.staleThresholdMinutes;
+        const schema = AgentRunWatchdog.schemaOf(provider);
+        if (!schema) {
+            LogError('AgentRunWatchdog.SweepOrphanedRuns: could not resolve the AIAgentRun schema from metadata; skipping sweep');
+            return 0;
+        }
+        const d = provider.Dialect;
+        try {
+            // The proc runs the atomic UPDATE on the DB clock and returns RunsFailed.
+            const sql = d.ProcedureCallSyntax(schema, SP_SWEEP, [String(Math.trunc(threshold))]) + ';';
+            const rows = await provider.ExecuteSQL(sql, undefined, { isMutation: true, description: 'AgentRunWatchdog stale-run sweep' }, contextUser);
+            const failCount = (Array.isArray(rows) && rows[0] && typeof rows[0].RunsFailed === 'number') ? rows[0].RunsFailed : 0;
+            if (failCount > 0) {
+                LogStatus(`[AgentRunWatchdog] Swept ${failCount} orphaned agent run(s) -> Failed (no heartbeat for >${threshold}m)`);
+            }
+            return failCount;
+        }
+        catch (err) {
+            LogError(`AgentRunWatchdog.SweepOrphanedRuns failed: ${err instanceof Error ? err.message : String(err)}`);
+            return 0;
+        }
+    }
+    // ----- internals -------------------------------------------------------------------------
+    /** Start the heartbeat + sweep timers and register for graceful shutdown, exactly once. */
+    ensureStarted() {
+        if (!this._registered) {
+            ShutdownRegistry.Instance.Register(this);
+            this._registered = true;
+        }
+        if (!this._heartbeatTimer) {
+            this._heartbeatTimer = setInterval(() => void this.heartbeat(), this._config.heartbeatIntervalMs);
+            // Don't keep the event loop alive solely for the watchdog.
+            this._heartbeatTimer.unref?.();
+        }
+        if (!this._sweepTimer) {
+            // The periodic sweep is an always-on in-process timer rather than an MJ Scheduled Job
+            // (MJ: Scheduled Jobs / SchedulingEngine) on purpose. This is a reliability floor for
+            // orphaned runs, and ScheduledJobsService is gated by `scheduledJobs.enabled` in config
+            // — moving the sweep there would silently disable it in any deployment that runs with
+            // scheduled jobs off, exactly where the safety net still needs to work. A Scheduled Job
+            // could be added on top later as an observability/audit layer (it would call the same
+            // idempotent SweepOrphanedRuns), but it must not be the only thing that runs it.
+            this._sweepTimer = setInterval(() => void this.periodicSweep(), this._config.sweepIntervalMs);
+            this._sweepTimer.unref?.();
+        }
+    }
+    stopTimers() {
+        if (this._heartbeatTimer) {
+            clearInterval(this._heartbeatTimer);
+            this._heartbeatTimer = null;
+        }
+        if (this._sweepTimer) {
+            clearInterval(this._sweepTimer);
+            this._sweepTimer = null;
+        }
+    }
+    /** Stamp LastHeartbeatAt for every run this process is guarding, via {@link SP_HEARTBEAT}.
+     *  Never throws (runs on a timer); a per-run failure is logged and the rest still beat. */
+    async heartbeat() {
+        if (!this._provider) {
+            return;
+        }
+        const ids = this.trackedIds();
+        if (!ids.length) {
+            return;
+        }
+        const schema = AgentRunWatchdog.schemaOf(this._provider);
+        if (!schema) {
+            return;
+        }
+        const d = this._provider.Dialect;
+        // One batched round-trip (one EXEC per id, newline-separated) rather than a call per run.
+        const sql = AgentRunWatchdog.buildProcBatch(d, schema, SP_HEARTBEAT, ids);
+        try {
+            await this._provider.ExecuteSQL(sql, undefined, { isMutation: true, ignoreLogging: true, description: 'AgentRunWatchdog heartbeat' }, this._contextUser ?? undefined);
+        }
+        catch (err) {
+            LogError(`AgentRunWatchdog heartbeat failed for runs [${ids.join(', ')}]: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Periodic tick: force-fail orphans, then prune any terminal runs out of the tracked set. */
+    async periodicSweep() {
+        if (!this._provider || !this._contextUser) {
+            return;
+        }
+        await AgentRunWatchdog.SweepOrphanedRuns(this._provider, this._contextUser, this._config);
+        await this.pruneTerminalRuns();
+    }
+    /**
+     * Drop any tracked run that is no longer `Running` so the in-memory set can't grow unbounded
+     * over a long-lived process. A single SELECT (against the base VIEW — the runtime user has no
+     * table access) of the still-running subset; the rest are pruned.
+     */
+    async pruneTerminalRuns() {
+        const ids = this.trackedIdList();
+        if (!ids || !this._provider) {
+            return;
+        }
+        const view = AgentRunWatchdog.viewOf(this._provider);
+        if (!view) {
+            return;
+        }
+        const d = this._provider.Dialect;
+        try {
+            const rows = await this._provider.ExecuteSQL(`SELECT ${d.QuoteIdentifier('ID')} FROM ${view} ` +
+                `WHERE ${d.QuoteIdentifier('Status')} = 'Running' AND ${d.QuoteIdentifier('ID')} IN (${ids});`, undefined, { ignoreLogging: true, description: 'AgentRunWatchdog tracked-set prune' }, this._contextUser ?? undefined);
+            const stillRunning = new Set();
+            if (Array.isArray(rows)) {
+                for (const row of rows) {
+                    if (typeof row?.ID === 'string') {
+                        stillRunning.add(row.ID.toLowerCase());
+                    }
+                }
+            }
+            for (const tracked of Array.from(this._trackedRuns)) {
+                if (!stillRunning.has(tracked)) {
+                    this._trackedRuns.delete(tracked);
+                }
+            }
+        }
+        catch (err) {
+            LogError(`AgentRunWatchdog prune failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /** Validated, lowercased UUIDs this process is guarding (for per-run proc calls). */
+    trackedIds() {
+        return Array.from(this._trackedRuns).filter(id => UUID_RE.test(id));
+    }
+    /**
+     * Build a single batched SQL string of one proc call per id, newline-separated, so a set of
+     * per-run writes goes to the DB as one round-trip instead of N. Each id is already a validated
+     * UUID and is quoted as a string literal before interpolation. Runs unchanged on SQL Server and
+     * PostgreSQL because the call form comes from {@link Dialect.ProcedureCallSyntax}.
+     */
+    static buildProcBatch(d, schema, proc, ids) {
+        return ids.map(id => d.ProcedureCallSyntax(schema, proc, [d.QuoteStringLiteral(id)]) + ';').join('\n');
+    }
+    /** Comma-joined, quoted, validated UUID list for an `ID IN (...)` clause, or '' if none. */
+    trackedIdList() {
+        return this.trackedIds().map(id => `'${id}'`).join(',');
+    }
+    /** Schema that owns the AIAgentRun objects (for qualifying proc calls), or null if unresolved. */
+    static schemaOf(provider) {
+        const entity = provider.EntityByName(AGENT_RUN_ENTITY);
+        return entity?.SchemaName || null;
+    }
+    /** Fully-qualified, dialect-quoted base VIEW for AIAgentRun reads, or null if unresolved. */
+    static viewOf(provider) {
+        const entity = provider.EntityByName(AGENT_RUN_ENTITY);
+        if (!entity || !entity.BaseView) {
+            return null;
+        }
+        const d = provider.Dialect;
+        return entity.SchemaName ? d.QuoteSchema(entity.SchemaName, entity.BaseView) : d.QuoteIdentifier(entity.BaseView);
+    }
+}
+//# sourceMappingURL=agent-run-watchdog.js.map

package/dist/agent-run-watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-watchdog.js","sourceRoot":"","sources":["../src/agent-run-watchdog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAiB,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAkC,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAoB3F,MAAM,cAAc,GAA2B;IAC3C,mBAAmB,EAAE,MAAM;IAC3B,eAAe,EAAE,CAAC,GAAG,MAAM;IAC3B,qBAAqB,EAAE,CAAC;CAC3B,CAAC;AAEF;kGACkG;AAClG,MAAM,OAAO,GAAG,+EAA+E,CAAC;AAEhG,yDAAyD;AACzD,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C;;sFAEsF;AACtF,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAClD,MAAM,QAAQ,GAAG,yBAAyB,CAAC;AAC3C,MAAM,SAAS,GAAG,oBAAoB,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,aAA+B;IASjE;QACI,KAAK,EAAE,CAAC;QATJ,YAAO,GAA2B,cAAc,CAAC;QACjD,iBAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,cAAS,GAAgC,IAAI,CAAC;QAC9C,iBAAY,GAAoB,IAAI,CAAC;QACrC,oBAAe,GAA0C,IAAI,CAAC;QAC9D,gBAAW,GAA0C,IAAI,CAAC;QAC1D,gBAAW,GAAG,KAAK,CAAC;QAUZ,iBAAY,GAAG,kBAAkB,CAAC;IANlD,CAAC;IAEM,MAAM,KAAK,QAAQ;QACtB,OAAO,KAAK,CAAC,WAAW,EAAoB,CAAC;IACjD,CAAC;IAID,sFAAsF;IAC/E,SAAS,CAAC,MAAuC;QACpD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAa,EAAE,QAA8B,EAAE,WAAqB;QAC7E,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO;QACX,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,EAAE,CAAC;IACzB,CAAC;IAED;yFACqF;IAC9E,OAAO,CAAC,KAAa;QACxB,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,CAAC;IACL,CAAC;IAED,2FAA2F;IAC3F,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,QAAQ;QACjB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,OAAO;QACX,CAAC;QACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;QACX,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,0FAA0F;QAC1F,MAAM,GAAG,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACvE,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,2CAA2C,EAAE,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;QACpK,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,QAAQ,CAAC,oDAAoD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzI,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,iBAAiB,CACjC,QAA8B,EAC9B,WAAqB,EACrB,MAAwC;QAExC,MAAM,SAAS,GAAG,MAAM,EAAE,qBAAqB,IAAI,cAAc,CAAC,qBAAqB,CAAC;QACxF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,QAAQ,CAAC,2GAA2G,CAAC,CAAC;YACtH,OAAO,CAAC,CAAC;QACb,CAAC;QACD,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC;YACD,0EAA0E;YAC1E,MAAM,GAAG,GAAG,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YAC3F,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,CAClC,GAAG,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,kCAAkC,EAAE,EAAE,WAAW,CAAC,CAAC;YACxG,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YACtH,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAChB,SAAS,CAAC,4BAA4B,SAAS,uDAAuD,SAAS,IAAI,CAAC,CAAC;YACzH,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,QAAQ,CAAC,8CAA8C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3G,OAAO,CAAC,CAAC;QACb,CAAC;IACL,CAAC;IAED,4FAA4F;IAE5F,2FAA2F;IACnF,aAAa;QACjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAClG,2DAA2D;YAC3D,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,sFAAsF;YACtF,sFAAsF;YACtF,wFAAwF;YACxF,sFAAsF;YACtF,wFAAwF;YACxF,sFAAsF;YACtF,iFAAiF;YACjF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAC9F,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC;QAC/B,CAAC;IACL,CAAC;IAEO,UAAU;QACd,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAChC,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;IACL,CAAC;IAED;+FAC2F;IACnF,KAAK,CAAC,SAAS;QACnB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACX,CAAC;QACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;QACX,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,0FAA0F;QAC1F,MAAM,GAAG,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QAC1E,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,4BAA4B,EAAE,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;QAC1K,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,QAAQ,CAAC,+CAA+C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpI,CAAC;IACL,CAAC;IAED,8FAA8F;IACtF,KAAK,CAAC,aAAa;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,OAAO;QACX,CAAC;QACD,MAAM,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1F,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,iBAAiB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1B,OAAO;QACX,CAAC;QACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,OAAO;QACX,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CACxC,UAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG;gBACjD,SAAS,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,EAC9F,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,oCAAoC,EAAE,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;YAC3H,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;YACvC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACrB,IAAI,OAAO,GAAG,EAAE,EAAE,KAAK,QAAQ,EAAE,CAAC;wBAC9B,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;oBAC3C,CAAC;gBACL,CAAC;YACL,CAAC;YACD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACtC,CAAC;YACL,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,QAAQ,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;IACL,CAAC;IAED,qFAAqF;IAC7E,UAAU;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,cAAc,CAAC,CAAU,EAAE,MAAc,EAAE,IAAY,EAAE,GAAa;QACjF,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3G,CAAC;IAED,4FAA4F;IACpF,aAAa;QACjB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,kGAAkG;IAC1F,MAAM,CAAC,QAAQ,CAAC,QAA8B;QAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACvD,OAAO,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,6FAA6F;IACrF,MAAM,CAAC,MAAM,CAAC,QAA8B;QAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC3B,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtH,CAAC;CACJ"}

package/dist/agent-types/loop-agent-prompt-params.d.ts

@@ -79,6 +79,12 @@ export interface ResponseTypeInclusionRules {
      * @default true
      */
     artifactToolCalls?: boolean;
+    /**
+     * Include the pipeline field in the response interface.
+     * Auto-aligns with includePipelineDocs unless explicitly set.
+     * @default true
+     */
+    pipeline?: boolean;
 }
 /**
  * Default values for ResponseTypeInclusionRules.
@@ -237,6 +243,13 @@ export interface LoopAgentTypePromptParams {
      * @default true
      */
     includeArtifactToolsDocs?: boolean;
+    /**
+     * Include tool-pipeline documentation in the prompt (the `_PIPELINE_TOOLS` block).
+     * Only emitted when at least one pipeline source — an Action or artifact tool — is available.
+     * Disable for agents that should never compose pipelines.
+     * @default true
+     */
+    includePipelineDocs?: boolean;
     /**
      * Maximum number of sub-agents to include in prompt details.
      * -1 = include all (default)

package/dist/agent-types/loop-agent-prompt-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-prompt-params.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAAC,0BAA0B,CAQtF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,yBAAyB;IAGtC;;;;;;;;;OASG;IACH,6BAA6B,CAAC,EAAE,0BAA0B,CAAC;IAE3D;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAInC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,yBAAyB,CAehF,CAAC"}
+{"version":3,"file":"loop-agent-prompt-params.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAAC,0BAA0B,CAStF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,yBAAyB;IAGtC;;;;;;;;;OASG;IACH,6BAA6B,CAAC,EAAE,0BAA0B,CAAC;IAE3D;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAI9B;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,yBAAyB,CAgBhF,CAAC"}

package/dist/agent-types/loop-agent-prompt-params.js

@@ -30,7 +30,8 @@ export const DEFAULT_RESPONSE_TYPE_INCLUSION_RULES = {
     forEach: true,
     while: true,
     scratchpad: true,
-    artifactToolCalls: true
+    artifactToolCalls: true,
+    pipeline: true
 };
 /**
  * Default values for LoopAgentTypePromptParams.
@@ -49,6 +50,7 @@ export const DEFAULT_LOOP_AGENT_PROMPT_PARAMS = {
     includeScratchpadDocs: true,
     scratchpadMaxTasks: 50,
     includeArtifactToolsDocs: true,
+    includePipelineDocs: true,
     maxSubAgentsInPrompt: -1,
     maxActionsInPrompt: -1
 };

package/dist/agent-types/loop-agent-prompt-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-prompt-params.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAwEH;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAyC;IACvF,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,iBAAiB,EAAE,IAAI;CAC1B,CAAC;AA+LF;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwC;IACjF,6BAA6B,EAAE,EAAE,GAAG,qCAAqC,EAAE;IAC3E,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,IAAI;IAC7B,kBAAkB,EAAE,IAAI;IACxB,2BAA2B,EAAE,IAAI;IACjC,uBAAuB,EAAE,IAAI;IAC7B,sBAAsB,EAAE,IAAI;IAC5B,uBAAuB,EAAE,IAAI;IAC7B,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,EAAE;IACtB,wBAAwB,EAAE,IAAI;IAC9B,oBAAoB,EAAE,CAAC,CAAC;IACxB,kBAAkB,EAAE,CAAC,CAAC;CACzB,CAAC"}
+{"version":3,"file":"loop-agent-prompt-params.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA+EH;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAyC;IACvF,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE,IAAI;CACjB,CAAC;AAuMF;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwC;IACjF,6BAA6B,EAAE,EAAE,GAAG,qCAAqC,EAAE;IAC3E,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,IAAI;IAC7B,kBAAkB,EAAE,IAAI;IACxB,2BAA2B,EAAE,IAAI;IACjC,uBAAuB,EAAE,IAAI;IAC7B,sBAAsB,EAAE,IAAI;IAC5B,uBAAuB,EAAE,IAAI;IAC7B,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,EAAE;IACtB,wBAAwB,EAAE,IAAI;IAC9B,mBAAmB,EAAE,IAAI;IACzB,oBAAoB,EAAE,CAAC,CAAC;IACxB,kBAAkB,EAAE,CAAC,CAAC;CACzB,CAAC"}

package/dist/agent-types/loop-agent-response-type.d.ts

@@ -1,4 +1,4 @@
-import { AgentPayloadChangeRequest, ForEachOperation, WhileOperation, AgentResponseForm, ActionableCommand, AutomaticCommand, AgentScratchpad } from "@memberjunction/ai-core-plus";
+import { AgentPayloadChangeRequest, ForEachOperation, WhileOperation, AgentResponseForm, ActionableCommand, AutomaticCommand, AgentScratchpad, AgentPipelineRequest } from "@memberjunction/ai-core-plus";
 import { ArtifactToolCall } from "../ArtifactToolManager.js";
 export type { ForEachOperation, WhileOperation, ArtifactToolCall };
 /**
@@ -62,9 +62,9 @@ export interface LoopAgentResponse<P = any> {
      */
     nextStep?: {
         /**
-         * Operation type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While'
+         * Operation type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While' | 'Pipeline'
          */
-        type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While';
+        type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While' | 'Pipeline';
         /**
          * Actions to execute (when type='Actions')
          */
@@ -72,6 +72,15 @@ export interface LoopAgentResponse<P = any> {
             name: string;
             params: Record<string, unknown>;
         }>;
+        /**
+         * Tool pipeline to run server-side (when type='Pipeline'). Like client tools, it is a
+         * yield/await action: the agent cannot know the result until it executes, so the loop runs
+         * the pipeline inline, injects the final output, and forces one more turn. Only the final
+         * step's output enters the context window. Modeling it as a `nextStep.type` (rather than a
+         * top-level field) makes it structurally mutually exclusive with Actions/Chat/etc. — the LLM
+         * cannot accidentally request a pipeline AND another step in the same turn.
+         */
+        pipeline?: AgentPipelineRequest;
         /**
          * Index of a compacted message to expand (when type='Retry').
          * The message is restored to full content and the prompt re-runs.

package/dist/agent-types/loop-agent-response-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-response-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpL,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,GAAG;IACtC;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAEjC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAEzC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEvC;;OAEG;IACH,oBAAoB,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACP;;WAEG;QACH,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;QAEvF;;WAEG;QACH,OAAO,CAAC,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnC,CAAC,CAAC;QAEH;;;WAGG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,QAAQ,CAAC,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YAEb;;eAEG;YACH,OAAO,EAAE,MAAM,CAAC;YAEhB;;;;eAIG;YACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAEzC;;eAEG;YACH,cAAc,EAAE,OAAO,CAAC;SAC3B,CAAC;QAEF;;WAEG;QACH,SAAS,CAAC,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;YAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACzC,cAAc,EAAE,OAAO,CAAC;SAC3B,CAAC,CAAC;QAEH;;;WAGG;QACH,WAAW,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjC,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC,CAAC;QAEH;;WAEG;QACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAE3B;;WAEG;QACH,KAAK,CAAC,EAAE,cAAc,CAAC;KAC1B,CAAC;CACL"}
+{"version":3,"file":"loop-agent-response-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":"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"}

package/dist/agent-types/loop-agent-response-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-response-type.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":";AAiKA,oEAAoE;AACpE,sDAAsD"}
+{"version":3,"file":"loop-agent-response-type.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":";AA2KA,oEAAoE;AACpE,sDAAsD"}

package/dist/agent-types/loop-agent-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEpL,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBACa,aAAc,SAAQ,aAAa;IAC5C,OAAO,CAAC,UAAU,CAAiC;IAEtC,wBAAwB,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3G;;;;;;;;;;;OAWG;IACU,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC7C,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAoLhC;;;;;;;OAOG;IACH,SAAS,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAsI5F;;;;;;;OAOG;IACU,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EACzC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;OAUG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK/G;;;;;;;;;;;OAWG;IACU,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC9C,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvC;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAK3C;;;;;;;;;;;;;;;;;OAiBG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAChD,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,CAAC,EACjB,cAAc,EAAE,GAAG,EACnB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,6BAA6B;CAyBxC"}
+{"version":3,"file":"loop-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEpL,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBACa,aAAc,SAAQ,aAAa;IAC5C,OAAO,CAAC,UAAU,CAAiC;IAEtC,wBAAwB,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3G;;;;;;;;;;;OAWG;IACU,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC7C,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA0NhC;;;;;;;OAOG;IACH,SAAS,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAyI5F;;;;;;;OAOG;IACU,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EACzC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;OAUG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK/G;;;;;;;;;;;OAWG;IACU,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC9C,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvC;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAK3C;;;;;;;;;;;;;;;;;OAiBG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAChD,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,CAAC,EACjB,cAAc,EAAE,GAAG,EACnB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,6BAA6B;CAyBxC"}

package/dist/agent-types/loop-agent-type.js

@@ -86,13 +86,41 @@ let LoopAgentType = class LoopAgentType extends BaseAgentType {
             // Parse the response using the base class utility
             const response = this.parseJSONResponse(promptResult);
             if (!response) {
-                return this.createRetryStep('Failed to parse JSON response');
+                // Strong, specific corrective directive. The common failure mode here is the model
+                // drifting into conversational prose (e.g. "I'm executing the X action with
+                // parameters: ...") instead of emitting the JSON envelope. A terse "couldn't parse"
+                // message gives the model nothing to correct against, so we spell out exactly what
+                // to do and what NOT to do. This is the retry-feedback half of the prose-drift fix;
+                // the other half re-roles framework action records so they stop reading as prose
+                // assistant exemplars.
+                return this.createRetryStep('Your previous message was not valid JSON and could not be parsed. Respond with ONLY a ' +
+                    'single raw JSON object conforming to the LoopAgentResponse interface — no prose, no ' +
+                    'markdown code fences, and no natural-language narration such as "I\'m executing the ... ' +
+                    'action". Do not describe your action in text; express it inside the JSON (e.g. via ' +
+                    'nextStep). Output the JSON object and nothing else.');
             }
             // Validate the response structure
             const validationResult = this.isValidLoopResponse(response);
             if (!validationResult.success) {
                 return this.createRetryStep(validationResult.message);
             }
+            // A tool pipeline is a yield/await action (like client tools): the agent can't know
+            // its result until it runs. Handle it BEFORE Chat/taskComplete/nextStep-switch checks —
+            // the loop executes the pipeline inline, injects the final output, and we force one
+            // more turn (Retry, non-terminal) so the LLM can use the result. Pipeline is a singular
+            // `nextStep.type`, so the model cannot also request Actions/Chat/etc. this turn; checking
+            // it here preserves yield/await semantics (it pre-empts taskComplete, like client tools).
+            if (response.nextStep?.type === 'Pipeline' && response.nextStep.pipeline?.steps?.length) {
+                return this.createNextStep('Retry', {
+                    pipeline: response.nextStep.pipeline,
+                    terminate: false,
+                    scratchpad: response.scratchpad,
+                    artifactToolCalls: response.artifactToolCalls,
+                    payloadChangeRequest: response.payloadChangeRequest,
+                    reasoning: response.reasoning,
+                    confidence: response.confidence
+                });
+            }
             // Check for Chat nextStep BEFORE checking taskComplete
             // This allows agents to ask for user clarification even when taskComplete=true
             if (response.nextStep?.type === 'Chat') {
@@ -238,6 +266,13 @@ let LoopAgentType = class LoopAgentType extends BaseAgentType {
                     retVal.messageIndex = response.nextStep.messageIndex;
                     retVal.expandReason = response.nextStep.reason;
                     break;
+                case 'Pipeline':
+                    // A well-formed pipeline is handled by the early return above; reaching the
+                    // switch means type='Pipeline' was set with no (or empty) nextStep.pipeline.steps.
+                    retVal.step = 'Retry';
+                    retVal.message = 'When nextStep.type == "Pipeline", nextStep.pipeline.steps must contain 1 or more stages';
+                    retVal.errorMessage = 'Pipeline steps not specified for Pipeline type';
+                    break;
                 default:
                     retVal.step = 'Retry';
                     retVal.errorMessage = `Unknown next step type: ${response.nextStep.type}`;
@@ -317,7 +352,7 @@ let LoopAgentType = class LoopAgentType extends BaseAgentType {
         }
         // Validate nextStep structure if present
         if (response.nextStep) {
-            const validStepTypes = ['actions', 'sub-agent', 'chat', 'retry', 'foreach', 'while', 'clienttools'];
+            const validStepTypes = ['actions', 'sub-agent', 'chat', 'retry', 'foreach', 'while', 'clienttools', 'pipeline'];
             let lcaseType = response.nextStep.type?.toLowerCase().trim();
             // allow the AI to mess up the case, but we need to validate it
             // be smart/lenient about missing types. if type is missing but we have a nextStep.subAgent/subAgents, default to sub-agent and if type is missing and we have nextStep.actions, default to actions
@@ -341,6 +376,10 @@ let LoopAgentType = class LoopAgentType extends BaseAgentType {
                 response.nextStep.type = 'While'; // update the data structure to have the correct type
                 lcaseType = 'while';
             }
+            else if (!lcaseType && response.nextStep.pipeline?.steps?.length) {
+                response.nextStep.type = 'Pipeline'; // update the data structure to have the correct type
+                lcaseType = 'pipeline';
+            }
             if (!validStepTypes.includes(lcaseType)) {
                 const message = `LoopAgentResponse has invalid nextStep.type: ${response.nextStep.type}`;
                 LogError(message);