@xdxer/dingtalk-agent 0.1.4 → 0.1.5-beta.10

package/docs/architecture/dingtalk-agent-architecture.svg

@@ -0,0 +1,125 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 880" width="1200" height="880" role="img" aria-labelledby="title desc">
+  <title id="title">dingtalk-agent 架构：五个部件，五个权威</title>
+  <desc id="desc">一个数字员工由五个部件构成，编号一到五：部件一 Agent 本体由本仓库拥有，内含可信事件、响应闸门、Session Run Wait、动作闸门与 Receipt 回读的处理链，以及本体装配、状态记忆、评测证据三块支撑；部件二组织身份与场域授权、部件三感知通道由钉钉数字员工平台提供，当前尚未接入；部件四平台执行能力由 DWS 提供，执行全部真实钉钉操作并回读 Receipt；部件五运行位置由 Managed Agent Platform 或本地 Agent Host 提供，Multica 已支持、DEAP 敬请期待、更多平台需先在注册表登记并提供平台 Skill 包。最底层是钉钉组织。</desc>
+  <style>
+    text { font-family: 'Helvetica Neue', Helvetica, Arial, 'PingFang SC', 'Microsoft YaHei', 'Microsoft JhengHei', 'SimHei', sans-serif; }
+    .title      { fill:#111827;font-size:22px;font-weight:700; }
+    .subtitle   { fill:#6b7280;font-size:13px; }
+    .lane       { fill:#475569;font-size:12px;font-weight:700;letter-spacing:.08em; }
+    .node-title { fill:#111827;font-size:15px;font-weight:700; }
+    .node-sub   { fill:#4b5563;font-size:12px; }
+    .small      { fill:#64748b;font-size:11px; }
+    .label      { fill:#475569;font-size:11px;font-weight:600; }
+    .footer     { fill:#ffffff;font-size:11px;font-weight:600; }
+    .badge-on   { fill:#ffffff;font-size:12px;font-weight:700; }
+  </style>
+  <defs>
+    <marker id="arrow-blue" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" fill="#2563eb"/></marker>
+    <marker id="arrow-gray" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" fill="#64748b"/></marker>
+    <marker id="arrow-purple" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" fill="#7c3aed"/></marker>
+    <marker id="arrow-teal" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" fill="#0d9488"/></marker>
+  </defs>
+  <rect width="1200" height="880" fill="#ffffff"/>
+  <text x="40" y="46" class="title">dingtalk-agent 架构：五个部件，五个权威，本仓库只拥有一个</text>
+  <text x="40" y="70" class="subtitle">把 Agent 装配成合格的钉钉数字员工，并连接更广阔的 Agent 运行平台。实心编号 = 本仓库拥有；空心编号 = 外部提供。</text>
+  <rect x="40" y="92" width="1120" height="122" rx="8" fill="#f9fafb" stroke="#d1d5db" stroke-width="1.5" stroke-dasharray="7 5"/>
+  <circle cx="62" cy="110" r="11" fill="#ffffff" stroke="#64748b" stroke-width="1.6"/>
+  <text x="62" y="114" text-anchor="middle" fill="#64748b" font-size="12" font-weight="700">5</text>
+  <text x="82" y="115" class="lane">RUNTIME LOCATION · 运行位置（可替换）—— Agent 在哪里执行，本仓库不自建 Runtime</text>
+  <rect x="64" y="128" width="247" height="70" rx="8" fill="#f0fdf4" stroke="#86efac" stroke-width="1.5"/>
+  <text x="187" y="156" text-anchor="middle" class="node-title">Multica</text>
+  <text x="187" y="178" text-anchor="middle" class="node-sub">已支持</text>
+  <rect x="339" y="128" width="247" height="70" rx="8" fill="#faf5ff" stroke="#c084fc" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="462" y="156" text-anchor="middle" class="node-title">DEAP</text>
+  <text x="462" y="178" text-anchor="middle" class="node-sub">敬请期待 · 是否内建运行平台待确认</text>
+  <rect x="614" y="128" width="247" height="70" rx="8" fill="#f9fafb" stroke="#d1d5db" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="737" y="156" text-anchor="middle" class="node-title">更多平台</text>
+  <text x="737" y="178" text-anchor="middle" class="node-sub">注册表 + 平台 Skill 包</text>
+  <rect x="889" y="128" width="247" height="70" rx="8" fill="#ffffff" stroke="#d1d5db" stroke-width="1.5"/>
+  <text x="1012" y="156" text-anchor="middle" class="node-title">本地 Agent Host</text>
+  <text x="1012" y="178" text-anchor="middle" class="node-sub">Claude Code · Codex · OpenCode</text>
+  <path d="M 600,268 L 600,220" fill="none" stroke="#64748b" stroke-width="1.5" stroke-dasharray="5 4" marker-end="url(#arrow-gray)"/>
+  <rect x="610" y="232" width="190" height="19" rx="4" fill="#ffffff" opacity="0.95"/>
+  <text x="704" y="246" text-anchor="middle" class="label">部署 · Definition 与 Skill 树</text>
+  <rect x="40" y="268" width="1120" height="292" rx="8" fill="#f8fafc" stroke="#0f766e" stroke-width="2"/>
+  <circle cx="62" cy="288" r="11" fill="#0f766e"/>
+  <text x="62" y="292" text-anchor="middle" class="badge-on">1</text>
+  <text x="82" y="292" fill="#0f766e" font-size="12" font-weight="700" letter-spacing=".08em">DINGTALK-AGENT · 本仓库唯一拥有的一项：Agent 本体 · 公共行为 · 状态 · 效果证据</text>
+  <text x="82" y="312" class="small">Skill 劝（该不该做）· CLI 拦（身份 / 目标 / 预算 / 幂等 / 回读）· DWS 做（执行）</text>
+  <rect x="64" y="326" width="187" height="92" rx="8" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.8"/>
+  <text x="157" y="356" text-anchor="middle" class="node-title">可信事件</text>
+  <text x="157" y="378" text-anchor="middle" class="node-sub">Invocation</text>
+  <text x="157" y="397" text-anchor="middle" class="small">谁 · 在哪 · 说了什么</text>
+  <rect x="285" y="326" width="187" height="92" rx="8" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.8"/>
+  <text x="378" y="356" text-anchor="middle" class="node-title">Response Gate</text>
+  <text x="378" y="378" text-anchor="middle" class="node-sub">mention/DM 才处理</text>
+  <text x="378" y="397" text-anchor="middle" class="small">群聊未 @ 默认沉默</text>
+  <rect x="506" y="326" width="187" height="92" rx="8" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.8"/>
+  <text x="599" y="356" text-anchor="middle" class="node-title">Session·Run·Wait</text>
+  <text x="599" y="378" text-anchor="middle" class="node-sub">一件事 · 一次唤醒</text>
+  <text x="599" y="397" text-anchor="middle" class="small">沙箱可丢弃，事情接着做</text>
+  <rect x="727" y="326" width="187" height="92" rx="8" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.8"/>
+  <text x="820" y="356" text-anchor="middle" class="node-title">Action Gate</text>
+  <text x="820" y="378" text-anchor="middle" class="node-sub">冻结身份 · 目标 · 预算</text>
+  <text x="820" y="397" text-anchor="middle" class="small">幂等，不盲重试</text>
+  <rect x="948" y="326" width="187" height="92" rx="8" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.8"/>
+  <text x="1041" y="356" text-anchor="middle" class="node-title">Receipt</text>
+  <text x="1041" y="378" text-anchor="middle" class="node-sub">独立回读</text>
+  <text x="1041" y="397" text-anchor="middle" class="small">无证据不声称完成</text>
+  <path d="M 251,372 L 285,372" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 472,372 L 506,372" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 693,372 L 727,372" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 914,372 L 948,372" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <rect x="64" y="440" width="337" height="92" rx="8" fill="#ffffff" stroke="#93c5fd" stroke-width="1.5"/>
+  <text x="232" y="468" text-anchor="middle" class="node-title">本体与装配</text>
+  <text x="232" y="490" text-anchor="middle" class="node-sub">Definition + Basic Behavior + Role Skills</text>
+  <text x="232" y="509" text-anchor="middle" class="small">agent enhance · agent audit --verify-load</text>
+  <rect x="431" y="440" width="337" height="92" rx="8" fill="#ffffff" stroke="#93c5fd" stroke-width="1.5"/>
+  <text x="599" y="468" text-anchor="middle" class="node-title">状态与记忆</text>
+  <text x="599" y="490" text-anchor="middle" class="node-sub">语义内容与控制状态分开</text>
+  <text x="599" y="509" text-anchor="middle" class="small">锁 · 幂等 · Receipt 不进 Markdown</text>
+  <rect x="798" y="440" width="337" height="92" rx="8" fill="#ffffff" stroke="#93c5fd" stroke-width="1.5"/>
+  <text x="966" y="468" text-anchor="middle" class="node-title">评测与证据</text>
+  <text x="966" y="490" text-anchor="middle" class="node-sub">上线前用最低成本证明它真会做事</text>
+  <text x="966" y="509" text-anchor="middle" class="small">lab · workspace eval · observe</text>
+  <path d="M 158,606 L 158,564" fill="none" stroke="#7c3aed" stroke-width="1.8" stroke-dasharray="6 4" marker-end="url(#arrow-purple)"/>
+  <rect x="169" y="572" width="136" height="19" rx="4" fill="#ffffff" opacity="0.95"/>
+  <text x="237" y="586" text-anchor="middle" class="label">签发的身份 · 可信事件</text>
+  <path d="M 821,564 L 821,606" fill="none" stroke="#0d9488" stroke-width="2" marker-end="url(#arrow-teal)"/>
+  <rect x="837" y="572" width="56" height="19" rx="4" fill="#ffffff" opacity="0.95"/>
+  <text x="865" y="586" text-anchor="middle" class="label">执行动作</text>
+  <path d="M 1042,606 L 1042,564" fill="none" stroke="#0d9488" stroke-width="2" marker-end="url(#arrow-teal)"/>
+  <rect x="1058" y="572" width="82" height="19" rx="4" fill="#ffffff" opacity="0.95"/>
+  <text x="1099" y="586" text-anchor="middle" class="label">Receipt 回读</text>
+  <rect x="40" y="606" width="540" height="140" rx="8" fill="#faf5ff" stroke="#c084fc" stroke-width="1.8" stroke-dasharray="7 5"/>
+  <text x="58" y="630" fill="#7c3aed" font-size="12" font-weight="700" letter-spacing=".08em">IDENTITY &amp; PERCEPTION · 钉钉数字员工平台</text>
+  <rect x="60" y="646" width="245" height="64" rx="8" fill="#ffffff" stroke="#d8b4fe" stroke-width="1.5"/>
+  <circle cx="80" cy="666" r="11" fill="#ffffff" stroke="#7c3aed" stroke-width="1.6"/>
+  <text x="80" y="670" text-anchor="middle" fill="#7c3aed" font-size="12" font-weight="700">2</text>
+  <text x="183" y="673" text-anchor="middle" class="node-title">身份权限管控</text>
+  <text x="183" y="694" text-anchor="middle" class="node-sub">创建 · UID · 场域边界 · 生命周期</text>
+  <rect x="320" y="646" width="245" height="64" rx="8" fill="#ffffff" stroke="#d8b4fe" stroke-width="1.5"/>
+  <circle cx="340" cy="666" r="11" fill="#ffffff" stroke="#7c3aed" stroke-width="1.6"/>
+  <text x="340" y="670" text-anchor="middle" fill="#7c3aed" font-size="12" font-weight="700">3</text>
+  <text x="443" y="673" text-anchor="middle" class="node-title">感知与人机交互</text>
+  <text x="443" y="694" text-anchor="middle" class="node-sub">事件送达 · 统一展示</text>
+  <text x="60" y="730" class="small">DEAP 敬请期待，平台命令一律 fail-closed；事件信封的权威是钉钉事件中心与 DWS。</text>
+  <rect x="620" y="606" width="540" height="140" rx="8" fill="#f0fdfa" stroke="#0f766e" stroke-width="1.8"/>
+  <text x="638" y="630" fill="#0f766e" font-size="12" font-weight="700" letter-spacing=".08em">PLATFORM EXECUTION · DWS</text>
+  <rect x="640" y="646" width="500" height="64" rx="8" fill="#ffffff" stroke="#5eead4" stroke-width="1.5"/>
+  <circle cx="660" cy="666" r="11" fill="#ffffff" stroke="#0d9488" stroke-width="1.6"/>
+  <text x="660" y="670" text-anchor="middle" fill="#0d9488" font-size="12" font-weight="700">4</text>
+  <text x="890" y="673" text-anchor="middle" class="node-title">钉钉全部产品能力</text>
+  <text x="890" y="694" text-anchor="middle" class="node-sub">消息 · 文档 · 表格 · 日程 · 审批 · 通讯录</text>
+  <text x="640" y="730" class="small">所有真实钉钉操作最终都由 DWS 执行；src/dws.ts 是全仓库唯一 spawn dws 的地方。</text>
+  <rect x="40" y="764" width="1120" height="28" rx="6" fill="#0f172a"/>
+  <text x="600" y="783" text-anchor="middle" class="footer">钉钉组织 · 真实的人、群、日程、审批与文档 —— 身份与事件由钉钉签发，本仓库只冻结、审计和引用，不发证、不改写、不扩权</text>
+  <line x1="40" y1="828" x2="74" y2="828" stroke="#2563eb" stroke-width="1.8" marker-end="url(#arrow-blue)"/>
+  <text x="82" y="832" class="small">主处理流：事件 → 资格 → 动作</text>
+  <line x1="300" y1="828" x2="334" y2="828" stroke="#64748b" stroke-width="1.8" stroke-dasharray="5 4" marker-end="url(#arrow-gray)"/>
+  <text x="342" y="832" class="small">装配与部署（本仓库 → 运行平台）</text>
+  <line x1="560" y1="828" x2="594" y2="828" stroke="#7c3aed" stroke-width="1.8" stroke-dasharray="6 4" marker-end="url(#arrow-purple)"/>
+  <text x="602" y="832" class="small">钉钉签发的身份与可信事件（DEAP 待接入）</text>
+  <line x1="860" y1="828" x2="894" y2="828" stroke="#0d9488" stroke-width="1.8" marker-end="url(#arrow-teal)"/>
+  <text x="902" y="832" class="small">DWS 执行与 Receipt 回读</text>
+</svg>

package/docs/assets/digital-employee-at-work.svg

@@ -0,0 +1,77 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 430" width="1200" height="430" role="img" aria-labelledby="title desc">
+  <title id="title">一个钉钉数字员工的一次协作</title>
+  <desc id="desc">群里有同事 @ 数字员工提出请求；它先确认自己是谁、被授权对谁做事；然后经 DWS 执行真实的钉钉操作；最后拿出可独立回读的回执与产物，才声称完成。全过程留在原来的群里，和真人同事走同一套协作界面。</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0a1020"/><stop offset="1" stop-color="#111a31"/></linearGradient>
+    <linearGradient id="accent" x1="0" y1="0" x2="1" y2="0"><stop offset="0" stop-color="#39c6f4"/><stop offset="1" stop-color="#7777ff"/></linearGradient>
+    <filter id="shadow" x="-20%" y="-30%" width="140%" height="160%"><feDropShadow dx="0" dy="8" stdDeviation="12" flood-color="#020617" flood-opacity=".34"/></filter>
+    <style>
+      text { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif; }
+      .eyebrow { font-size:13px;font-weight:600;letter-spacing:1.6px;fill:#7dd3fc; }
+      .title   { font-size:22px;font-weight:700;fill:#f8fafc; }
+      .step    { font-size:17px;font-weight:700;fill:#f8fafc; }
+      .body    { font-size:14px;font-weight:500;fill:#cbd5e1; }
+      .small   { font-size:12px;font-weight:500;fill:#94a3b8; }
+      .bubble  { font-size:14px;font-weight:600;fill:#dbeafe; }
+      .num     { font-size:13px;font-weight:700;fill:#08111f; }
+    </style>
+  </defs>
+  <rect width="1200" height="430" rx="28" fill="url(#bg)"/>
+  <path d="M52 96H1148" stroke="#23304a"/>
+  <text x="52" y="56" class="eyebrow">A DIGITAL EMPLOYEE AT WORK</text>
+  <text x="52" y="86" class="title">群里 @ 它一句话，它像同事一样把事办完——而且每一步都留得下痕迹</text>
+  <g filter="url(#shadow)">
+    <rect x="52" y="116" width="250" height="188" rx="22" fill="#111c33" stroke="#2b3b59"/>
+    <circle cx="84" cy="150" r="15" fill="#67e8f9"/>
+    <text x="84" y="155" text-anchor="middle" class="num">1</text>
+    <text x="110" y="156" class="step">有人在群里 @ 它</text>
+    <rect x="74" y="184" width="206" height="46" rx="10" fill="#172643"/>
+    <text x="90" y="204" class="body">真人同事，在原来的群里</text>
+    <text x="90" y="222" class="small">不用换工具、不用开新系统</text>
+  </g>
+  <g filter="url(#shadow)">
+    <rect x="340" y="116" width="250" height="188" rx="22" fill="#111c33" stroke="#2b3b59"/>
+    <circle cx="372" cy="150" r="15" fill="#67e8f9"/>
+    <text x="372" y="155" text-anchor="middle" class="num">2</text>
+    <text x="398" y="156" class="step">它先确认自己是谁</text>
+    <rect x="362" y="184" width="206" height="46" rx="10" fill="#172643"/>
+    <text x="378" y="204" class="body">工号 · 岗位 · 能对谁做事</text>
+    <text x="378" y="222" class="small">身份由钉钉签发，不看正文说什么</text>
+  </g>
+  <g filter="url(#shadow)">
+    <rect x="628" y="116" width="250" height="188" rx="22" fill="#111c33" stroke="#2b3b59"/>
+    <circle cx="660" cy="150" r="15" fill="#67e8f9"/>
+    <text x="660" y="155" text-anchor="middle" class="num">3</text>
+    <text x="686" y="156" class="step">它去把事情办了</text>
+    <rect x="650" y="184" width="206" height="46" rx="10" fill="#172643"/>
+    <text x="666" y="204" class="body">查状态 · 发通知 · 写文档</text>
+    <text x="666" y="222" class="small">每个动作都过一道闸门</text>
+  </g>
+  <g filter="url(#shadow)">
+    <rect x="916" y="116" width="232" height="188" rx="22" fill="#111c33" stroke="#2b3b59"/>
+    <circle cx="948" cy="150" r="15" fill="#67e8f9"/>
+    <text x="948" y="155" text-anchor="middle" class="num">4</text>
+    <text x="974" y="156" class="step">它拿得出做完的证据</text>
+    <rect x="938" y="184" width="188" height="46" rx="10" fill="#172643"/>
+    <text x="954" y="204" class="body">回执 · 产物 · 可独立回读</text>
+    <text x="954" y="222" class="small">没有证据，就不说「做完了」</text>
+  </g>
+  <rect x="74" y="248" width="206" height="40" rx="12" fill="#17314b" stroke="#275779"/>
+  <text x="90" y="273" class="bubble">「@发布助手 3.2 能发了吗」</text>
+  <rect x="362" y="248" width="206" height="40" rx="12" fill="#1c2a4d" stroke="#3a4f7a"/>
+  <text x="378" y="273" class="small" fill="#cbd5e1">授权范围外的人和群，不响应</text>
+  <rect x="650" y="248" width="206" height="40" rx="12" fill="#1c2a4d" stroke="#3a4f7a"/>
+  <text x="666" y="273" class="small" fill="#cbd5e1">回复目标只能来自这条消息</text>
+  <rect x="938" y="248" width="188" height="40" rx="12" fill="#14322a" stroke="#2f6b52"/>
+  <circle cx="958" cy="268" r="6" fill="#4ade80"/>
+  <text x="972" y="273" class="small" fill="#cbd5e1">回读通过才算完成</text>
+  <path d="M302 210H330" stroke="url(#accent)" stroke-width="3" stroke-linecap="round"/>
+  <path d="m320 202 10 8-10 8" fill="none" stroke="#7777ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M590 210H618" stroke="url(#accent)" stroke-width="3" stroke-linecap="round"/>
+  <path d="m608 202 10 8-10 8" fill="none" stroke="#7777ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M878 210H906" stroke="url(#accent)" stroke-width="3" stroke-linecap="round"/>
+  <path d="m896 202 10 8-10 8" fill="none" stroke="#7777ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+  <rect x="52" y="336" width="1096" height="1" fill="#23304a"/>
+  <text x="52" y="370" class="body">和真人同事走同一套协作界面——区别是，它的身份、边界和每一次副作用都可以被审计。</text>
+  <text x="52" y="398" class="small">未 @ 的群消息默认沉默 · 命令行不提供「发给谁」这个参数 · 说「完成」必须有宿主签发的证据——这三条由合同评测锁定。</text>
+</svg>

package/docs/schemas/multica-deployment-plan.schema.json

@@ -40,9 +40,11 @@
           }
         },
         "definitionHash": { "$ref": "#/$defs/hash" },
-        "instructionsHash": { "$ref": "#/$defs/hash" }
+        "instructionsHash": { "$ref": "#/$defs/hash" },
+        "previousRuntimeId": { "type": "string" }
       }
     },
+    "rebindRuntime": { "type": "boolean" },
     "operations": { "type": "array", "items": { "type": "string", "minLength": 1 } },
     "writeBudget": {
       "type": "object",

package/docs/schemas/multica-deployment-receipt.schema.json

@@ -49,17 +49,23 @@
     "calls": { "$ref": "multica-deployment-operation.schema.json#/$defs/calls" },
     "smoke": {
       "type": "object", "additionalProperties": false,
-      "required": ["status", "marker", "markerHash", "issueId", "taskId", "taskStatus", "requiredSkills", "loadedSkills", "toolTracePassed", "responsePassed", "responseHash", "failures"],
+      "required": ["status", "marker", "markerHash", "issueId", "taskId", "taskStatus", "taskDiagnostic", "requiredSkills", "loadedSkills", "toolTracePassed", "responsePassed", "responseHash", "failures"],
       "properties": {
         "status": { "enum": ["not-run", "pending", "passed", "failed"] },
         "marker": { "type": "string" }, "markerHash": { "type": "string" },
         "issueId": { "type": "string" }, "taskId": { "type": "string" },
-        "taskStatus": { "type": "string" },
+        "taskStatus": { "type": "string" }, "taskDiagnostic": { "type": "string" },
         "requiredSkills": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/name" } },
         "loadedSkills": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/name" } },
         "toolTracePassed": { "type": "boolean" }, "responsePassed": { "type": "boolean" },
         "responseHash": { "type": "string" },
-        "failures": { "type": "array", "items": { "type": "string" } }
+        "failures": { "type": "array", "items": { "type": "string" } },
+        "runtimeProvider": { "type": "string" },
+        "vocabularyIds": { "type": "array", "items": { "type": "string" } },
+        "toolNames": { "type": "array", "items": { "type": "string" } },
+        "unrecognizedTools": { "type": "array", "items": { "type": "string" } },
+        "classification": { "enum": ["", "skills-not-visible"] },
+        "failureDetails": { "$ref": "multica-workspace-inspection.schema.json#/$defs/failureDetails" }
       }
     },
     "rollback": {
@@ -72,6 +78,14 @@
       }
     },
     "failures": { "type": "array", "items": { "type": "string" } },
+    "failureDetails": { "$ref": "multica-workspace-inspection.schema.json#/$defs/failureDetails" },
+    "rebind": {
+      "type": "object", "additionalProperties": false,
+      "required": ["fromRuntimeId", "toRuntimeId"],
+      "properties": {
+        "fromRuntimeId": { "type": "string" }, "toRuntimeId": { "type": "string" }
+      }
+    },
     "evidencePath": { "type": "string", "minLength": 1 },
     "remoteRead": { "const": true }, "remoteWrite": { "type": "boolean" },
     "triggerWrite": { "const": false },

package/docs/schemas/multica-deployment-status.schema.json

@@ -14,10 +14,14 @@
     "passed": { "type": "boolean" }, "providerReady": { "type": "boolean" },
     "operationIntegrity": { "type": "boolean" }, "receiptIntegrity": { "type": "boolean" },
     "reconciled": { "type": "boolean" },
+    "receiptFrozen": { "type": "boolean" },
+    "smokeStale": { "type": "boolean" },
+    "nextAction": { "type": "string" },
     "failures": { "type": "array", "items": { "type": "string" } },
     "receipt": { "oneOf": [{ "type": "null" }, { "$ref": "multica-deployment-receipt.schema.json" }] },
-    "remoteRead": { "type": "boolean" }, "remoteWrite": { "const": false },
-    "triggerWrite": { "const": false }, "sideEffect": { "enum": [false, "multica-read"] },
+    "remoteRead": { "type": "boolean" }, "remoteWrite": { "type": "boolean" },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "enum": [false, "multica-read", "multica-read-write"] },
     "dingtalkSideEffect": { "const": false }
   }
 }

package/docs/schemas/multica-workspace-inspection.schema.json

@@ -36,6 +36,8 @@
     "resources": { "$ref": "#/$defs/resources" },
     "diff": { "type": "array", "items": { "type": "string" } },
     "failures": { "type": "array", "items": { "type": "string" } },
+    "failureDetails": { "$ref": "#/$defs/failureDetails" },
+    "envSanitized": { "type": "array", "items": { "type": "string" } },
     "calls": {
       "type": "array",
       "items": {
@@ -60,6 +62,20 @@
   },
   "$defs": {
     "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "failureDetails": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["code"],
+        "properties": {
+          "code": { "type": "string", "minLength": 1 },
+          "expected": { "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
+          "actual": { "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
+          "hint": { "type": "string" }
+        }
+      }
+    },
     "resources": {
       "type": "object",
       "additionalProperties": false,

package/docs/schemas/multica-workspace-run-plan.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-workspace-run-plan.schema.json",
+  "title": "dingtalk-agent Multica Workspace Run Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "workspace", "provider", "profile", "workspaceId", "runtimeId", "agentId", "promptHash", "operations", "blocking", "requiresExecute", "requiresExplicitYes", "remoteRead", "remoteWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-workspace-run-plan@1" },
+    "workspace": { "$ref": "#/$defs/name" },
+    "provider": { "const": "multica" },
+    "profile": { "type": "string", "minLength": 1 },
+    "workspaceId": { "type": "string", "minLength": 1 },
+    "runtimeId": { "type": "string", "minLength": 1 },
+    "agentId": { "type": "string", "minLength": 1 },
+    "promptHash": { "$ref": "#/$defs/hash" },
+    "operations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "blocking": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "requiresExecute": { "const": true },
+    "requiresExplicitYes": { "const": true },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  },
+  "$defs": {
+    "name": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/docs/schemas/multica-workspace-run.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-workspace-run.schema.json",
+  "title": "dingtalk-agent Multica Workspace Run Report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema",
+    "passed",
+    "runId",
+    "workspace",
+    "provider",
+    "profile",
+    "workspaceId",
+    "runtimeId",
+    "agentId",
+    "promptHash",
+    "issueId",
+    "issueStatus",
+    "taskId",
+    "taskStatus",
+    "taskDiagnostic",
+    "pollAttempts",
+    "pollIntervalMs",
+    "answer",
+    "answerHash",
+    "toolNames",
+    "loadedSkills",
+    "failures",
+    "calls",
+    "evidencePath",
+    "remoteRead",
+    "remoteWrite",
+    "triggerWrite",
+    "sideEffect",
+    "dingtalkSideEffect"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "dingtalk-agent/multica-workspace-run@1"
+    },
+    "passed": {
+      "type": "boolean"
+    },
+    "runId": {
+      "$ref": "#/$defs/id"
+    },
+    "workspace": {
+      "$ref": "#/$defs/name"
+    },
+    "provider": {
+      "const": "multica"
+    },
+    "profile": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workspaceId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "runtimeId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "agentId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "promptHash": {
+      "$ref": "#/$defs/hash"
+    },
+    "issueId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "issueStatus": {
+      "type": "string"
+    },
+    "taskId": {
+      "type": "string"
+    },
+    "taskStatus": {
+      "type": "string",
+      "minLength": 1
+    },
+    "taskDiagnostic": {
+      "type": "string"
+    },
+    "pollAttempts": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "pollIntervalMs": {
+      "type": "integer",
+      "minimum": 100
+    },
+    "answer": {
+      "type": "string"
+    },
+    "answerHash": {
+      "$ref": "#/$defs/hash"
+    },
+    "toolNames": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "loadedSkills": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/name"
+      }
+    },
+    "failures": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "calls": {
+      "$ref": "multica-deployment-operation.schema.json#/$defs/calls"
+    },
+    "evidencePath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "remoteRead": {
+      "const": true
+    },
+    "remoteWrite": {
+      "type": "boolean"
+    },
+    "triggerWrite": {
+      "const": false
+    },
+    "sideEffect": {
+      "const": "multica-issue-read-write"
+    },
+    "dingtalkSideEffect": {
+      "const": false
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{1,127}$"
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    }
+  }
+}

package/docs/schemas/multica-workspace-status.schema.json

@@ -26,6 +26,8 @@
     "observedHash": { "type": "string" },
     "diff": { "type": "array", "items": { "type": "string" } },
     "failures": { "type": "array", "items": { "type": "string" } },
+    "failureDetails": { "$ref": "multica-workspace-inspection.schema.json#/$defs/failureDetails" },
+    "observedAgentRuntimeId": { "type": "string" },
     "remoteRead": { "const": false },
     "remoteWrite": { "const": false },
     "sideEffect": { "const": false },

package/docs/schemas/project.schema.json

@@ -17,16 +17,42 @@
       "required": ["definition", "skills"],
       "properties": {
         "definition": { "type": "string", "minLength": 1 },
+        "skillsRoot": {
+          "type": "string",
+          "minLength": 1,
+          "description": "全部 Agent Skills 的单一版本化源码根；新项目默认 agent/skills，旧项目省略时沿用历史兼容布局"
+        },
         "displayName": { "type": "string", "minLength": 1, "maxLength": 128 },
         "skills": {
           "type": "array",
           "minItems": 1,
           "uniqueItems": true,
-          "contains": { "const": "dingtalk-basic-behavior" },
+          "contains": { "const": "dta-basic-behavior" },
           "items": { "$ref": "#/$defs/name" }
         }
       }
     },
+    "predicates": {
+      "type": "object",
+      "description": "完成判据注册表：id → 判据。声明侧 completion 用 predicate:<id> 引用，运行路径（autopilot description 标记、Receipt）引用同一 id——两个求值方无法静默分叉。跨语言合同：注册表就在本 manifest JSON 里，Python 引擎读同一份文件引用同一 id。一旦声明注册表（包括显式空对象——那是「已进入引用模式」，不是未声明），所有 completion 必须是引用（自由文本判据可被一句话注入绕过）。",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["description"],
+          "properties": {
+            "description": { "type": "string", "minLength": 1, "description": "人读判据：完成 = 数据里哪个可查状态" },
+            "source": { "type": "string", "minLength": 1, "description": "判据的数据来源/查询提示（表、字段、查询方式）" }
+          }
+        }
+      }
+    },
+    "schedules": {
+      "type": "array",
+      "description": "Agent 内化的常驻节律（internalized cron），声明式、版本化。clock 只开窗，作用域/完成判据由 Skill 状态驱动。部署由 provider adapter 映射（Multica→autopilot）。见 dta-agent-compose/references/drive-and-schedules.md",
+      "items": { "$ref": "#/$defs/schedule" }
+    },
     "workspaces": {
       "type": "object",
       "propertyNames": {
@@ -39,6 +65,23 @@
     }
   },
   "$defs": {
+    "schedule": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "cron", "timezone", "mode"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 128, "description": "人类标签，也作平台侧标题；同一 Project 内唯一" },
+        "cron": { "type": "string", "pattern": "^\\s*\\S+\\s+\\S+\\s+\\S+\\s+\\S+\\s+\\S+\\s*$", "description": "标准 5 段 cron（分 时 日 月 周），无秒、无 @macro" },
+        "timezone": { "type": "string", "minLength": 1, "description": "IANA 时区，如 Asia/Shanghai" },
+        "mode": { "enum": ["ephemeral", "work-item"], "description": "ephemeral=run-only；work-item=每次触发产生一个工作项（Multica create_issue）" },
+        "wake": { "type": "string", "minLength": 1, "description": "① 唤醒词/类别；Agent 读它给本拍定作用域，clock 不带工作清单" },
+        "purpose": { "type": "string", "minLength": 1 },
+        "completion": { "type": "string", "minLength": 1, "description": "② 从数据推得出的完成判据（level-triggered），不是「那一拍跑了没」。推荐 predicate:<id> 引用顶层 predicates 注册表（声明了注册表则强制引用）" },
+        "unit": { "type": "string", "minLength": 1, "description": "③ 每次触发的增量工作单元（折 delta，不重建）" },
+        "evidence": { "type": "string", "minLength": 1, "description": "④ 什么效果证明真做了（write/receipt/水位），不认自述" },
+        "supervision": { "type": "string", "minLength": 1, "description": "⑤ 谁盯这个循环收敛" }
+      }
+    },
     "name": {
       "type": "string",
       "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$"
@@ -50,7 +93,6 @@
     "storage": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["memory", "knowledge"],
       "properties": {
         "memory": { "type": "string", "pattern": "^(local-md|dingtalk-doc):.+$" },
         "knowledge": { "type": "string", "pattern": "^(local-md|dingtalk-doc):.+$" },
@@ -90,7 +132,7 @@
     "workspace": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["stage", "provider", "storage"],
+      "required": ["stage", "provider"],
       "properties": {
         "stage": { "enum": ["dev", "test", "staging", "prod"] },
         "provider": {
@@ -103,6 +145,15 @@
         "authority": { "$ref": "#/$defs/authority" }
       },
       "allOf": [
+        {
+          "if": {
+            "properties": { "provider": { "properties": { "kind": { "const": "opencode" } } } }
+          },
+          "then": {
+            "required": ["storage"],
+            "properties": { "storage": { "required": ["memory", "knowledge"] } }
+          }
+        },
         {
           "if": {
             "properties": { "provider": { "properties": { "kind": { "const": "multica" } } } }