teamshare-bridge 0.11.2 → 0.14.0

package/dist/lib/harness-models.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverHarnessModels = discoverHarnessModels;
+exports.pushHarnessCatalog = pushHarnessCatalog;
+/**
+ * Harness model discovery (IMP-9xx): asks each installed CLI for its native
+ * model list and pushes it to the TeamShare catalog so the web picker stays
+ * current as providers ship models. Discovery never gates a session - a
+ * failed push only means the UI falls back to free text.
+ *
+ * All three harnesses (opencode, antigravity, codex) are attempted on
+ * daemon boot and via `teamshare-bridge models sync`. Each returns null
+ * gracefully when its CLI is absent, uninstalled, or broken.
+ */
+const node_child_process_1 = require("node:child_process");
+const harness_1 = require("./harness");
+/** Runs `<bin> [shim-args] <args>` sync, returns combined stdout+stderr. */
+function runResolved(bin, args, timeoutMs = 20_000) {
+    const res = (0, node_child_process_1.spawnSync)(bin.file, [...(bin.args ?? []), ...args], {
+        encoding: 'utf8',
+        timeout: timeoutMs,
+        maxBuffer: 4 * 1024 * 1024,
+    });
+    return `${res.stdout ?? ''}${res.stderr ?? ''}`;
+}
+/** `opencode models` → plain text, one `provider/model` id per line. */
+function fromOpencode() {
+    const bin = (0, harness_1.resolveBin)('opencode');
+    if (!bin)
+        return null;
+    const out = runResolved(bin, ['models']);
+    const models = [];
+    for (const line of out.split(/\r?\n/)) {
+        const id = line.trim();
+        if (!id)
+            continue;
+        if (/^(op|usage|available|the |model)/i.test(id))
+            continue;
+        if (!/^[a-z][a-z0-9_./-]+$/i.test(id))
+            continue;
+        models.push({ modelId: id, label: id.replace(/^(opencode-go|opencode)\//, '') });
+    }
+    return models.length ? { source: 'discovered', models } : null;
+}
+/** `cursor agent models` → plain text, one model slug per line. */
+function fromCursor() {
+    const bin = (0, harness_1.resolveBin)('cursor');
+    if (!bin)
+        return null;
+    const out = runResolved(bin, ['agent', 'models']);
+    const models = [];
+    for (const line of out.split(/\r?\n/)) {
+        const id = line.trim();
+        if (!id)
+            continue;
+        if (/^(model|available|slug|name|cursor)/i.test(id))
+            continue;
+        if (!/^[a-z][a-z0-9_./\-]+$/i.test(id))
+            continue;
+        models.push({ modelId: id, label: id });
+    }
+    return models.length ? { source: 'discovered', models } : null;
+}
+/** `agy models` → TSV rows of `slug<TAB>Display Label`. */
+function fromAgy() {
+    const bin = (0, harness_1.resolveBin)('agy');
+    if (!bin)
+        return null;
+    const out = runResolved(bin, ['models']);
+    const models = [];
+    for (const line of out.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || /fetching|available models/i.test(trimmed))
+            continue;
+        const [id, ...rest] = trimmed.split(/\t|\s{2,}/);
+        if (!id || !rest.length)
+            continue;
+        if (!/^[\w.-]+$/.test(id))
+            continue;
+        models.push({ modelId: id, label: rest.join(' ').trim() });
+    }
+    return models.length ? { source: 'discovered', models } : null;
+}
+/** `codex debug models --bundled` → JSON { models: [{slug, display_name}] }. */
+function fromCodex() {
+    const bin = (0, harness_1.resolveBin)('codex');
+    if (!bin)
+        return null;
+    const out = runResolved(bin, ['debug', 'models', '--bundled']);
+    const jsonStart = out.indexOf('{');
+    if (jsonStart === -1)
+        return null;
+    try {
+        const parsed = JSON.parse(out.slice(jsonStart));
+        const list = Array.isArray(parsed.models) ? parsed.models : [];
+        const models = list
+            .filter((m) => typeof m.slug === 'string')
+            .map((m) => ({
+            modelId: m.slug,
+            label: typeof m.display_name === 'string' ? m.display_name : undefined,
+            meta: Array.isArray(m.reasoning_efforts) && m.reasoning_efforts.length
+                ? { efforts: m.reasoning_efforts }
+                : undefined,
+        }));
+        return models.length ? { source: 'discovered', models } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Native discovery per harness — attempts the CLI, returns null on failure
+ * (never throws). Callers treat null as "no models available" and skip
+ * the push silently so a broken/absent CLI never blocks sessions.
+ */
+function discoverHarnessModels(harness) {
+    try {
+        if (harness === 'opencode')
+            return fromOpencode();
+        if (harness === 'antigravity')
+            return fromAgy();
+        if (harness === 'codex')
+            return fromCodex();
+        if (harness === 'cursor')
+            return fromCursor();
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Pushes one harness batch to the TeamShare catalog (agent-key auth). */
+async function pushHarnessCatalog(baseUrl, apiKey, harness, batch) {
+    const base = baseUrl.replace(/\/+$/, '');
+    const res = await fetch(`${base}/model-catalog/discover`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Api-Key': apiKey },
+        body: JSON.stringify({ harness, source: batch.source, models: batch.models }),
+    });
+    if (!res.ok) {
+        throw new Error(`catalog push failed (${res.status}): ${await res.text().catch(() => '')}`.slice(0, 200));
+    }
+    const body = (await res.json());
+    return body.data?.stored ?? batch.models.length;
+}
+//# sourceMappingURL=harness-models.js.map

package/dist/lib/harness-models.js.map

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

package/dist/lib/harness-output.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Structured-output parsing for harnesses that emit JSON / NDJSON
+ * (antigravity `--output-format json`, claude `stream-json`, gemini json, ...).
+ *
+ * The reply loops call parseHarnessOutput() on the raw stdout and get back the
+ * plain-text reply. Defensive by design: when nothing structured is found the
+ * raw text is returned unchanged, so plain-text harnesses (opencode, codex
+ * exec) are never touched.
+ */
+/**
+ * Best-effort extraction of the plain-text reply from structured stdout.
+ * Returns null when nothing structured was found (caller keeps raw text).
+ */
+export declare function tryExtractStructuredReply(raw: string): string | null;
+/**
+ * Extract the plain-text reply for a harness. `structured` mirrors the
+ * adapter's `structuredOutput` flag; plain-text harnesses pass through.
+ */
+export declare function parseHarnessOutput(structured: boolean, raw: string): string;

package/dist/lib/harness-output.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Structured-output parsing for harnesses that emit JSON / NDJSON
+ * (antigravity `--output-format json`, claude `stream-json`, gemini json, ...).
+ *
+ * The reply loops call parseHarnessOutput() on the raw stdout and get back the
+ * plain-text reply. Defensive by design: when nothing structured is found the
+ * raw text is returned unchanged, so plain-text harnesses (opencode, codex
+ * exec) are never touched.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryExtractStructuredReply = tryExtractStructuredReply;
+exports.parseHarnessOutput = parseHarnessOutput;
+function isObject(v) {
+    return typeof v === 'object' && v !== null;
+}
+function asString(v) {
+    return typeof v === 'string' ? v : null;
+}
+/** Extract text from a single claude `stream-json` event line. */
+function claudeEventText(obj) {
+    if (obj.type === 'content_block_delta') {
+        const delta = obj.delta;
+        if (isObject(delta) && delta.type === 'text_delta')
+            return asString(delta.text);
+    }
+    if (obj.type === 'assistant') {
+        const content = obj.content;
+        if (Array.isArray(content)) {
+            const parts = [];
+            for (const c of content) {
+                if (isObject(c) && asString(c.text))
+                    parts.push(c.text);
+            }
+            if (parts.length)
+                return parts.join('');
+        }
+    }
+    return null;
+}
+/** Extract a reply from a single parsed JSON object (agy json shape). */
+function parseObjectReply(obj) {
+    if (asString(obj.response))
+        return obj.response;
+    if (asString(obj.text))
+        return obj.text;
+    if (asString(obj.message))
+        return obj.message;
+    if (asString(obj.content))
+        return obj.content;
+    if (isObject(obj.message) && Array.isArray(obj.message.content)) {
+        const parts = [];
+        for (const item of obj.message.content) {
+            if (isObject(item) && asString(item.text))
+                parts.push(item.text);
+        }
+        if (parts.length)
+            return parts.join('');
+    }
+    return null;
+}
+/**
+ * Best-effort extraction of the plain-text reply from structured stdout.
+ * Returns null when nothing structured was found (caller keeps raw text).
+ */
+function tryExtractStructuredReply(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    // NDJSON stream (claude stream-json) - one JSON object per line.
+    const lines = trimmed.split(/\r?\n/);
+    if (lines.length > 1) {
+        const texts = [];
+        let sawEvent = false;
+        for (const line of lines) {
+            const t = line.trim();
+            if (!t || !t.startsWith('{'))
+                continue;
+            try {
+                const obj = JSON.parse(t);
+                sawEvent = true;
+                const text = claudeEventText(obj) ?? parseObjectReply(obj);
+                if (text)
+                    texts.push(text);
+            }
+            catch {
+                /* not a JSON line - skip */
+            }
+        }
+        if (sawEvent && texts.length)
+            return texts.join('');
+    }
+    // Single JSON object.
+    try {
+        const obj = JSON.parse(trimmed);
+        return parseObjectReply(obj);
+    }
+    catch {
+        /* not JSON */
+    }
+    return null;
+}
+/**
+ * Extract the plain-text reply for a harness. `structured` mirrors the
+ * adapter's `structuredOutput` flag; plain-text harnesses pass through.
+ */
+function parseHarnessOutput(structured, raw) {
+    const trimmed = raw.trim();
+    if (!structured)
+        return trimmed;
+    const extracted = tryExtractStructuredReply(trimmed);
+    return extracted !== null ? extracted : trimmed;
+}
+//# sourceMappingURL=harness-output.js.map

package/dist/lib/harness-output.js.map

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

package/dist/lib/harness.d.ts

@@ -2,6 +2,15 @@ export interface HarnessRunOptions {
     maxBuffer?: number;
     /** Hard kill ceiling for TTY-routed runs (agy); minutes. */
     timeoutMin?: number;
+    /** Working directory the harness runs in (must match the MCP config cwd). */
+    cwd?: string;
+    /** Extra env for the child (TTY path only; piped path merges via adapter). */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Route through a pseudo-terminal when the harness gates stdout on isatty
+     * (mirrors the adapter's `needsTty`). When false, always piped.
+     */
+    needsTty?: boolean;
     /**
      * Agent API key injected into a per-session opencode config so the
      * teamshare MCP server authenticates as THIS agent (never the global
@@ -12,6 +21,8 @@ export interface HarnessRunOptions {
     opencodeMcpUrl?: string;
     /** Session mode header for the MCP override ('run' | 'build' | 'chat' | 'doc'). */
     opencodeSessionMode?: string;
+    /** TTY runs only: per-line transcript tap (tee agy output into session logs). */
+    onLine?: (line: string) => void;
 }
 export interface ResolvedBin {
     file: string;
@@ -41,8 +52,8 @@ export declare function writeOpencodeMcpConfig(agentKey: string, apiBaseUrl: str
 export declare function runHarness(cmd: string, args: string[], opts?: HarnessRunOptions): string;
 export declare function hasBin(bin: string): boolean;
 /**
- * runHarness variant for TTY-gated harnesses (antigravity / `agy`): routes
- * the run through a pseudo-terminal so its isatty-gated stdout actually
+ * runHarness variant for TTY-gated harnesses (adapter `needsTty: true`):
+ * routes the run through a pseudo-terminal so its isatty-gated stdout actually
  * emits, and returns the cleaned transcript as the reply text. Every other
  * binary keeps the plain piped path. Chat/doc callers should prefer this.
  */

package/dist/lib/harness.js

@@ -32,6 +32,32 @@ function whereShim(bin) {
         .find((s) => /\.(cmd|bat|ps1)$/i.test(s));
     return line ?? null;
 }
+/** All absolute PATH hits for a command (where.exe), trimmed + non-empty. */
+function whereAll(bin) {
+    if (process.platform !== 'win32')
+        return [];
+    const res = (0, node_child_process_1.spawnSync)('where', [bin], { encoding: 'utf8' });
+    if (res.status !== 0)
+        return [];
+    return (res.stdout ?? '')
+        .split(/\r?\n/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/** Extracts the real executable target from an npm .cmd/.bat/.ps1 shim. */
+function fromShim(shimPath) {
+    const text = (0, node_fs_1.readFileSync)(shimPath, 'utf8');
+    const match = text.match(/"([^"]+\.(?:exe|js))"/i);
+    if (!match)
+        return null;
+    const expanded = expand(match[1], (0, node_path_1.dirname)(shimPath));
+    const file = (0, node_path_1.isAbsolute)(expanded) ? expanded : (0, node_path_1.join)((0, node_path_1.dirname)(shimPath), expanded);
+    if (!(0, node_fs_1.existsSync)(file))
+        return null;
+    if (/\.exe$/i.test(file))
+        return { file };
+    return { file: process.execPath, args: [file] };
+}
 /** Expands shim placeholders (%dp0%, %~dp0%, %basedir%, $basedir, $PSScriptRoot). */
 function expand(target, shimDir) {
     return target
@@ -39,6 +65,30 @@ function expand(target, shimDir) {
         .replace(/%\w+%/g, '')
         .trim();
 }
+/**
+ * Well-known install dirs per binary (IMP-9xx): CLI installers often update
+ * the registry PATH for FUTURE shells only - a long-lived daemon keeps its
+ * spawn-time env forever, so `where` misses freshly installed tools. These
+ * fallbacks let resolution still succeed without a daemon restart.
+ */
+const KNOWN_INSTALL_DIRS = {
+    codex: ['%LOCALAPPDATA%\\Programs\\OpenAI\\Codex\\bin'],
+    agy: ['%LOCALAPPDATA%\\agy\\bin'],
+};
+function fromKnownDirs(bin) {
+    const dirs = KNOWN_INSTALL_DIRS[bin];
+    if (!dirs)
+        return null;
+    for (const raw of dirs) {
+        const dir = raw.replace(/%([^%]+)%/g, (_, k) => process.env[k] ?? '');
+        for (const name of [`${bin}.exe`, bin]) {
+            const file = (0, node_path_1.join)(dir, name);
+            if ((0, node_fs_1.existsSync)(file))
+                return { file };
+        }
+    }
+    return null;
+}
 /**
  * Resolves a PATH command to something Node can spawn without a shell.
  * Windows npm shims (opencode.cmd / opencode.ps1, claude.cmd) cannot be
@@ -47,22 +97,33 @@ function expand(target, shimDir) {
  * run via node) is extracted from the shim file instead.
  */
 function resolveBin(bin) {
-    if (tryExec(bin, ['--version']))
+    if (tryExec(bin, ['--version'])) {
+        // IMP-9xx: bare names break node-pty - ConPTY cannot PATH/PATHEXT
+        // resolve, it fails with the opaque "File not found: ". When an
+        // absolute executable exists on PATH, prefer it so TTY runs work.
+        if ((0, node_path_1.isAbsolute)(bin))
+            return { file: bin };
+        for (const line of whereAll(bin)) {
+            if (/\.(exe|js)$/i.test(line) && (0, node_fs_1.existsSync)(line)) {
+                return /\.exe$/i.test(line) ? { file: line } : { file: process.execPath, args: [line] };
+            }
+            if (/\.(cmd|bat|ps1)$/i.test(line)) {
+                const fromShimResult = fromShim(line);
+                if (fromShimResult)
+                    return fromShimResult;
+            }
+        }
         return { file: bin };
+    }
     const shim = whereShim(bin);
-    if (!shim)
-        return null;
-    const text = (0, node_fs_1.readFileSync)(shim, 'utf8');
-    const match = text.match(/"([^"]+\.(?:exe|js))"/i);
-    if (!match)
-        return null;
-    const expanded = expand(match[1], (0, node_path_1.dirname)(shim));
-    const file = (0, node_path_1.isAbsolute)(expanded) ? expanded : (0, node_path_1.join)((0, node_path_1.dirname)(shim), expanded);
-    if (!(0, node_fs_1.existsSync)(file))
-        return null;
-    if (/\.exe$/i.test(file))
-        return { file };
-    return { file: process.execPath, args: [file] };
+    if (shim) {
+        const fromShimResult = fromShim(shim);
+        if (fromShimResult)
+            return fromShimResult;
+    }
+    // Fresh install the daemon's PATH can't see yet - try known dirs before
+    // giving up so users don't need to restart the daemon after installs.
+    return fromKnownDirs(bin);
 }
 /**
  * Writes a throwaway opencode config that overrides the teamshare MCP
@@ -124,6 +185,7 @@ function runHarness(cmd, args, opts = {}) {
         const out = (0, node_child_process_1.execFileSync)(bin.file, [...(bin.args ?? []), ...args], {
             encoding: 'utf8',
             maxBuffer: opts.maxBuffer ?? 2 * 1024 * 1024,
+            cwd: opts.cwd,
             env: mcpEnv ? { ...process.env, ...mcpEnv.env } : undefined,
         });
         return out.trim();
@@ -142,28 +204,50 @@ function runHarness(cmd, args, opts = {}) {
 function hasBin(bin) {
     return resolveBin(bin) !== null;
 }
+let ptyWarned = false;
 /**
- * runHarness variant for TTY-gated harnesses (antigravity / `agy`): routes
- * the run through a pseudo-terminal so its isatty-gated stdout actually
+ * runHarness variant for TTY-gated harnesses (adapter `needsTty: true`):
+ * routes the run through a pseudo-terminal so its isatty-gated stdout actually
  * emits, and returns the cleaned transcript as the reply text. Every other
  * binary keeps the plain piped path. Chat/doc callers should prefer this.
  */
 async function runHarnessTtyAware(cmd, args, opts = {}) {
-    if (cmd !== 'agy' || !(0, agy_pty_1.ptyAvailable)())
+    if (!opts.needsTty)
+        return runHarness(cmd, args, opts);
+    if (!(0, agy_pty_1.ptyAvailable)()) {
+        // IMP-9xx: npm 11's allow-scripts blocks node-pty's install scripts by
+        // default, so its native build may be missing. This used to surface as a
+        // confusing silent empty reply - explain the one-time fix instead.
+        if (!ptyWarned) {
+            ptyWarned = true;
+            console.warn('[harness] TTY-gated harness requested but node-pty is unavailable ' +
+                '(npm blocked its install scripts). Piped fallback in use; if the ' +
+                'harness needs a TTY, run: npm i -g --allow-scripts=node-pty teamshare-bridge ' +
+                '(or: npm config set allow-scripts=node-pty --location=user)');
+        }
         return runHarness(cmd, args, opts);
+    }
     const bin = resolveBin(cmd);
     if (!bin)
         throw new Error(`No harness found (install ${cmd})`);
     const res = await (0, agy_pty_1.runAgyPty)({
         file: bin.file,
         args: [...(bin.args ?? []), ...args],
+        cwd: opts.cwd,
+        env: opts.env,
         timeoutMin: opts.timeoutMin ?? 10,
+        // IMP-9xx: tee the transcript into the session log - TTY runs used to
+        // leave 0-byte capture files, making failures undiagnosable.
+        onLine: opts.onLine,
     });
     const text = res.output.trim();
     if (res.code === 124)
         throw new Error('agy timed out (session cap)');
-    if (res.code !== 0 && !text)
-        throw new Error(`agy exited with code ${res.code}`);
+    if (res.code !== 0) {
+        // IMP-9xx: a non-zero exit is NEVER a successful reply, even when agy
+        // printed something (it prints errors on stdout too).
+        throw new Error(`agy exited with code ${res.code}: ${text ? text.slice(-400) : '(no output)'}`);
+    }
     return text;
 }
 //# sourceMappingURL=harness.js.map

package/dist/lib/harness.js.map

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

package/dist/lib/llm.d.ts

@@ -63,6 +63,17 @@ export declare function runLlmSession(api: TeamshareApi, taskId: string, brief:
  * Returns the final reply text.
  */
 export declare function runProjectSession(api: TeamshareApi, projectId: string, prompt: string, opts: LlmOptions, projectName?: string): Promise<string>;
+/**
+ * Document-assistant self-mode session (IMP-9xx): identical tool loop to
+ * {@link runProjectSession} but framed around ONE document. Lets a doc
+ * comment mention trigger real actions (create_task, add_comment, search…)
+ * even without an installed harness - parity with what the harness path
+ * gets through the per-session MCP config.
+ */
+export declare function runDocumentSession(api: TeamshareApi, ctx: {
+    projectId: string;
+    documentId: string;
+}, prompt: string, opts: LlmOptions): Promise<string>;
 /**
  * Single-shot chat completion (no tools) - used by the chat-reply loop to
  * draft a reply to a mention and by the run-report writer. Same env

package/dist/lib/llm.js

@@ -4,6 +4,7 @@ exports.QUESTION_MARKER = exports.DEFAULT_LLM_MODEL = exports.DEFAULT_LLM_BASE_U
 exports.buildTools = buildTools;
 exports.runLlmSession = runLlmSession;
 exports.runProjectSession = runProjectSession;
+exports.runDocumentSession = runDocumentSession;
 exports.complete = complete;
 exports.completeStream = completeStream;
 /**
@@ -587,10 +588,6 @@ async function runLlmSession(api, taskId, brief, opts, projectId) {
  * Returns the final reply text.
  */
 async function runProjectSession(api, projectId, prompt, opts, projectName) {
-    const tools = buildTools(api, {
-        defaultProjectId: projectId,
-        agentUserId: opts.agentUserId,
-    });
     const projectLabel = projectName ? `"${projectName}" (${projectId})` : projectId;
     const systemBase = `You are ${opts.agentName}, a TeamShare project assistant for project ${projectLabel}. ` +
         (opts.systemPrompt ? `${opts.systemPrompt}\n\n` : '') +
@@ -611,6 +608,39 @@ async function runProjectSession(api, projectId, prompt, opts, projectName) {
         'Never mention local folder names or repo names (e.g. teamshare-bridge, frontend, teamshare-backend). ' +
         'If the person asks about code work, mention tasks or documents in TeamShare, not local folders. ' +
         'Reply concisely in plain text; keep it under 4000 characters.';
+    return runToolLoop(api, projectId, systemBase, prompt, opts);
+}
+/**
+ * Document-assistant self-mode session (IMP-9xx): identical tool loop to
+ * {@link runProjectSession} but framed around ONE document. Lets a doc
+ * comment mention trigger real actions (create_task, add_comment, search…)
+ * even without an installed harness - parity with what the harness path
+ * gets through the per-session MCP config.
+ */
+async function runDocumentSession(api, ctx, prompt, opts) {
+    const systemBase = `You are ${opts.agentName}, a TeamShare document assistant replying inside the comment thread of document ${ctx.documentId}. ` +
+        (opts.systemPrompt ? `${opts.systemPrompt}\n\n` : '') +
+        'The user prompt already contains the document content and thread - answer from it directly. ' +
+        `create_task, create_document and add_comment are PINNED to this document's project (${ctx.projectId}) - ` +
+        'any projectId you might pass is ignored in favor of it. ' +
+        'Only ever claim you created/updated something if a tool actually returned it - if a tool errors, say so honestly. ' +
+        (opts.agentUserId
+            ? `Your TeamShare user id is ${opts.agentUserId}.\n`
+            : '') +
+        'You have tools: get_project, list_tasks, get_task, create_task, update_task, ' +
+        'add_comment, list_documents, read_document, create_document, update_document_note, search, ' +
+        'ask_human, list_subtasks, create_subtask, update_subtask, create_checklist_item, update_checklist_item, delete_checklist_item. ' +
+        'If the comment asks you to do something actionable, use the appropriate tool instead of only describing it. ' +
+        'Be direct and structured: open with the answer itself, then short bullets where helpful. No filler, no hedging. ' +
+        'Keep the reply SHORT - under 150 words, plain text only; this is a document comment thread, not a report (hard cap 4000 characters).';
+    return runToolLoop(api, ctx.projectId, systemBase, prompt, opts);
+}
+/** Shared pinned-project tool loop behind both session flavors. */
+async function runToolLoop(api, defaultProjectId, systemBase, prompt, opts) {
+    const tools = buildTools(api, {
+        defaultProjectId,
+        agentUserId: opts.agentUserId,
+    });
     const messages = [
         { role: 'system', content: systemBase },
         { role: 'user', content: prompt },