@amsterdamdatalabs/enact-factory 0.1.1

package/dist/adapters/agenticLoop.js

@@ -0,0 +1,219 @@
+// ============================================
+// EnactFactory - Agentic Tool Loop
+// Created: 2026-04-11
+// Purpose: HTTP adapters with tool loops get Claude-like tool-use behavior
+//          범용 에이전틱 루프 엔진.
+//          OpenAI function calling 포맷 기반.
+// ============================================
+import { TOOL_DEFINITIONS, executeToolCalls } from '../adapters/tools.js';
+// ============ 에이전틱 루프 ============
+/**
+ * 에이전틱 도구 루프 실행
+ *
+ * 흐름:
+ * 1. 프롬프트로 API 호출 (도구 정의 포함)
+ * 2. 응답에 tool_calls가 있으면 → 도구 실행 → 결과를 메시지에 추가 → 2로
+ * 3. 응답에 tool_calls가 없으면 (finish_reason = 'stop') → 최종 텍스트 반환
+ */
+export async function runAgenticLoop(options) {
+    const { systemPrompt, prompt, cwd, callApi, maxTurns = 15, timeoutMs = 300000, onLog, enableTools = true, } = options;
+    const startTime = Date.now();
+    const deadline = startTime + timeoutMs;
+    // 메시지 히스토리 구성
+    const messages = [];
+    if (systemPrompt) {
+        messages.push({ role: 'system', content: systemPrompt });
+    }
+    messages.push({ role: 'user', content: prompt });
+    const tools = enableTools ? TOOL_DEFINITIONS : [];
+    let toolCallCount = 0;
+    let apiCallCount = 0;
+    let totalTokens = 0;
+    let finalText = '';
+    for (let turn = 0; turn < maxTurns + 1; turn++) {
+        // 타임아웃 체크
+        if (Date.now() > deadline) {
+            onLog?.(`⏰ Agentic loop timeout after ${turn} turns`);
+            break;
+        }
+        // 매 턴 히스토리 압축 — 이전 턴의 tool call/result를 1줄 요약으로 교체
+        if (turn >= 2) {
+            compactPriorTurns(messages);
+        }
+        // API 호출
+        apiCallCount++;
+        onLog?.(`▸ API call #${apiCallCount}${turn > 0 ? ` (tool turn ${turn})` : ''}`);
+        let response;
+        try {
+            response = await callApi(messages, tools);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            onLog?.(`✖ API error: ${msg}`);
+            finalText = `API error: ${msg}`;
+            break;
+        }
+        if (response.usage) {
+            totalTokens += response.usage.prompt_tokens + response.usage.completion_tokens;
+        }
+        const choice = response.choices?.[0];
+        if (!choice) {
+            onLog?.('✖ Empty response from API');
+            finalText = 'Empty API response';
+            break;
+        }
+        const assistantMsg = choice.message;
+        // 도구 호출이 없으면 최종 응답
+        if (!assistantMsg.tool_calls || assistantMsg.tool_calls.length === 0) {
+            finalText = assistantMsg.content ?? '';
+            break;
+        }
+        // 어시스턴트 메시지를 히스토리에 추가 (tool_calls 포함)
+        messages.push({
+            role: 'assistant',
+            content: assistantMsg.content,
+            tool_calls: assistantMsg.tool_calls,
+        });
+        // 도구 실행
+        const toolCalls = assistantMsg.tool_calls.map(tc => ({
+            id: tc.id,
+            function: {
+                name: tc.function.name,
+                arguments: tc.function.arguments,
+            },
+        }));
+        for (const tc of toolCalls) {
+            try {
+                const args = JSON.parse(tc.function.arguments);
+                const argSummary = summarizeToolArgs(tc.function.name, args);
+                onLog?.(`  🔧 ${tc.function.name}${argSummary ? ': ' + argSummary : ''}`);
+            }
+            catch {
+                onLog?.(`  🔧 ${tc.function.name}`);
+            }
+        }
+        const results = await executeToolCalls(toolCalls, cwd);
+        toolCallCount += toolCalls.length;
+        // 도구 결과를 메시지에 추가
+        for (const result of results) {
+            messages.push({
+                role: 'tool',
+                tool_call_id: result.tool_call_id,
+                content: result.content,
+            });
+            if (result.is_error) {
+                onLog?.(`  ✖ ${result.content.slice(0, 100)}`);
+            }
+        }
+    }
+    return {
+        text: finalText,
+        toolCallCount,
+        apiCallCount,
+        totalTokens,
+        durationMs: Date.now() - startTime,
+    };
+}
+/**
+ * AgenticLoopResult → CliRunResult 변환
+ */
+export function loopResultToCliResult(result) {
+    return {
+        exitCode: 0,
+        stdout: result.text,
+        stderr: '',
+        durationMs: result.durationMs,
+    };
+}
+// ============ 히스토리 압축 ============
+/**
+ * 최근 1턴(assistant + tool results)만 원본 유지.
+ * 그 이전 턴의 assistant+tool 쌍을 1줄 요약 assistant 메시지로 교체.
+ *
+ * 구조 변환:
+ *   [system, user, asst(tool_calls), tool, tool, asst(tool_calls), tool, ...]
+ *   → [system, user, asst("Prior: read_file→ok, edit→ok"), asst(latest_tool_calls), tool, ...]
+ *
+ * OpenAI API 제약: tool 메시지는 직전 assistant의 tool_call_id와 대응해야 함.
+ * 따라서 오래된 tool 메시지는 삭제하고, 해당 assistant도 일반 텍스트로 교체.
+ */
+function compactPriorTurns(messages) {
+    const headerCount = messages[0]?.role === 'system' ? 2 : 1;
+    // 마지막 assistant+tool 블록의 시작 인덱스 찾기
+    let lastAssistantIdx = -1;
+    for (let i = messages.length - 1; i >= headerCount; i--) {
+        if (messages[i].role === 'assistant') {
+            lastAssistantIdx = i;
+            break;
+        }
+    }
+    if (lastAssistantIdx <= headerCount)
+        return; // 압축할 이전 턴이 없음
+    // headerCount ~ lastAssistantIdx 사이의 모든 assistant+tool 쌍을 요약
+    const summaryParts = [];
+    const toRemove = [];
+    for (let i = headerCount; i < lastAssistantIdx; i++) {
+        const msg = messages[i];
+        if (msg.role === 'assistant' && msg.tool_calls && msg.tool_calls.length > 0) {
+            // tool call 요약: "read_file(src/foo.ts), edit_file(src/foo.ts)"
+            const callSummaries = msg.tool_calls.map(tc => {
+                try {
+                    const args = JSON.parse(tc.function.arguments);
+                    const key = args.path || args.pattern || args.command;
+                    const short = typeof key === 'string' ? key.slice(0, 50) : '';
+                    return `${tc.function.name}(${short})`;
+                }
+                catch {
+                    return tc.function.name;
+                }
+            });
+            summaryParts.push(callSummaries.join(', '));
+            toRemove.push(i);
+        }
+        else if (msg.role === 'tool') {
+            // tool result → 성공/실패만 기록
+            const ok = !msg.content.startsWith('BLOCKED') && !msg.content.startsWith('Tool error');
+            const firstLine = msg.content.split('\n')[0].slice(0, 60);
+            summaryParts.push(ok ? `→ok` : `→err: ${firstLine}`);
+            toRemove.push(i);
+        }
+        else if (msg.role === 'assistant' && !msg.tool_calls) {
+            // 일반 assistant 메시지 — 첫 줄만 유지
+            const short = (msg.content ?? '').split('\n')[0].slice(0, 80);
+            if (short)
+                summaryParts.push(`note: ${short}`);
+            toRemove.push(i);
+        }
+    }
+    if (toRemove.length === 0)
+        return;
+    // 요약 메시지 생성
+    const summaryText = `[Prior turns compacted] ${summaryParts.join(' | ')}`;
+    // 역순으로 제거 (인덱스 안정성)
+    for (let i = toRemove.length - 1; i >= 0; i--) {
+        messages.splice(toRemove[i], 1);
+    }
+    // header 직후에 요약 삽입
+    messages.splice(headerCount, 0, {
+        role: 'assistant',
+        content: summaryText,
+    });
+}
+// ============ 헬퍼 ============
+function summarizeToolArgs(name, args) {
+    switch (name) {
+        case 'read_file':
+            return String(args.path ?? '');
+        case 'write_file':
+            return String(args.path ?? '');
+        case 'edit_file':
+            return String(args.path ?? '');
+        case 'search_files':
+            return `"${args.pattern}" in ${args.path}`;
+        case 'bash':
+            return String(args.command ?? '').slice(0, 80);
+        default:
+            return '';
+    }
+}
+//# sourceMappingURL=agenticLoop.js.map

package/dist/adapters/agenticLoop.js.map

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

package/dist/adapters/base.d.ts

@@ -0,0 +1,16 @@
+import type { CliAdapter, CliRunOptions, CliRunResult } from '../adapters/types.js';
+export declare class CliSpawnError extends Error {
+    readonly adapterName: string;
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly durationMs: number;
+    constructor(message: string, adapterName: string, exitCode: number, stdout: string, stderr: string, durationMs: number);
+}
+/**
+ * Spawn a CLI process using the given adapter and options.
+ * Handles: temp file write, spawn with shell, timeout/SIGKILL,
+ * stdout/stderr buffering, stream parsing via onLog, cleanup.
+ */
+export declare function spawnCli(adapter: CliAdapter, options: CliRunOptions): Promise<CliRunResult>;
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnF,qBAAa,aAAc,SAAQ,KAAK;IAGpC,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAL3B,OAAO,EAAE,MAAM,EACN,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM;CAK9B;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA6HvB"}

package/dist/adapters/base.js

@@ -0,0 +1,135 @@
+// ============================================
+// EnactFactory - CLI Adapter Base
+// Shared spawn logic for all CLI adapters
+// ============================================
+import { spawn } from 'node:child_process';
+import fs from 'node:fs/promises';
+import { parseCliStreamChunk } from '../agents/cliStreamParser.js';
+import { registerProcess } from '../adapters/processRegistry.js';
+import { buildExecutorEnv } from '../adapters/envPath.js';
+export class CliSpawnError extends Error {
+    adapterName;
+    exitCode;
+    stdout;
+    stderr;
+    durationMs;
+    constructor(message, adapterName, exitCode, stdout, stderr, durationMs) {
+        super(message);
+        this.adapterName = adapterName;
+        this.exitCode = exitCode;
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.durationMs = durationMs;
+        this.name = 'CliSpawnError';
+    }
+}
+/**
+ * Spawn a CLI process using the given adapter and options.
+ * Handles: temp file write, spawn with shell, timeout/SIGKILL,
+ * stdout/stderr buffering, stream parsing via onLog, cleanup.
+ */
+export async function spawnCli(adapter, options) {
+    // 어댑터가 직접 실행을 지원하면 shell spawn 대신 사용
+    if (adapter.run) {
+        return adapter.run(options);
+    }
+    // Fail-closed: every CLI spawn must supply processContext (PID tracking) or
+    // explicitly opt out via `untracked: true` (support agents only).
+    if (!options.processContext && !options.untracked) {
+        throw new Error(`[spawnCli] process identity required for adapter "${adapter.name}": ` +
+            'supply options.processContext with workItemId+stage, or set options.untracked=true ' +
+            'to explicitly opt out of watchdog tracking.');
+    }
+    const promptFile = `/tmp/enact-factory-prompt-${Date.now()}.txt`;
+    await fs.writeFile(promptFile, options.prompt);
+    try {
+        const { command, args } = adapter.buildCommand({
+            ...options,
+            // Pass the temp file path as the prompt so buildCommand can reference it
+            prompt: promptFile,
+        });
+        const cmd = [command, ...args].join(' ');
+        const startTime = Date.now();
+        return await new Promise((resolve, reject) => {
+            const proc = spawn(cmd, {
+                shell: true,
+                cwd: options.cwd,
+                // Inject EnactFactory's bundled node_modules/.bin (gives executors access
+                // to `cxt` and other shipped CLIs) without touching the user's shell
+                // PATH or ~/.claude/ config.
+                env: buildExecutorEnv(process.env),
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            // Register process for tracking if context provided
+            if (options.processContext && proc.pid) {
+                registerProcess({
+                    pid: proc.pid,
+                    workItemId: options.processContext.workItemId,
+                    stage: options.processContext.stage,
+                    model: options.model,
+                    projectPath: options.cwd,
+                    spawnedAt: startTime,
+                    lastActivityAt: startTime,
+                }, proc);
+            }
+            let stdout = '';
+            let stderr = '';
+            let streamBuffer = '';
+            proc.stdout?.on('data', (data) => {
+                const text = data.toString();
+                stdout += text;
+                if (options.onLog && adapter.capabilities.supportsStreaming) {
+                    streamBuffer = adapter.parseStreamingChunk
+                        ? adapter.parseStreamingChunk(text, options.onLog, streamBuffer)
+                        : parseCliStreamChunk(text, options.onLog, streamBuffer);
+                }
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            const timeoutMs = options.timeoutMs ?? 300000;
+            let timer = null;
+            if (timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    proc.kill('SIGKILL');
+                    reject(new Error(`${adapter.name} timeout after ${timeoutMs}ms`));
+                }, timeoutMs);
+            }
+            proc.on('close', (code) => {
+                if (timer)
+                    clearTimeout(timer);
+                const durationMs = Date.now() - startTime;
+                if (options.onLog && adapter.capabilities.supportsStreaming && streamBuffer.trim()) {
+                    streamBuffer = adapter.parseStreamingChunk
+                        ? adapter.parseStreamingChunk('\n', options.onLog, streamBuffer)
+                        : parseCliStreamChunk('\n', options.onLog, streamBuffer);
+                }
+                if (code !== 0 && code !== null) {
+                    const stderrSnippet = stderr.slice(0, 500);
+                    const stdoutSnippet = stdout.slice(0, 300);
+                    console.error(`[${adapter.name}] CLI exited with code ${code}`);
+                    console.error(`[${adapter.name}] stderr: ${stderrSnippet || '(empty)'}`);
+                    console.error(`[${adapter.name}] stdout (first 300): ${stdoutSnippet || '(empty)'}`);
+                    console.error(`[${adapter.name}] Duration: ${durationMs}ms, CWD: ${options.cwd}`);
+                    reject(new CliSpawnError(`${adapter.name} CLI failed with code ${code}: ${stderrSnippet.slice(0, 200)}`, adapter.name, code, stdout, stderr, durationMs));
+                    return;
+                }
+                resolve({ exitCode: code ?? 0, stdout, stderr, durationMs });
+            });
+            proc.on('error', (err) => {
+                if (timer)
+                    clearTimeout(timer);
+                reject(new Error(`${adapter.name} spawn error: ${err.message}`));
+            });
+        });
+    }
+    finally {
+        try {
+            await fs.unlink(promptFile);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

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

package/dist/adapters/claude.d.ts

@@ -0,0 +1,13 @@
+import type { CliAdapter, CliRunOptions, CliRunResult, AdapterCapabilities, ExecutorResult, ReviewResult } from '../adapters/types.js';
+export declare class ClaudeCliAdapter implements CliAdapter {
+    readonly name = "claude";
+    readonly capabilities: AdapterCapabilities;
+    isAvailable(): Promise<boolean>;
+    buildCommand(options: CliRunOptions): {
+        command: string;
+        args: string[];
+    };
+    parseExecutorOutput(raw: CliRunResult): ExecutorResult;
+    parseReviewerOutput(raw: CliRunResult): ReviewResult;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,YAAY,EACb,MAAM,qBAAqB,CAAC;AAU7B,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,IAAI,YAAY;IAEzB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAMxC;IAEI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IASzE,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc;IAuBtD,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;CAgCrD"}