@soundbi/sound-connect 0.1.0

package/dist/ingest.js

@@ -0,0 +1,573 @@
+/**
+ * File ingestion logic for the Sound Connect bridge (STORY-011, STORY-012, STORY-013).
+ *
+ * STORY-011 implements:
+ *   - Path validation and confinement (no directory traversal — AC3)
+ *   - Markdown file reading and normalization (AC1)
+ *   - Content chunking for large files (AC1)
+ *   - SHA-256 content hash for idempotency (AC2, ADR-004)
+ *   - Provenance attachment and POST to /ingest/:slug (AC2)
+ *   - Summary return: chunks ingested, deduped count (AC4)
+ *
+ * STORY-012 extends to:
+ *   - Folder enumeration supporting .md and transcript text files (.txt/.vtt/.srt)
+ *   - Per-file source_type reflecting the file kind (markdown vs transcript)
+ *   - Idempotency across folder re-runs (sha256 already present → deduped)
+ *   - Per-file result table (ingested / deduped / failed)
+ *
+ * STORY-013 extends to:
+ *   - When `queueOnFailure` is enabled, network errors and 5xx responses write the
+ *     chunk to the local retry queue instead of throwing (ADR-011).
+ *   - 4xx responses still throw immediately (permanent auth/access error — queue won't help).
+ *   - IngestSummary gains a `chunks_queued` field reporting items sent to the retry queue.
+ *
+ * ADR-006: v1 handles text/markdown and transcript plaintext only. Binary formats
+ *          (PDF, .xlsx, .docx) deferred to v1.1.
+ * ADR-004: sha256 of normalized content is the idempotency key.
+ * ADR-011: All errors are thrown with descriptive messages; callers surface them
+ *          as MCP tool errors — never silent failures.
+ */
+import { createHash } from 'node:crypto';
+import { readFile, stat, readdir } from 'node:fs/promises';
+import { resolve, extname, basename, join } from 'node:path';
+import { enqueueFailedChunk } from './retry-queue.js';
+// ── Constants ──────────────────────────────────────────────────────────────────
+/**
+ * Maximum single-chunk size in characters.
+ * Files larger than this are split into multiple chunks (AC1: chunk if large).
+ * ~6 000 chars ≈ ~1 500 tokens — a reasonable semantic unit for retrieval.
+ */
+const CHUNK_SIZE_CHARS = 6_000;
+/**
+ * Overlap between consecutive chunks in characters.
+ * Preserves context across chunk boundaries for better retrieval quality.
+ */
+const CHUNK_OVERLAP_CHARS = 200;
+/**
+ * Maximum file size accepted for ingestion (10 MB — ADR-004 body limit).
+ * The backend enforces this at the HTTP layer; we mirror it locally for a
+ * clear early error before the network round-trip.
+ */
+const MAX_FILE_BYTES = 10 * 1024 * 1024;
+/**
+ * File extensions accepted for ingestion (ADR-006: text/markdown + transcript plaintext).
+ * Binary formats (PDF, .xlsx, .docx) are deferred to v1.1.
+ */
+export const SUPPORTED_EXTENSIONS = new Set(['.md', '.txt', '.vtt', '.srt']);
+/**
+ * Derive the source_type provenance value from a file extension (STORY-012, ADR-004).
+ * Returns 'markdown' for .md files, 'transcript' for .txt/.vtt/.srt.
+ */
+export function sourceTypeForExt(ext) {
+    return ext === '.md' ? 'markdown' : 'transcript';
+}
+// ── Path validation (AC3, STORY-011/STORY-012) ───────────────────────────────
+/**
+ * Resolves and validates a single ingestable file path.
+ *
+ * Rules enforced:
+ *   1. Path must not be empty.
+ *   2. File must exist and be a regular file (not a directory or symlink loop).
+ *   3. File extension must be in SUPPORTED_EXTENSIONS (ADR-006: .md/.txt/.vtt/.srt).
+ *   4. File size must not exceed MAX_FILE_BYTES (ADR-004 body limit).
+ *
+ * Traversal confinement: `resolve()` normalises `../` sequences so the resolved
+ * path is always absolute. We do NOT restrict to a whitelist directory because
+ * peers legitimately have notes and transcripts anywhere on their machine. We do
+ * block the obvious attack vectors: empty paths, non-files, unsupported extensions.
+ *
+ * @param rawPath  The path supplied by the tool caller.
+ * @returns Resolved absolute path.
+ * @throws Error with a descriptive message on any validation failure.
+ */
+export async function validateAndResolvePath(rawPath) {
+    if (!rawPath || rawPath.trim() === '') {
+        throw new Error('Path must not be empty.');
+    }
+    // Normalise: resolve relative paths against cwd, collapse ../ sequences.
+    const resolved = resolve(rawPath.trim());
+    // Check for null bytes (path injection attempt).
+    if (resolved.includes('\0')) {
+        throw new Error(`Invalid path: contains null byte.`);
+    }
+    // Must be a supported text format (ADR-006: markdown + transcripts in v1).
+    const ext = extname(resolved).toLowerCase();
+    if (!SUPPORTED_EXTENSIONS.has(ext)) {
+        throw new Error(`File "${basename(resolved)}" has extension "${ext || '(none)'}". ` +
+            'Only markdown (.md) and transcript (.txt, .vtt, .srt) files are supported in v1. ' +
+            'Binary format support (PDF, .docx, .xlsx) is planned for v1.1.');
+    }
+    // Verify the file exists and is a regular file.
+    let fileSize;
+    try {
+        const info = await stat(resolved);
+        if (!info.isFile()) {
+            throw new Error(`Path "${resolved}" is not a regular file.`);
+        }
+        fileSize = info.size;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`File not found: "${resolved}". Check the path and try again.`);
+        }
+        if (err.code === 'EACCES') {
+            throw new Error(`Permission denied reading "${resolved}".`);
+        }
+        throw err;
+    }
+    // Size guard — mirror the backend's 10 MB body limit (ADR-004).
+    if (fileSize > MAX_FILE_BYTES) {
+        throw new Error(`File "${basename(resolved)}" is ${(fileSize / 1024 / 1024).toFixed(1)} MB, ` +
+            `which exceeds the 10 MB ingestion limit.`);
+    }
+    return resolved;
+}
+// ── Folder enumeration (STORY-012, AC1) ──────────────────────────────────────
+/**
+ * Parse the `glob` argument from ingest_folder into a Set of allowed extensions.
+ *
+ * Accepts patterns like "*.md", "*.vtt", "*.txt", "*.srt".
+ * If the pattern matches a known SUPPORTED_EXTENSIONS entry, only that extension
+ * is returned. If glob is undefined/empty, all SUPPORTED_EXTENSIONS are returned.
+ * If glob specifies an unsupported extension, throws with a clear message.
+ *
+ * This is intentionally simple — STORY-012 AC1 says "glob?" but the only
+ * meaningful variation is filtering by extension, not full glob matching.
+ * Full glob support (**, recursive patterns) is deferred to v1.1.
+ */
+export function parseGlobToExtensions(glob) {
+    if (!glob || glob.trim() === '') {
+        return new Set(SUPPORTED_EXTENSIONS);
+    }
+    // Extract the extension from a pattern like "*.md", "*.vtt", "docs/*.txt".
+    const match = /\*(\.[a-z0-9]+)$/i.exec(glob.trim());
+    if (!match) {
+        // No wildcard extension found — treat as all supported extensions.
+        return new Set(SUPPORTED_EXTENSIONS);
+    }
+    const ext = match[1].toLowerCase();
+    if (!SUPPORTED_EXTENSIONS.has(ext)) {
+        throw new Error(`glob pattern "${glob}" requests extension "${ext}" which is not supported. ` +
+            `Supported extensions: ${[...SUPPORTED_EXTENSIONS].join(', ')}. ` +
+            'Binary formats (PDF, .docx, .xlsx) are planned for v1.1.');
+    }
+    return new Set([ext]);
+}
+/**
+ * Enumerate all ingestable files in a folder (non-recursive, flat listing).
+ *
+ * Returns absolute paths of files whose extension is in the allowed set.
+ * Silently skips subdirectories and files with unsupported extensions.
+ * Throws if the folder does not exist or is not a directory.
+ *
+ * STORY-012 AC1: enumerates .md and transcript text files (.txt/.vtt/.srt).
+ * Recursion is not in scope for v1 — flat directory only.
+ *
+ * @param folderPath   Absolute path to the folder to enumerate.
+ * @param allowedExts  Set of lowercase extensions to include (from parseGlobToExtensions).
+ * @returns Sorted list of absolute file paths.
+ */
+export async function enumerateFolder(folderPath, allowedExts) {
+    let entries;
+    try {
+        entries = await readdir(folderPath, { withFileTypes: true });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`Folder not found: "${folderPath}". Check the path and try again.`);
+        }
+        if (err.code === 'ENOTDIR') {
+            throw new Error(`Path "${folderPath}" is not a directory.`);
+        }
+        if (err.code === 'EACCES') {
+            throw new Error(`Permission denied reading folder "${folderPath}".`);
+        }
+        throw err;
+    }
+    const files = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const ext = extname(entry.name).toLowerCase();
+        if (!allowedExts.has(ext))
+            continue;
+        files.push(join(folderPath, entry.name));
+    }
+    // Deterministic ordering so result tables are consistent across runs.
+    files.sort();
+    return files;
+}
+// ── Normalization (AC1) ────────────────────────────────────────────────────────
+/**
+ * Normalize markdown content before hashing and chunking.
+ *
+ * Normalization steps:
+ *   1. Normalize line endings to LF.
+ *   2. Strip trailing whitespace from each line.
+ *   3. Collapse runs of 3+ blank lines to 2 blank lines (preserve paragraph spacing).
+ *   4. Trim leading/trailing blank lines from the document.
+ *
+ * This ensures that whitespace-only edits do not produce new sha256 hashes
+ * (no spurious re-ingestion) while preserving meaningful structure.
+ */
+export function normalizeMarkdown(content) {
+    return content
+        .replace(/\r\n/g, '\n') // CRLF → LF
+        .replace(/\r/g, '\n') // bare CR → LF
+        .split('\n')
+        .map(line => line.trimEnd()) // strip trailing whitespace per line
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n') // collapse 3+ blank lines to 2
+        .trim();
+}
+// ── Chunking (AC1) ────────────────────────────────────────────────────────────
+/**
+ * Split normalized content into overlapping chunks for retrieval-friendly storage.
+ *
+ * Strategy: paragraph-aware sliding window.
+ *   - Split on double-newlines (paragraph boundaries) to avoid cutting mid-sentence.
+ *   - Accumulate paragraphs until the chunk would exceed CHUNK_SIZE_CHARS.
+ *   - Start the next chunk with the last CHUNK_OVERLAP_CHARS of the previous chunk
+ *     (approximate — overlap at paragraph boundary nearest to the overlap target).
+ *
+ * If the entire content fits in one chunk, returns a single-element array.
+ */
+export function chunkContent(content) {
+    if (content.length <= CHUNK_SIZE_CHARS) {
+        return [content];
+    }
+    const paragraphs = content.split(/\n\n+/);
+    const chunks = [];
+    let current = '';
+    for (const paragraph of paragraphs) {
+        const candidate = current ? `${current}\n\n${paragraph}` : paragraph;
+        if (candidate.length > CHUNK_SIZE_CHARS && current) {
+            // Flush current chunk.
+            chunks.push(current);
+            // Start next chunk with overlap: take the tail of the current chunk.
+            const overlapStart = Math.max(0, current.length - CHUNK_OVERLAP_CHARS);
+            const overlap = current.slice(overlapStart);
+            current = `${overlap}\n\n${paragraph}`;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current) {
+        chunks.push(current);
+    }
+    return chunks.length > 0 ? chunks : [content];
+}
+// ── Hashing (AC2, ADR-004) ────────────────────────────────────────────────────
+/** Compute the SHA-256 hex digest of a string. */
+export function sha256(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+/**
+ * Attempt a single POST to /ingest/:slug and classify the outcome.
+ *
+ * Does NOT throw — returns a typed outcome so the caller decides whether
+ * to queue, throw, or count as deduped.
+ *
+ * Classification:
+ *   transient — network error or 5xx: idempotency (ADR-004) makes retry safe.
+ *   permanent — 4xx: auth/access error that won't resolve by retrying.
+ *   success   — 2xx.
+ *
+ * Note: 413 (payload too large) is treated as permanent — retrying the same
+ * oversized chunk will never succeed.
+ */
+async function tryPostChunk(backendUrl, clientSlug, token, payload) {
+    const url = `${backendUrl}/ingest/${encodeURIComponent(clientSlug)}`;
+    let res;
+    try {
+        res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+            body: JSON.stringify(payload),
+        });
+    }
+    catch (err) {
+        // Network-level failure (DNS, timeout, ECONNREFUSED) — transient.
+        return {
+            kind: 'transient',
+            error: `Backend unreachable at ${url}: ${err.message}. ` +
+                'Check your network connection and try again.',
+        };
+    }
+    let bodyText = '';
+    try {
+        bodyText = await res.text();
+    }
+    catch { /* ignore */ }
+    // 413 = payload too large (permanent — retrying the same chunk won't help).
+    if (res.status === 413) {
+        return {
+            kind: 'permanent',
+            error: 'Backend rejected the payload as too large (413). The file or chunk exceeds the 10 MB limit.',
+        };
+    }
+    // Any other 4xx = permanent (auth / access).
+    if (res.status >= 400 && res.status < 500) {
+        let hint = '';
+        try {
+            const parsed = JSON.parse(bodyText);
+            hint = (parsed['hint'] ?? parsed['error'] ?? parsed['message'] ?? '');
+        }
+        catch { /* not JSON */ }
+        if (res.status === 401) {
+            return {
+                kind: 'permanent',
+                error: 'Bearer token rejected by backend (401). Run `npx @soundbi/sound-connect login` to re-authenticate.',
+            };
+        }
+        if (res.status === 403) {
+            return {
+                kind: 'permanent',
+                error: `Access denied to client "${clientSlug}" (403). ${hint || 'Verify your Sound Connect membership.'}`,
+            };
+        }
+        return {
+            kind: 'permanent',
+            error: `Backend returned HTTP ${res.status}${hint ? `: ${hint}` : ''}. ${bodyText.slice(0, 200)}`,
+        };
+    }
+    // 5xx or other non-2xx — transient.
+    if (!res.ok) {
+        return {
+            kind: 'transient',
+            error: `Backend returned HTTP ${res.status}. ${bodyText.slice(0, 200)}`,
+        };
+    }
+    // 2xx success.
+    try {
+        return { kind: 'success', response: JSON.parse(bodyText) };
+    }
+    catch {
+        // 200 with non-JSON body — treat as success, non-deduped.
+        return { kind: 'success', response: { ok: true, deduped: false } };
+    }
+}
+/**
+ * POST a single chunk to the backend /ingest/:slug endpoint.
+ *
+ * Returns { deduped: true } when the backend reports the sha256 already exists.
+ * Throws on network errors or non-2xx responses (ADR-011: fail closed).
+ *
+ * This wrapper is kept for backward compatibility with existing callers that
+ * expect the original throw-on-failure contract (STORY-011/012 tests).
+ */
+async function postChunk(backendUrl, clientSlug, token, payload) {
+    const outcome = await tryPostChunk(backendUrl, clientSlug, token, payload);
+    if (outcome.kind === 'success')
+        return outcome.response;
+    throw new Error(outcome.error);
+}
+// ── Public API (AC1–AC4) ──────────────────────────────────────────────────────
+/**
+ * Ingest a single local text file (markdown or transcript) into the Sound Connect corpus.
+ *
+ * Full pipeline:
+ *   1. Validate path — supports .md, .txt, .vtt, .srt (STORY-012 AC1, ADR-006).
+ *   2. Read file.
+ *   3. Normalize content (line endings, trailing whitespace, blank lines).
+ *   4. Chunk if large.
+ *   5. Hash each chunk (ADR-004 idempotency key).
+ *   6. Attach provenance with source_type derived from extension (STORY-012 AC2).
+ *   7. POST each chunk to /ingest/:slug.
+ *      STORY-013: When queueOnFailure=true, network errors and 5xx responses write
+ *      the chunk to the local retry queue instead of throwing. 4xx errors still throw.
+ *   8. Return summary (includes chunks_queued when queueOnFailure is used).
+ *
+ * @throws Error with a descriptive message on any failure (ADR-011).
+ */
+export async function ingestMarkdownFile(opts) {
+    const { filePath, backendUrl, clientSlug, token, workstreamSlug, authorEmail, queueOnFailure } = opts;
+    // Validate and resolve path (supports .md + transcripts).
+    const resolvedPath = await validateAndResolvePath(filePath);
+    const filename = basename(resolvedPath);
+    // Derive source_type from extension (STORY-012 AC2, ADR-004 invariant 2).
+    const ext = extname(resolvedPath).toLowerCase();
+    const sourceType = sourceTypeForExt(ext);
+    // Read file.
+    const rawContent = await readFile(resolvedPath, 'utf8');
+    // Normalize (shared for markdown and transcript plaintext).
+    const normalized = normalizeMarkdown(rawContent);
+    if (!normalized) {
+        throw new Error(`File "${filename}" is empty after normalization. Nothing to ingest.`);
+    }
+    // Full-content hash for the summary (hash of the complete normalized document).
+    const contentHash = sha256(normalized);
+    // Chunk.
+    const chunks = chunkContent(normalized);
+    // Provenance — author_email from token claim or config (ADR-004 invariant 2).
+    const effectiveAuthorEmail = authorEmail ?? '';
+    const timestamp = new Date().toISOString();
+    let chunksIngested = 0;
+    let chunksDeduped = 0;
+    let chunksQueued = 0;
+    // POST each chunk with provenance.
+    for (let i = 0; i < chunks.length; i++) {
+        const chunkText = chunks[i];
+        const chunkHash = chunks.length === 1 ? contentHash : sha256(chunkText);
+        // Filename disambiguated per-chunk when there are multiple chunks.
+        const chunkFilename = chunks.length === 1
+            ? filename
+            : `${filename}#chunk-${i + 1}-of-${chunks.length}`;
+        const payload = {
+            source_type: sourceType,
+            filename: chunkFilename,
+            content: chunkText,
+            sha256: chunkHash,
+            timestamp,
+            author_email: effectiveAuthorEmail,
+            ...(workstreamSlug ? { workstream_slug: workstreamSlug } : {}),
+        };
+        if (queueOnFailure) {
+            // STORY-013: use tryPostChunk so we can distinguish transient vs permanent failures.
+            const outcome = await tryPostChunk(backendUrl, clientSlug, token, payload);
+            if (outcome.kind === 'success') {
+                if (outcome.response.deduped) {
+                    chunksDeduped++;
+                }
+                else {
+                    chunksIngested++;
+                }
+            }
+            else if (outcome.kind === 'transient') {
+                // Transient (network / 5xx) — write to retry queue. ADR-004 idempotency makes re-send safe.
+                await enqueueFailedChunk(backendUrl, clientSlug, payload, outcome.error);
+                chunksQueued++;
+            }
+            else {
+                // Permanent (4xx) — throw immediately. Queueing won't help (auth/access error).
+                throw new Error(outcome.error);
+            }
+        }
+        else {
+            // Original behaviour: throw on any failure.
+            const result = await postChunk(backendUrl, clientSlug, token, payload);
+            if (result.deduped) {
+                chunksDeduped++;
+            }
+            else {
+                chunksIngested++;
+            }
+        }
+    }
+    // Return summary.
+    return {
+        chunks_sent: chunks.length,
+        chunks_ingested: chunksIngested,
+        chunks_deduped: chunksDeduped,
+        chunks_queued: chunksQueued,
+        file: resolvedPath,
+        content_hash: contentHash,
+    };
+}
+// ── ingestFolder (STORY-012) ──────────────────────────────────────────────────
+/**
+ * Bulk-ingest a directory of markdown and transcript text files.
+ *
+ * Pipeline (STORY-012):
+ *   1. Resolve and validate the folder path.
+ *   2. Parse glob to determine which extensions to include (AC1).
+ *   3. Enumerate matching files in the folder (flat, non-recursive).
+ *   4. For each file: run through the ingestMarkdownFile pipeline (STORY-011 path).
+ *      - deduped = all chunks were already present (idempotency, AC3).
+ *      - ingested = at least one new chunk was accepted.
+ *      - failed   = any error during read/post.
+ *   5. Return per-file result table + folder-level totals (AC4).
+ *
+ * Idempotency (AC3): re-running the folder produces files_ingested=0 and
+ * files_deduped=N (one per file) because sha256 keys are already present.
+ *
+ * ADR-011: per-file failures are captured in the result table and do NOT abort
+ * the rest of the run — callers see which files failed and why.
+ *
+ * @throws Error only if the folder itself cannot be accessed (not per-file errors).
+ */
+export async function ingestFolder(opts) {
+    const { folderPath, glob, backendUrl, clientSlug, token, workstreamSlug, authorEmail } = opts;
+    // Resolve and validate folder path.
+    const resolvedFolder = resolve(folderPath.trim());
+    // Verify the folder exists and is a directory.
+    try {
+        const info = await stat(resolvedFolder);
+        if (!info.isDirectory()) {
+            throw new Error(`Path "${resolvedFolder}" is not a directory.`);
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`Folder not found: "${resolvedFolder}". Check the path and try again.`);
+        }
+        if (err.code === 'EACCES') {
+            throw new Error(`Permission denied reading folder "${resolvedFolder}".`);
+        }
+        throw err;
+    }
+    // Parse glob into allowed extensions (AC1).
+    const allowedExts = parseGlobToExtensions(glob);
+    // Enumerate matching files (AC1).
+    const files = await enumerateFolder(resolvedFolder, allowedExts);
+    const results = [];
+    let filesIngested = 0;
+    let filesDeduped = 0;
+    let filesFailed = 0;
+    // Process each file through the STORY-011 ingest path (AC2).
+    for (const filePath of files) {
+        try {
+            const summary = await ingestMarkdownFile({
+                filePath,
+                backendUrl,
+                clientSlug,
+                token,
+                workstreamSlug,
+                authorEmail,
+            });
+            // AC3: Idempotency — fully deduped means all chunks were already present.
+            const fullyDeduped = summary.chunks_ingested === 0 && summary.chunks_deduped > 0;
+            if (fullyDeduped) {
+                filesDeduped++;
+                results.push({
+                    file: filePath,
+                    status: 'deduped',
+                    chunks_sent: summary.chunks_sent,
+                    chunks_deduped: summary.chunks_deduped,
+                });
+            }
+            else {
+                filesIngested++;
+                results.push({
+                    file: filePath,
+                    status: 'ingested',
+                    chunks_sent: summary.chunks_sent,
+                    chunks_ingested: summary.chunks_ingested,
+                    chunks_deduped: summary.chunks_deduped,
+                });
+            }
+        }
+        catch (err) {
+            // ADR-011: per-file failures captured, do not abort the folder run.
+            filesFailed++;
+            results.push({
+                file: filePath,
+                status: 'failed',
+                error: (err instanceof Error) ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        folder: resolvedFolder,
+        files_found: files.length,
+        files_ingested: filesIngested,
+        files_deduped: filesDeduped,
+        files_failed: filesFailed,
+        results,
+    };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,kFAAkF;AAElF;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B;;;GAGG;AACH,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;;GAIG;AACH,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AACnD,CAAC;AA+GD,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAe;IAC1D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,yEAAyE;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEzC,iDAAiD;IACjD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,2EAA2E;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,GAAG,IAAI,QAAQ,KAAK;YACnE,mFAAmF;YACnF,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,0BAA0B,CAAC,CAAC;QAC/D,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,kCAAkC,CAAC,CAAC;QAClF,CAAC;QACD,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,IAAI,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,gEAAgE;IAChE,IAAI,QAAQ,GAAG,cAAc,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;YAC7E,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChC,OAAO,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACvC,CAAC;IAED,2EAA2E;IAC3E,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,mEAAmE;QACnE,OAAO,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,yBAAyB,GAAG,4BAA4B;YAC7E,yBAAyB,CAAC,GAAG,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACjE,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,WAAwB;IAExB,IAAI,OAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAqB,CAAC;IACnF,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,sBAAsB,UAAU,kCAAkC,CAAC,CAAC;QACtF,CAAC;QACD,IAAK,GAA6B,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,SAAS,UAAU,uBAAuB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,qCAAqC,UAAU,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,IAAI,EAAE,CAAC;IACb,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kFAAkF;AAElF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO;SACX,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAU,YAAY;SAC5C,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAa,eAAe;SAChD,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAM,qCAAqC;SACtE,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAO,+BAA+B;SAChE,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACvC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAErE,IAAI,SAAS,CAAC,MAAM,GAAG,gBAAgB,IAAI,OAAO,EAAE,CAAC;YACnD,uBAAuB;YACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAErB,qEAAqE;YACrE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC5C,OAAO,GAAG,GAAG,OAAO,OAAO,SAAS,EAAE,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,iFAAiF;AAEjF,kDAAkD;AAClD,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AA8BD;;;;;;;;;;;;;GAaG;AACH,KAAK,UAAU,YAAY,CACzB,UAAkB,EAClB,UAAkB,EAClB,KAAa,EACb,OAAsB;IAEtB,MAAM,GAAG,GAAG,GAAG,UAAU,WAAW,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;IAErE,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACrB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,KAAK,EAAE;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,kEAAkE;QAClE,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,KAAK,EACH,0BAA0B,GAAG,KAAM,GAAa,CAAC,OAAO,IAAI;gBAC5D,8CAA8C;SACjD,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAExB,4EAA4E;IAC5E,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,6FAA6F;SACrG,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC1C,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B,CAAC;YAC/D,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAW,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAE1B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,oGAAoG;aAC5G,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,4BAA4B,UAAU,YAAY,IAAI,IAAI,uCAAuC,EAAE;aAC3G,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,yBAAyB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;SAClG,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,yBAAyB,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;SACxE,CAAC;IACJ,CAAC;IAED,eAAe;IACf,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAmB,EAAE,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,SAAS,CACtB,UAAkB,EAClB,UAAkB,EAClB,KAAa,EACb,OAAsB;IAEtB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACxD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAuB;IAC9D,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEtG,0DAA0D;IAC1D,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IAExC,0EAA0E;IAC1E,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEzC,aAAa;IACb,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAExD,4DAA4D;IAC5D,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,oDAAoD,CAAC,CAAC;IACzF,CAAC;IAED,gFAAgF;IAChF,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAEvC,SAAS;IACT,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAExC,8EAA8E;IAC9E,MAAM,oBAAoB,GAAG,WAAW,IAAI,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,mCAAmC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAExE,mEAAmE;QACnE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;YACvC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,GAAG,QAAQ,UAAU,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC;QAErD,MAAM,OAAO,GAAkB;YAC7B,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,SAAS;YACjB,SAAS;YACT,YAAY,EAAE,oBAAoB;YAClC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACnB,qFAAqF;YACrF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3E,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC7B,aAAa,EAAE,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,cAAc,EAAE,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACxC,4FAA4F;gBAC5F,MAAM,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzE,YAAY,EAAE,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,gFAAgF;gBAChF,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACvE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,aAAa,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1B,eAAe,EAAE,cAAc;QAC/B,cAAc,EAAE,aAAa;QAC7B,aAAa,EAAE,YAAY;QAC3B,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,WAAW;KAC1B,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE9F,oCAAoC;IACpC,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAElD,+CAA+C;IAC/C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,SAAS,cAAc,uBAAuB,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,sBAAsB,cAAc,kCAAkC,CAAC,CAAC;QAC1F,CAAC;QACD,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,qCAAqC,cAAc,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,4CAA4C;IAC5C,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAEhD,kCAAkC;IAClC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAEjE,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,6DAA6D;IAC7D,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;gBACvC,QAAQ;gBACR,UAAU;gBACV,UAAU;gBACV,KAAK;gBACL,cAAc;gBACd,WAAW;aACZ,CAAC,CAAC;YAEH,0EAA0E;YAC1E,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,KAAK,CAAC,IAAI,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC;YAEjF,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,SAAS;oBACjB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,cAAc,EAAE,OAAO,CAAC,cAAc;iBACvC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,aAAa,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,UAAU;oBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,eAAe,EAAE,OAAO,CAAC,eAAe;oBACxC,cAAc,EAAE,OAAO,CAAC,cAAc;iBACvC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,oEAAoE;YACpE,WAAW,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,cAAc,EAAE,aAAa;QAC7B,aAAa,EAAE,YAAY;QAC3B,YAAY,EAAE,WAAW;QACzB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Backend proxy module for the Sound Connect bridge (STORY-008, ADR-002, ADR-003).
+ *
+ * Implements two operations against the backend `/mcp/:slug` endpoint:
+ *   1. fetchBackendTools — issues a `tools/list` JSON-RPC call and returns the tool list.
+ *   2. callBackendTool   — issues a `tools/call` JSON-RPC call and returns the result.
+ *
+ * Both operations authenticate via `Authorization: Bearer <token>` (ADR-003).
+ * The backend uses StreamableHTTPServerTransport in stateless mode — every call is an
+ * independent HTTP POST; no session handshake is required.
+ *
+ * ADR-011 error handling:
+ *   - 401 → BackendAuthError (token invalid / expired — user must re-login)
+ *   - 403 → BackendForbiddenError (peer not a member of this client)
+ *   - 429 → BackendRateLimitError (back off and retry)
+ *   - 5xx → BackendUnavailableError (backend unreachable / internal error)
+ *   - JSON parse failure → BackendProtocolError (unexpected response shape)
+ *
+ * These are surfaced as MCP tool errors in tools.ts — never as silent failures.
+ */
+/** A single tool entry as returned by the backend `tools/list` response. */
+export interface BackendTool {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, object>;
+        required?: string[];
+    };
+}
+/** Result of a `tools/call` forwarded to the backend. */
+export interface BackendToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError?: boolean;
+}
+/** The bearer token was rejected (401). Peer must re-run `login`. */
+export declare class BackendAuthError extends Error {
+    constructor(msg?: string);
+}
+/** Peer is not a member of the requested client (403). */
+export declare class BackendForbiddenError extends Error {
+    constructor(slug: string, hint?: string);
+}
+/** Backend is rate-limiting this peer (429). */
+export declare class BackendRateLimitError extends Error {
+    constructor(retryAfterMs?: number);
+}
+/** Backend returned a 5xx or was unreachable. */
+export declare class BackendUnavailableError extends Error {
+    constructor(status: number, msg?: string);
+}
+/** The backend response did not conform to the expected JSON-RPC shape. */
+export declare class BackendProtocolError extends Error {
+    constructor(detail: string);
+}
+/**
+ * Fetch the backend's tool list for the bound client.
+ *
+ * Sends `tools/list` JSON-RPC to `/mcp/:slug` with the peer's bearer token.
+ * Returns the tool array from the response; throws a typed BackendXxxError on failure.
+ *
+ * STORY-008 AC1: bridge fetches the backend tool list for the bound client.
+ */
+export declare function fetchBackendTools(backendUrl: string, slug: string, token: string): Promise<BackendTool[]>;
+/**
+ * Forward a tool call to the backend `/mcp/:slug` endpoint.
+ *
+ * Sends `tools/call` JSON-RPC with the provided arguments, authenticated via bearer token.
+ * Parses the result and returns it as a BackendToolResult.
+ *
+ * STORY-008 AC2: tool calls forwarded with Authorization: Bearer <token>.
+ * STORY-008 AC4: backend errors surface as MCP tool errors (isError: true), not exceptions.
+ */
+export declare function callBackendTool(backendUrl: string, slug: string, token: string, toolName: string, toolArgs: Record<string, unknown>): Promise<BackendToolResult>;
+//# sourceMappingURL=proxy.d.ts.map