teamshare-bridge 0.26.6 → 0.26.7

package/dist/lib/browser/xlsx-template.js

@@ -0,0 +1,380 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QA_TEXT_MAX_BYTES = exports.QA_XLSX_MAX_COLS = exports.QA_XLSX_MAX_ROWS = void 0;
+exports.parseCellAddress = parseCellAddress;
+exports.colToLetters = colToLetters;
+exports.readStagedFile = readStagedFile;
+exports.fillStagedSpreadsheet = fillStagedSpreadsheet;
+/**
+ * Read and fill spreadsheet templates inside the run's staging directory
+ * (2026-10, QA files).
+ *
+ * WHY THIS EXISTS: a QA flow that must "download the template, fill it with
+ * test data and upload it" needs the template's STRUCTURE, not a guess at
+ * it. The agent reads headers first (`readStagedFile`), writes values into a
+ * COPY (`fillExcel` — the original download stays intact for a retry), and
+ * `attachFile` picks up the copy. All paths stay inside the run's staging
+ * directory, so the `safeStagedPath` guard keeps holding.
+ *
+ * Implementation notes:
+ * - `xlsx-populate` is already a bridge dependency (the workbook builder
+ *   uses it), so no new package is needed.
+ * - `fillExcel` preserves everything it does not touch (styles, formulas,
+ *   validation) because it edits the template in place rather than
+ *   rebuilding it.
+ * - Text formats (.csv/.tsv/.txt/.json) read as text — the agent composes
+ *   new content itself and stages it with `stageFile({ text })`.
+ */
+const node_fs_1 = require("node:fs");
+const xlsx_populate_1 = __importDefault(require("xlsx-populate"));
+const stage_file_1 = require("./stage-file");
+exports.QA_XLSX_MAX_ROWS = 2000;
+exports.QA_XLSX_MAX_COLS = 200;
+exports.QA_TEXT_MAX_BYTES = 200 * 1024;
+const SPREADSHEET_EXTS = ['.xlsx', '.xlsm'];
+function extOf(path) {
+    const i = path.lastIndexOf('.');
+    return i >= 0 ? path.slice(i).toLowerCase() : '';
+}
+function cellToJson(v) {
+    if (v instanceof Date)
+        return v.toISOString();
+    return v ?? null;
+}
+/** Split "Sheet1!B3" / "'My Sheet'!C2" / "B3" into sheet + column + row. */
+function parseCellAddress(addr) {
+    const m = /^(?:'((?:[^']|'')+)'!|([^!]+)!)?([A-Za-z]+)(\d+)$/.exec(addr.trim());
+    if (!m)
+        return null;
+    const raw = m[1] ?? m[2] ?? null;
+    const sheet = raw === null ? null : raw.replace(/''/g, "'");
+    const letters = m[3].toUpperCase();
+    let col = 0;
+    for (const ch of letters) {
+        col = col * 26 + (ch.charCodeAt(0) - 64);
+        if (col > exports.QA_XLSX_MAX_COLS + 26)
+            return null;
+    }
+    const row = Number(m[4]);
+    if (!Number.isInteger(row) || row < 1 || row > exports.QA_XLSX_MAX_ROWS + 100) {
+        return null;
+    }
+    return { sheet, col, row };
+}
+function colToLetters(col) {
+    let n = col;
+    let s = '';
+    while (n > 0) {
+        const r = (n - 1) % 26;
+        s = String.fromCharCode(65 + r) + s;
+        n = Math.floor((n - 1) / 26);
+    }
+    return s || 'A';
+}
+/**
+ * Read a staged file: spreadsheets come back as sheets + header-keyed rows,
+ * text formats come back as text. Caps keep the MCP response small.
+ */
+async function readStagedFile(opts) {
+    const safe = (0, stage_file_1.safeStagedPath)(opts.runId, opts.filePath);
+    if (!safe) {
+        return {
+            ok: false,
+            error: "the file is not in this run's staging directory",
+        };
+    }
+    const ext = extOf(safe);
+    if (SPREADSHEET_EXTS.includes(ext)) {
+        return readWorkbook(safe, opts.sheet, opts.maxRows);
+    }
+    let stat;
+    try {
+        stat = (0, node_fs_1.readFileSync)(safe).length;
+    }
+    catch {
+        return { ok: false, error: 'the file could not be read' };
+    }
+    if (stat > exports.QA_TEXT_MAX_BYTES) {
+        return {
+            ok: false,
+            error: `text file is too large (${Math.round(stat / 1024)} KB, max ${exports.QA_TEXT_MAX_BYTES / 1024} KB) — narrow the download first`,
+        };
+    }
+    try {
+        const text = (0, node_fs_1.readFileSync)(safe, 'utf8');
+        return { ok: true, kind: 'text', text, truncated: false };
+    }
+    catch {
+        return { ok: false, error: 'the file is not readable as text' };
+    }
+}
+async function readWorkbook(path, onlySheet, maxRows) {
+    const cap = Math.min(Math.max(typeof maxRows === 'number' ? maxRows : exports.QA_XLSX_MAX_ROWS, 1), exports.QA_XLSX_MAX_ROWS);
+    let buffer;
+    try {
+        buffer = (0, node_fs_1.readFileSync)(path);
+    }
+    catch {
+        return { ok: false, error: 'the file could not be read' };
+    }
+    let workbook;
+    try {
+        workbook = await xlsx_populate_1.default.fromDataAsync(buffer);
+    }
+    catch {
+        return { ok: false, error: 'the file is not a readable workbook' };
+    }
+    const sheets = [];
+    let names;
+    try {
+        names = workbook.sheets().map((s) => s.name());
+    }
+    catch {
+        return { ok: false, error: 'the workbook has no readable sheets' };
+    }
+    const wanted = onlySheet ? names.filter((n) => n === onlySheet) : names;
+    if (onlySheet && wanted.length === 0) {
+        return {
+            ok: false,
+            error: `sheet "${onlySheet}" not found (available: ${names.join(', ') || 'none'})`,
+        };
+    }
+    for (const name of wanted) {
+        const sheet = workbook.sheet(name);
+        let endCol = 0;
+        let endRow = 0;
+        try {
+            const used = sheet.usedRange();
+            if (used) {
+                endCol = used.endCell().columnNumber();
+                endRow = used.endCell().rowNumber();
+            }
+        }
+        catch {
+            /* empty sheet */
+        }
+        endCol = Math.min(endCol, exports.QA_XLSX_MAX_COLS);
+        endRow = Math.min(endRow, cap + 1);
+        const grid = [];
+        for (let r = 1; r <= endRow; r++) {
+            const row = [];
+            for (let c = 1; c <= endCol; c++) {
+                try {
+                    row.push(cellToJson(sheet.cell(r, c).value()));
+                }
+                catch {
+                    row.push(null);
+                }
+            }
+            grid.push(row);
+        }
+        // Trim trailing empty columns and rows: a template's used range often
+        // overshoots its real content, and the agent must see headers and rows,
+        // not phantom "Column C" entries and blank objects.
+        const cellEmpty = (v) => v === null ||
+            v === undefined ||
+            (typeof v === 'string' && v.trim() === '');
+        let lastCol = -1;
+        for (const row of grid) {
+            for (let c = row.length - 1; c > lastCol; c--) {
+                if (!cellEmpty(row[c])) {
+                    lastCol = c;
+                    break;
+                }
+            }
+        }
+        const trimmed = grid
+            .map((row) => row.slice(0, lastCol + 1))
+            .filter((row, i, all) => {
+            if (i === 0)
+                return true;
+            const rest = all.slice(i);
+            return rest.some((r) => r.some((v) => !cellEmpty(v)));
+        });
+        const headerRow = trimmed[0] ?? [];
+        const headers = headerRow.map((h, i) => String(h ?? '').trim() === ''
+            ? `Column ${colToLetters(i + 1)}`
+            : String(h).trim());
+        const rows = trimmed.slice(1).map((cells) => {
+            const obj = {};
+            headers.forEach((h, i) => {
+                obj[h] = cells[i] ?? null;
+            });
+            return obj;
+        });
+        sheets.push({
+            name,
+            headers,
+            rows,
+            rowCount: rows.length,
+            truncated: endRow >= cap + 1,
+        });
+    }
+    return { ok: true, kind: 'xlsx', sheets, truncated: false };
+}
+/**
+ * Edit a COPY of the staged template: `cells` writes exact addresses
+ * ("Sheet1!B3" or "B3" for the first sheet), `rows` appends header-keyed
+ * objects after the last used row (matched against the header row, so the
+ * agent must have read the template first). Styles, formulas and validation
+ * survive — only the addressed cells change.
+ */
+async function fillStagedSpreadsheet(opts) {
+    const safe = (0, stage_file_1.safeStagedPath)(opts.runId, opts.templatePath);
+    if (!safe) {
+        return {
+            ok: false,
+            error: "the template is not in this run's staging directory",
+        };
+    }
+    if (!SPREADSHEET_EXTS.includes(extOf(safe))) {
+        return { ok: false, error: 'only .xlsx templates can be filled' };
+    }
+    const cells = opts.cells ?? {};
+    const rows = Array.isArray(opts.rows) ? opts.rows : [];
+    if (Object.keys(cells).length === 0 && rows.length === 0) {
+        return { ok: false, error: 'nothing to write — pass cells and/or rows' };
+    }
+    if (rows.length > exports.QA_XLSX_MAX_ROWS) {
+        return {
+            ok: false,
+            error: `too many rows (${rows.length}, max ${exports.QA_XLSX_MAX_ROWS})`,
+        };
+    }
+    let workbook;
+    try {
+        workbook = await xlsx_populate_1.default.fromDataAsync((0, node_fs_1.readFileSync)(safe));
+    }
+    catch {
+        return { ok: false, error: 'the template is not a readable workbook' };
+    }
+    const firstName = (() => {
+        try {
+            return workbook.sheets()[0]?.name();
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    // Exact-address writes.
+    for (const [addr, value] of Object.entries(cells)) {
+        const parsed = parseCellAddress(addr);
+        if (!parsed) {
+            return {
+                ok: false,
+                error: `bad cell address "${addr}" — use "Sheet1!B3"`,
+            };
+        }
+        const sheetName = parsed.sheet ?? opts.sheet ?? firstName;
+        if (!sheetName) {
+            return { ok: false, error: 'the workbook has no sheets' };
+        }
+        let sheet;
+        try {
+            sheet = workbook.sheet(sheetName);
+        }
+        catch {
+            return { ok: false, error: `sheet "${sheetName}" not found` };
+        }
+        try {
+            sheet.cell(parsed.row, parsed.col).value(value ?? null);
+        }
+        catch {
+            return { ok: false, error: `could not write ${addr}` };
+        }
+    }
+    // Header-keyed row appends.
+    if (rows.length > 0) {
+        const sheetName = opts.sheet ?? firstName;
+        if (!sheetName) {
+            return { ok: false, error: 'the workbook has no sheets' };
+        }
+        let sheet;
+        try {
+            sheet = workbook.sheet(sheetName);
+        }
+        catch {
+            return { ok: false, error: `sheet "${sheetName}" not found` };
+        }
+        let lastRow = 0;
+        try {
+            const used = sheet.usedRange();
+            if (used)
+                lastRow = used.endCell().rowNumber();
+        }
+        catch {
+            lastRow = 0;
+        }
+        // Header map from the first row (same rule as the reader).
+        const headers = [];
+        const probeCols = Math.min(exports.QA_XLSX_MAX_COLS, 200);
+        for (let c = 1; c <= probeCols; c++) {
+            let v = null;
+            try {
+                v = sheet.cell(1, c).value();
+            }
+            catch {
+                break;
+            }
+            if (v === null || v === undefined || String(v).trim() === '')
+                break;
+            headers.push(String(v).trim());
+        }
+        if (headers.length === 0) {
+            return {
+                ok: false,
+                error: `sheet "${sheetName}" has no header row — write with cells instead`,
+            };
+        }
+        const unknownKeys = new Set();
+        rows.forEach((row, i) => {
+            const target = lastRow + 1 + i;
+            for (const [key, value] of Object.entries(row)) {
+                const idx = headers.indexOf(key);
+                if (idx === -1) {
+                    unknownKeys.add(key);
+                    continue;
+                }
+                try {
+                    sheet.cell(target, idx + 1).value(value ?? null);
+                }
+                catch {
+                    /* one bad cell must not lose the row */
+                }
+            }
+        });
+        if (unknownKeys.size > 0) {
+            return {
+                ok: false,
+                error: `unknown column(s): ${[...unknownKeys].join(', ')} (headers: ${headers.join(', ')})`,
+            };
+        }
+    }
+    let buffer;
+    try {
+        buffer = Buffer.from(await workbook.outputAsync());
+    }
+    catch {
+        return { ok: false, error: 'the filled workbook could not be rendered' };
+    }
+    const staged = await (0, stage_file_1.stageFile)({
+        runId: opts.runId,
+        fileName: opts.fileName && opts.fileName.trim()
+            ? opts.fileName.trim()
+            : 'filled-template.xlsx',
+        buffer,
+    });
+    if (!staged) {
+        return { ok: false, error: 'the filled file could not be staged' };
+    }
+    return {
+        ok: true,
+        path: staged.path,
+        fileName: staged.path.split(/[\\/]/).pop(),
+        bytes: staged.bytes,
+    };
+}
+//# sourceMappingURL=xlsx-template.js.map

package/dist/lib/browser/xlsx-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx-template.js","sourceRoot":"","sources":["../../../src/lib/browser/xlsx-template.ts"],"names":[],"mappings":";;;;;;AA2DA,4CAsBC;AAED,oCASC;AAMD,wCAmCC;AA+HD,sDA2JC;AA/ZD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qCAAuC;AACvC,kEAAyC;AACzC,6CAAyD;AAE5C,QAAA,gBAAgB,GAAG,IAAI,CAAC;AACxB,QAAA,gBAAgB,GAAG,GAAG,CAAC;AACvB,QAAA,iBAAiB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE5C,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAoB5C,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,CAAU;IAC5B,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,CAAC,IAAI,IAAI,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,SAAgB,gBAAgB,CAAC,IAAY;IAK3C,MAAM,CAAC,GAAG,mDAAmD,CAAC,IAAI,CAChE,IAAI,CAAC,IAAI,EAAE,CACZ,CAAC;IACF,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,GAAG,GAAG,wBAAgB,GAAG,EAAE;YAAE,OAAO,IAAI,CAAC;IAC/C,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,wBAAgB,GAAG,GAAG,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC7B,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC,GAAG,GAAG,CAAC;IACZ,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,IAAI,GAAG,CAAC;AAClB,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,IAKpC;IACC,MAAM,IAAI,GAAG,IAAA,2BAAc,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,iDAAiD;SACzD,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAA,sBAAY,EAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,IAAI,GAAG,yBAAiB,EAAE,CAAC;QAC7B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,2BAA2B,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,yBAAiB,GAAG,IAAI,kCAAkC;SAChI,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,IAAY,EACZ,SAAkB,EAClB,OAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAClB,IAAI,CAAC,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAgB,EAAE,CAAC,CAAC,EACrE,wBAAgB,CACjB,CAAC;IACF,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,sBAAY,EAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,QAAa,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,uBAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACxE,IAAI,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,UAAU,SAAS,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG;SACnF,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC;gBACvC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;YACtC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAgB,CAAC,CAAC;QAC5C,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACnC,MAAM,IAAI,GAAgB,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjC,MAAM,GAAG,GAAc,EAAE,CAAC;YAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACjD,CAAC;gBAAC,MAAM,CAAC;oBACP,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QACD,sEAAsE;QACtE,wEAAwE;QACxE,oDAAoD;QACpD,MAAM,SAAS,GAAG,CAAC,CAAU,EAAE,EAAE,CAC/B,CAAC,KAAK,IAAI;YACV,CAAC,KAAK,SAAS;YACf,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7C,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvB,OAAO,GAAG,CAAC,CAAC;oBACZ,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI;aACjB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;aACvC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;YACtB,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QACL,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAC3B,CAAC,CAAC,UAAU,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE;YACjC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CACrB,CAAC;QACF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1C,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACvB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YAC5B,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,IAAI,GAAG,GAAG,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC9D,CAAC;AAWD;;;;;;GAMG;AACI,KAAK,UAAU,qBAAqB,CAAC,IAO3C;IACC,MAAM,IAAI,GAAG,IAAA,2BAAc,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,qDAAqD;SAC7D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,wBAAgB,EAAE,CAAC;QACnC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,kBAAkB,IAAI,CAAC,MAAM,SAAS,wBAAgB,GAAG;SACjE,CAAC;IACJ,CAAC;IACD,IAAI,QAAa,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,uBAAY,CAAC,aAAa,CAAC,IAAA,sBAAY,EAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE;QACtB,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAY,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,wBAAwB;IACxB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,qBAAqB,IAAI,qBAAqB;aACtD,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;QAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,KAAU,CAAC;QACf,IAAI,CAAC;YACH,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,SAAS,aAAa,EAAE,CAAC;QAChE,CAAC;QACD,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,KAAU,CAAC;QACf,IAAI,CAAC;YACH,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,SAAS,aAAa,EAAE,CAAC;QAChE,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;QACD,2DAA2D;QAC3D,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,wBAAgB,EAAE,GAAG,CAAC,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,GAAY,IAAI,CAAC;YACtB,IAAI,CAAC;gBACH,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM;YACR,CAAC;YACD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,MAAM;YACpE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,UAAU,SAAS,gDAAgD;aAC3E,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACjC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBACf,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACP,wCAAwC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,sBAAsB,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aAC5F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAAC;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EACN,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YACnC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YACtB,CAAC,CAAC,sBAAsB;QAC5B,MAAM;KACP,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IACrE,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE;QAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/lib/harness/opencode-control.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build the CLI argv that interrupts `sessionId`, or null for an invalid id.
+ * Exported as a pure function so the contract can be pinned by a unit test.
+ */
+export declare function buildOpencodeInterruptArgs(sessionId: string): string[] | null;
+/**
+ * Interrupt an OpenCode V2 session on the shared service.
+ *
+ * Best-effort by contract: a missing CLI, a stopped service, a timeout or an
+ * idle session all answer `false` and must NEVER throw - a stop path must not
+ * fail because the harness could not be reached. The caller logs the result;
+ * the relay-token revocation is the independent backstop.
+ */
+export declare function interruptOpencodeSession(sessionId: string, timeoutMs?: number): Promise<boolean>;

package/dist/lib/harness/opencode-control.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOpencodeInterruptArgs = buildOpencodeInterruptArgs;
+exports.interruptOpencodeSession = interruptOpencodeSession;
+/**
+ * OpenCode V2 session control (2026-10).
+ *
+ * THE BUG THIS EXISTS FOR: V2 is a client/server product. `opencode run` is a
+ * CLIENT attached to a shared background service that owns the session, the
+ * model stream and all tool execution. `session.stop` used to kill the CLI's
+ * process tree only - the service kept executing the turn, kept calling MCP
+ * tools through the run's still-valid relay token, and kept driving the debug
+ * browser. The human saw "stopped" while the QA run went on.
+ *
+ * The service exposes `POST /api/session/{sessionID}/interrupt` (verified from
+ * its OpenAPI document). The CLI's `api` subcommand carries the service auth,
+ * so this is one short-lived process with a hard timeout - never a long-lived
+ * connection and never a direct HTTP call that would need the service token.
+ */
+const node_child_process_1 = require("node:child_process");
+const harness_1 = require("./harness");
+/** OpenCode session ids are `ses_` + base62-ish; reject anything else. */
+const OPENCODE_SESSION_ID = /^ses_[A-Za-z0-9]+$/;
+/**
+ * Build the CLI argv that interrupts `sessionId`, or null for an invalid id.
+ * Exported as a pure function so the contract can be pinned by a unit test.
+ */
+function buildOpencodeInterruptArgs(sessionId) {
+    if (!OPENCODE_SESSION_ID.test(sessionId))
+        return null;
+    return ['api', 'POST', `/api/session/${sessionId}/interrupt`];
+}
+/**
+ * Interrupt an OpenCode V2 session on the shared service.
+ *
+ * Best-effort by contract: a missing CLI, a stopped service, a timeout or an
+ * idle session all answer `false` and must NEVER throw - a stop path must not
+ * fail because the harness could not be reached. The caller logs the result;
+ * the relay-token revocation is the independent backstop.
+ */
+function interruptOpencodeSession(sessionId, timeoutMs = 15_000) {
+    const args = buildOpencodeInterruptArgs(sessionId);
+    if (!args)
+        return Promise.resolve(false);
+    const bin = (0, harness_1.resolveBin)('opencode');
+    if (!bin)
+        return Promise.resolve(false);
+    return new Promise((resolve) => {
+        try {
+            (0, node_child_process_1.execFile)(bin.file, [...(bin.args ?? []), ...args], { timeout: timeoutMs, windowsHide: true, maxBuffer: 1024 * 1024 }, (err, stdout) => {
+                if (err) {
+                    resolve(false);
+                    return;
+                }
+                resolve(/"interrupted"\s*:\s*true/.test(String(stdout ?? '')));
+            });
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+//# sourceMappingURL=opencode-control.js.map

package/dist/lib/harness/opencode-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-control.js","sourceRoot":"","sources":["../../../src/lib/harness/opencode-control.ts"],"names":[],"mappings":";;AAyBA,gEAGC;AAUD,4DA0BC;AAhED;;;;;;;;;;;;;;GAcG;AACH,2DAA8C;AAC9C,uCAAuC;AAEvC,0EAA0E;AAC1E,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,SAAgB,0BAA0B,CAAC,SAAiB;IAC1D,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,SAAS,YAAY,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,wBAAwB,CACtC,SAAiB,EACjB,SAAS,GAAG,MAAM;IAElB,MAAM,IAAI,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAA,oBAAU,EAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,IAAA,6BAAQ,EACN,GAAG,CAAC,IAAI,EACR,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,EAC9B,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,EACjE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACd,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,CAAC,KAAK,CAAC,CAAC;oBACf,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/harness/session-store.d.ts

@@ -32,3 +32,36 @@ export declare function saveHarnessSession(rec: HarnessSessionRecord): void;
 export declare function clearHarnessSession(agentId: string, taskId: string, mode: string): void;
 /** True when a record exists (used to decide whether resume is even possible). */
 export declare function hasHarnessSession(agentId: string, taskId: string, mode: string): boolean;
+/**
+ * Live harness-session record (2026-10).
+ *
+ * The resume store above is written only when a run FINISHES. A forced stop
+ * kills the CLI before that, so the daemon had no way to learn the
+ * harness-native session id of the run it just killed - and on OpenCode V2 the
+ * shared service keeps executing that session after the CLI dies.
+ *
+ * This record is written the moment the harness session id is captured, keyed
+ * by the BRIDGE session id (the `--session` value the daemon knows). On a
+ * forced stop the daemon reads it, interrupts the harness session, and only
+ * then removes the run scope. A clean exit removes it in `cleanMcp`.
+ */
+export interface LiveHarnessSessionRecord {
+    bridgeSessionId: string;
+    harness: string;
+    /** Harness-native session id (opencode `ses_...`, claude/codex id, ...). */
+    id: string;
+    /** Working directory the harness actually ran in (the run scope when one was created). */
+    cwd: string;
+    /** `<projectRoot>/.teamshare-runs/<bridgeSessionId>` when a run scope was used. */
+    scopeDir: string | null;
+    agentId: string | null;
+    taskId: string | null;
+    mode: string | null;
+    createdAt: string;
+}
+/** Persist the live harness id (best-effort; never throws). */
+export declare function saveLiveHarnessSession(rec: LiveHarnessSessionRecord): void;
+/** Load the live harness id for a bridge session, or null. */
+export declare function loadLiveHarnessSession(bridgeSessionId: string): LiveHarnessSessionRecord | null;
+/** Drop the live harness id (clean exit, or after a successful stop). */
+export declare function clearLiveHarnessSession(bridgeSessionId: string): void;

package/dist/lib/harness/session-store.js

@@ -4,6 +4,9 @@ exports.loadHarnessSession = loadHarnessSession;
 exports.saveHarnessSession = saveHarnessSession;
 exports.clearHarnessSession = clearHarnessSession;
 exports.hasHarnessSession = hasHarnessSession;
+exports.saveLiveHarnessSession = saveLiveHarnessSession;
+exports.loadLiveHarnessSession = loadLiveHarnessSession;
+exports.clearLiveHarnessSession = clearLiveHarnessSession;
 /**
  * Machine-local harness session store.
  *
@@ -19,6 +22,7 @@ const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
 const STORE_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'harness-sessions');
+const SESSIONS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'sessions');
 function recordPath(agentId, taskId, mode) {
     return (0, node_path_1.join)(STORE_DIR, agentId, `${taskId}.${mode}.json`);
 }
@@ -77,6 +81,40 @@ function clearHarnessSession(agentId, taskId, mode) {
 function hasHarnessSession(agentId, taskId, mode) {
     return (0, node_fs_1.existsSync)(recordPath(agentId, taskId, mode));
 }
+function liveRecordPath(bridgeSessionId) {
+    const safe = bridgeSessionId.replace(/[^a-zA-Z0-9._-]/g, '_').slice(0, 80);
+    return (0, node_path_1.join)(SESSIONS_DIR, `harness-${safe}.json`);
+}
+/** Persist the live harness id (best-effort; never throws). */
+function saveLiveHarnessSession(rec) {
+    try {
+        (0, node_fs_1.mkdirSync)(SESSIONS_DIR, { recursive: true });
+        (0, node_fs_1.writeFileSync)(liveRecordPath(rec.bridgeSessionId), JSON.stringify(rec, null, 2), 'utf8');
+    }
+    catch {
+        /* best-effort: a stop must still work without this file */
+    }
+}
+/** Load the live harness id for a bridge session, or null. */
+function loadLiveHarnessSession(bridgeSessionId) {
+    try {
+        const raw = (0, node_fs_1.readFileSync)(liveRecordPath(bridgeSessionId), 'utf8');
+        const rec = JSON.parse(raw);
+        return rec?.id ? rec : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Drop the live harness id (clean exit, or after a successful stop). */
+function clearLiveHarnessSession(bridgeSessionId) {
+    try {
+        (0, node_fs_1.rmSync)(liveRecordPath(bridgeSessionId), { force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
 function normalize(p) {
     return p.replace(/\\/g, '/').replace(/\/+$/, '').toLowerCase();
 }

package/dist/lib/harness/session-store.js.map

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