overlord-cli 0.2608132027.0 → 0.2608141252.0

package/dist/index.js

@@ -16556,12 +16556,88 @@ var init_latch_environment = __esm({
   }
 });
 
-// ../packages/core/dist/service/latch-launch.js
+// ../packages/core/dist/service/terminal-profile-types.js
+function parseViewerOpenAs(value) {
+  return typeof value === "string" && value.trim().toLowerCase() === "tab" ? "tab" : DEFAULT_VIEWER_OPEN_AS;
+}
 function trimmed(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
+function viewerKindForLauncher(launcher) {
+  const value = trimmed(launcher);
+  if (!value)
+    return "inline";
+  const lowered = value.toLowerCase();
+  if (lowered === "iterm2" || lowered === "iterm")
+    return "iterm";
+  if (lowered === "terminal")
+    return "terminal";
+  return "custom";
+}
+function normalizeExecutionProvider(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return null;
+  const cast = value;
+  const kind = trimmed(cast.kind)?.toLowerCase() === "latch" ? "latch" : "direct";
+  return {
+    kind,
+    executable: trimmed(cast.executable) ?? DEFAULT_LATCH_EXECUTABLE
+  };
+}
+function launchSessionSnapshotFromMetadata(metadata) {
+  const raw = metadata?.[LAUNCH_SESSION_METADATA_KEY];
+  if (!raw || typeof raw !== "object" || Array.isArray(raw))
+    return null;
+  const cast = raw;
+  if (cast.version !== TERMINAL_PROFILE_VERSION)
+    return null;
+  const viewer = cast.viewer && typeof cast.viewer === "object" && !Array.isArray(cast.viewer) ? cast.viewer : null;
+  const launcher = trimmed(viewer?.launcher);
+  const source = (value) => trimmed(value) === "target" ? "target" : "user_default";
+  return {
+    version: TERMINAL_PROFILE_VERSION,
+    executionProvider: normalizeExecutionProvider(cast.executionProvider) ?? {
+      ...DEFAULT_EXECUTION_PROVIDER
+    },
+    viewer: {
+      kind: trimmed(viewer?.kind) ? trimmed(viewer?.kind) : viewerKindForLauncher(launcher),
+      launcher,
+      openOnLaunch: viewer?.openOnLaunch !== false,
+      // A snapshot frozen before `openAs` existed carries none; `window` is what
+      // those runs actually did, so the absent case must not become `tab`.
+      openAs: parseViewerOpenAs(viewer?.openAs)
+    },
+    executionProviderSource: source(cast.executionProviderSource),
+    viewerOpenSource: source(cast.viewerOpenSource),
+    resolvedAt: trimmed(cast.resolvedAt) ?? ""
+  };
+}
+var DEFAULT_VIEWER_OPEN_AS, TERMINAL_PROFILE_VERSION, DEFAULT_LATCH_EXECUTABLE, DEFAULT_EXECUTION_PROVIDER, DEFAULT_OPEN_VIEWER_ON_LAUNCH, DEFAULT_LAUNCH_SESSION_DEFAULTS, LAUNCH_SESSION_METADATA_KEY;
+var init_terminal_profile_types2 = __esm({
+  "../packages/core/dist/service/terminal-profile-types.js"() {
+    "use strict";
+    DEFAULT_VIEWER_OPEN_AS = "window";
+    TERMINAL_PROFILE_VERSION = 1;
+    DEFAULT_LATCH_EXECUTABLE = "latch";
+    DEFAULT_EXECUTION_PROVIDER = {
+      kind: "direct",
+      executable: DEFAULT_LATCH_EXECUTABLE
+    };
+    DEFAULT_OPEN_VIEWER_ON_LAUNCH = true;
+    DEFAULT_LAUNCH_SESSION_DEFAULTS = {
+      executionProvider: { ...DEFAULT_EXECUTION_PROVIDER },
+      openViewerOnLaunch: DEFAULT_OPEN_VIEWER_ON_LAUNCH
+    };
+    LAUNCH_SESSION_METADATA_KEY = "launchSession";
+  }
+});
+
+// ../packages/core/dist/service/latch-launch.js
+function trimmed2(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
 function buildLatchCreateManifest({ commandString, shell = process.env.SHELL?.trim() || "/bin/bash", cwd, env, size = DEFAULT_LATCH_TERMINAL_SIZE, title, name, commandLabel, externalRunId }) {
-  const shellPath = trimmed(shell) ?? "/bin/bash";
+  const shellPath = trimmed2(shell) ?? "/bin/bash";
   const cleanedEnv = {};
   for (const [key, value] of Object.entries(env)) {
     if (key.trim() && typeof value === "string")
@@ -16570,15 +16646,15 @@ function buildLatchCreateManifest({ commandString, shell = process.env.SHELL?.tr
   const display = {
     source: {
       kind: "overlord",
-      ...trimmed(externalRunId) ? { external_run_id: trimmed(externalRunId) } : {}
+      ...trimmed2(externalRunId) ? { external_run_id: trimmed2(externalRunId) } : {}
     }
   };
-  if (trimmed(title))
-    display.title = trimmed(title);
-  if (trimmed(name))
-    display.name = trimmed(name);
-  if (trimmed(commandLabel))
-    display.command_label = trimmed(commandLabel);
+  if (trimmed2(title))
+    display.title = trimmed2(title);
+  if (trimmed2(name))
+    display.name = trimmed2(name);
+  if (trimmed2(commandLabel))
+    display.command_label = trimmed2(commandLabel);
   return {
     format_version: LATCH_MANIFEST_FORMAT_VERSION,
     launch: {
@@ -16597,7 +16673,7 @@ function buildLatchCreateManifest({ commandString, shell = process.env.SHELL?.tr
 function parseLatchCreateReport(raw) {
   try {
     const parsed = JSON.parse(raw);
-    const id = trimmed(parsed.session?.id);
+    const id = trimmed2(parsed.session?.id);
     if (!id)
       return null;
     const protocolVersion = typeof parsed.protocolVersion === "number" && Number.isFinite(parsed.protocolVersion) ? parsed.protocolVersion : LATCH_MANIFEST_FORMAT_VERSION;
@@ -16605,9 +16681,9 @@ function parseLatchCreateReport(raw) {
       protocolVersion,
       session: {
         id,
-        name: trimmed(parsed.session?.name) ?? id,
-        state: trimmed(parsed.session?.state) ?? "running",
-        createdAt: trimmed(parsed.session?.createdAt) ?? (/* @__PURE__ */ new Date()).toISOString()
+        name: trimmed2(parsed.session?.name) ?? id,
+        state: trimmed2(parsed.session?.state) ?? "running",
+        createdAt: trimmed2(parsed.session?.createdAt) ?? (/* @__PURE__ */ new Date()).toISOString()
       }
     };
   } catch {
@@ -16619,28 +16695,28 @@ function toExecutionProviderSession({ createReport, executionTargetId, createdAt
     provider: "latch",
     providerSessionId: createReport.session.id,
     sessionName: createReport.session.name,
-    executionTargetId: trimmed(executionTargetId),
+    executionTargetId: trimmed2(executionTargetId),
     agentSessionId: null,
     createdAt: createdAt ?? createReport.session.createdAt,
     lastObservedState: createReport.session.state
   };
 }
 function existingLatchProviderSession({ latchSessionId, executionTargetId, createdAt = (/* @__PURE__ */ new Date()).toISOString() }) {
-  const providerSessionId = trimmed(latchSessionId);
+  const providerSessionId = trimmed2(latchSessionId);
   if (!providerSessionId)
     return null;
   return {
     provider: "latch",
     providerSessionId,
     sessionName: null,
-    executionTargetId: trimmed(executionTargetId),
+    executionTargetId: trimmed2(executionTargetId),
     agentSessionId: null,
     createdAt,
     lastObservedState: "running"
   };
 }
 function latchViewerFlagForKind(kind) {
-  switch (trimmed(kind)?.toLowerCase()) {
+  switch (trimmed2(kind)?.toLowerCase()) {
     case "iterm":
     case "iterm2":
       return "iterm";
@@ -16648,28 +16724,59 @@ function latchViewerFlagForKind(kind) {
       return null;
   }
 }
+function compareLatchProductVersions(a, b) {
+  const parts = (value) => value.trim().split(".").map((segment) => {
+    const parsed = Number.parseInt(segment, 10);
+    return Number.isFinite(parsed) ? parsed : 0;
+  });
+  const left = parts(a);
+  const right = parts(b);
+  const length = Math.max(left.length, right.length);
+  for (let index = 0; index < length; index += 1) {
+    const diff = (left[index] ?? 0) - (right[index] ?? 0);
+    if (diff !== 0)
+      return diff;
+  }
+  return 0;
+}
+function latchSupportsOpenAs(productVersion) {
+  const version = trimmed2(productVersion);
+  if (!version)
+    return false;
+  return compareLatchProductVersions(version, LATCH_OPEN_AS_MIN_PRODUCT_VERSION) >= 0;
+}
+function buildLatchOpenArgs({ providerSessionId, viewer, openAs, productVersion }) {
+  const args = ["open", providerSessionId, "--with", viewer];
+  if (openAs && latchSupportsOpenAs(productVersion)) {
+    args.push("--as", parseViewerOpenAs(openAs));
+  }
+  args.push("--json");
+  return args;
+}
 function latchAttachCommand({ executable = "latch", providerSessionId }) {
-  return `${trimmed(executable) ?? "latch"} attach ${providerSessionId}`;
+  return `${trimmed2(executable) ?? "latch"} attach ${providerSessionId}`;
 }
 function shouldUseLatchProvider({ providerKind, latchSelectable }) {
-  return trimmed(providerKind)?.toLowerCase() === "latch" && latchSelectable === true;
+  return trimmed2(providerKind)?.toLowerCase() === "latch" && latchSelectable === true;
 }
-var LATCH_MANIFEST_FORMAT_VERSION, DEFAULT_LATCH_TERMINAL_SIZE;
+var LATCH_MANIFEST_FORMAT_VERSION, DEFAULT_LATCH_TERMINAL_SIZE, LATCH_OPEN_AS_MIN_PRODUCT_VERSION;
 var init_latch_launch = __esm({
   "../packages/core/dist/service/latch-launch.js"() {
     "use strict";
+    init_terminal_profile_types2();
     LATCH_MANIFEST_FORMAT_VERSION = 1;
     DEFAULT_LATCH_TERMINAL_SIZE = { cols: 120, rows: 36 };
+    LATCH_OPEN_AS_MIN_PRODUCT_VERSION = "0.2608140931.0";
   }
 });
 
 // ../packages/core/dist/service/latch-session.js
 import { spawnSync as spawnSync2 } from "node:child_process";
-function trimmed2(value) {
+function trimmed3(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function parseState(value) {
-  switch (trimmed2(value)) {
+  switch (trimmed3(value)) {
     case "running":
       return "running";
     case "exited":
@@ -16708,11 +16815,11 @@ function runLatchJson({ executable, args }) {
   }
 }
 function inspectLatchSession({ executable = "latch", providerSessionId }) {
-  const sessionId = trimmed2(providerSessionId);
+  const sessionId = trimmed3(providerSessionId);
   if (!sessionId)
     throw new LatchSessionCommandError("A Latch session id is required.");
   const report = runLatchJson({
-    executable: trimmed2(executable) ?? "latch",
+    executable: trimmed3(executable) ?? "latch",
     args: ["inspect", sessionId, "--json"]
   });
   const state = parseState(report.state);
@@ -16720,47 +16827,61 @@ function inspectLatchSession({ executable = "latch", providerSessionId }) {
     throw new LatchSessionCommandError("Latch returned an unsupported session state.");
   const exit = report.exit && typeof report.exit === "object" && !Array.isArray(report.exit) ? report.exit : null;
   return {
-    providerSessionId: trimmed2(report.id) ?? sessionId,
-    name: trimmed2(report.name) ?? sessionId,
+    providerSessionId: trimmed3(report.id) ?? sessionId,
+    name: trimmed3(report.name) ?? sessionId,
     state,
     exitCode: typeof exit?.code === "number" && Number.isFinite(exit.code) ? exit.code : null,
     inspectedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-function openLatchSession({ executable = "latch", providerSessionId, viewerKind }) {
-  const sessionId = trimmed2(providerSessionId);
+function readLatchProductVersion(executable) {
+  try {
+    return trimmed3(runLatchJson({ executable, args: ["capabilities", "--json"] }).productVersion);
+  } catch {
+    return null;
+  }
+}
+function openLatchSession({ executable = "latch", providerSessionId, viewerKind, openAs }) {
+  const sessionId = trimmed3(providerSessionId);
   if (!sessionId)
     throw new LatchSessionCommandError("A Latch session id is required.");
   const viewer = latchViewerFlagForKind(viewerKind);
   if (!viewer) {
     throw new LatchSessionCommandError(`Latch cannot open the configured viewer "${viewerKind}".`);
   }
+  const exe = trimmed3(executable) ?? "latch";
   const report = runLatchJson({
-    executable: trimmed2(executable) ?? "latch",
-    args: ["open", sessionId, "--with", viewer, "--json"]
+    executable: exe,
+    args: buildLatchOpenArgs({
+      providerSessionId: sessionId,
+      viewer,
+      openAs,
+      productVersion: openAs ? readLatchProductVersion(exe) : null
+    })
   });
   if (report.opened !== true) {
     throw new LatchSessionCommandError(`Latch did not open the ${viewer} viewer.`);
   }
   return {
-    providerSessionId: trimmed2(report.id) ?? sessionId,
-    viewer: trimmed2(report.viewer) ?? viewer,
-    opened: true
+    providerSessionId: trimmed3(report.id) ?? sessionId,
+    viewer: trimmed3(report.viewer) ?? viewer,
+    opened: true,
+    behavior: trimmed3(report.behavior) ? parseViewerOpenAs(report.behavior) : null
   };
 }
 function stopLatchSession({ executable = "latch", providerSessionId }) {
-  const sessionId = trimmed2(providerSessionId);
+  const sessionId = trimmed3(providerSessionId);
   if (!sessionId)
     throw new LatchSessionCommandError("A Latch session id is required.");
   const report = runLatchJson({
-    executable: trimmed2(executable) ?? "latch",
+    executable: trimmed3(executable) ?? "latch",
     args: ["stop", sessionId, "--json"]
   });
   const state = parseState(report.state);
   if (!state)
     throw new LatchSessionCommandError("Latch returned an unsupported session state.");
   return {
-    providerSessionId: trimmed2(report.id) ?? sessionId,
+    providerSessionId: trimmed3(report.id) ?? sessionId,
     state
   };
 }
@@ -16770,6 +16891,7 @@ var init_latch_session = __esm({
     "use strict";
     init_latch_environment();
     init_latch_launch();
+    init_terminal_profile_types2();
     LatchSessionCommandError = class extends Error {
       constructor(message) {
         super(message);
@@ -16781,17 +16903,17 @@ var init_latch_session = __esm({
 
 // ../packages/core/dist/service/latch-events.js
 import { spawn as spawn3 } from "node:child_process";
-function trimmed3(value) {
+function trimmed4(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function parseHarnessEvent(value) {
   if (!value || typeof value !== "object" || Array.isArray(value))
     return null;
   const row = value;
-  const type = trimmed3(row.type);
-  const sessionId = trimmed3(row.sessionId);
-  const at = trimmed3(row.at);
-  const harnessVersion = trimmed3(row.harnessVersion);
+  const type = trimmed4(row.type);
+  const sessionId = trimmed4(row.sessionId);
+  const at = trimmed4(row.at);
+  const harnessVersion = trimmed4(row.harnessVersion);
   const connectorEpoch = typeof row.connectorEpoch === "number" && Number.isFinite(row.connectorEpoch) ? row.connectorEpoch : null;
   if (!type || !HARNESS_EVENT_TYPES.has(type) || !sessionId || !at || !harnessVersion)
     return null;
@@ -16802,26 +16924,26 @@ function parseHarnessEvent(value) {
     case "user_message":
     case "assistant_delta":
     case "assistant_message": {
-      const text = trimmed3(row.text);
+      const text = trimmed4(row.text);
       if (!text)
         return null;
       return { ...base, type, text };
     }
     case "tool_started": {
-      const tool = trimmed3(row.tool);
+      const tool = trimmed4(row.tool);
       if (!tool)
         return null;
       return { ...base, type, tool, input: row.input };
     }
     case "tool_finished": {
-      const tool = trimmed3(row.tool);
+      const tool = trimmed4(row.tool);
       if (!tool)
         return null;
       return { ...base, type, tool, output: row.output };
     }
     case "awaiting_input": {
-      const requestId = trimmed3(row.requestId);
-      const kind = trimmed3(row.kind);
+      const requestId = trimmed4(row.requestId);
+      const kind = trimmed4(row.kind);
       const prompt = typeof row.prompt === "string" ? row.prompt : null;
       if (!requestId || kind !== "permission" && kind !== "question" || prompt === null) {
         return null;
@@ -16837,7 +16959,7 @@ function parseHarnessEvent(value) {
       };
     }
     case "status": {
-      const status = trimmed3(row.status);
+      const status = trimmed4(row.status);
       if (!status)
         return null;
       return { ...base, type, status };
@@ -16862,11 +16984,11 @@ function parseHarnessEventNdjson(raw) {
   return events;
 }
 async function collectLatchEvents({ executable = "latch", providerSessionId, from = 0, idleMs = 250, timeoutMs = 8e3 }) {
-  const sessionId = trimmed3(providerSessionId);
+  const sessionId = trimmed4(providerSessionId);
   if (!sessionId)
     throw new LatchSessionCommandError("A Latch session id is required.");
   const fromCursor = Number.isFinite(from) && from > 0 ? Math.floor(from) : 0;
-  const bin = trimmed3(executable) ?? "latch";
+  const bin = trimmed4(executable) ?? "latch";
   return new Promise((resolve, reject) => {
     const child = spawn3(bin, ["events", sessionId, "--json", "--from", String(fromCursor)], {
       stdio: ["ignore", "pipe", "pipe"],
@@ -17281,75 +17403,6 @@ var init_git_tree = __esm({
   }
 });
 
-// ../packages/core/dist/service/terminal-profile-types.js
-function trimmed4(value) {
-  return typeof value === "string" && value.trim() ? value.trim() : null;
-}
-function viewerKindForLauncher(launcher) {
-  const value = trimmed4(launcher);
-  if (!value)
-    return "inline";
-  const lowered = value.toLowerCase();
-  if (lowered === "iterm2" || lowered === "iterm")
-    return "iterm";
-  if (lowered === "terminal")
-    return "terminal";
-  return "custom";
-}
-function normalizeExecutionProvider(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value))
-    return null;
-  const cast = value;
-  const kind = trimmed4(cast.kind)?.toLowerCase() === "latch" ? "latch" : "direct";
-  return {
-    kind,
-    executable: trimmed4(cast.executable) ?? DEFAULT_LATCH_EXECUTABLE
-  };
-}
-function launchSessionSnapshotFromMetadata(metadata) {
-  const raw = metadata?.[LAUNCH_SESSION_METADATA_KEY];
-  if (!raw || typeof raw !== "object" || Array.isArray(raw))
-    return null;
-  const cast = raw;
-  if (cast.version !== TERMINAL_PROFILE_VERSION)
-    return null;
-  const viewer = cast.viewer && typeof cast.viewer === "object" && !Array.isArray(cast.viewer) ? cast.viewer : null;
-  const launcher = trimmed4(viewer?.launcher);
-  const source = (value) => trimmed4(value) === "target" ? "target" : "user_default";
-  return {
-    version: TERMINAL_PROFILE_VERSION,
-    executionProvider: normalizeExecutionProvider(cast.executionProvider) ?? {
-      ...DEFAULT_EXECUTION_PROVIDER
-    },
-    viewer: {
-      kind: trimmed4(viewer?.kind) ? trimmed4(viewer?.kind) : viewerKindForLauncher(launcher),
-      launcher,
-      openOnLaunch: viewer?.openOnLaunch !== false
-    },
-    executionProviderSource: source(cast.executionProviderSource),
-    viewerOpenSource: source(cast.viewerOpenSource),
-    resolvedAt: trimmed4(cast.resolvedAt) ?? ""
-  };
-}
-var TERMINAL_PROFILE_VERSION, DEFAULT_LATCH_EXECUTABLE, DEFAULT_EXECUTION_PROVIDER, DEFAULT_OPEN_VIEWER_ON_LAUNCH, DEFAULT_LAUNCH_SESSION_DEFAULTS, LAUNCH_SESSION_METADATA_KEY;
-var init_terminal_profile_types2 = __esm({
-  "../packages/core/dist/service/terminal-profile-types.js"() {
-    "use strict";
-    TERMINAL_PROFILE_VERSION = 1;
-    DEFAULT_LATCH_EXECUTABLE = "latch";
-    DEFAULT_EXECUTION_PROVIDER = {
-      kind: "direct",
-      executable: DEFAULT_LATCH_EXECUTABLE
-    };
-    DEFAULT_OPEN_VIEWER_ON_LAUNCH = true;
-    DEFAULT_LAUNCH_SESSION_DEFAULTS = {
-      executionProvider: { ...DEFAULT_EXECUTION_PROVIDER },
-      openViewerOnLaunch: DEFAULT_OPEN_VIEWER_ON_LAUNCH
-    };
-    LAUNCH_SESSION_METADATA_KEY = "launchSession";
-  }
-});
-
 // ../packages/core/dist/service/latch-discovery.js
 import { execFileSync as execFileSync3 } from "node:child_process";
 import { existsSync as existsSync16, mkdirSync as mkdirSync9, readFileSync as readFileSync15, statSync as statSync4, writeFileSync as writeFileSync8 } from "node:fs";
@@ -19186,7 +19239,9 @@ function createLatchSession({
 function openLatchViewer({
   executable = DEFAULT_LATCH_EXECUTABLE,
   providerSessionId,
-  viewerKind
+  viewerKind,
+  openAs,
+  productVersion
 }) {
   const viewer = latchViewerFlagForKind(viewerKind);
   const attachCommand = latchAttachCommand({ executable, providerSessionId });
@@ -19197,9 +19252,10 @@ function openLatchViewer({
       attachCommand
     };
   }
+  const sendsOpenAs = Boolean(openAs) && latchSupportsOpenAs(productVersion);
   const result = spawnLatchJson({
     executable,
-    args: ["open", providerSessionId, "--with", viewer, "--json"]
+    args: buildLatchOpenArgs({ providerSessionId, viewer, openAs, productVersion })
   });
   if (result.status !== 0) {
     const detail = (result.stderr || result.stdout || `exit ${result.status ?? "null"}`).trim();
@@ -19209,7 +19265,7 @@ function openLatchViewer({
       attachCommand
     };
   }
-  return { ok: true, viewer };
+  return { ok: true, viewer, openAs: sendsOpenAs ? parseViewerOpenAs(openAs) : null };
 }
 var init_latch_launch2 = __esm({
   "src/latch-launch.ts"() {
@@ -19917,6 +19973,7 @@ async function launchAgent({
   let providerFallbackWarning = null;
   let useLatch = false;
   let resolvedLatchExecutable = executable;
+  let latchProductVersion = null;
   const existingProviderSession = providerKind === "latch" ? existingLatchProviderSession({
     latchSessionId: process.env.LATCH_SESSION_ID,
     executionTargetId: options.executionTargetId
@@ -19960,6 +20017,7 @@ async function launchAgent({
       });
       if (useLatch && discovery.state === "found") {
         resolvedLatchExecutable = discovery.resolvedPath;
+        latchProductVersion = discovery.productVersion;
       }
       if (!useLatch) {
         providerFallbackWarning = discovery.state === "not_installed" ? `Latch is not installed on this execution target (${discovery.installCommand}); falling back to direct launch.` : discovery.state === "incompatible" ? `Latch is incompatible (${discovery.missingCapability}: ${discovery.detail}); falling back to direct launch.` : "Latch is unavailable; falling back to direct launch.";
@@ -19984,7 +20042,9 @@ async function launchAgent({
       viewerOpen = openLatchViewer({
         executable: resolvedLatchExecutable,
         providerSessionId: created.providerSession.providerSessionId,
-        viewerKind: snapshot?.viewer.kind ?? "iterm"
+        viewerKind: snapshot?.viewer.kind ?? "iterm",
+        openAs: snapshot?.viewer.openAs ?? null,
+        productVersion: latchProductVersion
       });
     }
     return {