@extentos/mcp-server 0.0.75 → 0.0.78

package/dist/tools/handlers/initSpec.js

@@ -1,350 +0,0 @@
-// initSpec — populate the first real spec + emit the ExtentosCallbacks dispatch template.
-// Spec: docs/mcp/MCP_TOOLS.md § initSpec
-// The MCP server has no filesystem — "refuse if spec already populated" is advisory
-// and enforced by the agent calling inspectIntegration first (see tool description).
-//
-// Manifest contract: when the agent passes `currentManifest` (the manifest
-// returned by inspectIntegration / generateConnectionModule), this tool
-// applies its patch in-memory and returns the full next-state manifest under
-// `manifest: { path, content }`. The agent overwrites the file verbatim, no
-// agent-side merging required. Falls back to returning only `manifestPatch`
-// when `currentManifest` is omitted (legacy callers).
-import { createHash } from "node:crypto";
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { androidSourcePath, iosModuleName } from "../util/appPackage.js";
-import { validateSpec } from "../validation/validateSpec.js";
-import { renderAndroidCallbacks, renderIosCallbacks } from "../templates/callbackHandler.js";
-import { PRESET_TRIGGERS, PRESET_TRIGGER_IDS } from "../data/presetTriggers.js";
-import { derivesInfoPlistPatch } from "../util/permissions.js";
-import { applyManifestPatch, manifestPath, } from "../util/manifest.js";
-import { okResponse, errorResponse } from "../response.js";
-import { hashGeneratedContent } from "../util/generatedHash.js";
-import { mergeUserCodeBlocks } from "../util/userCodeMerge.js";
-export function handleInitSpec(raw) {
-    const parsed = parseArgs(raw);
-    if ("error" in parsed)
-        return parsed.error;
-    const args = parsed.args;
-    const mergedTriggers = mergeTriggers(args.presetTriggers, args.triggers);
-    const spec = {
-        $schema: "extentos://schema/v1",
-        extentos_version: "1.0",
-        target: { vendor: "meta_rayban" },
-        blocks: args.blocks,
-        streams: args.streams,
-        triggers: mergedTriggers,
-    };
-    const validation = validateSpec(spec);
-    const specContent = JSON.stringify(spec, null, 2);
-    const specHash = sha256(specContent);
-    const nowIso = new Date().toISOString();
-    const handlerNames = validation.stats.handlerNames;
-    const rawFiles = buildFiles(args.platform, args.appPackage, handlerNames);
-    // If the agent passed projectPath, do server-side USER-CODE merge for any
-    // create_or_merge file that already exists on disk. The action is upgraded
-    // to "write" (verbatim) and the manifest hash is recomputed over the merged
-    // content so live-vs-recorded matches by construction. See
-    // util/userCodeMerge.ts for the full contract.
-    //
-    // F-R3-6: compute removed handler names from the manifest diff so true
-    // orphans (handler removed from spec) get the ORPHANED label, while
-    // developer-created shared utility blocks are preserved silently.
-    const removedHandlerNames = removedTrackedNamesFromManifest(args.currentManifest, handlerNames);
-    const files = rawFiles.map((f) => maybeMerge(f, args.projectPath, removedHandlerNames));
-    const specPath = specPathFor(args.platform, args.appPackage);
-    const permissionsDelta = args.platform === "android"
-        ? {
-            added: validation.stats.permissions,
-            manifestEntries: validation.stats.permissions.map((p) => `<uses-permission android:name="${p}" />`),
-        }
-        : undefined;
-    const infoPlistPatch = args.platform === "ios" ? derivesInfoPlistPatch(spec) : undefined;
-    // Same rationale as updateSpec: manifest.permissions reflects the spec,
-    // full-replace via permissionsSet so an empty/stale manifest self-heals on
-    // first init. validation.stats.permissions covers Android only — iOS uses
-    // Info.plist keys, which derivesInfoPlistPatch surfaces separately and which
-    // don't get tracked in manifest.permissions today.
-    const manifestPatch = {
-        lastUpdatedAt: nowIso,
-        integrationAdded: {
-            blocks: args.blocks.map((b) => b.type).filter((x) => typeof x === "string").sort(),
-            streams: args.streams.map((s) => s.type).filter((x) => typeof x === "string").sort(),
-            triggers: Array.from(new Set(mergedTriggers.map((t) => t.type).filter((x) => typeof x === "string"))).sort(),
-            handlerNames,
-            togglesOverridden: collectTogglesOverridden(mergedTriggers),
-        },
-        generatedFilesAdded: files.map((f) => ({
-            path: f.path,
-            template: "callback_handler",
-            hash: hashGeneratedContent(f.content),
-            generatedAt: nowIso,
-            generatedByTool: "initSpec",
-        })),
-        permissionsSet: args.platform === "android" ? [...validation.stats.permissions].sort() : undefined,
-        specUpdated: { path: specPath, hash: `sha256:${specHash}`, updatedAt: nowIso },
-    };
-    const summary = buildSummary(args, handlerNames, validation);
-    const response = {
-        spec: { path: specPath, content: spec },
-        files,
-        permissionsDelta,
-        validation: {
-            passed: validation.valid,
-            errors: validation.errors,
-            warnings: validation.warnings,
-        },
-        basedOn: { hash: `sha256:${specHash}`, timestamp: nowIso },
-        summary,
-    };
-    // Manifest contract (matches updateSpec, generateConsumer):
-    //   - currentManifest supplied → return `manifest: { path, content }` (full
-    //     next-state). Agent writes that file verbatim. manifestPatch is omitted
-    //     because two sources of truth invite double-apply bugs.
-    //   - currentManifest omitted → return `manifestPatch` only. Legacy fallback
-    //     for callers who haven't migrated to the round-trip pattern.
-    if (args.currentManifest) {
-        const next = applyManifestPatch(args.currentManifest, manifestPatch);
-        response.manifest = { path: manifestPath(), content: next };
-    }
-    else {
-        response.manifestPatch = manifestPatch;
-    }
-    if (infoPlistPatch)
-        response.infoPlistPatch = infoPlistPatch;
-    return okResponse(response);
-}
-function parseArgs(raw) {
-    if (!raw || typeof raw !== "object") {
-        return {
-            error: errorResponse({
-                code: "invalid_arguments",
-                message: "initSpec requires an object argument.",
-                fixHint: "Pass { blocks, triggers, platform, appPackage, ... }.",
-                retryable: false,
-            }),
-        };
-    }
-    const obj = raw;
-    if (!Array.isArray(obj.blocks)) {
-        return {
-            error: errorResponse({
-                code: "invalid_arguments",
-                message: "blocks is required and must be an array (may be empty).",
-                fixHint: "Pass blocks: []",
-                retryable: false,
-            }),
-        };
-    }
-    if (!Array.isArray(obj.triggers)) {
-        return {
-            error: errorResponse({
-                code: "invalid_arguments",
-                message: "triggers is required and must be an array.",
-                fixHint: "Pass triggers: [{ type, id, actions: [...] }, ...]",
-                retryable: false,
-            }),
-        };
-    }
-    if (obj.platform !== "android" && obj.platform !== "ios") {
-        return {
-            error: errorResponse({
-                code: "invalid_arguments",
-                message: `platform must be "android" or "ios" (got ${JSON.stringify(obj.platform)}).`,
-                fixHint: "Pass platform: \"android\" or \"ios\".",
-                retryable: false,
-            }),
-        };
-    }
-    if (typeof obj.appPackage !== "string" || obj.appPackage.length === 0) {
-        return {
-            error: errorResponse({
-                code: "invalid_arguments",
-                message: "appPackage is required and must be a non-empty string.",
-                fixHint: "Pass the developer's package/bundle id, e.g. com.example.myapp.",
-                retryable: false,
-            }),
-        };
-    }
-    const streams = Array.isArray(obj.streams) ? obj.streams : [];
-    const rawPreset = Array.isArray(obj.presetTriggers) ? obj.presetTriggers : [];
-    const presetTriggers = [];
-    for (const p of rawPreset) {
-        if (typeof p !== "string" || !PRESET_TRIGGER_IDS.includes(p)) {
-            return {
-                error: errorResponse({
-                    code: "invalid_arguments",
-                    message: `presetTriggers contains unknown preset ${JSON.stringify(p)}.`,
-                    fixHint: `Valid presets: ${PRESET_TRIGGER_IDS.join(", ")}.`,
-                    retryable: false,
-                }),
-            };
-        }
-        presetTriggers.push(p);
-    }
-    const currentManifest = obj.currentManifest && typeof obj.currentManifest === "object" && !Array.isArray(obj.currentManifest)
-        ? obj.currentManifest
-        : undefined;
-    const projectPath = typeof obj.projectPath === "string" && obj.projectPath ? obj.projectPath : undefined;
-    return {
-        args: {
-            blocks: obj.blocks,
-            streams,
-            triggers: obj.triggers,
-            presetTriggers,
-            platform: obj.platform,
-            appPackage: obj.appPackage,
-            currentManifest,
-            projectPath,
-        },
-    };
-}
-// Compute names that were tracked by the spec last cycle (per the manifest)
-// but aren't tracked now — the diff that lets the merge utility decide which
-// in-existing-only USER-CODE blocks are TRUE orphans (handler removed from
-// spec; gets ORPHANED label) vs developer-created shared utility blocks
-// (preserved silently). See util/userCodeMerge.ts MergeOptions.
-function removedTrackedNamesFromManifest(manifest, newHandlerNames) {
-    if (!manifest)
-        return [];
-    const integration = manifest.integration;
-    if (!integration)
-        return [];
-    const previousHandlers = Array.isArray(integration.handlerNames)
-        ? integration.handlerNames.filter((n) => typeof n === "string")
-        : [];
-    const previous = new Set([...previousHandlers, "imports"]);
-    const next = new Set([...newHandlerNames, "imports"]);
-    return [...previous].filter((n) => !next.has(n));
-}
-// When projectPath is provided, the action upgrades to "write" — the
-// server has done all the merge work the agent would otherwise have to
-// do, so the agent writes content verbatim. Two cases:
-//
-//   - File exists on disk: run the server-side USER-CODE merge,
-//     return action "write" with merged content + mergeReport.
-//   - File doesn't exist (fresh integration): nothing to merge, but
-//     still return action "write" with the raw template + an empty
-//     mergeReport. F-R3-4: previously returned "create_or_merge" in
-//     this case, contradicting the docstring "action becomes 'write'".
-//     Functionally equivalent (both = "write the file fresh") but the
-//     contract was inconsistent, so a strict agent that switches code
-//     paths on the action would do extra work for no reason.
-//
-// When projectPath is omitted, fall through to the legacy
-// create_or_merge contract (agent does its own merge).
-function maybeMerge(raw, projectPath, removedTrackedNames = []) {
-    if (!projectPath)
-        return { ...raw };
-    const abs = join(projectPath, raw.path);
-    if (!existsSync(abs)) {
-        return {
-            path: raw.path,
-            content: raw.content,
-            action: "write",
-            mergeReport: { preserved: [], orphaned: [], extra: [], warnings: [] },
-        };
-    }
-    const existing = readFileSync(abs, "utf8");
-    const result = mergeUserCodeBlocks(existing, raw.content, { removedTrackedNames });
-    return {
-        path: raw.path,
-        content: result.merged,
-        action: "write",
-        mergeReport: {
-            preserved: result.preserved,
-            orphaned: result.orphaned,
-            extra: result.extra,
-            warnings: result.warnings,
-        },
-    };
-}
-function mergeTriggers(presetIds, agentTriggers) {
-    const agentIds = new Set(agentTriggers.map((t) => t.id).filter((x) => typeof x === "string"));
-    const expanded = [];
-    for (const pid of presetIds) {
-        const preset = PRESET_TRIGGERS[pid];
-        if (agentIds.has(preset.id))
-            continue;
-        expanded.push(JSON.parse(JSON.stringify(preset)));
-    }
-    return [...expanded, ...agentTriggers];
-}
-function buildFiles(platform, appPackage, handlerNames) {
-    // ExtentosCallbacks.{kt,swift} always contains USER-CODE-START/END blocks
-    // for handler bodies, so the action MUST be `create_or_merge`. Previously
-    // emitted as `create`, which would tell the agent to overwrite — losing
-    // the dev's handler implementations on any re-emission. generateConsumer
-    // already emits this same file with create_or_merge; this fix aligns
-    // initSpec with that contract. See INTEGRATION_SHAPE.md § File-level actions.
-    if (platform === "android") {
-        const sourcePath = androidSourcePath(appPackage);
-        return [
-            {
-                path: `app/src/main/java/${sourcePath}/extentos/ExtentosCallbacks.kt`,
-                action: "create_or_merge",
-                content: renderAndroidCallbacks(appPackage, handlerNames),
-            },
-        ];
-    }
-    const moduleName = iosModuleName(appPackage);
-    return [
-        {
-            path: `Sources/${moduleName}/Extentos/ExtentosCallbacks.swift`,
-            action: "create_or_merge",
-            content: renderIosCallbacks(handlerNames),
-        },
-    ];
-}
-function specPathFor(platform, appPackage) {
-    if (platform === "android")
-        return "app/src/main/assets/extentos.spec.json";
-    const moduleName = iosModuleName(appPackage);
-    return `Sources/${moduleName}/Resources/extentos.spec.json`;
-}
-function collectTogglesOverridden(triggers) {
-    const keys = new Set();
-    const visit = (actions) => {
-        if (!Array.isArray(actions))
-            return;
-        for (const a of actions) {
-            if (!a || typeof a !== "object")
-                continue;
-            const rec = a;
-            if (rec.type === "set_toggle" && typeof rec.key === "string")
-                keys.add(rec.key);
-            if (rec.type === "branch") {
-                visit(rec.then);
-                visit(rec.else);
-            }
-            if (rec.type === "retry_with_backoff" || rec.type === "when_connected") {
-                if (rec.action)
-                    visit([rec.action]);
-            }
-        }
-    };
-    for (const t of triggers)
-        visit(t.actions);
-    return [...keys].sort();
-}
-function buildSummary(args, handlerNames, validation) {
-    const parts = [
-        `Generated spec with ${args.blocks.length} block${plural(args.blocks.length)}`,
-        `${args.streams.length} stream${plural(args.streams.length)}`,
-        `${args.triggers.length + args.presetTriggers.length} trigger${plural(args.triggers.length + args.presetTriggers.length)}`,
-    ];
-    const handlersPart = handlerNames.length
-        ? `Callback handler has ${handlerNames.length} handler stub${plural(handlerNames.length)}: ${handlerNames.join(", ")}.`
-        : `No app_callback handlers in this spec; ExtentosCallbacks is empty.`;
-    const validationPart = validation.valid
-        ? "Validation passed."
-        : `Validation failed with ${validation.errors.length} error${plural(validation.errors.length)} — see validation.errors.`;
-    return `${parts.join(", ")}. ${handlersPart} ${validationPart}`;
-}
-function plural(n) {
-    return n === 1 ? "" : "s";
-}
-function sha256(content) {
-    return createHash("sha256").update(content).digest("hex");
-}
-//# sourceMappingURL=initSpec.js.map

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

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

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

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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,CAgG9D"}

package/dist/tools/handlers/planIntegration.js

@@ -1,293 +0,0 @@
-// 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;
-    // Merge rule (documented in MCP_TOOLS.md § planIntegration):
-    //   1. KEYWORDS entries with a `pattern:` field are exclusive — only the
-    //      FIRST matching pattern entry contributes its primitives. This
-    //      prevents over-suggestion when a goal mentions both "voice notes"
-    //      (matches `voice_notes`) and "voice command" (matches
-    //      `voice_assistant`) — we emit only the voice_notes pattern's
-    //      primitives, not a noisy union of both.
-    //   2. KEYWORDS entries WITHOUT a `pattern:` field are additive (e.g.
-    //      `tap` adds the tap trigger; `music` adds speak_text). They stack
-    //      with the chosen pattern.
-    for (const kw of KEYWORDS) {
-        if (!kw.match.test(lower))
-            continue;
-        if (kw.pattern) {
-            if (referencePattern)
-                continue; // already locked in a pattern
-            referencePattern = kw.pattern;
-        }
-        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 (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].sort(),
-        suggestedPresets: [...presetTriggers],
-        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