@morphllm/morphsdk 0.2.8 → 0.2.14

package/dist/client.js

@@ -1,12 +1,12 @@
 import {
   MorphClient
-} from "./chunk-BWI43OMO.js";
-import "./chunk-AKVAAKRB.js";
+} from "./chunk-C2TYLJRK.js";
 import "./chunk-VJK4PH5V.js";
+import "./chunk-4V46N27D.js";
+import "./chunk-OWXIAZUZ.js";
 import "./chunk-74ZHKB54.js";
 import "./chunk-5VQEQSJQ.js";
-import "./chunk-4V46N27D.js";
-import "./chunk-4UVEBIDK.js";
+import "./chunk-AKVAAKRB.js";
 import "./chunk-4VWJFZVS.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/index.cjs

@@ -369,6 +369,82 @@ async function executeCodebaseSearch(input, config) {
   }
 }
 
+// tools/browser/live.ts
+var LIVE_PRESETS = {
+  /** Read-only monitoring (no interaction) */
+  readonly: { interactive: false },
+  /** Interactive control (human-in-the-loop) */
+  interactive: { interactive: true },
+  /** Watch-only without controls */
+  monitoring: { interactive: false, showControls: false }
+};
+function buildLiveUrl(debugUrl, options = {}) {
+  if (!debugUrl) {
+    throw new Error(
+      "debugUrl is required. Ensure your backend returns debugUrl in the task response. Contact support@morphllm.com if you need help."
+    );
+  }
+  const url = new URL(debugUrl);
+  if (options.interactive !== void 0) {
+    url.searchParams.set("interactive", String(options.interactive));
+  }
+  if (options.theme) {
+    url.searchParams.set("theme", options.theme);
+  }
+  if (options.showControls !== void 0) {
+    url.searchParams.set("showControls", String(options.showControls));
+  }
+  if (options.pageId) {
+    url.searchParams.set("pageId", options.pageId);
+  }
+  if (options.pageIndex) {
+    url.searchParams.set("pageIndex", options.pageIndex);
+  }
+  return url.toString();
+}
+function buildLiveIframe(debugUrl, options = {}) {
+  const {
+    width = "100%",
+    height = "600px",
+    style = "",
+    className = "",
+    ...sessionOptions
+  } = options;
+  const src = buildLiveUrl(debugUrl, sessionOptions);
+  const widthStr = typeof width === "number" ? `${width}px` : width;
+  const heightStr = typeof height === "number" ? `${height}px` : height;
+  const baseStyle = `width: ${widthStr}; height: ${heightStr}; border: none;`;
+  const fullStyle = style ? `${baseStyle} ${style}` : baseStyle;
+  const attributes = [
+    `src="${src}"`,
+    `style="${fullStyle}"`
+  ];
+  if (className) {
+    attributes.push(`class="${className}"`);
+  }
+  return `<iframe ${attributes.join(" ")}></iframe>`;
+}
+function buildEmbedCode(debugUrl, options = {}) {
+  const iframe = buildLiveIframe(debugUrl, options);
+  return `<!-- Embed Morph Live Session -->
+${iframe}`;
+}
+function resolvePreset(optionsOrPreset) {
+  if (!optionsOrPreset) {
+    return {};
+  }
+  if (typeof optionsOrPreset === "string") {
+    const preset = LIVE_PRESETS[optionsOrPreset];
+    if (!preset) {
+      throw new Error(
+        `Unknown preset: ${optionsOrPreset}. Available presets: ${Object.keys(LIVE_PRESETS).join(", ")}`
+      );
+    }
+    return preset;
+  }
+  return optionsOrPreset;
+}
+
 // tools/browser/core.ts
 var DEFAULT_CONFIG2 = {
   apiUrl: process.env.MORPH_ENVIRONMENT === "DEV" ? "http://localhost:8000" : "https://browser.morphllm.com",
@@ -439,10 +515,16 @@ async function executeBrowserTask(input, config = {}) {
   const timeout = config.timeout || DEFAULT_CONFIG2.timeout;
   const debug = config.debug || false;
   if (!input.task || input.task.trim().length === 0) {
-    return { success: false, error: "Task description is required" };
+    return {
+      success: false,
+      error: 'Task description is required. Example: "Go to example.com and click the login button"'
+    };
   }
   if (input.max_steps !== void 0 && (input.max_steps < 1 || input.max_steps > 50)) {
-    return { success: false, error: "max_steps must be between 1 and 50" };
+    return {
+      success: false,
+      error: "max_steps must be between 1 and 50. Use more steps for complex multi-page flows."
+    };
   }
   if (debug) {
     console.log(`[Browser] Task: "${input.task.slice(0, 60)}..." url=${input.url || "none"} maxSteps=${input.max_steps ?? 10}`);
@@ -495,7 +577,7 @@ async function executeBrowserTask(input, config = {}) {
       if (error.message.includes("ECONNREFUSED") || error.message.includes("fetch failed")) {
         return {
           success: false,
-          error: `Cannot connect to browser worker at ${apiUrl}. Ensure the service is running.`
+          error: `Cannot connect to browser worker at ${apiUrl}. Ensure the service is running and accessible. For local dev, set MORPH_ENVIRONMENT=DEV.`
         };
       }
       return {
@@ -660,7 +742,7 @@ function wrapTaskResponse(result, config) {
   if (!result.task_id) {
     throw new Error("task_id is required to wrap response");
   }
-  return {
+  const wrapped = {
     ...result,
     task_id: result.task_id,
     liveUrl: generateLiveUrl(result.task_id, config),
@@ -668,13 +750,42 @@ function wrapTaskResponse(result, config) {
       return pollTaskUntilComplete(result.task_id, config, pollConfig);
     }
   };
+  if (result.debugUrl) {
+    wrapped.getLiveUrl = (options) => {
+      return buildLiveUrl(result.debugUrl, options);
+    };
+    wrapped.getLiveIframe = (optionsOrPreset) => {
+      const options = resolvePreset(optionsOrPreset);
+      return buildLiveIframe(result.debugUrl, options);
+    };
+    wrapped.getEmbedCode = () => {
+      return buildEmbedCode(result.debugUrl);
+    };
+  } else {
+    wrapped.getLiveUrl = () => {
+      throw new Error(
+        "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help."
+      );
+    };
+    wrapped.getLiveIframe = () => {
+      throw new Error(
+        "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help."
+      );
+    };
+    wrapped.getEmbedCode = () => {
+      throw new Error(
+        "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help."
+      );
+    };
+  }
+  return wrapped;
 }
 function wrapTaskResponseWithSchema(result, config, schema) {
   if (!result.task_id) {
     throw new Error("task_id is required to wrap response");
   }
   const parsed = result.output ? parseStructuredTaskOutput(result, schema) : { ...result, parsed: null };
-  return {
+  const wrapped = {
     ...parsed,
     task_id: result.task_id,
     liveUrl: generateLiveUrl(result.task_id, config),
@@ -683,6 +794,35 @@ function wrapTaskResponseWithSchema(result, config, schema) {
       return parseStructuredTaskOutput(finalResult, schema);
     }
   };
+  if (result.debugUrl) {
+    wrapped.getLiveUrl = (options) => {
+      return buildLiveUrl(result.debugUrl, options);
+    };
+    wrapped.getLiveIframe = (optionsOrPreset) => {
+      const options = resolvePreset(optionsOrPreset);
+      return buildLiveIframe(result.debugUrl, options);
+    };
+    wrapped.getEmbedCode = () => {
+      return buildEmbedCode(result.debugUrl);
+    };
+  } else {
+    wrapped.getLiveUrl = () => {
+      throw new Error(
+        "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help enabling live sessions. "
+      );
+    };
+    wrapped.getLiveIframe = () => {
+      throw new Error(
+        "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help enabling live sessions."
+      );
+    };
+    wrapped.getEmbedCode = () => {
+      throw new Error(
+        "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help enabling live sessions."
+      );
+    };
+  }
+  return wrapped;
 }
 async function checkHealth(config = {}) {
   const apiUrl = config.apiUrl || DEFAULT_CONFIG2.apiUrl;