@cogitator-ai/worker 0.3.20 → 0.5.0

package/dist/processors/swarm.js

@@ -3,64 +3,89 @@
  *
  * Recreates a Swarm from serialized config and executes it.
  */
-import { Cogitator, Agent } from '@cogitator-ai/core';
 import { Swarm } from '@cogitator-ai/swarms';
-import { recreateTools } from './shared.js';
-function recreateAgent(config) {
-    const tools = recreateTools(config.tools);
-    return new Agent({
-        name: config.name,
-        model: `${config.provider}/${config.model}`,
-        instructions: config.instructions,
-        temperature: config.temperature,
-        maxTokens: config.maxTokens,
-        tools,
-    });
-}
-function getStrategyType(topology) {
-    switch (topology) {
+import { createAgentFromConfig, resolveCogitator } from './shared.js';
+const DEFAULT_MAX_ROUNDS = 3;
+/**
+ * Translate a serialized swarm topology into a full swarm configuration.
+ */
+export function buildSwarmConfig(serialized, runtime, name = `worker-swarm-${Date.now()}`) {
+    const create = (agent) => createAgentFromConfig(agent, runtime);
+    const agents = serialized.agents.map(create);
+    const coordinator = serialized.coordinator ? create(serialized.coordinator) : undefined;
+    const maxRounds = serialized.maxRounds ?? DEFAULT_MAX_ROUNDS;
+    switch (serialized.topology) {
         case 'sequential':
-            return 'pipeline';
+            return {
+                name,
+                strategy: 'pipeline',
+                pipeline: { stages: agents.map((agent) => ({ name: agent.name, agent })) },
+            };
         case 'hierarchical':
-            return 'hierarchical';
-        case 'collaborative':
-            return 'round-robin';
+            if (!coordinator) {
+                throw new Error("Swarm topology 'hierarchical' requires a coordinator agent");
+            }
+            return { name, strategy: 'hierarchical', supervisor: coordinator, workers: agents };
         case 'debate':
-            return 'debate';
+            return {
+                name,
+                strategy: 'debate',
+                agents,
+                moderator: coordinator,
+                debate: { rounds: maxRounds },
+            };
         case 'voting':
-            return 'consensus';
-        default:
-            return 'round-robin';
+            return {
+                name,
+                strategy: 'consensus',
+                agents,
+                supervisor: coordinator,
+                consensus: {
+                    threshold: serialized.consensusThreshold ?? 0.5,
+                    maxRounds,
+                    resolution: 'majority',
+                    onNoConsensus: coordinator ? 'supervisor-decides' : 'escalate',
+                },
+            };
+        case 'collaborative':
+            return { name, strategy: 'round-robin', agents };
+        default: {
+            const exhaustive = serialized.topology;
+            throw new Error(`Unknown swarm topology: ${String(exhaustive)}`);
+        }
     }
 }
-export async function processSwarmJob(payload) {
-    const { swarmConfig, input } = payload;
-    const cogitator = new Cogitator();
-    const agents = swarmConfig.agents.map(recreateAgent);
-    const strategyType = getStrategyType(swarmConfig.topology);
-    const config = {
-        name: `worker-swarm-${Date.now()}`,
-        agents,
-        strategy: strategyType,
-    };
-    const swarm = new Swarm(cogitator, config);
-    const result = await swarm.run({
-        input,
-    });
-    const agentOutputs = [];
-    if (result.agentResults) {
-        for (const [agentId, runResult] of result.agentResults) {
-            agentOutputs.push({
-                agent: agentId,
-                output: runResult.output,
-            });
+function countRounds(config, votes) {
+    if (config.strategy === 'debate')
+        return config.debate?.rounds ?? 1;
+    if (config.strategy === 'consensus' && votes) {
+        const rounds = new Set();
+        for (const key of votes.keys()) {
+            const match = /_round(\d+)$/.exec(key);
+            if (match)
+                rounds.add(Number(match[1]));
         }
+        return Math.max(rounds.size, 1);
+    }
+    return 1;
+}
+export async function processSwarmJob(payload, runtime = {}) {
+    const config = buildSwarmConfig(payload.swarmConfig, runtime, `worker-swarm-${payload.jobId}`);
+    const swarm = new Swarm(resolveCogitator(runtime), config);
+    try {
+        const result = await swarm.run({ input: payload.input });
+        return {
+            type: 'swarm',
+            output: typeof result.output === 'string' ? result.output : JSON.stringify(result.output),
+            rounds: countRounds(config, result.votes),
+            agentOutputs: Array.from(result.agentResults, ([agent, runResult]) => ({
+                agent,
+                output: runResult.output,
+            })),
+        };
+    }
+    finally {
+        await swarm.close();
     }
-    return {
-        type: 'swarm',
-        output: String(result.output ?? ''),
-        rounds: 1,
-        agentOutputs,
-    };
 }
 //# sourceMappingURL=swarm.js.map

package/dist/processors/swarm.js.map

@@ -1 +1 @@
-{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/processors/swarm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,SAAS,aAAa,CAAC,MAAuB;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,IAAI,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE;QAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,QAA+E;IAE/E,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,UAAU,CAAC;QACpB,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC;QACxB,KAAK,eAAe;YAClB,OAAO,aAAa,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAwB;IAC5D,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAEvC,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAElC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAErD,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAgB;QAC1B,IAAI,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,EAAE;QAClC,MAAM;QACN,QAAQ,EAAE,YAAY;KACvB,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;QAC7B,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,YAAY,GAAwC,EAAE,CAAC;IAC7D,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACvD,YAAY,CAAC,IAAI,CAAC;gBAChB,KAAK,EAAE,OAAO;gBACd,MAAM,EAAE,SAAS,CAAC,MAAM;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;QACnC,MAAM,EAAE,CAAC;QACT,YAAY;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/processors/swarm.ts"],"names":[],"mappings":"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"}

package/dist/processors/workflow.d.ts

@@ -1,10 +1,26 @@
 /**
  * Workflow job processor
  *
- * Workflow execution in a distributed worker requires a serialization protocol
- * for the workflow graph (nodes, edges, conditions). This is planned but not
- * yet implemented. The processor throws so BullMQ properly marks the job as failed.
+ * Executes a serialized workflow graph as a DAG over a shared state object. Nodes run as
+ * soon as all of their predecessors have settled; independent branches run concurrently.
+ * Condition nodes activate their `'true'` or `'false'` outgoing edges; nodes reachable only
+ * through inactive edges are skipped.
  */
-import type { WorkflowJobPayload, WorkflowJobResult } from '../types.js';
-export declare function processWorkflowJob(_payload: WorkflowJobPayload): Promise<WorkflowJobResult>;
+import type { SerializedWorkflow, WorkerRuntime, WorkflowJobPayload, WorkflowJobResult } from '../types.js';
+type WorkflowState = Record<string, unknown>;
+/**
+ * Read a dot-separated path from the workflow state.
+ */
+export declare function readStatePath(state: WorkflowState, path: string): unknown;
+/**
+ * Render `{{path}}` placeholders against the workflow state.
+ */
+export declare function renderTemplate(template: string, state: WorkflowState): string;
+/**
+ * Check the graph before running anything: unique ids, known edge endpoints, branch labels
+ * only on condition nodes, valid node configs and no cycles.
+ */
+export declare function validateWorkflow(workflow: SerializedWorkflow): void;
+export declare function processWorkflowJob(payload: WorkflowJobPayload, runtime?: WorkerRuntime): Promise<WorkflowJobResult>;
+export {};
 //# sourceMappingURL=workflow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/processors/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEtE,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAMjG"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/processors/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAEV,kBAAkB,EAGlB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAGlB,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA2D7C;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOzE;AAOD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAI7E;AAcD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAiEnE;AAyKD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAgB5B"}

package/dist/processors/workflow.js

@@ -1,13 +1,309 @@
 /**
  * Workflow job processor
  *
- * Workflow execution in a distributed worker requires a serialization protocol
- * for the workflow graph (nodes, edges, conditions). This is planned but not
- * yet implemented. The processor throws so BullMQ properly marks the job as failed.
- */
-export async function processWorkflowJob(_payload) {
-    throw new Error('Workflow job processing is not yet implemented. ' +
-        'Workflows require a graph deserialization protocol that is currently in development. ' +
-        'Use direct WorkflowExecutor instead.');
+ * Executes a serialized workflow graph as a DAG over a shared state object. Nodes run as
+ * soon as all of their predecessors have settled; independent branches run concurrently.
+ * Condition nodes activate their `'true'` or `'false'` outgoing edges; nodes reachable only
+ * through inactive edges are skipped.
+ */
+import { z } from 'zod';
+import { createAgentFromConfig, resolveCogitator } from './shared.js';
+const LLM_PROVIDERS = [
+    'ollama',
+    'openai',
+    'anthropic',
+    'google',
+    'azure',
+    'bedrock',
+    'vllm',
+    'mistral',
+    'groq',
+    'together',
+    'deepseek',
+];
+const serializedAgentSchema = z.object({
+    name: z.string().min(1),
+    instructions: z.string(),
+    model: z.string().min(1),
+    provider: z.enum(LLM_PROVIDERS),
+    temperature: z.number().optional(),
+    maxTokens: z.number().int().positive().optional(),
+    maxIterations: z.number().int().positive().optional(),
+    tools: z.array(z.object({
+        name: z.string(),
+        description: z.string(),
+        parameters: z.object({
+            type: z.literal('object'),
+            properties: z.record(z.string(), z.unknown()),
+            required: z.array(z.string()).optional(),
+        }),
+    })),
+});
+const agentNodeSchema = z.object({
+    agentConfig: serializedAgentSchema,
+    prompt: z.string().optional(),
+    outputKey: z.string().min(1).optional(),
+});
+const transformNodeSchema = z.object({
+    transform: z.enum(['uppercase', 'lowercase', 'trim', 'json-parse', 'json-stringify', 'template']),
+    inputKey: z.string().min(1).optional(),
+    outputKey: z.string().min(1).optional(),
+    template: z.string().optional(),
+});
+const conditionNodeSchema = z.object({
+    key: z.string().min(1),
+    operator: z.enum(['equals', 'not-equals', 'contains', 'exists', 'gt', 'lt']),
+    value: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(),
+});
+/**
+ * Read a dot-separated path from the workflow state.
+ */
+export function readStatePath(state, path) {
+    let current = state;
+    for (const segment of path.split('.')) {
+        if (typeof current !== 'object' || current === null)
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+function stringifyValue(value) {
+    if (value === undefined || value === null)
+        return '';
+    return typeof value === 'string' ? value : JSON.stringify(value);
+}
+/**
+ * Render `{{path}}` placeholders against the workflow state.
+ */
+export function renderTemplate(template, state) {
+    return template.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (_match, path) => stringifyValue(readStatePath(state, path)));
+}
+function parseNodeConfig(node, schema) {
+    const parsed = schema.safeParse(node.config);
+    if (!parsed.success) {
+        throw new Error(`Invalid config for ${node.type} node '${node.id}': ${parsed.error.issues
+            .map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`)
+            .join('; ')}`);
+    }
+    return parsed.data;
+}
+/**
+ * Check the graph before running anything: unique ids, known edge endpoints, branch labels
+ * only on condition nodes, valid node configs and no cycles.
+ */
+export function validateWorkflow(workflow) {
+    const nodes = new Map();
+    for (const node of workflow.nodes) {
+        if (nodes.has(node.id)) {
+            throw new Error(`Duplicate workflow node id '${node.id}'`);
+        }
+        nodes.set(node.id, node);
+    }
+    for (const edge of workflow.edges) {
+        const from = nodes.get(edge.from);
+        if (!from)
+            throw new Error(`Edge references unknown node '${edge.from}'`);
+        if (!nodes.has(edge.to))
+            throw new Error(`Edge references unknown node '${edge.to}'`);
+        if (from.type === 'condition') {
+            if (edge.condition !== 'true' && edge.condition !== 'false') {
+                throw new Error(`Edges leaving condition node '${edge.from}' must set condition to 'true' or 'false'`);
+            }
+        }
+        else if (edge.condition !== undefined) {
+            throw new Error(`Edge ${edge.from} -> ${edge.to} has a condition but '${edge.from}' is not a condition node`);
+        }
+    }
+    for (const node of workflow.nodes) {
+        switch (node.type) {
+            case 'agent':
+                parseNodeConfig(node, agentNodeSchema);
+                break;
+            case 'transform': {
+                const config = parseNodeConfig(node, transformNodeSchema);
+                if (config.transform === 'template' && config.template === undefined) {
+                    throw new Error(`Transform node '${node.id}' uses 'template' but has no template`);
+                }
+                break;
+            }
+            case 'condition':
+                parseNodeConfig(node, conditionNodeSchema);
+                break;
+            case 'parallel':
+                break;
+        }
+    }
+    const indegree = new Map(workflow.nodes.map((n) => [n.id, 0]));
+    for (const edge of workflow.edges) {
+        indegree.set(edge.to, (indegree.get(edge.to) ?? 0) + 1);
+    }
+    const queue = workflow.nodes.filter((n) => indegree.get(n.id) === 0).map((n) => n.id);
+    let visited = 0;
+    while (queue.length > 0) {
+        const id = queue.shift();
+        visited++;
+        for (const edge of workflow.edges.filter((e) => e.from === id)) {
+            const remaining = (indegree.get(edge.to) ?? 0) - 1;
+            indegree.set(edge.to, remaining);
+            if (remaining === 0)
+                queue.push(edge.to);
+        }
+    }
+    if (visited !== workflow.nodes.length) {
+        throw new Error(`Workflow '${workflow.name}' contains a cycle`);
+    }
+}
+function evaluateCondition(config, state) {
+    const actual = readStatePath(state, config.key);
+    switch (config.operator) {
+        case 'exists':
+            return actual !== undefined && actual !== null;
+        case 'equals':
+            return actual === config.value;
+        case 'not-equals':
+            return actual !== config.value;
+        case 'contains':
+            if (typeof actual === 'string')
+                return actual.includes(stringifyValue(config.value));
+            if (Array.isArray(actual))
+                return actual.includes(config.value);
+            return false;
+        case 'gt':
+            return (typeof actual === 'number' && typeof config.value === 'number' && actual > config.value);
+        case 'lt':
+            return (typeof actual === 'number' && typeof config.value === 'number' && actual < config.value);
+    }
+}
+function applyTransform(config, input, state) {
+    switch (config.transform) {
+        case 'uppercase':
+            return stringifyValue(input).toUpperCase();
+        case 'lowercase':
+            return stringifyValue(input).toLowerCase();
+        case 'trim':
+            return stringifyValue(input).trim();
+        case 'json-parse':
+            if (typeof input !== 'string')
+                return input;
+            try {
+                return JSON.parse(input);
+            }
+            catch {
+                throw new Error('json-parse transform received invalid JSON');
+            }
+        case 'json-stringify':
+            return JSON.stringify(input);
+        case 'template':
+            return renderTemplate(config.template ?? '', state);
+    }
+}
+class WorkflowRun {
+    workflow;
+    runtime;
+    nodes;
+    outcomes = new Map();
+    outputKeys = new Map();
+    state;
+    constructor(workflow, input, runtime) {
+        this.workflow = workflow;
+        this.runtime = runtime;
+        this.nodes = new Map(workflow.nodes.map((n) => [n.id, n]));
+        this.state = { ...input };
+    }
+    async execute() {
+        const pending = new Set(this.nodes.keys());
+        const running = new Map();
+        while (pending.size > 0 || running.size > 0) {
+            for (const id of [...pending]) {
+                const incoming = this.workflow.edges.filter((e) => e.to === id);
+                if (!incoming.every((e) => this.outcomes.has(e.from)))
+                    continue;
+                pending.delete(id);
+                const active = incoming.length === 0 || incoming.some((e) => this.isEdgeActive(e));
+                if (!active) {
+                    this.outcomes.set(id, { status: 'skipped' });
+                    continue;
+                }
+                running.set(id, this.runNode(this.nodes.get(id), incoming).then((outcome) => {
+                    this.outcomes.set(id, outcome);
+                    running.delete(id);
+                }));
+            }
+            if (running.size > 0) {
+                await Promise.race(running.values());
+            }
+            else if (pending.size > 0 && ![...pending].some((id) => this.isReady(id))) {
+                throw new Error(`Workflow '${this.workflow.name}' cannot make progress`);
+            }
+        }
+        const nodeResults = {};
+        for (const [id, outcome] of this.outcomes) {
+            nodeResults[id] = outcome.status === 'completed' ? outcome.output : { skipped: true };
+        }
+        return { state: this.state, nodeResults };
+    }
+    isReady(id) {
+        return this.workflow.edges.filter((e) => e.to === id).every((e) => this.outcomes.has(e.from));
+    }
+    isEdgeActive(edge) {
+        const outcome = this.outcomes.get(edge.from);
+        if (outcome?.status !== 'completed')
+            return false;
+        return outcome.branch === undefined || outcome.branch === edge.condition;
+    }
+    previousOutput(incoming) {
+        for (const edge of incoming) {
+            if (!this.isEdgeActive(edge))
+                continue;
+            const key = this.outputKeys.get(edge.from);
+            if (key !== undefined)
+                return this.state[key];
+        }
+        return undefined;
+    }
+    async runNode(node, incoming) {
+        switch (node.type) {
+            case 'agent': {
+                const config = parseNodeConfig(node, agentNodeSchema);
+                const agent = createAgentFromConfig(config.agentConfig, this.runtime);
+                const prompt = config.prompt
+                    ? renderTemplate(config.prompt, this.state)
+                    : JSON.stringify(this.state);
+                const result = await resolveCogitator(this.runtime).run(agent, { input: prompt });
+                return this.store(node.id, config.outputKey, result.output);
+            }
+            case 'transform': {
+                const config = parseNodeConfig(node, transformNodeSchema);
+                const input = config.inputKey !== undefined
+                    ? readStatePath(this.state, config.inputKey)
+                    : this.previousOutput(incoming);
+                return this.store(node.id, config.outputKey, applyTransform(config, input, this.state));
+            }
+            case 'condition': {
+                const config = parseNodeConfig(node, conditionNodeSchema);
+                const passed = evaluateCondition(config, this.state);
+                return { status: 'completed', output: passed, branch: passed ? 'true' : 'false' };
+            }
+            case 'parallel':
+                return { status: 'completed', output: null };
+        }
+    }
+    store(nodeId, outputKey, value) {
+        const key = outputKey ?? nodeId;
+        this.state[key] = value;
+        this.outputKeys.set(nodeId, key);
+        return { status: 'completed', output: value };
+    }
+}
+export async function processWorkflowJob(payload, runtime = {}) {
+    const started = Date.now();
+    validateWorkflow(payload.workflowConfig);
+    const { state, nodeResults } = await new WorkflowRun(payload.workflowConfig, payload.input, runtime).execute();
+    return {
+        type: 'workflow',
+        output: state,
+        nodeResults,
+        duration: Date.now() - started,
+    };
 }
 //# sourceMappingURL=workflow.js.map

package/dist/processors/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/processors/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAA4B;IACnE,MAAM,IAAI,KAAK,CACb,kDAAkD;QAChD,uFAAuF;QACvF,sCAAsC,CACzC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/processors/workflow.ts"],"names":[],"mappings":"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"}

package/dist/queue.d.ts

@@ -11,6 +11,7 @@ import { Queue, type Job } from 'bullmq';
 import type { QueueConfig, QueueMetrics, JobPayload, AgentJobPayload, WorkflowJobPayload, SwarmJobPayload, SwarmAgentJobPayload, SerializedAgent, SerializedWorkflow, SerializedSwarm } from './types.js';
 export declare class JobQueue {
     private queue;
+    private connection;
     constructor(config: QueueConfig);
     /**
      * Add an agent execution job to the queue
@@ -44,13 +45,13 @@ export declare class JobQueue {
      */
     addSwarmAgentJob(swarmId: string, agentName: string, agentConfig: SerializedAgent, input: string, options?: {
         context?: Record<string, unknown>;
-        stateKeys?: {
-            blackboard: string;
-            messages: string;
-            results: string;
-        };
+        stateKeys?: SwarmAgentJobPayload['stateKeys'];
+        runOptions?: SwarmAgentJobPayload['runOptions'];
+        /** Key prefix used by the swarm's Redis state (default: 'swarm') */
+        keyPrefix?: string;
         priority?: number;
         delay?: number;
+        /** Agent run timeout in ms (shorthand for `runOptions.timeout`) */
         timeout?: number;
     }): Promise<Job<SwarmAgentJobPayload>>;
     /**

package/dist/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAC;AAEzC,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,SAAS,CAAC;AAQjB,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,UAAU,CAAiB;gBAEvB,MAAM,EAAE,WAAW;IAiB/B;;OAEG;IACG,WAAW,CACf,WAAW,EAAE,eAAe,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAoBhC;;OAEG;IACG,cAAc,CAClB,cAAc,EAAE,kBAAkB,EAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAoBnC;;OAEG;IACG,WAAW,CACf,WAAW,EAAE,eAAe,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAkBhC;;;OAGG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,eAAe,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAC9C,UAAU,CAAC,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAChD,oEAAoE;QACpE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IA8BrC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAIjE;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAqBzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;OAEG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAC3D,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpB;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC;IAI7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}