@xdxer/dingtalk-agent 0.1.5-beta.3 → 0.1.5-beta.4

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-workspace-run.schema.json

@@ -4,41 +4,158 @@
   "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"],
+  "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": { "const": true },
-    "triggerWrite": { "const": false },
-    "sideEffect": { "const": "multica-issue-read-write" },
-    "dingtalkSideEffect": { "const": false }
+    "$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}$" }
+    "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/project.schema.json

@@ -32,6 +32,11 @@
         }
       }
     },
+    "schedules": {
+      "type": "array",
+      "description": "Agent 内化的常驻节律（internalized cron），声明式、版本化。clock 只开窗，作用域/完成判据由 Skill 状态驱动。部署由 provider adapter 映射（Multica→autopilot）。见 dingtalk-agent-compose/references/drive-and-schedules.md",
+      "items": { "$ref": "#/$defs/schedule" }
+    },
     "workspaces": {
       "type": "object",
       "propertyNames": {
@@ -44,6 +49,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），不是「那一拍跑了没」" },
+        "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])?$"

package/docs/schemas/workspace-scaffold.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/workspace-scaffold.schema.json",
+  "title": "dingtalk-agent Workspace Scaffold Result",
+  "description": "Result of `dta workspace create <name>` when it authors a managed-platform Workspace entry into dingtalk-agent.json (rather than building a local OpenCode host). Env-referenced IDs are namespaced by Workspace name; authority is filled in and agentIdFrom is deliberately omitted so the first deploy creates the Agent and saves its stable ID.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "workspace", "provider", "stage", "profile", "applied", "alreadyDeclared",
+    "manifest", "block", "envRefs", "nextSteps", "sideEffect", "dingtalkSideEffect"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/workspace-scaffold@1" },
+    "workspace": { "type": "string", "minLength": 1 },
+    "provider": { "const": "multica" },
+    "stage": { "enum": ["dev", "test", "staging", "prod"] },
+    "profile": { "type": "string", "minLength": 1 },
+    "applied": { "type": "boolean" },
+    "alreadyDeclared": { "type": "boolean" },
+    "manifest": { "const": "dingtalk-agent.json" },
+    "block": { "type": "object" },
+    "envRefs": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceId", "runtimeId", "dwsProfile", "expectedUserId"],
+      "properties": {
+        "workspaceId": { "type": "string", "minLength": 1 },
+        "runtimeId": { "type": "string", "minLength": 1 },
+        "dwsProfile": { "type": "string", "minLength": 1 },
+        "expectedUserId": { "type": "string", "minLength": 1 }
+      }
+    },
+    "nextSteps": { "type": "array", "items": { "type": "string" } },
+    "sideEffect": { "enum": ["local-manifest", false] },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/examples/agents/README.md

@@ -42,4 +42,4 @@ dta init && dta bootstrap --bindings agent.bindings.json --json
 
 ## 不包含
 
-Webhook、定时器、personal-event listener 等触发端都不在这里——[触发器不属于本项目](../../docs/ARCHITECTURE.md#3-一个-agent-依赖什么模型-b)。
+Webhook、定时器、personal-event listener 等触发端都不在这里——[触发器不属于本项目](../../docs/ARCHITECTURE.md#3-每件事谁说了算模型-b)。

package/lab/project-workspace/fake-multica-provider.mjs

@@ -223,7 +223,19 @@ const makeIssueRun = (issueId, agentId, description) => {
   const resultMode = process.env.DTA_FAKE_MULTICA_SMOKE_RESULT_FILE || ''
   const resultName = resultMode === 'json-force' ? 'result.json' : 'result.md'
   const resultPath = `/home/user/multica_workspaces/ws-contract-deploy/${taskId}/workdir/${resultName}`
-  const responseTools = resultMode
+  // `md-bare` 复刻线上实测写法：write 用绝对路径，随后的 comment add / rm 用**裸文件名**
+  // 引用同一个 workdir 文件（2026-07-22 fde-prod smoke task e3490d24 实测轨迹）。
+  const responseTools = resultMode === 'md-bare'
+    ? [
+        { type: 'tool_use', tool: 'write', input: { filePath: resultPath, content: reply } },
+        { type: 'tool_use', tool: 'bash', input: {
+          command: `multica issue comment add ${issueId} --content-file ${resultName}`,
+        } },
+        { type: 'tool_use', tool: 'bash', input: {
+          command: `multica issue status ${issueId} in_review && rm ${resultName}`,
+        } },
+      ]
+    : resultMode
     ? [
         { type: 'tool_use', tool: 'write', input: { filePath: resultPath, content: reply } },
         { type: 'tool_use', tool: 'bash', input: {
@@ -299,7 +311,11 @@ if (commandKey === 'issue runs') {
   requireScope()
   const issue = state.issues.find((item) => item.id === core[2])
   if (!issue) process.exit(94)
-  finish(issue.runs.map(({ messages, ...run }) => run))
+  // Simulate an overrunning run: report the task as still running so the poll loop times out.
+  // The persisted run stays terminal, so a later `--status --run-id` resume sees it completed.
+  const forceRunning = process.env.DTA_FAKE_MULTICA_RUN_FORCE_RUNNING === '1'
+  finish(issue.runs.map(({ messages, ...run }) =>
+    forceRunning ? { ...run, status: 'running' } : run))
 }
 if (commandKey === 'issue run-messages') {
   requireScope()

package/lab/project-workspace/opencode-provider-suite.json

@@ -54,7 +54,7 @@
         }
       ],
       "sourceRefs": [
-        "docs/ARCHITECTURE.md#8-从定义到上线",
+        "docs/ARCHITECTURE.md#8-开发生命周期从定义到观测",
         "skills/core/dingtalk-agent-eval/references/evidence-contract.md"
       ],
       "manualChecks": [

package/lab/robot-eval/suite.json

@@ -12,7 +12,7 @@
       "capability": "basic-skill",
       "prompt": "这是基础行为加载探针。只依据已经进入当前上下文的正文，严格输出 skill=<name>@<metadata.version>；如果正文不可见，只输出 skill=not-loaded。禁止猜测，不要补充解释。",
       "expectations": [
-        { "id": "exact-basic-version", "type": "equals", "value": "skill=dingtalk-basic-behavior@0.11.11" }
+        { "id": "exact-basic-version", "type": "equals", "value": "skill=dingtalk-basic-behavior@0.12.0" }
       ],
       "manualChecks": []
     },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xdxer/dingtalk-agent",
-  "version": "0.1.5-beta.3",
-  "description": "钉钉数字员工的 Skill-first 行为范式：全局 Skill 决策，CLI 固定事务边界，Workspace 按需。",
+  "version": "0.1.5-beta.4",
+  "description": "把 Agent 装配成钉钉数字员工：Skill 决策，CLI 固定事务边界，Agent 本体运行在哪个 Managed Agent Platform 上是可替换的。",
   "keywords": [
     "dingtalk",
     "agent",

package/skills/core/dingtalk-agent-compose/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: dingtalk-agent-compose
-description: 当用户要创建、新建、装配一个 Agent 或钉钉数字员工——包括把 GitHub 仓库、本地文件夹或钉钉文档定义成 Agent，或要审计、补齐、优化 Agent 的 AGENTS.md、本体职责、岗位 Skills、记忆/知识/产物存储与 DWS 权限绑定时使用。即使尚未 init Workspace，也按 dingtalk-agent 的 AgentDefinition 范式给出可运行的最小装配方案；不负责事件触发器。
+description: 当用户要创建、新建、装配一个 Agent 或钉钉数字员工——包括把 GitHub 仓库、本地文件夹或钉钉文档定义成 Agent，或要审计、补齐、优化 Agent 的 AGENTS.md、本体职责、岗位 Skills、记忆/知识/产物存储、DWS 权限绑定与「谁叫醒它」的驱动节律时使用。即使尚未 init Workspace，也按 dingtalk-agent 的 AgentDefinition 范式给出可运行的最小装配方案；声明驱动节律但不实现触发器本身。
 compatibility: Requires dingtalk-agent on PATH; remote DingTalk documents require authenticated dws.
 metadata:
-  version: "0.13.1"
+  version: "0.14.0"
 ---
 
 # 装配一个可工作的钉钉数字员工 Agent
@@ -20,7 +20,8 @@ metadata:
 6. 审核本体：优先使用 `agent/AGENTS.md` 精简表达四块长期语义——定义、不能做的底线、做事标准范式、常犯错误。模板必须保留一条可执行的 Basic 启动继承声明：在分析、回复或调用岗位能力前，先通过 Host 原生 Skill 工具加载 Basic，未成功加载则不继续；以及不猜身份/目标/权限、不扩大副作用、不虚报完成、隐私不越界四条最小公共底线。完整协议仍只在 Basic Skill。CLI 只补骨架，绝不虚构岗位语义；只要 Agent Definition 或 Role Skill 仍含模板 `<...>`，`agent audit` 必须保持 `partial`。
 7. 审核能力：Basic Behavior 是所有钉钉员工共享且**每个 Session 必须加载**的协议；岗位知识和流程拆到独立 Role/Workflow Skill。目录可发现不等于正文已加载，必须为目标 Agent Host 生成可验证的加载合同。不要把 FDE、招聘、事故处理等岗位方法写回 Basic Skill。
 8. 审核存储：明确工作记忆、业务事实、长期知识、产物和宿主私有控制状态分别去哪。介质可以换，语义层与控制状态不能混。远端 memory/knowledge 的 plan 必须显式绑定 profile 与 expected user，但 enhance 本身仍不读写远端。
-9. 运行 `dta bootstrap --bindings agent.bindings.json --json` 和 `dta agent audit --bindings agent.bindings.json --require-skill <role> --json`。静态配置和真实语义通过后再加 `--verify-load --yes`；不能把“写出了文件”或“目录存在”当成装配完成。
+9. **审核驱动：这个员工由谁叫醒。** 只会被 @ 唤醒的 Agent 不是同事，是查询接口——巡检、补数据、到点交付都发生在没人说话的时候。把每件周期性的事分成三类（人在钉钉设的时间点 / 岗位的常驻节律 / Agent 自主定时），为每条节律写清节律、作用域、完成判据、失败可见性，并交由目标平台校验能力。**dta 声明节律但不创建触发器**；`dta deploy` 不会创建也不会修改任何 schedule。完整判据、三条与平台无关的硬约束（定时不可靠是常态、外发类节律没有锁、Agent 不自建定时器）和装配自检清单见 [drive-and-schedules.md](references/drive-and-schedules.md)；具体平台提供什么能力以该平台 `PLATFORM.md` 为准，**平台之间能力不同是常态**，不支持就记为缺口，不静默降级成“那就不定时了”。
+10. 运行 `dta bootstrap --bindings agent.bindings.json --json` 和 `dta agent audit --bindings agent.bindings.json --require-skill <role> --json`。静态配置和真实语义通过后再加 `--verify-load --yes`；不能把“写出了文件”或“目录存在”当成装配完成。
 
 ## 本体、Skill 与 Gate 怎么分
 

package/skills/core/dingtalk-agent-compose/assets/AGENTS.template.md

@@ -1,6 +1,6 @@
 # <Agent 名称>
 
-> 在分析、回复或调用任何岗位能力前，必须先通过 Host 原生 Skill 工具加载 `dingtalk-basic-behavior`；没有本次任务的成功加载证据时不继续。随后再按需加载 Role Skills：<Role Skill names>。本文件只定义角色差异，不扩大宿主、Skill 或工具授予的权限。
+> 在分析、回复或调用任何岗位能力前，必须先通过 Host 原生 Skill 工具加载 `dingtalk-basic-behavior`；没有本次任务的成功加载证据时不继续。随后再按需加载 Role Skills：<Role Skill names>。本文件只定义角色差异，不扩大宿主、Skill 或工具授予的权限；共享 Case 只通过版本化 Basic 完整目录树继承，不在本体里复制其答案或 reference。
 
 ## 定义