@extentos/mcp-server 0.0.93 → 0.1.0

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"getProductionChecklist.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/getProductionChecklist.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgE5E,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAyNrE"}
+{"version":3,"file":"getProductionChecklist.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/getProductionChecklist.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmF5E,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA8PrE"}

package/dist/tools/handlers/getProductionChecklist.js

@@ -38,6 +38,14 @@ const HARDWARE_VERIFY_CAPS = new Set([
     "conversation_listen",
     "conversation_speak",
     "conversation_ai_complete",
+    // Phase 4 assistant runtime — same reasoning. The assistant.start
+    // path exercises the BT HFP mic-input + speaker-output, the WebSocket
+    // to the AI provider, and tool dispatch under real-world conditions.
+    // Synthesis #3 makes real-hw validation a v2.0.0 gate.
+    "assistant_runtime",
+    "assistant_start",
+    "assistant_tool",
+    "assistant_provider_openai",
 ]);
 // Phase 3 conversation runtime capabilities — when ANY of these are
 // declared, a dedicated Conversation Runtime Setup step fires (manifest
@@ -49,6 +57,16 @@ const CONVERSATION_RUNTIME_CAPS = new Set([
     "conversation_speak",
     "conversation_ai_complete",
 ]);
+// Phase 4 assistant runtime capabilities — when ANY of these are
+// declared, a dedicated Assistant Runtime Setup step fires (BYOK key
+// + tool description hygiene + Mock-provider test pass + real-hw
+// validation per synthesis #3 v2.0.0 gate).
+const ASSISTANT_RUNTIME_CAPS = new Set([
+    "assistant_runtime",
+    "assistant_start",
+    "assistant_tool",
+    "assistant_provider_openai",
+]);
 export function handleGetProductionChecklist(raw) {
     const parsed = parseArgs(raw);
     if ("error" in parsed)
@@ -63,6 +81,7 @@ export function handleGetProductionChecklist(raw) {
     const ios = deriveIosFromCapabilities(capabilities);
     const metaDat = deriveMetaDatFromCapabilities(capabilities);
     const usesConversationRuntime = [...capsSet].some((c) => CONVERSATION_RUNTIME_CAPS.has(c));
+    const usesAssistantRuntime = [...capsSet].some((c) => ASSISTANT_RUNTIME_CAPS.has(c));
     const steps = [];
     // 1. Meta Developer Account
     steps.push({
@@ -105,35 +124,61 @@ export function handleGetProductionChecklist(raw) {
             description: `Wire BYOK API keys for ${handlers.length} handler${handlers.length === 1 ? "" : "s"}.`,
             status: "needed",
             details: "Each declared handler is expected to call a third-party AI / vision / translation service. Production builds must not ship with placeholder or in-simulator proxy credentials." +
+                (usesAssistantRuntime
+                    ? " **Phase 4 assistant runtime apps** need the OpenAI BYOK key wired via `glasses.assistant.setOpenaiApiKey(key)` at app init for `glasses.assistant.start(provider = AssistantProvider.OpenAi(...))` to work — see getCredentialGuide(service: \"openai\"). Key flows direct device → openai.com via the WebSocket Authorization header; Extentos backend never sees it."
+                    : "") +
                 (usesConversationRuntime
-                    ? " **Phase 3 conversation runtime apps** need the OpenAI BYOK key wired via `glasses.ai.setOpenaiApiKey(key)` at app init for `glasses.ai.complete(prompt)` to work — see getCredentialGuide(service: \"openai\")."
+                    ? " **Phase 3 conversation runtime apps** need the OpenAI BYOK key wired via `glasses.ai.setOpenaiApiKey(key)` at app init for `glasses.ai.complete(prompt)` to work — see getCredentialGuide(service: \"openai\"). NOTE: this API is DEPRECATED in v1.4.0 and REMOVED in v2.0.0 — migrate to `glasses.assistant.setOpenaiApiKey(key)` per docs/migration/phase-3-to-phase-4.md."
                     : ""),
             fix: "Call getCredentialGuide with the BYOK services to get per-provider setup steps, then wire secrets via platform-local secure storage (Android resValue/keystore, iOS Keychain/xcconfig).",
             affectedHandlers: handlers,
         });
     }
     // 4b. Phase 3 Conversation Runtime Setup — only if the app declared
-    //     any conversation_* capability. Three pre-ship gates the runtime
+    //     any conversation_* capability. Two pre-ship gates the runtime
     //     needs that the simulator setup doesn't enforce:
     //       (a) Manifest's `conversation` block populated, not just present.
-    //       (b) silero_vad.onnx + smart-turn-v3.2-cpu.onnx bundled as
-    //           Android assets / iOS resources (~11 MB total). Missing →
-    //           `glasses.conversation` is null at runtime (warn-logged).
+    //       (b) Host app passes `ExtentosConfig.conversationOptions` at
+    //           create-time, resolving model paths via `ConversationModels`
+    //           helper (models themselves ship inside the library).
     //       (c) OpenAI BYOK key wired (covered by step 4, cross-linked).
     if (usesConversationRuntime) {
         steps.push({
             category: "Phase 3 Conversation Runtime Setup",
-            description: "Validate `glasses.conversation` runtime setup — manifest config, bundled ONNX models, BYOK key wiring.",
+            description: "Validate `glasses.conversation` runtime setup — manifest config, `ConversationCoreOptions` wiring, BYOK key.",
             status: "needed",
-            details: "The Phase 3 conversation runtime (`glasses.conversation.onWake { listen() / speak() / ai.complete() }`) needs three things the simulator config doesn't enforce: (1) the manifest's `conversation` block must specify provider + voice + model (defaults: openai/gpt-4o-mini, alloy); (2) the Silero VAD + Smart Turn v3 ONNX model files must be bundled as Android assets (`app/src/main/assets/silero_vad.onnx` + `smart-turn-v3.2-cpu.onnx`) or iOS resources (`Sources/.../Resources/`); (3) the host app must pass `ExtentosConfig.conversationOptions` at create-time, supplying the resolved model file paths + backend base URL. If any of these are missing, `glasses.conversation` will be `null` at runtime and a `conversation.init_failed` Log event surfaces in `glasses.runtime.events` — the rest of the library stays functional. PII boundary: conversation lifecycle events carry `textLen` (char count) only, never transcript text; ensure your privacy disclosure covers metric-level voice telemetry.",
+            details: "The Phase 3 conversation runtime (`glasses.conversation.onWake { listen() / speak() / ai.complete() }`) needs three things the simulator config doesn't enforce: (1) the manifest's `conversation` block must specify provider + voice + model (defaults: openai/gpt-4o-mini, alloy); (2) the host app must pass `ExtentosConfig.conversationOptions` at create-time, with model file paths resolved via the bundled `ConversationModels` helper (Silero VAD ~2.2 MB + Smart Turn v3 ~8.7 MB are bundled inside `glasses-core` AAR / `GlassesCore` Swift package — customers don't bundle them themselves); (3) `glasses.ai.setOpenaiApiKey(BYOK)` wired (cross-link to step 4). If any of these are missing, `glasses.conversation` will be `null` at runtime and a `conversation.init_failed` Log event surfaces in `glasses.runtime.events` — the rest of the library stays functional. PII boundary: conversation lifecycle events carry `textLen` (char count) only, never transcript text; ensure your privacy disclosure covers metric-level voice telemetry.",
             fix: platform === "android"
-                ? "1) Ship the two ONNX files in app/src/main/assets/ (~11 MB; verify they're in the AAB). 2) Extract them to cacheDir at app init: `assets.open(\"silero_vad.onnx\").use { it.copyTo(File(cacheDir, \"silero_vad.onnx\").outputStream()) }`. 3) Build ConversationCoreOptions from the extracted paths + manifest config + backendBaseUrl. 4) Pass to ExtentosConfig(conversationOptions = options). 5) Confirm `glasses.conversation != null` after create returns. See getCapabilityGuide(feature: \"conversation_runtime\")."
-                : "1) Ship the two ONNX files in Sources/<Module>/Resources/ (~11 MB; declare in Package.swift's resources array). 2) Resolve URLs via `Bundle.module.url(forResource: \"silero_vad\", withExtension: \"onnx\")`. 3) Build ConversationCoreOptions from those paths + manifest config + backendBaseUrl. 4) Pass to ExtentosConfig(conversation: options). 5) Confirm `glasses.conversation != nil` after create returns. See getCapabilityGuide(feature: \"conversation_runtime\").",
+                ? "1) From a coroutine at app init: `val models = ConversationModels.ensureExtracted(context)` (idempotent; suspends ~50-200 ms on first launch to copy ~11 MB from AAR assets to cacheDir). 2) Build ConversationCoreOptions from `models.sileroVadPath` + `models.smartTurnPath` + manifest config + backendBaseUrl. 3) Pass to `ExtentosConfig(conversationOptions = options)`. 4) After create, call `glasses.ai?.setOpenaiApiKey(BuildConfig.OPENAI_API_KEY)`. 5) Confirm `glasses.conversation != null` after create returns. Full snippet: getCodeExample(pattern: \"conversation_agent_loop\")."
+                : "1) Synchronously at app init: `let models = ConversationModels.paths` (bundle lookup via `Bundle.module`). 2) Build `ConversationCoreOptions(sileroVadModelPath: models.sileroVadPath, smartTurnModelPath: models.smartTurnPath, …)`. 3) Pass to `ExtentosConfig(conversation: options)`. 4) After create, call `glasses.ai?.setOpenAiApiKey(Secrets.openAiKey)`. 5) Confirm `glasses.conversation != nil` after create returns. Full snippet: getCodeExample(pattern: \"conversation_agent_loop\").",
             codeChange: platform === "android"
                 ? { file: "extentos.manifest.json", hint: "conversation.stt.provider, conversation.tts.{provider, voice}, conversation.model" }
                 : { file: "extentos.manifest.json", hint: "conversation.stt.provider, conversation.tts.{provider, voice}, conversation.model" },
         });
     }
+    // 4c. Phase 4 Assistant Runtime Setup — only if the app declared any
+    //     assistant_* capability. Four pre-ship gates that the simulator
+    //     setup doesn't enforce:
+    //       (a) OpenAI BYOK key wired (covered by step 4, cross-linked).
+    //       (b) Tool descriptions are written for the AI (not the engineer)
+    //           — quality matters; the model picks tools from descriptions.
+    //       (c) Mock provider tests pass via injectAssistantUtterance +
+    //           assertToolCalled (the agent-driven E2E loop).
+    //       (d) Real-hardware validation done before declaring production-
+    //           ready (synthesis #3 — v2.0.0 gate).
+    if (usesAssistantRuntime) {
+        steps.push({
+            category: "Phase 4 Assistant Runtime Setup",
+            description: "Validate `glasses.assistant` runtime setup — BYOK key, tool description quality, Mock-provider tests, real-hardware smoke.",
+            status: "needed",
+            details: "The Phase 4 assistant runtime (`glasses.assistant.start(provider) { tool(name, description) { body } }`) needs four things the simulator setup doesn't enforce: (1) `glasses.assistant.setOpenaiApiKey(BYOK)` wired at app init (cross-link to step 4); (2) tool descriptions written for the AI — be specific about WHEN to call (\"Take a photo when the user asks to capture a moment\") not WHAT the tool does internally (\"Captures imagery via the camera SDK\"); the model picks from these descriptions alone; (3) each tool exercised end-to-end via the agent-test loop (`injectAssistantUtterance` + `assertToolCalled`) — Mock provider for deterministic CI, OpenAi provider for end-to-end smoke; (4) real-hardware validation on actual Ray-Bans before declaring production-ready (synthesis #3 — gates v2.0.0 ship). PII note: Phase 4 events DO carry verbatim transcripts in `assistant.user_spoke` / `assistant.assistant_spoke` (different from Phase 3 which stripped text) because BYOK flows direct device → openai.com without touching Extentos backend — customer apps own their privacy disclosure for assistant telemetry.",
+            fix: "1) At app init: `glasses.assistant.setOpenaiApiKey(BuildConfig.OPENAI_API_KEY)` (Android) or `glasses.assistant.setOpenAiApiKey(Secrets.openAiKey)` (iOS). 2) Review each tool() call's description — make it answer \"when should the AI call this?\" verbatim. 3) For each tool, write an agent test: `createSimulatorSession` → `injectAssistantUtterance({ text: 'expected user utterance' })` → `assertToolCalled({ name: 'expected_tool_name', timeoutMs: 5000 })`. 4) Before customer ship, run the full handler on real Ray-Bans + a phone. Walk through 5-10 voice interactions, watching for the three sim-fidelity buckets (audio character, hardware timing, hardware failure modes — see searchDocs(topic: 'simulator_fidelity')). Full setup snippet: getCodeExample(pattern: \"assistant_agent_loop\").",
+            codeChange: {
+                file: platform === "android" ? "Application.onCreate / ExtentosBootstrap.kt" : "App.init / ExtentosBootstrap.swift",
+                hint: "glasses.assistant.setOpenaiApiKey(...) + glasses.assistant.start(provider) { tool(...) }",
+            },
+        });
+    }
     // 5. Permissions Audit — always
     const permCount = platform === "android" ? android.permissions.length : ios.plistKeys.length;
     steps.push({
@@ -194,10 +239,16 @@ export function handleGetProductionChecklist(raw) {
             status: "needed",
             details: `App uses: ${hardwareVerifyCaps.join(", ")}. ` +
                 "Behavior under real SCO routing, real recognizer engines (SpeechRecognizer / SFSpeechRecognizer), thermal limits, and BT route changes can only be verified on hardware. During the test, watch getEventLog(filter: \"voice\") to confirm transcripts come through, no transport.error events surface, and the relevant operations complete cleanly." +
+                (usesAssistantRuntime
+                    ? " **Phase 4 assistant runtime apps**: synthesis #3 makes this gate load-bearing for v2.0.0 — at least one architecture must be dogfooded on real Ray-Bans with audio audible before the v2.0.0 cascaded-deletion ships. Watch for the three sim-fidelity buckets: (A) audio character — does the model still pick tools reliably with the noisier HFP capture vs the sim's wide-band mic?; (B) hardware timing — first-utterance HFP profile switch (~200-500 ms), A2DP↔HFP music collision; (C) hardware failure modes — BT range loss, incoming-call interruption, battery drain (~30 min HFP ceiling), thermal throttling. Confirm the assistant.* event sequence in getEventLog matches the sim test (assistant.session_started → user_spoke → tool_called → tool_result → assistant_spoke). See searchDocs(topic: \"simulator_fidelity\") for the contract."
+                    : "") +
                 (usesConversationRuntime
                     ? " **Phase 3 conversation runtime apps**: also confirm the symmetric A10 lifecycle event pairs (`conversation.handler_started`/`handler_finished`, `conversation.turn_started`/`turn_ended`) land in the log per handler invocation, and that `conversation.error` doesn't surface (network/STT/TTS/LLM failures all show up there). The simulator sim's right-rail ConversationPanel is the visual equivalent — green active-handler card + listening pulse → expected; red error rows → investigate."
                     : ""),
             fix: "Pair Ray-Ban Meta to your phone, install your app, and exercise: (1) each voice path you handle; (2) record_audio / capture_video at the max duration you configure; (3) BT route change mid-recording (connect/disconnect AirPods). Verify the event log shows transcripts, no transport.error[stt_*] events, and operations complete successfully." +
+                (usesAssistantRuntime
+                    ? " For assistant runtime: walk 5-10 voice interactions covering every tool you registered + the take/stop pair semantics (if any). Verify (1) assistant.session_started fires on app start; (2) each tool call surfaces assistant.tool_called → assistant.tool_result with reasonable duration_ms; (3) the assistant.reconnected event fires after ~50 min — confirms the library-owned reconnection state machine works under real network conditions; (4) on BT disconnect/range loss, assistant.session_ended(error) fires + app handles re-bind on reconnect."
+                    : "") +
                 (usesConversationRuntime
                     ? " For conversation runtime: walk a full wake → listen → ai.complete → speak loop end-to-end, then verify (1) the handler / turn event pairs are symmetric in getEventLog, (2) BYOK key isn't rejected (no `conversation.error{kind: stt_unauthorized}` or AiException.Unauthorized), (3) Smart Turn EOU fires at natural utterance boundaries (not stuck on the 600 ms silence fallback for every turn — that signals VAD trouble)."
                     : ""),

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"injectAssistantUtterance.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/injectAssistantUtterance.ts"],"names":[],"mappings":"AAyBA,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAW5E,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,UAAU,CAAC,CAmIrB"}

package/dist/tools/handlers/injectAssistantUtterance.js

@@ -0,0 +1,139 @@
+// injectAssistantUtterance — Phase 4 S1.W.7.
+//
+// Drive an assistant turn from outside the live session — used by
+// agent-driven E2E tests of the Phase 4 glasses.assistant.start surface.
+// Mirrors injectTranscript's pattern (frame travels through the same
+// sim-hub path; the library routes it to the active assistant session).
+//
+// v1 paths (per synthesis #16, partially scoped down for Sprint 1):
+//   - text: deterministic path. v1 wire-routing reuses the existing
+//     stt_transcript frame the Rust core already knows about (Phase 4
+//     plan § machine-split: NO Rust changes). MockAssistantProvider
+//     subscribes to audio.transcriptions() Flow and routes Finals to
+//     its dispatcher. Sub-millisecond. No API cost.
+//   - audioWavBase64: real-provider audio path — DEFERRED to v1.1.
+//     Implementing this needs either a new inbound frame type (Rust
+//     core change) or a separate audio-chunk injection endpoint;
+//     either is out of Sprint 1 scope. Handler rejects with
+//     not_implemented for now.
+//
+// USE for agent-driven end-to-end tests of glasses.assistant.start
+// (e.g. createSimulatorSession → injectAssistantUtterance({ text:
+// "take a picture" }) → assertToolCalled({ name: "take_picture" })).
+// DON'T USE for capability discovery (use getPlatformInfo) or static
+// validation (use validateIntegration).
+import { okResponse, errorResponse } from "../response.js";
+import { backendFetch } from "../util/backendClient.js";
+export async function handleInjectAssistantUtterance(raw) {
+    if (!raw || typeof raw !== "object") {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "injectAssistantUtterance requires { sessionId, text? | audioWavBase64? }.",
+            fixHint: 'Pass { sessionId: "sim_...", text: "take a picture" }. For real-provider audio injection, pass audioWavBase64 instead — a base64-encoded WAV file the library decodes + feeds through the active provider.',
+            retryable: false,
+        });
+    }
+    const o = raw;
+    if (typeof o.sessionId !== "string" || !o.sessionId.trim()) {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "sessionId (string) is required.",
+            fixHint: "Pass the sessionId returned by createSimulatorSession.",
+            retryable: false,
+        });
+    }
+    const text = typeof o.text === "string" ? o.text : undefined;
+    const audioWavBase64 = typeof o.audioWavBase64 === "string" ? o.audioWavBase64 : undefined;
+    // Enforce exactly-one-of in the handler (the JSON Schema can't express
+    // top-level oneOf per the assertNoForbiddenTopLevelKeywords lock).
+    if (text == null && audioWavBase64 == null) {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "Either text or audioWavBase64 is required.",
+            fixHint: 'Pass text: "take a picture" for the Mock provider path (fast, deterministic, free), or audioWavBase64: "..." for the real-provider audio path.',
+            retryable: false,
+        });
+    }
+    if (text != null && audioWavBase64 != null) {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "Pass either text or audioWavBase64 — not both.",
+            fixHint: "Pick the path: text for Mock-provider intent matching, audioWavBase64 for real-provider audio.",
+            retryable: false,
+        });
+    }
+    if (text != null && text.length === 0) {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "text must be non-empty.",
+            fixHint: 'Pass text: "take a picture" (or any utterance the model should hear).',
+            retryable: false,
+        });
+    }
+    // v1 wire-routing: text path reuses the existing stt_transcript frame
+    // so we don't need to teach the Rust core a new inbound frame type
+    // (Phase 4 plan § machine-split: NO Rust changes). The library shell's
+    // MockAssistantProvider subscribes to audio.transcriptions() and routes
+    // Finals to its injectUtterance dispatcher. Tagged with
+    // source: "assistant_inject" so the backend ws-hub renders these as
+    // assistant injects rather than mic injects in the event log.
+    //
+    // audioWavBase64 path: deferred to v1.1 — needs a frame-type extension
+    // or a separate audio-chunk injection endpoint. Surfaces the 'not yet
+    // supported' error in the handler below.
+    if (audioWavBase64 != null) {
+        return errorResponse({
+            code: "not_implemented",
+            message: "audioWavBase64 path is not yet implemented in v1 (deferred to v1.1).",
+            fixHint: "Use the text: path for now — the MockAssistantProvider matches against tool descriptions deterministically. For real-provider validation, run the OpenAi provider session with a real mic source (sim browser tab mic, or real glasses).",
+            retryable: false,
+        });
+    }
+    const payload = {
+        type: "stt_transcript",
+        text: text,
+        isFinal: true,
+        confidence: 0.99,
+        source: "assistant_inject",
+    };
+    const res = await backendFetch(`/api/sessions/${encodeURIComponent(o.sessionId)}/inject`, {
+        method: "POST",
+        body: payload,
+    });
+    if (res.status === 404) {
+        return errorResponse({
+            code: "session_not_found",
+            message: `No session found with id ${JSON.stringify(o.sessionId)}.`,
+            fixHint: "Call createSimulatorSession to start a new session.",
+            retryable: false,
+        });
+    }
+    if (res.status === 409) {
+        const body = res.data;
+        return errorResponse({
+            code: "app_not_attached",
+            message: body?.message ??
+                "Inject not delivered: the session exists but no app role is currently attached.",
+            fixHint: "Start your app (build + run on the emulator/device) so the WebSocket attaches, then retry. Confirm with getSimulatorStatus — connectedRoles.app should be present. Also verify glasses.assistant.start { ... } has been called in your app — the inject routes to the active assistant session.",
+            retryable: true,
+        });
+    }
+    if (!res.ok || !res.data || res.data.delivered !== true) {
+        return errorResponse({
+            code: "backend_unreachable",
+            message: `Backend /api/sessions/${o.sessionId}/inject failed: ${res.errorText ?? `HTTP ${res.status}`}.`,
+            fixHint: "Ensure the Extentos backend is reachable.",
+            retryable: true,
+        });
+    }
+    return okResponse({
+        sessionId: o.sessionId,
+        delivered: true,
+        mode: "text",
+        frame: res.data.frame ?? payload,
+        summary: `Injected utterance "${text.slice(0, 60)}${text.length > 60 ? "…" : ""}" into ${o.sessionId}. ` +
+            `Follow up with assertToolCalled({ sessionId, name: "..." }) to verify the expected tool fired, ` +
+            `or getEventLog(types: ["assistant.tool_called","assistant.assistant_spoke"]) to see the full event trace.`,
+    });
+}
+//# sourceMappingURL=injectAssistantUtterance.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"validateIntegration.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/validateIntegration.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA0B7D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAuVlE"}
+{"version":3,"file":"validateIntegration.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/validateIntegration.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA0B7D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA0WlE"}

package/dist/tools/handlers/validateIntegration.js

@@ -16,6 +16,11 @@
 //   * Android: AGP + Gradle versions meet the library's floor
 //   * Android: declare a foreground-service hint when capabilities require
 //     background mic / camera survival
+//   * Android: ExtentosBootstrap subclass field-init footgun — top-level
+//     property initializers that touch Context (via `(this)` or a `getXxx()`
+//     Context method) run before `attachBaseContext` wires the Context and
+//     NPE at app start. Heuristic regex check; flags suspect lines so the
+//     dev can switch to `by lazy { ... }` or move the init into `onCreate()`.
 import { readFileSync, existsSync, readdirSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { join, isAbsolute, resolve } from "node:path";
@@ -312,10 +317,29 @@ export function handleValidateIntegration(raw) {
     // longer exists.
     const bCheck = checkBootstrap(projectPath, generatedFiles, platform);
     checks.push(bCheck);
+    // bootstrap_subclass_field_inits_safe — heuristic NPE footgun check.
+    // Customers who extend ExtentosBootstrap with a peer field like
+    // `val library = LibraryStore(this)` crash at app start because the
+    // initializer runs before attachBaseContext wires Context. Caught
+    // during the 2026-05-24 dogfood; emits warn-severity with the offending
+    // file + the property name so the dev can switch to `by lazy` or move
+    // the init into onCreate(). Android-only (Application lifecycle quirk).
+    const fiCheck = checkBootstrapSubclassFieldInits(projectPath, platform);
+    if (fiCheck)
+        checks.push(fiCheck);
     // ui_artifact_matches_usage
     const uiCheck = checkUiArtifact(projectPath, platform, manifest);
     if (uiCheck)
         checks.push(uiCheck);
+    // Phase 4 — assistant_integration_advisory (S2.W.8). Detects whether the
+    // app uses the canonical Phase 4 `glasses.assistant.start` surface, flags
+    // legacy Phase 3 `glasses.conversation.*` / `glasses.ai.complete` calls
+    // with v2.0.0-removal warnings, and notes when both coexist (the v1.4.0
+    // migration window). Soft-severity — info when only Phase 4 is used;
+    // warn when Phase 3 is still present.
+    const phase4Check = checkAssistantIntegration(projectPath, platform);
+    if (phase4Check)
+        checks.push(phase4Check);
     // agp_version_supported + gradle_version_supported (Android only).
     // F-R4-8: read the project's actual AGP/Gradle versions, compare against
     // the manifest's recorded minimums (or VERSION_INFO if the manifest
@@ -572,6 +596,64 @@ function checkBootstrap(projectPath, generatedFiles, platform) {
         details: `Bootstrap calls ${expectedCreate}…). SDK is wired.`,
     };
 }
+// Phase 4 — assistant_integration_advisory (S2.W.8). Light source scan
+// to surface Phase 3 / Phase 4 usage. Three observable states:
+//   - Phase 4 only (assistant.start present, conversation.* + ai.complete
+//     absent) → info, "✓ Phase 4 canonical surface in use"
+//   - Phase 3 still present (conversation.* or ai.complete found) → warn,
+//     "Phase 3 conversation runtime is DEPRECATED in v1.4.0 and removed
+//     in v2.0.0; migrate to glasses.assistant.start"
+//   - Both coexist → info, "Mixed Phase 3 + Phase 4 — migration in progress,
+//     complete before v2.0.0"
+//   - Neither (no voice AI wired) → null (no check emitted; not all apps
+//     use voice AI)
+//
+// Detection by string scan, not AST — fine for an advisory check.
+function checkAssistantIntegration(projectPath, platform) {
+    // Source needles for Phase 4 and Phase 3 voice surfaces.
+    const phase4Needle = "assistant.start"; // glasses.assistant.start { ... }
+    const phase3Needles = ["conversation.onWake", "conversation.start", "ai.complete"];
+    let usesPhase4 = false;
+    let usesPhase3 = false;
+    for (const root of candidateSourceRoots(projectPath, platform)) {
+        if (!existsSync(root))
+            continue;
+        const text = readProjectText(root);
+        if (text.includes(phase4Needle))
+            usesPhase4 = true;
+        if (phase3Needles.some((n) => text.includes(n)))
+            usesPhase3 = true;
+        if (usesPhase4 && usesPhase3)
+            break;
+    }
+    // No voice-AI surface detected — not every app uses voice; emit nothing.
+    if (!usesPhase4 && !usesPhase3)
+        return null;
+    if (usesPhase4 && !usesPhase3) {
+        return {
+            name: "assistant_integration_advisory",
+            passed: true,
+            severity: "info",
+            details: "✓ Phase 4 canonical voice-AI surface (`glasses.assistant.start`) detected; no deprecated Phase 3 conversation runtime references found.",
+        };
+    }
+    if (!usesPhase4 && usesPhase3) {
+        return {
+            name: "assistant_integration_advisory",
+            passed: false,
+            severity: "warn",
+            details: "Phase 3 conversation runtime detected (`glasses.conversation.*` or `glasses.ai.complete`). These APIs are DEPRECATED in v1.4.0 and REMOVED in v2.0.0. Migrate to `glasses.assistant.start { tool(name, description) { body } }` — customer code typically drops ~60% LoC.",
+            fix: "Read `docs/migration/phase-3-to-phase-4.md` (also available via `searchDocs(topic: 'assistant_runtime')`). Migrate each `onWake { while(true) { listen() ... } }` block to `assistant.start(provider) { tool(...) { ... } }`. Migrate each `glasses.ai.complete(prompt)` call to OpenAI SDK direct (walkthrough C). Same BYOK key; rename `glasses.ai.setOpenaiApiKey` → `glasses.assistant.setOpenaiApiKey`.",
+        };
+    }
+    // Both present — migration in progress.
+    return {
+        name: "assistant_integration_advisory",
+        passed: true,
+        severity: "info",
+        details: "Mixed Phase 3 + Phase 4 voice-AI surfaces detected. v1.4.0 deprecation window — both coexist. Complete the Phase 3 → Phase 4 migration before v2.0.0 (3-month deprecation window from v1.4.0 ship date). See `docs/migration/phase-3-to-phase-4.md`.",
+    };
+}
 function checkUiArtifact(projectPath, platform, manifest) {
     const uiSymbols = ["ExtentosConnectionPage", "ExtentosTheme", "rememberExtentosState", "ExtentosState"];
     let anyUsage = false;
@@ -760,6 +842,92 @@ function readTextSafe(abs) {
         return "";
     }
 }
+function walkKtFiles(root, fn, depth = 0, cap = 6) {
+    if (depth > cap)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const name = entry.name;
+        if (name.startsWith(".") || name === "node_modules" || name === "build" || name === "Pods")
+            continue;
+        const abs = join(root, name);
+        if (entry.isDirectory()) {
+            walkKtFiles(abs, fn, depth + 1, cap);
+        }
+        else if (/\.kt$/.test(name)) {
+            fn(abs, readTextSafe(abs));
+        }
+    }
+}
+function shortPath(abs, projectPath) {
+    return abs.startsWith(projectPath)
+        ? abs.slice(projectPath.length + 1).replaceAll("\\", "/")
+        : abs;
+}
+function checkBootstrapSubclassFieldInits(projectPath, platform) {
+    if (platform !== "android")
+        return null;
+    const findings = [];
+    for (const root of candidateSourceRoots(projectPath, "android")) {
+        walkKtFiles(root, (file, text) => {
+            // Only examine files declaring a subclass of ExtentosBootstrap. We
+            // don't try to AST-parse — Kotlin lacks a cheap JS parser here, and
+            // the canonical subclass form (`class MyApp : ExtentosBootstrap() {`)
+            // is well-bounded enough that regex is good enough.
+            const header = text.match(/class\s+\w+\s*[^{]*:\s*ExtentosBootstrap\s*\(\s*\)\s*\{/);
+            if (!header)
+                return;
+            // Scan the class body up to the first member function declaration —
+            // top-level property initializers live in that window. Members
+            // declared inside `companion object { ... }` or nested classes are
+            // out of scope for the constructor-time NPE we care about.
+            const bodyStart = (header.index ?? 0) + header[0].length;
+            const afterBody = text.slice(bodyStart);
+            const firstFn = afterBody.match(/^\s*(?:override\s+|protected\s+|private\s+|internal\s+|public\s+)*fun\s+/m);
+            const bodyEnd = firstFn ? bodyStart + (firstFn.index ?? 0) : text.length;
+            const body = text.slice(bodyStart, bodyEnd);
+            // Match property declarations with single-line initializers. Skips
+            // `lateinit var` (no `=`), multi-line inits (rare for fields, OK to
+            // miss), and explicit `by lazy { ... }` (safe — first read fires
+            // after super.onCreate()).
+            const fieldInitRe = /^\s*(?:private\s+|protected\s+|internal\s+|public\s+)?(?:val|var)\s+(\w+)(?:\s*:\s*[^=]+?)?\s*=\s*([^\n]+)$/gm;
+            let m;
+            while ((m = fieldInitRe.exec(body))) {
+                const name = m[1];
+                const initText = m[2].trim();
+                if (/\bby\s+lazy\b/.test(initText))
+                    continue;
+                if (/\blazy\s*\(/.test(initText))
+                    continue;
+                const touchesContext = /\bthis\b/.test(initText) ||
+                    /\bget(?:FilesDir|CacheDir|ExternalFilesDir|NoBackupFilesDir|CodeCacheDir|Dir|SharedPreferences|ApplicationContext|SystemService|Resources|Assets|ContentResolver|PackageManager|String|Database|DatabasePath)\s*\(/.test(initText);
+                if (touchesContext) {
+                    findings.push(`${shortPath(file, projectPath)}: \`${name}\` initializer touches Context: \`${initText.slice(0, 80)}${initText.length > 80 ? "…" : ""}\``);
+                }
+            }
+        });
+    }
+    if (findings.length === 0) {
+        return {
+            name: "bootstrap_subclass_field_inits_safe",
+            passed: true,
+            details: "No ExtentosBootstrap subclass field-init touches Context (or no subclass exists — both fine).",
+        };
+    }
+    return {
+        name: "bootstrap_subclass_field_inits_safe",
+        passed: false,
+        severity: "warn",
+        details: `Detected ${findings.length} field initializer(s) on an ExtentosBootstrap subclass that may touch Context before \`attachBaseContext\` wires it. The app will crash at start with NullPointerException because top-level property initializers run before super.onCreate(). Suspect line(s):\n${findings.map((f) => `  - ${f}`).join("\n")}`,
+        fix: "Wrap each suspect field in `by lazy { ... }` (first read fires the initializer after super.onCreate()) or move the init into onCreate() itself with `lateinit var … ; private set`. See ExtentosBootstrap.kt KDoc for examples.",
+    };
+}
 function sha256(text) {
     return createHash("sha256").update(text).digest("hex");
 }