opendevbrowser 0.0.24 → 0.0.26

package/dist/inspiredesign/brief-expansion.d.ts

@@ -0,0 +1,41 @@
+import type { CanvasNavigationModel, CanvasThemeStrategy, CanvasVisualDirectionProfile } from "../canvas/types";
+type InspiredesignBriefFormatRoute = {
+    profile: CanvasVisualDirectionProfile;
+    themeStrategy: CanvasThemeStrategy;
+    navigationModel: CanvasNavigationModel;
+    layoutApproach: string;
+};
+export type InspiredesignBriefFormat = {
+    id: string;
+    label: string;
+    bestFor: string[];
+    businessFocus: string[];
+    keywords: string[];
+    archetype: string;
+    layoutArchetype: string;
+    typographySystem: string;
+    surfaceTreatment: string;
+    shapeLanguage: string;
+    componentGrammar: string;
+    motionGrammar: string;
+    paletteIntent: string;
+    visualDensity: string;
+    designVariance: string;
+    responsiveCollapseRules: string[];
+    guardrails: string[];
+    antiPatterns: string[];
+    deliverables: string[];
+    route: InspiredesignBriefFormatRoute;
+};
+export type InspiredesignBriefExpansion = {
+    sourceBrief: string;
+    advancedBrief: string;
+    templateVersion: string;
+    format: InspiredesignBriefFormat;
+};
+export declare const INSPIREDESIGN_BRIEF_TEMPLATE_VERSION: string;
+export declare const normalizeInspiredesignBriefText: (value: string) => string;
+export declare const cloneInspiredesignBriefFormat: (format: InspiredesignBriefFormat) => InspiredesignBriefFormat;
+export declare const expandInspiredesignBrief: (brief: string, preferredFormatId?: string) => InspiredesignBriefExpansion;
+export {};
+//# sourceMappingURL=brief-expansion.d.ts.map

package/dist/inspiredesign/brief-expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-expansion.d.ts","sourceRoot":"","sources":["../../src/inspiredesign/brief-expansion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAUzB,KAAK,6BAA6B,GAAG;IACnC,OAAO,EAAE,4BAA4B,CAAC;IACtC,aAAa,EAAE,mBAAmB,CAAC;IACnC,eAAe,EAAE,qBAAqB,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAoCF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,6BAA6B,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC;AAGF,eAAO,MAAM,oCAAoC,QAAyB,CAAC;AAE3E,eAAO,MAAM,+BAA+B,GAAI,OAAO,MAAM,KAAG,MAA2C,CAAC;AAqB5G,eAAO,MAAM,6BAA6B,GACxC,QAAQ,wBAAwB,KAC/B,wBAqBD,CAAC;AAkJH,eAAO,MAAM,wBAAwB,GACnC,OAAO,MAAM,EACb,oBAAoB,MAAM,KACzB,2BASF,CAAC"}

package/dist/inspiredesign/handoff.d.ts

@@ -1,5 +1,6 @@
 export declare const INSPIREDESIGN_HANDOFF_FILES: {
     readonly designMarkdown: "design.md";
+    readonly advancedBrief: "advanced-brief.md";
     readonly designContract: "design-contract.json";
     readonly canvasPlanRequest: "canvas-plan.request.json";
     readonly designAgentHandoff: "design-agent-handoff.json";
@@ -26,8 +27,9 @@ export declare const INSPIREDESIGN_HANDOFF_COMMANDS: {
 };
 export declare const INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS: readonly [string, string];
 export declare const INSPIREDESIGN_HANDOFF_GUIDANCE: {
+    readonly reviewAdvancedBrief: "advanced-brief.md is the authoritative prompt route for the selected format, profile defaults, layout posture, motion grammar, and anti-patterns. Read it before touching Canvas or implementation files.";
     readonly prepareCanvasPlanRequest: "Fill canvasSessionId, leaseId, and documentId in canvas-plan.request.json before running opendevbrowser canvas --command canvas.plan.set --params-file ./canvas-plan.request.json.";
-    readonly deepCaptureRecommendation: "Rerun inspiredesign with captureMode=deep only when you need richer evidence for visual hierarchy, protected references, or capture-specific debugging.";
+    readonly deepCaptureRecommendation: "Any inspiredesign run with reference URLs already uses captureMode=deep. Rerun with the same URLs only when you need refreshed DOM/layout evidence, restored session state, or capture-specific debugging.";
 };
 export declare const buildInspiredesignFollowthroughSummary: () => string;
 export declare const buildInspiredesignNextStep: () => string;

package/dist/inspiredesign/handoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/inspiredesign/handoff.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B;;;;;;;;;;CAU9B,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;;;;;;;CAS/B,CAAC;AAaX,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX,eAAO,MAAM,wCAAwC,2BAG3C,CAAC;AAEX,eAAO,MAAM,8BAA8B;;;CAGjC,CAAC;AAEX,eAAO,MAAM,sCAAsC,QAAO,MAEzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAO,MAE7C,CAAC"}
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/inspiredesign/handoff.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B;;;;;;;;;;;CAW9B,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;;;;;;;CAS/B,CAAC;AAaX,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX,eAAO,MAAM,wCAAwC,2BAG3C,CAAC;AAEX,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX,eAAO,MAAM,sCAAsC,QAAO,MAEzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAO,MAE7C,CAAC"}

package/dist/opendevbrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAuClD,QAAA,MAAM,oBAAoB,EAAE,MAsQ3B,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA8ClD,QAAA,MAAM,oBAAoB,EAAE,MAmW3B,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/opendevbrowser.js

@@ -1,5 +1,7 @@
 import {
   AGENT_INBOX_SYSTEM_MARKER,
+  DEFAULT_DAEMON_STATUS_FETCH_OPTIONS,
+  DEFAULT_WORKFLOW_TRANSPORT_TIMEOUT_MS,
   DaemonClient,
   ScriptRunner,
   buildAnnotateResult,
@@ -10,19 +12,22 @@ import {
   classifySessionRelayEndpoint,
   createAutomationCoordinator,
   createCoreRuntimeAssemblies,
+  createDaemonStopHeaders,
   createOpenDevBrowserCore,
   executeMacroWithRuntime,
   extractExtension,
+  fetchDaemonStatus,
   fetchDaemonStatusFromMetadata,
-  getCurrentDaemonFingerprint,
+  fetchWithTimeout,
   inspectSession,
+  isCurrentDaemonFingerprint,
   onboarding_metadata_default,
   readDaemonMetadata,
   requireChallengeOrchestrationConfig,
   resolveBundledProviderRuntime,
   resolveSessionRelayRoute,
   startDaemon
-} from "./chunk-5I6TZRVS.js";
+} from "./chunk-GTTYIAI7.js";
 import "./chunk-STGGGVYT.js";
 import "./chunk-3ILXPKSJ.js";
 import "./chunk-TBUCZX4A.js";
@@ -32,8 +37,9 @@ import {
   buildBlockerArtifacts,
   buildMacroResolveSuccessHandoff,
   classifyBlockerSignal,
-  createRequestId
-} from "./chunk-K2TEHJCV.js";
+  createRequestId,
+  resolveInspiredesignCaptureMode
+} from "./chunk-AVQL6WAS.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/remote-manager.ts
@@ -42,8 +48,18 @@ var RemoteManager = class {
   constructor(client) {
     this.client = client;
   }
-  launch(options) {
-    return this.client.call("session.launch", options);
+  callWithOptionalTimeout(name, params, timeoutMs) {
+    if (typeof timeoutMs === "number") {
+      return this.client.call(name, params, { timeoutMs });
+    }
+    return this.client.call(name, params);
+  }
+  launch(options, timeoutMs) {
+    return this.callWithOptionalTimeout(
+      "session.launch",
+      options,
+      timeoutMs
+    );
   }
   connect(options) {
     return this.client.call("session.connect", options);
@@ -66,20 +82,20 @@ var RemoteManager = class {
   status(sessionId) {
     return this.client.call("session.status", { sessionId });
   }
-  cookieImport(sessionId, cookies, strict = true, requestId) {
-    return this.client.call("session.cookieImport", {
+  cookieImport(sessionId, cookies, strict = true, requestId, timeoutMs) {
+    return this.callWithOptionalTimeout("session.cookieImport", {
       sessionId,
       cookies,
       strict,
       requestId
-    });
+    }, timeoutMs);
   }
-  cookieList(sessionId, urls, requestId) {
-    return this.client.call("session.cookieList", {
+  cookieList(sessionId, urls, requestId, timeoutMs) {
+    return this.callWithOptionalTimeout("session.cookieList", {
       sessionId,
       ...urls && urls.length > 0 ? { urls } : {},
       requestId
-    });
+    }, timeoutMs);
   }
   goto(sessionId, url, waitUntil = "load", timeoutMs = 3e4, _sessionOverride, targetId) {
     return this.client.call("nav.goto", {
@@ -107,14 +123,14 @@ var RemoteManager = class {
       ...typeof targetId === "string" ? { targetId } : {}
     });
   }
-  snapshot(sessionId, mode, maxChars, cursor, targetId) {
-    return this.client.call("nav.snapshot", {
+  snapshot(sessionId, mode, maxChars, cursor, targetId, timeoutMs) {
+    return this.callWithOptionalTimeout("nav.snapshot", {
       sessionId,
       mode,
       maxChars,
       cursor,
       ...typeof targetId === "string" ? { targetId } : {}
-    });
+    }, timeoutMs);
   }
   click(sessionId, ref, targetId) {
     return this.client.call("interact.click", {
@@ -237,11 +253,19 @@ var RemoteManager = class {
       ...typeof targetId === "string" ? { targetId } : {}
     });
   }
-  clonePage(sessionId, targetId) {
-    return this.client.call("export.clonePage", {
+  clonePage(sessionId, targetId, timeoutMs) {
+    return this.callWithOptionalTimeout("export.clonePage", {
       sessionId,
       ...typeof targetId === "string" ? { targetId } : {}
-    });
+    }, timeoutMs);
+  }
+  clonePageHtmlWithOptions(sessionId, targetId, options, timeoutMs) {
+    return this.callWithOptionalTimeout("export.clonePageHtml", {
+      sessionId,
+      ...typeof targetId === "string" ? { targetId } : {},
+      ...typeof options?.maxNodes === "number" ? { maxNodes: options.maxNodes } : {},
+      ...typeof options?.inlineStyles === "boolean" ? { inlineStyles: options.inlineStyles } : {}
+    }, timeoutMs);
   }
   cloneComponent(sessionId, ref, targetId) {
     return this.client.call("export.cloneComponent", {
@@ -1055,7 +1079,7 @@ function createStatusTool(deps) {
         let updateHint;
         let sessionStatus = null;
         if (hubEnabled) {
-          const daemonStatus = await fetchDaemonStatusFromMetadata();
+          const daemonStatus = await fetchDaemonStatusFromMetadata(config, DEFAULT_DAEMON_STATUS_FETCH_OPTIONS);
           if (!daemonStatus) {
             return failure("Daemon not running. Start with `npx opendevbrowser serve`.", "status_failed");
           }
@@ -3168,7 +3192,7 @@ function createResearchRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runResearchWorkflow } = await import("./providers-6YVHKTOJ.js");
+        const { runResearchWorkflow } = await import("./providers-T2FQJCF6.js");
         const result = await runResearchWorkflow(runtime, {
           topic: args.topic,
           days: args.days,
@@ -3219,7 +3243,7 @@ function createShoppingRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runShoppingWorkflow } = await import("./providers-6YVHKTOJ.js");
+        const { runShoppingWorkflow } = await import("./providers-T2FQJCF6.js");
         const result = await runShoppingWorkflow(runtime, {
           query: args.query,
           providers: args.providers,
@@ -3288,7 +3312,7 @@ function createProductVideoRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runProductVideoWorkflow } = await import("./providers-6YVHKTOJ.js");
+        const { runProductVideoWorkflow } = await import("./providers-T2FQJCF6.js");
         const includeScreenshots = args.include_screenshots ?? true;
         const result = await runProductVideoWorkflow(runtime, {
           product_url: args.product_url,
@@ -3327,7 +3351,7 @@ function createInspiredesignRunTool(deps) {
     args: {
       brief: z66.string().min(1).describe("Inspiredesign brief"),
       urls: z66.array(z66.string()).optional().describe("Inspiration URLs to analyze"),
-      captureMode: captureModeSchema.optional().describe("Capture mode: off|deep"),
+      captureMode: captureModeSchema.optional().describe("Capture mode: off|deep. Any URLs force deep."),
       includePrototypeGuidance: z66.boolean().optional().describe("Include prototype guidance output"),
       mode: modeSchema3.optional().describe("compact|json|md|context|path"),
       timeoutMs: z66.number().int().positive().optional().describe("Workflow timeout in milliseconds"),
@@ -3340,8 +3364,8 @@ function createInspiredesignRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runInspiredesignWorkflow } = await import("./providers-6YVHKTOJ.js");
-        const captureMode = args.captureMode ?? "off";
+        const { runInspiredesignWorkflow } = await import("./providers-T2FQJCF6.js");
+        const captureMode = resolveInspiredesignCaptureMode(args.captureMode, args.urls);
         const cookieSource = deps.config.get().providers?.cookieSource;
         const result = await runInspiredesignWorkflow(runtime, {
           brief: args.brief,
@@ -3349,7 +3373,7 @@ function createInspiredesignRunTool(deps) {
           captureMode,
           includePrototypeGuidance: args.includePrototypeGuidance,
           mode: args.mode ?? "compact",
-          timeoutMs: args.timeoutMs,
+          timeoutMs: args.timeoutMs ?? DEFAULT_WORKFLOW_TRANSPORT_TIMEOUT_MS,
           outputDir: args.outputDir,
           ttlHours: args.ttlHours,
           useCookies: args.useCookies,
@@ -3453,7 +3477,9 @@ function createTools(deps) {
       execute: async (args, context) => {
         try {
           await deps.ensureHub?.();
-        } catch {
+        } catch (error) {
+          const serialized = serializeError(error);
+          return failure(serialized.message, serialized.code ?? "hub_unavailable", serialized.details);
         }
         return definition.execute(args, context);
       }
@@ -3623,6 +3649,69 @@ var OpenDevBrowserPlugin = async ({ directory, worktree }) => {
     toolDeps.providerRuntime = providerRuntime;
     toolDeps.browserFallbackPort = browserFallbackPort;
   };
+  const readEnsureHubBudgetMs = (deadlineMs) => {
+    const remainingMs = deadlineMs - Date.now();
+    return remainingMs > 0 ? remainingMs : null;
+  };
+  const stopTimeoutMs = (deadlineMs) => {
+    return Math.max(1, Math.min(500, readEnsureHubBudgetMs(deadlineMs) ?? 1));
+  };
+  const resolveHubStopConnection = (currentConfig, status) => {
+    const metadata = readDaemonMetadata();
+    if (metadata?.pid === status.pid) {
+      return { port: metadata.port, token: metadata.token };
+    }
+    return { port: currentConfig.daemonPort, token: currentConfig.daemonToken };
+  };
+  const isConfiguredHubConnection = (currentConfig, connection) => {
+    return connection.port === currentConfig.daemonPort && connection.token === currentConfig.daemonToken;
+  };
+  const waitForHubDaemonShutdown = async (connection, deadlineMs) => {
+    while (readEnsureHubBudgetMs(deadlineMs)) {
+      const status = await fetchDaemonStatus(connection.port, connection.token, {
+        timeoutMs: stopTimeoutMs(deadlineMs)
+      });
+      if (!status?.ok) {
+        return true;
+      }
+      await new Promise((resolve) => setTimeout(resolve, Math.min(100, stopTimeoutMs(deadlineMs))));
+    }
+    return false;
+  };
+  const stopMismatchedHubDaemon = async (currentConfig, status, deadlineMs) => {
+    const connection = resolveHubStopConnection(currentConfig, status);
+    const configuredConnection = isConfiguredHubConnection(currentConfig, connection);
+    let response;
+    try {
+      response = await fetchWithTimeout(`http://127.0.0.1:${connection.port}/stop`, {
+        method: "POST",
+        headers: createDaemonStopHeaders(connection.token, "plugin.ensureHub.upgrade")
+      }, stopTimeoutMs(deadlineMs));
+    } catch (error) {
+      if (!configuredConnection) {
+        return;
+      }
+      throw error instanceof Error ? error : new Error(String(error));
+    }
+    if (response.status === 409) {
+      if (!configuredConnection) {
+        return;
+      }
+      throw new Error(`Hub daemon on 127.0.0.1:${connection.port} pid=${status.pid} is protected by a different opendevbrowser build.`);
+    }
+    if (!response.ok) {
+      if (!configuredConnection) {
+        return;
+      }
+      throw new Error(`Hub daemon stop failed with status ${response.status}.`);
+    }
+    if (!await waitForHubDaemonShutdown(connection, deadlineMs)) {
+      if (!configuredConnection) {
+        return;
+      }
+      throw new Error(`Timed out waiting for hub daemon on 127.0.0.1:${connection.port} to stop.`);
+    }
+  };
   const ensureHub = async () => {
     const currentConfig = configStore.get();
     if (!isHubEnabled(currentConfig)) {
@@ -3634,29 +3723,26 @@ var OpenDevBrowserPlugin = async ({ directory, worktree }) => {
     const deadline = Date.now() + 2e3;
     let attempt = 0;
     let lastError = null;
-    const currentFingerprint = getCurrentDaemonFingerprint();
     while (attempt < 2 && Date.now() < deadline) {
       attempt += 1;
-      const status = await fetchDaemonStatusFromMetadata(currentConfig);
-      if (status?.ok && status.fingerprint === currentFingerprint) {
-        bindRemote();
-        await relay?.refresh?.();
-        return;
+      const statusTimeoutMs = readEnsureHubBudgetMs(deadline);
+      if (!statusTimeoutMs) {
+        break;
       }
+      const status = await fetchDaemonStatusFromMetadata(currentConfig, {
+        ...DEFAULT_DAEMON_STATUS_FETCH_OPTIONS,
+        timeoutMs: statusTimeoutMs
+      });
       if (status?.ok) {
-        const metadata = readDaemonMetadata();
-        const daemonPort = metadata?.port ?? currentConfig.daemonPort;
-        const daemonToken = metadata?.token ?? currentConfig.daemonToken;
-        if (daemonPort > 0 && daemonToken) {
-          try {
-            await fetch(`http://127.0.0.1:${daemonPort}/stop`, {
-              method: "POST",
-              headers: { Authorization: `Bearer ${daemonToken}` }
-            });
-          } catch (error) {
-            lastError = error instanceof Error ? error : new Error(String(error));
-          }
+        if (isCurrentDaemonFingerprint(status.fingerprint)) {
+          bindRemote();
+          await relay?.refresh?.();
+          return;
         }
+        await stopMismatchedHubDaemon(currentConfig, status, deadline);
+      }
+      if (!readEnsureHubBudgetMs(deadline)) {
+        break;
       }
       try {
         const { stop } = await startDaemon({ config: currentConfig, directory, worktree });
@@ -3664,6 +3750,22 @@ var OpenDevBrowserPlugin = async ({ directory, worktree }) => {
       } catch (error) {
         lastError = error instanceof Error ? error : new Error(String(error));
       }
+      const refreshedTimeoutMs = readEnsureHubBudgetMs(deadline);
+      if (!refreshedTimeoutMs) {
+        break;
+      }
+      const refreshedStatus = await fetchDaemonStatusFromMetadata(currentConfig, {
+        ...DEFAULT_DAEMON_STATUS_FETCH_OPTIONS,
+        timeoutMs: refreshedTimeoutMs
+      });
+      if (refreshedStatus?.ok) {
+        if (isCurrentDaemonFingerprint(refreshedStatus.fingerprint)) {
+          bindRemote();
+          await relay?.refresh?.();
+          return;
+        }
+        await stopMismatchedHubDaemon(currentConfig, refreshedStatus, deadline);
+      }
       if (Date.now() < deadline) {
         await new Promise((resolve) => setTimeout(resolve, 500));
       }
@@ -3676,7 +3778,6 @@ var OpenDevBrowserPlugin = async ({ directory, worktree }) => {
   toolDeps.ensureHub = ensureHub;
   const hubEnabled = isHubEnabled(config);
   if (hubEnabled) {
-    bindRemote();
     try {
       await ensureHub();
     } catch (error) {