@dsh-workbench/shared 0.3.5 → 0.3.7

package/dist/host/version-range.js

@@ -0,0 +1,73 @@
+import { compareVersions } from './release';
+function readable(version) {
+    return compareVersions(version, '0.0.0') !== undefined;
+}
+function segmentsOf(version) {
+    if (!readable(version))
+        return undefined;
+    return version.split('.').map((part) => Number.parseInt(part, 10));
+}
+function caretUpper(base) {
+    const [major = 0, minor = 0, patch = 0] = base;
+    if (major > 0)
+        return `${major + 1}.0.0`;
+    return minor > 0 ? `0.${minor + 1}.0` : `0.0.${patch + 1}`;
+}
+function tildeUpper(base) {
+    const [major = 0, minor = 0] = base;
+    return `${major}.${minor + 1}.0`;
+}
+function comparator(token, version) {
+    const match = /^(>=|<=|>|<|=|\^|~)?\s*(.+)$/.exec(token.trim());
+    if (match === null)
+        return undefined;
+    const [, operator = '', raw = ''] = match;
+    const base = segmentsOf(raw.trim());
+    if (base === undefined)
+        return undefined;
+    const at = (other) => compareVersions(version, other);
+    switch (operator) {
+        case '^':
+            return (at(raw) ?? -1) >= 0 && (at(caretUpper(base)) ?? 1) < 0;
+        case '~':
+            return (at(raw) ?? -1) >= 0 && (at(tildeUpper(base)) ?? 1) < 0;
+        default:
+            break;
+    }
+    const compared = at(raw.trim());
+    if (compared === undefined)
+        return undefined;
+    switch (operator) {
+        case '>=':
+            return compared >= 0;
+        case '<=':
+            return compared <= 0;
+        case '>':
+            return compared > 0;
+        case '<':
+            return compared < 0;
+        case '=':
+        case '':
+            return compared === 0;
+        default:
+            return undefined;
+    }
+}
+export function checkVersionRange(contract, version) {
+    const spec = contract?.trim() ?? '';
+    if (spec === '')
+        return 'satisfied';
+    if (!readable(version))
+        return 'malformed';
+    const tokens = spec.split(/\s+/).filter((token) => token !== '');
+    if (tokens.length === 0)
+        return 'satisfied';
+    for (const token of tokens) {
+        const verdict = comparator(token, version);
+        if (verdict === undefined)
+            return 'malformed';
+        if (!verdict)
+            return 'unsatisfied';
+    }
+    return 'satisfied';
+}

package/dist/host.d.ts

@@ -1,20 +1,20 @@
 export * from './config/constants.js';
 export * from './api/context-ref.js';
 export * from './api/unit.js';
-export * from './api/unit-declaration.js';
 export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';
-export * from './lib/panel-state.js';
 export * from './lib/board-fact.js';
-export * from './lib/diy-debug.js';
-export * from './lib/diy-record.js';
 export * from './api/blocker-table.js';
+export * from './host/board-fact.js';
 export * from './host/browser-find.js';
 export * from './host/browser-read.js';
 export * from './host/cli-error.js';
+export * from './host/context-ref.js';
 export * from './host/data-root.js';
+export * from './host/diy-debug.js';
+export * from './host/diy-record.js';
 export * from './host/facts.js';
 export * from './host/git.js';
 export * from './host/http.js';
@@ -22,12 +22,15 @@ export * from './host/long-task.js';
 export * from './host/opencli-runtime.js';
 export * from './host/opencli-window.js';
 export * from './host/opencli.js';
+export * from './host/panel-state.js';
 export * from './host/plugin-ledger.js';
 export * from './host/plugin-source.js';
 export * from './host/provision.js';
+export * from './host/shell-text.js';
 export * from './host/shell.js';
 export * from './host/tool-approval.js';
 export * from './host/tool-kit.js';
+export * from './host/unit-declaration.js';
 export * from './host/unit-face.js';
 export * from './host/unit-libs.js';
 export * from './host/value-handoff.js';

package/dist/host.js

@@ -1,20 +1,20 @@
 export * from './config/constants.js';
 export * from './api/context-ref.js';
 export * from './api/unit.js';
-export * from './api/unit-declaration.js';
 export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';
-export * from './lib/panel-state.js';
 export * from './lib/board-fact.js';
-export * from './lib/diy-debug.js';
-export * from './lib/diy-record.js';
 export * from './api/blocker-table.js';
+export * from './host/board-fact.js';
 export * from './host/browser-find.js';
 export * from './host/browser-read.js';
 export * from './host/cli-error.js';
+export * from './host/context-ref.js';
 export * from './host/data-root.js';
+export * from './host/diy-debug.js';
+export * from './host/diy-record.js';
 export * from './host/facts.js';
 export * from './host/git.js';
 export * from './host/http.js';
@@ -22,12 +22,15 @@ export * from './host/long-task.js';
 export * from './host/opencli-runtime.js';
 export * from './host/opencli-window.js';
 export * from './host/opencli.js';
+export * from './host/panel-state.js';
 export * from './host/plugin-ledger.js';
 export * from './host/plugin-source.js';
 export * from './host/provision.js';
+export * from './host/shell-text.js';
 export * from './host/shell.js';
 export * from './host/tool-approval.js';
 export * from './host/tool-kit.js';
+export * from './host/unit-declaration.js';
 export * from './host/unit-face.js';
 export * from './host/unit-libs.js';
 export * from './host/value-handoff.js';

package/dist/i18n/en.js

@@ -37,6 +37,7 @@ export const en = {
     'session.actions': 'Actions for {name}',
     'status.idle': 'Idle',
     'status.running': 'Running',
+    'status.longTask': 'Long task running',
     'status.waitingApproval': 'Waiting for approval',
     'status.planReview': 'Plan awaiting review',
     'status.waitingAnswer': 'Waiting for your answer',
@@ -50,6 +51,8 @@ export const en = {
     'project.attention.warning.other': '{n} sessions waiting for you',
     'project.attention.running.one': '1 session running',
     'project.attention.running.other': '{n} sessions running',
+    'project.attention.longTask.one': '1 long task running',
+    'project.attention.longTask.other': '{n} long tasks running',
     'project.attention.done.one': '1 session finished, unread',
     'project.attention.done.other': '{n} sessions finished, unread',
     'project.attention.state.warning': 'Approval',
@@ -426,6 +429,7 @@ export const en = {
     'record.waiting.note': 'Press "Start recording" on that page, then "Stop recording" when done (it will not switch you back)',
     'record.recording': 'Recording',
     'record.recording.note': 'Press "Stop recording" when done; if the bar is gone press Halt so the agent grabs it first',
+    'record.recording.shots': '; to keep a shot of this moment press "Screenshot" on the bar ({n} taken)',
     'record.finished': 'Recording finished',
     'record.finished.note': 'This run is done — the agent will grab it and wrap up on its own',
     'record.act.cancel': 'Cancel',
@@ -436,4 +440,6 @@ export const en = {
     'approval.record.noUrl': 'no site given (this call gets refused)',
     'approval.record.oneAction': 'one action',
     'approval.record.noSwitch': 'it will not switch you back (the leftbar footer shows the state)',
+    'approval.longTask.what': 'Stops',
+    'approval.longTask.signal': 'stopping only sends an interrupt signal — how the platform-side run finishes is up to the module',
 };

package/dist/i18n/index.d.ts

@@ -39,6 +39,7 @@ export declare const dictionaries: {
         readonly 'session.actions': "{name} 的操作";
         readonly 'status.idle': "空闲";
         readonly 'status.running': "进行中";
+        readonly 'status.longTask': "长任务在跑";
         readonly 'status.waitingApproval': "等待审批";
         readonly 'status.planReview': "计划待审";
         readonly 'status.waitingAnswer': "等待回答";
@@ -52,6 +53,8 @@ export declare const dictionaries: {
         readonly 'project.attention.warning.other': "{n} 个会话在等你点头";
         readonly 'project.attention.running.one': "1 个会话在跑";
         readonly 'project.attention.running.other': "{n} 个会话在跑";
+        readonly 'project.attention.longTask.one': "1 个长任务在跑";
+        readonly 'project.attention.longTask.other': "{n} 个长任务在跑";
         readonly 'project.attention.done.one': "1 个会话跑完没看";
         readonly 'project.attention.done.other': "{n} 个会话跑完没看";
         readonly 'project.attention.state.warning': "待审批";
@@ -428,6 +431,7 @@ export declare const dictionaries: {
         readonly 'record.waiting.note': "请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）";
         readonly 'record.recording': "录制中";
         readonly 'record.recording.note': "做完按「结束录制」；浮条没了按「停」，让 agent 先取再收";
+        readonly 'record.recording.shots': "；想留一张现场就按浮条上的「截图」（已拍 {n} 张）";
         readonly 'record.finished': "录制完成";
         readonly 'record.finished.note': "这一段录完了 —— agent 会自己来取并收工，不用你点";
         readonly 'record.act.cancel': "取消";
@@ -438,8 +442,10 @@ export declare const dictionaries: {
         readonly 'approval.record.noUrl': "没给站点地址（这次会被当场拒）";
         readonly 'approval.record.oneAction': "一次操作";
         readonly 'approval.record.noSwitch': "录完不会替你切回来（左栏底部会亮一条状态）";
+        readonly 'approval.longTask.what': "要停的那一趟";
+        readonly 'approval.longTask.signal': "停了只是让外壳发出中断信号 —— 平台侧那趟活儿的收尾看模块自己";
     };
-    en: Record<"time.now" | "time.ago" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.add.busy" | "project.add.failed" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.group.workspaces" | "project.group.defaultWorkspace" | "project.group.workshop" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.list.label" | "session.copy" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.compact.approval" | "status.compact.planReview" | "status.compact.answer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "project.attention.warning.one" | "project.attention.warning.other" | "project.attention.running.one" | "project.attention.running.other" | "project.attention.done.one" | "project.attention.done.other" | "project.attention.state.warning" | "project.attention.state.running" | "project.attention.state.done" | "hover.copied" | "time.short.minutes" | "time.short.hours" | "time.short.days" | "time.short.months" | "time.short.years" | "panels.title" | "panels.groupBoardless" | "panels.groupPlugins" | "panels.market.defaultHint" | "panels.market.defaultLabel" | "panels.market.defaultLocked" | "panels.followAll" | "panels.followAllConfirmTitle" | "panels.followAllConfirmDetail" | "panels.followAllConfirmAck" | "panels.followAllConfirmYes" | "panels.followAllConfirmNo" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.hintJoin" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.notActive" | "panels.market.notUsable" | "panels.market.broken" | "panels.market.hasNew" | "panels.market.hasProblem" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.swapSlow" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.needCommands" | "panels.market.localMark" | "panels.market.localHint" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "panels.market.pendingRestart" | "panels.market.workbenchName" | "panels.market.workbenchLocal" | "panels.market.pluginKeptInUse" | "panels.market.pluginKeptUnsure" | "panels.market.pluginKeptHeld" | "panels.market.pluginKeptUnnamed" | "panels.market.pluginBroken" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNotWorkbenchModule" | "panels.market.add.problemNotModuleOrPlugin" | "panels.market.add.failureNotModuleOrPlugin" | "panels.market.add.installedPlugin" | "panels.market.add.pluginPreview" | "panels.market.add.pluginAlias" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureInstalled" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.classifying" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.restartWhy" | "panels.market.add.restartWhy.no-hmr" | "panels.market.add.restartWhy.package-moved" | "panels.market.add.restartWhy.host-module" | "panels.market.add.restartWhy.unmanaged-plugin" | "panels.market.add.restartWhy.module-comparison" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "rightbar.openPlatform" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label" | "configSync.nav" | "configSync.lead" | "configSync.source" | "configSync.sourceBroken" | "configSync.sourceRows" | "configSync.sourceDead" | "configSync.refresh" | "configSync.loading" | "configSync.readHint" | "configSync.tag.new" | "configSync.tag.differs" | "configSync.conflictNote" | "configSync.code.lang" | "configSync.code.copy" | "configSync.code.copied" | "configSync.code.wrap" | "configSync.code.unwrap" | "configSync.code.collapse" | "configSync.code.collapseAria" | "configSync.code.expandAria" | "configSync.code.expand" | "configSync.missing" | "configSync.apply" | "configSync.applyNone" | "configSync.applying" | "configSync.applied" | "configSync.appliedIds" | "configSync.skippedIds" | "configSync.nothing" | "configSync.unreadable" | "configSync.noSource" | "configSync.emptyProviders" | "configSync.failed" | "debug.workspace" | "debug.status" | "debug.status.trouble" | "debug.stalled" | "debug.act.pause" | "debug.act.resume" | "debug.act.stop" | "debug.act.stop.ask" | "debug.card.here.title" | "debug.card.here.note" | "debug.card.away.note" | "debug.card.paused.note" | "debug.card.hidden.note" | "record.waiting" | "record.waiting.note" | "record.recording" | "record.recording.note" | "record.finished" | "record.finished.note" | "record.act.cancel" | "record.act.halt" | "approval.record.site" | "approval.record.what" | "approval.record.lands" | "approval.record.noUrl" | "approval.record.oneAction" | "approval.record.noSwitch", string>;
+    en: Record<"time.now" | "time.ago" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.add.busy" | "project.add.failed" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.group.workspaces" | "project.group.defaultWorkspace" | "project.group.workshop" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.list.label" | "session.copy" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.longTask" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.compact.approval" | "status.compact.planReview" | "status.compact.answer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "project.attention.warning.one" | "project.attention.warning.other" | "project.attention.running.one" | "project.attention.running.other" | "project.attention.longTask.one" | "project.attention.longTask.other" | "project.attention.done.one" | "project.attention.done.other" | "project.attention.state.warning" | "project.attention.state.running" | "project.attention.state.done" | "hover.copied" | "time.short.minutes" | "time.short.hours" | "time.short.days" | "time.short.months" | "time.short.years" | "panels.title" | "panels.groupBoardless" | "panels.groupPlugins" | "panels.market.defaultHint" | "panels.market.defaultLabel" | "panels.market.defaultLocked" | "panels.followAll" | "panels.followAllConfirmTitle" | "panels.followAllConfirmDetail" | "panels.followAllConfirmAck" | "panels.followAllConfirmYes" | "panels.followAllConfirmNo" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.hintJoin" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.notActive" | "panels.market.notUsable" | "panels.market.broken" | "panels.market.hasNew" | "panels.market.hasProblem" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.swapSlow" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.needCommands" | "panels.market.localMark" | "panels.market.localHint" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "panels.market.pendingRestart" | "panels.market.workbenchName" | "panels.market.workbenchLocal" | "panels.market.pluginKeptInUse" | "panels.market.pluginKeptUnsure" | "panels.market.pluginKeptHeld" | "panels.market.pluginKeptUnnamed" | "panels.market.pluginBroken" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNotWorkbenchModule" | "panels.market.add.problemNotModuleOrPlugin" | "panels.market.add.failureNotModuleOrPlugin" | "panels.market.add.installedPlugin" | "panels.market.add.pluginPreview" | "panels.market.add.pluginAlias" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureInstalled" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.classifying" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.restartWhy" | "panels.market.add.restartWhy.no-hmr" | "panels.market.add.restartWhy.package-moved" | "panels.market.add.restartWhy.host-module" | "panels.market.add.restartWhy.unmanaged-plugin" | "panels.market.add.restartWhy.module-comparison" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "rightbar.openPlatform" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label" | "configSync.nav" | "configSync.lead" | "configSync.source" | "configSync.sourceBroken" | "configSync.sourceRows" | "configSync.sourceDead" | "configSync.refresh" | "configSync.loading" | "configSync.readHint" | "configSync.tag.new" | "configSync.tag.differs" | "configSync.conflictNote" | "configSync.code.lang" | "configSync.code.copy" | "configSync.code.copied" | "configSync.code.wrap" | "configSync.code.unwrap" | "configSync.code.collapse" | "configSync.code.collapseAria" | "configSync.code.expandAria" | "configSync.code.expand" | "configSync.missing" | "configSync.apply" | "configSync.applyNone" | "configSync.applying" | "configSync.applied" | "configSync.appliedIds" | "configSync.skippedIds" | "configSync.nothing" | "configSync.unreadable" | "configSync.noSource" | "configSync.emptyProviders" | "configSync.failed" | "debug.workspace" | "debug.status" | "debug.status.trouble" | "debug.stalled" | "debug.act.pause" | "debug.act.resume" | "debug.act.stop" | "debug.act.stop.ask" | "debug.card.here.title" | "debug.card.here.note" | "debug.card.away.note" | "debug.card.paused.note" | "debug.card.hidden.note" | "record.waiting" | "record.waiting.note" | "record.recording" | "record.recording.note" | "record.recording.shots" | "record.finished" | "record.finished.note" | "record.act.cancel" | "record.act.halt" | "approval.record.site" | "approval.record.what" | "approval.record.lands" | "approval.record.noUrl" | "approval.record.oneAction" | "approval.record.noSwitch" | "approval.longTask.what" | "approval.longTask.signal", string>;
 };
 /** 中文词表的键类型（从 `zh.ts` 转出）：`en` 与模块词表都得覆盖同一批键。 */
 export type { WorkbenchMessages };

package/dist/i18n/zh.d.ts

@@ -37,6 +37,7 @@ export declare const zh: {
     readonly 'session.actions': "{name} 的操作";
     readonly 'status.idle': "空闲";
     readonly 'status.running': "进行中";
+    readonly 'status.longTask': "长任务在跑";
     readonly 'status.waitingApproval': "等待审批";
     readonly 'status.planReview': "计划待审";
     readonly 'status.waitingAnswer': "等待回答";
@@ -50,6 +51,8 @@ export declare const zh: {
     readonly 'project.attention.warning.other': "{n} 个会话在等你点头";
     readonly 'project.attention.running.one': "1 个会话在跑";
     readonly 'project.attention.running.other': "{n} 个会话在跑";
+    readonly 'project.attention.longTask.one': "1 个长任务在跑";
+    readonly 'project.attention.longTask.other': "{n} 个长任务在跑";
     readonly 'project.attention.done.one': "1 个会话跑完没看";
     readonly 'project.attention.done.other': "{n} 个会话跑完没看";
     readonly 'project.attention.state.warning': "待审批";
@@ -426,6 +429,7 @@ export declare const zh: {
     readonly 'record.waiting.note': "请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）";
     readonly 'record.recording': "录制中";
     readonly 'record.recording.note': "做完按「结束录制」；浮条没了按「停」，让 agent 先取再收";
+    readonly 'record.recording.shots': "；想留一张现场就按浮条上的「截图」（已拍 {n} 张）";
     readonly 'record.finished': "录制完成";
     readonly 'record.finished.note': "这一段录完了 —— agent 会自己来取并收工，不用你点";
     readonly 'record.act.cancel': "取消";
@@ -436,6 +440,8 @@ export declare const zh: {
     readonly 'approval.record.noUrl': "没给站点地址（这次会被当场拒）";
     readonly 'approval.record.oneAction': "一次操作";
     readonly 'approval.record.noSwitch': "录完不会替你切回来（左栏底部会亮一条状态）";
+    readonly 'approval.longTask.what': "要停的那一趟";
+    readonly 'approval.longTask.signal': "停了只是让外壳发出中断信号 —— 平台侧那趟活儿的收尾看模块自己";
 };
 /** 中文词表的键类型：`en` 与模块词表都得覆盖同一批键。 */
 export type WorkbenchMessages = typeof zh;

package/dist/i18n/zh.js

@@ -37,6 +37,7 @@ export const zh = {
     'session.actions': '{name} 的操作',
     'status.idle': '空闲',
     'status.running': '进行中',
+    'status.longTask': '长任务在跑',
     'status.waitingApproval': '等待审批',
     'status.planReview': '计划待审',
     'status.waitingAnswer': '等待回答',
@@ -50,6 +51,8 @@ export const zh = {
     'project.attention.warning.other': '{n} 个会话在等你点头',
     'project.attention.running.one': '1 个会话在跑',
     'project.attention.running.other': '{n} 个会话在跑',
+    'project.attention.longTask.one': '1 个长任务在跑',
+    'project.attention.longTask.other': '{n} 个长任务在跑',
     'project.attention.done.one': '1 个会话跑完没看',
     'project.attention.done.other': '{n} 个会话跑完没看',
     'project.attention.state.warning': '待审批',
@@ -426,6 +429,7 @@ export const zh = {
     'record.waiting.note': '请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）',
     'record.recording': '录制中',
     'record.recording.note': '做完按「结束录制」；浮条没了按「停」，让 agent 先取再收',
+    'record.recording.shots': '；想留一张现场就按浮条上的「截图」（已拍 {n} 张）',
     'record.finished': '录制完成',
     'record.finished.note': '这一段录完了 —— agent 会自己来取并收工，不用你点',
     'record.act.cancel': '取消',
@@ -436,4 +440,6 @@ export const zh = {
     'approval.record.noUrl': '没给站点地址（这次会被当场拒）',
     'approval.record.oneAction': '一次操作',
     'approval.record.noSwitch': '录完不会替你切回来（左栏底部会亮一条状态）',
+    'approval.longTask.what': '要停的那一趟',
+    'approval.longTask.signal': '停了只是让外壳发出中断信号 —— 平台侧那趟活儿的收尾看模块自己',
 };

package/dist/index.d.ts

@@ -7,7 +7,6 @@ export * from './api/facts.js';
 export * from './api/host-write.js';
 export * from './api/long-task.js';
 export * from './api/unit-board.js';
-export * from './api/unit-declaration.js';
 export * from './api/unit.js';
 export * from './api/workbench-client.js';
 export * from './api/workbench-contract.js';
@@ -19,6 +18,7 @@ export * from './components/CardAnchor.js';
 export * from './components/CardBoundary.js';
 export * from './components/CardHead.js';
 export * from './components/ChoiceGroup.js';
+export * from './components/ConfirmBar.js';
 export * from './components/Field.js';
 export * from './components/Form.js';
 export * from './components/FormActions.js';
@@ -49,10 +49,7 @@ export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';
 export * from './lib/board-fact.js';
 export * from './lib/busy.js';
-export * from './lib/diy-debug.js';
-export * from './lib/diy-record.js';
 export * from './lib/form-problem.js';
-export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';

package/dist/index.js

@@ -7,7 +7,6 @@ export * from './api/facts.js';
 export * from './api/host-write.js';
 export * from './api/long-task.js';
 export * from './api/unit-board.js';
-export * from './api/unit-declaration.js';
 export * from './api/unit.js';
 export * from './api/workbench-client.js';
 export * from './api/workbench-contract.js';
@@ -19,6 +18,7 @@ export * from './components/CardAnchor.js';
 export * from './components/CardBoundary.js';
 export * from './components/CardHead.js';
 export * from './components/ChoiceGroup.js';
+export * from './components/ConfirmBar.js';
 export * from './components/Field.js';
 export * from './components/Form.js';
 export * from './components/FormActions.js';
@@ -49,10 +49,7 @@ export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';
 export * from './lib/board-fact.js';
 export * from './lib/busy.js';
-export * from './lib/diy-debug.js';
-export * from './lib/diy-record.js';
 export * from './lib/form-problem.js';
-export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';

package/dist/lib/board-fact.d.ts

@@ -24,13 +24,6 @@ export interface BoardProbe {
  * @returns 同一个路径或在其下给 `true`；`root` 末尾带不带斜杠都认（`/a` 不匹配 `/ab`）。
  */
 export declare function insideWorkshop(root: string, target: string): boolean;
-/**
- * 把一次探针读数归成椅面归属。
- * @param probe - 探针读数。
- * @param workshop - 当前工作区根路径；`null` 表示还不知道当前是哪个工作区。
- * @returns 外壳不在、或板路径与工作区缺一 → `unknown`；右栏没开或没画出来 → `hidden`；板在本工作区 → `workshop`，否则 `other`。
- */
-export declare function boardFactOf(probe: BoardProbe, workshop: string | null): BoardFactState;
 /**
  * 把探针读数归成左栏那句人话的档位。
  * @param probe - 探针读数。

package/dist/lib/board-fact.js

@@ -10,21 +10,6 @@ export function insideWorkshop(root, target) {
     const base = root.endsWith('/') ? root : `${root}/`;
     return target.startsWith(base);
 }
-/**
- * 把一次探针读数归成椅面归属。
- * @param probe - 探针读数。
- * @param workshop - 当前工作区根路径；`null` 表示还不知道当前是哪个工作区。
- * @returns 外壳不在、或板路径与工作区缺一 → `unknown`；右栏没开或没画出来 → `hidden`；板在本工作区 → `workshop`，否则 `other`。
- */
-export function boardFactOf(probe, workshop) {
-    if (!probe.workbench)
-        return 'unknown';
-    if (!probe.bar || !probe.open || !probe.drawn)
-        return 'hidden';
-    if (probe.board === '' || workshop === null)
-        return 'unknown';
-    return insideWorkshop(workshop, probe.board) ? 'workshop' : 'other';
-}
 /**
  * 把探针读数归成左栏那句人话的档位。
  * @param probe - 探针读数。

package/dist/lib/diy-record.d.ts

@@ -14,7 +14,29 @@ export interface RecordExpect {
     readonly urlContains: string;
 }
 /**
- * 一份活着的录制约定：相位 + 谁的会话 + 哪个工作区 / 单元 + 页面 URL 与标题 + 要找的那一次写 + 落盘文件 + 三个时间戳。
+ * 一次「截图」在宿主台账里的那一行：页面上的计数、落图那一刻、落盘路径；没落下来时带 `error` 原文（落成的那条没有它）。
+ */
+export interface RecordShot {
+    readonly n: number;
+    readonly at: number;
+    readonly path: string;
+    readonly error?: string;
+}
+/**
+ * 某个页面计数已经试过几次：初拍算一次，失败再试一次；计数一换就从头数。
+ */
+export interface RecordShotTries {
+    readonly n: number;
+    readonly tries: number;
+}
+/**
+ * 一张图最多试几次（初拍 + 一次重试）：失败如实报过就停，不每拍重试到底。
+ */
+export declare const RECORD_SHOT_TRIES = 2;
+/**
+ * 一份活着的录制约定：相位 + 谁的会话 + 哪个工作区 / 单元 + 页面 URL 与标题 + 要找的那一次写 +
+ * 落盘文件 + 三个时间戳，以及两份台账：按计数落图的 `shots`（`shotsSeen` 只记落成的那个计数）
+ * 与门铃的 `beats` / `beatMs`（命中几次、最近一次等了多久）。
  */
 export interface RecordState {
     readonly phase: RecordPhase;
@@ -30,6 +52,11 @@ export interface RecordState {
     readonly startedAt: number;
     readonly t0: number | null;
     readonly t1: number | null;
+    readonly shots: readonly RecordShot[];
+    readonly shotsSeen: number;
+    readonly shotTries: RecordShotTries | null;
+    readonly beats: number;
+    readonly beatMs: number;
     readonly at: number;
 }
 /**
@@ -83,8 +110,18 @@ export interface RecordStore {
     begin(pact: RecordPact): RecordMove;
     started(sessionId: string, at: number, now: number): RecordMove;
     finished(sessionId: string, at: number, now: number): RecordMove;
+    shotTaken(sessionId: string, shot: RecordShot, now: number): RecordMove;
+    shotFailed(sessionId: string, shot: RecordShot, now: number): RecordMove;
+    beat(sessionId: string, ms: number, now: number): RecordMove;
     stop(sessionId: string, now: number): RecordMove;
 }
+/**
+ * 这一拍该不该落图：页面计数涨过 `shotsSeen` 才算；同一个计数已经试满就先放下，等他自己再按。
+ * @param state - 当前有效的那份约定。
+ * @param pageShots - 页面浮条上那个「已拍」计数。
+ * @returns 该落的那个计数；不该落给 `null`（没涨 / 试满了 / 不是个正经数）。
+ */
+export declare function shotDueOf(state: RecordState, pageShots: number): number | null;
 /**
  * 造一份新的录制约定存储（进程内存，同一时刻只可能有一份有效约定）。
  * @returns 存取口；动作成不成都在返回的 `RecordMove` 里，不抛异常。

package/dist/lib/diy-record.js

@@ -2,6 +2,10 @@
  * 录制约定的有效期（15 分钟，毫秒）：超过它没动静的约定算过期、当场让人。
  */
 export const RECORD_STALE_MS = 15 * 60 * 1000;
+/**
+ * 一张图最多试几次（初拍 + 一次重试）：失败如实报过就停，不每拍重试到底。
+ */
+export const RECORD_SHOT_TRIES = 2;
 /**
  * 把工具入参收成人话动作。
  * @param raw - 任意入参值。
@@ -10,6 +14,22 @@ export const RECORD_STALE_MS = 15 * 60 * 1000;
 export function parseRecordIntent(raw) {
     return raw === 'peek' || raw === 'halt' || raw === 'stop' ? raw : null;
 }
+/**
+ * 这一拍该不该落图：页面计数涨过 `shotsSeen` 才算；同一个计数已经试满就先放下，等他自己再按。
+ * @param state - 当前有效的那份约定。
+ * @param pageShots - 页面浮条上那个「已拍」计数。
+ * @returns 该落的那个计数；不该落给 `null`（没涨 / 试满了 / 不是个正经数）。
+ */
+export function shotDueOf(state, pageShots) {
+    if (!Number.isFinite(pageShots))
+        return null;
+    const n = Math.floor(pageShots);
+    if (n <= state.shotsSeen)
+        return null;
+    if (state.shotTries !== null && state.shotTries.n === n && state.shotTries.tries >= RECORD_SHOT_TRIES)
+        return null;
+    return n;
+}
 function alive(state, now) {
     if (state === null)
         return null;
@@ -28,6 +48,18 @@ function ownerOf(state, sessionId, now) {
 export function createRecordStore() {
     let held = null;
     const live = (now) => alive(held, now);
+    const withShot = (found, shot, now, error) => {
+        const row = error === undefined ? shot : { n: shot.n, at: shot.at, path: shot.path, error };
+        const kept = found.shots.filter((one) => one.n !== shot.n);
+        const tries = found.shotTries !== null && found.shotTries.n === shot.n ? found.shotTries.tries : 0;
+        return {
+            ...found,
+            shots: [...kept, row].sort((one, two) => one.n - two.n),
+            shotsSeen: error === undefined ? Math.max(found.shotsSeen, shot.n) : found.shotsSeen,
+            shotTries: error === undefined ? null : { n: shot.n, tries: tries + 1 },
+            at: now,
+        };
+    };
     return {
         live,
         begin(pact) {
@@ -49,6 +81,11 @@ export function createRecordStore() {
                 startedAt: pact.now,
                 t0: null,
                 t1: null,
+                shots: [],
+                shotsSeen: 0,
+                shotTries: null,
+                beats: 0,
+                beatMs: 0,
                 at: pact.now,
             };
             held = state;
@@ -76,6 +113,35 @@ export function createRecordStore() {
             held = state;
             return { ok: true, state };
         },
+        shotTaken(sessionId, shot, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            const state = withShot(found, shot, now, undefined);
+            held = state;
+            return { ok: true, state };
+        },
+        shotFailed(sessionId, shot, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            const state = withShot(found, shot, now, shot.error === undefined ? '落图失败' : shot.error);
+            held = state;
+            return { ok: true, state };
+        },
+        beat(sessionId, ms, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            const state = {
+                ...found,
+                beats: found.beats + 1,
+                beatMs: Math.max(0, Math.floor(ms)),
+                at: now,
+            };
+            held = state;
+            return { ok: true, state };
+        },
         stop(sessionId, now) {
             const found = ownerOf(held, sessionId, now);
             if (typeof found === 'string')

package/dist/lib/text.d.ts

@@ -1,16 +1,3 @@
-/**
- * 把一个值裹成 shell 里的单引号字面量（值里的单引号一并转义），保证元字符按字面量传递。
- * @param value - 任意值；不是字符串的先 `String()`。
- * @returns 可安全拼进 `/bin/sh -c` 的一段文本 —— 含空格 / `$()` / `;` / 通配符的值都不会被当成语法。
- */
-export declare function quoteShellArg(value: unknown): string;
-/**
- * 取一段文本的末尾若干行（如命令输出），顺带去掉首尾空白。
- * @param text - 原文；`null` / `undefined` 当空串。
- * @param lines - 最多留几行，默认 6；0 给全篇、负数从开头砍掉那么多行（都是 `slice` 语义），调用方传正数。
- * @returns 末尾若干行、去首尾空行后的文本；原文行数不够就全给，空输入给空串。
- */
-export declare function tailLines(text: string | null | undefined, lines?: number): string;
 /**
  * 宽松解析一段前后可能夹着人话的 JSON：整段不通就从行首的 `[` / `{` 起、截到最后一个闭合符再试。
  * @param text - 原文；`null` / `undefined` 当空串。