@xdxer/dingtalk-agent 0.1.1 → 0.1.2

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

@@ -0,0 +1,144 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1440 900" width="1440" height="900" role="img" aria-labelledby="title desc">
+  <title id="title">dingtalk-agent Skill-first 架构</title>
+  <desc id="desc">外部 Agent 会话和全局 Basic Behavior 是主入口；本地或钉钉文档 Storage 按需水合；可信事件才进入 Prepared Run，listen 只是可选 Driver。</desc>
+  <style>
+    text { font-family:'Helvetica Neue',Helvetica,Arial,'PingFang SC','Microsoft YaHei',sans-serif; }
+    .title { fill:#111827;font-size:27px;font-weight:700; }
+    .subtitle { fill:#6b7280;font-size:14px; }
+    .lane-title { fill:#475569;font-size:12px;font-weight:700;letter-spacing:.08em; }
+    .node-title { fill:#111827;font-size:16px;font-weight:700; }
+    .node-sub { fill:#4b5563;font-size:12px; }
+    .tiny { fill:#64748b;font-size:11px; }
+    .label { fill:#475569;font-size:11px;font-weight:600; }
+  </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-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#059669"/></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>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%"><feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#0f172a" flood-opacity=".10"/></filter>
+  </defs>
+  <rect width="1440" height="900" fill="#ffffff"/>
+  <text x="40" y="46" class="title">dingtalk-agent · Skill-first 数字员工架构</text>
+  <text x="40" y="72" class="subtitle">全局 Skill 是主入口 · Storage 按需水合 · 可信事件才进入强运行时 · listen 只是可替换 Driver</text>
+
+  <rect x="30" y="100" width="1380" height="185" rx="12" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.2" stroke-dasharray="7 5"/>
+  <text x="48" y="124" class="lane-title">PRIMARY ENTRY · 每个 Agent 会话</text>
+
+  <rect x="60" y="150" width="190" height="88" rx="10" fill="#fff7ed" stroke="#fdba74" stroke-width="1.6" filter="url(#shadow)"/>
+  <text x="155" y="180" text-anchor="middle" class="node-title">钉钉事项 / 用户请求</text>
+  <text x="155" y="205" text-anchor="middle" class="node-sub">消息 · @ · 任务 · 确认</text>
+
+  <rect x="330" y="138" width="250" height="112" rx="12" fill="#eff6ff" stroke="#60a5fa" stroke-width="2.2" filter="url(#shadow)"/>
+  <rect x="334" y="142" width="242" height="104" rx="9" fill="none" stroke="#60a5fa" stroke-width=".8" opacity=".5"/>
+  <text x="455" y="174" text-anchor="middle" class="node-title">Claude Code / Codex</text>
+  <text x="455" y="198" text-anchor="middle" class="node-sub">外部 Agent Host</text>
+  <text x="455" y="220" text-anchor="middle" class="node-sub">模型 · 工具 · 当前 Session</text>
+
+  <rect x="660" y="125" width="270" height="70" rx="10" fill="#faf5ff" stroke="#c084fc" stroke-width="1.8" filter="url(#shadow)"/>
+  <text x="795" y="155" text-anchor="middle" class="node-title">全局 Basic Behavior</text>
+  <text x="795" y="178" text-anchor="middle" class="node-sub">何时说 / 问 / 静默 / 记忆</text>
+
+  <rect x="660" y="210" width="270" height="52" rx="9" fill="#f0fdf4" stroke="#4ade80" stroke-width="1.6"/>
+  <text x="795" y="240" text-anchor="middle" class="node-title">岗位 / Workflow Skill</text>
+
+  <rect x="1030" y="138" width="300" height="112" rx="10" fill="#f0fdfa" stroke="#2dd4bf" stroke-width="1.7" filter="url(#shadow)"/>
+  <text x="1180" y="170" text-anchor="middle" class="node-title">dingtalk-agent CLI</text>
+  <text x="1180" y="195" text-anchor="middle" class="node-sub">安装 · 水合 · 强行为边界</text>
+  <text x="1180" y="219" text-anchor="middle" class="node-sub">不内置模型 · 不复制 DWS</text>
+
+  <path d="M250 194 L330 194" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+  <path d="M660 160 L610 160 L610 176 L580 176" fill="none" stroke="#7c3aed" stroke-width="2" marker-end="url(#arrow-purple)"/>
+  <path d="M660 236 L610 236 L610 218 L580 218" fill="none" stroke="#7c3aed" stroke-width="2" marker-end="url(#arrow-purple)"/>
+  <path d="M580 194 L620 194 L620 272 L990 272 L990 194 L1030 194" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+  <rect x="762" y="259" width="88" height="21" rx="5" fill="#ffffff" opacity=".96"/>
+  <text x="806" y="274" text-anchor="middle" class="label">确定性能力</text>
+  <path d="M455 250 L455 305 L160 305 L160 390" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M1180 250 L1180 305 L910 305 L910 375" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+
+  <rect x="30" y="325" width="670" height="260" rx="12" fill="#f8fafc" stroke="#94a3b8" stroke-width="1.2" stroke-dasharray="7 5"/>
+  <text x="48" y="350" class="lane-title">CONTEXT · 无需 init 的按需水合</text>
+
+  <rect x="65" y="390" width="190" height="84" rx="10" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.6" filter="url(#shadow)"/>
+  <text x="160" y="422" text-anchor="middle" class="node-title">bootstrap</text>
+  <text x="160" y="447" text-anchor="middle" class="node-sub">发现 · probe · pull</text>
+
+  <rect x="330" y="375" width="280" height="78" rx="10" fill="#f0fdf4" stroke="#86efac" stroke-width="1.6" filter="url(#shadow)"/>
+  <text x="470" y="406" text-anchor="middle" class="node-title">Local Workspace</text>
+  <text x="470" y="431" text-anchor="middle" class="node-sub">local-dir · 直接挂载，不复制</text>
+
+  <rect x="330" y="475" width="280" height="78" rx="10" fill="#f0fdfa" stroke="#5eead4" stroke-width="1.6" filter="url(#shadow)"/>
+  <text x="470" y="506" text-anchor="middle" class="node-title">钉钉在线文档</text>
+  <text x="470" y="531" text-anchor="middle" class="node-sub">DWS probe → 只读 Markdown 快照</text>
+
+  <path d="M255 420 L330 414" fill="none" stroke="#059669" stroke-width="2" marker-end="url(#arrow-green)"/>
+  <path d="M255 444 L292 444 L292 514 L330 514" fill="none" stroke="#059669" stroke-width="2" marker-end="url(#arrow-green)"/>
+  <rect x="266" y="400" width="56" height="21" rx="5" fill="#ffffff" opacity=".96"/>
+  <text x="294" y="415" text-anchor="middle" class="label">read</text>
+  <rect x="266" y="489" width="56" height="21" rx="5" fill="#ffffff" opacity=".96"/>
+  <text x="294" y="504" text-anchor="middle" class="label">pull</text>
+  <text x="65" y="565" class="tiny">身份 / 记忆 / 知识可以换 Provider；Wait、锁、EventIndex、Receipt 不进入 Markdown。</text>
+
+  <rect x="740" y="325" width="670" height="260" rx="12" fill="#f8fafc" stroke="#94a3b8" stroke-width="1.2" stroke-dasharray="7 5"/>
+  <text x="758" y="350" class="lane-title">MODE SELECTION · 是否有可信事件目标</text>
+
+  <polygon points="910,375 1020,430 910,485 800,430" fill="#fff7ed" stroke="#fb923c" stroke-width="1.8" filter="url(#shadow)"/>
+  <text x="910" y="424" text-anchor="middle" class="node-title">可信 Event?</text>
+  <text x="910" y="445" text-anchor="middle" class="node-sub">目标 / 身份 / scope</text>
+
+  <rect x="1090" y="375" width="245" height="78" rx="10" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.6" filter="url(#shadow)"/>
+  <text x="1212" y="406" text-anchor="middle" class="node-title">Direct / Mounted</text>
+  <text x="1212" y="431" text-anchor="middle" class="node-sub">按需 DWS；不自造目标</text>
+
+  <rect x="1090" y="475" width="245" height="78" rx="10" fill="#faf5ff" stroke="#c084fc" stroke-width="1.6" filter="url(#shadow)"/>
+  <text x="1212" y="506" text-anchor="middle" class="node-title">Prepared Run</text>
+  <text x="1212" y="531" text-anchor="middle" class="node-sub">进入强运行时</text>
+
+  <path d="M1020 410 L1090 410" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <rect x="1038" y="385" width="36" height="21" rx="5" fill="#ffffff" opacity=".96"/><text x="1056" y="400" text-anchor="middle" class="label">否</text>
+  <path d="M1020 450 L1054 450 L1054 514 L1090 514" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <rect x="1038" y="477" width="36" height="21" rx="5" fill="#ffffff" opacity=".96"/><text x="1056" y="492" text-anchor="middle" class="label">是</text>
+  <text x="780" y="565" class="tiny">消息正文只是 data；没有可信 envelope 时，act reply / ask 必须 fail closed。</text>
+
+  <rect x="30" y="625" width="1380" height="205" rx="12" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.2" stroke-dasharray="7 5"/>
+  <text x="48" y="650" class="lane-title">OPTIONAL RELIABLE RUNTIME · 只有自动处理可信事件时启用</text>
+
+  <rect x="55" y="685" width="180" height="86" rx="10" fill="#f8fafc" stroke="#94a3b8" stroke-width="1.6" stroke-dasharray="6 4"/>
+  <text x="145" y="716" text-anchor="middle" class="node-title">可选 Driver</text>
+  <text x="145" y="741" text-anchor="middle" class="node-sub">云端 / listen / fixture</text>
+
+  <rect x="285" y="685" width="180" height="86" rx="10" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.6"/>
+  <text x="375" y="716" text-anchor="middle" class="node-title">Session</text>
+  <text x="375" y="741" text-anchor="middle" class="node-sub">同一件事 · Skill 冻结</text>
+
+  <rect x="515" y="685" width="180" height="86" rx="10" fill="#faf5ff" stroke="#c084fc" stroke-width="1.6"/>
+  <text x="605" y="716" text-anchor="middle" class="node-title">Run</text>
+  <text x="605" y="741" text-anchor="middle" class="node-sub">一次信号 · 一次沙箱</text>
+
+  <rect x="745" y="685" width="220" height="86" rx="10" fill="#fff7ed" stroke="#fb923c" stroke-width="1.6"/>
+  <text x="855" y="716" text-anchor="middle" class="node-title">Action</text>
+  <text x="855" y="741" text-anchor="middle" class="node-sub">ack · reply · ask · silence</text>
+
+  <rect x="1015" y="685" width="160" height="86" rx="10" fill="#fef2f2" stroke="#f87171" stroke-width="1.6"/>
+  <text x="1095" y="716" text-anchor="middle" class="node-title">Action Gate</text>
+  <text x="1095" y="741" text-anchor="middle" class="node-sub">目标 · 预算 · 幂等</text>
+
+  <rect x="1225" y="685" width="140" height="86" rx="10" fill="#f0fdfa" stroke="#2dd4bf" stroke-width="1.6"/>
+  <text x="1295" y="716" text-anchor="middle" class="node-title">DWS</text>
+  <text x="1295" y="741" text-anchor="middle" class="node-sub">执行 + 回读</text>
+
+  <path d="M235 728 L285 728" fill="none" stroke="#64748b" stroke-width="2" stroke-dasharray="5 4" marker-end="url(#arrow-gray)"/>
+  <path d="M465 728 L515 728" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M695 728 L745 728" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M965 728 L1015 728" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M1175 728 L1225 728" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M855 771 C855 810 375 810 375 771" fill="none" stroke="#7c3aed" stroke-width="1.8" stroke-dasharray="5 4" marker-end="url(#arrow-purple)"/>
+  <rect x="565" y="790" width="122" height="21" rx="5" fill="#ffffff" opacity=".96"/>
+  <text x="626" y="805" text-anchor="middle" class="label">ask 后事件恢复</text>
+
+  <text x="40" y="864" fill="#111827" font-size="13" font-weight="700">默认路径：global Skill → Agent Session → bootstrap（按需）｜强运行时：可信 Event → Session → Run → Action</text>
+  <line x1="40" y1="884" x2="74" y2="884" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/><text x="82" y="888" class="tiny">主处理流</text>
+  <line x1="190" y1="884" x2="224" y2="884" stroke="#059669" stroke-width="2" marker-end="url(#arrow-green)"/><text x="232" y="888" class="tiny">上下文读取</text>
+  <line x1="350" y1="884" x2="384" y2="884" stroke="#64748b" stroke-width="2" stroke-dasharray="5 4" marker-end="url(#arrow-gray)"/><text x="392" y="888" class="tiny">可选事件驱动</text>
+  <line x1="535" y1="884" x2="569" y2="884" stroke="#7c3aed" stroke-width="2" stroke-dasharray="5 4" marker-end="url(#arrow-purple)"/><text x="577" y="888" class="tiny">恢复 / Skill 注入</text>
+</svg>

package/docs/architecture/durable-async-agent-runtime.svg

@@ -0,0 +1,234 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 1080" width="1600" height="1080">
+  <style>
+    text { font-family: 'Helvetica Neue', Helvetica, Arial, 'PingFang SC', 'Microsoft YaHei', sans-serif; fill: #111827; }
+    .title { font-size: 28px; font-weight: 750; }
+    .subtitle { font-size: 14px; fill: #64748b; }
+    .lane { font-size: 12px; font-weight: 750; letter-spacing: .08em; }
+    .node-title { font-size: 14px; font-weight: 700; }
+    .node-sub { font-size: 11px; fill: #64748b; }
+    .small { font-size: 10px; fill: #64748b; }
+    .label { font-size: 11px; font-weight: 650; fill: #334155; }
+    .invariant { font-size: 12px; font-weight: 650; }
+    .footer { font-size: 11px; font-weight: 650; fill: #ffffff; }
+  </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-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#059669"/></marker>
+    <marker id="arrow-orange" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#ea580c"/></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-red" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#dc2626"/></marker>
+    <filter id="shadow" x="-12%" y="-12%" width="124%" height="136%"><feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#0f172a" flood-opacity="0.10"/></filter>
+  </defs>
+
+  <rect width="1600" height="1080" fill="#ffffff"/>
+  <text x="42" y="42" class="title">钉钉数字员工 · Durable Async Workflow 运行模型</text>
+  <text x="42" y="68" class="subtitle">消息只是信号：它可能恢复已有 await、启动新 workflow、触发强中断，或仅被观察。Session 跨多个一次性 Sandbox Run 持久存在。</text>
+
+  <!-- Event intake -->
+  <rect x="30" y="92" width="1540" height="215" rx="14" fill="#eff6ff" fill-opacity="0.48" stroke="#93c5fd" stroke-width="1.2" stroke-dasharray="7,4"/>
+  <text x="50" y="117" class="lane" fill="#1d4ed8">事件入口 · DURABLE INBOX BEFORE ACK</text>
+
+  <g filter="url(#shadow)">
+    <rect x="52" y="142" width="160" height="112" rx="10" fill="#ffffff" stroke="#bfdbfe" stroke-width="1.5"/>
+    <circle cx="83" cy="173" r="13" fill="#dbeafe" stroke="#2563eb"/>
+    <path d="M69 211 Q69 190 83 190 Q97 190 97 211" fill="#dbeafe" stroke="#2563eb"/>
+    <text x="140" y="172" text-anchor="middle" class="node-title">钉钉消息</text>
+    <text x="132" y="196" text-anchor="middle" class="node-sub">DM / @ / 群 / 回复</text>
+    <text x="132" y="217" text-anchor="middle" class="node-sub">actor · conv · reply_to</text>
+    <text x="132" y="238" text-anchor="middle" class="node-sub">event_id · message_id</text>
+
+    <rect x="52" y="266" width="160" height="26" rx="7" fill="#ffffff" stroke="#bfdbfe"/>
+    <text x="132" y="284" text-anchor="middle" class="small">表格 · 待办 · 审批 · Timer</text>
+
+    <rect x="260" y="142" width="205" height="112" rx="10" fill="#f0fdfa" stroke="#5eead4" stroke-width="1.6"/>
+    <text x="362" y="171" text-anchor="middle" class="node-title">Durable Event Ledger</text>
+    <text x="362" y="195" text-anchor="middle" class="node-sub">先持久化，再向上游确认</text>
+    <text x="362" y="216" text-anchor="middle" class="node-sub">event 去重 · 原始信封 · 来源证据</text>
+    <text x="362" y="237" text-anchor="middle" class="node-sub">at-least-once，不假设 exactly-once</text>
+
+    <rect x="520" y="136" width="260" height="124" rx="12" fill="#ffffff" stroke="#2563eb" stroke-width="2.2"/>
+    <text x="650" y="165" text-anchor="middle" class="node-title">Continuation Router</text>
+    <text x="650" y="188" text-anchor="middle" class="node-sub">按 await_id + event matcher 原子 claim</text>
+    <text x="650" y="209" text-anchor="middle" class="node-sub">校验 actor / subject / audience / ACL</text>
+    <text x="650" y="230" text-anchor="middle" class="node-sub">同一源码 await_point 可被执行多次</text>
+    <text x="650" y="247" text-anchor="middle" class="small">因此不能只用 (lambda_id, await_point)</text>
+  </g>
+
+  <path d="M212 198 H250" stroke="#2563eb" stroke-width="2.2" fill="none" marker-end="url(#arrow-blue)"/>
+  <path d="M465 198 H510" stroke="#2563eb" stroke-width="2.2" fill="none" marker-end="url(#arrow-blue)"/>
+
+  <!-- Router outcomes -->
+  <g>
+    <rect x="830" y="136" width="165" height="54" rx="8" fill="#ecfdf5" stroke="#6ee7b7"/>
+    <text x="912" y="158" text-anchor="middle" class="node-title">命中 Await</text>
+    <text x="912" y="178" text-anchor="middle" class="node-sub">恢复同一 Workflow</text>
+    <rect x="830" y="202" width="165" height="54" rx="8" fill="#fff7ed" stroke="#fdba74"/>
+    <text x="912" y="224" text-anchor="middle" class="node-title">无 Await + 可响应</text>
+    <text x="912" y="244" text-anchor="middle" class="node-sub">启动新 Workflow</text>
+    <rect x="1035" y="136" width="165" height="54" rx="8" fill="#fef2f2" stroke="#fca5a5"/>
+    <text x="1117" y="158" text-anchor="middle" class="node-title">Stop / Correction</text>
+    <text x="1117" y="178" text-anchor="middle" class="node-sub">撤销 lease + fencing</text>
+    <rect x="1035" y="202" width="165" height="54" rx="8" fill="#f8fafc" stroke="#cbd5e1"/>
+    <text x="1117" y="224" text-anchor="middle" class="node-title">不具响应资格</text>
+    <text x="1117" y="244" text-anchor="middle" class="node-sub">观察 / 记账 / silence</text>
+
+    <rect x="1248" y="136" width="280" height="120" rx="10" fill="#faf5ff" stroke="#c4b5fd" stroke-width="1.4"/>
+    <text x="1388" y="163" text-anchor="middle" class="node-title">Event Match 不是“猜上下文”</text>
+    <text x="1388" y="187" text-anchor="middle" class="node-sub">await_id · expected_actor · reply_to</text>
+    <text x="1388" y="208" text-anchor="middle" class="node-sub">resource_ref · deadline · cardinality</text>
+    <text x="1388" y="229" text-anchor="middle" class="node-sub">scope_version · continuation capability</text>
+    <text x="1388" y="247" text-anchor="middle" class="small">多重命中必须 fail closed / 仲裁</text>
+  </g>
+  <path d="M780 177 H820" stroke="#059669" stroke-width="2" fill="none" marker-end="url(#arrow-green)"/>
+  <path d="M780 218 H820" stroke="#ea580c" stroke-width="2" fill="none" marker-end="url(#arrow-orange)"/>
+  <path d="M780 159 H1025" stroke="#dc2626" stroke-width="1.7" fill="none" marker-end="url(#arrow-red)"/>
+  <path d="M780 239 H1025" stroke="#64748b" stroke-width="1.5" stroke-dasharray="5,3" fill="none"/>
+
+  <!-- Runtime lane -->
+  <rect x="30" y="330" width="1540" height="470" rx="14" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.2" stroke-dasharray="7,4"/>
+  <text x="50" y="356" class="lane" fill="#475569">DURABLE WORKFLOW KERNEL · 持久化的是显式状态，不是 JS/PYTHON/LLM 隐藏栈</text>
+
+  <!-- Context store -->
+  <g filter="url(#shadow)">
+    <rect x="52" y="382" width="410" height="335" rx="12" fill="#ffffff" stroke="#0d9488" stroke-width="1.8"/>
+    <text x="74" y="410" class="node-title">Context Store（WCB / PCB + 状态对象）</text>
+    <text x="74" y="430" class="node-sub">WorkflowInstance 是一个 durable coroutine；Session 可作为其产品名</text>
+
+    <rect x="72" y="452" width="176" height="92" rx="8" fill="#ecfdf5" stroke="#6ee7b7"/>
+    <text x="160" y="476" text-anchor="middle" class="node-title">Workflow Control Block</text>
+    <text x="160" y="497" text-anchor="middle" class="node-sub">state · lease · principal · budget</text>
+    <text x="160" y="517" text-anchor="middle" class="node-sub">definition/skill/policy snapshot</text>
+    <text x="160" y="536" text-anchor="middle" class="small">parent/child · retry · fencing token</text>
+
+    <rect x="266" y="452" width="176" height="92" rx="8" fill="#eff6ff" stroke="#93c5fd"/>
+    <text x="354" y="476" text-anchor="middle" class="node-title">Frames / Checkpoints</text>
+    <text x="354" y="497" text-anchor="middle" class="node-sub">program node · explicit locals</text>
+    <text x="354" y="517" text-anchor="middle" class="node-sub">draft refs · evidence refs</text>
+    <text x="354" y="536" text-anchor="middle" class="small">expected_version · compensation</text>
+
+    <rect x="72" y="562" width="176" height="92" rx="8" fill="#faf5ff" stroke="#c4b5fd"/>
+    <text x="160" y="586" text-anchor="middle" class="node-title">Continuation Graph</text>
+    <text x="160" y="607" text-anchor="middle" class="node-sub">AwaitSubscription / child links</text>
+    <text x="160" y="627" text-anchor="middle" class="node-sub">await_any · await_all · timeout</text>
+    <text x="160" y="646" text-anchor="middle" class="small">async DAG，不只是一条 Call Stack</text>
+
+    <rect x="266" y="562" width="176" height="92" rx="8" fill="#fff7ed" stroke="#fdba74"/>
+    <text x="354" y="586" text-anchor="middle" class="node-title">Effect Journal</text>
+    <text x="354" y="607" text-anchor="middle" class="node-sub">Intent · Attempt · Receipt</text>
+    <text x="354" y="627" text-anchor="middle" class="node-sub">idempotency key · readback</text>
+    <text x="354" y="646" text-anchor="middle" class="small">外部 I/O 不随 replay 重复</text>
+
+    <rect x="72" y="670" width="370" height="28" rx="7" fill="#f0fdfa" stroke="#99f6e4"/>
+    <text x="257" y="689" text-anchor="middle" class="label">Field Handles → People / Ontology / KB / Resource Registry / ACL</text>
+  </g>
+
+  <!-- Scheduler + sandbox -->
+  <g filter="url(#shadow)">
+    <rect x="520" y="407" width="190" height="104" rx="10" fill="#ecfdf5" stroke="#34d399" stroke-width="1.6"/>
+    <text x="615" y="435" text-anchor="middle" class="node-title">Workflow Scheduler</text>
+    <text x="615" y="458" text-anchor="middle" class="node-sub">claim · lease · priority · budget</text>
+    <text x="615" y="479" text-anchor="middle" class="node-sub">start / resume / cancel / retry</text>
+    <text x="615" y="499" text-anchor="middle" class="small">一次只调度一个执行 quantum</text>
+
+    <rect x="758" y="390" width="245" height="140" rx="12" fill="#ffffff" stroke="#7c3aed" stroke-width="2.5"/>
+    <rect x="764" y="396" width="233" height="128" rx="9" fill="none" stroke="#ddd6fe"/>
+    <text x="880" y="421" text-anchor="middle" class="node-title">Run / Ephemeral Sandbox</text>
+    <text x="880" y="446" text-anchor="middle" class="node-sub">恢复显式 frame，执行一个时间片</text>
+    <text x="880" y="468" text-anchor="middle" class="node-sub">模型只负责理解 / 规划 / 表达</text>
+    <text x="880" y="490" text-anchor="middle" class="node-sub">到 await / checkpoint / terminal 即退出</text>
+    <text x="880" y="513" text-anchor="middle" class="small">沙箱销毁；WorkflowInstance 仍存在</text>
+
+    <rect x="1048" y="407" width="210" height="104" rx="10" fill="#fff7ed" stroke="#fb923c" stroke-width="1.7"/>
+    <text x="1153" y="435" text-anchor="middle" class="node-title">Policy Gate / Broker</text>
+    <text x="1153" y="458" text-anchor="middle" class="node-sub">principal · target · capability</text>
+    <text x="1153" y="479" text-anchor="middle" class="node-sub">Intent-before-I/O · identity verify</text>
+    <text x="1153" y="499" text-anchor="middle" class="small">内核边界 / 系统调用网关</text>
+
+    <rect x="1306" y="407" width="215" height="104" rx="10" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.7"/>
+    <text x="1413" y="435" text-anchor="middle" class="node-title">DWS / 钉钉标准品</text>
+    <text x="1413" y="458" text-anchor="middle" class="node-sub">IM · 表格 · 文档 · 待办</text>
+    <text x="1413" y="479" text-anchor="middle" class="node-sub">日历 · 审批 · DING · 通讯录</text>
+    <text x="1413" y="499" text-anchor="middle" class="small">typed operation + external receipt</text>
+  </g>
+
+  <path d="M995 163 V321 H615 V397" stroke="#059669" stroke-width="2" fill="none" marker-end="url(#arrow-green)"/>
+  <text x="785" y="319" class="label">resume / spawn</text>
+  <path d="M1117 190 V370 H684 V397" stroke="#dc2626" stroke-width="1.8" fill="none" marker-end="url(#arrow-red)"/>
+  <text x="905" y="366" class="label" fill="#b91c1c">interrupt / fence</text>
+  <path d="M462 459 H510" stroke="#059669" stroke-width="2" fill="none" marker-end="url(#arrow-green)"/>
+  <path d="M710 459 H748" stroke="#2563eb" stroke-width="2.2" fill="none" marker-end="url(#arrow-blue)"/>
+  <path d="M1003 459 H1038" stroke="#ea580c" stroke-width="2.2" fill="none" marker-end="url(#arrow-orange)"/>
+  <path d="M1258 459 H1296" stroke="#ea580c" stroke-width="2.2" fill="none" marker-end="url(#arrow-orange)"/>
+  <path d="M1413 511 V550 H1153 V521" stroke="#7c3aed" stroke-width="1.8" fill="none" marker-end="url(#arrow-purple)"/>
+  <text x="1283" y="545" text-anchor="middle" class="label">Receipt / readback</text>
+  <path d="M1048 497 H1022 V695 H472" stroke="#7c3aed" stroke-width="1.8" fill="none" marker-end="url(#arrow-purple)"/>
+  <text x="757" y="690" text-anchor="middle" class="label">effect receipt + checkpoint</text>
+  <path d="M758 507 H730 V650 H472" stroke="#059669" stroke-width="1.8" stroke-dasharray="5,3" fill="none" marker-end="url(#arrow-green)"/>
+  <text x="614" y="644" text-anchor="middle" class="label">await / complete</text>
+
+  <!-- Primitive families -->
+  <rect x="520" y="580" width="1000" height="137" rx="10" fill="#ffffff" stroke="#d1d5db"/>
+  <text x="540" y="605" class="lane" fill="#475569">通用办公基础能力 · 四原语只是 SOCIAL API，不是全部“系统调用”</text>
+  <g>
+    <rect x="540" y="624" width="170" height="70" rx="8" fill="#eff6ff" stroke="#bfdbfe"/>
+    <text x="625" y="648" text-anchor="middle" class="node-title">Social</text>
+    <text x="625" y="669" text-anchor="middle" class="node-sub">ack · reply · ask · silence</text>
+    <text x="625" y="686" text-anchor="middle" class="small">+ progress（扩展）</text>
+    <rect x="730" y="624" width="180" height="70" rx="8" fill="#ecfdf5" stroke="#a7f3d0"/>
+    <text x="820" y="648" text-anchor="middle" class="node-title">Process</text>
+    <text x="820" y="669" text-anchor="middle" class="node-sub">spawn · await · join · cancel</text>
+    <text x="820" y="686" text-anchor="middle" class="small">checkpoint · timeout · compensate</text>
+    <rect x="930" y="624" width="180" height="70" rx="8" fill="#fff7ed" stroke="#fed7aa"/>
+    <text x="1020" y="648" text-anchor="middle" class="node-title">Workspace Effects</text>
+    <text x="1020" y="669" text-anchor="middle" class="node-sub">read/query · write/upsert</text>
+    <text x="1020" y="686" text-anchor="middle" class="small">task · calendar · approval · IM</text>
+    <rect x="1130" y="624" width="180" height="70" rx="8" fill="#faf5ff" stroke="#ddd6fe"/>
+    <text x="1220" y="648" text-anchor="middle" class="node-title">Context</text>
+    <text x="1220" y="669" text-anchor="middle" class="node-sub">heap handle · provenance · TTL</text>
+    <text x="1220" y="686" text-anchor="middle" class="small">subject memory · resource registry</text>
+    <rect x="1330" y="624" width="170" height="70" rx="8" fill="#fef2f2" stroke="#fecaca"/>
+    <text x="1415" y="648" text-anchor="middle" class="node-title">Trust &amp; Learning</text>
+    <text x="1415" y="669" text-anchor="middle" class="node-sub">authority · receipt · audit</text>
+    <text x="1415" y="686" text-anchor="middle" class="small">feedback → candidate → gate</text>
+  </g>
+
+  <!-- FDE instance / incident mapping -->
+  <rect x="30" y="825" width="1540" height="207" rx="14" fill="#faf5ff" fill-opacity="0.48" stroke="#c4b5fd" stroke-width="1.2"/>
+  <text x="50" y="851" class="lane" fill="#6d28d9">FDE 教练实例 · 同一个点评事项跨 4 个 RUN 恢复</text>
+
+  <g>
+    <rect x="52" y="875" width="235" height="79" rx="9" fill="#ffffff" stroke="#c4b5fd"/>
+    <text x="169" y="899" text-anchor="middle" class="node-title">Run #1 · 日报事件</text>
+    <text x="169" y="920" text-anchor="middle" class="node-sub">验证学生/Field → durable ack</text>
+    <text x="169" y="940" text-anchor="middle" class="node-sub">创建 workflow_instance + draft task</text>
+    <rect x="330" y="875" width="235" height="79" rx="9" fill="#ffffff" stroke="#c4b5fd"/>
+    <text x="447" y="899" text-anchor="middle" class="node-title">Run #2 · 形成草稿</text>
+    <text x="447" y="920" text-anchor="middle" class="node-sub">读日报/主管点评 → ask 预览</text>
+    <text x="447" y="940" text-anchor="middle" class="node-sub">原子登记 await(student, reply_to)</text>
+    <rect x="608" y="875" width="235" height="79" rx="9" fill="#ffffff" stroke="#c4b5fd"/>
+    <text x="725" y="899" text-anchor="middle" class="node-title">Run #3 · 学生纠正</text>
+    <text x="725" y="920" text-anchor="middle" class="node-sub">命中原 await → draft_v2</text>
+    <text x="725" y="940" text-anchor="middle" class="node-sub">保留 v1 + 纠正来源 → 再确认</text>
+    <rect x="886" y="875" width="235" height="79" rx="9" fill="#ffffff" stroke="#c4b5fd"/>
+    <text x="1003" y="899" text-anchor="middle" class="node-title">Run #4 · 确认发布</text>
+    <text x="1003" y="920" text-anchor="middle" class="node-sub">重新校验身份/目标/版本</text>
+    <text x="1003" y="940" text-anchor="middle" class="node-sub">幂等 publish → Receipt → complete</text>
+  </g>
+  <path d="M287 914 H320" stroke="#7c3aed" stroke-width="1.8" fill="none" marker-end="url(#arrow-purple)"/>
+  <path d="M565 914 H598" stroke="#7c3aed" stroke-width="1.8" fill="none" marker-end="url(#arrow-purple)"/>
+  <path d="M843 914 H876" stroke="#7c3aed" stroke-width="1.8" fill="none" marker-end="url(#arrow-purple)"/>
+  <text x="447" y="972" text-anchor="middle" class="small">沙箱休眠 ≠ 进程挂起：每个 Run 都可来自全新的 sandbox</text>
+
+  <g>
+    <rect x="1165" y="871" width="365" height="113" rx="9" fill="#fff7ed" stroke="#fdba74"/>
+    <text x="1185" y="896" class="node-title">历史事故 → 内核兜底</text>
+    <text x="1185" y="918" class="node-sub">13 个事件丢失 → Inbox 落盘后才 ACK</text>
+    <text x="1185" y="938" class="node-sub">纠正后继续 → host cancel + fencing token</text>
+    <text x="1185" y="958" class="node-sub">重复群推送 → Effect Journal + stable idempotency</text>
+    <text x="1185" y="978" class="node-sub">300s/超时重启 → checkpoint 后换新 Run 续做</text>
+  </g>
+
+  <!-- Invariants footer -->
+  <rect x="30" y="1047" width="1540" height="22" rx="6" fill="#0f172a"/>
+  <text x="800" y="1063" text-anchor="middle" class="footer">不保存模型隐性推理 · 不热替换运行中 Skill · 不以模型自述作为完成证据 · 所有跨系统副作用必须 Receipt/readback</text>
+</svg>

package/docs//345/206/205/347/275/221/345/256/236/347/233/270.md

@@ -0,0 +1,77 @@
+<!-- ⚠️ 内网文档 —— 不进 npm 包（package.json 的 files 不含 docs/）。
+     里面是 dws 的命令面和钉钉 API 的内部缺陷清单。**不要外发。** -->
+
+# 钉钉：怎么操作它
+
+## 行动界面（`dws` 的 20 个服务）
+
+| | |
+|---|---|
+| **doc** 文档 · **sheet** 表格 · **aitable** AI表格 · **drive** 钉盘 · **wiki** 知识库 | 东西放哪 |
+| **chat** 群聊消息机器人 · **ding** DING · **mail** 邮箱 | 怎么说话 |
+| **todo** 待办 · **calendar** 日历 · **agoal** 目标 · **oa** 审批 | 怎么协作 |
+| **contact** 通讯录 · **attendance** 考勤 | 组织与人 |
+| **minutes** AI听记 · **aisearch** AI搜问 · **report** 日志 · **live** 直播 | 其它 |
+
+**用前先 `dws <服务> --help`。命令和 flag 以 `--help` 和真实返回为准，不要凭记忆敲。**
+
+## ★ 读写实相（每一条都是血换的，违反必【静默】出错）
+
+### 三个层级，各藏各的
+
+```
+aitable record query  →  记录在 data 里     {"data":{"records":[…]}}
+doc read              →  markdown 在 顶层   {"markdown":"…"}
+todo task list        →  东西在 result 里   {"result":{"todoCards":[…],"hasMore":true}}
+```
+
+**读错层级 → 拿到 `undefined` → 当成"是空的" → 一整天的数据可以这么无声丢掉。**
+**拿不到必须响亮地死，绝不当成"表是空的"。**
+
+> 这个坑连写这份文档的人都栽过。所以：**所有对钉钉的调用走 CLI，不要自己 spawn dws。**
+
+### 分页会静默截断
+
+- `aitable record query --all` **必须**配 `--page-limit 0`（默认 50 页 ≈ 5000 条静默截断）。
+- **`hasMore` 只在 `todo task list --size ≤ 20` 时存在。** size 一超过 20，
+  `hasMore`/`page`/`size` **三个键整个消失** → 你拿到 `undefined` → 当成 `false` → **静默截断**。
+  实测 `--size 100` 拿回 100 条，真实总数 **109** —— **吃掉 9 条**。
+  **`undefined` 不是「没有下一页」，是「没有信号」。**
+  → 用 `dingtalk-agent todo`（帮你翻页了）。
+
+### 创建类：报错但其实建成功了
+
+`doc create` / `doc upload` 实测：**返回 error 信封，文档却真的建出来了。**
+- **绝不看返回信封** —— 按名回查 + 内容回读定成败。
+- **创建类永不盲重试**（会造重复件）。失败先按幂等键回查。
+
+### 写操作报错 ≠ 失败
+
+**回读实态才定成败。** `success:true` 也不算验收。
+
+### AI 表格的字段
+
+| | 写 | 读回 |
+|---|---|---|
+| 单选 | 字符串 `"日"` | **`{id,name}` 对象** |
+| 数字 | `int/float` | **字符串** `"0.812"` |
+| 日期 | `"YYYY-MM-DD"`（写 epoch 毫秒会存成 1788 年垃圾） | ISO 全串 |
+
+- **过滤日期用 epoch 毫秒 + `not_before`/`not_after`。`eq` 对 date 字段永远 0 行。**
+- 载荷键是 **`cells`**，不是 `fields`。
+- `table create` 单次最多落 **15 个字段**，多的**静默丢弃** → 建完必回读补齐。
+- 中文选项名**可以**做 eq 过滤。
+
+### markdown 会被重排版
+
+钉钉会重写：表格分隔线补齐 · 加粗与行内代码嵌套重写 · 段落合并 · 双重转义 `&amp;#95;`。
+
+- **重排版不是漂移。** 比对必须**剥掉 markdown 符号只看文字流**。
+- **标题里的行内代码会被整个吞掉**（`### 用 \`x\`` → `### 用 `）。行内代码一律挪出标题。
+- 表格单元格里的裸 `|` 会截断内容（用 `·`）。
+
+### 其它
+
+- **文档空间 ≠ 钉盘空间**，两套不互通。AI 表格是在线实体，不是文件。
+- `dws` 命令的**续行反斜杠中间不能插注释**（bash 会吃掉后半条）。
+- **`dws` 带代理正常。** 别一刀切 `unset proxy`（会打断别的需要代理的 CLI）。

package/evals/baselines/2026-07-14/behavior-summary.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "kind": "claude-shadow-baseline",
+  "date": "2026-07-14",
+  "suite": [101, 102, 103],
+  "runsPerConfiguration": 1,
+  "modelSelection": {
+    "pinned": false,
+    "observed": ["claude-opus-4-8"]
+  },
+  "withSkill": {
+    "passRateMean": 1,
+    "timeSecondsMean": 20.8613,
+    "tokensMean": 9528.6667
+  },
+  "withoutSkill": {
+    "passRateMean": 1,
+    "timeSecondsMean": 20.693,
+    "tokensMean": 7591.3333
+  },
+  "delta": {
+    "passRate": 0,
+    "timeSeconds": 0.1683,
+    "tokens": 1937.3333
+  },
+  "interpretation": "三个简单场景只验证了 runner 与动作合同，两种配置均通过；不能据此证明 Skill 有增益。样本仅一次，不能用于显著性判断。",
+  "rawEvidenceLocalPath": "evals/results/behavior-iteration-001/benchmark.json"
+}

package/evals/baselines/2026-07-14/contract-summary.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": 1,
+  "kind": "deterministic-contract-baseline",
+  "date": "2026-07-14",
+  "evals": 10,
+  "passRate": 1,
+  "externalWrites": 0,
+  "coverage": [
+    "mentioned 与 ambient group 行为",
+    "durable inbox/outbox 与 dispatch ack",
+    "事件重复投递",
+    "reply-target 与 Skill 快照防篡改",
+    "DWS 字符串 data 解析",
+    "tenant/causal Session 隔离",
+    "单一 egress owner",
+    "稳定 heartbeat duty 与唯一 occurrence"
+  ]
+}

package/evals/baselines/2026-07-14/live-canary-summary.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "kind": "robot-connect-live-canary",
+  "date": "2026-07-14",
+  "botName": "DTA蓝本实验员",
+  "marker": "DTA-EVAL-NEWBOT-01",
+  "syntheticInput": "7 + 5 等于多少？请直接回答。",
+  "actualReply": "7 + 5 等于 12。",
+  "latencySeconds": 4,
+  "platformReadbackMatched": true,
+  "connectorStopped": true,
+  "finalConnectorState": "not_running",
+  "proves": [
+    "专用机器人到隔离 workspace 的连接成立",
+    "Claude Code 能处理消息并由 connector 回发",
+    "DWS 可以从平台独立回读请求与回复"
+  ],
+  "doesNotProve": [
+    "结构化事件信封与 Session 路由",
+    "reply-target 防篡改",
+    "typed Action 与 Receipt",
+    "messageId 级幂等",
+    "personal-event 完整链路"
+  ]
+}