@spotpatch/runtime 1.12.0 → 1.13.0

package/dist/external-handoff-panel.d.cts

@@ -1,4 +1,4 @@
-import { ExternalHandoffFramework, SpotPatchLocale, SpotAnnotation, ExternalHandoffCapability, ExternalAgentControlStatus, ErrorCode, ExternalHandoffPublishResult, ExternalAgentManagedResult, ExternalHandoffStatusResult } from '@spotpatch/shared/external-handoff-browser';
+import { ExternalHandoffFramework, SpotPatchLocale, DispatchSummary, ExternalAgentControlStatus, SpotAnnotation, ExternalHandoffCapability, ErrorCode, ExternalHandoffPublishResult, ExternalAgentManagedResult, ExternalHandoffStatusResult } from '@spotpatch/shared/external-handoff-browser';
 
 interface ExternalHandoffPanel {
     readonly cancelManagedButton: HTMLButtonElement;
@@ -31,7 +31,7 @@ interface ExternalHandoffWorkflow {
     readonly mount: () => void;
 }
 interface ExternalHandoffExtension {
-    readonly createPanel: (document: Document, framework: ExternalHandoffFramework, locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void) => ExternalHandoffPanel;
+    readonly createPanel: (document: Document, framework: ExternalHandoffFramework, locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void, onDispatchChange?: (dispatch: DispatchSummary | null) => void, onControlChange?: (status: ExternalAgentControlStatus | undefined) => void) => ExternalHandoffPanel;
     readonly createWorkflow: (fetch: typeof globalThis.fetch, panel: ExternalHandoffPanel, selectedAnnotation: () => SpotAnnotation | undefined, sessionToken: string, window: Window) => ExternalHandoffWorkflow;
 }
 declare function registerExternalHandoffExtension(extension: ExternalHandoffExtension): void;
@@ -39,6 +39,6 @@ declare function getExternalHandoffExtension(): ExternalHandoffExtension | undef
 
 declare function createExternalHandoffWorkflow(fetch: typeof globalThis.fetch, panel: ExternalHandoffPanel, selectedAnnotation: () => SpotAnnotation | undefined, sessionToken: string, window: Window): ExternalHandoffWorkflow;
 
-declare function createExternalHandoffPanel(document: Document, framework: "vite" | "next", locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void): ExternalHandoffPanel;
+declare function createExternalHandoffPanel(document: Document, framework: "vite" | "next", locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void, onDispatchChange?: (dispatch: DispatchSummary | null) => void, onControlChange?: (status: ExternalAgentControlStatus | undefined) => void): ExternalHandoffPanel;
 
 export { type ExternalHandoffExtension, type ExternalHandoffPanel, type ExternalHandoffWorkflow, createExternalHandoffPanel, createExternalHandoffWorkflow, getExternalHandoffExtension, registerExternalHandoffExtension };

package/dist/external-handoff-panel.d.ts

@@ -1,4 +1,4 @@
-import { ExternalHandoffFramework, SpotPatchLocale, SpotAnnotation, ExternalHandoffCapability, ExternalAgentControlStatus, ErrorCode, ExternalHandoffPublishResult, ExternalAgentManagedResult, ExternalHandoffStatusResult } from '@spotpatch/shared/external-handoff-browser';
+import { ExternalHandoffFramework, SpotPatchLocale, DispatchSummary, ExternalAgentControlStatus, SpotAnnotation, ExternalHandoffCapability, ErrorCode, ExternalHandoffPublishResult, ExternalAgentManagedResult, ExternalHandoffStatusResult } from '@spotpatch/shared/external-handoff-browser';
 
 interface ExternalHandoffPanel {
     readonly cancelManagedButton: HTMLButtonElement;
@@ -31,7 +31,7 @@ interface ExternalHandoffWorkflow {
     readonly mount: () => void;
 }
 interface ExternalHandoffExtension {
-    readonly createPanel: (document: Document, framework: ExternalHandoffFramework, locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void) => ExternalHandoffPanel;
+    readonly createPanel: (document: Document, framework: ExternalHandoffFramework, locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void, onDispatchChange?: (dispatch: DispatchSummary | null) => void, onControlChange?: (status: ExternalAgentControlStatus | undefined) => void) => ExternalHandoffPanel;
     readonly createWorkflow: (fetch: typeof globalThis.fetch, panel: ExternalHandoffPanel, selectedAnnotation: () => SpotAnnotation | undefined, sessionToken: string, window: Window) => ExternalHandoffWorkflow;
 }
 declare function registerExternalHandoffExtension(extension: ExternalHandoffExtension): void;
@@ -39,6 +39,6 @@ declare function getExternalHandoffExtension(): ExternalHandoffExtension | undef
 
 declare function createExternalHandoffWorkflow(fetch: typeof globalThis.fetch, panel: ExternalHandoffPanel, selectedAnnotation: () => SpotAnnotation | undefined, sessionToken: string, window: Window): ExternalHandoffWorkflow;
 
-declare function createExternalHandoffPanel(document: Document, framework: "vite" | "next", locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void): ExternalHandoffPanel;
+declare function createExternalHandoffPanel(document: Document, framework: "vite" | "next", locale: () => SpotPatchLocale, sessionId: string, subscribeLocale: (listener: () => void) => () => void, onViewChange: () => void, onDispatchChange?: (dispatch: DispatchSummary | null) => void, onControlChange?: (status: ExternalAgentControlStatus | undefined) => void): ExternalHandoffPanel;
 
 export { type ExternalHandoffExtension, type ExternalHandoffPanel, type ExternalHandoffWorkflow, createExternalHandoffPanel, createExternalHandoffWorkflow, getExternalHandoffExtension, registerExternalHandoffExtension };

package/dist/external-handoff-panel.js

@@ -1,11 +1,11 @@
 import {
   getExternalHandoffExtension,
   registerExternalHandoffExtension
-} from "./chunk-BXRMVHNT.js";
+} from "./chunk-ASRUAKA5.js";
 import {
   createButton,
   createMarkedElement
-} from "./chunk-7ES63LA7.js";
+} from "./chunk-P6X75LO5.js";
 
 // src/controller/external-handoff-workflow.ts
 import {
@@ -1013,6 +1013,7 @@ var MESSAGES = Object.freeze({
     resultTitle: "Managed result",
     controlConnection: (state, mode) => `Connection: ${state} \xB7 Mode: ${mode}`,
     controlAuth: (auth, grant) => `Auth: ${auth} \xB7 Grant: ${grant}`,
+    controlConsentRequired: 'Grant required: type "yes" in the terminal that started `pnpm dev`. If no prompt is visible, restart `pnpm dev` in an interactive terminal and connect again.',
     controlModel: (model) => `Model: ${model}`,
     controlRevision: (task) => `Revision ${String(task.revision)}: ${task.deliveryStatus} / ${task.executionStatus} / ${task.managedPhase}`,
     controlValidation: (outcome) => `Validation: ${outcome}`,
@@ -1021,11 +1022,11 @@ var MESSAGES = Object.freeze({
     controlErrorText: Object.freeze({
       AGENT_BINARY_NOT_FOUND: "Codex is not installed or is not on PATH.",
       AGENT_BINARY_UNTRUSTED: "The resolved Codex executable is not trusted.",
-      AGENT_VERSION_UNSUPPORTED: "The installed Codex version is unsupported.",
+      AGENT_VERSION_UNSUPPORTED: "The installed Codex version is below SpotPatch's compatibility baseline.",
       APP_SERVER_HANDSHAKE_FAILED: "Codex App Server did not complete startup.",
       AGENT_AUTH_REQUIRED: "Codex requires an authenticated account.",
       AGENT_MODEL_UNAVAILABLE: "The configured Codex model is unavailable.",
-      AGENT_PROTOCOL_INCOMPATIBLE: "The Codex App Server protocol is incompatible.",
+      AGENT_PROTOCOL_INCOMPATIBLE: "The generated Codex App Server schema is incompatible with SpotPatch's required protocol subset.",
       CODEX_CONFIG_ISOLATION_UNSUPPORTED: "This Codex version cannot prove managed configuration isolation.",
       MANAGED_GRANT_INVALID: "The saved project grant failed validation.",
       MANAGED_PLATFORM_UNSUPPORTED: "Managed execution is not proven safe on this platform.",
@@ -1033,14 +1034,14 @@ var MESSAGES = Object.freeze({
       MANAGED_SNAPSHOT_FAILED: "The independent workspace snapshot could not be created.",
       MANAGED_SCOPE_VIOLATION: "The candidate change exceeded its authorized paths.",
       MANAGED_CHANGE_LIMIT_EXCEEDED: "The candidate change exceeded safety limits.",
-      MANAGED_VALIDATION_FAILED: "A required check failed or changed the candidate diff.",
+      MANAGED_VALIDATION_FAILED: "The candidate change did not pass audit or validation.",
       MANAGED_WORKSPACE_CONFLICT: "An authorized source file changed during execution.",
       MANAGED_APPLY_FAILED: "The audited change could not be applied safely.",
       MANAGED_CLEANUP_INCOMPLETE: "Managed thread or workspace cleanup is incomplete."
     }),
     controlActionText: Object.freeze({
       "install-agent": "Install Codex and retry.",
-      "use-supported-version": "Use a supported Codex version.",
+      "use-supported-version": "Use a schema-compatible Codex version.",
       "sign-in": "Sign in with Codex, then retry.",
       "choose-available-model": "Choose an available model in Codex configuration.",
       "use-inbox": "Continue with the Agent inbox fallback.",
@@ -1099,6 +1100,7 @@ var MESSAGES = Object.freeze({
     resultTitle: "\u53D7\u7BA1\u6267\u884C\u7ED3\u679C",
     controlConnection: (state, mode) => `\u8FDE\u63A5\uFF1A${state} \xB7 \u6A21\u5F0F\uFF1A${mode}`,
     controlAuth: (auth, grant) => `\u8BA4\u8BC1\uFF1A${auth} \xB7 \u6388\u6743\uFF1A${grant}`,
+    controlConsentRequired: "\u9700\u8981\u9879\u76EE\u6388\u6743\uFF1A\u8BF7\u5728\u542F\u52A8 `pnpm dev` \u7684\u7EC8\u7AEF\u8F93\u5165\u201Cyes\u201D\u3002\u82E5\u7EC8\u7AEF\u6CA1\u6709\u51FA\u73B0\u786E\u8BA4\u63D0\u793A\uFF0C\u8BF7\u5728\u53EF\u4EA4\u4E92\u7EC8\u7AEF\u91CD\u65B0\u542F\u52A8 `pnpm dev` \u540E\u518D\u8FDE\u63A5\u3002",
     controlModel: (model) => `\u6A21\u578B\uFF1A${model}`,
     controlRevision: (task) => `revision ${String(task.revision)}\uFF1A${task.deliveryStatus} / ${task.executionStatus} / ${task.managedPhase}`,
     controlValidation: (outcome) => `\u9A8C\u8BC1\uFF1A${outcome}`,
@@ -1107,11 +1109,11 @@ var MESSAGES = Object.freeze({
     controlErrorText: Object.freeze({
       AGENT_BINARY_NOT_FOUND: "\u672A\u5B89\u88C5 Codex\uFF0C\u6216 Codex \u4E0D\u5728 PATH \u4E2D\u3002",
       AGENT_BINARY_UNTRUSTED: "\u89E3\u6790\u5230\u7684 Codex \u53EF\u6267\u884C\u6587\u4EF6\u4E0D\u53EF\u4FE1\u3002",
-      AGENT_VERSION_UNSUPPORTED: "\u5DF2\u5B89\u88C5\u7684 Codex \u7248\u672C\u4E0D\u53D7\u652F\u6301\u3002",
+      AGENT_VERSION_UNSUPPORTED: "\u5DF2\u5B89\u88C5\u7684 Codex \u7248\u672C\u4F4E\u4E8E SpotPatch \u517C\u5BB9\u57FA\u7EBF\u3002",
       APP_SERVER_HANDSHAKE_FAILED: "Codex App Server \u672A\u5B8C\u6210\u542F\u52A8\u63E1\u624B\u3002",
       AGENT_AUTH_REQUIRED: "Codex \u9700\u8981\u5DF2\u767B\u5F55\u7684\u8D26\u6237\u3002",
       AGENT_MODEL_UNAVAILABLE: "Codex \u914D\u7F6E\u7684\u6A21\u578B\u5F53\u524D\u4E0D\u53EF\u7528\u3002",
-      AGENT_PROTOCOL_INCOMPATIBLE: "Codex App Server \u534F\u8BAE\u4E0D\u517C\u5BB9\u3002",
+      AGENT_PROTOCOL_INCOMPATIBLE: "Codex \u751F\u6210\u7684 App Server Schema \u4E0D\u6EE1\u8DB3 SpotPatch \u6240\u9700\u534F\u8BAE\u5B50\u96C6\u3002",
       CODEX_CONFIG_ISOLATION_UNSUPPORTED: "\u5F53\u524D Codex \u7248\u672C\u65E0\u6CD5\u8BC1\u660E\u53D7\u7BA1\u914D\u7F6E\u9694\u79BB\u3002",
       MANAGED_GRANT_INVALID: "\u4FDD\u5B58\u7684\u9879\u76EE\u6388\u6743\u672A\u901A\u8FC7\u6821\u9A8C\u3002",
       MANAGED_PLATFORM_UNSUPPORTED: "\u5F53\u524D\u5E73\u53F0\u5C1A\u672A\u8BC1\u660E\u53EF\u5B89\u5168\u8FD0\u884C\u53D7\u7BA1\u6267\u884C\u3002",
@@ -1119,14 +1121,14 @@ var MESSAGES = Object.freeze({
       MANAGED_SNAPSHOT_FAILED: "\u65E0\u6CD5\u521B\u5EFA\u72EC\u7ACB\u5DE5\u4F5C\u533A\u5FEB\u7167\u3002",
       MANAGED_SCOPE_VIOLATION: "\u5019\u9009\u4FEE\u6539\u8D85\u51FA\u6388\u6743\u8DEF\u5F84\u3002",
       MANAGED_CHANGE_LIMIT_EXCEEDED: "\u5019\u9009\u4FEE\u6539\u8D85\u8FC7\u5B89\u5168\u4E0A\u9650\u3002",
-      MANAGED_VALIDATION_FAILED: "required check \u5931\u8D25\u6216\u6539\u53D8\u4E86\u5019\u9009 diff\u3002",
+      MANAGED_VALIDATION_FAILED: "\u5019\u9009\u4FEE\u6539\u672A\u901A\u8FC7\u5BA1\u8BA1\u6216\u9A8C\u8BC1\u3002",
       MANAGED_WORKSPACE_CONFLICT: "\u6267\u884C\u671F\u95F4\u6388\u6743\u6E90\u7801\u53D1\u751F\u4E86\u53D8\u5316\u3002",
       MANAGED_APPLY_FAILED: "\u5DF2\u5BA1\u8BA1\u4FEE\u6539\u65E0\u6CD5\u5B89\u5168\u5199\u5165\u3002",
       MANAGED_CLEANUP_INCOMPLETE: "\u53D7\u7BA1 thread \u6216\u5DE5\u4F5C\u533A\u6E05\u7406\u4E0D\u5B8C\u6574\u3002"
     }),
     controlActionText: Object.freeze({
       "install-agent": "\u5B89\u88C5 Codex \u540E\u91CD\u8BD5\u3002",
-      "use-supported-version": "\u6539\u7528\u53D7\u652F\u6301\u7684 Codex \u7248\u672C\u3002",
+      "use-supported-version": "\u6539\u7528 Schema \u517C\u5BB9\u7684 Codex \u7248\u672C\u3002",
       "sign-in": "\u767B\u5F55 Codex \u540E\u91CD\u8BD5\u3002",
       "choose-available-model": "\u5728 Codex \u914D\u7F6E\u4E2D\u9009\u62E9\u53EF\u7528\u6A21\u578B\u3002",
       "use-inbox": "\u7EE7\u7EED\u4F7F\u7528 Agent \u6536\u4EF6\u7BB1\u964D\u7EA7\u8DEF\u5F84\u3002",
@@ -1263,6 +1265,7 @@ function controlStatusText(value, messages) {
   const parts = [
     messages.controlConnection(value.connectionState, value.mode),
     messages.controlAuth(value.authReadiness, value.grantState),
+    ...value.connectionState === "awaiting-consent" && value.grantState === "missing" ? [messages.controlConsentRequired] : [],
     ...model === void 0 ? [] : [messages.controlModel(model)],
     ...task === void 0 ? [] : [
       messages.controlRevision(task),
@@ -1295,11 +1298,13 @@ function managedResultText(result, messages) {
     ...timings
   ].join("\n");
 }
-function createExternalHandoffPanel(document, framework, locale, sessionId, subscribeLocale, onViewChange) {
+function createExternalHandoffPanel(document, framework, locale, sessionId, subscribeLocale, onViewChange, onDispatchChange, onControlChange) {
   const options = {
     document,
     framework,
     locale,
+    ...onDispatchChange === void 0 ? {} : { onDispatchChange },
+    ...onControlChange === void 0 ? {} : { onControlChange },
     onViewChange,
     sessionId,
     subscribeLocale
@@ -1324,6 +1329,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
   root.hidden = true;
   const heading = createMarkedElement(document, "div");
   heading.className = "spotpatch-external-heading";
+  heading.setAttribute("data-spotpatch-agent-identity", "");
   const title = createMarkedElement(document, "strong");
   const refreshButton = createButton(document, "", "spotpatch-external-refresh");
   heading.append(title, refreshButton);
@@ -1552,6 +1558,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
       status.textContent = summaryMessage(result.handoff);
     }
     refreshActions();
+    options.onDispatchChange?.(result.dispatch);
     options.onViewChange();
   };
   return Object.freeze({
@@ -1593,6 +1600,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
       status.dataset.state = capability.brokerReady ? "ready" : "error";
       status.textContent = capability.brokerReady ? capability.activeAdapter?.canDispatch === true ? messages.activeReady(agentName(capability.activeAdapter.kind)) : capability.dispatch !== null && capability.activeAdapter !== null ? dispatchMessage(messages, capability.dispatch) : capability.activeWaitCount > 0 ? messages.readyWaiting(capability.activeWaitCount) : messages.ready : messages.error("EXTERNAL_HANDOFF_UNAVAILABLE");
       refreshActions();
+      options.onDispatchChange?.(capability.dispatch);
       options.onViewChange();
     },
     renderPublishing() {
@@ -1621,6 +1629,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
       controlStatus.dataset.state = value.connectionState;
       disclosureNoGuarantee.textContent = value.mode === "managed" ? messages.disclosureManagedGuarantee : messages.disclosureNoGuarantee;
       refreshControlActions();
+      options.onControlChange?.(value);
       options.onViewChange();
     },
     renderControlUnavailable() {
@@ -1629,6 +1638,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
       controlStatus.textContent = messages.controlUnavailable;
       disclosureNoGuarantee.textContent = messages.disclosureNoGuarantee;
       refreshControlActions();
+      options.onControlChange?.(void 0);
       options.onViewChange();
     },
     renderManagedResult(result) {
@@ -1646,6 +1656,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
       status.dataset.state = "error";
       status.textContent = canRetry ? `${messages.error(code)} ${messages.retry}.` : messages.error(code);
       refreshActions();
+      options.onDispatchChange?.(null);
       options.onViewChange();
     },
     setBusy(nextBusy) {