@matteeh/osq 0.1.0 → 0.2.0

package/dist/harness/opencode/opencode-observe-usage.d.ts

@@ -0,0 +1,4 @@
+import type { ObservedPlanningSession } from '../../core/report/planning-observed.js';
+/** Read local OpenCode sessions with completed write/edit parts. */
+export declare function readOpencodePlanningSessions(bin: string): Promise<readonly ObservedPlanningSession[]>;
+//# sourceMappingURL=opencode-observe-usage.d.ts.map

package/dist/harness/opencode/opencode-observe-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-observe-usage.d.ts","sourceRoot":"","sources":["../../../src/harness/opencode/opencode-observe-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AA+FtF,oEAAoE;AACpE,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAmC7C"}

package/dist/harness/opencode/opencode-observe-usage.js

@@ -0,0 +1,100 @@
+import { spawnWithTimeout } from '../process.js';
+import { buildOpencodeObservationQuery, finiteNonNegative, parseRows, parseTimeMs, } from './opencode-usage.js';
+function text(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+/** Accumulate one session's rows, one turn per distinct assistant message. */
+function absorbRow(drafts, row) {
+    const sessionId = text(row.session_id);
+    const messageId = text(row.message_id);
+    if (!sessionId || !messageId)
+        return;
+    let draft = drafts.get(sessionId);
+    if (!draft) {
+        draft = {
+            directory: text(row.directory),
+            version: text(row.version),
+            model: null,
+            turns: [],
+            byMessage: new Map(),
+        };
+        drafts.set(sessionId, draft);
+    }
+    let turn = draft.byMessage.get(messageId);
+    if (!turn) {
+        const messageMs = parseTimeMs(row.message_time);
+        if (messageMs === null)
+            return;
+        const model = text(row.model);
+        turn = {
+            timestamp: new Date(messageMs).toISOString(),
+            model,
+            inputTokens: finiteNonNegative(row.tokens_input),
+            outputTokens: finiteNonNegative(row.tokens_output),
+            cacheReadTokens: finiteNonNegative(row.tokens_cache_read),
+            cacheWriteTokens: finiteNonNegative(row.tokens_cache_write),
+            reasoningTokens: finiteNonNegative(row.tokens_reasoning),
+            cost: finiteNonNegative(row.cost),
+            edits: [],
+        };
+        draft.byMessage.set(messageId, turn);
+        draft.turns.push(turn);
+        if (model)
+            draft.model = model;
+    }
+    const editPath = text(row.edit_path);
+    if (editPath && !turn.edits.includes(editPath))
+        turn.edits.push(editPath);
+}
+function toTurn(turn) {
+    return {
+        timestamp: turn.timestamp,
+        model: turn.model,
+        inputTokens: turn.inputTokens,
+        outputTokens: turn.outputTokens,
+        cacheReadTokens: turn.cacheReadTokens,
+        cacheWriteTokens: turn.cacheWriteTokens,
+        reasoningTokens: turn.reasoningTokens,
+        cost: turn.cost,
+        edits: turn.edits,
+    };
+}
+/** Read local OpenCode sessions with completed write/edit parts. */
+export async function readOpencodePlanningSessions(bin) {
+    let stdout;
+    try {
+        const result = await spawnWithTimeout({
+            command: bin,
+            args: ['db', '--format', 'json', buildOpencodeObservationQuery()],
+            cwd: process.cwd(),
+            timeoutSeconds: 10,
+        });
+        if (result.exitCode !== 0)
+            return [];
+        stdout = result.stdout;
+    }
+    catch {
+        return [];
+    }
+    const drafts = new Map();
+    for (const row of parseRows(stdout)) {
+        absorbRow(drafts, row);
+    }
+    const results = [];
+    for (const [nativeSessionId, draft] of drafts) {
+        const turns = draft.turns.map(toTurn);
+        if (turns.length === 0)
+            continue;
+        results.push({
+            harness: 'opencode',
+            nativeSessionId,
+            sessionDir: draft.directory,
+            model: draft.model,
+            harnessVersion: draft.version,
+            sessionCost: null,
+            turns,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=opencode-observe-usage.js.map

package/dist/harness/opencode/opencode-observe-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-observe-usage.js","sourceRoot":"","sources":["../../../src/harness/opencode/opencode-observe-usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,SAAS,EACT,WAAW,GACZ,MAAM,qBAAqB,CAAC;AA6B7B,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC;AAED,8EAA8E;AAC9E,SAAS,SAAS,CAAC,MAA0B,EAAE,GAA4B;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS;QAAE,OAAO;IACrC,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAC9B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAC1B,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI,GAAG,EAAE;SACrB,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,GAAG;YACL,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;YAC5C,KAAK;YACL,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC;YAChD,YAAY,EAAE,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC;YAClD,eAAe,EAAE,iBAAiB,CAAC,GAAG,CAAC,iBAAiB,CAAC;YACzD,gBAAgB,EAAE,iBAAiB,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC3D,eAAe,EAAE,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACxD,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;YACjC,KAAK,EAAE,EAAE;SACV,CAAC;QACF,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACrC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACjC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,MAAM,CAAC,IAAe;IAC7B,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,GAAW;IAEX,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,OAAO,EAAE,GAAG;YACZ,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;YACjE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,cAAc,EAAE,EAAE;SACnB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,OAAO,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,UAAU;YACnB,eAAe;YACf,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,cAAc,EAAE,KAAK,CAAC,OAAO;YAC7B,WAAW,EAAE,IAAI;YACjB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/harness/opencode/opencode-usage.d.ts

@@ -0,0 +1,24 @@
+import { type InteractiveUsage, type ReadInteractiveUsageOptions } from '../types.js';
+/** Build a read-only session query with safely quoted values. */
+export declare function buildOpencodeSessionQuery(cwd: string): string;
+/**
+ * Build a read-only message+part query for approval-time observation. It joins
+ * `message` to `session` on `message.session_id` and left-joins `part` on
+ * `part.message_id` with the completed write/edit filters, keeping only rows
+ * that carry such a part. Every usage, model, and edit field is projected
+ * through SQLite `json_extract`, so raw `message.data`, `part.data`, prompts,
+ * output, old/new strings, and write content never enter osq. It never names
+ * the old `part.sessionID` column.
+ */
+export declare function buildOpencodeObservationQuery(): string;
+export declare function finiteNonNegative(value: unknown): number | null;
+export declare function parseTimeMs(value: unknown): number | null;
+/** Coerce `db --format json` output into object rows, tolerating both shapes. */
+export declare function parseRows(stdout: string): Record<string, unknown>[];
+export declare function mapUsage(row: Record<string, unknown>): InteractiveUsage;
+/**
+ * Reads observed usage through `bin`. Any spawn failure, non-zero exit,
+ * unparseable output, or non-unique match degrades to the all-null value.
+ */
+export declare function readOpencodeInteractiveUsage(options: ReadInteractiveUsageOptions, bin: string): Promise<InteractiveUsage>;
+//# sourceMappingURL=opencode-usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-usage.d.ts","sourceRoot":"","sources":["../../../src/harness/opencode/opencode-usage.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAqBrB,iEAAiE;AACjE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAuBtD;AAQD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAazD;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmCnE;AAWD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAcvE;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}

package/dist/harness/opencode/opencode-usage.js

@@ -0,0 +1,181 @@
+import path from 'node:path';
+import { spawnWithTimeout } from '../process.js';
+import { NULL_INTERACTIVE_USAGE, } from '../types.js';
+/**
+ * Read-only OpenCode session usage. Uses the resolved harness CLI's
+ * `db --format json` interface to select only the session metadata and usage
+ * columns, then requires exactly one row for the planning working directory
+ * whose creation time falls inside the observed interval. Transcripts and
+ * message content are never read.
+ */
+const SESSION_COLUMNS = [
+    'directory',
+    'time_created',
+    'tokens_input',
+    'tokens_output',
+    'tokens_reasoning',
+    'tokens_cache_read',
+    'tokens_cache_write',
+    'cost',
+];
+/** Build a read-only session query with safely quoted values. */
+export function buildOpencodeSessionQuery(cwd) {
+    const escaped = cwd.replace(/'/g, "''");
+    return `SELECT ${SESSION_COLUMNS.join(', ')} FROM session WHERE directory = '${escaped}'`;
+}
+/**
+ * Build a read-only message+part query for approval-time observation. It joins
+ * `message` to `session` on `message.session_id` and left-joins `part` on
+ * `part.message_id` with the completed write/edit filters, keeping only rows
+ * that carry such a part. Every usage, model, and edit field is projected
+ * through SQLite `json_extract`, so raw `message.data`, `part.data`, prompts,
+ * output, old/new strings, and write content never enter osq. It never names
+ * the old `part.sessionID` column.
+ */
+export function buildOpencodeObservationQuery() {
+    const columns = [
+        'message.session_id AS session_id',
+        'session.directory AS directory',
+        'session.version AS version',
+        'message.id AS message_id',
+        'message.time_created AS message_time',
+        "json_extract(message.data, '$.modelID') AS model",
+        "json_extract(message.data, '$.tokens.input') AS tokens_input",
+        "json_extract(message.data, '$.tokens.output') AS tokens_output",
+        "json_extract(message.data, '$.tokens.reasoning') AS tokens_reasoning",
+        "json_extract(message.data, '$.tokens.cache.read') AS tokens_cache_read",
+        "json_extract(message.data, '$.tokens.cache.write') AS tokens_cache_write",
+        "json_extract(message.data, '$.cost') AS cost",
+        "json_extract(part.data, '$.state.input.filePath') AS edit_path",
+        'part.time_created AS edit_time',
+    ];
+    const partFilters = [
+        "json_extract(part.data, '$.type') = 'tool'",
+        "json_extract(part.data, '$.tool') IN ('write', 'edit')",
+        "json_extract(part.data, '$.state.status') = 'completed'",
+    ];
+    return `SELECT ${columns.join(', ')} FROM message JOIN session ON session.id = message.session_id LEFT JOIN part ON part.message_id = message.id AND ${partFilters.join(' AND ')} WHERE json_extract(message.data, '$.role') = 'assistant' AND part.message_id IS NOT NULL`;
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+export function finiteNonNegative(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+        return null;
+    }
+    return value;
+}
+export function parseTimeMs(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value > 1e11 ? value : value * 1000;
+    }
+    if (typeof value === 'string' && value.trim().length > 0) {
+        const numeric = Number(value);
+        if (Number.isFinite(numeric)) {
+            return numeric > 1e11 ? numeric : numeric * 1000;
+        }
+        const parsed = Date.parse(value);
+        return Number.isNaN(parsed) ? null : parsed;
+    }
+    return null;
+}
+/** Coerce `db --format json` output into object rows, tolerating both shapes. */
+export function parseRows(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        return [];
+    }
+    if (Array.isArray(parsed)) {
+        return parsed
+            .map((row) => asRecord(row))
+            .filter((row) => row !== undefined);
+    }
+    const container = asRecord(parsed);
+    if (!container)
+        return [];
+    const rows = Array.isArray(container.rows) ? container.rows : [];
+    const columns = Array.isArray(container.columns) ? container.columns.map(String) : [];
+    const result = [];
+    for (const row of rows) {
+        const record = asRecord(row);
+        if (record) {
+            result.push(record);
+            continue;
+        }
+        if (Array.isArray(row) && columns.length === row.length) {
+            const mapped = {};
+            columns.forEach((column, index) => {
+                mapped[column] = row[index];
+            });
+            result.push(mapped);
+        }
+    }
+    return result;
+}
+function sameDirectory(value, cwd) {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        return path.resolve(value) === path.resolve(cwd);
+    }
+    catch {
+        return false;
+    }
+}
+export function mapUsage(row) {
+    const cacheRead = finiteNonNegative(row.tokens_cache_read);
+    const cacheWrite = finiteNonNegative(row.tokens_cache_write);
+    // Cache is the sum of the harness's stored read and write counters; it is
+    // never derived from totals.
+    const cachedTokens = cacheRead === null && cacheWrite === null ? null : (cacheRead ?? 0) + (cacheWrite ?? 0);
+    return {
+        inputTokens: finiteNonNegative(row.tokens_input),
+        outputTokens: finiteNonNegative(row.tokens_output),
+        cachedTokens,
+        reasoningTokens: finiteNonNegative(row.tokens_reasoning),
+        cost: finiteNonNegative(row.cost),
+    };
+}
+/**
+ * Reads observed usage through `bin`. Any spawn failure, non-zero exit,
+ * unparseable output, or non-unique match degrades to the all-null value.
+ */
+export async function readOpencodeInteractiveUsage(options, bin) {
+    const startedMs = Date.parse(options.startedAt);
+    const endedMs = Date.parse(options.endedAt);
+    if (!Number.isFinite(startedMs) || !Number.isFinite(endedMs)) {
+        return NULL_INTERACTIVE_USAGE;
+    }
+    let stdout;
+    try {
+        const result = await spawnWithTimeout({
+            command: bin,
+            args: ['db', '--format', 'json', buildOpencodeSessionQuery(options.cwd)],
+            cwd: options.cwd,
+            timeoutSeconds: 10,
+        });
+        if (result.exitCode !== 0) {
+            return NULL_INTERACTIVE_USAGE;
+        }
+        stdout = result.stdout;
+    }
+    catch {
+        return NULL_INTERACTIVE_USAGE;
+    }
+    const matches = parseRows(stdout).filter((row) => {
+        if (!sameDirectory(row.directory, options.cwd))
+            return false;
+        const created = parseTimeMs(row.time_created);
+        return created !== null && created >= startedMs && created <= endedMs;
+    });
+    if (matches.length !== 1) {
+        return NULL_INTERACTIVE_USAGE;
+    }
+    return mapUsage(matches[0]);
+}
+//# sourceMappingURL=opencode-usage.js.map

package/dist/harness/opencode/opencode-usage.js.map

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

package/dist/harness/{opencode.d.ts → opencode/opencode.d.ts}

@@ -1,8 +1,9 @@
-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";
+import { type OsqConfig } from '../../core/foundation/config.js';
+import type { Logger } from '../../core/foundation/logger.js';
+import { EventStreamParser } from '../stream.js';
+import { type HarnessAdapter, type InteractiveSessionOptions, type InteractiveUsage, type ReadInteractiveUsageOptions, type SpawnResult, type SpawnTaskOptions, type ToolEventData } from '../types.js';
+export declare const OPENCODE_PLANNER_AGENT_TEMPLATE = "---\ndescription: Interactive planning agent for osq\nmode: all\npermission:\n  read: allow\n  edit: allow\n  glob: allow\n  grep: allow\n  bash:\n    \"*\": deny\n    \"osq lint*\": allow\n    \"pnpm osq lint*\": allow\n    \"npx osq lint*\": allow\n    \"*;*\": deny\n    \"*&*\": deny\n    \"*|*\": deny\n    \"*>*\": deny\n    \"*<*\": deny\n    \"*`*\": deny\n    \"*$(*\": deny\n    \"*\\n*\": deny\n  webfetch: deny\n  websearch: deny\n---\n\nFollow PLANNER.md strictly for change planning rules and procedure.\nWrites are expected only under openspec/changes/<id>/.\nThe only shell command you may run is `osq lint <slug>`.\n";
+export declare const OPENCODE_AGENT_TEMPLATE: string;
 export declare function resolveOpencodeBinary(config?: OsqConfig): Promise<string>;
 export declare function buildOpencodePrompt(options: SpawnTaskOptions): string;
 export declare function buildOpencodeArgs(options: SpawnTaskOptions): Promise<string[]>;
@@ -18,13 +19,13 @@ export interface OpencodeTokensData {
 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>;
+export declare function processOpencodeStdoutLine(line: string, specFolderPath: string, taskNumber: string, logger?: Logger, projectRoot?: string): 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);
+    constructor(specFolderPath: string, taskNumber: string, logger?: Logger, projectRoot?: string);
 }
 export declare function preflightOpencode(projectRoot: string, config?: OsqConfig): Promise<{
     version: string;
@@ -35,5 +36,7 @@ export declare class OpencodeAdapter implements HarnessAdapter {
     preflight(projectRoot: string, config: OsqConfig): Promise<void>;
     setup(projectRoot: string, config: OsqConfig): Promise<void>;
     spawn(options: SpawnTaskOptions): Promise<SpawnResult>;
+    spawnInteractive(options: InteractiveSessionOptions): Promise<number>;
+    readInteractiveUsage(options: ReadInteractiveUsageOptions): Promise<InteractiveUsage>;
 }
 //# sourceMappingURL=opencode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/harness/opencode/opencode.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,iCAAiC,CAAC;AAM7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAK9D,OAAO,EACL,iBAAiB,EAIlB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAErB,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,+BAA+B,8nBA4B3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAcnC,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,CAErE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuHpF;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;AAyBD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAsEf;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB;gBAClD,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAK9F;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;IA+C5D,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqCtD,gBAAgB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BrE,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAK5F"}