@adhdev/daemon-core 0.8.64 → 0.8.66

package/dist/index.js

@@ -458,6 +458,231 @@ var init_logger = __esm({
   }
 });
 
+// src/providers/io-contracts.ts
+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 record = input;
+  const nestedInput = record.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 record.text === "string" ? record.text : typeof record.message === "string" ? record.message : void 0;
+  if (directText !== void 0) {
+    return { parts: [{ type: "text", text: directText }], textFallback: directText };
+  }
+  const directParts = normalizeInputParts(record.parts ?? record.prompt);
+  return {
+    parts: directParts,
+    textFallback: typeof record.textFallback === "string" ? record.textFallback : void 0,
+    metadata: normalizeInputMetadata(record.metadata)
+  };
+}
+function normalizeInputMetadata(value) {
+  if (!value || typeof value !== "object") return void 0;
+  const record = value;
+  const metadata = {};
+  if (record.source === "dashboard" || record.source === "shortcut_api" || record.source === "provider_script" || record.source === "session_replay") {
+    metadata.source = record.source;
+  }
+  if (typeof record.clientTimestamp === "number" && Number.isFinite(record.clientTimestamp)) {
+    metadata.clientTimestamp = record.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 = __esm({
+  "src/providers/io-contracts.ts"() {
+    "use strict";
+  }
+});
+
+// src/providers/contracts.ts
+function flattenContent(content) {
+  if (typeof content === "string") return content;
+  return flattenMessageParts(normalizeMessageParts(content));
+}
+var init_contracts = __esm({
+  "src/providers/contracts.ts"() {
+    "use strict";
+    init_io_contracts();
+    init_io_contracts();
+  }
+});
+
 // src/providers/chat-message-normalization.ts
 function canonicalizeKindHint(value) {
   return value.trim().toLowerCase().replace(/[\s-]+/g, "_");
@@ -608,39 +833,161 @@ var init_chat_message_normalization = __esm({
   }
 });
 
-// src/cli-adapters/terminal-backends/ghostty-vt-backend.ts
-function isModuleNotFoundError(error, ref) {
-  if (!(error instanceof Error)) return false;
-  const message = error.message || "";
-  const code = "code" in error ? error.code : void 0;
-  return code === "MODULE_NOT_FOUND" && message.includes(ref);
+// src/providers/read-chat-contract.ts
+function isPlainObject3(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
 }
-function normalizeBinding(mod, ref) {
-  const binding = mod?.default?.createTerminal ? mod.default : mod?.createTerminal ? mod : null;
-  if (!binding) {
-    throw new Error(`Ghostty VT binding "${ref}" does not export createTerminal()`);
+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 binding;
+  return status;
 }
-function getBindingCandidates() {
-  const explicit = process.env.ADHDEV_GHOSTTY_VT_BINDING?.trim();
-  return explicit ? [explicit] : DEFAULT_BINDING_CANDIDATES;
+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 loadGhosttyVtBinding(required) {
-  if (cachedBinding !== void 0) {
-    if (!cachedBinding && required && cachedBindingError) {
-      throw cachedBindingError;
+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 cachedBinding;
+    return activeModal === null ? null : void 0;
   }
-  const errors = [];
-  for (const ref of getBindingCandidates()) {
-    try {
-      const mod = require(ref);
-      cachedBinding = normalizeBinding(mod, ref);
-      cachedBindingError = null;
-      return cachedBinding;
-    } catch (error) {
+  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, VALID_ROLES;
+var init_read_chat_contract = __esm({
+  "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"];
+  }
+});
+
+// src/cli-adapters/terminal-backends/ghostty-vt-backend.ts
+function isModuleNotFoundError(error, ref) {
+  if (!(error instanceof Error)) return false;
+  const message = error.message || "";
+  const code = "code" in error ? error.code : void 0;
+  return code === "MODULE_NOT_FOUND" && message.includes(ref);
+}
+function normalizeBinding(mod, ref) {
+  const binding = mod?.default?.createTerminal ? mod.default : mod?.createTerminal ? mod : null;
+  if (!binding) {
+    throw new Error(`Ghostty VT binding "${ref}" does not export createTerminal()`);
+  }
+  return binding;
+}
+function getBindingCandidates() {
+  const explicit = process.env.ADHDEV_GHOSTTY_VT_BINDING?.trim();
+  return explicit ? [explicit] : DEFAULT_BINDING_CANDIDATES;
+}
+function loadGhosttyVtBinding(required) {
+  if (cachedBinding !== void 0) {
+    if (!cachedBinding && required && cachedBindingError) {
+      throw cachedBindingError;
+    }
+    return cachedBinding;
+  }
+  const errors = [];
+  for (const ref of getBindingCandidates()) {
+    try {
+      const mod = require(ref);
+      cachedBinding = normalizeBinding(mod, ref);
+      cachedBindingError = null;
+      return cachedBinding;
+    } catch (error) {
       if (isModuleNotFoundError(error, ref)) {
         errors.push(`${ref}: module not found`);
         continue;
@@ -1463,6 +1810,7 @@ var init_provider_cli_adapter = __esm({
     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();
@@ -2608,6 +2956,9 @@ var init_provider_cli_adapter = __esm({
             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;
@@ -5199,351 +5550,142 @@ var CdpDomHandlers = class {
   * 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 };
-    }
-  }
-};
-
-// src/providers/ide-provider-instance.ts
-var crypto2 = __toESM(require("crypto"));
-
-// src/providers/io-contracts.ts
-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 record = input;
-  const nestedInput = record.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 record.text === "string" ? record.text : typeof record.message === "string" ? record.message : void 0;
-  if (directText !== void 0) {
-    return { parts: [{ type: "text", text: directText }], textFallback: directText };
-  }
-  const directParts = normalizeInputParts(record.parts ?? record.prompt);
-  return {
-    parts: directParts,
-    textFallback: typeof record.textFallback === "string" ? record.textFallback : void 0,
-    metadata: normalizeInputMetadata(record.metadata)
-  };
-}
-function normalizeInputMetadata(value) {
-  if (!value || typeof value !== "object") return void 0;
-  const record = value;
-  const metadata = {};
-  if (record.source === "dashboard" || record.source === "shortcut_api" || record.source === "provider_script" || record.source === "session_replay") {
-    metadata.source = record.source;
-  }
-  if (typeof record.clientTimestamp === "number" && Number.isFinite(record.clientTimestamp)) {
-    metadata.clientTimestamp = record.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 } : {}
+  */
+  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");
-}
+};
 
-// src/providers/contracts.ts
-function flattenContent(content) {
-  if (typeof content === "string") return content;
-  return flattenMessageParts(normalizeMessageParts(content));
-}
+// src/providers/ide-provider-instance.ts
+var crypto2 = __toESM(require("crypto"));
+init_contracts();
+
+// src/providers/extension-provider-instance.ts
+init_contracts();
 
 // src/providers/status-monitor.ts
 var DEFAULT_MONITOR_CONFIG = {
@@ -5658,6 +5800,7 @@ var StatusMonitor = class {
 };
 
 // src/providers/control-effects.ts
+init_contracts();
 init_chat_message_normalization();
 function extractProviderControlValues(controls, data) {
   if (!data || typeof data !== "object") return void 0;
@@ -5779,38 +5922,37 @@ function buildPersistedProviderEffectMessage(effect) {
   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) {
@@ -6701,19 +6843,37 @@ var ExtensionProviderInstance = class {
       );
     }
   }
+  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 hash = `${msg.role}:${(msg.content || "").slice(0, 100)}`;
-      const prevTime = this.prevMessageHashes.get(hash);
+      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(hash, msg.receivedAt);
+      nextHashes.set(syntheticTurnKey, msg.receivedAt);
     }
     this.prevMessageHashes = nextHashes;
     return normalizeChatMessages(messages);
@@ -6790,6 +6950,7 @@ ${effect.notification.body || ""}`.trim();
 
 // src/providers/ide-provider-instance.ts
 init_logger();
+init_read_chat_contract();
 
 // src/providers/approval-utils.ts
 var DEFAULT_APPROVAL_POSITIVE_HINTS = [
@@ -7071,7 +7232,7 @@ var IdeProviderInstance = class {
         }
       }
       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;
@@ -8216,6 +8377,65 @@ function reconcileIdeRuntimeSessions(instanceManager, sessionRegistry) {
 init_logger();
 
 // src/commands/chat-commands.ts
+init_contracts();
+
+// src/providers/provider-input-support.ts
+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`);
+  }
+}
+
+// src/commands/chat-commands.ts
+init_read_chat_contract();
 init_logger();
 
 // src/logging/debug-config.ts
@@ -8397,10 +8617,15 @@ function isCliLikeTransport(transport) {
 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);
@@ -8553,14 +8778,20 @@ function computeReadChatSync(messages, cursor) {
   };
 }
 function buildReadChatCommandResult(payload, args) {
-  const messages = normalizeReadChatMessages(payload);
+  let validatedPayload;
+  try {
+    validatedPayload = validateReadChatResultPayload(payload, "read_chat command result");
+  } catch (error) {
+    return { success: false, error: error?.message || String(error) };
+  }
+  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,
@@ -8571,7 +8802,7 @@ function buildReadChatCommandResult(payload, args) {
   const sync = computeReadChatSync(messages, cursor);
   return {
     success: true,
-    ...payload,
+    ...validatedPayload,
     messages: sync.messages,
     syncMode: sync.syncMode,
     replaceFrom: sync.replaceFrom,
@@ -8650,12 +8881,18 @@ async function handleReadChat(h, args) {
     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);
       }
     }
@@ -8673,25 +8910,26 @@ async function handleReadChat(h, args) {
           }
         }
         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) {
@@ -8746,15 +8984,16 @@ async function handleReadChat(h, args) {
           }
         }
         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) {
@@ -8775,25 +9014,26 @@ async function handleReadChat(h, args) {
           }
         }
         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) {
@@ -8811,11 +9051,12 @@ async function handleReadChat(h, args) {
 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) => LOG.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 };
   };
@@ -8823,11 +9064,26 @@ async function handleSendChat(h, args) {
     _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) {
@@ -8835,6 +9091,8 @@ async function handleSendChat(h, args) {
       }
     }
   }
+  assertTextOnlyInput(provider, input);
+  if (!text) return { success: false, error: "text required" };
   if (isExtensionTransport(transport)) {
     _log(`Extension: ${provider?.type || "unknown_extension"}`);
     try {
@@ -9999,14 +10257,14 @@ function normalizeProviderScriptArgs(args, scriptName) {
 }
 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 {};
@@ -10809,7 +11067,7 @@ var DaemonCommandHandler = class {
 
 // src/commands/cli-manager.ts
 var os12 = __toESM(require("os"));
-var path13 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 var crypto4 = __toESM(require("crypto"));
 var import_chalk = __toESM(require("chalk"));
 init_provider_cli_adapter();
@@ -10821,6 +11079,7 @@ var path11 = __toESM(require("path"));
 var crypto3 = __toESM(require("crypto"));
 var fs5 = __toESM(require("fs"));
 var import_node_module = require("module");
+init_contracts();
 init_provider_cli_adapter();
 init_logger();
 init_chat_message_normalization();
@@ -11119,6 +11378,7 @@ var CliProviderInstance = class {
   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) => {
           LOG.warn("CLI", `[${this.type}] send_message failed: ${e?.message || e}`);
@@ -11556,10 +11816,10 @@ ${effect.notification.body || ""}`.trim();
 };
 
 // src/providers/acp-provider-instance.ts
-var path12 = __toESM(require("path"));
 var import_stream = require("stream");
 var import_child_process5 = require("child_process");
 var import_sdk = require("@agentclientprotocol/sdk");
+init_contracts();
 init_chat_message_normalization();
 init_logger();
 function getPromptCapabilityFlags(agentCapabilities) {
@@ -11570,25 +11830,6 @@ function getPromptCapabilityFlags(agentCapabilities) {
     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;
@@ -11605,55 +11846,60 @@ function buildAcpPromptParts(input, agentCapabilities) {
       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;
 }
@@ -11784,6 +12030,7 @@ var AcpProviderInstance = class {
   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}`)
@@ -12717,6 +12964,7 @@ ${rawInput}` : rawInput;
 };
 
 // src/commands/cli-manager.ts
+init_contracts();
 init_logger();
 
 // src/commands/hosted-runtime-restore.ts
@@ -12983,7 +13231,7 @@ var DaemonCliManager = class {
   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();
@@ -13442,6 +13690,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);
@@ -13464,16 +13718,17 @@ Run 'adhdev doctor' for detailed diagnostics.`
 var import_child_process6 = require("child_process");
 var net = __toESM(require("net"));
 var os14 = __toESM(require("os"));
-var path15 = __toESM(require("path"));
+var path14 = __toESM(require("path"));
 
 // src/providers/provider-loader.ts
 var fs6 = __toESM(require("fs"));
-var path14 = __toESM(require("path"));
+var path13 = __toESM(require("path"));
 var os13 = __toESM(require("os"));
 var chokidar = __toESM(require("chokidar"));
 init_logger();
 
 // src/providers/provider-schema.ts
+var VALID_CAPABILITY_MEDIA_TYPES = /* @__PURE__ */ new Set(["text", "image", "audio", "video", "resource"]);
 var KNOWN_PROVIDER_FIELDS = /* @__PURE__ */ new Set([
   "type",
   "name",
@@ -13524,6 +13779,7 @@ var KNOWN_PROVIDER_FIELDS = /* @__PURE__ */ new Set([
   "sendDelayMs",
   "sendKey",
   "submitStrategy",
+  "timeouts",
   "disableUpstream"
 ]);
 var VALUE_CONTROL_TYPES = /* @__PURE__ */ new Set(["select", "toggle", "cycle", "slider"]);
@@ -13550,6 +13806,7 @@ function validateProviderDefinition(raw) {
     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;
@@ -13567,11 +13824,61 @@ function validateProviderDefinition(raw) {
   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");
@@ -13626,9 +13933,9 @@ var ProviderLoader = class _ProviderLoader {
   static META_FILE = ".meta.json";
   constructor(options) {
     this.logFn = options?.logFn || LOG.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,
@@ -13676,7 +13983,7 @@ var ProviderLoader = class _ProviderLoader {
     }
     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}`);
@@ -13690,7 +13997,7 @@ var ProviderLoader = class _ProviderLoader {
   * 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.
@@ -13717,7 +14024,7 @@ var ProviderLoader = class _ProviderLoader {
   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)
@@ -13756,7 +14063,7 @@ var ProviderLoader = class _ProviderLoader {
     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;
@@ -14071,8 +14378,8 @@ var ProviderLoader = class _ProviderLoader {
               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;
             }
@@ -14087,8 +14394,8 @@ var ProviderLoader = class _ProviderLoader {
             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.`;
@@ -14105,8 +14412,8 @@ var ProviderLoader = class _ProviderLoader {
               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) {
@@ -14122,8 +14429,8 @@ var ProviderLoader = class _ProviderLoader {
         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;
         }
       }
     }
@@ -14148,14 +14455,14 @@ var ProviderLoader = class _ProviderLoader {
       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 cached = this.scriptsCache.get(dir);
     if (cached) return cached;
-    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)];
@@ -14197,7 +14504,7 @@ var ProviderLoader = class _ProviderLoader {
             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();
           }
         };
@@ -14252,7 +14559,7 @@ var ProviderLoader = class _ProviderLoader {
     }
     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 {
@@ -14312,17 +14619,17 @@ var ProviderLoader = class _ProviderLoader {
         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 });
@@ -14397,8 +14704,8 @@ var ProviderLoader = class _ProviderLoader {
   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 {
@@ -14409,7 +14716,7 @@ var ProviderLoader = class _ProviderLoader {
   /** .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,
@@ -14426,7 +14733,7 @@ var ProviderLoader = class _ProviderLoader {
     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 {
@@ -14611,17 +14918,17 @@ var ProviderLoader = class _ProviderLoader {
     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 {
               }
             }
@@ -14638,7 +14945,7 @@ var ProviderLoader = class _ProviderLoader {
    * (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)];
@@ -14652,7 +14959,7 @@ var ProviderLoader = class _ProviderLoader {
       for (const file of fs6.readdirSync(dir)) {
         if (!file.endsWith(".js")) continue;
         const scriptName = toCamel(file.replace(".js", ""));
-        const filePath = path14.join(dir, file);
+        const filePath = path13.join(dir, file);
         result[scriptName] = (...args) => {
           try {
             let content = fs6.readFileSync(filePath, "utf-8");
@@ -14712,7 +15019,7 @@ var ProviderLoader = class _ProviderLoader {
       }
       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);
@@ -14733,7 +15040,7 @@ var ProviderLoader = class _ProviderLoader {
             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)];
@@ -14759,7 +15066,7 @@ var ProviderLoader = class _ProviderLoader {
           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));
         }
       }
     };
@@ -15017,8 +15324,8 @@ function detectCurrentWorkspace(ideId) {
       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"
         );
@@ -15196,9 +15503,9 @@ init_logger();
 
 // src/logging/command-log.ts
 var fs7 = __toESM(require("fs"));
-var path16 = __toESM(require("path"));
+var path15 = __toESM(require("path"));
 var os15 = __toESM(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 {
@@ -15236,13 +15543,13 @@ function getDateStr2() {
   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();
   }
 }
@@ -15256,7 +15563,7 @@ function cleanOldFiles() {
       const dateMatch = file.match(/commands-(\d{4}-\d{2}-\d{2})/);
       if (dateMatch && dateMatch[1] < cutoffStr) {
         try {
-          fs7.unlinkSync(path16.join(LOG_DIR2, file));
+          fs7.unlinkSync(path15.join(LOG_DIR2, file));
         } catch {
         }
       }
@@ -15669,13 +15976,13 @@ var import_child_process7 = require("child_process");
 var import_child_process8 = require("child_process");
 var fs8 = __toESM(require("fs"));
 var os17 = __toESM(require("os"));
-var path17 = __toESM(require("path"));
+var path16 = __toESM(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}
@@ -15715,7 +16022,7 @@ async function waitForPidExit(pid, timeoutMs) {
   }
 }
 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);
@@ -15744,7 +16051,7 @@ function stopSessionHostProcesses(appName) {
   }
 }
 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 {
@@ -15755,7 +16062,7 @@ function cleanupStaleGlobalInstallDirs(pkgName) {
   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") {
@@ -15763,25 +16070,25 @@ function cleanupStaleGlobalInstallDirs(pkgName) {
   }
   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)}`);
     }
   }
 }
@@ -16811,6 +17118,7 @@ var DEFAULT_DAEMON_PORT = 19222;
 var DAEMON_WS_PATH = "/ipc";
 
 // src/agent-stream/provider-adapter.ts
+init_read_chat_contract();
 init_chat_message_normalization();
 var ProviderStreamAdapter = class {
   agentType;
@@ -16916,26 +17224,29 @@ var ProviderStreamAdapter = class {
         }
         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;
@@ -17774,15 +18085,16 @@ var ProviderInstanceManager = class {
 };
 
 // src/index.ts
+init_io_contracts();
 init_chat_message_normalization();
 
 // src/providers/version-archive.ts
 var fs10 = __toESM(require("fs"));
-var path18 = __toESM(require("path"));
+var path17 = __toESM(require("path"));
 var os18 = __toESM(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 = {};
@@ -17829,7 +18141,7 @@ var VersionArchive = class {
   }
   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 {
     }
@@ -17886,7 +18198,7 @@ function checkPathExists2(paths) {
   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;
@@ -17896,7 +18208,7 @@ function checkPathExists2(paths) {
 }
 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;
@@ -17922,7 +18234,7 @@ async function detectAllVersions(loader, archive) {
       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);
@@ -17963,7 +18275,7 @@ async function detectAllVersions(loader, archive) {
 // src/daemon/dev-server.ts
 var http2 = __toESM(require("http"));
 var fs14 = __toESM(require("fs"));
-var path22 = __toESM(require("path"));
+var path21 = __toESM(require("path"));
 init_config();
 
 // src/daemon/scaffold-template.ts
@@ -18307,7 +18619,7 @@ init_logger();
 
 // src/daemon/dev-cdp-handlers.ts
 var fs11 = __toESM(require("fs"));
-var path19 = __toESM(require("path"));
+var path18 = __toESM(require("path"));
 init_logger();
 async function handleCdpEvaluate(ctx, req, res) {
   const body = await ctx.readBody(req);
@@ -18486,17 +18798,17 @@ async function handleScriptHints(ctx, type, _req, res) {
     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;
@@ -19325,7 +19637,7 @@ async function handleDomContext(ctx, type, req, res) {
 
 // src/daemon/dev-cli-debug.ts
 var fs12 = __toESM(require("fs"));
-var path20 = __toESM(require("path"));
+var path19 = __toESM(require("path"));
 function slugifyFixtureName(value) {
   const normalized = String(value || "").trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
   return normalized || `fixture-${Date.now()}`;
@@ -19335,11 +19647,11 @@ function getCliFixtureDir(ctx, type) {
   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}`);
   }
@@ -20106,7 +20418,7 @@ async function handleCliFixtureCapture(ctx, req, res) {
       },
       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,
@@ -20130,7 +20442,7 @@ async function handleCliFixtureList(ctx, type, _req, res) {
       return;
     }
     const fixtures = fs12.readdirSync(fixtureDir).filter((file) => file.endsWith(".json")).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" })).map((file) => {
-      const fullPath = path20.join(fixtureDir, file);
+      const fullPath = path19.join(fixtureDir, file);
       try {
         const raw = JSON.parse(fs12.readFileSync(fullPath, "utf-8"));
         return {
@@ -20266,7 +20578,7 @@ async function handleCliRaw(ctx, req, res) {
 
 // src/daemon/dev-auto-implement.ts
 var fs13 = __toESM(require("fs"));
-var path21 = __toESM(require("path"));
+var path20 = __toESM(require("path"));
 var os19 = __toESM(require("os"));
 function getAutoImplPid(ctx) {
   const pid = ctx.autoImplProcess?.pid;
@@ -20323,22 +20635,22 @@ function getLatestScriptVersionDir(scriptsDir) {
   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, b) => b.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);
@@ -20346,11 +20658,11 @@ function resolveAutoImplWritableProviderDir(ctx, category, type, requestedDir) {
     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}` };
   }
@@ -20361,13 +20673,13 @@ function loadAutoImplReferenceScripts(ctx, referenceType) {
   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 file of fs13.readdirSync(latestDir)) {
     if (!file.endsWith(".js")) continue;
     try {
-      referenceScripts[file] = fs13.readFileSync(path21.join(latestDir, file), "utf-8");
+      referenceScripts[file] = fs13.readFileSync(path20.join(latestDir, file), "utf-8");
     } catch {
     }
   }
@@ -20475,9 +20787,9 @@ async function handleAutoImplement(ctx, type, req, res) {
     });
     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);
@@ -20914,7 +21226,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
     setMode: "set_mode.js"
   };
   const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).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}\``);
@@ -20925,7 +21237,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
     for (const file of fs13.readdirSync(latestScriptsDir)) {
       if (file.endsWith(".js") && targetFileNames.has(file)) {
         try {
-          const content = fs13.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
+          const content = fs13.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
           lines.push("```javascript");
           lines.push(content);
@@ -20942,7 +21254,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
       lines.push("");
       for (const file of refFiles) {
         try {
-          const content = fs13.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
+          const content = fs13.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u{1F512}`);
           lines.push("```javascript");
           lines.push(content);
@@ -20983,10 +21295,10 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
       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 {
     }
@@ -21223,7 +21535,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
     parseApproval: "parse_approval.js"
   };
   const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).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}\``);
@@ -21235,7 +21547,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       if (!file.endsWith(".js")) continue;
       if (!targetFileNames.has(file)) continue;
       try {
-        const content = fs13.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
+        const content = fs13.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
         lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
         lines.push("```javascript");
         lines.push(content);
@@ -21251,7 +21563,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       lines.push("");
       for (const file of refFiles) {
         try {
-          const content = fs13.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
+          const content = fs13.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u{1F512}`);
           lines.push("```javascript");
           lines.push(content);
@@ -21284,10 +21596,10 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       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 {
     }
@@ -21734,8 +22046,8 @@ var DevServer = class _DevServer {
   }
   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 path22 = typeof r.pattern === "string" ? r.pattern : r.pattern.source.replace(/\\\//g, "/").replace(/\(\[.*?\]\+\)/g, ":type").replace(/[\^$]/g, "");
+      return `${r.method.padEnd(5)} ${path22}`;
     });
   }
   async start(port = DEV_SERVER_PORT) {
@@ -22016,12 +22328,12 @@ var DevServer = class _DevServer {
   // ─── DevConsole SPA ───
   getConsoleDistDir() {
     const candidates = [
-      path22.resolve(__dirname, "../../web-devconsole/dist"),
-      path22.resolve(__dirname, "../../../web-devconsole/dist"),
-      path22.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(path22.join(dir, "index.html"))) return dir;
+      if (fs14.existsSync(path21.join(dir, "index.html"))) return dir;
     }
     return null;
   }
@@ -22031,7 +22343,7 @@ var DevServer = class _DevServer {
       this.json(res, 500, { error: "DevConsole not found. Run: npm run build -w packages/web-devconsole" });
       return;
     }
-    const htmlPath = path22.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" });
@@ -22056,15 +22368,15 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: "Not found" });
       return;
     }
-    const safePath = path22.normalize(pathname).replace(/^\.\.\//, "");
-    const filePath = path22.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 = path22.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);
@@ -22177,9 +22489,9 @@ var DevServer = class _DevServer {
           const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
           if (entry.isDirectory()) {
             files.push({ path: rel, size: 0, type: "dir" });
-            scan(path22.join(d, entry.name), rel);
+            scan(path21.join(d, entry.name), rel);
           } else {
-            const stat = fs14.statSync(path22.join(d, entry.name));
+            const stat = fs14.statSync(path21.join(d, entry.name));
             files.push({ path: rel, size: stat.size, type: "file" });
           }
         }
@@ -22202,7 +22514,7 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider directory not found: ${type}` });
       return;
     }
-    const fullPath = path22.resolve(dir, path22.normalize(filePath));
+    const fullPath = path21.resolve(dir, path21.normalize(filePath));
     if (!fullPath.startsWith(dir)) {
       this.json(res, 403, { error: "Forbidden" });
       return;
@@ -22227,14 +22539,14 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider directory not found: ${type}` });
       return;
     }
-    const fullPath = path22.resolve(dir, path22.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(path22.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();
@@ -22251,7 +22563,7 @@ var DevServer = class _DevServer {
       return;
     }
     for (const name of ["scripts.js", "provider.json"]) {
-      const p = path22.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 });
@@ -22272,8 +22584,8 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider not found: ${type}` });
       return;
     }
-    const target = fs14.existsSync(path22.join(dir, "scripts.js")) ? "scripts.js" : "provider.json";
-    const targetPath = path22.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");
@@ -22420,7 +22732,7 @@ var DevServer = class _DevServer {
     }
     let targetDir;
     targetDir = this.providerLoader.getUserProviderDir(category, type);
-    const jsonPath = path22.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;
@@ -22432,8 +22744,8 @@ var DevServer = class _DevServer {
       const createdFiles = ["provider.json"];
       if (result.files) {
         for (const [relPath, content] of Object.entries(result.files)) {
-          const fullPath = path22.join(targetDir, relPath);
-          fs14.mkdirSync(path22.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);
         }
@@ -22486,22 +22798,22 @@ var DevServer = class _DevServer {
     if (!fs14.existsSync(scriptsDir)) return null;
     const versions = fs14.readdirSync(scriptsDir).filter((d) => {
       try {
-        return fs14.statSync(path22.join(scriptsDir, d)).isDirectory();
+        return fs14.statSync(path21.join(scriptsDir, d)).isDirectory();
       } catch {
         return false;
       }
     }).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" }));
     if (versions.length === 0) return null;
-    return path22.join(scriptsDir, versions[0]);
+    return path21.join(scriptsDir, versions[0]);
   }
   resolveAutoImplWritableProviderDir(category, type, requestedDir) {
-    const canonicalUserDir = path22.resolve(this.providerLoader.getUserProviderDir(category, type));
-    const desiredDir = requestedDir ? path22.resolve(requestedDir) : canonicalUserDir;
-    const upstreamRoot = path22.resolve(this.providerLoader.getUpstreamDir());
-    if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path22.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 (path22.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);
@@ -22509,11 +22821,11 @@ var DevServer = class _DevServer {
       return { dir: null, reason: `Provider source directory not found for '${type}'` };
     }
     if (!fs14.existsSync(desiredDir)) {
-      fs14.mkdirSync(path22.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 = path22.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}` };
     }
@@ -22549,7 +22861,7 @@ var DevServer = class _DevServer {
       setMode: "set_mode.js"
     };
     const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-    const scriptsDir = path22.join(providerDir, "scripts");
+    const scriptsDir = path21.join(providerDir, "scripts");
     const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
     if (latestScriptsDir) {
       lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -22560,7 +22872,7 @@ var DevServer = class _DevServer {
       for (const file of fs14.readdirSync(latestScriptsDir)) {
         if (file.endsWith(".js") && targetFileNames.has(file)) {
           try {
-            const content = fs14.readFileSync(path22.join(latestScriptsDir, file), "utf-8");
+            const content = fs14.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
             lines.push("```javascript");
             lines.push(content);
@@ -22577,7 +22889,7 @@ var DevServer = class _DevServer {
         lines.push("");
         for (const file of refFiles) {
           try {
-            const content = fs14.readFileSync(path22.join(latestScriptsDir, file), "utf-8");
+            const content = fs14.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u{1F512}`);
             lines.push("```javascript");
             lines.push(content);
@@ -22618,10 +22930,10 @@ var DevServer = class _DevServer {
         lines.push("");
       }
     }
-    const docsDir = path22.join(providerDir, "../../docs");
+    const docsDir = path21.join(providerDir, "../../docs");
     const loadGuide = (name) => {
       try {
-        const p = path22.join(docsDir, name);
+        const p = path21.join(docsDir, name);
         if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
       } catch {
       }
@@ -22795,7 +23107,7 @@ var DevServer = class _DevServer {
       parseApproval: "parse_approval.js"
     };
     const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-    const scriptsDir = path22.join(providerDir, "scripts");
+    const scriptsDir = path21.join(providerDir, "scripts");
     const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
     if (latestScriptsDir) {
       lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -22807,7 +23119,7 @@ var DevServer = class _DevServer {
         if (!file.endsWith(".js")) continue;
         if (!targetFileNames.has(file)) continue;
         try {
-          const content = fs14.readFileSync(path22.join(latestScriptsDir, file), "utf-8");
+          const content = fs14.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
           lines.push("```javascript");
           lines.push(content);
@@ -22823,7 +23135,7 @@ var DevServer = class _DevServer {
         lines.push("");
         for (const file of refFiles) {
           try {
-            const content = fs14.readFileSync(path22.join(latestScriptsDir, file), "utf-8");
+            const content = fs14.readFileSync(path21.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u{1F512}`);
             lines.push("```javascript");
             lines.push(content);
@@ -22856,10 +23168,10 @@ var DevServer = class _DevServer {
         lines.push("");
       }
     }
-    const docsDir = path22.join(providerDir, "../../docs");
+    const docsDir = path21.join(providerDir, "../../docs");
     const loadGuide = (name) => {
       try {
-        const p = path22.join(docsDir, name);
+        const p = path21.join(docsDir, name);
         if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
       } catch {
       }