@extentos/mcp-server 0.0.1

package/dist/tools/util/permissions.js

@@ -0,0 +1,165 @@
+// Shared derivations for spec → platform permissions / Info.plist / DAT needs.
+// Consumed by initSpec, generateConsumer, getPermissions, and validateSpec's stats.
+const ANDROID_MIN_SDK = 28;
+const ANDROID_COMPILE_SDK = 34;
+const ANDROID_TARGET_SDK = 34;
+const IOS_PRIVACY_STRINGS = {
+    NSCameraUsageDescription: "Used to capture photos and video from your glasses.",
+    NSMicrophoneUsageDescription: "Used to capture audio from your glasses for voice commands.",
+    NSSpeechRecognitionUsageDescription: "Used to transcribe voice commands from your glasses.",
+    NSLocationWhenInUseUsageDescription: "Used to deliver location-aware glasses experiences.",
+    NSBluetoothAlwaysUsageDescription: "Used to connect to your Meta Ray-Ban glasses.",
+};
+const IOS_REASONS = {
+    NSCameraUsageDescription: "capture_photo / capture_video block or video_frames / outgoing_video_stream.",
+    NSMicrophoneUsageDescription: "record_audio block, voice triggers, or audio_chunks / transcription_incremental stream.",
+    NSSpeechRecognitionUsageDescription: "voice_command / wake_word / push_to_talk trigger or transcription_incremental stream.",
+    NSLocationWhenInUseUsageDescription: "location_updated trigger.",
+    NSBluetoothAlwaysUsageDescription: "Required by Meta DAT SDK for all glasses connections.",
+};
+export function derivePermissions(blocks, streams, triggers) {
+    const set = new Set();
+    const add = (v) => set.add(v);
+    for (const b of blocks) {
+        if (b.type === "capture_photo" || b.type === "capture_video")
+            add("android.permission.CAMERA");
+        if (b.type === "capture_video" || b.type === "record_audio")
+            add("android.permission.RECORD_AUDIO");
+    }
+    for (const st of streams) {
+        if (st.type === "video_frames" || st.type === "outgoing_video_stream")
+            add("android.permission.CAMERA");
+        if (st.type === "audio_chunks" ||
+            st.type === "transcription_incremental" ||
+            st.type === "outgoing_audio_stream")
+            add("android.permission.RECORD_AUDIO");
+        add("android.permission.FOREGROUND_SERVICE");
+    }
+    for (const t of triggers) {
+        if (t.type === "voice_command" || t.type === "wake_word" || t.type === "push_to_talk")
+            add("android.permission.RECORD_AUDIO");
+        if (t.type === "location_updated")
+            add("android.permission.ACCESS_FINE_LOCATION");
+        if (t.type === "phone_notification_forwarded")
+            add("android.permission.BIND_NOTIFICATION_LISTENER_SERVICE");
+        if (t.type === "incoming_call_detected")
+            add("android.permission.READ_PHONE_STATE");
+    }
+    add("android.permission.BLUETOOTH_CONNECT");
+    add("android.permission.BLUETOOTH_SCAN");
+    add("android.permission.INTERNET");
+    return [...set].sort();
+}
+export function deriveAndroid(spec) {
+    const blocks = arr(spec.blocks);
+    const streams = arr(spec.streams);
+    const triggers = arr(spec.triggers);
+    const permissions = derivePermissions(blocks, streams, triggers);
+    const manifestEntries = permissions.map((p) => `<uses-permission android:name="${p}" />`);
+    const fgTypes = new Set();
+    for (const s of streams) {
+        if (s.type === "video_frames" || s.type === "outgoing_video_stream")
+            fgTypes.add("camera");
+        if (s.type === "audio_chunks" ||
+            s.type === "transcription_incremental" ||
+            s.type === "outgoing_audio_stream")
+            fgTypes.add("microphone");
+    }
+    const fgRequired = fgTypes.size > 0;
+    const fgDecl = fgRequired
+        ? `<service android:name=".extentos.ExtentosForegroundService" android:foregroundServiceType="${[...fgTypes].sort().join("|")}" android:exported="false" />`
+        : null;
+    return {
+        permissions,
+        manifestEntries,
+        foregroundService: {
+            required: fgRequired,
+            types: [...fgTypes].sort(),
+            declaration: fgDecl,
+        },
+        minimumSdk: ANDROID_MIN_SDK,
+        compileSdk: ANDROID_COMPILE_SDK,
+        targetSdk: ANDROID_TARGET_SDK,
+    };
+}
+export function deriveIos(spec) {
+    const blocks = arr(spec.blocks);
+    const streams = arr(spec.streams);
+    const triggers = arr(spec.triggers);
+    const needed = new Set();
+    needed.add("NSBluetoothAlwaysUsageDescription");
+    for (const b of blocks) {
+        if (b.type === "capture_photo" || b.type === "capture_video")
+            needed.add("NSCameraUsageDescription");
+        if (b.type === "capture_video" || b.type === "record_audio")
+            needed.add("NSMicrophoneUsageDescription");
+    }
+    for (const s of streams) {
+        if (s.type === "video_frames" || s.type === "outgoing_video_stream")
+            needed.add("NSCameraUsageDescription");
+        if (s.type === "audio_chunks" ||
+            s.type === "transcription_incremental" ||
+            s.type === "outgoing_audio_stream") {
+            needed.add("NSMicrophoneUsageDescription");
+            needed.add("NSSpeechRecognitionUsageDescription");
+        }
+    }
+    for (const t of triggers) {
+        if (t.type === "voice_command" || t.type === "wake_word" || t.type === "push_to_talk") {
+            needed.add("NSMicrophoneUsageDescription");
+            needed.add("NSSpeechRecognitionUsageDescription");
+        }
+        if (t.type === "location_updated")
+            needed.add("NSLocationWhenInUseUsageDescription");
+    }
+    const plistKeys = [...needed].sort().map((key) => ({
+        key,
+        value: IOS_PRIVACY_STRINGS[key] ?? "Required by this Extentos spec.",
+        reason: IOS_REASONS[key] ?? "Required by this Extentos spec.",
+    }));
+    return { plistKeys };
+}
+export function deriveMetaDat(spec) {
+    const blocks = arr(spec.blocks);
+    const streams = arr(spec.streams);
+    const scopes = new Set(["glasses.connection"]);
+    for (const b of blocks) {
+        if (b.type === "capture_photo")
+            scopes.add("glasses.camera.photo");
+        if (b.type === "capture_video")
+            scopes.add("glasses.camera.video");
+        if (b.type === "record_audio")
+            scopes.add("glasses.audio.record");
+    }
+    for (const s of streams) {
+        if (s.type === "video_frames" || s.type === "outgoing_video_stream")
+            scopes.add("glasses.camera.stream");
+        if (s.type === "audio_chunks" ||
+            s.type === "transcription_incremental" ||
+            s.type === "outgoing_audio_stream")
+            scopes.add("glasses.audio.stream");
+    }
+    return {
+        scopes: [...scopes].sort(),
+        registrationRequired: true,
+        registrationSteps: [
+            "Create a Meta for Developers app at https://developers.facebook.com/apps/.",
+            "Enable the Meta Wearables Developer Access Toolkit (DAT) product.",
+            "Add your Android package / iOS bundle ID to the app settings.",
+            "Copy the Meta App ID and Client Token into extentos.manifest.json (MVP) or platform config.",
+        ],
+    };
+}
+export function derivesInfoPlistPatch(spec) {
+    const { plistKeys } = deriveIos(spec);
+    if (!plistKeys.length)
+        return undefined;
+    const added = {};
+    for (const { key, value } of plistKeys)
+        added[key] = value;
+    return { added };
+}
+function arr(v) {
+    return Array.isArray(v) ? v : [];
+}
+//# sourceMappingURL=permissions.js.map

package/dist/tools/util/permissions.js.map

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

package/dist/tools/validation/validateSpec.d.ts

@@ -0,0 +1,22 @@
+export interface SpecValidationIssue {
+    path: string;
+    rule: string;
+    message: string;
+    suggestion?: string;
+}
+export interface SpecValidationResult {
+    status: "valid" | "invalid";
+    valid: boolean;
+    errors: SpecValidationIssue[];
+    warnings: SpecValidationIssue[];
+    stats: {
+        blocks: number;
+        streams: number;
+        triggers: number;
+        actions: number;
+        handlerNames: string[];
+        permissions: string[];
+    };
+}
+export declare function validateSpec(spec: unknown): SpecValidationResult;
+//# sourceMappingURL=validateSpec.d.ts.map

package/dist/tools/validation/validateSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSpec.d.ts","sourceRoot":"","sources":["../../../src/tools/validation/validateSpec.ts"],"names":[],"mappings":"AA6CA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACH;AAcD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAoKhE"}

package/dist/tools/validation/validateSpec.js

@@ -0,0 +1,370 @@
+// Full spec validator. Runs:
+//   1. JSON Schema (draft 2020-12) via ajv against the embedded extentos-spec.schema.json
+//   2. 12 cross-reference / semantic rules from SPEC_SCHEMA.md § Spec validation rules
+// Rule labels mirror the canonical numbering in the doc.
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { specSchema } from "../../generated/schemas.js";
+import { derivePermissions } from "../util/permissions.js";
+const TOGGLE_KEYS = new Set([
+    "listening_mode",
+    "camera_streaming_enabled",
+    "audio_capture_enabled",
+    "transcription_enabled",
+    "battery_save_mode",
+    "voice_confirmations",
+    "audio_video_coexistence_policy",
+    "privacy_mode",
+]);
+const HARDWARE_STATE_FIELDS = new Set([
+    "hardware_state.connected",
+    "hardware_state.thermal",
+    "hardware_state.battery",
+    "hardware_state.audio_route",
+]);
+const TRIGGER_PAYLOAD_PREFIX = "trigger_payload.";
+const TOGGLES_PREFIX = "toggles.";
+const HARDWARE_STATE_PREFIX = "hardware_state.";
+const WRAPPER_ACTION_TYPES = new Set(["retry_with_backoff", "when_connected"]);
+const AUDIO_ROUTES = new Set([
+    "glasses_speaker",
+    "phone_speaker",
+    "bluetooth_earbuds",
+    "wired_earbuds",
+]);
+const THERMAL_LEVELS = new Set(["none", "light", "moderate", "severe", "critical"]);
+const ID_PATTERN = /^[a-z][a-z0-9_]{0,31}$/;
+const TEMPLATE_PATTERN = /\{\{([a-zA-Z0-9_.]+)\}\}/g;
+let cachedAjv = null;
+let cachedValidate = null;
+function ensureAjv() {
+    if (cachedAjv && cachedValidate)
+        return { ajv: cachedAjv, validate: cachedValidate };
+    const ajv = new Ajv2020({ allErrors: true, strict: false });
+    const validate = ajv.compile(specSchema);
+    cachedAjv = ajv;
+    cachedValidate = validate;
+    return { ajv, validate };
+}
+export function validateSpec(spec) {
+    const errors = [];
+    const warnings = [];
+    const { validate } = ensureAjv();
+    const schemaOk = validate(spec);
+    if (!schemaOk && Array.isArray(validate.errors)) {
+        for (const e of validate.errors) {
+            errors.push({
+                path: e.instancePath || "/",
+                rule: `schema:${e.keyword}`,
+                message: e.message ?? "schema violation",
+            });
+        }
+    }
+    if (!spec || typeof spec !== "object") {
+        return emptyResult(errors, warnings);
+    }
+    const s = spec;
+    // Rule 1: extentos_version
+    if (!s.extentos_version) {
+        errors.push({
+            path: "/extentos_version",
+            rule: "R1:VersionMissing",
+            message: "extentos_version is required.",
+            suggestion: 'Add "extentos_version": "1.0" at the top level.',
+        });
+    }
+    else if (s.extentos_version !== "1.0") {
+        errors.push({
+            path: "/extentos_version",
+            rule: "R1:VersionUnknown",
+            message: `Unsupported extentos_version ${JSON.stringify(s.extentos_version)}; only "1.0" is valid for MVP.`,
+        });
+    }
+    // Rule 2: target.vendor
+    const target = s.target;
+    if (!target || !target.vendor) {
+        errors.push({
+            path: "/target/vendor",
+            rule: "R2:VendorMissing",
+            message: "target.vendor is required.",
+            suggestion: 'Add "target": { "vendor": "meta_rayban" }.',
+        });
+    }
+    else if (target.vendor !== "meta_rayban") {
+        errors.push({
+            path: "/target/vendor",
+            rule: "R2:VendorUnknown",
+            message: `Unknown target.vendor ${JSON.stringify(target.vendor)}; only "meta_rayban" is supported for MVP.`,
+        });
+    }
+    const blocks = Array.isArray(s.blocks) ? s.blocks : [];
+    const streams = Array.isArray(s.streams) ? s.streams : [];
+    const triggers = Array.isArray(s.triggers) ? s.triggers : [];
+    // Rule 5: id uniqueness & pattern across blocks, streams
+    const usedIds = new Map();
+    function claimId(where, value, path) {
+        if (typeof value !== "string")
+            return null;
+        if (!ID_PATTERN.test(value)) {
+            errors.push({
+                path,
+                rule: "R5:IdPattern",
+                message: `id "${value}" must match ${ID_PATTERN}.`,
+            });
+            return null;
+        }
+        const prior = usedIds.get(value);
+        if (prior) {
+            errors.push({
+                path,
+                rule: "R5:IdDuplicate",
+                message: `id "${value}" is already used in ${prior}.`,
+            });
+            return null;
+        }
+        usedIds.set(value, where);
+        return value;
+    }
+    blocks.forEach((b, i) => claimId(`blocks[${i}]`, b.id, `/blocks/${i}/id`));
+    streams.forEach((st, i) => claimId(`streams[${i}]`, st.id, `/streams/${i}/id`));
+    // Triggers participate in id uniqueness per the same rule surface
+    triggers.forEach((t, i) => {
+        if (t.id !== undefined)
+            claimId(`triggers[${i}]`, t.id, `/triggers/${i}/id`);
+    });
+    // Rule 8: only one fallback trigger
+    const fallbackCount = triggers.filter((t) => t.type === "fallback").length;
+    if (fallbackCount > 1) {
+        errors.push({
+            path: "/triggers",
+            rule: "R8:FallbackOnce",
+            message: `Found ${fallbackCount} fallback triggers; at most one is allowed.`,
+        });
+    }
+    // Rule 7: mode: parallel reserved
+    triggers.forEach((t, i) => {
+        if (t.mode === "parallel") {
+            errors.push({
+                path: `/triggers/${i}/mode`,
+                rule: "R7:ParallelReserved",
+                message: 'mode: "parallel" is reserved and not allowed.',
+                suggestion: "Use mode: restart | single | queued.",
+            });
+        }
+    });
+    // Per-trigger action walking — branch depth, wrapper nesting, set_toggle keys, template refs
+    const blockIds = new Set(blocks.map((b) => b.id).filter((x) => typeof x === "string"));
+    const handlerNames = new Set();
+    let actionCount = 0;
+    triggers.forEach((trigger, ti) => {
+        const triggerPath = `/triggers/${ti}`;
+        const knownVars = new Set();
+        if (trigger.type === "voice_command" && typeof trigger.phrase === "string") {
+            // Named captures are promoted to top-level variables
+            const capturePattern = /\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g;
+            let m;
+            while ((m = capturePattern.exec(trigger.phrase)) !== null) {
+                knownVars.add(m[1]);
+            }
+        }
+        const actions = Array.isArray(trigger.actions) ? trigger.actions : [];
+        walkActions(actions, `${triggerPath}/actions`, 0, knownVars, {
+            errors,
+            warnings,
+            blockIds,
+            handlerNames,
+            countAction: () => actionCount++,
+        });
+    });
+    // Validate block_call references to block ids
+    triggers.forEach((trigger, ti) => {
+        const actions = Array.isArray(trigger.actions) ? trigger.actions : [];
+        actions.forEach((a, ai) => checkBlockCallRefs(a, `/triggers/${ti}/actions/${ai}`, blockIds, errors));
+    });
+    // Derived permissions (minimal surface — expanded by getPermissions tool)
+    const permissions = derivePermissions(blocks, streams, triggers);
+    const valid = errors.length === 0;
+    return {
+        status: valid ? "valid" : "invalid",
+        valid,
+        errors,
+        warnings,
+        stats: {
+            blocks: blocks.length,
+            streams: streams.length,
+            triggers: triggers.length,
+            actions: actionCount,
+            handlerNames: [...handlerNames].sort(),
+            permissions,
+        },
+    };
+}
+function walkActions(actions, basePath, branchDepth, knownVars, ctx, inWrapper = false) {
+    actions.forEach((action, idx) => {
+        ctx.countAction();
+        const path = `${basePath}/${idx}`;
+        const type = action.type;
+        if (type === "branch") {
+            // Rule 3
+            if (branchDepth >= 1) {
+                ctx.errors.push({
+                    path,
+                    rule: "R3:BranchDepth",
+                    message: "branch is nested inside another branch; max depth is 1.",
+                    suggestion: "Flatten the logic using sibling actions or a set_variable gate.",
+                });
+            }
+            checkTemplatesInObject(action.condition, `${path}/condition`, knownVars, ctx);
+            const thenActions = Array.isArray(action.then) ? action.then : [];
+            const elseActions = Array.isArray(action.else) ? action.else : [];
+            walkActions(thenActions, `${path}/then`, branchDepth + 1, knownVars, ctx, inWrapper);
+            walkActions(elseActions, `${path}/else`, branchDepth + 1, knownVars, ctx, inWrapper);
+            return;
+        }
+        if (type === "set_toggle") {
+            const key = action.key;
+            if (typeof key !== "string" || !TOGGLE_KEYS.has(key)) {
+                ctx.errors.push({
+                    path: `${path}/key`,
+                    rule: "R10:UnknownToggle",
+                    message: `set_toggle.key ${JSON.stringify(key)} is not a known toggle name.`,
+                    suggestion: `Known toggles: ${[...TOGGLE_KEYS].sort().join(", ")}.`,
+                });
+            }
+        }
+        if (type === "retry_with_backoff" || type === "when_connected") {
+            if (inWrapper) {
+                ctx.errors.push({
+                    path,
+                    rule: "R11:WrapperNesting",
+                    message: `${type} cannot be nested inside another wrapper action.`,
+                });
+            }
+            // Rule 12: when_connected.require predicates
+            if (type === "when_connected" && Array.isArray(action.require)) {
+                for (let i = 0; i < action.require.length; i++) {
+                    const pred = action.require[i];
+                    if (typeof pred !== "string" || !isValidWhenConnectedPredicate(pred)) {
+                        ctx.errors.push({
+                            path: `${path}/require/${i}`,
+                            rule: "R12:UnknownPredicate",
+                            message: `when_connected.require predicate ${JSON.stringify(pred)} is not a known form.`,
+                            suggestion: "Valid: connected, phone_battery_above:<0-100>, thermal_below:<level>, audio_route:<route>, toggle_on:<key>, toggle_off:<key>.",
+                        });
+                    }
+                }
+            }
+            // Wrappers contain a single nested action
+            const wrapped = action.action;
+            if (wrapped) {
+                if (typeof wrapped.type === "string" && WRAPPER_ACTION_TYPES.has(wrapped.type)) {
+                    ctx.errors.push({
+                        path: `${path}/action`,
+                        rule: "R11:WrapperNesting",
+                        message: `${type} wraps a ${wrapped.type}; wrapper actions may not nest other wrapper actions.`,
+                    });
+                }
+                walkActions([wrapped], `${path}/action`, branchDepth, knownVars, ctx, true);
+            }
+            return;
+        }
+        // Variables produced by this action flow forward
+        if (type === "block_call" && typeof action.save_as === "string") {
+            knownVars.add(action.save_as);
+        }
+        if (type === "app_callback") {
+            if (typeof action.handler === "string")
+                ctx.handlerNames.add(action.handler);
+            if (typeof action.save_as === "string")
+                knownVars.add(action.save_as);
+        }
+        if (type === "set_variable" && typeof action.name === "string") {
+            knownVars.add(action.name);
+        }
+        if (type === "prompt" && typeof action.save_as === "string") {
+            knownVars.add(action.save_as);
+        }
+        checkTemplatesInObject(action, path, knownVars, ctx);
+    });
+}
+function isValidWhenConnectedPredicate(p) {
+    if (p === "connected")
+        return true;
+    const batteryMatch = /^phone_battery_above:(\d{1,3})$/.exec(p);
+    if (batteryMatch) {
+        const n = Number(batteryMatch[1]);
+        return n >= 0 && n <= 100;
+    }
+    const thermalMatch = /^thermal_below:(\w+)$/.exec(p);
+    if (thermalMatch)
+        return THERMAL_LEVELS.has(thermalMatch[1]);
+    const audioMatch = /^audio_route:(\w+)$/.exec(p);
+    if (audioMatch)
+        return AUDIO_ROUTES.has(audioMatch[1]);
+    const toggleMatch = /^toggle_(on|off):(\w+)$/.exec(p);
+    if (toggleMatch)
+        return TOGGLE_KEYS.has(toggleMatch[2]);
+    return false;
+}
+function checkTemplatesInObject(obj, path, knownVars, ctx) {
+    walkTemplates(obj, path, (template, ownerPath) => {
+        const root = template.split(".")[0];
+        if (template.startsWith(TOGGLES_PREFIX) ||
+            template.startsWith(HARDWARE_STATE_PREFIX) ||
+            template.startsWith(TRIGGER_PAYLOAD_PREFIX) ||
+            HARDWARE_STATE_FIELDS.has(template)) {
+            return;
+        }
+        if (knownVars.has(root))
+            return;
+        ctx.errors.push({
+            path: ownerPath,
+            rule: "R6:TemplateUnresolved",
+            message: `Template {{${template}}} does not resolve to any variable written earlier, toggle, trigger_payload, or hardware_state.`,
+            suggestion: "Produce the variable earlier in the flow via block_call.save_as / app_callback.save_as / set_variable, or reference toggles.<key>, trigger_payload.<field>, or hardware_state.<field>.",
+        });
+    });
+}
+function walkTemplates(v, path, onFound) {
+    if (typeof v === "string") {
+        let m;
+        TEMPLATE_PATTERN.lastIndex = 0;
+        while ((m = TEMPLATE_PATTERN.exec(v)) !== null) {
+            onFound(m[1], path);
+        }
+        return;
+    }
+    if (Array.isArray(v)) {
+        v.forEach((item, i) => walkTemplates(item, `${path}/${i}`, onFound));
+        return;
+    }
+    if (v && typeof v === "object") {
+        for (const [k, val] of Object.entries(v)) {
+            walkTemplates(val, `${path}/${k}`, onFound);
+        }
+    }
+}
+function checkBlockCallRefs(action, path, blockIds, errors) {
+    if (action.type === "block_call" && typeof action.block_id === "string" && !blockIds.has(action.block_id)) {
+        errors.push({
+            path: `${path}/block_id`,
+            rule: "X:UnknownBlockRef",
+            message: `block_call references block_id "${action.block_id}" which is not declared in the blocks array.`,
+        });
+    }
+    if (action.type === "branch") {
+        const thenA = Array.isArray(action.then) ? action.then : [];
+        const elseA = Array.isArray(action.else) ? action.else : [];
+        thenA.forEach((a, i) => checkBlockCallRefs(a, `${path}/then/${i}`, blockIds, errors));
+        elseA.forEach((a, i) => checkBlockCallRefs(a, `${path}/else/${i}`, blockIds, errors));
+    }
+}
+function emptyResult(errors, warnings) {
+    return {
+        status: "invalid",
+        valid: false,
+        errors,
+        warnings,
+        stats: { blocks: 0, streams: 0, triggers: 0, actions: 0, handlerNames: [], permissions: [] },
+    };
+}
+//# sourceMappingURL=validateSpec.js.map

package/dist/tools/validation/validateSpec.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@extentos/mcp-server",
+  "version": "0.0.1",
+  "description": "Extentos MCP server — deterministic tools for building Meta-glasses apps.",
+  "type": "module",
+  "bin": {
+    "extentos-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/generate-embedded-schemas.mjs",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "cli": "node dist/cli.js",
+    "dev": "tsc --watch",
+    "typecheck": "npm run prebuild && tsc --noEmit",
+    "smoke": "npm run build && node scripts/example-flow-smoke.mjs",
+    "smoke:telemetry": "npm run build && node scripts/telemetry-smoke.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "meta-glasses",
+    "ray-ban",
+    "extentos",
+    "ai-agents",
+    "claude-code"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ajv": "^8.18.0",
+    "commander": "^12.1.0",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Asgermolgaard/vibe-hardware.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://github.com/Asgermolgaard/vibe-hardware/tree/master/mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/Asgermolgaard/vibe-hardware/issues"
+  },
+  "license": "MIT"
+}