@ajna-inc/workflow 0.5.37 → 0.6.1

package/build/queue/CommandQueue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandQueue.mjs","names":[],"sources":["../../src/queue/CommandQueue.ts"],"sourcesContent":["import type { AgentContext } from '@credo-ts/core'\n\nexport type WorkflowCommandJob = {\n  cmd: 'start' | 'advance' | 'pause' | 'resume' | 'cancel' | 'complete'\n  thid: string\n  connectionId?: string\n  idempotency_key?: string\n  payload: Record<string, unknown>\n  contextCorrelationId: string\n}\n\nexport interface CommandQueue {\n  enqueue(agentContext: AgentContext, job: WorkflowCommandJob): Promise<void>\n  startWorker(onJob: (job: WorkflowCommandJob) => Promise<void>): Promise<void>\n  stop(): Promise<void>\n  isReady(): Promise<boolean>\n  // Hint the queue to poll immediately (best-effort)\n  triggerPoll?(): void\n}\n\n// DI token for the queue instance\nexport class CommandQueueService {}\n"],"mappings":";AAqBA,IAAa,sBAAb,MAAiC"}

package/build/queue/PersistentCommandQueue.d.mts

@@ -0,0 +1,56 @@
+import { WorkflowCommandRepository } from "../repository/WorkflowCommandRepository.mjs";
+import { CommandQueue, WorkflowCommandJob } from "./CommandQueue.mjs";
+import { AgentContext, AgentContextProvider } from "@credo-ts/core";
+
+//#region src/queue/PersistentCommandQueue.d.ts
+interface PersistentCommandQueueOptions {
+  pollIntervalMs?: number;
+  concurrency?: number;
+  processingTimeoutMs?: number;
+  staleCheckIntervalMs?: number;
+  cleanupIntervalMs?: number;
+  commandRetentionMs?: number;
+  failedRetentionMs?: number;
+  maxAttempts?: number;
+}
+declare class PersistentCommandQueue implements CommandQueue {
+  private readonly pollIntervalMs;
+  private readonly concurrency;
+  private readonly processingTimeoutMs;
+  private readonly staleCheckIntervalMs;
+  private readonly cleanupIntervalMs;
+  private readonly commandRetentionMs;
+  private readonly failedRetentionMs;
+  private readonly maxAttempts;
+  private running;
+  private activeCount;
+  private onJobHandler?;
+  private readonly repository;
+  private readonly contextProvider;
+  private readonly rootContext;
+  private readonly logger;
+  private readonly pendingSleeps;
+  constructor(repository: WorkflowCommandRepository, contextProvider: AgentContextProvider, rootContext: AgentContext, options?: PersistentCommandQueueOptions);
+  isReady(): Promise<boolean>;
+  enqueue(agentContext: AgentContext, job: WorkflowCommandJob): Promise<void>;
+  triggerPoll(): void;
+  startWorker(onJob: (job: WorkflowCommandJob) => Promise<void>): Promise<void>;
+  stop(): Promise<void>;
+  private pollLoop;
+  private poll;
+  private processCommand;
+  private staleCheckLoop;
+  private cleanupLoop;
+  private resolveContext;
+  private sleep;
+  getMetrics(): Promise<{
+    pending: number;
+    processing: number;
+    completed: number;
+    failed: number;
+    active: number;
+  }>;
+}
+//#endregion
+export { PersistentCommandQueue, PersistentCommandQueueOptions };
+//# sourceMappingURL=PersistentCommandQueue.d.mts.map

package/build/queue/PersistentCommandQueue.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentCommandQueue.d.mts","names":[],"sources":["../../src/queue/PersistentCommandQueue.ts"],"sourcesContent":[],"mappings":";;;;;UAOiB,6BAAA;;EAAA,WAAA,CAAA,EAAA,MAAA;EAWJ,mBAAA,CAAA,EAAA,MAAuB;EAqBpB,oBAAA,CAAA,EAAA,MAAA;EACK,iBAAA,CAAA,EAAA,MAAA;EACJ,kBAAA,CAAA,EAAA,MAAA;EACH,iBAAA,CAAA,EAAA,MAAA;EAiBY,WAAA,CAAA,EAAA,MAAA;;AAI8B,cA7C3C,sBAAA,YAAkC,YA6CS,CAAA;EAAqB,iBAAA,cAAA;EAgDrC,iBAAA,WAAA;EAAuB,iBAAA,mBAAA;EAAgB,iBAAA,oBAAA;EAgBxD,iBAAA,iBAAA;EA4QM,iBAAA,kBAAA;EAzXkB,iBAAA,iBAAA;EAAY,iBAAA,WAAA;;;;;;;;;0BAqB3C,4CACK,mCACJ,wBACH;aAiBY;wBAIW,mBAAmB,qBAAqB;;2BAgDrC,uBAAuB,gBAAgB;UAgBxD;;;;;;;;gBA4QM"}

package/build/queue/PersistentCommandQueue.mjs

@@ -0,0 +1,273 @@
+import { WorkflowCommandRecord } from "../repository/WorkflowCommandRecord.mjs";
+import "../repository/WorkflowCommandRepository.mjs";
+import { AgentConfig, InjectionSymbols } from "@credo-ts/core";
+
+//#region src/queue/PersistentCommandQueue.ts
+var PersistentCommandQueue = class {
+	constructor(repository, contextProvider, rootContext, options) {
+		this.running = false;
+		this.activeCount = 0;
+		this.pendingSleeps = /* @__PURE__ */ new Set();
+		this.repository = repository;
+		this.contextProvider = contextProvider;
+		this.rootContext = rootContext;
+		this.logger = rootContext.dependencyManager.resolve(AgentConfig).logger;
+		this.pollIntervalMs = options?.pollIntervalMs ?? 100;
+		this.concurrency = Math.max(1, options?.concurrency ?? 3);
+		this.processingTimeoutMs = options?.processingTimeoutMs ?? 3e4;
+		this.staleCheckIntervalMs = options?.staleCheckIntervalMs ?? 5e3;
+		this.cleanupIntervalMs = options?.cleanupIntervalMs ?? 6e4;
+		this.commandRetentionMs = options?.commandRetentionMs ?? 36e5;
+		this.failedRetentionMs = options?.failedRetentionMs ?? 864e5;
+		this.maxAttempts = options?.maxAttempts ?? 3;
+	}
+	async isReady() {
+		return true;
+	}
+	async enqueue(agentContext, job) {
+		try {
+			if ((await this.repository.findByQuery(this.rootContext, { thid: job.thid }))?.some?.((r) => r.cmd === job.cmd && (r.status === "pending" || r.status === "processing"))) {
+				this.logger.debug(`[PersistentQueue] Dedup enqueue: command already queued (${job.cmd}) for ${job.thid}`);
+				return;
+			}
+		} catch {}
+		const record = new WorkflowCommandRecord({
+			cmd: job.cmd,
+			thid: job.thid,
+			connectionId: job.connectionId,
+			idempotencyKey: job.idempotency_key,
+			payload: job.payload,
+			contextCorrelationId: job.contextCorrelationId,
+			status: "pending",
+			attempts: 0,
+			createdAt: /* @__PURE__ */ new Date()
+		});
+		await this.repository.save(this.rootContext, record);
+		this.logger.debug(`[PersistentQueue] Enqueued command: ${job.cmd} for ${job.thid}`);
+		setImmediate(() => void this.poll());
+	}
+	triggerPoll() {
+		try {
+			setImmediate(() => void this.poll());
+		} catch {}
+	}
+	async startWorker(onJob) {
+		this.onJobHandler = onJob;
+		this.running = true;
+		this.logger.info("[PersistentQueue] Starting worker loops", {
+			pollIntervalMs: this.pollIntervalMs,
+			concurrency: this.concurrency,
+			processingTimeoutMs: this.processingTimeoutMs
+		});
+		this.pollLoop();
+		this.staleCheckLoop();
+		this.cleanupLoop();
+	}
+	async stop() {
+		this.logger.info("[PersistentQueue] Stopping worker...");
+		this.running = false;
+		for (const entry of Array.from(this.pendingSleeps)) {
+			try {
+				clearTimeout(entry.timer);
+			} catch {}
+			try {
+				entry.resolve();
+			} catch {}
+			this.pendingSleeps.delete(entry);
+		}
+		const maxWait = 1e4;
+		const start = Date.now();
+		while (this.activeCount > 0 && Date.now() - start < maxWait) await this.sleep(100);
+		if (this.activeCount > 0) this.logger.warn(`[PersistentQueue] Stopped with ${this.activeCount} active jobs`);
+		else this.logger.info("[PersistentQueue] Stopped cleanly");
+	}
+	async pollLoop() {
+		while (this.running) {
+			try {
+				await this.poll();
+			} catch (err) {
+				if (this.running && this.logger && typeof this.logger.error === "function") this.logger.error("[PersistentQueue] Poll error", { error: err.message });
+			}
+			await this.sleep(this.pollIntervalMs);
+		}
+	}
+	async poll() {
+		if (this.activeCount >= this.concurrency) return;
+		if (!this.onJobHandler) return;
+		const limit = this.concurrency - this.activeCount;
+		const pending = await this.repository.findPending(this.rootContext, limit);
+		if (pending.length > 0) try {
+			this.logger.info("[PersistentQueue] Pending commands fetched", { count: pending.length });
+		} catch {}
+		for (const record of pending) {
+			if (record.attempts >= this.maxAttempts) {
+				await this.repository.markFailed(this.rootContext, record, `Max attempts (${this.maxAttempts}) exceeded`);
+				this.logger.warn(`[PersistentQueue] Command ${record.id} failed after ${this.maxAttempts} attempts`);
+				continue;
+			}
+			await this.repository.markProcessing(this.rootContext, record);
+			this.activeCount++;
+			this.processCommand(record);
+		}
+	}
+	async processCommand(record) {
+		let scoped = null;
+		try {
+			scoped = await this.resolveContext(record.contextCorrelationId);
+			if (!scoped) throw new Error(`Unable to resolve context: ${record.contextCorrelationId}`);
+			const job = {
+				cmd: record.cmd,
+				thid: record.thid,
+				connectionId: record.connectionId,
+				idempotency_key: record.idempotencyKey,
+				payload: record.payload,
+				contextCorrelationId: record.contextCorrelationId
+			};
+			try {
+				this.logger.info("[PersistentQueue] Processing command", {
+					cmd: record.cmd,
+					thid: record.thid,
+					attempts: record.attempts
+				});
+			} catch {}
+			await this.onJobHandler(job);
+			await this.repository.markCompleted(this.rootContext, record);
+			try {
+				this.logger.info("[PersistentQueue] Completed command", {
+					cmd: record.cmd,
+					thid: record.thid
+				});
+			} catch {}
+		} catch (err) {
+			const errorMsg = err.message || "Unknown error";
+			const errCode = err?.code;
+			if (this.running && this.logger && typeof this.logger.error === "function") this.logger.error(`[PersistentQueue] Command processing failed: ${record.cmd} for ${record.thid}`, {
+				error: errorMsg,
+				attempts: record.attempts
+			});
+			if (errCode === "invalid_template") {
+				try {
+					await this.sleep(Math.min(1e3, this.pollIntervalMs * 10));
+				} catch {}
+				try {
+					if (record.attempts > 0) record.attempts -= 1;
+				} catch {}
+				await this.repository.resetToPending(this.rootContext, record);
+				try {
+					this.logger.info("[PersistentQueue] Deferred command due to missing template; reset to pending", {
+						cmd: record.cmd,
+						thid: record.thid
+					});
+				} catch {}
+				return;
+			}
+			if (record.attempts >= this.maxAttempts) await this.repository.markFailed(this.rootContext, record, errorMsg);
+			else {
+				await this.repository.resetToPending(this.rootContext, record);
+				try {
+					this.logger.info("[PersistentQueue] Resetting command to pending for retry", {
+						cmd: record.cmd,
+						thid: record.thid,
+						attempts: record.attempts
+					});
+				} catch {}
+			}
+		} finally {
+			try {
+				await scoped?.release?.();
+			} catch {}
+			this.activeCount--;
+		}
+	}
+	async staleCheckLoop() {
+		while (this.running) {
+			await this.sleep(this.staleCheckIntervalMs);
+			try {
+				const stale = await this.repository.findStale(this.rootContext, this.processingTimeoutMs);
+				for (const record of stale) {
+					this.logger.warn(`[PersistentQueue] Resetting stale command: ${record.cmd} for ${record.thid}`, {
+						attempts: record.attempts,
+						lastAttempt: record.lastAttemptAt?.toISOString()
+					});
+					if (record.attempts >= this.maxAttempts) await this.repository.markFailed(this.rootContext, record, "Stale after max attempts");
+					else await this.repository.resetToPending(this.rootContext, record);
+				}
+			} catch (err) {
+				if (this.running && this.logger && typeof this.logger.error === "function") this.logger.error("[PersistentQueue] Stale check error", { error: err.message });
+			}
+		}
+	}
+	async cleanupLoop() {
+		while (this.running) {
+			await this.sleep(this.cleanupIntervalMs);
+			try {
+				const completedCutoff = new Date(Date.now() - this.commandRetentionMs);
+				const failedCutoff = new Date(Date.now() - this.failedRetentionMs);
+				const [completedDeleted, failedDeleted] = await Promise.all([this.repository.deleteCompleted(this.rootContext, completedCutoff), this.repository.deleteFailed(this.rootContext, failedCutoff)]);
+				if (completedDeleted > 0 || failedDeleted > 0) this.logger.debug(`[PersistentQueue] Cleanup: deleted ${completedDeleted} completed, ${failedDeleted} failed`);
+			} catch (err) {
+				if (this.running && this.logger && typeof this.logger.error === "function") this.logger.error("[PersistentQueue] Cleanup error", { error: err.message });
+			}
+		}
+	}
+	async resolveContext(correlationId) {
+		const rootId = this.rootContext.contextCorrelationId;
+		if (!correlationId || correlationId === rootId) return {
+			context: this.rootContext,
+			release: async () => {}
+		};
+		try {
+			const scopedContext = await this.contextProvider.getAgentContextForContextCorrelationId(correlationId);
+			return {
+				context: scopedContext,
+				release: async () => {
+					try {
+						await this.contextProvider.endSessionForAgentContext(scopedContext);
+					} catch (error) {
+						this.logger.debug("[PersistentQueue] Failed to end tenant session", {
+							contextCorrelationId: correlationId,
+							error: error.message
+						});
+					}
+				}
+			};
+		} catch (error) {
+			if (this.running && this.logger && typeof this.logger.error === "function") this.logger.error("[PersistentQueue] Unable to resolve context, falling back to root", {
+				contextCorrelationId: correlationId,
+				error: error.message
+			});
+			return {
+				context: this.rootContext,
+				release: async () => {}
+			};
+		}
+	}
+	sleep(ms) {
+		return new Promise((outerResolve) => {
+			const entry = {
+				timer: void 0,
+				resolve: () => {}
+			};
+			const resolve = () => {
+				try {
+					outerResolve();
+				} finally {
+					this.pendingSleeps.delete(entry);
+				}
+			};
+			entry.resolve = resolve;
+			entry.timer = setTimeout(resolve, ms);
+			this.pendingSleeps.add(entry);
+		});
+	}
+	async getMetrics() {
+		return {
+			...await this.repository.getMetrics(this.rootContext),
+			active: this.activeCount
+		};
+	}
+};
+
+//#endregion
+export { PersistentCommandQueue };
+//# sourceMappingURL=PersistentCommandQueue.mjs.map

package/build/queue/PersistentCommandQueue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentCommandQueue.mjs","names":["scoped: { context: AgentContext; release: () => Promise<void> } | null","job: WorkflowCommandJob"],"sources":["../../src/queue/PersistentCommandQueue.ts"],"sourcesContent":["import type { AgentContext, AgentContextProvider } from '@credo-ts/core'\nimport type { CommandQueue, WorkflowCommandJob } from './CommandQueue'\n\nimport { AgentConfig, InjectionSymbols } from '@credo-ts/core'\nimport { WorkflowCommandRecord } from '../repository/WorkflowCommandRecord'\nimport { WorkflowCommandRepository } from '../repository/WorkflowCommandRepository'\n\nexport interface PersistentCommandQueueOptions {\n  pollIntervalMs?: number\n  concurrency?: number\n  processingTimeoutMs?: number\n  staleCheckIntervalMs?: number\n  cleanupIntervalMs?: number\n  commandRetentionMs?: number\n  failedRetentionMs?: number\n  maxAttempts?: number\n}\n\nexport class PersistentCommandQueue implements CommandQueue {\n  private readonly pollIntervalMs: number\n  private readonly concurrency: number\n  private readonly processingTimeoutMs: number\n  private readonly staleCheckIntervalMs: number\n  private readonly cleanupIntervalMs: number\n  private readonly commandRetentionMs: number\n  private readonly failedRetentionMs: number\n  private readonly maxAttempts: number\n\n  private running = false\n  private activeCount = 0\n  private onJobHandler?: (job: WorkflowCommandJob) => Promise<void>\n\n  private readonly repository: WorkflowCommandRepository\n  private readonly contextProvider: AgentContextProvider\n  private readonly rootContext: AgentContext\n  private readonly logger: AgentConfig['logger']\n  private readonly pendingSleeps = new Set<{ timer: NodeJS.Timeout; resolve: () => void }>()\n\n  public constructor(\n    repository: WorkflowCommandRepository,\n    contextProvider: AgentContextProvider,\n    rootContext: AgentContext,\n    options?: PersistentCommandQueueOptions\n  ) {\n    this.repository = repository\n    this.contextProvider = contextProvider\n    this.rootContext = rootContext\n    this.logger = rootContext.dependencyManager.resolve(AgentConfig).logger\n\n    this.pollIntervalMs = options?.pollIntervalMs ?? 100\n    this.concurrency = Math.max(1, options?.concurrency ?? 3)\n    this.processingTimeoutMs = options?.processingTimeoutMs ?? 30000\n    this.staleCheckIntervalMs = options?.staleCheckIntervalMs ?? 5000\n    this.cleanupIntervalMs = options?.cleanupIntervalMs ?? 60000\n    this.commandRetentionMs = options?.commandRetentionMs ?? 3600000 // 1 hour\n    this.failedRetentionMs = options?.failedRetentionMs ?? 86400000 // 24 hours\n    this.maxAttempts = options?.maxAttempts ?? 3\n  }\n\n  public async isReady(): Promise<boolean> {\n    return true // Always ready (uses existing storage)\n  }\n\n  public async enqueue(agentContext: AgentContext, job: WorkflowCommandJob): Promise<void> {\n    // Always persist commands in the root context so a single worker can process\n    // commands across tenants and resolve the proper context per job.\n    // Deduplicate by (cmd, thid) when a command is already pending/processing\n    try {\n      const existing = await this.repository.findByQuery(this.rootContext, { thid: job.thid })\n      if (\n        existing?.some?.(\n          (r) => r.cmd === job.cmd && (r.status === 'pending' || r.status === 'processing')\n        )\n      ) {\n        this.logger.debug(\n          `[PersistentQueue] Dedup enqueue: command already queued (${job.cmd}) for ${job.thid}`\n        )\n        return\n      }\n    } catch {\n      // swallow and proceed to enqueue\n    }\n\n    const record = new WorkflowCommandRecord({\n      cmd: job.cmd,\n      thid: job.thid,\n      connectionId: job.connectionId,\n      idempotencyKey: job.idempotency_key,\n      payload: job.payload,\n      contextCorrelationId: job.contextCorrelationId,\n      status: 'pending',\n      attempts: 0,\n      createdAt: new Date(),\n    })\n\n    await this.repository.save(this.rootContext, record)\n    this.logger.debug(`[PersistentQueue] Enqueued command: ${job.cmd} for ${job.thid}`)\n\n    // Trigger immediate poll (non-blocking)\n    setImmediate(() => void this.poll())\n  }\n\n  public triggerPoll(): void {\n    // Non-blocking immediate poll hint\n    try {\n      setImmediate(() => void this.poll())\n    } catch {\n      // best-effort only\n    }\n  }\n\n  public async startWorker(onJob: (job: WorkflowCommandJob) => Promise<void>): Promise<void> {\n    this.onJobHandler = onJob\n    this.running = true\n\n    this.logger.info('[PersistentQueue] Starting worker loops', {\n      pollIntervalMs: this.pollIntervalMs,\n      concurrency: this.concurrency,\n      processingTimeoutMs: this.processingTimeoutMs,\n    })\n\n    // Start background loops (non-blocking)\n    void this.pollLoop()\n    void this.staleCheckLoop()\n    void this.cleanupLoop()\n  }\n\n  public async stop(): Promise<void> {\n    this.logger.info('[PersistentQueue] Stopping worker...')\n    this.running = false\n\n    // Cancel any pending sleep timers and resolve sleepers\n    for (const entry of Array.from(this.pendingSleeps)) {\n      try {\n        clearTimeout(entry.timer)\n      } catch {}\n      try {\n        entry.resolve()\n      } catch {}\n      this.pendingSleeps.delete(entry)\n    }\n\n    // Wait for active jobs to complete (with timeout)\n    const maxWait = 10000\n    const start = Date.now()\n    while (this.activeCount > 0 && Date.now() - start < maxWait) {\n      await this.sleep(100)\n    }\n\n    if (this.activeCount > 0) {\n      this.logger.warn(`[PersistentQueue] Stopped with ${this.activeCount} active jobs`)\n    } else {\n      this.logger.info('[PersistentQueue] Stopped cleanly')\n    }\n  }\n\n  private async pollLoop(): Promise<void> {\n    while (this.running) {\n      try {\n        await this.poll()\n      } catch (err) {\n        if (this.running && this.logger && typeof this.logger.error === 'function') {\n          this.logger.error('[PersistentQueue] Poll error', { error: (err as Error).message })\n        }\n      }\n      await this.sleep(this.pollIntervalMs)\n    }\n  }\n\n  private async poll(): Promise<void> {\n    if (this.activeCount >= this.concurrency) return\n    if (!this.onJobHandler) return\n\n    const limit = this.concurrency - this.activeCount\n    const pending = await this.repository.findPending(this.rootContext, limit)\n    if (pending.length > 0) {\n      try {\n        this.logger.info('[PersistentQueue] Pending commands fetched', {\n          count: pending.length,\n        })\n      } catch {}\n    }\n\n    for (const record of pending) {\n      // Check max attempts before processing\n      if (record.attempts >= this.maxAttempts) {\n        await this.repository.markFailed(\n          this.rootContext,\n          record,\n          `Max attempts (${this.maxAttempts}) exceeded`\n        )\n        this.logger.warn(`[PersistentQueue] Command ${record.id} failed after ${this.maxAttempts} attempts`)\n        continue\n      }\n\n      // Mark as processing\n      await this.repository.markProcessing(this.rootContext, record)\n      this.activeCount++\n\n      // Process in background\n      void this.processCommand(record)\n    }\n  }\n\n  private async processCommand(record: WorkflowCommandRecord): Promise<void> {\n    let scoped: { context: AgentContext; release: () => Promise<void> } | null = null\n    try {\n      // Resolve tenant context\n      scoped = await this.resolveContext(record.contextCorrelationId)\n\n      if (!scoped) {\n        throw new Error(`Unable to resolve context: ${record.contextCorrelationId}`)\n      }\n\n      const job: WorkflowCommandJob = {\n        cmd: record.cmd,\n        thid: record.thid,\n        connectionId: record.connectionId,\n        idempotency_key: record.idempotencyKey,\n        payload: record.payload,\n        contextCorrelationId: record.contextCorrelationId,\n      }\n\n      try {\n        this.logger.info('[PersistentQueue] Processing command', {\n          cmd: record.cmd,\n          thid: record.thid,\n          attempts: record.attempts,\n        })\n      } catch {}\n      await this.onJobHandler!(job)\n\n      // Mark as completed in root context (commands are stored centrally)\n      await this.repository.markCompleted(this.rootContext, record)\n      try {\n        this.logger.info('[PersistentQueue] Completed command', {\n          cmd: record.cmd,\n          thid: record.thid,\n        })\n      } catch {}\n    } catch (err) {\n      const errorMsg = (err as Error).message || 'Unknown error'\n      const errCode = (err as unknown as { code?: string })?.code\n      if (this.running && this.logger && typeof this.logger.error === 'function') {\n        this.logger.error(`[PersistentQueue] Command processing failed: ${record.cmd} for ${record.thid}`, {\n          error: errorMsg,\n          attempts: record.attempts,\n        })\n      }\n      // Special deferral for missing template: keep retrying without exhausting attempts\n      if (errCode === 'invalid_template') {\n        try {\n          // Small backoff to avoid tight retry loop\n          await this.sleep(Math.min(1000, this.pollIntervalMs * 10))\n        } catch {}\n        try {\n          // Undo the attempt increment performed when marking processing\n          if (record.attempts > 0) record.attempts -= 1\n        } catch {}\n        await this.repository.resetToPending(this.rootContext, record)\n        try {\n          this.logger.info('[PersistentQueue] Deferred command due to missing template; reset to pending', {\n            cmd: record.cmd,\n            thid: record.thid,\n          })\n        } catch {}\n        return\n      }\n\n      // Mark as failed if max attempts reached, otherwise reset to pending for retry\n      if (record.attempts >= this.maxAttempts) {\n        await this.repository.markFailed(this.rootContext, record, errorMsg)\n      } else {\n        await this.repository.resetToPending(this.rootContext, record)\n        try {\n          this.logger.info('[PersistentQueue] Resetting command to pending for retry', {\n            cmd: record.cmd,\n            thid: record.thid,\n            attempts: record.attempts,\n          })\n        } catch {}\n      }\n    } finally {\n      // Always release scoped context if obtained\n      try {\n        await scoped?.release?.()\n      } catch {}\n      this.activeCount--\n    }\n  }\n\n  private async staleCheckLoop(): Promise<void> {\n    while (this.running) {\n      await this.sleep(this.staleCheckIntervalMs)\n      try {\n        const stale = await this.repository.findStale(this.rootContext, this.processingTimeoutMs)\n\n        for (const record of stale) {\n          this.logger.warn(`[PersistentQueue] Resetting stale command: ${record.cmd} for ${record.thid}`, {\n            attempts: record.attempts,\n            lastAttempt: record.lastAttemptAt?.toISOString(),\n          })\n\n          if (record.attempts >= this.maxAttempts) {\n            await this.repository.markFailed(this.rootContext, record, 'Stale after max attempts')\n          } else {\n            await this.repository.resetToPending(this.rootContext, record)\n          }\n        }\n      } catch (err) {\n        if (this.running && this.logger && typeof this.logger.error === 'function') {\n          this.logger.error('[PersistentQueue] Stale check error', { error: (err as Error).message })\n        }\n      }\n    }\n  }\n\n  private async cleanupLoop(): Promise<void> {\n    while (this.running) {\n      await this.sleep(this.cleanupIntervalMs)\n      try {\n        const completedCutoff = new Date(Date.now() - this.commandRetentionMs)\n        const failedCutoff = new Date(Date.now() - this.failedRetentionMs)\n\n        const [completedDeleted, failedDeleted] = await Promise.all([\n          this.repository.deleteCompleted(this.rootContext, completedCutoff),\n          this.repository.deleteFailed(this.rootContext, failedCutoff),\n        ])\n\n        if (completedDeleted > 0 || failedDeleted > 0) {\n          this.logger.debug(`[PersistentQueue] Cleanup: deleted ${completedDeleted} completed, ${failedDeleted} failed`)\n        }\n      } catch (err) {\n        if (this.running && this.logger && typeof this.logger.error === 'function') {\n          this.logger.error('[PersistentQueue] Cleanup error', { error: (err as Error).message })\n        }\n      }\n    }\n  }\n\n  private async resolveContext(\n    correlationId: string\n  ): Promise<{ context: AgentContext; release: () => Promise<void> } | null> {\n    const rootId = this.rootContext.contextCorrelationId\n\n    if (!correlationId || correlationId === rootId) {\n      return { context: this.rootContext, release: async () => {} }\n    }\n\n    try {\n      // Some inbound paths may enqueue with base context id (e.g., 'default').\n      // If we can resolve it, do so; otherwise, fall back to root tenant context so\n      // jobs in this queue are still processed under the tenant.\n      const scopedContext = await this.contextProvider.getAgentContextForContextCorrelationId(correlationId)\n      return {\n        context: scopedContext,\n        release: async () => {\n          try {\n            await this.contextProvider.endSessionForAgentContext(scopedContext)\n          } catch (error) {\n            this.logger.debug('[PersistentQueue] Failed to end tenant session', {\n              contextCorrelationId: correlationId,\n              error: (error as Error).message,\n            })\n          }\n        },\n      }\n    } catch (error) {\n      if (this.running && this.logger && typeof this.logger.error === 'function') {\n        this.logger.error('[PersistentQueue] Unable to resolve context, falling back to root', {\n          contextCorrelationId: correlationId,\n          error: (error as Error).message,\n        })\n      }\n      // Fallback: use the root agent context bound to this queue\n      return { context: this.rootContext, release: async () => {} }\n    }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((outerResolve) => {\n      const entry = { timer: undefined as unknown as NodeJS.Timeout, resolve: () => {} }\n      const resolve = () => {\n        try {\n          outerResolve()\n        } finally {\n          this.pendingSleeps.delete(entry)\n        }\n      }\n      entry.resolve = resolve\n      entry.timer = setTimeout(resolve, ms)\n      this.pendingSleeps.add(entry)\n    })\n  }\n\n  public async getMetrics(): Promise<{\n    pending: number\n    processing: number\n    completed: number\n    failed: number\n    active: number\n  }> {\n    const repoMetrics = await this.repository.getMetrics(this.rootContext)\n    return {\n      ...repoMetrics,\n      active: this.activeCount,\n    }\n  }\n}\n"],"mappings":"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"}

package/build/repository/WorkflowCommandRecord.d.mts

@@ -0,0 +1,50 @@
+import { BaseRecord, TagsBase } from "@credo-ts/core";
+
+//#region src/repository/WorkflowCommandRecord.d.ts
+type WorkflowCommandType = 'start' | 'advance' | 'pause' | 'resume' | 'cancel' | 'complete';
+type WorkflowCommandStatus = 'pending' | 'processing' | 'completed' | 'failed';
+interface WorkflowCommandRecordProps {
+  id?: string;
+  cmd: WorkflowCommandType;
+  thid: string;
+  connectionId?: string;
+  idempotencyKey?: string;
+  payload: Record<string, unknown>;
+  contextCorrelationId: string;
+  status?: WorkflowCommandStatus;
+  attempts?: number;
+  lastAttemptAt?: Date;
+  error?: string;
+  createdAt?: Date;
+  completedAt?: Date;
+}
+type WorkflowCommandRecordTags = TagsBase & {
+  status: WorkflowCommandStatus;
+  thid: string;
+  connectionId: string;
+  contextCorrelationId: string;
+  cmd: WorkflowCommandType;
+  templateId?: string;
+  templateVersion?: string;
+};
+declare class WorkflowCommandRecord extends BaseRecord<WorkflowCommandRecordTags, TagsBase> {
+  static readonly type: "WorkflowCommandRecord";
+  readonly type: "WorkflowCommandRecord";
+  cmd: WorkflowCommandType;
+  thid: string;
+  connectionId?: string;
+  idempotencyKey?: string;
+  payload: Record<string, unknown>;
+  contextCorrelationId: string;
+  status: WorkflowCommandStatus;
+  attempts: number;
+  lastAttemptAt?: Date;
+  error?: string;
+  createdAt: Date;
+  completedAt?: Date;
+  constructor(props: WorkflowCommandRecordProps);
+  getTags(): WorkflowCommandRecordTags;
+}
+//#endregion
+export { WorkflowCommandRecord, WorkflowCommandRecordProps, WorkflowCommandRecordTags, WorkflowCommandStatus, WorkflowCommandType };
+//# sourceMappingURL=WorkflowCommandRecord.d.mts.map

package/build/repository/WorkflowCommandRecord.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowCommandRecord.d.mts","names":[],"sources":["../../src/repository/WorkflowCommandRecord.ts"],"sourcesContent":[],"mappings":";;;KAIY,mBAAA;AAAA,KACA,qBAAA,GADmB,SAAA,GAAA,YAAA,GAAA,WAAA,GAAA,QAAA;AACnB,UAEK,0BAAA,CAFgB;EAEhB,EAAA,CAAA,EAAA,MAAA;EAEV,GAAA,EAAA,mBAAA;EAII,IAAA,EAAA,MAAA;EAGA,YAAA,CAAA,EAAA,MAAA;EAEO,cAAA,CAAA,EAAA,MAAA;EAGJ,OAAA,EARH,MAQG,CAAA,MAAA,EAAA,OAAA,CAAA;EACE,oBAAA,EAAA,MAAA;EAAI,MAAA,CAAA,EANT,qBAMS;EAGR,QAAA,CAAA,EAAA,MAAA;EAA4B,aAAA,CAAA,EAPtB,IAOsB;EAC9B,KAAA,CAAA,EAAA,MAAA;EAIH,SAAA,CAAA,EATO,IASP;EAAmB,WAAA,CAAA,EARV,IAQU;AAM1B;AAAsD,KAX1C,yBAAA,GAA4B,QAWc,GAAA;EAA2B,MAAA,EAVvE,qBAUuE;EAIlE,IAAA,EAAA,MAAA;EAII,YAAA,EAAA,MAAA;EAGD,oBAAA,EAAA,MAAA;EAEO,GAAA,EAnBlB,mBAmBkB;EAGJ,UAAA,CAAA,EAAA,MAAA;EACE,eAAA,CAAA,EAAA,MAAA;CAEK;AAsBR,cAzCP,qBAAA,SAA8B,UAyCvB,CAzCkC,yBAyClC,EAzC6D,QAyC7D,CAAA,CAAA;EAzCuB,gBAAA,IAAA,EAAA,uBAAA;EAAU,SAAA,IAAA,EAAA,uBAAA;OAItC;;;;WAII;;UAGD;;kBAEO;;aAGJ;gBACE;qBAEK;aAsBR"}

package/build/repository/WorkflowCommandRecord.mjs

@@ -0,0 +1,48 @@
+import { BaseRecord, utils } from "@credo-ts/core";
+
+//#region src/repository/WorkflowCommandRecord.ts
+var WorkflowCommandRecord = class WorkflowCommandRecord extends BaseRecord {
+	constructor(props) {
+		super();
+		this.type = WorkflowCommandRecord.type;
+		if (props) {
+			this.id = props.id ?? utils.uuid();
+			this.cmd = props.cmd;
+			this.thid = props.thid;
+			this.connectionId = props.connectionId;
+			this.idempotencyKey = props.idempotencyKey;
+			this.payload = props.payload;
+			this.contextCorrelationId = props.contextCorrelationId;
+			this.status = props.status ?? "pending";
+			this.attempts = props.attempts ?? 0;
+			this.lastAttemptAt = props.lastAttemptAt;
+			this.error = props.error;
+			this.createdAt = props.createdAt ?? /* @__PURE__ */ new Date();
+			this.completedAt = props.completedAt;
+		}
+	}
+	getTags() {
+		const base = {
+			...this._tags,
+			status: this.status,
+			thid: this.thid,
+			connectionId: this.connectionId ?? "",
+			contextCorrelationId: this.contextCorrelationId,
+			cmd: this.cmd
+		};
+		try {
+			if (this.cmd === "start") {
+				const tId = this.payload?.template_id;
+				const tVer = this.payload?.template_version;
+				if (tId) base.templateId = tId;
+				if (tVer) base.templateVersion = tVer;
+			}
+		} catch {}
+		return base;
+	}
+};
+WorkflowCommandRecord.type = "WorkflowCommandRecord";
+
+//#endregion
+export { WorkflowCommandRecord };
+//# sourceMappingURL=WorkflowCommandRecord.mjs.map

package/build/repository/WorkflowCommandRecord.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowCommandRecord.mjs","names":["base: WorkflowCommandRecordTags"],"sources":["../../src/repository/WorkflowCommandRecord.ts"],"sourcesContent":["import type { TagsBase } from '@credo-ts/core'\n\nimport { BaseRecord, utils } from '@credo-ts/core'\n\nexport type WorkflowCommandType = 'start' | 'advance' | 'pause' | 'resume' | 'cancel' | 'complete'\nexport type WorkflowCommandStatus = 'pending' | 'processing' | 'completed' | 'failed'\n\nexport interface WorkflowCommandRecordProps {\n  id?: string\n  cmd: WorkflowCommandType\n  thid: string\n  connectionId?: string\n  idempotencyKey?: string\n  payload: Record<string, unknown>\n  contextCorrelationId: string\n\n  status?: WorkflowCommandStatus\n  attempts?: number\n  lastAttemptAt?: Date\n  error?: string\n\n  createdAt?: Date\n  completedAt?: Date\n}\n\nexport type WorkflowCommandRecordTags = TagsBase & {\n  status: WorkflowCommandStatus\n  thid: string\n  connectionId: string\n  contextCorrelationId: string\n  cmd: WorkflowCommandType\n  // Optional filtering tags (populated for 'start' commands)\n  templateId?: string\n  templateVersion?: string\n}\n\nexport class WorkflowCommandRecord extends BaseRecord<WorkflowCommandRecordTags, TagsBase> {\n  public static readonly type = 'WorkflowCommandRecord' as const\n  public readonly type = WorkflowCommandRecord.type\n\n  public cmd!: WorkflowCommandType\n  public thid!: string\n  public connectionId?: string\n  public idempotencyKey?: string\n  public payload!: Record<string, unknown>\n  public contextCorrelationId!: string\n\n  public status!: WorkflowCommandStatus\n  public attempts!: number\n  public lastAttemptAt?: Date\n  public error?: string\n\n  public createdAt!: Date\n  public completedAt?: Date\n\n  public constructor(props: WorkflowCommandRecordProps) {\n    super()\n\n    if (props) {\n      this.id = props.id ?? utils.uuid()\n      this.cmd = props.cmd\n      this.thid = props.thid\n      this.connectionId = props.connectionId\n      this.idempotencyKey = props.idempotencyKey\n      this.payload = props.payload\n      this.contextCorrelationId = props.contextCorrelationId\n\n      this.status = props.status ?? 'pending'\n      this.attempts = props.attempts ?? 0\n      this.lastAttemptAt = props.lastAttemptAt\n      this.error = props.error\n\n      this.createdAt = props.createdAt ?? new Date()\n      this.completedAt = props.completedAt\n    }\n  }\n\n  public getTags(): WorkflowCommandRecordTags {\n    const base: WorkflowCommandRecordTags = {\n      ...this._tags,\n      status: this.status,\n      thid: this.thid,\n      connectionId: this.connectionId ?? '',\n      contextCorrelationId: this.contextCorrelationId,\n      cmd: this.cmd,\n    }\n    try {\n      if (this.cmd === 'start') {\n        const tId = (this.payload as { template_id?: string })?.template_id\n        const tVer = (this.payload as { template_version?: string })?.template_version\n        if (tId) (base as unknown as { templateId?: string }).templateId = tId\n        if (tVer) (base as unknown as { templateVersion?: string }).templateVersion = tVer\n      }\n    } catch {\n      /* noop */\n    }\n    return base\n  }\n}\n"],"mappings":";;;AAoCA,IAAa,wBAAb,MAAa,8BAA8B,WAAgD;CAmBzF,AAAO,YAAY,OAAmC;AACpD,SAAO;OAlBO,OAAO,sBAAsB;AAoB3C,MAAI,OAAO;AACT,QAAK,KAAK,MAAM,MAAM,MAAM,MAAM;AAClC,QAAK,MAAM,MAAM;AACjB,QAAK,OAAO,MAAM;AAClB,QAAK,eAAe,MAAM;AAC1B,QAAK,iBAAiB,MAAM;AAC5B,QAAK,UAAU,MAAM;AACrB,QAAK,uBAAuB,MAAM;AAElC,QAAK,SAAS,MAAM,UAAU;AAC9B,QAAK,WAAW,MAAM,YAAY;AAClC,QAAK,gBAAgB,MAAM;AAC3B,QAAK,QAAQ,MAAM;AAEnB,QAAK,YAAY,MAAM,6BAAa,IAAI,MAAM;AAC9C,QAAK,cAAc,MAAM;;;CAI7B,AAAO,UAAqC;EAC1C,MAAMA,OAAkC;GACtC,GAAG,KAAK;GACR,QAAQ,KAAK;GACb,MAAM,KAAK;GACX,cAAc,KAAK,gBAAgB;GACnC,sBAAsB,KAAK;GAC3B,KAAK,KAAK;GACX;AACD,MAAI;AACF,OAAI,KAAK,QAAQ,SAAS;IACxB,MAAM,MAAO,KAAK,SAAsC;IACxD,MAAM,OAAQ,KAAK,SAA2C;AAC9D,QAAI,IAAK,CAAC,KAA4C,aAAa;AACnE,QAAI,KAAM,CAAC,KAAiD,kBAAkB;;UAE1E;AAGR,SAAO;;;sBA3Dc,OAAO"}

package/build/repository/WorkflowCommandRepository.d.mts

@@ -0,0 +1,59 @@
+import { WorkflowCommandRecord } from "./WorkflowCommandRecord.mjs";
+import { AgentContext, EventEmitter, Repository, StorageService } from "@credo-ts/core";
+
+//#region src/repository/WorkflowCommandRepository.d.ts
+declare class WorkflowCommandRepository extends Repository<WorkflowCommandRecord> {
+  constructor(storageService: StorageService<WorkflowCommandRecord>, eventEmitter: EventEmitter);
+  /**
+   * Find pending commands (status='pending'), ordered by creation time
+   */
+  findPending(agentContext: AgentContext, limit?: number): Promise<WorkflowCommandRecord[]>;
+  /**
+   * Find pending 'start' commands for a specific template (and optional version)
+   */
+  findPendingStartsByTemplate(agentContext: AgentContext, templateId: string, version?: string): Promise<WorkflowCommandRecord[]>;
+  /**
+   * Find commands stuck in 'processing' state longer than timeoutMs
+   */
+  findStale(agentContext: AgentContext, timeoutMs: number): Promise<WorkflowCommandRecord[]>;
+  /**
+   * Find command by thid (thread ID / instance ID)
+   */
+  findByThid(agentContext: AgentContext, thid: string): Promise<WorkflowCommandRecord[]>;
+  /**
+   * Mark command as processing
+   */
+  markProcessing(agentContext: AgentContext, record: WorkflowCommandRecord): Promise<void>;
+  /**
+   * Mark command as completed
+   */
+  markCompleted(agentContext: AgentContext, record: WorkflowCommandRecord): Promise<void>;
+  /**
+   * Mark command as failed
+   */
+  markFailed(agentContext: AgentContext, record: WorkflowCommandRecord, error: string): Promise<void>;
+  /**
+   * Delete completed commands older than given date
+   */
+  deleteCompleted(agentContext: AgentContext, olderThan: Date): Promise<number>;
+  /**
+   * Delete failed commands older than given date
+   */
+  deleteFailed(agentContext: AgentContext, olderThan: Date): Promise<number>;
+  /**
+   * Reset stale command to pending for retry
+   */
+  resetToPending(agentContext: AgentContext, record: WorkflowCommandRecord): Promise<void>;
+  /**
+   * Get queue metrics
+   */
+  getMetrics(agentContext: AgentContext): Promise<{
+    pending: number;
+    processing: number;
+    completed: number;
+    failed: number;
+  }>;
+}
+//#endregion
+export { WorkflowCommandRepository };
+//# sourceMappingURL=WorkflowCommandRepository.d.mts.map

package/build/repository/WorkflowCommandRepository.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowCommandRepository.d.mts","names":[],"sources":["../../src/repository/WorkflowCommandRepository.ts"],"sourcesContent":[],"mappings":";;;;cAOa,yBAAA,SAAkC,WAAW;EAA7C,WAAA,CAAA,cAAA,EAEgD,cAFtB,CAEqC,qBAFrC,CAAA,EAAA,YAAA,EAGrB,YAHqB;EAAmB;;;EAGxC,WAAA,CAAA,YAAA,EAQuB,YARvB,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAQkD,OARlD,CAQ0D,qBAR1D,EAAA,CAAA;EAQuB;;;EAWvB,2BAAA,CAAA,YAAA,EAAA,YAAA,EAAA,UAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAGb,OAHa,CAGL,qBAHK,EAAA,CAAA;EAGL;;;EAeoE,SAAA,CAAA,YAAA,EAA1C,YAA0C,EAAA,SAAA,EAAA,MAAA,CAAA,EAAR,OAAQ,CAAA,qBAAA,EAAA,CAAA;EAAR;;;EAaJ,UAAA,CAAA,YAAA,EAA7B,YAA6B,EAAA,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA,CAAQ,qBAAR,EAAA,CAAA;EAOzB;;;EAUD,cAAA,CAAA,YAAA,EAVC,YAUD,EAAA,MAAA,EAVuB,qBAUvB,CAAA,EAV+C,OAU/C,CAAA,IAAA,CAAA;EAAsB;;;EAWrD,aAAA,CAAA,YAAA,EAX+B,YAW/B,EAAA,MAAA,EAXqD,qBAWrD,CAAA,EAX6E,OAW7E,CAAA,IAAA,CAAA;EAEP;;;EAUwE,UAAA,CAAA,YAAA,EAb3D,YAa2D,EAAA,MAAA,EAZjE,qBAYiE,EAAA,KAAA,EAAA,MAAA,CAAA,EAVxE,OAUwE,CAAA,IAAA,CAAA;EAiBnC;;;EAiBE,eAAA,CAAA,YAAA,EAlCC,YAkCD,EAAA,SAAA,EAlC0B,IAkC1B,CAAA,EAlCiC,OAkCjC,CAAA,MAAA,CAAA;EAAsB;;;EASX,YAAA,CAAA,YAAA,EA1Bb,YA0Ba,EAAA,SAAA,EA1BY,IA0BZ,CAAA,EA1BmB,OA0BnB,CAAA,MAAA,CAAA;EAxIR;;;+BA+HH,sBAAsB,wBAAwB;;;;2BASlD,eAAe"}