teamshare-bridge 0.1.0

package/dist/lib/api.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Typed REST client for the TeamShare API (contract: docs/agent-tasks/
+ * agent-hub-connection.md). Envelope-aware, retrying, timeout-bound.
+ */
+import { AgentConfig } from './config';
+export declare const DEFAULT_API_URL = "http://localhost:4000/api";
+export declare class ApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details: unknown;
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+export declare class TeamshareApi {
+    readonly baseUrl: string;
+    readonly apiKey?: string | undefined;
+    constructor(baseUrl?: string, apiKey?: string | undefined);
+    /** Reuses a config agent's credentials. */
+    static forAgent(baseUrl: string, agent: AgentConfig): TeamshareApi;
+    private request;
+    heartbeat(agentId: string, status: 'online' | 'working' | 'offline', taskId?: string, sessionId?: string): Promise<unknown>;
+    inbox(agentId: string): Promise<{
+        tasks: Array<Record<string, unknown>>;
+        comments: Array<Record<string, unknown>>;
+        mentions: Array<Record<string, unknown>>;
+        chat: Array<Record<string, unknown>>;
+    }>;
+    mintRunToken(agentId: string, taskId?: string): Promise<{
+        token: string;
+        expiresAt: string;
+    }>;
+    redeemRunToken(runToken: string, taskId?: string): Promise<{
+        wsToken: string;
+        agentId: string;
+        scopes: string[];
+        settings?: {
+            model?: string | null;
+            temperature?: number | null;
+            maxTokens?: number | null;
+            systemPrompt?: string | null;
+        };
+    }>;
+    getTask(taskId: string): Promise<Task>;
+    listTasks(params: {
+        projectId?: string;
+        status?: string;
+        assigneeId?: string;
+        page?: number;
+        pageSize?: number;
+    }): Promise<Task[]>;
+    createTask(dto: {
+        projectId: string;
+        title: string;
+        description?: string;
+        status?: string;
+        priority?: string;
+        assigneeId?: string;
+        dueDate?: string;
+        tags?: string[];
+    }): Promise<Task>;
+    updateTask(taskId: string, dto: Record<string, unknown>): Promise<Task>;
+    listComments(taskId: string): Promise<Comment[]>;
+    /** Subtask tree of a task (nested, each node with checklist items). */
+    listSubtasks(taskId: string): Promise<SubtaskNode[]>;
+    createSubtask(dto: {
+        taskId: string;
+        title: string;
+        parentId?: string | null;
+        assigneeId?: string | null;
+        dueDate?: string | null;
+    }): Promise<SubtaskNode>;
+    /** Mark done / reopen, rename, reassign, move or re-due a subtask. */
+    updateSubtask(subtaskId: string, dto: Record<string, unknown>): Promise<SubtaskNode>; /** Document comment thread (Phase F document assistant). */
+    listDocumentComments(documentId: string): Promise<Comment[]>;
+    addComment(dto: {
+        taskId?: string;
+        documentId?: string;
+        body: string;
+    }): Promise<Comment>;
+    getProject(projectId: string): Promise<{
+        id: string;
+        name: string;
+        status: string;
+    }>;
+    listDocuments(projectId: string): Promise<Document[]>;
+    getDocument(documentId: string): Promise<{
+        id: string;
+        type: 'link' | 'file';
+        name: string;
+        urlOrKey?: string | null;
+        projectId: string;
+        mime?: string | null;
+        createdAt: string;
+    }>;
+    /** Phase F: extracted text for office/PDF documents. */
+    getDocumentExtract(documentId: string): Promise<{
+        text: string;
+        truncated: boolean;
+        format: string;
+        cached: boolean;
+    }>;
+    /**
+     * Downloads a document. Link docs return { url }; local files return plain
+     * text; Cloudinary-hosted files return { url } (fetchable by the caller).
+     */
+    getDocumentContent(doc: Document): Promise<string>;
+    search(q: string, type?: string): Promise<Array<Record<string, unknown>>>;
+    listChatMessages(projectId: string, page?: number, pageSize?: number): Promise<Array<{
+        id: string;
+        projectId: string;
+        authorId: string;
+        body: string;
+        createdAt: string;
+        author?: {
+            id: string;
+            name: string;
+            kind?: string;
+        } | null;
+    }>>;
+    postChatMessage(projectId: string, body: string): Promise<Record<string, unknown>>;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string | null;
+    status: string;
+    priority: string;
+    projectId: string;
+    assigneeId?: string | null;
+    dueDate?: string | null;
+    tags?: string[];
+    createdAt: string;
+    updatedAt?: string;
+    project?: {
+        id: string;
+        name: string;
+    } | null;
+    comments?: Comment[];
+}
+export interface Comment {
+    id: string;
+    taskId?: string | null;
+    documentId?: string | null;
+    body: string;
+    author?: {
+        id: string;
+        name: string;
+        kind?: string;
+    } | null;
+    authorId?: string;
+    createdAt: string;
+}
+export interface ChecklistItemRow {
+    id: string;
+    title: string;
+    done: boolean;
+    sortOrder?: number;
+}
+export interface SubtaskNode {
+    id: string;
+    taskId: string;
+    parentId?: string | null;
+    title: string;
+    done: boolean;
+    assigneeId?: string | null;
+    dueDate?: string | null;
+    sortOrder: number;
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+    assignee?: {
+        id: string;
+        name: string;
+        kind?: string;
+    } | null;
+    creator?: {
+        id: string;
+        name: string;
+        kind?: string;
+    } | null;
+    children?: SubtaskNode[];
+    checklistItems?: ChecklistItemRow[];
+}
+export interface Document {
+    id: string;
+    projectId: string;
+    type: 'link' | 'file';
+    urlOrKey: string;
+    name: string;
+    mime?: string | null;
+    createdAt: string;
+}

package/dist/lib/api.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamshareApi = exports.ApiError = exports.DEFAULT_API_URL = void 0;
+exports.DEFAULT_API_URL = 'http://localhost:4000/api';
+class ApiError extends Error {
+    code;
+    status;
+    details;
+    constructor(code, message, status, details) {
+        super(message);
+        this.name = 'ApiError';
+        this.code = code;
+        this.status = status;
+        this.details = details;
+    }
+}
+exports.ApiError = ApiError;
+const TIMEOUT_MS = 15_000;
+const MAX_RETRIES = 2;
+class TeamshareApi {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl = process.env.TEAMSHARE_API_URL ?? exports.DEFAULT_API_URL, apiKey) {
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+    }
+    /** Reuses a config agent's credentials. */
+    static forAgent(baseUrl, agent) {
+        return new TeamshareApi(baseUrl, agent.apiKey);
+    }
+    async request(path, init = {}, retries = MAX_RETRIES) {
+        const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'User-Agent': 'teamshare-bridge/0.1',
+            ...init.headers,
+        };
+        if (this.apiKey)
+            headers['X-Api-Key'] = this.apiKey;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        try {
+            const res = await fetch(url, {
+                ...init,
+                headers,
+                signal: controller.signal,
+            });
+            const raw = (await res.json().catch(() => null));
+            if (!raw) {
+                throw new ApiError('INVALID_RESPONSE', `non-JSON response (${res.status})`, res.status);
+            }
+            if (!res.ok || raw.success === false) {
+                const err = raw.error ?? { code: 'HTTP_' + res.status, message: `HTTP ${res.status}` };
+                throw new ApiError(err.code, err.message, res.status, err.details);
+            }
+            return raw.data;
+        }
+        catch (err) {
+            if (retries > 0 && isRetryable(err)) {
+                await sleep(500 * (MAX_RETRIES - retries + 1));
+                return this.request(path, init, retries - 1);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    // -- agent identity -------------------------------------------------------
+    heartbeat(agentId, status, taskId, sessionId) {
+        const body = { status };
+        if (taskId)
+            body.taskId = taskId;
+        if (sessionId)
+            body.sessionId = sessionId;
+        return this.request(`/agents/${agentId}/heartbeat`, {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+    }
+    inbox(agentId) {
+        return this.request(`/agents/${agentId}/inbox`);
+    }
+    mintRunToken(agentId, taskId) {
+        return this.request(`/agents/${agentId}/run-tokens`, {
+            method: 'POST',
+            body: JSON.stringify(taskId ? { taskId } : {}),
+        });
+    }
+    redeemRunToken(runToken, taskId) {
+        return this.request('/agent-bridge/redeem-run-token', {
+            method: 'POST',
+            body: JSON.stringify(taskId ? { runToken, taskId } : { runToken }),
+        });
+    }
+    // -- tasks ----------------------------------------------------------------
+    getTask(taskId) {
+        return this.request(`/tasks/${taskId}`);
+    }
+    listTasks(params) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(params))
+            if (v !== undefined)
+                qs.set(k, String(v));
+        return this.request(`/tasks?${qs.toString()}`);
+    }
+    createTask(dto) {
+        return this.request('/tasks', { method: 'POST', body: JSON.stringify(dto) });
+    }
+    updateTask(taskId, dto) {
+        return this.request(`/tasks/${taskId}`, { method: 'PATCH', body: JSON.stringify(dto) });
+    }
+    listComments(taskId) {
+        return this.request(`/comments?taskId=${taskId}`);
+    }
+    // -- subtasks (agent breakdown + check-off) --------------------------------
+    /** Subtask tree of a task (nested, each node with checklist items). */
+    listSubtasks(taskId) {
+        return this.request(`/tasks/${taskId}/subtasks`);
+    }
+    createSubtask(dto) {
+        return this.request(`/tasks/${dto.taskId}/subtasks`, {
+            method: 'POST',
+            body: JSON.stringify(dto),
+        });
+    }
+    /** Mark done / reopen, rename, reassign, move or re-due a subtask. */
+    updateSubtask(subtaskId, dto) {
+        return this.request(`/subtasks/${subtaskId}`, {
+            method: 'PATCH',
+            body: JSON.stringify(dto),
+        });
+    } /** Document comment thread (Phase F document assistant). */
+    listDocumentComments(documentId) {
+        return this.request(`/comments?documentId=${documentId}`);
+    }
+    addComment(dto) {
+        return this.request('/comments', {
+            method: 'POST',
+            body: JSON.stringify(dto),
+        });
+    }
+    // -- projects / documents / search ---------------------------------------
+    getProject(projectId) {
+        return this.request(`/projects/${projectId}`);
+    }
+    listDocuments(projectId) {
+        return this.request(`/documents?projectId=${projectId}`);
+    }
+    getDocument(documentId) {
+        return this.request(`/documents/${documentId}`);
+    }
+    /** Phase F: extracted text for office/PDF documents. */
+    getDocumentExtract(documentId) {
+        return this.request(`/documents/${documentId}/extract`);
+    }
+    /**
+     * Downloads a document. Link docs return { url }; local files return plain
+     * text; Cloudinary-hosted files return { url } (fetchable by the caller).
+     */
+    async getDocumentContent(doc) {
+        if (doc.type === 'link')
+            return JSON.stringify({ type: 'link', url: doc.urlOrKey });
+        try {
+            const res = await fetch(`${this.baseUrl}/documents/${doc.id}/download`, {
+                headers: this.apiKey ? { 'X-Api-Key': this.apiKey } : undefined,
+                signal: AbortSignal.timeout(TIMEOUT_MS),
+            });
+            if (!res.ok)
+                return `[download failed: HTTP ${res.status}]`;
+            const ct = res.headers.get('content-type') ?? '';
+            if (ct.includes('application/json')) {
+                const json = (await res.json());
+                return JSON.stringify({ type: 'file', name: doc.name, url: json.url ?? null });
+            }
+            return await res.text();
+        }
+        catch {
+            return '[download failed: network error]';
+        }
+    }
+    search(q, type) {
+        const qs = new URLSearchParams({ q });
+        if (type)
+            qs.set('type', type);
+        return this.request(`/search?${qs.toString()}`);
+    }
+    // -- chat (agent chat replies, dual-auth surface) -----------------------
+    listChatMessages(projectId, page = 1, pageSize = 50) {
+        const qs = new URLSearchParams({ projectId, page: String(page), pageSize: String(pageSize) });
+        return this.request(`/chat/messages?${qs.toString()}`);
+    }
+    postChatMessage(projectId, body) {
+        return this.request('/chat/messages', {
+            method: 'POST',
+            body: JSON.stringify({ projectId, body }),
+        });
+    }
+}
+exports.TeamshareApi = TeamshareApi;
+function isRetryable(err) {
+    if (err instanceof ApiError)
+        return err.status >= 500;
+    return err instanceof TypeError; // network / aborted
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

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

package/dist/lib/brief.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Task-brief fetching + session reporting helpers shared by the CLI, daemon
+ * and protocol handler (contract section 5, "CLI session").
+ */
+import { TeamshareApi, Task } from './api';
+export interface BriefOptions {
+    maxDocChars?: number;
+}
+/** Builds the Markdown brief the working session sees. */
+export declare function fetchTaskBrief(api: TeamshareApi, taskId: string, opts?: BriefOptions): Promise<string>;
+/** Best-effort heartbeat wrapper - never throws. */
+export declare function reportStatus(api: TeamshareApi, agentId: string, status: 'online' | 'working' | 'offline', taskId?: string, sessionId?: string): Promise<void>;
+/** Posts the closing summary comment - best-effort, never throws. */
+export declare function postClosingComment(api: TeamshareApi, taskId: string, summary: string): Promise<void>;
+/** Waits for the task to leave open/in_progress, or times out. */
+export declare function waitForTaskCompletion(api: TeamshareApi, taskId: string, pollMs?: number, maxWaitMs?: number, onProgress?: (status: string) => void): Promise<Task>;

package/dist/lib/brief.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchTaskBrief = fetchTaskBrief;
+exports.reportStatus = reportStatus;
+exports.postClosingComment = postClosingComment;
+exports.waitForTaskCompletion = waitForTaskCompletion;
+const MAX_DOC_CHARS = 20_000;
+/** Builds the Markdown brief the working session sees. */
+async function fetchTaskBrief(api, taskId, opts = {}) {
+    const maxDocChars = opts.maxDocChars ?? MAX_DOC_CHARS;
+    const task = await api.getTask(taskId);
+    const lines = [];
+    lines.push(`# Task: ${task.title}`);
+    lines.push('');
+    lines.push(`- **Status:** ${task.status}  ` +
+        `**Priority:** ${task.priority}` +
+        (task.dueDate ? `  **Due:** ${task.dueDate}` : '') +
+        (task.assigneeId ? `  **Assignee:** ${task.assigneeId}` : ''));
+    if (task.project)
+        lines.push(`- **Project:** ${task.project.name} (${task.projectId})`);
+    lines.push('');
+    if (task.description) {
+        lines.push('## Description');
+        lines.push('');
+        lines.push(task.description);
+        lines.push('');
+    }
+    const comments = await api.listComments(taskId);
+    if (comments.length > 0) {
+        lines.push('## Comments');
+        lines.push('');
+        for (const c of comments.slice(-25)) {
+            const author = c.author?.name ?? c.authorId ?? 'unknown';
+            lines.push(`- **${author}** (${c.createdAt}): ${c.body.replace(/\s+/g, ' ')}`);
+        }
+        lines.push('');
+    }
+    // Subtask breakdown (existing or to-be-created) - the agent's progress plan.
+    const subtasks = await api.listSubtasks(taskId).catch(() => []);
+    if (subtasks.length > 0) {
+        lines.push('## Subtasks');
+        lines.push('');
+        const render = (nodes, depth) => {
+            for (const node of nodes) {
+                lines.push(`${'  '.repeat(depth)}- [${node.done ? 'x' : ' '}] ${node.title}` +
+                    (node.assignee?.name ? ` (assignee: ${node.assignee.name})` : ''));
+                if (node.children?.length)
+                    render(node.children, depth + 1);
+            }
+        };
+        render(subtasks, 0);
+        lines.push('');
+    }
+    if (task.projectId) {
+        const docs = await api.listDocuments(task.projectId);
+        if (docs.length > 0) {
+            lines.push('## Project files');
+            lines.push('');
+            let used = 0;
+            for (const doc of docs.slice(0, 20)) {
+                const content = await api.getDocumentContent(doc);
+                const remain = maxDocChars - used;
+                if (remain <= 0) {
+                    lines.push(`- ${doc.name}: (omitted - budget reached)`);
+                    continue;
+                }
+                const body = content.length > remain ? `${content.slice(0, remain)}…` : content;
+                used += body.length;
+                lines.push(`### ${doc.name}${doc.mime ? ` (${doc.mime})` : ''}`);
+                lines.push('');
+                lines.push(body);
+                lines.push('');
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/** Best-effort heartbeat wrapper - never throws. */
+async function reportStatus(api, agentId, status, taskId, sessionId) {
+    try {
+        await api.heartbeat(agentId, status, taskId, sessionId);
+    }
+    catch (err) {
+        console.warn(`[heartbeat ${status}] ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** Posts the closing summary comment - best-effort, never throws. */
+async function postClosingComment(api, taskId, summary) {
+    if (!summary.trim())
+        return;
+    try {
+        await api.addComment({ taskId, body: summary });
+    }
+    catch (err) {
+        console.warn(`[report] ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** Waits for the task to leave open/in_progress, or times out. */
+async function waitForTaskCompletion(api, taskId, pollMs = 15_000, maxWaitMs = 20 * 60_000, onProgress) {
+    const deadline = Date.now() + maxWaitMs;
+    let last = '';
+    for (;;) {
+        const task = await api.getTask(taskId);
+        if (task.status !== last) {
+            last = task.status;
+            onProgress?.(task.status);
+        }
+        if (['resolved', 'closed', 'in_review'].includes(task.status))
+            return task;
+        if (Date.now() >= deadline)
+            return task;
+        await new Promise((r) => setTimeout(r, pollMs));
+    }
+}
+//# sourceMappingURL=brief.js.map

package/dist/lib/brief.js.map

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

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

@@ -0,0 +1,29 @@
+import { TeamshareApi } from './api';
+export interface ChatReplyOptions {
+    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;
+    /** Phase C: stream the generated reply as message:partial frames. */
+    stream?: {
+        wsBase: string;
+        apiKey: string;
+        projectId: string;
+        channelId?: string;
+    };
+}
+/**
+ * Runs the chat reply loop. Heartbeats working/online around the work and
+ * posts one reply per mentioning message (in chronological order).
+ */
+export declare function runChatReply(api: TeamshareApi, agentId: string, projectId: string, mentionToken: string, opts: ChatReplyOptions): Promise<{
+    replied: number;
+    skipped: number;
+}>;