@openhands/agent-canvas 1.0.0-beta.8 → 1.0.0-rc.1

package/build/locales/ja/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "バックエンドを確認",
   "ONBOARDING$BACKEND_SUBTITLE": "OpenHands はエージェントサーバーと通信します。デフォルトのバックエンドに接続できることを確認してください。",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "接続できました！ 🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "エージェントサーバーが稼働しています。次に進みましょう。",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "エージェント実行用のデフォルトバックエンドを起動しましたが、エージェントバックエンドは必要な数だけ接続できます。ノートPC上、Dockerでサンドボックス化したもの、リモートVM上など、複数を使い分けられます。",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "設定を表示",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "設定を非表示",
   "ONBOARDING$BACKEND_CHECKING": "バックエンドの接続を確認しています…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "バックエンドに接続できません",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "下の接続情報を更新し、保存して再試行してください。",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "プロバイダーとモデルを選択してください。Anthropic Claude Opus を事前に選択しています。",
   "ONBOARDING$HELLO_TITLE": "ハローと挨拶 👋",
   "ONBOARDING$HELLO_SUBTITLE": "OpenHands に最初のメッセージを送信しましょう。ワークスペースなしの新しい会話を開始します。",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "OpenHands でできることを説明する簡単な Web ページを作成して",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "OpenHands でできることを説明する簡単な Web ページを作成して。",
   "ONBOARDING$HELLO_LAUNCH": "送信",
   "ONBOARDING$HELLO_LAUNCHING": "会話を開始しています…",
   "ONBOARDING$ACP_SECRETS_TITLE": "API キーを追加",

package/build/locales/ko-KR/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "백엔드 확인",
   "ONBOARDING$BACKEND_SUBTITLE": "OpenHands는 에이전트 서버와 통신합니다. 기본 백엔드에 접근할 수 있는지 확인하세요.",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "연결되었습니다! 🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "에이전트 서버가 정상적으로 실행 중입니다. 계속 진행합시다.",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "에이전트를 실행할 기본 백엔드를 시작했지만, 원하는 만큼 많은 에이전트 백엔드를 연결할 수 있습니다. 노트북, Docker 샌드박스, 원격 VM에 각각 하나씩 둘 수 있습니다.",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "구성 표시",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "구성 숨기기",
   "ONBOARDING$BACKEND_CHECKING": "백엔드 연결을 확인 중입니다…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "백엔드에 연결할 수 없습니다",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "아래 연결 정보를 수정한 뒤 저장하여 다시 시도하세요.",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "공급자와 모델을 선택하세요. 기본값으로 Anthropic Claude Opus가 선택되어 있습니다.",
   "ONBOARDING$HELLO_TITLE": "인사하기 👋",
   "ONBOARDING$HELLO_SUBTITLE": "OpenHands에 첫 메시지를 보내세요. 작업 공간 없이 새 대화를 시작합니다.",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "OpenHands가 무엇을 할 수 있는지 설명하는 간단한 웹페이지를 만들어 줘",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "OpenHands가 무엇을 할 수 있는지 설명하는 간단한 웹페이지를 만들어 줘.",
   "ONBOARDING$HELLO_LAUNCH": "보내기",
   "ONBOARDING$HELLO_LAUNCHING": "대화를 시작하는 중…",
   "ONBOARDING$ACP_SECRETS_TITLE": "API 키 추가",

package/build/locales/no/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "Sjekk backend",
   "ONBOARDING$BACKEND_SUBTITLE": "OpenHands kommuniserer med en agent-server. Sjekk at standard backend er tilgjengelig.",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "Du er tilkoblet! 🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "Agent-serveren din kjører. La oss gå videre.",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "Vi har startet en standard backend for å kjøre agentene dine, men du kan koble til så mange agent-backends du vil. Du kan ha én på laptopen, én i Docker-sandbox og én på en ekstern VM.",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "Vis konfigurasjon",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "Skjul konfigurasjon",
   "ONBOARDING$BACKEND_CHECKING": "Sjekker backend-tilkoblingen din…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "Vi når ikke backend-en din",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "Oppdater tilkoblingsdetaljene under og lagre for å prøve igjen.",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "Velg en leverandør og modell. Vi har forhåndsvalgt Anthropic Claude Opus.",
   "ONBOARDING$HELLO_TITLE": "Si hei 👋",
   "ONBOARDING$HELLO_SUBTITLE": "Send din første melding til OpenHands. Vi starter en ny samtale uten arbeidsområde.",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "Lag en enkel nettside som forklarer hva OpenHands kan gjøre",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "Lag en enkel nettside som forklarer hva OpenHands kan gjøre.",
   "ONBOARDING$HELLO_LAUNCH": "Send",
   "ONBOARDING$HELLO_LAUNCHING": "Starter samtale…",
   "ONBOARDING$ACP_SECRETS_TITLE": "Legg til API-nøklene dine",

package/build/locales/pt/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "Verifique seu backend",
   "ONBOARDING$BACKEND_SUBTITLE": "O OpenHands se comunica com um servidor de agente. Verifique se o backend padrão está acessível.",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "Conectado! 🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "Seu servidor de agente está em execução. Vamos continuar.",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "Iniciamos um backend padrão para executar seus agentes, mas você pode conectar quantos backends de agente quiser. Você pode ter um no laptop, um em sandbox no Docker e um em uma VM remota.",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "Mostrar configuração",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "Ocultar configuração",
   "ONBOARDING$BACKEND_CHECKING": "Verificando a conexão com o backend…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "Não foi possível conectar ao seu backend",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "Atualize os detalhes de conexão abaixo e salve para tentar novamente.",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "Escolha um provedor e modelo. Já selecionamos o Anthropic Claude Opus.",
   "ONBOARDING$HELLO_TITLE": "Diga olá 👋",
   "ONBOARDING$HELLO_SUBTITLE": "Envie sua primeira mensagem ao OpenHands. Vamos iniciar uma nova conversa sem workspace.",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "Crie uma página web básica explicando o que o OpenHands pode fazer",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "Crie uma página web básica explicando o que o OpenHands pode fazer.",
   "ONBOARDING$HELLO_LAUNCH": "Enviar",
   "ONBOARDING$HELLO_LAUNCHING": "Iniciando conversa…",
   "ONBOARDING$ACP_SECRETS_TITLE": "Adicione suas chaves de API",

package/build/locales/tr/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "Sunucu tarafını kontrol edin",
   "ONBOARDING$BACKEND_SUBTITLE": "OpenHands bir aracı sunucusuyla iletişim kurar. Varsayılan sunucuya erişilebildiğinden emin olun.",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "Bağlandınız! 🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "Aracı sunucunuz çalışıyor. Devam edelim.",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "Ajanlarınızı çalıştırmak için varsayılan bir backend başlattık, ancak istediğiniz kadar ajan backend'i bağlayabilirsiniz. Dizüstü bilgisayarınızda bir tane, Docker'da sandbox'lanmış bir tane ve uzak bir VM'de bir tane olabilir.",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "Yapılandırmayı göster",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "Yapılandırmayı gizle",
   "ONBOARDING$BACKEND_CHECKING": "Sunucu bağlantınız kontrol ediliyor…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "Sunucunuza ulaşılamıyor",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "Aşağıdaki bağlantı bilgilerini güncelleyin ve yeniden denemek için kaydedin.",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "Bir sağlayıcı ve model seçin. Anthropic Claude Opus'u önceden seçtik.",
   "ONBOARDING$HELLO_TITLE": "Selam ver 👋",
   "ONBOARDING$HELLO_SUBTITLE": "OpenHands'e ilk mesajınızı gönderin. Çalışma alanı olmadan yeni bir sohbet başlatacağız.",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "OpenHands'in neler yapabileceğini anlatan basit bir web sayfası oluştur",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "OpenHands'in neler yapabileceğini anlatan basit bir web sayfası oluştur.",
   "ONBOARDING$HELLO_LAUNCH": "Gönder",
   "ONBOARDING$HELLO_LAUNCHING": "Sohbet başlatılıyor…",
   "ONBOARDING$ACP_SECRETS_TITLE": "API anahtarlarınızı ekleyin",

package/build/locales/uk/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "Перевірте бекенд",
   "ONBOARDING$BACKEND_SUBTITLE": "OpenHands взаємодіє з агент-сервером. Переконайтеся, що типовий бекенд доступний.",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "З'єднання встановлено! 🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "Ваш агент-сервер працює. Продовжимо.",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "Ми запустили типовий бекенд для ваших агентів, але ви можете підключити скільки завгодно бекендів агентів. Один може бути на ноутбуці, один у Docker sandbox і один на віддаленій VM.",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "Показати конфігурацію",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "Приховати конфігурацію",
   "ONBOARDING$BACKEND_CHECKING": "Перевірка з'єднання з бекендом…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "Не вдається з'єднатися з бекендом",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "Оновіть нижче параметри з'єднання та збережіть, щоб повторити спробу.",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "Виберіть провайдера та модель. Anthropic Claude Opus уже обрано.",
   "ONBOARDING$HELLO_TITLE": "Привітайтеся 👋",
   "ONBOARDING$HELLO_SUBTITLE": "Надішліть перше повідомлення до OpenHands. Почнемо нову розмову без робочого простору.",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "Створи просту вебсторінку, що пояснює, на що здатний OpenHands",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "Створи просту вебсторінку, що пояснює, на що здатний OpenHands.",
   "ONBOARDING$HELLO_LAUNCH": "Надіслати",
   "ONBOARDING$HELLO_LAUNCHING": "Розпочинаємо розмову…",
   "ONBOARDING$ACP_SECRETS_TITLE": "Додайте свої ключі API",

package/build/locales/zh-CN/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "检查后端",
   "ONBOARDING$BACKEND_SUBTITLE": "OpenHands 通过智能体服务器进行通信。请确认默认后端可访问。",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "已连接！🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "智能体服务器已就绪。让我们继续。",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "我们已启动默认后端来运行您的智能体，但您可以连接任意数量的智能体后端。例如，您可以在笔记本电脑、Docker 沙箱或远程 VM 上各运行一个。",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "显示配置",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "隐藏配置",
   "ONBOARDING$BACKEND_CHECKING": "正在检查后端连接…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "无法连接到后端",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "请更新下方的连接信息并保存以重试。",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "选择提供商和模型。我们已为你预先选择 Anthropic Claude Opus。",
   "ONBOARDING$HELLO_TITLE": "打个招呼 👋",
   "ONBOARDING$HELLO_SUBTITLE": "向 OpenHands 发送你的第一条消息。我们将启动一个无工作区的新对话。",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "创建一个简单的网页，说明 OpenHands 能做什么",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "创建一个简单的网页，说明 OpenHands 能做什么。",
   "ONBOARDING$HELLO_LAUNCH": "发送",
   "ONBOARDING$HELLO_LAUNCHING": "正在开始对话…",
   "ONBOARDING$ACP_SECRETS_TITLE": "添加你的 API 密钥",

package/build/locales/zh-TW/openhands.json

@@ -1623,7 +1623,9 @@
   "ONBOARDING$BACKEND_TITLE": "檢查後端",
   "ONBOARDING$BACKEND_SUBTITLE": "OpenHands 透過代理伺服器溝通。請確認預設後端可連線。",
   "ONBOARDING$BACKEND_CONNECTED_TITLE": "已連線！🎉",
-  "ONBOARDING$BACKEND_CONNECTED_BODY": "代理伺服器已啟動並執行中。讓我們繼續。",
+  "ONBOARDING$BACKEND_CONNECTED_BODY": "我們已啟動預設後端來執行您的代理，但您可以連接任意數量的代理後端。您可以在筆記型電腦、Docker 沙箱或遠端 VM 上各執行一個。",
+  "ONBOARDING$BACKEND_SHOW_CONFIGURATION": "顯示設定",
+  "ONBOARDING$BACKEND_HIDE_CONFIGURATION": "隱藏設定",
   "ONBOARDING$BACKEND_CHECKING": "正在檢查後端連線…",
   "ONBOARDING$BACKEND_DISCONNECTED_TITLE": "無法連線到後端",
   "ONBOARDING$BACKEND_DISCONNECTED_BODY": "請更新下方連線資訊並儲存以重試。",
@@ -1634,7 +1636,7 @@
   "ONBOARDING$LLM_SUBTITLE": "選擇供應商與模型。我們已預先選好 Anthropic Claude Opus。",
   "ONBOARDING$HELLO_TITLE": "打個招呼 👋",
   "ONBOARDING$HELLO_SUBTITLE": "向 OpenHands 傳送第一則訊息。我們會開始一個沒有工作區的新對話。",
-  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "建立一個簡單的網頁，說明 OpenHands 能做什麼",
+  "ONBOARDING$HELLO_DEFAULT_MESSAGE": "建立一個簡單的網頁，說明 OpenHands 能做什麼。",
   "ONBOARDING$HELLO_LAUNCH": "傳送",
   "ONBOARDING$HELLO_LAUNCHING": "對話開始中…",
   "ONBOARDING$ACP_SECRETS_TITLE": "新增你的 API 金鑰",

package/config/defaults.json

@@ -3,7 +3,7 @@
 
   "versions": {
     "agentServer": "1.24.0",
-    "automation": "1.0.0a5",
+    "automation": "1.0.0a6",
     "automationSdk": "1.22.1"
   },
 

package/dist/api/agent-server-home.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../node_modules/@openhands/typescript-client/dist/client/file-client.cjs`),t=require(`./agent-server-client-options.cjs`);var n=new Map;function r(e){return/^([/\\]|[a-zA-Z]:[/\\])/.test(e)}function i(e,t){return`${e.replace(/[/\\]+$/,``)}/${t.replace(/^[/\\]+/,``)}`}async function a(r={}){let i=t.getAgentServerClientOptions(r),a=i.host,o=n.get(a);if(o)return o;let s=(async()=>{let{home:t}=await new e.FileClient(i).getHome();if(!t||typeof t!=`string`)throw Error(`Agent server returned an empty home directory`);return t.replace(/[/\\]+$/,``)})();n.set(a,s);try{return await s}catch(e){throw n.delete(a),e}}async function o(e,t={}){let n=e.replace(/[/\\]+$/,``);return n?r(n)?n:i(await a(t),n):a(t)}exports.resolveAbsoluteAgentServerPath=o;
+//# sourceMappingURL=agent-server-home.cjs.map

package/dist/api/agent-server-home.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-server-home.cjs","names":[],"sources":["../../src/api/agent-server-home.ts"],"sourcesContent":["// @spec WUP-001 — Resolve relative working dirs against /api/file/home\nimport { FileClient } from \"@openhands/typescript-client/clients\";\nimport {\n  getAgentServerClientOptions,\n  type AgentServerClientOverrides,\n} from \"./agent-server-client-options\";\n\n/**\n * Cache the agent-server's home directory per host so we only round-trip\n * `/api/file/home` once per backend. The home dir is effectively static for\n * the lifetime of a running agent-server (it's `Path.home()` on the host),\n * so caching is safe and avoids hammering the endpoint on every upload.\n *\n * The cache holds `Promise<string>` rather than `string` so concurrent\n * callers share a single in-flight request.\n */\nconst homeDirCache = new Map<string, Promise<string>>();\n\nfunction isAbsolutePath(path: string): boolean {\n  // Treat POSIX-style and Windows-style absolute paths as absolute.\n  // The agent-server itself is POSIX on Linux/macOS and uses `\\\\` style\n  // on Windows; we just need to know whether `Path(path).is_absolute()`\n  // would return true on the server.\n  //\n  // Patterns covered:\n  //   POSIX absolute:      /foo/bar\n  //   Windows drive:       C:\\foo  or  C:/foo\n  //   Windows UNC:         \\\\server\\share  (starts with `\\`, matches `[/\\\\]`)\n  return /^([/\\\\]|[a-zA-Z]:[/\\\\])/.test(path);\n}\n\n/**\n * Join a parent directory and a relative child segment with a forward slash,\n * collapsing any duplicate separators that result from the join.\n */\nfunction joinPath(parent: string, child: string): string {\n  const left = parent.replace(/[/\\\\]+$/, \"\");\n  const right = child.replace(/^[/\\\\]+/, \"\");\n  return `${left}/${right}`;\n}\n\n/**\n * Fetch and cache the agent-server's home directory via `GET /api/file/home`.\n *\n * The result is the absolute path returned by `Path.home()` on the\n * agent-server host (e.g. `/Users/foo`, `/root`, or `C:\\\\Users\\\\Foo`). This\n * is the most reliable absolute, writable anchor the agent-server API\n * currently exposes — `/server_info` doesn't include the process CWD.\n *\n * @param overrides Same shape as `getAgentServerClientOptions` — lets cloud\n *   sandboxes pass a `conversationUrl` + `sessionApiKey` so the lookup goes\n *   to the per-conversation runtime rather than the bundled local backend.\n */\nexport async function getAgentServerHomeDir(\n  overrides: AgentServerClientOverrides = {},\n): Promise<string> {\n  const options = getAgentServerClientOptions(overrides);\n  const cacheKey = options.host;\n  const cached = homeDirCache.get(cacheKey);\n  if (cached) return cached;\n\n  const lookup = (async () => {\n    const { home } = await new FileClient(options).getHome();\n    if (!home || typeof home !== \"string\") {\n      throw new Error(\"Agent server returned an empty home directory\");\n    }\n    return home.replace(/[/\\\\]+$/, \"\");\n  })();\n\n  homeDirCache.set(cacheKey, lookup);\n  try {\n    return await lookup;\n  } catch (error) {\n    // Don't cache failures — let the next call retry.\n    homeDirCache.delete(cacheKey);\n    throw error;\n  }\n}\n\n/** Test-only helper. */\nexport function clearAgentServerHomeDirCache(): void {\n  homeDirCache.clear();\n}\n\n/**\n * Resolve a (possibly relative) working dir to an absolute path the\n * agent-server's file APIs will accept.\n *\n * - If `workingDir` is already absolute, returns it unchanged.\n * - Otherwise prepends the agent-server's home dir (looked up via\n *   `/api/file/home` and cached). This matches how the published binary\n *   and Docker entrypoint expect to anchor relative working dirs: under\n *   `~/workspace/project` rather than the filesystem root.\n *\n * Why this matters: the agent-server's `/api/file/upload` endpoint requires\n * an absolute path and `mkdir -p`s the parent. Naively prepending `/` to a\n * relative dir like `workspace/project/<hex>` produces `/workspace/...`,\n * which on macOS lives under the SIP-protected read-only root and fails\n * with `Errno 30: Read-only file system: '/workspace'`. Resolving against\n * `Path.home()` instead puts the path somewhere reliably writable.\n */\nexport async function resolveAbsoluteAgentServerPath(\n  workingDir: string,\n  overrides: AgentServerClientOverrides = {},\n): Promise<string> {\n  const trimmed = workingDir.replace(/[/\\\\]+$/, \"\");\n  if (!trimmed) {\n    return getAgentServerHomeDir(overrides);\n  }\n  if (isAbsolutePath(trimmed)) return trimmed;\n\n  const home = await getAgentServerHomeDir(overrides);\n  return joinPath(home, trimmed);\n}\n"],"mappings":"wLAgBA,IAAM,EAAe,IAAI,IAEzB,SAAS,EAAe,EAAuB,CAU7C,MAAO,0BAA0B,KAAK,EAAK,CAO7C,SAAS,EAAS,EAAgB,EAAuB,CAGvD,MAAO,GAFM,EAAO,QAAQ,UAAW,GAE7B,CAAK,GADD,EAAM,QAAQ,UAAW,GACrB,GAepB,eAAsB,EACpB,EAAwC,EAAE,CACzB,CACjB,IAAM,EAAU,EAAA,4BAA4B,EAAU,CAChD,EAAW,EAAQ,KACnB,EAAS,EAAa,IAAI,EAAS,CACzC,GAAI,EAAQ,OAAO,EAEnB,IAAM,GAAU,SAAY,CAC1B,GAAM,CAAE,QAAS,MAAM,IAAI,EAAA,WAAW,EAAQ,CAAC,SAAS,CACxD,GAAI,CAAC,GAAQ,OAAO,GAAS,SAC3B,MAAU,MAAM,gDAAgD,CAElE,OAAO,EAAK,QAAQ,UAAW,GAAG,IAChC,CAEJ,EAAa,IAAI,EAAU,EAAO,CAClC,GAAI,CACF,OAAO,MAAM,QACN,EAAO,CAGd,MADA,EAAa,OAAO,EAAS,CACvB,GA0BV,eAAsB,EACpB,EACA,EAAwC,EAAE,CACzB,CACjB,IAAM,EAAU,EAAW,QAAQ,UAAW,GAAG,CAOjD,OANK,EAGD,EAAe,EAAQ,CAAS,EAG7B,EAAS,MADG,EAAsB,EAAU,CAC7B,EAAQ,CALrB,EAAsB,EAAU"}

package/dist/api/agent-server-home.d.ts

@@ -0,0 +1,34 @@
+import { type AgentServerClientOverrides } from "./agent-server-client-options";
+/**
+ * Fetch and cache the agent-server's home directory via `GET /api/file/home`.
+ *
+ * The result is the absolute path returned by `Path.home()` on the
+ * agent-server host (e.g. `/Users/foo`, `/root`, or `C:\\Users\\Foo`). This
+ * is the most reliable absolute, writable anchor the agent-server API
+ * currently exposes — `/server_info` doesn't include the process CWD.
+ *
+ * @param overrides Same shape as `getAgentServerClientOptions` — lets cloud
+ *   sandboxes pass a `conversationUrl` + `sessionApiKey` so the lookup goes
+ *   to the per-conversation runtime rather than the bundled local backend.
+ */
+export declare function getAgentServerHomeDir(overrides?: AgentServerClientOverrides): Promise<string>;
+/** Test-only helper. */
+export declare function clearAgentServerHomeDirCache(): void;
+/**
+ * Resolve a (possibly relative) working dir to an absolute path the
+ * agent-server's file APIs will accept.
+ *
+ * - If `workingDir` is already absolute, returns it unchanged.
+ * - Otherwise prepends the agent-server's home dir (looked up via
+ *   `/api/file/home` and cached). This matches how the published binary
+ *   and Docker entrypoint expect to anchor relative working dirs: under
+ *   `~/workspace/project` rather than the filesystem root.
+ *
+ * Why this matters: the agent-server's `/api/file/upload` endpoint requires
+ * an absolute path and `mkdir -p`s the parent. Naively prepending `/` to a
+ * relative dir like `workspace/project/<hex>` produces `/workspace/...`,
+ * which on macOS lives under the SIP-protected read-only root and fails
+ * with `Errno 30: Read-only file system: '/workspace'`. Resolving against
+ * `Path.home()` instead puts the path somewhere reliably writable.
+ */
+export declare function resolveAbsoluteAgentServerPath(workingDir: string, overrides?: AgentServerClientOverrides): Promise<string>;

package/dist/api/agent-server-home.js

@@ -0,0 +1,33 @@
+import { FileClient as e } from "../node_modules/@openhands/typescript-client/dist/client/file-client.js";
+import { getAgentServerClientOptions as t } from "./agent-server-client-options.js";
+//#region src/api/agent-server-home.ts
+var n = /* @__PURE__ */ new Map();
+function r(e) {
+	return /^([/\\]|[a-zA-Z]:[/\\])/.test(e);
+}
+function i(e, t) {
+	return `${e.replace(/[/\\]+$/, "")}/${t.replace(/^[/\\]+/, "")}`;
+}
+async function a(r = {}) {
+	let i = t(r), a = i.host, o = n.get(a);
+	if (o) return o;
+	let s = (async () => {
+		let { home: t } = await new e(i).getHome();
+		if (!t || typeof t != "string") throw Error("Agent server returned an empty home directory");
+		return t.replace(/[/\\]+$/, "");
+	})();
+	n.set(a, s);
+	try {
+		return await s;
+	} catch (e) {
+		throw n.delete(a), e;
+	}
+}
+async function o(e, t = {}) {
+	let n = e.replace(/[/\\]+$/, "");
+	return n ? r(n) ? n : i(await a(t), n) : a(t);
+}
+//#endregion
+export { o as resolveAbsoluteAgentServerPath };
+
+//# sourceMappingURL=agent-server-home.js.map

package/dist/api/agent-server-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-server-home.js","names":[],"sources":["../../src/api/agent-server-home.ts"],"sourcesContent":["// @spec WUP-001 — Resolve relative working dirs against /api/file/home\nimport { FileClient } from \"@openhands/typescript-client/clients\";\nimport {\n  getAgentServerClientOptions,\n  type AgentServerClientOverrides,\n} from \"./agent-server-client-options\";\n\n/**\n * Cache the agent-server's home directory per host so we only round-trip\n * `/api/file/home` once per backend. The home dir is effectively static for\n * the lifetime of a running agent-server (it's `Path.home()` on the host),\n * so caching is safe and avoids hammering the endpoint on every upload.\n *\n * The cache holds `Promise<string>` rather than `string` so concurrent\n * callers share a single in-flight request.\n */\nconst homeDirCache = new Map<string, Promise<string>>();\n\nfunction isAbsolutePath(path: string): boolean {\n  // Treat POSIX-style and Windows-style absolute paths as absolute.\n  // The agent-server itself is POSIX on Linux/macOS and uses `\\\\` style\n  // on Windows; we just need to know whether `Path(path).is_absolute()`\n  // would return true on the server.\n  //\n  // Patterns covered:\n  //   POSIX absolute:      /foo/bar\n  //   Windows drive:       C:\\foo  or  C:/foo\n  //   Windows UNC:         \\\\server\\share  (starts with `\\`, matches `[/\\\\]`)\n  return /^([/\\\\]|[a-zA-Z]:[/\\\\])/.test(path);\n}\n\n/**\n * Join a parent directory and a relative child segment with a forward slash,\n * collapsing any duplicate separators that result from the join.\n */\nfunction joinPath(parent: string, child: string): string {\n  const left = parent.replace(/[/\\\\]+$/, \"\");\n  const right = child.replace(/^[/\\\\]+/, \"\");\n  return `${left}/${right}`;\n}\n\n/**\n * Fetch and cache the agent-server's home directory via `GET /api/file/home`.\n *\n * The result is the absolute path returned by `Path.home()` on the\n * agent-server host (e.g. `/Users/foo`, `/root`, or `C:\\\\Users\\\\Foo`). This\n * is the most reliable absolute, writable anchor the agent-server API\n * currently exposes — `/server_info` doesn't include the process CWD.\n *\n * @param overrides Same shape as `getAgentServerClientOptions` — lets cloud\n *   sandboxes pass a `conversationUrl` + `sessionApiKey` so the lookup goes\n *   to the per-conversation runtime rather than the bundled local backend.\n */\nexport async function getAgentServerHomeDir(\n  overrides: AgentServerClientOverrides = {},\n): Promise<string> {\n  const options = getAgentServerClientOptions(overrides);\n  const cacheKey = options.host;\n  const cached = homeDirCache.get(cacheKey);\n  if (cached) return cached;\n\n  const lookup = (async () => {\n    const { home } = await new FileClient(options).getHome();\n    if (!home || typeof home !== \"string\") {\n      throw new Error(\"Agent server returned an empty home directory\");\n    }\n    return home.replace(/[/\\\\]+$/, \"\");\n  })();\n\n  homeDirCache.set(cacheKey, lookup);\n  try {\n    return await lookup;\n  } catch (error) {\n    // Don't cache failures — let the next call retry.\n    homeDirCache.delete(cacheKey);\n    throw error;\n  }\n}\n\n/** Test-only helper. */\nexport function clearAgentServerHomeDirCache(): void {\n  homeDirCache.clear();\n}\n\n/**\n * Resolve a (possibly relative) working dir to an absolute path the\n * agent-server's file APIs will accept.\n *\n * - If `workingDir` is already absolute, returns it unchanged.\n * - Otherwise prepends the agent-server's home dir (looked up via\n *   `/api/file/home` and cached). This matches how the published binary\n *   and Docker entrypoint expect to anchor relative working dirs: under\n *   `~/workspace/project` rather than the filesystem root.\n *\n * Why this matters: the agent-server's `/api/file/upload` endpoint requires\n * an absolute path and `mkdir -p`s the parent. Naively prepending `/` to a\n * relative dir like `workspace/project/<hex>` produces `/workspace/...`,\n * which on macOS lives under the SIP-protected read-only root and fails\n * with `Errno 30: Read-only file system: '/workspace'`. Resolving against\n * `Path.home()` instead puts the path somewhere reliably writable.\n */\nexport async function resolveAbsoluteAgentServerPath(\n  workingDir: string,\n  overrides: AgentServerClientOverrides = {},\n): Promise<string> {\n  const trimmed = workingDir.replace(/[/\\\\]+$/, \"\");\n  if (!trimmed) {\n    return getAgentServerHomeDir(overrides);\n  }\n  if (isAbsolutePath(trimmed)) return trimmed;\n\n  const home = await getAgentServerHomeDir(overrides);\n  return joinPath(home, trimmed);\n}\n"],"mappings":";;;AAgBA,IAAM,oBAAe,IAAI,KAA8B;AAEvD,SAAS,EAAe,GAAuB;AAU7C,QAAO,0BAA0B,KAAK,EAAK;;AAO7C,SAAS,EAAS,GAAgB,GAAuB;AAGvD,QAAO,GAFM,EAAO,QAAQ,WAAW,GAE7B,CAAK,GADD,EAAM,QAAQ,WAAW,GACrB;;AAepB,eAAsB,EACpB,IAAwC,EAAE,EACzB;CACjB,IAAM,IAAU,EAA4B,EAAU,EAChD,IAAW,EAAQ,MACnB,IAAS,EAAa,IAAI,EAAS;AACzC,KAAI,EAAQ,QAAO;CAEnB,IAAM,KAAU,YAAY;EAC1B,IAAM,EAAE,YAAS,MAAM,IAAI,EAAW,EAAQ,CAAC,SAAS;AACxD,MAAI,CAAC,KAAQ,OAAO,KAAS,SAC3B,OAAU,MAAM,gDAAgD;AAElE,SAAO,EAAK,QAAQ,WAAW,GAAG;KAChC;AAEJ,GAAa,IAAI,GAAU,EAAO;AAClC,KAAI;AACF,SAAO,MAAM;UACN,GAAO;AAGd,QADA,EAAa,OAAO,EAAS,EACvB;;;AA0BV,eAAsB,EACpB,GACA,IAAwC,EAAE,EACzB;CACjB,IAAM,IAAU,EAAW,QAAQ,WAAW,GAAG;AAOjD,QANK,IAGD,EAAe,EAAQ,GAAS,IAG7B,EAAS,MADG,EAAsB,EAAU,EAC7B,EAAQ,GALrB,EAAsB,EAAU"}

package/dist/api/config-service/config-service.api.cjs

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../node_modules/@openhands/typescript-client/dist/client/llm-client.cjs`),t=require(`../agent-server-client-options.cjs`);function n(e,t){if(!t)return e;let n=t.toLowerCase();return e.filter(e=>e.name.toLowerCase().includes(n))}function r(e,t){return t===void 0?e:e.filter(e=>e.verified===t)}function i(e,t){return!t||t<=0?e:e.slice(0,t)}var a=class{static async searchModels(a={},o){let s=new e.LLMMetadataClient(t.getAgentServerClientOptions()),c=o===void 0?s.getVerifiedModels():Promise.resolve(o),[l,u]=await Promise.all([s.getModels(),c]),d=a.provider__eq??null,f=new Set(d?u?.[d]??[]:[]),p=[...f].map(e=>({provider:d,name:e,verified:!0})),m=d?(l??[]).filter(e=>e.startsWith(`${d}/`)).map(e=>e.slice(d.length+1)).filter(e=>e.length>0&&!f.has(e)).map(e=>({provider:d,name:e,verified:!1})):[];return{items:i(r(n([...p,...m],a.query),a.verified__eq),a.limit),next_page_id:null}}static async searchProviders(a={},o){let s=new e.LLMMetadataClient(t.getAgentServerClientOptions()),c=o===void 0?s.getVerifiedModels():Promise.resolve(o),[l,u]=await Promise.all([s.getProviders(),c]),d=new Set(Object.keys(u??{}));return{items:i(r(n([...new Set([...d,...l??[]])].map(e=>({name:e,verified:d.has(e)})),a.query),a.verified__eq),a.limit),next_page_id:null}}};exports.default=a;
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../backend-registry/active-store.cjs`),t=require(`../../node_modules/@openhands/typescript-client/dist/client/llm-client.cjs`),n=require(`../agent-server-client-options.cjs`),r=require(`../cloud/proxy.cjs`);function i(e,t){if(!t)return e;let n=t.toLowerCase();return e.filter(e=>e.name.toLowerCase().includes(n))}function a(e,t){return t===void 0?e:e.filter(e=>e.verified===t)}function o(e,t){return!t||t<=0?e:e.slice(0,t)}function s(e){let t=new URLSearchParams;for(let[n,r]of Object.entries(e))r!==void 0&&t.set(n,String(r));let n=t.toString();return n?`?${n}`:``}var c=class{static async searchModels(c={},l){let u=e.getActiveBackend();if(u.backend.kind===`cloud`){let e=s({page_id:c.page_id,limit:c.limit,query:c.query,verified__eq:c.verified__eq,provider__eq:c.provider__eq});return r.callCloudProxy({backend:u.backend,method:`GET`,path:`/api/v1/config/models/search${e}`})}let d=new t.LLMMetadataClient(n.getAgentServerClientOptions()),f=l===void 0?d.getVerifiedModels():Promise.resolve(l),[p,m]=await Promise.all([d.getModels(),f]),h=c.provider__eq??null,g=new Set(h?m?.[h]??[]:[]),_=[...g].map(e=>({provider:h,name:e,verified:!0})),v=h?(p??[]).filter(e=>e.startsWith(`${h}/`)).map(e=>e.slice(h.length+1)).filter(e=>e.length>0&&!g.has(e)).map(e=>({provider:h,name:e,verified:!1})):[];return{items:o(a(i([..._,...v],c.query),c.verified__eq),c.limit),next_page_id:null}}static async searchProviders(c={},l){let u=e.getActiveBackend();if(u.backend.kind===`cloud`){let e=s({page_id:c.page_id,limit:c.limit,query:c.query,verified__eq:c.verified__eq});return r.callCloudProxy({backend:u.backend,method:`GET`,path:`/api/v1/config/providers/search${e}`})}let d=new t.LLMMetadataClient(n.getAgentServerClientOptions()),f=l===void 0?d.getVerifiedModels():Promise.resolve(l),[p,m]=await Promise.all([d.getProviders(),f]),h=new Set(Object.keys(m??{}));return{items:o(a(i([...new Set([...h,...p??[]])].map(e=>({name:e,verified:h.has(e)})),c.query),c.verified__eq),c.limit),next_page_id:null}}};exports.default=c;
 //# sourceMappingURL=config-service.api.cjs.map

package/dist/api/config-service/config-service.api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-service.api.cjs","names":[],"sources":["../../../src/api/config-service/config-service.api.ts"],"sourcesContent":["import { LLMMetadataClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\nimport type {\n  LLMModel,\n  LLMModelPage,\n  LLMProvider,\n  ProviderPage,\n  SearchModelsParams,\n  SearchProvidersParams,\n} from \"./config-service.types\";\n\nfunction filterByQuery<T extends { name: string }>(\n  items: T[],\n  query?: string,\n): T[] {\n  if (!query) {\n    return items;\n  }\n\n  const normalizedQuery = query.toLowerCase();\n  return items.filter((item) =>\n    item.name.toLowerCase().includes(normalizedQuery),\n  );\n}\n\nfunction filterByVerified<T extends { verified: boolean }>(\n  items: T[],\n  verified?: boolean,\n): T[] {\n  if (verified === undefined) {\n    return items;\n  }\n\n  return items.filter((item) => item.verified === verified);\n}\n\nfunction limitItems<T>(items: T[], limit?: number): T[] {\n  if (!limit || limit <= 0) {\n    return items;\n  }\n\n  return items.slice(0, limit);\n}\n\nclass ConfigService {\n  static async searchModels(\n    params: SearchModelsParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<LLMModelPage> {\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [models, verifiedMap] = await Promise.all([\n      llmClient.getModels(),\n      verifiedFetch,\n    ]);\n\n    const provider = params.provider__eq ?? null;\n    const verifiedNames = new Set(\n      provider ? (verifiedMap?.[provider] ?? []) : [],\n    );\n    const verifiedItems: LLMModel[] = [...verifiedNames].map((name) => ({\n      provider,\n      name,\n      verified: true,\n    }));\n\n    const prefixedItems: LLMModel[] = provider\n      ? (models ?? [])\n          .filter((model) => model.startsWith(`${provider}/`))\n          .map((model) => model.slice(provider.length + 1))\n          .filter((name) => name.length > 0 && !verifiedNames.has(name))\n          .map((name) => ({\n            provider,\n            name,\n            verified: false,\n          }))\n      : [];\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery([...verifiedItems, ...prefixedItems], params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return {\n      items,\n      next_page_id: null,\n    };\n  }\n\n  static async searchProviders(\n    params: SearchProvidersParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<ProviderPage> {\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [providers, verifiedMap] = await Promise.all([\n      llmClient.getProviders(),\n      verifiedFetch,\n    ]);\n\n    const verifiedProviders = new Set(Object.keys(verifiedMap ?? {}));\n    const names = new Set<string>([...verifiedProviders, ...(providers ?? [])]);\n    const providerItems: LLMProvider[] = [...names].map((name) => ({\n      name,\n      verified: verifiedProviders.has(name),\n    }));\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery(providerItems, params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return {\n      items,\n      next_page_id: null,\n    };\n  }\n}\n\nexport default ConfigService;\n"],"mappings":"8LAWA,SAAS,EACP,EACA,EACK,CACL,GAAI,CAAC,EACH,OAAO,EAGT,IAAM,EAAkB,EAAM,aAAa,CAC3C,OAAO,EAAM,OAAQ,GACnB,EAAK,KAAK,aAAa,CAAC,SAAS,EAAgB,CAClD,CAGH,SAAS,EACP,EACA,EACK,CAKL,OAJI,IAAa,IAAA,GACR,EAGF,EAAM,OAAQ,GAAS,EAAK,WAAa,EAAS,CAG3D,SAAS,EAAc,EAAY,EAAqB,CAKtD,MAJI,CAAC,GAAS,GAAS,EACd,EAGF,EAAM,MAAM,EAAG,EAAM,CAG9B,IAAM,EAAN,KAAoB,CAClB,aAAa,aACX,EAA6B,EAAE,CAC/B,EACuB,CACvB,IAAM,EAAY,IAAI,EAAA,kBAAkB,EAAA,6BAA6B,CAAC,CAChE,EACJ,IAAuB,IAAA,GAEnB,EAAU,mBAAmB,CAD7B,QAAQ,QAAQ,EAAmB,CAEnC,CAAC,EAAQ,GAAe,MAAM,QAAQ,IAAI,CAC9C,EAAU,WAAW,CACrB,EACD,CAAC,CAEI,EAAW,EAAO,cAAgB,KAClC,EAAgB,IAAI,IACxB,EAAY,IAAc,IAAa,EAAE,CAAI,EAAE,CAChD,CACK,EAA4B,CAAC,GAAG,EAAc,CAAC,IAAK,IAAU,CAClE,WACA,OACA,SAAU,GACX,EAAE,CAEG,EAA4B,GAC7B,GAAU,EAAE,EACV,OAAQ,GAAU,EAAM,WAAW,GAAG,EAAS,GAAG,CAAC,CACnD,IAAK,GAAU,EAAM,MAAM,EAAS,OAAS,EAAE,CAAC,CAChD,OAAQ,GAAS,EAAK,OAAS,GAAK,CAAC,EAAc,IAAI,EAAK,CAAC,CAC7D,IAAK,IAAU,CACd,WACA,OACA,SAAU,GACX,EAAE,CACL,EAAE,CAUN,MAAO,CACL,MATY,EACZ,EACE,EAAc,CAAC,GAAG,EAAe,GAAG,EAAc,CAAE,EAAO,MAAM,CACjE,EAAO,aACR,CACD,EAAO,MAIP,CACA,aAAc,KACf,CAGH,aAAa,gBACX,EAAgC,EAAE,CAClC,EACuB,CACvB,IAAM,EAAY,IAAI,EAAA,kBAAkB,EAAA,6BAA6B,CAAC,CAChE,EACJ,IAAuB,IAAA,GAEnB,EAAU,mBAAmB,CAD7B,QAAQ,QAAQ,EAAmB,CAEnC,CAAC,EAAW,GAAe,MAAM,QAAQ,IAAI,CACjD,EAAU,cAAc,CACxB,EACD,CAAC,CAEI,EAAoB,IAAI,IAAI,OAAO,KAAK,GAAe,EAAE,CAAC,CAAC,CAejE,MAAO,CACL,MATY,EACZ,EACE,EAPiC,CAAC,GAAG,IADvB,IAAY,CAAC,GAAG,EAAmB,GAAI,GAAa,EAAE,CAAE,CACjC,CAAM,CAAC,IAAK,IAAU,CAC7D,OACA,SAAU,EAAkB,IAAI,EAAK,CACtC,EAIiB,CAAe,EAAO,MAAM,CAC1C,EAAO,aACR,CACD,EAAO,MAIP,CACA,aAAc,KACf"}
+{"version":3,"file":"config-service.api.cjs","names":[],"sources":["../../../src/api/config-service/config-service.api.ts"],"sourcesContent":["import { LLMMetadataClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport { callCloudProxy } from \"../cloud/proxy\";\nimport type {\n  LLMModel,\n  LLMModelPage,\n  LLMProvider,\n  ProviderPage,\n  SearchModelsParams,\n  SearchProvidersParams,\n} from \"./config-service.types\";\n\nfunction filterByQuery<T extends { name: string }>(\n  items: T[],\n  query?: string,\n): T[] {\n  if (!query) {\n    return items;\n  }\n\n  const normalizedQuery = query.toLowerCase();\n  return items.filter((item) =>\n    item.name.toLowerCase().includes(normalizedQuery),\n  );\n}\n\nfunction filterByVerified<T extends { verified: boolean }>(\n  items: T[],\n  verified?: boolean,\n): T[] {\n  if (verified === undefined) {\n    return items;\n  }\n\n  return items.filter((item) => item.verified === verified);\n}\n\nfunction limitItems<T>(items: T[], limit?: number): T[] {\n  if (!limit || limit <= 0) {\n    return items;\n  }\n\n  return items.slice(0, limit);\n}\n\nfunction buildCloudQueryString(\n  params: Record<string, string | number | boolean | undefined>,\n): string {\n  const qs = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value !== undefined) qs.set(key, String(value));\n  }\n  const str = qs.toString();\n  return str ? `?${str}` : \"\";\n}\n\nclass ConfigService {\n  /**\n   * @param verifiedByProvider - Pre-fetched verified-models map used by the\n   *   local reconstruction path. Ignored for cloud backends, which call\n   *   `/api/v1/config/models/search` directly (verified status is embedded in\n   *   each returned item).\n   */\n  static async searchModels(\n    params: SearchModelsParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<LLMModelPage> {\n    const active = getActiveBackend();\n\n    if (active.backend.kind === \"cloud\") {\n      // Cloud exposes /api/v1/config/models/search which returns LLMModelPage directly.\n      // verifiedByProvider is not needed — the cloud API embeds verified status natively.\n      const qs = buildCloudQueryString({\n        page_id: params.page_id,\n        limit: params.limit,\n        query: params.query,\n        verified__eq: params.verified__eq,\n        provider__eq: params.provider__eq,\n      });\n      return callCloudProxy<LLMModelPage>({\n        backend: active.backend,\n        method: \"GET\",\n        path: `/api/v1/config/models/search${qs}`,\n      });\n    }\n\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [models, verifiedMap] = await Promise.all([\n      llmClient.getModels(),\n      verifiedFetch,\n    ]);\n\n    const provider = params.provider__eq ?? null;\n    const verifiedNames = new Set(\n      provider ? (verifiedMap?.[provider] ?? []) : [],\n    );\n    const verifiedItems: LLMModel[] = [...verifiedNames].map((name) => ({\n      provider,\n      name,\n      verified: true,\n    }));\n\n    const prefixedItems: LLMModel[] = provider\n      ? (models ?? [])\n          .filter((model) => model.startsWith(`${provider}/`))\n          .map((model) => model.slice(provider.length + 1))\n          .filter((name) => name.length > 0 && !verifiedNames.has(name))\n          .map((name) => ({\n            provider,\n            name,\n            verified: false,\n          }))\n      : [];\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery([...verifiedItems, ...prefixedItems], params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return { items, next_page_id: null };\n  }\n\n  /**\n   * @param verifiedByProvider - Pre-fetched verified-models map used by the\n   *   local reconstruction path. Ignored for cloud backends, which call\n   *   `/api/v1/config/providers/search` directly (verified status is embedded in\n   *   each returned item).\n   */\n  static async searchProviders(\n    params: SearchProvidersParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<ProviderPage> {\n    const active = getActiveBackend();\n\n    if (active.backend.kind === \"cloud\") {\n      // Cloud exposes /api/v1/config/providers/search which returns ProviderPage directly.\n      // verifiedByProvider is not needed — the cloud API embeds verified status natively.\n      const qs = buildCloudQueryString({\n        page_id: params.page_id,\n        limit: params.limit,\n        query: params.query,\n        verified__eq: params.verified__eq,\n      });\n      return callCloudProxy<ProviderPage>({\n        backend: active.backend,\n        method: \"GET\",\n        path: `/api/v1/config/providers/search${qs}`,\n      });\n    }\n\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [providers, verifiedMap] = await Promise.all([\n      llmClient.getProviders(),\n      verifiedFetch,\n    ]);\n\n    const verifiedProviders = new Set(Object.keys(verifiedMap ?? {}));\n    const names = new Set<string>([...verifiedProviders, ...(providers ?? [])]);\n    const providerItems: LLMProvider[] = [...names].map((name) => ({\n      name,\n      verified: verifiedProviders.has(name),\n    }));\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery(providerItems, params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return { items, next_page_id: null };\n  }\n}\n\nexport default ConfigService;\n"],"mappings":"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"}

package/dist/api/config-service/config-service.api.d.ts

@@ -1,6 +1,18 @@
 import type { LLMModelPage, ProviderPage, SearchModelsParams, SearchProvidersParams } from "./config-service.types";
 declare class ConfigService {
+    /**
+     * @param verifiedByProvider - Pre-fetched verified-models map used by the
+     *   local reconstruction path. Ignored for cloud backends, which call
+     *   `/api/v1/config/models/search` directly (verified status is embedded in
+     *   each returned item).
+     */
     static searchModels(params?: SearchModelsParams, verifiedByProvider?: Record<string, string[]>): Promise<LLMModelPage>;
+    /**
+     * @param verifiedByProvider - Pre-fetched verified-models map used by the
+     *   local reconstruction path. Ignored for cloud backends, which call
+     *   `/api/v1/config/providers/search` directly (verified status is embedded in
+     *   each returned item).
+     */
     static searchProviders(params?: SearchProvidersParams, verifiedByProvider?: Record<string, string[]>): Promise<ProviderPage>;
 }
 export default ConfigService;

package/dist/api/config-service/config-service.api.js

@@ -1,45 +1,82 @@
-import { LLMMetadataClient as e } from "../../node_modules/@openhands/typescript-client/dist/client/llm-client.js";
-import { getAgentServerClientOptions as t } from "../agent-server-client-options.js";
+import { getActiveBackend as e } from "../backend-registry/active-store.js";
+import { LLMMetadataClient as t } from "../../node_modules/@openhands/typescript-client/dist/client/llm-client.js";
+import { getAgentServerClientOptions as n } from "../agent-server-client-options.js";
+import { callCloudProxy as r } from "../cloud/proxy.js";
 //#region src/api/config-service/config-service.api.ts
-function n(e, t) {
+function i(e, t) {
 	if (!t) return e;
 	let n = t.toLowerCase();
 	return e.filter((e) => e.name.toLowerCase().includes(n));
 }
-function r(e, t) {
+function a(e, t) {
 	return t === void 0 ? e : e.filter((e) => e.verified === t);
 }
-function i(e, t) {
+function o(e, t) {
 	return !t || t <= 0 ? e : e.slice(0, t);
 }
-var a = class {
-	static async searchModels(a = {}, o) {
-		let s = new e(t()), c = o === void 0 ? s.getVerifiedModels() : Promise.resolve(o), [l, u] = await Promise.all([s.getModels(), c]), d = a.provider__eq ?? null, f = new Set(d ? u?.[d] ?? [] : []), p = [...f].map((e) => ({
-			provider: d,
+function s(e) {
+	let t = new URLSearchParams();
+	for (let [n, r] of Object.entries(e)) r !== void 0 && t.set(n, String(r));
+	let n = t.toString();
+	return n ? `?${n}` : "";
+}
+var c = class {
+	static async searchModels(c = {}, l) {
+		let u = e();
+		if (u.backend.kind === "cloud") {
+			let e = s({
+				page_id: c.page_id,
+				limit: c.limit,
+				query: c.query,
+				verified__eq: c.verified__eq,
+				provider__eq: c.provider__eq
+			});
+			return r({
+				backend: u.backend,
+				method: "GET",
+				path: `/api/v1/config/models/search${e}`
+			});
+		}
+		let d = new t(n()), f = l === void 0 ? d.getVerifiedModels() : Promise.resolve(l), [p, m] = await Promise.all([d.getModels(), f]), h = c.provider__eq ?? null, g = new Set(h ? m?.[h] ?? [] : []), _ = [...g].map((e) => ({
+			provider: h,
 			name: e,
 			verified: !0
-		})), m = d ? (l ?? []).filter((e) => e.startsWith(`${d}/`)).map((e) => e.slice(d.length + 1)).filter((e) => e.length > 0 && !f.has(e)).map((e) => ({
-			provider: d,
+		})), v = h ? (p ?? []).filter((e) => e.startsWith(`${h}/`)).map((e) => e.slice(h.length + 1)).filter((e) => e.length > 0 && !g.has(e)).map((e) => ({
+			provider: h,
 			name: e,
 			verified: !1
 		})) : [];
 		return {
-			items: i(r(n([...p, ...m], a.query), a.verified__eq), a.limit),
+			items: o(a(i([..._, ...v], c.query), c.verified__eq), c.limit),
 			next_page_id: null
 		};
 	}
-	static async searchProviders(a = {}, o) {
-		let s = new e(t()), c = o === void 0 ? s.getVerifiedModels() : Promise.resolve(o), [l, u] = await Promise.all([s.getProviders(), c]), d = new Set(Object.keys(u ?? {}));
+	static async searchProviders(c = {}, l) {
+		let u = e();
+		if (u.backend.kind === "cloud") {
+			let e = s({
+				page_id: c.page_id,
+				limit: c.limit,
+				query: c.query,
+				verified__eq: c.verified__eq
+			});
+			return r({
+				backend: u.backend,
+				method: "GET",
+				path: `/api/v1/config/providers/search${e}`
+			});
+		}
+		let d = new t(n()), f = l === void 0 ? d.getVerifiedModels() : Promise.resolve(l), [p, m] = await Promise.all([d.getProviders(), f]), h = new Set(Object.keys(m ?? {}));
 		return {
-			items: i(r(n([...new Set([...d, ...l ?? []])].map((e) => ({
+			items: o(a(i([...new Set([...h, ...p ?? []])].map((e) => ({
 				name: e,
-				verified: d.has(e)
-			})), a.query), a.verified__eq), a.limit),
+				verified: h.has(e)
+			})), c.query), c.verified__eq), c.limit),
 			next_page_id: null
 		};
 	}
 };
 //#endregion
-export { a as default };
+export { c as default };
 
 //# sourceMappingURL=config-service.api.js.map

package/dist/api/config-service/config-service.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-service.api.js","names":[],"sources":["../../../src/api/config-service/config-service.api.ts"],"sourcesContent":["import { LLMMetadataClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\nimport type {\n  LLMModel,\n  LLMModelPage,\n  LLMProvider,\n  ProviderPage,\n  SearchModelsParams,\n  SearchProvidersParams,\n} from \"./config-service.types\";\n\nfunction filterByQuery<T extends { name: string }>(\n  items: T[],\n  query?: string,\n): T[] {\n  if (!query) {\n    return items;\n  }\n\n  const normalizedQuery = query.toLowerCase();\n  return items.filter((item) =>\n    item.name.toLowerCase().includes(normalizedQuery),\n  );\n}\n\nfunction filterByVerified<T extends { verified: boolean }>(\n  items: T[],\n  verified?: boolean,\n): T[] {\n  if (verified === undefined) {\n    return items;\n  }\n\n  return items.filter((item) => item.verified === verified);\n}\n\nfunction limitItems<T>(items: T[], limit?: number): T[] {\n  if (!limit || limit <= 0) {\n    return items;\n  }\n\n  return items.slice(0, limit);\n}\n\nclass ConfigService {\n  static async searchModels(\n    params: SearchModelsParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<LLMModelPage> {\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [models, verifiedMap] = await Promise.all([\n      llmClient.getModels(),\n      verifiedFetch,\n    ]);\n\n    const provider = params.provider__eq ?? null;\n    const verifiedNames = new Set(\n      provider ? (verifiedMap?.[provider] ?? []) : [],\n    );\n    const verifiedItems: LLMModel[] = [...verifiedNames].map((name) => ({\n      provider,\n      name,\n      verified: true,\n    }));\n\n    const prefixedItems: LLMModel[] = provider\n      ? (models ?? [])\n          .filter((model) => model.startsWith(`${provider}/`))\n          .map((model) => model.slice(provider.length + 1))\n          .filter((name) => name.length > 0 && !verifiedNames.has(name))\n          .map((name) => ({\n            provider,\n            name,\n            verified: false,\n          }))\n      : [];\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery([...verifiedItems, ...prefixedItems], params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return {\n      items,\n      next_page_id: null,\n    };\n  }\n\n  static async searchProviders(\n    params: SearchProvidersParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<ProviderPage> {\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [providers, verifiedMap] = await Promise.all([\n      llmClient.getProviders(),\n      verifiedFetch,\n    ]);\n\n    const verifiedProviders = new Set(Object.keys(verifiedMap ?? {}));\n    const names = new Set<string>([...verifiedProviders, ...(providers ?? [])]);\n    const providerItems: LLMProvider[] = [...names].map((name) => ({\n      name,\n      verified: verifiedProviders.has(name),\n    }));\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery(providerItems, params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return {\n      items,\n      next_page_id: null,\n    };\n  }\n}\n\nexport default ConfigService;\n"],"mappings":";;;AAWA,SAAS,EACP,GACA,GACK;AACL,KAAI,CAAC,EACH,QAAO;CAGT,IAAM,IAAkB,EAAM,aAAa;AAC3C,QAAO,EAAM,QAAQ,MACnB,EAAK,KAAK,aAAa,CAAC,SAAS,EAAgB,CAClD;;AAGH,SAAS,EACP,GACA,GACK;AAKL,QAJI,MAAa,KAAA,IACR,IAGF,EAAM,QAAQ,MAAS,EAAK,aAAa,EAAS;;AAG3D,SAAS,EAAc,GAAY,GAAqB;AAKtD,QAJI,CAAC,KAAS,KAAS,IACd,IAGF,EAAM,MAAM,GAAG,EAAM;;AAG9B,IAAM,IAAN,MAAoB;CAClB,aAAa,aACX,IAA6B,EAAE,EAC/B,GACuB;EACvB,IAAM,IAAY,IAAI,EAAkB,GAA6B,CAAC,EAChE,IACJ,MAAuB,KAAA,IAEnB,EAAU,mBAAmB,GAD7B,QAAQ,QAAQ,EAAmB,EAEnC,CAAC,GAAQ,KAAe,MAAM,QAAQ,IAAI,CAC9C,EAAU,WAAW,EACrB,EACD,CAAC,EAEI,IAAW,EAAO,gBAAgB,MAClC,IAAgB,IAAI,IACxB,IAAY,IAAc,MAAa,EAAE,GAAI,EAAE,CAChD,EACK,IAA4B,CAAC,GAAG,EAAc,CAAC,KAAK,OAAU;GAClE;GACA;GACA,UAAU;GACX,EAAE,EAEG,IAA4B,KAC7B,KAAU,EAAE,EACV,QAAQ,MAAU,EAAM,WAAW,GAAG,EAAS,GAAG,CAAC,CACnD,KAAK,MAAU,EAAM,MAAM,EAAS,SAAS,EAAE,CAAC,CAChD,QAAQ,MAAS,EAAK,SAAS,KAAK,CAAC,EAAc,IAAI,EAAK,CAAC,CAC7D,KAAK,OAAU;GACd;GACA;GACA,UAAU;GACX,EAAE,GACL,EAAE;AAUN,SAAO;GACL,OATY,EACZ,EACE,EAAc,CAAC,GAAG,GAAe,GAAG,EAAc,EAAE,EAAO,MAAM,EACjE,EAAO,aACR,EACD,EAAO,MAIP;GACA,cAAc;GACf;;CAGH,aAAa,gBACX,IAAgC,EAAE,EAClC,GACuB;EACvB,IAAM,IAAY,IAAI,EAAkB,GAA6B,CAAC,EAChE,IACJ,MAAuB,KAAA,IAEnB,EAAU,mBAAmB,GAD7B,QAAQ,QAAQ,EAAmB,EAEnC,CAAC,GAAW,KAAe,MAAM,QAAQ,IAAI,CACjD,EAAU,cAAc,EACxB,EACD,CAAC,EAEI,IAAoB,IAAI,IAAI,OAAO,KAAK,KAAe,EAAE,CAAC,CAAC;AAejE,SAAO;GACL,OATY,EACZ,EACE,EAPiC,CAAC,GAAG,IADvB,IAAY,CAAC,GAAG,GAAmB,GAAI,KAAa,EAAE,CAAE,CACjC,CAAM,CAAC,KAAK,OAAU;IAC7D;IACA,UAAU,EAAkB,IAAI,EAAK;IACtC,EAIiB,EAAe,EAAO,MAAM,EAC1C,EAAO,aACR,EACD,EAAO,MAIP;GACA,cAAc;GACf"}
+{"version":3,"file":"config-service.api.js","names":[],"sources":["../../../src/api/config-service/config-service.api.ts"],"sourcesContent":["import { LLMMetadataClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport { callCloudProxy } from \"../cloud/proxy\";\nimport type {\n  LLMModel,\n  LLMModelPage,\n  LLMProvider,\n  ProviderPage,\n  SearchModelsParams,\n  SearchProvidersParams,\n} from \"./config-service.types\";\n\nfunction filterByQuery<T extends { name: string }>(\n  items: T[],\n  query?: string,\n): T[] {\n  if (!query) {\n    return items;\n  }\n\n  const normalizedQuery = query.toLowerCase();\n  return items.filter((item) =>\n    item.name.toLowerCase().includes(normalizedQuery),\n  );\n}\n\nfunction filterByVerified<T extends { verified: boolean }>(\n  items: T[],\n  verified?: boolean,\n): T[] {\n  if (verified === undefined) {\n    return items;\n  }\n\n  return items.filter((item) => item.verified === verified);\n}\n\nfunction limitItems<T>(items: T[], limit?: number): T[] {\n  if (!limit || limit <= 0) {\n    return items;\n  }\n\n  return items.slice(0, limit);\n}\n\nfunction buildCloudQueryString(\n  params: Record<string, string | number | boolean | undefined>,\n): string {\n  const qs = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value !== undefined) qs.set(key, String(value));\n  }\n  const str = qs.toString();\n  return str ? `?${str}` : \"\";\n}\n\nclass ConfigService {\n  /**\n   * @param verifiedByProvider - Pre-fetched verified-models map used by the\n   *   local reconstruction path. Ignored for cloud backends, which call\n   *   `/api/v1/config/models/search` directly (verified status is embedded in\n   *   each returned item).\n   */\n  static async searchModels(\n    params: SearchModelsParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<LLMModelPage> {\n    const active = getActiveBackend();\n\n    if (active.backend.kind === \"cloud\") {\n      // Cloud exposes /api/v1/config/models/search which returns LLMModelPage directly.\n      // verifiedByProvider is not needed — the cloud API embeds verified status natively.\n      const qs = buildCloudQueryString({\n        page_id: params.page_id,\n        limit: params.limit,\n        query: params.query,\n        verified__eq: params.verified__eq,\n        provider__eq: params.provider__eq,\n      });\n      return callCloudProxy<LLMModelPage>({\n        backend: active.backend,\n        method: \"GET\",\n        path: `/api/v1/config/models/search${qs}`,\n      });\n    }\n\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [models, verifiedMap] = await Promise.all([\n      llmClient.getModels(),\n      verifiedFetch,\n    ]);\n\n    const provider = params.provider__eq ?? null;\n    const verifiedNames = new Set(\n      provider ? (verifiedMap?.[provider] ?? []) : [],\n    );\n    const verifiedItems: LLMModel[] = [...verifiedNames].map((name) => ({\n      provider,\n      name,\n      verified: true,\n    }));\n\n    const prefixedItems: LLMModel[] = provider\n      ? (models ?? [])\n          .filter((model) => model.startsWith(`${provider}/`))\n          .map((model) => model.slice(provider.length + 1))\n          .filter((name) => name.length > 0 && !verifiedNames.has(name))\n          .map((name) => ({\n            provider,\n            name,\n            verified: false,\n          }))\n      : [];\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery([...verifiedItems, ...prefixedItems], params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return { items, next_page_id: null };\n  }\n\n  /**\n   * @param verifiedByProvider - Pre-fetched verified-models map used by the\n   *   local reconstruction path. Ignored for cloud backends, which call\n   *   `/api/v1/config/providers/search` directly (verified status is embedded in\n   *   each returned item).\n   */\n  static async searchProviders(\n    params: SearchProvidersParams = {},\n    verifiedByProvider?: Record<string, string[]>,\n  ): Promise<ProviderPage> {\n    const active = getActiveBackend();\n\n    if (active.backend.kind === \"cloud\") {\n      // Cloud exposes /api/v1/config/providers/search which returns ProviderPage directly.\n      // verifiedByProvider is not needed — the cloud API embeds verified status natively.\n      const qs = buildCloudQueryString({\n        page_id: params.page_id,\n        limit: params.limit,\n        query: params.query,\n        verified__eq: params.verified__eq,\n      });\n      return callCloudProxy<ProviderPage>({\n        backend: active.backend,\n        method: \"GET\",\n        path: `/api/v1/config/providers/search${qs}`,\n      });\n    }\n\n    const llmClient = new LLMMetadataClient(getAgentServerClientOptions());\n    const verifiedFetch =\n      verifiedByProvider !== undefined\n        ? Promise.resolve(verifiedByProvider)\n        : llmClient.getVerifiedModels();\n    const [providers, verifiedMap] = await Promise.all([\n      llmClient.getProviders(),\n      verifiedFetch,\n    ]);\n\n    const verifiedProviders = new Set(Object.keys(verifiedMap ?? {}));\n    const names = new Set<string>([...verifiedProviders, ...(providers ?? [])]);\n    const providerItems: LLMProvider[] = [...names].map((name) => ({\n      name,\n      verified: verifiedProviders.has(name),\n    }));\n\n    const items = limitItems(\n      filterByVerified(\n        filterByQuery(providerItems, params.query),\n        params.verified__eq,\n      ),\n      params.limit,\n    );\n\n    return { items, next_page_id: null };\n  }\n}\n\nexport default ConfigService;\n"],"mappings":"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"}

package/dist/api/conversation-file-upload.api.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`./backend-registry/active-store.cjs`),t=require(`./agent-server-client-options.cjs`),n=require(`../node_modules/@openhands/typescript-client/dist/workspace/remote-workspace.cjs`),r=require(`./cloud/conversation-service.api.cjs`),i=require(`./workspace-upload-path.cjs`);var a=5;async function o(t,n){if(n?.id===t&&n.conversation_url?.trim()&&n.session_api_key?.trim())return{conversationUrl:n.conversation_url.trim(),sessionApiKey:n.session_api_key.trim()};if(e.getActiveBackend().backend.kind===`cloud`){let[e]=await r.batchGetCloudConversations([t]);return{conversationUrl:e?.conversation_url?.trim()??null,sessionApiKey:e?.session_api_key?.trim()??null}}return{conversationUrl:null,sessionApiKey:null}}function s(e){if(!e.conversationUrl||!e.sessionApiKey)throw Error(`Conversation sandbox is still starting. Wait for it to finish, then try again.`);return{conversationUrl:e.conversationUrl,sessionApiKey:e.sessionApiKey}}async function c(t,n,r){let a=await i.resolveConversationUploadWorkingDir(t,r),c=await o(t,r),u=e.getActiveBackend().backend.kind===`cloud`,d=r?.id===t?r.session_api_key??c.sessionApiKey:c.sessionApiKey,f=r?.id===t?r.conversation_url??c.conversationUrl:c.conversationUrl;if(u){let e=s({conversationUrl:f,sessionApiKey:d});return l({files:n,workingDir:a,conversationUrl:e.conversationUrl,sessionApiKey:e.sessionApiKey})}return l({files:n,workingDir:a,conversationUrl:f,sessionApiKey:d})}async function l(e){let{files:r,workingDir:o,conversationUrl:s,sessionApiKey:c}=e,l=new n.RemoteWorkspace(t.getAgentServerClientOptions({conversationUrl:s,sessionApiKey:c,workingDir:o})),u=async e=>{try{let t=i.getSafeUploadFileName(e.name),n=i.buildWorkspaceUploadPath(e.name,o);return await l.fileUpload(e,n),{uploadedFile:t,skippedFile:null}}catch(t){return{uploadedFile:null,skippedFile:{name:e.name,reason:t instanceof Error?t.message:`Upload failed`}}}},d=[];for(let e=0;e<r.length;e+=a){let t=r.slice(e,e+a);d.push(...await Promise.all(t.map(u)))}return{uploaded_files:d.flatMap(e=>e.uploadedFile?[e.uploadedFile]:[]),skipped_files:d.flatMap(e=>e.skippedFile?[e.skippedFile]:[])}}exports.resolveConversationRuntime=o,exports.uploadFilesToConversation=c;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`./backend-registry/active-store.cjs`),t=require(`./agent-server-client-options.cjs`),n=require(`../node_modules/@openhands/typescript-client/dist/workspace/remote-workspace.cjs`),r=require(`./cloud/conversation-service.api.cjs`),i=require(`./workspace-upload-path.cjs`);var a=5;async function o(t,n){if(n?.id===t&&n.conversation_url?.trim()&&n.session_api_key?.trim())return{conversationUrl:n.conversation_url.trim(),sessionApiKey:n.session_api_key.trim()};if(e.getActiveBackend().backend.kind===`cloud`){let[e]=await r.batchGetCloudConversations([t]);return{conversationUrl:e?.conversation_url?.trim()??null,sessionApiKey:e?.session_api_key?.trim()??null}}return{conversationUrl:null,sessionApiKey:null}}function s(e){if(!e.conversationUrl||!e.sessionApiKey)throw Error(`Conversation sandbox is still starting. Wait for it to finish, then try again.`);return{conversationUrl:e.conversationUrl,sessionApiKey:e.sessionApiKey}}async function c(t,n,r){let a=await i.resolveConversationUploadWorkingDir(t,r),c=await o(t,r),u=e.getActiveBackend().backend.kind===`cloud`,d=r?.id===t?r.session_api_key??c.sessionApiKey:c.sessionApiKey,f=r?.id===t?r.conversation_url??c.conversationUrl:c.conversationUrl;if(u){let e=s({conversationUrl:f,sessionApiKey:d});return l({files:n,workingDir:a,conversationUrl:e.conversationUrl,sessionApiKey:e.sessionApiKey})}return l({files:n,workingDir:a,conversationUrl:f,sessionApiKey:d})}async function l(e){let{files:r,workingDir:o,conversationUrl:s,sessionApiKey:c}=e,l=new n.RemoteWorkspace(t.getAgentServerClientOptions({conversationUrl:s,sessionApiKey:c,workingDir:o})),u=async e=>{try{let t=i.getSafeUploadFileName(e.name),n=await i.buildWorkspaceUploadPath(e.name,o,{conversationUrl:s,sessionApiKey:c});return await l.fileUpload(e,n),{uploadedFile:t,skippedFile:null}}catch(t){return{uploadedFile:null,skippedFile:{name:e.name,reason:t instanceof Error?t.message:`Upload failed`}}}},d=[];for(let e=0;e<r.length;e+=a){let t=r.slice(e,e+a);d.push(...await Promise.all(t.map(u)))}return{uploaded_files:d.flatMap(e=>e.uploadedFile?[e.uploadedFile]:[]),skipped_files:d.flatMap(e=>e.skippedFile?[e.skippedFile]:[])}}exports.resolveConversationRuntime=o,exports.uploadFilesToConversation=c;
 //# sourceMappingURL=conversation-file-upload.api.cjs.map

package/dist/api/conversation-file-upload.api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-file-upload.api.cjs","names":[],"sources":["../../src/api/conversation-file-upload.api.ts"],"sourcesContent":["import { RemoteWorkspace } from \"@openhands/typescript-client/workspace/remote-workspace\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport { getActiveBackend } from \"#/api/backend-registry/active-store\";\nimport { batchGetCloudConversations } from \"#/api/cloud/conversation-service.api\";\nimport type { AppConversation } from \"#/api/conversation-service/agent-server-conversation-service.types\";\nimport type { FileUploadSuccessResponse } from \"#/api/open-hands.types\";\nimport {\n  buildWorkspaceUploadPath,\n  getSafeUploadFileName,\n  resolveConversationUploadWorkingDir,\n} from \"#/api/workspace-upload-path\";\n\nconst FILE_UPLOAD_CONCURRENCY = 5;\n\nexport interface ConversationRuntimeContext {\n  conversationUrl: string | null;\n  sessionApiKey: string | null;\n}\n\n/**\n * Resolve the sandbox runtime URL + session key needed for file upload and\n * send-event calls. Cloud conversations only exist on the provisioned runtime,\n * not on the bundled local agent-server.\n */\nexport async function resolveConversationRuntime(\n  conversationId: string,\n  currentConversation?: AppConversation | null,\n): Promise<ConversationRuntimeContext> {\n  if (\n    currentConversation?.id === conversationId &&\n    currentConversation.conversation_url?.trim() &&\n    currentConversation.session_api_key?.trim()\n  ) {\n    return {\n      conversationUrl: currentConversation.conversation_url.trim(),\n      sessionApiKey: currentConversation.session_api_key.trim(),\n    };\n  }\n\n  if (getActiveBackend().backend.kind === \"cloud\") {\n    const [conversation] = await batchGetCloudConversations([conversationId]);\n    return {\n      conversationUrl: conversation?.conversation_url?.trim() ?? null,\n      sessionApiKey: conversation?.session_api_key?.trim() ?? null,\n    };\n  }\n\n  return { conversationUrl: null, sessionApiKey: null };\n}\n\nfunction requireCloudRuntime(\n  runtime: ConversationRuntimeContext,\n): ConversationRuntimeContext & {\n  conversationUrl: string;\n  sessionApiKey: string;\n} {\n  if (!runtime.conversationUrl || !runtime.sessionApiKey) {\n    throw new Error(\n      \"Conversation sandbox is still starting. Wait for it to finish, then try again.\",\n    );\n  }\n  return {\n    conversationUrl: runtime.conversationUrl,\n    sessionApiKey: runtime.sessionApiKey,\n  };\n}\n\n/**\n * Upload attachments into the conversation workspace. Local conversations use\n * the bundled agent-server; cloud conversations target the provisioned runtime.\n */\nexport async function uploadFilesToConversation(\n  conversationId: string,\n  files: File[],\n  currentConversation?: AppConversation | null,\n): Promise<FileUploadSuccessResponse> {\n  const workingDir = await resolveConversationUploadWorkingDir(\n    conversationId,\n    currentConversation,\n  );\n  const runtime = await resolveConversationRuntime(\n    conversationId,\n    currentConversation,\n  );\n  const isCloud = getActiveBackend().backend.kind === \"cloud\";\n\n  const sessionApiKey =\n    currentConversation?.id === conversationId\n      ? (currentConversation.session_api_key ?? runtime.sessionApiKey)\n      : runtime.sessionApiKey;\n  const conversationUrl =\n    currentConversation?.id === conversationId\n      ? (currentConversation.conversation_url ?? runtime.conversationUrl)\n      : runtime.conversationUrl;\n\n  if (isCloud) {\n    const cloudRuntime = requireCloudRuntime({\n      conversationUrl,\n      sessionApiKey,\n    });\n    return uploadFilesToRuntime({\n      files,\n      workingDir,\n      conversationUrl: cloudRuntime.conversationUrl,\n      sessionApiKey: cloudRuntime.sessionApiKey,\n    });\n  }\n\n  return uploadFilesToRuntime({\n    files,\n    workingDir,\n    conversationUrl,\n    sessionApiKey,\n  });\n}\n\nasync function uploadFilesToRuntime(options: {\n  files: File[];\n  workingDir: string;\n  conversationUrl: string | null;\n  sessionApiKey: string | null;\n}): Promise<FileUploadSuccessResponse> {\n  const { files, workingDir, conversationUrl, sessionApiKey } = options;\n  const workspace = new RemoteWorkspace(\n    getAgentServerClientOptions({\n      conversationUrl,\n      sessionApiKey,\n      workingDir,\n    }),\n  );\n\n  const uploadFile = async (file: File) => {\n    try {\n      const safeName = getSafeUploadFileName(file.name);\n      const uploadPath = buildWorkspaceUploadPath(file.name, workingDir);\n      await workspace.fileUpload(file, uploadPath);\n      return { uploadedFile: safeName, skippedFile: null };\n    } catch (error) {\n      return {\n        uploadedFile: null,\n        skippedFile: {\n          name: file.name,\n          reason: error instanceof Error ? error.message : \"Upload failed\",\n        },\n      };\n    }\n  };\n\n  const results: Awaited<ReturnType<typeof uploadFile>>[] = [];\n  for (let index = 0; index < files.length; index += FILE_UPLOAD_CONCURRENCY) {\n    const batch = files.slice(index, index + FILE_UPLOAD_CONCURRENCY);\n    results.push(...(await Promise.all(batch.map(uploadFile))));\n  }\n\n  return {\n    uploaded_files: results.flatMap((result) =>\n      result.uploadedFile ? [result.uploadedFile] : [],\n    ),\n    skipped_files: results.flatMap((result) =>\n      result.skippedFile ? [result.skippedFile] : [],\n    ),\n  };\n}\n"],"mappings":"4UAYA,IAAM,EAA0B,EAYhC,eAAsB,EACpB,EACA,EACqC,CACrC,GACE,GAAqB,KAAO,GAC5B,EAAoB,kBAAkB,MAAM,EAC5C,EAAoB,iBAAiB,MAAM,CAE3C,MAAO,CACL,gBAAiB,EAAoB,iBAAiB,MAAM,CAC5D,cAAe,EAAoB,gBAAgB,MAAM,CAC1D,CAGH,GAAI,EAAA,kBAAkB,CAAC,QAAQ,OAAS,QAAS,CAC/C,GAAM,CAAC,GAAgB,MAAM,EAAA,2BAA2B,CAAC,EAAe,CAAC,CACzE,MAAO,CACL,gBAAiB,GAAc,kBAAkB,MAAM,EAAI,KAC3D,cAAe,GAAc,iBAAiB,MAAM,EAAI,KACzD,CAGH,MAAO,CAAE,gBAAiB,KAAM,cAAe,KAAM,CAGvD,SAAS,EACP,EAIA,CACA,GAAI,CAAC,EAAQ,iBAAmB,CAAC,EAAQ,cACvC,MAAU,MACR,iFACD,CAEH,MAAO,CACL,gBAAiB,EAAQ,gBACzB,cAAe,EAAQ,cACxB,CAOH,eAAsB,EACpB,EACA,EACA,EACoC,CACpC,IAAM,EAAa,MAAM,EAAA,oCACvB,EACA,EACD,CACK,EAAU,MAAM,EACpB,EACA,EACD,CACK,EAAU,EAAA,kBAAkB,CAAC,QAAQ,OAAS,QAE9C,EACJ,GAAqB,KAAO,EACvB,EAAoB,iBAAmB,EAAQ,cAChD,EAAQ,cACR,EACJ,GAAqB,KAAO,EACvB,EAAoB,kBAAoB,EAAQ,gBACjD,EAAQ,gBAEd,GAAI,EAAS,CACX,IAAM,EAAe,EAAoB,CACvC,kBACA,gBACD,CAAC,CACF,OAAO,EAAqB,CAC1B,QACA,aACA,gBAAiB,EAAa,gBAC9B,cAAe,EAAa,cAC7B,CAAC,CAGJ,OAAO,EAAqB,CAC1B,QACA,aACA,kBACA,gBACD,CAAC,CAGJ,eAAe,EAAqB,EAKG,CACrC,GAAM,CAAE,QAAO,aAAY,kBAAiB,iBAAkB,EACxD,EAAY,IAAI,EAAA,gBACpB,EAAA,4BAA4B,CAC1B,kBACA,gBACA,aACD,CAAC,CACH,CAEK,EAAa,KAAO,IAAe,CACvC,GAAI,CACF,IAAM,EAAW,EAAA,sBAAsB,EAAK,KAAK,CAC3C,EAAa,EAAA,yBAAyB,EAAK,KAAM,EAAW,CAElE,OADA,MAAM,EAAU,WAAW,EAAM,EAAW,CACrC,CAAE,aAAc,EAAU,YAAa,KAAM,OAC7C,EAAO,CACd,MAAO,CACL,aAAc,KACd,YAAa,CACX,KAAM,EAAK,KACX,OAAQ,aAAiB,MAAQ,EAAM,QAAU,gBAClD,CACF,GAIC,EAAoD,EAAE,CAC5D,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAM,OAAQ,GAAS,EAAyB,CAC1E,IAAM,EAAQ,EAAM,MAAM,EAAO,EAAQ,EAAwB,CACjE,EAAQ,KAAK,GAAI,MAAM,QAAQ,IAAI,EAAM,IAAI,EAAW,CAAC,CAAE,CAG7D,MAAO,CACL,eAAgB,EAAQ,QAAS,GAC/B,EAAO,aAAe,CAAC,EAAO,aAAa,CAAG,EAAE,CACjD,CACD,cAAe,EAAQ,QAAS,GAC9B,EAAO,YAAc,CAAC,EAAO,YAAY,CAAG,EAAE,CAC/C,CACF"}
+{"version":3,"file":"conversation-file-upload.api.cjs","names":[],"sources":["../../src/api/conversation-file-upload.api.ts"],"sourcesContent":["import { RemoteWorkspace } from \"@openhands/typescript-client/workspace/remote-workspace\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport { getActiveBackend } from \"#/api/backend-registry/active-store\";\nimport { batchGetCloudConversations } from \"#/api/cloud/conversation-service.api\";\nimport type { AppConversation } from \"#/api/conversation-service/agent-server-conversation-service.types\";\nimport type { FileUploadSuccessResponse } from \"#/api/open-hands.types\";\nimport {\n  buildWorkspaceUploadPath,\n  getSafeUploadFileName,\n  resolveConversationUploadWorkingDir,\n} from \"#/api/workspace-upload-path\";\n\nconst FILE_UPLOAD_CONCURRENCY = 5;\n\nexport interface ConversationRuntimeContext {\n  conversationUrl: string | null;\n  sessionApiKey: string | null;\n}\n\n/**\n * Resolve the sandbox runtime URL + session key needed for file upload and\n * send-event calls. Cloud conversations only exist on the provisioned runtime,\n * not on the bundled local agent-server.\n */\nexport async function resolveConversationRuntime(\n  conversationId: string,\n  currentConversation?: AppConversation | null,\n): Promise<ConversationRuntimeContext> {\n  if (\n    currentConversation?.id === conversationId &&\n    currentConversation.conversation_url?.trim() &&\n    currentConversation.session_api_key?.trim()\n  ) {\n    return {\n      conversationUrl: currentConversation.conversation_url.trim(),\n      sessionApiKey: currentConversation.session_api_key.trim(),\n    };\n  }\n\n  if (getActiveBackend().backend.kind === \"cloud\") {\n    const [conversation] = await batchGetCloudConversations([conversationId]);\n    return {\n      conversationUrl: conversation?.conversation_url?.trim() ?? null,\n      sessionApiKey: conversation?.session_api_key?.trim() ?? null,\n    };\n  }\n\n  return { conversationUrl: null, sessionApiKey: null };\n}\n\nfunction requireCloudRuntime(\n  runtime: ConversationRuntimeContext,\n): ConversationRuntimeContext & {\n  conversationUrl: string;\n  sessionApiKey: string;\n} {\n  if (!runtime.conversationUrl || !runtime.sessionApiKey) {\n    throw new Error(\n      \"Conversation sandbox is still starting. Wait for it to finish, then try again.\",\n    );\n  }\n  return {\n    conversationUrl: runtime.conversationUrl,\n    sessionApiKey: runtime.sessionApiKey,\n  };\n}\n\n/**\n * Upload attachments into the conversation workspace. Local conversations use\n * the bundled agent-server; cloud conversations target the provisioned runtime.\n */\nexport async function uploadFilesToConversation(\n  conversationId: string,\n  files: File[],\n  currentConversation?: AppConversation | null,\n): Promise<FileUploadSuccessResponse> {\n  const workingDir = await resolveConversationUploadWorkingDir(\n    conversationId,\n    currentConversation,\n  );\n  const runtime = await resolveConversationRuntime(\n    conversationId,\n    currentConversation,\n  );\n  const isCloud = getActiveBackend().backend.kind === \"cloud\";\n\n  const sessionApiKey =\n    currentConversation?.id === conversationId\n      ? (currentConversation.session_api_key ?? runtime.sessionApiKey)\n      : runtime.sessionApiKey;\n  const conversationUrl =\n    currentConversation?.id === conversationId\n      ? (currentConversation.conversation_url ?? runtime.conversationUrl)\n      : runtime.conversationUrl;\n\n  if (isCloud) {\n    const cloudRuntime = requireCloudRuntime({\n      conversationUrl,\n      sessionApiKey,\n    });\n    return uploadFilesToRuntime({\n      files,\n      workingDir,\n      conversationUrl: cloudRuntime.conversationUrl,\n      sessionApiKey: cloudRuntime.sessionApiKey,\n    });\n  }\n\n  return uploadFilesToRuntime({\n    files,\n    workingDir,\n    conversationUrl,\n    sessionApiKey,\n  });\n}\n\nasync function uploadFilesToRuntime(options: {\n  files: File[];\n  workingDir: string;\n  conversationUrl: string | null;\n  sessionApiKey: string | null;\n}): Promise<FileUploadSuccessResponse> {\n  const { files, workingDir, conversationUrl, sessionApiKey } = options;\n  const workspace = new RemoteWorkspace(\n    getAgentServerClientOptions({\n      conversationUrl,\n      sessionApiKey,\n      workingDir,\n    }),\n  );\n\n  const uploadFile = async (file: File) => {\n    try {\n      const safeName = getSafeUploadFileName(file.name);\n      // @spec WUP-001 — Build an absolute upload path that's anchored against\n      // the agent-server's home dir (when `workingDir` is relative) instead\n      // of the filesystem root. Without this, default conversations whose\n      // working_dir is `workspace/project/<hex>` (relative) land at\n      // `/workspace/project/<hex>/...` on the agent-server, which on macOS\n      // and fresh containers is a read-only mount.\n      const uploadPath = await buildWorkspaceUploadPath(file.name, workingDir, {\n        conversationUrl,\n        sessionApiKey,\n      });\n      await workspace.fileUpload(file, uploadPath);\n      return { uploadedFile: safeName, skippedFile: null };\n    } catch (error) {\n      return {\n        uploadedFile: null,\n        skippedFile: {\n          name: file.name,\n          reason: error instanceof Error ? error.message : \"Upload failed\",\n        },\n      };\n    }\n  };\n\n  const results: Awaited<ReturnType<typeof uploadFile>>[] = [];\n  for (let index = 0; index < files.length; index += FILE_UPLOAD_CONCURRENCY) {\n    const batch = files.slice(index, index + FILE_UPLOAD_CONCURRENCY);\n    results.push(...(await Promise.all(batch.map(uploadFile))));\n  }\n\n  return {\n    uploaded_files: results.flatMap((result) =>\n      result.uploadedFile ? [result.uploadedFile] : [],\n    ),\n    skipped_files: results.flatMap((result) =>\n      result.skippedFile ? [result.skippedFile] : [],\n    ),\n  };\n}\n"],"mappings":"4UAYA,IAAM,EAA0B,EAYhC,eAAsB,EACpB,EACA,EACqC,CACrC,GACE,GAAqB,KAAO,GAC5B,EAAoB,kBAAkB,MAAM,EAC5C,EAAoB,iBAAiB,MAAM,CAE3C,MAAO,CACL,gBAAiB,EAAoB,iBAAiB,MAAM,CAC5D,cAAe,EAAoB,gBAAgB,MAAM,CAC1D,CAGH,GAAI,EAAA,kBAAkB,CAAC,QAAQ,OAAS,QAAS,CAC/C,GAAM,CAAC,GAAgB,MAAM,EAAA,2BAA2B,CAAC,EAAe,CAAC,CACzE,MAAO,CACL,gBAAiB,GAAc,kBAAkB,MAAM,EAAI,KAC3D,cAAe,GAAc,iBAAiB,MAAM,EAAI,KACzD,CAGH,MAAO,CAAE,gBAAiB,KAAM,cAAe,KAAM,CAGvD,SAAS,EACP,EAIA,CACA,GAAI,CAAC,EAAQ,iBAAmB,CAAC,EAAQ,cACvC,MAAU,MACR,iFACD,CAEH,MAAO,CACL,gBAAiB,EAAQ,gBACzB,cAAe,EAAQ,cACxB,CAOH,eAAsB,EACpB,EACA,EACA,EACoC,CACpC,IAAM,EAAa,MAAM,EAAA,oCACvB,EACA,EACD,CACK,EAAU,MAAM,EACpB,EACA,EACD,CACK,EAAU,EAAA,kBAAkB,CAAC,QAAQ,OAAS,QAE9C,EACJ,GAAqB,KAAO,EACvB,EAAoB,iBAAmB,EAAQ,cAChD,EAAQ,cACR,EACJ,GAAqB,KAAO,EACvB,EAAoB,kBAAoB,EAAQ,gBACjD,EAAQ,gBAEd,GAAI,EAAS,CACX,IAAM,EAAe,EAAoB,CACvC,kBACA,gBACD,CAAC,CACF,OAAO,EAAqB,CAC1B,QACA,aACA,gBAAiB,EAAa,gBAC9B,cAAe,EAAa,cAC7B,CAAC,CAGJ,OAAO,EAAqB,CAC1B,QACA,aACA,kBACA,gBACD,CAAC,CAGJ,eAAe,EAAqB,EAKG,CACrC,GAAM,CAAE,QAAO,aAAY,kBAAiB,iBAAkB,EACxD,EAAY,IAAI,EAAA,gBACpB,EAAA,4BAA4B,CAC1B,kBACA,gBACA,aACD,CAAC,CACH,CAEK,EAAa,KAAO,IAAe,CACvC,GAAI,CACF,IAAM,EAAW,EAAA,sBAAsB,EAAK,KAAK,CAO3C,EAAa,MAAM,EAAA,yBAAyB,EAAK,KAAM,EAAY,CACvE,kBACA,gBACD,CAAC,CAEF,OADA,MAAM,EAAU,WAAW,EAAM,EAAW,CACrC,CAAE,aAAc,EAAU,YAAa,KAAM,OAC7C,EAAO,CACd,MAAO,CACL,aAAc,KACd,YAAa,CACX,KAAM,EAAK,KACX,OAAQ,aAAiB,MAAQ,EAAM,QAAU,gBAClD,CACF,GAIC,EAAoD,EAAE,CAC5D,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAM,OAAQ,GAAS,EAAyB,CAC1E,IAAM,EAAQ,EAAM,MAAM,EAAO,EAAQ,EAAwB,CACjE,EAAQ,KAAK,GAAI,MAAM,QAAQ,IAAI,EAAM,IAAI,EAAW,CAAC,CAAE,CAG7D,MAAO,CACL,eAAgB,EAAQ,QAAS,GAC/B,EAAO,aAAe,CAAC,EAAO,aAAa,CAAG,EAAE,CACjD,CACD,cAAe,EAAQ,QAAS,GAC9B,EAAO,YAAc,CAAC,EAAO,YAAY,CAAG,EAAE,CAC/C,CACF"}

package/dist/api/conversation-file-upload.api.js

@@ -57,7 +57,10 @@ async function d(e) {
 		workingDir: o
 	})), d = async (e) => {
 		try {
-			let t = a(e.name), n = i(e.name, o);
+			let t = a(e.name), n = await i(e.name, o, {
+				conversationUrl: c,
+				sessionApiKey: l
+			});
 			return await u.fileUpload(e, n), {
 				uploadedFile: t,
 				skippedFile: null