@sensigo/realm-cli 0.1.0

package/dist/agent/slack-socket-client.js

@@ -0,0 +1,141 @@
+/**
+ * Opens a Slack Socket Mode WebSocket connection and begins delivering gate thread events.
+ * Handles reconnection transparently on drops or Slack-requested refreshes.
+ * Returns a handle to close the connection immediately.
+ */
+export function connectSocketMode(config) {
+    const { appToken, threadTs, onEvent, signal } = config;
+    let stopped = false;
+    let currentWs;
+    let backoffMs = 1000;
+    const stop = () => {
+        stopped = true;
+        currentWs?.close();
+    };
+    const connect = async () => {
+        if (stopped || signal?.aborted)
+            return;
+        // Step 1 — obtain the WebSocket URL from Slack.
+        let wsUrl;
+        try {
+            const response = await fetch('https://slack.com/api/apps.connections.open', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${appToken}`,
+                },
+            });
+            const data = (await response.json());
+            if (!data.ok || data.url === undefined) {
+                const delay = backoffMs;
+                backoffMs = Math.min(backoffMs * 2, 30_000);
+                console.warn(`  ⚠  Socket Mode: apps.connections.open failed (${data.error ?? 'unknown'}) — retrying in ${delay}ms.`);
+                setTimeout(() => {
+                    if (!stopped && !signal?.aborted) {
+                        void connect();
+                    }
+                }, delay);
+                return;
+            }
+            wsUrl = data.url;
+        }
+        catch (err) {
+            const delay = backoffMs;
+            backoffMs = Math.min(backoffMs * 2, 30_000);
+            console.warn(`  ⚠  Socket Mode: failed to obtain WebSocket URL — ${err instanceof Error ? err.message : String(err)}. Retrying in ${delay}ms.`);
+            setTimeout(() => {
+                if (!stopped && !signal?.aborted) {
+                    void connect();
+                }
+            }, delay);
+            return;
+        }
+        if (stopped || signal?.aborted)
+            return;
+        // Step 2 — open the WebSocket connection.
+        const ws = new WebSocket(wsUrl);
+        currentWs = ws;
+        // Tracks deliberate closes (disconnect message) to skip backoff on the close event.
+        let intentionalClose = false;
+        ws.addEventListener('message', (event) => {
+            // A successful message indicates a live connection — reset backoff.
+            backoffMs = 1000;
+            let msg;
+            try {
+                msg = JSON.parse(event.data);
+            }
+            catch {
+                return;
+            }
+            const type = msg['type'];
+            if (type === 'hello') {
+                console.log('  ℹ  Socket Mode connected.');
+                return;
+            }
+            // Slack requesting a reconnect — close and reconnect immediately, no backoff.
+            if (type === 'disconnect') {
+                intentionalClose = true;
+                ws.close();
+                if (!stopped && !signal?.aborted) {
+                    void connect();
+                }
+                return;
+            }
+            if (type === 'events_api') {
+                const envelopeId = msg['envelope_id'];
+                // ACK immediately (within 3 s as required by Slack).
+                if (envelopeId !== undefined) {
+                    ws.send(JSON.stringify({ envelope_id: envelopeId }));
+                }
+                const payload = msg['payload'];
+                if (payload === undefined)
+                    return;
+                const msgEvent = payload['event'];
+                if (msgEvent === undefined)
+                    return;
+                // Use envelope_id as the dedup event_id (outer envelope is the authoritative key).
+                const eventId = envelopeId ?? payload['event_id'];
+                if (!eventId)
+                    return;
+                // Apply all required filters before forwarding to onEvent.
+                if (msgEvent['type'] !== 'message')
+                    return;
+                if (msgEvent['bot_id'] !== undefined)
+                    return;
+                if (msgEvent['subtype'] === 'bot_message')
+                    return;
+                if (msgEvent['thread_ts'] !== threadTs)
+                    return;
+                const user = msgEvent['user'];
+                if (!user)
+                    return;
+                const text = msgEvent['text'];
+                if (!text)
+                    return;
+                const ts = msgEvent['ts'];
+                if (!ts)
+                    return;
+                onEvent({ event_id: eventId, thread_ts: threadTs, user, text, ts });
+            }
+        });
+        ws.addEventListener('close', () => {
+            if (stopped || signal?.aborted || intentionalClose)
+                return;
+            // Unexpected close — reconnect with exponential backoff (max 30 s).
+            const delay = backoffMs;
+            backoffMs = Math.min(backoffMs * 2, 30_000);
+            setTimeout(() => {
+                if (!stopped && !signal?.aborted) {
+                    void connect();
+                }
+            }, delay);
+        });
+        signal?.addEventListener('abort', () => {
+            stopped = true;
+            ws.close();
+        }, { once: true });
+    };
+    void connect();
+    return { close: stop };
+}
+//# sourceMappingURL=slack-socket-client.js.map

package/dist/agent/slack-socket-client.js.map

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

package/dist/commands/agent.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const agentCommand: Command;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,eAAO,MAAM,YAAY,SA0OtB,CAAC"}

package/dist/commands/agent.js

@@ -0,0 +1,183 @@
+// realm agent — autonomous CLI command that drives a workflow using an LLM provider.
+// Core loop logic lives in packages/cli/src/agent/run-agent.ts for testability.
+import { Command } from 'commander';
+import { join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { loadWorkflowFromFile, JsonFileStore, JsonWorkflowStore, createDefaultRegistry, GitHubAdapter, SlackAdapter, } from '@sensigo/realm';
+import { LlmProvider, resolveProvider } from '../agent/providers/llm-provider.js';
+import { runAgent } from '../agent/run-agent.js';
+import { createSlackGateHandler } from '../agent/gate/slack-gate-notifier.js';
+import { checkAdapterPrerequisites, formatPreflightError, checkSlackBidirectionalConfig, } from '../agent/preflight.js';
+export const agentCommand = new Command('agent')
+    .description('Run a workflow autonomously using an LLM provider')
+    .option('--workflow <path>', 'Path to workflow directory or workflow.yaml file')
+    .option('--run-id <id>', 'Attach to an existing run instead of creating a new one')
+    .option('--params <json>', 'Initial run parameters as JSON string', '{}')
+    .option('--provider <provider>', 'LLM provider: openai or anthropic (auto-detected from env)')
+    .option('--model <model>', 'Model name override (default: gpt-4o / claude-sonnet-4-5)')
+    .option('--base-url <url>', 'Base URL for OpenAI-compatible endpoints (e.g. DeepSeek, Qwen, Groq)')
+    .option('--provider-module <path>', 'Path to a custom LlmProvider module (default export must be an instance extending LlmProvider)')
+    .option('--register', 'Persist the workflow definition to ~/.realm/workflows/ (same as realm workflow register)')
+    .action(async (opts) => {
+    if (!opts.workflow && !opts.runId) {
+        console.error('Error: one of --workflow or --run-id is required');
+        process.exit(1);
+    }
+    if (opts.workflow && opts.runId) {
+        console.error('Error: --workflow and --run-id are mutually exclusive');
+        process.exit(1);
+    }
+    if (opts.params !== '{}' && opts.runId) {
+        console.error('Error: --params cannot be used with --run-id; the run already has params from creation time');
+        process.exit(1);
+    }
+    try {
+        const workflowStore = new JsonWorkflowStore();
+        const store = new JsonFileStore();
+        let provider;
+        if (opts.providerModule !== undefined) {
+            if (opts.provider !== undefined ||
+                opts.model !== undefined ||
+                opts.baseUrl !== undefined) {
+                console.error('Error: --provider-module cannot be combined with --provider, --model, or --base-url');
+                process.exit(1);
+            }
+            const modulePath = resolve(opts.providerModule);
+            const moduleUrl = pathToFileURL(modulePath).href;
+            let mod;
+            try {
+                mod = (await import(moduleUrl));
+            }
+            catch (err) {
+                console.error(`Error: failed to import provider module '${opts.providerModule}': ${err instanceof Error ? err.message : String(err)}`);
+                process.exit(1);
+            }
+            if (!(mod.default instanceof LlmProvider)) {
+                console.error(`Error: provider module default export must be an instance extending LlmProvider.\n` +
+                    `Import LlmProvider from '@sensigo/realm-cli/agent' and export 'export default new MyProvider()'.`);
+                process.exit(1);
+            }
+            provider = mod.default;
+        }
+        else {
+            provider = await resolveProvider(opts.provider, opts.model, opts.baseUrl);
+        }
+        const registry = createDefaultRegistry();
+        if (process.env['GITHUB_TOKEN'] !== undefined)
+            registry.register('adapter', 'github', new GitHubAdapter('github', { auth: { token: process.env['GITHUB_TOKEN'] } }));
+        if (process.env['SLACK_WEBHOOK_URL'] !== undefined)
+            registry.register('adapter', 'slack', new SlackAdapter('slack', { webhook_url: process.env['SLACK_WEBHOOK_URL'] }));
+        let result;
+        if (opts.runId !== undefined) {
+            // --run-id path: attach to existing run, load definition from store.
+            const runRecord = await store.get(opts.runId);
+            const definition = await workflowStore.get(runRecord.workflow_id);
+            const hasSlack = process.env['SLACK_BOT_TOKEN'] !== undefined ||
+                process.env['SLACK_WEBHOOK_URL'] !== undefined;
+            const slackConfig = {
+                store,
+                definition,
+                provider,
+                ...(process.env['SLACK_WEBHOOK_URL'] !== undefined && {
+                    webhookUrl: process.env['SLACK_WEBHOOK_URL'],
+                }),
+                ...(process.env['SLACK_BOT_TOKEN'] !== undefined && {
+                    botToken: process.env['SLACK_BOT_TOKEN'],
+                }),
+                ...(process.env['SLACK_CHANNEL_ID'] !== undefined && {
+                    channelId: process.env['SLACK_CHANNEL_ID'],
+                }),
+                ...(process.env['SLACK_SIGNING_SECRET'] !== undefined && {
+                    signingSecret: process.env['SLACK_SIGNING_SECRET'],
+                }),
+                ...(process.env['SLACK_EVENTS_PORT'] !== undefined && {
+                    eventsPort: parseInt(process.env['SLACK_EVENTS_PORT'], 10),
+                }),
+                ...(process.env['SLACK_APP_TOKEN'] !== undefined && {
+                    appToken: process.env['SLACK_APP_TOKEN'],
+                }),
+                ...(process.env['SLACK_GATE_REMINDER_INTERVAL_MS'] !== undefined && {
+                    reminderIntervalMs: parseInt(process.env['SLACK_GATE_REMINDER_INTERVAL_MS'], 10),
+                }),
+                ...(process.env['SLACK_GATE_ESCALATION_THRESHOLD_MS'] !== undefined && {
+                    escalationThresholdMs: parseInt(process.env['SLACK_GATE_ESCALATION_THRESHOLD_MS'], 10),
+                }),
+            };
+            const gateHandler = hasSlack ? createSlackGateHandler(slackConfig) : undefined;
+            result = await runAgent({ store, workflowStore, provider, registry, ...(gateHandler ? { gateHandler } : {}) }, {
+                existingRunId: opts.runId,
+                definition,
+                params: {},
+            });
+        }
+        else {
+            const params = JSON.parse(opts.params);
+            // Resolve and load workflow definition before starting a run.
+            const inputPath = opts.workflow;
+            const filePath = inputPath.endsWith('.yaml') || inputPath.endsWith('.yml')
+                ? inputPath
+                : join(inputPath, 'workflow.yaml');
+            const definition = loadWorkflowFromFile(filePath);
+            // Fail fast if required adapter env vars are missing.
+            const preflightFindings = checkAdapterPrerequisites(definition);
+            if (preflightFindings.length > 0) {
+                console.error(formatPreflightError(preflightFindings));
+                process.exit(1);
+            }
+            // Print advisory warnings for incomplete Slack bidirectional config.
+            const slackWarnings = checkSlackBidirectionalConfig();
+            for (const warning of slackWarnings) {
+                console.warn(`  ⚠  ${warning.message}`);
+            }
+            const hasSlack2 = process.env['SLACK_BOT_TOKEN'] !== undefined ||
+                process.env['SLACK_WEBHOOK_URL'] !== undefined;
+            const slackConfig2 = {
+                store,
+                definition,
+                provider,
+                ...(process.env['SLACK_WEBHOOK_URL'] !== undefined && {
+                    webhookUrl: process.env['SLACK_WEBHOOK_URL'],
+                }),
+                ...(process.env['SLACK_BOT_TOKEN'] !== undefined && {
+                    botToken: process.env['SLACK_BOT_TOKEN'],
+                }),
+                ...(process.env['SLACK_CHANNEL_ID'] !== undefined && {
+                    channelId: process.env['SLACK_CHANNEL_ID'],
+                }),
+                ...(process.env['SLACK_SIGNING_SECRET'] !== undefined && {
+                    signingSecret: process.env['SLACK_SIGNING_SECRET'],
+                }),
+                ...(process.env['SLACK_EVENTS_PORT'] !== undefined && {
+                    eventsPort: parseInt(process.env['SLACK_EVENTS_PORT'], 10),
+                }),
+                ...(process.env['SLACK_APP_TOKEN'] !== undefined && {
+                    appToken: process.env['SLACK_APP_TOKEN'],
+                }),
+                ...(process.env['SLACK_GATE_REMINDER_INTERVAL_MS'] !== undefined && {
+                    reminderIntervalMs: parseInt(process.env['SLACK_GATE_REMINDER_INTERVAL_MS'], 10),
+                }),
+                ...(process.env['SLACK_GATE_ESCALATION_THRESHOLD_MS'] !== undefined && {
+                    escalationThresholdMs: parseInt(process.env['SLACK_GATE_ESCALATION_THRESHOLD_MS'], 10),
+                }),
+            };
+            const gateHandler2 = hasSlack2 ? createSlackGateHandler(slackConfig2) : undefined;
+            result = await runAgent({
+                store,
+                workflowStore,
+                provider,
+                registry,
+                ...(gateHandler2 ? { gateHandler: gateHandler2 } : {}),
+            }, {
+                definition,
+                params,
+                register: opts.register === true,
+            });
+        }
+        process.exit(result === 'completed' ? 0 : 1);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

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

package/dist/commands/cleanup.d.ts

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+import type { RunStore, RunRecord } from '@sensigo/realm';
+/**
+ * List all non-terminal runs idle for longer than `olderThan` and mark them abandoned.
+ * @param options  `olderThan` is a duration string; `dryRun` skips writes.
+ * @param runStore Store holding run records.
+ * @returns The list of affected runs.
+ */
+export declare function cleanupRuns(options: {
+    olderThan: string;
+    dryRun?: boolean;
+}, runStore: RunStore): Promise<{
+    affected: RunRecord[];
+}>;
+export declare const cleanupCommand: Command;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/commands/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAyB1D;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAChD,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CA+BpC;AAED,eAAO,MAAM,cAAc,SAsBvB,CAAC"}

package/dist/commands/cleanup.js

@@ -0,0 +1,79 @@
+// cleanup command — marks idle non-terminal runs as abandoned.
+import { Command } from 'commander';
+import { WorkflowError, WAITING_PHASES } from '@sensigo/realm';
+/**
+ * Parses a duration string such as "30d", "6h", or "10m" into milliseconds.
+ */
+function parseDuration(s) {
+    const match = /^(\d+)(d|h|m)$/.exec(s);
+    if (match === null) {
+        throw new WorkflowError(`Invalid duration '${s}'. Use format: <number>(d|h|m), e.g. 30d, 6h, 10m`, {
+            code: 'VALIDATION_INPUT_SCHEMA',
+            category: 'VALIDATION',
+            agentAction: 'provide_input',
+            retryable: false,
+        });
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const multipliers = { d: 86_400_000, h: 3_600_000, m: 60_000 };
+    return value * multipliers[unit];
+}
+/**
+ * List all non-terminal runs idle for longer than `olderThan` and mark them abandoned.
+ * @param options  `olderThan` is a duration string; `dryRun` skips writes.
+ * @param runStore Store holding run records.
+ * @returns The list of affected runs.
+ */
+export async function cleanupRuns(options, runStore) {
+    const threshold = parseDuration(options.olderThan);
+    const now = Date.now();
+    const all = await runStore.list();
+    const affected = [];
+    for (const run of all) {
+        if (run.terminal_state) {
+            continue;
+        }
+        if (WAITING_PHASES.has(run.run_phase)) {
+            continue;
+        }
+        const idleMs = now - new Date(run.updated_at).getTime();
+        if (idleMs >= threshold) {
+            affected.push(run);
+        }
+    }
+    if (!(options.dryRun ?? false)) {
+        for (const run of affected) {
+            await runStore.update({
+                ...run,
+                run_phase: 'abandoned',
+                terminal_state: true,
+                terminal_reason: 'Marked abandoned by realm cleanup',
+            });
+        }
+    }
+    return { affected };
+}
+export const cleanupCommand = new Command('cleanup')
+    .description('Mark idle non-terminal runs as abandoned')
+    .requiredOption('--older-than <duration>', 'Abandon runs idle longer than this duration (e.g. 30d, 6h, 10m)')
+    .option('--dry-run', 'Preview which runs would be abandoned without modifying them')
+    .action(async (opts) => {
+    const { JsonFileStore } = await import('@sensigo/realm');
+    const runStore = new JsonFileStore();
+    try {
+        const { affected } = await cleanupRuns(opts, runStore);
+        const n = affected.length;
+        if (opts.dryRun ?? false) {
+            console.log(`Would mark ${n} run(s) as abandoned.`);
+        }
+        else {
+            console.log(`Marked ${n} run(s) as abandoned.`);
+        }
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=cleanup.js.map

package/dist/commands/cleanup.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,41 @@
+import { Command } from 'commander';
+import type { RunRecord } from '@sensigo/realm';
+import type { ReplayRecord } from '../store/replay-store.js';
+/** Returns true when the given ID is a replay ID (starts with "rpl_"). */
+export declare function isReplayId(id: string): boolean;
+export interface ReplayDiffRow {
+    step_id: string;
+    /** Precondition column for replay A. */
+    precond_a: string;
+    /** Precondition column for replay B. */
+    precond_b: string;
+    /** Whether the two replay outcomes differ for this step. */
+    differs: boolean;
+}
+/**
+ * Compares step-level precondition results from two replay records.
+ * @param recordA First replay record.
+ * @param recordB Second replay record.
+ */
+export declare function diffReplays(recordA: ReplayRecord, recordB: ReplayRecord): ReplayDiffRow[];
+export interface DiffStepRow {
+    step_id: string;
+    status_a: string;
+    status_b: string;
+    hash_a: string;
+    hash_b: string;
+    duration_a_ms: number;
+    duration_b_ms: number;
+    /** True when both runs have the step and produce the same evidence hash. */
+    same_output: boolean;
+    /** True when both runs have the same step status (including 'missing'). */
+    same_status: boolean;
+}
+/**
+ * Compares evidence chains of two runs, producing a row per unique step.
+ * @param runA First run to compare.
+ * @param runB Second run to compare.
+ */
+export declare function diffRuns(runA: RunRecord, runB: RunRecord): DiffStepRow[];
+export declare const diffCommand: Command;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,gBAAgB,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;CAClB;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,aAAa,EAAE,CAezF;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,EAAE,CAqCxE;AAuBD,eAAO,MAAM,WAAW,SAsHpB,CAAC"}