teamshare-bridge 0.1.0

package/dist/lib/lock.js.map

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

package/dist/lib/models.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Curated model catalog (Phase D+): provider -> OpenAI-compatible base URL
+ * resolution for `provider:model` specs stored in Agent.model.
+ *
+ * The authoritative copy + update process live in `docs/agent-models.md`.
+ * This file mirrors the frontend catalog
+ * (`frontend/src/lib/constants/models.ts`) and the docs table — keep all
+ * three in sync (see the docs for the 3-step update process).
+ */
+export declare const MODEL_BASE_URLS: Record<string, string>;
+/** Provider keys accepted by the catalog (for validation/docs). */
+export declare const MODEL_PROVIDERS: string[];
+/** Default OpenAI-compatible base when nothing else is configured. */
+export declare const DEFAULT_LLM_BASE_URL = "https://api.openai.com/v1";
+export interface ResolvedModel {
+    /** Base URL for chat/completions (env LLM_BASE_URL always wins). */
+    baseUrl: string;
+    /** Model id sent to the API. */
+    model: string;
+    /** True when the spec was resolved via the catalog (vs raw env default). */
+    catalogued: boolean;
+}
+/**
+ * Resolves a model spec to (baseUrl, model):
+ * - `provider:model` (e.g. "gemini:gemini-2.5-flash") -> catalog base URL.
+ * - Anything else (legacy "deepseek-chat") -> env LLM_BASE_URL default,
+ *   preserving the pre-catalog behavior.
+ * Precedence for the base URL: LLM_BASE_URL env > catalog provider URL.
+ */
+export declare function resolveModel(spec: string, envBaseUrl?: string): ResolvedModel;

package/dist/lib/models.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Curated model catalog (Phase D+): provider -> OpenAI-compatible base URL
+ * resolution for `provider:model` specs stored in Agent.model.
+ *
+ * The authoritative copy + update process live in `docs/agent-models.md`.
+ * This file mirrors the frontend catalog
+ * (`frontend/src/lib/constants/models.ts`) and the docs table — keep all
+ * three in sync (see the docs for the 3-step update process).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LLM_BASE_URL = exports.MODEL_PROVIDERS = exports.MODEL_BASE_URLS = void 0;
+exports.resolveModel = resolveModel;
+exports.MODEL_BASE_URLS = {
+    gemini: 'https://generativelanguage.googleapis.com/v1beta/openai',
+    deepseek: 'https://api.deepseek.com',
+    openai: 'https://api.openai.com/v1',
+    groq: 'https://api.groq.com/openai/v1',
+    openrouter: 'https://openrouter.ai/api/v1',
+    mistral: 'https://api.mistral.ai/v1',
+};
+/** Provider keys accepted by the catalog (for validation/docs). */
+exports.MODEL_PROVIDERS = Object.keys(exports.MODEL_BASE_URLS);
+/** Default OpenAI-compatible base when nothing else is configured. */
+exports.DEFAULT_LLM_BASE_URL = 'https://api.openai.com/v1';
+/**
+ * Resolves a model spec to (baseUrl, model):
+ * - `provider:model` (e.g. "gemini:gemini-2.5-flash") -> catalog base URL.
+ * - Anything else (legacy "deepseek-chat") -> env LLM_BASE_URL default,
+ *   preserving the pre-catalog behavior.
+ * Precedence for the base URL: LLM_BASE_URL env > catalog provider URL.
+ */
+function resolveModel(spec, envBaseUrl) {
+    const colon = spec.indexOf(':');
+    const provider = colon > 0 ? spec.slice(0, colon) : '';
+    const modelId = colon > 0 ? spec.slice(colon + 1) : spec;
+    const catalogUrl = exports.MODEL_BASE_URLS[provider];
+    if (catalogUrl) {
+        return {
+            baseUrl: envBaseUrl ?? catalogUrl,
+            model: modelId,
+            catalogued: true,
+        };
+    }
+    return {
+        baseUrl: envBaseUrl ?? exports.DEFAULT_LLM_BASE_URL,
+        model: spec,
+        catalogued: false,
+    };
+}
+//# sourceMappingURL=models.js.map

package/dist/lib/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/lib/models.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAiCH,oCAiBC;AAhDY,QAAA,eAAe,GAA2B;IACrD,MAAM,EAAE,yDAAyD;IACjE,QAAQ,EAAE,0BAA0B;IACpC,MAAM,EAAE,2BAA2B;IACnC,IAAI,EAAE,gCAAgC;IACtC,UAAU,EAAE,8BAA8B;IAC1C,OAAO,EAAE,2BAA2B;CACrC,CAAC;AAEF,mEAAmE;AACtD,QAAA,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAe,CAAC,CAAC;AAE5D,sEAAsE;AACzD,QAAA,oBAAoB,GAAG,2BAA2B,CAAC;AAWhE;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,IAAY,EAAE,UAAmB;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,MAAM,UAAU,GAAG,uBAAe,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,UAAU,IAAI,UAAU;YACjC,KAAK,EAAE,OAAO;YACd,UAAU,EAAE,IAAI;SACjB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,UAAU,IAAI,4BAAoB;QAC3C,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC"}

package/dist/lib/partial-stream.d.ts

@@ -0,0 +1,25 @@
+export interface PartialStreamOptions {
+    wsBase: string;
+    apiKey: string;
+    projectId: string;
+    channelId?: string;
+}
+export declare class PartialStream {
+    private readonly opts;
+    private socket;
+    private readonly draftId;
+    private readonly projectId;
+    private channelId?;
+    private seq;
+    private buffer;
+    private timer;
+    private closed;
+    constructor(opts: PartialStreamOptions, draftId: string);
+    /** Best-effort connect - failures degrade to non-streaming silently. */
+    connect(): void;
+    /** Buffer a token delta and flush it in coalesced frames. */
+    token(delta: string): void;
+    private flush;
+    /** Flush remaining tokens + announce the persisted message. */
+    end(messageId?: string): void;
+}

package/dist/lib/partial-stream.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartialStream = void 0;
+/**
+ * Phase C chat streaming (IMP-530): forwards generated reply tokens to the
+ * project channel as `message:partial` frames over the /chat socket
+ * (apiKey auth, like the REST dual-auth surface). The final message is still
+ * posted via POST /chat/messages — this client only relays the live draft;
+ * the backend never persists partials.
+ */
+const socket_io_client_1 = require("socket.io-client");
+const MAX_RATE_MS = 80; // coalesce frames to <= ~12 packets/sec
+const MAX_FRAME = 240; // chars per frame (multi-byte safe splits below)
+class PartialStream {
+    opts;
+    socket = null;
+    draftId;
+    projectId;
+    channelId;
+    seq = 0;
+    buffer = '';
+    timer = null;
+    closed = false;
+    constructor(opts, draftId) {
+        this.opts = opts;
+        this.draftId = draftId;
+        this.projectId = opts.projectId;
+        this.channelId = opts.channelId;
+    }
+    /** Best-effort connect - failures degrade to non-streaming silently. */
+    connect() {
+        try {
+            this.socket = (0, socket_io_client_1.io)(`${this.opts.wsBase}/chat`, {
+                transports: ['websocket'],
+                auth: { apiKey: this.opts.apiKey },
+                reconnection: true,
+                reconnectionDelay: 2_000,
+                reconnectionDelayMax: 15_000,
+            });
+        }
+        catch {
+            this.socket = null;
+        }
+    }
+    /** Buffer a token delta and flush it in coalesced frames. */
+    token(delta) {
+        if (this.closed)
+            return;
+        this.buffer += delta;
+        if (!this.timer) {
+            this.timer = setTimeout(() => this.flush(), MAX_RATE_MS);
+        }
+    }
+    flush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (!this.buffer)
+            return;
+        const chunk = this.buffer;
+        this.buffer = '';
+        const safe = chunk.slice(0, MAX_FRAME);
+        if (chunk.length > MAX_FRAME)
+            this.buffer = chunk.slice(MAX_FRAME);
+        this.seq += 1;
+        this.socket?.emit('message:partial', {
+            projectId: this.projectId,
+            channelId: this.channelId,
+            draftId: this.draftId,
+            sessionId: null,
+            seq: this.seq,
+            text: safe,
+        });
+    }
+    /** Flush remaining tokens + announce the persisted message. */
+    end(messageId) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.flush();
+        this.socket?.emit('message:partial:end', {
+            projectId: this.projectId,
+            channelId: this.channelId,
+            draftId: this.draftId,
+            sessionId: null,
+            messageId: messageId ?? null,
+        });
+        try {
+            this.socket?.disconnect();
+        }
+        catch {
+            /* best-effort */
+        }
+        this.socket = null;
+    }
+}
+exports.PartialStream = PartialStream;
+//# sourceMappingURL=partial-stream.js.map

package/dist/lib/partial-stream.js.map

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

package/dist/lib/session-stream.d.ts

@@ -0,0 +1,38 @@
+export interface SessionFrame {
+    stream: 'stdout' | 'stderr';
+    text: string;
+    at: string;
+}
+export interface SessionMeta {
+    sessionId: string;
+    agentId: string;
+    projectId?: string;
+    taskId?: string;
+    mode: 'run' | 'chat';
+    model?: string | null;
+}
+export declare function sessionsDir(): string;
+/** Generates a session id (`session_<uuid>`), shared by spawn/daemon. */
+export declare function newSessionId(): string;
+export declare class SessionStream {
+    readonly sessionId: string;
+    readonly meta: SessionMeta;
+    private readonly startedAtISO;
+    private socket;
+    private lines;
+    private pending;
+    private timer;
+    private ended;
+    private started;
+    constructor(meta: SessionMeta);
+    /** Best-effort connect + emit session:start. Never throws. */
+    connect(wsBase: string, apiKey: string): void;
+    /** Tees a console line into the stream buffer (batched upstream). */
+    line(text: string, stream?: 'stdout' | 'stderr'): void;
+    private emitFrame;
+    private flush;
+    /** Flushes and emits session:end (waits briefly for the ack). */
+    end(exitCode: number | null): Promise<void>;
+    /** Writes the transcript tail to ~/.teamshare/sessions/<id>.json. */
+    private persist;
+}

package/dist/lib/session-stream.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionStream = void 0;
+exports.sessionsDir = sessionsDir;
+exports.newSessionId = newSessionId;
+/**
+ * Phase A live console (IMP-510): streams a CLI session's output to the
+ * TeamShare backend over the /agents WebSocket (`session:start` /
+ * `session:output` / `session:end`, batched ~200ms) and mirrors the
+ * transcript tail to ~/.teamshare/sessions/<sessionId>.json so a
+ * reconnected browser can replay the last lines.
+ *
+ * Best-effort by design: any failure (backend down, socket drop) degrades
+ * to local console output only - it must never break the session itself.
+ */
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const socket_io_client_1 = require("socket.io-client");
+const BATCH_MS = 200;
+const TRANSCRIPT_LIMIT = 500;
+const SESSIONS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'sessions');
+function sessionsDir() {
+    return SESSIONS_DIR;
+}
+/** Generates a session id (`session_<uuid>`), shared by spawn/daemon. */
+function newSessionId() {
+    return `session_${(0, node_crypto_1.randomUUID)()}`;
+}
+function localPath(sessionId) {
+    return (0, node_path_1.join)(SESSIONS_DIR, `${sessionId}.json`);
+}
+class SessionStream {
+    sessionId;
+    meta;
+    startedAtISO;
+    socket = null;
+    lines = [];
+    pending = [];
+    timer = null;
+    ended = false;
+    started = false;
+    constructor(meta) {
+        this.sessionId = meta.sessionId;
+        this.meta = meta;
+        this.startedAtISO = new Date().toISOString();
+    }
+    /** Best-effort connect + emit session:start. Never throws. */
+    connect(wsBase, apiKey) {
+        try {
+            this.socket = (0, socket_io_client_1.io)(wsBase, {
+                transports: ['websocket'],
+                auth: { apiKey },
+                reconnection: true,
+                reconnectionDelay: 2_000,
+                reconnectionDelayMax: 30_000,
+            });
+            this.socket.on('connect', () => {
+                // The join ack confirms the gateway finished authenticating this
+                // socket (client.agentId is set). Only then is it safe to emit
+                // session:start - the gateway rejects it otherwise.
+                const joinAndStart = () => {
+                    this.socket?.emit('join', { ack: true }, (res) => {
+                        if (res?.success) {
+                            this.socket?.emit('session:start', {
+                                sessionId: this.meta.sessionId,
+                                agentId: this.meta.agentId,
+                                projectId: this.meta.projectId ?? undefined,
+                                taskId: this.meta.taskId ?? undefined,
+                                mode: this.meta.mode,
+                                model: this.meta.model ?? null,
+                                startedAt: this.startedAtISO,
+                            });
+                            this.started = true;
+                            // Replay anything buffered while disconnected.
+                            if (this.pending.length) {
+                                for (const frame of this.pending)
+                                    this.emitFrame(frame);
+                                this.pending = [];
+                            }
+                        }
+                        else {
+                            // Auth not ready yet - retry shortly (the gateway handler is
+                            // async; the ack arrives once it completes).
+                            setTimeout(joinAndStart, 1000);
+                        }
+                    });
+                };
+                joinAndStart();
+            });
+            this.socket.on('connect_error', () => {
+                /* retry automatically - output keeps buffering locally */
+            });
+        }
+        catch {
+            this.socket = null;
+        }
+    }
+    /** Tees a console line into the stream buffer (batched upstream). */
+    line(text, stream = 'stdout') {
+        const frame = {
+            stream,
+            text,
+            at: new Date().toISOString(),
+        };
+        this.lines.push(frame);
+        if (this.lines.length > TRANSCRIPT_LIMIT) {
+            this.lines.splice(0, this.lines.length - TRANSCRIPT_LIMIT);
+        }
+        if (!this.socket?.connected) {
+            if (this.pending.length < TRANSCRIPT_LIMIT)
+                this.pending.push(frame);
+            this.persist();
+            return;
+        }
+        this.pending.push(frame);
+        if (!this.timer) {
+            this.timer = setTimeout(() => this.flush(), BATCH_MS);
+        }
+        this.persist();
+    }
+    emitFrame(frame) {
+        this.socket?.emit('session:output', {
+            sessionId: this.sessionId,
+            stream: frame.stream,
+            text: frame.text,
+            at: frame.at,
+        });
+    }
+    flush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (!this.pending.length)
+            return;
+        const batch = this.pending;
+        this.pending = [];
+        for (const frame of batch)
+            this.emitFrame(frame);
+    }
+    /** Flushes and emits session:end (waits briefly for the ack). */
+    async end(exitCode) {
+        if (this.ended)
+            return;
+        this.ended = true;
+        this.flush();
+        this.persist({ ended: true, exitCode });
+        const done = new Promise((resolve) => {
+            const t = setTimeout(resolve, 1500);
+            this.socket?.emit('session:end', { sessionId: this.sessionId, exitCode }, () => {
+                clearTimeout(t);
+                resolve();
+            });
+            if (!this.socket)
+                resolve();
+        });
+        await done;
+        try {
+            this.socket?.disconnect();
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    /** Writes the transcript tail to ~/.teamshare/sessions/<id>.json. */
+    persist(opts) {
+        try {
+            (0, node_fs_1.mkdirSync)(SESSIONS_DIR, { recursive: true });
+            const payload = {
+                sessionId: this.sessionId,
+                agentId: this.meta.agentId,
+                projectId: this.meta.projectId ?? null,
+                taskId: this.meta.taskId ?? null,
+                mode: this.meta.mode,
+                model: this.meta.model ?? null,
+                startedAt: this.startedAtISO,
+                endedAt: opts?.ended ? new Date().toISOString() : null,
+                exitCode: opts?.exitCode ?? null,
+                lines: this.lines,
+            };
+            (0, node_fs_1.writeFileSync)(localPath(this.sessionId), JSON.stringify(payload, null, 2));
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+exports.SessionStream = SessionStream;
+//# sourceMappingURL=session-stream.js.map

package/dist/lib/session-stream.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "teamshare-bridge",
+  "version": "0.1.0",
+  "description": "Local bridge for TeamShare agents - CLI session runner, auto-wake WebSocket daemon, and teamshare:// protocol handler.",
+  "type": "commonjs",
+  "license": "MIT",
+  "keywords": [
+    "teamshare",
+    "agent",
+    "bridge",
+    "mcp",
+    "ai",
+    "automation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dominionbanjo/teamshare-bridge.git"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "teamshare-agent": "dist/cli/index.js",
+    "teamshare-bridge": "dist/bridge/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "dev": "tsc -p tsconfig.json --watch",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "socket.io-client": "^4.8.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}