slavedriver 0.1.0

package/dist/mcp/tools.js

@@ -0,0 +1,259 @@
+// ── Validation helpers ──────────────────────────────────────────────────────
+function asRecord(params) {
+    if (typeof params === 'object' && params !== null && !Array.isArray(params)) {
+        return params;
+    }
+    return {};
+}
+function invalidParams(message) {
+    return { content: [{ type: 'text', text: `Invalid parameters: ${message}` }], isError: true };
+}
+function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+// ── Config validation ───────────────────────────────────────────────────────
+const SETTABLE_CONFIG_KEYS = new Set([
+    'maxConcurrentAgents',
+    'maxTotalTokens',
+    'maxTokensPerStep',
+    'maxWallTimeSeconds',
+    'maxAgentInvocations',
+]);
+const NUMERIC_BOUNDS = {
+    maxConcurrentAgents: { min: 1, max: 24 },
+    maxTotalTokens: { min: 1000, max: 100_000_000 },
+    maxTokensPerStep: { min: 1000, max: 10_000_000 },
+    maxWallTimeSeconds: { min: 10, max: 86400 },
+    maxAgentInvocations: { min: 1, max: 1000 },
+};
+function validateConfigValue(key, value) {
+    const bounds = NUMERIC_BOUNDS[key];
+    if (bounds) {
+        if (typeof value !== 'number' || !Number.isFinite(value) || value < bounds.min || value > bounds.max) {
+            return `${key} must be a number between ${bounds.min} and ${bounds.max}`;
+        }
+        if (Number.isInteger(bounds.min) && !Number.isInteger(value)) {
+            return `${key} must be an integer`;
+        }
+        return null;
+    }
+    return `${key} cannot be set via config tool`;
+}
+// ── Tool definitions ────────────────────────────────────────────────────────
+const TOOL_DEFS = [
+    {
+        name: 'slavedriver_start',
+        description: 'Launch the slavedriver pipeline with a goal. By default blocks until the pipeline completes and returns a summary. Set wait=false to return immediately with a run ID for polling.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                goal: { type: 'string', description: 'The goal or task description for the pipeline' },
+                dryRun: { type: 'boolean', description: 'Stop after planning (do not execute)' },
+                wait: { type: 'boolean', description: 'Block until pipeline completes (default true). Set false to return immediately.' },
+            },
+            required: ['goal'],
+        },
+    },
+    {
+        name: 'slavedriver_status',
+        description: 'Get the current status of the slavedriver pipeline run.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                includeEvents: { type: 'boolean', description: 'Include recent events in response' },
+                eventLimit: { type: 'number', description: 'Max events to return (default 20)' },
+            },
+        },
+    },
+    {
+        name: 'slavedriver_abort',
+        description: 'Abort the current pipeline run.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'slavedriver_config',
+        description: 'Read or update project configuration.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['get', 'set'], description: 'Read or write config' },
+                key: { type: 'string', description: 'Config key to set (required for set)' },
+                value: { description: 'Config value to set (required for set)' },
+            },
+            required: ['action'],
+        },
+    },
+];
+export function createToolRegistry(params) {
+    const { runManager, store, sdRoot, workingDirectory, configPath } = params;
+    async function readConfig() {
+        const { readFile } = await import('node:fs/promises');
+        const content = await readFile(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    async function writeConfig(config) {
+        const { writeFile } = await import('node:fs/promises');
+        await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    }
+    const handlers = {
+        slavedriver_start: async (p) => {
+            let goal;
+            if (typeof p['goal'] === 'string' && p['goal'].trim().length > 0) {
+                goal = p['goal'].trim();
+            }
+            else {
+                return invalidParams('goal is required and must be a non-empty string');
+            }
+            if (goal.length > 10_000) {
+                return invalidParams('goal must be 10,000 characters or fewer');
+            }
+            const wait = p['wait'] !== false; // default true
+            try {
+                const runId = runManager.start(goal, {
+                    dryRun: p['dryRun'] === true,
+                });
+                if (!wait) {
+                    const state = runManager.getState();
+                    return textResult(JSON.stringify({
+                        runId,
+                        status: 'started',
+                        ...(state?.dashboardSession ? { dashboard: `tmux attach-session -t ${state.dashboardSession}` } : {}),
+                    }));
+                }
+                // Block until pipeline completes
+                const finalState = await runManager.waitForCompletion();
+                if (!finalState) {
+                    return textResult(JSON.stringify({ runId, status: 'completed' }));
+                }
+                const elapsedMs = Date.now() - new Date(finalState.startedAt).getTime();
+                const elapsedSec = Math.round(elapsedMs / 1000);
+                return textResult(JSON.stringify({
+                    runId,
+                    status: 'completed',
+                    steps: {
+                        total: finalState.totalSteps,
+                        completed: finalState.completedSteps,
+                        failed: finalState.failedSteps,
+                    },
+                    tokens: finalState.totalInputTokens + finalState.totalOutputTokens,
+                    elapsedSeconds: elapsedSec,
+                    ...(finalState.error ? { error: finalState.error } : {}),
+                    ...(finalState.dashboardSession ? { dashboard: `tmux attach-session -t ${finalState.dashboardSession}` } : {}),
+                }));
+            }
+            catch (err) {
+                return errorResult(err instanceof Error ? err.message : String(err));
+            }
+        },
+        slavedriver_status: async (p) => {
+            const state = runManager.getState();
+            const includeEvents = p['includeEvents'] === true;
+            const eventLimit = typeof p['eventLimit'] === 'number' ? Math.min(Math.max(1, p['eventLimit']), 200) : 20;
+            if (!state) {
+                // No active run — read step store directly
+                try {
+                    const steps = await store.listSteps();
+                    if (steps.length === 0) {
+                        return textResult(JSON.stringify({ status: 'no_steps' }));
+                    }
+                    const completed = steps.filter((s) => s.meta.status === 'completed').length;
+                    const failed = steps.filter((s) => s.meta.status === 'failed').length;
+                    const running = steps.filter((s) => s.meta.status === 'running').length;
+                    const pending = steps.filter((s) => s.meta.status === 'pending').length;
+                    const stepList = steps.map((s) => ({
+                        number: s.number,
+                        name: s.meta.name,
+                        status: s.meta.status,
+                        agent: s.meta.agent,
+                    }));
+                    return textResult(JSON.stringify({
+                        status: 'idle',
+                        steps: { total: steps.length, completed, failed, running, pending },
+                        stepList,
+                    }));
+                }
+                catch {
+                    return textResult(JSON.stringify({ status: 'no_active_run' }));
+                }
+            }
+            const result = {
+                ...state,
+                summary: `Steps: ${state.completedSteps}/${state.totalSteps} done${state.failedSteps > 0 ? `, ${state.failedSteps} failed` : ''} | Tokens: ${state.totalInputTokens + state.totalOutputTokens}`,
+            };
+            if (includeEvents) {
+                result['recentEvents'] = runManager.getRecentEvents(eventLimit);
+            }
+            return textResult(JSON.stringify(result));
+        },
+        slavedriver_abort: async () => {
+            const aborted = runManager.abort();
+            if (!aborted) {
+                return errorResult('No active run to abort');
+            }
+            return textResult(JSON.stringify({ status: 'aborted' }));
+        },
+        slavedriver_config: async (p) => {
+            const action = p['action'];
+            if (action === 'get') {
+                try {
+                    const config = await readConfig();
+                    return textResult(JSON.stringify(config));
+                }
+                catch (err) {
+                    return errorResult(err instanceof Error ? err.message : String(err));
+                }
+            }
+            if (action === 'set') {
+                const key = p['key'];
+                if (typeof key !== 'string' || key.trim().length === 0) {
+                    return invalidParams('key is required for set action');
+                }
+                if (!SETTABLE_CONFIG_KEYS.has(key)) {
+                    return invalidParams(`unknown or unsettable config key: ${key}`);
+                }
+                const value = p['value'];
+                if (value === undefined) {
+                    return invalidParams('value is required for set action');
+                }
+                const validationError = validateConfigValue(key, value);
+                if (validationError) {
+                    return invalidParams(validationError);
+                }
+                try {
+                    const current = await readConfig();
+                    const updated = { ...current, [key]: value };
+                    await writeConfig(updated);
+                    return textResult(JSON.stringify({ status: 'updated', key, value }));
+                }
+                catch (err) {
+                    return errorResult(err instanceof Error ? err.message : String(err));
+                }
+            }
+            return invalidParams('action must be one of: get, set');
+        },
+    };
+    return {
+        list() {
+            return [...TOOL_DEFS];
+        },
+        async call(name, params) {
+            const handler = handlers[name];
+            if (!handler) {
+                return errorResult(`Unknown tool: ${name}`);
+            }
+            try {
+                return await handler(asRecord(params));
+            }
+            catch (err) {
+                return errorResult(`Internal error: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/orchestrator/alert-types.d.ts

@@ -0,0 +1,16 @@
+export type AlertSeverity = 'question' | 'blocked' | 'warning' | 'error' | 'approval';
+export interface AgentAlert {
+    readonly taskId: string;
+    readonly executionId: string;
+    readonly severity: AlertSeverity;
+    readonly message: string;
+    readonly context?: string;
+    readonly timestamp: number;
+}
+export type AlertAction = 'answer' | 'retry' | 'skip' | 'abort';
+export interface AlertResponse {
+    readonly action: AlertAction;
+    readonly message?: string;
+}
+export type AlertCallback = (alert: AgentAlert) => Promise<AlertResponse>;
+export type AlertPolicy = 'skip' | 'abort' | 'retry';

package/dist/orchestrator/alert-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=alert-types.js.map

package/dist/orchestrator/alert-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-types.js","sourceRoot":"","sources":["../../src/orchestrator/alert-types.ts"],"names":[],"mappings":""}

package/dist/orchestrator/alerts.d.ts

@@ -0,0 +1,20 @@
+import type { AgentAlert, AlertCallback, AlertPolicy, AlertResponse, AlertSeverity } from './alert-types.js';
+export type { AgentAlert, AlertCallback, AlertPolicy, AlertResponse, AlertSeverity };
+export { type AlertAction } from './alert-types.js';
+export interface AlertHandlerParams {
+    readonly onAlert?: AlertCallback;
+    readonly alertPolicy: AlertPolicy;
+    readonly enableAlerts: boolean;
+}
+export interface AlertStats {
+    readonly total: number;
+    readonly answered: number;
+    readonly skipped: number;
+    readonly aborted: number;
+    readonly retried: number;
+}
+export interface AlertHandler {
+    handleAlert(alert: AgentAlert): Promise<AlertResponse>;
+    getStats(): AlertStats;
+}
+export declare function createAlertHandler(params: AlertHandlerParams): AlertHandler;

package/dist/orchestrator/alerts.js

@@ -0,0 +1,76 @@
+const BLOCKING_SEVERITIES = new Set(['blocked', 'error']);
+export function createAlertHandler(params) {
+    let total = 0;
+    let answered = 0;
+    let skipped = 0;
+    let aborted = 0;
+    let retried = 0;
+    function trackResponse(response) {
+        total++;
+        switch (response.action) {
+            case 'answer':
+                answered++;
+                break;
+            case 'skip':
+                skipped++;
+                break;
+            case 'abort':
+                aborted++;
+                break;
+            case 'retry':
+                retried++;
+                break;
+        }
+    }
+    function autoHandleDisabled(severity) {
+        if (BLOCKING_SEVERITIES.has(severity)) {
+            return { action: 'abort' };
+        }
+        return { action: 'skip' };
+    }
+    function autoHandleByPolicy(severity) {
+        switch (params.alertPolicy) {
+            case 'skip':
+                return { action: 'skip' };
+            case 'abort':
+                return BLOCKING_SEVERITIES.has(severity)
+                    ? { action: 'abort' }
+                    : { action: 'skip' };
+            case 'retry':
+                return BLOCKING_SEVERITIES.has(severity)
+                    ? { action: 'retry' }
+                    : { action: 'skip' };
+        }
+    }
+    async function handleAlert(alert) {
+        // Alerts disabled — auto-respond based on severity
+        if (!params.enableAlerts) {
+            const response = autoHandleDisabled(alert.severity);
+            trackResponse(response);
+            return response;
+        }
+        // Interactive mode — callback provided
+        if (params.onAlert) {
+            try {
+                const response = await params.onAlert(alert);
+                trackResponse(response);
+                return response;
+            }
+            catch {
+                // Callback failed — abort as safety measure
+                const response = { action: 'abort' };
+                trackResponse(response);
+                return response;
+            }
+        }
+        // Non-interactive mode — auto-handle by policy
+        const response = autoHandleByPolicy(alert.severity);
+        trackResponse(response);
+        return response;
+    }
+    function getStats() {
+        return { total, answered, skipped, aborted, retried };
+    }
+    return { handleAlert, getStats };
+}
+//# sourceMappingURL=alerts.js.map

package/dist/orchestrator/alerts.js.map

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

package/dist/orchestrator/checkpoints.d.ts

@@ -0,0 +1,8 @@
+import type { CheckpointConfig } from '../types.js';
+export type CheckpointAction = 'continue' | 'modify' | 'abort';
+export type CheckpointCallback = (phase: string, summary: string) => Promise<CheckpointAction>;
+export interface CheckpointHandler {
+    shouldPause(phase: string): boolean;
+    execute(phase: string, summary: string): Promise<CheckpointAction>;
+}
+export declare function createCheckpoint(config: CheckpointConfig, callback?: CheckpointCallback): CheckpointHandler;

package/dist/orchestrator/checkpoints.js

@@ -0,0 +1,24 @@
+const PHASE_TO_CONFIG_KEY = {
+    plan: 'afterPlan',
+    wave: 'afterEachWave',
+    execute: 'afterExecute',
+    security: 'afterSecurity',
+    qa: 'afterQA',
+};
+export function createCheckpoint(config, callback) {
+    return {
+        shouldPause(phase) {
+            const key = PHASE_TO_CONFIG_KEY[phase];
+            if (!key)
+                return false;
+            return config[key] === true;
+        },
+        async execute(phase, summary) {
+            if (!callback) {
+                return 'continue';
+            }
+            return callback(phase, summary);
+        },
+    };
+}
+//# sourceMappingURL=checkpoints.js.map

package/dist/orchestrator/checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.js","sourceRoot":"","sources":["../../src/orchestrator/checkpoints.ts"],"names":[],"mappings":"AAWA,MAAM,mBAAmB,GAA2C;IAClE,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,eAAe;IACzB,EAAE,EAAE,SAAS;CACd,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAC9B,MAAwB,EACxB,QAA6B;IAE7B,OAAO;QACL,WAAW,CAAC,KAAa;YACvB,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG;gBAAE,OAAO,KAAK,CAAC;YACvB,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;QAC9B,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAe;YAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,OAAO,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/orchestrator/engine.d.ts

@@ -0,0 +1,71 @@
+import type { Phase, Task, TaskEvent, ProjectConfig } from '../types.js';
+import type { AgentRuntime, AgentEvent } from '../agents/runtime.js';
+import type { StateStore } from '../state/store.js';
+import type { SessionManager } from '../session/manager.js';
+import type { SafetyState } from './safety.js';
+import type { WaveResult } from './wave-executor.js';
+import type { CheckpointCallback } from './checkpoints.js';
+import type { AlertCallback, AgentAlert, AlertResponse } from './alert-types.js';
+export type EngineEvent = {
+    type: 'phase_changed';
+    from: Phase;
+    to: Phase;
+} | {
+    type: 'tasks_loaded';
+    tasks: readonly Task[];
+    totalWaves: number;
+} | {
+    type: 'wave_started';
+    wave: number;
+    taskCount: number;
+} | {
+    type: 'wave_completed';
+    wave: number;
+    results: WaveResult;
+} | {
+    type: 'task_event';
+    event: TaskEvent;
+} | {
+    type: 'agent_event';
+    taskId: string;
+    event: AgentEvent;
+} | {
+    type: 'error';
+    error: string;
+    phase: Phase;
+} | {
+    type: 'complete';
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalAgentInvocations: number;
+    taskCount: number;
+} | {
+    type: 'approval_required';
+    plan: string;
+} | {
+    type: 'alert';
+    alert: AgentAlert;
+    response: AlertResponse;
+};
+export interface EngineParams {
+    readonly runtime: AgentRuntime;
+    readonly store: StateStore;
+    readonly sessionManager: SessionManager;
+    readonly config: ProjectConfig;
+    readonly workingDirectory: string;
+    readonly onEvent: (event: EngineEvent) => void;
+    readonly onApproval?: (plan: string) => Promise<boolean>;
+    readonly onCheckpoint?: CheckpointCallback;
+    readonly onAlert?: AlertCallback;
+    readonly abortSignal?: AbortSignal;
+    readonly skipDiscovery?: boolean;
+    readonly skipVerification?: boolean;
+    readonly dryRun?: boolean;
+    readonly targetWave?: number;
+}
+export interface Engine {
+    run(goal: string): Promise<void>;
+    readonly phase: Phase;
+    readonly safetyState: SafetyState;
+}
+export declare function createEngine(params: EngineParams): Engine;