@spotpatch/runtime 1.2.1 → 1.4.0

package/README.md

@@ -1,9 +1,27 @@
-# @spotpatch/runtime
+<p align="center">
+  <a href="https://github.com/huanglvjing/spotpatch"><img src="https://raw.githubusercontent.com/huanglvjing/spotpatch/main/docs/assets/spotpatch-logo.svg" alt="SpotPatch" width="560" /></a>
+</p>
 
-The browser-only SpotPatch runtime containing the element picker, bounded DOM
-and CSS collectors, localized Shadow DOM workbench, and prompt composer.
+# `@spotpatch/runtime`
 
-Applications should install and configure
-[`@spotpatch/vite`](https://www.npmjs.com/package/@spotpatch/vite). The Vite
-plugin injects this runtime only during development and verifies that it is
-absent from production output.
+## English
+
+The browser Runtime used by SpotPatch framework adapters. It contains the element picker, bounded DOM and CSS collectors, source-context client, localized Shadow DOM workbench, multi-target state, prompt composer, and optional Agent review UI.
+
+Applications should install and configure [`@spotpatch/vite`](https://www.npmjs.com/package/@spotpatch/vite) rather than bootstrap this package directly. The adapter supplies authenticated development configuration and guarantees that the Runtime is absent from production output.
+
+This package never owns provider credentials or unrestricted filesystem access.
+
+## 简体中文
+
+这是 SpotPatch 框架适配器使用的浏览器 Runtime，包含元素选择器、有界 DOM/CSS 采集器、源码上下文客户端、本地化 Shadow DOM 工作台、多目标状态、Prompt 生成器和可选 Agent 审阅界面。
+
+业务应用应安装并配置 [`@spotpatch/vite`](https://www.npmjs.com/package/@spotpatch/vite)，而不是直接启动本包。框架适配器负责提供经过认证的开发期配置，并保证生产产物不包含 Runtime。
+
+本包不持有 Provider 凭据，也不具备不受限制的文件系统访问能力。
+
+## Links / 链接
+
+- [Repository / 仓库](https://github.com/huanglvjing/spotpatch)
+- [UI and diagnostics / UI 与诊断](https://github.com/huanglvjing/spotpatch/blob/main/docs/%E6%8A%80%E6%9C%AF%E6%96%B9%E6%A1%88/10-UI%E4%B8%8E%E8%AF%8A%E6%96%AD.md)
+- [MIT License / 许可证](https://github.com/huanglvjing/spotpatch/blob/main/LICENSE)

package/dist/index.cjs

@@ -227,7 +227,7 @@ function isAgentEventBase(value) {
     "timestamp",
     "type",
     "data"
-  ]) && value.schemaVersion === 1 && isPositiveInteger(value.sequence) && isJobId(value.jobId) && typeof value.status === "string" && JOB_STATUS_VALUES.has(value.status) && isIsoTimestamp(value.timestamp) && typeof value.type === "string" && isRecord(value.data);
+  ]) && value.schemaVersion === 2 && isPositiveInteger(value.sequence) && isJobId(value.jobId) && typeof value.status === "string" && JOB_STATUS_VALUES.has(value.status) && isIsoTimestamp(value.timestamp) && typeof value.type === "string" && isRecord(value.data);
 }
 function isAgentJobEvent(value) {
   if (!isAgentEventBase(value)) {
@@ -241,12 +241,13 @@ function isAgentJobEvent(value) {
       return hasOnlyKeys(data, ["message"]) && isBoundedString(data.message, 1024);
     case "tool":
       return hasOnlyKeys(data, [
+        "turn",
         "toolCallId",
         "toolName",
         "state",
         "relativePath",
         "checkLabel"
-      ]) && isBoundedString(data.toolCallId, 256) && isBoundedString(data.toolName, 100) && (data.state === "started" || data.state === "succeeded" || data.state === "failed") && isOptionalBoundedString(data.relativePath, 1024) && isOptionalBoundedString(data.checkLabel, 100);
+      ]) && isPositiveInteger(data.turn) && isBoundedString(data.toolCallId, 256) && isBoundedString(data.toolName, 100) && (data.state === "started" || data.state === "succeeded" || data.state === "failed") && isOptionalBoundedString(data.relativePath, 1024) && isOptionalBoundedString(data.checkLabel, 100);
     case "check":
       return hasOnlyKeys(data, ["result"]) && isAgentCheckResult(data.result);
     case "result-ready":
@@ -2347,13 +2348,15 @@ var ERROR_MESSAGES_EN = Object.freeze({
   [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_TOO_LARGE]: "Reduce untracked files below the safe count and size limits.",
   [import_shared6.ERROR_CODES.WORKTREE_UNTRACKED_UNSUPPORTED]: "An untracked path is missing, linked, or not a regular file.",
   [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED]: "Local changes cannot be isolated safely.",
-  [import_shared6.ERROR_CODES.TOOL_DENIED]: "A model tool request violated the local safety policy.",
-  [import_shared6.ERROR_CODES.TOOL_INPUT_INVALID]: "The model sent invalid tool arguments or reused a tool ID.",
-  [import_shared6.ERROR_CODES.TOOL_PATH_DENIED]: "The model requested a protected, linked, non-text, or external path.",
-  [import_shared6.ERROR_CODES.PATCH_REJECTED]: "The proposed patch did not pass local policy.",
-  [import_shared6.ERROR_CODES.VALIDATION_FAILED]: "Required project checks failed. The change cannot be applied.",
-  [import_shared6.ERROR_CODES.APPLY_CONFLICT]: "Project files changed after the Agent baseline; no overwrite was performed.",
-  [import_shared6.ERROR_CODES.INTERNAL_ERROR]: "The Agent job failed without exposing private details."
+  [import_shared6.ERROR_CODES.TOOL_DENIED]: "A tool request violated local safety policy.",
+  [import_shared6.ERROR_CODES.TOOL_INPUT_INVALID]: "Invalid tool request.",
+  [import_shared6.ERROR_CODES.TOOL_ARGUMENTS_INVALID]: "Tool arguments are invalid.",
+  [import_shared6.ERROR_CODES.TOOL_CALL_ID_CONFLICT]: "Tool ID conflicts in this turn.",
+  [import_shared6.ERROR_CODES.TOOL_PATH_DENIED]: "The model requested a protected or external path.",
+  [import_shared6.ERROR_CODES.PATCH_REJECTED]: "The patch violated local policy.",
+  [import_shared6.ERROR_CODES.VALIDATION_FAILED]: "Required checks failed; changes cannot be applied.",
+  [import_shared6.ERROR_CODES.APPLY_CONFLICT]: "Agent-touched files changed; nothing was overwritten.",
+  [import_shared6.ERROR_CODES.INTERNAL_ERROR]: "The Agent failed without exposing private details."
 });
 var ERROR_MESSAGES_ZH = Object.freeze({
   [import_shared6.ERROR_CODES.INVALID_REQUEST]: "Agent \u8BF7\u6C42\u65E0\u6548\uFF0C\u5DF2\u88AB\u62D2\u7EDD\u3002",
@@ -2380,13 +2383,15 @@ var ERROR_MESSAGES_ZH = Object.freeze({
   [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_TOO_LARGE]: "\u672A\u8DDF\u8E2A\u6587\u4EF6\u8D85\u8FC7\u5B89\u5168\u6570\u91CF\u6216\u4F53\u79EF\u4E0A\u9650\uFF0C\u8BF7\u5148\u7CBE\u7B80\u3002",
   [import_shared6.ERROR_CODES.WORKTREE_UNTRACKED_UNSUPPORTED]: "\u672A\u8DDF\u8E2A\u9879\u5DF2\u4E22\u5931\u3001\u662F\u7B26\u53F7\u94FE\u63A5\u6216\u4E0D\u662F\u666E\u901A\u6587\u4EF6\u3002",
   [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED]: "\u5F53\u524D\u672C\u5730\u4FEE\u6539\u65E0\u6CD5\u5B89\u5168\u9694\u79BB\u3002",
-  [import_shared6.ERROR_CODES.TOOL_DENIED]: "\u6A21\u578B\u5DE5\u5177\u8BF7\u6C42\u8FDD\u53CD\u672C\u5730\u5B89\u5168\u7B56\u7565\u3002",
-  [import_shared6.ERROR_CODES.TOOL_INPUT_INVALID]: "\u6A21\u578B\u53D1\u9001\u4E86\u65E0\u6548\u5DE5\u5177\u53C2\u6570\uFF0C\u6216\u590D\u7528\u4E86\u5DE5\u5177\u8C03\u7528 ID\u3002",
-  [import_shared6.ERROR_CODES.TOOL_PATH_DENIED]: "\u6A21\u578B\u8BF7\u6C42\u4E86\u53D7\u4FDD\u62A4\u3001\u975E\u6587\u672C\u3001\u7B26\u53F7\u94FE\u63A5\u6216\u9879\u76EE\u5916\u8DEF\u5F84\u3002",
-  [import_shared6.ERROR_CODES.PATCH_REJECTED]: "\u5EFA\u8BAE\u8865\u4E01\u672A\u901A\u8FC7\u672C\u5730\u7B56\u7565\u68C0\u67E5\u3002",
-  [import_shared6.ERROR_CODES.VALIDATION_FAILED]: "\u9879\u76EE\u5FC5\u9700\u68C0\u67E5\u5931\u8D25\uFF0C\u4E0D\u80FD\u5E94\u7528\u672C\u6B21\u53D8\u66F4\u3002",
-  [import_shared6.ERROR_CODES.APPLY_CONFLICT]: "Agent \u5EFA\u7ACB\u57FA\u7EBF\u540E\u9879\u76EE\u6587\u4EF6\u5DF2\u53D8\u5316\uFF0C\u672A\u6267\u884C\u8986\u76D6\u3002",
-  [import_shared6.ERROR_CODES.INTERNAL_ERROR]: "Agent \u4EFB\u52A1\u5931\u8D25\uFF0C\u79C1\u6709\u7EC6\u8282\u672A\u66B4\u9732\u5230\u6D4F\u89C8\u5668\u3002"
+  [import_shared6.ERROR_CODES.TOOL_DENIED]: "\u5DE5\u5177\u8BF7\u6C42\u8FDD\u53CD\u672C\u5730\u5B89\u5168\u7B56\u7565\u3002",
+  [import_shared6.ERROR_CODES.TOOL_INPUT_INVALID]: "\u5DE5\u5177\u8BF7\u6C42\u65E0\u6548\u3002",
+  [import_shared6.ERROR_CODES.TOOL_ARGUMENTS_INVALID]: "\u5DE5\u5177\u53C2\u6570\u65E0\u6548\u3002",
+  [import_shared6.ERROR_CODES.TOOL_CALL_ID_CONFLICT]: "\u672C\u8F6E\u5DE5\u5177 ID \u51B2\u7A81\u3002",
+  [import_shared6.ERROR_CODES.TOOL_PATH_DENIED]: "\u6A21\u578B\u8BF7\u6C42\u4E86\u53D7\u4FDD\u62A4\u6216\u9879\u76EE\u5916\u8DEF\u5F84\u3002",
+  [import_shared6.ERROR_CODES.PATCH_REJECTED]: "\u8865\u4E01\u8FDD\u53CD\u672C\u5730\u7B56\u7565\u3002",
+  [import_shared6.ERROR_CODES.VALIDATION_FAILED]: "\u5FC5\u9700\u68C0\u67E5\u5931\u8D25\uFF0C\u65E0\u6CD5\u5E94\u7528\u53D8\u66F4\u3002",
+  [import_shared6.ERROR_CODES.APPLY_CONFLICT]: "Agent \u89E6\u53CA\u6587\u4EF6\u5DF2\u53D8\u5316\uFF0C\u672A\u8986\u76D6\u3002",
+  [import_shared6.ERROR_CODES.INTERNAL_ERROR]: "Agent \u5931\u8D25\uFF0C\u672A\u66B4\u9732\u79C1\u6709\u7EC6\u8282\u3002"
 });
 var SUMMARY_MESSAGES_EN = Object.freeze({
   adapter: "React adapter",
@@ -4115,7 +4120,7 @@ function sourceLocation2(resolution, context, messages) {
 function createSelectionSummary(input, messages) {
   const lines = [
     `SpotPatch: ${input.spotPatchVersion}`,
-    `Vite: ${input.viteVersion}`,
+    `${input.framework === "next" ? "Next.js" : "Vite"}: ${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}`
@@ -4160,7 +4165,7 @@ function capabilityKey(providerProfileId, modelProfileId) {
 function activityFromEvent(event) {
   if (event.type === "tool") {
     return Object.freeze({
-      key: `tool:${event.data.toolCallId}`,
+      key: `tool:${String(event.data.turn)}:${event.data.toolCallId}`,
       label: `${event.data.toolName} \xB7 ${event.data.state}`,
       state: event.data.state === "started" ? "active" : event.data.state === "succeeded" ? "success" : "failure"
     });
@@ -4650,8 +4655,9 @@ function createController(config, dependencies = {}) {
           ...target.styles === void 0 ? {} : { styles: target.styles },
           apiStatus: target.apiStatus,
           collectionStatus: target.collectionStatus,
-          spotPatchVersion: config.spotPatchVersion,
-          viteVersion: config.viteVersion
+          framework: config.framework,
+          frameworkVersion: config.frameworkVersion,
+          spotPatchVersion: config.spotPatchVersion
         },
         messages
       );