@sprinterai/runtime 0.7.1 → 0.8.0

package/dist/workflow/claim-manager.js

@@ -0,0 +1,31 @@
+/** Default maximum claim duration before a node run is considered stale. */
+export const DEFAULT_CLAIM_TIMEOUT_MS = 15 * 60_000; // 15 minutes
+/**
+ * Expire workflow node run claims that have been held longer than `maxDurationMs`.
+ * Stale claims block workflow progress — expiring them resets the nodes so they
+ * can be claimed and retried.
+ *
+ * @param store - The workflow run store.
+ * @param maxDurationMs - Claims older than this (in ms) are expired. Defaults to 15 minutes.
+ * @returns The number of claims expired.
+ */
+export async function expireStaleWorkflowNodeClaims(store, maxDurationMs = DEFAULT_CLAIM_TIMEOUT_MS) {
+    const expired = await store.expireStaleNodeClaims(maxDurationMs);
+    return expired.length;
+}
+/**
+ * Check whether any node runs in a set are currently claimed (running).
+ * Useful for deciding whether to advance a workflow or wait.
+ */
+export function hasActiveClaims(nodeRuns) {
+    return nodeRuns.some((n) => n.status === 'running' && n.claimed_by !== null);
+}
+/**
+ * Filter node runs to those whose claims have exceeded the timeout threshold.
+ * Useful for monitoring or manual expiry flows.
+ */
+export function findStaleNodeRuns(nodeRuns, maxDurationMs = DEFAULT_CLAIM_TIMEOUT_MS) {
+    const cutoff = new Date(Date.now() - maxDurationMs).toISOString();
+    return nodeRuns.filter((n) => n.status === 'running' && n.claimed_at !== null && n.claimed_at < cutoff);
+}
+//# sourceMappingURL=claim-manager.js.map

package/dist/workflow/claim-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-manager.js","sourceRoot":"","sources":["../../src/workflow/claim-manager.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,aAAa;AAElE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAsD,EACtD,gBAAwB,wBAAwB;IAEhD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiC;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiC,EACjC,gBAAwB,wBAAwB;IAEhD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,GAAG,MAAM,CAChF,CAAC;AACJ,CAAC"}

package/dist/workflow/claim-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claim-manager.test.d.ts.map

package/dist/workflow/claim-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-manager.test.d.ts","sourceRoot":"","sources":["../../src/workflow/claim-manager.test.ts"],"names":[],"mappings":""}

package/dist/workflow/claim-manager.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, vi } from 'vitest';
+import { expireStaleWorkflowNodeClaims, hasActiveClaims, findStaleNodeRuns, DEFAULT_CLAIM_TIMEOUT_MS, } from './claim-manager.js';
+function makeNodeRun(overrides) {
+    return {
+        workflow_run_id: 'run-1',
+        entity_id: 'entity-1',
+        tenant_id: 'tenant-1',
+        node_key: 'node-1',
+        node_type: 'agent_task',
+        label: 'Test Node',
+        field_name: null,
+        block_id: null,
+        output_type: 'field',
+        assignee_type: null,
+        assignee_agent_slug: null,
+        depends_on: [],
+        instructions: null,
+        metadata: null,
+        error_message: null,
+        claimed_by: null,
+        claimed_at: null,
+        attempt_count: 0,
+        started_at: null,
+        completed_at: null,
+        duration_ms: null,
+        created_at: '2026-01-01T10:00:00Z',
+        ...overrides,
+    };
+}
+describe('DEFAULT_CLAIM_TIMEOUT_MS', () => {
+    it('is 15 minutes', () => {
+        expect(DEFAULT_CLAIM_TIMEOUT_MS).toBe(15 * 60_000);
+    });
+});
+describe('expireStaleWorkflowNodeClaims', () => {
+    it('calls expireStaleNodeClaims with provided timeout', async () => {
+        const expired = [makeNodeRun({ id: 'n1', status: 'running' })];
+        const store = { expireStaleNodeClaims: vi.fn(async () => expired) };
+        const count = await expireStaleWorkflowNodeClaims(store, 30_000);
+        expect(store.expireStaleNodeClaims).toHaveBeenCalledWith(30_000);
+        expect(count).toBe(1);
+    });
+    it('uses default timeout when not provided', async () => {
+        const store = { expireStaleNodeClaims: vi.fn(async () => []) };
+        await expireStaleWorkflowNodeClaims(store);
+        expect(store.expireStaleNodeClaims).toHaveBeenCalledWith(DEFAULT_CLAIM_TIMEOUT_MS);
+    });
+    it('returns 0 when no claims were expired', async () => {
+        const store = { expireStaleNodeClaims: vi.fn(async () => []) };
+        const count = await expireStaleWorkflowNodeClaims(store, 60_000);
+        expect(count).toBe(0);
+    });
+    it('returns the count of expired claims', async () => {
+        const store = {
+            expireStaleNodeClaims: vi.fn(async () => [
+                makeNodeRun({ id: 'n1', status: 'running' }),
+                makeNodeRun({ id: 'n2', status: 'running' }),
+                makeNodeRun({ id: 'n3', status: 'running' }),
+            ]),
+        };
+        const count = await expireStaleWorkflowNodeClaims(store, 60_000);
+        expect(count).toBe(3);
+    });
+});
+describe('hasActiveClaims', () => {
+    it('returns true when a running node is claimed', () => {
+        const nodes = [makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1' })];
+        expect(hasActiveClaims(nodes)).toBe(true);
+    });
+    it('returns false when no nodes are claimed', () => {
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'pending' }),
+            makeNodeRun({ id: 'n2', status: 'completed' }),
+        ];
+        expect(hasActiveClaims(nodes)).toBe(false);
+    });
+    it('returns false when running but claimed_by is null', () => {
+        const nodes = [makeNodeRun({ id: 'n1', status: 'running', claimed_by: null })];
+        expect(hasActiveClaims(nodes)).toBe(false);
+    });
+    it('returns false for empty array', () => {
+        expect(hasActiveClaims([])).toBe(false);
+    });
+});
+describe('findStaleNodeRuns', () => {
+    it('returns nodes claimed before the cutoff', () => {
+        const staleAt = new Date(Date.now() - 20 * 60_000).toISOString(); // 20 min ago
+        const recentAt = new Date(Date.now() - 5 * 60_000).toISOString(); // 5 min ago
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1', claimed_at: staleAt }),
+            makeNodeRun({ id: 'n2', status: 'running', claimed_by: 'agent-1', claimed_at: recentAt }),
+        ];
+        const stale = findStaleNodeRuns(nodes, 15 * 60_000);
+        expect(stale).toHaveLength(1);
+        expect(stale[0].id).toBe('n1');
+    });
+    it('excludes non-running nodes', () => {
+        const oldAt = new Date(Date.now() - 60 * 60_000).toISOString();
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'pending', claimed_at: oldAt }),
+            makeNodeRun({ id: 'n2', status: 'completed', claimed_at: oldAt }),
+            makeNodeRun({ id: 'n3', status: 'running', claimed_by: 'agent-1', claimed_at: oldAt }),
+        ];
+        const stale = findStaleNodeRuns(nodes);
+        expect(stale).toHaveLength(1);
+        expect(stale[0].id).toBe('n3');
+    });
+    it('returns empty array when no stale nodes', () => {
+        const recentAt = new Date(Date.now() - 1000).toISOString();
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1', claimed_at: recentAt }),
+        ];
+        const stale = findStaleNodeRuns(nodes, 15 * 60_000);
+        expect(stale).toHaveLength(0);
+    });
+    it('uses DEFAULT_CLAIM_TIMEOUT_MS when not specified', () => {
+        const staleAt = new Date(Date.now() - 20 * 60_000).toISOString();
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1', claimed_at: staleAt }),
+        ];
+        expect(findStaleNodeRuns(nodes)).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=claim-manager.test.js.map

package/dist/workflow/claim-manager.test.js.map

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

package/dist/workflow/index.d.ts

@@ -11,4 +11,7 @@ export { createNodeExecutor } from './create-node-executor.js';
 export type { CreateNodeExecutorOptions } from './create-node-executor.js';
 export { runEntityWorkflow } from './run-entity-workflow.js';
 export type { RunEntityWorkflowOptions } from './run-entity-workflow.js';
+export { getWorkflowRunHistory, getActiveWorkflowRuns, getRecentWorkflowRuns, getWorkflowActivitySummary, } from './run-queries.js';
+export type { WorkflowActivitySummary } from './run-queries.js';
+export { expireStaleWorkflowNodeClaims, hasActiveClaims, findStaleNodeRuns, DEFAULT_CLAIM_TIMEOUT_MS, } from './claim-manager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EACL,6BAA6B,EAC7B,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/workflow/index.js

@@ -5,4 +5,8 @@ export { runWorkflow } from './workflow-runner.js';
 export { extractValueFromText, isEmptyFieldValue } from './field-recovery.js';
 export { createNodeExecutor } from './create-node-executor.js';
 export { runEntityWorkflow } from './run-entity-workflow.js';
+// ─── Run Queries ────────────────────────────────────────────
+export { getWorkflowRunHistory, getActiveWorkflowRuns, getRecentWorkflowRuns, getWorkflowActivitySummary, } from './run-queries.js';
+// ─── Claim Manager ──────────────────────────────────────────
+export { expireStaleWorkflowNodeClaims, hasActiveClaims, findStaleNodeRuns, DEFAULT_CLAIM_TIMEOUT_MS, } from './claim-manager.js';
 //# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,+DAA+D;AAC/D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAGvB,+DAA+D;AAC/D,OAAO,EACL,6BAA6B,EAC7B,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/workflow/run-queries.d.ts

@@ -0,0 +1,45 @@
+import type { WorkflowRunRecord, WorkflowRunStore } from '@sprinterai/core';
+export interface WorkflowActivitySummary {
+    /** Runs currently in progress (running, waiting_human, partial). */
+    active: number;
+    /** Runs waiting for human input. */
+    waitingHuman: number;
+    /** Runs completed today (since midnight UTC). */
+    completedToday: number;
+    /** Runs that failed today (since midnight UTC). */
+    failedToday: number;
+}
+/**
+ * Get the run history for a specific entity, ordered most-recent first.
+ * @param store - The workflow run store.
+ * @param entityId - The entity to query.
+ * @param options.limit - Maximum number of runs to return (default 20).
+ */
+export declare function getWorkflowRunHistory(store: Pick<WorkflowRunStore, 'listWorkflowRuns'>, entityId: string, options?: {
+    limit?: number;
+}): Promise<WorkflowRunRecord[]>;
+/**
+ * Get all currently active workflow runs for a tenant.
+ * Active = running, waiting_human, or partial.
+ * @param store - The workflow run store (already tenant-scoped).
+ * @param _tenantId - Tenant ID (informational; the store is already scoped).
+ * @param options.limit - Per-status limit before merging (default 50).
+ */
+export declare function getActiveWorkflowRuns(store: Pick<WorkflowRunStore, 'listWorkflowRuns'>, _tenantId: string, options?: {
+    limit?: number;
+}): Promise<WorkflowRunRecord[]>;
+/**
+ * Get recently completed or failed workflow runs, most-recent first.
+ * @param store - The workflow run store (already tenant-scoped).
+ * @param _tenantId - Tenant ID (informational; the store is already scoped).
+ * @param limit - Maximum number of runs to return (default 20).
+ */
+export declare function getRecentWorkflowRuns(store: Pick<WorkflowRunStore, 'listWorkflowRuns'>, _tenantId: string, limit?: number): Promise<WorkflowRunRecord[]>;
+/**
+ * Get aggregate activity counts for an entity's workflow runs.
+ * Useful for displaying summary dashboards.
+ * @param store - The workflow run store.
+ * @param entityId - The entity to summarize.
+ */
+export declare function getWorkflowActivitySummary(store: Pick<WorkflowRunStore, 'listWorkflowRuns'>, entityId: string): Promise<WorkflowActivitySummary>;
+//# sourceMappingURL=run-queries.d.ts.map

package/dist/workflow/run-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-queries.d.ts","sourceRoot":"","sources":["../../src/workflow/run-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAqB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAS/F,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,EACjD,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAE9B;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,EACjD,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAe9B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,EACjD,SAAS,EAAE,MAAM,EACjB,KAAK,SAAK,GACT,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAa9B;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,EACjD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,CAAC,CA6BlC"}

package/dist/workflow/run-queries.js

@@ -0,0 +1,80 @@
+// Active statuses — runs that are still in progress
+const ACTIVE_STATUSES = ['running', 'waiting_human', 'partial'];
+// Terminal statuses — runs that have finished
+const TERMINAL_STATUSES = ['completed', 'failed'];
+// ─── Query functions ─────────────────────────────────────────
+/**
+ * Get the run history for a specific entity, ordered most-recent first.
+ * @param store - The workflow run store.
+ * @param entityId - The entity to query.
+ * @param options.limit - Maximum number of runs to return (default 20).
+ */
+export async function getWorkflowRunHistory(store, entityId, options = {}) {
+    return store.listWorkflowRuns({ entityId, limit: options.limit ?? 20 });
+}
+/**
+ * Get all currently active workflow runs for a tenant.
+ * Active = running, waiting_human, or partial.
+ * @param store - The workflow run store (already tenant-scoped).
+ * @param _tenantId - Tenant ID (informational; the store is already scoped).
+ * @param options.limit - Per-status limit before merging (default 50).
+ */
+export async function getActiveWorkflowRuns(store, _tenantId, options = {}) {
+    const perStatusLimit = options.limit ?? 50;
+    const results = await Promise.all(ACTIVE_STATUSES.map((status) => store.listWorkflowRuns({ status, limit: perStatusLimit })));
+    return results
+        .flat()
+        .sort((a, b) => {
+        const aTime = a.started_at ?? a.created_at ?? '';
+        const bTime = b.started_at ?? b.created_at ?? '';
+        return bTime.localeCompare(aTime);
+    })
+        .slice(0, perStatusLimit);
+}
+/**
+ * Get recently completed or failed workflow runs, most-recent first.
+ * @param store - The workflow run store (already tenant-scoped).
+ * @param _tenantId - Tenant ID (informational; the store is already scoped).
+ * @param limit - Maximum number of runs to return (default 20).
+ */
+export async function getRecentWorkflowRuns(store, _tenantId, limit = 20) {
+    const results = await Promise.all(TERMINAL_STATUSES.map((status) => store.listWorkflowRuns({ status, limit })));
+    return results
+        .flat()
+        .sort((a, b) => {
+        const aTime = a.completed_at ?? a.created_at ?? '';
+        const bTime = b.completed_at ?? b.created_at ?? '';
+        return bTime.localeCompare(aTime);
+    })
+        .slice(0, limit);
+}
+/**
+ * Get aggregate activity counts for an entity's workflow runs.
+ * Useful for displaying summary dashboards.
+ * @param store - The workflow run store.
+ * @param entityId - The entity to summarize.
+ */
+export async function getWorkflowActivitySummary(store, entityId) {
+    const todayMidnight = new Date();
+    todayMidnight.setUTCHours(0, 0, 0, 0);
+    const todayIso = todayMidnight.toISOString();
+    const [activeRuns, completedAll, failedAll] = await Promise.all([
+        // Get all active runs for this entity
+        Promise.all(ACTIVE_STATUSES.map((status) => store.listWorkflowRuns({ entityId, status, limit: 1000 }))),
+        // Get completed runs to filter by today
+        store.listWorkflowRuns({ entityId, status: 'completed', limit: 1000 }),
+        // Get failed runs to filter by today
+        store.listWorkflowRuns({ entityId, status: 'failed', limit: 1000 }),
+    ]);
+    const allActive = activeRuns.flat();
+    const waitingHuman = allActive.filter((r) => r.status === 'waiting_human');
+    const completedToday = completedAll.filter((r) => (r.completed_at ?? r.created_at ?? '') >= todayIso);
+    const failedToday = failedAll.filter((r) => (r.completed_at ?? r.created_at ?? '') >= todayIso);
+    return {
+        active: allActive.length,
+        waitingHuman: waitingHuman.length,
+        completedToday: completedToday.length,
+        failedToday: failedToday.length,
+    };
+}
+//# sourceMappingURL=run-queries.js.map

package/dist/workflow/run-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-queries.js","sourceRoot":"","sources":["../../src/workflow/run-queries.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,MAAM,eAAe,GAAwB,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;AACrF,8CAA8C;AAC9C,MAAM,iBAAiB,GAAwB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAevE,gEAAgE;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiD,EACjD,QAAgB,EAChB,UAA8B,EAAE;IAEhC,OAAO,KAAK,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiD,EACjD,SAAiB,EACjB,UAA8B,EAAE;IAEhC,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAE3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAC3F,CAAC;IAEF,OAAO,OAAO;SACX,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiD,EACjD,SAAiB,EACjB,KAAK,GAAG,EAAE;IAEV,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAC7E,CAAC;IAEF,OAAO,OAAO;SACX,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAiD,EACjD,QAAgB;IAEhB,MAAM,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,aAAa,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAE7C,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9D,sCAAsC;QACtC,OAAO,CAAC,GAAG,CACT,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAC3F;QACD,wCAAwC;QACxC,KAAK,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACtE,qCAAqC;QACrC,KAAK,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,eAAe,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,IAAI,QAAQ,CAC1D,CAAC;IACF,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC;IAEhG,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,cAAc,EAAE,cAAc,CAAC,MAAM;QACrC,WAAW,EAAE,WAAW,CAAC,MAAM;KAChC,CAAC;AACJ,CAAC"}

package/dist/workflow/run-queries.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-queries.test.d.ts.map

package/dist/workflow/run-queries.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-queries.test.d.ts","sourceRoot":"","sources":["../../src/workflow/run-queries.test.ts"],"names":[],"mappings":""}

package/dist/workflow/run-queries.test.js

@@ -0,0 +1,177 @@
+import { describe, it, expect, vi } from 'vitest';
+import { getWorkflowRunHistory, getActiveWorkflowRuns, getRecentWorkflowRuns, getWorkflowActivitySummary, } from './run-queries.js';
+function makeRun(overrides) {
+    return {
+        entity_id: 'entity-1',
+        tenant_id: 'tenant-1',
+        trigger_type: 'manual',
+        metadata: null,
+        started_at: '2026-01-01T10:00:00Z',
+        completed_at: null,
+        created_at: '2026-01-01T10:00:00Z',
+        duration_ms: null,
+        ...overrides,
+    };
+}
+function makeStore(runsByStatus) {
+    return {
+        listWorkflowRuns: vi.fn(async ({ status, entityId } = {}) => {
+            let pool = status ? (runsByStatus[status] ?? []) : Object.values(runsByStatus).flat();
+            if (entityId)
+                pool = pool.filter((r) => r.entity_id === entityId);
+            return pool;
+        }),
+    };
+}
+describe('getWorkflowRunHistory', () => {
+    it('returns runs for the entity ordered by store', async () => {
+        const runs = [
+            makeRun({ id: 'r1', status: 'completed', entity_id: 'entity-1' }),
+            makeRun({ id: 'r2', status: 'failed', entity_id: 'entity-1' }),
+        ];
+        const store = makeStore({ completed: [runs[0]], failed: [runs[1]] });
+        const result = await getWorkflowRunHistory(store, 'entity-1');
+        expect(store.listWorkflowRuns).toHaveBeenCalledWith({
+            entityId: 'entity-1',
+            limit: 20,
+        });
+        expect(result.length).toBeGreaterThanOrEqual(0);
+    });
+    it('uses custom limit', async () => {
+        const store = makeStore({});
+        await getWorkflowRunHistory(store, 'entity-1', { limit: 5 });
+        expect(store.listWorkflowRuns).toHaveBeenCalledWith({ entityId: 'entity-1', limit: 5 });
+    });
+});
+describe('getActiveWorkflowRuns', () => {
+    it('queries running, waiting_human, and partial statuses', async () => {
+        const store = makeStore({
+            running: [makeRun({ id: 'r1', status: 'running' })],
+            waiting_human: [makeRun({ id: 'r2', status: 'waiting_human' })],
+            partial: [makeRun({ id: 'r3', status: 'partial' })],
+        });
+        const result = await getActiveWorkflowRuns(store, 'tenant-1');
+        const calledStatuses = store.listWorkflowRuns.mock.calls
+            .map((c) => c[0]?.status)
+            .filter(Boolean);
+        expect(calledStatuses).toContain('running');
+        expect(calledStatuses).toContain('waiting_human');
+        expect(calledStatuses).toContain('partial');
+        expect(result).toHaveLength(3);
+    });
+    it('deduplicates and sorts by started_at descending', async () => {
+        const store = makeStore({
+            running: [
+                makeRun({ id: 'r1', status: 'running', started_at: '2026-01-01T09:00:00Z' }),
+                makeRun({ id: 'r2', status: 'running', started_at: '2026-01-01T11:00:00Z' }),
+            ],
+            waiting_human: [],
+            partial: [],
+        });
+        const result = await getActiveWorkflowRuns(store, 'tenant-1');
+        expect(result[0].id).toBe('r2'); // most recent first
+        expect(result[1].id).toBe('r1');
+    });
+    it('respects limit option', async () => {
+        const store = makeStore({
+            running: Array.from({ length: 10 }, (_, i) => makeRun({ id: `r${i}`, status: 'running' })),
+            waiting_human: [],
+            partial: [],
+        });
+        const result = await getActiveWorkflowRuns(store, 'tenant-1', { limit: 3 });
+        expect(result).toHaveLength(3);
+    });
+    it('returns empty array when no active runs', async () => {
+        const store = makeStore({ running: [], waiting_human: [], partial: [] });
+        const result = await getActiveWorkflowRuns(store, 'tenant-1');
+        expect(result).toHaveLength(0);
+    });
+});
+describe('getRecentWorkflowRuns', () => {
+    it('queries completed and failed statuses', async () => {
+        const store = makeStore({
+            completed: [makeRun({ id: 'r1', status: 'completed' })],
+            failed: [makeRun({ id: 'r2', status: 'failed' })],
+        });
+        const result = await getRecentWorkflowRuns(store, 'tenant-1');
+        const calledStatuses = store.listWorkflowRuns.mock.calls
+            .map((c) => c[0]?.status)
+            .filter(Boolean);
+        expect(calledStatuses).toContain('completed');
+        expect(calledStatuses).toContain('failed');
+        expect(result).toHaveLength(2);
+    });
+    it('sorts by completed_at descending', async () => {
+        const store = makeStore({
+            completed: [
+                makeRun({ id: 'r1', status: 'completed', completed_at: '2026-01-01T08:00:00Z' }),
+                makeRun({ id: 'r2', status: 'completed', completed_at: '2026-01-01T12:00:00Z' }),
+            ],
+            failed: [],
+        });
+        const result = await getRecentWorkflowRuns(store, 'tenant-1');
+        expect(result[0].id).toBe('r2');
+        expect(result[1].id).toBe('r1');
+    });
+    it('respects limit parameter', async () => {
+        const store = makeStore({
+            completed: Array.from({ length: 10 }, (_, i) => makeRun({ id: `r${i}`, status: 'completed' })),
+            failed: [],
+        });
+        const result = await getRecentWorkflowRuns(store, 'tenant-1', 3);
+        expect(result).toHaveLength(3);
+    });
+});
+describe('getWorkflowActivitySummary', () => {
+    it('counts active, waitingHuman, completedToday, failedToday', async () => {
+        const todayIso = new Date().toISOString();
+        const yesterdayIso = new Date(Date.now() - 86400000).toISOString();
+        const store = makeStore({
+            running: [makeRun({ id: 'r1', status: 'running', entity_id: 'entity-1' })],
+            waiting_human: [makeRun({ id: 'r2', status: 'waiting_human', entity_id: 'entity-1' })],
+            partial: [],
+            completed: [
+                makeRun({
+                    id: 'r3',
+                    status: 'completed',
+                    entity_id: 'entity-1',
+                    completed_at: todayIso,
+                }),
+                makeRun({
+                    id: 'r4',
+                    status: 'completed',
+                    entity_id: 'entity-1',
+                    completed_at: yesterdayIso,
+                }),
+            ],
+            failed: [
+                makeRun({
+                    id: 'r5',
+                    status: 'failed',
+                    entity_id: 'entity-1',
+                    completed_at: todayIso,
+                }),
+            ],
+        });
+        const summary = await getWorkflowActivitySummary(store, 'entity-1');
+        expect(summary.active).toBe(2); // running + waiting_human
+        expect(summary.waitingHuman).toBe(1);
+        expect(summary.completedToday).toBe(1); // only r3 (r4 was yesterday)
+        expect(summary.failedToday).toBe(1);
+    });
+    it('returns zeros when no runs exist', async () => {
+        const store = makeStore({
+            running: [],
+            waiting_human: [],
+            partial: [],
+            completed: [],
+            failed: [],
+        });
+        const summary = await getWorkflowActivitySummary(store, 'entity-1');
+        expect(summary.active).toBe(0);
+        expect(summary.waitingHuman).toBe(0);
+        expect(summary.completedToday).toBe(0);
+        expect(summary.failedToday).toBe(0);
+    });
+});
+//# sourceMappingURL=run-queries.test.js.map

package/dist/workflow/run-queries.test.js.map

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