smol-symphony 0.1.0

package/dist/workflow.js

@@ -0,0 +1,385 @@
+// WORKFLOW.md loader, watcher, and typed config view (SPEC §5, §6).
+import { readFile } from 'node:fs/promises';
+import { existsSync, statSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import chokidar from 'chokidar';
+import { parse as parseYaml } from 'yaml';
+import { log } from './logging.js';
+import { isKnownAdapter } from './agent/adapters.js';
+export class WorkflowError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'WorkflowError';
+    }
+}
+// §5.2: split YAML front matter from prompt body.
+export function splitFrontMatter(text) {
+    if (!text.startsWith('---')) {
+        return { config: {}, body: text.trim() };
+    }
+    const lines = text.split(/\r?\n/);
+    // First and closing fences must be exactly `---` (with optional trailing whitespace),
+    // unindented. Otherwise an indented `---` inside a multiline YAML hook script would be
+    // mistaken for the closing fence.
+    const isFence = (line) => /^---\s*$/.test(line ?? '');
+    if (!isFence(lines[0])) {
+        return { config: {}, body: text.trim() };
+    }
+    let endIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (isFence(lines[i])) {
+            endIdx = i;
+            break;
+        }
+    }
+    if (endIdx < 0) {
+        throw new WorkflowError('workflow_parse_error', 'unterminated YAML front matter');
+    }
+    const fmText = lines.slice(1, endIdx).join('\n');
+    const body = lines.slice(endIdx + 1).join('\n').trim();
+    let parsed;
+    try {
+        parsed = fmText.trim().length === 0 ? {} : parseYaml(fmText);
+    }
+    catch (err) {
+        throw new WorkflowError('workflow_parse_error', `invalid YAML front matter: ${err.message}`);
+    }
+    if (parsed === null || parsed === undefined)
+        parsed = {};
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new WorkflowError('workflow_front_matter_not_a_map', 'YAML front matter must decode to a map');
+    }
+    return { config: parsed, body };
+}
+export async function loadWorkflow(workflowPath) {
+    let text;
+    try {
+        text = await readFile(workflowPath, 'utf8');
+    }
+    catch (err) {
+        throw new WorkflowError('missing_workflow_file', `cannot read ${workflowPath}: ${err.message}`);
+    }
+    const { config, body } = splitFrontMatter(text);
+    return { config, prompt_template: body };
+}
+// $VAR / ~ expansion for path/command fields (§6.1).
+export function expandVar(value) {
+    if (typeof value !== 'string')
+        return value;
+    let s = value;
+    if (s.startsWith('~/') || s === '~') {
+        s = s === '~' ? os.homedir() : path.join(os.homedir(), s.slice(2));
+    }
+    const m = s.match(/^\$([A-Z_][A-Z0-9_]*)$/);
+    if (m) {
+        const envVal = process.env[m[1]];
+        return envVal ?? '';
+    }
+    return s;
+}
+function asString(v) {
+    if (typeof v === 'string')
+        return v;
+    return null;
+}
+function asInt(v, fallback) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return Math.trunc(v);
+    if (typeof v === 'string' && /^-?\d+$/.test(v))
+        return parseInt(v, 10);
+    return fallback;
+}
+function asStringList(v, fallback) {
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === 'string');
+    return fallback;
+}
+function asMapStrPosInt(v) {
+    const out = {};
+    if (v && typeof v === 'object' && !Array.isArray(v)) {
+        for (const [k, raw] of Object.entries(v)) {
+            const n = asInt(raw, 0);
+            if (n > 0)
+                out[k.toLowerCase()] = n;
+        }
+    }
+    return out;
+}
+function getObject(parent, key) {
+    const v = parent[key];
+    if (v && typeof v === 'object' && !Array.isArray(v))
+        return v;
+    return {};
+}
+// Build a fully typed ServiceConfig from a parsed front matter map (§6.1).
+export function buildServiceConfig(raw, workflowPath) {
+    const workflowAbs = path.resolve(workflowPath);
+    const workflowDir = path.dirname(workflowAbs);
+    // tracker (§5.3.1)
+    const trackerRaw = getObject(raw, 'tracker');
+    const trackerKind = (asString(trackerRaw['kind']) ?? '').trim();
+    const apiKeyRaw = asString(trackerRaw['api_key']);
+    const apiKeyResolved = apiKeyRaw ? expandVar(apiKeyRaw) : null;
+    const trackerEndpointDefault = trackerKind === 'linear' ? 'https://api.linear.app/graphql' : null;
+    // local-tracker extension: optional `tracker.root` path.
+    const trackerRootRaw = asString(trackerRaw['root']);
+    let trackerRoot = null;
+    if (trackerRootRaw) {
+        const expanded = expandVar(trackerRootRaw);
+        if (expanded === '') {
+            throw new WorkflowError('workflow_parse_error', `tracker.root references an unset variable: ${trackerRootRaw}`);
+        }
+        trackerRoot = path.isAbsolute(expanded) ? expanded : path.resolve(workflowDir, expanded);
+    }
+    else if (trackerKind === 'local') {
+        // Default local tracker root: <workflow-dir>/issues
+        trackerRoot = path.resolve(workflowDir, 'issues');
+    }
+    const tracker = {
+        kind: trackerKind,
+        endpoint: asString(trackerRaw['endpoint']) ?? trackerEndpointDefault,
+        api_key: apiKeyResolved && apiKeyResolved.length > 0 ? apiKeyResolved : null,
+        project_slug: asString(trackerRaw['project_slug']),
+        active_states: asStringList(trackerRaw['active_states'], ['Todo', 'In Progress']),
+        terminal_states: asStringList(trackerRaw['terminal_states'], [
+            'Closed',
+            'Cancelled',
+            'Canceled',
+            'Duplicate',
+            'Done',
+        ]),
+        root: trackerRoot,
+    };
+    // polling (§5.3.2)
+    const pollingRaw = getObject(raw, 'polling');
+    const polling = {
+        interval_ms: asInt(pollingRaw['interval_ms'], 30_000),
+    };
+    // workspace (§5.3.3)
+    const workspaceRaw = getObject(raw, 'workspace');
+    const wsRootInput = asString(workspaceRaw['root']);
+    let workspaceRoot;
+    if (wsRootInput) {
+        const expanded = expandVar(wsRootInput);
+        if (expanded === '') {
+            throw new WorkflowError('workflow_parse_error', `workspace.root references an unset variable: ${wsRootInput}`);
+        }
+        workspaceRoot = path.isAbsolute(expanded) ? expanded : path.resolve(workflowDir, expanded);
+    }
+    else {
+        workspaceRoot = path.join(os.tmpdir(), 'symphony_workspaces');
+    }
+    const workspace = { root: path.resolve(workspaceRoot) };
+    // hooks (§5.3.4)
+    const hooksRaw = getObject(raw, 'hooks');
+    const hooks = {
+        after_create: asString(hooksRaw['after_create']),
+        before_run: asString(hooksRaw['before_run']),
+        after_run: asString(hooksRaw['after_run']),
+        before_remove: asString(hooksRaw['before_remove']),
+        timeout_ms: asInt(hooksRaw['timeout_ms'], 60_000),
+    };
+    if (hooks.timeout_ms <= 0) {
+        throw new WorkflowError('workflow_parse_error', 'hooks.timeout_ms must be positive');
+    }
+    // agent (§5.3.5)
+    const agentRaw = getObject(raw, 'agent');
+    const maxTurns = asInt(agentRaw['max_turns'], 20);
+    if (maxTurns <= 0) {
+        throw new WorkflowError('workflow_parse_error', 'agent.max_turns must be positive');
+    }
+    const agent = {
+        max_concurrent_agents: asInt(agentRaw['max_concurrent_agents'], 10),
+        max_turns: maxTurns,
+        max_retry_backoff_ms: asInt(agentRaw['max_retry_backoff_ms'], 300_000),
+        max_concurrent_agents_by_state: asMapStrPosInt(agentRaw['max_concurrent_agents_by_state']),
+    };
+    // acp (Symphony extension; supersedes the §5.3.6 `codex` block). `adapter` selects
+    // one of symphony's known profiles (claude, codex). `command` is optional: when
+    // null/unset, symphony auto-derives the launch command from the adapter profile and
+    // stages the host credential file into the workspace. Override `command` only if
+    // you need a custom launch (testing a forked adapter, a non-default binary path,
+    // etc.) — overriding also opts out of credential staging.
+    const acpRaw = getObject(raw, 'acp');
+    const acp = {
+        adapter: asString(acpRaw['adapter']) ?? 'claude',
+        command: asString(acpRaw['command']),
+        shell: asString(acpRaw['shell']) ?? 'bash',
+        prompt_timeout_ms: asInt(acpRaw['prompt_timeout_ms'], 3_600_000),
+        read_timeout_ms: asInt(acpRaw['read_timeout_ms'], 30_000),
+        stall_timeout_ms: asInt(acpRaw['stall_timeout_ms'], 300_000),
+    };
+    // smolvm extension
+    const smolvmRaw = getObject(raw, 'smolvm');
+    const fromRaw = asString(smolvmRaw['from']);
+    let from = null;
+    if (fromRaw) {
+        const expanded = expandVar(fromRaw);
+        if (expanded === '') {
+            throw new WorkflowError('workflow_parse_error', `smolvm.from references an unset variable: ${fromRaw}`);
+        }
+        from = path.isAbsolute(expanded) ? expanded : path.resolve(workflowDir, expanded);
+    }
+    const volumesRaw = smolvmRaw['volumes'];
+    const volumes = Array.isArray(volumesRaw)
+        ? volumesRaw.flatMap((v) => {
+            if (!v || typeof v !== 'object' || Array.isArray(v))
+                return [];
+            const m = v;
+            const hostRaw = asString(m['host']);
+            const guest = asString(m['guest']);
+            if (!hostRaw || !guest)
+                return [];
+            const expandedHost = expandVar(hostRaw);
+            if (expandedHost === '')
+                return [];
+            const host = path.isAbsolute(expandedHost)
+                ? expandedHost
+                : path.resolve(workflowDir, expandedHost);
+            const readonly = m['readonly'] === true;
+            return [{ host, guest, readonly }];
+        })
+        : [];
+    const smolvm = {
+        image: asString(smolvmRaw['image']),
+        from,
+        cpus: asInt(smolvmRaw['cpus'], 2),
+        mem_mib: asInt(smolvmRaw['mem_mib'], 2048),
+        net: smolvmRaw['net'] !== false,
+        bin_path: asString(smolvmRaw['bin_path']),
+        volumes,
+        // Default forwarded credentials cover all three shipped ACP adapters so workflows that
+        // do not override `smolvm.forward_env` still authenticate after the default-adapter
+        // switch to claude-agent-acp.
+        forward_env: asStringList(smolvmRaw['forward_env'], [
+            'OPENAI_API_KEY',
+            'ANTHROPIC_API_KEY',
+        ]),
+        endpoint: asString(smolvmRaw['endpoint']) ??
+            `unix://${process.env.XDG_RUNTIME_DIR ?? '/run/user/1000'}/smolvm.sock`,
+    };
+    // server extension (§13.7)
+    const serverRaw = getObject(raw, 'server');
+    const server = {
+        port: typeof serverRaw['port'] === 'number' ? serverRaw['port'] : null,
+        host: asString(serverRaw['host']) ?? '127.0.0.1',
+    };
+    // mcp extension: per-issue MCP server (mark_done + request_human_steering tools) injected
+    // into each ACP session. `host` defaults to the QEMU slirp gateway; the port is the
+    // actually-bound HTTP server's port (resolved at runtime, not config-parse time, so
+    // `--port` and an unset server.port can never desync). `host_url` is an explicit full-URL
+    // override for cases where the VM can't reach the orchestrator via the host gateway.
+    const mcpRaw = getObject(raw, 'mcp');
+    const mcpEnabledRaw = mcpRaw['enabled'];
+    const mcpEnabled = mcpEnabledRaw === undefined ? true : mcpEnabledRaw !== false;
+    const mcp = {
+        enabled: mcpEnabled,
+        // 127.0.0.1 works for smolvm because its VM network intercepts loopback
+        // traffic and forwards it to the host's loopback. (Empirically verified;
+        // 10.0.2.2 — the QEMU slirp gateway — is NOT reachable here.) Other VMMs
+        // can override via the `host` field in the WORKFLOW.md mcp block.
+        host: asString(mcpRaw['host']) ?? '127.0.0.1',
+        explicit_host_url: asString(mcpRaw['host_url']),
+    };
+    return {
+        workflow_path: workflowAbs,
+        workflow_dir: workflowDir,
+        tracker,
+        polling,
+        workspace,
+        hooks,
+        agent,
+        acp,
+        smolvm,
+        server,
+        mcp,
+    };
+}
+// §6.3 dispatch preflight validation.
+export function validateDispatch(cfg) {
+    if (!cfg.tracker.kind)
+        return 'tracker.kind is required';
+    if (cfg.tracker.kind !== 'linear' && cfg.tracker.kind !== 'local') {
+        return `unsupported_tracker_kind: ${cfg.tracker.kind}`;
+    }
+    if (cfg.tracker.kind === 'linear') {
+        if (!cfg.tracker.api_key)
+            return 'missing_tracker_api_key';
+        if (!cfg.tracker.project_slug)
+            return 'missing_tracker_project_slug';
+    }
+    if (cfg.tracker.kind === 'local') {
+        if (!cfg.tracker.root)
+            return 'tracker.root must be set for local tracker';
+        if (!existsSync(cfg.tracker.root) || !statSync(cfg.tracker.root).isDirectory()) {
+            return `tracker.root not found or not a directory: ${cfg.tracker.root}`;
+        }
+    }
+    // When acp.command is explicitly set, the operator owns the launch (and credential
+    // staging). Otherwise the adapter id must be one symphony has a profile for, so
+    // the runner can auto-derive the command and ship credentials.
+    if (cfg.acp.command !== null) {
+        if (!cfg.acp.command.trim())
+            return 'acp.command must be non-empty when set';
+    }
+    else if (!isKnownAdapter(cfg.acp.adapter)) {
+        return `acp.adapter "${cfg.acp.adapter}" is not a known profile; set acp.command to override or use one of: claude, codex`;
+    }
+    return null;
+}
+// Build + watch a workflow source. Throws on initial load failure.
+export async function watchWorkflow(workflowPath) {
+    const workflowAbs = path.resolve(workflowPath);
+    const initialDef = await loadWorkflow(workflowAbs);
+    const initialCfg = buildServiceConfig(initialDef.config, workflowAbs);
+    let current = { definition: initialDef, config: initialCfg };
+    const listeners = new Set();
+    const watcher = chokidar.watch(workflowAbs, {
+        ignoreInitial: true,
+        persistent: true,
+    });
+    let reloadInFlight = null;
+    const reload = async () => {
+        if (reloadInFlight)
+            return reloadInFlight;
+        reloadInFlight = (async () => {
+            try {
+                const def = await loadWorkflow(workflowAbs);
+                const cfg = buildServiceConfig(def.config, workflowAbs);
+                current = { definition: def, config: cfg };
+                log.info('workflow reloaded', { path: workflowAbs });
+                for (const cb of listeners)
+                    cb({ definition: def, config: cfg });
+            }
+            catch (err) {
+                const e = err instanceof WorkflowError
+                    ? err
+                    : new WorkflowError('workflow_parse_error', err.message);
+                log.warn('workflow reload failed; keeping last good config', { error: e.message, code: e.code });
+                for (const cb of listeners)
+                    cb({ error: e });
+            }
+            finally {
+                reloadInFlight = null;
+            }
+        })();
+        return reloadInFlight;
+    };
+    watcher.on('change', () => void reload());
+    watcher.on('add', () => void reload());
+    // §5.5: workflow read errors must block dispatch. If the file is deleted or temporarily
+    // renamed, surface a missing_workflow_file error so the orchestrator knows.
+    watcher.on('unlink', () => void reload());
+    return {
+        current: () => current,
+        onChange: (cb) => {
+            listeners.add(cb);
+            return () => listeners.delete(cb);
+        },
+        stop: () => watcher.close(),
+    };
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/dist/workspace.js

@@ -0,0 +1,196 @@
+// Workspace manager (SPEC §9). Per-issue workspace dirs under workspace.root.
+//
+// Safety invariants enforced:
+// 1. Workspace path is rooted at workspace.root (containment check).
+// 2. Workspace key is sanitized — only [A-Za-z0-9._-] allowed.
+// 3. Agent cwd MUST equal the workspace path (enforced by callers via runWithCwd).
+import { mkdir, rm, lstat } from 'node:fs/promises';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+export class WorkspaceError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'WorkspaceError';
+    }
+}
+// §9.5 Invariant 3.
+export function sanitizeWorkspaceKey(identifier) {
+    return identifier.replace(/[^A-Za-z0-9._-]/g, '_');
+}
+// §9.5 Invariant 2: workspace path MUST be contained within workspace root.
+//
+// We deliberately check for a `..` path component rather than a `..` prefix on the
+// relative path: an identifier like `..fix` sanitizes to a perfectly contained child
+// directory whose relative path begins with the two-character substring `..` but does
+// not actually escape the root.
+export function assertContained(workspaceRoot, candidate) {
+    const rootAbs = path.resolve(workspaceRoot);
+    const candAbs = path.resolve(candidate);
+    if (candAbs === rootAbs) {
+        throw new WorkspaceError('invalid_workspace_path', `workspace path must not equal workspace root (${rootAbs})`);
+    }
+    const rel = path.relative(rootAbs, candAbs);
+    if (rel === '' || path.isAbsolute(rel)) {
+        throw new WorkspaceError('invalid_workspace_path', `workspace path ${candAbs} is not contained within ${rootAbs}`);
+    }
+    const parts = rel.split(path.sep);
+    if (parts.some((p) => p === '..')) {
+        throw new WorkspaceError('invalid_workspace_path', `workspace path ${candAbs} is not contained within ${rootAbs}`);
+    }
+}
+// A hook failed when it timed out, exited with a non-zero status, or was terminated by a
+// signal. The signal-termination case is important — otherwise a fatal `before_run` script
+// that calls `kill -TERM $$` would look successful (exit_code=null, timed_out=false).
+function hookFailed(res) {
+    return res.timed_out || res.signal !== null || res.exit_code !== 0;
+}
+function hookFailureReason(res) {
+    if (res.timed_out)
+        return 'timed out';
+    if (res.signal !== null)
+        return `terminated by signal ${res.signal}`;
+    return `exited with code ${res.exit_code}`;
+}
+// Execute a hook script (POSIX `sh -lc`). Returns result so callers can decide on failure
+// semantics (§9.4).
+export async function runHookScript(script, cwd, timeoutMs) {
+    return new Promise((resolve) => {
+        const child = spawn('sh', ['-lc', script], {
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: process.env,
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        child.stdout?.on('data', (b) => {
+            stdout += b.toString('utf8');
+            if (stdout.length > 65_536)
+                stdout = stdout.slice(0, 65_536);
+        });
+        child.stderr?.on('data', (b) => {
+            stderr += b.toString('utf8');
+            if (stderr.length > 65_536)
+                stderr = stderr.slice(0, 65_536);
+        });
+        const t = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGKILL');
+        }, timeoutMs);
+        child.on('error', () => {
+            clearTimeout(t);
+            resolve({ ran: true, exit_code: null, signal: null, timed_out: timedOut, stdout, stderr });
+        });
+        child.on('close', (code, signal) => {
+            clearTimeout(t);
+            resolve({
+                ran: true,
+                exit_code: code,
+                signal: signal ?? null,
+                timed_out: timedOut,
+                stdout,
+                stderr,
+            });
+        });
+    });
+}
+export class WorkspaceManager {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    updateConfig(cfg) {
+        this.cfg = cfg;
+    }
+    workspacePathFor(identifier) {
+        const key = sanitizeWorkspaceKey(identifier);
+        if (key.length === 0) {
+            throw new WorkspaceError('invalid_workspace_key', `cannot sanitize identifier: ${identifier}`);
+        }
+        return path.join(this.cfg.workspace.root, key);
+    }
+    // Ensure the per-issue workspace directory exists. Runs after_create when created_now.
+    async ensureFor(identifier) {
+        const workspaceRoot = this.cfg.workspace.root;
+        await mkdir(workspaceRoot, { recursive: true });
+        const wsPath = this.workspacePathFor(identifier);
+        assertContained(workspaceRoot, wsPath);
+        let createdNow = false;
+        try {
+            // Use lstat so symlinks at the workspace path are rejected: a symlink could redirect
+            // hook execution and the returned cwd outside the workspace root, which violates the
+            // §9.5 containment invariant.
+            const st = await lstat(wsPath);
+            if (st.isSymbolicLink()) {
+                throw new WorkspaceError('workspace_path_is_symlink', `workspace path ${wsPath} is a symlink; refusing to use`);
+            }
+            if (!st.isDirectory()) {
+                throw new WorkspaceError('workspace_path_not_directory', `expected directory at ${wsPath}, found a non-directory`);
+            }
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                await mkdir(wsPath, { recursive: true });
+                createdNow = true;
+            }
+            else {
+                throw err;
+            }
+        }
+        if (createdNow && this.cfg.hooks.after_create) {
+            const res = await runHookScript(this.cfg.hooks.after_create, wsPath, this.cfg.hooks.timeout_ms);
+            if (hookFailed(res)) {
+                // §9.4: after_create failure is fatal — also unwind the partially prepared directory.
+                try {
+                    await rm(wsPath, { recursive: true, force: true });
+                }
+                catch {
+                    // Best-effort cleanup.
+                }
+                throw new WorkspaceError('after_create_failed', `after_create hook ${hookFailureReason(res)}`);
+            }
+        }
+        return {
+            path: wsPath,
+            workspace_key: sanitizeWorkspaceKey(identifier),
+            created_now: createdNow,
+        };
+    }
+    // Run before_run; throw on failure/timeout (§9.4).
+    async runBeforeRun(workspacePath, hooks) {
+        if (!hooks.before_run)
+            return;
+        const res = await runHookScript(hooks.before_run, workspacePath, hooks.timeout_ms);
+        if (hookFailed(res)) {
+            throw new WorkspaceError('before_run_failed', `before_run hook ${hookFailureReason(res)}`);
+        }
+    }
+    // Best-effort after_run hook (§9.4: failure logged and ignored — caller logs).
+    async runAfterRunBestEffort(workspacePath, hooks) {
+        if (!hooks.after_run)
+            return null;
+        return runHookScript(hooks.after_run, workspacePath, hooks.timeout_ms);
+    }
+    // Best-effort before_remove + filesystem removal (§9.4).
+    async remove(identifier, hooks) {
+        const wsPath = this.workspacePathFor(identifier);
+        assertContained(this.cfg.workspace.root, wsPath);
+        let hookResult = null;
+        try {
+            const st = await lstat(wsPath);
+            if (st.isSymbolicLink() || !st.isDirectory())
+                return null;
+        }
+        catch {
+            return null;
+        }
+        if (hooks.before_remove) {
+            hookResult = await runHookScript(hooks.before_remove, wsPath, hooks.timeout_ms);
+        }
+        await rm(wsPath, { recursive: true, force: true });
+        return hookResult;
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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