@adhdev/daemon-standalone 0.8.64 → 0.8.66

package/dist/index.js

@@ -28313,6 +28313,227 @@ var require_dist2 = __commonJS({
         LOG_PATH = path6.join(LOG_DIR, `daemon-${getDateStr()}.log`);
       }
     });
+    function normalizeInputEnvelope(input) {
+      const normalized = normalizeInputEnvelopePayload(input);
+      const textFallback = normalized.textFallback ?? flattenInputParts(normalized.parts);
+      return {
+        parts: normalized.parts,
+        textFallback,
+        ...normalized.metadata ? { metadata: normalized.metadata } : {}
+      };
+    }
+    function normalizeMessageParts(content) {
+      if (typeof content === "string") return [{ type: "text", text: content }];
+      if (!Array.isArray(content)) {
+        if (content && typeof content === "object" && typeof content.text === "string") {
+          return [{ type: "text", text: String(content.text) }];
+        }
+        return [];
+      }
+      const parts = [];
+      for (const raw of content) {
+        if (typeof raw === "string") {
+          parts.push({ type: "text", text: raw });
+          continue;
+        }
+        if (!raw || typeof raw !== "object") continue;
+        const part = normalizeMessagePartObject(raw);
+        if (part) parts.push(part);
+      }
+      return parts;
+    }
+    function flattenMessageParts(parts) {
+      return parts.map((part) => {
+        if (part.type === "text") return part.text;
+        if (part.type === "resource") return part.resource.text || "";
+        return "";
+      }).filter((value) => value.length > 0).join("\n");
+    }
+    function normalizeInputEnvelopePayload(input) {
+      if (typeof input === "string") {
+        return { parts: [{ type: "text", text: input }], textFallback: input };
+      }
+      if (!input || typeof input !== "object") {
+        return { parts: [], textFallback: "" };
+      }
+      const record2 = input;
+      const nestedInput = record2.input;
+      if (nestedInput && typeof nestedInput === "object") {
+        const nested = nestedInput;
+        return {
+          parts: normalizeInputParts(nested.parts ?? nested.prompt),
+          textFallback: typeof nested.textFallback === "string" ? nested.textFallback : void 0,
+          metadata: normalizeInputMetadata(nested.metadata)
+        };
+      }
+      const directText = typeof record2.text === "string" ? record2.text : typeof record2.message === "string" ? record2.message : void 0;
+      if (directText !== void 0) {
+        return { parts: [{ type: "text", text: directText }], textFallback: directText };
+      }
+      const directParts = normalizeInputParts(record2.parts ?? record2.prompt);
+      return {
+        parts: directParts,
+        textFallback: typeof record2.textFallback === "string" ? record2.textFallback : void 0,
+        metadata: normalizeInputMetadata(record2.metadata)
+      };
+    }
+    function normalizeInputMetadata(value) {
+      if (!value || typeof value !== "object") return void 0;
+      const record2 = value;
+      const metadata = {};
+      if (record2.source === "dashboard" || record2.source === "shortcut_api" || record2.source === "provider_script" || record2.source === "session_replay") {
+        metadata.source = record2.source;
+      }
+      if (typeof record2.clientTimestamp === "number" && Number.isFinite(record2.clientTimestamp)) {
+        metadata.clientTimestamp = record2.clientTimestamp;
+      }
+      return Object.keys(metadata).length > 0 ? metadata : void 0;
+    }
+    function normalizeInputParts(value) {
+      if (!Array.isArray(value)) return [];
+      const parts = [];
+      for (const raw of value) {
+        if (typeof raw === "string") {
+          parts.push({ type: "text", text: raw });
+          continue;
+        }
+        if (!raw || typeof raw !== "object") continue;
+        const part = normalizeInputPartObject(raw);
+        if (part) parts.push(part);
+      }
+      return parts;
+    }
+    function normalizeInputPartObject(raw) {
+      const type = raw.type;
+      if (type === "text" && typeof raw.text === "string") {
+        return { type, text: raw.text };
+      }
+      if (type === "image" && typeof raw.mimeType === "string") {
+        return {
+          type,
+          mimeType: raw.mimeType,
+          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
+          ...typeof raw.data === "string" ? { data: raw.data } : {},
+          ...typeof raw.alt === "string" ? { alt: raw.alt } : {}
+        };
+      }
+      if (type === "audio" && typeof raw.mimeType === "string") {
+        return {
+          type,
+          mimeType: raw.mimeType,
+          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
+          ...typeof raw.data === "string" ? { data: raw.data } : {},
+          ...typeof raw.transcript === "string" ? { transcript: raw.transcript } : {}
+        };
+      }
+      if (type === "video" && typeof raw.mimeType === "string") {
+        return {
+          type,
+          mimeType: raw.mimeType,
+          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
+          ...typeof raw.data === "string" ? { data: raw.data } : {},
+          ...typeof raw.posterUri === "string" ? { posterUri: raw.posterUri } : {}
+        };
+      }
+      if (type === "resource" && typeof raw.uri === "string") {
+        return {
+          type,
+          uri: raw.uri,
+          ...typeof raw.mimeType === "string" ? { mimeType: raw.mimeType } : {},
+          ...typeof raw.name === "string" ? { name: raw.name } : {},
+          ...typeof raw.text === "string" ? { text: raw.text } : {},
+          ...typeof raw.data === "string" ? { data: raw.data } : {}
+        };
+      }
+      if (type === "resource_link" && typeof raw.uri === "string") {
+        return {
+          type: "resource",
+          uri: raw.uri,
+          ...typeof raw.mimeType === "string" ? { mimeType: raw.mimeType } : {},
+          ...typeof raw.name === "string" ? { name: raw.name } : {}
+        };
+      }
+      return null;
+    }
+    function normalizeMessagePartObject(raw) {
+      const type = raw.type;
+      if (type === "text" && typeof raw.text === "string") {
+        return { type, text: raw.text };
+      }
+      if (type === "image" && typeof raw.mimeType === "string") {
+        return {
+          type,
+          mimeType: raw.mimeType,
+          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
+          ...typeof raw.data === "string" ? { data: raw.data } : {}
+        };
+      }
+      if (type === "audio" && typeof raw.mimeType === "string") {
+        return {
+          type,
+          mimeType: raw.mimeType,
+          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
+          ...typeof raw.data === "string" ? { data: raw.data } : {},
+          ...typeof raw.transcript === "string" ? { transcript: raw.transcript } : {}
+        };
+      }
+      if (type === "video" && typeof raw.mimeType === "string") {
+        return {
+          type,
+          mimeType: raw.mimeType,
+          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
+          ...typeof raw.data === "string" ? { data: raw.data } : {},
+          ...typeof raw.posterUri === "string" ? { posterUri: raw.posterUri } : {}
+        };
+      }
+      if (type === "resource_link" && typeof raw.uri === "string" && typeof raw.name === "string") {
+        return {
+          type,
+          uri: raw.uri,
+          name: raw.name,
+          ...typeof raw.mimeType === "string" ? { mimeType: raw.mimeType } : {},
+          ...typeof raw.size === "number" ? { size: raw.size } : {}
+        };
+      }
+      if (type === "resource" && raw.resource && typeof raw.resource === "object") {
+        const resource = raw.resource;
+        if (typeof resource.uri !== "string") return null;
+        return {
+          type,
+          resource: {
+            uri: resource.uri,
+            ...typeof resource.mimeType === "string" || resource.mimeType === null ? { mimeType: resource.mimeType } : {},
+            ...typeof resource.text === "string" ? { text: resource.text } : {},
+            ...typeof resource.blob === "string" ? { blob: resource.blob } : {}
+          }
+        };
+      }
+      return null;
+    }
+    function flattenInputParts(parts) {
+      return parts.map((part) => {
+        if (part.type === "text") return part.text;
+        if (part.type === "audio") return part.transcript || "";
+        if (part.type === "resource") return part.text || "";
+        return "";
+      }).filter((value) => value.length > 0).join("\n");
+    }
+    var init_io_contracts = __esm2({
+      "src/providers/io-contracts.ts"() {
+        "use strict";
+      }
+    });
+    function flattenContent(content) {
+      if (typeof content === "string") return content;
+      return flattenMessageParts(normalizeMessageParts(content));
+    }
+    var init_contracts = __esm2({
+      "src/providers/contracts.ts"() {
+        "use strict";
+        init_io_contracts();
+        init_io_contracts();
+      }
+    });
     function canonicalizeKindHint(value) {
       return value.trim().toLowerCase().replace(/[\s-]+/g, "_");
     }
@@ -28463,6 +28684,127 @@ var require_dist2 = __commonJS({
         };
       }
     });
+    function isPlainObject3(value) {
+      return !!value && typeof value === "object" && !Array.isArray(value);
+    }
+    function isFiniteNumber(value) {
+      return typeof value === "number" && Number.isFinite(value);
+    }
+    function validateStatus(status, source) {
+      if (typeof status !== "string" || !VALID_STATUSES.includes(status)) {
+        throw new Error(`${source}: status must be one of ${VALID_STATUSES.join(", ")}`);
+      }
+      return status;
+    }
+    function validateRole(role, source, index) {
+      if (typeof role !== "string" || !VALID_ROLES.includes(role)) {
+        throw new Error(`${source}: messages[${index}].role must be one of ${VALID_ROLES.join(", ")}`);
+      }
+      return role;
+    }
+    function validateMessageContent(content, source, index) {
+      if (typeof content === "string") return content;
+      if (Array.isArray(content)) return normalizeMessageParts(content);
+      throw new Error(`${source}: messages[${index}].content must be a string or structured content array`);
+    }
+    function validateMessage(message, source, index) {
+      if (!isPlainObject3(message)) {
+        throw new Error(`${source}: messages[${index}] must be an object`);
+      }
+      const normalized = {
+        role: validateRole(message.role, source, index),
+        content: validateMessageContent(message.content, source, index)
+      };
+      if (typeof message.kind === "string") normalized.kind = message.kind;
+      if (typeof message.id === "string") normalized.id = message.id;
+      if (isFiniteNumber(message.index)) normalized.index = message.index;
+      if (isFiniteNumber(message.timestamp)) normalized.timestamp = message.timestamp;
+      if (isFiniteNumber(message.receivedAt)) normalized.receivedAt = message.receivedAt;
+      if (Array.isArray(message.toolCalls)) normalized.toolCalls = message.toolCalls;
+      if (isPlainObject3(message.meta)) normalized.meta = message.meta;
+      if (typeof message.senderName === "string") normalized.senderName = message.senderName;
+      if (typeof message._type === "string") normalized._type = message._type;
+      if (typeof message._sub === "string") normalized._sub = message._sub;
+      return normalized;
+    }
+    function validateModal(activeModal, status, source) {
+      if (activeModal == null) {
+        if (status === "waiting_approval") {
+          throw new Error(`${source}: waiting_approval status requires activeModal with buttons`);
+        }
+        return activeModal === null ? null : void 0;
+      }
+      if (!isPlainObject3(activeModal)) {
+        throw new Error(`${source}: activeModal must be an object when provided`);
+      }
+      if (typeof activeModal.message !== "string") {
+        throw new Error(`${source}: activeModal.message must be a string`);
+      }
+      if (!Array.isArray(activeModal.buttons) || activeModal.buttons.some((button) => typeof button !== "string" || !button.trim())) {
+        throw new Error(`${source}: activeModal.buttons must be a non-empty string array`);
+      }
+      const normalized = {
+        message: activeModal.message,
+        buttons: activeModal.buttons.map((button) => button.trim())
+      };
+      if (isFiniteNumber(activeModal.width)) normalized.width = activeModal.width;
+      if (isFiniteNumber(activeModal.height)) normalized.height = activeModal.height;
+      return normalized;
+    }
+    function validateControlValues(controlValues, source) {
+      if (controlValues === void 0) return void 0;
+      if (!isPlainObject3(controlValues)) {
+        throw new Error(`${source}: controlValues must be an object when provided`);
+      }
+      const normalized = {};
+      for (const [key, value] of Object.entries(controlValues)) {
+        if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
+          throw new Error(`${source}: controlValues.${key} must be string, number, or boolean`);
+        }
+        normalized[key] = value;
+      }
+      return normalized;
+    }
+    function validateReadChatResultPayload(raw, source = "read_chat") {
+      if (!isPlainObject3(raw)) {
+        throw new Error(`${source}: payload must be an object`);
+      }
+      const status = validateStatus(raw.status, source);
+      if (!Array.isArray(raw.messages)) {
+        throw new Error(`${source}: messages must be an array`);
+      }
+      const messages = raw.messages.map((message, index) => validateMessage(message, source, index));
+      const activeModal = validateModal(raw.activeModal, status, source);
+      const controlValues = validateControlValues(raw.controlValues, source);
+      const normalized = {
+        status,
+        messages
+      };
+      if (activeModal !== void 0) normalized.activeModal = activeModal;
+      if (typeof raw.id === "string") normalized.id = raw.id;
+      if (typeof raw.title === "string") normalized.title = raw.title;
+      if (typeof raw.agentType === "string") normalized.agentType = raw.agentType;
+      if (typeof raw.agentName === "string") normalized.agentName = raw.agentName;
+      if (typeof raw.extensionId === "string") normalized.extensionId = raw.extensionId;
+      if (typeof raw.inputContent === "string") normalized.inputContent = raw.inputContent;
+      if (typeof raw.isVisible === "boolean") normalized.isVisible = raw.isVisible;
+      if (typeof raw.isWelcomeScreen === "boolean") normalized.isWelcomeScreen = raw.isWelcomeScreen;
+      if (controlValues) normalized.controlValues = controlValues;
+      if (raw.summaryMetadata !== void 0) normalized.summaryMetadata = raw.summaryMetadata;
+      if (Array.isArray(raw.effects)) normalized.effects = raw.effects;
+      if (typeof raw.providerSessionId === "string") normalized.providerSessionId = raw.providerSessionId;
+      return normalized;
+    }
+    var VALID_STATUSES;
+    var VALID_ROLES;
+    var init_read_chat_contract = __esm2({
+      "src/providers/read-chat-contract.ts"() {
+        "use strict";
+        init_contracts();
+        VALID_STATUSES = ["idle", "generating", "waiting_approval", "error", "panel_hidden", "streaming", "long_generating"];
+        VALID_ROLES = ["user", "assistant", "system", "human"];
+      }
+    });
     function isModuleNotFoundError(error48, ref) {
       if (!(error48 instanceof Error)) return false;
       const message = error48.message || "";
@@ -29313,6 +29655,7 @@ var require_dist2 = __commonJS({
         init_pty_transport();
         init_provider_cli_shared();
         init_chat_message_normalization();
+        init_read_chat_contract();
         init_provider_cli_parse();
         init_provider_cli_config();
         init_provider_cli_runtime();
@@ -30458,6 +30801,9 @@ var require_dist2 = __commonJS({
                 runtimeSettings: this.runtimeSettings
               });
               const parsed = this.cliScripts.parseOutput(input);
+              if (parsed && typeof parsed === "object") {
+                Object.assign(parsed, validateReadChatResultPayload(parsed, `${this.cliType} parseOutput`));
+              }
               const refinedStatus = this.refineDetectedStatus(typeof parsed?.status === "string" ? parsed.status : null, input.recentBuffer, input.screenText);
               if (parsed && refinedStatus && parsed.status !== refinedStatus) {
                 parsed.status = refinedStatus;
@@ -33016,352 +33362,145 @@ ${data.message || ""}`.trim();
           return { success: false, error: e.message };
         }
       }
-      /**
-      * CDP DOM Debug — IDE AI panel specialized analysis
-      * Collect all essential info at once when supporting new IDE
-      * 
-      * args:
-      * ideType?: string — IDE type hint
-      * sessionId?: string — agent webview session ID 
-      */
-      async handleDomDebug(args) {
-        if (!this.getCdp()?.isConnected) return { success: false, error: "CDP not connected" };
-        const sessionId = args?.sessionId;
-        const expression = `(() => {
-            const result = {
-                url: location.href,
-                title: document.title,
-                viewport: { w: window.innerWidth, h: window.innerHeight },
-                
- // Input field info
-                inputs: [],
- // Textarea info
-                textareas: [],
- // Contenteditable info
-                editables: [],
- // Buttons (send, submit etc)
-                buttons: [],
- // iframes (agent webviews)
-                iframes: [],
- // role="textbox" info
-                textboxes: [],
-            };
-
- // Input fields
-            document.querySelectorAll('input[type="text"], input:not([type])').forEach((el, i) => {
-                if (i >= 10) return;
-                result.inputs.push({
-                    tag: 'input',
-                    id: el.id || null,
-                    class: (el.className || '').toString().slice(0, 150),
-                    placeholder: el.getAttribute('placeholder') || null,
-                    name: el.name || null,
-                    value: el.value?.slice(0, 100) || null,
-                    visible: el.offsetParent !== null,
-                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
-                });
-            });
-
- // textarea
-            document.querySelectorAll('textarea').forEach((el, i) => {
-                if (i >= 10) return;
-                result.textareas.push({
-                    id: el.id || null,
-                    class: (el.className || '').toString().slice(0, 150),
-                    placeholder: el.getAttribute('placeholder') || null,
-                    rows: el.rows,
-                    value: el.value?.slice(0, 100) || null,
-                    visible: el.offsetParent !== null,
-                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
-                });
-            });
-
- // contenteditable
-            document.querySelectorAll('[contenteditable="true"]').forEach((el, i) => {
-                if (i >= 10) return;
-                result.editables.push({
-                    tag: el.tagName?.toLowerCase(),
-                    id: el.id || null,
-                    class: (el.className || '').toString().slice(0, 150),
-                    role: el.getAttribute('role') || null,
-                    text: (el.textContent || '').trim().slice(0, 100),
-                    visible: el.offsetParent !== null,
-                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
-                });
-            });
-
- // role="textbox"
-            document.querySelectorAll('[role="textbox"]').forEach((el, i) => {
-                if (i >= 10) return;
-                result.textboxes.push({
-                    tag: el.tagName?.toLowerCase(),
-                    id: el.id || null,
-                    class: (el.className || '').toString().slice(0, 150),
-                    'aria-label': el.getAttribute('aria-label') || null,
-                    text: (el.textContent || '').trim().slice(0, 100),
-                    visible: el.offsetParent !== null,
-                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
-                });
-            });
-
- // Buttons (send, submit, accept, reject, approve etc)
-            const btnKeywords = /send|submit|accept|reject|approve|deny|cancel|confirm|run|execute|apply/i;
-            document.querySelectorAll('button, [role="button"], input[type="submit"]').forEach((el, i) => {
-                const text = (el.textContent || el.getAttribute('aria-label') || '').trim();
-                if (i < 30 && (text.length < 30 || btnKeywords.test(text))) {
-                    result.buttons.push({
-                        tag: el.tagName?.toLowerCase(),
-                        id: el.id || null,
-                        class: (el.className || '').toString().slice(0, 150),
-                        text: text.slice(0, 80),
-                        'aria-label': el.getAttribute('aria-label') || null,
-                        disabled: el.disabled || el.getAttribute('disabled') !== null,
-                        visible: el.offsetParent !== null,
-                        rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
-                    });
-                }
-            });
-
- // iframes
-            document.querySelectorAll('iframe, webview').forEach((el, i) => {
-                if (i >= 20) return;
-                result.iframes.push({
-                    tag: el.tagName?.toLowerCase(),
-                    id: el.id || null,
-                    class: (el.className || '').toString().slice(0, 150),
-                    src: el.getAttribute('src')?.slice(0, 200) || null,
-                    title: el.getAttribute('title') || null,
-                    visible: el.offsetParent !== null,
-                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
-                });
-            });
-
-            return JSON.stringify(result);
-        })()`;
-        try {
-          let raw;
-          if (sessionId) {
-            raw = await this.getCdp().evaluateInSessionFrame(sessionId, expression);
-          } else {
-            raw = await this.getCdp().evaluate(expression, 3e4);
-          }
-          const parsed = typeof raw === "string" ? JSON.parse(raw) : raw;
-          return { success: true, ...parsed };
-        } catch (e) {
-          return { success: false, error: e.message };
-        }
-      }
-    };
-    var crypto2 = __toESM2(require("crypto"));
-    function normalizeInputEnvelope(input) {
-      const normalized = normalizeInputEnvelopePayload(input);
-      const textFallback = normalized.textFallback ?? flattenInputParts(normalized.parts);
-      return {
-        parts: normalized.parts,
-        textFallback,
-        ...normalized.metadata ? { metadata: normalized.metadata } : {}
-      };
-    }
-    function normalizeMessageParts(content) {
-      if (typeof content === "string") return [{ type: "text", text: content }];
-      if (!Array.isArray(content)) {
-        if (content && typeof content === "object" && typeof content.text === "string") {
-          return [{ type: "text", text: String(content.text) }];
-        }
-        return [];
-      }
-      const parts = [];
-      for (const raw of content) {
-        if (typeof raw === "string") {
-          parts.push({ type: "text", text: raw });
-          continue;
-        }
-        if (!raw || typeof raw !== "object") continue;
-        const part = normalizeMessagePartObject(raw);
-        if (part) parts.push(part);
-      }
-      return parts;
-    }
-    function flattenMessageParts(parts) {
-      return parts.map((part) => {
-        if (part.type === "text") return part.text;
-        if (part.type === "resource") return part.resource.text || "";
-        return "";
-      }).filter((value) => value.length > 0).join("\n");
-    }
-    function normalizeInputEnvelopePayload(input) {
-      if (typeof input === "string") {
-        return { parts: [{ type: "text", text: input }], textFallback: input };
-      }
-      if (!input || typeof input !== "object") {
-        return { parts: [], textFallback: "" };
-      }
-      const record2 = input;
-      const nestedInput = record2.input;
-      if (nestedInput && typeof nestedInput === "object") {
-        const nested = nestedInput;
-        return {
-          parts: normalizeInputParts(nested.parts ?? nested.prompt),
-          textFallback: typeof nested.textFallback === "string" ? nested.textFallback : void 0,
-          metadata: normalizeInputMetadata(nested.metadata)
-        };
-      }
-      const directText = typeof record2.text === "string" ? record2.text : typeof record2.message === "string" ? record2.message : void 0;
-      if (directText !== void 0) {
-        return { parts: [{ type: "text", text: directText }], textFallback: directText };
-      }
-      const directParts = normalizeInputParts(record2.parts ?? record2.prompt);
-      return {
-        parts: directParts,
-        textFallback: typeof record2.textFallback === "string" ? record2.textFallback : void 0,
-        metadata: normalizeInputMetadata(record2.metadata)
-      };
-    }
-    function normalizeInputMetadata(value) {
-      if (!value || typeof value !== "object") return void 0;
-      const record2 = value;
-      const metadata = {};
-      if (record2.source === "dashboard" || record2.source === "shortcut_api" || record2.source === "provider_script" || record2.source === "session_replay") {
-        metadata.source = record2.source;
-      }
-      if (typeof record2.clientTimestamp === "number" && Number.isFinite(record2.clientTimestamp)) {
-        metadata.clientTimestamp = record2.clientTimestamp;
-      }
-      return Object.keys(metadata).length > 0 ? metadata : void 0;
-    }
-    function normalizeInputParts(value) {
-      if (!Array.isArray(value)) return [];
-      const parts = [];
-      for (const raw of value) {
-        if (typeof raw === "string") {
-          parts.push({ type: "text", text: raw });
-          continue;
-        }
-        if (!raw || typeof raw !== "object") continue;
-        const part = normalizeInputPartObject(raw);
-        if (part) parts.push(part);
-      }
-      return parts;
-    }
-    function normalizeInputPartObject(raw) {
-      const type = raw.type;
-      if (type === "text" && typeof raw.text === "string") {
-        return { type, text: raw.text };
-      }
-      if (type === "image" && typeof raw.mimeType === "string") {
-        return {
-          type,
-          mimeType: raw.mimeType,
-          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
-          ...typeof raw.data === "string" ? { data: raw.data } : {},
-          ...typeof raw.alt === "string" ? { alt: raw.alt } : {}
-        };
-      }
-      if (type === "audio" && typeof raw.mimeType === "string") {
-        return {
-          type,
-          mimeType: raw.mimeType,
-          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
-          ...typeof raw.data === "string" ? { data: raw.data } : {},
-          ...typeof raw.transcript === "string" ? { transcript: raw.transcript } : {}
-        };
-      }
-      if (type === "video" && typeof raw.mimeType === "string") {
-        return {
-          type,
-          mimeType: raw.mimeType,
-          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
-          ...typeof raw.data === "string" ? { data: raw.data } : {},
-          ...typeof raw.posterUri === "string" ? { posterUri: raw.posterUri } : {}
-        };
-      }
-      if (type === "resource" && typeof raw.uri === "string") {
-        return {
-          type,
-          uri: raw.uri,
-          ...typeof raw.mimeType === "string" ? { mimeType: raw.mimeType } : {},
-          ...typeof raw.name === "string" ? { name: raw.name } : {},
-          ...typeof raw.text === "string" ? { text: raw.text } : {},
-          ...typeof raw.data === "string" ? { data: raw.data } : {}
-        };
-      }
-      if (type === "resource_link" && typeof raw.uri === "string") {
-        return {
-          type: "resource",
-          uri: raw.uri,
-          ...typeof raw.mimeType === "string" ? { mimeType: raw.mimeType } : {},
-          ...typeof raw.name === "string" ? { name: raw.name } : {}
-        };
-      }
-      return null;
-    }
-    function normalizeMessagePartObject(raw) {
-      const type = raw.type;
-      if (type === "text" && typeof raw.text === "string") {
-        return { type, text: raw.text };
-      }
-      if (type === "image" && typeof raw.mimeType === "string") {
-        return {
-          type,
-          mimeType: raw.mimeType,
-          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
-          ...typeof raw.data === "string" ? { data: raw.data } : {}
-        };
-      }
-      if (type === "audio" && typeof raw.mimeType === "string") {
-        return {
-          type,
-          mimeType: raw.mimeType,
-          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
-          ...typeof raw.data === "string" ? { data: raw.data } : {},
-          ...typeof raw.transcript === "string" ? { transcript: raw.transcript } : {}
-        };
-      }
-      if (type === "video" && typeof raw.mimeType === "string") {
-        return {
-          type,
-          mimeType: raw.mimeType,
-          ...typeof raw.uri === "string" ? { uri: raw.uri } : {},
-          ...typeof raw.data === "string" ? { data: raw.data } : {},
-          ...typeof raw.posterUri === "string" ? { posterUri: raw.posterUri } : {}
-        };
-      }
-      if (type === "resource_link" && typeof raw.uri === "string" && typeof raw.name === "string") {
-        return {
-          type,
-          uri: raw.uri,
-          name: raw.name,
-          ...typeof raw.mimeType === "string" ? { mimeType: raw.mimeType } : {},
-          ...typeof raw.size === "number" ? { size: raw.size } : {}
-        };
-      }
-      if (type === "resource" && raw.resource && typeof raw.resource === "object") {
-        const resource = raw.resource;
-        if (typeof resource.uri !== "string") return null;
-        return {
-          type,
-          resource: {
-            uri: resource.uri,
-            ...typeof resource.mimeType === "string" || resource.mimeType === null ? { mimeType: resource.mimeType } : {},
-            ...typeof resource.text === "string" ? { text: resource.text } : {},
-            ...typeof resource.blob === "string" ? { blob: resource.blob } : {}
+      /**
+      * CDP DOM Debug — IDE AI panel specialized analysis
+      * Collect all essential info at once when supporting new IDE
+      * 
+      * args:
+      * ideType?: string — IDE type hint
+      * sessionId?: string — agent webview session ID 
+      */
+      async handleDomDebug(args) {
+        if (!this.getCdp()?.isConnected) return { success: false, error: "CDP not connected" };
+        const sessionId = args?.sessionId;
+        const expression = `(() => {
+            const result = {
+                url: location.href,
+                title: document.title,
+                viewport: { w: window.innerWidth, h: window.innerHeight },
+                
+ // Input field info
+                inputs: [],
+ // Textarea info
+                textareas: [],
+ // Contenteditable info
+                editables: [],
+ // Buttons (send, submit etc)
+                buttons: [],
+ // iframes (agent webviews)
+                iframes: [],
+ // role="textbox" info
+                textboxes: [],
+            };
+
+ // Input fields
+            document.querySelectorAll('input[type="text"], input:not([type])').forEach((el, i) => {
+                if (i >= 10) return;
+                result.inputs.push({
+                    tag: 'input',
+                    id: el.id || null,
+                    class: (el.className || '').toString().slice(0, 150),
+                    placeholder: el.getAttribute('placeholder') || null,
+                    name: el.name || null,
+                    value: el.value?.slice(0, 100) || null,
+                    visible: el.offsetParent !== null,
+                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
+                });
+            });
+
+ // textarea
+            document.querySelectorAll('textarea').forEach((el, i) => {
+                if (i >= 10) return;
+                result.textareas.push({
+                    id: el.id || null,
+                    class: (el.className || '').toString().slice(0, 150),
+                    placeholder: el.getAttribute('placeholder') || null,
+                    rows: el.rows,
+                    value: el.value?.slice(0, 100) || null,
+                    visible: el.offsetParent !== null,
+                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
+                });
+            });
+
+ // contenteditable
+            document.querySelectorAll('[contenteditable="true"]').forEach((el, i) => {
+                if (i >= 10) return;
+                result.editables.push({
+                    tag: el.tagName?.toLowerCase(),
+                    id: el.id || null,
+                    class: (el.className || '').toString().slice(0, 150),
+                    role: el.getAttribute('role') || null,
+                    text: (el.textContent || '').trim().slice(0, 100),
+                    visible: el.offsetParent !== null,
+                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
+                });
+            });
+
+ // role="textbox"
+            document.querySelectorAll('[role="textbox"]').forEach((el, i) => {
+                if (i >= 10) return;
+                result.textboxes.push({
+                    tag: el.tagName?.toLowerCase(),
+                    id: el.id || null,
+                    class: (el.className || '').toString().slice(0, 150),
+                    'aria-label': el.getAttribute('aria-label') || null,
+                    text: (el.textContent || '').trim().slice(0, 100),
+                    visible: el.offsetParent !== null,
+                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
+                });
+            });
+
+ // Buttons (send, submit, accept, reject, approve etc)
+            const btnKeywords = /send|submit|accept|reject|approve|deny|cancel|confirm|run|execute|apply/i;
+            document.querySelectorAll('button, [role="button"], input[type="submit"]').forEach((el, i) => {
+                const text = (el.textContent || el.getAttribute('aria-label') || '').trim();
+                if (i < 30 && (text.length < 30 || btnKeywords.test(text))) {
+                    result.buttons.push({
+                        tag: el.tagName?.toLowerCase(),
+                        id: el.id || null,
+                        class: (el.className || '').toString().slice(0, 150),
+                        text: text.slice(0, 80),
+                        'aria-label': el.getAttribute('aria-label') || null,
+                        disabled: el.disabled || el.getAttribute('disabled') !== null,
+                        visible: el.offsetParent !== null,
+                        rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
+                    });
+                }
+            });
+
+ // iframes
+            document.querySelectorAll('iframe, webview').forEach((el, i) => {
+                if (i >= 20) return;
+                result.iframes.push({
+                    tag: el.tagName?.toLowerCase(),
+                    id: el.id || null,
+                    class: (el.className || '').toString().slice(0, 150),
+                    src: el.getAttribute('src')?.slice(0, 200) || null,
+                    title: el.getAttribute('title') || null,
+                    visible: el.offsetParent !== null,
+                    rect: (() => { try { const r = el.getBoundingClientRect(); return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }; } catch { return null; } })(),
+                });
+            });
+
+            return JSON.stringify(result);
+        })()`;
+        try {
+          let raw;
+          if (sessionId) {
+            raw = await this.getCdp().evaluateInSessionFrame(sessionId, expression);
+          } else {
+            raw = await this.getCdp().evaluate(expression, 3e4);
           }
-        };
+          const parsed = typeof raw === "string" ? JSON.parse(raw) : raw;
+          return { success: true, ...parsed };
+        } catch (e) {
+          return { success: false, error: e.message };
+        }
       }
-      return null;
-    }
-    function flattenInputParts(parts) {
-      return parts.map((part) => {
-        if (part.type === "text") return part.text;
-        if (part.type === "audio") return part.transcript || "";
-        if (part.type === "resource") return part.text || "";
-        return "";
-      }).filter((value) => value.length > 0).join("\n");
-    }
-    function flattenContent(content) {
-      if (typeof content === "string") return content;
-      return flattenMessageParts(normalizeMessageParts(content));
-    }
+    };
+    var crypto2 = __toESM2(require("crypto"));
+    init_contracts();
+    init_contracts();
     var DEFAULT_MONITOR_CONFIG = {
       approvalAlert: true,
       longGeneratingAlert: true,
@@ -33472,6 +33611,7 @@ ${data.message || ""}`.trim();
         }
       }
     };
+    init_contracts();
     init_chat_message_normalization();
     function extractProviderControlValues(controls, data) {
       if (!data || typeof data !== "object") return void 0;
@@ -33593,38 +33733,37 @@ ${data.message || ""}`.trim();
       return null;
     }
     function normalizeControlListResult(data) {
-      if (data && typeof data === "object" && Array.isArray(data.options)) {
-        return {
-          options: normalizeControlOptions(data.options),
-          ...isScalarControlValue(data.currentValue) ? { currentValue: data.currentValue } : {},
-          ...typeof data.error === "string" ? { error: data.error } : {}
-        };
+      if (!data || typeof data !== "object" || !Array.isArray(data.options)) {
+        throw new Error("Provider control list results must use the typed shape { options, currentValue?, error? }");
       }
-      const rawOptions = Array.isArray(data?.models) ? data.models : Array.isArray(data?.modes) ? data.modes : Array.isArray(data?.options) ? data.options : [];
-      const options = normalizeControlOptions(rawOptions);
       return {
-        options,
-        ...isScalarControlValue(data?.current) ? { currentValue: data.current } : {},
-        ...isScalarControlValue(data?.currentValue) ? { currentValue: data.currentValue } : {},
-        ...typeof data?.error === "string" ? { error: data.error } : {}
+        options: normalizeControlOptions(data.options),
+        ...isScalarControlValue(data.currentValue) ? { currentValue: data.currentValue } : {},
+        ...typeof data.error === "string" ? { error: data.error } : {}
       };
     }
     function normalizeControlSetResult(data) {
-      const currentValue = isScalarControlValue(data?.currentValue) ? data.currentValue : isScalarControlValue(data?.value) ? data.value : void 0;
+      if (!data || typeof data !== "object" || typeof data.ok !== "boolean") {
+        throw new Error("Provider control set results must use the typed shape { ok, currentValue?, effects?, error? }");
+      }
+      const currentValue = isScalarControlValue(data.currentValue) ? data.currentValue : isScalarControlValue(data.value) ? data.value : void 0;
       return {
-        ok: data?.ok === true || data?.success === true,
+        ok: data.ok,
         ...currentValue !== void 0 ? { currentValue } : {},
-        ...Array.isArray(data?.effects) ? { effects: normalizeProviderEffects(data) } : {},
-        ...typeof data?.error === "string" ? { error: data.error } : {}
+        ...Array.isArray(data.effects) ? { effects: normalizeProviderEffects(data) } : {},
+        ...typeof data.error === "string" ? { error: data.error } : {}
       };
     }
     function normalizeControlInvokeResult(data) {
-      const currentValue = isScalarControlValue(data?.currentValue) ? data.currentValue : isScalarControlValue(data?.value) ? data.value : void 0;
+      if (!data || typeof data !== "object" || typeof data.ok !== "boolean") {
+        throw new Error("Provider control invoke results must use the typed shape { ok, currentValue?, effects?, error? }");
+      }
+      const currentValue = isScalarControlValue(data.currentValue) ? data.currentValue : isScalarControlValue(data.value) ? data.value : void 0;
       return {
-        ok: data?.ok === true || data?.success === true,
+        ok: data.ok,
         ...currentValue !== void 0 ? { currentValue } : {},
-        ...Array.isArray(data?.effects) ? { effects: normalizeProviderEffects(data) } : {},
-        ...typeof data?.error === "string" ? { error: data.error } : {}
+        ...Array.isArray(data.effects) ? { effects: normalizeProviderEffects(data) } : {},
+        ...typeof data.error === "string" ? { error: data.error } : {}
       };
     }
     function normalizeControlOptions(options) {
@@ -34509,19 +34648,37 @@ ${cleanBody}`;
           );
         }
       }
+      buildSyntheticTurnKey(message, occurrence) {
+        const role = typeof message?.role === "string" ? message.role : "";
+        const kind = typeof message?.kind === "string" ? message.kind : "";
+        const senderName = typeof message?.senderName === "string" ? message.senderName : "";
+        const content = flattenContent(message?.content).replace(/\s+/g, " ").trim().slice(0, 500);
+        return `${role}|${kind}|${senderName}|${content}|${occurrence}`;
+      }
       /**
-       * Assign stable receivedAt to extension messages.
-       * Same pattern as IdeProviderInstance.readChat() prevByHash —
-       * preserves first-seen timestamp across polling cycles.
+       * Assign stable receivedAt / synthetic _turnKey to extension messages.
+       * Same transcript should keep the same identity across polling cycles and
+       * stream resets, while repeated identical text later in the transcript still
+       * produces a distinct completion marker via the occurrence suffix.
        */
       assignReceivedAt(messages) {
         const now = Date.now();
         const nextHashes = /* @__PURE__ */ new Map();
+        const occurrenceByBaseKey = /* @__PURE__ */ new Map();
         for (const msg of messages) {
-          const hash2 = `${msg.role}:${(msg.content || "").slice(0, 100)}`;
-          const prevTime = this.prevMessageHashes.get(hash2);
+          const explicitTurnKey = typeof msg?._turnKey === "string" && msg._turnKey.trim() ? msg._turnKey.trim() : "";
+          const explicitId = typeof msg?.id === "string" && msg.id.trim() ? `id:${msg.id.trim()}` : "";
+          const explicitIndex = typeof msg?.index === "number" && Number.isFinite(msg.index) ? `idx:${msg.index}` : "";
+          const baseKey = explicitTurnKey || explicitId || explicitIndex || `${msg?.role || ""}:${flattenContent(msg?.content || "").slice(0, 500)}`;
+          const occurrence = (occurrenceByBaseKey.get(baseKey) || 0) + 1;
+          occurrenceByBaseKey.set(baseKey, occurrence);
+          const syntheticTurnKey = explicitTurnKey || explicitId || explicitIndex || this.buildSyntheticTurnKey(msg, occurrence);
+          if (!explicitTurnKey && !explicitId && !explicitIndex) {
+            msg._turnKey = syntheticTurnKey;
+          }
+          const prevTime = this.prevMessageHashes.get(syntheticTurnKey);
           msg.receivedAt = prevTime || now;
-          nextHashes.set(hash2, msg.receivedAt);
+          nextHashes.set(syntheticTurnKey, msg.receivedAt);
         }
         this.prevMessageHashes = nextHashes;
         return normalizeChatMessages(messages);
@@ -34596,6 +34753,7 @@ ${effect.notification.body || ""}`.trim();
       }
     };
     init_logger();
+    init_read_chat_contract();
     var DEFAULT_APPROVAL_POSITIVE_HINTS = [
       "run",
       "approve",
@@ -34873,7 +35031,7 @@ ${effect.notification.body || ""}`.trim();
             }
           }
           if (!raw || typeof raw !== "object") return;
-          const chat = raw;
+          const chat = validateReadChatResultPayload(raw, `${this.type} readChat`);
           let { activeModal } = chat;
           if (activeModal) {
             const w = activeModal.width ?? Infinity;
@@ -36002,6 +36160,61 @@ ${effect.notification.body || ""}`.trim();
       }
     }
     init_logger();
+    init_contracts();
+    var VALID_INPUT_MEDIA_TYPES = /* @__PURE__ */ new Set(["text", "image", "audio", "video", "resource"]);
+    function getProviderLabel(provider) {
+      return provider?.name || provider?.type || "This provider";
+    }
+    function hasNonEmptyFallbackText(input) {
+      return typeof input.textFallback === "string" && input.textFallback.trim().length > 0;
+    }
+    function getRequestedInputMediaTypes(input) {
+      const types = /* @__PURE__ */ new Set();
+      if (hasNonEmptyFallbackText(input) && !input.parts.some((part) => part.type === "text")) {
+        types.add("text");
+      }
+      for (const part of input.parts) {
+        if (VALID_INPUT_MEDIA_TYPES.has(part.type)) {
+          types.add(part.type);
+        }
+      }
+      return Array.from(types);
+    }
+    function getEffectiveSemanticPartCount(input) {
+      let count = input.parts.length;
+      if (hasNonEmptyFallbackText(input) && !input.parts.some((part) => part.type === "text")) {
+        count += 1;
+      }
+      return count;
+    }
+    function assertTextOnlyInput(provider, input) {
+      const unsupported = getRequestedInputMediaTypes(input).filter((type) => type !== "text");
+      if (unsupported.length === 0) return;
+      const label = getProviderLabel(provider);
+      const suffix = unsupported.length === 1 ? "" : "s";
+      throw new Error(`${label} only supports text input; unsupported input type${suffix}: ${unsupported.join(", ")}`);
+    }
+    function getDeclaredProviderInputSupport(provider) {
+      const rawMediaTypes = Array.isArray(provider?.capabilities?.input?.mediaTypes) ? provider?.capabilities?.input?.mediaTypes.filter((type) => VALID_INPUT_MEDIA_TYPES.has(type)) : [];
+      return {
+        multipart: provider?.capabilities?.input?.multipart === true,
+        mediaTypes: new Set(rawMediaTypes.length > 0 ? rawMediaTypes : ["text"])
+      };
+    }
+    function assertProviderSupportsDeclaredInput(provider, input) {
+      const label = getProviderLabel(provider);
+      const support = getDeclaredProviderInputSupport(provider);
+      const requestedTypes = getRequestedInputMediaTypes(input);
+      const unsupported = requestedTypes.filter((type) => !support.mediaTypes.has(type));
+      if (unsupported.length > 0) {
+        const suffix = unsupported.length === 1 ? "" : "s";
+        throw new Error(`${label} does not support input type${suffix}: ${unsupported.join(", ")}`);
+      }
+      if (getEffectiveSemanticPartCount(input) > 1 && !support.multipart) {
+        throw new Error(`${label} does not support multipart input`);
+      }
+    }
+    init_read_chat_contract();
     init_logger();
     var NORMAL_TRACE_BUFFER_SIZE = 200;
     var DEV_TRACE_BUFFER_SIZE = 1e3;
@@ -36177,10 +36390,15 @@ ${effect.notification.body || ""}`.trim();
     function isExtensionTransport(transport) {
       return transport === "cdp-webview";
     }
-    function buildRecentSendKey(h, args, provider, text) {
+    function buildRecentSendKey(h, args, provider, signature) {
       const transport = getTargetTransport(h, provider) || "unknown";
       const target = args?.targetSessionId || args?.agentType || h.currentSession?.providerType || h.currentProviderType || h.currentManagerKey || "unknown";
-      return `${transport}:${target}:${text.trim()}`;
+      return `${transport}:${target}:${signature.trim()}`;
+    }
+    function buildSendInputSignature(input) {
+      const text = typeof input.textFallback === "string" ? input.textFallback.trim() : "";
+      if (text) return text;
+      return JSON.stringify(input.parts || []);
     }
     function getSendChatInputEnvelope(args) {
       return normalizeInputEnvelope(args?.input ? { input: args.input } : args);
@@ -36333,14 +36551,20 @@ ${effect.notification.body || ""}`.trim();
       };
     }
     function buildReadChatCommandResult(payload, args) {
-      const messages = normalizeReadChatMessages(payload);
+      let validatedPayload;
+      try {
+        validatedPayload = validateReadChatResultPayload(payload, "read_chat command result");
+      } catch (error48) {
+        return { success: false, error: error48?.message || String(error48) };
+      }
+      const messages = normalizeReadChatMessages(validatedPayload);
       const cursor = normalizeReadChatCursor(args);
       if (!cursor.knownMessageCount && !cursor.lastMessageSignature && cursor.tailLimit > 0 && messages.length > cursor.tailLimit) {
         const tailMessages = messages.slice(-cursor.tailLimit);
         const lastMessageSignature = getChatMessageSignature(tailMessages[tailMessages.length - 1]);
         return {
           success: true,
-          ...payload,
+          ...validatedPayload,
           messages: tailMessages,
           syncMode: "full",
           replaceFrom: 0,
@@ -36351,7 +36575,7 @@ ${effect.notification.body || ""}`.trim();
       const sync = computeReadChatSync(messages, cursor);
       return {
         success: true,
-        ...payload,
+        ...validatedPayload,
         messages: sync.messages,
         syncMode: sync.syncMode,
         replaceFrom: sync.replaceFrom,
@@ -36430,12 +36654,18 @@ ${effect.notification.body || ""}`.trim();
         const adapter = getTargetedCliAdapter(h, args, provider?.type);
         if (adapter) {
           _log(`${transport} adapter: ${adapter.cliType}`);
-          const status = adapter.getStatus();
+          const parsedStatus = typeof adapter.getScriptParsedStatus === "function" ? parseMaybeJson(adapter.getScriptParsedStatus()) : null;
+          const parsedRecord = parsedStatus && typeof parsedStatus === "object" ? parsedStatus : null;
+          const status = parsedRecord || adapter.getStatus();
+          const title = typeof parsedRecord?.title === "string" ? parsedRecord.title : void 0;
+          const providerSessionId = typeof parsedRecord?.providerSessionId === "string" ? parsedRecord.providerSessionId : void 0;
           if (status) {
             return buildReadChatCommandResult({
               messages: status.messages || [],
               status: status.status,
-              activeModal: status.activeModal
+              activeModal: status.activeModal,
+              ...title ? { title } : {},
+              ...providerSessionId ? { providerSessionId } : {}
             }, args);
           }
         }
@@ -36453,25 +36683,26 @@ ${effect.notification.body || ""}`.trim();
               }
             }
             if (parsed && typeof parsed === "object") {
-              _log(`Extension OK: ${parsed.messages?.length || 0} msgs`);
+              const validated = validateReadChatResultPayload(parsed, "extension read_chat");
+              _log(`Extension OK: ${validated.messages?.length || 0} msgs`);
               traceProviderEvent(args, "provider", "extension.read_chat.success", {
                 h,
                 provider,
                 payload: {
                   method: "evaluateProviderScript",
                   result: evalResult.result,
-                  parsed,
-                  messageCount: Array.isArray(parsed.messages) ? parsed.messages.length : 0
+                  parsed: validated,
+                  messageCount: Array.isArray(validated.messages) ? validated.messages.length : 0
                 }
               });
               h.historyWriter.appendNewMessages(
                 provider?.type || "unknown_extension",
-                toHistoryPersistedMessages(normalizeReadChatMessages(parsed)),
-                parsed.title,
+                toHistoryPersistedMessages(normalizeReadChatMessages(validated)),
+                validated.title,
                 args?.targetSessionId,
                 historySessionId
               );
-              return buildReadChatCommandResult(parsed, args);
+              return buildReadChatCommandResult(validated, args);
             }
           }
         } catch (e) {
@@ -36526,15 +36757,16 @@ ${effect.notification.body || ""}`.trim();
               }
             }
             if (parsed && typeof parsed === "object") {
-              _log(`Webview OK: ${parsed.messages?.length || 0} msgs`);
+              const validated = validateReadChatResultPayload(parsed, "webview read_chat");
+              _log(`Webview OK: ${validated.messages?.length || 0} msgs`);
               h.historyWriter.appendNewMessages(
                 provider?.type || getCurrentProviderType(h, "unknown_webview"),
-                toHistoryPersistedMessages(normalizeReadChatMessages(parsed)),
-                parsed.title,
+                toHistoryPersistedMessages(normalizeReadChatMessages(validated)),
+                validated.title,
                 args?.targetSessionId,
                 historySessionId
               );
-              return buildReadChatCommandResult(parsed, args);
+              return buildReadChatCommandResult(validated, args);
             }
           }
         } catch (e) {
@@ -36555,25 +36787,26 @@ ${effect.notification.body || ""}`.trim();
               }
             }
             if (parsed && typeof parsed === "object" && parsed.messages?.length > 0) {
-              _log(`OK: ${parsed.messages?.length} msgs`);
+              const validated = validateReadChatResultPayload(parsed, "ide read_chat");
+              _log(`OK: ${validated.messages?.length} msgs`);
               traceProviderEvent(args, "provider", "ide.read_chat.success", {
                 h,
                 provider,
                 payload: {
                   method: "evaluate",
                   result: evalResult.result,
-                  parsed,
-                  messageCount: Array.isArray(parsed.messages) ? parsed.messages.length : 0
+                  parsed: validated,
+                  messageCount: Array.isArray(validated.messages) ? validated.messages.length : 0
                 }
               });
               h.historyWriter.appendNewMessages(
                 provider?.type || getCurrentProviderType(h, "unknown_ide"),
-                toHistoryPersistedMessages(normalizeReadChatMessages(parsed)),
-                parsed.title,
+                toHistoryPersistedMessages(normalizeReadChatMessages(validated)),
+                validated.title,
                 args?.targetSessionId,
                 historySessionId
               );
-              return buildReadChatCommandResult(parsed, args);
+              return buildReadChatCommandResult(validated, args);
             }
           }
         } catch (e) {
@@ -36591,11 +36824,12 @@ ${effect.notification.body || ""}`.trim();
     async function handleSendChat(h, args) {
       const input = getSendChatInputEnvelope(args);
       const text = input.textFallback;
-      if (!text) return { success: false, error: "text required" };
+      const hasInput = input.parts.length > 0 || typeof text === "string" && text.trim().length > 0;
+      if (!hasInput) return { success: false, error: "input required" };
       const _log = (msg) => LOG2.debug("Command", `[send_chat] ${msg}`);
       const provider = h.getProvider(args?.agentType);
       const transport = getTargetTransport(h, provider);
-      const dedupeKey = buildRecentSendKey(h, args, provider, text);
+      const dedupeKey = buildRecentSendKey(h, args, provider, buildSendInputSignature(input));
       const _logSendSuccess = (method, targetAgent) => {
         return { success: true, sent: true, method, targetAgent };
       };
@@ -36603,11 +36837,26 @@ ${effect.notification.body || ""}`.trim();
         _log(`Suppressed duplicate send for ${dedupeKey}`);
         return { success: true, sent: false, deduplicated: true };
       }
-      if (isCliLikeTransport(transport)) {
+      if (transport === "acp") {
+        const target = getTargetInstance(h, args);
+        if (!target || target.category !== "acp") {
+          return { success: false, error: `ACP instance not found for ${provider?.type || args?.agentType || "unknown"}` };
+        }
+        try {
+          assertProviderSupportsDeclaredInput(provider, input);
+          target.onEvent("send_message", { input });
+          return _logSendSuccess("acp-instance", target.type);
+        } catch (e) {
+          return { success: false, error: `acp send failed: ${e.message}` };
+        }
+      }
+      if (transport === "pty") {
         const adapter = getTargetedCliAdapter(h, args, provider?.type);
         if (adapter) {
           _log(`${transport} adapter: ${adapter.cliType}`);
           try {
+            assertTextOnlyInput(provider, input);
+            if (!text) return { success: false, error: "text required for PTY send" };
             await adapter.sendMessage(text);
             return _logSendSuccess(`${transport}-adapter`, adapter.cliType);
           } catch (e) {
@@ -36615,6 +36864,8 @@ ${effect.notification.body || ""}`.trim();
           }
         }
       }
+      assertTextOnlyInput(provider, input);
+      if (!text) return { success: false, error: "text required" };
       if (isExtensionTransport(transport)) {
         _log(`Extension: ${provider?.type || "unknown_extension"}`);
         try {
@@ -37769,14 +38020,14 @@ ${effect.notification.body || ""}`.trim();
     }
     function buildControlScriptResult(scriptName, payload) {
       if (!payload || typeof payload !== "object") return {};
-      if (Array.isArray(payload.options) || Array.isArray(payload.models) || Array.isArray(payload.modes)) {
+      if (Array.isArray(payload.options)) {
         return { controlResult: normalizeControlListResult(payload) };
       }
       const looksLikeValueMutation = /^set|^change/i.test(scriptName) || payload.currentValue !== void 0 || payload.value !== void 0;
       if (looksLikeValueMutation) {
         return { controlResult: normalizeControlSetResult(payload) };
       }
-      if (payload.ok !== void 0 || payload.success !== void 0 || Array.isArray(payload.effects)) {
+      if (payload.ok !== void 0 || Array.isArray(payload.effects) || typeof payload.error === "string") {
         return { controlResult: normalizeControlInvokeResult(payload) };
       }
       return {};
@@ -38573,7 +38824,7 @@ ${effect.notification.body || ""}`.trim();
       }
     };
     var os12 = __toESM2(require("os"));
-    var path13 = __toESM2(require("path"));
+    var path12 = __toESM2(require("path"));
     var crypto4 = __toESM2(require("crypto"));
     var import_chalk = __toESM2(require("chalk"));
     init_provider_cli_adapter();
@@ -38583,6 +38834,7 @@ ${effect.notification.body || ""}`.trim();
     var crypto3 = __toESM2(require("crypto"));
     var fs5 = __toESM2(require("fs"));
     var import_node_module = require("module");
+    init_contracts();
     init_provider_cli_adapter();
     init_logger();
     init_chat_message_normalization();
@@ -38881,6 +39133,7 @@ ${effect.notification.body || ""}`.trim();
       onEvent(event, data) {
         if (event === "send_message") {
           const input = normalizeInputEnvelope(data);
+          assertTextOnlyInput(this.provider, input);
           if (input.textFallback) {
             void this.adapter.sendMessage(input.textFallback).catch((e) => {
               LOG2.warn("CLI", `[${this.type}] send_message failed: ${e?.message || e}`);
@@ -39316,10 +39569,10 @@ ${effect.notification.body || ""}`.trim();
         }
       }
     };
-    var path12 = __toESM2(require("path"));
     var import_stream = require("stream");
     var import_child_process5 = require("child_process");
     var import_sdk = (init_acp(), __toCommonJS(acp_exports));
+    init_contracts();
     init_chat_message_normalization();
     init_logger();
     function getPromptCapabilityFlags(agentCapabilities) {
@@ -39330,25 +39583,6 @@ ${effect.notification.body || ""}`.trim();
         embeddedContext: prompt.embeddedContext === true
       };
     }
-    function getResourceNameFromUri(uri, fallback) {
-      try {
-        if (uri.startsWith("file://")) {
-          return path12.basename(new URL(uri).pathname) || fallback;
-        }
-        return path12.basename(uri) || fallback;
-      } catch {
-        return fallback;
-      }
-    }
-    function inputPartToResourceLink(part, fallbackName) {
-      if (!part.uri) return null;
-      return {
-        type: "resource_link",
-        uri: part.uri,
-        name: getResourceNameFromUri(part.uri, fallbackName),
-        ...part.mimeType ? { mimeType: part.mimeType } : {}
-      };
-    }
     function appendPromptText(promptParts, text) {
       const normalized = typeof text === "string" ? text.trim() : "";
       if (!normalized) return;
@@ -39365,55 +39599,60 @@ ${effect.notification.body || ""}`.trim();
           continue;
         }
         if (part.type === "image") {
-          if (caps.image && part.data) {
-            promptParts.push({
-              type: "image",
-              data: part.data,
-              mimeType: part.mimeType,
-              ...part.uri ? { uri: part.uri } : {}
-            });
-            continue;
+          if (!caps.image) {
+            throw new Error("ACP agent does not support input type: image");
+          }
+          if (!part.data) {
+            throw new Error("ACP image input requires inline image data");
           }
-          const fallback = inputPartToResourceLink(part, "image");
-          if (fallback) promptParts.push(fallback);
-          appendPromptText(promptParts, part.alt || (!part.uri ? `Attached image (${part.mimeType})` : void 0));
+          promptParts.push({
+            type: "image",
+            data: part.data,
+            mimeType: part.mimeType,
+            ...part.uri ? { uri: part.uri } : {}
+          });
           continue;
         }
         if (part.type === "audio") {
-          if (caps.audio && part.data) {
-            promptParts.push({
-              type: "audio",
-              data: part.data,
-              mimeType: part.mimeType
-            });
-            continue;
+          if (!caps.audio) {
+            throw new Error("ACP agent does not support input type: audio");
+          }
+          if (!part.data) {
+            throw new Error("ACP audio input requires inline audio data");
           }
-          const fallback = inputPartToResourceLink(part, "audio");
-          if (fallback) promptParts.push(fallback);
-          appendPromptText(promptParts, part.transcript || (!part.uri ? `Attached audio (${part.mimeType})` : void 0));
+          promptParts.push({
+            type: "audio",
+            data: part.data,
+            mimeType: part.mimeType
+          });
           continue;
         }
         if (part.type === "resource") {
-          if (caps.embeddedContext && (part.text || part.data)) {
+          if (!caps.embeddedContext) {
+            throw new Error("ACP agent does not support input type: resource");
+          }
+          if (part.text) {
             promptParts.push({
               type: "resource",
-              resource: part.text ? { uri: part.uri, text: part.text, mimeType: part.mimeType ?? null } : { uri: part.uri, blob: part.data || "", mimeType: part.mimeType ?? null }
+              resource: { uri: part.uri, text: part.text, mimeType: part.mimeType ?? null }
             });
             continue;
           }
-          const fallback = inputPartToResourceLink(part, part.name || "resource");
-          if (fallback) promptParts.push(fallback);
-          appendPromptText(promptParts, part.text || (!part.uri && part.name ? part.name : void 0));
-          continue;
+          if (part.data) {
+            promptParts.push({
+              type: "resource",
+              resource: { uri: part.uri, blob: part.data, mimeType: part.mimeType ?? null }
+            });
+            continue;
+          }
+          throw new Error("ACP resource input requires embedded text or binary data");
         }
         if (part.type === "video") {
-          const fallback = inputPartToResourceLink(part, "video");
-          if (fallback) promptParts.push(fallback);
-          appendPromptText(promptParts, !part.uri ? `Attached video (${part.mimeType})` : void 0);
+          throw new Error("ACP agent does not support input type: video");
         }
       }
       if (!promptParts.some((part) => part.type === "text") && input.textFallback) {
-        promptParts.unshift({ type: "text", text: input.textFallback });
+        appendPromptText(promptParts, input.textFallback);
       }
       return promptParts;
     }
@@ -39544,6 +39783,7 @@ ${effect.notification.body || ""}`.trim();
       onEvent(event, data) {
         if (event === "send_message") {
           const input = normalizeInputEnvelope(data);
+          assertProviderSupportsDeclaredInput(this.provider, input);
           const promptParts = buildAcpPromptParts(input, this.agentCapabilities);
           this.sendPrompt(input.textFallback, promptParts.length > 0 ? promptParts : void 0).catch(
             (e) => this.log.warn(`[${this.type}] sendPrompt error: ${e?.message}`)
@@ -40475,6 +40715,7 @@ ${rawInput}` : rawInput;
         return this.agentCapabilities;
       }
     };
+    init_contracts();
     init_logger();
     function shouldRestoreHostedRuntime(record2, managerTag) {
       if (!managerTag) return true;
@@ -40737,7 +40978,7 @@ ${rawInput}` : rawInput;
       async startSession(cliType, workingDir, cliArgs, initialModel, options) {
         const trimmed = (workingDir || "").trim();
         if (!trimmed) throw new Error("working directory required");
-        const resolvedDir = trimmed.startsWith("~") ? trimmed.replace(/^~/, os12.homedir()) : path13.resolve(trimmed);
+        const resolvedDir = trimmed.startsWith("~") ? trimmed.replace(/^~/, os12.homedir()) : path12.resolve(trimmed);
         const normalizedType = this.providerLoader.resolveAlias(cliType);
         const provider = this.providerLoader.getByAlias(cliType);
         const key = crypto4.randomUUID();
@@ -41196,6 +41437,12 @@ Run 'adhdev doctor' for detailed diagnostics.`
             const { adapter, key } = found;
             if (action === "send_chat") {
               const input = normalizeInputEnvelope(args?.input ? { input: args.input } : args);
+              const provider = this.providerLoader.resolve(agentType) || this.providerLoader.getMeta(agentType);
+              if (provider?.category === "acp") {
+                assertProviderSupportsDeclaredInput(provider, input);
+              } else {
+                assertTextOnlyInput(provider, input);
+              }
               const message = input.textFallback;
               if (!message) throw new Error("message required for send_chat");
               await adapter.sendMessage(message);
@@ -41216,12 +41463,13 @@ Run 'adhdev doctor' for detailed diagnostics.`
     var import_child_process6 = require("child_process");
     var net3 = __toESM2(require("net"));
     var os14 = __toESM2(require("os"));
-    var path15 = __toESM2(require("path"));
-    var fs6 = __toESM2(require("fs"));
     var path14 = __toESM2(require("path"));
+    var fs6 = __toESM2(require("fs"));
+    var path13 = __toESM2(require("path"));
     var os13 = __toESM2(require("os"));
     var chokidar = __toESM2((init_chokidar(), __toCommonJS(chokidar_exports)));
     init_logger();
+    var VALID_CAPABILITY_MEDIA_TYPES = /* @__PURE__ */ new Set(["text", "image", "audio", "video", "resource"]);
     var KNOWN_PROVIDER_FIELDS = /* @__PURE__ */ new Set([
       "type",
       "name",
@@ -41272,6 +41520,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       "sendDelayMs",
       "sendKey",
       "submitStrategy",
+      "timeouts",
       "disableUpstream"
     ]);
     var VALUE_CONTROL_TYPES = /* @__PURE__ */ new Set(["select", "toggle", "cycle", "slider"]);
@@ -41298,6 +41547,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
         warnings.push("disableUpstream is deprecated in provider definitions; use machine-level provider source policy instead");
       }
       const category = provider.category;
+      const controls = Array.isArray(provider.controls) ? provider.controls : [];
       if (category === "cli" || category === "acp") {
         const spawn4 = provider.spawn;
         const command = spawn4 && typeof spawn4 === "object" ? spawn4.command : void 0;
@@ -41315,11 +41565,61 @@ Run 'adhdev doctor' for detailed diagnostics.`
       if (category === "extension" && !provider.extensionId) {
         warnings.push("Extension providers should have extensionId");
       }
-      for (const control of Array.isArray(provider.controls) ? provider.controls : []) {
+      validateCapabilities(provider, controls, errors);
+      for (const control of controls) {
         validateControl(control, errors);
       }
       return { errors, warnings };
     }
+    function validateCapabilities(provider, controls, errors) {
+      const capabilities = provider.capabilities;
+      if (provider.contractVersion === 2) {
+        if (!capabilities || typeof capabilities !== "object") {
+          errors.push("contractVersion 2 providers must declare capabilities");
+          return;
+        }
+      }
+      if (!capabilities || typeof capabilities !== "object") {
+        return;
+      }
+      const input = capabilities.input;
+      if (!input || typeof input !== "object") {
+        errors.push("capabilities.input is required");
+      } else {
+        if (typeof input.multipart !== "boolean") {
+          errors.push("capabilities.input.multipart must be boolean");
+        }
+        if (!Array.isArray(input.mediaTypes) || input.mediaTypes.length === 0) {
+          errors.push("capabilities.input.mediaTypes must be a non-empty array");
+        } else if (input.mediaTypes.some((type) => typeof type !== "string" || !VALID_CAPABILITY_MEDIA_TYPES.has(type))) {
+          errors.push(`capabilities.input.mediaTypes must only include: ${Array.from(VALID_CAPABILITY_MEDIA_TYPES).join(", ")}`);
+        }
+      }
+      const output = capabilities.output;
+      if (!output || typeof output !== "object") {
+        errors.push("capabilities.output is required");
+      } else {
+        if (typeof output.richContent !== "boolean") {
+          errors.push("capabilities.output.richContent must be boolean");
+        }
+        if (!Array.isArray(output.mediaTypes) || output.mediaTypes.length === 0) {
+          errors.push("capabilities.output.mediaTypes must be a non-empty array");
+        } else if (output.mediaTypes.some((type) => typeof type !== "string" || !VALID_CAPABILITY_MEDIA_TYPES.has(type))) {
+          errors.push(`capabilities.output.mediaTypes must only include: ${Array.from(VALID_CAPABILITY_MEDIA_TYPES).join(", ")}`);
+        }
+      }
+      const controlCapabilities = capabilities.controls;
+      if (!controlCapabilities || typeof controlCapabilities !== "object") {
+        errors.push("capabilities.controls is required");
+        return;
+      }
+      if (typeof controlCapabilities.typedResults !== "boolean") {
+        errors.push("capabilities.controls.typedResults must be boolean");
+      }
+      if (controls.length > 0 && controlCapabilities.typedResults !== true) {
+        errors.push("providers declaring controls must set capabilities.controls.typedResults=true");
+      }
+    }
     function validateControl(control, errors) {
       if (!control || typeof control !== "object") {
         errors.push("controls: each control must be an object");
@@ -41372,9 +41672,9 @@ Run 'adhdev doctor' for detailed diagnostics.`
       static META_FILE = ".meta.json";
       constructor(options) {
         this.logFn = options?.logFn || LOG2.forComponent("Provider").asLogFn();
-        this.defaultProvidersDir = path14.join(os13.homedir(), ".adhdev", "providers");
+        this.defaultProvidersDir = path13.join(os13.homedir(), ".adhdev", "providers");
         this.userDir = this.defaultProvidersDir;
-        this.upstreamDir = path14.join(this.defaultProvidersDir, ".upstream");
+        this.upstreamDir = path13.join(this.defaultProvidersDir, ".upstream");
         this.disableUpstream = false;
         this.applySourceConfig({
           userDir: options?.userDir,
@@ -41422,7 +41722,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
         }
         this.sourceMode = nextSourceMode;
         this.userDir = this.explicitProviderDir || this.defaultProvidersDir;
-        this.upstreamDir = path14.join(this.defaultProvidersDir, ".upstream");
+        this.upstreamDir = path13.join(this.defaultProvidersDir, ".upstream");
         this.disableUpstream = this.sourceMode === "no-upstream";
         if (this.explicitProviderDir) {
           this.log(`Config 'providerDir' applied: ${this.userDir}`);
@@ -41436,7 +41736,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       * Canonical provider directory shape for a given root.
       */
       getProviderDir(root, category, type) {
-        return path14.join(root, category, type);
+        return path13.join(root, category, type);
       }
       /**
       * Canonical user override directory for a provider.
@@ -41463,7 +41763,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       resolveProviderFile(type, ...segments) {
         const dir = this.findProviderDirInternal(type);
         if (!dir) return null;
-        return path14.join(dir, ...segments);
+        return path13.join(dir, ...segments);
       }
       /**
       * Load all providers (3-tier priority)
@@ -41502,7 +41802,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
         if (!fs6.existsSync(this.upstreamDir)) return false;
         try {
           return fs6.readdirSync(this.upstreamDir).some(
-            (d) => fs6.statSync(path14.join(this.upstreamDir, d)).isDirectory()
+            (d) => fs6.statSync(path13.join(this.upstreamDir, d)).isDirectory()
           );
         } catch {
           return false;
@@ -41817,8 +42117,8 @@ Run 'adhdev doctor' for detailed diagnostics.`
                   resolved._resolvedScriptDir = entry.scriptDir;
                   resolved._resolvedScriptsSource = `compatibility:${entry.ideVersion}`;
                   if (providerDir) {
-                    const fullDir = path14.join(providerDir, entry.scriptDir);
-                    resolved._resolvedScriptsPath = fs6.existsSync(path14.join(fullDir, "scripts.js")) ? path14.join(fullDir, "scripts.js") : fullDir;
+                    const fullDir = path13.join(providerDir, entry.scriptDir);
+                    resolved._resolvedScriptsPath = fs6.existsSync(path13.join(fullDir, "scripts.js")) ? path13.join(fullDir, "scripts.js") : fullDir;
                   }
                   matched = true;
                 }
@@ -41833,8 +42133,8 @@ Run 'adhdev doctor' for detailed diagnostics.`
                 resolved._resolvedScriptDir = base.defaultScriptDir;
                 resolved._resolvedScriptsSource = "defaultScriptDir:version_miss";
                 if (providerDir) {
-                  const fullDir = path14.join(providerDir, base.defaultScriptDir);
-                  resolved._resolvedScriptsPath = fs6.existsSync(path14.join(fullDir, "scripts.js")) ? path14.join(fullDir, "scripts.js") : fullDir;
+                  const fullDir = path13.join(providerDir, base.defaultScriptDir);
+                  resolved._resolvedScriptsPath = fs6.existsSync(path13.join(fullDir, "scripts.js")) ? path13.join(fullDir, "scripts.js") : fullDir;
                 }
               }
               resolved._versionWarning = `Version ${currentVersion} not in compatibility matrix. Using default scripts.`;
@@ -41851,8 +42151,8 @@ Run 'adhdev doctor' for detailed diagnostics.`
                   resolved._resolvedScriptDir = dirOverride;
                   resolved._resolvedScriptsSource = `versions:${range}`;
                   if (providerDir) {
-                    const fullDir = path14.join(providerDir, dirOverride);
-                    resolved._resolvedScriptsPath = fs6.existsSync(path14.join(fullDir, "scripts.js")) ? path14.join(fullDir, "scripts.js") : fullDir;
+                    const fullDir = path13.join(providerDir, dirOverride);
+                    resolved._resolvedScriptsPath = fs6.existsSync(path13.join(fullDir, "scripts.js")) ? path13.join(fullDir, "scripts.js") : fullDir;
                   }
                 }
               } else if (override.scripts) {
@@ -41868,8 +42168,8 @@ Run 'adhdev doctor' for detailed diagnostics.`
             resolved._resolvedScriptDir = base.defaultScriptDir;
             resolved._resolvedScriptsSource = "defaultScriptDir:no_version";
             if (providerDir) {
-              const fullDir = path14.join(providerDir, base.defaultScriptDir);
-              resolved._resolvedScriptsPath = fs6.existsSync(path14.join(fullDir, "scripts.js")) ? path14.join(fullDir, "scripts.js") : fullDir;
+              const fullDir = path13.join(providerDir, base.defaultScriptDir);
+              resolved._resolvedScriptsPath = fs6.existsSync(path13.join(fullDir, "scripts.js")) ? path13.join(fullDir, "scripts.js") : fullDir;
             }
           }
         }
@@ -41894,14 +42194,14 @@ Run 'adhdev doctor' for detailed diagnostics.`
           this.log(`  [loadScriptsFromDir] ${type}: providerDir not found`);
           return null;
         }
-        const dir = path14.join(providerDir, scriptDir);
+        const dir = path13.join(providerDir, scriptDir);
         if (!fs6.existsSync(dir)) {
           this.log(`  [loadScriptsFromDir] ${type}: dir not found: ${dir}`);
           return null;
         }
         const cached2 = this.scriptsCache.get(dir);
         if (cached2) return cached2;
-        const scriptsJs = path14.join(dir, "scripts.js");
+        const scriptsJs = path13.join(dir, "scripts.js");
         if (fs6.existsSync(scriptsJs)) {
           try {
             delete require.cache[require.resolve(scriptsJs)];
@@ -41943,7 +42243,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
                 return;
               }
               if (filePath.endsWith(".js") || filePath.endsWith(".json")) {
-                this.log(`File changed: ${path14.basename(filePath)}, reloading...`);
+                this.log(`File changed: ${path13.basename(filePath)}, reloading...`);
                 this.reload();
               }
             };
@@ -41998,7 +42298,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
         }
         const https = require("https");
         const { execSync: execSync7 } = require("child_process");
-        const metaPath = path14.join(this.upstreamDir, _ProviderLoader.META_FILE);
+        const metaPath = path13.join(this.upstreamDir, _ProviderLoader.META_FILE);
         let prevEtag = "";
         let prevTimestamp = 0;
         try {
@@ -42058,17 +42358,17 @@ Run 'adhdev doctor' for detailed diagnostics.`
             return { updated: false };
           }
           this.log("Downloading latest providers from GitHub...");
-          const tmpTar = path14.join(os13.tmpdir(), `adhdev-providers-${Date.now()}.tar.gz`);
-          const tmpExtract = path14.join(os13.tmpdir(), `adhdev-providers-extract-${Date.now()}`);
+          const tmpTar = path13.join(os13.tmpdir(), `adhdev-providers-${Date.now()}.tar.gz`);
+          const tmpExtract = path13.join(os13.tmpdir(), `adhdev-providers-extract-${Date.now()}`);
           await this.downloadFile(_ProviderLoader.GITHUB_TARBALL_URL, tmpTar);
           fs6.mkdirSync(tmpExtract, { recursive: true });
           execSync7(`tar -xzf "${tmpTar}" -C "${tmpExtract}"`, { timeout: 3e4 });
           const extracted = fs6.readdirSync(tmpExtract);
           const rootDir = extracted.find(
-            (d) => fs6.statSync(path14.join(tmpExtract, d)).isDirectory() && d.startsWith("adhdev-providers")
+            (d) => fs6.statSync(path13.join(tmpExtract, d)).isDirectory() && d.startsWith("adhdev-providers")
           );
           if (!rootDir) throw new Error("Unexpected tarball structure");
-          const sourceDir = path14.join(tmpExtract, rootDir);
+          const sourceDir = path13.join(tmpExtract, rootDir);
           const backupDir = this.upstreamDir + ".bak";
           if (fs6.existsSync(this.upstreamDir)) {
             if (fs6.existsSync(backupDir)) fs6.rmSync(backupDir, { recursive: true, force: true });
@@ -42143,8 +42443,8 @@ Run 'adhdev doctor' for detailed diagnostics.`
       copyDirRecursive(src, dest) {
         fs6.mkdirSync(dest, { recursive: true });
         for (const entry of fs6.readdirSync(src, { withFileTypes: true })) {
-          const srcPath = path14.join(src, entry.name);
-          const destPath = path14.join(dest, entry.name);
+          const srcPath = path13.join(src, entry.name);
+          const destPath = path13.join(dest, entry.name);
           if (entry.isDirectory()) {
             this.copyDirRecursive(srcPath, destPath);
           } else {
@@ -42155,7 +42455,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       /** .meta.json save */
       writeMeta(metaPath, etag, timestamp) {
         try {
-          fs6.mkdirSync(path14.dirname(metaPath), { recursive: true });
+          fs6.mkdirSync(path13.dirname(metaPath), { recursive: true });
           fs6.writeFileSync(metaPath, JSON.stringify({
             etag,
             timestamp,
@@ -42172,7 +42472,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
         const scan = (d) => {
           try {
             for (const entry of fs6.readdirSync(d, { withFileTypes: true })) {
-              if (entry.isDirectory()) scan(path14.join(d, entry.name));
+              if (entry.isDirectory()) scan(path13.join(d, entry.name));
               else if (entry.name === "provider.json") count++;
             }
           } catch {
@@ -42357,17 +42657,17 @@ Run 'adhdev doctor' for detailed diagnostics.`
         for (const root of searchRoots) {
           if (!fs6.existsSync(root)) continue;
           const candidate = this.getProviderDir(root, cat, type);
-          if (fs6.existsSync(path14.join(candidate, "provider.json"))) return candidate;
-          const catDir = path14.join(root, cat);
+          if (fs6.existsSync(path13.join(candidate, "provider.json"))) return candidate;
+          const catDir = path13.join(root, cat);
           if (fs6.existsSync(catDir)) {
             try {
               for (const entry of fs6.readdirSync(catDir, { withFileTypes: true })) {
                 if (!entry.isDirectory()) continue;
-                const jsonPath = path14.join(catDir, entry.name, "provider.json");
+                const jsonPath = path13.join(catDir, entry.name, "provider.json");
                 if (fs6.existsSync(jsonPath)) {
                   try {
                     const data = JSON.parse(fs6.readFileSync(jsonPath, "utf-8"));
-                    if (data.type === type) return path14.join(catDir, entry.name);
+                    if (data.type === type) return path13.join(catDir, entry.name);
                   } catch {
                   }
                 }
@@ -42384,7 +42684,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
        * (template substitution is NOT applied here — scripts.js handles that)
        */
       buildScriptWrappersFromDir(dir) {
-        const scriptsJs = path14.join(dir, "scripts.js");
+        const scriptsJs = path13.join(dir, "scripts.js");
         if (fs6.existsSync(scriptsJs)) {
           try {
             delete require.cache[require.resolve(scriptsJs)];
@@ -42398,7 +42698,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
           for (const file2 of fs6.readdirSync(dir)) {
             if (!file2.endsWith(".js")) continue;
             const scriptName = toCamel(file2.replace(".js", ""));
-            const filePath = path14.join(dir, file2);
+            const filePath = path13.join(dir, file2);
             result[scriptName] = (...args) => {
               try {
                 let content = fs6.readFileSync(filePath, "utf-8");
@@ -42458,7 +42758,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
           }
           const hasJson = entries.some((e) => e.name === "provider.json");
           if (hasJson) {
-            const jsonPath = path14.join(d, "provider.json");
+            const jsonPath = path13.join(d, "provider.json");
             try {
               const raw = fs6.readFileSync(jsonPath, "utf-8");
               const mod = JSON.parse(raw);
@@ -42479,7 +42779,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
                 this.log(`\u26A0 Invalid provider at ${jsonPath}: ${validation.errors.join("; ")}`);
               } else {
                 const hasCompatibility = Array.isArray(normalizedProvider.compatibility);
-                const scriptsPath = path14.join(d, "scripts.js");
+                const scriptsPath = path13.join(d, "scripts.js");
                 if (!hasCompatibility && fs6.existsSync(scriptsPath)) {
                   try {
                     delete require.cache[require.resolve(scriptsPath)];
@@ -42505,7 +42805,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
               if (!entry.isDirectory()) continue;
               if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
               if (excludeDirs && d === dir && excludeDirs.includes(entry.name)) continue;
-              scan(path14.join(d, entry.name));
+              scan(path13.join(d, entry.name));
             }
           }
         };
@@ -42761,8 +43061,8 @@ Run 'adhdev doctor' for detailed diagnostics.`
           const appNameMap = getMacAppIdentifiers();
           const appName = appNameMap[ideId];
           if (appName) {
-            const storagePath = path15.join(
-              process.env.APPDATA || path15.join(os14.homedir(), "AppData", "Roaming"),
+            const storagePath = path14.join(
+              process.env.APPDATA || path14.join(os14.homedir(), "AppData", "Roaming"),
               appName,
               "storage.json"
             );
@@ -42936,9 +43236,9 @@ Run 'adhdev doctor' for detailed diagnostics.`
     init_config();
     init_logger();
     var fs7 = __toESM2(require("fs"));
-    var path16 = __toESM2(require("path"));
+    var path15 = __toESM2(require("path"));
     var os15 = __toESM2(require("os"));
-    var LOG_DIR2 = process.platform === "win32" ? path16.join(process.env.LOCALAPPDATA || process.env.APPDATA || path16.join(os15.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path16.join(os15.homedir(), "Library", "Logs", "adhdev") : path16.join(os15.homedir(), ".local", "share", "adhdev", "logs");
+    var LOG_DIR2 = process.platform === "win32" ? path15.join(process.env.LOCALAPPDATA || process.env.APPDATA || path15.join(os15.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path15.join(os15.homedir(), "Library", "Logs", "adhdev") : path15.join(os15.homedir(), ".local", "share", "adhdev", "logs");
     var MAX_FILE_SIZE = 5 * 1024 * 1024;
     var MAX_DAYS = 7;
     try {
@@ -42976,13 +43276,13 @@ Run 'adhdev doctor' for detailed diagnostics.`
       return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
     }
     var currentDate2 = getDateStr2();
-    var currentFile = path16.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
+    var currentFile = path15.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
     var writeCount2 = 0;
     function checkRotation() {
       const today = getDateStr2();
       if (today !== currentDate2) {
         currentDate2 = today;
-        currentFile = path16.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
+        currentFile = path15.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
         cleanOldFiles();
       }
     }
@@ -42996,7 +43296,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
           const dateMatch = file2.match(/commands-(\d{4}-\d{2}-\d{2})/);
           if (dateMatch && dateMatch[1] < cutoffStr) {
             try {
-              fs7.unlinkSync(path16.join(LOG_DIR2, file2));
+              fs7.unlinkSync(path15.join(LOG_DIR2, file2));
             } catch {
             }
           }
@@ -43401,13 +43701,13 @@ Run 'adhdev doctor' for detailed diagnostics.`
     var import_child_process8 = require("child_process");
     var fs8 = __toESM2(require("fs"));
     var os17 = __toESM2(require("os"));
-    var path17 = __toESM2(require("path"));
+    var path16 = __toESM2(require("path"));
     var UPGRADE_HELPER_ENV = "ADHDEV_DAEMON_UPGRADE_HELPER";
     function getUpgradeLogPath() {
       const home = os17.homedir();
-      const dir = path17.join(home, ".adhdev");
+      const dir = path16.join(home, ".adhdev");
       fs8.mkdirSync(dir, { recursive: true });
-      return path17.join(dir, "daemon-upgrade.log");
+      return path16.join(dir, "daemon-upgrade.log");
     }
     function appendUpgradeLog(message) {
       const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] ${message}
@@ -43447,7 +43747,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       }
     }
     function stopSessionHostProcesses(appName) {
-      const pidFile = path17.join(os17.homedir(), ".adhdev", `${appName}-session-host.pid`);
+      const pidFile = path16.join(os17.homedir(), ".adhdev", `${appName}-session-host.pid`);
       try {
         if (fs8.existsSync(pidFile)) {
           const pid = Number.parseInt(fs8.readFileSync(pidFile, "utf8").trim(), 10);
@@ -43476,7 +43776,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       }
     }
     function removeDaemonPidFile() {
-      const pidFile = path17.join(os17.homedir(), ".adhdev", "daemon.pid");
+      const pidFile = path16.join(os17.homedir(), ".adhdev", "daemon.pid");
       try {
         fs8.unlinkSync(pidFile);
       } catch {
@@ -43487,7 +43787,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       const npmRoot = (0, import_child_process7.execFileSync)(getNpmExecutable(), ["root", "-g"], { encoding: "utf8", ...npmExecOpts }).trim();
       if (!npmRoot) return;
       const npmPrefix = (0, import_child_process7.execFileSync)(getNpmExecutable(), ["prefix", "-g"], { encoding: "utf8", ...npmExecOpts }).trim();
-      const binDir = process.platform === "win32" ? npmPrefix : path17.join(npmPrefix, "bin");
+      const binDir = process.platform === "win32" ? npmPrefix : path16.join(npmPrefix, "bin");
       const packageBaseName = pkgName.startsWith("@") ? pkgName.split("/")[1] : pkgName;
       const binNames = /* @__PURE__ */ new Set([packageBaseName]);
       if (pkgName === "@adhdev/daemon-standalone") {
@@ -43495,25 +43795,25 @@ Run 'adhdev doctor' for detailed diagnostics.`
       }
       if (pkgName.startsWith("@")) {
         const [scope, name] = pkgName.split("/");
-        const scopeDir = path17.join(npmRoot, scope);
+        const scopeDir = path16.join(npmRoot, scope);
         if (!fs8.existsSync(scopeDir)) return;
         for (const entry of fs8.readdirSync(scopeDir)) {
           if (!entry.startsWith(`.${name}-`)) continue;
-          fs8.rmSync(path17.join(scopeDir, entry), { recursive: true, force: true });
-          appendUpgradeLog(`Removed stale scoped staging dir: ${path17.join(scopeDir, entry)}`);
+          fs8.rmSync(path16.join(scopeDir, entry), { recursive: true, force: true });
+          appendUpgradeLog(`Removed stale scoped staging dir: ${path16.join(scopeDir, entry)}`);
         }
       } else {
         for (const entry of fs8.readdirSync(npmRoot)) {
           if (!entry.startsWith(`.${pkgName}-`)) continue;
-          fs8.rmSync(path17.join(npmRoot, entry), { recursive: true, force: true });
-          appendUpgradeLog(`Removed stale staging dir: ${path17.join(npmRoot, entry)}`);
+          fs8.rmSync(path16.join(npmRoot, entry), { recursive: true, force: true });
+          appendUpgradeLog(`Removed stale staging dir: ${path16.join(npmRoot, entry)}`);
         }
       }
       if (fs8.existsSync(binDir)) {
         for (const entry of fs8.readdirSync(binDir)) {
           if (![...binNames].some((name) => entry.startsWith(`.${name}-`))) continue;
-          fs8.rmSync(path17.join(binDir, entry), { recursive: true, force: true });
-          appendUpgradeLog(`Removed stale bin staging entry: ${path17.join(binDir, entry)}`);
+          fs8.rmSync(path16.join(binDir, entry), { recursive: true, force: true });
+          appendUpgradeLog(`Removed stale bin staging entry: ${path16.join(binDir, entry)}`);
         }
       }
     }
@@ -44533,6 +44833,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
     init_logger();
     var DEFAULT_DAEMON_PORT = 19222;
     var DAEMON_WS_PATH = "/ipc";
+    init_read_chat_contract();
     init_chat_message_normalization();
     var ProviderStreamAdapter = class {
       agentType;
@@ -44638,26 +44939,29 @@ Run 'adhdev doctor' for detailed diagnostics.`
             }
             return state2;
           }
+          const validated = validateReadChatResultPayload(data, `${this.agentType} readChat`);
+          const validatedStatus = validated.status;
+          const streamStatus = validatedStatus === "generating" || validatedStatus === "long_generating" ? "streaming" : validatedStatus;
           const state = {
             agentType: this.agentType,
             agentName: this.agentName,
             extensionId: this.extensionId,
-            status: data.status || "idle",
-            messages: normalizeChatMessages(Array.isArray(data.messages) ? data.messages : []),
-            inputContent: data.inputContent || "",
-            activeModal: data.activeModal
+            status: streamStatus,
+            messages: normalizeChatMessages(validated.messages),
+            inputContent: typeof validated.inputContent === "string" ? validated.inputContent : "",
+            ...validated.activeModal ? { activeModal: validated.activeModal } : {}
           };
-          if (typeof data.title === "string" && data.title.trim()) {
-            state.title = data.title.trim();
+          if (typeof validated.title === "string" && validated.title.trim()) {
+            state.title = validated.title.trim();
           }
-          const controlValues = extractProviderControlValues(this.provider.controls, data);
+          const controlValues = extractProviderControlValues(this.provider.controls, validated);
           const surface = resolveProviderStateSurface({
             controlValues,
-            summaryMetadata: data.summaryMetadata
+            summaryMetadata: validated.summaryMetadata
           });
           if (surface.controlValues) state.controlValues = surface.controlValues;
           if (surface.summaryMetadata) state.summaryMetadata = surface.summaryMetadata;
-          const effects = normalizeProviderEffects(data);
+          const effects = normalizeProviderEffects(validated);
           if (effects.length > 0) state.effects = effects;
           if (state.messages.length > 0) {
             this.lastSuccessState = state;
@@ -45486,13 +45790,14 @@ Run 'adhdev doctor' for detailed diagnostics.`
         this.eventListeners = [];
       }
     };
+    init_io_contracts();
     init_chat_message_normalization();
     var fs10 = __toESM2(require("fs"));
-    var path18 = __toESM2(require("path"));
+    var path17 = __toESM2(require("path"));
     var os18 = __toESM2(require("os"));
     var import_child_process9 = require("child_process");
     var import_os3 = require("os");
-    var ARCHIVE_PATH = path18.join(os18.homedir(), ".adhdev", "version-history.json");
+    var ARCHIVE_PATH = path17.join(os18.homedir(), ".adhdev", "version-history.json");
     var MAX_ENTRIES_PER_PROVIDER = 20;
     var VersionArchive = class {
       history = {};
@@ -45539,7 +45844,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       }
       save() {
         try {
-          fs10.mkdirSync(path18.dirname(ARCHIVE_PATH), { recursive: true });
+          fs10.mkdirSync(path17.dirname(ARCHIVE_PATH), { recursive: true });
           fs10.writeFileSync(ARCHIVE_PATH, JSON.stringify(this.history, null, 2));
         } catch {
         }
@@ -45596,7 +45901,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
       for (const p of paths) {
         if (p.includes("*")) {
           const home = os18.homedir();
-          const resolved = p.replace(/\*/g, home.split(path18.sep).pop() || "");
+          const resolved = p.replace(/\*/g, home.split(path17.sep).pop() || "");
           if (fs10.existsSync(resolved)) return resolved;
         } else {
           if (fs10.existsSync(p)) return p;
@@ -45606,7 +45911,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
     }
     function getMacAppVersion(appPath) {
       if ((0, import_os3.platform)() !== "darwin" || !appPath.endsWith(".app")) return null;
-      const plistPath = path18.join(appPath, "Contents", "Info.plist");
+      const plistPath = path17.join(appPath, "Contents", "Info.plist");
       if (!fs10.existsSync(plistPath)) return null;
       const raw = runCommand(`/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "${plistPath}"`);
       return raw || null;
@@ -45632,7 +45937,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
           const cliBin = provider.cli ? findBinary2(provider.cli) : null;
           let resolvedBin = cliBin;
           if (!resolvedBin && appPath && currentOs === "darwin") {
-            const bundled = path18.join(appPath, "Contents", "Resources", "app", "bin", provider.cli || "");
+            const bundled = path17.join(appPath, "Contents", "Resources", "app", "bin", provider.cli || "");
             if (provider.cli && fs10.existsSync(bundled)) resolvedBin = bundled;
           }
           info.installed = !!(appPath || resolvedBin);
@@ -45671,7 +45976,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
     }
     var http2 = __toESM2(require("http"));
     var fs14 = __toESM2(require("fs"));
-    var path222 = __toESM2(require("path"));
+    var path21 = __toESM2(require("path"));
     init_config();
     function generateFiles(type, name, category, opts = {}) {
       const { cdpPorts, cli, processName, installPath, binary, extensionId, version: version2 = "0.1" } = opts;
@@ -46009,7 +46314,7 @@ async (params) => {
     }
     init_logger();
     var fs11 = __toESM2(require("fs"));
-    var path19 = __toESM2(require("path"));
+    var path18 = __toESM2(require("path"));
     init_logger();
     async function handleCdpEvaluate(ctx, req, res) {
       const body = await ctx.readBody(req);
@@ -46188,17 +46493,17 @@ async (params) => {
         return;
       }
       let scriptsPath = "";
-      const directScripts = path19.join(dir, "scripts.js");
+      const directScripts = path18.join(dir, "scripts.js");
       if (fs11.existsSync(directScripts)) {
         scriptsPath = directScripts;
       } else {
-        const scriptsDir = path19.join(dir, "scripts");
+        const scriptsDir = path18.join(dir, "scripts");
         if (fs11.existsSync(scriptsDir)) {
           const versions = fs11.readdirSync(scriptsDir).filter((d) => {
-            return fs11.statSync(path19.join(scriptsDir, d)).isDirectory();
+            return fs11.statSync(path18.join(scriptsDir, d)).isDirectory();
           }).sort().reverse();
           for (const ver of versions) {
-            const p = path19.join(scriptsDir, ver, "scripts.js");
+            const p = path18.join(scriptsDir, ver, "scripts.js");
             if (fs11.existsSync(p)) {
               scriptsPath = p;
               break;
@@ -47025,7 +47330,7 @@ async (params) => {
       }
     }
     var fs12 = __toESM2(require("fs"));
-    var path20 = __toESM2(require("path"));
+    var path19 = __toESM2(require("path"));
     function slugifyFixtureName(value) {
       const normalized = String(value || "").trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
       return normalized || `fixture-${Date.now()}`;
@@ -47035,11 +47340,11 @@ async (params) => {
       if (!providerDir) {
         throw new Error(`Provider directory not found for '${type}'`);
       }
-      return path20.join(providerDir, "fixtures");
+      return path19.join(providerDir, "fixtures");
     }
     function readCliFixture(ctx, type, name) {
       const fixtureDir = getCliFixtureDir(ctx, type);
-      const filePath = path20.join(fixtureDir, `${name}.json`);
+      const filePath = path19.join(fixtureDir, `${name}.json`);
       if (!fs12.existsSync(filePath)) {
         throw new Error(`Fixture not found: ${filePath}`);
       }
@@ -47806,7 +48111,7 @@ async (params) => {
           },
           notes: typeof body?.notes === "string" ? body.notes : void 0
         };
-        const filePath = path20.join(fixtureDir, `${name}.json`);
+        const filePath = path19.join(fixtureDir, `${name}.json`);
         fs12.writeFileSync(filePath, JSON.stringify(fixture, null, 2));
         ctx.json(res, 200, {
           saved: true,
@@ -47830,7 +48135,7 @@ async (params) => {
           return;
         }
         const fixtures = fs12.readdirSync(fixtureDir).filter((file2) => file2.endsWith(".json")).sort((a, b2) => b2.localeCompare(a, void 0, { numeric: true, sensitivity: "base" })).map((file2) => {
-          const fullPath = path20.join(fixtureDir, file2);
+          const fullPath = path19.join(fixtureDir, file2);
           try {
             const raw = JSON.parse(fs12.readFileSync(fullPath, "utf-8"));
             return {
@@ -47964,7 +48269,7 @@ async (params) => {
       }
     }
     var fs13 = __toESM2(require("fs"));
-    var path21 = __toESM2(require("path"));
+    var path20 = __toESM2(require("path"));
     var os19 = __toESM2(require("os"));
     function getAutoImplPid(ctx) {
       const pid = ctx.autoImplProcess?.pid;
@@ -48021,22 +48326,22 @@ async (params) => {
       if (!fs13.existsSync(scriptsDir)) return null;
       const versions = fs13.readdirSync(scriptsDir).filter((d) => {
         try {
-          return fs13.statSync(path21.join(scriptsDir, d)).isDirectory();
+          return fs13.statSync(path20.join(scriptsDir, d)).isDirectory();
         } catch {
           return false;
         }
       }).sort((a, b2) => b2.localeCompare(a, void 0, { numeric: true, sensitivity: "base" }));
       if (versions.length === 0) return null;
-      return path21.join(scriptsDir, versions[0]);
+      return path20.join(scriptsDir, versions[0]);
     }
     function resolveAutoImplWritableProviderDir(ctx, category, type, requestedDir) {
-      const canonicalUserDir = path21.resolve(ctx.providerLoader.getUserProviderDir(category, type));
-      const desiredDir = requestedDir ? path21.resolve(requestedDir) : canonicalUserDir;
-      const upstreamRoot = path21.resolve(ctx.providerLoader.getUpstreamDir());
-      if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path21.sep}`)) {
+      const canonicalUserDir = path20.resolve(ctx.providerLoader.getUserProviderDir(category, type));
+      const desiredDir = requestedDir ? path20.resolve(requestedDir) : canonicalUserDir;
+      const upstreamRoot = path20.resolve(ctx.providerLoader.getUpstreamDir());
+      if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path20.sep}`)) {
         return { dir: null, reason: `Refusing to write into upstream provider directory: ${desiredDir}` };
       }
-      if (path21.basename(desiredDir) !== type) {
+      if (path20.basename(desiredDir) !== type) {
         return { dir: null, reason: `Requested writable provider directory must end with '${type}': ${desiredDir}` };
       }
       const sourceDir = ctx.findProviderDir(type);
@@ -48044,11 +48349,11 @@ async (params) => {
         return { dir: null, reason: `Provider source directory not found for '${type}'` };
       }
       if (!fs13.existsSync(desiredDir)) {
-        fs13.mkdirSync(path21.dirname(desiredDir), { recursive: true });
+        fs13.mkdirSync(path20.dirname(desiredDir), { recursive: true });
         fs13.cpSync(sourceDir, desiredDir, { recursive: true });
         ctx.log(`Auto-implement writable copy created: ${desiredDir}`);
       }
-      const providerJson = path21.join(desiredDir, "provider.json");
+      const providerJson = path20.join(desiredDir, "provider.json");
       if (!fs13.existsSync(providerJson)) {
         return { dir: null, reason: `provider.json not found in writable provider directory: ${desiredDir}` };
       }
@@ -48059,13 +48364,13 @@ async (params) => {
       const refDir = ctx.findProviderDir(referenceType);
       if (!refDir || !fs13.existsSync(refDir)) return {};
       const referenceScripts = {};
-      const scriptsDir = path21.join(refDir, "scripts");
+      const scriptsDir = path20.join(refDir, "scripts");
       const latestDir = getLatestScriptVersionDir(scriptsDir);
       if (!latestDir) return referenceScripts;
       for (const file2 of fs13.readdirSync(latestDir)) {
         if (!file2.endsWith(".js")) continue;
         try {
-          referenceScripts[file2] = fs13.readFileSync(path21.join(latestDir, file2), "utf-8");
+          referenceScripts[file2] = fs13.readFileSync(path20.join(latestDir, file2), "utf-8");
         } catch {
         }
       }
@@ -48173,9 +48478,9 @@ async (params) => {
         });
         const referenceScripts = loadAutoImplReferenceScripts(ctx, resolvedReference);
         const prompt = buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domContext, referenceScripts, comment, resolvedReference, verification);
-        const tmpDir = path21.join(os19.tmpdir(), "adhdev-autoimpl");
+        const tmpDir = path20.join(os19.tmpdir(), "adhdev-autoimpl");
         if (!fs13.existsSync(tmpDir)) fs13.mkdirSync(tmpDir, { recursive: true });
-        const promptFile = path21.join(tmpDir, `prompt-${type}-${Date.now()}.md`);
+        const promptFile = path20.join(tmpDir, `prompt-${type}-${Date.now()}.md`);
         fs13.writeFileSync(promptFile, prompt, "utf-8");
         ctx.log(`Auto-implement prompt written to ${promptFile} (${prompt.length} chars)`);
         const agentProvider = ctx.providerLoader.resolve(agent) || ctx.providerLoader.getMeta(agent);
@@ -48612,7 +48917,7 @@ async (params) => {
         setMode: "set_mode.js"
       };
       const targetFileNames = new Set(functions.map((fn2) => funcToFile[fn2]).filter(Boolean));
-      const scriptsDir = path21.join(providerDir, "scripts");
+      const scriptsDir = path20.join(providerDir, "scripts");
       const latestScriptsDir = getLatestScriptVersionDir(scriptsDir);
       if (latestScriptsDir) {
         lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -48623,7 +48928,7 @@ async (params) => {
         for (const file2 of fs13.readdirSync(latestScriptsDir)) {
           if (file2.endsWith(".js") && targetFileNames.has(file2)) {
             try {
-              const content = fs13.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
+              const content = fs13.readFileSync(path20.join(latestScriptsDir, file2), "utf-8");
               lines.push(`### \`${file2}\` \u270F\uFE0F EDIT`);
               lines.push("```javascript");
               lines.push(content);
@@ -48640,7 +48945,7 @@ async (params) => {
           lines.push("");
           for (const file2 of refFiles) {
             try {
-              const content = fs13.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
+              const content = fs13.readFileSync(path20.join(latestScriptsDir, file2), "utf-8");
               lines.push(`### \`${file2}\` \u{1F512}`);
               lines.push("```javascript");
               lines.push(content);
@@ -48681,10 +48986,10 @@ async (params) => {
           lines.push("");
         }
       }
-      const docsDir = path21.join(providerDir, "../../docs");
+      const docsDir = path20.join(providerDir, "../../docs");
       const loadGuide = (name) => {
         try {
-          const p = path21.join(docsDir, name);
+          const p = path20.join(docsDir, name);
           if (fs13.existsSync(p)) return fs13.readFileSync(p, "utf-8");
         } catch {
         }
@@ -48921,7 +49226,7 @@ async (params) => {
         parseApproval: "parse_approval.js"
       };
       const targetFileNames = new Set(functions.map((fn2) => funcToFile[fn2]).filter(Boolean));
-      const scriptsDir = path21.join(providerDir, "scripts");
+      const scriptsDir = path20.join(providerDir, "scripts");
       const latestScriptsDir = getLatestScriptVersionDir(scriptsDir);
       if (latestScriptsDir) {
         lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -48933,7 +49238,7 @@ async (params) => {
           if (!file2.endsWith(".js")) continue;
           if (!targetFileNames.has(file2)) continue;
           try {
-            const content = fs13.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
+            const content = fs13.readFileSync(path20.join(latestScriptsDir, file2), "utf-8");
             lines.push(`### \`${file2}\` \u270F\uFE0F EDIT`);
             lines.push("```javascript");
             lines.push(content);
@@ -48949,7 +49254,7 @@ async (params) => {
           lines.push("");
           for (const file2 of refFiles) {
             try {
-              const content = fs13.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
+              const content = fs13.readFileSync(path20.join(latestScriptsDir, file2), "utf-8");
               lines.push(`### \`${file2}\` \u{1F512}`);
               lines.push("```javascript");
               lines.push(content);
@@ -48982,10 +49287,10 @@ async (params) => {
           lines.push("");
         }
       }
-      const docsDir = path21.join(providerDir, "../../docs");
+      const docsDir = path20.join(providerDir, "../../docs");
       const loadGuide = (name) => {
         try {
-          const p = path21.join(docsDir, name);
+          const p = path20.join(docsDir, name);
           if (fs13.existsSync(p)) return fs13.readFileSync(p, "utf-8");
         } catch {
         }
@@ -49430,8 +49735,8 @@ data: ${JSON.stringify(msg.data)}
       }
       getEndpointList() {
         return this.routes.map((r) => {
-          const path23 = typeof r.pattern === "string" ? r.pattern : r.pattern.source.replace(/\\\//g, "/").replace(/\(\[.*?\]\+\)/g, ":type").replace(/[\^$]/g, "");
-          return `${r.method.padEnd(5)} ${path23}`;
+          const path222 = typeof r.pattern === "string" ? r.pattern : r.pattern.source.replace(/\\\//g, "/").replace(/\(\[.*?\]\+\)/g, ":type").replace(/[\^$]/g, "");
+          return `${r.method.padEnd(5)} ${path222}`;
         });
       }
       async start(port = DEV_SERVER_PORT) {
@@ -49712,12 +50017,12 @@ data: ${JSON.stringify(msg.data)}
       // ─── DevConsole SPA ───
       getConsoleDistDir() {
         const candidates = [
-          path222.resolve(__dirname, "../../web-devconsole/dist"),
-          path222.resolve(__dirname, "../../../web-devconsole/dist"),
-          path222.join(process.cwd(), "packages/web-devconsole/dist")
+          path21.resolve(__dirname, "../../web-devconsole/dist"),
+          path21.resolve(__dirname, "../../../web-devconsole/dist"),
+          path21.join(process.cwd(), "packages/web-devconsole/dist")
         ];
         for (const dir of candidates) {
-          if (fs14.existsSync(path222.join(dir, "index.html"))) return dir;
+          if (fs14.existsSync(path21.join(dir, "index.html"))) return dir;
         }
         return null;
       }
@@ -49727,7 +50032,7 @@ data: ${JSON.stringify(msg.data)}
           this.json(res, 500, { error: "DevConsole not found. Run: npm run build -w packages/web-devconsole" });
           return;
         }
-        const htmlPath = path222.join(distDir, "index.html");
+        const htmlPath = path21.join(distDir, "index.html");
         try {
           const html = fs14.readFileSync(htmlPath, "utf-8");
           res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
@@ -49752,15 +50057,15 @@ data: ${JSON.stringify(msg.data)}
           this.json(res, 404, { error: "Not found" });
           return;
         }
-        const safePath = path222.normalize(pathname).replace(/^\.\.\//, "");
-        const filePath = path222.join(distDir, safePath);
+        const safePath = path21.normalize(pathname).replace(/^\.\.\//, "");
+        const filePath = path21.join(distDir, safePath);
         if (!filePath.startsWith(distDir)) {
           this.json(res, 403, { error: "Forbidden" });
           return;
         }
         try {
           const content = fs14.readFileSync(filePath);
-          const ext = path222.extname(filePath);
+          const ext = path21.extname(filePath);
           const contentType = _DevServer.MIME_MAP[ext] || "application/octet-stream";
           res.writeHead(200, { "Content-Type": contentType, "Cache-Control": "public, max-age=31536000, immutable" });
           res.end(content);
@@ -49873,9 +50178,9 @@ data: ${JSON.stringify(msg.data)}
               const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
               if (entry.isDirectory()) {
                 files.push({ path: rel, size: 0, type: "dir" });
-                scan(path222.join(d, entry.name), rel);
+                scan(path21.join(d, entry.name), rel);
               } else {
-                const stat4 = fs14.statSync(path222.join(d, entry.name));
+                const stat4 = fs14.statSync(path21.join(d, entry.name));
                 files.push({ path: rel, size: stat4.size, type: "file" });
               }
             }
@@ -49898,7 +50203,7 @@ data: ${JSON.stringify(msg.data)}
           this.json(res, 404, { error: `Provider directory not found: ${type}` });
           return;
         }
-        const fullPath = path222.resolve(dir, path222.normalize(filePath));
+        const fullPath = path21.resolve(dir, path21.normalize(filePath));
         if (!fullPath.startsWith(dir)) {
           this.json(res, 403, { error: "Forbidden" });
           return;
@@ -49923,14 +50228,14 @@ data: ${JSON.stringify(msg.data)}
           this.json(res, 404, { error: `Provider directory not found: ${type}` });
           return;
         }
-        const fullPath = path222.resolve(dir, path222.normalize(filePath));
+        const fullPath = path21.resolve(dir, path21.normalize(filePath));
         if (!fullPath.startsWith(dir)) {
           this.json(res, 403, { error: "Forbidden" });
           return;
         }
         try {
           if (fs14.existsSync(fullPath)) fs14.copyFileSync(fullPath, fullPath + ".bak");
-          fs14.mkdirSync(path222.dirname(fullPath), { recursive: true });
+          fs14.mkdirSync(path21.dirname(fullPath), { recursive: true });
           fs14.writeFileSync(fullPath, content, "utf-8");
           this.log(`File saved: ${fullPath} (${content.length} chars)`);
           this.providerLoader.reload();
@@ -49947,7 +50252,7 @@ data: ${JSON.stringify(msg.data)}
           return;
         }
         for (const name of ["scripts.js", "provider.json"]) {
-          const p = path222.join(dir, name);
+          const p = path21.join(dir, name);
           if (fs14.existsSync(p)) {
             const source = fs14.readFileSync(p, "utf-8");
             this.json(res, 200, { type, path: p, source, lines: source.split("\n").length });
@@ -49968,8 +50273,8 @@ data: ${JSON.stringify(msg.data)}
           this.json(res, 404, { error: `Provider not found: ${type}` });
           return;
         }
-        const target = fs14.existsSync(path222.join(dir, "scripts.js")) ? "scripts.js" : "provider.json";
-        const targetPath = path222.join(dir, target);
+        const target = fs14.existsSync(path21.join(dir, "scripts.js")) ? "scripts.js" : "provider.json";
+        const targetPath = path21.join(dir, target);
         try {
           if (fs14.existsSync(targetPath)) fs14.copyFileSync(targetPath, targetPath + ".bak");
           fs14.writeFileSync(targetPath, source, "utf-8");
@@ -50116,7 +50421,7 @@ data: ${JSON.stringify(msg.data)}
         }
         let targetDir;
         targetDir = this.providerLoader.getUserProviderDir(category, type);
-        const jsonPath = path222.join(targetDir, "provider.json");
+        const jsonPath = path21.join(targetDir, "provider.json");
         if (fs14.existsSync(jsonPath)) {
           this.json(res, 409, { error: `Provider already exists at ${targetDir}`, path: targetDir });
           return;
@@ -50128,8 +50433,8 @@ data: ${JSON.stringify(msg.data)}
           const createdFiles = ["provider.json"];
           if (result.files) {
             for (const [relPath, content] of Object.entries(result.files)) {
-              const fullPath = path222.join(targetDir, relPath);
-              fs14.mkdirSync(path222.dirname(fullPath), { recursive: true });
+              const fullPath = path21.join(targetDir, relPath);
+              fs14.mkdirSync(path21.dirname(fullPath), { recursive: true });
               fs14.writeFileSync(fullPath, content, "utf-8");
               createdFiles.push(relPath);
             }
@@ -50182,22 +50487,22 @@ data: ${JSON.stringify(msg.data)}
         if (!fs14.existsSync(scriptsDir)) return null;
         const versions = fs14.readdirSync(scriptsDir).filter((d) => {
           try {
-            return fs14.statSync(path222.join(scriptsDir, d)).isDirectory();
+            return fs14.statSync(path21.join(scriptsDir, d)).isDirectory();
           } catch {
             return false;
           }
         }).sort((a, b2) => b2.localeCompare(a, void 0, { numeric: true, sensitivity: "base" }));
         if (versions.length === 0) return null;
-        return path222.join(scriptsDir, versions[0]);
+        return path21.join(scriptsDir, versions[0]);
       }
       resolveAutoImplWritableProviderDir(category, type, requestedDir) {
-        const canonicalUserDir = path222.resolve(this.providerLoader.getUserProviderDir(category, type));
-        const desiredDir = requestedDir ? path222.resolve(requestedDir) : canonicalUserDir;
-        const upstreamRoot = path222.resolve(this.providerLoader.getUpstreamDir());
-        if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path222.sep}`)) {
+        const canonicalUserDir = path21.resolve(this.providerLoader.getUserProviderDir(category, type));
+        const desiredDir = requestedDir ? path21.resolve(requestedDir) : canonicalUserDir;
+        const upstreamRoot = path21.resolve(this.providerLoader.getUpstreamDir());
+        if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path21.sep}`)) {
           return { dir: null, reason: `Refusing to write into upstream provider directory: ${desiredDir}` };
         }
-        if (path222.basename(desiredDir) !== type) {
+        if (path21.basename(desiredDir) !== type) {
           return { dir: null, reason: `Requested writable provider directory must end with '${type}': ${desiredDir}` };
         }
         const sourceDir = this.findProviderDir(type);
@@ -50205,11 +50510,11 @@ data: ${JSON.stringify(msg.data)}
           return { dir: null, reason: `Provider source directory not found for '${type}'` };
         }
         if (!fs14.existsSync(desiredDir)) {
-          fs14.mkdirSync(path222.dirname(desiredDir), { recursive: true });
+          fs14.mkdirSync(path21.dirname(desiredDir), { recursive: true });
           fs14.cpSync(sourceDir, desiredDir, { recursive: true });
           this.log(`Auto-implement writable copy created: ${desiredDir}`);
         }
-        const providerJson = path222.join(desiredDir, "provider.json");
+        const providerJson = path21.join(desiredDir, "provider.json");
         if (!fs14.existsSync(providerJson)) {
           return { dir: null, reason: `provider.json not found in writable provider directory: ${desiredDir}` };
         }
@@ -50245,7 +50550,7 @@ data: ${JSON.stringify(msg.data)}
           setMode: "set_mode.js"
         };
         const targetFileNames = new Set(functions.map((fn2) => funcToFile[fn2]).filter(Boolean));
-        const scriptsDir = path222.join(providerDir, "scripts");
+        const scriptsDir = path21.join(providerDir, "scripts");
         const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
         if (latestScriptsDir) {
           lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -50256,7 +50561,7 @@ data: ${JSON.stringify(msg.data)}
           for (const file2 of fs14.readdirSync(latestScriptsDir)) {
             if (file2.endsWith(".js") && targetFileNames.has(file2)) {
               try {
-                const content = fs14.readFileSync(path222.join(latestScriptsDir, file2), "utf-8");
+                const content = fs14.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
                 lines.push(`### \`${file2}\` \u270F\uFE0F EDIT`);
                 lines.push("```javascript");
                 lines.push(content);
@@ -50273,7 +50578,7 @@ data: ${JSON.stringify(msg.data)}
             lines.push("");
             for (const file2 of refFiles) {
               try {
-                const content = fs14.readFileSync(path222.join(latestScriptsDir, file2), "utf-8");
+                const content = fs14.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
                 lines.push(`### \`${file2}\` \u{1F512}`);
                 lines.push("```javascript");
                 lines.push(content);
@@ -50314,10 +50619,10 @@ data: ${JSON.stringify(msg.data)}
             lines.push("");
           }
         }
-        const docsDir = path222.join(providerDir, "../../docs");
+        const docsDir = path21.join(providerDir, "../../docs");
         const loadGuide = (name) => {
           try {
-            const p = path222.join(docsDir, name);
+            const p = path21.join(docsDir, name);
             if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
           } catch {
           }
@@ -50491,7 +50796,7 @@ data: ${JSON.stringify(msg.data)}
           parseApproval: "parse_approval.js"
         };
         const targetFileNames = new Set(functions.map((fn2) => funcToFile[fn2]).filter(Boolean));
-        const scriptsDir = path222.join(providerDir, "scripts");
+        const scriptsDir = path21.join(providerDir, "scripts");
         const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
         if (latestScriptsDir) {
           lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -50503,7 +50808,7 @@ data: ${JSON.stringify(msg.data)}
             if (!file2.endsWith(".js")) continue;
             if (!targetFileNames.has(file2)) continue;
             try {
-              const content = fs14.readFileSync(path222.join(latestScriptsDir, file2), "utf-8");
+              const content = fs14.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
               lines.push(`### \`${file2}\` \u270F\uFE0F EDIT`);
               lines.push("```javascript");
               lines.push(content);
@@ -50519,7 +50824,7 @@ data: ${JSON.stringify(msg.data)}
             lines.push("");
             for (const file2 of refFiles) {
               try {
-                const content = fs14.readFileSync(path222.join(latestScriptsDir, file2), "utf-8");
+                const content = fs14.readFileSync(path21.join(latestScriptsDir, file2), "utf-8");
                 lines.push(`### \`${file2}\` \u{1F512}`);
                 lines.push("```javascript");
                 lines.push(content);
@@ -50552,10 +50857,10 @@ data: ${JSON.stringify(msg.data)}
             lines.push("");
           }
         }
-        const docsDir = path222.join(providerDir, "../../docs");
+        const docsDir = path21.join(providerDir, "../../docs");
         const loadGuide = (name) => {
           try {
-            const p = path222.join(docsDir, name);
+            const p = path21.join(docsDir, name);
             if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
           } catch {
           }