@spotpatch/runtime 1.9.0 → 1.10.0

package/dist/index.js

@@ -5,13 +5,18 @@ import {
   mergeComponentDataFlowReport,
   mergePageDataFlowReport
 } from "./chunk-QY5T4DPA.js";
+import {
+  getDataFlowExtension
+} from "./chunk-NII5OBAN.js";
+import {
+  getExternalHandoffExtension
+} from "./chunk-XBD55BCF.js";
 import {
   UI_MARKER_ATTRIBUTE,
   UI_Z_INDEX,
   createButton,
-  createMarkedElement,
-  getDataFlowExtension
-} from "./chunk-AXKYJRAM.js";
+  createMarkedElement
+} from "./chunk-7ES63LA7.js";
 
 // src/controller/runtime-controller.ts
 import { createReact18Adapter } from "@spotpatch/react-adapter";
@@ -2593,6 +2598,8 @@ var STATUS_ZH = Object.freeze({
   reverted: "\u5DF2\u64A4\u9500",
   failed: "\u5931\u8D25"
 });
+var EXTERNAL_HANDOFF_ERROR_EN = "The external Agent handoff request failed.";
+var EXTERNAL_HANDOFF_ERROR_ZH = "\u5916\u90E8 Agent \u4EA4\u63A5\u8BF7\u6C42\u5931\u8D25\u3002";
 var ERROR_MESSAGES_EN = Object.freeze({
   [ERROR_CODES2.INVALID_REQUEST]: "The Agent request was rejected as invalid.",
   [ERROR_CODES2.INVALID_TOKEN]: "The local SpotPatch session expired.",
@@ -2614,6 +2621,24 @@ var ERROR_MESSAGES_EN = Object.freeze({
   [ERROR_CODES2.AGENT_BUSY]: "Another write Agent job is still active.",
   [ERROR_CODES2.AGENT_LIMIT_EXCEEDED]: "The Agent stopped at a configured time, turn, output, or size limit.",
   [ERROR_CODES2.AGENT_CANCELLED]: "The Agent job was cancelled.",
+  [ERROR_CODES2.EXTERNAL_HANDOFF_DISABLED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.EXTERNAL_HANDOFF_UNAVAILABLE]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.HANDOFF_VALIDATION_FAILED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.HANDOFF_SOURCE_STALE]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.HANDOFF_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.HANDOFF_EXPIRED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.HANDOFF_CURSOR_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.HANDOFF_RESPONSE_TOO_LARGE]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.BRIDGE_UNAUTHORIZED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.BRIDGE_PROTOCOL_MISMATCH]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.BRIDGE_BUSY]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.EXTERNAL_AGENT_BUSY]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.ACTIVE_ADAPTER_CONFLICT]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.ACTIVE_ADAPTER_LEASE_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.ACTIVE_DISPATCH_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.SESSION_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.SESSION_AMBIGUOUS]: EXTERNAL_HANDOFF_ERROR_EN,
+  [ERROR_CODES2.SESSION_CLOSED]: EXTERNAL_HANDOFF_ERROR_EN,
   [ERROR_CODES2.WORKTREE_DIRTY]: "Confirm inclusion of local changes before running AI.",
   [ERROR_CODES2.WORKTREE_NOT_REPOSITORY]: "Vite root must be an initialized Git repository root.",
   [ERROR_CODES2.WORKTREE_OPERATION_IN_PROGRESS]: "Finish the active merge, rebase, cherry-pick, or revert.",
@@ -2652,6 +2677,24 @@ var ERROR_MESSAGES_ZH = Object.freeze({
   [ERROR_CODES2.AGENT_BUSY]: "\u5F53\u524D\u9879\u76EE\u5DF2\u6709\u4E00\u4E2A\u5199\u5165\u4EFB\u52A1\u6B63\u5728\u8FD0\u884C\u3002",
   [ERROR_CODES2.AGENT_LIMIT_EXCEEDED]: "Agent \u8FBE\u5230\u65F6\u95F4\u3001\u8F6E\u6B21\u3001\u8F93\u51FA\u6216\u53D8\u66F4\u89C4\u6A21\u9650\u5236\u3002",
   [ERROR_CODES2.AGENT_CANCELLED]: "Agent \u4EFB\u52A1\u5DF2\u53D6\u6D88\u3002",
+  [ERROR_CODES2.EXTERNAL_HANDOFF_DISABLED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.EXTERNAL_HANDOFF_UNAVAILABLE]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.HANDOFF_VALIDATION_FAILED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.HANDOFF_SOURCE_STALE]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.HANDOFF_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.HANDOFF_EXPIRED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.HANDOFF_CURSOR_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.HANDOFF_RESPONSE_TOO_LARGE]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.BRIDGE_UNAUTHORIZED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.BRIDGE_PROTOCOL_MISMATCH]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.BRIDGE_BUSY]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.EXTERNAL_AGENT_BUSY]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.ACTIVE_ADAPTER_CONFLICT]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.ACTIVE_ADAPTER_LEASE_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.ACTIVE_DISPATCH_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.SESSION_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.SESSION_AMBIGUOUS]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [ERROR_CODES2.SESSION_CLOSED]: EXTERNAL_HANDOFF_ERROR_ZH,
   [ERROR_CODES2.WORKTREE_DIRTY]: "\u8FD0\u884C AI \u524D\uFF0C\u8BF7\u660E\u786E\u540C\u610F\u5C06\u5F53\u524D\u672C\u5730\u4FEE\u6539\u7EB3\u5165\u9694\u79BB\u57FA\u7EBF\u3002",
   [ERROR_CODES2.WORKTREE_NOT_REPOSITORY]: "Vite \u6839\u76EE\u5F55\u4E0D\u662F\u5DF2\u521D\u59CB\u5316 Git \u4ED3\u5E93\u7684\u9876\u5C42\u76EE\u5F55\u3002",
   [ERROR_CODES2.WORKTREE_OPERATION_IN_PROGRESS]: "\u8BF7\u5148\u5B8C\u6210\u5F53\u524D merge\u3001rebase\u3001cherry-pick \u6216 revert\uFF0C\u518D\u8FD0\u884C AI\u3002",
@@ -3076,6 +3119,15 @@ var DIALOG_FALLBACK_HEIGHT = Object.freeze({
   previewing: 560,
   selected: DIALOG_MAX_HEIGHT
 });
+function resolveStyleNonce(document) {
+  const nonces = new Set(
+    [...document.querySelectorAll("script[nonce]")].map((script) => script.nonce?.trim() ?? "").filter(Boolean)
+  );
+  if (nonces.size !== 1) {
+    return void 0;
+  }
+  return nonces.values().next().value;
+}
 function createStyles(document) {
   const style = document.createElement("style");
   style.textContent = `
@@ -3797,7 +3849,7 @@ function createUnavailableDataFlowPanel(document, changesRoot, diagnosticsRoot)
     resetView: () => void 0
   });
 }
-function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: false }), localePreference = "auto", dataFlowEnabled = false) {
+function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: false }), localePreference = "auto", dataFlowEnabled = false, externalAgentEnabled = false, framework = "vite", sessionId = "") {
   const localizer = createUiLocalizer(document, localePreference);
   let messages = localizer.messages();
   const host = document.createElement("spotpatch-root");
@@ -3914,7 +3966,19 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
   diagnostics.append(diagnosticsLabel, summary);
   const agentPanel = createAgentPanel(document, ai, localizer);
   const changesPanel = createMarkedElement(document, "div");
-  changesPanel.append(targetsPanel, agentPanel.root);
+  const externalHandoffPanel = externalAgentEnabled ? getExternalHandoffExtension()?.createPanel(
+    document,
+    framework,
+    localizer.locale,
+    sessionId,
+    localizer.subscribe,
+    placeDialog
+  ) : void 0;
+  changesPanel.append(
+    targetsPanel,
+    agentPanel.root,
+    ...externalHandoffPanel === void 0 ? [] : [externalHandoffPanel.root]
+  );
   const dataFlowPanel = getDataFlowExtension()?.createPanel(
     document,
     dataFlowEnabled,
@@ -3966,6 +4030,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     agentPanel.testButton,
     addTargetButton,
     agentPanel.runButton,
+    ...externalHandoffPanel === void 0 ? [] : [externalHandoffPanel.sendButton],
     previewButton,
     agentPanel.cancelButton,
     agentPanel.applyButton,
@@ -3981,9 +4046,19 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
   liveRegion.className = "spotpatch-live";
   liveRegion.setAttribute("aria-live", "polite");
   liveRegion.setAttribute("aria-atomic", "true");
-  shadowRoot.append(
+  const styles2 = [
     createStyles(document),
     dataFlowPanel.styles,
+    ...externalHandoffPanel === void 0 ? [] : [externalHandoffPanel.styles]
+  ];
+  const styleNonce = resolveStyleNonce(document);
+  if (styleNonce !== void 0) {
+    for (const style of styles2) {
+      style.nonce = styleNonce;
+    }
+  }
+  shadowRoot.append(
+    ...styles2,
     selectionHighlights,
     highlight,
     dialog,
@@ -4265,6 +4340,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     openEditorButton.disabled = !canOpenEditor;
     previewButton.disabled = !canPreview;
     agentPanel.setContextReady(canPreview);
+    externalHandoffPanel?.setContextReady(canPreview);
     updateContextOverview(summaryText);
     placeDialog();
   }
@@ -4281,6 +4357,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     previewButton.hidden = !selected;
     secondaryActions.hidden = !selected;
     agentPanel.setSelectionVisible(selected);
+    externalHandoffPanel?.setSelectionVisible(selected);
     copyButton.hidden = !previewing;
     backButton.hidden = !previewing;
     title.textContent = previewing ? messages.dialog.previewTitle : messages.dialog.editTitle;
@@ -4362,6 +4439,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     agentApplyButton: agentPanel.applyButton,
     agentRevertButton: agentPanel.revertButton,
     agentResetButton: agentPanel.resetButton,
+    ...externalHandoffPanel === void 0 ? {} : { externalHandoffPanel },
     renderStatus(status) {
       const inspecting = status === "inspecting";
       triggerButton.setAttribute("aria-pressed", String(inspecting));
@@ -4410,6 +4488,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       currentCanPreview = enabled;
       previewButton.disabled = !enabled;
       agentPanel.setContextReady(enabled);
+      externalHandoffPanel?.setContextReady(enabled);
     },
     hideSelection() {
       dialog.hidden = true;
@@ -4434,6 +4513,8 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       currentCanPreview = false;
       agentPanel.setContextReady(false);
       agentPanel.setSelectionVisible(false);
+      externalHandoffPanel?.setContextReady(false);
+      externalHandoffPanel?.setSelectionVisible(false);
       agentPanel.setEditingEnabled(true);
       agentPanel.resetJob();
       dataFlowPanel.resetView();
@@ -4466,6 +4547,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       });
       openEditorButton.disabled = !currentCanOpenEditor;
       previewButton.disabled = !enabled || !currentCanPreview;
+      externalHandoffPanel?.setContextReady(enabled && currentCanPreview);
       agentPanel.setEditingEnabled(enabled);
       placeDialog();
     },
@@ -4506,6 +4588,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       localeButton.removeEventListener("click", localizer.toggle);
       unsubscribeLocale();
       dataFlowPanel.dispose();
+      externalHandoffPanel?.dispose();
       agentPanel.dispose();
       host.remove();
     }
@@ -5003,7 +5086,10 @@ function createController(config, dependencies = {}) {
     config.shortcut,
     config.ai,
     config.locale,
-    config.dataFlow.enabled
+    config.dataFlow.enabled,
+    config.externalAgent.enabled,
+    config.framework,
+    config.sessionId
   );
   const api = dependencies.api ?? createRuntimeApi({
     apiBase: config.apiBase,
@@ -5326,6 +5412,7 @@ ${summary}`;
     sessionRevision += 1;
     api.cancelPending();
     agentWorkflow.disposeSelection();
+    externalHandoffWorkflow?.cancelPending();
     clearCollectionTimers();
     resizeObserver?.disconnect();
     targets = [];
@@ -5444,6 +5531,13 @@ ${summary}`;
     },
     view
   });
+  const externalHandoffWorkflow = config.externalAgent.enabled && view.externalHandoffPanel !== void 0 ? getExternalHandoffExtension()?.createWorkflow(
+    browser.window.fetch.bind(browser.window),
+    view.externalHandoffPanel,
+    selectedAnnotation,
+    config.sessionToken,
+    browser.window
+  ) : void 0;
   async function loadSourceContext(target2, revision) {
     const marker = target2.marker;
     if (marker === void 0) {
@@ -5872,6 +5966,7 @@ ${summary}`;
       return;
     }
     mounted = true;
+    externalHandoffWorkflow?.mount();
     view.renderStatus(state.status);
     browser.document.addEventListener("pointermove", handlePointerMove, true);
     browser.document.addEventListener("click", handleClick, true);
@@ -5938,6 +6033,7 @@ ${summary}`;
       api.cancelPending();
       api.dispose();
       agentWorkflow.disposeSelection();
+      externalHandoffWorkflow?.dispose();
       sourceResolver.dispose();
       return;
     }
@@ -6001,6 +6097,7 @@ ${summary}`;
     api.cancelPending();
     api.dispose();
     agentWorkflow.disposeSelection();
+    externalHandoffWorkflow?.dispose();
     sourceResolver.dispose();
     view.dispose();
     state = INITIAL_RUNTIME_STATE;