teamshare-bridge 0.27.5 → 0.28.2

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

@@ -1,9 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONVERSATIONAL_MODES = exports.DEFAULT_CHAT_CONTEXT_TOKENS = void 0;
+exports.estimateSessionTokens = estimateSessionTokens;
+exports.sessionContextExceeded = sessionContextExceeded;
 exports.loadHarnessSession = loadHarnessSession;
 exports.saveHarnessSession = saveHarnessSession;
 exports.clearHarnessSession = clearHarnessSession;
+exports.peekHarnessSession = peekHarnessSession;
+exports.addHarnessSessionContext = addHarnessSessionContext;
+exports.noteHarnessSessionFailure = noteHarnessSessionFailure;
+exports.clearHarnessSessionFailure = clearHarnessSessionFailure;
 exports.hasHarnessSession = hasHarnessSession;
+exports.conversationWouldResume = conversationWouldResume;
 exports.saveLiveHarnessSession = saveLiveHarnessSession;
 exports.loadLiveHarnessSession = loadLiveHarnessSession;
 exports.clearLiveHarnessSession = clearLiveHarnessSession;
@@ -21,8 +29,55 @@ exports.clearLiveHarnessSession = clearLiveHarnessSession;
 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');
+// Env overrides exist so a test can never write into the developer's real
+// `~/.teamshare/harness-sessions` (and, worse, adopt a live agent's session
+// record). Same pattern as `mirror-lease.ts`'s `TS_MIRROR_LEASE_DIR`.
+const STORE_DIR = process.env.TS_HARNESS_SESSION_DIR?.trim() ||
+    (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'harness-sessions');
+const SESSIONS_DIR = process.env.TS_SESSIONS_DIR?.trim() ||
+    (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'sessions');
+/**
+ * Default context budget for a conversational session (2026-12).
+ *
+ * A project can override it (`Project.chatMaxContextTokens`); this is what
+ * "not stated" means. 400k is large enough that a normal project conversation
+ * never rotates, and small enough that it happens well before the biggest
+ * windows fill.
+ */
+exports.DEFAULT_CHAT_CONTEXT_TOKENS = 400_000;
+/** Modes that are ONE CONVERSATION and must not lose it to a transient error. */
+exports.CONVERSATIONAL_MODES = new Set([
+    'chat',
+    'doc',
+    'board',
+]);
+/**
+ * Rough token estimate for a conversation from its accumulated character count.
+ *
+ * ~4 characters per token is the standard English approximation, and it is the
+ * only one that works for every harness (some print usage, most do not).
+ */
+function estimateSessionTokens(contextChars) {
+    if (!contextChars || contextChars <= 0)
+        return 0;
+    return Math.ceil(contextChars / 4);
+}
+/**
+ * Has this conversation outgrown its budget?
+ *
+ * `limit` is `Project.chatMaxContextTokens` (null/undefined = the 400k
+ * default). A record with no `contextChars` (written before this field existed)
+ * is treated as EMPTY, not as over budget - the first run under the new code
+ * adopts it and starts counting from its own prompt.
+ */
+function sessionContextExceeded(record, limitTokens) {
+    if (!record)
+        return false;
+    const limit = typeof limitTokens === 'number' && limitTokens > 0
+        ? limitTokens
+        : exports.DEFAULT_CHAT_CONTEXT_TOKENS;
+    return estimateSessionTokens(record.contextChars) >= limit;
+}
 function recordPath(agentId, taskId, mode) {
     return (0, node_path_1.join)(STORE_DIR, agentId, `${taskId}.${mode}.json`);
 }
@@ -77,10 +132,94 @@ function clearHarnessSession(agentId, taskId, mode) {
         /* best-effort */
     }
 }
+/** Read a record regardless of harness/cwd (used for accounting + rotation). */
+function peekHarnessSession(agentId, taskId, mode) {
+    try {
+        const raw = (0, node_fs_1.readFileSync)(recordPath(agentId, taskId, mode), 'utf8');
+        const rec = JSON.parse(raw);
+        return rec?.id ? rec : null;
+    }
+    catch {
+        return null;
+    }
+}
+function patchSessionRecord(agentId, taskId, mode, patch) {
+    const current = peekHarnessSession(agentId, taskId, mode);
+    if (!current)
+        return null;
+    try {
+        const next = patch(current);
+        (0, node_fs_1.writeFileSync)(recordPath(agentId, taskId, mode), JSON.stringify(next, null, 2), 'utf8');
+        return next;
+    }
+    catch {
+        return current;
+    }
+}
+/**
+ * Add one turn's worth of characters to a session's context estimate.
+ *
+ * Called after a successful turn. Best-effort: a missing record (cleared mid
+ * run) is a no-op, and the conversation simply starts counting again next time.
+ */
+function addHarnessSessionContext(agentId, taskId, mode, addedChars) {
+    const add = Math.max(0, Math.round(addedChars));
+    return patchSessionRecord(agentId, taskId, mode, (rec) => ({
+        ...rec,
+        contextChars: (rec.contextChars ?? 0) + add,
+        turns: (rec.turns ?? 0) + 1,
+        consecutiveFailures: 0,
+        lastUsedAt: new Date().toISOString(),
+    }));
+}
+/**
+ * Record a failed turn on a conversational session.
+ *
+ * Returns the new consecutive-failure count, so the caller can decide whether
+ * the session is worth keeping (1) or poisoned (>= 2).
+ */
+function noteHarnessSessionFailure(agentId, taskId, mode, error) {
+    const next = patchSessionRecord(agentId, taskId, mode, (rec) => ({
+        ...rec,
+        consecutiveFailures: (rec.consecutiveFailures ?? 0) + 1,
+        lastError: error?.slice(0, 300),
+    }));
+    return next?.consecutiveFailures ?? 0;
+}
+/**
+ * Take back the recorded failure of a turn that DID deliver its answer (2026-11).
+ *
+ * A conversational turn can exit non-zero AFTER the model posted its reply
+ * through the MCP tool (OpenCode V2 client/server). The bridge only learns that
+ * later, from the channel, so the caller clears the strike it did not deserve -
+ * otherwise one delivered turn plus one transient error would reach the 2-strike
+ * conversation reset and silently forget the thread.
+ */
+function clearHarnessSessionFailure(agentId, taskId, mode) {
+    patchSessionRecord(agentId, taskId, mode, (rec) => {
+        const next = { ...rec, consecutiveFailures: 0 };
+        delete next.lastError;
+        return next;
+    });
+}
 /** True when a record exists (used to decide whether resume is even possible). */
 function hasHarnessSession(agentId, taskId, mode) {
     return (0, node_fs_1.existsSync)(recordPath(agentId, taskId, mode));
 }
+/**
+ * Would the next run of this conversation RESUME, or start fresh? (2026-12)
+ *
+ * Read-only: it applies exactly the gates `spawnHarness` applies (record
+ * present, same harness, same cwd) plus the context budget, so a caller can
+ * choose a bigger seed window when the conversation is about to be new
+ * (`chat-reply`). It must never rotate anything itself.
+ */
+function conversationWouldResume(agentId, taskId, mode, harness, cwd, limitTokens) {
+    const rec = loadRecord(agentId, taskId, mode, harness, cwd);
+    if (!rec)
+        return false;
+    return !sessionContextExceeded(rec, limitTokens);
+}
 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`);

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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"}

package/dist/lib/harness/spawn.d.ts

@@ -1,5 +1,20 @@
 import { type HarnessName, type SpawnOpts } from './harness-adapter';
 export type LogFn = (text: string, level?: 'stdout' | 'stderr') => void;
+/**
+ * Does this harness output line report "the conversation is too big for the
+ * model's context window"? (2026-12)
+ *
+ * Harnesses fail this way in words, not codes, and every vendor phrases it
+ * differently: OpenAI says "maximum context length", Anthropic "prompt is too
+ * long", Gemini "input token count ... exceeds", local models print
+ * "context window exceeded". We only need to recognise it well enough to
+ * ROTATE instead of failing the reply - a false positive costs one fresh
+ * session, a false negative loses the human's message.
+ *
+ * Deliberately narrow: bare "token" or "context" alone would match ordinary
+ * chatter, so each pattern pairs the idea with a limit/exceed verb.
+ */
+export declare function isContextOverflowText(text: string): boolean;
 /**
  * Kill a spawned harness AND its whole descendant tree. Plain child.kill()
  * only terminates the shell wrapper (cmd.exe / sh) - npm/vitest/LSP