@epoch-agent/server 0.7.0 → 0.8.1

package/README.md

@@ -254,8 +254,17 @@ sessionId 就是方案 30 §9.5 那条 bug 的形状 —— 编译得过、跑
 
 **录像那一条不再脱敏一次**：脱敏在落盘那一刻就做完了（core 的 `redactLine`，
 跑在已经序列化过的一整行上）。在这一层补一道会让下一个人以为盘上那一份是干净的
-—— 而盘上那一份才是真正会被 `cat` 的那份。帧数超过 `MAX_RECORDING_FRAMES`
-（4000）时截断 + `truncated: true`，界面必须把它画出来。
+—— 而盘上那一份才是真正会被 `cat` 的那份。
+
+发出去之前**先把流式增量折回消息**（core 的 `coalesceRecording`）：盘上是一个
+`text-delta` 一帧，几千个输出 token 就是几千帧，而这些帧在运行结束之后没有独立
+含义（渲染那侧只是把它们拼成一段正文）。折完之后一帧 ≈ 一段正文 / 一次工具调用，
+`MAX_RECORDING_FRAMES`（4000）这把尺子才量得到真东西 —— **它量的是折叠之后的帧数**。
+
+超了就截断 + `truncated: true`，界面必须把它画出来。⚠️ **截掉的是开头，留的是
+尾巴**（`slice(-N)`）：一次运行里人要看的正是那句结论和 `finish` 那一帧上的账，
+而留头去尾会让正文断在半句话上 —— 屏幕上那半截自己不会说「我是半截的」
+（判据同 protocol 的 `NoticeCode: 'response-truncated'`）。
 
 ⚠️ 这一组借的是 `WebRuntimeView.schedules`（`ScheduleControlView`，
 结构镜像在 [src/schedule/view.ts](./src/schedule/view.ts)）。判定、注册进 OS、

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Lang, WireSkillImportFailure, WireSkillImportForm, WireSkillRemoveFailure, WireCapabilitiesResponse, WireSkillBodyResponse, EpochUserContent, AgentEvent, WireEnvelope, CustomCommandDef, ExpandedCommand, ModelRef, SetSelectionResult, WireCommandExpansion, WireCustomCommand, WireGoalPhase, WireGoalRefusal, WireTurnState, WireSessionFinish, ApprovalOutcome, QuestionAnswer, SessionSurfaceView, WireSessionReference, WireFileReference, ProviderType, ModelSelectionOrigin, WireModelCaveat, WireModelRejection, ContextBreakdown, PermissionLevel, WirePermissionRememberFailure, WirePluginSourceType, WirePluginRefuseReason, WirePluginEntry, WireModelSource, WireModelProbeStatus, ScheduleDefinition, ScheduleRun, ScheduleBackendKind, OperationType, ScheduleTrigger, WireScheduleIssue, ScheduleRunStatus, TrustLevel, WireSandboxReason, WireAuditOutcome, WireAuditCode, WireCachedApproval, WireCachedDecision, WireToolVerdict, WireToolGateAxis, WireSecurityResponse, WireRewindScope, WireRewindRequest, WireCheckpointSummary, WireRewindPreview, WireRewindResponse, ActiveAgentRole, WireSettingValue, WireSettingLayer, WireSettingWriteLayer, WireSettingFutile, WireSettingApply, WireSettingValueKind, WireSettingsResponse, EpochConfig, TokenUsage, WireCompressionLine, WireProviderSummary, WireToolSummary, Diagnostic, WireReplayMessage, WireFileChange, WireAuthGuard, WireWorkspaceDiffResponse, BackgroundTaskInfo, WireTasksResponse, WireBackgroundTask, WireScheduleRow } from '@epoch-agent/protocol';
+import { Lang, WireSkillImportFailure, WireSkillImportForm, WireSkillRemoveFailure, WireCapabilitiesResponse, WireSkillBodyResponse, EpochUserContent, AgentEvent, WireEnvelope, CustomCommandDef, ExpandedCommand, ModelRef, SetSelectionResult, WireCommandExpansion, WireCustomCommand, WireGoalPhase, WireGoalRefusal, WireTurnState, WireSessionFinish, ApprovalOutcome, QuestionAnswer, SessionSurfaceView, WireSessionReference, WireFileReference, ProviderType, ModelSelectionOrigin, WireModelCaveat, WireModelRejection, ContextBreakdown, PermissionLevel, WirePermissionRememberFailure, WirePluginSourceType, WirePluginVisibility, WirePluginRefuseReason, WirePluginEntry, WireModelSource, WireModelProbeStatus, ScheduleDefinition, ScheduleRun, ScheduleBackendKind, OperationType, ScheduleTrigger, WireScheduleIssue, ScheduleRunStatus, TrustLevel, WireSandboxReason, WireAuditOutcome, WireAuditCode, WireCachedApproval, WireCachedDecision, WireToolVerdict, WireToolGateAxis, WireSecurityResponse, WireRewindScope, WireRewindRequest, WireCheckpointSummary, WireRewindPreview, WireRewindResponse, ActiveAgentRole, WireSettingValue, WireSettingLayer, WireSettingWriteLayer, WireSettingFutile, WireSettingApply, WireSettingValueKind, WireSettingsResponse, EpochConfig, TokenUsage, WireCompressionLine, WireProviderSummary, WireToolSummary, Diagnostic, WireReplayMessage, WireFileChange, WireAuthGuard, WireWorkspaceDiffResponse, BackgroundTaskInfo, WireTasksResponse, WireBackgroundTask, WireScheduleRow } from '@epoch-agent/protocol';
 import { SerializableApprovalRequest, SerializableQuestionRequest, ApprovalRevokeResult, LevelChangeResult, WorkspaceFilesView } from '@epoch-agent/runtime';
 import { ServerResponse } from 'node:http';
 
@@ -2263,11 +2263,12 @@ interface RuntimeModel {
 }
 
 /**
- * 插件那一页的十条端点（方案 59 §六 E2，2026-08-21；本地源与市场管理 2026-09-04
- * 补，判据在 protocol 的 `wire-plugin.ts` 文件头第一节那次**翻案**）：
+ * 插件那一页的十二条端点（方案 59 §六 E2，2026-08-21；本地源与市场管理 2026-09-04
+ * 补，判据在 protocol 的 `wire-plugin.ts` 文件头第一节那次**翻案**；上传 2026-09-08
+ * 补，判据在那份文件头第一节之二）：
  *
  * ```
- * GET  /api/plugins                       装着的 + 市场里有什么 + 已加的市场 + pendingRestart
+ * GET  /api/plugins                       装着的 + 市场里有什么 + 已加的市场 + pendingRestart + uploadEnabled
  * POST /api/plugins/install/preview       {ref}           → 将安装什么，一个字节都不写
  * POST /api/plugins/install               {ref, token}    → 真装
  * POST /api/plugins/install/local/preview {path}          → 同上，来源是本机一条目录
@@ -2277,6 +2278,8 @@ interface RuntimeModel {
  * POST /api/plugins/uninstall             {name}          → 卸载
  * POST /api/plugins/marketplaces          {source}        → 加一个市场
  * POST /api/plugins/marketplaces/remove   {name}          → 移除一个市场
+ * POST /api/plugins/upload/preview        {path}          → 会打包哪些文件，一个字节都不发
+ * POST /api/plugins/upload                {path, token}   → 打包 + 交给宿主
  * ```
  *
  * ## ⚠️ 这一层**一条策略判断都没有**
@@ -2290,10 +2293,10 @@ interface RuntimeModel {
  * 界面上是一条画成可点、点了却被拒的行（判据同 `PluginSearchHit.installable`
  * 为什么不从结果里剔掉远程那条）。
  *
- * ## ⚠️ 那一道闸：**九条 POST 在回环之外一律 403**，这是这个文件的正题
+ * ## ⚠️ 那一道闸：**十一条 POST 在回环之外一律 403**，这是这个文件的正题
  *
  * 判据全文在 protocol 的 [wire-plugin.ts](../../protocol/src/wire-plugin.ts) 文件头
- * 第二节，这里记它对这一层的五条直接后果：
+ * 第二节，这里记它对这一层的**六**条直接后果：
  *
  * 1. **`ctx.lanExposed` 为真时 403 `plugin-write-lan-exposed`，一个字节都不写。**
  *    装一包插件会落下 `hooks.json` 和 `mcp.json`，那两样**起子进程** ——
@@ -2312,6 +2315,10 @@ interface RuntimeModel {
  *    唯一后果是那一页在 LAN 那一档下一片空白，
  *    偏偏那时用户最想知道的就是「我装了什么、生效了没有」。
  *    （对比 `GET /api/mcp/config` 为什么连读都挡：那份文件里的 `env` 是明文密钥。）
+ * 6. **上传那两条是这张表里最该挡的**（2026-09-08）：它们读这台机器上任意一条
+ *    目录、把内容**发到外面去**。放行的话，一个 LAN 上的人能指着 `~/.ssh` 说
+ *    「上传它」。⚠️ **预览那一条同样挡**，虽然它一个字节都不发 ——
+ *    它回的那份**文件清单本身就是情报**（拿它能探这台机器上有什么）。
  *
  * ## ⚠️ 这一片可以整个不存在 —— 503 `no-plugin-control`
  *
@@ -2320,6 +2327,11 @@ interface RuntimeModel {
  * JSDoc 上）。六条一律 503，判据同 `no-goal-store`：那是一句关于**这个部署**的
  * 真话，而一份「装了 0 个插件」的空列表会让用户去找一个不存在的安装按钮。
  *
+ * ⚠️ **上传那两条还有第二档「没开」，而它比 503 那一档窄**：`runtime.plugins`
+ * 在、但宿主没给 `upload` 回调 —— 那时它们回 **200 + `upload-unavailable`**，
+ * 不是 503。两档分得开是有用的：503 说「这一整页没开」，那一档说
+ * 「页开着，只是没有交出去这条路」，而后者正是 `epoch web --plugins` 的常态。
+ *
  * ⚠️ **默认的 `epoch web` 就落在这一档上**（不给 `--plugins` 就不传
  * `hostMarketplaces`）。那一格 2026-08-21 答掉了：`epoch web --plugins` 才接上
  * （传 `{ sources: [] }`），**默认关**，判据在
@@ -2378,6 +2390,26 @@ interface PluginHitView {
         source: string;
         category?: string;
         keywords?: readonly string[];
+        /** 目录里那一格「谁写的」。**摊平在投影里做**，判据在 `WirePluginHit.author` 上 */
+        author?: {
+            name: string;
+        };
+        /**
+         * 市场那一侧数的两个计数（2026-09-08）。**可选**，而缺席在网线上变 `null`
+         * 不是 `0` —— 判据在 `WirePluginHit.downloads` 上（「没人报」和「一次都没装过」
+         * 是两句不同的话）。
+         */
+        downloads?: number;
+        likes?: number;
+        /** 展示用的那几格（2026-09-08）。全部可选 → 网线上一律 `null` */
+        displayName?: string;
+        icon?: string;
+        /** **市场说的**版本。`updateAvailable` 是拿它和装着的那个比出来的 */
+        version?: string;
+        changelog?: string;
+        size?: number;
+        homepage?: string;
+        visibility?: WirePluginVisibility;
     };
     sourceType?: WirePluginSourceType;
     installable: boolean;
@@ -2460,7 +2492,49 @@ type MarketOutcomeView = {
     marketplace?: MarketplaceView;
 } | RefusalView;
 /**
- * `PluginControl`（runtime）在服务端眼里的样子 —— **只有那十一个动词加一格布尔**。
+ * `PackPlan`（core，经 runtime 原样透出）的镜像 —— 「会打包什么」那一屏的内容。
+ *
+ * ⚠️ 借的是**整份 `files`** 而不是一个长度：判据在 `WirePluginUploadPlan.files`
+ * 上（这条路上最常见的事故是「目录里有一份 `.env`」，一个计数答不出那件事）。
+ */
+interface PackPlanView {
+    manifest: {
+        name: string;
+        version: string;
+        description?: string;
+        author?: {
+            name: string;
+        };
+    };
+    files: readonly {
+        path: string;
+        bytes: number;
+    }[];
+    totalBytes: number;
+    suspicious: readonly string[];
+    skippedLinks: readonly string[];
+}
+type UploadPreviewOutcomeView = {
+    ok: true;
+    plan: PackPlanView;
+    token: string;
+} | RefusalView;
+/**
+ * 上传的结局。
+ *
+ * ⚠️ 成功那一档借的是 `detail`（**宿主原话**）而不是我们编的一句 —— 判据在
+ * `WirePluginUploadResponse.detail` 上：上传之后发生什么（直接上架 / 排队审核）
+ * 是宿主那一侧的流程，这一层编不出来。
+ */
+type UploadOutcomeView = {
+    ok: true;
+    detail: string;
+    name: string;
+    version: string;
+    bytes: number;
+} | RefusalView;
+/**
+ * `PluginControl`（runtime）在服务端眼里的样子 —— **只有那十四个动词加两格布尔**。
  *
  * 镜像里只有它们，于是这个包**写不出** core 的 `setPluginEnabled`
  * （停用一个插件会静默拿掉别人正依赖的一批命令，正当性和「装 / 卸」不是一回事）；
@@ -2486,7 +2560,29 @@ interface PluginControlView {
     marketplaces(): readonly MarketplaceView[];
     addMarketplace(source: string, lang?: Lang): Promise<MarketOutcomeView>;
     removeMarketplace(name: string, lang?: Lang): Promise<MarketOutcomeView>;
+    /**
+     * 「会打包什么」。⚠️ **同步的**（runtime 那一层只走一遍目录，不起子进程）——
+     * 镜像上写成 `Promise` 也满足，但那会让这一层顺手 `await` 一个不用等的东西
+     */
+    previewUpload(path: string, lang?: Lang): UploadPreviewOutcomeView;
+    upload(path: string, token: string, 
+    /** 用户在那一屏上填的。**宿主没声明要问的格子由下一层丢掉**，这一层不过滤 */
+    form: {
+        visibility?: WirePluginVisibility;
+        changelog?: string;
+    }, lang?: Lang): Promise<UploadOutcomeView>;
     readonly pendingRestart: boolean;
+    /** 上传表单多问哪几格。**两个恒有的布尔**，runtime 那一层算好的 */
+    readonly uploadOptions: {
+        visibility: boolean;
+        changelog: boolean;
+    };
+    /**
+     * 宿主给了上传出口吗。**runtime 算好的结论**，这一层原样投影上网线 ——
+     * 在这儿重判一次（比如看那个回调在不在）就是给同一个问题第二个答案，
+     * 判据同文件头那句「这一层一条策略判断都没有」。
+     */
+    readonly uploadEnabled: boolean;
 }
 /**
  * 装着的一条 → 网线上那一行。
@@ -2666,8 +2762,26 @@ interface ScheduleCreateView {
     endDate?: string;
     enabled?: boolean;
 }
-/** 改一条任务 —— core 的 `UpdateScheduleInput`。没给的字段一个都不动 */
-type ScheduleUpdateView = Partial<ScheduleCreateView>;
+/**
+ * 改一条任务 —— core 的 `UpdateScheduleInput`。没给的字段一个都不动。
+ *
+ * ⚠️ **四格收 `null` = 清空这一格**，和网线上那份（`WireScheduleUpdateRequest`）
+ * 逐字段对得上。别写成 `Partial<ScheduleCreateView>`（2026-09-07 之前就是那样）：
+ * 那一版比真身**窄**，而窄的方向 TS 不报 —— 入参是逆变的，一个「什么都收得下」
+ * 的真身赋给一个「只收 string」的镜像永远合法。于是这一层压根表达不出「清空」，
+ * `schedule/body.ts` 只好把 `null` 翻成空串往下递，而 core 从来不认空串是清空。
+ * 那次的表现是：表单上两格生效区间都没填，保存却报两行「生效区间不对: 」。
+ *
+ * 也就是说**这一格的正确性没有编译器守着**，只有这段注释和用例。判据全文在
+ * core 的 `UpdateScheduleInput` 上。
+ */
+type ScheduleUpdateView = Partial<Omit<ScheduleCreateView, 'workDir' | 'model' | 'startDate' | 'endDate'>> & {
+    /** `null` = 不绑工作区了 → 落回 `~/.epoch/automation/<id>/`（runtime 那一层解析） */
+    workDir?: string | null;
+    model?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+};
 /** 存下来了没有 —— core / runtime 的 `ScheduleSaveResult` */
 interface ScheduleSaveView {
     /** 校验不过时 `undefined`，且库里一个字都没写 */
@@ -4884,12 +4998,17 @@ declare function collectTasks(sessionId: string, registry: TaskRegistryView): Wi
  */
 
 /**
- * 一份录像最多回多少帧。
+ * 一份录像最多回多少帧 —— **折叠之后的帧**。
+ *
+ * 一次跑飞的运行能写出几万帧，整份推给浏览器会让那个标签页卡死。超了就截断 +
+ * `truncated: true` —— **必须说出来**，判据同 `WireSkillBodyResponse.truncated`：
+ * 一份看起来完整、其实少了后半截的回放，比一句「太长了没给全」坏得多。
  *
- * 一次跑飞的运行能写出几万帧（每个 `text-delta` 一帧），整份推给浏览器会让
- * 那个标签页卡死。超了就截断 + `truncated: true` —— **必须说出来**，
- * 判据同 `WireSkillBodyResponse.truncated`：一份看起来完整、其实少了后半截的
- * 回放，比一句「太长了没给全」坏得多。
+ * ⚠️ **这把尺子量的是折叠之后的帧数**（2026-09-07 改准）。原来量的是盘上的原始
+ * 帧数，而盘上「每个 `text-delta` 一帧」—— 于是几千个输出 token 就是几千帧，
+ * **一次正常的多轮任务**（实测：27 轮、0.016 美元）就撞上了这道闸门。
+ * 折叠在 core 的 `coalesceRecording` 里，折完一帧 ≈ 一段正文 / 一次工具调用，
+ * 4000 才重新是「一次真正巨大的运行」的意思。
  */
 declare const MAX_RECORDING_FRAMES = 4000;
 /**

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createServer } from 'http';
-import { t, ApprovalRelay, QuestionRelay, serializeStream, withRoleScope, withModelScope, withToolScope, nextRunAt, skillIndexDescription, SANDBOX_EXCLUDES, SANDBOX_COVERS, isSystemOpenable, backgroundTaskOutput, listBackgroundTasks, providerLabel, MAX_REASON_CHARS, MAX_OBJECTIVE_CHARS, MAX_GOAL_MAX_ROUNDS, DEFAULT_GOAL_MAX_ROUNDS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_DEFAULTS, readRecording } from '@epoch-agent/runtime';
+import { t, ApprovalRelay, QuestionRelay, serializeStream, withRoleScope, withModelScope, withToolScope, nextRunAt, skillIndexDescription, SANDBOX_EXCLUDES, SANDBOX_COVERS, isSystemOpenable, backgroundTaskOutput, listBackgroundTasks, providerLabel, MAX_REASON_CHARS, MAX_OBJECTIVE_CHARS, MAX_GOAL_MAX_ROUNDS, DEFAULT_GOAL_MAX_ROUNDS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_DEFAULTS, coalesceRecording, readRecording } from '@epoch-agent/runtime';
 import { timingSafeEqual, randomBytes } from 'crypto';
 import { PLAN_OUTCOMES, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, extractAllMentions, MAX_ATTACH_FILES, utf8ByteLength, MAX_SESSION_REFS, attachSessionSurface, isWireRewindScope, WIRE_REWIND_SCOPES, MAX_ATTACH_TOTAL_BYTES, MAX_ATTACH_BYTES, WIRE_LANG_PARAM, isLang, isQuestionAnswerMap, isProviderType, apiKeyEnvVar, WIRE_FILE_STAT_MAX, WIRE_SETTING_WRITE_LAYERS, isWirePlanAction, WIRE_PLAN_ACTIONS, isPermissionLevel, PERMISSION_LEVELS, collectPendingApprovals, unfixedRules, isWireSettingWriteLayer, parseModelRef, WIRE_GOAL_ACTIONS, OPERATION_TYPES, isOperationType } from '@epoch-agent/protocol';
 import { resolve, join, relative, isAbsolute, sep, dirname, basename, extname } from 'path';
@@ -2448,7 +2448,8 @@ function toWirePluginEntry(entry) {
     counts: entry.counts ? toWireCounts(entry.counts) : null
   };
 }
-function toWirePluginHit(hit, installedNames) {
+function toWirePluginHit(hit, installed) {
+  const mine = installed.get(hit.entry.name);
   return {
     marketplace: hit.marketplace,
     ref: hit.ref,
@@ -2458,7 +2459,18 @@ function toWirePluginHit(hit, installedNames) {
     keywords: [...hit.entry.keywords ?? []],
     sourceType: hit.sourceType ?? null,
     installable: hit.installable,
-    installed: installedNames.has(hit.entry.name)
+    installed: mine !== void 0,
+    author: hit.entry.author?.name ?? null,
+    downloads: hit.entry.downloads ?? null,
+    likes: hit.entry.likes ?? null,
+    displayName: hit.entry.displayName ?? null,
+    icon: hit.entry.icon ?? null,
+    version: hit.entry.version ?? null,
+    changelog: hit.entry.changelog ?? null,
+    size: hit.entry.size ?? null,
+    homepage: hit.entry.homepage ?? null,
+    visibility: hit.entry.visibility ?? null,
+    updateAvailable: mine !== void 0 && !mine.linked && hit.entry.version !== void 0 && hit.entry.version !== mine.version
   };
 }
 function toWireMarketplace(market) {
@@ -2518,12 +2530,16 @@ function listPlugins(ctx, res, lang) {
   const control = controlOf(ctx, res, lang);
   if (!control) return;
   const installed = control.list();
-  const installedNames = new Set(installed.map((p) => p.name));
+  const installedMap = new Map(
+    installed.map((p) => [p.name, { version: p.version, linked: p.linked }])
+  );
   sendJson(res, 200, {
     installed: installed.map(toWirePluginEntry),
-    hits: control.search().map((hit) => toWirePluginHit(hit, installedNames)),
+    hits: control.search().map((hit) => toWirePluginHit(hit, installedMap)),
     marketplaces: control.marketplaces().map(toWireMarketplace),
-    pendingRestart: control.pendingRestart
+    pendingRestart: control.pendingRestart,
+    uploadEnabled: control.uploadEnabled,
+    uploadOptions: control.uploadOptions
   });
 }
 function sendPreview(res, outcome) {
@@ -2658,6 +2674,71 @@ async function removePluginMarketplace(ctx, req, res, lang) {
   if (!body.ok) return sendError(res, body.status, "bad-body", body.message);
   sendMarket(res, await control.removeMarketplace(fieldOf(asRecord(body.value), "name"), lang));
 }
+function previewPluginUpload(ctx, req, res, lang) {
+  return withUploadBody(ctx, req, res, lang, (control, payload) => {
+    sendUploadPreview(res, control.previewUpload(fieldOf(payload, "path"), lang));
+  });
+}
+function uploadPlugin(ctx, req, res, lang) {
+  return withUploadBody(ctx, req, res, lang, async (control, payload) => {
+    sendUpload(
+      res,
+      await control.upload(
+        fieldOf(payload, "path"),
+        fieldOf(payload, "token"),
+        {
+          ...fieldOf(payload, "visibility") === "private" ? { visibility: "private" } : fieldOf(payload, "visibility") === "public" ? { visibility: "public" } : {},
+          ...fieldOf(payload, "changelog") ? { changelog: fieldOf(payload, "changelog") } : {}
+        },
+        lang
+      )
+    );
+  });
+}
+async function withUploadBody(ctx, req, res, lang, run) {
+  if (refusedByLan(ctx, res, lang)) return;
+  const control = controlOf(ctx, res, lang);
+  if (!control) return;
+  const body = await readJsonBody(req);
+  if (!body.ok) return sendError(res, body.status, "bad-body", body.message);
+  await run(control, asRecord(body.value));
+}
+function sendUploadPreview(res, outcome) {
+  if (!outcome.ok) {
+    return sendJson(res, 200, {
+      ok: false,
+      plan: null,
+      token: null,
+      reason: outcome.reason,
+      detail: outcome.detail
+    });
+  }
+  const { manifest, files, totalBytes, suspicious, skippedLinks } = outcome.plan;
+  sendJson(res, 200, {
+    ok: true,
+    plan: {
+      name: manifest.name,
+      version: manifest.version,
+      description: manifest.description ?? "",
+      author: manifest.author?.name ?? null,
+      files: files.map((f) => ({ path: f.path, bytes: f.bytes })),
+      totalBytes,
+      suspicious: [...suspicious],
+      skippedLinks: [...skippedLinks]
+    },
+    token: outcome.token,
+    reason: null,
+    detail: null
+  });
+}
+function sendUpload(res, outcome) {
+  sendJson(res, 200, {
+    ok: outcome.ok,
+    detail: outcome.detail,
+    uploaded: outcome.ok ? { name: outcome.name, version: outcome.version, bytes: outcome.bytes } : null,
+    reason: outcome.ok ? null : outcome.reason
+  });
+}
 function toWireProvider(option, lang) {
   return {
     type: option.type,
@@ -2855,21 +2936,28 @@ function numberList(value) {
   }
   return out;
 }
-function optionals(raw, lang) {
+var CLEARABLE = ["model", "workDir", "startDate", "endDate"];
+function optionals(raw, allowClear, lang) {
   const out = {};
-  for (const key of ["name", "prompt", "model", "workDir", "startDate", "endDate"]) {
+  const bad = (field) => ({
+    ok: false,
+    message: t("web.schedule_bad_field", { field }, lang)
+  });
+  for (const key of ["name", "prompt"]) {
+    const value = raw[key];
+    if (value === void 0) continue;
+    if (typeof value !== "string") return bad(key);
+    out[key] = value;
+  }
+  for (const key of CLEARABLE) {
     const value = raw[key];
     if (value === void 0) continue;
     if (value === null) {
-      if (key === "name" || key === "prompt") {
-        return { ok: false, message: t("web.schedule_bad_field", { field: key }, lang) };
-      }
-      out[key] = "";
+      if (!allowClear) return bad(key);
+      out[key] = null;
       continue;
     }
-    if (typeof value !== "string") {
-      return { ok: false, message: t("web.schedule_bad_field", { field: key }, lang) };
-    }
+    if (typeof value !== "string") return bad(key);
     out[key] = value;
   }
   for (const key of ["maxTurns", "maxBudgetUsd", "timeoutMs"]) {
@@ -2939,7 +3027,7 @@ function parseCreate2(body, lang) {
     return { ok: false, message: t("web.schedule_bad_trigger", void 0, lang) };
   if (budget === null)
     return { ok: false, message: t("web.schedule_budget_required", void 0, lang) };
-  const rest = optionals(raw, lang);
+  const rest = optionals(raw, false, lang);
   if (!rest.ok) return rest;
   return {
     ok: true,
@@ -2947,7 +3035,7 @@ function parseCreate2(body, lang) {
   };
 }
 function parseUpdate2(body, lang) {
-  return optionals(asRecord(body), lang);
+  return optionals(asRecord(body), true, lang);
 }
 function parseFix(body, lang) {
   const runId = asRecord(body)["runId"];
@@ -3105,14 +3193,14 @@ function toRecording(run) {
   if (run.logPath === void 0) {
     return { runId: run.id, frames: [], missing: true, truncated: false };
   }
-  const frames = readRecording(run.logPath);
+  const frames = coalesceRecording(readRecording(run.logPath));
   if (frames.length === 0) {
     return { runId: run.id, frames: [], missing: true, truncated: false };
   }
   const truncated = frames.length > MAX_RECORDING_FRAMES;
   return {
     runId: run.id,
-    frames: truncated ? frames.slice(0, MAX_RECORDING_FRAMES) : frames,
+    frames: truncated ? frames.slice(-MAX_RECORDING_FRAMES) : frames,
     missing: false,
     truncated
   };
@@ -4363,6 +4451,12 @@ async function handleApi(opts, req, res, method, segments, lang) {
   if (resource === "plugins" && first === "marketplaces" && second === void 0 && method === "POST") {
     return addPluginMarketplace(ctx, req, res, lang);
   }
+  if (resource === "plugins" && first === "upload" && second === "preview" && method === "POST") {
+    return previewPluginUpload(ctx, req, res, lang);
+  }
+  if (resource === "plugins" && first === "upload" && second === void 0 && method === "POST") {
+    return uploadPlugin(ctx, req, res, lang);
+  }
   if (resource === "providers" && first === void 0 && isRead(method)) {
     return listProviders(ctx, res, lang);
   }