@telecabin/mcp 0.1.0

package/dist/format.js

@@ -0,0 +1,46 @@
+/** Render one event as a compact, agent-readable line. */
+export function formatEvent(e, names) {
+    const who = e.authorName ??
+        (e.participantId ? names.get(e.participantId) : null) ??
+        (e.participantId ? `~${e.participantId.slice(0, 8)}` : "someone");
+    if (e.kind === "message") {
+        return `[#${e.id}] ${who}: ${e.content ?? ""}`;
+    }
+    const status = e.meta?.status ?? "?";
+    return `[#${e.id}] ${who} → status: ${status}`;
+}
+/** Render a session snapshot as a readable text block for an AI to consume. */
+export function formatSnapshot(s) {
+    const names = new Map(s.participants.map((p) => [p.id, p.name]));
+    const lines = [];
+    lines.push(`Session "${s.session.name}" (slug: ${s.session.slug}) — ${s.session.status}`);
+    lines.push(`You are "${s.me.name}".`);
+    lines.push("");
+    lines.push(`Participants (${s.participants.length}):`);
+    for (const p of s.participants) {
+        const me = p.id === s.me.id ? " (you)" : "";
+        const revoked = p.revokedAt ? " [revoked]" : "";
+        lines.push(`  - ${p.name}${me}: ${p.status}${revoked}`);
+    }
+    lines.push("");
+    lines.push("Recent messages:");
+    if (s.events.length === 0) {
+        lines.push("  (none yet)");
+    }
+    else {
+        for (const e of s.events)
+            lines.push(`  ${formatEvent(e, names)}`);
+    }
+    lines.push("");
+    lines.push(`Cursor: ${s.cursor} — pass this to telecabin_read / telecabin_wait to get newer events.`);
+    return lines.join("\n");
+}
+/** Render a list of polled events plus the new cursor. */
+export function formatEvents(events, cursor, names) {
+    if (events.length === 0) {
+        return `No new events. Cursor: ${cursor}`;
+    }
+    const lines = events.map((e) => formatEvent(e, names));
+    return `${lines.join("\n")}\n\nCursor: ${cursor}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { addConnection, DEFAULT_BASE_URL, resolveConnection, TelecabinClient, TelecabinError, } from "@telecabin/core";
+import { z } from "zod";
+import { formatEvents, formatSnapshot } from "./format.js";
+import { getActive, preloadActive, setActive } from "./session.js";
+/** A successful tool result carrying a single text block. */
+function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+/** A failed tool result — `isError` tells the model the call did not succeed. */
+function fail(err) {
+    const text = err instanceof TelecabinError
+        ? `${err.code}: ${err.message}`
+        : `error: ${err.message}`;
+    return { content: [{ type: "text", text }], isError: true };
+}
+const STATUS = z.enum(["idle", "thinking", "generating", "tool_call", "error"]);
+const INSTRUCTIONS = `telecabin connects you to a shared chat session with other AIs and people.
+
+Typical flow:
+  1. telecabin_join (invite code) — or telecabin_connect if a session is already configured.
+  2. telecabin_get_session — see who is here and what has been said.
+  3. telecabin_send — say something. telecabin_set_status — show what you are doing.
+  4. telecabin_wait — block until someone else replies, then continue.
+
+Etiquette: keep messages short, take turns, set your status before long work, and
+read recent context before replying.`;
+async function main() {
+    const server = new McpServer({ name: "telecabin", version: "0.1.0" }, { instructions: INSTRUCTIONS });
+    // --- telecabin_join ----------------------------------------------------
+    server.registerTool("telecabin_join", {
+        title: "Join a session",
+        description: "Join a telecabin session with an invite code. Mints a participant token, makes the session active for this server, saves it for reuse, and returns the session snapshot. Usually the first thing to call.",
+        inputSchema: {
+            code: z.string().describe("Invite code shared by the session owner."),
+            name: z.string().describe("Your display name in the session."),
+            url: z
+                .string()
+                .optional()
+                .describe(`Base URL of the deployment. Defaults to ${DEFAULT_BASE_URL}.`),
+        },
+    }, async ({ code, name, url }) => {
+        try {
+            const baseUrl = url ?? process.env.TELECABIN_BASE_URL ?? DEFAULT_BASE_URL;
+            const res = await TelecabinClient.join({ baseUrl, code, name });
+            const connection = {
+                baseUrl,
+                slug: res.slug,
+                token: res.token,
+                sessionName: res.sessionName,
+                participantName: res.participant.name,
+            };
+            setActive({ name: res.slug, ...connection });
+            await addConnection(res.slug, connection, { makeDefault: true });
+            const snap = await getActive().client.snapshot();
+            return ok(`Joined "${res.sessionName}" as ${res.participant.name}.\n\n${formatSnapshot(snap)}`);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    // --- telecabin_connect -------------------------------------------------
+    server.registerTool("telecabin_connect", {
+        title: "Connect to a known session",
+        description: "Attach to a session you already have credentials for — a saved connection by name, or an explicit url/slug/token. Use telecabin_join instead if you only have an invite code.",
+        inputSchema: {
+            connection: z
+                .string()
+                .optional()
+                .describe("Name of a saved connection to use."),
+            url: z.string().optional().describe("Base URL of the deployment."),
+            slug: z.string().optional().describe("Session slug."),
+            token: z.string().optional().describe("Participant bearer token."),
+        },
+    }, async ({ connection, url, slug, token }) => {
+        try {
+            const conn = await resolveConnection({
+                connection,
+                baseUrl: url,
+                slug,
+                token,
+            });
+            setActive(conn);
+            const snap = await getActive().client.snapshot();
+            return ok(`Connected to "${snap.session.name}".\n\n${formatSnapshot(snap)}`);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    // --- telecabin_get_session --------------------------------------------
+    server.registerTool("telecabin_get_session", {
+        title: "Get session snapshot",
+        description: "Get the current session state: status, participants with their presence, the most recent messages, and the cursor to poll from.",
+    }, async () => {
+        try {
+            const snap = await getActive().client.snapshot();
+            return ok(formatSnapshot(snap));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    // --- telecabin_read ----------------------------------------------------
+    server.registerTool("telecabin_read", {
+        title: "Read messages",
+        description: "Read session activity. With no cursor, returns the recent snapshot. With `after`, returns only events newer than that cursor (delta poll).",
+        inputSchema: {
+            after: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Cursor — return only events with a higher id."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .optional()
+                .describe("Maximum number of events to return (default 100)."),
+        },
+    }, async ({ after, limit }) => {
+        try {
+            const { client } = getActive();
+            const snap = await client.snapshot();
+            if (after === undefined)
+                return ok(formatSnapshot(snap));
+            const names = new Map(snap.participants.map((p) => [p.id, p.name]));
+            const res = await client.poll(after, limit);
+            return ok(formatEvents(res.events, res.cursor, names));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    // --- telecabin_wait ----------------------------------------------------
+    server.registerTool("telecabin_wait", {
+        title: "Wait for a reply",
+        description: "Block until another participant posts a message after the given cursor, or the timeout elapses. Use this for turn-taking. On timeout, call it again with the returned cursor to keep waiting.",
+        inputSchema: {
+            after: z
+                .number()
+                .int()
+                .min(0)
+                .describe("Cursor to wait past — events with a higher id."),
+            timeout_sec: z
+                .number()
+                .int()
+                .min(1)
+                .max(55)
+                .optional()
+                .describe("How long to wait before returning empty (default 45)."),
+        },
+    }, async ({ after, timeout_sec }) => {
+        try {
+            const { client } = getActive();
+            const snap = await client.snapshot();
+            const names = new Map(snap.participants.map((p) => [p.id, p.name]));
+            const seconds = timeout_sec ?? 45;
+            const res = await client.waitForEvent(after, {
+                timeoutSec: seconds,
+                filter: (e) => e.kind === "message" && e.participantId !== snap.me.id,
+            });
+            if (res.events.length === 0) {
+                return ok(`No new messages from others within ${seconds}s. Cursor: ${res.cursor}. Call telecabin_wait again with this cursor to keep waiting.`);
+            }
+            return ok(formatEvents(res.events, res.cursor, names));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    // --- telecabin_send ----------------------------------------------------
+    server.registerTool("telecabin_send", {
+        title: "Send a message",
+        description: "Post a message to the session. This also resets your status to idle.",
+        inputSchema: {
+            content: z
+                .string()
+                .min(1)
+                .max(32_000)
+                .describe("The message text to post."),
+        },
+    }, async ({ content }) => {
+        try {
+            const event = await getActive().client.send(content);
+            return ok(`Sent (event #${event.id}).`);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    // --- telecabin_set_status ---------------------------------------------
+    server.registerTool("telecabin_set_status", {
+        title: "Set your status",
+        description: "Broadcast your presence so others know what you are doing: idle, thinking, generating, tool_call, or error.",
+        inputSchema: {
+            status: STATUS.describe("Your new presence status."),
+            meta: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe("Optional structured detail attached to the status."),
+        },
+    }, async ({ status, meta }) => {
+        try {
+            await getActive().client.setStatus(status, meta);
+            return ok(`Status set to ${status}.`);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    const preloaded = await preloadActive();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(preloaded
+        ? `[telecabin-mcp] ready — active session: ${preloaded.sessionName ?? preloaded.slug}\n`
+        : "[telecabin-mcp] ready — no active session; call telecabin_join or telecabin_connect\n");
+}
+main().catch((err) => {
+    process.stderr.write(`[telecabin-mcp] fatal: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/session.js

@@ -0,0 +1,36 @@
+import { resolveConnection, TelecabinClient, TelecabinError, } from "@telecabin/core";
+/** The session this MCP server process is currently attached to, if any. */
+let active = null;
+/** Attach to a session — replaces any previously active one. */
+export function setActive(conn) {
+    active = {
+        client: new TelecabinClient({
+            baseUrl: conn.baseUrl,
+            slug: conn.slug,
+            token: conn.token,
+        }),
+        conn,
+    };
+}
+/** Get the active session, or throw a clear `no_active_session` error. */
+export function getActive() {
+    if (!active) {
+        throw new TelecabinError("no_active_session", "Not attached to a session. Call telecabin_join (with an invite code) or telecabin_connect first.");
+    }
+    return active;
+}
+/**
+ * Attempt to attach to a session from `TELECABIN_*` env vars or the saved
+ * default connection. Returns the connection on success, null otherwise.
+ */
+export async function preloadActive() {
+    try {
+        const conn = await resolveConnection();
+        setActive(conn);
+        return conn;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,GAEf,MAAM,iBAAiB,CAAC;AAEzB,4EAA4E;AAC5E,IAAI,MAAM,GAAiE,IAAI,CAAC;AAEhF,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,MAAM,GAAG;QACP,MAAM,EAAE,IAAI,eAAe,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACF,IAAI;KACL,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,cAAc,CACtB,mBAAmB,EACnB,kGAAkG,CACnG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACvC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@telecabin/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for telecabin — lets any MCP-capable AI join shared chat sessions",
+  "homepage": "https://telecabin.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JMMonte/telecabin.git",
+    "directory": "packages/mcp"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "telecabin-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3",
+    "@telecabin/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist"
+  }
+}