@cogitator-ai/workflows 0.8.0 → 0.10.0

package/dist/human/durable-approval-stores.js

@@ -0,0 +1,383 @@
+/**
+ * Durable approval stores: Redis and Postgres.
+ *
+ * A human node often waits in one process (a worker) while the answer is
+ * submitted from another (a web server), so `onResponse` both reacts to
+ * responses submitted through the same store instance and polls the backend
+ * for responses written elsewhere.
+ */
+import { createIfMissing, fromJson, TABLE_NAME } from '../postgres-schema.js';
+import { ApprovalAlreadyAnsweredError, submitOrExisting, withdrawnResponse, } from './approval-outcomes.js';
+const DEFAULT_POLL_INTERVAL = 1000;
+/**
+ * Approvals in Redis: requests and responses as JSON under their id, with
+ * sorted sets (scored by creation time) of pending request ids overall, per
+ * workflow and per assignee, so pending lookups never scan the keyspace.
+ */
+export class RedisApprovalStore {
+    client;
+    prefix;
+    watcher;
+    constructor(options) {
+        this.client = options.client;
+        this.prefix = options.keyPrefix ?? 'cogitator:workflow-approvals';
+        this.watcher = new ResponseWatcher((requestId) => this.getResponse(requestId), options);
+    }
+    async createRequest(request) {
+        const [previous, answered] = await Promise.all([
+            this.getRequest(request.id),
+            this.client.get(this.responseKey(request.id)),
+        ]);
+        await this.client.set(this.requestKey(request.id), JSON.stringify(request));
+        const indexes = answered === null ? this.pendingIndexes(request) : [];
+        if (previous) {
+            const outdated = this.pendingIndexes(previous).filter((key) => !indexes.includes(key));
+            await Promise.all(outdated.map((key) => this.client.zrem(key, request.id)));
+        }
+        await Promise.all(indexes.map((key) => this.client.zadd(key, request.createdAt, request.id)));
+    }
+    async getRequest(id) {
+        const raw = await this.client.get(this.requestKey(id));
+        return raw ? JSON.parse(raw) : null;
+    }
+    async getPendingRequests(workflowId) {
+        if (workflowId) {
+            return this.readPending(this.workflowIndexKey(workflowId), (request) => request.workflowId === workflowId);
+        }
+        return this.readPending(this.pendingKey(), () => true);
+    }
+    async getPendingForAssignee(assignee) {
+        return this.readPending(this.assigneeIndexKey(assignee), (request) => isAssignedTo(request, assignee));
+    }
+    /**
+     * Records the answer; the first answer wins (claimed by adding the request
+     * to the answered set), a later one throws `ApprovalAlreadyAnsweredError`.
+     */
+    async submitResponse(response) {
+        const claimed = await this.client.zadd(this.answeredKey(), Date.now(), response.requestId);
+        if (Number(claimed) !== 1) {
+            const existing = await this.getResponse(response.requestId);
+            throw new ApprovalAlreadyAnsweredError(response.requestId, existing ?? undefined);
+        }
+        await this.client.set(this.responseKey(response.requestId), JSON.stringify(response));
+        const request = await this.getRequest(response.requestId);
+        if (request) {
+            await Promise.all(this.pendingIndexes(request).map((key) => this.client.zrem(key, request.id)));
+        }
+        this.watcher.deliver(response);
+    }
+    async getResponse(requestId) {
+        const raw = await this.client.get(this.responseKey(requestId));
+        return raw ? JSON.parse(raw) : null;
+    }
+    /**
+     * Removes the request. A request nobody answered yet gets `withdrawnResponse`
+     * as its answer, which stays stored so waiters in other processes see it.
+     */
+    async deleteRequest(id) {
+        const request = await this.getRequest(id);
+        const pending = request !== null && (await this.getResponse(id)) === null;
+        if (pending) {
+            await submitOrExisting(this, withdrawnResponse(id));
+            await this.client.del(this.requestKey(id));
+        }
+        else {
+            this.watcher.cancel(id);
+            await this.client.del(this.requestKey(id), this.responseKey(id));
+            await this.client.zrem(this.answeredKey(), id);
+        }
+        if (request) {
+            await Promise.all(this.pendingIndexes(request).map((key) => this.client.zrem(key, id)));
+        }
+    }
+    onResponse(requestId, callback) {
+        return this.watcher.watch(requestId, callback);
+    }
+    /** Stop polling and drop every registered callback. */
+    dispose() {
+        this.watcher.dispose();
+    }
+    async readPending(indexKey, belongs) {
+        const ids = await this.client.zrange(indexKey, 0, -1);
+        if (ids.length === 0)
+            return [];
+        const [requests, responses] = await Promise.all([
+            this.client.mget(...ids.map((id) => this.requestKey(id))),
+            this.client.mget(...ids.map((id) => this.responseKey(id))),
+        ]);
+        const pending = [];
+        const stale = [];
+        ids.forEach((id, index) => {
+            const raw = requests[index];
+            const request = raw ? JSON.parse(raw) : null;
+            if (request && responses[index] === null && belongs(request))
+                pending.push(request);
+            else
+                stale.push(id);
+        });
+        if (stale.length > 0)
+            await this.client.zrem(indexKey, ...stale);
+        return pending;
+    }
+    pendingIndexes(request) {
+        const assignees = new Set(request.assigneeGroup ?? []);
+        if (request.assignee !== undefined)
+            assignees.add(request.assignee);
+        return [
+            this.pendingKey(),
+            this.workflowIndexKey(request.workflowId),
+            ...[...assignees].map((assignee) => this.assigneeIndexKey(assignee)),
+        ];
+    }
+    requestKey(id) {
+        return `${this.prefix}:request:${id}`;
+    }
+    answeredKey() {
+        return `${this.prefix}:answered`;
+    }
+    responseKey(requestId) {
+        return `${this.prefix}:response:${requestId}`;
+    }
+    pendingKey() {
+        return `${this.prefix}:pending`;
+    }
+    workflowIndexKey(workflowId) {
+        return `${this.prefix}:pending:workflow:${workflowId}`;
+    }
+    assigneeIndexKey(assignee) {
+        return `${this.prefix}:pending:assignee:${assignee}`;
+    }
+}
+/**
+ * Approvals in Postgres: a requests table with the workflow and assignees
+ * as indexed columns next to the JSONB request, and a responses table keyed
+ * by request id; pending means no matching response row.
+ */
+export class PostgresApprovalStore {
+    client;
+    requests;
+    responses;
+    indexPrefix;
+    watcher;
+    ready;
+    constructor(options) {
+        const prefix = options.tablePrefix ?? 'cogitator_workflow_approvals';
+        if (!TABLE_NAME.test(prefix)) {
+            throw new Error(`Invalid approval table prefix: ${prefix}`);
+        }
+        this.client = options.client;
+        this.requests = `${prefix}_requests`;
+        this.responses = `${prefix}_responses`;
+        this.indexPrefix = prefix.replace('.', '_');
+        this.watcher = new ResponseWatcher((requestId) => this.getResponse(requestId), options);
+    }
+    async createRequest(request) {
+        await this.ensureTables();
+        await this.client.query(`INSERT INTO ${this.requests} (id, workflow_id, assignee, assignee_group, created_at, data)
+       VALUES ($1, $2, $3, $4, $5, $6)
+       ON CONFLICT (id) DO UPDATE
+         SET workflow_id = EXCLUDED.workflow_id, assignee = EXCLUDED.assignee,
+             assignee_group = EXCLUDED.assignee_group, created_at = EXCLUDED.created_at,
+             data = EXCLUDED.data`, [
+            request.id,
+            request.workflowId,
+            request.assignee ?? null,
+            request.assigneeGroup ?? [],
+            request.createdAt,
+            JSON.stringify(request),
+        ]);
+    }
+    async getRequest(id) {
+        await this.ensureTables();
+        const { rows } = await this.client.query(`SELECT data FROM ${this.requests} WHERE id = $1`, [
+            id,
+        ]);
+        return rows[0] ? fromJson(rows[0].data) : null;
+    }
+    async getPendingRequests(workflowId) {
+        await this.ensureTables();
+        const { rows } = workflowId
+            ? await this.client.query(`SELECT r.data FROM ${this.requests} r
+           WHERE r.workflow_id = $1 AND ${this.unanswered()}
+           ORDER BY r.created_at, r.id`, [workflowId])
+            : await this.client.query(`SELECT r.data FROM ${this.requests} r
+           WHERE ${this.unanswered()}
+           ORDER BY r.created_at, r.id`);
+        return rows.map((row) => fromJson(row.data));
+    }
+    async getPendingForAssignee(assignee) {
+        await this.ensureTables();
+        const { rows } = await this.client.query(`SELECT r.data FROM ${this.requests} r
+       WHERE (r.assignee = $1 OR r.assignee_group @> ARRAY[$1]::text[]) AND ${this.unanswered()}
+       ORDER BY r.created_at, r.id`, [assignee]);
+        return rows.map((row) => fromJson(row.data));
+    }
+    /** Records the answer; the first answer wins, a later one throws `ApprovalAlreadyAnsweredError`. */
+    async submitResponse(response) {
+        await this.ensureTables();
+        const { rows } = await this.client.query(`INSERT INTO ${this.responses} (request_id, data)
+       VALUES ($1, $2)
+       ON CONFLICT (request_id) DO NOTHING
+       RETURNING request_id`, [response.requestId, JSON.stringify(response)]);
+        if (rows.length === 0) {
+            const existing = await this.getResponse(response.requestId);
+            throw new ApprovalAlreadyAnsweredError(response.requestId, existing ?? undefined);
+        }
+        this.watcher.deliver(response);
+    }
+    async getResponse(requestId) {
+        await this.ensureTables();
+        const { rows } = await this.client.query(`SELECT data FROM ${this.responses} WHERE request_id = $1`, [requestId]);
+        return rows[0] ? fromJson(rows[0].data) : null;
+    }
+    /**
+     * Removes the request. A request nobody answered yet gets `withdrawnResponse`
+     * as its answer, which stays stored so waiters in other processes see it.
+     */
+    async deleteRequest(id) {
+        await this.ensureTables();
+        const pending = (await this.getRequest(id)) !== null && (await this.getResponse(id)) === null;
+        if (pending) {
+            await submitOrExisting(this, withdrawnResponse(id));
+            await this.client.query(`DELETE FROM ${this.requests} WHERE id = $1`, [id]);
+            return;
+        }
+        this.watcher.cancel(id);
+        await this.client.query(`WITH removed AS (DELETE FROM ${this.responses} WHERE request_id = $1)
+       DELETE FROM ${this.requests} WHERE id = $1`, [id]);
+    }
+    onResponse(requestId, callback) {
+        return this.watcher.watch(requestId, callback);
+    }
+    /** Stop polling and drop every registered callback. */
+    dispose() {
+        this.watcher.dispose();
+    }
+    unanswered() {
+        return `NOT EXISTS (SELECT 1 FROM ${this.responses} s WHERE s.request_id = r.id)`;
+    }
+    ensureTables() {
+        this.ready ??= this.createTables().catch((error) => {
+            this.ready = undefined;
+            throw error;
+        });
+        return this.ready;
+    }
+    async createTables() {
+        const statements = [
+            `CREATE TABLE IF NOT EXISTS ${this.requests} (
+         id TEXT PRIMARY KEY,
+         workflow_id TEXT NOT NULL,
+         assignee TEXT,
+         assignee_group TEXT[] NOT NULL DEFAULT '{}',
+         created_at BIGINT NOT NULL,
+         data JSONB NOT NULL
+       )`,
+            `CREATE TABLE IF NOT EXISTS ${this.responses} (
+         request_id TEXT PRIMARY KEY,
+         data JSONB NOT NULL
+       )`,
+            `CREATE INDEX IF NOT EXISTS ${this.indexPrefix}_requests_workflow_idx
+         ON ${this.requests} (workflow_id, created_at)`,
+            `CREATE INDEX IF NOT EXISTS ${this.indexPrefix}_requests_assignee_idx
+         ON ${this.requests} (assignee)`,
+            `CREATE INDEX IF NOT EXISTS ${this.indexPrefix}_requests_assignee_group_idx
+         ON ${this.requests} USING GIN (assignee_group)`,
+        ];
+        for (const statement of statements)
+            await createIfMissing(this.client, statement);
+    }
+}
+/**
+ * Callbacks waiting for responses: delivered at once for responses submitted
+ * through the store, and found by polling for responses written elsewhere
+ * while at least one callback for the request is registered.
+ */
+class ResponseWatcher {
+    fetch;
+    watches = new Map();
+    pollInterval;
+    onPollError;
+    constructor(fetch, options) {
+        this.fetch = fetch;
+        this.pollInterval = options.pollInterval ?? DEFAULT_POLL_INTERVAL;
+        this.onPollError = options.onPollError;
+    }
+    watch(requestId, callback) {
+        let watch = this.watches.get(requestId);
+        if (!watch) {
+            watch = { listeners: new Set() };
+            this.watches.set(requestId, watch);
+            this.schedule(requestId, watch);
+        }
+        const listener = { callback };
+        watch.listeners.add(listener);
+        void this.check(requestId, watch);
+        const subscribed = watch;
+        return () => {
+            subscribed.listeners.delete(listener);
+            if (subscribed.listeners.size === 0)
+                this.stop(requestId, subscribed);
+        };
+    }
+    deliver(response) {
+        const watch = this.watches.get(response.requestId);
+        if (!watch)
+            return;
+        this.stop(response.requestId, watch);
+        const listeners = [...watch.listeners];
+        watch.listeners.clear();
+        for (const { callback } of listeners) {
+            try {
+                callback(response);
+            }
+            catch { }
+        }
+    }
+    cancel(requestId) {
+        const watch = this.watches.get(requestId);
+        if (!watch)
+            return;
+        this.stop(requestId, watch);
+        watch.listeners.clear();
+    }
+    dispose() {
+        for (const requestId of [...this.watches.keys()])
+            this.cancel(requestId);
+    }
+    stop(requestId, watch) {
+        if (watch.timer !== undefined)
+            clearTimeout(watch.timer);
+        watch.timer = undefined;
+        if (this.watches.get(requestId) === watch)
+            this.watches.delete(requestId);
+    }
+    schedule(requestId, watch) {
+        const timer = setTimeout(() => void this.poll(requestId, watch), this.pollInterval);
+        if (typeof timer === 'object' && 'unref' in timer)
+            timer.unref();
+        watch.timer = timer;
+    }
+    async poll(requestId, watch) {
+        watch.timer = undefined;
+        await this.check(requestId, watch);
+        if (this.watches.get(requestId) === watch)
+            this.schedule(requestId, watch);
+    }
+    async check(requestId, watch) {
+        let response;
+        try {
+            response = await this.fetch(requestId);
+        }
+        catch (error) {
+            this.onPollError?.(error, requestId);
+            return;
+        }
+        if (response && this.watches.get(requestId) === watch)
+            this.deliver(response);
+    }
+}
+function isAssignedTo(request, assignee) {
+    return request.assignee === assignee || (request.assigneeGroup?.includes(assignee) ?? false);
+}
+//# sourceMappingURL=durable-approval-stores.js.map

package/dist/human/durable-approval-stores.js.map

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

package/dist/human/human-node.d.ts

@@ -9,7 +9,7 @@
  * - Delegation support
  * - Priority-based routing
  */
-import type { WorkflowState, HumanNodeConfig, ApprovalResponse, ApprovalStore, ApprovalNotifier, ApprovalChoice, ApprovalChainStep } from '@cogitator-ai/types';
+import type { WorkflowState, HumanNodeConfig, ApprovalRequest, ApprovalResponse, ApprovalStore, ApprovalNotifier, ApprovalChoice, ApprovalChainStep } from '@cogitator-ai/types';
 /**
  * Context for human node execution
  */
@@ -19,6 +19,8 @@ export interface HumanNodeContext {
     nodeId: string;
     approvalStore: ApprovalStore;
     approvalNotifier?: ApprovalNotifier;
+    /** Called for every request created: the node's own, each chain step and escalations */
+    onApprovalRequired?: (request: ApprovalRequest) => void;
 }
 /**
  * Result of human node execution
@@ -30,15 +32,21 @@ export interface HumanNodeResult<S extends WorkflowState> {
     state: S;
     timedOut?: boolean;
     escalated?: boolean;
+    /** The request was deleted, or expired, before anyone answered */
+    withdrawn?: boolean;
 }
 /**
  * Execute a human approval node
  */
 export declare function executeHumanNode<S extends WorkflowState>(state: S, config: HumanNodeConfig<S>, context: HumanNodeContext): Promise<HumanNodeResult<S>>;
+/** A human node config with its name set, as the node factories return it. */
+export type NamedHumanNodeConfig<S extends WorkflowState> = HumanNodeConfig<S> & {
+    name: string;
+};
 /**
  * Create a human approval node factory
  */
-export declare function humanNode<S extends WorkflowState>(name: string, approval: HumanNodeConfig<S>['approval']): HumanNodeConfig<S>;
+export declare function humanNode<S extends WorkflowState>(name: string, approval: HumanNodeConfig<S>['approval']): NamedHumanNodeConfig<S>;
 /**
  * Create a simple approve/reject node
  */
@@ -49,7 +57,7 @@ export declare function approvalNode<S extends WorkflowState>(name: string, opti
     timeout?: number;
     timeoutAction?: 'approve' | 'reject' | 'fail';
     priority?: 'low' | 'normal' | 'high' | 'urgent';
-}): HumanNodeConfig<S>;
+}): NamedHumanNodeConfig<S>;
 /**
  * Create a multi-choice selection node
  */
@@ -60,7 +68,7 @@ export declare function choiceNode<S extends WorkflowState>(name: string, option
     assignee?: string | ((state: S) => string);
     timeout?: number;
     priority?: 'low' | 'normal' | 'high' | 'urgent';
-}): HumanNodeConfig<S>;
+}): NamedHumanNodeConfig<S>;
 /**
  * Create a free-form input node
  */
@@ -70,7 +78,7 @@ export declare function inputNode<S extends WorkflowState>(name: string, options
     assignee?: string | ((state: S) => string);
     timeout?: number;
     priority?: 'low' | 'normal' | 'high' | 'urgent';
-}): HumanNodeConfig<S>;
+}): NamedHumanNodeConfig<S>;
 /**
  * Create a rating node
  */
@@ -80,7 +88,7 @@ export declare function ratingNode<S extends WorkflowState>(name: string, option
     assignee?: string | ((state: S) => string);
     timeout?: number;
     priority?: 'low' | 'normal' | 'high' | 'urgent';
-}): HumanNodeConfig<S>;
+}): NamedHumanNodeConfig<S>;
 /**
  * Create an approval chain node
  */
@@ -89,7 +97,7 @@ export declare function chainNode<S extends WorkflowState>(name: string, options
     description?: string | ((state: S) => string);
     chain: ApprovalChainStep[];
     priority?: 'low' | 'normal' | 'high' | 'urgent';
-}): HumanNodeConfig<S>;
+}): NamedHumanNodeConfig<S>;
 /**
  * Create a manager → director → VP chain
  */
@@ -100,5 +108,5 @@ export declare function managementChain<S extends WorkflowState>(name: string, o
     director?: string;
     vp?: string;
     timeoutPerStep?: number;
-}): HumanNodeConfig<S>;
+}): NamedHumanNodeConfig<S>;
 //# sourceMappingURL=human-node.d.ts.map

package/dist/human/human-node.d.ts.map

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