@waq666/pneuma 0.7.1 → 0.8.1
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 +242 -206
- package/bin/dsc.js +9 -3
- package/bin/headless.cjs +1 -1
- package/lib/adapter/transcript.d.ts +19 -2
- package/lib/adapter/transcript.js +71 -14
- package/lib/app/AgentsOverlay.js +7 -6
- package/lib/app/App.js +1 -1
- package/lib/app/ApprovalCard.js +15 -9
- package/lib/app/ChatView.d.ts +3 -1
- package/lib/app/ChatView.js +21 -17
- package/lib/app/Composer.js +22 -4
- package/lib/app/MarkdownView.js +2 -1
- package/lib/app/ModelPicker.js +7 -6
- package/lib/app/PickerFrame.d.ts +4 -0
- package/lib/app/PickerFrame.js +18 -0
- package/lib/app/PlanReviewCard.js +2 -1
- package/lib/app/PresetPicker.js +8 -7
- package/lib/app/SessionPicker.js +21 -20
- package/lib/app/SettingsOverlay.js +1 -1
- package/lib/app/SkillsPicker.js +7 -6
- package/lib/app/StatusBar.js +3 -15
- package/lib/app/TaskStrips.js +1 -4
- package/lib/app/TimelineRail.js +2 -1
- package/lib/app/ToolCard.js +2 -6
- package/lib/app/Welcome.d.ts +1 -0
- package/lib/app/Welcome.js +1 -4
- package/lib/app/click.d.ts +0 -2
- package/lib/app/click.js +2 -21
- package/lib/app/display-width.d.ts +16 -0
- package/lib/app/display-width.js +33 -0
- package/lib/app/markdown.d.ts +1 -3
- package/lib/app/markdown.js +2 -19
- package/lib/app/scroll-model.js +1 -1
- package/lib/contract/approval.d.ts +91 -0
- package/lib/contract/approval.js +1 -0
- package/lib/contract/mode.d.ts +69 -0
- package/lib/contract/mode.js +1 -0
- package/lib/contract/plugin.d.ts +240 -0
- package/lib/contract/plugin.js +1 -0
- package/lib/contract/runtime.d.ts +282 -0
- package/lib/contract/runtime.js +1 -0
- package/lib/contract/session.d.ts +208 -0
- package/lib/contract/session.js +36 -0
- package/lib/contract/settings.d.ts +242 -0
- package/lib/contract/settings.js +1 -0
- package/lib/contract/snapshot.d.ts +453 -0
- package/lib/contract/snapshot.js +1 -0
- package/lib/contract/task.d.ts +189 -0
- package/lib/contract/task.js +10 -0
- package/lib/contract/transcript.d.ts +358 -0
- package/lib/contract/transcript.js +1 -0
- package/lib/contract/usage.d.ts +132 -0
- package/lib/contract/usage.js +10 -0
- package/lib/contract.d.ts +20 -1968
- package/lib/contract.js +19 -30
- package/lib/core/agent-roles.d.ts +1 -1
- package/lib/core/agent-roles.js +6 -5
- package/lib/core/approval-floor.d.ts +9 -0
- package/lib/core/approval-floor.js +152 -25
- package/lib/core/attachments.d.ts +185 -0
- package/lib/core/attachments.js +425 -0
- package/lib/core/bytes.d.ts +14 -0
- package/lib/core/bytes.js +28 -0
- package/lib/core/call-meaning.d.ts +20 -0
- package/lib/core/call-meaning.js +347 -0
- package/lib/core/cdp/actions.js +6 -0
- package/lib/core/cdp/launch.js +2 -2
- package/lib/core/cdp/report.d.ts +27 -0
- package/lib/core/cdp/report.js +50 -0
- package/lib/core/cdp/ring-buffer.d.ts +25 -0
- package/lib/core/cdp/ring-buffer.js +44 -0
- package/lib/core/cdp/snapshot.js +5 -9
- package/lib/core/cdp/transport.js +1 -1
- package/lib/core/clamp.d.ts +20 -0
- package/lib/core/clamp.js +24 -0
- package/lib/core/clock.d.ts +16 -0
- package/lib/core/clock.js +20 -0
- package/lib/core/command-policy.js +33 -1
- package/lib/core/commands-completion.d.ts +28 -0
- package/lib/core/commands-completion.js +108 -30
- package/lib/core/compact.d.ts +36 -6
- package/lib/core/compact.js +89 -17
- package/lib/core/desktop-control.js +1 -3
- package/lib/core/dsh-compat/llm-usage-event.d.ts +78 -0
- package/lib/core/dsh-compat/llm-usage-event.js +91 -0
- package/lib/core/dsh-compat/presentation.d.ts +84 -0
- package/lib/core/dsh-compat/presentation.js +105 -0
- package/lib/core/dsh-compat/resolve-hook.d.ts +3 -3
- package/lib/core/dsh-compat/resolve-hook.js +41 -13
- package/lib/core/dsh-compat/service-map.d.ts +52 -0
- package/lib/core/dsh-compat/service-map.js +87 -0
- package/lib/core/dsh-compat/session-bridge.d.ts +107 -0
- package/lib/core/dsh-compat/session-bridge.js +376 -0
- package/lib/core/dsh-compat/session-events.d.ts +54 -0
- package/lib/core/dsh-compat/session-events.js +297 -0
- package/lib/core/dsh-compat/shims/credentials.d.ts +62 -0
- package/lib/core/dsh-compat/shims/credentials.js +86 -0
- package/lib/core/dsh-compat/shims/home-paths.d.ts +77 -0
- package/lib/core/dsh-compat/shims/home-paths.js +143 -0
- package/lib/core/dsh-compat/tools-facade.d.ts +31 -1
- package/lib/core/dsh-compat/tools-facade.js +207 -3
- package/lib/core/err-text.d.ts +5 -0
- package/lib/core/err-text.js +5 -0
- package/lib/core/events.d.ts +31 -2
- package/lib/core/git-info.d.ts +127 -15
- package/lib/core/git-info.js +315 -34
- package/lib/core/git-surface.d.ts +17 -0
- package/lib/core/git-surface.js +7 -0
- package/lib/core/hooks.d.ts +19 -2
- package/lib/core/hooks.js +57 -13
- package/lib/core/host-methods.d.ts +1 -1
- package/lib/core/host-methods.js +4 -0
- package/lib/core/image-diet.js +1 -4
- package/lib/core/json-text.d.ts +11 -0
- package/lib/core/json-text.js +18 -0
- package/lib/core/learnings/skill-write.d.ts +1 -7
- package/lib/core/learnings/skill-write.js +3 -37
- package/lib/core/lifecycle-hooks.d.ts +11 -3
- package/lib/core/lifecycle-hooks.js +33 -42
- package/lib/core/llm.d.ts +42 -0
- package/lib/core/llm.js +40 -25
- package/lib/core/loop.d.ts +11 -1
- package/lib/core/loop.js +95 -28
- package/lib/core/lsp/client.js +30 -17
- package/lib/core/lsp/normalize.d.ts +0 -2
- package/lib/core/lsp/normalize.js +1 -6
- package/lib/core/lsp/servers.js +1 -4
- package/lib/core/mcp.d.ts +18 -0
- package/lib/core/mcp.js +60 -16
- package/lib/core/microcompact.d.ts +45 -0
- package/lib/core/microcompact.js +128 -0
- package/lib/core/native-bridge.js +2 -10
- package/lib/core/path-policy.d.ts +13 -1
- package/lib/core/path-policy.js +87 -18
- package/lib/core/permission-presets.d.ts +9 -5
- package/lib/core/permission-presets.js +14 -7
- package/lib/core/permission-scope.d.ts +65 -0
- package/lib/core/permission-scope.js +109 -0
- package/lib/core/plugin-bundle.d.ts +95 -0
- package/lib/core/plugin-bundle.js +137 -0
- package/lib/core/plugin-loader.d.ts +36 -1
- package/lib/core/plugin-loader.js +336 -12
- package/lib/core/plugin-patch.d.ts +64 -0
- package/lib/core/plugin-patch.js +146 -0
- package/lib/core/plugin-registry.d.ts +14 -0
- package/lib/core/plugin-registry.js +2 -0
- package/lib/core/prefs.js +40 -2
- package/lib/core/presets.d.ts +11 -0
- package/lib/core/presets.js +61 -22
- package/lib/core/profile-dir.d.ts +5 -0
- package/lib/core/profile-dir.js +40 -0
- package/lib/core/prompt.js +55 -19
- package/lib/core/ptc.d.ts +8 -2
- package/lib/core/ptc.js +18 -4
- package/lib/core/records.d.ts +16 -0
- package/lib/core/records.js +22 -0
- package/lib/core/remote/notify.js +1 -3
- package/lib/core/remote/push.js +2 -6
- package/lib/core/sandbox/execpolicy.js +27 -3
- package/lib/core/sandbox/net-proxy.js +2 -2
- package/lib/core/sandbox/policy.d.ts +1 -1
- package/lib/core/sandbox/policy.js +21 -15
- package/lib/core/sandbox/win/account.js +1 -4
- package/lib/core/sandbox/win/acl.js +1 -6
- package/lib/core/sandbox/win/backend.d.ts +24 -3
- package/lib/core/sandbox/win/backend.js +73 -23
- package/lib/core/sandbox/win/doctor.js +1 -4
- package/lib/core/sandbox/win/runner-entry.js +1 -6
- package/lib/core/sandbox/win/setup.js +1 -4
- package/lib/core/sandbox/win/utf16.d.ts +11 -0
- package/lib/core/sandbox/win/utf16.js +15 -0
- package/lib/core/sandbox/win/wfp.js +1 -4
- package/lib/core/schedule/rule.d.ts +0 -17
- package/lib/core/schedule/rule.js +1 -3
- package/lib/core/schedule/runner.d.ts +5 -2
- package/lib/core/schedule/runner.js +32 -9
- package/lib/core/schedule/store.d.ts +0 -2
- package/lib/core/schedule/store.js +2 -9
- package/lib/core/session-index.d.ts +50 -0
- package/lib/core/session-index.js +169 -3
- package/lib/core/session.d.ts +89 -13
- package/lib/core/session.js +385 -32
- package/lib/core/shell-quote.d.ts +21 -0
- package/lib/core/shell-quote.js +24 -0
- package/lib/core/side-ask.d.ts +52 -0
- package/lib/core/side-ask.js +89 -0
- package/lib/core/skills.d.ts +16 -0
- package/lib/core/skills.js +45 -8
- package/lib/core/snapshot-throttle.d.ts +8 -0
- package/lib/core/snapshot-throttle.js +24 -0
- package/lib/core/spill.d.ts +11 -5
- package/lib/core/spill.js +35 -36
- package/lib/core/strings.d.ts +21 -0
- package/lib/core/strings.js +33 -0
- package/lib/core/terminal-env.d.ts +61 -0
- package/lib/core/terminal-env.js +327 -0
- package/lib/core/text-format.d.ts +17 -0
- package/lib/core/text-format.js +26 -0
- package/lib/core/todo-reminder.d.ts +19 -14
- package/lib/core/todo-reminder.js +14 -23
- package/lib/core/token-estimate.d.ts +18 -2
- package/lib/core/token-estimate.js +10 -2
- package/lib/core/tool-result-prune.d.ts +42 -0
- package/lib/core/tool-result-prune.js +47 -0
- package/lib/core/tool-search.d.ts +3 -2
- package/lib/core/tool-search.js +3 -2
- package/lib/core/tools/bash.d.ts +35 -3
- package/lib/core/tools/bash.js +168 -41
- package/lib/core/tools/fs-tools.js +18 -17
- package/lib/core/tools/image-tool.d.ts +2 -0
- package/lib/core/tools/image-tool.js +59 -0
- package/lib/core/tools/path-args.d.ts +4 -0
- package/lib/core/tools/path-args.js +22 -0
- package/lib/core/tools/search-tools.d.ts +30 -0
- package/lib/core/tools/search-tools.js +321 -34
- package/lib/core/tools.d.ts +82 -0
- package/lib/core/tools.js +21 -0
- package/lib/core/transcript-text.d.ts +19 -0
- package/lib/core/transcript-text.js +44 -0
- package/lib/core/ui-boot-source.d.ts +5 -0
- package/lib/core/ui-boot-source.js +10 -3
- package/lib/core/ui-bundles.d.ts +80 -6
- package/lib/core/ui-bundles.js +700 -76
- package/lib/core/ui-events.d.ts +10 -0
- package/lib/core/ui-events.js +25 -0
- package/lib/core/ui-methods.d.ts +1 -1
- package/lib/core/ui-methods.js +42 -13
- package/lib/core/ui-route.js +11 -7
- package/lib/core/ui-server.d.ts +6 -0
- package/lib/core/ui-server.js +106 -1
- package/lib/core/unified-diff.d.ts +35 -0
- package/lib/core/unified-diff.js +86 -0
- package/lib/core/usage-log.js +39 -0
- package/lib/core/web-http.d.ts +1 -1
- package/lib/core/web-http.js +1 -3
- package/lib/host/kernel.js +57 -41
- package/lib/plugins/agent.js +101 -20
- package/lib/plugins/approval-floor.js +12 -8
- package/lib/plugins/approval.js +252 -80
- package/lib/plugins/ask.js +60 -8
- package/lib/plugins/browser.js +32 -84
- package/lib/plugins/commands.js +167 -57
- package/lib/plugins/compact.d.ts +2 -2
- package/lib/plugins/compact.js +200 -30
- package/lib/plugins/computer-use.js +34 -18
- package/lib/plugins/dock-browser.js +24 -65
- package/lib/plugins/dsh-compat.js +7 -0
- package/lib/plugins/file-review.js +59 -15
- package/lib/plugins/git.js +16 -8
- package/lib/plugins/goal.js +9 -8
- package/lib/plugins/hooks.js +4 -2
- package/lib/plugins/host-stdio.js +14 -16
- package/lib/plugins/lifecycle-hooks.d.ts +5 -4
- package/lib/plugins/lifecycle-hooks.js +12 -10
- package/lib/plugins/llm.js +74 -33
- package/lib/plugins/lsp.js +22 -27
- package/lib/plugins/mcp.js +16 -17
- package/lib/plugins/memory.js +3 -24
- package/lib/plugins/microcompact.d.ts +4 -1
- package/lib/plugins/microcompact.js +117 -19
- package/lib/plugins/mode.js +30 -11
- package/lib/plugins/permission-presets.d.ts +2 -1
- package/lib/plugins/permission-presets.js +55 -35
- package/lib/plugins/plugin-manager.js +4 -6
- package/lib/plugins/presets.js +56 -27
- package/lib/plugins/prompt.js +54 -11
- package/lib/plugins/ptc.d.ts +13 -0
- package/lib/plugins/ptc.js +121 -24
- package/lib/plugins/remote/types.d.ts +1 -1
- package/lib/plugins/remote/types.js +11 -0
- package/lib/plugins/remote.js +14 -15
- package/lib/plugins/runtime.js +91 -14
- package/lib/plugins/sandbox.js +181 -60
- package/lib/plugins/schedule.js +12 -11
- package/lib/plugins/self-improve.js +28 -18
- package/lib/plugins/session-search.js +18 -13
- package/lib/plugins/session-title.js +1 -1
- package/lib/plugins/session.js +103 -25
- package/lib/plugins/settings.js +16 -40
- package/lib/plugins/skills.js +18 -1
- package/lib/plugins/spill.js +18 -11
- package/lib/plugins/subagent.js +208 -42
- package/lib/plugins/team.js +11 -5
- package/lib/plugins/todo.d.ts +1 -1
- package/lib/plugins/todo.js +25 -19
- package/lib/plugins/tool-search.js +47 -28
- package/lib/plugins/tools-default.js +89 -5
- package/lib/plugins/tools.js +3 -3
- package/lib/plugins/transcript.js +116 -9
- package/lib/plugins/web-search.d.ts +1 -1
- package/lib/plugins/web-search.js +25 -16
- package/lib/plugins/webserver.js +40 -7
- package/lib/remote/assets/app-B3Id1EBq.js +14 -0
- package/lib/remote/assets/index.html +2 -2
- package/lib/remote/assets/{style-DIB6729x.css → style-NtlpbKOI.css} +1 -1
- package/lib/services/types.d.ts +247 -29
- package/lib/tools/plugin-cli.d.ts +1 -0
- package/lib/tools/plugin-cli.js +209 -0
- package/lib/ui/assets/app-B-Jx5dnh.js +90 -0
- package/lib/ui/assets/{chunk-BajyYBss.js → chunk-Bfdlo8Me.js} +1 -1
- package/lib/ui/assets/chunk-DGX-i4eb.js +12 -0
- package/lib/ui/assets/index.html +62 -14
- package/lib/ui/assets/style-WzxwEPaE.css +1 -0
- package/lib/ui/frames.js +1 -3
- package/lib/ui/index.d.ts +30 -1
- package/lib/ui/index.js +29 -0
- package/lib/ui/manifest.d.ts +24 -6
- package/lib/ui/manifest.js +3 -2
- package/lib/ui/plugins/actions/bundle.json +8 -0
- package/lib/ui/plugins/actions/client.js +43 -0
- package/lib/ui/plugins/ask/bundle.json +8 -0
- package/lib/ui/plugins/ask/client.js +415 -0
- package/lib/ui/plugins/browser/bundle.json +8 -0
- package/lib/ui/plugins/composer/bundle.json +9 -0
- package/lib/ui/plugins/composer/client.js +1806 -1087
- package/lib/ui/plugins/files/bundle.json +8 -0
- package/lib/ui/plugins/files/client.js +13 -98
- package/lib/ui/plugins/manifest.json +1 -104
- package/lib/ui/plugins/palette/bundle.json +8 -0
- package/lib/ui/plugins/palette/client.js +360 -0
- package/lib/ui/plugins/plugins/bundle.json +8 -0
- package/lib/ui/plugins/plugins/client.js +116 -38
- package/lib/ui/plugins/preview/bundle.json +8 -0
- package/lib/ui/plugins/preview/client.js +6 -16
- package/lib/ui/plugins/prompt/bundle.json +8 -0
- package/lib/ui/plugins/prompt/client.js +81 -47
- package/lib/ui/plugins/sessions/bundle.json +8 -0
- package/lib/ui/plugins/sessions/client.js +157 -111
- package/lib/ui/plugins/settings/bundle.json +8 -0
- package/lib/ui/plugins/settings/client.js +184 -170
- package/lib/ui/plugins/skills/bundle.json +8 -0
- package/lib/ui/plugins/skills/client.js +161 -79
- package/lib/ui/plugins/status/bundle.json +8 -0
- package/lib/ui/plugins/status/client.js +165 -26
- package/lib/ui/plugins/statusbar/bundle.json +9 -0
- package/lib/ui/plugins/statusbar/client.js +100 -144
- package/lib/ui/plugins/tasks/bundle.json +8 -0
- package/lib/ui/plugins/team/bundle.json +8 -0
- package/lib/ui/plugins/team/client.js +60 -58
- package/lib/ui/plugins/terminal/bundle.json +8 -0
- package/lib/ui/plugins/terminal/client.js +1 -7
- package/lib/ui/plugins/trace/bundle.json +11 -0
- package/lib/ui/plugins/trace/client.js +86 -179
- package/lib/ui/plugins/transcript/bundle.json +8 -0
- package/lib/ui/plugins/transcript/client.js +1608 -1243
- package/lib/ui/sdk/@dsc/ui/index.d.ts +54 -16
- package/lib/ui/sdk/@dsc/ui/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +20 -1968
- package/lib/ui/sdk/@dsc/ui-core/core/attachments.d.ts +185 -0
- package/lib/ui/sdk/@dsc/ui-core/core/bytes.d.ts +14 -0
- package/lib/ui/sdk/@dsc/ui-core/core/err-text.d.ts +18 -0
- package/lib/ui/sdk/@dsc/ui-core/core/git-surface.d.ts +17 -0
- package/lib/ui/sdk/@dsc/ui-core/core/json-text.d.ts +11 -0
- package/lib/ui/sdk/@dsc/ui-core/core/path-policy.d.ts +44 -0
- package/lib/ui/sdk/@dsc/ui-core/core/records.d.ts +16 -0
- package/lib/ui/sdk/@dsc/ui-core/core/throughput.d.ts +46 -0
- package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +18 -2
- package/lib/ui/sdk/@dsc/ui-core/core/unified-diff.d.ts +35 -0
- package/lib/ui/sdk/@dsc/ui-core/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +30 -1
- package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +24 -6
- package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +19 -8
- package/lib/ui/sdk/@dsc/ui-core/ui/signal.d.ts +49 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +17 -3
- package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +1 -1
- package/lib/ui/sdk/@dsc/ui-dockkit/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +4 -0
- package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +6 -1
- package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +21 -0
- package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +1 -0
- package/lib/ui/sdk/@dsc/ui-layout/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +1 -1
- package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +10 -1
- package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +1 -1
- package/lib/ui/sdk/@dsc/ui-layout/usage-today.d.ts +11 -0
- package/lib/ui/sdk/@dsc/ui-primitives/dialog-focus.d.ts +30 -0
- package/lib/ui/sdk/@dsc/ui-primitives/error-text.d.ts +12 -0
- package/lib/ui/sdk/@dsc/ui-primitives/git-surface.d.ts +9 -0
- package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +23 -0
- package/lib/ui/sdk/@dsc/ui-primitives/humanize-error.d.ts +35 -0
- package/lib/ui/sdk/@dsc/ui-primitives/icons-workspace.d.ts +33 -0
- package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +21 -3
- package/lib/ui/sdk/@dsc/ui-primitives/image-lightbox.d.ts +21 -0
- package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +16 -0
- package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +10 -14
- package/lib/ui/sdk/@dsc/ui-primitives/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +31 -8
- package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +2 -0
- package/lib/ui/sdk/@dsc/ui-primitives/review-findings-card.d.ts +25 -0
- package/lib/ui/sdk/@dsc/ui-primitives/review-findings.d.ts +64 -0
- package/lib/ui/sdk/@dsc/ui-primitives/review-notice-card.d.ts +27 -0
- package/lib/ui/sdk/@dsc/ui-primitives/review-notice.d.ts +80 -0
- package/lib/ui/sdk/@dsc/ui-primitives/signal.d.ts +9 -0
- package/lib/ui/sdk/@dsc/ui-primitives/sizes.d.ts +15 -0
- package/lib/ui/sdk/@dsc/ui-primitives/skeleton.d.ts +39 -0
- package/lib/ui/sdk/@dsc/ui-primitives/snapshot.d.ts +46 -0
- package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +3 -3
- package/lib/ui/sdk/@dsc/ui-primitives/throughput.d.ts +13 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +9 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +1 -1
- package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +30 -6
- package/lib/ui/sdk/@dsc/ui-primitives/unified-diff.d.ts +10 -0
- package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +10 -1
- package/lib/ui/sdk/@dsc/ui-renderer/cordis-host.d.ts +113 -0
- package/lib/ui/sdk/@dsc/ui-renderer/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-slots/package.json +1 -1
- package/lib/ui/services.d.ts +19 -8
- package/lib/ui/services.js +20 -12
- package/lib/ui/signal.d.ts +49 -0
- package/lib/ui/signal.js +57 -0
- package/lib/ui/tui-plugins.js +36 -16
- package/package.json +71 -58
- package/lib/remote/assets/app-DAcUCOEn.js +0 -14
- package/lib/ui/assets/app-B70nVIKd.js +0 -69
- package/lib/ui/assets/chunk-BGcgwlCI.js +0 -12
- package/lib/ui/assets/style-Bq01xH_b.css +0 -1
package/README.md
CHANGED
|
@@ -1,206 +1,242 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img src="docs/assets/readme/banner.png" width="560" alt="Pneuma — 独立终端 AI harness">
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
<p align="center">
|
|
6
|
-
<a href="https://www.npmjs.com/package/@waq666/pneuma"><img src="https://img.shields.io/npm/v/@waq666/pneuma?style=flat-square&label=npm&color=cb3837" alt="npm"></a>
|
|
7
|
-
<a href="https://github.com/waq05/pneuma/actions/workflows/release.yml"><img src="https://github.com/waq05/pneuma/actions/workflows/release.yml/badge.svg?branch=main" alt="Release"></a>
|
|
8
|
-
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License: MIT"></a>
|
|
9
|
-
<a href="package.json"><img src="https://img.shields.io/badge/node-%E2%89%A5%2022.19-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node >= 22.19"></a>
|
|
10
|
-
</p>
|
|
11
|
-
|
|
12
|
-
# Pneuma
|
|
13
|
-
|
|
14
|
-
> **全自研**的终端 AI 编程助手:自写 ReAct loop + 会话落盘 + 工具栈 + 审批,UI 用 ink(React for CLI),另有 Electron 桌面端;插件装配基于开源 cordis 上下文内核。
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="docs/assets/readme/banner.png" width="560" alt="Pneuma — 独立终端 AI harness">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<p align="center">
|
|
6
|
+
<a href="https://www.npmjs.com/package/@waq666/pneuma"><img src="https://img.shields.io/npm/v/@waq666/pneuma?style=flat-square&label=npm&color=cb3837" alt="npm"></a>
|
|
7
|
+
<a href="https://github.com/waq05/pneuma/actions/workflows/release.yml"><img src="https://github.com/waq05/pneuma/actions/workflows/release.yml/badge.svg?branch=main" alt="Release"></a>
|
|
8
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License: MIT"></a>
|
|
9
|
+
<a href="package.json"><img src="https://img.shields.io/badge/node-%E2%89%A5%2022.19-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node >= 22.19"></a>
|
|
10
|
+
</p>
|
|
11
|
+
|
|
12
|
+
# Pneuma
|
|
13
|
+
|
|
14
|
+
> **全自研**的终端 AI 编程助手:自写 ReAct loop + 会话落盘 + 工具栈 + 审批,UI 用 ink(React for CLI),另有 Electron 桌面端;插件装配基于开源 cordis 上下文内核。
|
|
15
|
+
|
|
16
|
+
各版本的用户可见变化见 [CHANGELOG.md](CHANGELOG.md)。
|
|
17
|
+
|
|
18
|
+
## 有什么
|
|
19
|
+
|
|
20
|
+
- **一颗内核,三种前端** — 终端 TUI、Electron 桌面端(默认已是插件化界面壳)、**手机浏览器遥控页**;局域网扫码配对,人在外面也能批卡、看进度、发消息(PWA + Web Push + Webhook)。
|
|
21
|
+
- **模型自由** — 多端点 / 多模型随意切;上下文窗口、思考档位、图片 / 视频模态逐模型配置并可就地实测。输入框底栏两颗 chip 直接换模型与思考强度:模型是两级菜单,思考强度是一条四档滑杆(关 / 低 / 高 / 最大,每档一套动效)。模型、档位与协作模式都**按会话记**:在 A 会话换模型,B 会话和后台子代理仍用自己的那一条。
|
|
22
|
+
- **智能体协作** — 子智能体、智能体团队(并行队友 + 收件箱 + 汇报)、任务清单、计划交付、跨轮目标续跑。叫停队友只是停当前那一轮:它在名册里留着,传话就能接着干,干完的汇报照旧回到主会话(要彻底清掉用「移除」)。
|
|
23
|
+
- **长期记忆** — 跨会话事实分「全局 / 用户偏好 / 工作区」三格,当轮生效,可评估、可整理。
|
|
24
|
+
- **插件化** — 每个服务一个 cordis 插件;官方 18 个可开关插件(见 [§插件](#插件))+ 单文件 ESM 第三方插件;桌面界面壳本身也是插件架构(带 SDK)。
|
|
25
|
+
- **四档主题** — Claude(暖米白,取 Anthropic 官方色板,**出厂默认**)/ 深色 / 浅色 / 跟随系统;整屏颜色只由两个种子(墨色、强调色)与一组百分比旋钮派生,换皮肤不用改组件。
|
|
26
|
+
- **默认终端可选** — 设置 → 终端环境会真去探这台机器上有哪些 shell(Windows PowerShell 5.1 / PowerShell 7 / Git Bash / WSL),探到才给选项;选中之后 bash 工具与终端会话都走它,模型看到的工具说明也跟着改口(选了 Git Bash,它就按 bash 的语法写命令),审批地板的引号与转义规则同步切换。
|
|
27
|
+
- **用量统计** — 设置 → 用量统计:汇总卡 + Token 活动热力图(今天 / 近 7 天 / 近 30 天 / 近一年,手机上只滚那一块)+ 分模型趋势折线 + 模型占比环形图;输入框上方的 Token 卡自动进位(1,238,946 读作 1.2M,335,048 读作 335K),精确值放在悬浮提示里。
|
|
28
|
+
- **可收起的右侧栏** — 关掉整块栏最后一张页签才收起(「开始」页留着,下次展开还是它);只要还剩页签(哪怕只剩「开始」)就照旧展开,分栏清空一格也一样。
|
|
29
|
+
- **面板宽度记得住** — 侧栏、正文列、右侧栏、并排审查的宽度与侧栏收起状态跨重启保留:这几项落在 `~/.dsc/settings.json`,不靠浏览器存储,所以宿主换端口、切工作目录再回来,还是你拖出来的那个宽。
|
|
30
|
+
- **提问卡可收起** — 模型一次问好几题时,卡片分别是「标头(题目标签 + 题干)+ 作答区 + 翻页栏」;点标头右侧的折叠钮收起,只剩一行标头(题干两行封顶),输入框上方立刻让出空间。收起不平移内容:草稿、选到哪一题、翻页位置都留着,展开还是原样。
|
|
31
|
+
- **写前预览收成一行** — 模型改文件之前仍会把「改哪几行」摆进对话流,但默认只占一行(`编辑文件` / `新建文件` + 路径 + `+N 行 / -M 行`),点开才看 diff、再点收起;任务跑着的时候不再被十几块绿红 diff 冲掉。这一轮改完的文件在轮尾汇总成一张「已编辑 N 个文件」的卡。
|
|
32
|
+
- **安全默认** — 写 / 执行一律过审批卡(一次授权一次生效);沙箱策略围栏、危险命令灾难地板;「沙箱三档」与「谁来审」是两个正交的旋钮(见 [§权限与安全边界](#权限与安全边界))。
|
|
33
|
+
- **权限按会话独立** — 每个会话各记自己的沙箱档位、权限模式与审阅者:A 会话切「只读」不影响 B 会话和后台跑着的子代理;新会话按「默认权限预设」起步,之后改默认值不动已经打开的会话。
|
|
34
|
+
- **画面不串台** — 后台会话跑出来的工具卡、压缩提示、文件预览、钩子留言只落在它自己的会话里;切到新会话不会看到上一个会话还在动的「查找文件」。
|
|
35
|
+
- **启动不再刷权限提示** — 按偏好恢复的权限模式 / 审阅者 / 权限预设不再往对话流里写「切换为…」(这三项在输入框那颗旋钮上一直看得见);主动点预设、`/policy`、`/reviewer` 该有的回执照旧。
|
|
36
|
+
- **新会话当场看得见** — 点「新会话」,侧栏当前工作区顶上立刻多出一行并高亮;切到别的会话它就消失(还没发过消息,磁盘上也还没有文件),发出第一句话之后它变成正式会话、位置与高亮都不跳。输入框里打的半截话、贴的附件按工作区暂存,切走再点「新会话」还是那一句;重启不保留。
|
|
37
|
+
- **切会话不再等半拍** — 点侧栏那一行,高亮当场就换(正文随后落地,不再「点了没动静」);刚看过的三个会话留在内存里,切回去不重读磁盘。背后三笔账:切会话不再重扫技能目录与 git 状态(同一个工作区里它们一个字节都没变,原来每次白白多花 30–50ms)、侧栏列表按文件改动情况缓存(你机器上 76 条会话从原来每次 120–150ms 降到约 18ms)、快照推送不再固定等一个 80ms 的窗口。宿主侧实测从 60–150ms 降到 3–35ms。
|
|
38
|
+
- **轮尾只在悬浮时说话** — 「~653 tok · 21:53」这行附注与复制 / 分叉同一套:平时透明,鼠标压到这一轮的回复上(或键盘焦点进来)才浮现;隐着也占位,所以不会一出现就把版面顶跳。
|
|
39
|
+
- **重新编辑留在当前会话** — 点消息旁那颗铅笔改完重发,不再另开一条会话:这条消息及其之后的回答在当前会话里作废,改过的文字接着发。磁盘上原文一条不删(日志末尾记一句「从这里往后作废」),所以改错了还能回查。
|
|
40
|
+
- **会话时间跟着「最后一步」走** — 侧栏那列时间现在读这条会话最后一次对话的时刻,不再读文件被写过的时间;点开一条老会话,它不会再平白无故变成「刚刚」。只看一眼也不会再改动任何会话文件(补权限默认值改为等下次真要写日志时才落盘)。
|
|
41
|
+
- **置顶图钉换了** — 原来那枚斜着的小图标缩到 13px 糊成一团,现在换成竖向图钉、放大到 14px:没置顶的平时藏着、悬浮(或键盘聚焦)才浮出来,已置顶的钉身填实、染成提示色,一眼分得出有没有钉住。
|
|
42
|
+
- **过程区更紧凑** — 工具调用与思考行去掉了卡片边框和悬停底色:一行只有图标 + 说明 + 摘要 + 行尾读数,点文字才展开;行高与行距各收一档,成功的行不再重复写「完成」。整轮「用时 X」与阶段组头这类汇总入口照留。思考行、工具行、阶段组头现在是**同一套三级栅格**:左缘对齐、组头字号与思考行同档;**只有一条工具调用时不套组头**,直接平铺成一行,两层以上才分组。
|
|
43
|
+
- **上下文占用不再归零** — 切会话、重启宿主后,底栏「上下文已用」按这条会话最后一次请求的真实占用回填,不再显示 0%;这条会话一行用量都没有时整段不画(不拿 0% 冒充「还没数」)。
|
|
44
|
+
- **折叠默认态改完立即生效** — 设置里改「工具卡 / 定稿的思考行」的默认展开态,屏幕上的会话立刻跟着变;你手动点开过的那几条保持原样。
|
|
45
|
+
- **长会话省 token** — 旧工具结果每轮清一次,且只有清掉的量占到整段提示词 25% 以上才真清(清得太少反而会打断前缀缓存)、超过 8000 字符的工具输出只留头 4K + 尾 1K(最近 4 条原样保留,中间写明省了多少、原文在日志里)、历史图片按预算卸载、压缩前回插读过的文件、端点侧显式缓存断点;**沙箱档位与当前模式挪到请求末尾的环境快照**,切权限 / 换模式不再让整个前缀缓存失效(实测切一次权限曾一次损失 59K 命中)。命中率实测 93%,单次未命中中位数 2.3k token。
|
|
46
|
+
- **子代理默认不限轮次** — 派出去的队友想跑几轮跑几轮,需要收口时在设置 → 子智能体里填「轮次上限」(与角色文件的 max-turns 取更小);设限后最后一轮收走工具,只让它直接交结论,汇报里带运行记录路径。
|
|
47
|
+
- **旁问(只读、流式)** — 在会话里选中一段文字,点浮出的「问 AI」,右侧栏就地回答:不执行工具、不写主会话、
|
|
48
|
+
不进会话列表;答案按会话留在内存里,重启清空。入口三个:选区浮钮、右侧栏「开始」页的「旁问」卡、`Ctrl+Shift+K`;
|
|
49
|
+
命令面板(`Ctrl+K`)另有两行动作,它的可见入口在顶栏右上角。
|
|
50
|
+
|
|
51
|
+
## 快速开始
|
|
52
|
+
|
|
53
|
+
### 桌面端
|
|
54
|
+
|
|
55
|
+
自带运行时,不用装 Node:到 [Releases](https://github.com/waq05/pneuma/releases) 下载安装版
|
|
56
|
+
`pneuma-setup-x.y.z.exe`(可选安装目录)或免安装单文件 `pneuma-portable-x.y.z.exe`。
|
|
57
|
+
|
|
58
|
+
### CLI(`numa`)
|
|
59
|
+
|
|
60
|
+
需要 Node.js ≥ 22.19:
|
|
61
|
+
|
|
62
|
+
```sh
|
|
63
|
+
npm i -g @waq666/pneuma # 或免安装:npx @waq666/pneuma
|
|
64
|
+
numa # 独立启动(新会话)
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
`numa --resume` 恢复上次会话;`numa --resume <会话jsonl路径>` 恢复指定会话。
|
|
68
|
+
|
|
69
|
+
### 从源码跑
|
|
70
|
+
|
|
71
|
+
```sh
|
|
72
|
+
git clone https://github.com/waq05/pneuma
|
|
73
|
+
cd pneuma && pnpm install && pnpm build
|
|
74
|
+
npm i -g file:. # 全局 numa 命令指向本地构建
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## 快捷键与斜杠命令
|
|
78
|
+
|
|
79
|
+
| 按键 / 命令 | 作用 |
|
|
80
|
+
| --- | --- |
|
|
81
|
+
| 直接输入 + Enter | 发送消息 |
|
|
82
|
+
| 输入 `/` 后 | 输入框上方弹出候选面板:每行是「图标 + 中文名 + 英文名 + 一句说明」,说明右对齐;`/model ` 后列**可用模型**(↑↓ 选择、Tab 补全、Esc 关闭)。桌面、手机、终端三处同一套中文名,来自宿主那张命令表 |
|
|
83
|
+
| ↑ / ↓(空输入时) | 翻输入历史 |
|
|
84
|
+
| Ctrl+C | 一次:打断当前回合;2 秒内两次:退出 |
|
|
85
|
+
| Ctrl+T | 展开/折叠思考(reasoning) |
|
|
86
|
+
| `/new` | 新建会话 |
|
|
87
|
+
| `/resume` | 恢复历史会话(↑↓ 选择,Enter 确认,Esc 取消) |
|
|
88
|
+
| `/compact` | 手动压缩上下文(自动阈值:估算 tokens 超过「窗口 × 80%」与「窗口 − 输出预留 − 安全余量」里较小的那个;压完保留的最近对话按模型窗口 16% 的 token 预算折算,两条都可在设置「上下文压缩」里调) |
|
|
89
|
+
| `/model [端点/]模型名` | 切换模型(下一次请求生效;候选来自配置里的全部 provider/model) |
|
|
90
|
+
| 桌面端 Ctrl+V / 拖文件 | 图片、视频、其它文件都能贴/拖进输入框:图片先规范化再随消息发出;视频存原件并把关键帧一起发给模型,气泡里是一张可播放的视频卡;其它文件给模型一条只读路径。模型没开 `image` 模态时会被拒绝(见 [§配置](#配置)) |
|
|
91
|
+
| 桌面端悬停待发附件 | 图片/视频是 64px 缩略图(视频角上标「N 帧」),文件是带名字与体积的卡片;`×` 移除,空输入框按 Backspace 撤最后一条;贴图与附件在会话切换后各回各的,不会串到别的会话 |
|
|
92
|
+
| `/help` `/exit` | 帮助 / 退出 |
|
|
93
|
+
|
|
94
|
+
面板打开时按 Enter 会采用当前选中项;命令名还支持**唯一前缀自动展开**(输入 `/ne` 按 Enter 即执行 `/new`),带参数时同样生效(`/di HEAD` → `/diff HEAD`)。`/review` 这类**要收一段输入**的命令是例外:回车只把它补进输入框(`/review `,光标落在空格后、下方显示提示),你写完要求再按回车才执行。
|
|
95
|
+
|
|
96
|
+
桌面端输入框里能跑的是 9 条:`/new` `/compact` `/status` `/usage` `/diff` `/review` `/review-status` `/review-cancel` `/help`;
|
|
97
|
+
在那里的 `/help` 只列这 9 条(以前会把 23 条全列出来,其中 16 条一敲就被拒)。权限、模型、
|
|
98
|
+
思考强度这些有底栏旋钮的命令,完整清单在终端里打 `/help` 看。
|
|
99
|
+
|
|
100
|
+
手机上打 `/` 也会弹同一张菜单(点一行采纳),发出去的命令走宿主那条派发通道——以前手机上
|
|
101
|
+
打 `/compact` 会被当成普通消息喂给模型,模型只好回一句「不认识」。
|
|
102
|
+
|
|
103
|
+
工具授权卡出现时:`y` 允许一次,`n`(或 Esc)拒绝。卡只弹在发起它的那个会话里——后台会话的卡不串到当前视图,切回去(状态点会亮)再答。
|
|
104
|
+
|
|
105
|
+
## 工具集(10 件)
|
|
106
|
+
|
|
107
|
+
`bash`(PowerShell)、`read`、`write`、`edit`(唯一匹配替换)、`glob`、`grep` 六件核心读写搜索工具;
|
|
108
|
+
另有 4 件:后台作业三件套 `job_output` / `job_list` / `job_kill`,以及交互终端 `terminal`。
|
|
109
|
+
读类工具自动放行;**写/执行类必须过审批卡**(无持久授权,一次授权一次生效)。
|
|
110
|
+
|
|
111
|
+
## 配置
|
|
112
|
+
|
|
113
|
+
Pneuma 只读**自己的**配置文件(`~/.dsc/`):
|
|
114
|
+
|
|
115
|
+
- **`~/.dsc/config.yaml`**(主配置):`default`(默认 provider/model)+ `providers`
|
|
116
|
+
(`displayName` / `baseURL` / `apiKeyEnv` / `models` 列表;可选 `api` 选线上协议适配器,
|
|
117
|
+
缺省 `openai-compat` 风格的 `openai-completions`,装了提供别的协议的插件后可换)。
|
|
118
|
+
- **模型可选字段**(不写就用默认,设置界面「模型」分区每个模型一行可直接改):
|
|
119
|
+
|
|
120
|
+
```yaml
|
|
121
|
+
models:
|
|
122
|
+
- id: hy3-a
|
|
123
|
+
contextWindow: 200000 # 上下文窗口(用于压缩阈值与侧栏显示)
|
|
124
|
+
maxTokens: 32000 # 单次输出上限
|
|
125
|
+
thinkingLevels: [off, low, max] # 这个模型支持哪几档思考(默认四档 off/low/high/max)
|
|
126
|
+
thinkingParam: reasoning-effort # 档位发哪个字段:thinking / reasoning-effort / none
|
|
127
|
+
effortMap: { low: minimal, max: ultra_max } # 各档发给端点的线上值(写 null = 不发字段)
|
|
128
|
+
modalities: [text, image] # 能收什么输入:text / image / video
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
`thinkingParam` 默认 `thinking`(只有开关、无档位字段的协议),此时低/高/最大都发 `thinking: enabled`;
|
|
132
|
+
网关按档位取值的(发 `reasoning_effort`)要显式写成 `reasoning-effort`,界面上的思考档位才会真的生效。
|
|
133
|
+
`modalities` 没写 `image` 的模型,界面上贴图会被直接拒绝。
|
|
134
|
+
- **key 来源顺序**:`apiKeyEnv` 指向的环境变量 → `~/.dsc/credentials.yaml`。代码绝不打印 key。
|
|
135
|
+
- **`~/.dsc/config.json`**(可选轻量覆盖):`{ "provider": "...", "model": "...", "temperature": 0.7 }`。
|
|
136
|
+
|
|
137
|
+
```sh
|
|
138
|
+
numa config show # 查看当前生效的端点/模型/key 来源(不打印 key)
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
- **会话落盘**:`~/.dsc/sessions/<cwd 压缩名>/<uuid>.jsonl`(append-only,重放恢复);
|
|
142
|
+
`~/.dsc/.last-session` 是 `--resume` 无参时的指针。
|
|
143
|
+
- **附件落盘**:`~/.dsc/attachments/v1/objects/<sha 前两位>/<sha256>`(内容寻址,同字节只存一份)。
|
|
144
|
+
会话 jsonl 里只记引用(`/api/attachments/<sha>`),图片在组装模型请求时才读成 base64;
|
|
145
|
+
单图 ≤ 20MiB,一个视频/其它文件 ≤ 200MiB,一条消息最多 20 张图(含视频抽帧)。附件不会自动清理。
|
|
146
|
+
|
|
147
|
+
## 插件
|
|
148
|
+
|
|
149
|
+
每个服务一个 cordis 插件。官方可开关插件共 **18 个**(默认开:联网搜索、危险命令硬拦截、长输出转存、历史会话搜索、文件与命令围栏、改动前预览;默认关:子智能体、共享任务板、操作电脑桌面、外部命令钩子、MCP 外部工具、工具按需加载、定时任务、代码跳转与报错、受控浏览器、侧栏浏览器、经验沉淀、dsh 插件兼容),在插件中心里手动开关;长期记忆是默认开的内核插件。完整清单与各自干什么见 [docs/development.md](docs/development.md) 第 4 节。
|
|
150
|
+
|
|
151
|
+
界面那一半(含 dsh 组合包自带的界面半)也在插件中心里管:手工放进 `~/.dsc/plugins/<目录>/` 的
|
|
152
|
+
要先点一次「确认信任」,用 `numa plugin add` 装进 profile 的组合包装了就算同意,直接在
|
|
153
|
+
「组合包界面」那一组里开关。
|
|
154
|
+
|
|
155
|
+
外部插件 = 单个 ESM `.js` 文件放进 `~/.dsc/plugins/`,可注册工具、命令、监听事件,
|
|
156
|
+
桌面端「插件」页可视化管理。完整 API、上手路径与扩展点速查见 **[docs/plugin-development.md](docs/plugin-development.md)**(§0 快速上手,§1–§10 完整规格);可运行示例见 `examples/plugins/ping.js`。
|
|
157
|
+
|
|
158
|
+
## 架构
|
|
159
|
+
|
|
160
|
+
一条消息的旅程:
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
你的一句话 → ReAct 循环(流式)→ 写/执行类先过审批卡 → 工具 → 定稿 → JSONL 落盘 → 界面快照
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
```
|
|
167
|
+
bin/dsc.js 启动器(零依赖):--resume / config 子命令 → spawn node lib/boot.js
|
|
168
|
+
src/boot.ts 进程入口:读配置 → createKernel()(cordis 装配)→ 装 UI 插件
|
|
169
|
+
src/tools/config-cli.ts numa config 命令行工具
|
|
170
|
+
src/core/ 自研引擎(零 UI 依赖)
|
|
171
|
+
config.ts 读 ~/.dsc/config.yaml + key 来源链(env → 凭据文件)
|
|
172
|
+
llm.ts OpenAI chat-completions 流式客户端(SSE/reasoning/tool_calls/usage/重试)
|
|
173
|
+
session.ts JSONL 会话(append-only + 重放恢复)
|
|
174
|
+
loop.ts MiniAgent ReAct 循环(turn → stream → 审批 → 工具 → 定稿)
|
|
175
|
+
tools/ bash/read/write/edit/glob/grep 注册表
|
|
176
|
+
approval.ts 写/执行类挂起等 y/n
|
|
177
|
+
compact.ts 保头折尾摘要压缩
|
|
178
|
+
src/adapter/ core 事件 → 快照投影(transcript 折叠 + core-runtime)
|
|
179
|
+
src/contract.ts UI ⇄ 运行时 的中性契约(DscRuntime)
|
|
180
|
+
src/host/kernel.ts 内核装配顺序 + 三档插件清单(运行内核 / 官方可开关 / 自定义)
|
|
181
|
+
src/plugins/ 每个服务一个 cordis 插件(含官方可开关插件,见上文清单)
|
|
182
|
+
src/app/ ink UI(App/ChatView/Composer/ToolCard/ApprovalCard/SessionPicker/StatusBar)
|
|
183
|
+
desktop/ Electron 桌面端:主进程 + 独立运行时子进程;界面就是插件壳(旧渲染层已删除)
|
|
184
|
+
ui-shell/ 桌面与手机共用的界面壳(插件化:布局 + 基元 + 官方界面插件;产物落 lib/ui/assets)
|
|
185
|
+
scripts/composer-test.mjs 候选面板/输入行的确定性测试(node scripts/composer-test.mjs,16 项断言)
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
**模式(Agent 预设)**:一根独立的旋钮,决定模型是谁、手上有什么、被叮嘱了什么(提示词 + 工具目录)。出厂四个——标准 / PTC / 极简 / 创造(顺序与 dsh 的 preset 一致):PTC 是全量工具再加 `run_code`,极简只有一条 shell 加 `read_image`、提示词换成一句固定话(保留 AGENTS.md 注入),创造在标准之上加 `runtime_api`。自己加的模式就是 `~/.dsc/presets/<名字>.md` 一个文件,设置页可图形编辑,输入框下方那颗旋钮或 `/preset <名字>` 切换。模式**只做减法**(工具白名单取子集、提示段只能摘掉四段),任何模式都放宽不了安全。详见 [docs/presets.md](docs/presets.md)。
|
|
189
|
+
|
|
190
|
+
## 权限与安全边界
|
|
191
|
+
|
|
192
|
+
三件事叠在一起,越靠后越硬:
|
|
193
|
+
|
|
194
|
+
- **权限预设(出厂四个)** — 只读 / 工作区可写(默认)/ 完全访问 / AI 复核,取值与 dsh 对齐:只读是「只读沙箱 + 拦下后问你一次」,工作区可写是「工作区沙箱 + 区外问」,完全访问是「不设围栏 + 不问」,AI 复核是「不设围栏 + 每次调用先过模型判官」。切预设时沙箱、权限模式、审阅者三根一起写盘,重启后还是同一档;要微调就逐格改,会落到 `custom`。
|
|
195
|
+
- **审批卡** — 区外写入与命令一律挂起等你按 `y` / `n`,**一次授权一次生效**,没有持久授权。卡上只放四样东西:这次要干什么(一行中文,例如「删除 D:\\dsc\\.tmp」)、命令原文、为什么现在问你、以及改动预览;`pnpm --version`、`node -v` 这类只打印版本或帮助的命令不再弹卡。
|
|
196
|
+
- **灾难地板** — 危险命令(格式化磁盘、递归删根、`git push --force` 之类)即使选了「完全访问」也直接拒。
|
|
197
|
+
|
|
198
|
+
**边界要说清楚**:沙箱是策略围栏(默认开的 sandbox 插件:可写根白名单、受保护路径、命令前缀策略、一次性升权),拦得住 Pneuma 自己发起的工具调用,**拦不住命令内部的任意写**——那要选容器后端;最终兜底仍是审批卡。
|
|
199
|
+
|
|
200
|
+
## 已知限制
|
|
201
|
+
|
|
202
|
+
- 插件能加工具、命令、事件监听、设置分区和技能来源,但拿不到 DOM:界面扩展只接受可 JSON 序列化的控件声明。
|
|
203
|
+
- Windows 中文输入法可能拦截审批卡的 y/n 键(输入法切英文即可)。
|
|
204
|
+
- **电脑控制**(无障碍元素级点击 / 拖拽 / 截图)目前仅 Windows,且没接沙箱——动作按危险分级审计,最终仍过审批卡。
|
|
205
|
+
- 跨进程的路由状态(当前模型/思考强度)不落盘,重启宿主后回到配置默认值。
|
|
206
|
+
|
|
207
|
+
## 开发
|
|
208
|
+
|
|
209
|
+
```sh
|
|
210
|
+
pnpm install
|
|
211
|
+
pnpm build # 编内部引擎与宿主(tsc → lib/)
|
|
212
|
+
pnpm build:ui # 编桌面 / 手机共用的界面壳(产物落 lib/ui/assets)
|
|
213
|
+
pnpm typecheck
|
|
214
|
+
pnpm dev # tsc --watch
|
|
215
|
+
|
|
216
|
+
node scripts/composer-test.mjs # 自检:scripts/ 下每个 *-test.mjs 都是一个能单独跑的无头脚本
|
|
217
|
+
cd desktop && pnpm dev # 桌面端(先把上面两条 build 跑过)
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
桌面端的进程分层、宿主 ⇄ 壳协议与打包流程见 [desktop/README.md](desktop/README.md)。
|
|
221
|
+
|
|
222
|
+
## 文档
|
|
223
|
+
|
|
224
|
+
| 文档 | 讲什么 |
|
|
225
|
+
| --- | --- |
|
|
226
|
+
| [docs/development.md](docs/development.md) | 开发手册:运行时结构、三条启动链路、进程间协议、`~/.dsc` 数据面、扩展点清单、自检与打包、代码约定、排错与关键数值 |
|
|
227
|
+
| [docs/development-log.md](docs/development-log.md) | 开发记录:各阶段引入了什么、决策台账、真 bug 台账、还欠什么 |
|
|
228
|
+
| [docs/plugin-development.md](docs/plugin-development.md) | 插件开发:§0 从零上手(选形态、跑通最小链路、扩展点速查、交付自检)+ §1–§10 完整规格(全表签名、dsh 兼容层、界面插件契约) |
|
|
229
|
+
| [docs/presets.md](docs/presets.md) | **模式(Agent 预设)**:模式文件怎么写、出厂四个各是什么、可去掉哪些提示段、四条硬规矩 |
|
|
230
|
+
| [docs/ui-design.md](docs/ui-design.md) | 界面开发规范:设计原则、令牌体系、原语层、布局与反馈、键盘与动效、主题引擎对照 |
|
|
231
|
+
|
|
232
|
+
其余文档按用途分三类:
|
|
233
|
+
|
|
234
|
+
**活参考与现状说明**:[docs/harness-benchmark-roadmap.md](docs/harness-benchmark-roadmap.md)(对标差距与路线图)、[docs/peer-feature-inventory.md](docs/peer-feature-inventory.md)(三家功能面清单)、[docs/remote-tunnel.md](docs/remote-tunnel.md)(遥控端口走隧道)
|
|
235
|
+
|
|
236
|
+
**外部实现拆解(按名字查的参考资料)**:[docs/codex-request-assembly.md](docs/codex-request-assembly.md)(codex 的请求组装)、[docs/dsh-request-assembly.md](docs/dsh-request-assembly.md)(dsh 的请求组装)、[docs/dsh-plugin-porting.md](docs/dsh-plugin-porting.md)(dsh 插件搬到 Pneuma 怎么改、哪些不支持)
|
|
237
|
+
|
|
238
|
+
**已归档**:已完成的历史计划、一次性审查报告与停更的对照表都移到 [docs/archive/](docs/archive/) 了,每篇开头有一行 `状态:已归档(原因)` 和去向说明。共 14 篇,另有 `archive/shots/` 下 6 份当时的施工自检报告。
|
|
239
|
+
|
|
240
|
+
## 许可
|
|
241
|
+
|
|
242
|
+
MIT,见 [LICENSE](LICENSE)。问题与建议走 [Issues](https://github.com/waq05/pneuma/issues)。
|
package/bin/dsc.js
CHANGED
|
@@ -44,14 +44,20 @@ if (first === '--help' || first === '-h') {
|
|
|
44
44
|
'\n' +
|
|
45
45
|
'配置:\n' +
|
|
46
46
|
' numa config migrate [--force] 从 dsh 迁移模型配置到 ~/.dsc/config.yaml\n' +
|
|
47
|
-
' numa config show 显示当前生效的端点/模型/key 来源\n'
|
|
47
|
+
' numa config show 显示当前生效的端点/模型/key 来源\n' +
|
|
48
|
+
'\n' +
|
|
49
|
+
'插件(dsh 生态的组合包):\n' +
|
|
50
|
+
' numa plugin add <包名|tarball|路径> [--profile 名字] 装一个组合包并登记到 profile\n' +
|
|
51
|
+
' numa plugin remove <包名> [--profile 名字] 卸掉\n' +
|
|
52
|
+
' numa plugin list [--profile 名字] 列出已装组合包与版本闸状态\n',
|
|
48
53
|
)
|
|
49
54
|
process.exit(0)
|
|
50
55
|
}
|
|
51
56
|
|
|
52
57
|
// ── 子命令:config(交给 lib/tools/config-cli.js) ───────────────────────────
|
|
53
|
-
if (first === 'config') {
|
|
54
|
-
const
|
|
58
|
+
if (first === 'config' || first === 'plugin') {
|
|
59
|
+
const tool = first === 'config' ? 'config-cli.js' : 'plugin-cli.js'
|
|
60
|
+
const child = spawn(process.execPath, [join(PKG_ROOT, 'lib', 'tools', tool), ...process.argv.slice(3)], {
|
|
55
61
|
stdio: 'inherit',
|
|
56
62
|
env: process.env,
|
|
57
63
|
})
|
package/bin/headless.cjs
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
* 用法(终端手测,stdin/stdout JSONL):
|
|
12
12
|
* node <dsc>/bin/headless.cjs
|
|
13
13
|
*/
|
|
14
|
-
/*
|
|
14
|
+
/* 本文件是 CommonJS 启动脚本:require 是它唯一的加载方式,不走 ESM import。 */
|
|
15
15
|
'use strict'
|
|
16
16
|
|
|
17
17
|
const { pathToFileURL } = require('node:url')
|
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
import type { CoreEvent } from '../core/events.js';
|
|
17
17
|
import { type ChatMessage } from '../core/llm.js';
|
|
18
18
|
import type { FileChangeSummary } from '../core/tools.js';
|
|
19
|
+
import type { ToolPresentationView } from '../contract.js';
|
|
19
20
|
import { type CostBuckets } from '../core/pricing.js';
|
|
20
21
|
import { type RequestSegments } from '../core/token-estimate.js';
|
|
21
22
|
import type { TokenUsageView, TranscriptEntry } from '../contract.js';
|
|
@@ -81,6 +82,21 @@ export declare class Transcript {
|
|
|
81
82
|
* 下一帧事件到达自然修正。
|
|
82
83
|
*/
|
|
83
84
|
seedTurnState(running: boolean): void;
|
|
85
|
+
/**
|
|
86
|
+
* 会话重新打开时把「最近一次请求的上下文占用」种回来。
|
|
87
|
+
*
|
|
88
|
+
* 为什么需要:contextUsed 只在收到 usage 事件时赋值,而重放历史明确不重放 usage;
|
|
89
|
+
* 宿主重启后第一帧于是显示 0%,用户看到的是「上下文被清空了」,实际只是读数没恢复。
|
|
90
|
+
* usage 日志里按会话存着每条请求的输入 token(最后一条就是此刻的占用),
|
|
91
|
+
* 由调用方读出后交给这里补上。
|
|
92
|
+
*
|
|
93
|
+
* 为什么只补总数、不补分段:分段(系统提示词 / 工具定义 / 对话消息)是宿主按
|
|
94
|
+
* 请求内容估出来的,日志里没有;它仍然要等下一次请求的 context 事件。这里若把
|
|
95
|
+
* 总数塞进 contextSegments,卡片就会拿一份假的分段画进度条。
|
|
96
|
+
*
|
|
97
|
+
* 没有样本的会话不要调用(调用方传 0 会把「还没数」伪装成一个 0% 读数)。
|
|
98
|
+
*/
|
|
99
|
+
seedContextUsage(used: number): void;
|
|
84
100
|
/**
|
|
85
101
|
* 本会话已经落过几条压缩标记(`clear()` 归零)。新标记的 `count` 就是它加一,
|
|
86
102
|
* 因此这个数就是「第几次压缩」。标记只在真正压过的地方产生,所以不必认识压缩服务。
|
|
@@ -99,8 +115,9 @@ export declare class Transcript {
|
|
|
99
115
|
/**
|
|
100
116
|
* 追加一条系统提示(错误/状态说明)。
|
|
101
117
|
* @param compaction - 这条提示是「历史刚被压缩」的落点:带标记,轨迹页据此切区段。
|
|
118
|
+
* @param level - `'error'` 表示要人处理的问题:界面会弹一次提示而不再铺在首屏;缺省只进日志。
|
|
102
119
|
*/
|
|
103
|
-
system(text: string, compaction?: boolean): void;
|
|
120
|
+
system(text: string, compaction?: boolean, level?: 'info' | 'error', command?: boolean): void;
|
|
104
121
|
/** 下一个压缩标记;只有真压过的地方才调用,所以序号不会跳。 */
|
|
105
122
|
private compactionMark;
|
|
106
123
|
/**
|
|
@@ -121,7 +138,7 @@ export declare class Transcript {
|
|
|
121
138
|
* 时间戳跟着消息走(`ChatMessage.ts`,由会话日志重放时填回):有就盖在条目上,
|
|
122
139
|
* 没有(2026-09 之前的老日志)就传 null,条目干脆不带 ts,界面降级不显示时间。
|
|
123
140
|
*/
|
|
124
|
-
replayHistory(messages: readonly ChatMessage[], toolErrors?: ReadonlyMap<string, string>, fileChanges?: ReadonlyMap<string, FileChangeSummary>): boolean;
|
|
141
|
+
replayHistory(messages: readonly ChatMessage[], toolErrors?: ReadonlyMap<string, string>, fileChanges?: ReadonlyMap<string, readonly FileChangeSummary[]>, presentations?: ReadonlyMap<string, ToolPresentationView>): boolean;
|
|
125
142
|
/** 给新条目盖时间戳;重放老日志(eventTs 为 null)时不盖。 */
|
|
126
143
|
private stamp;
|
|
127
144
|
/**
|