npm - @openhands/agent-canvas - Versions diffs - 1.14.0 → 1.16.0 - Mend

@openhands/agent-canvas 1.14.0 → 1.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1855) hide show

package/dist/utils/utils.d.ts CHANGED Viewed

@@ -126,40 +126,6 @@ export declare const getPRShort: (isGitLab: boolean) => "MR" | "PR";
  * constructPullRequestUrl(789, "bitbucket", "PROJECT/repo", "server.com") // "https://server.com/projects/PROJECT/repos/repo/pull-requests/789"
  */
 export declare const constructPullRequestUrl: (prNumber: number, provider: Provider, repositoryName: string, host?: string | null) => string;
-/**
- * Construct the microagent URL for different providers
- * @param gitProvider The git provider
- * @param repositoryName The repository name in format "owner/repo"
- * @param microagentPath The path to the microagent in the repository
- * @returns The URL to the microagent file in the Git provider
- *
- * @example
- * constructMicroagentUrl("github", "owner/repo", ".openhands/microagents/tell-me-a-joke.md")
- * // "https://github.com/owner/repo/blob/main/.openhands/microagents/tell-me-a-joke.md"
- * constructMicroagentUrl("gitlab", "owner/repo", "microagents/git-helper.md")
- * // "https://gitlab.com/owner/repo/-/blob/main/microagents/git-helper.md"
- * constructMicroagentUrl("bitbucket", "owner/repo", ".openhands/microagents/docker-helper.md")
- * // "https://bitbucket.org/owner/repo/src/main/.openhands/microagents/docker-helper.md"
- */
-export declare const constructMicroagentUrl: (gitProvider: Provider, repositoryName: string, microagentPath: string, host?: string | null) => string;
-/**
- * Extract repository owner, repo name, and file path from repository and microagent data
- * @param selectedRepository The selected repository object with full_name property
- * @param microagent The microagent object with path property
- * @returns Object containing owner, repo, and filePath
- *
- * @example
- * const { owner, repo, filePath } = extractRepositoryInfo(selectedRepository, microagent);
- */
-export declare const extractRepositoryInfo: (selectedRepository: {
-    full_name?: string;
-} | null | undefined, microagent: {
-    path?: string;
-} | null | undefined) => {
-    owner: string;
-    repo: string;
-    filePath: string;
-};
 /**
  * Construct the repository URL for different providers
  * @param provider The git provider
@@ -187,6 +153,7 @@ export declare const constructRepositoryUrl: (provider: Provider, repositoryName
  * constructBranchUrl("bitbucket", "PROJECT/repo", "feature", "server.com") // "https://server.com/projects/PROJECT/repos/repo/browse?at=refs/heads/feature"
  */
 export declare const constructBranchUrl: (provider: Provider, repositoryName: string, branchName: string, host?: string | null) => string;
+export declare const getGitCommitPrompt: () => string;
 /**
  * Generate a git pull prompt
  * @returns The git pull prompt
@@ -218,13 +185,6 @@ export declare const getCreateNewBranchPrompt: () => string;
 export declare function getTotalTaskCount(suggestedTasks: SuggestedTaskGroup[] | undefined): number;
 export declare function getLimitedTaskGroups(suggestedTasks: SuggestedTaskGroup[], maxTasks: number): SuggestedTaskGroup[];
 export declare function getDisplayedTaskGroups(suggestedTasks: SuggestedTaskGroup[] | undefined, isExpanded: boolean): SuggestedTaskGroup[];
-/**
- * Get the repository markdown creation prompt with additional PR creation instructions
- * @param gitProvider The git provider to use for generating provider-specific text
- * @param query Optional custom query to use instead of the default prompt
- * @returns The complete prompt for creating repository markdown and PR instructions
- */
-export declare const getRepoMdCreatePrompt: (gitProvider: Provider, query?: string) => string;
 /**
  * Get the label for a conversation status
  * @param status The conversation status

package/dist/utils/utils.js CHANGED Viewed

@@ -34,14 +34,35 @@ var c = (e, t) => {
 		case "forgejo": return "https://codeberg.org";
 		default: return "";
 	}
-}, g = (e) => e === "gitlab" ? "GitLab" : e === "bitbucket" ? "Bitbucket" : e === "bitbucket_data_center" ? "Bitbucket Data Center" : e === "azure_devops" ? "Azure DevOps" : e === "forgejo" ? "Forgejo" : "GitHub", _ = (e) => e ? "merge request" : "pull request", v = (e) => e ? "MR" : "PR", y = (e, t, n) => {
+}, g = (e) => e === "gitlab" ? "GitLab" : e === "bitbucket" ? "Bitbucket" : e === "bitbucket_data_center" ? "Bitbucket Data Center" : e === "azure_devops" ? "Azure DevOps" : e === "forgejo" ? "Forgejo" : "GitHub", _ = (e) => e ? "merge request" : "pull request", v = (e) => e ? "MR" : "PR", y = (e, t, n, r) => {
+	let i = h(t, r);
+	switch (t) {
+		case "github": return `${i}/${n}/pull/${e}`;
+		case "forgejo": return `${i}/${n}/pull/${e}`;
+		case "gitlab": return `${i}/${n}/-/merge_requests/${e}`;
+		case "bitbucket": return `${i}/${n}/pull-requests/${e}`;
+		case "bitbucket_data_center": {
+			let [t, r] = n.split("/");
+			return `${i}/projects/${t}/repos/${r}/pull-requests/${e}`;
+		}
+		case "azure_devops": {
+			let t = n.split("/");
+			if (t.length === 3) {
+				let [n, r, a] = t;
+				return `${i}/${n}/${r}/_git/${a}/pullrequest/${e}`;
+			}
+			return "";
+		}
+		default: return "";
+	}
+}, b = (e, t, n) => {
 	let r = h(e, n);
 	if (e === "bitbucket_data_center") {
 		let [e, n] = t.split("/");
 		return `${r}/projects/${e}/repos/${n}`;
 	}
 	return `${r}/${t}`;
-}, b = (e, t, n, r) => {
+}, x = (e, t, n, r) => {
 	let i = h(e, r);
 	switch (e) {
 		case "github": return `${i}/${t}/tree/${n}`;
@@ -66,17 +87,17 @@ var c = (e, t) => {
 		}
 		default: return "";
 	}
-}, x = () => "Please pull the latest code from the repository.", S = (e) => `Please push the changes to a remote branch on ${g(e)}, but do NOT create a ${_(e === "gitlab")}. Check your current branch name first - if it's main, master, deploy, or another common default branch name, create a new branch with a descriptive name related to your changes. Otherwise, use the exact SAME branch name as the one you are currently on.`, C = (e) => {
+}, S = "Please review the current changes and create a git commit with a concise, descriptive message.", C = () => S, w = () => "Please pull the latest code from the repository.", T = (e) => `Please push the changes to a remote branch on ${g(e)}, but do NOT create a ${_(e === "gitlab")}. Check your current branch name first - if it's main, master, deploy, or another common default branch name, create a new branch with a descriptive name related to your changes. Otherwise, use the exact SAME branch name as the one you are currently on.`, E = (e) => {
 	let t = g(e), n = _(e === "gitlab");
 	return `Please push the changes to ${t} and open a ${n}. If you're on a default branch (e.g., main, master, deploy), create a new branch with a descriptive name otherwise use the current branch. If a ${n} template exists in the repository, please follow it when creating the ${v(e === "gitlab")} description.`;
-}, w = () => "Please create a new branch with a descriptive name related to the work you plan to do.", T = (e) => !!e && e !== "ERROR" && e !== "READY", E = (e) => {
+}, D = () => "Please create a new branch with a descriptive name related to the work you plan to do.", O = (e) => !!e && e !== "ERROR" && e !== "READY", k = (e) => {
 	let { isPausing: t, isTask: n, taskStatus: i, isStartingStatus: s, isStopStatus: c, curAgentState: l } = e;
 	return t ? "#FFD600" : n && i ? i === "ERROR" ? a : "#FFD600" : s ? "#FFD600" : c ? "#ffffff" : l === r.ERROR ? a : o;
 };
-function D({ isPausing: t = !1, isTask: n, taskStatus: a, taskDetail: o, isStartingStatus: s, isStopStatus: c, curAgentState: l, errorMessage: u, t: d }) {
+function A({ isPausing: t = !1, isTask: n, taskStatus: a, taskDetail: o, isStartingStatus: s, isStopStatus: c, curAgentState: l, errorMessage: u, t: d }) {
 	return t ? d(e.COMMON$STOPPING) : n && a ? a === "ERROR" ? o || d(e.CONVERSATION$ERROR_STARTING_CONVERSATION) : a === "READY" ? d(e.CONVERSATION$READY) : o || d(i(a)) : s ? d(e.COMMON$STARTING) : c ? d(e.COMMON$SERVER_STOPPED) : l === r.ERROR ? u || d(e.COMMON$ERROR) : d(e.COMMON$RUNNING);
 }
 //#endregion
-export { s as cn, b as constructBranchUrl, y as constructRepositoryUrl, c as downloadBlob, w as getCreateNewBranchPrompt, C as getCreatePRPrompt, p as getFileExtension, x as getGitPullPrompt, S as getGitPushPrompt, E as getStatusColor, D as getStatusText, l as getStyleHeightPx, f as isMobileDevice, d as isMobileUserAgent, T as isTaskPolling, u as setStyleHeightPx, m as shouldUseInstallationRepos };
+export { s as cn, x as constructBranchUrl, y as constructPullRequestUrl, b as constructRepositoryUrl, c as downloadBlob, D as getCreateNewBranchPrompt, E as getCreatePRPrompt, p as getFileExtension, C as getGitCommitPrompt, h as getGitProviderBaseUrl, w as getGitPullPrompt, T as getGitPushPrompt, g as getProviderName, k as getStatusColor, A as getStatusText, l as getStyleHeightPx, f as isMobileDevice, d as isMobileUserAgent, O as isTaskPolling, u as setStyleHeightPx, m as shouldUseInstallationRepos };
 //# sourceMappingURL=utils.js.map

package/dist/utils/utils.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"utils.js","names":[],"sources":["../../src/utils/utils.ts"],"sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\nimport { Provider } from \"#/types/settings\";\nimport { SuggestedTaskGroup } from \"#/utils/types\";\nimport { ConversationStatus } from \"#/types/conversation-status\";\nimport { GitRepository } from \"#/types/git\";\nimport { sanitizeQuery } from \"#/utils/sanitize-query\";\nimport { PRODUCT_URL } from \"#/utils/constants\";\nimport { AgentState } from \"#/types/agent-state\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { getTaskStatusI18nKey } from \"#/utils/status\";\nimport type { AppConversationStartTaskStatus } from \"#/api/conversation-service/agent-server-conversation-service.types\";\nimport {\n OH_STATUS_ERROR_COLOR,\n OH_STATUS_SUCCESS_COLOR,\n} from \"#/constants/status-colors\";\n\nexport function cn(...inputs: ClassValue[]) {\n return twMerge(clsx(inputs));\n}\n\n/*\n Trigger a download for a provided Blob with the given filename\n /\nexport const downloadBlob = (blob: Blob, filename: string): void => {\n const url = window.URL.createObjectURL(blob);\n const link = document.createElement(\"a\");\n link.href = url;\n link.download = filename;\n document.body.appendChild(link);\n link.click();\n document.body.removeChild(link);\n window.URL.revokeObjectURL(url);\n};\n\n/\n Get the numeric height value from an element's style property\n * @param el The HTML element to get the height from\n * @param fallback The fallback value to return if style height is invalid\n * @returns The numeric height value in pixels, or the fallback value\n \n @example\n * getStyleHeightPx(element, 20) // Returns 20 if element.style.height is \"auto\" or invalid\n * getStyleHeightPx(element, 20) // Returns 100 if element.style.height is \"100px\"\n /\nexport const getStyleHeightPx = (el: HTMLElement, fallback: number): number => {\n const elementHeight = parseFloat(el.style.height \|\| \"\");\n return Number.isFinite(elementHeight) ? elementHeight : fallback;\n};\n\n/\n Set the height style property of an element to a specific pixel value\n * @param el The HTML element to set the height for\n * @param height The height value in pixels to set\n \n @example\n * setStyleHeightPx(element, 100) // Sets element.style.height to \"100px\"\n * setStyleHeightPx(textarea, 200) // Sets textarea.style.height to \"200px\"\n /\nexport const setStyleHeightPx = (el: HTMLElement, height: number): void => {\n el.style.setProperty(\"height\", `${height}px`);\n};\n\n/\n Detect a phone/tablet user agent (Android, iPhone, iPad, …).\n * Unlike isMobileDevice, this ignores touch capability, so a desktop OS with\n * a touchscreen (e.g. a Windows 2-in-1) is NOT matched. Use this when the\n * decision depends on having a physical keyboard rather than on touch input.\n /\nexport const isMobileUserAgent = (): boolean =>\n /Android\|webOS\|iPhone\|iPad\|iPod\|BlackBerry\|IEMobile\|Opera Mini/i.test(\n navigator.userAgent,\n );\n\n/\n Detect if the user is on a mobile device.\n * Touch support alone is not sufficient — touchscreen laptops have touch\n * but use a mouse/trackpad as primary input. We check that the primary\n * pointing device is coarse (finger) to avoid false positives.\n /\nexport const isMobileDevice = (): boolean => {\n if (isMobileUserAgent()) return true;\n\n const hasTouch = \"ontouchstart\" in window \|\| navigator.maxTouchPoints > 0;\n if (!hasTouch) return false;\n\n // If matchMedia is available, check whether the primary pointer is fine\n // (mouse/trackpad). Touchscreen laptops report fine, real mobile devices don't.\n if (typeof window.matchMedia === \"function\") {\n return !window.matchMedia(\"(pointer: fine)\").matches;\n }\n\n // Fallback: touch present but no matchMedia — assume mobile\n return true;\n};\n\n/\n Checks if the current domain is the production domain\n * @returns True if the current domain matches the production URL\n /\nexport const isProductionDomain = (): boolean =>\n window.location.origin === PRODUCT_URL.PRODUCTION;\n\ninterface EventActionHistory {\n args?: {\n LLM_API_KEY?: string;\n [key: string]: unknown;\n };\n extras?: {\n open_page_urls: string[];\n active_page_index: number;\n dom_object: Record<string, unknown>;\n axtree_object: Record<string, unknown>;\n extra_element_properties: Record<string, unknown>;\n last_browser_action: string;\n last_browser_action_error: unknown;\n focused_element_bid: string;\n };\n [key: string]: unknown;\n}\n\nexport const removeUnwantedKeys = (\n data: EventActionHistory[],\n): EventActionHistory[] => {\n const UNDESIRED_KEYS = [\n \"open_page_urls\",\n \"active_page_index\",\n \"dom_object\",\n \"axtree_object\",\n \"extra_element_properties\",\n \"last_browser_action\",\n \"last_browser_action_error\",\n \"focused_element_bid\",\n ];\n\n return data\n .filter((item) => {\n // Skip items that have a status key\n if (\"status\" in item) {\n return false;\n }\n return true;\n })\n .map((item) => {\n // Create a shallow copy of item\n const newItem = { ...item };\n\n // Check if extras exists and delete it from a new extras object\n if (newItem.extras) {\n const newExtras = { ...newItem.extras };\n UNDESIRED_KEYS.forEach((key) => {\n delete newExtras[key as keyof typeof newExtras];\n });\n newItem.extras = newExtras;\n }\n\n return newItem;\n });\n};\n\n/\n Get file extension from file name in uppercase format\n * @param fileName The file name to extract extension from\n * @returns The file extension in uppercase, or \"FILE\" if no extension found\n \n @example\n * getFileExtension(\"document.pdf\") // \"PDF\"\n * getFileExtension(\"image.jpeg\") // \"JPEG\"\n * getFileExtension(\"noextension\") // \"FILE\"\n /\nexport const getFileExtension = (fileName: string): string => {\n const extension = fileName.split(\".\").pop()?.toUpperCase();\n return extension \|\| \"FILE\";\n};\n\n/\n Whether to use the installation-scoped repo flow\n * (`/api/v1/git/installations/search` → `/api/v1/git/repositories/search?installation_id=…`)\n * for the given provider/backend combo.\n \n Mirrors OpenHands' cloud frontend (parameterized by `app_mode`):\n * - bitbucket / bitbucket_data_center → always installation-based\n * - github → installation-based ONLY when the active backend is cloud\n * - gitlab / azure_devops / forgejo → direct (search) flow\n \n `appMode` accepts the active backend `kind` (\"local\" \| \"cloud\") so call\n * sites can hand it through directly.\n /\nexport const shouldUseInstallationRepos = (\n provider: Provider \| null \| undefined,\n appMode?: \"local\" \| \"cloud\",\n) => {\n if (!provider) return false;\n\n switch (provider) {\n case \"bitbucket\":\n case \"bitbucket_data_center\":\n return true;\n case \"github\":\n return appMode === \"cloud\";\n default:\n return false;\n }\n};\n\nexport const getGitProviderBaseUrl = (\n gitProvider: Provider,\n host?: string \| null,\n): string => {\n // If custom host provided, use it (with https:// prefix if needed)\n if (host && host.trim() !== \"\") {\n return host.startsWith(\"http\") ? host : `https://${host}`;\n }\n\n // Fall back to defaults\n switch (gitProvider) {\n case \"github\":\n return \"https://github.com\";\n case \"gitlab\":\n return \"https://gitlab.com\";\n case \"bitbucket\":\n return \"https://bitbucket.org\";\n case \"azure_devops\":\n return \"https://dev.azure.com\";\n case \"forgejo\":\n // Default UI links to Codeberg unless a custom host is available in settings\n // Note: UI link builders don't currently receive host; consider plumbing settings if needed\n return \"https://codeberg.org\";\n default:\n return \"\";\n }\n};\n\n/\n Get the name of the git provider\n * @param gitProvider The git provider\n * @returns The name of the git provider\n /\nexport const getProviderName = (gitProvider: Provider) => {\n if (gitProvider === \"gitlab\") return \"GitLab\";\n if (gitProvider === \"bitbucket\") return \"Bitbucket\";\n if (gitProvider === \"bitbucket_data_center\") return \"Bitbucket Data Center\";\n if (gitProvider === \"azure_devops\") return \"Azure DevOps\";\n if (gitProvider === \"forgejo\") return \"Forgejo\";\n return \"GitHub\";\n};\n\n/\n Get the name of the PR\n * @param isGitLab Whether the git provider is GitLab\n * @returns The name of the PR\n /\nexport const getPR = (isGitLab: boolean) =>\n isGitLab ? \"merge request\" : \"pull request\";\n\n/\n Get the short name of the PR\n * @param isGitLab Whether the git provider is GitLab\n * @returns The short name of the PR\n /\nexport const getPRShort = (isGitLab: boolean) => (isGitLab ? \"MR\" : \"PR\");\n\n/\n Construct the pull request (merge request) URL for different providers\n * @param prNumber The pull request number\n * @param provider The git provider\n * @param repositoryName The repository name in format \"owner/repo\"\n * @returns The pull request URL\n \n @example\n * constructPullRequestUrl(123, \"github\", \"owner/repo\") // \"https://github.com/owner/repo/pull/123\"\n * constructPullRequestUrl(456, \"gitlab\", \"owner/repo\") // \"https://gitlab.com/owner/repo/-/merge_requests/456\"\n * constructPullRequestUrl(789, \"bitbucket\", \"owner/repo\") // \"https://bitbucket.org/owner/repo/pull-requests/789\"\n * constructPullRequestUrl(789, \"bitbucket\", \"PROJECT/repo\", \"server.com\") // \"https://server.com/projects/PROJECT/repos/repo/pull-requests/789\"\n /\nexport const constructPullRequestUrl = (\n prNumber: number,\n provider: Provider,\n repositoryName: string,\n host?: string \| null,\n): string => {\n const baseUrl = getGitProviderBaseUrl(provider, host);\n\n switch (provider) {\n case \"github\":\n return `${baseUrl}/${repositoryName}/pull/${prNumber}`;\n case \"forgejo\":\n return `${baseUrl}/${repositoryName}/pull/${prNumber}`;\n case \"gitlab\":\n return `${baseUrl}/${repositoryName}/-/merge_requests/${prNumber}`;\n case \"bitbucket\":\n return `${baseUrl}/${repositoryName}/pull-requests/${prNumber}`;\n case \"bitbucket_data_center\": {\n const [project, repo] = repositoryName.split(\"/\");\n return `${baseUrl}/projects/${project}/repos/${repo}/pull-requests/${prNumber}`;\n }\n case \"azure_devops\": {\n // Azure DevOps format: org/project/repo\n const parts = repositoryName.split(\"/\");\n if (parts.length === 3) {\n const [org, project, repo] = parts;\n return `${baseUrl}/${org}/${project}/_git/${repo}/pullrequest/${prNumber}`;\n }\n return \"\";\n }\n default:\n return \"\";\n }\n};\n\n/\n Construct the microagent URL for different providers\n * @param gitProvider The git provider\n * @param repositoryName The repository name in format \"owner/repo\"\n * @param microagentPath The path to the microagent in the repository\n * @returns The URL to the microagent file in the Git provider\n \n @example\n * constructMicroagentUrl(\"github\", \"owner/repo\", \".openhands/microagents/tell-me-a-joke.md\")\n * // \"https://github.com/owner/repo/blob/main/.openhands/microagents/tell-me-a-joke.md\"\n * constructMicroagentUrl(\"gitlab\", \"owner/repo\", \"microagents/git-helper.md\")\n * // \"https://gitlab.com/owner/repo/-/blob/main/microagents/git-helper.md\"\n * constructMicroagentUrl(\"bitbucket\", \"owner/repo\", \".openhands/microagents/docker-helper.md\")\n * // \"https://bitbucket.org/owner/repo/src/main/.openhands/microagents/docker-helper.md\"\n /\nexport const constructMicroagentUrl = (\n gitProvider: Provider,\n repositoryName: string,\n microagentPath: string,\n host?: string \| null,\n): string => {\n const baseUrl = getGitProviderBaseUrl(gitProvider, host);\n\n switch (gitProvider) {\n case \"github\":\n return `${baseUrl}/${repositoryName}/blob/main/${microagentPath}`;\n case \"forgejo\":\n return `${baseUrl}/${repositoryName}/src/branch/main/${microagentPath}`;\n case \"gitlab\":\n return `${baseUrl}/${repositoryName}/-/blob/main/${microagentPath}`;\n case \"bitbucket\":\n return `${baseUrl}/${repositoryName}/src/main/${microagentPath}`;\n case \"bitbucket_data_center\": {\n const [project, repo] = repositoryName.split(\"/\");\n return `${baseUrl}/projects/${project}/repos/${repo}/browse/${microagentPath}?at=refs/heads/main`;\n }\n case \"azure_devops\": {\n // Azure DevOps format: org/project/repo\n const parts = repositoryName.split(\"/\");\n if (parts.length === 3) {\n const [org, project, repo] = parts;\n return `${baseUrl}/${org}/${project}/_git/${repo}?path=/${microagentPath}&version=GBmain`;\n }\n return \"\";\n }\n default:\n return \"\";\n }\n};\n\n/\n Extract repository owner, repo name, and file path from repository and microagent data\n * @param selectedRepository The selected repository object with full_name property\n * @param microagent The microagent object with path property\n * @returns Object containing owner, repo, and filePath\n \n @example\n * const { owner, repo, filePath } = extractRepositoryInfo(selectedRepository, microagent);\n /\nexport const extractRepositoryInfo = (\n selectedRepository: { full_name?: string } \| null \| undefined,\n microagent: { path?: string } \| null \| undefined,\n) => {\n const [owner, repo] = selectedRepository?.full_name?.split(\"/\") \|\| [];\n const filePath = microagent?.path \|\| \"\";\n\n return { owner, repo, filePath };\n};\n\n/\n Construct the repository URL for different providers\n * @param provider The git provider\n * @param repositoryName The repository name in format \"owner/repo\"\n * @returns The repository URL\n \n @example\n * constructRepositoryUrl(\"github\", \"owner/repo\") // \"https://github.com/owner/repo\"\n * constructRepositoryUrl(\"gitlab\", \"owner/repo\") // \"https://gitlab.com/owner/repo\"\n * constructRepositoryUrl(\"bitbucket\", \"owner/repo\") // \"https://bitbucket.org/owner/repo\"\n /\nexport const constructRepositoryUrl = (\n provider: Provider,\n repositoryName: string,\n host?: string \| null,\n): string => {\n const baseUrl = getGitProviderBaseUrl(provider, host);\n if (provider === \"bitbucket_data_center\") {\n const [project, repo] = repositoryName.split(\"/\");\n return `${baseUrl}/projects/${project}/repos/${repo}`;\n }\n return `${baseUrl}/${repositoryName}`;\n};\n\n/\n Construct the branch URL for different providers\n * @param provider The git provider\n * @param repositoryName The repository name in format \"owner/repo\"\n * @param branchName The branch name\n * @param host Optional custom host for self-hosted instances\n * @returns The branch URL\n \n @example\n * constructBranchUrl(\"github\", \"owner/repo\", \"main\") // \"https://github.com/owner/repo/tree/main\"\n * constructBranchUrl(\"gitlab\", \"owner/repo\", \"develop\") // \"https://gitlab.com/owner/repo/-/tree/develop\"\n * constructBranchUrl(\"bitbucket\", \"owner/repo\", \"feature\") // \"https://bitbucket.org/owner/repo/src/feature\"\n * constructBranchUrl(\"bitbucket\", \"PROJECT/repo\", \"feature\", \"server.com\") // \"https://server.com/projects/PROJECT/repos/repo/browse?at=refs/heads/feature\"\n /\nexport const constructBranchUrl = (\n provider: Provider,\n repositoryName: string,\n branchName: string,\n host?: string \| null,\n): string => {\n const baseUrl = getGitProviderBaseUrl(provider, host);\n\n switch (provider) {\n case \"github\":\n return `${baseUrl}/${repositoryName}/tree/${branchName}`;\n case \"forgejo\":\n return `${baseUrl}/${repositoryName}/src/branch/${branchName}`;\n case \"gitlab\":\n return `${baseUrl}/${repositoryName}/-/tree/${branchName}`;\n case \"bitbucket\":\n return `${baseUrl}/${repositoryName}/src/${branchName}`;\n case \"bitbucket_data_center\": {\n // Bitbucket Server format: /projects/{PROJECT}/repos/{repo}/browse?at=refs/heads/{branch}\n const parts = repositoryName.split(\"/\");\n if (parts.length >= 2) {\n const [project, repo] = parts;\n return `${baseUrl}/projects/${project}/repos/${repo}/browse?at=refs/heads/${branchName}`;\n }\n return \"\";\n }\n case \"azure_devops\": {\n // Azure DevOps format: org/project/repo\n const parts = repositoryName.split(\"/\");\n if (parts.length === 3) {\n const [org, project, repo] = parts;\n return `${baseUrl}/${org}/${project}/_git/${repo}?version=GB${branchName}`;\n }\n return \"\";\n }\n default:\n return \"\";\n }\n};\n\n// Git Action Prompts\n\n/\n Generate a git pull prompt\n * @returns The git pull prompt\n /\nexport const getGitPullPrompt = (): string =>\n \"Please pull the latest code from the repository.\";\n\n/\n Generate a git push prompt\n * @param gitProvider The git provider\n * @returns The git push prompt\n /\nexport const getGitPushPrompt = (gitProvider: Provider): string => {\n const providerName = getProviderName(gitProvider);\n const pr = getPR(gitProvider === \"gitlab\");\n\n return `Please push the changes to a remote branch on ${providerName}, but do NOT create a ${pr}. Check your current branch name first - if it's main, master, deploy, or another common default branch name, create a new branch with a descriptive name related to your changes. Otherwise, use the exact SAME branch name as the one you are currently on.`;\n};\n\n/\n Generate a create pull request prompt\n * @param gitProvider The git provider\n * @returns The create PR prompt\n /\nexport const getCreatePRPrompt = (gitProvider: Provider): string => {\n const providerName = getProviderName(gitProvider);\n const pr = getPR(gitProvider === \"gitlab\");\n const prShort = getPRShort(gitProvider === \"gitlab\");\n\n return `Please push the changes to ${providerName} and open a ${pr}. If you're on a default branch (e.g., main, master, deploy), create a new branch with a descriptive name otherwise use the current branch. If a ${pr} template exists in the repository, please follow it when creating the ${prShort} description.`;\n};\n\n/\n Generate a push to existing PR prompt\n * @param gitProvider The git provider\n * @returns The push to PR prompt\n /\nexport const getPushToPRPrompt = (gitProvider: Provider): string => {\n const pr = getPR(gitProvider === \"gitlab\");\n\n return `Please push the latest changes to the existing ${pr}.`;\n};\n\n/\n Generate a create new branch prompt\n * @returns The create new branch prompt\n /\nexport const getCreateNewBranchPrompt = (): string =>\n \"Please create a new branch with a descriptive name related to the work you plan to do.\";\n\n// Helper functions\nexport function getTotalTaskCount(\n suggestedTasks: SuggestedTaskGroup[] \| undefined,\n): number {\n if (!suggestedTasks) return 0;\n return suggestedTasks.flatMap((group) => group.tasks).length;\n}\n\nexport function getLimitedTaskGroups(\n suggestedTasks: SuggestedTaskGroup[],\n maxTasks: number,\n): SuggestedTaskGroup[] {\n const limitedGroups: SuggestedTaskGroup[] = [];\n let taskCount = 0;\n\n for (const group of suggestedTasks) {\n if (taskCount >= maxTasks) break;\n\n const remainingTasksNeeded = maxTasks - taskCount;\n const tasksToShow = group.tasks.slice(0, remainingTasksNeeded);\n\n if (tasksToShow.length > 0) {\n limitedGroups.push({\n ...group,\n tasks: tasksToShow,\n });\n taskCount += tasksToShow.length;\n }\n }\n\n return limitedGroups;\n}\n\nexport function getDisplayedTaskGroups(\n suggestedTasks: SuggestedTaskGroup[] \| undefined,\n isExpanded: boolean,\n): SuggestedTaskGroup[] {\n if (!suggestedTasks \|\| suggestedTasks.length === 0) {\n return [];\n }\n\n if (isExpanded) {\n return suggestedTasks;\n }\n\n return getLimitedTaskGroups(suggestedTasks, 3);\n}\n\n/\n Get the repository markdown creation prompt with additional PR creation instructions\n * @param gitProvider The git provider to use for generating provider-specific text\n * @param query Optional custom query to use instead of the default prompt\n * @returns The complete prompt for creating repository markdown and PR instructions\n /\nexport const getRepoMdCreatePrompt = (\n gitProvider: Provider,\n query?: string,\n): string => {\n const providerName = getProviderName(gitProvider);\n const pr = getPR(gitProvider === \"gitlab\");\n const prShort = getPRShort(gitProvider === \"gitlab\");\n\n return `Please explore this repository. Create the file .openhands/microagents/repo.md with:\n ${\n query\n ? `- ${query}`\n : `- A description of the project\n - An overview of the file structure\n - Any information on how to run tests or other relevant commands\n - Any other information that would be helpful to a brand new developer\n Keep it short--just a few paragraphs will do.`\n }\n\nPlease push the changes to your branch on ${providerName} and create a ${pr}. Please create a meaningful branch name that describes the changes. If a ${pr} template exists in the repository, please follow it when creating the ${prShort} description.`;\n};\n\n/\n Get the label for a conversation status\n * @param status The conversation status\n * @returns The localized label for the status\n /\nexport const getConversationStatusLabel = (\n status: ConversationStatus,\n): string => {\n switch (status) {\n case \"STOPPED\":\n return \"COMMON$STOPPED\";\n case \"RUNNING\":\n return \"COMMON$RUNNING\";\n case \"STARTING\":\n return \"COMMON$STARTING\";\n case \"ERROR\":\n return \"COMMON$ERROR\";\n case \"ARCHIVED\":\n return \"COMMON$ARCHIVED\"; // Use STOPPED for archived conversations\n default:\n return \"COMMON$UNKNOWN\";\n }\n};\n\n// Task Tracking Utility Functions\n\n/\n Get the status icon for a task status\n * @param status The task status\n * @returns The emoji icon for the status\n /\nexport const getStatusIcon = (status: string) => {\n switch (status) {\n case \"todo\":\n return \"⏳\";\n case \"in_progress\":\n return \"🔄\";\n case \"done\":\n return \"✅\";\n default:\n return \"❓\";\n }\n};\n\n/\n Get the CSS class names for a task status badge\n * @param status The task status\n * @returns The CSS class names for styling the status badge\n /\nexport const getStatusClassName = (status: string) => {\n if (status === \"done\") {\n return \"bg-green-800 text-green-200\";\n }\n if (status === \"in_progress\") {\n return \"bg-yellow-800 text-yellow-200\";\n }\n return \"bg-tertiary text-[var(--oh-text-tertiary)]\";\n};\n\n/\n Helper function to apply client-side filtering based on search query\n * @param repo The Git repository to check\n * @param searchQuery The search query string\n * @returns True if the repository should be included based on the search query\n /\nexport const shouldIncludeRepository = (\n repo: GitRepository,\n searchQuery: string,\n): boolean => {\n if (!searchQuery.trim()) {\n return true;\n }\n\n const sanitizedQuery = sanitizeQuery(searchQuery);\n const sanitizedRepoName = sanitizeQuery(repo.full_name);\n return sanitizedRepoName.includes(sanitizedQuery);\n};\n\n/\n Get the OpenHands query string based on the provider\n * @param provider The git provider\n * @returns The query string for searching OpenHands repositories\n /\nexport const getOpenHandsQuery = (provider: Provider \| null): string => {\n const providerRepositorySuffix: Record<string, string> = {\n gitlab: \"openhands-config\",\n azure_devops: \"openhands-config\",\n default: \".openhands\",\n } as const;\n\n return provider && provider in providerRepositorySuffix\n ? providerRepositorySuffix[provider]\n : providerRepositorySuffix.default;\n};\n\n/\n Check if a repository has the OpenHands suffix based on the provider\n * @param repo The Git repository to check\n * @param provider The git provider\n * @returns True if the repository has the OpenHands suffix\n /\nexport const hasOpenHandsSuffix = (\n repo: GitRepository,\n provider: Provider \| null,\n): boolean => repo.full_name.endsWith(`/${getOpenHandsQuery(provider)}`);\n\n/\n Build headers for V1 API requests that require session authentication\n * @param sessionApiKey Session API key for authentication\n * @returns Headers object with X-Session-API-Key if provided\n /\nexport const buildSessionHeaders = (\n sessionApiKey?: string \| null,\n): Record<string, string> => {\n const headers: Record<string, string> = {};\n if (sessionApiKey) {\n headers[\"X-Session-API-Key\"] = sessionApiKey;\n }\n return headers;\n};\n\n/\n Check if a task is currently being polled (loading state)\n * @param taskStatus The task status string (e.g., \"WORKING\", \"ERROR\", \"READY\")\n * @returns True if the task is in a loading state (not ERROR and not READY)\n \n @example\n * isTaskPolling(\"WORKING\") // Returns true\n * isTaskPolling(\"PREPARING_REPOSITORY\") // Returns true\n * isTaskPolling(\"READY\") // Returns false\n * isTaskPolling(\"ERROR\") // Returns false\n * isTaskPolling(null) // Returns false\n * isTaskPolling(undefined) // Returns false\n /\nexport const isTaskPolling = (taskStatus: string \| null \| undefined): boolean =>\n !!taskStatus && taskStatus !== \"ERROR\" && taskStatus !== \"READY\";\n\n/\n Get the appropriate color based on agent status\n * @param options Configuration object for status color calculation\n * @param options.isPausing Whether the agent is currently pausing\n * @param options.isTask Whether we're polling a task\n * @param options.taskStatus The task status string (e.g., \"ERROR\", \"READY\")\n * @param options.isStartingStatus Whether the agent is in a starting state (LOADING or INIT)\n * @param options.isStopStatus Whether the conversation status is STOPPED\n * @param options.curAgentState The current agent state\n * @returns The hex color code for the status\n \n @example\n * getStatusColor({\n * isPausing: false,\n * isTask: false,\n * taskStatus: undefined,\n * isStartingStatus: false,\n * isStopStatus: false,\n * curAgentState: AgentState.RUNNING\n * }) // Returns \"var(--oh-status-success)\"\n /\nexport const getStatusColor = (options: {\n isPausing: boolean;\n isTask: boolean;\n taskStatus?: string \| null;\n isStartingStatus: boolean;\n isStopStatus: boolean;\n curAgentState: AgentState;\n}): string => {\n const {\n isPausing,\n isTask,\n taskStatus,\n isStartingStatus,\n isStopStatus,\n curAgentState,\n } = options;\n\n // Show pausing status\n if (isPausing) {\n return \"#FFD600\";\n }\n\n // Show task status if we're polling a task\n if (isTask && taskStatus) {\n if (taskStatus === \"ERROR\") {\n return OH_STATUS_ERROR_COLOR;\n }\n return \"#FFD600\";\n }\n\n if (isStartingStatus) {\n return \"#FFD600\";\n }\n if (isStopStatus) {\n return \"#ffffff\";\n }\n if (curAgentState === AgentState.ERROR) {\n return OH_STATUS_ERROR_COLOR;\n }\n return OH_STATUS_SUCCESS_COLOR;\n};\n\ninterface GetStatusTextArgs {\n isPausing: boolean;\n isTask: boolean;\n taskStatus?: AppConversationStartTaskStatus \| null;\n taskDetail?: string \| null;\n isStartingStatus: boolean;\n isStopStatus: boolean;\n curAgentState: AgentState;\n errorMessage?: string \| null;\n t: (t: string) => string;\n}\n\n/\n Get the server status text based on agent and task state\n \n @param options Configuration object for status text calculation\n * @param options.isPausing Whether the agent is currently pausing\n * @param options.isTask Whether we're polling a task\n * @param options.taskStatus The task status string (e.g., \"ERROR\", \"READY\")\n * @param options.taskDetail Optional task-specific detail text\n * @param options.isStartingStatus Whether the conversation is in STARTING state\n * @param options.isStopStatus Whether the conversation is STOPPED\n * @param options.curAgentState The current agent state\n * @param options.errorMessage Optional agent error message\n * @returns Localized human-readable status text\n \n @example\n * getStatusText({\n * isPausing: false,\n * isTask: true,\n * taskStatus: \"STARTING_CONVERSATION\",\n * taskDetail: null,\n * isStartingStatus: false,\n * isStopStatus: false,\n * curAgentState: AgentState.RUNNING\n * }) // Returns \"Starting conversation\"\n */\nexport function getStatusText({\n isPausing = false,\n isTask,\n taskStatus,\n taskDetail,\n isStartingStatus,\n isStopStatus,\n curAgentState,\n errorMessage,\n t,\n}: GetStatusTextArgs): string {\n // Show pausing status\n if (isPausing) {\n return t(I18nKey.COMMON$STOPPING);\n }\n\n // Show task status if we're polling a task\n if (isTask && taskStatus) {\n if (taskStatus === \"ERROR\") {\n return taskDetail \|\| t(I18nKey.CONVERSATION$ERROR_STARTING_CONVERSATION);\n }\n\n if (taskStatus === \"READY\") {\n return t(I18nKey.CONVERSATION$READY);\n }\n\n return taskDetail \|\| t(getTaskStatusI18nKey(taskStatus));\n }\n\n if (isStartingStatus) {\n return t(I18nKey.COMMON$STARTING);\n }\n\n if (isStopStatus) {\n return t(I18nKey.COMMON$SERVER_STOPPED);\n }\n\n if (curAgentState === AgentState.ERROR) {\n return errorMessage \|\| t(I18nKey.COMMON$ERROR);\n }\n\n return t(I18nKey.COMMON$RUNNING);\n}\n"],"mappings":";;;;;;;AAiBA,SAAgB,EAAG,GAAG,GAAsB;CAC1C,OAAO,EAAQ,EAAK,CAAM,CAAC;AAC7B;AAKA,IAAa,KAAgB,GAAY,MAA2B;CAClE,IAAM,IAAM,OAAO,IAAI,gBAAgB,CAAI,GACrC,IAAO,SAAS,cAAc,GAAG;CAMvC,AALA,EAAK,OAAO,GACZ,EAAK,WAAW,GAChB,SAAS,KAAK,YAAY,CAAI,GAC9B,EAAK,MAAM,GACX,SAAS,KAAK,YAAY,CAAI,GAC9B,OAAO,IAAI,gBAAgB,CAAG;AAChC,GAYa,KAAoB,GAAiB,MAA6B;CAC7E,IAAM,IAAgB,WAAW,EAAG,MAAM,UAAU,EAAE;CACtD,OAAO,OAAO,SAAS,CAAa,IAAI,IAAgB;AAC1D,GAWa,KAAoB,GAAiB,MAAyB;CACzE,EAAG,MAAM,YAAY,UAAU,GAAG,EAAO,GAAG;AAC9C,GAQa,UACX,iEAAiE,KAC/D,UAAU,SACZ,GAQW,UACP,EAAkB,IAAU,KAEf,kBAAkB,UAAU,UAAU,iBAAiB,IAKpE,OAAO,OAAO,cAAe,aACxB,CAAC,OAAO,WAAW,iBAAiB,EAAE,UAIxC,KATe,IAsFX,KAAoB,MACb,EAAS,MAAM,GAAG,EAAE,IAAI,GAAG,YAAY,KACrC,QAgBT,KACX,GACA,MACG;CACH,IAAI,CAAC,GAAU,OAAO;CAEtB,QAAQ,GAAR;EACE,KAAK;EACL,KAAK,yBACH,OAAO;EACT,KAAK,UACH,OAAO,MAAY;EACrB,SACE,OAAO;CACX;AACF,GAEa,KACX,GACA,MACW;CAEX,IAAI,KAAQ,EAAK,KAAK,MAAM,IAC1B,OAAO,EAAK,WAAW,MAAM,IAAI,IAAO,WAAW;CAIrD,QAAQ,GAAR;EACE,KAAK,UACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,gBACH,OAAO;EACT,KAAK,WAGH,OAAO;EACT,SACE,OAAO;CACX;AACF,GAOa,KAAmB,MAC1B,MAAgB,WAAiB,WACjC,MAAgB,cAAoB,cACpC,MAAgB,0BAAgC,0BAChD,MAAgB,iBAAuB,iBACvC,MAAgB,YAAkB,YAC/B,UAQI,KAAS,MACpB,IAAW,kBAAkB,gBAOlB,KAAc,MAAuB,IAAW,OAAO,MAkIvD,KACX,GACA,GACA,MACW;CACX,IAAM,IAAU,EAAsB,GAAU,CAAI;CACpD,IAAI,MAAa,yBAAyB;EACxC,IAAM,CAAC,GAAS,KAAQ,EAAe,MAAM,GAAG;EAChD,OAAO,GAAG,EAAQ,YAAY,EAAQ,SAAS;CACjD;CACA,OAAO,GAAG,EAAQ,GAAG;AACvB,GAgBa,KACX,GACA,GACA,GACA,MACW;CACX,IAAM,IAAU,EAAsB,GAAU,CAAI;CAEpD,QAAQ,GAAR;EACE,KAAK,UACH,OAAO,GAAG,EAAQ,GAAG,EAAe,QAAQ;EAC9C,KAAK,WACH,OAAO,GAAG,EAAQ,GAAG,EAAe,cAAc;EACpD,KAAK,UACH,OAAO,GAAG,EAAQ,GAAG,EAAe,UAAU;EAChD,KAAK,aACH,OAAO,GAAG,EAAQ,GAAG,EAAe,OAAO;EAC7C,KAAK,yBAAyB;GAE5B,IAAM,IAAQ,EAAe,MAAM,GAAG;GACtC,IAAI,EAAM,UAAU,GAAG;IACrB,IAAM,CAAC,GAAS,KAAQ;IACxB,OAAO,GAAG,EAAQ,YAAY,EAAQ,SAAS,EAAK,wBAAwB;GAC9E;GACA,OAAO;EACT;EACA,KAAK,gBAAgB;GAEnB,IAAM,IAAQ,EAAe,MAAM,GAAG;GACtC,IAAI,EAAM,WAAW,GAAG;IACtB,IAAM,CAAC,GAAK,GAAS,KAAQ;IAC7B,OAAO,GAAG,EAAQ,GAAG,EAAI,GAAG,EAAQ,QAAQ,EAAK,aAAa;GAChE;GACA,OAAO;EACT;EACA,SACE,OAAO;CACX;AACF,GAQa,UACX,oDAOW,KAAoB,MAIxB,iDAHc,EAAgB,CAGmB,EAAa,wBAF1D,EAAM,MAAgB,QAE4D,EAAG,gQAQrF,KAAqB,MAAkC;CAClE,IAAM,IAAe,EAAgB,CAAW,GAC1C,IAAK,EAAM,MAAgB,QAAQ;CAGzC,OAAO,8BAA8B,EAAa,cAAc,EAAG,mJAAmJ,EAAG,yEAFzM,EAAW,MAAgB,QAEuP,EAAQ;AAC5S,GAiBa,UACX,0FAoNW,KAAiB,MAC5B,CAAC,CAAC,KAAc,MAAe,WAAW,MAAe,SAuB9C,KAAkB,MAOjB;CACZ,IAAM,EACJ,cACA,WACA,eACA,qBACA,iBACA,qBACE;CAwBJ,OArBI,IACK,YAIL,KAAU,IACR,MAAe,UACV,IAEF,YAGL,IACK,YAEL,IACK,YAEL,MAAkB,EAAW,QACxB,IAEF;AACT;AAuCA,SAAgB,EAAc,EAC5B,eAAY,IACZ,WACA,eACA,eACA,qBACA,iBACA,kBACA,iBACA,QAC4B;CA+B5B,OA7BI,IACK,EAAE,EAAQ,eAAe,IAI9B,KAAU,IACR,MAAe,UACV,KAAc,EAAE,EAAQ,wCAAwC,IAGrE,MAAe,UACV,EAAE,EAAQ,kBAAkB,IAG9B,KAAc,EAAE,EAAqB,CAAU,CAAC,IAGrD,IACK,EAAE,EAAQ,eAAe,IAG9B,IACK,EAAE,EAAQ,qBAAqB,IAGpC,MAAkB,EAAW,QACxB,KAAgB,EAAE,EAAQ,YAAY,IAGxC,EAAE,EAAQ,cAAc;AACjC"}
1	+ {"version":3,"file":"utils.js","names":[],"sources":["../../src/utils/utils.ts"],"sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\nimport { Provider } from \"#/types/settings\";\nimport { SuggestedTaskGroup } from \"#/utils/types\";\nimport { ConversationStatus } from \"#/types/conversation-status\";\nimport { GitRepository } from \"#/types/git\";\nimport { sanitizeQuery } from \"#/utils/sanitize-query\";\nimport { PRODUCT_URL } from \"#/utils/constants\";\nimport { AgentState } from \"#/types/agent-state\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { getTaskStatusI18nKey } from \"#/utils/status\";\nimport type { AppConversationStartTaskStatus } from \"#/api/conversation-service/agent-server-conversation-service.types\";\nimport {\n OH_STATUS_ERROR_COLOR,\n OH_STATUS_SUCCESS_COLOR,\n} from \"#/constants/status-colors\";\n\nexport function cn(...inputs: ClassValue[]) {\n return twMerge(clsx(inputs));\n}\n\n/*\n Trigger a download for a provided Blob with the given filename\n /\nexport const downloadBlob = (blob: Blob, filename: string): void => {\n const url = window.URL.createObjectURL(blob);\n const link = document.createElement(\"a\");\n link.href = url;\n link.download = filename;\n document.body.appendChild(link);\n link.click();\n document.body.removeChild(link);\n window.URL.revokeObjectURL(url);\n};\n\n/\n Get the numeric height value from an element's style property\n * @param el The HTML element to get the height from\n * @param fallback The fallback value to return if style height is invalid\n * @returns The numeric height value in pixels, or the fallback value\n \n @example\n * getStyleHeightPx(element, 20) // Returns 20 if element.style.height is \"auto\" or invalid\n * getStyleHeightPx(element, 20) // Returns 100 if element.style.height is \"100px\"\n /\nexport const getStyleHeightPx = (el: HTMLElement, fallback: number): number => {\n const elementHeight = parseFloat(el.style.height \|\| \"\");\n return Number.isFinite(elementHeight) ? elementHeight : fallback;\n};\n\n/\n Set the height style property of an element to a specific pixel value\n * @param el The HTML element to set the height for\n * @param height The height value in pixels to set\n \n @example\n * setStyleHeightPx(element, 100) // Sets element.style.height to \"100px\"\n * setStyleHeightPx(textarea, 200) // Sets textarea.style.height to \"200px\"\n /\nexport const setStyleHeightPx = (el: HTMLElement, height: number): void => {\n el.style.setProperty(\"height\", `${height}px`);\n};\n\n/\n Detect a phone/tablet user agent (Android, iPhone, iPad, …).\n * Unlike isMobileDevice, this ignores touch capability, so a desktop OS with\n * a touchscreen (e.g. a Windows 2-in-1) is NOT matched. Use this when the\n * decision depends on having a physical keyboard rather than on touch input.\n /\nexport const isMobileUserAgent = (): boolean =>\n /Android\|webOS\|iPhone\|iPad\|iPod\|BlackBerry\|IEMobile\|Opera Mini/i.test(\n navigator.userAgent,\n );\n\n/\n Detect if the user is on a mobile device.\n * Touch support alone is not sufficient — touchscreen laptops have touch\n * but use a mouse/trackpad as primary input. We check that the primary\n * pointing device is coarse (finger) to avoid false positives.\n /\nexport const isMobileDevice = (): boolean => {\n if (isMobileUserAgent()) return true;\n\n const hasTouch = \"ontouchstart\" in window \|\| navigator.maxTouchPoints > 0;\n if (!hasTouch) return false;\n\n // If matchMedia is available, check whether the primary pointer is fine\n // (mouse/trackpad). Touchscreen laptops report fine, real mobile devices don't.\n if (typeof window.matchMedia === \"function\") {\n return !window.matchMedia(\"(pointer: fine)\").matches;\n }\n\n // Fallback: touch present but no matchMedia — assume mobile\n return true;\n};\n\n/\n Checks if the current domain is the production domain\n * @returns True if the current domain matches the production URL\n /\nexport const isProductionDomain = (): boolean =>\n window.location.origin === PRODUCT_URL.PRODUCTION;\n\ninterface EventActionHistory {\n args?: {\n LLM_API_KEY?: string;\n [key: string]: unknown;\n };\n extras?: {\n open_page_urls: string[];\n active_page_index: number;\n dom_object: Record<string, unknown>;\n axtree_object: Record<string, unknown>;\n extra_element_properties: Record<string, unknown>;\n last_browser_action: string;\n last_browser_action_error: unknown;\n focused_element_bid: string;\n };\n [key: string]: unknown;\n}\n\nexport const removeUnwantedKeys = (\n data: EventActionHistory[],\n): EventActionHistory[] => {\n const UNDESIRED_KEYS = [\n \"open_page_urls\",\n \"active_page_index\",\n \"dom_object\",\n \"axtree_object\",\n \"extra_element_properties\",\n \"last_browser_action\",\n \"last_browser_action_error\",\n \"focused_element_bid\",\n ];\n\n return data\n .filter((item) => {\n // Skip items that have a status key\n if (\"status\" in item) {\n return false;\n }\n return true;\n })\n .map((item) => {\n // Create a shallow copy of item\n const newItem = { ...item };\n\n // Check if extras exists and delete it from a new extras object\n if (newItem.extras) {\n const newExtras = { ...newItem.extras };\n UNDESIRED_KEYS.forEach((key) => {\n delete newExtras[key as keyof typeof newExtras];\n });\n newItem.extras = newExtras;\n }\n\n return newItem;\n });\n};\n\n/\n Get file extension from file name in uppercase format\n * @param fileName The file name to extract extension from\n * @returns The file extension in uppercase, or \"FILE\" if no extension found\n \n @example\n * getFileExtension(\"document.pdf\") // \"PDF\"\n * getFileExtension(\"image.jpeg\") // \"JPEG\"\n * getFileExtension(\"noextension\") // \"FILE\"\n /\nexport const getFileExtension = (fileName: string): string => {\n const extension = fileName.split(\".\").pop()?.toUpperCase();\n return extension \|\| \"FILE\";\n};\n\n/\n Whether to use the installation-scoped repo flow\n * (`/api/v1/git/installations/search` → `/api/v1/git/repositories/search?installation_id=…`)\n * for the given provider/backend combo.\n \n Mirrors OpenHands' cloud frontend (parameterized by `app_mode`):\n * - bitbucket / bitbucket_data_center → always installation-based\n * - github → installation-based ONLY when the active backend is cloud\n * - gitlab / azure_devops / forgejo → direct (search) flow\n \n `appMode` accepts the active backend `kind` (\"local\" \| \"cloud\") so call\n * sites can hand it through directly.\n /\nexport const shouldUseInstallationRepos = (\n provider: Provider \| null \| undefined,\n appMode?: \"local\" \| \"cloud\",\n) => {\n if (!provider) return false;\n\n switch (provider) {\n case \"bitbucket\":\n case \"bitbucket_data_center\":\n return true;\n case \"github\":\n return appMode === \"cloud\";\n default:\n return false;\n }\n};\n\nexport const getGitProviderBaseUrl = (\n gitProvider: Provider,\n host?: string \| null,\n): string => {\n // If custom host provided, use it (with https:// prefix if needed)\n if (host && host.trim() !== \"\") {\n return host.startsWith(\"http\") ? host : `https://${host}`;\n }\n\n // Fall back to defaults\n switch (gitProvider) {\n case \"github\":\n return \"https://github.com\";\n case \"gitlab\":\n return \"https://gitlab.com\";\n case \"bitbucket\":\n return \"https://bitbucket.org\";\n case \"azure_devops\":\n return \"https://dev.azure.com\";\n case \"forgejo\":\n // Default UI links to Codeberg unless a custom host is available in settings\n // Note: UI link builders don't currently receive host; consider plumbing settings if needed\n return \"https://codeberg.org\";\n default:\n return \"\";\n }\n};\n\n/\n Get the name of the git provider\n * @param gitProvider The git provider\n * @returns The name of the git provider\n /\nexport const getProviderName = (gitProvider: Provider) => {\n if (gitProvider === \"gitlab\") return \"GitLab\";\n if (gitProvider === \"bitbucket\") return \"Bitbucket\";\n if (gitProvider === \"bitbucket_data_center\") return \"Bitbucket Data Center\";\n if (gitProvider === \"azure_devops\") return \"Azure DevOps\";\n if (gitProvider === \"forgejo\") return \"Forgejo\";\n return \"GitHub\";\n};\n\n/\n Get the name of the PR\n * @param isGitLab Whether the git provider is GitLab\n * @returns The name of the PR\n /\nexport const getPR = (isGitLab: boolean) =>\n isGitLab ? \"merge request\" : \"pull request\";\n\n/\n Get the short name of the PR\n * @param isGitLab Whether the git provider is GitLab\n * @returns The short name of the PR\n /\nexport const getPRShort = (isGitLab: boolean) => (isGitLab ? \"MR\" : \"PR\");\n\n/\n Construct the pull request (merge request) URL for different providers\n * @param prNumber The pull request number\n * @param provider The git provider\n * @param repositoryName The repository name in format \"owner/repo\"\n * @returns The pull request URL\n \n @example\n * constructPullRequestUrl(123, \"github\", \"owner/repo\") // \"https://github.com/owner/repo/pull/123\"\n * constructPullRequestUrl(456, \"gitlab\", \"owner/repo\") // \"https://gitlab.com/owner/repo/-/merge_requests/456\"\n * constructPullRequestUrl(789, \"bitbucket\", \"owner/repo\") // \"https://bitbucket.org/owner/repo/pull-requests/789\"\n * constructPullRequestUrl(789, \"bitbucket\", \"PROJECT/repo\", \"server.com\") // \"https://server.com/projects/PROJECT/repos/repo/pull-requests/789\"\n /\nexport const constructPullRequestUrl = (\n prNumber: number,\n provider: Provider,\n repositoryName: string,\n host?: string \| null,\n): string => {\n const baseUrl = getGitProviderBaseUrl(provider, host);\n\n switch (provider) {\n case \"github\":\n return `${baseUrl}/${repositoryName}/pull/${prNumber}`;\n case \"forgejo\":\n return `${baseUrl}/${repositoryName}/pull/${prNumber}`;\n case \"gitlab\":\n return `${baseUrl}/${repositoryName}/-/merge_requests/${prNumber}`;\n case \"bitbucket\":\n return `${baseUrl}/${repositoryName}/pull-requests/${prNumber}`;\n case \"bitbucket_data_center\": {\n const [project, repo] = repositoryName.split(\"/\");\n return `${baseUrl}/projects/${project}/repos/${repo}/pull-requests/${prNumber}`;\n }\n case \"azure_devops\": {\n // Azure DevOps format: org/project/repo\n const parts = repositoryName.split(\"/\");\n if (parts.length === 3) {\n const [org, project, repo] = parts;\n return `${baseUrl}/${org}/${project}/_git/${repo}/pullrequest/${prNumber}`;\n }\n return \"\";\n }\n default:\n return \"\";\n }\n};\n\n/\n Construct the repository URL for different providers\n * @param provider The git provider\n * @param repositoryName The repository name in format \"owner/repo\"\n * @returns The repository URL\n \n @example\n * constructRepositoryUrl(\"github\", \"owner/repo\") // \"https://github.com/owner/repo\"\n * constructRepositoryUrl(\"gitlab\", \"owner/repo\") // \"https://gitlab.com/owner/repo\"\n * constructRepositoryUrl(\"bitbucket\", \"owner/repo\") // \"https://bitbucket.org/owner/repo\"\n /\nexport const constructRepositoryUrl = (\n provider: Provider,\n repositoryName: string,\n host?: string \| null,\n): string => {\n const baseUrl = getGitProviderBaseUrl(provider, host);\n if (provider === \"bitbucket_data_center\") {\n const [project, repo] = repositoryName.split(\"/\");\n return `${baseUrl}/projects/${project}/repos/${repo}`;\n }\n return `${baseUrl}/${repositoryName}`;\n};\n\n/\n Construct the branch URL for different providers\n * @param provider The git provider\n * @param repositoryName The repository name in format \"owner/repo\"\n * @param branchName The branch name\n * @param host Optional custom host for self-hosted instances\n * @returns The branch URL\n \n @example\n * constructBranchUrl(\"github\", \"owner/repo\", \"main\") // \"https://github.com/owner/repo/tree/main\"\n * constructBranchUrl(\"gitlab\", \"owner/repo\", \"develop\") // \"https://gitlab.com/owner/repo/-/tree/develop\"\n * constructBranchUrl(\"bitbucket\", \"owner/repo\", \"feature\") // \"https://bitbucket.org/owner/repo/src/feature\"\n * constructBranchUrl(\"bitbucket\", \"PROJECT/repo\", \"feature\", \"server.com\") // \"https://server.com/projects/PROJECT/repos/repo/browse?at=refs/heads/feature\"\n /\nexport const constructBranchUrl = (\n provider: Provider,\n repositoryName: string,\n branchName: string,\n host?: string \| null,\n): string => {\n const baseUrl = getGitProviderBaseUrl(provider, host);\n\n switch (provider) {\n case \"github\":\n return `${baseUrl}/${repositoryName}/tree/${branchName}`;\n case \"forgejo\":\n return `${baseUrl}/${repositoryName}/src/branch/${branchName}`;\n case \"gitlab\":\n return `${baseUrl}/${repositoryName}/-/tree/${branchName}`;\n case \"bitbucket\":\n return `${baseUrl}/${repositoryName}/src/${branchName}`;\n case \"bitbucket_data_center\": {\n // Bitbucket Server format: /projects/{PROJECT}/repos/{repo}/browse?at=refs/heads/{branch}\n const parts = repositoryName.split(\"/\");\n if (parts.length >= 2) {\n const [project, repo] = parts;\n return `${baseUrl}/projects/${project}/repos/${repo}/browse?at=refs/heads/${branchName}`;\n }\n return \"\";\n }\n case \"azure_devops\": {\n // Azure DevOps format: org/project/repo\n const parts = repositoryName.split(\"/\");\n if (parts.length === 3) {\n const [org, project, repo] = parts;\n return `${baseUrl}/${org}/${project}/_git/${repo}?version=GB${branchName}`;\n }\n return \"\";\n }\n default:\n return \"\";\n }\n};\n\n// Git Action Prompts\n\nconst GIT_COMMIT_PROMPT =\n \"Please review the current changes and create a git commit with a concise, descriptive message.\";\n\nexport const getGitCommitPrompt = (): string => GIT_COMMIT_PROMPT;\n\n/\n Generate a git pull prompt\n * @returns The git pull prompt\n /\nexport const getGitPullPrompt = (): string =>\n \"Please pull the latest code from the repository.\";\n\n/\n Generate a git push prompt\n * @param gitProvider The git provider\n * @returns The git push prompt\n /\nexport const getGitPushPrompt = (gitProvider: Provider): string => {\n const providerName = getProviderName(gitProvider);\n const pr = getPR(gitProvider === \"gitlab\");\n\n return `Please push the changes to a remote branch on ${providerName}, but do NOT create a ${pr}. Check your current branch name first - if it's main, master, deploy, or another common default branch name, create a new branch with a descriptive name related to your changes. Otherwise, use the exact SAME branch name as the one you are currently on.`;\n};\n\n/\n Generate a create pull request prompt\n * @param gitProvider The git provider\n * @returns The create PR prompt\n /\nexport const getCreatePRPrompt = (gitProvider: Provider): string => {\n const providerName = getProviderName(gitProvider);\n const pr = getPR(gitProvider === \"gitlab\");\n const prShort = getPRShort(gitProvider === \"gitlab\");\n\n return `Please push the changes to ${providerName} and open a ${pr}. If you're on a default branch (e.g., main, master, deploy), create a new branch with a descriptive name otherwise use the current branch. If a ${pr} template exists in the repository, please follow it when creating the ${prShort} description.`;\n};\n\n/\n Generate a push to existing PR prompt\n * @param gitProvider The git provider\n * @returns The push to PR prompt\n /\nexport const getPushToPRPrompt = (gitProvider: Provider): string => {\n const pr = getPR(gitProvider === \"gitlab\");\n\n return `Please push the latest changes to the existing ${pr}.`;\n};\n\n/\n Generate a create new branch prompt\n * @returns The create new branch prompt\n /\nexport const getCreateNewBranchPrompt = (): string =>\n \"Please create a new branch with a descriptive name related to the work you plan to do.\";\n\n// Helper functions\nexport function getTotalTaskCount(\n suggestedTasks: SuggestedTaskGroup[] \| undefined,\n): number {\n if (!suggestedTasks) return 0;\n return suggestedTasks.flatMap((group) => group.tasks).length;\n}\n\nexport function getLimitedTaskGroups(\n suggestedTasks: SuggestedTaskGroup[],\n maxTasks: number,\n): SuggestedTaskGroup[] {\n const limitedGroups: SuggestedTaskGroup[] = [];\n let taskCount = 0;\n\n for (const group of suggestedTasks) {\n if (taskCount >= maxTasks) break;\n\n const remainingTasksNeeded = maxTasks - taskCount;\n const tasksToShow = group.tasks.slice(0, remainingTasksNeeded);\n\n if (tasksToShow.length > 0) {\n limitedGroups.push({\n ...group,\n tasks: tasksToShow,\n });\n taskCount += tasksToShow.length;\n }\n }\n\n return limitedGroups;\n}\n\nexport function getDisplayedTaskGroups(\n suggestedTasks: SuggestedTaskGroup[] \| undefined,\n isExpanded: boolean,\n): SuggestedTaskGroup[] {\n if (!suggestedTasks \|\| suggestedTasks.length === 0) {\n return [];\n }\n\n if (isExpanded) {\n return suggestedTasks;\n }\n\n return getLimitedTaskGroups(suggestedTasks, 3);\n}\n\n/\n Get the label for a conversation status\n * @param status The conversation status\n * @returns The localized label for the status\n /\nexport const getConversationStatusLabel = (\n status: ConversationStatus,\n): string => {\n switch (status) {\n case \"STOPPED\":\n return \"COMMON$STOPPED\";\n case \"RUNNING\":\n return \"COMMON$RUNNING\";\n case \"STARTING\":\n return \"COMMON$STARTING\";\n case \"ERROR\":\n return \"COMMON$ERROR\";\n case \"ARCHIVED\":\n return \"COMMON$ARCHIVED\"; // Use STOPPED for archived conversations\n default:\n return \"COMMON$UNKNOWN\";\n }\n};\n\n// Task Tracking Utility Functions\n\n/\n Get the status icon for a task status\n * @param status The task status\n * @returns The emoji icon for the status\n /\nexport const getStatusIcon = (status: string) => {\n switch (status) {\n case \"todo\":\n return \"⏳\";\n case \"in_progress\":\n return \"🔄\";\n case \"done\":\n return \"✅\";\n default:\n return \"❓\";\n }\n};\n\n/\n Get the CSS class names for a task status badge\n * @param status The task status\n * @returns The CSS class names for styling the status badge\n /\nexport const getStatusClassName = (status: string) => {\n if (status === \"done\") {\n return \"bg-green-800 text-green-200\";\n }\n if (status === \"in_progress\") {\n return \"bg-yellow-800 text-yellow-200\";\n }\n return \"bg-tertiary text-[var(--oh-text-tertiary)]\";\n};\n\n/\n Helper function to apply client-side filtering based on search query\n * @param repo The Git repository to check\n * @param searchQuery The search query string\n * @returns True if the repository should be included based on the search query\n /\nexport const shouldIncludeRepository = (\n repo: GitRepository,\n searchQuery: string,\n): boolean => {\n if (!searchQuery.trim()) {\n return true;\n }\n\n const sanitizedQuery = sanitizeQuery(searchQuery);\n const sanitizedRepoName = sanitizeQuery(repo.full_name);\n return sanitizedRepoName.includes(sanitizedQuery);\n};\n\n/\n Get the OpenHands query string based on the provider\n * @param provider The git provider\n * @returns The query string for searching OpenHands repositories\n /\nexport const getOpenHandsQuery = (provider: Provider \| null): string => {\n const providerRepositorySuffix: Record<string, string> = {\n gitlab: \"openhands-config\",\n azure_devops: \"openhands-config\",\n default: \".openhands\",\n } as const;\n\n return provider && provider in providerRepositorySuffix\n ? providerRepositorySuffix[provider]\n : providerRepositorySuffix.default;\n};\n\n/\n Check if a repository has the OpenHands suffix based on the provider\n * @param repo The Git repository to check\n * @param provider The git provider\n * @returns True if the repository has the OpenHands suffix\n /\nexport const hasOpenHandsSuffix = (\n repo: GitRepository,\n provider: Provider \| null,\n): boolean => repo.full_name.endsWith(`/${getOpenHandsQuery(provider)}`);\n\n/\n Build headers for V1 API requests that require session authentication\n * @param sessionApiKey Session API key for authentication\n * @returns Headers object with X-Session-API-Key if provided\n /\nexport const buildSessionHeaders = (\n sessionApiKey?: string \| null,\n): Record<string, string> => {\n const headers: Record<string, string> = {};\n if (sessionApiKey) {\n headers[\"X-Session-API-Key\"] = sessionApiKey;\n }\n return headers;\n};\n\n/\n Check if a task is currently being polled (loading state)\n * @param taskStatus The task status string (e.g., \"WORKING\", \"ERROR\", \"READY\")\n * @returns True if the task is in a loading state (not ERROR and not READY)\n \n @example\n * isTaskPolling(\"WORKING\") // Returns true\n * isTaskPolling(\"PREPARING_REPOSITORY\") // Returns true\n * isTaskPolling(\"READY\") // Returns false\n * isTaskPolling(\"ERROR\") // Returns false\n * isTaskPolling(null) // Returns false\n * isTaskPolling(undefined) // Returns false\n /\nexport const isTaskPolling = (taskStatus: string \| null \| undefined): boolean =>\n !!taskStatus && taskStatus !== \"ERROR\" && taskStatus !== \"READY\";\n\n/\n Get the appropriate color based on agent status\n * @param options Configuration object for status color calculation\n * @param options.isPausing Whether the agent is currently pausing\n * @param options.isTask Whether we're polling a task\n * @param options.taskStatus The task status string (e.g., \"ERROR\", \"READY\")\n * @param options.isStartingStatus Whether the agent is in a starting state (LOADING or INIT)\n * @param options.isStopStatus Whether the conversation status is STOPPED\n * @param options.curAgentState The current agent state\n * @returns The hex color code for the status\n \n @example\n * getStatusColor({\n * isPausing: false,\n * isTask: false,\n * taskStatus: undefined,\n * isStartingStatus: false,\n * isStopStatus: false,\n * curAgentState: AgentState.RUNNING\n * }) // Returns \"var(--oh-status-success)\"\n /\nexport const getStatusColor = (options: {\n isPausing: boolean;\n isTask: boolean;\n taskStatus?: string \| null;\n isStartingStatus: boolean;\n isStopStatus: boolean;\n curAgentState: AgentState;\n}): string => {\n const {\n isPausing,\n isTask,\n taskStatus,\n isStartingStatus,\n isStopStatus,\n curAgentState,\n } = options;\n\n // Show pausing status\n if (isPausing) {\n return \"#FFD600\";\n }\n\n // Show task status if we're polling a task\n if (isTask && taskStatus) {\n if (taskStatus === \"ERROR\") {\n return OH_STATUS_ERROR_COLOR;\n }\n return \"#FFD600\";\n }\n\n if (isStartingStatus) {\n return \"#FFD600\";\n }\n if (isStopStatus) {\n return \"#ffffff\";\n }\n if (curAgentState === AgentState.ERROR) {\n return OH_STATUS_ERROR_COLOR;\n }\n return OH_STATUS_SUCCESS_COLOR;\n};\n\ninterface GetStatusTextArgs {\n isPausing: boolean;\n isTask: boolean;\n taskStatus?: AppConversationStartTaskStatus \| null;\n taskDetail?: string \| null;\n isStartingStatus: boolean;\n isStopStatus: boolean;\n curAgentState: AgentState;\n errorMessage?: string \| null;\n t: (t: string) => string;\n}\n\n/\n Get the server status text based on agent and task state\n \n @param options Configuration object for status text calculation\n * @param options.isPausing Whether the agent is currently pausing\n * @param options.isTask Whether we're polling a task\n * @param options.taskStatus The task status string (e.g., \"ERROR\", \"READY\")\n * @param options.taskDetail Optional task-specific detail text\n * @param options.isStartingStatus Whether the conversation is in STARTING state\n * @param options.isStopStatus Whether the conversation is STOPPED\n * @param options.curAgentState The current agent state\n * @param options.errorMessage Optional agent error message\n * @returns Localized human-readable status text\n \n @example\n * getStatusText({\n * isPausing: false,\n * isTask: true,\n * taskStatus: \"STARTING_CONVERSATION\",\n * taskDetail: null,\n * isStartingStatus: false,\n * isStopStatus: false,\n * curAgentState: AgentState.RUNNING\n * }) // Returns \"Starting conversation\"\n */\nexport function getStatusText({\n isPausing = false,\n isTask,\n taskStatus,\n taskDetail,\n isStartingStatus,\n isStopStatus,\n curAgentState,\n errorMessage,\n t,\n}: GetStatusTextArgs): string {\n // Show pausing status\n if (isPausing) {\n return t(I18nKey.COMMON$STOPPING);\n }\n\n // Show task status if we're polling a task\n if (isTask && taskStatus) {\n if (taskStatus === \"ERROR\") {\n return taskDetail \|\| t(I18nKey.CONVERSATION$ERROR_STARTING_CONVERSATION);\n }\n\n if (taskStatus === \"READY\") {\n return t(I18nKey.CONVERSATION$READY);\n }\n\n return taskDetail \|\| t(getTaskStatusI18nKey(taskStatus));\n }\n\n if (isStartingStatus) {\n return t(I18nKey.COMMON$STARTING);\n }\n\n if (isStopStatus) {\n return t(I18nKey.COMMON$SERVER_STOPPED);\n }\n\n if (curAgentState === AgentState.ERROR) {\n return errorMessage \|\| t(I18nKey.COMMON$ERROR);\n }\n\n return t(I18nKey.COMMON$RUNNING);\n}\n"],"mappings":"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"}

package/dist/utils/vscode-origin.cjs ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ require("../_virtual/_rolldown/runtime.cjs");var e=`__AGENT_CANVAS_VSCODE_BASE_PATH__`;function t(){if(typeof window<`u`){let t=window[e];if(typeof t==`string`&&t.trim())return n(t.trim())}return null}function n(e){let t=e.startsWith(`/`)?e:`/${e}`;return t.length>1?t.replace(/\/+$/,``):t}function r(e,t){if(!e\|\|!t)return!1;let n;try{n=new URL(e,typeof window<`u`?window.location.href:void 0)}catch{return!1}return typeof window<`u`&&n.origin!==window.location.origin?!1:n.pathname===t\|\|n.pathname.startsWith(`${t}/`)}exports.getOriginVSCodeBasePath=t,exports.isVSCodeUrlServedByOrigin=r;
2	+ //# sourceMappingURL=vscode-origin.cjs.map

package/dist/utils/vscode-origin.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"vscode-origin.cjs","names":[],"sources":["../../src/utils/vscode-origin.ts"],"sourcesContent":["/**\n * Whether *this browser origin* can serve the editor, and whether a given\n * editor URL is one it will actually route.\n *\n * Editor availability is not a property of the agent-server process alone. The\n * agent-server answers `/api/vscode/status` for whatever conversation you ask\n * about, and builds `/api/vscode/url` from the `base_url` the caller sends —\n * which is always `window.location.origin`. So a server can truthfully report\n * an editor that the page's own origin has no route to. Two supported layouts\n * hit that:\n *\n * - **Public mode** (`docker/entrypoint.sh`, `--auth-required`): a second\n * static server on its own port, sharing the same agent-server but\n * deliberately without the editor route, because the editor's connection\n * token is the session API key (OpenHands/software-agent-sdk#4317) and that\n * origin exists to test the *unauthenticated* case.\n * - **Extra backends** (`scripts/dev-extra-backend.mjs`): a second\n * agent-server registered from a browser whose origin belongs to another\n * stack. That origin's editor route, if any, points at the *bundled*\n * stack's editor — a different container's workspace.\n *\n * In both cases a control gated only on the server probe renders and then\n * resolves to the canvas SPA or, worse, someone else's workspace. So the\n * frontend has to intersect the server's capability with the origin's route\n * table, and this module is the origin half of that.\n */\n\nconst VSCODE_BASE_PATH_WINDOW_KEY = \"__AGENT_CANVAS_VSCODE_BASE_PATH__\";\n\n/**\n * The path prefix this origin serves the editor under, or `null` if it serves\n * no editor at all.\n *\n * Two sources, in order — mirroring `getRawRuntimeServicesInfo` in\n * `agent-server-adapter.ts`:\n * 1. `VITE_VSCODE_BASE_PATH` — baked in at build time by the dev launchers\n * that proxy the editor (`npm run dev`, dev:static).\n * 2. `window.__AGENT_CANVAS_VSCODE_BASE_PATH__` — injected into index.html at\n * serve time by `scripts/static-server.mjs --vscode-base-path <path>`,\n * which refuses to start unless a matching `--route` exists. That is the\n * path used by static builds (the Docker image, the published binary),\n * where the env var is empty in the prebuilt bundle.\n *\n * Absent from both means \"this origin does not serve the editor\" and the\n * control is hidden. That is the pre-existing behavior for every local backend,\n * so a deployment this cannot detect is no worse off than before.\n */\nexport function getOriginVSCodeBasePath(): string | null {\n const envRaw = import.meta.env.VITE_VSCODE_BASE_PATH?.trim();\n if (envRaw) return normalizePrefix(envRaw);\n\n if (typeof window !== \"undefined\") {\n const injected = (window as unknown as Record<string, unknown>)[\n VSCODE_BASE_PATH_WINDOW_KEY\n ];\n if (typeof injected === \"string\" && injected.trim()) {\n return normalizePrefix(injected.trim());\n }\n }\n\n return null;\n}\n\nfunction normalizePrefix(value: string): string {\n const withLeadingSlash = value.startsWith(\"/\") ? value : `/${value}`;\n return withLeadingSlash.length > 1\n ? withLeadingSlash.replace(/\\/+$/, \"\")\n : withLeadingSlash;\n}\n\n/**\n * Whether `url` is an editor URL this origin will actually route.\n *\n * The agent-server appends its own `vscode_base_path` to the origin we send it,\n * so the returned URL carries the prefix of the server that answered — not\n * necessarily the prefix this origin routes. An extra backend that configures\n * no prefix yields `<origin>/?tkn=…`, which is the canvas root: same origin,\n * wrong destination. Comparing paths is what separates the two.\n */\nexport function isVSCodeUrlServedByOrigin(\n url: string | null | undefined,\n basePath: string | null,\n): boolean {\n if (!url || !basePath) return false;\n\n let parsed: URL;\n try {\n parsed = new URL(\n url,\n typeof window !== \"undefined\" ? window.location.href : undefined,\n );\n } catch {\n return false;\n }\n\n // A cross-origin URL is somebody else's problem to route, not ours to vouch\n // for. The local path always builds on `window.location.origin`, so this only\n // fires on a value we did not construct.\n if (\n typeof window !== \"undefined\" &&\n parsed.origin !== window.location.origin\n ) {\n return false;\n }\n\n return (\n parsed.pathname === basePath || parsed.pathname.startsWith(`${basePath}/`)\n );\n}\n"],"mappings":"6CA2BA,IAAM,EAA8B,oCAoBpC,SAAgB,GAAyC,CAIvD,GAAI,OAAO,OAAW,IAAa,CACjC,IAAM,EAAY,OAChB,GAEF,GAAI,OAAO,GAAa,UAAY,EAAS,KAAK,EAChD,OAAO,EAAgB,EAAS,KAAK,CAAC,CAE1C,CAEA,OAAO,IACT,CAEA,SAAS,EAAgB,EAAuB,CAC9C,IAAM,EAAmB,EAAM,WAAW,GAAG,EAAI,EAAQ,IAAI,IAC7D,OAAO,EAAiB,OAAS,EAC7B,EAAiB,QAAQ,OAAQ,EAAE,EACnC,CACN,CAWA,SAAgB,EACd,EACA,EACS,CACT,GAAI,CAAC,GAAO,CAAC,EAAU,MAAO,GAE9B,IAAI,EACJ,GAAI,CACF,EAAS,IAAI,IACX,EACA,OAAO,OAAW,IAAc,OAAO,SAAS,KAAO,IAAA,EACzD,CACF,MAAQ,CACN,MAAO,EACT,CAYA,OANE,OAAO,OAAW,KAClB,EAAO,SAAW,OAAO,SAAS,OAE3B,GAIP,EAAO,WAAa,GAAY,EAAO,SAAS,WAAW,GAAG,EAAS,EAAE,CAE7E"}

package/dist/utils/vscode-origin.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+/**
+ * Whether *this browser origin* can serve the editor, and whether a given
+ * editor URL is one it will actually route.
+ *
+ * Editor availability is not a property of the agent-server process alone. The
+ * agent-server answers `/api/vscode/status` for whatever conversation you ask
+ * about, and builds `/api/vscode/url` from the `base_url` the caller sends —
+ * which is always `window.location.origin`. So a server can truthfully report
+ * an editor that the page's own origin has no route to. Two supported layouts
+ * hit that:
+ *
+ *   - **Public mode** (`docker/entrypoint.sh`, `--auth-required`): a second
+ *     static server on its own port, sharing the same agent-server but
+ *     deliberately without the editor route, because the editor's connection
+ *     token is the session API key (OpenHands/software-agent-sdk#4317) and that
+ *     origin exists to test the *unauthenticated* case.
+ *   - **Extra backends** (`scripts/dev-extra-backend.mjs`): a second
+ *     agent-server registered from a browser whose origin belongs to another
+ *     stack. That origin's editor route, if any, points at the *bundled*
+ *     stack's editor — a different container's workspace.
+ *
+ * In both cases a control gated only on the server probe renders and then
+ * resolves to the canvas SPA or, worse, someone else's workspace. So the
+ * frontend has to intersect the server's capability with the origin's route
+ * table, and this module is the origin half of that.
+ */
+/**
+ * The path prefix this origin serves the editor under, or `null` if it serves
+ * no editor at all.
+ *
+ * Two sources, in order — mirroring `getRawRuntimeServicesInfo` in
+ * `agent-server-adapter.ts`:
+ *   1. `VITE_VSCODE_BASE_PATH` — baked in at build time by the dev launchers
+ *      that proxy the editor (`npm run dev`, dev:static).
+ *   2. `window.__AGENT_CANVAS_VSCODE_BASE_PATH__` — injected into index.html at
+ *      serve time by `scripts/static-server.mjs --vscode-base-path <path>`,
+ *      which refuses to start unless a matching `--route` exists. That is the
+ *      path used by static builds (the Docker image, the published binary),
+ *      where the env var is empty in the prebuilt bundle.
+ *
+ * Absent from both means "this origin does not serve the editor" and the
+ * control is hidden. That is the pre-existing behavior for every local backend,
+ * so a deployment this cannot detect is no worse off than before.
+ */
+export declare function getOriginVSCodeBasePath(): string | null;
+/**
+ * Whether `url` is an editor URL this origin will actually route.
+ *
+ * The agent-server appends its own `vscode_base_path` to the origin we send it,
+ * so the returned URL carries the prefix of the server that answered — not
+ * necessarily the prefix this origin routes. An extra backend that configures
+ * no prefix yields `<origin>/?tkn=…`, which is the canvas root: same origin,
+ * wrong destination. Comparing paths is what separates the two.
+ */
+export declare function isVSCodeUrlServedByOrigin(url: string | null | undefined, basePath: string | null): boolean;

package/dist/utils/vscode-origin.js ADDED Viewed

@@ -0,0 +1,27 @@
+//#region src/utils/vscode-origin.ts
+var e = "__AGENT_CANVAS_VSCODE_BASE_PATH__";
+function t() {
+	if (typeof window < "u") {
+		let t = window[e];
+		if (typeof t == "string" && t.trim()) return n(t.trim());
+	}
+	return null;
+}
+function n(e) {
+	let t = e.startsWith("/") ? e : `/${e}`;
+	return t.length > 1 ? t.replace(/\/+$/, "") : t;
+}
+function r(e, t) {
+	if (!e || !t) return !1;
+	let n;
+	try {
+		n = new URL(e, typeof window < "u" ? window.location.href : void 0);
+	} catch {
+		return !1;
+	}
+	return typeof window < "u" && n.origin !== window.location.origin ? !1 : n.pathname === t || n.pathname.startsWith(`${t}/`);
+}
+//#endregion
+export { t as getOriginVSCodeBasePath, r as isVSCodeUrlServedByOrigin };
+//# sourceMappingURL=vscode-origin.js.map

package/dist/utils/vscode-origin.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"vscode-origin.js","names":[],"sources":["../../src/utils/vscode-origin.ts"],"sourcesContent":["/**\n * Whether *this browser origin* can serve the editor, and whether a given\n * editor URL is one it will actually route.\n *\n * Editor availability is not a property of the agent-server process alone. The\n * agent-server answers `/api/vscode/status` for whatever conversation you ask\n * about, and builds `/api/vscode/url` from the `base_url` the caller sends —\n * which is always `window.location.origin`. So a server can truthfully report\n * an editor that the page's own origin has no route to. Two supported layouts\n * hit that:\n *\n * - **Public mode** (`docker/entrypoint.sh`, `--auth-required`): a second\n * static server on its own port, sharing the same agent-server but\n * deliberately without the editor route, because the editor's connection\n * token is the session API key (OpenHands/software-agent-sdk#4317) and that\n * origin exists to test the *unauthenticated* case.\n * - **Extra backends** (`scripts/dev-extra-backend.mjs`): a second\n * agent-server registered from a browser whose origin belongs to another\n * stack. That origin's editor route, if any, points at the *bundled*\n * stack's editor — a different container's workspace.\n *\n * In both cases a control gated only on the server probe renders and then\n * resolves to the canvas SPA or, worse, someone else's workspace. So the\n * frontend has to intersect the server's capability with the origin's route\n * table, and this module is the origin half of that.\n */\n\nconst VSCODE_BASE_PATH_WINDOW_KEY = \"__AGENT_CANVAS_VSCODE_BASE_PATH__\";\n\n/**\n * The path prefix this origin serves the editor under, or `null` if it serves\n * no editor at all.\n *\n * Two sources, in order — mirroring `getRawRuntimeServicesInfo` in\n * `agent-server-adapter.ts`:\n * 1. `VITE_VSCODE_BASE_PATH` — baked in at build time by the dev launchers\n * that proxy the editor (`npm run dev`, dev:static).\n * 2. `window.__AGENT_CANVAS_VSCODE_BASE_PATH__` — injected into index.html at\n * serve time by `scripts/static-server.mjs --vscode-base-path <path>`,\n * which refuses to start unless a matching `--route` exists. That is the\n * path used by static builds (the Docker image, the published binary),\n * where the env var is empty in the prebuilt bundle.\n *\n * Absent from both means \"this origin does not serve the editor\" and the\n * control is hidden. That is the pre-existing behavior for every local backend,\n * so a deployment this cannot detect is no worse off than before.\n */\nexport function getOriginVSCodeBasePath(): string | null {\n const envRaw = import.meta.env.VITE_VSCODE_BASE_PATH?.trim();\n if (envRaw) return normalizePrefix(envRaw);\n\n if (typeof window !== \"undefined\") {\n const injected = (window as unknown as Record<string, unknown>)[\n VSCODE_BASE_PATH_WINDOW_KEY\n ];\n if (typeof injected === \"string\" && injected.trim()) {\n return normalizePrefix(injected.trim());\n }\n }\n\n return null;\n}\n\nfunction normalizePrefix(value: string): string {\n const withLeadingSlash = value.startsWith(\"/\") ? value : `/${value}`;\n return withLeadingSlash.length > 1\n ? withLeadingSlash.replace(/\\/+$/, \"\")\n : withLeadingSlash;\n}\n\n/**\n * Whether `url` is an editor URL this origin will actually route.\n *\n * The agent-server appends its own `vscode_base_path` to the origin we send it,\n * so the returned URL carries the prefix of the server that answered — not\n * necessarily the prefix this origin routes. An extra backend that configures\n * no prefix yields `<origin>/?tkn=…`, which is the canvas root: same origin,\n * wrong destination. Comparing paths is what separates the two.\n */\nexport function isVSCodeUrlServedByOrigin(\n url: string | null | undefined,\n basePath: string | null,\n): boolean {\n if (!url || !basePath) return false;\n\n let parsed: URL;\n try {\n parsed = new URL(\n url,\n typeof window !== \"undefined\" ? window.location.href : undefined,\n );\n } catch {\n return false;\n }\n\n // A cross-origin URL is somebody else's problem to route, not ours to vouch\n // for. The local path always builds on `window.location.origin`, so this only\n // fires on a value we did not construct.\n if (\n typeof window !== \"undefined\" &&\n parsed.origin !== window.location.origin\n ) {\n return false;\n }\n\n return (\n parsed.pathname === basePath || parsed.pathname.startsWith(`${basePath}/`)\n );\n}\n"],"mappings":";AA2BA,IAAM,IAA8B;AAoBpC,SAAgB,IAAyC;CAIvD,IAAI,OAAO,SAAW,KAAa;EACjC,IAAM,IAAY,OAChB;EAEF,IAAI,OAAO,KAAa,YAAY,EAAS,KAAK,GAChD,OAAO,EAAgB,EAAS,KAAK,CAAC;CAE1C;CAEA,OAAO;AACT;AAEA,SAAS,EAAgB,GAAuB;CAC9C,IAAM,IAAmB,EAAM,WAAW,GAAG,IAAI,IAAQ,IAAI;CAC7D,OAAO,EAAiB,SAAS,IAC7B,EAAiB,QAAQ,QAAQ,EAAE,IACnC;AACN;AAWA,SAAgB,EACd,GACA,GACS;CACT,IAAI,CAAC,KAAO,CAAC,GAAU,OAAO;CAE9B,IAAI;CACJ,IAAI;EACF,IAAS,IAAI,IACX,GACA,OAAO,SAAW,MAAc,OAAO,SAAS,OAAO,KAAA,CACzD;CACF,QAAQ;EACN,OAAO;CACT;CAYA,OANE,OAAO,SAAW,OAClB,EAAO,WAAW,OAAO,SAAS,SAE3B,KAIP,EAAO,aAAa,KAAY,EAAO,SAAS,WAAW,GAAG,EAAS,EAAE;AAE7E"}

package/dist/utils/websocket-handshake.cjs ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ require("../_virtual/_rolldown/runtime.cjs");var e=1e4;function t(t){let n=setTimeout(()=>{t.readyState===WebSocket.CONNECTING&&t.close()},e);return()=>clearTimeout(n)}exports.startHandshakeWatchdog=t;
2	+ //# sourceMappingURL=websocket-handshake.cjs.map

package/dist/utils/websocket-handshake.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"websocket-handshake.cjs","names":[],"sources":["../../src/utils/websocket-handshake.ts"],"sourcesContent":["// Browsers never time out a socket stuck in CONNECTING on their own, and\n// Chrome serializes WebSocket handshakes per host — a hung handshake also\n// blocks every other socket to the same origin until it settles. Close it\n// after this long so a retry (and any other queued handshake) can proceed.\nconst HANDSHAKE_TIMEOUT_MS = 10_000;\n\n/**\n * Watches a freshly constructed socket's handshake and closes the socket if it\n * is still in CONNECTING when the timeout elapses. close() fires the socket's\n * own error/close events (code 1006), so the abort flows through the caller's\n * normal close handling rather than a separate failure path.\n *\n * Returns a cancel function. The caller must invoke it once the handshake\n * settles — in its open and close handlers, and in any cleanup that detaches\n * those handlers — so the watchdog never outlives the socket it watches.\n */\nexport function startHandshakeWatchdog(\n ws: Pick<WebSocket, \"readyState\" | \"close\">,\n): () => void {\n const timeout = setTimeout(() => {\n if (ws.readyState === WebSocket.CONNECTING) {\n ws.close();\n }\n }, HANDSHAKE_TIMEOUT_MS);\n return () => clearTimeout(timeout);\n}\n"],"mappings":"6CAIA,IAAM,EAAuB,IAY7B,SAAgB,EACd,EACY,CACZ,IAAM,EAAU,eAAiB,CAC3B,EAAG,aAAe,UAAU,YAC9B,EAAG,MAAM,CAEb,EAAG,CAAoB,EACvB,UAAa,aAAa,CAAO,CACnC"}

package/dist/utils/websocket-handshake.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * Watches a freshly constructed socket's handshake and closes the socket if it
+ * is still in CONNECTING when the timeout elapses. close() fires the socket's
+ * own error/close events (code 1006), so the abort flows through the caller's
+ * normal close handling rather than a separate failure path.
+ *
+ * Returns a cancel function. The caller must invoke it once the handshake
+ * settles — in its open and close handlers, and in any cleanup that detaches
+ * those handlers — so the watchdog never outlives the socket it watches.
+ */
+export declare function startHandshakeWatchdog(ws: Pick<WebSocket, "readyState" | "close">): () => void;

package/dist/utils/websocket-handshake.js ADDED Viewed

@@ -0,0 +1,12 @@
+//#region src/utils/websocket-handshake.ts
+var e = 1e4;
+function t(t) {
+	let n = setTimeout(() => {
+		t.readyState === WebSocket.CONNECTING && t.close();
+	}, e);
+	return () => clearTimeout(n);
+}
+//#endregion
+export { t as startHandshakeWatchdog };
+//# sourceMappingURL=websocket-handshake.js.map

package/dist/utils/websocket-handshake.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"websocket-handshake.js","names":[],"sources":["../../src/utils/websocket-handshake.ts"],"sourcesContent":["// Browsers never time out a socket stuck in CONNECTING on their own, and\n// Chrome serializes WebSocket handshakes per host — a hung handshake also\n// blocks every other socket to the same origin until it settles. Close it\n// after this long so a retry (and any other queued handshake) can proceed.\nconst HANDSHAKE_TIMEOUT_MS = 10_000;\n\n/**\n * Watches a freshly constructed socket's handshake and closes the socket if it\n * is still in CONNECTING when the timeout elapses. close() fires the socket's\n * own error/close events (code 1006), so the abort flows through the caller's\n * normal close handling rather than a separate failure path.\n *\n * Returns a cancel function. The caller must invoke it once the handshake\n * settles — in its open and close handlers, and in any cleanup that detaches\n * those handlers — so the watchdog never outlives the socket it watches.\n */\nexport function startHandshakeWatchdog(\n ws: Pick<WebSocket, \"readyState\" | \"close\">,\n): () => void {\n const timeout = setTimeout(() => {\n if (ws.readyState === WebSocket.CONNECTING) {\n ws.close();\n }\n }, HANDSHAKE_TIMEOUT_MS);\n return () => clearTimeout(timeout);\n}\n"],"mappings":";AAIA,IAAM,IAAuB;AAY7B,SAAgB,EACd,GACY;CACZ,IAAM,IAAU,iBAAiB;EAC/B,AAAI,EAAG,eAAe,UAAU,cAC9B,EAAG,MAAM;CAEb,GAAG,CAAoB;CACvB,aAAa,aAAa,CAAO;AACnC"}

package/dist/utils/workspace-mode.d.ts CHANGED Viewed

@@ -1,4 +1,8 @@
 import type { BackendKind } from "#/api/backend-registry/types";
 import type { WorkspaceMode } from "#/api/conversation-metadata-store";
 import { I18nKey } from "#/i18n/declaration";
+export declare const DEFAULT_WORKSPACE_MODE: WorkspaceMode;
+export declare const LAST_LOCAL_WORKSPACE_MODE_STORAGE_KEY = "openhands-last-local-workspace-mode";
+export declare function readStoredLocalWorkspaceMode(): WorkspaceMode;
+export declare function writeStoredLocalWorkspaceMode(mode: WorkspaceMode): void;
 export declare function getWorkspaceModeI18nKey(mode: WorkspaceMode, backendKind: BackendKind): I18nKey;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/agent-canvas",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "description": "Agent Canvas UI for OpenHands - run AI coding agents with a visual interface",
   "license": "MIT",
   "private": false,
@@ -23,8 +23,8 @@
     "@heroui/react": "2.8.10",
     "@microlink/react-json-view": "1.31.25",
     "@monaco-editor/react": "4.7.0",
-    "@openhands/extensions": "0.16.0",
-    "@openhands/typescript-client": "1.38.0",
+    "@openhands/extensions": "0.19.0",
+    "@openhands/typescript-client": "1.39.0",
     "@react-router/node": "7.18.2",
     "@react-router/serve": "7.18.2",
     "@tailwindcss/vite": "4.3.3",

package/scripts/check-sdk-version-sync.mjs CHANGED Viewed

@@ -19,7 +19,7 @@
  *
  * Usage:
  *   node scripts/check-sdk-version-sync.mjs
- *   EXPECTED_SDK_VERSION=1.42.1 node scripts/check-sdk-version-sync.mjs
+ *   EXPECTED_SDK_VERSION=1.44.0 node scripts/check-sdk-version-sync.mjs
  *   node scripts/check-sdk-version-sync.mjs --check-pypi
  *
  * Environment variables:
@@ -78,7 +78,7 @@ Triggering from other repos:
     -H "Authorization: token \$GITHUB_TOKEN" \\
     -H "Accept: application/vnd.github.v3+json" \\
     https://api.github.com/repos/OpenHands/OpenHands/dispatches \\
-    -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.42.1"}}'
+    -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.44.0"}}'
 `);
   process.exit(0);
 }
@@ -260,9 +260,9 @@ async function fetchPyPIDependencies(packageName, version) {
  * Parse PyPI requires_dist array and extract SDK package versions
  *
  * PyPI returns dependencies in PEP 508 format like:
- *   "openhands-sdk>=1.42.1,<2.0.0"
- *   "openhands-tools==1.42.1"
- *   "openhands-workspace (>=1.42.1)"
+ *   "openhands-sdk>=1.44.0,<2.0.0"
+ *   "openhands-tools==1.44.0"
+ *   "openhands-workspace (>=1.44.0)"
  */
 function parseSdkVersionsFromRequiresDist(requiresDist) {
   const versions = {};
@@ -276,7 +276,7 @@ function parseSdkVersionsFromRequiresDist(requiresDist) {
       }
       // Extract the version number - look for patterns like:
-      // ">=1.42.1", "==1.42.1", "(>=1.42.1)", "~=1.42.1"
+      // ">=1.44.0", "==1.44.0", "(>=1.44.0)", "~=1.44.0"
       // After the package name and before any comma or closing paren
       const versionPattern = /[><=~!]+\s*([0-9]+(?:\.[0-9]+)*)/;
       const match = dep.match(versionPattern);

package/scripts/check-translation-completeness.cjs CHANGED Viewed

@@ -26,6 +26,10 @@ const IDENTICAL_VALUE_ALLOWLIST = new Set([
   'COMMAND_MENU$SHORTCUT',
   'CONVERSATION$ACP_AGENT_GENERIC',
   'CONVERSATION$BUDGET_USAGE_FORMAT',
+  'CONVERSATION$OVERVIEW_DIFF_ADDITIONS',
+  'CONVERSATION$OVERVIEW_DIFF_DELETIONS',
+  'CONVERSATION$OVERVIEW_GIT',
+  'CONVERSATION$OVERVIEW_UNAVAILABLE',
   'CONVERSATION_PANEL$PREVIEW_GIT',
   'FILES$VSCODE',
   'GITHUB$AUTH_SCOPE',
@@ -56,6 +60,7 @@ const IDENTICAL_VALUE_ALLOWLIST = new Set([
   'SETTINGS$MCP_SERVER_TYPE_SSE',
   'SETTINGS$MCP_SERVER_TYPE_STDIO',
   'SETTINGS$NAV_LLM',
+  'SETTINGS$OPENHANDS_API_KEY_HELP_LINK',
   'SETTINGS$SKILLS_PILLS_MORE',
   'SETTINGS$SKILLS_VERSION',
   'SETTINGS$SLACK',

package/scripts/dev-extra-backend.mjs CHANGED Viewed

@@ -43,7 +43,10 @@ function parsePort(value, fallback) {
  * @param {string} cwd
  * @param {Record<string, string | undefined>} env
  */
-export function buildExtraBackendConfig(cwd = process.cwd(), env = process.env) {
+export function buildExtraBackendConfig(
+  cwd = process.cwd(),
+  env = process.env,
+) {
   const base = buildSafeDevConfig(cwd, env);
   const backendPort = parsePort(
@@ -70,7 +73,7 @@ function isEnoentError(error) {
       typeof error === "object" &&
       "code" in error &&
       error.code === "ENOENT") ||
-      /ENOENT/.test(String(error)),
+    /ENOENT/.test(String(error)),
   );
 }
@@ -94,10 +97,14 @@ async function waitForServer(url, timeoutMs = DEFAULT_WAIT_TIMEOUT_MS) {
 }
 function spawnProcess(command, args, options = {}) {
-  const child = spawn(command, args, getProcessTreeSpawnOptions({
-    stdio: "inherit",
-    ...options,
-  }));
+  const child = spawn(
+    command,
+    args,
+    getProcessTreeSpawnOptions({
+      stdio: "inherit",
+      ...options,
+    }),
+  );
   child.once("error", (error) => {
     if (isEnoentError(error) && command === "uvx") {
@@ -164,6 +171,14 @@ async function main() {
     {
       cwd: config.cwd,
       env: {
+        // Deliberately not opting into the editor path prefix. This server is
+        // reached by registering it as an extra backend from a browser whose
+        // origin belongs to some *other* stack, so a prefix on that origin
+        // either does not resolve or — worse — resolves to the bundled
+        // stack's editor, silently handing back a different container's
+        // workspace. No single global prefix can disambiguate the two, so this
+        // launcher stays out of prefix-mode; the editor button is unavailable
+        // for conversations on an extra backend.
         ...process.env,
         ...buildAgentServerEnv(config),
       },
@@ -190,6 +205,12 @@ async function main() {
   process.on("SIGINT", () => shutdown("SIGINT"));
   process.on("SIGTERM", () => shutdown("SIGTERM"));
+  // The agent-server is spawned detached, so a SIGHUP that kills this launcher
+  // (terminal or multiplexer death) would otherwise leave it running and holding
+  // its port. Forward SIGTERM rather than SIGHUP: uvicorn only handles
+  // SIGINT/SIGTERM, so a forwarded SIGHUP would terminate the agent-server by
+  // default action instead of shutting it down gracefully.
+  process.on("SIGHUP", () => shutdown("SIGTERM"));
   const backendErrored = new Promise((_, reject) => {
     backend.once("error", (error) => reject(error));
@@ -221,9 +242,7 @@ async function main() {
   backend.once("exit", (code) => {
     if (!shuttingDown) {
-      console.error(
-        `agent-server exited unexpectedly with code ${code ?? 0}`,
-      );
+      console.error(`agent-server exited unexpectedly with code ${code ?? 0}`);
       shutdown();
       process.exitCode = code ?? 1;
     } else {