@te-river/opencode-team-mode 1.5.0 → 1.5.1

package/dist/tm/preview.js

@@ -0,0 +1,354 @@
+/**
+ * JIT layer-2 tools — content-aware previews (the soul of the offload handle)
+ * plus the L1 "structure" summaries for tm_fetch mode:"structure".
+ *
+ * Five branches, chosen by content_type (path hint) with sniffing fallback:
+ *   json   -> first 3 keys: path + type + magnitude
+ *   csv    -> header + 2 sample rows + total rows x cols
+ *   log    -> first 3 lines + pattern stats (ERROR x N, ...) + path:line refs
+ *   code   -> function/class signature list (with line numbers)
+ *   binary -> type + size + "不可预览"
+ *
+ * RED LINE: previews are hard-capped at TM_PREVIEW_MAX_TOKENS (default 80
+ * estimated tokens).  A bloated preview is an R4 regression — the cap is
+ * enforced by composition (body budget = cap - meta) so clue + hint lines
+ * always survive truncation.
+ */
+import * as path from "node:path";
+import { estimateTokens, shorten } from "./config.js";
+const CODE_EXTENSIONS = new Set([
+    ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".rs", ".java",
+    ".c", ".h", ".cpp", ".hpp", ".cs", ".rb", ".php", ".swift", ".kt", ".kts",
+    ".scala", ".sh", ".bash", ".ps1", ".psm1", ".sql", ".css", ".scss", ".less",
+    ".html", ".htm", ".vue", ".svelte", ".lua", ".pl", ".r", ".dart",
+]);
+const BINARY_EXTENSIONS = new Set([
+    ".png", ".jpg", ".jpeg", ".gif", ".webp", ".ico", ".bmp", ".pdf", ".zip",
+    ".gz", ".tgz", ".tar", ".bz2", ".7z", ".rar", ".exe", ".dll", ".so",
+    ".dylib", ".bin", ".dat", ".woff", ".woff2", ".ttf", ".otf", ".eot",
+    ".mp3", ".wav", ".flac", ".mp4", ".mov", ".avi", ".mkv", ".sqlite", ".db",
+    ".class", ".jar", ".wasm", ".node", ".pyc",
+]);
+/** Content type derived from the file extension (deterministic hint). */
+export function contentTypeForPath(p) {
+    const ext = path.extname(String(p ?? "")).toLowerCase();
+    if (ext === ".json" || ext === ".jsonc")
+        return "json";
+    if (ext === ".csv" || ext === ".tsv")
+        return "csv";
+    if (ext === ".log")
+        return "log";
+    if (BINARY_EXTENSIONS.has(ext))
+        return "binary";
+    if (CODE_EXTENSIONS.has(ext))
+        return "code";
+    return "text";
+}
+function looksBinary(sample) {
+    if (sample.includes("\0"))
+        return true;
+    let bad = 0;
+    for (const ch of sample) {
+        const c = ch.codePointAt(0) ?? 0;
+        if (c < 9 || (c > 13 && c < 32))
+            bad++;
+    }
+    return sample.length > 0 && bad / sample.length > 0.05;
+}
+/** Consistent column delimiter across the first few non-empty lines, if any. */
+function detectDelimiter(lines) {
+    const head = lines.slice(0, Math.min(4, lines.length));
+    for (const d of [",", "\t", ";", "|"]) {
+        const counts = head.map((l) => l.split(d).length);
+        if (Math.min(...counts) >= 2 && counts.every((c) => c === counts[0]))
+            return d;
+    }
+    return null;
+}
+/**
+ * Sniff content type when no path hint exists (or the hint was plain "text").
+ * Order: binary -> json -> csv -> code -> text.  Logs and plain text share
+ * the same preview branch, so no separate sniff rule is needed for them.
+ */
+export function sniffContentType(content) {
+    const sample = content.slice(0, 4096);
+    if (looksBinary(sample))
+        return "binary";
+    const trimmed = content.trimStart();
+    if (trimmed.startsWith("{") || trimmed.startsWith("["))
+        return "json";
+    const lines = content.split(/\r?\n/).filter((l) => l.trim()).slice(0, 5);
+    if (lines.length >= 2 && detectDelimiter(lines))
+        return "csv";
+    if (/(?:^|\n)\s*(?:export\s+)?(?:async\s+)?(?:function|class|interface|def)\b/.test(sample) ||
+        /(?:^|\n)\s*(?:import|from|package|using|namespace)\b/.test(sample)) {
+        return "code";
+    }
+    return "text";
+}
+/**
+ * Resolve the effective branch: a path-derived hint wins (deterministic);
+ * plain-text hints and missing hints fall through to sniffing (which may
+ * still upgrade the content to json / csv / code / binary).
+ */
+export function detectContentType(content, hint) {
+    if (hint && hint !== "text")
+        return hint;
+    return sniffContentType(content);
+}
+/** Hard cap by estimated tokens (chars/4): never exceed maxTokens. */
+export function capTokens(text, maxTokens) {
+    const marker = " …(截断)";
+    const maxChars = Math.max(8, maxTokens * 4);
+    if (text.length <= maxChars)
+        return text;
+    const usable = maxChars - marker.length; // marker lives INSIDE the budget
+    const cut = text.slice(0, usable);
+    const trimmed = cut.replace(/\s+\S*$/, ""); // back off to the last word boundary
+    const body = trimmed.length >= usable * 0.6 ? trimmed : cut;
+    return body + marker;
+}
+// ---------- five preview branches ----------
+function describeJsonValue(v) {
+    if (v === null)
+        return "null";
+    switch (typeof v) {
+        case "string":
+            return `string(len=${v.length})`;
+        case "number":
+        case "boolean":
+            return `${typeof v}=${v}`;
+        case "object":
+            return Array.isArray(v)
+                ? `array[len=${v.length}]`
+                : `object[keys=${Object.keys(v).length}]`;
+        default:
+            return typeof v;
+    }
+}
+function jsonPreview(content) {
+    const text = content.trim();
+    if (!text.startsWith("{") && !text.startsWith("["))
+        return null;
+    let obj;
+    try {
+        obj = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (Array.isArray(obj)) {
+        return `array[len=${obj.length}]，元素样本: ${obj.slice(0, 3).map(describeJsonValue).join(", ")}`;
+    }
+    if (obj && typeof obj === "object") {
+        const entries = Object.entries(obj);
+        const head = entries.slice(0, 3).map(([k, v]) => `${k}: ${describeJsonValue(v)}`);
+        const more = entries.length > 3 ? `（其余 ${entries.length - 3} 键省略）` : "";
+        return head.join("; ") + more;
+    }
+    return `scalar: ${describeJsonValue(obj)}`;
+}
+function csvPreview(content) {
+    const lines = content.split(/\r?\n/).filter((l) => l.trim());
+    if (lines.length < 2)
+        return null;
+    const delim = detectDelimiter(lines);
+    if (!delim)
+        return null;
+    const cols = lines[0].split(delim).length;
+    const shown = [lines[0], ...lines.slice(1, 3)].map((l) => shorten(l, 110));
+    const label = delim === "\t" ? "TAB" : delim;
+    shown.push(`共 ${lines.length} 行 × ${cols} 列（分隔符 "${label}"）`);
+    return shown.join("\n");
+}
+const PATH_LINE_REF = /(?:[A-Za-z0-9_.\-]+[\\/])*[A-Za-z0-9_.\-]+\.[A-Za-z0-9]{1,8}:\d{1,6}/g;
+function collectPathLineRefs(content, max) {
+    const seen = new Set();
+    for (const m of content.matchAll(PATH_LINE_REF)) {
+        seen.add(m[0]);
+        if (seen.size >= max)
+            break;
+    }
+    return [...seen];
+}
+/** log + plain text share one branch: head lines + pattern stats + refs. */
+function textPreview(content) {
+    const lines = content.split(/\r?\n/);
+    const head = lines.filter((l) => l.trim()).slice(0, 3).map((l) => shorten(l, 90));
+    const count = (re) => (content.match(re) ?? []).length;
+    const fatal = count(/\bFATAL\b/g);
+    const error = count(/\bERROR\b/g);
+    const warn = count(/\bWARN(?:ING)?\b/g);
+    const info = count(/\bINFO\b/g);
+    const stats = [
+        fatal ? `FATAL×${fatal}` : "",
+        error ? `ERROR×${error}` : "",
+        warn ? `WARN×${warn}` : "",
+        info ? `INFO×${info}` : "",
+    ].filter(Boolean).join(" ");
+    const refs = collectPathLineRefs(content, 3);
+    const parts = [head.length ? head.join("\n") : "(空内容)", `共 ${lines.length} 行`];
+    if (stats)
+        parts.push(stats);
+    if (refs.length)
+        parts.push(`位置: ${refs.join(", ")}`);
+    return parts.join("\n");
+}
+const SIGNATURE_PATTERNS = [
+    ["function", /(?:export\s+)?(?:default\s+)?(?:async\s+)?function\s*\*?\s*([A-Za-z0-9_$]+)/g],
+    ["class", /(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z0-9_$]+)/g],
+    ["interface", /(?:export\s+)?interface\s+([A-Za-z0-9_$]+)/g],
+    ["type", /(?:export\s+)?type\s+([A-Za-z0-9_$]+)\s*[=<]/g],
+    ["def", /^[ \t]*(?:async\s+)?def\s+([A-Za-z0-9_]+)/gm],
+    ["fn", /^[ \t]*(?:pub(?:\([^)]*\))?\s+)?fn\s+([A-Za-z0-9_]+)/gm],
+    ["const-fn", /(?:export\s+)?(?:const|let|var)\s+([A-Za-z0-9_$]+)\s*=\s*(?:async\s*)?\(/g],
+];
+function lineOfIndex(content, index) {
+    let line = 1;
+    for (let i = 0; i < index && i < content.length; i++) {
+        if (content.charCodeAt(i) === 10)
+            line++;
+    }
+    return line;
+}
+function codePreview(content, maxSignatures = 10) {
+    const found = [];
+    for (const [kind, re] of SIGNATURE_PATTERNS) {
+        for (const m of content.matchAll(re)) {
+            found.push(`L${lineOfIndex(content, m.index ?? 0)}: ${kind} ${m[1]}`);
+            if (found.length >= maxSignatures)
+                break;
+        }
+        if (found.length >= maxSignatures)
+            break;
+    }
+    if (found.length === 0)
+        return null;
+    const more = found.length >= maxSignatures ? "（更多签名省略）" : "";
+    return found.join("\n") + more;
+}
+function binaryPreview(content) {
+    return `二进制内容（binary），大小 ${content.length} bytes，不可预览`;
+}
+/**
+ * Compose body + clue + one-line hint, then enforce the token cap WITHOUT
+ * cutting the meta lines (body gets the residual budget; if the cap is too
+ * tight for meaningful body content the meta shrinks first, body last).
+ */
+function composeCapped(body, clue, maxTokens) {
+    const HINT = "提示: 先聚合再决定是否取原文（tm_fetch 分段取回）";
+    let meta = clue ? `线索: ${clue}\n${HINT}` : HINT;
+    let budget = maxTokens - estimateTokens(meta) - 1;
+    if (budget < 20) {
+        meta = HINT;
+        budget = maxTokens - estimateTokens(meta) - 1;
+    }
+    if (budget < 20) {
+        meta = "";
+        budget = maxTokens;
+    }
+    const cappedBody = capTokens(body, budget);
+    return meta ? `${cappedBody}\n${meta}` : cappedBody;
+}
+/** Build the governed preview for offloaded content. Never throws. */
+export function buildPreview(content, contentType, opts = {}) {
+    const maxTokens = Math.max(10, Math.trunc(opts.maxTokens ?? 80));
+    let body;
+    try {
+        switch (contentType) {
+            case "binary":
+                body = binaryPreview(content);
+                break;
+            case "json":
+                body = jsonPreview(content) ?? textPreview(content);
+                break;
+            case "csv":
+                body = csvPreview(content) ?? textPreview(content);
+                break;
+            case "code":
+                body = codePreview(content) ?? textPreview(content);
+                break;
+            default:
+                body = textPreview(content);
+        }
+    }
+    catch {
+        body = textPreview(content);
+    }
+    return composeCapped(body, opts.clue, maxTokens);
+}
+// ---------- L1 structure summaries (tm_fetch mode:"structure") ----------
+function structureJson(content) {
+    let obj;
+    try {
+        obj = JSON.parse(content.trim());
+    }
+    catch {
+        return null;
+    }
+    if (Array.isArray(obj))
+        return `array[len=${obj.length}]`;
+    if (obj && typeof obj === "object") {
+        const entries = Object.entries(obj).slice(0, 15);
+        return entries.map(([k, v]) => `${k}: ${describeJsonValue(v)}`).join("\n");
+    }
+    return `scalar: ${describeJsonValue(obj)}`;
+}
+function structureCsv(content) {
+    const lines = content.split(/\r?\n/).filter((l) => l.trim());
+    if (lines.length < 2)
+        return null;
+    const delim = detectDelimiter(lines);
+    if (!delim)
+        return null;
+    const cols = lines[0].split(delim).length;
+    return `表头: ${shorten(lines[0], 100)}\n共 ${lines.length} 行 × ${cols} 列`;
+}
+function structureText(content) {
+    const lines = content.split(/\r?\n/);
+    const errLines = [];
+    const warnLines = [];
+    const headings = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (errLines.length < 8 && /\bERROR\b/.test(lines[i]))
+            errLines.push(i + 1);
+        else if (warnLines.length < 8 && /\bWARN(?:ING)?\b/.test(lines[i]))
+            warnLines.push(i + 1);
+        if (headings.length < 6 && /^#{1,3}\s+\S/.test(lines[i])) {
+            headings.push(`L${i + 1}: ${shorten(lines[i].trim(), 60)}`);
+        }
+    }
+    const parts = [`共 ${lines.length} 行`];
+    if (errLines.length)
+        parts.push(`ERROR 行: ${errLines.join(",")}`);
+    if (warnLines.length)
+        parts.push(`WARN 行: ${warnLines.join(",")}`);
+    if (headings.length)
+        parts.push(headings.join("\n"));
+    return parts.join("\n");
+}
+/** ~100-token-level L1 map of an offloaded payload (TOC / key tree / error lines). */
+export function buildStructureSummary(content, contentType) {
+    let summary;
+    try {
+        switch (contentType) {
+            case "json":
+                summary = structureJson(content) ?? structureText(content);
+                break;
+            case "csv":
+                summary = structureCsv(content) ?? structureText(content);
+                break;
+            case "code":
+                summary = (codePreview(content, 12) ?? structureText(content)) +
+                    `\n共 ${content.split(/\r?\n/).length} 行`;
+                break;
+            default:
+                summary = structureText(content);
+        }
+    }
+    catch {
+        summary = structureText(content);
+    }
+    return capTokens(summary, 100);
+}
+//# sourceMappingURL=preview.js.map

package/dist/tm/preview.js.map

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

package/dist/tm/refs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * JIT layer-2 tools — run identity + offload handle crypto.
+ *
+ * A handle is {ref, access_token, expire_at}:
+ *   - ref          = tm://runs/{run_id}/steps/{step_id}/result
+ *   - access_token = HMAC-SHA256(process-start random key, run_id)
+ *     (may also ride the ref as a `#<hex>` fragment — tm_fetch accepts both)
+ *   - expire_at    = creation time + TM_BLACKBOARD_TTL (default 7 days)
+ *
+ * The key lives only in process memory; a model can carry a handle around
+ * but cannot forge one for another run, and a handle from an earlier
+ * process is dead the moment that process ends (new key, new run id).
+ */
+import * as crypto from "node:crypto";
+/** Compact run id: `r-<yyyyMMdd-HHmmss>-<6 hex>` (generated once per server()). */
+export declare function newRunId(now?: Date): string;
+/** HMAC-SHA256(key, runId) as hex — the handle access token. */
+export declare function hmacToken(key: crypto.BinaryLike, runId: string): string;
+/** Constant-time token check (length-compare guard before timingSafeEqual). */
+export declare function verifyToken(key: crypto.BinaryLike, runId: string, token: unknown): boolean;
+/** Strict ref grammar; the token fragment is optional. */
+export declare const REF_PATTERN: RegExp;
+export declare function buildRef(runId: string, stepId: string): string;
+export interface ParsedRef {
+    runId: string;
+    stepId: string;
+    token?: string;
+}
+/** Parse a ref; null when malformed (wrong scheme, extra segments, junk). */
+export declare function parseRef(ref: unknown): ParsedRef | null;
+/**
+ * True when `expireAt` (ms epoch) is strictly in the past at `now`.
+ * Non-numeric expire_at fails CLOSED (treated as expired) — entries are
+ * plugin-written, so a malformed one must not extend a handle's life.
+ */
+export declare function isExpired(expireAt: unknown, now?: number): boolean;
+//# sourceMappingURL=refs.d.ts.map

package/dist/tm/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/tm/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAMvD;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAI1F;AAED,0DAA0D;AAC1D,eAAO,MAAM,WAAW,QACsD,CAAA;AAE9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAI9E"}

package/dist/tm/refs.js

@@ -0,0 +1,58 @@
+/**
+ * JIT layer-2 tools — run identity + offload handle crypto.
+ *
+ * A handle is {ref, access_token, expire_at}:
+ *   - ref          = tm://runs/{run_id}/steps/{step_id}/result
+ *   - access_token = HMAC-SHA256(process-start random key, run_id)
+ *     (may also ride the ref as a `#<hex>` fragment — tm_fetch accepts both)
+ *   - expire_at    = creation time + TM_BLACKBOARD_TTL (default 7 days)
+ *
+ * The key lives only in process memory; a model can carry a handle around
+ * but cannot forge one for another run, and a handle from an earlier
+ * process is dead the moment that process ends (new key, new run id).
+ */
+import * as crypto from "node:crypto";
+/** Compact run id: `r-<yyyyMMdd-HHmmss>-<6 hex>` (generated once per server()). */
+export function newRunId(now = new Date()) {
+    const p = (n) => String(n).padStart(2, "0");
+    const ts = `${now.getFullYear()}${p(now.getMonth() + 1)}${p(now.getDate())}` +
+        `-${p(now.getHours())}${p(now.getMinutes())}${p(now.getSeconds())}`;
+    return `r-${ts}-${crypto.randomBytes(3).toString("hex")}`;
+}
+/** HMAC-SHA256(key, runId) as hex — the handle access token. */
+export function hmacToken(key, runId) {
+    return crypto.createHmac("sha256", key).update(runId).digest("hex");
+}
+/** Constant-time token check (length-compare guard before timingSafeEqual). */
+export function verifyToken(key, runId, token) {
+    const expected = Buffer.from(hmacToken(key, runId), "utf8");
+    const given = Buffer.from(String(token ?? ""), "utf8");
+    return given.length === expected.length && crypto.timingSafeEqual(expected, given);
+}
+/** Strict ref grammar; the token fragment is optional. */
+export const REF_PATTERN = /^tm:\/\/runs\/([^/\s]+)\/steps\/([^/\s]+)\/result(?:#([0-9a-fA-F]{16,}))?$/;
+export function buildRef(runId, stepId) {
+    return `tm://runs/${runId}/steps/${stepId}/result`;
+}
+/** Parse a ref; null when malformed (wrong scheme, extra segments, junk). */
+export function parseRef(ref) {
+    const m = REF_PATTERN.exec(String(ref ?? "").trim());
+    if (!m)
+        return null;
+    const parsed = { runId: m[1], stepId: m[2] };
+    if (m[3])
+        parsed.token = m[3];
+    return parsed;
+}
+/**
+ * True when `expireAt` (ms epoch) is strictly in the past at `now`.
+ * Non-numeric expire_at fails CLOSED (treated as expired) — entries are
+ * plugin-written, so a malformed one must not extend a handle's life.
+ */
+export function isExpired(expireAt, now = Date.now()) {
+    const t = Number(expireAt);
+    if (!Number.isFinite(t))
+        return true;
+    return now > t;
+}
+//# sourceMappingURL=refs.js.map

package/dist/tm/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/tm/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,MAAY,IAAI,IAAI,EAAE;IAC7C,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACnD,MAAM,EAAE,GACN,GAAG,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE;QACjE,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,CAAA;IACrE,OAAO,KAAK,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAA;AAC3D,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,GAAsB,EAAE,KAAa;IAC7D,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACrE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,GAAsB,EAAE,KAAa,EAAE,KAAc;IAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;IACtD,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AACpF,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,WAAW,GACtB,4EAA4E,CAAA;AAE9E,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,MAAc;IACpD,OAAO,aAAa,KAAK,UAAU,MAAM,SAAS,CAAA;AACpD,CAAC;AAQD,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACpD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,MAAM,MAAM,GAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACvD,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7B,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,QAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACnE,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACpC,OAAO,GAAG,GAAG,CAAC,CAAA;AAChB,CAAC"}

package/dist/tm/store.d.ts

@@ -0,0 +1,95 @@
+/**
+ * JIT layer-2 tools — run-payload store + trajectory.
+ *
+ * Blackboard layout (under TM_BLACKBOARD_DIR, default `<project>/.blackboard/`):
+ *   runs/{run_id}/steps/{step_id}/{seq:03d}-{tool}.md   full offloaded result
+ *   runs/{run_id}/index.jsonl                            one append per result
+ *     entry = { ts, run_id, step_id, seq, tool, ref, file, tokens,
+ *               content_type, expire_at, preview }
+ *
+ * Trajectory layout (under TM_TRAJECTORY_DIR, default `<project>/.trajectory/`):
+ *   runs/{run_id}/steps.jsonl    append-only, one line per event — NO code
+ *                                path may rewrite, truncate or delete lines;
+ *                                the TTL sweep of whole expired run dirs is
+ *                                the sanctioned reclamation path.
+ *   runs/{run_id}/usage.jsonl    RESERVED for T2.2 (constant below, unused).
+ *
+ * Reclamation philosophy mirrors blackboard.ts: a startup sweep removes run
+ * dirs idle past the TTL — idleness measured across the whole run-dir tree
+ * (file appends must count as activity; only this sweep is destructive).
+ */
+/** Reserved for T2.2 usage accounting — path constant only in this phase. */
+export declare const USAGE_JSONL_RELPATH = "usage.jsonl";
+export interface OffloadMeta {
+    tool: string;
+    content: string;
+    tokens: number;
+    contentType: string;
+    preview: string;
+    expireAt: number;
+}
+export interface StoredRef {
+    stepId: string;
+    seq: number;
+    file: string;
+    ref: string;
+    expireAt: number;
+}
+export interface IndexEntry {
+    ts: string;
+    run_id: string;
+    step_id: string;
+    seq: number;
+    tool: string;
+    ref: string;
+    file: string;
+    tokens: number;
+    content_type: string;
+    expire_at: number;
+    preview: string;
+}
+export interface RunStoreOptions {
+    projectRoot: string;
+    blackboardDir: string;
+    trajectoryDir: string;
+    runId: string;
+    ttlDays: number;
+}
+export declare class RunStore {
+    readonly blackboardRoot: string;
+    readonly trajectoryRoot: string;
+    private readonly _runId;
+    private readonly _ttlMs;
+    constructor(opts: RunStoreOptions);
+    get runId(): string;
+    private runDir;
+    stepsRoot(): string;
+    trajectoryFile(): string;
+    /**
+     * Write one offloaded result: step file (single write, never rewritten) +
+     * index.jsonl append.  Throws on store failures — the caller degrades
+     * (governance failures must not fail the task).
+     */
+    writeResult(stepId: string, meta: OffloadMeta): StoredRef;
+    /**
+     * Append one trajectory event.  Append-only by contract; best-effort
+     * (trajectory failures are swallowed — the blackboard failure path is the
+     * one that degrades upstream).
+     */
+    appendTrajectory(event: Record<string, unknown>): void;
+    /** Latest index entry for a ref (last append wins), or null. */
+    findIndexEntry(ref: string): IndexEntry | null;
+    /** Read the offloaded payload file of a step; null when gone/unreadable.
+     *  With multiple seq files in one step (defensive re-entry), the LATEST
+     *  seq wins — consistent with findIndexEntry's last-append-wins. */
+    readStepFile(stepId: string): {
+        content: string;
+    } | null;
+    /**
+     * Startup-only reclamation: remove run dirs (both stores) whose last tree
+     * activity is older than the TTL.  This is the ONLY destructive path in
+     * this module.  Returns the number of run dirs removed.  Never throws.
+     */
+    sweepExpired(now?: number): number;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/tm/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tm/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAKhD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,QAAQ;IACnB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,IAAI,EAAE,eAAe;IAWjC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,OAAO,CAAC,MAAM;IAId,SAAS,IAAI,MAAM;IAInB,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS;IA+BzD;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYtD,gEAAgE;IAChE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAmB9C;;wEAEoE;IACpE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWxD;;;;OAIG;IACH,YAAY,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM;CA+B/C"}