@spotpatch/runtime 1.15.0 → 1.15.2

package/dist/{chunk-ASRUAKA5.js → chunk-TEH2CCO3.js}

@@ -11,4 +11,4 @@ export {
   registerExternalHandoffExtension,
   getExternalHandoffExtension
 };
-//# sourceMappingURL=chunk-ASRUAKA5.js.map
+//# sourceMappingURL=chunk-TEH2CCO3.js.map

package/dist/chunk-TEH2CCO3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ui/external-handoff-contract.ts"],"sourcesContent":["import type {\n  DispatchSummary,\n  ErrorCode,\n  ExternalAgentControlStatus,\n  ExternalAgentManagedResult,\n  ExternalHandoffCapability,\n  ExternalHandoffPublishResult,\n  ExternalHandoffStatusResult,\n  ExternalHandoffFramework,\n  SpotAnnotation,\n  SpotPatchLocale,\n} from \"@spotpatch/shared/external-handoff-browser\";\n\nexport interface ExternalHandoffPanel {\n  readonly cancelManagedButton: HTMLButtonElement;\n  readonly connectButton: HTMLButtonElement;\n  readonly readModel: () => string | undefined;\n  readonly disconnectButton: HTMLButtonElement;\n  readonly refreshButton: HTMLButtonElement;\n  readonly root: HTMLElement;\n  readonly sendButton: HTMLButtonElement;\n  readonly styles: HTMLStyleElement;\n  readonly confirmDisclosure: (annotation: SpotAnnotation) => Promise<boolean>;\n  readonly dispose: () => void;\n  readonly renderCapability: (capability: ExternalHandoffCapability) => void;\n  readonly renderControlUnavailable: () => void;\n  readonly renderControlStatus: (status: ExternalAgentControlStatus) => void;\n  readonly renderError: (code?: ErrorCode, retryable?: boolean) => void;\n  readonly renderPublishResult: (result: ExternalHandoffPublishResult) => void;\n  readonly renderPublishing: () => void;\n  readonly renderManagedResult: (result: ExternalAgentManagedResult) => void;\n  readonly renderStatus: (result: ExternalHandoffStatusResult) => void;\n  readonly resolveButton: HTMLButtonElement;\n  readonly revokeButton: HTMLButtonElement;\n  readonly setBusy: (busy: boolean) => void;\n  readonly setControlBusy: (busy: boolean) => void;\n  readonly setContextReady: (ready: boolean) => void;\n  readonly setSelectionVisible: (visible: boolean) => void;\n}\n\nexport interface ExternalHandoffWorkflow {\n  readonly cancelPending: () => void;\n  readonly dispose: () => void;\n  readonly mount: () => void;\n}\n\nexport interface ExternalHandoffExtension {\n  readonly createPanel: (\n    document: Document,\n    framework: ExternalHandoffFramework,\n    locale: () => SpotPatchLocale,\n    sessionId: string,\n    subscribeLocale: (listener: () => void) => () => void,\n    onViewChange: () => void,\n    onDispatchChange?: (dispatch: DispatchSummary | null) => void,\n    onControlChange?: (status: ExternalAgentControlStatus | undefined) => void,\n  ) => ExternalHandoffPanel;\n  readonly createWorkflow: (\n    fetch: typeof globalThis.fetch,\n    panel: ExternalHandoffPanel,\n    selectedAnnotation: () => SpotAnnotation | undefined,\n    sessionToken: string,\n    window: Window,\n  ) => ExternalHandoffWorkflow;\n}\n\nconst EXTERNAL_HANDOFF_EXTENSION_KEY = Symbol.for(\"spotpatch.external-handoff.v1\");\ntype ExtensionStore = Partial<Record<symbol, ExternalHandoffExtension>>;\n\nexport function registerExternalHandoffExtension(\n  extension: ExternalHandoffExtension,\n): void {\n  (globalThis as ExtensionStore)[EXTERNAL_HANDOFF_EXTENSION_KEY] = extension;\n}\n\nexport function getExternalHandoffExtension(): ExternalHandoffExtension | undefined {\n  return (globalThis as ExtensionStore)[EXTERNAL_HANDOFF_EXTENSION_KEY];\n}\n"],"mappings":";AAkEA,IAAM,iCAAiC,uBAAO,IAAI,+BAA+B;AAG1E,SAAS,iCACd,WACM;AACN,EAAC,WAA8B,8BAA8B,IAAI;AACnE;AAEO,SAAS,8BAAoE;AAClF,SAAQ,WAA8B,8BAA8B;AACtE;","names":[]}

package/dist/external-handoff-panel.cjs

@@ -197,6 +197,9 @@ function parseTask(value) {
     ...value.resultExpiresAt === void 0 ? {} : { resultExpiresAt: value.resultExpiresAt }
   });
 }
+function validModel(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= import_external_handoff_browser.EXTERNAL_AGENT_CONTROL_LIMITS.maximumModelCharacters && value.trim() === value;
+}
 function parseExternalAgentControlStatus(value) {
   if (!record(value) || !optionalKeys(
     value,
@@ -210,8 +213,8 @@ function parseExternalAgentControlStatus(value) {
       "sequence",
       "updatedAt"
     ],
-    ["effectiveModel", "error", "requestedModel", "task"]
-  ) || value.schemaVersion !== 1 || !integer(value.sequence) || !member(import_external_handoff_browser.EXTERNAL_AGENT_MODES, value.mode) || !member(import_external_handoff_browser.EXTERNAL_AGENT_CONNECTION_STATES, value.connectionState) || !member(import_external_handoff_browser.EXTERNAL_AGENT_AUTH_READINESS, value.authReadiness) || !member(import_external_handoff_browser.EXTERNAL_AGENT_GRANT_STATES, value.grantState) || !validTimestamp(value.updatedAt) || value.requestedModel !== void 0 && (typeof value.requestedModel !== "string" || value.requestedModel.length === 0 || value.requestedModel.length > 128) || value.effectiveModel !== void 0 && (typeof value.effectiveModel !== "string" || value.effectiveModel.length === 0 || value.effectiveModel.length > 128) || !record(value.adapter) || !exactKeys(value.adapter, ["availability", "kind", "maturity"]) || value.adapter.kind !== "codex" || value.adapter.maturity !== "experimental" || value.adapter.availability !== "available" && value.adapter.availability !== "unavailable") {
+    ["effectiveModel", "error", "requestedModel", "task", "models"]
+  ) || value.schemaVersion !== 1 || !integer(value.sequence) || !member(import_external_handoff_browser.EXTERNAL_AGENT_MODES, value.mode) || !member(import_external_handoff_browser.EXTERNAL_AGENT_CONNECTION_STATES, value.connectionState) || !member(import_external_handoff_browser.EXTERNAL_AGENT_AUTH_READINESS, value.authReadiness) || !member(import_external_handoff_browser.EXTERNAL_AGENT_GRANT_STATES, value.grantState) || !validTimestamp(value.updatedAt) || value.requestedModel !== void 0 && !validModel(value.requestedModel) || value.effectiveModel !== void 0 && !validModel(value.effectiveModel) || value.models !== void 0 && (!Array.isArray(value.models) || value.models.length === 0 || value.models.length > import_external_handoff_browser.EXTERNAL_AGENT_CONTROL_LIMITS.maximumModels || !value.models.every(validModel) || new Set(value.models).size !== value.models.length) || !record(value.adapter) || !exactKeys(value.adapter, ["availability", "kind", "maturity"]) || value.adapter.kind !== "codex" || value.adapter.maturity !== "experimental" || value.adapter.availability !== "available" && value.adapter.availability !== "unavailable") {
     throw new TypeError("Invalid external Agent control status.");
   }
   let error;
@@ -238,6 +241,7 @@ function parseExternalAgentControlStatus(value) {
     connectionState: value.connectionState,
     authReadiness: value.authReadiness,
     grantState: value.grantState,
+    ...value.models === void 0 ? {} : { models: Object.freeze([...value.models]) },
     ...value.requestedModel === void 0 ? {} : { requestedModel: value.requestedModel },
     ...value.effectiveModel === void 0 ? {} : { effectiveModel: value.effectiveModel },
     ...value.task === void 0 ? {} : { task: parseTask(value.task) },
@@ -736,11 +740,13 @@ function createExternalHandoffWorkflow(fetch, panel, selectedAnnotation, session
     }
   };
   const handleConnectClick = () => {
+    const model = options.panel.readModel();
     void performControlAction(
       () => controlClient.connect({
         requestId: createRequestId(options.window),
         adapterKind: "codex",
-        profile: import_external_handoff_browser2.EXTERNAL_AGENT_MANAGED_PROFILE
+        profile: import_external_handoff_browser2.EXTERNAL_AGENT_MANAGED_PROFILE,
+        ...model === void 0 ? {} : { model }
       })
     );
   };
@@ -1029,6 +1035,10 @@ var MESSAGES = Object.freeze({
   "en-US": Object.freeze({
     title: "External Agent connection",
     agentLabel: "Agent",
+    modelLabel: "Managed Codex model",
+    modelLoading: "Connect to load available models",
+    modelHint: "Applies only to this managed connection, not API Key settings. Apply changes before publishing; switching reconnects Codex.",
+    applyModel: "Apply model",
     codexManaged: "Codex \xB7 managed (experimental)",
     connectManaged: "Connect Codex",
     disconnectManaged: "Disconnect",
@@ -1067,7 +1077,7 @@ var MESSAGES = Object.freeze({
       "install-agent": "Install Codex and retry.",
       "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.",
+      "choose-available-model": "Choose an available model and reconnect Codex.",
       "use-inbox": "Continue with the Agent inbox fallback.",
       "confirm-managed-access": "Revoke the invalid grant and confirm access again.",
       "review-candidate-diff": "Review the candidate diff and validation output.",
@@ -1116,6 +1126,10 @@ var MESSAGES = Object.freeze({
   "zh-CN": Object.freeze({
     title: "\u5916\u90E8 Agent \u8FDE\u63A5",
     agentLabel: "Agent",
+    modelLabel: "\u53D7\u7BA1 Codex \u6A21\u578B",
+    modelLoading: "\u8FDE\u63A5\u540E\u52A0\u8F7D\u53EF\u7528\u6A21\u578B",
+    modelHint: "\u4EC5\u4F5C\u7528\u4E8E\u6B64\u53D7\u7BA1\u8FDE\u63A5\uFF0C\u4E0D\u4FEE\u6539 API Key \u914D\u7F6E\u3002\u66F4\u6362\u540E\u8BF7\u5148\u5E94\u7528\u6A21\u578B\uFF0C\u518D\u53D1\u5E03\u4EFB\u52A1\uFF1B\u5E94\u7528\u65F6\u4F1A\u91CD\u65B0\u8FDE\u63A5 Codex\u3002",
+    applyModel: "\u5E94\u7528\u6A21\u578B",
     codexManaged: "Codex \xB7 \u53D7\u7BA1\u6A21\u5F0F\uFF08\u5B9E\u9A8C\u6027\uFF09",
     connectManaged: "\u8FDE\u63A5 Codex",
     disconnectManaged: "\u65AD\u5F00\u8FDE\u63A5",
@@ -1154,7 +1168,7 @@ var MESSAGES = Object.freeze({
       "install-agent": "\u5B89\u88C5 Codex \u540E\u91CD\u8BD5\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",
+      "choose-available-model": "\u9009\u62E9\u53EF\u7528\u6A21\u578B\u540E\u91CD\u65B0\u8FDE\u63A5 Codex\u3002",
       "use-inbox": "\u7EE7\u7EED\u4F7F\u7528 Agent \u6536\u4EF6\u7BB1\u964D\u7EA7\u8DEF\u5F84\u3002",
       "confirm-managed-access": "\u64A4\u9500\u65E0\u6548\u6388\u6743\u5E76\u91CD\u65B0\u786E\u8BA4\u3002",
       "review-candidate-diff": "\u68C0\u67E5\u5019\u9009 diff \u548C\u9A8C\u8BC1\u8F93\u51FA\u3002",
@@ -1376,6 +1390,11 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
   codexOption.value = "codex";
   agentSelect.append(codexOption);
   agentLabel.append(agentLabelText, agentSelect);
+  const modelLabel = createMarkedElement(document, "label");
+  const modelLabelText = createMarkedElement(document, "span");
+  const modelSelect = createMarkedElement(document, "select");
+  const modelHint = createMarkedElement(document, "p");
+  modelLabel.append(modelLabelText, modelSelect);
   const controlStatus = createMarkedElement(document, "p");
   controlStatus.className = "spotpatch-external-control-status";
   controlStatus.setAttribute("role", "status");
@@ -1398,7 +1417,14 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
   const managedResultSummary = createMarkedElement(document, "p");
   const managedResultDiff = createMarkedElement(document, "pre");
   managedResult.append(managedResultTitle, managedResultSummary, managedResultDiff);
-  controlRoot.append(agentLabel, controlStatus, controlActions, managedResult);
+  controlRoot.append(
+    agentLabel,
+    modelLabel,
+    modelHint,
+    controlStatus,
+    controlActions,
+    managedResult
+  );
   const resolveButton = createButton(document, "", "spotpatch-external-resolve");
   resolveButton.hidden = true;
   const settings = createMarkedElement(document, "details");
@@ -1455,15 +1481,19 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
     } catch {
     }
   };
+  const modelPending = () => control?.mode === "managed" && modelSelect.value !== "" && modelSelect.value !== control.requestedModel;
+  const controlPending = () => controlOperationBusy || control?.connectionState === "diagnosing" || control?.connectionState === "connecting" || control?.connectionState === "disconnecting";
   const refreshActions = () => {
     sendButton.textContent = retryable ? messages.retry : activeAdapter?.canDispatch === true ? messages.send : messages.inboxSend;
-    sendButton.disabled = !visible || !brokerReady || !contextReady || operationBusy || !retryable && dispatchBlocksSend;
+    sendButton.disabled = !visible || !brokerReady || !contextReady || operationBusy || controlPending() || modelPending() || !retryable && dispatchBlocksSend;
     sendButton.setAttribute("aria-busy", String(operationBusy));
     refreshButton.disabled = !visible || operationBusy;
     resolveButton.hidden = !unknownDelivery;
     resolveButton.disabled = !visible || operationBusy || !unknownDelivery;
   };
   const refreshControlActions = () => {
+    connectButton.textContent = modelPending() ? messages.applyModel : messages.connectManaged;
+    modelSelect.disabled = true;
     if (control === void 0) {
       connectButton.disabled = true;
       disconnectButton.disabled = true;
@@ -1472,8 +1502,9 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
       return;
     }
     const state = control.connectionState;
-    const operationPending = controlOperationBusy || state === "diagnosing" || state === "connecting" || state === "disconnecting";
-    connectButton.disabled = operationPending || state === "ready" || state === "busy";
+    const operationPending = controlPending();
+    modelSelect.disabled = operationPending || state === "busy" || !control.models?.length;
+    connectButton.disabled = operationPending || state === "ready" && !modelPending() || state === "busy";
     disconnectButton.disabled = operationPending || state === "disconnected";
     revokeButton.disabled = operationPending || control.grantState !== "valid";
     const phase = control.task?.managedPhase;
@@ -1524,6 +1555,11 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
     disclosureProvider.textContent = messages.disclosureProvider;
     disclosureNoGuarantee.textContent = messages.disclosureNoGuarantee;
     agentLabelText.textContent = messages.agentLabel;
+    modelLabelText.textContent = messages.modelLabel;
+    modelHint.textContent = messages.modelHint;
+    if (modelSelect.options.length === 1 && modelSelect.options[0]?.value === "") {
+      modelSelect.options[0].textContent = messages.modelLoading;
+    }
     codexOption.textContent = messages.codexManaged;
     connectButton.textContent = messages.connectManaged;
     disconnectButton.textContent = messages.disconnectManaged;
@@ -1555,6 +1591,25 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
   disclosure.addEventListener("keydown", handleDisclosureKeydown);
   settings.addEventListener("toggle", options.onViewChange);
   managedResult.addEventListener("toggle", options.onViewChange);
+  const handleModelChange = () => {
+    refreshControlActions();
+    refreshActions();
+  };
+  modelSelect.addEventListener("change", handleModelChange);
+  const renderModels = () => {
+    const previous = modelSelect.value;
+    const models = control?.models ?? [];
+    modelSelect.replaceChildren(
+      ...(models.length ? models : [""]).map((model) => {
+        const option = createMarkedElement(document, "option");
+        option.value = model;
+        option.textContent = model || messages.modelLoading;
+        return option;
+      })
+    );
+    modelSelect.value = models.includes(previous) ? previous : control?.requestedModel ?? models[0] ?? "";
+  };
+  renderModels();
   const unsubscribeLocale = options.subscribeLocale(applyMessages);
   applyMessages();
   status.textContent = messages.ready;
@@ -1597,6 +1652,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
     resolveButton,
     cancelManagedButton,
     connectButton,
+    readModel: () => modelSelect.value || void 0,
     disconnectButton,
     revokeButton,
     confirmDisclosure(annotation) {
@@ -1653,20 +1709,24 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
     },
     renderControlStatus(value) {
       control = value;
+      renderModels();
       controlStatus.textContent = controlStatusText(value, messages, framework);
       controlStatus.dataset.state = value.connectionState;
       disclosureNoGuarantee.textContent = value.mode === "managed" ? messages.disclosureManagedGuarantee : messages.disclosureNoGuarantee;
       refreshControlActions();
+      refreshActions();
       options.onControlChange?.(value);
       options.onViewChange();
     },
     renderControlUnavailable() {
       control = void 0;
+      renderModels();
       controlStatus.dataset.state = "unavailable";
       controlStatus.textContent = messages.controlUnavailable;
       disclosureNoGuarantee.textContent = messages.disclosureNoGuarantee;
       refreshControlActions();
       options.onControlChange?.(void 0);
+      refreshActions();
       options.onViewChange();
     },
     renderManagedResult(result) {
@@ -1694,6 +1754,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
     setControlBusy(nextBusy) {
       controlOperationBusy = nextBusy;
       refreshControlActions();
+      refreshActions();
     },
     setContextReady(ready) {
       contextReady = ready;
@@ -1711,6 +1772,7 @@ function createExternalHandoffPanel(document, framework, locale, sessionId, subs
       disclosure.removeEventListener("keydown", handleDisclosureKeydown);
       settings.removeEventListener("toggle", options.onViewChange);
       managedResult.removeEventListener("toggle", options.onViewChange);
+      modelSelect.removeEventListener("change", handleModelChange);
       unsubscribeLocale();
     }
   });