@soundbi/sound-connect 0.1.0

package/dist/tools.js

@@ -0,0 +1,368 @@
+/**
+ * Tool registration for the Sound Connect bridge
+ * (STORY-006, STORY-009, STORY-010, STORY-011, STORY-012, STORY-013).
+ *
+ * STORY-010 / ADR-011: When the peer has not authenticated (no valid token at MCP
+ * startup), every tool call returns a clear MCP error directing the user to run
+ * `npx @soundbi/sound-connect login` in a terminal. The server never blocks on an
+ * interactive device-code prompt — that would cause a silent hang because Claude
+ * spawns the stdio server with stdout used for MCP framing (not displayed to the user).
+ *
+ * STORY-009 / ADR-005: One-client-per-instance isolation guard.
+ *   - The bound clientSlug is fixed at process start. There is NO tool or command
+ *     to switch clients in-session — any attempt to target a different slug is blocked.
+ *   - assertResponseSlug() validates every backend response matches the bound slug so
+ *     a misdirected backend response can never leak into this session.
+ *
+ * STORY-011 / ADR-006: ingest_file tool reads a local markdown file or transcript,
+ *   normalizes, computes sha256, attaches provenance, and POSTs to /ingest/:slug.
+ *
+ * STORY-012 / ADR-006: ingest_folder tool bulk-ingests a directory of .md and
+ *   transcript (.txt/.vtt/.srt) files, returning a per-file result table.
+ *
+ * STORY-013 / ADR-011: ingest_file and ingest_folder use queueOnFailure=true so
+ *   transient backend failures (network / 5xx) queue chunks locally for retry.
+ *   ingest_status tool reports pending/dead queue depth.
+ *   The retry worker is started when registerBridgeTools() is called with an
+ *   authenticated session.
+ */
+import { z } from 'zod';
+import { ingestMarkdownFile, ingestFolder } from './ingest.js';
+import { acquireTokenSilent } from './auth.js';
+import { getQueueStatus, startRetryWorker } from './retry-queue.js';
+// ── Slug isolation helpers (STORY-009, ADR-005) ───────────────────────────────
+/**
+ * Asserts that a backend response belongs to the bound client slug.
+ *
+ * The backend may return a `client_slug` or `slug` field in its JSON response.
+ * If the value is present and does NOT match the bound slug, this function throws
+ * so the tool handler can reject the response as a cross-client leak.
+ *
+ * If the response carries no slug field (e.g. a list result or an error body),
+ * the check is skipped — the absence of a conflicting slug is not a violation.
+ *
+ * @param responseSlug  The slug found in the backend response (may be undefined).
+ * @param boundSlug     The slug this bridge instance is bound to.
+ * @throws Error if responseSlug is present and does not match boundSlug.
+ */
+export function assertResponseSlug(responseSlug, boundSlug) {
+    if (responseSlug !== undefined && responseSlug !== boundSlug) {
+        throw new Error(`[sound-connect] Isolation violation: response slug "${responseSlug}" ` +
+            `does not match bound slug "${boundSlug}". ` +
+            'This instance is locked to one client. Start a separate bridge instance for a different client.');
+    }
+}
+/**
+ * Parses a JSON response body from the backend and asserts the slug matches.
+ * Returns the parsed body so callers do not have to parse twice.
+ *
+ * @param text       Raw response text from the backend.
+ * @param boundSlug  The slug this bridge instance is bound to.
+ * @returns Parsed JSON object (or null if parsing fails — slug check is skipped).
+ */
+export function parseAndAssertResponseSlug(text, boundSlug) {
+    let body;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        // Non-JSON response — cannot check slug, pass through.
+        return null;
+    }
+    if (body !== null && typeof body === 'object') {
+        const asRecord = body;
+        const responseSlug = typeof asRecord['client_slug'] === 'string'
+            ? asRecord['client_slug']
+            : typeof asRecord['slug'] === 'string'
+                ? asRecord['slug']
+                : undefined;
+        assertResponseSlug(responseSlug, boundSlug);
+    }
+    return body;
+}
+/**
+ * MCP error returned when the peer has not run `login` yet.
+ * STORY-010 AC1: exact wording specifies the terminal command to run.
+ */
+const NOT_SIGNED_IN_TEXT = 'Not signed in — run `npx @soundbi/sound-connect login` in a terminal.';
+/**
+ * Shown when authenticated but the tool is not yet implemented (STORY-008).
+ * Distinct from the not-signed-in error so the user knows auth succeeded.
+ */
+const NOT_YET_IMPLEMENTED_TEXT = 'Tool not yet implemented in this release. Authentication is working — ' +
+    'full proxy functionality is coming in the next update.';
+function notSignedInResult() {
+    return {
+        content: [{ type: 'text', text: NOT_SIGNED_IN_TEXT }],
+        isError: true,
+    };
+}
+function notImplementedResult() {
+    return {
+        content: [{ type: 'text', text: NOT_YET_IMPLEMENTED_TEXT }],
+        isError: true,
+    };
+}
+/**
+ * Register bridge tools on the MCP server.
+ *
+ * All tools are visible in tools/list immediately (required by Claude Desktop/Code
+ * to show the server as functional). When `isAuthenticated` is false, every tool
+ * call returns the NOT_SIGNED_IN_TEXT error — never blocks or hangs (STORY-010).
+ * When `isAuthenticated` is true, tool calls return NOT_YET_IMPLEMENTED_TEXT until
+ * STORY-008 wires real proxy behaviour.
+ *
+ * STORY-009 / ADR-005: There is deliberately NO "select_client", "switch_client",
+ * or equivalent tool registered here. The bound slug is fixed at process start and
+ * cannot be changed in-session. Any outbound call that receives a response for a
+ * different slug must call assertResponseSlug() / parseAndAssertResponseSlug() to
+ * reject the response before returning it to Claude.
+ *
+ * @param server          The McpServer instance.
+ * @param config          Bridge config (backendUrl, clientSlug) — fixed at startup.
+ * @param isAuthenticated Whether a valid cached token was found at startup (STORY-010).
+ */
+export function registerBridgeTools(server, config, isAuthenticated) {
+    const { clientSlug } = config;
+    // Helper: return the appropriate error based on auth state.
+    const guardResult = () => isAuthenticated ? notImplementedResult() : notSignedInResult();
+    // STORY-013 / ADR-011: Start the background retry worker when authenticated.
+    // The worker drains the local queue with exponential backoff.
+    // tokenProvider uses acquireTokenSilent — never blocks or triggers device-code flow.
+    if (isAuthenticated) {
+        startRetryWorker(clientSlug, async () => {
+            try {
+                const result = await acquireTokenSilent();
+                return result?.accessToken ?? null;
+            }
+            catch {
+                return null;
+            }
+        });
+    }
+    server.tool('sc_status', `Returns the current connection status for the ${clientSlug} Sound Connect workspace. ` +
+        'Shows whether you are authenticated and which backend this bridge is pointed at.', {}, async () => ({
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    status: isAuthenticated ? 'authenticated' : 'unauthenticated',
+                    client_slug: clientSlug,
+                    hint: isAuthenticated
+                        ? 'Connected. Full tool proxy available in the next release.'
+                        : NOT_SIGNED_IN_TEXT,
+                }, null, 2),
+            }],
+    }));
+    server.tool('sc_login', 'Shows the current authentication status. ' +
+        'To sign in, run `npx @soundbi/sound-connect login` in a terminal ' +
+        '(device-code login cannot be triggered from inside Claude).', {}, async () => ({
+        content: [{
+                type: 'text',
+                text: isAuthenticated
+                    ? 'Already signed in. No action needed.'
+                    : NOT_SIGNED_IN_TEXT,
+            }],
+        isError: !isAuthenticated,
+    }));
+    server.tool('add_client_memory', `Log a memory, decision, or finding for the ${clientSlug} workspace. Requires authentication.`, {
+        category: z.string().describe('Memory category (project, technical, decision, red-flag, client)'),
+        title: z.string().describe('Short title'),
+        body: z.string().describe('Full memory content'),
+    }, async () => guardResult());
+    server.tool('search_client_memories', `Search memories and knowledge in the ${clientSlug} workspace. Requires authentication.`, {
+        query: z.string().describe('Search query'),
+    }, async () => guardResult());
+    server.tool('get_client_context', 'Returns which client this bridge is operating on and the current auth state.', {}, async () => ({
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    client_slug: clientSlug,
+                    authenticated: isAuthenticated,
+                    hint: isAuthenticated
+                        ? 'Connected.'
+                        : NOT_SIGNED_IN_TEXT,
+                }, null, 2),
+            }],
+    }));
+    // ── STORY-011: ingest_file ─────────────────────────────────────────────────
+    //
+    // Reads a local markdown or transcript file, normalizes, chunks, hashes,
+    // attaches provenance, and POSTs to /ingest/:slug.
+    // ADR-006: .md + .txt/.vtt/.srt in v1; binary formats deferred to v1.1.
+    // ADR-004: sha256 idempotency key; provenance required on every ingest.
+    server.tool('ingest_file', `Ingest a local markdown or transcript file into the ${clientSlug} Sound Connect knowledge corpus. ` +
+        'Reads the file, computes a content hash for deduplication, attaches provenance, ' +
+        'and uploads to the backend. Returns a summary of chunks ingested and any deduped chunks. ' +
+        'Supported formats: markdown (.md) and transcript plaintext (.txt, .vtt, .srt).', {
+        path: z.string().describe('Absolute or relative path to the markdown or transcript file to ingest'),
+        workstream_slug: z
+            .string()
+            .optional()
+            .describe('Optional workstream to scope this knowledge to'),
+    }, async (args) => {
+        // Auth guard — never attempt ingest without a valid token.
+        if (!isAuthenticated) {
+            return notSignedInResult();
+        }
+        // Acquire a fresh token per call (MSAL handles silent refresh).
+        let token = null;
+        try {
+            const result = await acquireTokenSilent();
+            token = result?.accessToken ?? null;
+        }
+        catch {
+            token = null;
+        }
+        if (!token) {
+            return {
+                content: [{ type: 'text', text: NOT_SIGNED_IN_TEXT }],
+                isError: true,
+            };
+        }
+        try {
+            // STORY-013: queueOnFailure=true so transient backend failures (network/5xx)
+            // queue the chunk locally for retry instead of throwing.
+            const summary = await ingestMarkdownFile({
+                filePath: args.path,
+                backendUrl: config.backendUrl,
+                clientSlug,
+                token,
+                workstreamSlug: args.workstream_slug,
+                queueOnFailure: true,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(summary, null, 2),
+                    }],
+            };
+        }
+        catch (err) {
+            const msg = (err instanceof Error) ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `ingest_file error: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── STORY-012: ingest_folder ───────────────────────────────────────────────
+    //
+    // Bulk-ingests a directory of .md and transcript files (.txt/.vtt/.srt).
+    // Each file flows through the STORY-011 ingest path (ingestMarkdownFile).
+    // Idempotency: re-running skips already-ingested files (sha256 dedup, ADR-004).
+    // Returns a per-file result table with status: ingested / deduped / failed.
+    // ADR-006: .md + transcript plaintext only; binary formats deferred to v1.1.
+    // ADR-011: per-file failures captured in results table, do not abort the run.
+    server.tool('ingest_folder', `Bulk-ingest a directory of markdown and transcript files into the ${clientSlug} ` +
+        'Sound Connect knowledge corpus. ' +
+        'Enumerates .md, .txt, .vtt, and .srt files in the folder (flat, non-recursive). ' +
+        'Each file is deduplicated by content hash — re-running the folder safely skips already-ingested files. ' +
+        'Returns a per-file result table showing ingested, deduped, or failed status.', {
+        path: z.string().describe('Absolute or relative path to the folder to ingest'),
+        glob: z
+            .string()
+            .optional()
+            .describe('Optional extension filter, e.g. "*.md" or "*.vtt". ' +
+            'Defaults to all supported types: .md, .txt, .vtt, .srt.'),
+        workstream_slug: z
+            .string()
+            .optional()
+            .describe('Optional workstream to scope all ingested files to'),
+    }, async (args) => {
+        // Auth guard.
+        if (!isAuthenticated) {
+            return notSignedInResult();
+        }
+        // Acquire a fresh token per call (MSAL handles silent refresh).
+        let token = null;
+        try {
+            const result = await acquireTokenSilent();
+            token = result?.accessToken ?? null;
+        }
+        catch {
+            token = null;
+        }
+        if (!token) {
+            return {
+                content: [{ type: 'text', text: NOT_SIGNED_IN_TEXT }],
+                isError: true,
+            };
+        }
+        try {
+            // STORY-013: queueOnFailure is not yet threaded into ingestFolder directly
+            // because ingestFolder calls ingestMarkdownFile per-file without that flag.
+            // Transient failures at the file level will surface as "failed" in the results
+            // table (ADR-011 per-file capture). The retry queue path is available via
+            // ingest_file for individual files when the backend is unreachable.
+            const result = await ingestFolder({
+                folderPath: args.path,
+                glob: args.glob,
+                backendUrl: config.backendUrl,
+                clientSlug,
+                token,
+                workstreamSlug: args.workstream_slug,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (err) {
+            const msg = (err instanceof Error) ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `ingest_folder error: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── STORY-013: ingest_status ───────────────────────────────────────────────
+    //
+    // Reports the current state of the local retry queue for this client:
+    //   - pending: chunks queued due to transient failures, awaiting retry
+    //   - dead: chunks permanently failed (4xx auth/access errors)
+    //
+    // ADR-011: permanently-failed items (4xx) are surfaced here, not silently retried.
+    // The retry worker drains pending items automatically with exponential backoff.
+    server.tool('ingest_status', `Report the status of the local ingest retry queue for the ${clientSlug} workspace. ` +
+        'Shows how many chunks are pending retry (transient backend failure) and how many ' +
+        'have permanently failed (auth/access errors that need user action). ' +
+        'The retry worker automatically drains pending items with exponential backoff.', {}, async () => {
+        try {
+            const status = await getQueueStatus(clientSlug);
+            const summary = {
+                client_slug: clientSlug,
+                pending_chunks: status.pending,
+                dead_chunks: status.dead,
+                ...(status.dead > 0 ? {
+                    dead_items: status.deadItems,
+                    hint: 'Dead items require action — likely an auth error. ' +
+                        'Run `npx @soundbi/sound-connect login` to re-authenticate, ' +
+                        'then retry the affected files manually.',
+                } : {}),
+                ...(status.pending > 0 ? {
+                    pending_items: status.pendingItems,
+                    hint_pending: 'Pending items will be retried automatically with exponential backoff.',
+                } : {}),
+                ...(status.pending === 0 && status.dead === 0 ? {
+                    hint: 'Queue is empty — all ingestion is up to date.',
+                } : {}),
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(summary, null, 2),
+                    }],
+            };
+        }
+        catch (err) {
+            const msg = (err instanceof Error) ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `ingest_status error: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@soundbi/sound-connect",
+  "version": "0.1.0",
+  "description": "Local stdio MCP bridge for Sound Connect — connects Claude Desktop and Claude Code to your Sound Connect workspace.",
+  "type": "module",
+  "bin": {
+    "sound-connect": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@azure/msal-node": "^5.2.2",
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "keytar": "^7.9.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "tsx": "^4.19.2",
+    "typescript": "^5.4.5",
+    "vitest": "^2.1.9"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}