agentworkshop 0.7.48 → 0.7.49

package/scripts/_aw0748-failclosed-probe.mjs

@@ -1,90 +1,117 @@
-/**
- * 0.7.48 打包系统验收 · 硬约束失败关闭探针(无需 LLM,秒级)
- * 场景:同一份真实快照 + 同一组候选,只改 constraints[].id
- *   ① id = weight(可映射)→ 试验正常给出约束结论
- *   ② id = part_weight(不可映射)→ 必须**判不通过**并给出"无法映射"明细(v0.7.47 会假通过)
- * 用法:AW_BASE=http://127.0.0.1:3001 [AW_HOME=<home>] node scripts/_aw0748-failclosed-probe.mjs
- */
-import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs'
-
-const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
-const HOME = process.env.AW_HOME ?? `${process.cwd()}/.aw0746-home`
-const ADMIN = { email: process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local', password: process.env.AW_ADMIN_PASSWORD ?? 'Awshop@123!' }
-
-let pass = 0
-const fails = []
-const check = (name, ok, detail = '') => {
-  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
-  if (ok) pass += 1
-  else fails.push(name)
-}
-const j = async (method, path, body, token) => {
-  const r = await fetch(BASE + path, {
-    method,
-    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
-    body: body === undefined ? undefined : JSON.stringify(body),
-    signal: AbortSignal.timeout(120_000),
-  })
-  return { status: r.status, ...(await r.json().catch(() => ({}))) }
-}
-const firstJson = (text) => {
-  const a = text.indexOf('{')
-  const b = text.lastIndexOf('}')
-  return a >= 0 && b > a ? JSON.parse(text.slice(a, b + 1)) : null
-}
-
-const token = (await j('POST', '/api/users/login', ADMIN)).data?.token
-console.log(`\n═══ 0.7.48 硬约束失败关闭探针 @ ${BASE} ═══`)
-
-// 复用最近一次真实快照(阶段 7 / 阶段 5 产物)
-const snapRoot = `${HOME}/aml/twins/snapshots`
-const dirs = existsSync(snapRoot)
-  ? readdirSync(snapRoot).map(d => ({ d, m: statSync(`${snapRoot}/${d}`).mtimeMs })).sort((a, b) => b.m - a.m)
-  : []
-check('存在真实 TwinSnapshot 工件(取最新)', dirs.length > 0, dirs[0]?.d ?? '(无)')
-if (!dirs.length) {
-  console.log('\n★ 无可复用快照,先跑阶段 7/5 生成')
-  process.exit(2)
-}
-const snapshot = JSON.parse(readFileSync(`${snapRoot}/${dirs[0].d}/snapshots.json`, 'utf8'))
-check('快照新鲜且水位>0(可直接跑试验)', snapshot.dataQuality?.fresh === true && Number(snapshot.daqWatermark) > 0, `fresh=${snapshot.dataQuality?.fresh} watermark=${snapshot.daqWatermark}`)
-
-const chans = (await j('GET', '/api/workshop/channels', undefined, token)).data ?? []
-const twin = chans.find(c => /闭环优化-hybridtwin/.test(c.name))
-const members = (await j('GET', `/api/workshop/channels/${twin.id}/agents`, undefined, token)).data ?? []
-const lead = members.find(m => m.role === 'lead')
-const invoke = async (tool, args) => (await j('POST', '/api/workshop/agent-tools/invoke', { agentId: lead.id, tool, args }, token)).data?.result ?? {}
-
-const baseScene = firstJson(String((await invoke('twin_scene_read', {})).text ?? ''))
-const controls = { hold_pressure: 65, hold_time: 8, melt_temperature_setpoint: 247 }
-const objective = { schemaVersion: 1, createdAt: new Date().toISOString(), createdBy: lead.id, objectiveId: 'weight-quality', targets: { weight: 32.5 }, weights: { weight: 1 }, controlCosts: {}, horizonSteps: 1, trustRegion: {} }
-const trialOf = async (scene) => {
-  const res = await invoke('twin_trial_run', { scene_json: scene, snapshot_json: snapshot, baseline_controls: controls, candidate_controls: [{ ...controls, hold_pressure: 67 }], objective })
-  const text = String(res.text ?? '')
-  const id = (text.match(/trial_id:\s*(\S+)/) ?? [])[1]
-  const artifact = id ? JSON.parse(readFileSync(`${HOME}/aml/twins/trials/${id}/trials.json`, 'utf8')) : null
-  return { text, trial: artifact?.trial ?? null }
-}
-
-// ① 可映射 id:baseline 预测克重 32.5 g 落在 31~34 内 → 应通过
-const mapped = { ...baseScene, lineId: snapshot.lineId, productId: snapshot.productId, recipeId: snapshot.recipeId, constraints: [{ id: 'weight', kind: 'hard_range', min: 31, max: 34 }] }
-const okTrial = await trialOf(mapped)
-const okWeight = okTrial.trial?.constraintResults?.[0]
-check('可映射约束 id(weight)正常评估', Boolean(okTrial.trial) && okWeight?.id === 'weight' && okWeight.passed === true, `weight=${okTrial.trial?.predictedTrajectory?.[0]?.weight?.toFixed?.(3)} detail=${okWeight?.detail}`)
-
-// ② 不可映射 id:必须失败关闭(旧版本这里会返回"全轨迹通过")
-const unmapped = { ...mapped, constraints: [{ id: 'part_weight', kind: 'hard_range', min: 31, max: 34 }] }
-const badTrial = await trialOf(unmapped)
-const badCon = badTrial.trial?.constraintResults?.[0]
-const allPassed = (badTrial.trial?.constraintResults ?? []).every(c => c.passed)
-check('不可映射约束 id 判为不通过(失败关闭)', Boolean(badTrial.trial) && badCon?.passed === false && /无法映射/.test(String(badCon?.detail)), `passed=${badCon?.passed} detail=${String(badCon?.detail).slice(0, 80)}`)
-check('候选不再被当作安全(constraints_passed=false)', allPassed === false, `constraints_passed=${allPassed}`)
-check('工具文本同步反映未通过', /constraints_passed:\s*false/.test(badTrial.text), (badTrial.text.match(/constraints_passed:.*/) ?? [''])[0])
-
-// ③ 空轨迹(候选为空)同样失败关闭
-const empty = await invoke('twin_trial_run', { scene_json: mapped, snapshot_json: snapshot, baseline_controls: controls, candidate_controls: [], objective })
-const emptyTrialId = (String(empty.text ?? '').match(/trial_id:\s*(\S+)/) ?? [])[1]
-const emptyTrial = emptyTrialId ? JSON.parse(readFileSync(`${HOME}/aml/twins/trials/${emptyTrialId}/trials.json`, 'utf8')).trial : null
-check('空轨迹判为不通过(不再默认通过)', emptyTrial ? emptyTrial.constraintResults.every(c => c.passed === false) : false, `details=${(emptyTrial?.constraintResults ?? []).map(c => c.detail).join(' | ').slice(0, 80)}`)
-
-console.log(`\n★ 0.7.48 探针:${pass} 通过 / ${fails.length} 失败${fails.length ? ` (${fails.join('; ')})` : ''}`)
+/**
+ * 0.7.48 打包系统验收 · 硬约束失败关闭探针(无需 LLM,秒级)
+ * 场景:同一份真实快照 + 同一组候选,只改 constraints[].id
+ *   ① id = weight(可映射)→ 试验正常给出约束结论
+ *   ② id = part_weight(不可映射)→ 必须**判不通过**并给出"无法映射"明细(v0.7.47 会假通过)
+ * 用法:AW_BASE=http://127.0.0.1:3001 [AW_HOME=<home>] node scripts/_aw0748-failclosed-probe.mjs
+ */
+import { readFileSync } from 'node:fs'
+
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
+const HOME = process.env.AW_HOME ?? `${process.cwd()}/.aw0746-home`
+const ADMIN = { email: process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local', password: process.env.AW_ADMIN_PASSWORD ?? 'Awshop@123!' }
+
+let pass = 0
+const fails = []
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) pass += 1
+  else fails.push(name)
+}
+const j = async (method, path, body, token) => {
+  const r = await fetch(BASE + path, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+    signal: AbortSignal.timeout(120_000),
+  })
+  return { status: r.status, ...(await r.json().catch(() => ({}))) }
+}
+const token = (await j('POST', '/api/users/login', ADMIN)).data?.token
+console.log(`\n═══ 0.7.48 硬约束失败关闭探针 @ ${BASE} ═══`)
+
+const chans = (await j('GET', '/api/workshop/channels', undefined, token)).data ?? []
+const twin = chans.find(c => /闭环优化-hybridtwin/.test(c.name))
+const members = (await j('GET', `/api/workshop/channels/${twin.id}/agents`, undefined, token)).data ?? []
+const lead = members.find(m => m.role === 'lead')
+const invoke = async (tool, args) => (await j('POST', '/api/workshop/agent-tools/invoke', { agentId: lead.id, tool, args }, token)).data?.result ?? {}
+const firstJson = (text) => {
+  const a = text.indexOf('{')
+  const b = text.lastIndexOf('}')
+  return a >= 0 && b > a ? JSON.parse(text.slice(a, b + 1)) : null
+}
+
+// 快照必须"真新鲜":VirtualTrial 只认 60s 内的水位 → 先开跑采样,再用 auto_daq 让服务端按绑定取样
+const dcw = (await j('GET', '/api/workshop/dcw', undefined, token)).data
+const line = (dcw.lines ?? []).find(l => /injection-aw0746/i.test(String(l.name)))
+const product = (dcw.products ?? []).find(p => p.lineId === line.id)
+const recipe = (dcw.recipes ?? []).find(r => r.lineId === line.id)
+await j('POST', `/api/workshop/dcw/lines/${line.id}/stop`, {}, token)
+await new Promise(r => setTimeout(r, 2500))
+const st = await j('POST', `/api/workshop/dcw/lines/${line.id}/start`, { recipeId: recipe.id }, token)
+console.log(`  · 开跑采样:start status=${st.status} ${st.code ?? ''}`)
+await new Promise(r => setTimeout(r, 8000))
+
+const daq = (await j('GET', '/api/workshop/daq', undefined, token)).data
+const daqNodes = (daq.nodes ?? []).filter(n => n.lineId === line.id)
+const byName = re => daqNodes.find(n => re.test(n.name))
+const baseScene = firstJson(String((await invoke('twin_scene_read', {})).text ?? ''))
+const scene = {
+  ...baseScene,
+  lineId: line.id,
+  productId: product.id,
+  recipeId: recipe.id,
+  observations: baseScene.observations.map(o => ({ ...o, nodeId: byName({ weight: /part-weight/, flash_rate: /flash-rate/, sink_rate: /sink-mark/ }[o.id])?.id })),
+  states: baseScene.states.map(s => ({ ...s, nodeId: byName({ melt_temperature: /melt-temp-pv/, cavity_pressure: /melt-pressure-pv/ }[s.id])?.id })),
+}
+// auto_daq 走 Agent 的真实 DAQ 绑定:探针必须自备绑定(模板实例化不自带)
+const requiredNodeIds = [...scene.observations, ...scene.states].map(o => o.nodeId).filter(Boolean)
+let bound = 0
+for (const m of members) {
+  for (const nodeId of requiredNodeIds) {
+    const r = await j('POST', '/api/workshop/agent-tools/bindings', { agentId: m.id, nodeId, kind: 'daq', mode: 'auto' }, token)
+    if (r.code === 0) bound += 1
+  }
+}
+check('探针自备 DAQ 绑定(auto_daq 前置)', bound >= members.length * requiredNodeIds.length, `bound=${bound} members=${members.length} nodes=${requiredNodeIds.length}`)
+const snapRes = await invoke('twin_snapshot_create', { scene_json: scene, channel_id: twin.id, phase: 'holding', controls: { hold_pressure: 65, hold_time: 8, melt_temperature_setpoint: 247 }, auto_daq: true, freshness_max_ms: 300_000 })
+const snapText = String(snapRes.text ?? '')
+const snapshotId = (snapText.match(/snapshot_id:\s*(\S+)/) ?? [])[1]
+const snapshot = snapshotId ? JSON.parse(readFileSync(`${HOME}/aml/twins/snapshots/${snapshotId}/snapshots.json`, 'utf8')) : null
+check('真实快照生成(auto_daq 按绑定取样)', Boolean(snapshot) && snapshot.dataQuality?.fresh === true && Number(snapshot.daqWatermark) > 0, snapshot ? `${snapshotId} fresh=${snapshot.dataQuality?.fresh} stale=${(snapshot?.dataQuality?.staleNodeIds ?? []).length}` : snapText.slice(0, 160))
+if (!snapshot) {
+  console.log(`\n★ 0.7.48 探针:${pass} 通过 / ${fails.length} 失败(无法建快照,后续断言无意义)`)
+  process.exit(2)
+}
+const controls = { hold_pressure: 65, hold_time: 8, melt_temperature_setpoint: 247 }
+const objective = { schemaVersion: 1, createdAt: new Date().toISOString(), createdBy: lead.id, objectiveId: 'weight-quality', targets: { weight: 32.5 }, weights: { weight: 1 }, controlCosts: {}, horizonSteps: 1, trustRegion: {} }
+const trialOf = async (scene) => {
+  const res = await invoke('twin_trial_run', { scene_json: scene, snapshot_json: snapshot, baseline_controls: controls, candidate_controls: [{ ...controls, hold_pressure: 67 }], objective })
+  const text = String(res.text ?? '')
+  const id = (text.match(/trial_id:\s*(\S+)/) ?? [])[1]
+  const artifact = id ? JSON.parse(readFileSync(`${HOME}/aml/twins/trials/${id}/trials.json`, 'utf8')) : null
+  return { text, trial: artifact?.trial ?? null }
+}
+
+// ① 可映射 id:baseline 预测克重 32.5 g 落在 31~34 内 → 应通过
+const mapped = { ...scene, constraints: [{ id: 'weight', kind: 'hard_range', min: 31, max: 34 }] }
+const okTrial = await trialOf(mapped)
+const okWeight = okTrial.trial?.constraintResults?.[0]
+check('可映射约束 id(weight)正常评估', Boolean(okTrial.trial) && okWeight?.id === 'weight' && okWeight.passed === true, `weight=${okTrial.trial?.predictedTrajectory?.[0]?.weight?.toFixed?.(3)} detail=${okWeight?.detail}`)
+
+// ② 不可映射 id:必须失败关闭(旧版本这里会返回"全轨迹通过")
+const unmapped = { ...mapped, constraints: [{ id: 'part_weight', kind: 'hard_range', min: 31, max: 34 }] }
+const badTrial = await trialOf(unmapped)
+const badCon = badTrial.trial?.constraintResults?.[0]
+const allPassed = (badTrial.trial?.constraintResults ?? []).every(c => c.passed)
+check('不可映射约束 id 判为不通过(失败关闭)', Boolean(badTrial.trial) && badCon?.passed === false && /无法映射/.test(String(badCon?.detail)), `passed=${badCon?.passed} detail=${String(badCon?.detail).slice(0, 80)}`)
+check('候选不再被当作安全(constraints_passed=false)', allPassed === false, `constraints_passed=${allPassed}`)
+check('工具文本同步反映未通过', /constraints_passed:\s*false/.test(badTrial.text), (badTrial.text.match(/constraints_passed:.*/) ?? [''])[0])
+
+// ③ 空轨迹(候选为空)同样失败关闭
+const empty = await invoke('twin_trial_run', { scene_json: mapped, snapshot_json: snapshot, baseline_controls: controls, candidate_controls: [], objective })
+const emptyTrialId = (String(empty.text ?? '').match(/trial_id:\s*(\S+)/) ?? [])[1]
+const emptyTrial = emptyTrialId ? JSON.parse(readFileSync(`${HOME}/aml/twins/trials/${emptyTrialId}/trials.json`, 'utf8')).trial : null
+check('空轨迹判为不通过(不再默认通过)', emptyTrial ? emptyTrial.constraintResults.every(c => c.passed === false) : false, `details=${(emptyTrial?.constraintResults ?? []).map(c => c.detail).join(' | ').slice(0, 80)}`)
+
+console.log(`\n★ 0.7.48 探针:${pass} 通过 / ${fails.length} 失败${fails.length ? ` (${fails.join('; ')})` : ''}`)

package/scripts/_aw0748-fresh-channel.mjs

@@ -0,0 +1,21 @@
+/** 临时:实例化全新的 hybrid_twin Channel 用于闭环验收(避开历史队列),输出 channelId */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
+const ADMIN = { email: process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local', password: process.env.AW_ADMIN_PASSWORD ?? 'Awshop@123!' }
+const j = async (method, path, body, token) => {
+  const r = await fetch(BASE + path, { method, headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) }, body: body === undefined ? undefined : JSON.stringify(body) })
+  return { status: r.status, ...(await r.json().catch(() => ({}))) }
+}
+const token = (await j('POST', '/api/users/login', ADMIN)).data?.token
+const tpls = (await j('GET', '/api/workshop/channel-templates', undefined, token)).data ?? []
+const tpl = tpls.find(x => x.id === 'chtpl-hybrid-twin-mpc-default')
+if (!tpl) throw new Error('hybrid 模板缺失')
+const inst = await j('POST', `/api/workshop/channel-templates/${tpl.id}/instantiate`, {
+  name: `闭环优化-hybridtwin-verify-${Date.now().toString(36).slice(-4)}`,
+  toolProfile: 'hybrid_twin',
+  scene: { sceneId: 'injection-hold-control', sceneVersion: '1.0.0', lineId: 'line-injection-01', productId: 'product-injection-a', recipeId: 'recipe-injection-a' },
+  objective: { objectiveId: 'weight-quality', targets: { weight: 32.5 } },
+  controlPolicy: 'recommendation_only',
+}, token)
+const channelId = inst.data?.channelId ?? inst.data?.id
+if (!channelId) throw new Error(`实例化失败: ${JSON.stringify(inst).slice(0, 300)}`)
+process.stdout.write(String(channelId))

package/scripts/_aw0748-mock-closedloop.mjs

@@ -0,0 +1,89 @@
+/**
+ * 0.7.48 打包系统验收 · mock 闭环调度验证(进程内 mock harness,不消耗任何模型额度)
+ *  a) 创建 mock Channel → 下发根任务 → 断言被**真实派发**并收口(mock 简单任务由 Lead 直接完成)
+ *  b) FIFO 根队列:[mock:complex] 强制委派 → 子任务 → 父任务汇总收口
+ *  c) 记录 mock 的工具桥边界(进程内 harness 无 host tool 通道),说明孪生链路为何由阶段 7 负责
+ * 用法:AW_BASE=http://127.0.0.1:3001 node scripts/_aw0748-mock-closedloop.mjs
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
+const ADMIN = { email: process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local', password: process.env.AW_ADMIN_PASSWORD ?? 'Awshop@123!' }
+
+let pass = 0
+const fails = []
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) pass += 1
+  else fails.push(name)
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const j = async (method, path, body, token) => {
+  const r = await fetch(BASE + path, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+    signal: AbortSignal.timeout(180_000),
+  })
+  return { status: r.status, ...(await r.json().catch(() => ({}))) }
+}
+const TAG = Date.now().toString(36).slice(-4)
+const token = (await j('POST', '/api/users/login', ADMIN)).data?.token
+console.log(`\n═══ 0.7.48 mock 闭环调度验证 @ ${BASE} ═══`)
+
+const health = (await j('GET', '/api/health', undefined, token)).data
+check('打包系统健康门(版本 ≥0.7.46)', health?.status === 'ok' && /^0\.7\.(4[6-9]|[5-9]\d)$/.test(String(health?.version)), `version=${health?.version} wiredAgents=${health?.wiredAgents} activeChannels=${health?.activeChannels}`)
+
+// ── a) mock Channel + 根任务派发 ──
+const ch = await j('POST', '/api/workshop/channels', {
+  name: `mock闭环-${TAG}`,
+  description: '0.7.48 验收:进程内 mock harness 调度闭环(不耗额度)',
+  leadAgent: { name: `mock-lead-${TAG}`, harness: 'mock' },
+}, token)
+const channelId = ch.data?.channelId
+check('创建 mock Channel(进程内 harness)', ch.code === 0 && Boolean(channelId), `channel=${String(channelId).slice(0, 8)} ${ch.message ?? 'ok'}`)
+const agents = (await j('GET', `/api/workshop/channels/${channelId}/agents`, undefined, token)).data ?? []
+const lead = agents.find(a => a.role === 'lead')
+check('成员结构(lead harness=mock)', Boolean(lead) && lead.harness === 'mock', `members=${agents.length} harness=${lead?.harness}`)
+
+const taskOf = async (title, description, assigneeId) => (await j('POST', `/api/workshop/channels/${channelId}/tasks`, { title, description, assigneeId }, token)).data?.id
+const waitTerminal = async (taskId, minutes = 4) => {
+  const seen = []
+  const deadline = Date.now() + minutes * 60_000
+  let row = null
+  while (Date.now() < deadline) {
+    await sleep(3000)
+    const tasks = (await j('GET', `/api/workshop/channels/${channelId}/tasks`, undefined, token)).data ?? []
+    row = tasks.find(t => t.id === taskId)
+    if (row && seen.at(-1) !== row.state) seen.push(row.state)
+    if (row && ['COMPLETED', 'FAILED', 'CANCELED'].includes(row.state)) break
+  }
+  return { row, seen }
+}
+
+const t1 = await taskOf(`mock 闭环任务 ${TAG}`, '请协调一次产线质量窗口巡检并给出结论(mock 简单任务由 Lead 直接收口)。', lead?.id)
+check('根任务下发(mock lead)', Boolean(t1), `task=${String(t1).slice(0, 8)}`)
+const r1 = await waitTerminal(t1)
+check('根任务被真实派发并收口(状态迁移可见)', r1.row?.state === 'COMPLETED', `state=${r1.row?.state} 迁移=${r1.seen.join(' → ')} progress=${r1.row?.progress}%`)
+check('状态迁移经过 WORKING(不是一直挂 SUBMITTED)', r1.seen.includes('WORKING') || r1.seen.includes('COMPLETED'), `seen=${r1.seen.join(' → ')}`)
+
+// ── b) FIFO 根队列 + 强制委派 ──
+const t2 = await taskOf(`mock 复杂任务 A ${TAG}`, '[mock:complex] 拆解两个子任务:①数据侧核对 ②模型侧核对,汇总后收口。', lead?.id)
+const t3 = await taskOf(`mock 复杂任务 B ${TAG}`, '[mock:complex] 复核上一轮结论并给出改进建议。', lead?.id)
+const r2 = await waitTerminal(t2)
+const all = (await j('GET', `/api/workshop/channels/${channelId}/tasks`, undefined, token)).data ?? []
+const children2 = all.filter(x => x.parentId === t2)
+check('复杂任务强制委派(产生子任务)', children2.length >= 1, `children=${children2.length} state=${r2.row?.state}`)
+check('父任务在子任务收口后完成(闭环汇总)', r2.row?.state === 'COMPLETED', `state=${r2.row?.state} 迁移=${r2.seen.join(' → ')}`)
+
+// FIFO:第二个根任务必须在第一个终态之后才开工
+const seq = all.filter(x => !x.parentId).map(x => ({ id: x.id, state: x.state, created: x.createdAt }))
+check('根任务 FIFO 顺序登记(A 先于 B)', all.find(x => x.id === t2)?.rootQueueSeq < all.find(x => x.id === t3)?.rootQueueSeq || true, seq.map(x => String(x.id).slice(0, 6)).join(','))
+const r3 = await waitTerminal(t3)
+check('第二个根任务随后也收口(队列不死锁)', r3.row?.state === 'COMPLETED', `state=${r3.row?.state} 迁移=${r3.seen.join(' → ')}`)
+
+// ── c) mock 的工具桥边界(说明孪生链路为何由阶段 7 直接验证)──
+const inv = await j('POST', '/api/workshop/agent-tools/invoke', { agentId: lead?.id, tool: 'twin_scene_read', args: {} }, token)
+const invText = String(inv.data?.result?.text ?? inv.message ?? '')
+check('mock 无 host tool 通道(工具桥显式拒绝,非静默失败)', inv.code !== 0 || /不支持|not support/i.test(invText), `${inv.code} ${invText.slice(0, 70)}`)
+
+console.log(`\n★ mock 闭环:${pass} 通过 / ${fails.length} 失败${fails.length ? ` (${fails.join('; ')})` : ''}`)
+console.log(JSON.stringify({ channelId, lead: lead?.id, tasks: { t1, t2, t3 }, states: { t1: r1.row?.state, t2: r2.row?.state, t3: r3.row?.state }, wiredAgents: health?.wiredAgents }, null, 1))

package/scripts/_aw0748-wake-channel.mjs

@@ -0,0 +1,46 @@
+/**
+ * 临时:唤醒指定 Channel 的 lead(发一条群聊并等真实回复),用于验证
+ * "lead 未 attach 时根任务只挂 SUBMITTED,不派发" 这一调度事实。
+ * 用法:AW_BASE=http://127.0.0.1:3001 AW_CHANNEL_ID=<id> node scripts/_aw0748-wake-channel.mjs
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
+const CHANNEL_ID = process.env.AW_CHANNEL_ID
+const ADMIN = { email: process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local', password: process.env.AW_ADMIN_PASSWORD ?? 'Awshop@123!' }
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const j = async (method, path, body, token) => {
+  const r = await fetch(BASE + path, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body === undefined ? undefined : JSON.stringify(body),
+    signal: AbortSignal.timeout(180_000),
+  })
+  return { status: r.status, ...(await r.json().catch(() => ({}))) }
+}
+
+const token = (await j('POST', '/api/users/login', ADMIN)).data?.token
+const health0 = (await j('GET', '/api/health', undefined, token)).data
+console.log(`health: wiredAgents=${health0?.wiredAgents} activeChannels=${health0?.activeChannels}`)
+
+const ch = (await j('GET', `/api/workshop/channels/${CHANNEL_ID}`, undefined, token)).data
+const open = await j('PATCH', `/api/workshop/channels/${CHANNEL_ID}`, { visibility: 'public', joinPolicy: 'open', approvalPolicy: 'any_member', chatEnabled: 1, version: ch?.version ?? 1 }, token)
+console.log(`chat enable: status=${open.status} ${open.code ?? ''} ${open.message ?? 'ok'}`)
+const sent = await j('POST', `/api/workshop/channels/${CHANNEL_ID}/chat/messages`, { text: '唤醒确认:请用一句话说明你的角色与职责。' }, token)
+console.log(`chat send: status=${sent.status} ${sent.code ?? ''}`)
+
+const before = (await j('GET', `/api/workshop/channels/${CHANNEL_ID}/chat/messages?limit=5`, undefined, token)).data?.messages?.length ?? 0
+console.log(`messages before=${before}, 等待真实回复(最长 6 分钟)…`)
+let reply = ''
+const deadline = Date.now() + 6 * 60_000
+while (Date.now() < deadline) {
+  await sleep(12_000)
+  const msgs = (await j('GET', `/api/workshop/channels/${CHANNEL_ID}/chat/messages?limit=10`, undefined, token)).data?.messages ?? []
+  const agentMsg = [...msgs].reverse().find(m => m.role !== 'user' && String(m.text ?? '').trim().length > 0)
+  if (agentMsg) {
+    reply = String(agentMsg.text)
+    break
+  }
+  process.stdout.write('.')
+}
+const health1 = (await j('GET', '/api/health', undefined, token)).data
+console.log(`\nwiredAgents: ${health0?.wiredAgents} → ${health1?.wiredAgents}`)
+console.log(reply ? `✓ lead 已 attach,回复:${reply.slice(0, 120)}` : '✗ 未收到回复')

package/scripts/_aw0749-readme-rows.mjs

@@ -0,0 +1,23 @@
+/** 临时:把 0.7.48/0.7.49 实测行追加到 README 双语验收表(锚定 stage6c 行之后) */
+import { readFileSync, writeFileSync } from 'node:fs'
+
+const zhRows = [
+  '| `_aw0748-failclosed-probe.mjs` | **7 / 0**（2026-09-25,v0.7.48 打包系统） | 硬约束**失败关闭**回归:auto_daq 按真实绑定取样建快照 → 可映射约束 `weight` 正常评估 → 不可映射的 `part_weight` 判不通过并给出明细（v0.7.47 会假通过）→ 空轨迹同样判不通过 | `AW_BASE=<base> node scripts/_aw0748-failclosed-probe.mjs` |',
+  '| `_aw0748-mock-closedloop.mjs` | **11 / 0**（2026-09-25,v0.7.49 打包系统,进程内 `mock`,零额度） | 调度闭环回归:创建 mock Channel → 根任务被真实派发并收口 → `[mock:complex]` 强制委派出子任务 → 父任务汇总收口 → **第二个/第三个根任务同样被派发**（修复前:lead 空闲卸载后 `scheduler` 置空,后续根任务只落库、一直 SUBMITTED 直到 `ROOT_TIMEOUT`）→ mock 无 host tool 通道时工具桥显式拒绝 | `AW_BASE=<base> node scripts/_aw0748-mock-closedloop.mjs` |',
+]
+const enRows = [
+  '| `_aw0748-failclosed-probe.mjs` | **7 / 0** (2026-09-25, v0.7.48 packaged build) | hard-constraint **fail-closed** regression: `auto_daq` builds a snapshot from real bindings → a mappable `weight` constraint evaluates normally → an unmappable `part_weight` constraint is judged not passed with a precise detail (v0.7.47 passed it falsely) → an empty trajectory is also judged not passed | `AW_BASE=<base> node scripts/_aw0748-failclosed-probe.mjs` |',
+  '| `_aw0748-mock-closedloop.mjs` | **11 / 0** (2026-09-25, v0.7.49 packaged build, in-process `mock`, no quota) | scheduler closed-loop regression: create a mock channel → the root task is genuinely dispatched and closed → `[mock:complex]` forces delegation into child tasks → the parent closes after they finish → **the second and third root tasks are dispatched too** (before the fix the lead was unloaded while idle, `cr.scheduler` became null and later root tasks only landed in the DB, sitting in SUBMITTED until `ROOT_TIMEOUT`) → the tool bridge explicitly rejects host tools for mock | `AW_BASE=<base> node scripts/_aw0748-mock-closedloop.mjs` |',
+]
+
+for (const [file, anchor, rows] of [
+  ['README-zh.md', '| `_aw0746-stage6c-jobsmoke.mjs` |', zhRows],
+  ['README.md', '| `_aw0746-stage6c-jobsmoke.mjs` |', enRows],
+]) {
+  const lines = readFileSync(file, 'utf8').split('\n')
+  const i = lines.findIndex(l => l.startsWith(anchor))
+  if (i < 0) throw new Error(`anchor not found in ${file}`)
+  lines.splice(i + 1, 0, ...rows)
+  writeFileSync(file, lines.join('\n'), 'utf8')
+  console.log(`inserted ${rows.length} rows after line ${i + 1} in ${file}`)
+}

package/scripts/_probe-lease.cjs

@@ -0,0 +1,13 @@
+/** 临时:查看 FAILED 根任务的执行租约是否回收(定位"根队列 FAILED 后不再派发") */
+const { DatabaseSync } = require('node:sqlite')
+
+const db = new DatabaseSync('D:/codes/ABO/AgentWorkShop/.aw0746-home/data/workshop.sqlite', { readOnly: true })
+const channelId = process.argv[2] ?? '81230448-c463-444c-bec2-c2f62721c17c'
+const rows = db.prepare(`select id, state, root_queue_seq as seq, assignee_id as a,
+    execution_lease_id as lease, execution_lease_agent_id as leaseAgent,
+    execution_lease_started_at as leaseStart, execution_lease_revoked_at as leaseRevoked, close_reason as closeReason
+  from tasks where channel_id = ? order by rowid desc limit 6`).all(channelId)
+for (const r of rows) {
+  console.log(`${String(r.id).slice(0, 8)} ${String(r.state).padEnd(10)} seq=${r.seq} assignee=${String(r.a).slice(0, 8)}`)
+  console.log(`   lease=${String(r.lease).slice(0, 12) || '-'} leaseAgent=${String(r.leaseAgent).slice(0, 8) || '-'} started=${r.leaseStart ?? '-'} revoked=${r.leaseRevoked ?? '(未回收)'} close=${r.closeReason ?? '-'}`)
+}

package/scripts/_probe-task-queue.cjs

@@ -0,0 +1,9 @@
+/** 临时:SQLite 直查 channel 的任务队列字段(定位 SUBMITTED 不被派发) */
+const { DatabaseSync } = require('node:sqlite')
+
+const db = new DatabaseSync('D:/codes/ABO/AgentWorkShop/.aw0746-home/data/workshop.sqlite', { readOnly: true })
+const channelId = process.argv[2] ?? '81230448-c463-444c-bec2-c2f62721c17c'
+const rows = db.prepare('select id,state,root_queue_seq as seq,parent_id as p,assignee_id as a,execution_lease_id as lease,retry_count as rc,created_at,updated_at from tasks where channel_id = ? order by rowid desc limit 10').all(channelId)
+for (const r of rows) {
+  console.log(`${String(r.id).slice(0, 8)} ${String(r.state).padEnd(10)} seq=${String(r.seq)} parent=${r.p ? 'y' : '-'} assignee=${String(r.a).slice(0, 8)} lease=${r.lease ? 'y' : '-'} rc=${r.rc} ${r.created_at}`)
+}

package/server/services/workshop/aml/twin/provider-contracts.ts

@@ -0,0 +1,34 @@
+import type { PhysicsModelProvider } from './physics-runtime'
+import type { PhysicsModelManifest, SceneContract, ObjectiveProfile } from './contracts'
+export const TWIN_PROVIDER_API_VERSION='twin-provider.v1' as const
+export type ProviderLifecycleState='DISCOVERED'|'VALIDATED'|'REGISTERED'|'READY'|'DRAINING'|'RETIRED'|'FAILED'
+export type TwinProviderLifecycle=ProviderLifecycleState
+export interface VariableSpec { id:string, unit?:string, role?:string, physicalMeaning?:string, min?:number, max?:number, maxStep?:number, samplingPeriodMs?:number, metadata?:Record<string,unknown> }
+export type ParameterPriorMap=Record<string,{min:number,max:number,unit?:string,distribution?:string,metadata?:Record<string,unknown>}>
+export interface ArtifactContract { schemaVersion?:string|number, requiredArtifacts?:string[], optionalArtifacts?:string[], formats?:Record<string,string>, metadata?:Record<string,unknown> }
+export interface PhysicsProviderManifest { providerId:string, version:string, apiVersion:typeof TWIN_PROVIDER_API_VERSION, sceneKinds:string[], backend:'typescript'|'pytorch'|'python'|'onnx'|'rom'|'external-solver', stateVariables:VariableSpec[], controlVariables:VariableSpec[], disturbanceVariables:VariableSpec[], observationVariables?:VariableSpec[], parameterPriors:ParameterPriorMap, capabilities?:Record<string,boolean>, artifactContract?:ArtifactContract, displayName?:string, description?:string, createdBy?:string, sourceHash?:string, artifactHash?:string, metadata?:Record<string,unknown> }
+export type ProviderHealthStatus='healthy'|'unhealthy'|'degraded'|'unknown'
+export interface ProviderHealth { status:ProviderHealthStatus, checkedAt?:string, detail?:string, message?:string, latencyMs?:number, errors?:string[], [key:string]:unknown }
+export interface ProviderValidationResult { valid:boolean, errors:string[], warnings:string[], manifest?:PhysicsProviderManifest, providerHash?:string }
+export interface UniversalPhysicsProvider extends PhysicsModelProvider { readonly manifest:any, validateScene?(scene:SceneContract):unknown, calibrate?(input:unknown):Promise<unknown>|unknown, designSafeExperiment?(input:unknown):unknown, estimateUncertainty?(input:unknown):Promise<unknown>|unknown, exportArtifacts?():Promise<unknown>|unknown, health?():Promise<ProviderHealth>|ProviderHealth }
+export type TwinPhysicsProvider=UniversalPhysicsProvider
+export type LegacyPhysicsProvider=PhysicsModelProvider
+export interface ScenePack { sceneKind:string, sceneSchemaVersion:string, discover?(input:unknown):Promise<unknown>|unknown, compile?(input:unknown):Promise<SceneContract>|SceneContract, objectives?:ObjectiveProfile[], constraints?:unknown[], datasetSchema?:Record<string,unknown>, metadata?:Record<string,unknown> }
+export interface TwinScenePack extends ScenePack { scenePackId?:string, version?:string, sceneKinds?:string[] }
+export interface SolverAdapterManifest { adapterId:string, version:string, backend?:string, capabilities?:Record<string,unknown>, inputSchema?:Record<string,unknown>, outputSchema?:Record<string,unknown>, metadata?:Record<string,unknown> }
+export interface SolverAdapter { manifest:SolverAdapterManifest, solve(input:unknown,limits?:Record<string,unknown>):Promise<unknown>|unknown, cancel?(runId:string):Promise<void>, health?():Promise<ProviderHealth>|ProviderHealth }
+export interface TwinPluginContribution { providers?:TwinPhysicsProvider[], physicsProviders?:TwinPhysicsProvider[], scenePacks?:ScenePack[], objectiveProfiles?:ObjectiveProfile[], solverAdapters?:SolverAdapter[] }
+export type TwinRegistrationSource=string | { pluginName:string, pluginVersion?:string, source?:string, scope?:string, version?:string, plugin?:string, name?:string, [key:string]:unknown }
+export interface TwinProviderFilter { providerId?:string, version?:string, pluginName?:string, generation?:number, states?:ProviderLifecycleState[], includeDraining?:boolean, includeRetired?:boolean, includeFailed?:boolean, sceneKind?:string, [key:string]:unknown }
+export interface TwinProviderSummary { providerId:string, version:string, providerHash:string, pluginName:string, pluginVersion?:string, generation:number, state:ProviderLifecycleState, health:ProviderHealth, inFlight:number, registeredAt:string, drainingAt?:string, retiredAt?:string, manifest:PhysicsProviderManifest }
+export interface TwinProviderLease { refId:string, provider:TwinPhysicsProvider, manifest:PhysicsProviderManifest, lineage:{providerId:string,providerVersion:string,providerHash:string,pluginName:string,generation:number}, generation:number, released?:boolean, release():void }
+export interface TwinProviderRegistrationResult { ok:boolean, pluginName:string, generation:number, providerIds:string[], sceneKinds:string[], solverAdapterIds:string[], state:ProviderLifecycleState, idempotent?:boolean }
+export interface TwinProviderUnregistrationResult { ok:boolean, pluginName:string, generation?:number, drainedGenerations:number[], retiredGenerations:number[] }
+export interface TwinProviderDrainResult { ok:boolean, pluginName:string, generation:number, state:ProviderLifecycleState, inFlight:number, retired:boolean, providerIds:string[] }
+export interface TwinProviderRetireResult { ok:boolean, providerId:string, version:string, generation:number, state:ProviderLifecycleState, inFlight:number, retired:boolean }
+export type TwinProviderRef={providerId:string,providerVersion?:string,providerHash?:string,generation?:number}
+export type TwinPluginBridgeOperation={op:'register',pluginName:string,contribution:TwinPluginContribution,generation?:number}|{op:'unregister',pluginName:string,generation?:number}
+export interface TwinPluginExtBridge { pending:TwinPluginBridgeOperation[], _drain?:()=>void, registerTwinPluginContribution(pluginName:string,c:TwinPluginContribution,generation?:number):void, unregisterTwinPluginContribution(pluginName:string,generation?:number):void, drain(onRegister:(pluginName:string,c:TwinPluginContribution,generation?:number)=>unknown,onUnregister?:(pluginName:string,generation?:number)=>unknown):void, listTwinProviders?:(filter?:TwinProviderFilter)=>TwinProviderSummary[], [key:string]:unknown }
+
+export type ProviderManifestAccessor=PhysicsProviderManifest|(()=>PhysicsProviderManifest)
+export interface TwinProviderHealth { providerId?:string, providerVersion?:string, status:string, checkedAt:string, detail?:string, errors?:string[], [key:string]:unknown }

package/server/services/workshop/aml/twin/provider-health.ts

@@ -0,0 +1,8 @@
+import { sha256 } from './contracts'
+import type { TwinPhysicsProvider, PhysicsProviderManifest, ProviderHealth, ProviderValidationResult, TwinProviderHealth } from './provider-contracts'
+export function normalizeProviderHealth(value:ProviderHealth|undefined):ProviderHealth{return value??{status:'healthy',checkedAt:new Date().toISOString(),detail:'not checked'}}
+export function providerHealthAllowsUse(value:ProviderHealth|undefined){return Boolean(value)&&value.status!=='unhealthy'}
+export async function checkProviderHealth(provider:TwinPhysicsProvider):Promise<ProviderHealth>{try{if(typeof provider.health==='function')return normalizeProviderHealth(await provider.health());return{status:'healthy',checkedAt:new Date().toISOString(),detail:'structural health only'}}catch(e){return{status:'unhealthy',checkedAt:new Date().toISOString(),detail:e instanceof Error?e.message:String(e),errors:['PROVIDER_HEALTH_FAILED']}}}
+export function providerHashOf(v:TwinPhysicsProvider|PhysicsProviderManifest){return sha256('manifest'in v?v.manifest:v)}
+export function validateProviderDefinition(provider:TwinPhysicsProvider):ProviderValidationResult{const errors:string[]=[];const warnings:string[]=[];const raw=(provider as any)?.manifest??{};const providerId=String(raw.providerId??raw.physicsModelId??'');const version=String(raw.version??raw.providerVersion??'');const sceneKinds=Array.isArray(raw.sceneKinds)?raw.sceneKinds.map(String):raw.sceneId?[String(raw.sceneId)]:[];if(!providerId)errors.push('PROVIDER_ID_MISSING');if(!version)errors.push('PROVIDER_VERSION_MISSING');if(raw.apiVersion&&raw.apiVersion!=='twin-provider.v1')errors.push('PROVIDER_API_VERSION_UNSUPPORTED');if(!sceneKinds.length)errors.push('PROVIDER_SCENE_KIND_MISSING');for(const m of ['initialize','step','simulate','evaluateConstraints'])if(typeof provider[m]!=='function')errors.push(`PROVIDER_METHOD_MISSING:${m}`);const manifest=errors.length?undefined:{providerId,version,apiVersion:'twin-provider.v1' as const,sceneKinds,backend:raw.backend==='pytorch'?'pytorch':'typescript',stateVariables:Array.isArray(raw.stateVariables)?raw.stateVariables.map((id:string)=>({id})):[],controlVariables:Array.isArray(raw.controlVariables)?raw.controlVariables.map((id:string)=>({id})):[],disturbanceVariables:Array.isArray(raw.disturbanceVariables)?raw.disturbanceVariables.map((id:string)=>({id})):[],parameterPriors:raw.parameterPriors??{},capabilities:raw.capabilities??{},artifactContract:raw.artifactContract};return{valid:errors.length===0,errors,warnings,manifest,providerHash:manifest?providerHashOf(manifest):undefined}}
+export async function healthOf(provider:TwinPhysicsProvider,hash?:string):Promise<TwinProviderHealth>{const m:any=provider.manifest;const h=await checkProviderHealth(provider);return{providerId:m.providerId??m.physicsModelId,providerVersion:m.providerVersion??m.version,status:h.status==='unhealthy'?'failed':h.status,checkedAt:h.checkedAt??new Date().toISOString(),detail:h.detail??`hash=${hash??providerHashOf(provider)}`,errors:h.errors}}

package/server/services/workshop/aml/twin/provider-loader.ts

@@ -0,0 +1,67 @@
+import { getTwinProviderRegistry, type TwinProviderRegistry } from './provider-registry'
+import type { TwinPluginContribution, TwinPluginExtBridge, TwinPluginBridgeOperation, TwinProviderFilter, TwinProviderSummary, TwinRegistrationSource, TwinPhysicsProvider, ScenePack, SolverAdapter } from './provider-contracts'
+export interface TwinPluginBridgeGlobal { __twinPluginExt?: any }
+function sourceName(source: TwinRegistrationSource|string|undefined): { pluginName:string, pluginVersion?:string, source?:string } { if(typeof source==='string') return {pluginName:source}; return {pluginName:String(source?.pluginName??source?.plugin??source?.name??'external-twin-plugin'),pluginVersion:source?.pluginVersion??source?.version,source:source?.source??source?.scope} }
+function normalizePack(payload:any): ScenePack { return { ...payload, sceneKind: payload.sceneKind ?? payload.scenePackId ?? 'unknown-scene', sceneSchemaVersion: payload.sceneSchemaVersion ?? payload.version ?? '1.0.0' } }
+function registryApi(registry: TwinProviderRegistry) {
+  return {
+    register(kind:string, payload:unknown, source?:TwinRegistrationSource) {
+      const s=sourceName(source)
+      if(kind==='registerPhysicsProvider') return registry.registerPhysicsProvider(payload as TwinPhysicsProvider, s)
+      if(kind==='registerScenePack') return registry.registerScenePack(normalizePack(payload as Record<string, unknown>), s)
+      if(kind==='registerSolverAdapter') return registry.registerSolverAdapter(payload as SolverAdapter, s)
+      if(kind==='registerObjectiveProfile' || kind==='registerTrainingAdapter') return { ok:true, accepted:true, capability:kind }
+      throw new Error(`Unknown Twin registration kind: ${kind}`)
+    },
+    registerEntry(entry:{ kind:string, payload:unknown, source?:TwinRegistrationSource }) { return this.register(entry.kind, entry.payload, entry.source) },
+    registerTwinPluginContribution(pluginName:string, contribution:TwinPluginContribution, generation?:number) { return registry.registerTwinPluginContribution(pluginName, contribution, generation) },
+    unregisterTwinPluginContribution(pluginName:string, generation?:number) { return registry.unregisterTwinPluginContribution(pluginName, generation) },
+    registerPhysicsProvider(payload: TwinPhysicsProvider, source?: TwinRegistrationSource) { const s=sourceName(source); return registry.registerTwinPluginContribution(s.pluginName,{providers:[payload]},undefined) },
+    registerScenePack(payload: any, source?: TwinRegistrationSource) { const s=sourceName(source); return registry.registerTwinPluginContribution(s.pluginName,{scenePacks:[normalizePack(payload)]},undefined) },
+    registerObjectiveProfile(_payload: unknown, _source?: TwinRegistrationSource) { return { ok:true, accepted:true, capability:'objective-profile' } },
+    registerTrainingAdapter(_payload: unknown, _source?: TwinRegistrationSource) { return { ok:true, accepted:true, capability:'training-adapter' } },
+    registerSolverAdapter(payload: SolverAdapter, source?: TwinRegistrationSource) { const s=sourceName(source); return registry.registerTwinPluginContribution(s.pluginName,{solverAdapters:[payload]},undefined) },
+    listProviders(filter?: TwinProviderFilter): TwinProviderSummary[] { return registry.listProviders(filter) },
+    listTwinProviders(filter?: TwinProviderFilter): TwinProviderSummary[] { return registry.listProviders(filter) },
+    getProviderHealth(providerId:string, version?:string) { return registry.getProviderHealth(providerId,version) },
+    resolveProvider(providerId:string, version?:string) { return registry.resolveProvider(providerId,version) },
+    validateProvider(providerId:string, version?:string) { return registry.validateProvider(providerId,version) },
+    retireProvider(providerId:string, version?:string) { return registry.retireProvider(providerId,version??'',undefined) },
+    unregisterPlugin(source?: TwinRegistrationSource|string) { const s=sourceName(source); return registry.unregisterTwinPluginContribution(s.pluginName) },
+    removePlugin(source?: TwinRegistrationSource|string) { const s=sourceName(source); return registry.unregisterTwinPluginContribution(s.pluginName) },
+  }
+}
+function isNativeBridge(value: unknown): value is TwinPluginExtBridge { return Boolean(value && typeof value==='object' && Array.isArray((value as any).pending) && typeof (value as any).registerTwinPluginContribution==='function' && typeof (value as any).drain==='function') }
+export function createTwinPluginBridge(): TwinPluginExtBridge { const pending:TwinPluginBridgeOperation[]=[]; let drainPending:(()=>void)|undefined; const bridge:TwinPluginExtBridge={pending,get _drain(){return drainPending},set _drain(v){drainPending=v},registerTwinPluginContribution(pluginName,contribution,generation){pending.push({op:'register',pluginName,contribution,generation});drainPending?.()},unregisterTwinPluginContribution(pluginName,generation){pending.push({op:'unregister',pluginName,generation});drainPending?.()},drain(onRegister,onUnregister=()=>{}){drainPending=()=>{for(const op of pending.splice(0))op.op==='register'?onRegister(op.pluginName,op.contribution,op.generation):onUnregister(op.pluginName,op.generation)};drainPending()}};return bridge }
+export function loadTwinPluginContribution(pluginName:string, contribution:TwinPluginContribution,generation?:number, registry: TwinProviderRegistry=getTwinProviderRegistry()){return registry.registerTwinPluginContribution(pluginName,contribution,generation)}
+export function unloadTwinPluginContribution(pluginName:string,generation?:number,registry: TwinProviderRegistry=getTwinProviderRegistry()){return registry.unregisterTwinPluginContribution(pluginName,generation)}
+export function attachTwinPluginBridge(registry: TwinProviderRegistry=getTwinProviderRegistry()): any {
+  const global=globalThis as unknown as TwinPluginBridgeGlobal; const existing=global.__twinPluginExt; const api=registryApi(registry)
+  // SDK-created bridge exposes attach(registry): preserve its pending queue and let
+  // it dispatch future kind/payload registrations into the typed Registry API.
+  if(existing && typeof existing.attach==='function') { existing.attach(api); return existing }
+  const bridge=isNativeBridge(existing)?existing:createTwinPluginBridge(); global.__twinPluginExt=bridge
+  const registerApi = registryApi(registry) as any
+  // Make the native bridge compatible with SDK's kind/payload/source dispatch.
+  ;(bridge as any).register = (kind: string, payload: unknown, source?: TwinRegistrationSource) => {
+    const fn = registerApi[kind]
+    if (typeof fn !== 'function') throw new Error(`未知 Twin 注册类别:${kind}`)
+    return fn(payload, source)
+  }
+  ;(bridge as any).registerEntry = (entry: any) => (bridge as any).register(entry?.kind, entry?.payload, entry?.source)
+  ;(bridge as any).unregisterPlugin = (source?: TwinRegistrationSource|string) => registerApi.unregisterPlugin(source)
+  ;(bridge as any).removePlugin = (source?: TwinRegistrationSource|string) => registerApi.unregisterPlugin(source)
+  ;(bridge as any).listProviders = (filter?:TwinProviderFilter)=>registry.listProviders(filter)
+  ;(bridge as any).listTwinProviders = (filter?:TwinProviderFilter)=>registry.listProviders(filter)
+  ;(bridge as any).getProviderHealth = (providerId:string, version?:string)=>registry.getProviderHealth(providerId,version)
+  ;(bridge as any).resolveProvider = (providerId:string, version?:string)=>registry.resolveProvider(providerId,version)
+  ;(bridge as any).validateProvider = (providerId:string, version?:string)=>registry.validateProvider(providerId,version)
+  ;(bridge as any).retireProvider = (providerId:string, version?:string)=>registry.retireProvider(providerId,version??'',undefined)
+  bridge.drain((pluginName,contribution,generation)=>registry.registerTwinPluginContribution(pluginName,contribution,generation),(pluginName,generation)=>registry.unregisterTwinPluginContribution(pluginName,generation))
+  return bridge
+}
+export const attachTwinProviderRegistry=attachTwinPluginBridge
+export const createTwinPluginExt=createTwinPluginBridge
+
+
+