@relayflows/core 0.0.1 → 1.0.0

package/dist/collectors/opencode.js

@@ -0,0 +1,204 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const OPENCODE_DB_PATH = path.join(os.homedir(), '.local', 'share', 'opencode', 'opencode.db');
+const MATCH_WINDOW_GRACE_MS = 5_000;
+const ERROR_LINE_PATTERN = /^(Error|error:|Command failed|FAIL)\b/;
+function loadDatabaseConstructor() {
+    try {
+        return require('better-sqlite3');
+    }
+    catch {
+        // fall through
+    }
+    // Fall back to Node 22+ native node:sqlite (experimental)
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { DatabaseSync } = require('node:sqlite');
+        return function NativeSqliteWrapper(filename, options) {
+            const db = new DatabaseSync(filename, { open: true, readOnly: options?.readonly ?? false });
+            return {
+                prepare(sql) {
+                    const stmt = db.prepare(sql);
+                    return {
+                        get(params) {
+                            return params != null ? stmt.get(params) : stmt.get();
+                        },
+                        all(params) {
+                            return (params != null ? stmt.all(params) : stmt.all());
+                        },
+                    };
+                },
+                pragma(source) { db.exec(`PRAGMA ${source}`); return undefined; },
+                close() { db.close(); },
+            };
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function toNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+function normalizeStatus(finish, hasErrors) {
+    if (finish === 'stop' || finish === 'completed') {
+        return 'completed';
+    }
+    if (finish === 'error' || finish === 'failed' || hasErrors) {
+        return 'failed';
+    }
+    return 'unknown';
+}
+function isToolPart(part) {
+    return !!part?.type && part.type.toLowerCase().includes('tool');
+}
+export class OpenCodeCollector {
+    canCollect() {
+        if (!fs.existsSync(OPENCODE_DB_PATH)) {
+            return false;
+        }
+        const Database = loadDatabaseConstructor();
+        if (!Database) {
+            return false;
+        }
+        let db = null;
+        try {
+            db = new Database(OPENCODE_DB_PATH, { readonly: true, fileMustExist: true });
+            db.pragma('query_only = ON');
+            db.prepare('SELECT 1').get();
+            return true;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            db?.close();
+        }
+    }
+    async collect(query) {
+        const Database = loadDatabaseConstructor();
+        if (!Database) {
+            return null;
+        }
+        let db = null;
+        try {
+            db = new Database(OPENCODE_DB_PATH, { readonly: true, fileMustExist: true });
+            db.pragma('query_only = ON');
+            const session = db.prepare(`
+          SELECT id, directory, time_created
+          FROM session
+          WHERE directory = @cwd
+            AND time_created BETWEEN @startedAt AND @completedAt
+          ORDER BY time_created DESC
+          LIMIT 1
+        `).get({
+                cwd: query.cwd,
+                startedAt: query.startedAt - MATCH_WINDOW_GRACE_MS,
+                completedAt: query.completedAt,
+            });
+            if (!session) {
+                return null;
+            }
+            const messages = db.prepare(`
+          SELECT id, session_id, time_created, data
+          FROM message
+          WHERE session_id = ?
+          ORDER BY time_created ASC
+        `).all(session.id);
+            const parts = db.prepare(`
+          SELECT id, message_id, session_id, time_created, data
+          FROM part
+          WHERE session_id = ?
+          ORDER BY time_created ASC
+        `).all(session.id);
+            const parsedMessages = messages.map((message) => ({
+                ...message,
+                parsed: parseJson(message.data),
+            }));
+            const parsedParts = parts.map((part) => ({
+                ...part,
+                parsed: parseJson(part.data),
+            }));
+            const lastMessageWithMetadata = [...parsedMessages]
+                .reverse()
+                .find((message) => message.parsed?.modelID || message.parsed?.providerID || message.parsed?.finish);
+            const tokenTotals = parsedMessages.reduce((totals, message) => {
+                const tokens = message.parsed?.tokens;
+                totals.input += toNumber(tokens?.input);
+                totals.output += toNumber(tokens?.output);
+                totals.cacheRead += toNumber(tokens?.cache?.read);
+                return totals;
+            }, { input: 0, output: 0, cacheRead: 0 });
+            const hasCostData = parsedMessages.some((message) => typeof message.parsed?.cost === 'number' && Number.isFinite(message.parsed.cost));
+            const totalCost = parsedMessages.reduce((sum, message) => sum + toNumber(message.parsed?.cost), 0);
+            const toolCallCounts = new Map();
+            for (const part of parsedParts) {
+                if (!isToolPart(part.parsed)) {
+                    continue;
+                }
+                const name = part.parsed.name?.trim();
+                if (!name) {
+                    continue;
+                }
+                toolCallCounts.set(name, (toolCallCounts.get(name) ?? 0) + 1);
+            }
+            const errors = [];
+            for (const [index, part] of parsedParts.entries()) {
+                const text = part.parsed?.type === 'text' ? part.parsed.text : undefined;
+                if (!text) {
+                    continue;
+                }
+                for (const line of text.split(/\r?\n/)) {
+                    const trimmed = line.trim();
+                    if (!trimmed || !ERROR_LINE_PATTERN.test(trimmed)) {
+                        continue;
+                    }
+                    errors.push({ turn: index + 1, text: trimmed });
+                }
+            }
+            const summary = [...parsedParts]
+                .reverse()
+                .find((part) => part.parsed?.type === 'text' && part.parsed.text?.trim())?.parsed?.text?.trim() ?? null;
+            const turns = parsedMessages.filter((message) => message.parsed?.role === 'assistant' || message.parsed?.role === 'user').length || parsedMessages.length;
+            return {
+                cli: 'opencode',
+                sessionId: session.id,
+                model: lastMessageWithMetadata?.parsed?.modelID ?? null,
+                provider: lastMessageWithMetadata?.parsed?.providerID ?? null,
+                durationMs: parsedMessages.length > 0
+                    ? Math.max(0, parsedMessages[parsedMessages.length - 1].time_created - session.time_created)
+                    : null,
+                cost: hasCostData ? totalCost : null,
+                tokens: tokenTotals,
+                turns,
+                toolCalls: [...toolCallCounts.entries()].map(([name, count]) => ({ name, count })),
+                errors,
+                finalStatus: normalizeStatus(lastMessageWithMetadata?.parsed?.finish, errors.length > 0),
+                summary,
+                raw: {
+                    session,
+                    messages: parsedMessages.map(({ parsed, ...message }) => ({ ...message, data: parsed ?? message.data })),
+                    parts: parsedParts.map(({ parsed, ...part }) => ({ ...part, data: parsed ?? part.data })),
+                },
+            };
+        }
+        catch {
+            return null;
+        }
+        finally {
+            db?.close();
+        }
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/collectors/opencode.js.map

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

package/dist/coordinator.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Swarm Coordinator — pattern selection, agent topology, and workflow lifecycle.
+ *
+ * Orchestrates workflow runs: picks the right swarm pattern (or auto-selects),
+ * resolves agent topology from the config, and drives the run through its
+ * lifecycle states (pending → running → completed / failed / cancelled).
+ */
+import { EventEmitter } from 'node:events';
+import type { AgentDefinition, RelayYamlConfig, SwarmPattern, WorkflowRunRow, WorkflowRunStatus, WorkflowStepRow } from './types.js';
+/** Minimal database client contract accepted by all services. */
+export interface DbClient {
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+    }>;
+}
+/** Describes the communication graph for a set of agents. */
+export interface AgentTopology {
+    pattern: SwarmPattern;
+    agents: AgentDefinition[];
+    /** Agent name → names it can send messages to. */
+    edges: Map<string, string[]>;
+    /** Optional hub agent for hub-spoke / hierarchical. */
+    hub?: string;
+    /** Ordered pipeline stages (pipeline pattern only). */
+    pipelineOrder?: string[];
+}
+export interface SwarmCoordinatorEvents {
+    'run:created': (run: WorkflowRunRow) => void;
+    'run:started': (run: WorkflowRunRow) => void;
+    'run:completed': (run: WorkflowRunRow) => void;
+    'run:failed': (run: WorkflowRunRow) => void;
+    'run:cancelled': (run: WorkflowRunRow) => void;
+    'step:started': (step: WorkflowStepRow) => void;
+    'step:completed': (step: WorkflowStepRow) => void;
+    'step:failed': (step: WorkflowStepRow) => void;
+}
+export declare class SwarmCoordinator extends EventEmitter {
+    private db;
+    constructor(db: DbClient);
+    /**
+     * Select the swarm pattern to use for a config. If the config already
+     * specifies a pattern, it is returned as-is. Otherwise heuristics apply.
+     */
+    selectPattern(config: RelayYamlConfig): SwarmPattern;
+    /**
+     * Build the agent communication topology for a given config and pattern.
+     * Non-interactive agents are excluded from message edges — they only communicate
+     * through step output chaining ({{steps.X.output}}).
+     */
+    resolveTopology(config: RelayYamlConfig, pattern?: SwarmPattern): AgentTopology;
+    /** Internal: resolve topology edges for interactive agents only. */
+    private resolveInteractiveTopology;
+    createRun(workspaceId: string, config: RelayYamlConfig): Promise<WorkflowRunRow>;
+    startRun(runId: string): Promise<WorkflowRunRow>;
+    completeRun(runId: string, stateSnapshot?: Record<string, unknown>): Promise<WorkflowRunRow>;
+    failRun(runId: string, error: string): Promise<WorkflowRunRow>;
+    cancelRun(runId: string): Promise<WorkflowRunRow>;
+    createSteps(runId: string, config: RelayYamlConfig): Promise<WorkflowStepRow[]>;
+    startStep(stepId: string): Promise<WorkflowStepRow>;
+    completeStep(stepId: string, output?: string): Promise<WorkflowStepRow>;
+    failStep(stepId: string, error: string): Promise<WorkflowStepRow>;
+    skipStep(stepId: string): Promise<WorkflowStepRow>;
+    getRun(runId: string): Promise<WorkflowRunRow | null>;
+    getSteps(runId: string): Promise<WorkflowStepRow[]>;
+    getReadySteps(runId: string): Promise<WorkflowStepRow[]>;
+    getRunsByWorkspace(workspaceId: string, status?: WorkflowRunStatus): Promise<WorkflowRunRow[]>;
+    private transitionRun;
+    private pickHub;
+    private resolvePipelineOrder;
+    private resolveEscalationOrder;
+    private resolveDAGEdges;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/coordinator.d.ts.map

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