@extentos/mcp-server 0.0.1

package/dist/tools/handlers/inspectIntegration.js

@@ -0,0 +1,204 @@
+// inspectIntegration — read-only snapshot of current Extentos integration.
+// Spec: docs/mcp/MCP_TOOLS.md § inspectIntegration
+// Reads manifest + spec + generated file hashes + dependency; emits basedOn freshness token.
+import { readFileSync, existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { join, isAbsolute, resolve } from "node:path";
+import { okResponse, errorResponse } from "../response.js";
+const GEN_MARKER = "EXTENTOS-GENERATED";
+export function handleInspectIntegration(raw) {
+    const args = (raw && typeof raw === "object" ? raw : {});
+    const projectPath = resolveProjectPath(args.projectPath);
+    const manifestPath = join(projectPath, "extentos.manifest.json");
+    if (!existsSync(manifestPath)) {
+        return okResponse({
+            found: false,
+            manifest: null,
+            spec: null,
+            basedOn: null,
+            generatedFilesStatus: [],
+            dependency: { found: false, coordinate: null, file: null },
+            drift: { specDrift: false, fileDrift: [], dependencyDrift: false },
+            connectionPageConfig: null,
+            gaps: [
+                `No extentos.manifest.json at ${manifestPath}. Run generateConnectionModule to bootstrap the project.`,
+            ],
+        });
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+    }
+    catch (e) {
+        return errorResponse({
+            code: "invalid_manifest",
+            message: `Failed to parse extentos.manifest.json: ${errMessage(e)}.`,
+            fixHint: "Re-run generateConnectionModule (will refuse to overwrite a valid manifest) or repair the file by hand.",
+            retryable: false,
+        });
+    }
+    const gaps = [];
+    const manifestVersion = manifest.manifestVersion;
+    if (manifestVersion !== 1) {
+        gaps.push(`manifestVersion is ${JSON.stringify(manifestVersion)} — this tool understands version 1 only.`);
+    }
+    const specInfo = manifest.spec ?? {};
+    const specRelPath = typeof specInfo.path === "string" ? specInfo.path : "";
+    const specAbsPath = specRelPath ? join(projectPath, specRelPath) : "";
+    let specContents = null;
+    let specRawText = "";
+    let specDrift = false;
+    if (!specRelPath) {
+        gaps.push("Manifest has no spec.path. Re-run generateConnectionModule.");
+    }
+    else if (!existsSync(specAbsPath)) {
+        gaps.push(`Spec file declared at ${specRelPath} is missing on disk.`);
+    }
+    else {
+        try {
+            specRawText = readFileSync(specAbsPath, "utf8");
+            specContents = JSON.parse(specRawText);
+            const canonical = JSON.stringify(specContents, null, 2);
+            const liveHash = `sha256:${sha256(canonical)}`;
+            const manifestHash = typeof specInfo.hash === "string" ? specInfo.hash : "";
+            if (manifestHash && manifestHash !== liveHash && manifestHash !== "sha256:empty") {
+                specDrift = true;
+            }
+        }
+        catch (e) {
+            gaps.push(`Spec file at ${specRelPath} is not valid JSON: ${errMessage(e)}.`);
+        }
+    }
+    const basedOnHash = specContents
+        ? `sha256:${sha256(JSON.stringify(specContents, null, 2))}`
+        : null;
+    const basedOn = basedOnHash
+        ? { hash: basedOnHash, timestamp: new Date().toISOString() }
+        : null;
+    const generatedFiles = Array.isArray(manifest.generatedFiles)
+        ? manifest.generatedFiles
+        : [];
+    const generatedFilesStatus = [];
+    const fileDrift = [];
+    for (const gf of generatedFiles) {
+        const rel = typeof gf.path === "string" ? gf.path : "";
+        const recordedHash = typeof gf.hash === "string" ? gf.hash : "";
+        if (!rel)
+            continue;
+        const abs = join(projectPath, rel);
+        const exists = existsSync(abs);
+        let hasMarker = false;
+        let hashMatch = false;
+        if (exists) {
+            const text = readFileSync(abs, "utf8");
+            hasMarker = text.includes(GEN_MARKER);
+            const liveHash = `sha256:${sha256(text)}`;
+            hashMatch = liveHash === recordedHash;
+            if (!hasMarker)
+                fileDrift.push({ path: rel, reason: "marker_absent" });
+            else if (!hashMatch)
+                fileDrift.push({ path: rel, reason: "hash_mismatch" });
+        }
+        else {
+            fileDrift.push({ path: rel, reason: "missing" });
+        }
+        generatedFilesStatus.push({ path: rel, exists, hasMarker, hashMatch });
+    }
+    const platform = typeof manifest.platform === "string" ? manifest.platform : undefined;
+    const dependency = inspectDependency(projectPath, platform, manifest);
+    const dependencyDrift = !dependency.found;
+    const connectionPageConfig = inspectConnectionPage(projectPath);
+    if (!dependency.found && platform === "android") {
+        gaps.push(`Gradle coordinate not found in ${dependency.file ?? "app/build.gradle.kts"}. Add the dependency or re-run generateConnectionModule.`);
+    }
+    else if (!dependency.found && platform === "ios") {
+        gaps.push(`SPM package not found in ${dependency.file ?? "Package.swift"}. Add the dependency or re-run generateConnectionModule.`);
+    }
+    return okResponse({
+        found: true,
+        manifest,
+        spec: specContents,
+        basedOn,
+        generatedFilesStatus,
+        dependency,
+        drift: { specDrift, fileDrift, dependencyDrift },
+        connectionPageConfig,
+        gaps,
+    });
+}
+function inspectDependency(projectPath, platform, manifest) {
+    if (platform === "android") {
+        const gradle = manifest.gradle;
+        const coord = typeof gradle?.coordinate === "string" ? gradle.coordinate : null;
+        const buildFile = typeof gradle?.buildFile === "string" ? gradle.buildFile : "app/build.gradle.kts";
+        const abs = join(projectPath, buildFile);
+        if (!coord || !existsSync(abs)) {
+            return { found: false, coordinate: coord, file: buildFile };
+        }
+        const text = readFileSync(abs, "utf8");
+        const coreId = coord.split(":").slice(0, 2).join(":");
+        return {
+            found: text.includes(coreId),
+            coordinate: coord,
+            file: buildFile,
+        };
+    }
+    if (platform === "ios") {
+        const spm = manifest.spm;
+        const pkg = typeof spm?.package === "string" ? spm.package : null;
+        const projectFile = typeof spm?.projectFile === "string" ? spm.projectFile : "Package.swift";
+        const abs = join(projectPath, projectFile);
+        if (!pkg || !existsSync(abs)) {
+            return { found: false, coordinate: pkg, file: projectFile };
+        }
+        const text = readFileSync(abs, "utf8");
+        return {
+            found: text.includes(pkg),
+            coordinate: pkg,
+            file: projectFile,
+        };
+    }
+    return { found: false, coordinate: null, file: null };
+}
+function inspectConnectionPage(projectPath) {
+    const candidates = [
+        "app/src/main/assets/extentos.connection-page.json",
+        "Resources/extentos.connection-page.json",
+        "extentos.connection-page.json",
+    ];
+    for (const rel of candidates) {
+        const abs = join(projectPath, rel);
+        if (!existsSync(abs))
+            continue;
+        try {
+            const parsed = JSON.parse(readFileSync(abs, "utf8"));
+            const knownKeys = new Set(["schemaVersion", "sections", "appearance"]);
+            const unknownFields = Object.keys(parsed).filter((k) => !knownKeys.has(k));
+            return {
+                path: rel,
+                exists: true,
+                schemaVersion: typeof parsed.schemaVersion === "number" ? parsed.schemaVersion : undefined,
+                sections: parsed.sections ?? undefined,
+                appearance: parsed.appearance ?? undefined,
+                unknownFields,
+            };
+        }
+        catch {
+            return { path: rel, exists: true, unknownFields: [] };
+        }
+    }
+    return null;
+}
+function sha256(text) {
+    return createHash("sha256").update(text).digest("hex");
+}
+function errMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+function resolveProjectPath(v) {
+    if (typeof v === "string" && v.length > 0) {
+        return isAbsolute(v) ? v : resolve(process.cwd(), v);
+    }
+    return process.cwd();
+}
+//# sourceMappingURL=inspectIntegration.js.map

package/dist/tools/handlers/inspectIntegration.js.map

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

package/dist/tools/handlers/planIntegration.d.ts

@@ -0,0 +1,3 @@
+import { type McpContent } from "../response.js";
+export declare function handlePlanIntegration(raw: unknown): McpContent;
+//# sourceMappingURL=planIntegration.d.ts.map

package/dist/tools/handlers/planIntegration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planIntegration.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/planIntegration.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAqG5E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAkF9D"}

package/dist/tools/handlers/planIntegration.js

@@ -0,0 +1,279 @@
+// planIntegration — map NL goal to deterministic tool-call sequence + primitive suggestions.
+// Spec: docs/mcp/MCP_TOOLS.md § planIntegration
+import { okResponse, errorResponse } from "../response.js";
+// Order matters: more specific phrases first.
+const KEYWORDS = [
+    {
+        match: /\btranslat(e|ion|or)\b/,
+        streams: ["transcription_incremental"],
+        handlers: ["translate"],
+        pattern: "live_translation",
+    },
+    {
+        match: /\b(notification|notify|alerts?)\b/,
+        triggers: ["phone_notification_forwarded"],
+        handlers: ["summarize_notification"],
+        pattern: "notification_reader",
+    },
+    {
+        match: /\b(describe|description|what.?s|identify|recognize|object|scene|see|look|vision)\b/,
+        blocks: ["capture_photo", "speak_text"],
+        triggers: ["voice_command"],
+        handlers: ["describe_image"],
+        pattern: "scene_description",
+    },
+    {
+        match: /\b(photo|picture|snapshot|capture)\b/,
+        blocks: ["capture_photo"],
+        triggers: ["voice_command", "capture_button"],
+        pattern: "scene_description",
+    },
+    {
+        match: /\bvideo\b/,
+        blocks: ["capture_video"],
+        triggers: ["voice_command"],
+    },
+    {
+        match: /\b(navigat|direction|way|route|map)\b/,
+        triggers: ["voice_command", "location_updated"],
+        handlers: ["get_directions"],
+        pattern: "navigation_guide",
+    },
+    {
+        match: /\b(call|phone|video.?call|meeting)\b/,
+        streams: ["outgoing_video_stream", "outgoing_audio_stream"],
+        pattern: "video_call",
+    },
+    {
+        match: /\bdetect(ion)?\b/,
+        streams: ["video_frames"],
+        handlers: ["detect_objects"],
+        pattern: "object_detection",
+    },
+    {
+        match: /\b(notes?|dictation|transcrib|memo)\b/,
+        blocks: ["record_audio"],
+        streams: ["transcription_incremental"],
+        triggers: ["voice_command"],
+        handlers: ["save_note"],
+        pattern: "voice_notes",
+    },
+    {
+        match: /\b(voice|speak|command|assistant|chat|ask|question)\b/,
+        triggers: ["voice_command"],
+        blocks: ["speak_text"],
+        handlers: ["answer_question"],
+        pattern: "voice_assistant",
+    },
+    {
+        match: /\b(music|audio|sound)\b/,
+        blocks: ["speak_text"],
+    },
+    {
+        match: /\b(tap|gesture)\b/,
+        triggers: ["tap"],
+    },
+    {
+        match: /\b(incoming.?call|ring)\b/,
+        triggers: ["incoming_call_detected"],
+    },
+];
+export function handlePlanIntegration(raw) {
+    const parsed = parseArgs(raw);
+    if ("error" in parsed)
+        return parsed.error;
+    const { goal, platform, hasExistingIntegration } = parsed;
+    const lower = goal.toLowerCase();
+    const blocks = new Set();
+    const streams = new Set();
+    const triggers = new Set();
+    const handlers = new Set();
+    let referencePattern = null;
+    for (const kw of KEYWORDS) {
+        if (!kw.match.test(lower))
+            continue;
+        kw.blocks?.forEach((b) => blocks.add(b));
+        kw.streams?.forEach((s) => streams.add(s));
+        kw.triggers?.forEach((t) => triggers.add(t));
+        kw.handlers?.forEach((h) => handlers.add(h));
+        if (kw.pattern && !referencePattern)
+            referencePattern = kw.pattern;
+    }
+    if (triggers.has("voice_command") && blocks.size === 0 && streams.size === 0) {
+        blocks.add("speak_text");
+    }
+    const warnings = [];
+    const presetTriggers = [];
+    if (triggers.has("voice_command") ||
+        triggers.has("wake_word") ||
+        triggers.has("push_to_talk")) {
+        presetTriggers.push("fallback_default");
+    }
+    if (streams.size > 0) {
+        presetTriggers.push("thermal_throttle");
+    }
+    if (streams.size > 0 && !triggers.has("connection_state_changed")) {
+        presetTriggers.push("disconnect_announce");
+    }
+    if (blocks.size + streams.size + triggers.size === 0) {
+        warnings.push("No primitives matched the goal keywords. Consider the 8 canonical patterns (use getExampleSpec) or rephrase the goal with concrete actions.");
+    }
+    if (triggers.has("voice_command") && blocks.has("speak_text") && handlers.size === 0) {
+        warnings.push("Voice-in/voice-out flow without an app_callback — confirm the AI processing step is intentional or add a handler.");
+    }
+    const toolSequence = buildToolSequence({
+        hasExistingIntegration: Boolean(hasExistingIntegration),
+        platform,
+        handlers: [...handlers],
+        streams: [...streams],
+        presetTriggers,
+        referencePattern,
+    });
+    const response = {
+        toolSequence,
+        suggestedBlocks: [...blocks].sort(),
+        suggestedStreams: [...streams].sort(),
+        suggestedTriggers: [...triggers, ...presetTriggers].sort(),
+        suggestedHandlers: [...handlers].sort(),
+        warnings,
+        estimatedSetupSteps: toolSequence.length,
+        referencePattern,
+        summary: buildSummary({
+            platform,
+            blocks: [...blocks],
+            streams: [...streams],
+            triggers: [...triggers],
+            handlers: [...handlers],
+            referencePattern,
+            hasExistingIntegration: Boolean(hasExistingIntegration),
+        }),
+    };
+    return okResponse(response);
+}
+function buildToolSequence(opts) {
+    const seq = [];
+    let step = 1;
+    seq.push({
+        step: step++,
+        tool: "getPlatformInfo",
+        params: { sections: ["version", "capabilities"], glasses: "meta_rayban" },
+        note: "Fetch library version and capability surface for the current glasses target.",
+    });
+    if (opts.referencePattern) {
+        seq.push({
+            step: step++,
+            tool: "getExampleSpec",
+            params: { pattern: opts.referencePattern },
+            note: `Grab the ${opts.referencePattern} reference spec as a starting point.`,
+        });
+    }
+    if (!opts.hasExistingIntegration) {
+        seq.push({
+            step: step++,
+            tool: "generateConnectionModule",
+            params: { platform: opts.platform, glasses: "meta_rayban" },
+            note: "One-shot project scaffold: bootstrap, manifest, dependency, empty spec.",
+        });
+        seq.push({
+            step: step++,
+            tool: "initSpec",
+            params: opts.presetTriggers.length
+                ? { platform: opts.platform, presetTriggers: opts.presetTriggers }
+                : { platform: opts.platform },
+            note: "Populate the first real spec with blocks/streams/triggers from the example + keyword matches.",
+        });
+    }
+    else {
+        seq.push({
+            step: step++,
+            tool: "inspectIntegration",
+            note: "Read current integration state (manifest + spec + file hashes) to get the basedOn freshness token.",
+        });
+        seq.push({
+            step: step++,
+            tool: "updateSpec",
+            note: "Apply the new primitives as patch operations against the inspected basedOn.",
+        });
+    }
+    if (opts.handlers.length) {
+        seq.push({
+            step: step++,
+            tool: "generateConsumer",
+            params: {
+                kind: "callback",
+                platform: opts.platform,
+                handlers: opts.handlers.map((name) => ({ name })),
+            },
+            note: `Stub the ${opts.handlers.length} app_callback handler${opts.handlers.length === 1 ? "" : "s"} on ${opts.platform}.`,
+        });
+    }
+    if (opts.streams.length) {
+        seq.push({
+            step: step++,
+            tool: "generateConsumer",
+            params: {
+                kind: "stream",
+                platform: opts.platform,
+                streams: opts.streams.map((id) => ({ id, type: id })),
+            },
+            note: `Generate stream consumer scaffolds for ${opts.streams.length} stream${opts.streams.length === 1 ? "" : "s"}.`,
+        });
+    }
+    seq.push({
+        step: step++,
+        tool: "validateIntegration",
+        note: "Pre-testing correctness gate: spec + files + manifest + permissions + handler coverage.",
+    });
+    seq.push({
+        step: step++,
+        tool: "createSimulatorSession",
+        note: "Provision a browser simulator session to test the flow end-to-end.",
+    });
+    return seq;
+}
+function buildSummary(opts) {
+    const primitives = opts.blocks.length + opts.streams.length + opts.triggers.length + opts.handlers.length;
+    const origin = opts.hasExistingIntegration ? "existing project" : "new project";
+    const pattern = opts.referencePattern
+        ? ` Referenced pattern: ${opts.referencePattern}.`
+        : "";
+    return `Plan for ${origin} on ${opts.platform}: ${primitives} suggested primitive${primitives === 1 ? "" : "s"} (${opts.blocks.length} block${s(opts.blocks.length)}, ${opts.streams.length} stream${s(opts.streams.length)}, ${opts.triggers.length} trigger${s(opts.triggers.length)}, ${opts.handlers.length} handler${s(opts.handlers.length)}).${pattern}`;
+}
+function s(n) {
+    return n === 1 ? "" : "s";
+}
+function parseArgs(raw) {
+    if (!raw || typeof raw !== "object") {
+        return {
+            error: errorResponse({
+                code: "invalid_arguments",
+                message: "planIntegration requires { goal, platform, glasses }.",
+                fixHint: 'Pass { goal: "...", platform: "android" | "ios", glasses: "meta_rayban" }.',
+                retryable: false,
+            }),
+        };
+    }
+    const obj = raw;
+    if (typeof obj.goal !== "string" || !obj.goal.trim()) {
+        return errInvalid("goal is required and must be a non-empty string.", 'Pass goal: "<plain-English goal>".');
+    }
+    if (obj.platform !== "android" && obj.platform !== "ios") {
+        return errInvalid(`platform must be "android" or "ios" (got ${JSON.stringify(obj.platform)}).`, 'Pass platform: "android" or "ios".');
+    }
+    return {
+        goal: obj.goal,
+        platform: obj.platform,
+        hasExistingIntegration: typeof obj.hasExistingIntegration === "boolean" ? obj.hasExistingIntegration : undefined,
+    };
+}
+function errInvalid(message, fixHint) {
+    return {
+        error: errorResponse({
+            code: "invalid_arguments",
+            message,
+            fixHint,
+            retryable: false,
+        }),
+    };
+}
+//# sourceMappingURL=planIntegration.js.map

package/dist/tools/handlers/planIntegration.js.map

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

package/dist/tools/handlers/searchDocs.d.ts

@@ -0,0 +1,3 @@
+import { type McpContent } from "../response.js";
+export declare function handleSearchDocs(raw: unknown): McpContent;
+//# sourceMappingURL=searchDocs.d.ts.map

package/dist/tools/handlers/searchDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchDocs.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/searchDocs.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAqCzD"}

package/dist/tools/handlers/searchDocs.js

@@ -0,0 +1,41 @@
+// searchDocs — deterministic keyword retrieval against the bundled doc index.
+// Spec: docs/mcp/MCP_TOOLS.md § searchDocs
+import { okResponse, errorResponse } from "../response.js";
+import { DOC_INDEX, searchDocsIndex } from "../docs/index.js";
+export function handleSearchDocs(raw) {
+    if (!raw || typeof raw !== "object") {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "searchDocs requires { query }.",
+            fixHint: 'Pass { query: "...", topic?: "..." }.',
+            retryable: false,
+        });
+    }
+    const obj = raw;
+    if (typeof obj.query !== "string" || !obj.query.trim()) {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "query is required and must be a non-empty string.",
+            fixHint: "Pass a natural-language query or keyword.",
+            retryable: false,
+        });
+    }
+    const topicFilter = typeof obj.topic === "string" ? obj.topic : undefined;
+    if (topicFilter && !DOC_INDEX.some((e) => e.topic === topicFilter)) {
+        return errorResponse({
+            code: "unknown_topic",
+            message: `Topic ${JSON.stringify(topicFilter)} is not one of the 26 indexed topics.`,
+            fixHint: `Valid topics: ${DOC_INDEX.map((e) => e.topic).join(", ")}.`,
+            retryable: false,
+        });
+    }
+    const hits = searchDocsIndex(obj.query, topicFilter);
+    const results = hits.map((e) => ({
+        topic: e.topic,
+        title: e.title,
+        content: e.content,
+        relatedTools: e.relatedTools,
+    }));
+    return okResponse({ results, totalResults: results.length });
+}
+//# sourceMappingURL=searchDocs.js.map

package/dist/tools/handlers/searchDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchDocs.js","sourceRoot":"","sources":["../../../src/tools/handlers/searchDocs.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2CAA2C;AAE3C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,gCAAgC;YACzC,OAAO,EAAE,uCAAuC;YAChD,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACvD,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,mDAAmD;YAC5D,OAAO,EAAE,2CAA2C;YACpD,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,EAAE,CAAC;QACnE,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,SAAS,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,uCAAuC;YACpF,OAAO,EAAE,iBAAiB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACrE,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,YAAY,EAAE,CAAC,CAAC,YAAY;KAC7B,CAAC,CAAC,CAAC;IAEJ,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/tools/handlers/updateSpec.d.ts

@@ -0,0 +1,3 @@
+import { type McpContent } from "../response.js";
+export declare function handleUpdateSpec(raw: unknown): McpContent;
+//# sourceMappingURL=updateSpec.d.ts.map

package/dist/tools/handlers/updateSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateSpec.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/updateSpec.ts"],"names":[],"mappings":"AAQA,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA0C5E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAyHzD"}