@spotpatch/runtime 1.13.0 → 1.15.0

package/dist/index.cjs

@@ -293,7 +293,7 @@ function readSuccessData(value) {
   return value.data;
 }
 function isCodeContext(value) {
-  return isRecord2(value) && typeof value.relativePath === "string" && (value.language === "tsx" || value.language === "jsx") && typeof value.startLine === "number" && typeof value.endLine === "number" && typeof value.excerpt === "string" && (value.boundary === "component" || value.boundary === "nearby-lines");
+  return isRecord2(value) && typeof value.relativePath === "string" && (value.language === "tsx" || value.language === "jsx" || value.language === "astro") && typeof value.startLine === "number" && typeof value.endLine === "number" && typeof value.excerpt === "string" && (value.boundary === "component" || value.boundary === "nearby-lines");
 }
 function deepFreezeUnknown(value) {
   if (!isRecord2(value) && !Array.isArray(value)) {
@@ -424,7 +424,7 @@ function omitBrowserCodeContext(request) {
   };
 }
 function runtimeApiErrorCode(error) {
-  return error instanceof RuntimeApiError ? error.code : void 0;
+  return error instanceof RuntimeApiError && isAgentErrorCode(error.code) ? error.code : void 0;
 }
 function createRuntimeApi(options) {
   const pendingRequests = /* @__PURE__ */ new Set();
@@ -1721,7 +1721,11 @@ function createSourceResolver(options) {
       if (marker !== void 0) {
         return Object.freeze({
           react: react2,
-          source: markerSource(marker, "jsx-host", "exact")
+          source: markerSource(
+            marker,
+            marker.kind === "astro" ? "astro-host" : "jsx-host",
+            "exact"
+          )
         });
       }
       if (react2.source !== void 0) {
@@ -2548,6 +2552,12 @@ function getExternalHandoffExtension() {
   return globalThis[EXTERNAL_HANDOFF_EXTENSION_KEY];
 }
 
+// src/ui/contextual-ask-contract.ts
+var CONTEXTUAL_ASK_EXTENSION_KEY = /* @__PURE__ */ Symbol.for("spotpatch.contextual-ask.v1");
+function getContextualAskExtension() {
+  return globalThis[CONTEXTUAL_ASK_EXTENSION_KEY];
+}
+
 // src/ui/motion-extension-contract.ts
 var MOTION_EXTENSION_KEY = /* @__PURE__ */ Symbol.for("spotpatch.motion.v1");
 function getFloatingSurfaceMotionExtension() {
@@ -4353,7 +4363,7 @@ function createUnavailableDataFlowPanel(document, changesRoot, diagnosticsRoot)
     resetView: () => void 0
   });
 }
-function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: false }), localePreference = "auto", dataFlowEnabled = false, externalAgentEnabled = false, framework = "vite", sessionId = "") {
+function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: false }), localePreference = "auto", dataFlowEnabled = false, externalAgentEnabled = false, framework = "vite", sessionId = "", contextualAskEnabled = false) {
   const localizer = createUiLocalizer(document, localePreference);
   const associatedWindow = document.defaultView;
   if (associatedWindow === null) {
@@ -4367,6 +4377,9 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
   );
   let messages = localizer.messages();
   let currentStatus = "idle";
+  let contextualAskMode = "change";
+  let contextualAskTitle = "";
+  let contextualAskSubtitle = "";
   let plannerVisible = false;
   let executionSuppressed = false;
   let executionProjection;
@@ -4576,6 +4589,29 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     backButton
   );
   actions.append(editorFeedback, secondaryActions, primaryActions);
+  const contextualAskPanel = contextualAskEnabled ? getContextualAskExtension()?.createPanel({
+    document,
+    locale: localizer.locale,
+    subscribeLocale: localizer.subscribe,
+    changeRoot: dataFlowPanel.root,
+    changeActions: actions,
+    announce,
+    onModeChange(mode, askTitle, askSubtitle) {
+      contextualAskMode = mode;
+      contextualAskTitle = askTitle;
+      contextualAskSubtitle = askSubtitle;
+      if (host.isConnected) renderPanelStatus(currentStatus);
+    },
+    onExecutionChange(projection) {
+      executionProjection = projection;
+      executionSuppressed = false;
+      renderFloatingSurfaceMotion();
+    },
+    onViewChange: requestFloatingSurfaceLayout
+  }) : void 0;
+  if (contextualAskPanel !== void 0) {
+    selectionPanel.prepend(contextualAskPanel.root);
+  }
   shell.append(header, body, actions);
   dialog.append(shell);
   const liveRegion = createMarkedElement(document, "div");
@@ -4586,6 +4622,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     createStyles(document),
     ...motionExtension === void 0 ? [] : [motionExtension.createStyles(document)],
     dataFlowPanel.styles,
+    ...contextualAskPanel === void 0 ? [] : [contextualAskPanel.styles],
     ...externalHandoffPanel === void 0 ? [] : [externalHandoffPanel.styles]
   ];
   const styleNonce = resolveStyleNonce(document);
@@ -5138,6 +5175,11 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     previewButton.disabled = !canPreview;
     agentPanel.setContextReady(canPreview);
     externalHandoffPanel?.setContextReady(canPreview);
+    contextualAskPanel?.setSelectionPreview({
+      contextReady: currentTargets.every((target2) => target2.status !== "loading"),
+      targetCount: currentTargets.length,
+      sourceCount: currentTargets.filter((target2) => target2.canOpenEditor).length
+    });
     updateContextOverview(summaryText);
     requestFloatingSurfaceLayout();
   }
@@ -5154,10 +5196,11 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     secondaryActions.hidden = !selected;
     agentPanel.setSelectionVisible(selected);
     externalHandoffPanel?.setSelectionVisible(selected);
+    contextualAskPanel?.setSelectionVisible(selected);
     copyButton.hidden = !previewing;
     backButton.hidden = !previewing;
-    title.textContent = previewing ? messages.dialog.previewTitle : messages.dialog.editTitle;
-    subtitle.textContent = previewing ? messages.dialog.previewSubtitle : messages.dialog.editSubtitle;
+    title.textContent = previewing ? messages.dialog.previewTitle : contextualAskMode === "ask" && contextualAskTitle.length > 0 ? contextualAskTitle : messages.dialog.editTitle;
+    subtitle.textContent = previewing ? messages.dialog.previewSubtitle : contextualAskMode === "ask" && contextualAskSubtitle.length > 0 ? contextualAskSubtitle : messages.dialog.editSubtitle;
     renderFloatingSurfaceMotion();
   }
   function applyMessages() {
@@ -5292,6 +5335,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     agentRevertButton: agentPanel.revertButton,
     agentResetButton: agentPanel.resetButton,
     ...externalHandoffPanel === void 0 ? {} : { externalHandoffPanel },
+    ...contextualAskPanel === void 0 ? {} : { contextualAskPanel },
     renderStatus(status) {
       const inspecting = status === "inspecting";
       if (status === "idle" || inspecting) {
@@ -5365,6 +5409,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       agentPanel.setSelectionVisible(false);
       externalHandoffPanel?.setContextReady(false);
       externalHandoffPanel?.setSelectionVisible(false);
+      contextualAskPanel?.setSelectionVisible(false);
       agentPanel.setEditingEnabled(true);
       agentPanel.resetJob();
       dataFlowPanel.resetView();
@@ -5505,6 +5550,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       unsubscribeLocale();
       dataFlowPanel.dispose();
       externalHandoffPanel?.dispose();
+      contextualAskPanel?.dispose();
       agentPanel.dispose();
       motionController?.dispose();
       executionIslandView.dispose();
@@ -5534,7 +5580,7 @@ function sourceLocation2(resolution, context, messages) {
 function createSelectionSummary(input, messages) {
   const lines = [
     `SpotPatch: ${input.spotPatchVersion}`,
-    `${input.framework === "next" ? "Next.js" : "Vite"}: ${input.frameworkVersion}`,
+    `${{ next: "Next.js", vite: "Vite", astro: "Astro" }[input.framework]}: ${input.frameworkVersion}`,
     `${messages.source}: ${sourceLocation2(input.resolution, input.code, messages)}`,
     `${messages.confidence}: ${input.resolution.source.confidence} (${messages.confidenceLabels[input.resolution.source.confidence]})`,
     `${messages.origin}: ${input.resolution.source.origin}`
@@ -6023,7 +6069,8 @@ function createController(config, dependencies = {}) {
     config.dataFlow.enabled,
     config.externalAgent.enabled,
     config.framework,
-    config.sessionId
+    config.sessionId,
+    config.contextualAsk.enabled
   );
   const api = dependencies.api ?? createRuntimeApi({
     apiBase: config.apiBase,
@@ -6226,6 +6273,19 @@ function createController(config, dependencies = {}) {
       (target2) => target2.instruction.trim().length > 0 && target2.elementContext !== void 0 && target2.styles !== void 0 && target2.apiStatus !== "loading"
     );
   }
+  function selectedAskSelection() {
+    const snapshots = targets.flatMap((target2) => {
+      const snapshot = snapshotTarget(target2);
+      return snapshot === void 0 ? [] : [snapshot];
+    });
+    if (snapshots.length === 0 || snapshots.length !== targets.length) {
+      return void 0;
+    }
+    return Object.freeze({
+      locale: view.locale(),
+      targets: snapshots
+    });
+  }
   function selectionSummary() {
     const messages = view.messages().summary;
     return targets.map((target2, index) => {
@@ -6347,6 +6407,7 @@ ${summary}`;
     api.cancelPending();
     agentWorkflow.disposeSelection();
     externalHandoffWorkflow?.cancelPending();
+    contextualAskWorkflow?.cancelPending();
     clearCollectionTimers();
     resizeObserver?.disconnect();
     targets = [];
@@ -6472,6 +6533,27 @@ ${summary}`;
     config.sessionToken,
     browser.window
   ) : void 0;
+  const contextualAskWorkflow = config.contextualAsk.enabled && view.contextualAskPanel !== void 0 ? getContextualAskExtension()?.createWorkflow({
+    ...clipboard === void 0 ? {} : { clipboard },
+    createId,
+    fetch: browser.window.fetch.bind(browser.window),
+    getSelection: selectedAskSelection,
+    onBusyChange(busy) {
+      view.setAgentEditingEnabled(!busy);
+    },
+    onConvert() {
+      view.focusTargetInstruction(activeTargetId);
+    },
+    async onOpenSource(source2) {
+      await api.openEditor({
+        fileId: source2.fileId,
+        line: source2.startLine,
+        column: 1
+      });
+    },
+    panel: view.contextualAskPanel,
+    sessionToken: config.sessionToken
+  }) : void 0;
   async function loadSourceContext(target2, revision) {
     const marker = target2.marker;
     if (marker === void 0) {
@@ -6585,6 +6667,7 @@ ${summary}`;
       previewPrompt = "";
       agentWorkflow.beginSelection();
       workflowSelectionActive = true;
+      contextualAskWorkflow?.beginSelection();
     }
     targetSequence += 1;
     const target2 = {
@@ -6603,6 +6686,9 @@ ${summary}`;
       dataFlowStatus: "idle"
     };
     targets.push(target2);
+    if (!initialSelection) {
+      contextualAskWorkflow?.selectionChanged();
+    }
     activeTargetId = target2.id;
     addingTarget = false;
     const revision = sessionRevision;
@@ -6719,10 +6805,12 @@ ${summary}`;
       pageDataFlowStatus = "idle";
       renderDataFlowView();
       selectionSession.clear();
+      contextualAskWorkflow?.selectionChanged();
       view.announce(view.messages().announcements.allTargetsRemoved);
       return;
     }
     refreshSelectionView();
+    contextualAskWorkflow?.selectionChanged();
     void loadDataFlowReports();
     persistSelection();
     view.announce(view.messages().announcements.targetRemoved);
@@ -6901,6 +6989,7 @@ ${summary}`;
     }
     mounted = true;
     externalHandoffWorkflow?.mount();
+    contextualAskWorkflow?.mount();
     view.renderStatus(state.status);
     browser.document.addEventListener("pointermove", handlePointerMove, true);
     browser.document.addEventListener("click", handleClick, true);
@@ -6952,6 +7041,7 @@ ${summary}`;
     if (selectionOpen && targets.length > 0) {
       transition({ type: "RESTORE" });
       agentWorkflow.beginSelection();
+      contextualAskWorkflow?.beginSelection();
       workflowSelectionActive = true;
       refreshSelectionView(true);
     }
@@ -6968,6 +7058,7 @@ ${summary}`;
       api.dispose();
       agentWorkflow.disposeSelection();
       externalHandoffWorkflow?.dispose();
+      contextualAskWorkflow?.dispose();
       sourceResolver.dispose();
       return;
     }
@@ -7032,6 +7123,7 @@ ${summary}`;
     api.dispose();
     agentWorkflow.disposeSelection();
     externalHandoffWorkflow?.dispose();
+    contextualAskWorkflow?.dispose();
     sourceResolver.dispose();
     view.dispose();
     state = INITIAL_RUNTIME_STATE;
@@ -7047,6 +7139,7 @@ function bootstrapSpotPatch(config) {
   const controller = createController(config);
   target2[RUNTIME_INSTANCE_KEY] = controller;
   controller.mount();
+  return controller;
 }
 
 // src/data-flow/data-flow-runtime.ts
@@ -7466,7 +7559,7 @@ var import_shared10 = require("@spotpatch/shared");
 function observationMatchesDependency(observation, dependency) {
   const origin = dependency.origin;
   const transportMatches = dependency.kind === "rpc" ? observation.transport === "trpc" && dependency.operation !== void 0 && observation.operation === dependency.operation : dependency.kind === "http" ? observation.transport === "fetch" || observation.transport === "xhr" : false;
-  if (!transportMatches || observation.freshness !== "current" || origin === void 0 || observation.requestCallsiteId !== origin.requestCallsiteId || observation.sourceVersion !== origin.sourceVersion || dependency.method !== void 0 && observation.method.toUpperCase() !== dependency.method.toUpperCase() || dependency.url !== void 0 && observation.url.pathname !== dependency.url.pathname || dependency.url?.origin !== void 0 && observation.url.origin !== dependency.url.origin || origin.componentSourceId !== void 0 && observation.componentSourceId !== void 0 && observation.componentSourceId !== origin.componentSourceId || origin.triggerCallsiteId !== void 0 && observation.triggerCallsiteId !== void 0 && observation.triggerCallsiteId !== origin.triggerCallsiteId) {
+  if (dependency.environment === "server" || !transportMatches || observation.freshness !== "current" || origin === void 0 || observation.requestCallsiteId !== origin.requestCallsiteId || observation.sourceVersion !== origin.sourceVersion || dependency.method !== void 0 && observation.method.toUpperCase() !== dependency.method.toUpperCase() || dependency.url !== void 0 && observation.url.pathname !== dependency.url.pathname || dependency.url?.origin !== void 0 && observation.url.origin !== dependency.url.origin || origin.componentSourceId !== void 0 && observation.componentSourceId !== void 0 && observation.componentSourceId !== origin.componentSourceId || origin.triggerCallsiteId !== void 0 && observation.triggerCallsiteId !== void 0 && observation.triggerCallsiteId !== origin.triggerCallsiteId) {
     return false;
   }
   return dependency.association !== "transitive" || observation.componentSourceId === origin.componentSourceId && observation.triggerCallsiteId === origin.triggerCallsiteId;
@@ -7524,8 +7617,12 @@ function appendRuntimeEvidence(evidence, observations, matchedIds) {
   ]);
 }
 function mergeComponentDataFlowReport(report, observations) {
+  const owners = /* @__PURE__ */ new Set([
+    report.component.componentSourceId,
+    ...report.dependencies.filter((dependency) => dependency.environment !== "server").map((dependency) => dependency.origin?.componentSourceId)
+  ]);
   const componentObservations = observations.filter(
-    (observation) => observation.componentSourceId === void 0 || observation.componentSourceId === report.component.componentSourceId
+    (observation) => observation.componentSourceId === void 0 || owners.has(observation.componentSourceId)
   );
   const merged = mergeDependencies(report.dependencies, componentObservations);
   return (0, import_shared10.limitDataFlowReportCollections)(