@mangostudio/cli-linux-x64 0.1.0-canary.846512f → 0.1.0-canary.8b6dce7

package/cursor-sidecar/run-agent.mjs

@@ -1,43 +1,25 @@
 #!/usr/bin/env node
 /**
  * Node sidecar for Cursor SDK local agent runs.
- * Line 1 on stdin is the JSON request; subsequent lines are tool_response RPC messages.
- * Writes NDJSON events (and tool_request RPC) to stdout.
+ * The first stdout line is the `ready` handshake; line 1 on stdin is the JSON
+ * request; subsequent stdin lines are tool_response RPC messages. Writes
+ * NDJSON events (and tool_request RPC) to stdout.
  */
 
-import { createInterface } from 'node:readline';
 import { Agent, Cursor } from '@cursor/sdk';
+import {
+  createStdinMultiplexer,
+  isRecord,
+  serializeError,
+  writeEvent,
+} from './sidecar-runtime.mjs';
 
-function writeEvent(event) {
-  process.stdout.write(`${JSON.stringify(event)}\n`);
-}
-
-function isRecord(value) {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function errorStatus(error) {
-  if (!isRecord(error)) return undefined;
-  const status = error.status ?? error.statusCode;
-  return typeof status === 'number' ? status : undefined;
-}
-
-function errorRetryable(error) {
-  if (!isRecord(error)) return undefined;
-  return typeof error.isRetryable === 'boolean' ? error.isRetryable : undefined;
-}
-
-function serializeError(error, fallback) {
-  const message = error instanceof Error && error.message ? error.message : fallback;
-  const status = errorStatus(error);
-  const isRetryable = errorRetryable(error);
-  return {
-    message,
-    content: message,
-    ...(status === undefined ? {} : { status }),
-    ...(isRetryable === undefined ? {} : { isRetryable, retryable: isRetryable }),
-  };
-}
+/**
+ * NDJSON protocol version announced in the `ready` handshake. Must stay in
+ * lockstep with CURSOR_SIDECAR_PROTOCOL_VERSION in ../sidecar-process.ts
+ * (this script cannot import it — both ship inside the same artifact).
+ */
+const PROTOCOL_VERSION = 1;
 
 function normalizeCustomTools(value) {
   if (!Array.isArray(value)) return undefined;
@@ -66,71 +48,6 @@ function normalizeSettingSources(value) {
   return sources.length > 0 ? sources : ['project'];
 }
 
-function createStdinMultiplexer() {
-  const rl = createInterface({ input: process.stdin });
-  const toolWaiters = new Map();
-  let toolRpcTimeoutMs;
-  let requestResolve;
-  let gotRequest = false;
-
-  const requestPromise = new Promise((resolve) => {
-    requestResolve = resolve;
-  });
-
-  rl.on('line', (line) => {
-    if (!line.trim()) return;
-
-    let parsed;
-    try {
-      parsed = JSON.parse(line);
-    } catch {
-      return;
-    }
-
-    if (!gotRequest) {
-      gotRequest = true;
-      requestResolve(parsed);
-      return;
-    }
-
-    if (parsed?.type === 'tool_response' && typeof parsed.id === 'string') {
-      const waiter = toolWaiters.get(parsed.id);
-      if (waiter) {
-        toolWaiters.delete(parsed.id);
-        if (waiter.timeout) clearTimeout(waiter.timeout);
-        waiter.resolve(parsed);
-      }
-    }
-  });
-
-  return {
-    readRequest: () => requestPromise,
-    setToolRpcTimeoutMs(value) {
-      toolRpcTimeoutMs = normalizeToolRpcTimeoutMs(value);
-    },
-    waitForToolResponse(id) {
-      return new Promise((resolve, reject) => {
-        const timeout =
-          toolRpcTimeoutMs === undefined
-            ? undefined
-            : setTimeout(() => {
-                toolWaiters.delete(id);
-                reject(new Error(`Tool RPC timed out after ${toolRpcTimeoutMs}ms.`));
-              }, toolRpcTimeoutMs);
-        timeout?.unref?.();
-        toolWaiters.set(id, { resolve, reject, timeout });
-      });
-    },
-    close: () => rl.close(),
-  };
-}
-
-function normalizeToolRpcTimeoutMs(value) {
-  if (typeof value !== 'number' || !Number.isFinite(value)) return undefined;
-  const rounded = Math.trunc(value);
-  return rounded > 0 ? rounded : undefined;
-}
-
 let nextToolRequestId = 0;
 
 function createRpcBackedCustomTools(toolDefs, stdinMux) {
@@ -210,6 +127,26 @@ async function disposeAgent(agent) {
   }
 }
 
+/**
+ * The agent currently running, tracked so the SIGTERM handler can dispose it
+ * (releasing Cursor's native child process) before exiting. Disposal is
+ * idempotent: SIGTERM and runAgent's finally may both reach it.
+ */
+let activeAgent;
+let activeAgentDisposed = false;
+
+async function disposeActiveAgent() {
+  if (!activeAgent || activeAgentDisposed) return;
+  activeAgentDisposed = true;
+  await disposeAgent(activeAgent);
+}
+
+process.on('SIGTERM', () => {
+  disposeActiveAgent()
+    .catch(() => {})
+    .finally(() => process.exit(143));
+});
+
 function readApiKey(request) {
   const apiKey = typeof request.apiKey === 'string' ? request.apiKey.trim() : '';
   if (!apiKey) throw new Error('Sidecar request missing apiKey.');
@@ -252,9 +189,8 @@ async function runAgent(request, stdinMux) {
   const customTools = toolDefs ? createRpcBackedCustomTools(toolDefs, stdinMux) : undefined;
   const settingSources = normalizeSettingSources(request.settingSources);
 
-  let agent;
   try {
-    agent = await Agent.create({
+    activeAgent = await Agent.create({
       apiKey,
       model: { id: model, ...(modelParams ? { params: modelParams } : {}) },
       local: {
@@ -263,6 +199,7 @@ async function runAgent(request, stdinMux) {
         ...(customTools ? { customTools } : {}),
       },
     });
+    const agent = activeAgent;
 
     const run = await agent.send(prompt);
     const emittedToolCalls = new Set();
@@ -304,12 +241,14 @@ async function runAgent(request, stdinMux) {
 
     writeEvent({ type: 'done', done: true });
   } finally {
-    await disposeAgent(agent);
+    await disposeActiveAgent();
   }
 }
 
 async function main() {
-  const stdinMux = createStdinMultiplexer();
+  writeEvent({ type: 'ready', protocolVersion: PROTOCOL_VERSION });
+
+  const stdinMux = createStdinMultiplexer({ sidecarLabel: 'Cursor' });
   const request = await stdinMux.readRequest();
   if (!isRecord(request)) throw new Error('Sidecar request must be a JSON object.');
 

package/cursor-sidecar/sidecar-runtime.mjs

@@ -0,0 +1,145 @@
+/**
+ * Shared Node-side helpers for MangoStudio SDK sidecars.
+ *
+ * This file is plain ESM because it ships beside sidecar entrypoints and
+ * cannot import workspace TypeScript.
+ */
+
+import { createInterface } from 'node:readline';
+
+/** Tool RPC wait applied when the parent does not pass toolRpcTimeoutMs. */
+export const DEFAULT_TOOL_RPC_TIMEOUT_MS = 300_000;
+
+// If the parent dies mid-run, stdout writes raise EPIPE; swallow so cleanup
+// paths (agent disposal, exit handlers) still run instead of crashing.
+process.stdout.on('error', () => {});
+
+export function writeEvent(event) {
+  try {
+    process.stdout.write(`${JSON.stringify(event)}\n`);
+  } catch {
+    // Parent may be gone (EPIPE); nothing useful to do.
+  }
+}
+
+export function isRecord(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function errorStatus(error) {
+  if (!isRecord(error)) return undefined;
+  const status = error.status ?? error.statusCode;
+  return typeof status === 'number' ? status : undefined;
+}
+
+function errorRetryable(error) {
+  if (!isRecord(error)) return undefined;
+  return typeof error.isRetryable === 'boolean' ? error.isRetryable : undefined;
+}
+
+export function serializeError(error, fallback) {
+  const message = error instanceof Error && error.message ? error.message : fallback;
+  const status = errorStatus(error);
+  const isRetryable = errorRetryable(error);
+  return {
+    message,
+    content: message,
+    ...(status === undefined ? {} : { status }),
+    ...(isRetryable === undefined ? {} : { isRetryable, retryable: isRetryable }),
+  };
+}
+
+export function createStdinMultiplexer(options = {}) {
+  const sidecarLabel = typeof options.sidecarLabel === 'string' ? options.sidecarLabel : 'Node';
+  const rl = createInterface({ input: process.stdin });
+  const toolWaiters = new Map();
+  let toolRpcTimeoutMs = DEFAULT_TOOL_RPC_TIMEOUT_MS;
+  let requestResolve;
+  let gotRequest = false;
+  let closedByUs = false;
+
+  const requestPromise = new Promise((resolve) => {
+    requestResolve = resolve;
+  });
+
+  rl.on('line', (line) => {
+    if (!line.trim()) return;
+
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch {
+      return;
+    }
+
+    if (!gotRequest) {
+      gotRequest = true;
+      requestResolve(parsed);
+      return;
+    }
+
+    if (parsed?.type === 'tool_response' && typeof parsed.id === 'string') {
+      const waiter = toolWaiters.get(parsed.id);
+      if (waiter) {
+        toolWaiters.delete(parsed.id);
+        if (waiter.timeout) clearTimeout(waiter.timeout);
+        waiter.resolve(parsed);
+      }
+    }
+  });
+
+  rl.on('close', () => {
+    if (closedByUs) return;
+
+    // Parent died before sending a request: exit instead of idling forever.
+    if (!gotRequest) {
+      writeEvent({
+        type: 'error',
+        content: `${sidecarLabel} sidecar stdin closed before a request was received.`,
+        done: true,
+      });
+      process.exit(1);
+    }
+
+    // Mid-run stdin close: no tool_response can ever arrive; unblock callers.
+    rejectPendingToolWaiters(
+      toolWaiters,
+      new Error(`${sidecarLabel} sidecar stdin closed while a tool call was pending.`)
+    );
+  });
+
+  return {
+    readRequest: () => requestPromise,
+    setToolRpcTimeoutMs(value) {
+      toolRpcTimeoutMs = normalizeToolRpcTimeoutMs(value);
+    },
+    waitForToolResponse(id) {
+      return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+          toolWaiters.delete(id);
+          reject(new Error(`Tool RPC timed out after ${toolRpcTimeoutMs}ms.`));
+        }, toolRpcTimeoutMs);
+        timeout.unref?.();
+        toolWaiters.set(id, { resolve, reject, timeout });
+      });
+    },
+    close: () => {
+      closedByUs = true;
+      rl.close();
+    },
+  };
+}
+
+function rejectPendingToolWaiters(toolWaiters, error) {
+  for (const [id, waiter] of toolWaiters) {
+    toolWaiters.delete(id);
+    if (waiter.timeout) clearTimeout(waiter.timeout);
+    waiter.reject(error);
+  }
+}
+
+export function normalizeToolRpcTimeoutMs(value) {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return DEFAULT_TOOL_RPC_TIMEOUT_MS;
+  const rounded = Math.trunc(value);
+  return rounded > 0 ? rounded : DEFAULT_TOOL_RPC_TIMEOUT_MS;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mangostudio/cli-linux-x64",
-  "version": "0.1.0-canary.846512f",
+  "version": "0.1.0-canary.8b6dce7",
   "description": "MangoStudio prebuilt binary for linux-x64.",
   "license": "MIT",
   "repository": {

package/public/assets/{MarkdownContentRenderer-DwrywcVv.js → MarkdownContentRenderer-DluhqQ8f.js}

@@ -1,4 +1,4 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/shiki-B3FV0nsK.js","assets/index-BLb-08lM.js","assets/rolldown-runtime-BYbx6iT9.js","assets/vendor-TU_R2f75.js","assets/ui-BEql6gkw.js","assets/vendor-deps-C4ULb-aw.js","assets/index-BYDs1qLs.css","assets/syntax-core-BoMshe5A.js"])))=>i.map(i=>d[i]);
-import{a as e}from"./rolldown-runtime-BYbx6iT9.js";import{i as t,r as n}from"./ui-BEql6gkw.js";import{i as r,n as i,r as a}from"./index-BLb-08lM.js";import{n as o,t as s}from"./markdown-parser-B0W8Yv4o.js";var c=e(t(),1),l=n(),u=`<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>`,d=`<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>`;function f({content:e,className:t,copyCodeLabel:n,codeCopiedLabel:i}){let{t:o}=r(),s=(0,c.useRef)(null),{resolvedCodeTheme:u}=a(),[d,f]=(0,c.useState)(null),[_,v]=(0,c.useState)(0),y=n??o.chat.copyCode,b=i??o.chat.codeCopied,x=(0,c.useMemo)(()=>k(e).join(`
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/shiki-Cjk9UNH4.js","assets/index-DgPknLa7.js","assets/rolldown-runtime-BYbx6iT9.js","assets/vendor-Dja0k3Kp.js","assets/ui-BEql6gkw.js","assets/vendor-deps-DHoTlQF_.js","assets/index-mg8B7wPk.css","assets/syntax-core-BoMshe5A.js"])))=>i.map(i=>d[i]);
+import{a as e}from"./rolldown-runtime-BYbx6iT9.js";import{i as t,r as n}from"./ui-BEql6gkw.js";import{i as r,n as i,r as a}from"./index-DgPknLa7.js";import{n as o,t as s}from"./markdown-parser-B0W8Yv4o.js";var c=e(t(),1),l=n(),u=`<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>`,d=`<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>`;function f({content:e,className:t,copyCodeLabel:n,codeCopiedLabel:i}){let{t:o}=r(),s=(0,c.useRef)(null),{resolvedCodeTheme:u}=a(),[d,f]=(0,c.useState)(null),[_,v]=(0,c.useState)(0),y=n??o.chat.copyCode,b=i??o.chat.codeCopied,x=(0,c.useMemo)(()=>k(e).join(`
 `),[e]);p((0,c.useMemo)(()=>x?x.split(`
-`):[],[x]),f,v),m(s,y,b);let S=h(e,(0,c.useMemo)(()=>g(u,y,d),[u,y,d,_]));return(0,l.jsx)(`div`,{ref:s,className:`markdown-content ${t??``}`,dangerouslySetInnerHTML:{__html:S}})}function p(e,t,n){(0,c.useEffect)(()=>{if(e.length===0)return;let r=!1;return A(e).then(e=>{r||(t(e),n(e=>e+1))}),()=>{r=!0}},[e,t,n])}function m(e,t,n){(0,c.useEffect)(()=>{let r=e.current;if(!r)return;let i=new Set,a=j(i,t,n);return r.addEventListener(`click`,a),()=>{r.removeEventListener(`click`,a);for(let e of i)clearTimeout(e)}},[e,t,n])}function h(e,t){return(0,c.useMemo)(()=>D(t,e),[e,t])}function g(e,t,n){return new s({gfm:!0,breaks:!0,renderer:_(e,t,n)})}function _(e,t,n){let r=new o;return r.link=v,r.image=y,r.html=e=>z(`text`in e?e.text:``),r.code=r=>w(r.text,r.lang,e,t,n),r}function v({href:e,title:t,tokens:n}){let r=n?.map(e=>`text`in e?e.text:e.raw).join(``)??``,i=C(e),a=t?` title="${z(t)}"`:``;return`<a href="${z(i)}" target="_blank" rel="noopener noreferrer"${a}>${r}</a>`}function y({href:e,title:t,text:n}){let r=C(e),i=t?` title="${z(t)}"`:``,a=n||r;return`<a href="${z(r)}" target="_blank" rel="noopener noreferrer" class="markdown-image-link"${i}>${z(a)}</a>`}var b=new Set([`http:`,`https:`,`mailto:`]),x=`#`,S=`https://markdown.invalid/`;function C(e){if(!e)return x;let t;try{t=new URL(e,S).protocol}catch{return x}return b.has(t)?e:x}function w(e,t,n,r,i){let a=t??``,o=a?i?.highlightCode(e,a,n):null;return o?T(o,a,r):E(e,a,r)}function T(e,t,n){return e.replace(`<pre `,`<pre data-lang="${z(t)}" `).replace(`</pre>`,`${R(n)}</pre>`)}function E(e,t,n){let r=t?` class="language-${z(t)}"`:``;return`<pre${t?` data-lang="${z(t)}"`:``}><code${r}>${z(e)}</code>${R(n)}</pre>`}function D(e,t){return t?e.parse(t,{async:!1}):``}var O=new s({gfm:!0,breaks:!0});function k(e){if(!e)return[];let t=new Set;return O.walkTokens(O.lexer(e),e=>{e.type===`code`&&`lang`in e&&e.lang&&t.add(e.lang)}),[...t].sort()}async function A(e){let t=await i(()=>import(`./shiki-B3FV0nsK.js`),__vite__mapDeps([0,1,2,3,4,5,6,7]));return await t.preloadCodeLanguages(e),t}function j(e,t,n){return r=>{M(r,e,t,n)}}async function M(e,t,n,r){let i=e.target.closest(`.copy-code-btn`);if(!i)return;let a=N(i);a!==null&&await P(i,a,t,n,r)}function N(e){let t=e.closest(`pre`);return t?t.querySelector(`code`)?.textContent??t.textContent??``:null}async function P(e,t,n,r,i){try{await navigator.clipboard.writeText(t),F(e,n,r,i)}catch{}}function F(e,t,n,r){e.innerHTML=d,e.setAttribute(`aria-label`,r),e.classList.add(`copy-code-btn--copied`),I(e,t,n)}function I(e,t,n){let r=setTimeout(()=>{t.delete(r),L(e,n)},2e3);t.add(r)}function L(e,t){e.innerHTML=u,e.setAttribute(`aria-label`,t),e.classList.remove(`copy-code-btn--copied`)}function R(e){return`<button class="copy-code-btn" type="button" aria-label="${z(e)}">${u}</button>`}function z(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replaceAll(`"`,`&quot;`).replaceAll(`'`,`&#39;`)}export{f as MarkdownContentRenderer};
+`):[],[x]),f,v),m(s,y,b);let S=h(e,(0,c.useMemo)(()=>g(u,y,d),[u,y,d,_]));return(0,l.jsx)(`div`,{ref:s,className:`markdown-content ${t??``}`,dangerouslySetInnerHTML:{__html:S}})}function p(e,t,n){(0,c.useEffect)(()=>{if(e.length===0)return;let r=!1;return A(e).then(e=>{r||(t(e),n(e=>e+1))}),()=>{r=!0}},[e,t,n])}function m(e,t,n){(0,c.useEffect)(()=>{let r=e.current;if(!r)return;let i=new Set,a=j(i,t,n);return r.addEventListener(`click`,a),()=>{r.removeEventListener(`click`,a);for(let e of i)clearTimeout(e)}},[e,t,n])}function h(e,t){return(0,c.useMemo)(()=>D(t,e),[e,t])}function g(e,t,n){return new s({gfm:!0,breaks:!0,renderer:_(e,t,n)})}function _(e,t,n){let r=new o;return r.link=v,r.image=y,r.html=e=>z(`text`in e?e.text:``),r.code=r=>w(r.text,r.lang,e,t,n),r}function v({href:e,title:t,tokens:n}){let r=n?.map(e=>`text`in e?e.text:e.raw).join(``)??``,i=C(e),a=t?` title="${z(t)}"`:``;return`<a href="${z(i)}" target="_blank" rel="noopener noreferrer"${a}>${r}</a>`}function y({href:e,title:t,text:n}){let r=C(e),i=t?` title="${z(t)}"`:``,a=n||r;return`<a href="${z(r)}" target="_blank" rel="noopener noreferrer" class="markdown-image-link"${i}>${z(a)}</a>`}var b=new Set([`http:`,`https:`,`mailto:`]),x=`#`,S=`https://markdown.invalid/`;function C(e){if(!e)return x;let t;try{t=new URL(e,S).protocol}catch{return x}return b.has(t)?e:x}function w(e,t,n,r,i){let a=t??``,o=a?i?.highlightCode(e,a,n):null;return o?T(o,a,r):E(e,a,r)}function T(e,t,n){return e.replace(`<pre `,`<pre data-lang="${z(t)}" `).replace(`</pre>`,`${R(n)}</pre>`)}function E(e,t,n){let r=t?` class="language-${z(t)}"`:``;return`<pre${t?` data-lang="${z(t)}"`:``}><code${r}>${z(e)}</code>${R(n)}</pre>`}function D(e,t){return t?e.parse(t,{async:!1}):``}var O=new s({gfm:!0,breaks:!0});function k(e){if(!e)return[];let t=new Set;return O.walkTokens(O.lexer(e),e=>{e.type===`code`&&`lang`in e&&e.lang&&t.add(e.lang)}),[...t].sort()}async function A(e){let t=await i(()=>import(`./shiki-Cjk9UNH4.js`),__vite__mapDeps([0,1,2,3,4,5,6,7]));return await t.preloadCodeLanguages(e),t}function j(e,t,n){return r=>{M(r,e,t,n)}}async function M(e,t,n,r){let i=e.target.closest(`.copy-code-btn`);if(!i)return;let a=N(i);a!==null&&await P(i,a,t,n,r)}function N(e){let t=e.closest(`pre`);return t?t.querySelector(`code`)?.textContent??t.textContent??``:null}async function P(e,t,n,r,i){try{await navigator.clipboard.writeText(t),F(e,n,r,i)}catch{}}function F(e,t,n,r){e.innerHTML=d,e.setAttribute(`aria-label`,r),e.classList.add(`copy-code-btn--copied`),I(e,t,n)}function I(e,t,n){let r=setTimeout(()=>{t.delete(r),L(e,n)},2e3);t.add(r)}function L(e,t){e.innerHTML=u,e.setAttribute(`aria-label`,t),e.classList.remove(`copy-code-btn--copied`)}function R(e){return`<button class="copy-code-btn" type="button" aria-label="${z(e)}">${u}</button>`}function z(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replaceAll(`"`,`&quot;`).replaceAll(`'`,`&#39;`)}export{f as MarkdownContentRenderer};