@extentos/mcp-server 0.0.1

package/dist/generated/schemas.js

@@ -0,0 +1,2697 @@
+// AUTO-GENERATED by scripts/generate-embedded-schemas.mjs. Do not edit.
+// Source: repo-root /schemas/*.json
+// Regenerate via `npm run prebuild` or `npm run build`.
+export const specSchema = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "extentos://schema/v1",
+    "type": "object",
+    "required": [
+        "extentos_version",
+        "target",
+        "blocks",
+        "triggers"
+    ],
+    "additionalProperties": false,
+    "properties": {
+        "$schema": {
+            "type": "string",
+            "description": "Optional first key; custom URI extentos://schema/v1 for IDE autocomplete. No HTTPS mirror.",
+            "examples": [
+                "extentos://schema/v1"
+            ]
+        },
+        "extentos_version": {
+            "type": "string",
+            "enum": [
+                "1.0"
+            ],
+            "description": "Major.minor spec schema version. Only '1.0' is valid for MVP.",
+            "examples": [
+                "1.0"
+            ]
+        },
+        "target": {
+            "type": "object",
+            "required": [
+                "vendor"
+            ],
+            "additionalProperties": false,
+            "description": "Hardware vendor this spec is authored against.",
+            "properties": {
+                "vendor": {
+                    "type": "string",
+                    "enum": [
+                        "meta_rayban"
+                    ],
+                    "description": "Target glasses vendor. Only 'meta_rayban' is valid for MVP.",
+                    "examples": [
+                        "meta_rayban"
+                    ]
+                }
+            }
+        },
+        "blocks": {
+            "type": "array",
+            "description": "Declared hardware capture primitives. Can be empty. Max 64.",
+            "maxItems": 64,
+            "items": {
+                "$ref": "#/$defs/block"
+            }
+        },
+        "streams": {
+            "type": "array",
+            "description": "Declared continuous stream primitives. Optional. Max 16.",
+            "maxItems": 16,
+            "items": {
+                "$ref": "#/$defs/stream"
+            }
+        },
+        "triggers": {
+            "type": "array",
+            "description": "Declared trigger flows. Can be empty. Max 32.",
+            "maxItems": 32,
+            "items": {
+                "$ref": "#/$defs/trigger"
+            }
+        },
+        "derived": {
+            "type": "object",
+            "description": "Optional compiler-computed metadata. Library recomputes at load time.",
+            "additionalProperties": false,
+            "properties": {
+                "capabilities_used": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Union of capabilities referenced by blocks, streams, and triggers.",
+                    "examples": [
+                        [
+                            "camera",
+                            "microphone",
+                            "speaker"
+                        ]
+                    ]
+                },
+                "meta_registration_requirements": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "dat.scope.* entries for Meta Developer Center registration.",
+                    "examples": [
+                        [
+                            "dat.scope.camera",
+                            "dat.scope.microphone"
+                        ]
+                    ]
+                },
+                "requires_network": {
+                    "type": "boolean",
+                    "description": "True if spec contains any app_callback action.",
+                    "examples": [
+                        true
+                    ]
+                },
+                "requires_foreground_service": {
+                    "type": "boolean",
+                    "description": "True if spec declares continuous streams or always-on listening.",
+                    "examples": [
+                        true
+                    ]
+                }
+            }
+        }
+    },
+    "$defs": {
+        "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_]{0,31}$",
+            "description": "Identifier: lowercase start, a-z/0-9/underscore, max 32 chars.",
+            "examples": [
+                "main_camera",
+                "describe_scene"
+            ]
+        },
+        "resolution": {
+            "type": "string",
+            "enum": [
+                "LOW",
+                "MEDIUM",
+                "HIGH"
+            ],
+            "description": "Capture resolution preset.",
+            "examples": [
+                "MEDIUM"
+            ]
+        },
+        "backpressure": {
+            "type": "string",
+            "enum": [
+                "drop_oldest",
+                "drop_newest",
+                "suspend"
+            ],
+            "description": "Backpressure strategy when stream consumer is slow.",
+            "examples": [
+                "drop_oldest"
+            ]
+        },
+        "frame_rate": {
+            "type": "integer",
+            "enum": [
+                2,
+                7,
+                15,
+                24,
+                30
+            ],
+            "description": "Frames per second. 1-2 fps for ML workloads, 15+ for live streaming.",
+            "examples": [
+                15
+            ]
+        },
+        "block": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/block_capture_photo"
+                },
+                {
+                    "$ref": "#/$defs/block_capture_video"
+                },
+                {
+                    "$ref": "#/$defs/block_record_audio"
+                }
+            ]
+        },
+        "block_capture_photo": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "params"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "capture_photo",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "capture_photo"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "params": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "resolution": {
+                            "$ref": "#/$defs/resolution"
+                        },
+                        "format": {
+                            "type": "string",
+                            "enum": [
+                                "jpeg",
+                                "heic"
+                            ],
+                            "description": "Output image format. Default jpeg.",
+                            "examples": [
+                                "jpeg"
+                            ]
+                        }
+                    }
+                }
+            }
+        },
+        "block_capture_video": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "params"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "capture_video",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "capture_video"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "params": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "resolution": {
+                            "$ref": "#/$defs/resolution"
+                        },
+                        "duration_seconds": {
+                            "type": "number",
+                            "description": "Clip length. Greater than 0, at most 60. Default 10.",
+                            "examples": [
+                                10
+                            ]
+                        },
+                        "format": {
+                            "type": "string",
+                            "enum": [
+                                "mp4_hevc",
+                                "mp4_h264"
+                            ],
+                            "description": "Video container and codec. HEVC recommended.",
+                            "examples": [
+                                "mp4_hevc"
+                            ]
+                        },
+                        "include_audio": {
+                            "type": "boolean",
+                            "description": "When true, triggers A2DP/HFP audio-video coexistence constraint.",
+                            "examples": [
+                                false
+                            ]
+                        }
+                    }
+                }
+            }
+        },
+        "block_record_audio": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "params"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "record_audio",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "record_audio"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "params": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "max_duration_seconds": {
+                            "type": "number",
+                            "description": "Max recording length. Greater than 0, at most 60. Default 15.",
+                            "examples": [
+                                15
+                            ]
+                        },
+                        "silence_timeout_seconds": {
+                            "type": "number",
+                            "description": "Cut off after this much silence. Greater than 0, at most 10. Default 2.",
+                            "examples": [
+                                2
+                            ]
+                        },
+                        "quality": {
+                            "type": "string",
+                            "enum": [
+                                "standard",
+                                "high"
+                            ],
+                            "description": "Audio quality. Bounded by HFP 8 kHz mono.",
+                            "examples": [
+                                "standard"
+                            ]
+                        }
+                    }
+                }
+            }
+        },
+        "stream": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/stream_video_frames"
+                },
+                {
+                    "$ref": "#/$defs/stream_audio_chunks"
+                },
+                {
+                    "$ref": "#/$defs/stream_transcription_incremental"
+                },
+                {
+                    "$ref": "#/$defs/stream_outgoing_audio"
+                },
+                {
+                    "$ref": "#/$defs/stream_outgoing_video"
+                }
+            ]
+        },
+        "stream_video_frames": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "config"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "video_frames",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "video_frames"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "config": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "resolution": {
+                            "$ref": "#/$defs/resolution"
+                        },
+                        "frame_rate": {
+                            "$ref": "#/$defs/frame_rate"
+                        },
+                        "codec": {
+                            "type": "string",
+                            "enum": [
+                                "hvc1",
+                                "h264"
+                            ],
+                            "description": "Video codec. hvc1 enables background streaming.",
+                            "examples": [
+                                "hvc1"
+                            ]
+                        },
+                        "backpressure": {
+                            "$ref": "#/$defs/backpressure"
+                        }
+                    }
+                }
+            }
+        },
+        "stream_audio_chunks": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "config"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "audio_chunks",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "audio_chunks"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "config": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "chunk_millis": {
+                            "type": "integer",
+                            "description": "Chunk size in ms. Greater than 0. Default 20.",
+                            "examples": [
+                                20
+                            ]
+                        },
+                        "backpressure": {
+                            "$ref": "#/$defs/backpressure"
+                        }
+                    }
+                }
+            }
+        },
+        "stream_transcription_incremental": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "config"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "transcription_incremental",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "transcription_incremental"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "config": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "language": {
+                            "type": "string",
+                            "description": "BCP-47 language tag.",
+                            "examples": [
+                                "en-US"
+                            ]
+                        },
+                        "min_partial_confidence": {
+                            "type": "number",
+                            "description": "Min confidence 0.0-1.0 for partial transcripts. Default 0.3.",
+                            "examples": [
+                                0.3
+                            ]
+                        }
+                    }
+                }
+            }
+        },
+        "stream_outgoing_audio": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "config"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "outgoing_audio_stream",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "outgoing_audio_stream"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "config": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "chunk_millis": {
+                            "type": "integer",
+                            "description": "Chunk size in ms. Greater than 0. Default 20.",
+                            "examples": [
+                                20
+                            ]
+                        },
+                        "codec": {
+                            "type": "string",
+                            "enum": [
+                                "opus",
+                                "pcm_s16le"
+                            ],
+                            "description": "Outgoing audio codec.",
+                            "examples": [
+                                "opus"
+                            ]
+                        }
+                    }
+                }
+            }
+        },
+        "stream_outgoing_video": {
+            "type": "object",
+            "required": [
+                "type",
+                "id",
+                "config"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "outgoing_video_stream",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "outgoing_video_stream"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "config": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "resolution": {
+                            "$ref": "#/$defs/resolution"
+                        },
+                        "frame_rate": {
+                            "$ref": "#/$defs/frame_rate"
+                        },
+                        "codec": {
+                            "type": "string",
+                            "enum": [
+                                "hvc1",
+                                "h264"
+                            ],
+                            "description": "Outgoing video codec.",
+                            "examples": [
+                                "hvc1"
+                            ]
+                        }
+                    }
+                }
+            }
+        },
+        "trigger_mode": {
+            "type": "string",
+            "enum": [
+                "restart",
+                "single",
+                "queued"
+            ],
+            "description": "Concurrency mode. 'parallel' is reserved and will fail load.",
+            "examples": [
+                "restart"
+            ]
+        },
+        "trigger_on_failure": {
+            "type": "string",
+            "enum": [
+                "continue",
+                "abort"
+            ],
+            "description": "Default failure policy for block/app_callback failures.",
+            "examples": [
+                "continue"
+            ]
+        },
+        "trigger_display": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Presentational metadata for connection UI. Ignored by interpreter.",
+            "properties": {
+                "label": {
+                    "type": "string",
+                    "maxLength": 48,
+                    "description": "Button label override; max 48 chars.",
+                    "examples": [
+                        "Describe Scene"
+                    ]
+                }
+            }
+        },
+        "trigger": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/trigger_voice_command"
+                },
+                {
+                    "$ref": "#/$defs/trigger_wake_word"
+                },
+                {
+                    "$ref": "#/$defs/trigger_push_to_talk"
+                },
+                {
+                    "$ref": "#/$defs/trigger_manual_launch"
+                },
+                {
+                    "$ref": "#/$defs/trigger_fallback"
+                },
+                {
+                    "$ref": "#/$defs/trigger_connection_state_changed"
+                },
+                {
+                    "$ref": "#/$defs/trigger_hinges_closed"
+                },
+                {
+                    "$ref": "#/$defs/trigger_thermal_warning"
+                },
+                {
+                    "$ref": "#/$defs/trigger_audio_route_changed"
+                },
+                {
+                    "$ref": "#/$defs/trigger_phone_notification_forwarded"
+                },
+                {
+                    "$ref": "#/$defs/trigger_location_updated"
+                },
+                {
+                    "$ref": "#/$defs/trigger_incoming_call_detected"
+                },
+                {
+                    "$ref": "#/$defs/trigger_app_lifecycle_changed"
+                }
+            ]
+        },
+        "trigger_common_tail": {
+            "type": "object",
+            "properties": {
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "description": "Sequence of actions to run when trigger fires.",
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_voice_command": {
+            "type": "object",
+            "required": [
+                "type",
+                "phrase",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "voice_command",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "voice_command"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "phrase": {
+                    "type": "string",
+                    "description": "Spoken phrase. Supports named captures via {name}.",
+                    "examples": [
+                        "describe what you see",
+                        "set a timer for {duration}"
+                    ]
+                },
+                "match_mode": {
+                    "type": "string",
+                    "enum": [
+                        "exact",
+                        "starts_with",
+                        "contains"
+                    ],
+                    "description": "Phrase match mode. Default contains.",
+                    "examples": [
+                        "contains"
+                    ]
+                },
+                "min_confidence": {
+                    "type": "number",
+                    "description": "Min STT confidence 0.0-1.0. Default 0.5.",
+                    "examples": [
+                        0.5
+                    ]
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_wake_word": {
+            "type": "object",
+            "required": [
+                "type",
+                "phrase",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "wake_word",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "wake_word"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "phrase": {
+                    "type": "string",
+                    "description": "Wake word. Built-in: 'hey assistant', 'ok glasses', 'computer'.",
+                    "examples": [
+                        "hey assistant"
+                    ]
+                },
+                "model_path": {
+                    "type": "string",
+                    "description": "Optional Picovoice Porcupine custom model path.",
+                    "examples": [
+                        "assets/custom.ppn"
+                    ]
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_push_to_talk": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "push_to_talk",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "push_to_talk"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_manual_launch": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "manual_launch",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "manual_launch"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_fallback": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "description": "Fires when no voice_command matched. At most one per spec.",
+            "properties": {
+                "type": {
+                    "const": "fallback",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "fallback"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_connection_state_changed": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "connection_state_changed",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "connection_state_changed"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "on_transition": {
+                    "type": "object",
+                    "required": [
+                        "to"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Filter which transitions fire this trigger. Bucket-only matching.",
+                    "properties": {
+                        "from": {
+                            "type": "string",
+                            "enum": [
+                                "NotRegistered",
+                                "Registered",
+                                "DeviceDiscovered",
+                                "Connecting",
+                                "Connected",
+                                "SessionActive",
+                                "StreamActive",
+                                "Disconnected"
+                            ],
+                            "description": "Source state bucket.",
+                            "examples": [
+                                "Connected"
+                            ]
+                        },
+                        "to": {
+                            "type": "string",
+                            "enum": [
+                                "NotRegistered",
+                                "Registered",
+                                "DeviceDiscovered",
+                                "Connecting",
+                                "Connected",
+                                "SessionActive",
+                                "StreamActive",
+                                "Disconnected"
+                            ],
+                            "description": "Destination state bucket.",
+                            "examples": [
+                                "Disconnected"
+                            ]
+                        }
+                    }
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_hinges_closed": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "hinges_closed",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "hinges_closed"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_thermal_warning": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "thermal_warning",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "thermal_warning"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "severity": {
+                    "type": "string",
+                    "enum": [
+                        "light",
+                        "moderate",
+                        "severe",
+                        "critical"
+                    ],
+                    "description": "Fires when thermal state crosses this level going up. Default moderate.",
+                    "examples": [
+                        "moderate"
+                    ]
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_audio_route_changed": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "audio_route_changed",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "audio_route_changed"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_phone_notification_forwarded": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "phone_notification_forwarded",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "phone_notification_forwarded"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_location_updated": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "location_updated",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "location_updated"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "min_interval_millis": {
+                    "type": "integer",
+                    "description": "Min interval between firings in ms. Greater than 0. Default 5000.",
+                    "examples": [
+                        5000
+                    ]
+                },
+                "min_displacement_meters": {
+                    "type": "number",
+                    "description": "Min displacement before firing in meters. At least 0. Default 10.",
+                    "examples": [
+                        10
+                    ]
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_incoming_call_detected": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "incoming_call_detected",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "incoming_call_detected"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "trigger_app_lifecycle_changed": {
+            "type": "object",
+            "required": [
+                "type",
+                "actions"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "app_lifecycle_changed",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "app_lifecycle_changed"
+                    ]
+                },
+                "id": {
+                    "$ref": "#/$defs/id"
+                },
+                "to": {
+                    "type": "string",
+                    "enum": [
+                        "foreground",
+                        "background",
+                        "destroyed"
+                    ],
+                    "description": "Only fire on transitions TO this state.",
+                    "examples": [
+                        "background"
+                    ]
+                },
+                "mode": {
+                    "$ref": "#/$defs/trigger_mode"
+                },
+                "on_failure": {
+                    "$ref": "#/$defs/trigger_on_failure"
+                },
+                "display": {
+                    "$ref": "#/$defs/trigger_display"
+                },
+                "actions": {
+                    "type": "array",
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/action"
+                    }
+                }
+            }
+        },
+        "action": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/action_block_call"
+                },
+                {
+                    "$ref": "#/$defs/action_app_callback"
+                },
+                {
+                    "$ref": "#/$defs/action_branch"
+                },
+                {
+                    "$ref": "#/$defs/action_set_variable"
+                },
+                {
+                    "$ref": "#/$defs/action_speak_text"
+                },
+                {
+                    "$ref": "#/$defs/action_earcon_beep"
+                },
+                {
+                    "$ref": "#/$defs/action_prompt"
+                },
+                {
+                    "$ref": "#/$defs/action_set_toggle"
+                },
+                {
+                    "$ref": "#/$defs/action_delay"
+                },
+                {
+                    "$ref": "#/$defs/action_abort"
+                },
+                {
+                    "$ref": "#/$defs/action_log"
+                },
+                {
+                    "$ref": "#/$defs/action_wait_for_connected"
+                },
+                {
+                    "$ref": "#/$defs/action_retry_with_backoff"
+                },
+                {
+                    "$ref": "#/$defs/action_buffer_and_replay"
+                },
+                {
+                    "$ref": "#/$defs/action_when_connected"
+                }
+            ]
+        },
+        "action_non_wrapper": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/action_block_call"
+                },
+                {
+                    "$ref": "#/$defs/action_app_callback"
+                },
+                {
+                    "$ref": "#/$defs/action_branch"
+                },
+                {
+                    "$ref": "#/$defs/action_set_variable"
+                },
+                {
+                    "$ref": "#/$defs/action_speak_text"
+                },
+                {
+                    "$ref": "#/$defs/action_earcon_beep"
+                },
+                {
+                    "$ref": "#/$defs/action_prompt"
+                },
+                {
+                    "$ref": "#/$defs/action_set_toggle"
+                },
+                {
+                    "$ref": "#/$defs/action_delay"
+                },
+                {
+                    "$ref": "#/$defs/action_abort"
+                },
+                {
+                    "$ref": "#/$defs/action_log"
+                },
+                {
+                    "$ref": "#/$defs/action_wait_for_connected"
+                },
+                {
+                    "$ref": "#/$defs/action_buffer_and_replay"
+                }
+            ]
+        },
+        "action_no_branch": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/action_block_call"
+                },
+                {
+                    "$ref": "#/$defs/action_app_callback"
+                },
+                {
+                    "$ref": "#/$defs/action_set_variable"
+                },
+                {
+                    "$ref": "#/$defs/action_speak_text"
+                },
+                {
+                    "$ref": "#/$defs/action_earcon_beep"
+                },
+                {
+                    "$ref": "#/$defs/action_prompt"
+                },
+                {
+                    "$ref": "#/$defs/action_set_toggle"
+                },
+                {
+                    "$ref": "#/$defs/action_delay"
+                },
+                {
+                    "$ref": "#/$defs/action_abort"
+                },
+                {
+                    "$ref": "#/$defs/action_log"
+                },
+                {
+                    "$ref": "#/$defs/action_wait_for_connected"
+                },
+                {
+                    "$ref": "#/$defs/action_retry_with_backoff"
+                },
+                {
+                    "$ref": "#/$defs/action_buffer_and_replay"
+                },
+                {
+                    "$ref": "#/$defs/action_when_connected"
+                }
+            ]
+        },
+        "action_block_call": {
+            "type": "object",
+            "required": [
+                "type",
+                "block_id"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "block_call",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "block_call"
+                    ]
+                },
+                "block_id": {
+                    "$ref": "#/$defs/id"
+                },
+                "save_as": {
+                    "$ref": "#/$defs/id"
+                }
+            }
+        },
+        "action_app_callback": {
+            "type": "object",
+            "required": [
+                "type",
+                "handler",
+                "input"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "app_callback",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "app_callback"
+                    ]
+                },
+                "handler": {
+                    "$ref": "#/$defs/id"
+                },
+                "input": {
+                    "type": "object",
+                    "description": "Input payload. String values support {{template}} substitution.",
+                    "examples": [
+                        {
+                            "image": "{{photo}}",
+                            "prompt": "Describe"
+                        }
+                    ]
+                },
+                "save_as": {
+                    "$ref": "#/$defs/id"
+                },
+                "timeout_ms": {
+                    "type": "integer",
+                    "description": "Handler timeout in ms. Greater than 0. Default 10000.",
+                    "examples": [
+                        10000
+                    ]
+                }
+            }
+        },
+        "action_branch": {
+            "type": "object",
+            "required": [
+                "type",
+                "condition",
+                "then"
+            ],
+            "additionalProperties": false,
+            "description": "Conditional. Max depth 1 — 'then' and 'else' arms must not contain another branch.",
+            "properties": {
+                "type": {
+                    "const": "branch",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "branch"
+                    ]
+                },
+                "condition": {
+                    "$ref": "#/$defs/branch_condition"
+                },
+                "then": {
+                    "type": "array",
+                    "description": "Actions when condition is true. No nested branch.",
+                    "items": {
+                        "$ref": "#/$defs/action_no_branch"
+                    }
+                },
+                "else": {
+                    "type": "array",
+                    "description": "Actions when condition is false. No nested branch.",
+                    "items": {
+                        "$ref": "#/$defs/action_no_branch"
+                    }
+                }
+            }
+        },
+        "action_set_variable": {
+            "type": "object",
+            "required": [
+                "type",
+                "name",
+                "value"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "set_variable",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "set_variable"
+                    ]
+                },
+                "name": {
+                    "$ref": "#/$defs/id"
+                },
+                "value": {
+                    "description": "Any JSON value. Strings support templates.",
+                    "examples": [
+                        "Hello {{user_name}}"
+                    ]
+                },
+                "fallback": {
+                    "description": "Written if value resolves to empty.",
+                    "examples": [
+                        "Hello friend"
+                    ]
+                }
+            }
+        },
+        "action_speak_text": {
+            "type": "object",
+            "required": [
+                "type",
+                "text"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "speak_text",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "speak_text"
+                    ]
+                },
+                "text": {
+                    "type": "string",
+                    "description": "Text to speak. Supports templates.",
+                    "examples": [
+                        "{{description}}"
+                    ]
+                },
+                "voice": {
+                    "type": "string",
+                    "description": "Optional voice id.",
+                    "examples": [
+                        "en-US-Wavenet-D"
+                    ]
+                },
+                "rate": {
+                    "type": "number",
+                    "description": "Playback rate 0.5-2.0. Default 1.0.",
+                    "examples": [
+                        1
+                    ]
+                },
+                "pitch": {
+                    "type": "number",
+                    "description": "Pitch -1.0 to 1.0. Default 0.0.",
+                    "examples": [
+                        0
+                    ]
+                },
+                "volume": {
+                    "type": "number",
+                    "description": "Volume 0.0-1.0. Default 1.0.",
+                    "examples": [
+                        1
+                    ]
+                },
+                "wait_for_completion": {
+                    "type": "boolean",
+                    "description": "Block flow until TTS finishes. Default true.",
+                    "examples": [
+                        true
+                    ]
+                }
+            }
+        },
+        "action_earcon_beep": {
+            "type": "object",
+            "required": [
+                "type",
+                "sound"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "earcon_beep",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "earcon_beep"
+                    ]
+                },
+                "sound": {
+                    "type": "string",
+                    "enum": [
+                        "confirmation",
+                        "error",
+                        "notification",
+                        "start",
+                        "stop"
+                    ],
+                    "description": "Earcon sound.",
+                    "examples": [
+                        "confirmation"
+                    ]
+                },
+                "volume": {
+                    "type": "number",
+                    "description": "Volume 0.0-1.0. Default 0.8.",
+                    "examples": [
+                        0.8
+                    ]
+                }
+            }
+        },
+        "action_prompt": {
+            "type": "object",
+            "required": [
+                "type",
+                "question",
+                "save_as"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "prompt",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "prompt"
+                    ]
+                },
+                "question": {
+                    "type": "string",
+                    "description": "Question to ask. Spoken via TTS. Supports templates.",
+                    "examples": [
+                        "For how long?"
+                    ]
+                },
+                "save_as": {
+                    "$ref": "#/$defs/id"
+                },
+                "timeout_seconds": {
+                    "type": "number",
+                    "description": "Response timeout. Greater than 0, at most 30. Default 5.",
+                    "examples": [
+                        5
+                    ]
+                },
+                "min_confidence": {
+                    "type": "number",
+                    "description": "Min STT confidence 0.0-1.0. Default 0.4.",
+                    "examples": [
+                        0.4
+                    ]
+                }
+            }
+        },
+        "action_set_toggle": {
+            "type": "object",
+            "required": [
+                "type",
+                "key",
+                "value"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "set_toggle",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "set_toggle"
+                    ]
+                },
+                "key": {
+                    "type": "string",
+                    "description": "Known toggle key (validated at load).",
+                    "examples": [
+                        "battery_save_mode"
+                    ]
+                },
+                "value": {
+                    "description": "Toggle value; type depends on key.",
+                    "examples": [
+                        true
+                    ]
+                }
+            }
+        },
+        "action_delay": {
+            "type": "object",
+            "required": [
+                "type",
+                "seconds"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "delay",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "delay"
+                    ]
+                },
+                "seconds": {
+                    "type": "number",
+                    "description": "Pause duration. Must be a literal number. Greater than 0, at most 3600.",
+                    "examples": [
+                        2
+                    ]
+                }
+            }
+        },
+        "action_abort": {
+            "type": "object",
+            "required": [
+                "type"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "abort",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "abort"
+                    ]
+                },
+                "reason": {
+                    "type": "string",
+                    "description": "Reason string.",
+                    "examples": [
+                        "user cancelled"
+                    ]
+                }
+            }
+        },
+        "action_log": {
+            "type": "object",
+            "required": [
+                "type",
+                "level",
+                "message"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "log",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "log"
+                    ]
+                },
+                "level": {
+                    "type": "string",
+                    "enum": [
+                        "debug",
+                        "info",
+                        "warning",
+                        "error"
+                    ],
+                    "description": "Log level.",
+                    "examples": [
+                        "info"
+                    ]
+                },
+                "message": {
+                    "type": "string",
+                    "description": "Log message. Supports templates.",
+                    "examples": [
+                        "flow started"
+                    ]
+                },
+                "payload": {
+                    "type": "object",
+                    "description": "Structured payload. String values support templates.",
+                    "examples": [
+                        {
+                            "photo_width": "{{photo.width}}"
+                        }
+                    ]
+                }
+            }
+        },
+        "action_wait_for_connected": {
+            "type": "object",
+            "required": [
+                "type",
+                "timeout_seconds"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "wait_for_connected",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "wait_for_connected"
+                    ]
+                },
+                "timeout_seconds": {
+                    "type": "number",
+                    "description": "Max wait. Greater than 0, at most 120. Aborts with connection_timeout on timeout.",
+                    "examples": [
+                        30
+                    ]
+                }
+            }
+        },
+        "action_retry_with_backoff": {
+            "type": "object",
+            "required": [
+                "type",
+                "action"
+            ],
+            "additionalProperties": false,
+            "description": "Wrapper action. Inner 'action' must be non-wrapper.",
+            "properties": {
+                "type": {
+                    "const": "retry_with_backoff",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "retry_with_backoff"
+                    ]
+                },
+                "action": {
+                    "$ref": "#/$defs/action_non_wrapper"
+                },
+                "max_attempts": {
+                    "type": "integer",
+                    "description": "Max attempts. Greater than 0. Default 3.",
+                    "examples": [
+                        3
+                    ]
+                },
+                "initial_delay_ms": {
+                    "type": "integer",
+                    "description": "Initial delay in ms. Greater than 0. Default 1000.",
+                    "examples": [
+                        1000
+                    ]
+                },
+                "multiplier": {
+                    "type": "number",
+                    "description": "Backoff multiplier. Greater than 0. Default 2.0.",
+                    "examples": [
+                        2
+                    ]
+                },
+                "max_delay_ms": {
+                    "type": "integer",
+                    "description": "Max delay in ms. Greater than 0. Default 30000.",
+                    "examples": [
+                        30000
+                    ]
+                },
+                "jitter": {
+                    "type": "number",
+                    "description": "Jitter fraction 0.0-1.0. Default 0.2.",
+                    "examples": [
+                        0.2
+                    ]
+                }
+            }
+        },
+        "action_buffer_and_replay": {
+            "type": "object",
+            "required": [
+                "type",
+                "event"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "type": {
+                    "const": "buffer_and_replay",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "buffer_and_replay"
+                    ]
+                },
+                "event": {
+                    "type": "string",
+                    "description": "Block type or trigger type to buffer.",
+                    "examples": [
+                        "capture_photo"
+                    ]
+                },
+                "max_buffered": {
+                    "type": "integer",
+                    "description": "Max buffered events. Greater than 0. Default 50.",
+                    "examples": [
+                        50
+                    ]
+                },
+                "on_overflow": {
+                    "type": "string",
+                    "enum": [
+                        "drop_oldest",
+                        "drop_newest"
+                    ],
+                    "description": "Overflow policy.",
+                    "examples": [
+                        "drop_oldest"
+                    ]
+                }
+            }
+        },
+        "action_when_connected": {
+            "type": "object",
+            "required": [
+                "type",
+                "require",
+                "action"
+            ],
+            "additionalProperties": false,
+            "description": "Wrapper action. Inner 'action' must be non-wrapper.",
+            "properties": {
+                "type": {
+                    "const": "when_connected",
+                    "description": "Discriminator.",
+                    "examples": [
+                        "when_connected"
+                    ]
+                },
+                "require": {
+                    "type": "array",
+                    "description": "Predicate strings. Valid forms: 'connected', 'phone_battery_above:N', 'thermal_below:<level>', 'audio_route:<route>', 'toggle_on:<key>', 'toggle_off:<key>'.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "examples": [
+                        [
+                            "connected",
+                            "thermal_below:moderate"
+                        ]
+                    ]
+                },
+                "action": {
+                    "$ref": "#/$defs/action_non_wrapper"
+                },
+                "on_unmet": {
+                    "type": "string",
+                    "enum": [
+                        "skip",
+                        "abort"
+                    ],
+                    "description": "Behavior when predicates unmet.",
+                    "examples": [
+                        "skip"
+                    ]
+                }
+            }
+        },
+        "branch_condition": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/branch_condition_simple"
+                },
+                {
+                    "$ref": "#/$defs/branch_condition_all"
+                },
+                {
+                    "$ref": "#/$defs/branch_condition_any"
+                }
+            ]
+        },
+        "branch_condition_simple": {
+            "type": "object",
+            "required": [
+                "variable",
+                "operator"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "variable": {
+                    "type": "string",
+                    "description": "Variable name. Supports dot-path and special namespaces (toggles.*, trigger_payload.*, hardware_state.*).",
+                    "examples": [
+                        "description",
+                        "photo.width",
+                        "toggles.privacy_mode"
+                    ]
+                },
+                "operator": {
+                    "type": "string",
+                    "enum": [
+                        "equals",
+                        "not_equals",
+                        "contains",
+                        "not_contains",
+                        "is_empty",
+                        "not_empty",
+                        "greater_than",
+                        "less_than",
+                        "gte",
+                        "lte",
+                        "starts_with",
+                        "ends_with"
+                    ],
+                    "description": "Comparison operator.",
+                    "examples": [
+                        "equals"
+                    ]
+                },
+                "value": {
+                    "description": "Comparand. Optional for is_empty/not_empty, required otherwise."
+                }
+            }
+        },
+        "branch_condition_all": {
+            "type": "object",
+            "required": [
+                "all"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "all": {
+                    "type": "array",
+                    "description": "AND combinator. Nesting not capped.",
+                    "items": {
+                        "$ref": "#/$defs/branch_condition"
+                    }
+                }
+            }
+        },
+        "branch_condition_any": {
+            "type": "object",
+            "required": [
+                "any"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "any": {
+                    "type": "array",
+                    "description": "OR combinator. Nesting not capped.",
+                    "items": {
+                        "$ref": "#/$defs/branch_condition"
+                    }
+                }
+            }
+        }
+    }
+};
+export const manifestSchema = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "extentos://schema/manifest/v1",
+    "type": "object",
+    "required": [
+        "manifestVersion",
+        "platform",
+        "glasses",
+        "appPackage",
+        "extentos",
+        "spec",
+        "generatedFiles",
+        "permissions",
+        "integration"
+    ],
+    "additionalProperties": false,
+    "description": "Machine-readable Extentos integration state. Written by MCP tools, read by inspectIntegration and validateIntegration.",
+    "properties": {
+        "manifestVersion": {
+            "type": "integer",
+            "const": 1,
+            "description": "Manifest format version. Only 1 is valid for MVP.",
+            "examples": [
+                1
+            ]
+        },
+        "platform": {
+            "type": "string",
+            "enum": [
+                "android",
+                "ios"
+            ],
+            "description": "Platform this manifest describes.",
+            "examples": [
+                "android"
+            ]
+        },
+        "glasses": {
+            "type": "string",
+            "enum": [
+                "meta_rayban"
+            ],
+            "description": "Target glasses vendor. Only meta_rayban for MVP.",
+            "examples": [
+                "meta_rayban"
+            ]
+        },
+        "appPackage": {
+            "type": "string",
+            "description": "Developer app identifier. Android: package name. iOS: Bundle ID.",
+            "examples": [
+                "com.example.myapp"
+            ]
+        },
+        "extentos": {
+            "type": "object",
+            "required": [
+                "libraryVersion",
+                "specVersion",
+                "installedAt",
+                "lastUpdatedAt"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "libraryVersion": {
+                    "type": "string",
+                    "description": "Installed library version.",
+                    "examples": [
+                        "1.0.0"
+                    ]
+                },
+                "specVersion": {
+                    "type": "string",
+                    "description": "Spec schema version.",
+                    "examples": [
+                        "1.0"
+                    ]
+                },
+                "installedAt": {
+                    "type": "string",
+                    "description": "ISO-8601 timestamp of first install.",
+                    "examples": [
+                        "2026-04-16T12:00:00Z"
+                    ]
+                },
+                "lastUpdatedAt": {
+                    "type": "string",
+                    "description": "ISO-8601 timestamp of last integration mutation.",
+                    "examples": [
+                        "2026-04-16T14:30:00Z"
+                    ]
+                }
+            }
+        },
+        "spec": {
+            "type": "object",
+            "required": [
+                "path",
+                "hash"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "path": {
+                    "type": "string",
+                    "description": "Path to spec file relative to project root.",
+                    "examples": [
+                        "app/src/main/assets/extentos.spec.json",
+                        "Resources/extentos.spec.json"
+                    ]
+                },
+                "hash": {
+                    "type": "string",
+                    "description": "SHA-256 of spec file contents, prefixed with 'sha256:'. Detects out-of-band edits.",
+                    "examples": [
+                        "sha256:a1b2c3d4e5f6"
+                    ]
+                }
+            }
+        },
+        "generatedFiles": {
+            "type": "array",
+            "description": "Every generated file with metadata.",
+            "items": {
+                "type": "object",
+                "required": [
+                    "path",
+                    "template",
+                    "hash",
+                    "generatedAt",
+                    "generatedByTool"
+                ],
+                "additionalProperties": false,
+                "properties": {
+                    "path": {
+                        "type": "string",
+                        "description": "Relative path from project root.",
+                        "examples": [
+                            "app/src/main/java/com/example/myapp/extentos/ExtentosBootstrap.kt"
+                        ]
+                    },
+                    "template": {
+                        "type": "string",
+                        "enum": [
+                            "connection_module",
+                            "callback_handler",
+                            "stream_consumer"
+                        ],
+                        "description": "Template name.",
+                        "examples": [
+                            "connection_module"
+                        ]
+                    },
+                    "hash": {
+                        "type": "string",
+                        "description": "SHA-256 of file contents at generation time.",
+                        "examples": [
+                            "sha256:e5f6g7h8"
+                        ]
+                    },
+                    "generatedAt": {
+                        "type": "string",
+                        "description": "ISO-8601 timestamp.",
+                        "examples": [
+                            "2026-04-16T12:00:00Z"
+                        ]
+                    },
+                    "generatedByTool": {
+                        "type": "string",
+                        "description": "MCP tool that created this file.",
+                        "examples": [
+                            "generateConnectionModule"
+                        ]
+                    }
+                }
+            }
+        },
+        "gradle": {
+            "type": "object",
+            "required": [
+                "coordinate",
+                "buildFile"
+            ],
+            "additionalProperties": false,
+            "description": "Android only. Mutually exclusive with spm.",
+            "properties": {
+                "coordinate": {
+                    "type": "string",
+                    "description": "Expected Gradle dependency coordinate.",
+                    "examples": [
+                        "com.extentos:glasses:1.0.0"
+                    ]
+                },
+                "buildFile": {
+                    "type": "string",
+                    "description": "Path to build.gradle.kts.",
+                    "examples": [
+                        "app/build.gradle.kts"
+                    ]
+                },
+                "additionalArtifacts": {
+                    "type": "array",
+                    "description": "Additional Gradle dependencies beyond the core coordinate.",
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "coordinate",
+                            "configuration"
+                        ],
+                        "additionalProperties": false,
+                        "properties": {
+                            "coordinate": {
+                                "type": "string",
+                                "description": "Gradle coordinate.",
+                                "examples": [
+                                    "com.extentos:glasses-ui:1.0.0"
+                                ]
+                            },
+                            "configuration": {
+                                "type": "string",
+                                "enum": [
+                                    "implementation",
+                                    "debugImplementation"
+                                ],
+                                "description": "Gradle configuration.",
+                                "examples": [
+                                    "implementation"
+                                ]
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "spm": {
+            "type": "object",
+            "required": [
+                "package",
+                "packageURL",
+                "version",
+                "projectFile"
+            ],
+            "additionalProperties": false,
+            "description": "iOS only. Mutually exclusive with gradle.",
+            "properties": {
+                "package": {
+                    "type": "string",
+                    "description": "SPM package name.",
+                    "examples": [
+                        "Extentos"
+                    ]
+                },
+                "packageURL": {
+                    "type": "string",
+                    "description": "Git URL of the Extentos SPM package.",
+                    "examples": [
+                        "https://github.com/extentos/extentos-ios"
+                    ]
+                },
+                "version": {
+                    "type": "string",
+                    "description": "Resolved SPM version.",
+                    "examples": [
+                        "1.0.0"
+                    ]
+                },
+                "projectFile": {
+                    "type": "string",
+                    "description": "Path to .xcodeproj/project.pbxproj or Package.swift.",
+                    "examples": [
+                        "MyApp.xcodeproj/project.pbxproj"
+                    ]
+                },
+                "additionalProducts": {
+                    "type": "array",
+                    "description": "Additional SPM products linked to targets.",
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "product",
+                            "target"
+                        ],
+                        "additionalProperties": false,
+                        "properties": {
+                            "product": {
+                                "type": "string",
+                                "description": "SPM product name.",
+                                "examples": [
+                                    "GlassesUI"
+                                ]
+                            },
+                            "target": {
+                                "type": "string",
+                                "description": "Xcode target name.",
+                                "examples": [
+                                    "MyApp"
+                                ]
+                            },
+                            "debugOnly": {
+                                "type": "boolean",
+                                "description": "Link only in debug configuration.",
+                                "examples": [
+                                    true
+                                ]
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "permissions": {
+            "type": "array",
+            "description": "Expected platform permissions derived from spec. Android: android.permission.*. iOS: Info.plist keys.",
+            "items": {
+                "type": "string"
+            },
+            "examples": [
+                [
+                    "android.permission.BLUETOOTH_CONNECT",
+                    "android.permission.CAMERA"
+                ]
+            ]
+        },
+        "integration": {
+            "type": "object",
+            "required": [
+                "blocks",
+                "streams",
+                "triggers",
+                "handlerNames",
+                "togglesOverridden"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "blocks": {
+                    "type": "array",
+                    "description": "Block types currently in the spec.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "examples": [
+                        [
+                            "capture_photo"
+                        ]
+                    ]
+                },
+                "streams": {
+                    "type": "array",
+                    "description": "Stream types currently in the spec.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "examples": [
+                        [
+                            "transcription_incremental"
+                        ]
+                    ]
+                },
+                "triggers": {
+                    "type": "array",
+                    "description": "Trigger types currently in the spec.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "examples": [
+                        [
+                            "voice_command",
+                            "fallback"
+                        ]
+                    ]
+                },
+                "handlerNames": {
+                    "type": "array",
+                    "description": "app_callback handler names in the spec.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "examples": [
+                        [
+                            "vision"
+                        ]
+                    ]
+                },
+                "togglesOverridden": {
+                    "type": "array",
+                    "description": "Toggle keys explicitly set in spec triggers.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "examples": [
+                        [
+                            "battery_save_mode"
+                        ]
+                    ]
+                }
+            }
+        }
+    }
+};
+export const connectionPageSchema = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "extentos://schema/connection-page/v1",
+    "type": "object",
+    "required": [
+        "schemaVersion"
+    ],
+    "description": "Optional ExtentosConnectionPage theming and section visibility. All fields beyond schemaVersion are optional; unknown fields are tolerated (additive contract).",
+    "properties": {
+        "schemaVersion": {
+            "type": "integer",
+            "const": 1,
+            "description": "Connection-page config format version. Only 1 is valid for MVP.",
+            "examples": [
+                1
+            ]
+        },
+        "sections": {
+            "type": "object",
+            "description": "Which sections render on the connection page. Status section always renders.",
+            "properties": {
+                "capabilities": {
+                    "type": "boolean",
+                    "description": "Show capabilities section. Default true.",
+                    "examples": [
+                        true
+                    ]
+                },
+                "triggers": {
+                    "type": "boolean",
+                    "description": "Show triggers section. Default true.",
+                    "examples": [
+                        true
+                    ]
+                },
+                "toggles": {
+                    "type": "boolean",
+                    "description": "Show toggles section. Default true.",
+                    "examples": [
+                        true
+                    ]
+                }
+            }
+        },
+        "appearance": {
+            "type": "object",
+            "description": "Layer 2 theming tokens. Field-by-field merge over built-in Appearance.Default. Any field omitted falls back to default.",
+            "properties": {
+                "colors": {
+                    "type": "object",
+                    "description": "11 color tokens.",
+                    "properties": {
+                        "primary": {
+                            "type": "string",
+                            "description": "Primary accent color, hex.",
+                            "examples": [
+                                "#3B82F6"
+                            ]
+                        },
+                        "surface": {
+                            "type": "string",
+                            "description": "Primary surface color.",
+                            "examples": [
+                                "#0A0A0F"
+                            ]
+                        },
+                        "surfaceVariant": {
+                            "type": "string",
+                            "description": "Secondary surface color.",
+                            "examples": [
+                                "#16161A"
+                            ]
+                        },
+                        "onSurface": {
+                            "type": "string",
+                            "description": "Primary text color on surface.",
+                            "examples": [
+                                "#FFFFFF"
+                            ]
+                        },
+                        "onSurfaceSecondary": {
+                            "type": "string",
+                            "description": "Secondary text color on surface.",
+                            "examples": [
+                                "#A3A3A3"
+                            ]
+                        },
+                        "onSurfaceMuted": {
+                            "type": "string",
+                            "description": "Muted text color on surface.",
+                            "examples": [
+                                "#6B7280"
+                            ]
+                        },
+                        "accent": {
+                            "type": "string",
+                            "description": "Secondary accent color.",
+                            "examples": [
+                                "#10B981"
+                            ]
+                        },
+                        "success": {
+                            "type": "string",
+                            "description": "Success color.",
+                            "examples": [
+                                "#10B981"
+                            ]
+                        },
+                        "warning": {
+                            "type": "string",
+                            "description": "Warning color.",
+                            "examples": [
+                                "#F59E0B"
+                            ]
+                        },
+                        "error": {
+                            "type": "string",
+                            "description": "Error color.",
+                            "examples": [
+                                "#EF4444"
+                            ]
+                        },
+                        "divider": {
+                            "type": "string",
+                            "description": "Divider/border color.",
+                            "examples": [
+                                "#27272A"
+                            ]
+                        }
+                    }
+                },
+                "typography": {
+                    "type": "object",
+                    "description": "8 typography tokens.",
+                    "properties": {
+                        "sectionLabel": {
+                            "$ref": "#/$defs/font_token"
+                        },
+                        "statusLabel": {
+                            "$ref": "#/$defs/font_token"
+                        },
+                        "statusSub": {
+                            "$ref": "#/$defs/font_token"
+                        },
+                        "metaLabel": {
+                            "$ref": "#/$defs/font_token"
+                        },
+                        "metaValue": {
+                            "$ref": "#/$defs/font_token"
+                        },
+                        "triggerPhrase": {
+                            "$ref": "#/$defs/font_token"
+                        },
+                        "triggerBadge": {
+                            "$ref": "#/$defs/font_token"
+                        },
+                        "capabilityName": {
+                            "$ref": "#/$defs/font_token"
+                        }
+                    }
+                },
+                "shapes": {
+                    "type": "object",
+                    "description": "3 shape tokens.",
+                    "properties": {
+                        "card": {
+                            "$ref": "#/$defs/shape_token"
+                        },
+                        "section": {
+                            "$ref": "#/$defs/shape_token"
+                        },
+                        "chip": {
+                            "$ref": "#/$defs/shape_token"
+                        }
+                    }
+                }
+            }
+        }
+    },
+    "$defs": {
+        "font_token": {
+            "type": "object",
+            "description": "Font token.",
+            "properties": {
+                "family": {
+                    "type": "string",
+                    "description": "Font family name.",
+                    "examples": [
+                        "SF Pro Text",
+                        "Roboto"
+                    ]
+                },
+                "weight": {
+                    "type": "integer",
+                    "description": "Font weight 100-900.",
+                    "examples": [
+                        600
+                    ]
+                },
+                "size": {
+                    "type": "number",
+                    "description": "Font size in sp (Android) / pt (iOS).",
+                    "examples": [
+                        14
+                    ]
+                },
+                "lineHeight": {
+                    "type": "number",
+                    "description": "Optional line height multiplier.",
+                    "examples": [
+                        1.2
+                    ]
+                },
+                "letterSpacing": {
+                    "type": "number",
+                    "description": "Optional letter spacing em.",
+                    "examples": [
+                        0.02
+                    ]
+                }
+            }
+        },
+        "shape_token": {
+            "type": "object",
+            "description": "Shape token.",
+            "properties": {
+                "cornerRadius": {
+                    "type": "number",
+                    "description": "Corner radius in dp (Android) / pt (iOS).",
+                    "examples": [
+                        16
+                    ]
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=schemas.js.map