teamshare-bridge 0.1.0

package/dist/lib/chat-reply.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runChatReply = runChatReply;
+/**
+ * Agent chat-reply loop (`teamshare-agent chat`): reads the recent project
+ * channel and replies to EVERY message that mentions the agent, separately.
+ * Generation uses the configured harness (opencode `run` / `claude -p`,
+ * non-interactive, stdout captured) or the `--self` LLM completion.
+ * Phase C (IMP-530): `--self` replies stream token-by-token into the
+ * channel as `message:partial` frames when a stream socket is provided;
+ * the final message is still posted via POST /chat/messages.
+ */
+const node_child_process_1 = require("node:child_process");
+const llm_1 = require("./llm");
+const partial_stream_1 = require("./partial-stream");
+const MAX_TARGETS = 10;
+const CONTEXT_WINDOW = 10;
+function hasBin(bin) {
+    try {
+        (0, node_child_process_1.execFileSync)(bin, ['--version'], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Generates a reply via the harness (non-interactive) or headless LLM. */
+async function generateReply(agentName, target, prompt, opts, onToken) {
+    if (opts.echo) {
+        const reply = `@${target.author?.name ?? 'there'} — this is an automated acknowledgment from ${agentName}. I saw your message and I'm on it.`;
+        if (onToken)
+            onToken(reply);
+        return reply;
+    }
+    if (opts.selfMode || opts.harness === 'none') {
+        if (!opts.llm?.apiKey) {
+            throw new Error('--self / --harness none requires LLM_API_KEY (and optionally LLM_BASE_URL / LLM_MODEL)');
+        }
+        // Phase C: stream the completion when the caller provided a stream socket.
+        if (onToken) {
+            return (0, llm_1.completeStream)(prompt, opts.llm, onToken);
+        }
+        return (0, llm_1.complete)(prompt, opts.llm);
+    }
+    if (opts.harness === 'opencode' || (opts.harness === 'auto' && hasBin('opencode'))) {
+        return (0, node_child_process_1.execFileSync)('opencode', ['run', prompt], {
+            encoding: 'utf8',
+            maxBuffer: 2 * 1024 * 1024,
+        }).trim();
+    }
+    if (opts.harness === 'claude' || (opts.harness === 'auto' && hasBin('claude'))) {
+        return (0, node_child_process_1.execFileSync)('claude', ['-p', prompt], {
+            encoding: 'utf8',
+            maxBuffer: 2 * 1024 * 1024,
+        }).trim();
+    }
+    throw new Error('No harness found (install opencode or claude, or use --self with LLM_API_KEY)');
+}
+function mentionPrompt(agentName, target, context) {
+    const lines = context
+        .map((m) => `[${m.createdAt}] ${m.author?.name ?? '?'}: ${m.body}`)
+        .join('\n');
+    return [
+        `You are ${agentName}, a TeamShare project assistant. The project chat looks like this:`,
+        '',
+        lines,
+        '',
+        `The latest message mentions you (@${agentName}):`,
+        '',
+        `[${target.createdAt}] ${target.author?.name ?? 'someone'}: ${target.body}`,
+        '',
+        'Reply to that message directly. Address the person by name if known. Be concise and useful.',
+    ].join('\n');
+}
+/**
+ * Runs the chat reply loop. Heartbeats working/online around the work and
+ * posts one reply per mentioning message (in chronological order).
+ */
+async function runChatReply(api, agentId, projectId, mentionToken, opts) {
+    const token = mentionToken.replace(/^@/, '').toLowerCase();
+    const selfName = mentionToken.replace(/^@/, '');
+    const page = await api.listChatMessages(projectId, 1, 50);
+    const rows = [...(page ?? [])].sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+    if (!rows.length)
+        return { replied: 0, skipped: 0 };
+    // Every message that mentions the agent, excluding messages the agent
+    // itself authored (its own replies mention other people, not itself).
+    const targets = rows.filter((m) => {
+        const mentionsAgent = m.body.toLowerCase().includes(`@${token}`);
+        const isAgent = m.author?.kind === 'agent' ||
+            (m.author?.name ?? '').toLowerCase() === selfName.toLowerCase();
+        return mentionsAgent && !isAgent;
+    });
+    if (!targets.length)
+        return { replied: 0, skipped: 0 };
+    let replied = 0;
+    for (const target of targets.slice(0, MAX_TARGETS)) {
+        const targetIndex = rows.findIndex((r) => r.id === target.id);
+        const context = rows.slice(Math.max(0, targetIndex - CONTEXT_WINDOW), targetIndex + 1);
+        const prompt = mentionPrompt(selfName, target, context);
+        // Phase C: open a partial stream per target when configured (streaming
+        // is best-effort - failures fall back to the plain final post).
+        const draftId = `draft_${target.id}`;
+        let stream = null;
+        if (opts.stream && (opts.selfMode || opts.harness === 'none' || opts.echo)) {
+            stream = new partial_stream_1.PartialStream({
+                wsBase: opts.stream.wsBase,
+                apiKey: opts.stream.apiKey,
+                projectId: opts.stream.projectId,
+                channelId: opts.stream.channelId,
+            }, draftId);
+            stream.connect();
+        }
+        const reply = await generateReply(selfName, target, prompt, opts, (delta) => stream?.token(delta));
+        if (!reply) {
+            stream?.end();
+            continue;
+        }
+        const posted = await api.postChatMessage(projectId, reply);
+        stream?.end(posted?.id ??
+            posted?.message?.id);
+        replied += 1;
+    }
+    return { replied, skipped: targets.length - replied };
+}
+//# sourceMappingURL=chat-reply.js.map

package/dist/lib/chat-reply.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,25 @@
+/** Ports the website probes to detect the bridge (contract section 5). */
+export declare const BRIDGE_CANDIDATE_PORTS: readonly [48231, 48242, 48253, 48264, 48275, 48286, 48297];
+export interface AgentConfig {
+    agentId: string;
+    apiKey: string;
+}
+export interface BridgeConfig {
+    agents: AgentConfig[];
+    port: number;
+    harness: 'auto' | 'opencode' | 'claude' | 'none';
+    quietHours: {
+        start: string;
+        end: string;
+    } | null;
+    wakeRules: {
+        priorities: string[];
+    } | null;
+}
+export declare function configPath(): string;
+export declare function defaultConfig(): BridgeConfig;
+export declare function loadConfig(): BridgeConfig;
+export declare function saveConfig(config: BridgeConfig): void;
+/** Adds/updates an agent key entry (used by `connect` and `add-agent`). */
+export declare function upsertAgent(agentId: string, apiKey: string): BridgeConfig;
+export declare function msg(err: unknown): string;

package/dist/lib/config.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRIDGE_CANDIDATE_PORTS = void 0;
+exports.configPath = configPath;
+exports.defaultConfig = defaultConfig;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.upsertAgent = upsertAgent;
+exports.msg = msg;
+/**
+ * teamshare-bridge config: ~/.teamshare/config.json
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+/** Ports the website probes to detect the bridge (contract section 5). */
+exports.BRIDGE_CANDIDATE_PORTS = [
+    48231, 48242, 48253, 48264, 48275, 48286, 48297,
+];
+const CONFIG_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare');
+const CONFIG_PATH = (0, node_path_1.join)(CONFIG_DIR, 'config.json');
+function configPath() {
+    return CONFIG_PATH;
+}
+function defaultConfig() {
+    const pick = exports.BRIDGE_CANDIDATE_PORTS[Math.floor(Math.random() * exports.BRIDGE_CANDIDATE_PORTS.length)];
+    return {
+        agents: [],
+        port: pick,
+        harness: 'auto',
+        quietHours: null,
+        wakeRules: null,
+    };
+}
+function loadConfig() {
+    try {
+        if ((0, node_fs_1.existsSync)(CONFIG_PATH)) {
+            const raw = JSON.parse((0, node_fs_1.readFileSync)(CONFIG_PATH, 'utf8'));
+            const def = defaultConfig();
+            return {
+                agents: Array.isArray(raw.agents) ? raw.agents : [],
+                port: typeof raw.port === 'number' && Number.isInteger(raw.port)
+                    ? raw.port
+                    : def.port,
+                harness: raw.harness ?? def.harness,
+                quietHours: raw.quietHours ?? null,
+                wakeRules: raw.wakeRules ?? null,
+            };
+        }
+    }
+    catch (err) {
+        console.warn(`[config] failed to read ${CONFIG_PATH}: ${msg(err)}`);
+    }
+    const def = defaultConfig();
+    saveConfig(def);
+    return def;
+}
+function saveConfig(config) {
+    try {
+        (0, node_fs_1.mkdirSync)(CONFIG_DIR, { recursive: true });
+        (0, node_fs_1.writeFileSync)(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf8');
+    }
+    catch (err) {
+        console.warn(`[config] failed to write ${CONFIG_PATH}: ${msg(err)}`);
+    }
+}
+/** Adds/updates an agent key entry (used by `connect` and `add-agent`). */
+function upsertAgent(agentId, apiKey) {
+    const config = loadConfig();
+    const existing = config.agents.find((a) => a.agentId === agentId);
+    if (existing)
+        existing.apiKey = apiKey;
+    else
+        config.agents.push({ agentId, apiKey });
+    saveConfig(config);
+    return config;
+}
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/doc-reply.d.ts

@@ -0,0 +1,22 @@
+import { TeamshareApi } from './api';
+export interface DocReplyOptions {
+    harness: 'auto' | 'opencode' | 'claude' | 'none';
+    selfMode: boolean;
+    llm?: {
+        baseUrl: string;
+        apiKey: string;
+        model: string;
+        temperature?: number;
+        maxTokens?: number;
+    };
+    /** Debug/testing switch (TS_CHAT_ECHO=1): post canned acknowledgments. */
+    echo?: boolean;
+}
+/**
+ * Runs the document reply loop: fetch the document + extract, find comments
+ * mentioning the agent, reply to each (one per comment, chronological).
+ */
+export declare function runDocReply(api: TeamshareApi, agentId: string, documentId: string, mentionToken: string, opts: DocReplyOptions): Promise<{
+    replied: number;
+    skipped: number;
+}>;

package/dist/lib/doc-reply.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDocReply = runDocReply;
+/**
+ * Phase F document assistant (`teamshare-agent doc`): reads a document's
+ * extracted text (Word/PPT/Excel/PDF) plus its comment thread, and replies
+ * to every comment that @mentions the agent. The reply quotes the relevant
+ * context - the document text is included in the prompt so the model can
+ * answer questions about the document content.
+ */
+const node_child_process_1 = require("node:child_process");
+const llm_1 = require("./llm");
+const MAX_TARGETS = 10;
+const CONTEXT_WINDOW = 10;
+const MAX_DOC_CHARS = 60_000;
+function hasBin(bin) {
+    try {
+        (0, node_child_process_1.execFileSync)(bin, ['--version'], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function generateReply(agentName, target, prompt, opts) {
+    if (opts.echo) {
+        return Promise.resolve(`@${target.author?.name ?? 'there'} — this is an automated acknowledgment from ${agentName}. I read the document and I'm on it.`);
+    }
+    if (opts.selfMode || opts.harness === 'none') {
+        if (!opts.llm?.apiKey) {
+            throw new Error('--self / --harness none requires LLM_API_KEY (and optionally LLM_BASE_URL / LLM_MODEL)');
+        }
+        return (0, llm_1.complete)(prompt, opts.llm);
+    }
+    if (opts.harness === 'opencode' || (opts.harness === 'auto' && hasBin('opencode'))) {
+        return Promise.resolve((0, node_child_process_1.execFileSync)('opencode', ['run', prompt], {
+            encoding: 'utf8',
+            maxBuffer: 2 * 1024 * 1024,
+        }).trim());
+    }
+    if (opts.harness === 'claude' || (opts.harness === 'auto' && hasBin('claude'))) {
+        return Promise.resolve((0, node_child_process_1.execFileSync)('claude', ['-p', prompt], {
+            encoding: 'utf8',
+            maxBuffer: 2 * 1024 * 1024,
+        }).trim());
+    }
+    throw new Error('No harness found (install opencode or claude, or use --self with LLM_API_KEY)');
+}
+function docPrompt(agentName, docName, docText, target, context) {
+    const thread = context
+        .map((c) => `[${c.createdAt}] ${c.author?.name ?? '?'}: ${c.body}`)
+        .join('\n');
+    return [
+        `You are ${agentName}, a TeamShare document assistant. The document "${docName}" contains:`,
+        '',
+        '--- DOCUMENT CONTENT ---',
+        docText.slice(0, MAX_DOC_CHARS),
+        docText.length > MAX_DOC_CHARS ? '\n…[truncated]' : '',
+        '--- END DOCUMENT CONTENT ---',
+        '',
+        'The document comment thread looks like this:',
+        '',
+        thread,
+        '',
+        `The latest comment mentions you (@${agentName}):`,
+        '',
+        `[${target.createdAt}] ${target.author?.name ?? 'someone'}: ${target.body}`,
+        '',
+        'Answer that comment directly, based on the document content. Address the person by name if known. Be concise and useful; quote the document where helpful.',
+    ]
+        .filter((line) => line !== '')
+        .join('\n');
+}
+/**
+ * Runs the document reply loop: fetch the document + extract, find comments
+ * mentioning the agent, reply to each (one per comment, chronological).
+ */
+async function runDocReply(api, agentId, documentId, mentionToken, opts) {
+    const token = mentionToken.replace(/^@/, '').toLowerCase();
+    const selfName = mentionToken.replace(/^@/, '');
+    const [doc, docExtract] = await Promise.all([
+        api.getDocument(documentId),
+        api.getDocumentExtract(documentId).catch(() => null),
+    ]);
+    const docText = docExtract?.text ?? '(no extractable text - link document or unsupported file)';
+    const rows = await api.listDocumentComments(documentId);
+    const targets = rows.filter((c) => {
+        const mentionsAgent = c.body.toLowerCase().includes(`@${token}`);
+        const isAgent = c.author?.kind === 'agent' ||
+            (c.author?.name ?? '').toLowerCase() === selfName.toLowerCase();
+        return mentionsAgent && !isAgent;
+    });
+    if (!targets.length)
+        return { replied: 0, skipped: 0 };
+    let replied = 0;
+    for (const target of targets.slice(0, MAX_TARGETS)) {
+        const targetIndex = rows.findIndex((r) => r.id === target.id);
+        const context = rows.slice(Math.max(0, targetIndex - CONTEXT_WINDOW), targetIndex + 1);
+        const prompt = docPrompt(selfName, doc.name, docText, target, context);
+        const reply = await generateReply(selfName, target, prompt, opts);
+        if (!reply)
+            continue;
+        await api.addComment({ documentId, body: reply });
+        replied += 1;
+    }
+    return { replied, skipped: targets.length - replied };
+}
+//# sourceMappingURL=doc-reply.js.map

package/dist/lib/doc-reply.js.map

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

package/dist/lib/llm.d.ts

@@ -0,0 +1,50 @@
+import { TeamshareApi } from './api';
+export declare const DEFAULT_LLM_BASE_URL = "https://api.openai.com/v1";
+export declare const DEFAULT_LLM_MODEL = "deepseek-chat";
+interface ToolDef {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface LlmResult {
+    summary: string;
+    iterations: number;
+    tokensUsed: number;
+    finishedBy: 'no-tool-call' | 'max-iterations' | 'task-done';
+}
+export interface LlmOptions {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    agentName: string;
+    systemPrompt?: string | null;
+    /** Sampling temperature (0-2). Default 0.2 (Phase D). */
+    temperature?: number;
+    /** Token budget for the completion (Phase D). */
+    maxTokens?: number;
+    /** Resume a previous --self session for this task (Phase E, IMP-540). */
+    continue?: boolean;
+}
+/**
+ * Phase B ask-human (IMP-530): markers + polling for the `--self` loop.
+ * The MCP server implements the same contract for opencode sessions.
+ */
+export declare const QUESTION_MARKER = "[question]";
+export declare function buildTools(api: TeamshareApi, askTimeoutMsOverride?: number): {
+    def: ToolDef;
+    run: (args: Record<string, unknown>) => Promise<unknown>;
+}[];
+export declare function runLlmSession(api: TeamshareApi, taskId: string, brief: string, opts: LlmOptions): Promise<LlmResult>;
+/**
+ * Single-shot chat completion (no tools) - used by the chat-reply loop to
+ * draft a reply to a mention. Same env contract as `--self`.
+ */
+export declare function complete(prompt: string, opts: Pick<LlmOptions, 'baseUrl' | 'apiKey' | 'model' | 'temperature' | 'maxTokens'>): Promise<string>;
+/**
+ * Phase C streaming (IMP-530): OpenAI-compatible SSE `chat/completions`
+ * (stream: true). Calls `onToken` with each content delta as it arrives;
+ * resolves with the full trimmed reply. Works with any OpenAI-compatible
+ * provider (Gemini, DeepSeek, OpenAI, Groq, OpenRouter, Mistral).
+ */
+export declare function completeStream(prompt: string, opts: Pick<LlmOptions, 'baseUrl' | 'apiKey' | 'model' | 'temperature' | 'maxTokens'>, onToken: (delta: string) => void): Promise<string>;
+export {};