minimal-agent 0.11.0 → 0.13.0

package/src/web/protocol.ts

@@ -19,7 +19,7 @@
 
 import type { AskAnswer, AskOption, AskQuestionSpec, AskSource } from '../askBridge.js';
 import type { PluginEvent } from '../plugins/pluginApi.js';
-import type { AgentResultMetadata, ConversationFilePurpose, FileActivityMetadata, LoopEvent, Message, MessageAttachmentRef, MessageBrowserReference, ProgressStage, SubagentProgress, ToolCall, ToolProgressDetail, ToolResultMetadata } from '../types.js';
+import type { AgentResultMetadata, ConversationFilePurpose, DeliverableManifest, FileActivityMetadata, LoopEvent, Message, MessageAttachmentRef, MessageBrowserReference, ProgressStage, SubagentProgress, ToolCall, ToolProgressDetail, ToolResultMetadata } from '../types.js';
 import type { ConversationSearchResult, MemoryCategory, MemoryDiagnostic, MemoryEditablePatch, MemoryRecord, MemorySettings, MemoryUpdate, PersonaDocument } from '../memory/memoryService.js';
 import type { HumanInterventionReason } from '../humanIntervention.js';
 
@@ -1067,7 +1067,7 @@ export interface GroupMessageAttachment {
   size: number;
 }
 
-export type ConversationFileKind = 'workspace-file' | 'group-attachment' | 'agent-file';
+export type ConversationFileKind = 'workspace-file' | 'user-attachment' | 'group-attachment' | 'agent-file';
 export type ConversationFileActivity = 'referenced' | 'read' | 'created' | 'modified' | 'generated' | 'deleted';
 
 /** Safe metadata an Agent Node may publish to a group. Absolute paths and file bytes are forbidden. */
@@ -1105,6 +1105,65 @@ export interface ConversationFileRef {
   sha256?: string;
   modifiedAt?: number;
   contentChanged?: boolean;
+  originalAvailable?: boolean;
+  archivedAvailable?: boolean;
+  previewSource?: 'original' | 'archive' | 'upload';
+}
+
+/** A durable, turn-scoped formal delivery. File refs are resolved at read time. */
+export interface ConversationDelivery {
+  id: string;
+  turnId: string;
+  toolCallId?: string;
+  createdAt: number;
+  manifest: DeliverableManifest;
+  resolvedFiles: ConversationFileRef[];
+}
+
+/** Durable user-supplied and formally delivered artifacts for one user turn. */
+export interface ConversationArtifactGroup {
+  turnId: string;
+  createdAt: number;
+  compacted: boolean;
+  userAttachments: MessageAttachmentRef[];
+  deliveries: ConversationDelivery[];
+}
+
+export type ConversationAssetCategory = 'document' | 'code' | 'image' | 'link' | 'other';
+export type ConversationAssetOrigin = 'user-upload' | 'user-reference' | 'ai-delivery';
+export type ConversationAssetKind = 'workspace-file' | 'user-attachment' | 'web-link';
+
+/** A durable, session-scoped item explicitly supplied by the user or formally delivered by the Agent. */
+export interface ConversationAsset {
+  id: string;
+  conversationKey: string;
+  kind: ConversationAssetKind;
+  category: ConversationAssetCategory;
+  name: string;
+  origins: ConversationAssetOrigin[];
+  firstTurnId: string;
+  lastTurnId: string;
+  firstSeenAt: number;
+  lastSeenAt: number;
+  pinned: boolean;
+  available: boolean;
+  previewable: boolean;
+  relativePath?: string;
+  url?: string;
+  domain?: string;
+  mime?: string;
+  size?: number;
+  previewUrl?: string;
+  verification?: import('../types.js').FileVerification;
+  sha256?: string;
+  modifiedAt?: number;
+  contentChanged?: boolean;
+  /** The original workspace file still exists at its submitted path. */
+  originalAvailable?: boolean;
+  /** An immutable, content-addressed copy of the submitted file is available. */
+  archivedAvailable?: boolean;
+  /** Which bytes are opened by the default preview action. */
+  previewSource?: 'original' | 'archive' | 'upload';
 }
 
 export interface GroupChatMessage {
@@ -1244,8 +1303,13 @@ export type ClientFrame =
   | { t: 'plain/rename'; sessionId: string; title: string }
   | { t: 'plain/delete'; sessionId: string }
   | { t: 'resource/files/list'; dir: string; sessionId: string }
+  | { t: 'resource/assets/list'; requestId: string; target: ConversationTarget & { sessionId: string } }
+  | { t: 'resource/assets/pin'; requestId: string; target: ConversationTarget & { sessionId: string }; assetId: string; pinned: boolean }
+  | { t: 'resource/assets/open'; requestId: string; target: ConversationTarget & { sessionId: string }; assetId: string; source?: 'default' | 'original' | 'archive' }
+  | { t: 'resource/assets/reveal'; requestId: string; target: ConversationTarget & { sessionId: string }; assetId: string; source?: 'original' | 'archive' }
+  | { t: 'resource/files/open'; requestId: string; target: ConversationTarget & { sessionId: string }; relativePath: string }
   | { t: 'resource/files/pin'; dir: string; sessionId: string; relativePath: string; pinned: boolean }
-  | { t: 'resource/files/reveal'; dir: string; relativePath: string }
+  | { t: 'resource/files/reveal'; requestId?: string; dir?: string; target?: ConversationTarget & { sessionId: string }; relativePath: string }
   | { t: 'resource/memories/list'; workspaceId?: string; query?: string }
   | { t: 'resource/memories/settings/update'; autoRemember: boolean; workspaceId?: string }
   | { t: 'resource/memories/update'; id: string; scope: 'personal' | 'workspace'; expectedVersion: string; patch: MemoryUpdate; workspaceId?: string }
@@ -1519,10 +1583,21 @@ export type ServerFrame =
       conversationKey: string;
       historyRevision: string;
       messages: Message[];
+      deliveries?: ConversationDelivery[];
+      assets?: ConversationAsset[];
+      artifactGroups?: ConversationArtifactGroup[];
       runSnapshot?: ConversationRunSnapshot;
       contextUsage?: Extract<LoopEvent, { type: 'context_usage' }>;
     }
+  | { t: 'conversation/delivery/changed'; conversationKey: string; delivery: ConversationDelivery }
+  | { t: 'conversation/assets/changed'; conversationKey: string; assets: ConversationAsset[] }
   | { t: 'resource/files/list'; dir: string; sessionId: string; files: ConversationFileRef[] }
+  | { t: 'resource/assets/list'; requestId: string; conversationKey: string; assets?: ConversationAsset[]; error?: string }
+  | { t: 'resource/assets/pinned'; requestId: string; ok: boolean; error?: string }
+  | { t: 'resource/assets/opened'; requestId: string; ref?: ConversationFileRef; error?: string }
+  | { t: 'resource/assets/revealed'; requestId: string; ok: boolean; error?: string }
+  | { t: 'resource/files/opened'; requestId: string; ref?: ConversationFileRef; error?: string }
+  | { t: 'resource/files/revealed'; requestId: string; ok: boolean; error?: string }
   | { t: 'resource/memories'; records: MemoryRecord[]; settings: MemorySettings; workspaceId?: string; reviewRecords?: MemoryRecord[]; persona?: PersonaDocument | null }
   | { t: 'resource/memories/conversations'; requestId: string; results: ConversationSearchResult[]; error?: string }
   | { t: 'resource/memories/manage/state'; requestId: string; state: MemoryManagementState }

package/workflows/adaptive-research.yaml

@@ -21,11 +21,11 @@ steps:
     title: "1/3·自主调研写笔记"
     agent: |
       调研主题「${inputs.topic}」：用你手上的工具搜集 3-5 个关键要点，
-      整理成简洁的中文 markdown，写到 ./out/notes.md（目录不存在就先创建）。
+      整理成简洁的中文 markdown，写到 out/adaptive-research/${session}/notes.md（目录不存在就先创建）。
       写完后用 Read 自检文件确实写好了再收尾。
     allowed_tools: [Read, Write, Edit, Bash, Grep, Glob]
     # 确定性完成条件：模型「宣告要写却没写」时引擎自动提醒续跑（announce-not-do 兜底）
-    done_when: "fileExists('./out/notes.md')"
+    done_when: "fileExists('out/adaptive-research/${session}/notes.md')"
     capture:
       # agent 步 raw 只有 text/result（无 content）——曾绑 content 导致 notes 恒 undefined
       text: notes
@@ -35,7 +35,7 @@ steps:
     title: "2/3·统计笔记行数"
     tool: Bash
     args:
-      command: "wc -l ./out/notes.md"
+      command: "wc -l out/adaptive-research/${session}/notes.md"
     onError: recover
     recover_hint: "文件不存在或路径不对，就先用 Glob/Read 定位 notes.md 再统计行数"
     capture:
@@ -46,5 +46,5 @@ steps:
     title: "3/3·守门校验"
     type: verify
     checks:
-      - 'file_exists:./out/notes.md'
-    onFail: "调研笔记 ./out/notes.md 未生成，检查 research 步"
+      - 'file_exists:out/adaptive-research/${session}/notes.md'
+    onFail: "调研笔记 out/adaptive-research/${session}/notes.md 未生成，检查 research 步"

package/workflows/book-review-short.yaml

@@ -56,7 +56,7 @@ steps:
     title: "3/7·脚本落盘"
     tool: Write
     args:
-      file_path: "videos/${inputs.book}/script.txt"
+      file_path: "out/book-review-short/${session}/script.txt"
       content: "${script_text}"
 
   # 4. 生成 3 个钩子标题（loop + llm）—— P1 启用
@@ -97,7 +97,7 @@ steps:
   - id: gen_thumbnail
     title: "5/7·生成缩略图（可降级）"
     skill: image-gen-openrouter
-    input: 'prompt=${thumb_prompt} output=videos/${inputs.book}/thumbnail.png aspect=9:16'
+    input: 'prompt=${thumb_prompt} output=out/book-review-short/${session}/thumbnail.png aspect=9:16'
     onError: continue
 
   # 6. 元数据汇总（确定性工具）
@@ -106,7 +106,7 @@ steps:
     title: "6/7·汇总 meta.json"
     tool: Write
     args:
-      file_path: "videos/${inputs.book}/meta.json"
+      file_path: "out/book-review-short/${session}/meta.json"
       content: |
         {
           "book": ${json(inputs.book)},
@@ -120,6 +120,6 @@ steps:
     title: "7/7·守门校验"
     type: verify
     checks:
-      - 'file_exists:videos/${inputs.book}/script.txt'
-      - 'file_exists:videos/${inputs.book}/meta.json'
+      - 'file_exists:out/book-review-short/${session}/script.txt'
+      - 'file_exists:out/book-review-short/${session}/meta.json'
     onFail: "脚本或 meta 未写盘，请检查 Write 工具"

package/workflows/e2e-write-greet.yaml

@@ -12,7 +12,7 @@ steps:
     title: "1/3·写入便签"
     tool: Write
     args:
-      file_path: "out/${inputs.topic}/note.txt"
+      file_path: "out/e2e-write-greet/${session}/note.txt"
       content: "topic=${inputs.topic} ok"
     capture:
       args.content: note_body
@@ -21,7 +21,7 @@ steps:
     title: "2/3·校验落盘"
     type: verify
     checks:
-      - 'file_exists:out/${inputs.topic}/note.txt'
+      - 'file_exists:out/e2e-write-greet/${session}/note.txt'
     onFail: "note.txt 未落盘"
 
   - id: verify_capture

package/workflows/illustrate.yaml

@@ -8,7 +8,7 @@ version: "0.1"
 
 # 最终交付物（new-task 清旧 / completed 报产物 / 完成闸门校验落盘）。中间候选图与分文件不声明（scratch）。
 artifacts:
-  - "./build/illustrations.json"
+  - "out/illustrate/${session}/build/illustrations.json"
 
 # 自愈：浏览器/网络瞬态故障 in-run 重跑。
 self_heal:
@@ -154,7 +154,7 @@ steps:
         tool: Download
         args:
           url: "${u}"
-          path: "./build/illustrations/cand_${u_idx}.img"
+          path: "out/illustrate/${session}/build/illustrations/cand_${u_idx}.img"
           timeout: 30000
           headers:
             User-Agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36"
@@ -170,7 +170,7 @@ steps:
     do:
       - id: score_one
         title: "配图·打分 #${u_idx}"
-        when: "fileExists('./build/illustrations/cand_' + u_idx + '.img')"
+        when: "fileExists('out/illustrate/${session}/build/illustrations/cand_' + u_idx + '.img')"
         llm: |
           下方附上一张候选配图（用于主题：「${inputs.topic}」）。请**只看这张图**给出客观评估，输出 JSON。
           - relevance：0-10，图片内容与主题的契合度（画的东西是否切题）。
@@ -178,7 +178,7 @@ steps:
           - is_ad：true/false——这是不是**广告/促销/带营销文案或店铺水印/比价图**等不适合当配图的图。
           - reason：一句话理由（中文）。
           只输出 JSON 对象本身，不要 markdown 代码块、不要解释。
-        images: ["./build/illustrations/cand_${u_idx}.img"]
+        images: ["out/illustrate/${session}/build/illustrations/cand_${u_idx}.img"]
         image_detail: high
         capture:
           text: score_text
@@ -186,10 +186,10 @@ steps:
         max_retries: 1
       - id: write_score
         title: "配图·记录分数 #${u_idx}"
-        when: "fileExists('./build/illustrations/cand_' + u_idx + '.img')"
+        when: "fileExists('out/illustrate/${session}/build/illustrations/cand_' + u_idx + '.img')"
         tool: Write
         args:
-          file_path: "./build/illustrations/score_${u_idx}.json"
+          file_path: "out/illustrate/${session}/build/illustrations/score_${u_idx}.json"
           content: |
             {"index": ${u_idx}, "url": ${json(u)}, "engine": ${json(engine_used)}, "path": "build/illustrations/cand_${u_idx}.img", "score": ${score_text}}
         onError: continue
@@ -198,24 +198,24 @@ steps:
   - id: select
     title: "配图·选出最合适的 ${inputs.count} 张"
     agent: |
-      你是配图验收员。**唯一任务**：从已打分的候选里选出最合适的 ${inputs.count} 张配图，写 `./build/illustrations.json`。不要做别的。
+      你是配图验收员。**唯一任务**：从已打分的候选里选出最合适的 ${inputs.count} 张配图，写 `out/illustrate/${session}/build/illustrations.json`。不要做别的。
 
-      1. 用 Glob 列出 `./build/illustrations/score_*.json`，逐个 Read。每个文件形如
+      1. 用 Glob 列出 `out/illustrate/${session}/build/illustrations/score_*.json`，逐个 Read。每个文件形如
          `{"index","url","engine","path","score":{"relevance","quality","is_ad","reason"}}`（坏文件/缺 score 的跳过）。
       2. **先剔除 `score.is_ad == true` 的**（广告/促销/水印图绝不入选）。
       3. 其余按 **relevance×quality 降序**排序，取前 ${inputs.count} 张（不足就有几张给几张）。
-      4. 用 Write 写 `./build/illustrations.json`（严格 JSON、无注释、无 ``` 包裹）：
+      4. 用 Write 写 `out/illustrate/${session}/build/illustrations.json`（严格 JSON、无注释、无 ``` 包裹）：
          `{"topic": "...", "engine_used": "${engine_used}", "count": <实际入选数>,
            "picks": [{"path","url","engine","relevance","quality","reason"}, ...]}`
          path 用 score 文件里的 path（如 build/illustrations/cand_3.img）。
       完成后简述：扫了几个候选、剔了几张广告、最终选了哪几张（序号 + 一句理由）。
     allowed_tools: [Glob, Read, Write]
     maxTurns: 12
-    done_when: "fileExists('./build/illustrations.json')"
+    done_when: "fileExists('out/illustrate/${session}/build/illustrations.json')"
     onError: halt
     max_retries: 1
     artifacts:
-      - "./build/illustrations.json"
+      - "out/illustrate/${session}/build/illustrations.json"
 
   # ---------- 阶段7：完成报告（确定性输出，不烧 LLM）----------
   - id: report
@@ -223,5 +223,5 @@ steps:
     type: echo
     message: |
       ✅ 配图完成（主题：${inputs.topic}，来源：${engine_used}）。
-      选中的图片清单见 ./build/illustrations.json（每条含 path/url/engine/分数）。
+      选中的图片清单见 out/illustrate/${session}/build/illustrations.json（每条含 path/url/engine/分数）。
       下游 PPT/文章工作流可读 illustrations.json 取用这 ${inputs.count} 张配图。

package/workflows/plan.yaml

@@ -30,7 +30,7 @@ self_heal:
                         # 3s 级重试必撞同一个故障窗口（2026-06-12 实跑：两次重试全死在拥塞波里）
 
 artifacts:
-  - PLAN.md            # 核心产出：实现计划文档（仅在 stage4 定稿时落盘一次）
+  - out/plan/${session}/PLAN.md            # 核心产出：实现计划文档（仅在 stage4 定稿时落盘一次）
 
 steps:
   # ================================================================
@@ -129,7 +129,7 @@ steps:
       - id: stage2_draft_plan
         title: 阶段2/6·起草实现计划
         llm: |
-          你负责把目标和探索结果写成**可直接执行的实现计划正文**（将原样写入 ./PLAN.md）。
+          你负责把目标和探索结果写成**可直接执行的实现计划正文**（将原样写入 out/plan/${session}/out/plan/${session}/PLAN.md）。
 
           ${learnings_text != '' ? '这是用户方向性打回后的重做。用户审批反馈（必须遵从）：\n' + learnings_text : ''}
 
@@ -178,9 +178,9 @@ steps:
 
       # ----------------------------------------------------------------
       # 阶段 4：方案重构确定 + 人工审批闸门（反馈分类路由）
-      #   revise 产终版正文 → Write 落盘 ./PLAN.md → 审批小循环：
+      #   revise 产终版正文 → Write 落盘 out/plan/${session}/out/plan/${session}/PLAN.md → 审批小循环：
       #     空反馈（选继续）→ 批准放行
-      #     minor 反馈      → 就地修订 PLAN.md → 下一轮再确认
+      #     minor 反馈      → 就地修订 out/plan/${session}/PLAN.md → 下一轮再确认
       #     fundamental 反馈 → 记入教训 + continue 打回 plan_loop 重新规划
       # ----------------------------------------------------------------
       - id: stage4_revise
@@ -202,13 +202,13 @@ steps:
         max_retries: 2
 
       - id: stage4_write_plan
-        title: 阶段4/6·写入 PLAN.md
+        title: 阶段4/6·写入 out/plan/${session}/PLAN.md
         tool: Write
         args:
-          file_path: ./PLAN.md
+          file_path: out/plan/${session}/out/plan/${session}/PLAN.md
           content: "${final_plan_text}"
         artifacts:
-          - PLAN.md
+          - out/plan/${session}/PLAN.md
         max_retries: 1
 
       - id: stage4_approval
@@ -222,9 +222,9 @@ steps:
             type: pause
             free_text: approve   # 自由输入不 halt：捕获后由分类步决定走向
             prompt: |
-              📋 计划已定稿：./PLAN.md —— 请 review 后选择。
+              📋 计划已定稿：out/plan/${session}/out/plan/${session}/PLAN.md —— 请 review 后选择。
               选「继续执行」进入执行阶段；选「停止」保留现场（同目标重跑可断点续跑）；
-              选「其他」输入修改意见：小调整会就地改 PLAN.md 再请你确认，
+              选「其他」输入修改意见：小调整会就地改 out/plan/${session}/PLAN.md 再请你确认，
               方向性变化会带着你的意见回到规划阶段重来。
             capture:
               free_text: approval_notes
@@ -281,11 +281,11 @@ steps:
                 type: continue
                 target: plan_loop
             else:
-              # 局部调整：就地修订 PLAN.md，审批小循环自然进入下一轮再请确认
+              # 局部调整：就地修订 out/plan/${session}/PLAN.md，审批小循环自然进入下一轮再请确认
               - id: revise_with_feedback
                 title: 阶段4/6·按反馈修订计划
                 llm: |
-                  用户审批计划时给了修改意见。请把意见合入计划，输出**更新后的完整 PLAN.md 正文**。
+                  用户审批计划时给了修改意见。请把意见合入计划，输出**更新后的完整 out/plan/${session}/PLAN.md 正文**。
 
                   ## 用户修改意见
                   ${approval_notes}
@@ -301,13 +301,13 @@ steps:
                   text: final_plan_text
                 max_retries: 2
               - id: write_revised_plan
-                title: 阶段4/6·回写 PLAN.md
+                title: 阶段4/6·回写 out/plan/${session}/PLAN.md
                 tool: Write
                 args:
-                  file_path: ./PLAN.md
+                  file_path: out/plan/${session}/out/plan/${session}/PLAN.md
                   content: "${final_plan_text}"
                 artifacts:
-                  - PLAN.md
+                  - out/plan/${session}/PLAN.md
                 max_retries: 1
 
       # 审批小循环 5 轮仍无明确同意 → 诚实停（现场保留可续跑）
@@ -332,7 +332,7 @@ steps:
           - id: stage5_execute
             title: 阶段5/6·执行计划
             agent: |
-              你是资深工程师，执行一份已通过审批的实现计划。先 Read ./PLAN.md 了解全部步骤。
+              你是资深工程师，执行一份已通过审批的实现计划。先 Read out/plan/${session}/out/plan/${session}/PLAN.md 了解全部步骤。
 
               ${exec_feedback != '' ? '## ⚠️ 上轮执行验收未通过（本轮必须重点补完，产物已部分存在时增量补齐，不要从零重做）\n' + exec_feedback : ''}
 
@@ -369,7 +369,7 @@ steps:
               对照"成功标准"和当前文件系统，判断用户目标是否**真实达成**。
 
               请严格执行：
-              1. 先 Read ./PLAN.md，按其中的成功标准和产出物清单核验。
+              1. 先 Read out/plan/${session}/out/plan/${session}/PLAN.md，按其中的成功标准和产出物清单核验。
               2. 用 Bash/Read/Glob 亲自核实核心产物是否真实存在、是否满足每条成功标准。
               3. 产物是 pptx/docx/pdf/xlsx 等 OOXML 时，**必须用忠实的 OPC 合规校验**
                  （检查无 ZIP 目录条目、[Content_Types].xml 在首位、关系都解析、无 0 字节媒体），
@@ -383,7 +383,7 @@ steps:
 
               只输出 JSON 对象本身（不要 markdown、不要解释正文）。
             context_files:
-              - path: ./PLAN.md
+              - path: out/plan/${session}/out/plan/${session}/PLAN.md
                 hint: 实现计划与产出物清单
             allowed_tools: [Read, Bash, Glob]
             output_schema:
@@ -443,7 +443,7 @@ steps:
         title: 阶段5-6·执行兜底检查
         type: assert
         condition: "qualified == true"
-        onFail: "已批准的计划执行 3 轮仍未通过验收，工作流诚实停止（现场与 PLAN.md 保留，重跑同目标可从断点续跑；也可调整目标后重来）。最后阻塞原因：${blocking_reason}"
+        onFail: "已批准的计划执行 3 轮仍未通过验收，工作流诚实停止（现场与 out/plan/${session}/PLAN.md 保留，重跑同目标可从断点续跑；也可调整目标后重来）。最后阻塞原因：${blocking_reason}"
 
   # ================================================================
   # 出循环后：唯一正常到达路径 = exec_gate 验收通过 break 穿透至此。