@matteeh/osq 0.1.0

package/dist/core/status.js

@@ -0,0 +1,106 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_CONFIG } from './config.js';
+import { deriveSpecState } from './state.js';
+export async function getStatusOverview(projectRoot, config = DEFAULT_CONFIG) {
+    const specsDir = path.join(projectRoot, config.paths.specs);
+    let entries = [];
+    try {
+        entries = await fs.readdir(specsDir);
+    }
+    catch {
+        return { specs: [], archivedCount: 0, archivedChangeFolders: 0 };
+    }
+    const archiveDir = path.join(projectRoot, config.paths.archive);
+    const archiveRel = path.relative(specsDir, archiveDir);
+    const archiveFolder = !archiveRel.startsWith('..') && !path.isAbsolute(archiveRel)
+        ? archiveRel.split(path.sep)[0]
+        : 'archive';
+    const candidateFolders = entries.filter((e) => !e.startsWith('_') && !e.startsWith('.') && e !== archiveFolder);
+    const validFolders = [];
+    for (const folder of candidateFolders) {
+        const folderPath = path.join(specsDir, folder);
+        const stat = await fs.stat(folderPath).catch(() => null);
+        if (!stat || !stat.isDirectory())
+            continue;
+        const specMdStat = await fs.stat(path.join(folderPath, 'spec.md')).catch(() => null);
+        if (!specMdStat || !specMdStat.isFile())
+            continue;
+        validFolders.push(folder);
+    }
+    validFolders.sort((a, b) => {
+        const numA = Number.parseInt(a, 10);
+        const numB = Number.parseInt(b, 10);
+        if (!Number.isNaN(numA) && !Number.isNaN(numB)) {
+            return numA - numB;
+        }
+        return a.localeCompare(b);
+    });
+    const specs = [];
+    for (const folder of validFolders) {
+        const folderPath = path.join(specsDir, folder);
+        const specState = await deriveSpecState(projectRoot, folderPath);
+        specs.push(specState);
+    }
+    let archivedCount = 0;
+    try {
+        const archiveEntries = await fs.readdir(archiveDir);
+        for (const entry of archiveEntries) {
+            if (entry.startsWith('.'))
+                continue;
+            const fullPath = path.join(archiveDir, entry);
+            const stat = await fs.stat(fullPath).catch(() => null);
+            if (stat?.isDirectory()) {
+                archivedCount++;
+            }
+        }
+    }
+    catch {
+        archivedCount = 0;
+    }
+    return {
+        specs,
+        archivedCount,
+        archivedChangeFolders: archivedCount,
+    };
+}
+function formatTaskLine(task) {
+    let indicator = '[ ]';
+    if (task.status === 'done') {
+        indicator = '[x]';
+    }
+    else if (task.status === 'running') {
+        indicator = '[>]';
+    }
+    else if (task.status === 'dead') {
+        indicator = '[!]';
+    }
+    const title = task.title || task.fileName;
+    const deadInfo = task.deadReason ? ` (reason: ${task.deadReason})` : '';
+    return `  ${indicator} ${task.taskNumber}. ${title} [${task.status}]${deadInfo}`;
+}
+export function formatStatusOverview(overview) {
+    const lines = [];
+    lines.push('Active specs:');
+    if (overview.specs.length === 0) {
+        lines.push('  (none)');
+    }
+    else {
+        for (const spec of overview.specs) {
+            const approvalStatus = spec.approvedHash ? 'approved' : 'unapproved';
+            lines.push(`${spec.folderName}: ${spec.title} [${spec.status}] (${approvalStatus})`);
+            if (spec.tasks.length === 0) {
+                lines.push('  (no tasks)');
+            }
+            else {
+                for (const task of spec.tasks) {
+                    lines.push(formatTaskLine(task));
+                }
+            }
+        }
+    }
+    lines.push('');
+    lines.push(`Archived specs: ${overview.archivedCount}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=status.js.map

package/dist/core/status.js.map

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

package/dist/harness/agy.d.ts

@@ -0,0 +1,31 @@
+import type { OsqConfig } from '../core/config.js';
+import type { Logger } from '../core/logger.js';
+import { EventStreamParser } from './stream.js';
+import { type HarnessAdapter, type SpawnResult, type SpawnTaskOptions, type ToolEventData } from './types.js';
+export declare function resolveAgyBinary(): Promise<string>;
+export declare function buildAgyPrompt(options: SpawnTaskOptions): string;
+export declare function buildAgyArgs(options: SpawnTaskOptions): string[];
+export interface AgyStreamTokensData {
+    promptTokens: number;
+    candidateTokens: number;
+    totalTokens: number;
+    cachedTokens: number;
+    reasoningTokens: number;
+    cost: number;
+}
+export declare function extractAgyTokens(event: unknown): AgyStreamTokensData | null;
+export declare function extractAgyToolEvent(event: unknown): ToolEventData | null;
+export declare function processAgyStdoutLine(line: string, specFolderPath: string, taskNumber: string, logger?: Logger): Promise<void>;
+/**
+ * Compatibility subclass retained for existing callers and tests; the buffering
+ * and serialization logic lives entirely in the shared {@link EventStreamParser}.
+ */
+export declare class AgyEventStreamParser extends EventStreamParser {
+    constructor(specFolderPath: string, taskNumber: string, logger?: Logger);
+}
+export declare class AgyAdapter implements HarnessAdapter {
+    readonly name = "agy";
+    setup(projectRoot: string, _config: OsqConfig): Promise<void>;
+    spawn(options: SpawnTaskOptions): Promise<SpawnResult>;
+}
+//# sourceMappingURL=agy.d.ts.map

package/dist/harness/agy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agy.d.ts","sourceRoot":"","sources":["../../src/harness/agy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EACL,iBAAiB,EAIlB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAErB,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgBxD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAgChE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA2BhE;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAkC3E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAqDxE;AAqBD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;gBAC7C,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAGxE;AAED,qBAAa,UAAW,YAAW,cAAc;IAC/C,QAAQ,CAAC,IAAI,SAAS;IAEhB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAoC7D"}

package/dist/harness/agy.js

@@ -0,0 +1,251 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnWithTimeout } from './process.js';
+import { EventStreamParser, asRecord, firstNonEmptyString, resolveEventTimestamp, } from './stream.js';
+import { appendHarnessEvent, } from './types.js';
+export async function resolveAgyBinary() {
+    if (process.env.AGY_PATH) {
+        return process.env.AGY_PATH;
+    }
+    const home = os.homedir();
+    const candidates = [path.join(home, '.local', 'bin', 'agy'), '/usr/local/bin/agy', 'agy'];
+    for (const candidate of candidates) {
+        try {
+            await fs.access(candidate);
+            return candidate;
+        }
+        catch { }
+    }
+    return 'agy';
+}
+export function buildAgyPrompt(options) {
+    const { projectRoot, specFolderPath, taskNumber, taskTitle, scope, entry, verifyCommand } = options;
+    const taskRelPath = path.relative(projectRoot, path.join(specFolderPath, 'tasks', `${taskNumber}.md`));
+    const specRelPath = path.relative(projectRoot, path.join(specFolderPath, 'spec.md'));
+    const resultRelPath = path.relative(projectRoot, path.join(specFolderPath, '.run', 'results', `${taskNumber}.md`));
+    return [
+        'You are a coding agent working autonomously on an osq task. Follow AGENTS.md strictly.',
+        `Task File: ${taskRelPath}`,
+        `Parent Spec: ${specRelPath}`,
+        `Task Title: ${taskTitle}`,
+        `Scope: ${scope.join(', ')}`,
+        `Entry: ${entry.join(', ')}`,
+        `Verify Command: ${verifyCommand}`,
+        '',
+        'Rules:',
+        `1. Read ${taskRelPath}, ${specRelPath}, and features docs referenced in ${specRelPath}.`,
+        '2. Write tests for each acceptance line before implementing.',
+        '3. Keep all edits strictly inside scope.',
+        `4. Verify your work by running: ${verifyCommand}`,
+        `5. CRITICAL: Before exiting, you MUST write ${resultRelPath} documenting: changed, deviated, drift against features/, missing context, and next steps.`,
+        `6. Do not modify tasks.md, spec.md, or any file outside your scope and ${resultRelPath}.`,
+        `7. When done, write ${resultRelPath} and exit cleanly.`,
+    ].join('\n');
+}
+export function buildAgyArgs(options) {
+    const { config } = options;
+    const taskPrompt = buildAgyPrompt(options);
+    const model = config?.agy?.model || process.env.OSQ_MODEL || 'gemini-3.8-flash-high';
+    const dangerouslySkipPermissions = config?.agy?.dangerouslySkipPermissions ?? true;
+    const args = [
+        '-p',
+        taskPrompt,
+        '--model',
+        model,
+        '--mode',
+        'accept-edits',
+        '--output-format',
+        'stream-json',
+    ];
+    if (dangerouslySkipPermissions) {
+        args.push('--dangerously-skip-permissions');
+    }
+    const rawTimeout = config?.timeouts?.taskTimeoutSeconds ?? options.timeoutSeconds ?? 1800;
+    const printTimeout = Math.max(60, rawTimeout - 30);
+    args.push('--print-timeout', `${printTimeout}s`);
+    return args;
+}
+const AGY_TOOL_SUMMARY_MAX_LENGTH = 60;
+const AGY_COMMAND_TOOLS = new Set(['run_command', 'command_status', 'send_command_input']);
+export function extractAgyTokens(event) {
+    const eventObj = asRecord(event);
+    if (!eventObj) {
+        return null;
+    }
+    const stepUpdate = asRecord(eventObj.step_update);
+    const usage = asRecord(stepUpdate?.usage) ??
+        asRecord(asRecord(eventObj.result)?.usage) ??
+        asRecord(eventObj.usage);
+    if (!usage) {
+        return null;
+    }
+    const promptTokens = Number(usage.input_tokens) || 0;
+    const candidateTokens = Number(usage.output_tokens) || 0;
+    const cachedTokens = Number(usage.cache_read_tokens) || 0;
+    const reasoningTokens = Number(usage.thinking_tokens ?? usage.reasoning_tokens ?? 0) || 0;
+    const explicitTotal = Number(usage.total_tokens);
+    const totalTokens = Number.isFinite(explicitTotal) && explicitTotal > 0
+        ? explicitTotal
+        : promptTokens + candidateTokens;
+    return {
+        promptTokens,
+        candidateTokens,
+        totalTokens,
+        cachedTokens,
+        reasoningTokens,
+        cost: 0,
+    };
+}
+export function extractAgyToolEvent(event) {
+    const eventObj = asRecord(event);
+    if (!eventObj) {
+        return null;
+    }
+    const stepUpdate = asRecord(eventObj.step_update);
+    if (!stepUpdate || stepUpdate.step_type !== 'tool') {
+        return null;
+    }
+    const toolInfo = asRecord(stepUpdate.tool_info);
+    const tool = firstNonEmptyString(stepUpdate.tool_name, toolInfo?.name, stepUpdate.name);
+    if (!tool) {
+        return null;
+    }
+    const parameters = asRecord(toolInfo?.parameters) ??
+        asRecord(stepUpdate.parameters) ??
+        asRecord(toolInfo?.input) ??
+        asRecord(stepUpdate.input) ??
+        asRecord(eventObj.parameters) ??
+        {};
+    if (AGY_COMMAND_TOOLS.has(tool.toLowerCase())) {
+        const command = firstNonEmptyString(parameters.CommandLine, parameters.command, parameters.cmd, parameters.commandLine);
+        return { tool, summary: (command ?? '').slice(0, AGY_TOOL_SUMMARY_MAX_LENGTH) };
+    }
+    const target = firstNonEmptyString(parameters.AbsolutePath, parameters.path, parameters.file_path, parameters.filePath, parameters.file, parameters.absolute_path, parameters.target_file, parameters.DirectoryPath, parameters.directoryPath, parameters.pattern);
+    if (target) {
+        return { tool, summary: target };
+    }
+    const raw = Object.keys(parameters).length > 0 ? JSON.stringify(parameters) : '';
+    return { tool, summary: raw.slice(0, AGY_TOOL_SUMMARY_MAX_LENGTH) };
+}
+/**
+ * Single code path for tool observation: the events.jsonl entry and its verbose
+ * stderr log line are always emitted together by the shared stdout handler.
+ */
+async function recordAgyToolEvent(specFolderPath, taskNumber, toolEvent, timestamp, logger) {
+    await appendHarnessEvent(specFolderPath, taskNumber, {
+        type: 'tool',
+        timestamp,
+        data: { tool: toolEvent.tool, summary: toolEvent.summary },
+    });
+    logger?.verbose(`[tool] ${toolEvent.tool}: ${toolEvent.summary}`);
+}
+export async function processAgyStdoutLine(line, specFolderPath, taskNumber, logger) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return;
+    }
+    let event;
+    try {
+        event = JSON.parse(trimmed);
+    }
+    catch {
+        // agy may legitimately emit non-JSON output when stream-json is unsupported.
+        // It is diagnostic only: verbose logging, never stdout.
+        logger?.verbose(`[agy] Unrecognised stream line: ${trimmed}`);
+        return;
+    }
+    const eventObj = asRecord(event);
+    if (!eventObj) {
+        logger?.verbose(`[agy] Unrecognised stream line: ${trimmed}`);
+        return;
+    }
+    const toolEvent = extractAgyToolEvent(eventObj);
+    if (toolEvent) {
+        await recordAgyToolEvent(specFolderPath, taskNumber, toolEvent, resolveEventTimestamp(eventObj), logger);
+        return;
+    }
+    // The result payload carries the completed assistant response. Partial
+    // `text_delta` fragments from step updates are never persisted as text events.
+    const resultObj = asRecord(eventObj.result);
+    if (eventObj.event === 'result' || resultObj) {
+        const response = firstNonEmptyString(resultObj?.response);
+        if (response !== undefined) {
+            await appendHarnessEvent(specFolderPath, taskNumber, {
+                type: 'text',
+                timestamp: resolveEventTimestamp(eventObj),
+                data: { text: response },
+            });
+        }
+        return;
+    }
+    // Only per-step usage is counted; the trailing result event repeats the final
+    // totals and would otherwise double count in heartbeat accumulations.
+    if (!asRecord(eventObj.step_update)) {
+        logger?.verbose(`[agy] Unknown event type: ${eventObj.event ?? eventObj.type ?? 'unknown'}`);
+        return;
+    }
+    const tokensData = extractAgyTokens(eventObj);
+    if (!tokensData) {
+        return;
+    }
+    await appendHarnessEvent(specFolderPath, taskNumber, {
+        type: 'tokens',
+        timestamp: resolveEventTimestamp(eventObj),
+        data: {
+            promptTokens: tokensData.promptTokens,
+            candidateTokens: tokensData.candidateTokens,
+            totalTokens: tokensData.totalTokens,
+            cachedTokens: tokensData.cachedTokens,
+            reasoningTokens: tokensData.reasoningTokens,
+            cost: tokensData.cost,
+        },
+    });
+}
+/**
+ * Compatibility subclass retained for existing callers and tests; the buffering
+ * and serialization logic lives entirely in the shared {@link EventStreamParser}.
+ */
+export class AgyEventStreamParser extends EventStreamParser {
+    constructor(specFolderPath, taskNumber, logger) {
+        super((line) => processAgyStdoutLine(line, specFolderPath, taskNumber, logger));
+    }
+}
+export class AgyAdapter {
+    name = 'agy';
+    async setup(projectRoot, _config) {
+        const agentsDir = path.join(projectRoot, '.agents');
+        await fs.mkdir(agentsDir, { recursive: true });
+    }
+    async spawn(options) {
+        const { projectRoot, specFolderPath, taskNumber, timeoutSeconds = 1800 } = options;
+        const agyBin = await resolveAgyBinary();
+        const args = buildAgyArgs(options);
+        const streamParser = new EventStreamParser((line) => processAgyStdoutLine(line, specFolderPath, taskNumber, options.logger));
+        const result = await spawnWithTimeout({
+            command: agyBin,
+            args,
+            cwd: projectRoot,
+            env: {
+                ...process.env,
+                OSQ_TASK_NUMBER: taskNumber,
+                OSQ_SPEC_FOLDER: specFolderPath,
+            },
+            timeoutSeconds,
+            onStdout: (chunk) => {
+                streamParser.feed(chunk);
+            },
+            onSpawn: options.onSpawn,
+        });
+        await streamParser.flush();
+        return {
+            exitCode: result.exitCode,
+            timedOut: result.timedOut,
+            signal: result.signal,
+            error: result.error,
+            pid: result.pid,
+            elapsedMs: result.elapsedMs,
+        };
+    }
+}
+//# sourceMappingURL=agy.js.map

package/dist/harness/agy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agy.js","sourceRoot":"","sources":["../../src/harness/agy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAML,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;IAE1F,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,GACvF,OAAO,CAAC;IAEV,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAC/B,WAAW,EACX,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,GAAG,UAAU,KAAK,CAAC,CACvD,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;IACrF,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CACjC,WAAW,EACX,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,KAAK,CAAC,CACjE,CAAC;IAEF,OAAO;QACL,wFAAwF;QACxF,cAAc,WAAW,EAAE;QAC3B,gBAAgB,WAAW,EAAE;QAC7B,eAAe,SAAS,EAAE;QAC1B,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC5B,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC5B,mBAAmB,aAAa,EAAE;QAClC,EAAE;QACF,QAAQ;QACR,WAAW,WAAW,KAAK,WAAW,qCAAqC,WAAW,GAAG;QACzF,8DAA8D;QAC9D,0CAA0C;QAC1C,mCAAmC,aAAa,EAAE;QAClD,+CAA+C,aAAa,4FAA4F;QACxJ,0EAA0E,aAAa,GAAG;QAC1F,uBAAuB,aAAa,oBAAoB;KACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAyB;IACpD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3B,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,EAAE,GAAG,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,uBAAuB,CAAC;IACrF,MAAM,0BAA0B,GAAG,MAAM,EAAE,GAAG,EAAE,0BAA0B,IAAI,IAAI,CAAC;IAEnF,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,UAAU;QACV,SAAS;QACT,KAAK;QACL,QAAQ;QACR,cAAc;QACd,iBAAiB;QACjB,aAAa;KACd,CAAC;IAEF,IAAI,0BAA0B,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,EAAE,QAAQ,EAAE,kBAAkB,IAAI,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IAC1F,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,YAAY,GAAG,CAAC,CAAC;IAEjD,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAE3F,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,KAAK,GACT,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;QAC1C,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1F,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,WAAW,GACf,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC;QACjD,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,YAAY,GAAG,eAAe,CAAC;IAErC,OAAO;QACL,YAAY;QACZ,eAAe;QACf,WAAW;QACX,YAAY;QACZ,eAAe;QACf,IAAI,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACxF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GACd,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC9B,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;QAC/B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;QACzB,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAC1B,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC7B,EAAE,CAAC;IAEL,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,mBAAmB,CACjC,UAAU,CAAC,WAAW,EACtB,UAAU,CAAC,OAAO,EAClB,UAAU,CAAC,GAAG,EACd,UAAU,CAAC,WAAW,CACvB,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,EAAE,CAAC;IAClF,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAChC,UAAU,CAAC,YAAY,EACvB,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,aAAa,EACxB,UAAU,CAAC,WAAW,EACtB,UAAU,CAAC,aAAa,EACxB,UAAU,CAAC,aAAa,EACxB,UAAU,CAAC,OAAO,CACnB,CAAC;IACF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,EAAE,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAC/B,cAAsB,EACtB,UAAkB,EAClB,SAAwB,EACxB,SAAiB,EACjB,MAAe;IAEf,MAAM,kBAAkB,CAAC,cAAc,EAAE,UAAU,EAAE;QACnD,IAAI,EAAE,MAAM;QACZ,SAAS;QACT,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE;KAC3D,CAAC,CAAC;IACH,MAAM,EAAE,OAAO,CAAC,UAAU,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,cAAsB,EACtB,UAAkB,EAClB,MAAe;IAEf,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,wDAAwD;QACxD,MAAM,EAAE,OAAO,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,EAAE,OAAO,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,kBAAkB,CACtB,cAAc,EACd,UAAU,EACV,SAAS,EACT,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,MAAM,CACP,CAAC;QACF,OAAO;IACT,CAAC;IAED,uEAAuE;IACvE,+EAA+E;IAC/E,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC1D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,kBAAkB,CAAC,cAAc,EAAE,UAAU,EAAE;gBACnD,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,qBAAqB,CAAC,QAAQ,CAAC;gBAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAA0B;aACjD,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IAED,8EAA8E;IAC9E,sEAAsE;IACtE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,MAAM,EAAE,OAAO,CAAC,6BAA6B,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;QAC7F,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IAED,MAAM,kBAAkB,CAAC,cAAc,EAAE,UAAU,EAAE;QACnD,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,qBAAqB,CAAC,QAAQ,CAAC;QAC1C,IAAI,EAAE;YACJ,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,IAAI,EAAE,UAAU,CAAC,IAAI;SACtB;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IACzD,YAAY,cAAsB,EAAE,UAAkB,EAAE,MAAe;QACrE,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAClF,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,KAAK,CAAC;IAEtB,KAAK,CAAC,KAAK,CAAC,WAAmB,EAAE,OAAkB;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAyB;QACnC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAEnF,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE,CAClD,oBAAoB,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CACvE,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,GAAG,EAAE,WAAW;YAChB,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,eAAe,EAAE,UAAU;gBAC3B,eAAe,EAAE,cAAc;aAChC;YACD,cAAc;YACd,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YACD,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;QAE3B,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/harness/index.d.ts

@@ -0,0 +1,7 @@
+import type { HarnessAdapter } from './types.js';
+export declare function getHarnessAdapter(name: string): HarnessAdapter;
+export * from './types.js';
+export * from './mock.js';
+export * from './agy.js';
+export * from './opencode.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAQ9D;AAED,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/harness/index.js

@@ -0,0 +1,20 @@
+import { AgyAdapter } from './agy.js';
+import { MockAdapter } from './mock.js';
+import { OpencodeAdapter } from './opencode.js';
+const adapters = {
+    agy: () => new AgyAdapter(),
+    mock: () => new MockAdapter(),
+    opencode: () => new OpencodeAdapter(),
+};
+export function getHarnessAdapter(name) {
+    const factory = adapters[name.toLowerCase()];
+    if (!factory) {
+        throw new Error(`Unknown harness adapter: "${name}". Available adapters: ${Object.keys(adapters).join(', ')}`);
+    }
+    return factory();
+}
+export * from './types.js';
+export * from './mock.js';
+export * from './agy.js';
+export * from './opencode.js';
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,QAAQ,GAAyC;IACrD,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,UAAU,EAAE;IAC3B,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE;IAC7B,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;CACtC,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,0BAA0B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/harness/mock.d.ts

@@ -0,0 +1,19 @@
+import type { OsqConfig } from '../core/config.js';
+import { type HarnessAdapter, type SpawnResult, type SpawnTaskOptions } from './types.js';
+export interface MockBehavior {
+    exitCode?: number;
+    writeResult?: boolean;
+    resultContent?: string;
+    delayMs?: number;
+    error?: string;
+    timedOut?: boolean;
+}
+export declare class MockAdapter implements HarnessAdapter {
+    readonly name = "mock";
+    private behavior;
+    setBehavior(behavior: MockBehavior): void;
+    resetBehavior(): void;
+    setup(_projectRoot: string, _config: OsqConfig): Promise<void>;
+    spawn(options: SpawnTaskOptions): Promise<SpawnResult>;
+}
+//# sourceMappingURL=mock.d.ts.map

package/dist/harness/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/harness/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,QAAQ,CAAoB;IAEpC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIzC,aAAa,IAAI,IAAI;IAIf,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAsD7D"}

package/dist/harness/mock.js

@@ -0,0 +1,62 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { appendHarnessEvent, } from './types.js';
+export class MockAdapter {
+    name = 'mock';
+    behavior = {};
+    setBehavior(behavior) {
+        this.behavior = behavior;
+    }
+    resetBehavior() {
+        this.behavior = {};
+    }
+    async setup(_projectRoot, _config) {
+        // No-op for mock harness
+    }
+    async spawn(options) {
+        const { specFolderPath, taskNumber, tier } = options;
+        await appendHarnessEvent(specFolderPath, taskNumber, {
+            type: 'started',
+            timestamp: new Date().toISOString(),
+            data: { tier, mock: true },
+        });
+        if (this.behavior.delayMs) {
+            await new Promise((resolve) => setTimeout(resolve, this.behavior.delayMs));
+        }
+        await appendHarnessEvent(specFolderPath, taskNumber, {
+            type: 'tokens',
+            timestamp: new Date().toISOString(),
+            data: { promptTokens: 500, candidateTokens: 200 },
+        });
+        const shouldWriteResult = this.behavior.writeResult ?? true;
+        if (shouldWriteResult) {
+            const resultsDir = path.join(specFolderPath, '.run', 'results');
+            await fs.mkdir(resultsDir, { recursive: true });
+            const resultPath = path.join(resultsDir, `${taskNumber}.md`);
+            const defaultContent = [
+                `# Result for Task ${taskNumber}`,
+                '',
+                '## Changed',
+                '- Simulated work completed by MockAdapter.',
+            ].join('\n');
+            await fs.writeFile(resultPath, this.behavior.resultContent || `${defaultContent}\n`, 'utf8');
+            await appendHarnessEvent(specFolderPath, taskNumber, {
+                type: 'result_written',
+                timestamp: new Date().toISOString(),
+                data: { path: resultPath },
+            });
+        }
+        const exitCode = this.behavior.exitCode ?? (this.behavior.timedOut ? 124 : 0);
+        await appendHarnessEvent(specFolderPath, taskNumber, {
+            type: 'exited',
+            timestamp: new Date().toISOString(),
+            data: { exitCode, timedOut: this.behavior.timedOut },
+        });
+        return {
+            exitCode,
+            error: this.behavior.error,
+            timedOut: this.behavior.timedOut,
+        };
+    }
+}
+//# sourceMappingURL=mock.js.map

package/dist/harness/mock.js.map

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

package/dist/harness/opencode.d.ts

@@ -0,0 +1,39 @@
+import type { OsqConfig } from '../core/config.js';
+import type { Logger } from '../core/logger.js';
+import { EventStreamParser } from './stream.js';
+import { type HarnessAdapter, type SpawnResult, type SpawnTaskOptions, type ToolEventData } from './types.js';
+export declare const OPENCODE_AGENT_TEMPLATE = "---\ndescription: Autonomous task execution agent for osq\nmode: all\npermission:\n  read: allow\n  edit: allow\n  bash: allow\n  glob: allow\n  grep: allow\n  webfetch: deny\n  websearch: deny\n---\n\n<!-- OSQ:START -->\n## Executing a spec\n\n1. Read your task file, its parent `spec.md`, then only the docs listed under `features`. Nothing else.\n2. Too big for one pass? Write why in `.run/results/<n>.md`, exit without code.\n3. Read a previous result file for this task if present. Run the task's `verify`. Start from what fails.\n4. Tests for each acceptance line before implementing.\n5. Minimal code to pass. Stay inside `scope`.\n6. Run the task's `verify` command before exiting.\n\n## Exiting\n\nWrite `.run/results/<n>.md` first: changed, deviated, drift against `features/`, missing context, and for unfinished work which acceptance line is next. Omit empty sections. Then exit. One attempt. Never write to `features/`, `tasks.md`, or anything in `specs/` outside `.run/results/`. Do not ask questions.\n<!-- OSQ:END -->\n";
+export declare function resolveOpencodeBinary(config?: OsqConfig): Promise<string>;
+export declare function buildOpencodePrompt(options: SpawnTaskOptions): string;
+export declare function buildOpencodeArgs(options: SpawnTaskOptions): Promise<string[]>;
+export declare const spawnTask: typeof buildOpencodeArgs;
+export interface OpencodeTokensData {
+    promptTokens: number;
+    candidateTokens: number;
+    totalTokens: number;
+    cachedTokens: number;
+    reasoningTokens: number;
+    cost: number;
+}
+export declare function extractOpencodeTokens(event: unknown): OpencodeTokensData | null;
+export declare function extractToolEventSummary(toolName: string, input: unknown): string;
+export declare function extractOpencodeToolEvent(event: unknown): ToolEventData | null;
+export declare function processOpencodeStdoutLine(line: string, specFolderPath: string, taskNumber: string, logger?: Logger): Promise<void>;
+/**
+ * Compatibility subclass retained for existing callers and tests; the buffering
+ * and serialization logic lives entirely in the shared {@link EventStreamParser}.
+ */
+export declare class OpencodeEventStreamParser extends EventStreamParser {
+    constructor(specFolderPath: string, taskNumber: string, logger?: Logger);
+}
+export declare function preflightOpencode(projectRoot: string, config?: OsqConfig): Promise<{
+    version: string;
+    bin: string;
+}>;
+export declare class OpencodeAdapter implements HarnessAdapter {
+    readonly name = "opencode";
+    preflight(projectRoot: string, config: OsqConfig): Promise<void>;
+    setup(projectRoot: string, config: OsqConfig): Promise<void>;
+    spawn(options: SpawnTaskOptions): Promise<SpawnResult>;
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/harness/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/harness/opencode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EACL,iBAAiB,EAIlB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAErB,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,uBAAuB,ihCAcnC,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ/E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAgCrE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsFpF;AAED,eAAO,MAAM,SAAS,0BAAoB,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAwD/E;AAKD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAuBhF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CA4B7E;AAqBD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAqEf;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB;gBAClD,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAGxE;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA2B3C;AAED,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,IAAI,cAAc;IAErB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC5D,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAoC7D"}