@takboo/dsh-coopanion 0.4.9 → 0.4.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -105
- package/desktop/keyboard-activity-win.cs +52 -0
- package/desktop/keyboard-activity-x11.py +77 -0
- package/desktop/keyboard-activity.cjs +54 -0
- package/desktop/keyboard-activity.jxa +27 -0
- package/desktop/lifecycle-state-macos.jxa +16 -0
- package/desktop/lifecycle-state.cjs +21 -0
- package/desktop/main.cjs +73 -13
- package/desktop/preload.cjs +3 -0
- package/dist/bridge.js.map +2 -2
- package/dist/build-info.json +6 -0
- package/dist/client.js +72 -1
- package/dist/companion-store.cjs +19907 -0
- package/dist/diagnostics.cjs +170 -0
- package/dist/figure-server.cjs +19725 -23
- package/dist/index.js +48 -3
- package/dist/index.js.map +3 -3
- package/docs/README.md +67 -0
- package/docs/archive/2026-10-m1-m6/roadmap.md +186 -0
- package/docs/{notification-implementation.md → archive/2026-10-notifications/notification-implementation.md} +3 -1
- package/docs/{notification-n0.md → archive/2026-10-notifications/notification-n0.md} +8 -6
- package/docs/{notification-n3.md → archive/2026-10-notifications/notification-n3.md} +2 -0
- package/docs/{notification-n4.md → archive/2026-10-notifications/notification-n4.md} +2 -0
- package/docs/{notification-plan.md → archive/2026-10-notifications/notification-plan.md} +4 -2
- package/docs/archive/2026-10-p1/roadmap-20261015.md +150 -0
- package/docs/archive/README.md +12 -0
- package/docs/archive/npm-bootstrap.md +18 -0
- package/docs/assets/README.md +16 -0
- package/docs/assets/showcase/appearance.png +0 -0
- package/docs/assets/showcase/companion.gif +0 -0
- package/docs/assets/showcase/conversation.png +0 -0
- package/docs/assets/showcase/inbox.png +0 -0
- package/docs/character-art-pipeline.md +122 -0
- package/docs/characters.md +10 -2
- package/docs/companionship-contract.md +70 -0
- package/docs/daily-rhythm-contract.md +4 -2
- package/docs/desktop-recovery-contract.md +4 -0
- package/docs/development.md +87 -0
- package/docs/diagnostics-contract.md +43 -0
- package/docs/evidence/AGENTS.md +5 -0
- package/docs/evidence/README.md +22 -0
- package/docs/evidence/p1/README.md +86 -0
- package/docs/evidence/p1/baseline-idle.json +8030 -0
- package/docs/evidence/p1/baseline-inbox-ui-native-access.log +47 -0
- package/docs/evidence/p1/baseline-inbox-ui-rerun.log +41 -0
- package/docs/evidence/p1/baseline-inbox-ui.log +15 -0
- package/docs/evidence/p1/baseline-unit.log +62 -0
- package/docs/evidence/p1/cadence-day.json +8394 -0
- package/docs/evidence/p1/cadence-night.json +8394 -0
- package/docs/evidence/p1/cadence-off.json +8034 -0
- package/docs/evidence/p1/companionship-installed-0.2.0-rc.2.json +13 -0
- package/docs/evidence/p1/companionship-installed-0.2.1-alpha.1.json +13 -0
- package/docs/evidence/p1/companionship-installed-s3-0.2.0-rc.2.json +13 -0
- package/docs/evidence/p1/companionship-installed-s3-0.2.1-alpha.1.json +13 -0
- package/docs/evidence/p1/companionship-invitation-s3.png +0 -0
- package/docs/evidence/p1/companionship-invitation.png +0 -0
- package/docs/evidence/p1/companionship-native-s3.json +22 -0
- package/docs/evidence/p1/companionship-native.json +22 -0
- package/docs/evidence/p1/companionship-small-menu-s3.png +0 -0
- package/docs/evidence/p1/companionship-small-menu.png +0 -0
- package/docs/evidence/p1/diagnostics-20261016/README.md +44 -0
- package/docs/evidence/p1/diagnostics-20261016/build-info.json +6 -0
- package/docs/evidence/p1/diagnostics-20261016/candidate-verification.json +7 -0
- package/docs/evidence/p1/diagnostics-20261016/installed-alpha1.json +15 -0
- package/docs/evidence/p1/diagnostics-20261016/installed-rc2.json +15 -0
- package/docs/evidence/p1/diagnostics-20261016/local-collector-processes.json +24 -0
- package/docs/evidence/p1/diagnostics-20261016/local-daily-files.json +6 -0
- package/docs/evidence/p1/diagnostics-20261016/local-daily-install.json +73 -0
- package/docs/evidence/p1/diagnostics-20261016/local-profile-update.json +9 -0
- package/docs/evidence/p1/diagnostics-20261016/local-progress-at-handoff.json +119 -0
- package/docs/evidence/p1/diagnostics-20261016/local-sampler-metadata.json +18 -0
- package/docs/evidence/p1/diagnostics-20261016/local-seven-day-launch.json +11 -0
- package/docs/evidence/p1/diagnostics-20261016/sha256.json +18 -0
- package/docs/evidence/p1/diagnostics-20261016/validation.json +40 -0
- package/docs/evidence/p1/diagnostics-20261016/vm-smoke-metadata.json +102 -0
- package/docs/evidence/p1/diagnostics-20261016/vm-smoke-summary.json +134 -0
- package/docs/evidence/p1/diagnostics-20261016/vm-two-hour-progress-at-handoff.json +145 -0
- package/docs/evidence/p1/diagnostics-20261016/vm-two-hour-start-metadata.json +102 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/README.md +27 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/candidate-ci-check.json +1 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/documentation-checks.json +28 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/local-configuration-check.json +85 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/local-controller-check.json +11 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/local-metadata.json +18 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/local-progress.json +126 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/remote-delivery-check.json +21 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/sha256.json +10 -0
- package/docs/evidence/p1/diagnostics-followup-20261016/vm-progress.json +145 -0
- package/docs/evidence/p1/experience-rejected-20261016/README.md +24 -0
- package/docs/evidence/p1/experience-rejected-20261016/feedback-and-decision.json +22 -0
- package/docs/evidence/p1/experience-rejected-20261016/local-controller-final.json +13 -0
- package/docs/evidence/p1/experience-rejected-20261016/local-events.ndjson +58 -0
- package/docs/evidence/p1/experience-rejected-20261016/local-metadata.json +18 -0
- package/docs/evidence/p1/experience-rejected-20261016/local-samples.ndjson +112 -0
- package/docs/evidence/p1/experience-rejected-20261016/local-summary.json +112 -0
- package/docs/evidence/p1/experience-rejected-20261016/sha256.json +8 -0
- package/docs/evidence/p1/final-day.json +8394 -0
- package/docs/evidence/p1/final-night.json +8394 -0
- package/docs/evidence/p1/final-off.json +8034 -0
- package/docs/evidence/p1/final-resource-comparison-s2.json +27 -0
- package/docs/evidence/p1/implementation-day.json +8586 -0
- package/docs/evidence/p1/implementation-night.json +8394 -0
- package/docs/evidence/p1/implementation-off.json +8034 -0
- package/docs/evidence/p1/implementation-s1.json +29 -0
- package/docs/evidence/p1/implementation-s2.json +41 -0
- package/docs/evidence/p1/implementation-s3.json +54 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/README.md +43 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/SHA256SUMS +28 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/build-info.json +6 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/initial-record-at-e820baf.md +39 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/install-0.2.0-rc.2.json +28 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/install-0.2.1-alpha.1.json +28 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/install-alpha.log +36 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/install-rc.log +36 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/README.md +11 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-confirmed.json +42 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-initial.json +40 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-mouse-package.json +48 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-panel-timeout.log +9 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/package-linux-arm64-helper.log +8 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/package-linux-keyboard.json +30 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/package-linux-keyboard.log +1 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-keyboard.json +23 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-keyboard.log +1 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-npc.json +22 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-npc.log +1 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/physical-acceptance-SHA256SUMS +4 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/physical-acceptance.json +50 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-focused-probe.mjs +45 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-package.json +71 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-probe.mjs +43 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-waiting.log +3 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel.log +4 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/previous-packages.json +12 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/protected-bytes.json +5 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/protected-final.json +6 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/source-binding.json +13 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/unit.log +74 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/validation.json +40 -0
- package/docs/evidence/p1/keyboard-platforms-20261016/verification.json +7 -0
- package/docs/evidence/p1/keyboard-vm-20261016/README.md +51 -0
- package/docs/evidence/p1/keyboard-vm-20261016/SHA256SUMS +44 -0
- package/docs/evidence/p1/keyboard-vm-20261016/cleanup-vms.json +29 -0
- package/docs/evidence/p1/keyboard-vm-20261016/cleanup-vms.stderr +0 -0
- package/docs/evidence/p1/keyboard-vm-20261016/create-linux.log +14 -0
- package/docs/evidence/p1/keyboard-vm-20261016/create-windows.json +1 -0
- package/docs/evidence/p1/keyboard-vm-20261016/create-windows.stderr +0 -0
- package/docs/evidence/p1/keyboard-vm-20261016/dhcp-leases-after.stderr +2 -0
- package/docs/evidence/p1/keyboard-vm-20261016/dhcp-leases-after.txt +0 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/cleanup-vms.py +49 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/inject-vm.py +35 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/install-linux.sh +17 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/prepare-windows-console.ps1 +52 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/retry-windows-validation.ps1 +17 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/run-linux-package-probe.py +13 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/run-linux-probe.py +13 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/run-windows-probe.py +17 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/setup-linux.sh +21 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/setup-windows.ps1 +33 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/start-windows-probe.ps1 +20 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/vm-npc-probe-preflight.mjs +45 -0
- package/docs/evidence/p1/keyboard-vm-20261016/harness/vm-npc-probe.mjs +46 -0
- package/docs/evidence/p1/keyboard-vm-20261016/host-after-cleanup.txt +8 -0
- package/docs/evidence/p1/keyboard-vm-20261016/install-linux.log +8 -0
- package/docs/evidence/p1/keyboard-vm-20261016/linux-environment.txt +34 -0
- package/docs/evidence/p1/keyboard-vm-20261016/linux-keyboard-native.json +24 -0
- package/docs/evidence/p1/keyboard-vm-20261016/linux-qmp-npc.log +9 -0
- package/docs/evidence/p1/keyboard-vm-20261016/linux-qmp-package-npc.log +9 -0
- package/docs/evidence/p1/keyboard-vm-20261016/linux-rebuilt-preflight.json +100 -0
- package/docs/evidence/p1/keyboard-vm-20261016/linux-result.json +100 -0
- package/docs/evidence/p1/keyboard-vm-20261016/linux-validation.log +75 -0
- package/docs/evidence/p1/keyboard-vm-20261016/node-win-checksum.json +5 -0
- package/docs/evidence/p1/keyboard-vm-20261016/protected-bytes.json +6 -0
- package/docs/evidence/p1/keyboard-vm-20261016/setup-linux.log +765 -0
- package/docs/evidence/p1/keyboard-vm-20261016/setup-windows.log +92 -0
- package/docs/evidence/p1/keyboard-vm-20261016/summary.json +54 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-autologin-cleanup.json +1 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-console-preparation.json +6 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-console-state-1.json +1 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-final-state.txt +4 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-keyboard-native.json +24 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-keyboard-native.log +1 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-qmp-console.log +110 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-result.json +101 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-validation-retry.log +90 -0
- package/docs/evidence/p1/keyboard-vm-20261016/windows-vm-raw.log +6 -0
- package/docs/evidence/p1/npc-capability-20261016/README.md +27 -0
- package/docs/evidence/p1/npc-capability-20261016/initial-probe.log +14 -0
- package/docs/evidence/p1/npc-capability-20261016/initial-probe.mjs +51 -0
- package/docs/evidence/p1/npc-capability-20261016/inventory.json +123 -0
- package/docs/evidence/p1/npc-capability-20261016/probe.log +1 -0
- package/docs/evidence/p1/npc-capability-20261016/probe.mjs +56 -0
- package/docs/evidence/p1/npc-capability-20261016/report.json +180 -0
- package/docs/evidence/p1/npc-capability-20261016/sha256.json +8 -0
- package/docs/evidence/p1/npc-life-20261016/README.md +56 -0
- package/docs/evidence/p1/npc-life-20261016/SHA256SUMS +47 -0
- package/docs/evidence/p1/npc-life-20261016/SHA256SUMS.initial +41 -0
- package/docs/evidence/p1/npc-life-20261016/actual-input.json +1069 -0
- package/docs/evidence/p1/npc-life-20261016/attempts/desktop-geometry-startup.log +96 -0
- package/docs/evidence/p1/npc-life-20261016/attempts/desktop-physical-cursor-interruption.log +19 -0
- package/docs/evidence/p1/npc-life-20261016/attempts/inbox-first.log +85 -0
- package/docs/evidence/p1/npc-life-20261016/attempts/initial-companion-ui.log +31 -0
- package/docs/evidence/p1/npc-life-20261016/attempts/install-rc-first.log +191 -0
- package/docs/evidence/p1/npc-life-20261016/attempts/native-first.log +11 -0
- package/docs/evidence/p1/npc-life-20261016/attempts/native-geometry-first.log +89 -0
- package/docs/evidence/p1/npc-life-20261016/baseline.json +1029 -0
- package/docs/evidence/p1/npc-life-20261016/build-info.json +6 -0
- package/docs/evidence/p1/npc-life-20261016/companionship-installed-0.2.0-rc.2.json +13 -0
- package/docs/evidence/p1/npc-life-20261016/companionship-installed-0.2.1-alpha.1.json +13 -0
- package/docs/evidence/p1/npc-life-20261016/controlled-idle.json +1069 -0
- package/docs/evidence/p1/npc-life-20261016/daily-rhythm-installed-0.2.0-rc.2.json +14 -0
- package/docs/evidence/p1/npc-life-20261016/daily-rhythm-installed-0.2.1-alpha.1.json +14 -0
- package/docs/evidence/p1/npc-life-20261016/desktop.log +12 -0
- package/docs/evidence/p1/npc-life-20261016/diagnostics-installed-0.2.0-rc.2.json +15 -0
- package/docs/evidence/p1/npc-life-20261016/diagnostics-installed-0.2.1-alpha.1.json +15 -0
- package/docs/evidence/p1/npc-life-20261016/final-integrity.json +12 -0
- package/docs/evidence/p1/npc-life-20261016/general-ui-source.log +24 -0
- package/docs/evidence/p1/npc-life-20261016/general-ui.log +24 -0
- package/docs/evidence/p1/npc-life-20261016/inbox-ui.log +67 -0
- package/docs/evidence/p1/npc-life-20261016/install-0.2.0-rc.2.json +28 -0
- package/docs/evidence/p1/npc-life-20261016/install-0.2.1-alpha.1.json +28 -0
- package/docs/evidence/p1/npc-life-20261016/install-alpha.log +36 -0
- package/docs/evidence/p1/npc-life-20261016/install-rc.log +36 -0
- package/docs/evidence/p1/npc-life-20261016/multi-display-installed-0.2.0-rc.2.json +581 -0
- package/docs/evidence/p1/npc-life-20261016/multi-display-installed-0.2.1-alpha.1.json +581 -0
- package/docs/evidence/p1/npc-life-20261016/notification-ui-source.log +5 -0
- package/docs/evidence/p1/npc-life-20261016/notification-ui.log +5 -0
- package/docs/evidence/p1/npc-life-20261016/npc-life-native-home.png +0 -0
- package/docs/evidence/p1/npc-life-20261016/npc-life-native.json +20 -0
- package/docs/evidence/p1/npc-life-20261016/npc-life-observe.png +0 -0
- package/docs/evidence/p1/npc-life-20261016/package-native.log +1 -0
- package/docs/evidence/p1/npc-life-20261016/preserved-originals.json +21 -0
- package/docs/evidence/p1/npc-life-20261016/resources.log +9 -0
- package/docs/evidence/p1/npc-life-20261016/source-binding.json +13 -0
- package/docs/evidence/p1/npc-life-20261016/source-verify.log +7 -0
- package/docs/evidence/p1/npc-life-20261016/text-scale-installed-0.2.0-rc.2.json +653 -0
- package/docs/evidence/p1/npc-life-20261016/text-scale-installed-0.2.1-alpha.1.json +653 -0
- package/docs/evidence/p1/npc-life-20261016/typecheck.log +4 -0
- package/docs/evidence/p1/npc-life-20261016/unit.log +69 -0
- package/docs/evidence/p1/npc-life-20261016/validation.json +33 -0
- package/docs/evidence/p1/npc-life-20261016/verification.json +7 -0
- package/docs/evidence/p1/npc-life-20261016/verify-source.py +22 -0
- package/docs/evidence/p1/p1-cadence-desktop.log +10 -0
- package/docs/evidence/p1/p1-cadence-inbox-ui.log +65 -0
- package/docs/evidence/p1/p1-cadence-notification-ui.log +5 -0
- package/docs/evidence/p1/p1-cadence-package-check.log +1 -0
- package/docs/evidence/p1/p1-cadence-ui-full.log +24 -0
- package/docs/evidence/p1/p1-final-desktop.log +10 -0
- package/docs/evidence/p1/p1-final-inbox-ui.log +63 -0
- package/docs/evidence/p1/p1-final-notification-ui.log +5 -0
- package/docs/evidence/p1/p1-final-typecheck.log +4 -0
- package/docs/evidence/p1/p1-final-ui.log +24 -0
- package/docs/evidence/p1/p1-final-unit.log +68 -0
- package/docs/evidence/p1/p1-s3-install-alpha1.redacted.log +34 -0
- package/docs/evidence/p1/p1-s3-install-rc2.redacted.log +34 -0
- package/docs/evidence/p1/p1-s3-metadata.log +5 -0
- package/docs/evidence/p1/p1-s3-resource.log +12 -0
- package/docs/evidence/p1/p1-s3-typecheck.log +4 -0
- package/docs/evidence/p1/p1-s3-unit.log +68 -0
- package/docs/evidence/p1/p1-verified-install-alpha1.redacted.log +35 -0
- package/docs/evidence/p1/p1-verified-install-rc2.redacted.log +35 -0
- package/docs/evidence/p1/p1-verified-package-check.log +1 -0
- package/docs/evidence/p1/paired-diagnostic-s2.json +61 -0
- package/docs/evidence/p1/paired-diagnostic-s3.json +61 -0
- package/docs/evidence/p1/resource-comparison-s3.json +33 -0
- package/docs/evidence/p1/resource-comparison.json +27 -0
- package/docs/evidence/p1/vm-20261016/README.md +43 -0
- package/docs/evidence/p1/vm-20261016/SHA256SUMS +6 -0
- package/docs/evidence/p1/vm-20261016/candidate-source-check.json +195 -0
- package/docs/evidence/p1/vm-20261016/environment-during-run.txt +70 -0
- package/docs/evidence/p1/vm-20261016/long-start-metadata.json +48 -0
- package/docs/evidence/p1/vm-20261016/observer-v1/observe-companion.mjs +279 -0
- package/docs/evidence/p1/vm-20261016/observer-v1/resource-observation.mjs +89 -0
- package/docs/evidence/p1/vm-20261016/observer-v1/run-resource-observation.sh +34 -0
- package/docs/evidence/p1/vm-20261016/observer-v1-SHA256SUMS +3 -0
- package/docs/evidence/p1/vm-20261016/old-run-partial-SHA256SUMS +3 -0
- package/docs/evidence/p1/vm-20261016/old-run-partial-samples.ndjson +554 -0
- package/docs/evidence/p1/vm-20261016/old-run-partial-summary.json +101 -0
- package/docs/evidence/p1/vm-20261016/old-run-stop.json +6 -0
- package/docs/evidence/p1/vm-20261016/smoke-metadata.json +48 -0
- package/docs/evidence/p1/vm-20261016/smoke-samples.ndjson +12 -0
- package/docs/evidence/p1/vm-20261016/smoke-summary.json +94 -0
- package/docs/evidence/releases/v0.4.9/README.md +18 -0
- package/docs/evidence/releases/v0.4.9/delivery-verification.json +480 -0
- package/docs/multi-display-contract.md +4 -4
- package/docs/notification-contract.md +7 -5
- package/docs/npc-daily-life-plan.md +80 -0
- package/docs/release-notes.md +15 -0
- package/docs/releasing.md +5 -16
- package/docs/roadmap.md +69 -153
- package/docs/text-readability-contract.md +2 -2
- package/docs/usage.md +157 -0
- package/npm-shrinkwrap.json +2 -2
- package/package.json +3 -2
- package/scripts/build.mjs +22 -1
- package/scripts/capture-showcase.mjs +81 -0
- package/scripts/check-package.mjs +8 -0
- package/scripts/diagnostics-client.mjs +89 -0
- package/scripts/measure-idle.mjs +11 -7
- package/scripts/observe-companion.mjs +166 -0
- package/scripts/preview.mjs +2 -1
- package/scripts/resource-observation.mjs +117 -0
- package/scripts/run-resource-observation.sh +34 -0
- package/scripts/sample-companion.mjs +156 -0
- package/src/bridge.ts +2 -1
- package/src/client/Settings.tsx +9 -3
- package/src/client/locales.ts +4 -0
- package/src/companion-store.ts +149 -0
- package/src/diagnostics.ts +98 -0
- package/src/figure-server.ts +18 -4
- package/src/index.ts +12 -7
- package/tests/bridge.test.ts +3 -3
- package/tests/companion-client.test.js +22 -0
- package/tests/companion-http.test.ts +24 -0
- package/tests/companion-store.test.ts +77 -0
- package/tests/companion-touch.test.js +20 -0
- package/tests/companionship-native.mjs +44 -0
- package/tests/companionship-ui.mjs +315 -0
- package/tests/companionship.test.js +57 -0
- package/tests/desktop.mjs +4 -0
- package/tests/diagnostics-native.mjs +82 -0
- package/tests/diagnostics.test.js +133 -0
- package/tests/helpers/body-startup.mjs +31 -0
- package/tests/helpers/companionship.mjs +25 -0
- package/tests/helpers/keyboard-x11-probe.py +60 -0
- package/tests/helpers/native-pointer.mjs +10 -0
- package/tests/helpers/npc-life.mjs +24 -0
- package/tests/install.mjs +42 -1
- package/tests/keyboard-activity-native.mjs +40 -0
- package/tests/keyboard-activity.test.js +102 -0
- package/tests/lifecycle-startup-native.mjs +47 -0
- package/tests/lifecycle-state.test.js +44 -0
- package/tests/npc-life-native.mjs +52 -0
- package/tests/npc-life.test.js +77 -0
- package/tests/plugin.test.ts +28 -0
- package/tests/render-cadence.test.js +20 -0
- package/tests/resource-observation.test.js +52 -0
- package/tests/session-replies-ui.mjs +3 -1
- package/tests/text-scale-ui.mjs +3 -1
- package/web/companion-client.js +32 -0
- package/web/companion-touch.js +15 -0
- package/web/companionship.d.ts +12 -0
- package/web/companionship.js +80 -0
- package/web/diagnostics.js +13 -0
- package/web/index.html +9 -0
- package/web/locale.js +2 -0
- package/web/npc-life.js +91 -0
- package/web/pet.js +186 -20
- package/web/render-cadence.js +6 -0
- package/web/style.css +13 -1
- package/web/upstream/LICENSE +661 -0
- package/web/upstream/UPSTREAM.md +2 -0
package/README.md
CHANGED
|
@@ -1,150 +1,105 @@
|
|
|
1
|
-
# DeepSeek 大肥鱼
|
|
1
|
+
# DeepSeek 大肥鱼
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**让 Harness 的工作,有个看得见的小伙伴。**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
大肥鱼住在你的桌面上,陪你一起用 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 工作。她会思考、挥手、陪你等结果,也会把回复和待办捎到桌边。双击她,就能接着刚才的对话聊下去。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
[](https://github.com/takboo/dsh-coopanion/releases/latest)
|
|
8
|
+
[](https://github.com/takboo/dsh-coopanion/actions/workflows/ci.yml)
|
|
9
|
+
[](LICENSE)
|
|
8
10
|
|
|
9
|
-
|
|
11
|
+
[**下载插件**](https://github.com/takboo/dsh-coopanion/releases/latest/download/dsh-coopanion.tgz) · [快速开始](#开始一起工作) · [使用指南](docs/usage.md) · [更新记录](https://github.com/takboo/dsh-coopanion/releases/latest)
|
|
10
12
|
|
|
11
|
-
|
|
13
|
+

|
|
12
14
|
|
|
13
|
-
|
|
14
|
-
- 上游动作和表情:走路、跑步、跳跃、挥手、鞠躬、跳舞、坐下、睡眠等;拖拽、抛掷与落地由同一物理系统处理。
|
|
15
|
-
- 最终回复使用描边气泡,短预览在最多约 3 秒内显示;可立即显示、展开完整阅读和返回源会话。嘴部同步与合成音效可关闭,不是 TTS。
|
|
16
|
-
- `figure.json` API 2 ZIP 角色包导入、动画预览、配色 / 多轴换装、切换、删除;角色和搭配在重启后保留。
|
|
17
|
-
- 支持拖拽松手切换到原生鼠标所在显示器,也可从托盘 **移到显示器** 选择;拔掉当前屏后回到有效工作区,其他屏变化保持当前位置,阅读和草稿在当前窗口保留。物理多屏 / 混合 DPI 仍待实机验收,受控与本机结果见 M5 记录。
|
|
18
|
-
- 透明、无边框、置顶桌宠;空白区域点击穿透。点击互动、双击聊天、右键菜单、闲时活动、休息和显示 / 隐藏。
|
|
19
|
-
- 角色周围不显示常驻操作按钮或名称标签;有未读回复、待处理审批 / 提问或异常时出现小信封。聊天面板中点击当前会话可切换对话。
|
|
20
|
-
- Harness 原生 **Settings → 桌宠** 页面:运行状态、启动 / 重启 / 关闭、显示 / 隐藏、角色管理及实时保存的偏好设置。
|
|
21
|
-
- 实时思考 / 生成 / 工具工作动画;完成、审批、AI 提问、出错和各类停止通过角色表情与互动提示呈现。流式片段驱动嘴部,最终回复独立进入阅读气泡;只有已提交目标完成才庆祝,约 2.5 秒后回到待机。普通回合和目标中间轮保留全文及未读,提示“本轮回复已生成”;目标继续、暂停和阻塞分别呈现。
|
|
22
|
-
- 角色显示时由角色提醒;运行中隐藏角色时,可由 Harness 发送系统通知并点击返回源会话。系统通知默认关闭,设置页提供权限申请、测试通知和送达回执。
|
|
23
|
-
- 审批与 AI 提问的待处理列表、默认 10 分钟后的一次自动补提醒及“稍后提醒”;同一会话同时到期的请求合并提示。
|
|
24
|
-
- 会话以真实提问、项目路径、时间和有效短编号区分,支持搜索及键盘切换;旧会话从公开历史恢复提问。
|
|
25
|
-
- 菜单与聊天使用角色风格的描边卡片,颜色跟随换装;摸头、叫醒、拖拽等互动使用上游身体事件。
|
|
26
|
-
- macOS 状态栏采用随系统明暗变化的角色模板图标与状态小图形,不显示状态文字;悬停和菜单保留会话、任务、未读及设置详情,与桌面共用状态判断和持久偏好。
|
|
27
|
-
- 聊天输入通过正式 `sessionController.prompt`(`mode: queue`) 进入 Harness 的持久会话,使用其现有模型、工具和权限。互动和换装不会自动发起模型请求。
|
|
28
|
-
- 菜单提供 **源码 · AGPL**,包含对应源代码、上游运行时、构建脚本和依赖锁文件。
|
|
15
|
+
<sub>实际浏览器界面演示:思考 → 收到回复 → 双击继续聊。演示中的 Harness 任务事件为模拟。</sub>
|
|
29
16
|
|
|
30
|
-
|
|
17
|
+
本页的 npm/Release 安装入口面向已发布版本。0.4.10 新增默认关闭的自主陪伴与本地诊断试用功能,实际发布身份及各项验收状态见[工程文档索引](docs/README.md)。
|
|
31
18
|
|
|
32
|
-
|
|
19
|
+
## 她会做些什么?
|
|
33
20
|
|
|
34
|
-
|
|
21
|
+
### 桌边有个会回应你的小伙伴
|
|
35
22
|
|
|
36
|
-
|
|
23
|
+
眨眼、看向你、挥挥手,拖起来还会晃动、落地。点点她、打个招呼,或者换个模样继续工作。想安静一会儿,可以让她休息、关掉音效,或暂时隐藏。
|
|
37
24
|
|
|
38
|
-
|
|
25
|
+
还可以开启默认关闭的「日常陪伴节奏」:白天偶尔做些小动作,夜间更安静;你在工作、阅读或输入时,她会先让位。
|
|
39
26
|
|
|
40
|
-
|
|
27
|
+
### 工作到哪一步,一眼就知道
|
|
41
28
|
|
|
42
|
-
|
|
29
|
+
思考、生成回复、使用工具,都有对应的表情和动作。目标真正完成时,她才会开心庆祝;需要审批、回答问题或查看异常时,小信封会为你留着入口。
|
|
43
30
|
|
|
44
|
-
|
|
31
|
+
角色隐藏后,还可以按需开启 Harness 系统通知。审批和问题始终由你在 Harness 中处理。
|
|
45
32
|
|
|
46
|
-
|
|
33
|
+
### 把回复带回来,也把对话接下去
|
|
47
34
|
|
|
48
|
-
|
|
35
|
+
小信封收好不同会话的回复与待办。长回复可以展开阅读,支持 Markdown、表格和代码块;新消息到来时,正在读的内容保持原样。
|
|
49
36
|
|
|
50
|
-
|
|
51
|
-
2. 在 Harness 侧边栏 **插件** 页安装压缩包的绝对路径,启用 `dsh-coopanion`。
|
|
52
|
-
3. 完全退出再重新打开 Harness。首次启动时会下载并校验 Electron 44 运行时。
|
|
53
|
-
4. 打开一段 Harness 会话,双击角色聊天,或从 **Settings → 桌宠** 管理角色。
|
|
37
|
+
双击打开聊天,选择一段会话就能继续,包括还没在 Harness 中打开的历史会话。消息沿用该会话的模型、工具和权限,后台任务不会抢走你正在聊的对象。
|
|
54
38
|
|
|
55
|
-
|
|
39
|
+
<p align="center">
|
|
40
|
+
<img src="docs/assets/showcase/conversation.png" width="340" align="top" alt="大肥鱼聊天面板,保留选中的会话并继续输入">
|
|
41
|
+
<img src="docs/assets/showcase/inbox.png" width="340" align="top" alt="多会话回复收件箱,提供完整阅读和继续对话入口">
|
|
42
|
+
</p>
|
|
56
43
|
|
|
57
|
-
|
|
58
|
-
dsh plugin --profile desktop add /absolute/path/dsh-coopanion-0.4.9.tgz
|
|
59
|
-
```
|
|
44
|
+
### 换个模样,照你的习惯来
|
|
60
45
|
|
|
61
|
-
|
|
46
|
+
内置大肥鱼提供多套配色,可以预览动作,也能导入社区制作的角色包。角色大小和文字大小分别调整,小小一只也能把回复看清楚。
|
|
62
47
|
|
|
63
|
-
|
|
48
|
+
<p align="center">
|
|
49
|
+
<img src="docs/assets/showcase/appearance.png" width="340" alt="角色面板中预览 Claude 配色与跳舞动作">
|
|
50
|
+
</p>
|
|
64
51
|
|
|
65
|
-
|
|
52
|
+
想制作自己的角色?从 [API 2 角色指南](docs/characters.md) 和 [最小示例](examples/star) 开始。
|
|
66
53
|
|
|
67
|
-
|
|
54
|
+
## 开始一起工作
|
|
68
55
|
|
|
69
|
-
|
|
56
|
+
需要 **DeepSeek Harness Desktop 0.2.0-rc.2 或 0.2.1-alpha.1**。这是 Harness 插件,聊天使用你在 Harness 中配置的模型,无需另填 API Key。
|
|
70
57
|
|
|
71
|
-
|
|
72
|
-
npm ci --ignore-scripts
|
|
73
|
-
npm run verify:metadata
|
|
74
|
-
npm run setup:electron
|
|
75
|
-
npm run typecheck
|
|
76
|
-
npm test
|
|
77
|
-
npm run build
|
|
78
|
-
npm run character:pack -- examples/star paper-star.zip
|
|
79
|
-
npm run test:ui
|
|
80
|
-
npm run test:notification-ui
|
|
81
|
-
npm run test:desktop
|
|
82
|
-
npm pack
|
|
83
|
-
node scripts/check-package.mjs
|
|
84
|
-
npm run test:install
|
|
85
|
-
```
|
|
58
|
+
### 在 Harness 中从 npm 安装(推荐)
|
|
86
59
|
|
|
87
|
-
|
|
60
|
+
打开侧边栏 **插件 → 添加插件**,在「包名或地址」中填入:
|
|
88
61
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
CI 窗口测试使用隔离数据和测试沙箱参数;Linux 在虚拟显示中运行。普通安装保留 Chromium sandbox、contextIsolation,关闭 Node integration。安装测试中的通知适配器、原生可见性及答复器为受控边界;完整系统实机验收和外部真实模型会话尚未验证。
|
|
62
|
+
```text
|
|
63
|
+
@takboo/dsh-coopanion
|
|
64
|
+
```
|
|
94
65
|
|
|
95
|
-
|
|
66
|
+
点击安装,完成后启用 `dsh-coopanion`,再完全退出并重新打开 Harness。
|
|
96
67
|
|
|
97
|
-
|
|
68
|
+
### 使用 dsh 命令行安装
|
|
98
69
|
|
|
99
|
-
|
|
70
|
+
使用 **Desktop 自带的 `dsh` 命令**。先启动 Desktop 一次完成初始化,完全退出应用后执行:
|
|
100
71
|
|
|
101
72
|
```bash
|
|
102
|
-
|
|
73
|
+
dsh plugin --profile desktop add @takboo/dsh-coopanion
|
|
103
74
|
```
|
|
104
75
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
## 配置与会话
|
|
108
|
-
|
|
109
|
-
**Settings → 桌宠** 沿用 Harness 的主题、中英文与系统语言设置。可控制随 Harness 启动、闲时活动、任务通知、系统通知、待处理请求补提醒、等待时间、角色尺寸(90–240)、文字大小(100% / 125% / 150%)和气泡时长(2–60 秒);数值按 Enter 或离开输入框保存。文字大小选择后立即保存并同步到当前桌宠,独立于角色尺寸,保留当前阅读、草稿与在途发送;旧配置默认 100%。
|
|
110
|
-
|
|
111
|
-
**日常陪伴节奏** 默认关闭,旧配置沿用原有闲时动作。开启闲时走动及此偏好后,按系统本地时间在 07:00–22:00 每 45–90 秒尝试现有轻动作,夜间每 2–4 分钟仅轻点头或坐下;缺少动作时保持待机。任务、待办、阅读、输入、拖拽、用户休息及减少动态效果始终优先,占用解除后重新等待,动作结束恢复当前神态。偏好立即同步并持久保存,不增加模型请求或通知,详见[日常节奏契约](docs/daily-rhythm-contract.md)及[本地验证边界](docs/evidence/m6/README.md)。
|
|
112
|
-
|
|
113
|
-
桌宠意外退出后按 1、3、10 秒间隔最多自动恢复三次,连续稳定运行 60 秒后清零。设置页显示恢复次数和诊断,可随时关闭或在失败后手动重启;主动关闭不触发恢复。隐藏的角色恢复后仍隐藏,关注会话、完整结果、未读和有效待办保留,旧结果不再次主动提醒。窗口内草稿与阅读位置会随进程退出丢失,恢复不会重发聊天或任务。缺少图形环境、无效运行时路径或未确认清理的进程直接反馈错误,详见[恢复契约](docs/desktop-recovery-contract.md)。
|
|
114
|
-
|
|
115
|
-
```yaml
|
|
116
|
-
- id: dsh-coopanion
|
|
117
|
-
config:
|
|
118
|
-
autoStart: true
|
|
119
|
-
size: 180
|
|
120
|
-
roam: true
|
|
121
|
-
dailyRhythm: false
|
|
122
|
-
notifications: true
|
|
123
|
-
systemNotifications: false
|
|
124
|
-
reminders: true
|
|
125
|
-
reminderDelayMs: 600000
|
|
126
|
-
bubbleDurationMs: 12000
|
|
127
|
-
# electronPath: /absolute/path/to/electron
|
|
128
|
-
```
|
|
76
|
+
完成后重新打开 Desktop。其他 profile 的安装方法见[使用指南](docs/usage.md#通过-dsh-命令行安装)。
|
|
129
77
|
|
|
130
|
-
|
|
78
|
+
### 下载压缩包安装
|
|
131
79
|
|
|
132
|
-
|
|
80
|
+
[下载最新插件包 `dsh-coopanion.tgz`](https://github.com/takboo/dsh-coopanion/releases/latest/download/dsh-coopanion.tgz),在 **插件 → 添加插件** 中填入压缩包的绝对路径,安装并启用,然后重启 Harness。
|
|
133
81
|
|
|
134
|
-
|
|
82
|
+
安装后在 **Settings → 桌宠** 查看运行状态。首次启动需要联网下载并校验 Electron 运行时。
|
|
135
83
|
|
|
136
|
-
|
|
84
|
+
| 操作 | 会发生什么 |
|
|
85
|
+
|---|---|
|
|
86
|
+
| 单击角色 | 和她互动 |
|
|
87
|
+
| 双击角色 | 打开聊天;点击当前会话可换一段聊 |
|
|
88
|
+
| 右键角色 | 换装、休息、音效和其他偏好 |
|
|
89
|
+
| 点击小信封 | 查看回复、审批、问题和异常 |
|
|
137
90
|
|
|
138
|
-
|
|
91
|
+
系统通知与日常陪伴节奏默认关闭,可在设置中开启。更多配置、CLI 安装和旧角色迁移见[使用指南](docs/usage.md)。
|
|
139
92
|
|
|
140
|
-
|
|
93
|
+
## 了解更多与参与
|
|
141
94
|
|
|
142
|
-
|
|
95
|
+
- **使用遇到问题:** 查看[使用指南](docs/usage.md),或[提交 Issue](https://github.com/takboo/dsh-coopanion/issues)。
|
|
96
|
+
- **参与开发:** 从[开发指南](docs/development.md)开始,完整契约与验证状态见[工程文档索引](docs/README.md)。
|
|
97
|
+
- **关注后续改进:** 查看[路线图](docs/roadmap.md)和[版本记录](docs/release-notes.md)。
|
|
143
98
|
|
|
144
|
-
|
|
99
|
+
支持平台为 Windows、macOS 和 Linux。物理多屏/混合 DPI、系统通知中心实机体验、真实模型会话及长期资源表现的验证范围见[当前状态](docs/README.md#当前交付)。
|
|
145
100
|
|
|
146
|
-
|
|
101
|
+
## 致谢与许可
|
|
147
102
|
|
|
148
|
-
|
|
103
|
+
大肥鱼的动画与角色运行时来自 [Pal-AI-Lab / Coopanion](https://github.com/Pal-AI-Lab/Coopanion)。感谢原作者与角色创作者,让她有了灵动的表情、动作和配色。
|
|
149
104
|
|
|
150
|
-
|
|
105
|
+
组合程序采用 [AGPL-3.0-or-later](LICENSE),保留原项目的 [MIT 署名](LICENSE-MIT)。角色贴图和商标有独立权利声明,详见[第三方声明](THIRD_PARTY_NOTICES.md)与[上游版本记录](web/upstream/UPSTREAM.md)。
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
// Raw Input notification only: never call GetRawInputData or inspect key payloads.
|
|
2
|
+
using System;
|
|
3
|
+
using System.Diagnostics;
|
|
4
|
+
using System.Runtime.InteropServices;
|
|
5
|
+
using System.Windows.Forms;
|
|
6
|
+
|
|
7
|
+
public sealed class KeyboardActivity : NativeWindow {
|
|
8
|
+
[StructLayout(LayoutKind.Sequential)]
|
|
9
|
+
struct Device { public ushort page, usage; public uint flags; public IntPtr target; }
|
|
10
|
+
[DllImport("user32.dll", SetLastError = true)]
|
|
11
|
+
static extern bool RegisterRawInputDevices(Device[] devices, uint count, uint size);
|
|
12
|
+
[DllImport("user32.dll", SetLastError = true)]
|
|
13
|
+
static extern IntPtr OpenInputDesktop(uint flags, bool inherit, uint access);
|
|
14
|
+
[DllImport("user32.dll")]
|
|
15
|
+
static extern bool CloseDesktop(IntPtr desktop);
|
|
16
|
+
readonly Stopwatch clock = Stopwatch.StartNew();
|
|
17
|
+
long last = -1;
|
|
18
|
+
protected override void WndProc(ref Message message) {
|
|
19
|
+
if (message.Msg == 0x00ff) last = clock.ElapsedMilliseconds;
|
|
20
|
+
// Includes required foreground raw-input cleanup, without dereferencing lParam.
|
|
21
|
+
base.WndProc(ref message);
|
|
22
|
+
}
|
|
23
|
+
[STAThread]
|
|
24
|
+
public static void Run(int parentPid) {
|
|
25
|
+
using (var parent = Process.GetProcessById(parentPid)) {
|
|
26
|
+
var window = new KeyboardActivity();
|
|
27
|
+
// Message-only window; never takes focus or suppresses normal keyboard input.
|
|
28
|
+
window.CreateHandle(new CreateParams { Parent = new IntPtr(-3) });
|
|
29
|
+
var devices = new[] { new Device { page = 1, usage = 6, flags = 0x100, target = window.Handle } };
|
|
30
|
+
if (!RegisterRawInputDevices(devices, 1, (uint)Marshal.SizeOf(typeof(Device)))) {
|
|
31
|
+
window.DestroyHandle(); throw new InvalidOperationException();
|
|
32
|
+
}
|
|
33
|
+
using (var timer = new Timer { Interval = 500 }) {
|
|
34
|
+
timer.Tick += delegate {
|
|
35
|
+
if (parent.HasExited) { Application.ExitThread(); return; }
|
|
36
|
+
var desktop = OpenInputDesktop(0, false, 1);
|
|
37
|
+
bool available = desktop != IntPtr.Zero && Environment.UserInteractive && !SystemInformation.TerminalServerSession;
|
|
38
|
+
if (desktop != IntPtr.Zero) CloseDesktop(desktop);
|
|
39
|
+
// A fresh registration needs an observation window before claiming idle.
|
|
40
|
+
string state = !available || window.clock.ElapsedMilliseconds < 1500 ? "unknown"
|
|
41
|
+
: window.last >= 0 && window.clock.ElapsedMilliseconds - window.last < 1500 ? "active" : "idle";
|
|
42
|
+
Console.Out.WriteLine(state); Console.Out.Flush();
|
|
43
|
+
};
|
|
44
|
+
try { timer.Start(); Application.Run(); }
|
|
45
|
+
finally {
|
|
46
|
+
RegisterRawInputDevices(new[] { new Device { page = 1, usage = 6, flags = 1, target = IntPtr.Zero } }, 1, (uint)Marshal.SizeOf(typeof(Device)));
|
|
47
|
+
window.DestroyHandle();
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
"""XInput2 event category only. Never fetch cookie data, key codes or key maps."""
|
|
2
|
+
import ctypes as C
|
|
3
|
+
import os
|
|
4
|
+
import select
|
|
5
|
+
import sys
|
|
6
|
+
import time
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def run():
|
|
10
|
+
if os.environ.get('WAYLAND_DISPLAY') or os.environ.get('XDG_SESSION_TYPE', '').lower() == 'wayland' or not os.environ.get('DISPLAY'):
|
|
11
|
+
raise RuntimeError()
|
|
12
|
+
x = C.CDLL('libX11.so.6')
|
|
13
|
+
xi = C.CDLL('libXi.so.6')
|
|
14
|
+
# Only the generic-event header is represented. The opaque payload is not fetched.
|
|
15
|
+
class Header(C.Structure):
|
|
16
|
+
_fields_ = [('type', C.c_int), ('serial', C.c_ulong), ('send_event', C.c_int),
|
|
17
|
+
('display', C.c_void_p), ('extension', C.c_int), ('evtype', C.c_int)]
|
|
18
|
+
class Event(C.Union):
|
|
19
|
+
_fields_ = [('header', Header), ('padding', C.c_long * 24)]
|
|
20
|
+
class Mask(C.Structure):
|
|
21
|
+
_fields_ = [('deviceid', C.c_int), ('mask_len', C.c_int), ('mask', C.POINTER(C.c_ubyte))]
|
|
22
|
+
x.XOpenDisplay.argtypes = [C.c_char_p]; x.XOpenDisplay.restype = C.c_void_p
|
|
23
|
+
x.XDefaultRootWindow.argtypes = [C.c_void_p]; x.XDefaultRootWindow.restype = C.c_ulong
|
|
24
|
+
x.XQueryExtension.argtypes = [C.c_void_p, C.c_char_p, C.POINTER(C.c_int), C.POINTER(C.c_int), C.POINTER(C.c_int)]
|
|
25
|
+
x.XConnectionNumber.argtypes = [C.c_void_p]; x.XConnectionNumber.restype = C.c_int
|
|
26
|
+
x.XPending.argtypes = [C.c_void_p]
|
|
27
|
+
x.XNextEvent.argtypes = [C.c_void_p, C.POINTER(Event)]
|
|
28
|
+
x.XFlush.argtypes = [C.c_void_p]
|
|
29
|
+
x.XCloseDisplay.argtypes = [C.c_void_p]
|
|
30
|
+
xi.XIQueryVersion.argtypes = [C.c_void_p, C.POINTER(C.c_int), C.POINTER(C.c_int)]
|
|
31
|
+
xi.XISelectEvents.argtypes = [C.c_void_p, C.c_ulong, C.POINTER(Mask), C.c_int]
|
|
32
|
+
display = x.XOpenDisplay(None)
|
|
33
|
+
if not display:
|
|
34
|
+
raise RuntimeError()
|
|
35
|
+
try:
|
|
36
|
+
opcode, first, error = C.c_int(), C.c_int(), C.c_int()
|
|
37
|
+
if x.XQueryExtension(display, b'XWAYLAND', C.byref(opcode), C.byref(first), C.byref(error)):
|
|
38
|
+
raise RuntimeError()
|
|
39
|
+
if not x.XQueryExtension(display, b'XInputExtension', C.byref(opcode), C.byref(first), C.byref(error)):
|
|
40
|
+
raise RuntimeError()
|
|
41
|
+
major, minor = C.c_int(2), C.c_int(1)
|
|
42
|
+
if xi.XIQueryVersion(display, C.byref(major), C.byref(minor)) != 0 or (major.value, minor.value) < (2, 1):
|
|
43
|
+
raise RuntimeError()
|
|
44
|
+
bits = (C.c_ubyte * 2)()
|
|
45
|
+
for kind in (13, 14): # XI_RawKeyPress / XI_RawKeyRelease, not key identifiers.
|
|
46
|
+
bits[kind >> 3] |= 1 << (kind & 7)
|
|
47
|
+
mask = Mask(1, 2, bits) # XIAllMasterDevices; avoid duplicate slave notifications.
|
|
48
|
+
if xi.XISelectEvents(display, x.XDefaultRootWindow(display), C.byref(mask), 1) != 0:
|
|
49
|
+
raise RuntimeError()
|
|
50
|
+
x.XFlush(display)
|
|
51
|
+
fd, parent = x.XConnectionNumber(display), os.getppid()
|
|
52
|
+
started, last, due = time.monotonic(), None, time.monotonic()
|
|
53
|
+
event = Event()
|
|
54
|
+
while parent > 1 and os.getppid() == parent:
|
|
55
|
+
# Bound each drain so an input flood cannot starve heartbeats or termination.
|
|
56
|
+
for _ in range(256):
|
|
57
|
+
if not x.XPending(display):
|
|
58
|
+
break
|
|
59
|
+
x.XNextEvent(display, C.byref(event))
|
|
60
|
+
h = event.header
|
|
61
|
+
if h.type == 35 and h.extension == opcode.value and h.evtype in (13, 14):
|
|
62
|
+
last = time.monotonic()
|
|
63
|
+
now = time.monotonic()
|
|
64
|
+
if now >= due:
|
|
65
|
+
print('unknown' if now - started < 1.5 else 'active' if last is not None and now - last < 1.5 else 'idle', flush=True)
|
|
66
|
+
due = now + .5
|
|
67
|
+
select.select([fd], [], [], max(0, due - time.monotonic()))
|
|
68
|
+
finally:
|
|
69
|
+
x.XCloseDisplay(display)
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
if __name__ == '__main__':
|
|
73
|
+
try:
|
|
74
|
+
run()
|
|
75
|
+
except Exception:
|
|
76
|
+
print('unknown', flush=True)
|
|
77
|
+
sys.exit(1)
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
const { spawn } = require('node:child_process');
|
|
2
|
+
const { join, win32 } = require('node:path');
|
|
3
|
+
const STATES = new Set(['active', 'idle', 'unknown']);
|
|
4
|
+
const BACKENDS = { darwin: 'macos', win32: 'windows', linux: 'x11' };
|
|
5
|
+
// Helpers reduce input to a bounded enum stream before it reaches Electron.
|
|
6
|
+
exports.createKeyboardActivity = ({ platform = process.platform, env = process.env, start = spawn, now = () => performance.now() } = {}) => {
|
|
7
|
+
let child, value = 'unknown', at = -Infinity, pending = '', enabled = false, status = 'disabled', startedAt = 0;
|
|
8
|
+
const backend = BACKENDS[platform] ?? 'none';
|
|
9
|
+
const stop = reason => {
|
|
10
|
+
const old = child; child = undefined; value = 'unknown'; at = -Infinity; pending = ''; status = reason; old?.kill();
|
|
11
|
+
};
|
|
12
|
+
function inspect() {
|
|
13
|
+
if (child && status === 'starting' && now() - startedAt > 15000) stop('failed');
|
|
14
|
+
const stale = ['available', 'unavailable'].includes(status) && now() - at > 2500;
|
|
15
|
+
return { value: stale ? 'unknown' : value, backend, status: stale ? 'stale' : status };
|
|
16
|
+
}
|
|
17
|
+
return {
|
|
18
|
+
configure(on) {
|
|
19
|
+
if (!on) { enabled = false; stop('disabled'); return; }
|
|
20
|
+
if (enabled) return; // No restart storm: disable/re-enable retries a failed helper.
|
|
21
|
+
enabled = true;
|
|
22
|
+
if (backend === 'none') { status = 'unsupported-platform'; return; }
|
|
23
|
+
if (platform === 'linux' && (env.WAYLAND_DISPLAY || env.XDG_SESSION_TYPE?.toLowerCase() === 'wayland' || !env.DISPLAY)) { status = 'unsupported-session'; return; }
|
|
24
|
+
let command, args;
|
|
25
|
+
if (platform === 'darwin') { command = '/usr/bin/osascript'; args = ['-l', 'JavaScript', join(__dirname, 'keyboard-activity.jxa')]; }
|
|
26
|
+
else if (platform === 'win32') {
|
|
27
|
+
if (!env.SystemRoot || !win32.isAbsolute(env.SystemRoot)) { status = 'missing-dependency'; return; }
|
|
28
|
+
command = win32.join(env.SystemRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
|
|
29
|
+
const source = join(__dirname, 'keyboard-activity-win.cs').replace(/'/g, "''");
|
|
30
|
+
args = ['-NoLogo', '-NoProfile', '-STA', '-NonInteractive', '-WindowStyle', 'Hidden', '-Command', `$ErrorActionPreference='Stop'; try { Add-Type -Path '${source}' -ReferencedAssemblies System.Windows.Forms; [KeyboardActivity]::Run(${process.pid}) } catch { [Console]::Out.WriteLine('unknown'); exit 1 }`];
|
|
31
|
+
} else { command = '/usr/bin/python3'; args = ['-I', '-u', join(__dirname, 'keyboard-activity-x11.py')]; }
|
|
32
|
+
status = 'starting'; startedAt = now();
|
|
33
|
+
let next;
|
|
34
|
+
try { next = start(command, args, { stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true }); }
|
|
35
|
+
catch (error) { stop(error.code === 'ENOENT' ? 'missing-dependency' : 'failed'); return; }
|
|
36
|
+
child = next;
|
|
37
|
+
next.stdout.on('data', bytes => {
|
|
38
|
+
if (child !== next) return;
|
|
39
|
+
pending += bytes.toString();
|
|
40
|
+
if (pending.length > 256) { stop('protocol-error'); return; }
|
|
41
|
+
let index;
|
|
42
|
+
while ((index = pending.indexOf('\n')) >= 0) {
|
|
43
|
+
const line = pending.slice(0, index).replace(/\r$/, ''); pending = pending.slice(index + 1);
|
|
44
|
+
if (!STATES.has(line)) { stop('protocol-error'); return; }
|
|
45
|
+
value = line; at = now(); status = line === 'unknown' ? 'unavailable' : 'available';
|
|
46
|
+
}
|
|
47
|
+
});
|
|
48
|
+
next.on('error', error => { if (child === next) stop(error.code === 'ENOENT' ? 'missing-dependency' : 'failed'); });
|
|
49
|
+
next.on('exit', () => { if (child === next) stop('failed'); });
|
|
50
|
+
},
|
|
51
|
+
sample() { return inspect().value; },
|
|
52
|
+
inspect,
|
|
53
|
+
};
|
|
54
|
+
};
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
// Query only aggregate event ages; event-listening authorization is a separate API.
|
|
2
|
+
// No event tap, event objects, key codes, text or combined mouse/keyboard idle time.
|
|
3
|
+
ObjC.import('Foundation');
|
|
4
|
+
ObjC.bindFunction('CGEventSourceSecondsSinceLastEventType', ['double', ['int', 'unsigned int']]);
|
|
5
|
+
ObjC.bindFunction('getppid', ['int', []]);
|
|
6
|
+
ObjC.bindFunction('puts', ['int', ['char *']]);
|
|
7
|
+
ObjC.bindFunction('fflush', ['int', ['void *']]);
|
|
8
|
+
ObjC.bindFunction('usleep', ['int', ['unsigned int']]);
|
|
9
|
+
var combinedSessionState = 0, keyDown = 10, keyUp = 11;
|
|
10
|
+
function sample() {
|
|
11
|
+
try {
|
|
12
|
+
var down = $.CGEventSourceSecondsSinceLastEventType(combinedSessionState, keyDown);
|
|
13
|
+
var up = $.CGEventSourceSecondsSinceLastEventType(combinedSessionState, keyUp);
|
|
14
|
+
// Reject API sentinels as well as negative/nonfinite results (not false idle).
|
|
15
|
+
if (!isFinite(down) || !isFinite(up) || down < 0 || up < 0 || down >= 1e10 || up >= 1e10) return 'unknown';
|
|
16
|
+
return Math.min(down, up) < 1.5 ? 'active' : 'idle';
|
|
17
|
+
} catch (_) { return 'unknown'; }
|
|
18
|
+
}
|
|
19
|
+
function run(args) {
|
|
20
|
+
if (args[0] === '--once') return sample();
|
|
21
|
+
var parent = $.getppid();
|
|
22
|
+
while (parent > 1 && $.getppid() === parent) {
|
|
23
|
+
$.puts(sample());
|
|
24
|
+
$.fflush(null);
|
|
25
|
+
$.usleep(500000);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
// Inspect only three aggregate flags; never unwrap or emit the session identity dictionary.
|
|
2
|
+
ObjC.import('CoreGraphics');
|
|
3
|
+
var state = 'unknown';
|
|
4
|
+
try {
|
|
5
|
+
var session = ObjC.castRefToObject($.CGSessionCopyCurrentDictionary());
|
|
6
|
+
function flag(key) {
|
|
7
|
+
try {
|
|
8
|
+
var value = ObjC.unwrap(session.objectForKey($(key)));
|
|
9
|
+
return value === true || value === 1 ? true : value === false || value === 0 ? false : value === undefined || value === null ? null : 'unknown';
|
|
10
|
+
} catch (_) { return 'unknown'; }
|
|
11
|
+
}
|
|
12
|
+
var locked = flag('CGSSessionScreenIsLocked');
|
|
13
|
+
if (locked === true) state = 'locked';
|
|
14
|
+
else if ((locked === false || locked === null) && flag('kCGSessionOnConsoleKey') === true && flag('kCGSessionLoginDoneKey') === true) state = 'unlocked';
|
|
15
|
+
} catch (_) {}
|
|
16
|
+
state;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
const { execFileSync } = require('node:child_process');
|
|
2
|
+
const { join } = require('node:path');
|
|
3
|
+
|
|
4
|
+
/** Aggregate session state only; unavailable adapters never imply an unlocked desktop. */
|
|
5
|
+
function initialLockState({ platform = process.platform, env = process.env, monitor, run = execFileSync } = {}) {
|
|
6
|
+
// Native regression profiles explicitly control their desktop lifecycle.
|
|
7
|
+
if (env.DSH_PET_TEST_NO_SANDBOX === '1') {
|
|
8
|
+
const value = env.DSH_PET_TEST_INITIAL_LOCK_STATE ?? 'unlocked';
|
|
9
|
+
if (value !== 'system') return ['locked', 'unlocked', 'unknown'].includes(value) ? value : 'unknown';
|
|
10
|
+
}
|
|
11
|
+
try {
|
|
12
|
+
if (platform === 'darwin') {
|
|
13
|
+
const value = run('/usr/bin/osascript', ['-l', 'JavaScript', join(__dirname, 'lifecycle-state-macos.jxa')],
|
|
14
|
+
{ encoding: 'utf8', timeout: 1500, maxBuffer: 128, stdio: ['ignore', 'pipe', 'ignore'] }).trim();
|
|
15
|
+
return ['locked', 'unlocked'].includes(value) ? value : 'unknown';
|
|
16
|
+
}
|
|
17
|
+
const value = monitor?.getSystemIdleState(1);
|
|
18
|
+
return value === 'locked' ? 'locked' : ['active', 'idle'].includes(value) ? 'unlocked' : 'unknown';
|
|
19
|
+
} catch { return 'unknown'; }
|
|
20
|
+
}
|
|
21
|
+
module.exports = { initialLockState };
|