@draht/coding-agent 2026.7.30 → 2026.9.5-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/CHANGELOG.md +154 -0
- package/README.md +46 -2
- package/agents/debugger.md +12 -1
- package/agents/git-committer.md +1 -0
- package/agents/implementer.md +20 -0
- package/agents/investigator.md +75 -0
- package/agents/reviewer.md +7 -0
- package/agents/spec-reviewer.md +66 -0
- package/agents/verifier.md +4 -3
- package/bin/draht-tools.cjs +472 -41
- package/dist/agents/debugger.md +12 -1
- package/dist/agents/git-committer.md +1 -0
- package/dist/agents/implementer.md +20 -0
- package/dist/agents/investigator.md +75 -0
- package/dist/agents/reviewer.md +7 -0
- package/dist/agents/spec-reviewer.md +66 -0
- package/dist/agents/verifier.md +4 -3
- package/dist/cli/args.d.ts +10 -0
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +69 -2
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/attach-mode.d.ts +61 -0
- package/dist/cli/attach-mode.d.ts.map +1 -1
- package/dist/cli/attach-mode.js +243 -5
- package/dist/cli/attach-mode.js.map +1 -1
- package/dist/cli/credential-print.d.ts +1 -1
- package/dist/cli/credential-print.d.ts.map +1 -1
- package/dist/cli/credential-print.js +5 -4
- package/dist/cli/credential-print.js.map +1 -1
- package/dist/config.d.ts +9 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +31 -4
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +17 -1
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +87 -30
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts +1 -1
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +1 -0
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +35 -16
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +149 -64
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts +5 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +72 -15
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/builtins/checkpoints.d.ts +20 -0
- package/dist/core/builtins/checkpoints.d.ts.map +1 -0
- package/dist/core/builtins/checkpoints.js +161 -0
- package/dist/core/builtins/checkpoints.js.map +1 -0
- package/dist/core/builtins/duet.d.ts +26 -0
- package/dist/core/builtins/duet.d.ts.map +1 -0
- package/dist/core/builtins/duet.js +660 -0
- package/dist/core/builtins/duet.js.map +1 -0
- package/dist/core/builtins/index.d.ts.map +1 -1
- package/dist/core/builtins/index.js +7 -1
- package/dist/core/builtins/index.js.map +1 -1
- package/dist/core/builtins/subagent.d.ts +24 -4
- package/dist/core/builtins/subagent.d.ts.map +1 -1
- package/dist/core/builtins/subagent.js +278 -35
- package/dist/core/builtins/subagent.js.map +1 -1
- package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
- package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-cli.js +78 -0
- package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts +294 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.js +865 -0
- package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
- package/dist/core/checkpoints/rewind.d.ts +141 -0
- package/dist/core/checkpoints/rewind.d.ts.map +1 -0
- package/dist/core/checkpoints/rewind.js +246 -0
- package/dist/core/checkpoints/rewind.js.map +1 -0
- package/dist/core/compaction/branch-summarization.d.ts +1 -1
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +9 -4
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +5 -0
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +25 -4
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/extensions/index.d.ts +1 -1
- package/dist/core/extensions/index.d.ts.map +1 -1
- package/dist/core/extensions/index.js.map +1 -1
- package/dist/core/extensions/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +83 -20
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +13 -2
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +37 -2
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +189 -6
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/http-dispatcher.d.ts.map +1 -1
- package/dist/core/http-dispatcher.js +7 -0
- package/dist/core/http-dispatcher.js.map +1 -1
- package/dist/core/index.d.ts +1 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/keybindings.d.ts +5 -0
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +1 -0
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/model-registry.d.ts +3 -2
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +8 -8
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +34 -7
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +7 -1
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +30 -10
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
- package/dist/core/multi-agent/permission-gate.js +4 -3
- package/dist/core/multi-agent/permission-gate.js.map +1 -1
- package/dist/core/multi-agent/worktree.d.ts +2 -0
- package/dist/core/multi-agent/worktree.d.ts.map +1 -1
- package/dist/core/multi-agent/worktree.js +2 -2
- package/dist/core/multi-agent/worktree.js.map +1 -1
- package/dist/core/package-manager.d.ts +7 -1
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +21 -44
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/permission-relay/index.d.ts +19 -0
- package/dist/core/permission-relay/index.d.ts.map +1 -0
- package/dist/core/permission-relay/index.js +49 -0
- package/dist/core/permission-relay/index.js.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.js +788 -0
- package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
- package/dist/core/permission-relay/types.d.ts +222 -0
- package/dist/core/permission-relay/types.d.ts.map +1 -0
- package/dist/core/permission-relay/types.js +15 -0
- package/dist/core/permission-relay/types.js.map +1 -0
- package/dist/core/pi-manifest.d.ts +14 -0
- package/dist/core/pi-manifest.d.ts.map +1 -0
- package/dist/core/pi-manifest.js +35 -0
- package/dist/core/pi-manifest.js.map +1 -0
- package/dist/core/project-trust.js +2 -2
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/resource-loader.d.ts +21 -0
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +101 -24
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/sandbox/bash-operations.d.ts +149 -0
- package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
- package/dist/core/sandbox/bash-operations.js +163 -0
- package/dist/core/sandbox/bash-operations.js.map +1 -0
- package/dist/core/sandbox/env.d.ts +83 -0
- package/dist/core/sandbox/env.d.ts.map +1 -0
- package/dist/core/sandbox/env.js +123 -0
- package/dist/core/sandbox/env.js.map +1 -0
- package/dist/core/sandbox/executor.d.ts +104 -0
- package/dist/core/sandbox/executor.d.ts.map +1 -0
- package/dist/core/sandbox/executor.js +92 -0
- package/dist/core/sandbox/executor.js.map +1 -0
- package/dist/core/sandbox/index.d.ts +36 -0
- package/dist/core/sandbox/index.d.ts.map +1 -0
- package/dist/core/sandbox/index.js +36 -0
- package/dist/core/sandbox/index.js.map +1 -0
- package/dist/core/sandbox/linux.d.ts +121 -0
- package/dist/core/sandbox/linux.d.ts.map +1 -0
- package/dist/core/sandbox/linux.js +260 -0
- package/dist/core/sandbox/linux.js.map +1 -0
- package/dist/core/sandbox/policy.d.ts +142 -0
- package/dist/core/sandbox/policy.d.ts.map +1 -0
- package/dist/core/sandbox/policy.js +297 -0
- package/dist/core/sandbox/policy.js.map +1 -0
- package/dist/core/sandbox/real-path.d.ts +112 -0
- package/dist/core/sandbox/real-path.d.ts.map +1 -0
- package/dist/core/sandbox/real-path.js +158 -0
- package/dist/core/sandbox/real-path.js.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.js +239 -0
- package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
- package/dist/core/sandbox/seatbelt.d.ts +95 -0
- package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt.js +154 -0
- package/dist/core/sandbox/seatbelt.js.map +1 -0
- package/dist/core/sandbox/self-test.d.ts +109 -0
- package/dist/core/sandbox/self-test.d.ts.map +1 -0
- package/dist/core/sandbox/self-test.js +369 -0
- package/dist/core/sandbox/self-test.js.map +1 -0
- package/dist/core/sandbox/spawn.d.ts +33 -0
- package/dist/core/sandbox/spawn.d.ts.map +1 -0
- package/dist/core/sandbox/spawn.js +87 -0
- package/dist/core/sandbox/spawn.js.map +1 -0
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +3 -1
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-manager.d.ts +60 -1
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +53 -6
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-manager.d.ts +21 -0
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +36 -16
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/skills.d.ts +3 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +19 -6
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +1 -0
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/soak/soak-log.d.ts +298 -0
- package/dist/core/soak/soak-log.d.ts.map +1 -0
- package/dist/core/soak/soak-log.js +660 -0
- package/dist/core/soak/soak-log.js.map +1 -0
- package/dist/core/soak/soak-reader.d.ts +60 -0
- package/dist/core/soak/soak-reader.d.ts.map +1 -0
- package/dist/core/soak/soak-reader.js +106 -0
- package/dist/core/soak/soak-reader.js.map +1 -0
- package/dist/core/socket-server/discovery.d.ts +78 -1
- package/dist/core/socket-server/discovery.d.ts.map +1 -1
- package/dist/core/socket-server/discovery.js +356 -37
- package/dist/core/socket-server/discovery.js.map +1 -1
- package/dist/core/socket-server/index.d.ts +10 -4
- package/dist/core/socket-server/index.d.ts.map +1 -1
- package/dist/core/socket-server/index.js +6 -3
- package/dist/core/socket-server/index.js.map +1 -1
- package/dist/core/socket-server/permission-delivery.d.ts +125 -0
- package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
- package/dist/core/socket-server/permission-delivery.js +152 -0
- package/dist/core/socket-server/permission-delivery.js.map +1 -0
- package/dist/core/socket-server/permission-registry.d.ts +301 -0
- package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
- package/dist/core/socket-server/permission-registry.js +410 -0
- package/dist/core/socket-server/permission-registry.js.map +1 -0
- package/dist/core/socket-server/permission-relay.d.ts +81 -0
- package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
- package/dist/core/socket-server/permission-relay.js +528 -0
- package/dist/core/socket-server/permission-relay.js.map +1 -0
- package/dist/core/socket-server/safe-text.d.ts +83 -0
- package/dist/core/socket-server/safe-text.d.ts.map +1 -0
- package/dist/core/socket-server/safe-text.js +277 -0
- package/dist/core/socket-server/safe-text.js.map +1 -0
- package/dist/core/socket-server/session-integration.d.ts +65 -2
- package/dist/core/socket-server/session-integration.d.ts.map +1 -1
- package/dist/core/socket-server/session-integration.js +434 -32
- package/dist/core/socket-server/session-integration.js.map +1 -1
- package/dist/core/socket-server/socket-client.d.ts +21 -2
- package/dist/core/socket-server/socket-client.d.ts.map +1 -1
- package/dist/core/socket-server/socket-client.js +52 -1
- package/dist/core/socket-server/socket-client.js.map +1 -1
- package/dist/core/socket-server/socket-server.d.ts +152 -1
- package/dist/core/socket-server/socket-server.d.ts.map +1 -1
- package/dist/core/socket-server/socket-server.js +775 -26
- package/dist/core/socket-server/socket-server.js.map +1 -1
- package/dist/core/socket-server/types.d.ts +106 -2
- package/dist/core/socket-server/types.d.ts.map +1 -1
- package/dist/core/socket-server/types.js +13 -1
- package/dist/core/socket-server/types.js.map +1 -1
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +8 -9
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/tools/bash.d.ts +1 -1
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +5 -2
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +17 -2
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/find.d.ts +3 -0
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +11 -18
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/trust-manager.d.ts +6 -4
- package/dist/core/trust-manager.d.ts.map +1 -1
- package/dist/core/trust-manager.js +55 -21
- package/dist/core/trust-manager.js.map +1 -1
- package/dist/extensions/index.d.ts.map +1 -1
- package/dist/extensions/index.js +5 -1
- package/dist/extensions/index.js.map +1 -1
- package/dist/extensions/llama/provider.d.ts.map +1 -1
- package/dist/extensions/llama/provider.js +5 -1
- package/dist/extensions/llama/provider.js.map +1 -1
- package/dist/extensions/stub-provider/index.d.ts +9 -0
- package/dist/extensions/stub-provider/index.d.ts.map +1 -0
- package/dist/extensions/stub-provider/index.js +13 -0
- package/dist/extensions/stub-provider/index.js.map +1 -0
- package/dist/extensions/stub-provider/provider.d.ts +77 -0
- package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
- package/dist/extensions/stub-provider/provider.js +193 -0
- package/dist/extensions/stub-provider/provider.js.map +1 -0
- package/dist/hooks/gsd/draht-quality-gate.js +3 -3
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +242 -45
- package/dist/main.js.map +1 -1
- package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/config-selector.js +3 -2
- package/dist/modes/interactive/components/config-selector.js.map +1 -1
- package/dist/modes/interactive/components/extension-selector.d.ts +49 -0
- package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-selector.js +202 -5
- package/dist/modes/interactive/components/extension-selector.js.map +1 -1
- package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/session-selector.js +10 -2
- package/dist/modes/interactive/components/session-selector.js.map +1 -1
- package/dist/modes/interactive/components/settings-selector.d.ts +2 -0
- package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/settings-selector.js +10 -0
- package/dist/modes/interactive/components/settings-selector.js.map +1 -1
- package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/tool-execution.js +10 -1
- package/dist/modes/interactive/components/tool-execution.js.map +1 -1
- package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +21 -5
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/interactive-mode.d.ts +97 -3
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +394 -24
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +165 -7
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +68 -1
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/prompts/commands/atomic-commit.md +1 -12
- package/dist/prompts/commands/brainstorm.md +12 -15
- package/dist/prompts/commands/create-verification-skill.md +108 -0
- package/dist/prompts/commands/discuss-phase.md +3 -14
- package/dist/prompts/commands/execute-phase.md +3 -11
- package/dist/prompts/commands/fix.md +41 -18
- package/dist/prompts/commands/grill.md +66 -0
- package/dist/prompts/commands/init-project.md +5 -15
- package/dist/prompts/commands/map-codebase.md +1 -13
- package/dist/prompts/commands/new-project.md +5 -15
- package/dist/prompts/commands/next-milestone.md +1 -13
- package/dist/prompts/commands/orchestrate.md +1 -1
- package/dist/prompts/commands/pause-work.md +1 -13
- package/dist/prompts/commands/plan-phase.md +2 -11
- package/dist/prompts/commands/progress.md +0 -13
- package/dist/prompts/commands/quick.md +3 -11
- package/dist/prompts/commands/resolve-conflicts.md +71 -0
- package/dist/prompts/commands/resume-work.md +0 -13
- package/dist/prompts/commands/review.md +4 -13
- package/dist/prompts/commands/triage.md +159 -0
- package/dist/prompts/commands/verify-work.md +4 -14
- package/dist/prompts/commands/why.md +135 -0
- package/dist/skills/atomic-reasoning/SKILL.md +115 -0
- package/dist/skills/blast-radius/SKILL.md +55 -0
- package/dist/skills/epistemics/SKILL.md +99 -0
- package/dist/skills/hexagon-animation/SKILL.md +49 -0
- package/dist/skills/hexagon-animation/generate.mjs +81 -0
- package/dist/skills/hexagon-animation/template.html +361 -0
- package/dist/skills/typescript-discipline/SKILL.md +50 -0
- package/dist/skills/typescript-discipline/references/patterns.md +294 -0
- package/dist/skills/unslop/SKILL.md +101 -0
- package/dist/utils/canonical-path.d.ts +28 -0
- package/dist/utils/canonical-path.d.ts.map +1 -0
- package/dist/utils/canonical-path.js +90 -0
- package/dist/utils/canonical-path.js.map +1 -0
- package/dist/utils/child-process.d.ts +12 -1
- package/dist/utils/child-process.d.ts.map +1 -1
- package/dist/utils/child-process.js +25 -8
- package/dist/utils/child-process.js.map +1 -1
- package/dist/utils/clipboard.d.ts +1 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +22 -2
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/exif-orientation.d.ts.map +1 -1
- package/dist/utils/exif-orientation.js +2 -3
- package/dist/utils/exif-orientation.js.map +1 -1
- package/dist/utils/paths.d.ts +2 -7
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +13 -15
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +6 -4
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +3 -5
- package/dist/utils/tools-manager.js.map +1 -1
- package/docs/attachable-sessions.md +79 -0
- package/docs/compaction.md +21 -21
- package/docs/containerization.md +23 -23
- package/docs/custom-provider.md +16 -16
- package/docs/development.md +9 -9
- package/docs/docs.json +6 -2
- package/docs/duet.md +42 -0
- package/docs/extensions.md +58 -58
- package/docs/index.md +10 -10
- package/docs/json.md +7 -7
- package/docs/keybindings.md +6 -5
- package/docs/llama-cpp.md +6 -6
- package/docs/models.md +6 -6
- package/docs/packages.md +43 -43
- package/docs/prompt-templates.md +4 -4
- package/docs/providers.md +12 -12
- package/docs/quickstart.md +32 -32
- package/docs/rpc.md +83 -12
- package/docs/sdk.md +15 -15
- package/docs/security.md +18 -18
- package/docs/session-format.md +35 -13
- package/docs/sessions.md +17 -14
- package/docs/settings.md +25 -18
- package/docs/shell-aliases.md +2 -2
- package/docs/skills.md +12 -11
- package/docs/terminal-setup.md +12 -12
- package/docs/termux.md +6 -6
- package/docs/themes.md +11 -11
- package/docs/tmux.md +4 -4
- package/docs/tui.md +5 -5
- package/docs/usage.md +50 -50
- package/docs/windows.md +2 -2
- package/examples/extensions/overlay-qa-tests.ts +3 -3
- package/hooks/gsd/draht-quality-gate.js +3 -3
- package/package.json +11 -10
- package/prompts/commands/atomic-commit.md +1 -12
- package/prompts/commands/brainstorm.md +12 -15
- package/prompts/commands/create-verification-skill.md +108 -0
- package/prompts/commands/discuss-phase.md +3 -14
- package/prompts/commands/execute-phase.md +3 -11
- package/prompts/commands/fix.md +41 -18
- package/prompts/commands/grill.md +66 -0
- package/prompts/commands/init-project.md +5 -15
- package/prompts/commands/map-codebase.md +1 -13
- package/prompts/commands/new-project.md +5 -15
- package/prompts/commands/next-milestone.md +1 -13
- package/prompts/commands/orchestrate.md +1 -1
- package/prompts/commands/pause-work.md +1 -13
- package/prompts/commands/plan-phase.md +2 -11
- package/prompts/commands/progress.md +0 -13
- package/prompts/commands/quick.md +3 -11
- package/prompts/commands/resolve-conflicts.md +71 -0
- package/prompts/commands/resume-work.md +0 -13
- package/prompts/commands/review.md +4 -13
- package/prompts/commands/triage.md +159 -0
- package/prompts/commands/verify-work.md +4 -14
- package/prompts/commands/why.md +135 -0
- package/skills/atomic-reasoning/SKILL.md +115 -0
- package/skills/blast-radius/SKILL.md +55 -0
- package/skills/epistemics/SKILL.md +99 -0
- package/skills/hexagon-animation/SKILL.md +49 -0
- package/skills/hexagon-animation/generate.mjs +81 -0
- package/skills/hexagon-animation/template.html +361 -0
- package/skills/typescript-discipline/SKILL.md +50 -0
- package/skills/typescript-discipline/references/patterns.md +294 -0
- package/skills/unslop/SKILL.md +101 -0
- package/dist/prompts/agents/build.md +0 -86
- package/dist/prompts/agents/plan.md +0 -79
- package/dist/prompts/agents/verify.md +0 -69
- package/prompts/agents/build.md +0 -86
- package/prompts/agents/plan.md +0 -79
- package/prompts/agents/verify.md +0 -69
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
* Used when running `draht --attach <session-id>`.
|
|
6
6
|
*/
|
|
7
7
|
import { connect } from "node:net";
|
|
8
|
+
import { PERMISSION_RELAY_CAPABILITY, } from "./types.js";
|
|
8
9
|
/**
|
|
9
10
|
* SocketClient connects to a socket-based draht session.
|
|
10
11
|
*
|
|
@@ -24,6 +25,8 @@ export class SocketClient {
|
|
|
24
25
|
#onInputEcho = null;
|
|
25
26
|
#onError = null;
|
|
26
27
|
#onDisconnect = null;
|
|
28
|
+
#onPermissionRequest = null;
|
|
29
|
+
#onPermissionResolved = null;
|
|
27
30
|
constructor(options) {
|
|
28
31
|
this.#socketPath = options.socketPath;
|
|
29
32
|
this.#clientId = options.clientId ?? `client-${crypto.randomUUID().slice(0, 8)}`;
|
|
@@ -37,10 +40,14 @@ export class SocketClient {
|
|
|
37
40
|
this.#socket = connect(this.#socketPath);
|
|
38
41
|
this.#socket.on("connect", () => {
|
|
39
42
|
// Send attach message
|
|
43
|
+
// Declaring the capability is what makes the session send permission
|
|
44
|
+
// frames to this client at all — an attach line without it is how an
|
|
45
|
+
// older client says "do not send me anything I cannot decode".
|
|
40
46
|
const attach = {
|
|
41
47
|
type: "attach",
|
|
42
48
|
clientId: this.#clientId,
|
|
43
49
|
mode: this.#mode,
|
|
50
|
+
capabilities: [PERMISSION_RELAY_CAPABILITY],
|
|
44
51
|
};
|
|
45
52
|
this.#send(attach);
|
|
46
53
|
resolve();
|
|
@@ -86,6 +93,25 @@ export class SocketClient {
|
|
|
86
93
|
};
|
|
87
94
|
this.#send(input);
|
|
88
95
|
}
|
|
96
|
+
/**
|
|
97
|
+
* Answer a permission ask by naming one of the options it offered.
|
|
98
|
+
*
|
|
99
|
+
* The answer names an option id, never a decision: what an id means is fixed
|
|
100
|
+
* by the ask that offered it, so a client cannot approve something it was
|
|
101
|
+
* only offered the chance to deny.
|
|
102
|
+
*/
|
|
103
|
+
sendPermissionResponse(requestId, optionId) {
|
|
104
|
+
if (!this.#socket) {
|
|
105
|
+
throw new Error("Not connected");
|
|
106
|
+
}
|
|
107
|
+
const response = {
|
|
108
|
+
type: "permission_response",
|
|
109
|
+
clientId: this.#clientId,
|
|
110
|
+
requestId,
|
|
111
|
+
optionId,
|
|
112
|
+
};
|
|
113
|
+
this.#send(response);
|
|
114
|
+
}
|
|
89
115
|
/**
|
|
90
116
|
* Set callback for output received from session.
|
|
91
117
|
*/
|
|
@@ -118,6 +144,9 @@ export class SocketClient {
|
|
|
118
144
|
}
|
|
119
145
|
/**
|
|
120
146
|
* Set callback for errors.
|
|
147
|
+
*
|
|
148
|
+
* `code` identifies the frame: the caller needs it to tell a recoverable condition
|
|
149
|
+
* (a rejected prompt, a replaced session) from a fatal one.
|
|
121
150
|
*/
|
|
122
151
|
onError(callback) {
|
|
123
152
|
this.#onError = callback;
|
|
@@ -128,6 +157,18 @@ export class SocketClient {
|
|
|
128
157
|
onDisconnect(callback) {
|
|
129
158
|
this.#onDisconnect = callback;
|
|
130
159
|
}
|
|
160
|
+
/**
|
|
161
|
+
* Set callback for a permission ask raised by the session.
|
|
162
|
+
*/
|
|
163
|
+
onPermissionRequest(callback) {
|
|
164
|
+
this.#onPermissionRequest = callback;
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* Set callback for the outcome of a permission ask.
|
|
168
|
+
*/
|
|
169
|
+
onPermissionResolved(callback) {
|
|
170
|
+
this.#onPermissionResolved = callback;
|
|
171
|
+
}
|
|
131
172
|
/**
|
|
132
173
|
* Handle incoming data from server.
|
|
133
174
|
*/
|
|
@@ -179,7 +220,17 @@ export class SocketClient {
|
|
|
179
220
|
break;
|
|
180
221
|
case "error":
|
|
181
222
|
if (this.#onError) {
|
|
182
|
-
this.#onError(message.message);
|
|
223
|
+
this.#onError(message.message, message.code);
|
|
224
|
+
}
|
|
225
|
+
break;
|
|
226
|
+
case "permission_request":
|
|
227
|
+
if (this.#onPermissionRequest) {
|
|
228
|
+
this.#onPermissionRequest(message);
|
|
229
|
+
}
|
|
230
|
+
break;
|
|
231
|
+
case "permission_resolved":
|
|
232
|
+
if (this.#onPermissionResolved) {
|
|
233
|
+
this.#onPermissionResolved(message);
|
|
183
234
|
}
|
|
184
235
|
break;
|
|
185
236
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"socket-client.js","sourceRoot":"","sources":["../../../src/core/socket-server/socket-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SocketClient - Client for attaching to a draht socket session\n *\n * Connects to a Unix domain socket, sends input, and receives output.\n * Used when running `draht --attach <session-id>`.\n */\n\nimport { connect, type Socket } from \"node:net\";\nimport type { ClientMessage, ClientMode, ServerMessage } from \"./types.js\";\n\nexport interface SocketClientOptions {\n\t/** Path to the Unix socket */\n\tsocketPath: string;\n\t/** Client identifier (defaults to random ID) */\n\tclientId?: string;\n\t/** Connection mode */\n\tmode?: ClientMode;\n}\n\n/**\n * SocketClient connects to a socket-based draht session.\n *\n * Provides callbacks for output, metadata, and connection events.\n */\nexport class SocketClient {\n\treadonly #socketPath: string;\n\treadonly #clientId: string;\n\treadonly #mode: ClientMode;\n\n\t#socket: Socket | null = null;\n\t#buffer = \"\";\n\n\t/** Callbacks */\n\t#onOutput: ((data: string, stream: \"stdout\" | \"stderr\") => void) | null = null;\n\t#onMetadata: ((sessionId: string, cwd: string, createdAt: Date) => void) | null = null;\n\t#onClientJoined: ((clientId: string, mode: ClientMode) => void) | null = null;\n\t#onClientLeft: ((clientId: string) => void) | null = null;\n\t#onInputEcho: ((data: string, clientId: string) => void) | null = null;\n\t#onError: ((message: string) => void) | null = null;\n\t#onDisconnect: (() => void) | null = null;\n\n\tconstructor(options: SocketClientOptions) {\n\t\tthis.#socketPath = options.socketPath;\n\t\tthis.#clientId = options.clientId ?? `client-${crypto.randomUUID().slice(0, 8)}`;\n\t\tthis.#mode = options.mode ?? \"read-write\";\n\t}\n\n\t/**\n\t * Connect to the socket server.\n\t */\n\tasync connect(): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tthis.#socket = connect(this.#socketPath);\n\n\t\t\tthis.#socket.on(\"connect\", () => {\n\t\t\t\t// Send attach message\n\t\t\t\tconst attach: ClientMessage = {\n\t\t\t\t\ttype: \"attach\",\n\t\t\t\t\tclientId: this.#clientId,\n\t\t\t\t\tmode: this.#mode,\n\t\t\t\t};\n\t\t\t\tthis.#send(attach);\n\t\t\t\tresolve();\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"data\", (data) => {\n\t\t\t\tthis.#handleData(data);\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"close\", () => {\n\t\t\t\tif (this.#onDisconnect) {\n\t\t\t\t\tthis.#onDisconnect();\n\t\t\t\t}\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"error\", (err) => {\n\t\t\t\treject(err);\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Disconnect from the socket server.\n\t */\n\tdisconnect(): void {\n\t\tif (this.#socket) {\n\t\t\tconst detach: ClientMessage = {\n\t\t\t\ttype: \"detach\",\n\t\t\t\tclientId: this.#clientId,\n\t\t\t};\n\t\t\tthis.#send(detach);\n\t\t\tthis.#socket.end();\n\t\t\tthis.#socket = null;\n\t\t}\n\t}\n\n\t/**\n\t * Send input to the session.\n\t */\n\tsendInput(data: string): void {\n\t\tif (!this.#socket) {\n\t\t\tthrow new Error(\"Not connected\");\n\t\t}\n\n\t\tconst input: ClientMessage = {\n\t\t\ttype: \"input\",\n\t\t\tdata,\n\t\t\tclientId: this.#clientId,\n\t\t};\n\t\tthis.#send(input);\n\t}\n\n\t/**\n\t * Set callback for output received from session.\n\t */\n\tonOutput(callback: (data: string, stream: \"stdout\" | \"stderr\") => void): void {\n\t\tthis.#onOutput = callback;\n\t}\n\n\t/**\n\t * Set callback for session metadata (received on attach).\n\t */\n\tonMetadata(callback: (sessionId: string, cwd: string, createdAt: Date) => void): void {\n\t\tthis.#onMetadata = callback;\n\t}\n\n\t/**\n\t * Set callback for when another client joins.\n\t */\n\tonClientJoined(callback: (clientId: string, mode: ClientMode) => void): void {\n\t\tthis.#onClientJoined = callback;\n\t}\n\n\t/**\n\t * Set callback for when another client leaves.\n\t */\n\tonClientLeft(callback: (clientId: string) => void): void {\n\t\tthis.#onClientLeft = callback;\n\t}\n\n\t/**\n\t * Set callback for input echo from other clients.\n\t */\n\tonInputEcho(callback: (data: string, clientId: string) => void): void {\n\t\tthis.#onInputEcho = callback;\n\t}\n\n\t/**\n\t * Set callback for errors.\n\t */\n\tonError(callback: (message: string) => void): void {\n\t\tthis.#onError = callback;\n\t}\n\n\t/**\n\t * Set callback for disconnect.\n\t */\n\tonDisconnect(callback: () => void): void {\n\t\tthis.#onDisconnect = callback;\n\t}\n\n\t/**\n\t * Handle incoming data from server.\n\t */\n\t#handleData(data: Buffer): void {\n\t\tthis.#buffer += data.toString();\n\t\tconst lines = this.#buffer.split(\"\\n\");\n\t\tthis.#buffer = lines.pop() || \"\";\n\n\t\tfor (const line of lines) {\n\t\t\tif (!line.trim()) continue;\n\n\t\t\ttry {\n\t\t\t\tconst message = JSON.parse(line) as ServerMessage;\n\t\t\t\tthis.#handleServerMessage(message);\n\t\t\t} catch {\n\t\t\t\t// Ignore malformed messages\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Handle a server message.\n\t */\n\t#handleServerMessage(message: ServerMessage): void {\n\t\tswitch (message.type) {\n\t\t\tcase \"output\":\n\t\t\t\tif (this.#onOutput) {\n\t\t\t\t\tthis.#onOutput(message.data, message.stream);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"input_echo\":\n\t\t\t\tif (this.#onInputEcho) {\n\t\t\t\t\tthis.#onInputEcho(message.data, message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"client_joined\":\n\t\t\t\tif (this.#onClientJoined) {\n\t\t\t\t\tthis.#onClientJoined(message.clientId, message.mode);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"client_left\":\n\t\t\t\tif (this.#onClientLeft) {\n\t\t\t\t\tthis.#onClientLeft(message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"session_metadata\":\n\t\t\t\tif (this.#onMetadata) {\n\t\t\t\t\tthis.#onMetadata(message.sessionId, message.cwd, new Date(message.createdAt));\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"error\":\n\t\t\t\tif (this.#onError) {\n\t\t\t\t\tthis.#onError(message.message);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\t/**\n\t * Send a message to the server.\n\t */\n\t#send(message: ClientMessage): void {\n\t\tif (!this.#socket) return;\n\t\tconst json = `${JSON.stringify(message)}\\n`;\n\t\tthis.#socket.write(json);\n\t}\n}\n"]}
|
|
1
|
+
{"version":3,"file":"socket-client.js","sourceRoot":"","sources":["../../../src/core/socket-server/socket-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAe,MAAM,UAAU,CAAC;AAChD,OAAO,EAGN,2BAA2B,GAI3B,MAAM,YAAY,CAAC;AAWpB;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACf,WAAW,CAAS;IACpB,SAAS,CAAS;IAClB,KAAK,CAAa;IAE3B,OAAO,GAAkB,IAAI,CAAC;IAC9B,OAAO,GAAG,EAAE,CAAC;IAEb,gBAAgB;IAChB,SAAS,GAAiE,IAAI,CAAC;IAC/E,WAAW,GAAuE,IAAI,CAAC;IACvF,eAAe,GAA0D,IAAI,CAAC;IAC9E,aAAa,GAAwC,IAAI,CAAC;IAC1D,YAAY,GAAsD,IAAI,CAAC;IACvE,QAAQ,GAAsD,IAAI,CAAC;IACnE,aAAa,GAAwB,IAAI,CAAC;IAC1C,oBAAoB,GAAyD,IAAI,CAAC;IAClF,qBAAqB,GAA0D,IAAI,CAAC;IAEpF,YAAY,OAA4B;QACvC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAEzC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBAC/B,sBAAsB;gBACtB,qEAAqE;gBACrE,qEAAqE;gBACrE,+DAA+D;gBAC/D,MAAM,MAAM,GAAkB;oBAC7B,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI,CAAC,SAAS;oBACxB,IAAI,EAAE,IAAI,CAAC,KAAK;oBAChB,YAAY,EAAE,CAAC,2BAA2B,CAAC;iBAC3C,CAAC;gBACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO,EAAE,CAAC;YACX,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAChC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC7B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACxB,IAAI,CAAC,aAAa,EAAE,CAAC;gBACtB,CAAC;YACF,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAChC,MAAM,CAAC,GAAG,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACT,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,MAAM,GAAkB;gBAC7B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI,CAAC,SAAS;aACxB,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,CAAC;IACF,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,KAAK,GAAkB;YAC5B,IAAI,EAAE,OAAO;YACb,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,SAAS;SACxB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CAAC,SAAiB,EAAE,QAAgB;QACzD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,QAAQ,GAAkB;YAC/B,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,SAAS;YACT,QAAQ;SACR,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAA6D;QACrE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAmE;QAC7E,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAsD;QACpE,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAoC;QAChD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAkD;QAC7D,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAAkD;QACzD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAoB;QAChC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,QAAqD;QACxE,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,QAAsD;QAC1E,IAAI,CAAC,qBAAqB,GAAG,QAAQ,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACvB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAE3B,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;gBAClD,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACR,4BAA4B;YAC7B,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,OAAsB;QAC1C,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,QAAQ;gBACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM;YAEP,KAAK,YAAY;gBAChB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACvB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACnD,CAAC;gBACD,MAAM;YAEP,KAAK,eAAe;gBACnB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBAC1B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM;YAEP,KAAK,aAAa;gBACjB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACxB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACtC,CAAC;gBACD,MAAM;YAEP,KAAK,kBAAkB;gBACtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACtB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC/E,CAAC;gBACD,MAAM;YAEP,KAAK,OAAO;gBACX,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM;YAEP,KAAK,oBAAoB;gBACxB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;oBAC/B,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBACpC,CAAC;gBACD,MAAM;YAEP,KAAK,qBAAqB;gBACzB,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;oBAChC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;gBACD,MAAM;QACR,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAsB;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACD","sourcesContent":["/**\n * SocketClient - Client for attaching to a draht socket session\n *\n * Connects to a Unix domain socket, sends input, and receives output.\n * Used when running `draht --attach <session-id>`.\n */\n\nimport { connect, type Socket } from \"node:net\";\nimport {\n\ttype ClientMessage,\n\ttype ClientMode,\n\tPERMISSION_RELAY_CAPABILITY,\n\ttype PermissionRequestMessage,\n\ttype PermissionResolvedMessage,\n\ttype ServerMessage,\n} from \"./types.js\";\n\nexport interface SocketClientOptions {\n\t/** Path to the Unix socket */\n\tsocketPath: string;\n\t/** Client identifier (defaults to random ID) */\n\tclientId?: string;\n\t/** Connection mode */\n\tmode?: ClientMode;\n}\n\n/**\n * SocketClient connects to a socket-based draht session.\n *\n * Provides callbacks for output, metadata, and connection events.\n */\nexport class SocketClient {\n\treadonly #socketPath: string;\n\treadonly #clientId: string;\n\treadonly #mode: ClientMode;\n\n\t#socket: Socket | null = null;\n\t#buffer = \"\";\n\n\t/** Callbacks */\n\t#onOutput: ((data: string, stream: \"stdout\" | \"stderr\") => void) | null = null;\n\t#onMetadata: ((sessionId: string, cwd: string, createdAt: Date) => void) | null = null;\n\t#onClientJoined: ((clientId: string, mode: ClientMode) => void) | null = null;\n\t#onClientLeft: ((clientId: string) => void) | null = null;\n\t#onInputEcho: ((data: string, clientId: string) => void) | null = null;\n\t#onError: ((message: string, code?: string) => void) | null = null;\n\t#onDisconnect: (() => void) | null = null;\n\t#onPermissionRequest: ((message: PermissionRequestMessage) => void) | null = null;\n\t#onPermissionResolved: ((message: PermissionResolvedMessage) => void) | null = null;\n\n\tconstructor(options: SocketClientOptions) {\n\t\tthis.#socketPath = options.socketPath;\n\t\tthis.#clientId = options.clientId ?? `client-${crypto.randomUUID().slice(0, 8)}`;\n\t\tthis.#mode = options.mode ?? \"read-write\";\n\t}\n\n\t/**\n\t * Connect to the socket server.\n\t */\n\tasync connect(): Promise<void> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tthis.#socket = connect(this.#socketPath);\n\n\t\t\tthis.#socket.on(\"connect\", () => {\n\t\t\t\t// Send attach message\n\t\t\t\t// Declaring the capability is what makes the session send permission\n\t\t\t\t// frames to this client at all — an attach line without it is how an\n\t\t\t\t// older client says \"do not send me anything I cannot decode\".\n\t\t\t\tconst attach: ClientMessage = {\n\t\t\t\t\ttype: \"attach\",\n\t\t\t\t\tclientId: this.#clientId,\n\t\t\t\t\tmode: this.#mode,\n\t\t\t\t\tcapabilities: [PERMISSION_RELAY_CAPABILITY],\n\t\t\t\t};\n\t\t\t\tthis.#send(attach);\n\t\t\t\tresolve();\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"data\", (data) => {\n\t\t\t\tthis.#handleData(data);\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"close\", () => {\n\t\t\t\tif (this.#onDisconnect) {\n\t\t\t\t\tthis.#onDisconnect();\n\t\t\t\t}\n\t\t\t});\n\n\t\t\tthis.#socket.on(\"error\", (err) => {\n\t\t\t\treject(err);\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Disconnect from the socket server.\n\t */\n\tdisconnect(): void {\n\t\tif (this.#socket) {\n\t\t\tconst detach: ClientMessage = {\n\t\t\t\ttype: \"detach\",\n\t\t\t\tclientId: this.#clientId,\n\t\t\t};\n\t\t\tthis.#send(detach);\n\t\t\tthis.#socket.end();\n\t\t\tthis.#socket = null;\n\t\t}\n\t}\n\n\t/**\n\t * Send input to the session.\n\t */\n\tsendInput(data: string): void {\n\t\tif (!this.#socket) {\n\t\t\tthrow new Error(\"Not connected\");\n\t\t}\n\n\t\tconst input: ClientMessage = {\n\t\t\ttype: \"input\",\n\t\t\tdata,\n\t\t\tclientId: this.#clientId,\n\t\t};\n\t\tthis.#send(input);\n\t}\n\n\t/**\n\t * Answer a permission ask by naming one of the options it offered.\n\t *\n\t * The answer names an option id, never a decision: what an id means is fixed\n\t * by the ask that offered it, so a client cannot approve something it was\n\t * only offered the chance to deny.\n\t */\n\tsendPermissionResponse(requestId: string, optionId: string): void {\n\t\tif (!this.#socket) {\n\t\t\tthrow new Error(\"Not connected\");\n\t\t}\n\n\t\tconst response: ClientMessage = {\n\t\t\ttype: \"permission_response\",\n\t\t\tclientId: this.#clientId,\n\t\t\trequestId,\n\t\t\toptionId,\n\t\t};\n\t\tthis.#send(response);\n\t}\n\n\t/**\n\t * Set callback for output received from session.\n\t */\n\tonOutput(callback: (data: string, stream: \"stdout\" | \"stderr\") => void): void {\n\t\tthis.#onOutput = callback;\n\t}\n\n\t/**\n\t * Set callback for session metadata (received on attach).\n\t */\n\tonMetadata(callback: (sessionId: string, cwd: string, createdAt: Date) => void): void {\n\t\tthis.#onMetadata = callback;\n\t}\n\n\t/**\n\t * Set callback for when another client joins.\n\t */\n\tonClientJoined(callback: (clientId: string, mode: ClientMode) => void): void {\n\t\tthis.#onClientJoined = callback;\n\t}\n\n\t/**\n\t * Set callback for when another client leaves.\n\t */\n\tonClientLeft(callback: (clientId: string) => void): void {\n\t\tthis.#onClientLeft = callback;\n\t}\n\n\t/**\n\t * Set callback for input echo from other clients.\n\t */\n\tonInputEcho(callback: (data: string, clientId: string) => void): void {\n\t\tthis.#onInputEcho = callback;\n\t}\n\n\t/**\n\t * Set callback for errors.\n\t *\n\t * `code` identifies the frame: the caller needs it to tell a recoverable condition\n\t * (a rejected prompt, a replaced session) from a fatal one.\n\t */\n\tonError(callback: (message: string, code?: string) => void): void {\n\t\tthis.#onError = callback;\n\t}\n\n\t/**\n\t * Set callback for disconnect.\n\t */\n\tonDisconnect(callback: () => void): void {\n\t\tthis.#onDisconnect = callback;\n\t}\n\n\t/**\n\t * Set callback for a permission ask raised by the session.\n\t */\n\tonPermissionRequest(callback: (message: PermissionRequestMessage) => void): void {\n\t\tthis.#onPermissionRequest = callback;\n\t}\n\n\t/**\n\t * Set callback for the outcome of a permission ask.\n\t */\n\tonPermissionResolved(callback: (message: PermissionResolvedMessage) => void): void {\n\t\tthis.#onPermissionResolved = callback;\n\t}\n\n\t/**\n\t * Handle incoming data from server.\n\t */\n\t#handleData(data: Buffer): void {\n\t\tthis.#buffer += data.toString();\n\t\tconst lines = this.#buffer.split(\"\\n\");\n\t\tthis.#buffer = lines.pop() || \"\";\n\n\t\tfor (const line of lines) {\n\t\t\tif (!line.trim()) continue;\n\n\t\t\ttry {\n\t\t\t\tconst message = JSON.parse(line) as ServerMessage;\n\t\t\t\tthis.#handleServerMessage(message);\n\t\t\t} catch {\n\t\t\t\t// Ignore malformed messages\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Handle a server message.\n\t */\n\t#handleServerMessage(message: ServerMessage): void {\n\t\tswitch (message.type) {\n\t\t\tcase \"output\":\n\t\t\t\tif (this.#onOutput) {\n\t\t\t\t\tthis.#onOutput(message.data, message.stream);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"input_echo\":\n\t\t\t\tif (this.#onInputEcho) {\n\t\t\t\t\tthis.#onInputEcho(message.data, message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"client_joined\":\n\t\t\t\tif (this.#onClientJoined) {\n\t\t\t\t\tthis.#onClientJoined(message.clientId, message.mode);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"client_left\":\n\t\t\t\tif (this.#onClientLeft) {\n\t\t\t\t\tthis.#onClientLeft(message.clientId);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"session_metadata\":\n\t\t\t\tif (this.#onMetadata) {\n\t\t\t\t\tthis.#onMetadata(message.sessionId, message.cwd, new Date(message.createdAt));\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"error\":\n\t\t\t\tif (this.#onError) {\n\t\t\t\t\tthis.#onError(message.message, message.code);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"permission_request\":\n\t\t\t\tif (this.#onPermissionRequest) {\n\t\t\t\t\tthis.#onPermissionRequest(message);\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"permission_resolved\":\n\t\t\t\tif (this.#onPermissionResolved) {\n\t\t\t\t\tthis.#onPermissionResolved(message);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\t/**\n\t * Send a message to the server.\n\t */\n\t#send(message: ClientMessage): void {\n\t\tif (!this.#socket) return;\n\t\tconst json = `${JSON.stringify(message)}\\n`;\n\t\tthis.#socket.write(json);\n\t}\n}\n"]}
|
|
@@ -7,6 +7,22 @@
|
|
|
7
7
|
* - Input from any client is echoed to all others
|
|
8
8
|
* - Clients can join/leave without disrupting the session
|
|
9
9
|
*/
|
|
10
|
+
import { type PermissionRequestMessage, type PermissionResolvedMessage, type PermissionResponseMessage } from "./types.js";
|
|
11
|
+
/**
|
|
12
|
+
* How many live attachable sockets one host may hold (R35-ALWAYS.4).
|
|
13
|
+
*
|
|
14
|
+
* There was no cap at all: 500 sockets bound in one process with zero refusals,
|
|
15
|
+
* and `ulimit -n` on the development machine is 1048576, so the fd ceiling never
|
|
16
|
+
* arrives to stop a crash-restart loop. 64 is far above real use — a heavy user
|
|
17
|
+
* runs perhaps 10-20 concurrent sessions — and still low enough that a runaway is
|
|
18
|
+
* caught while the machine is healthy. It is a per-host number, counted from the
|
|
19
|
+
* sockets directory after the start-time sweep, not a per-process one: the point
|
|
20
|
+
* is to bound what accumulates on disk, and a restart loop is a new process each
|
|
21
|
+
* time.
|
|
22
|
+
*
|
|
23
|
+
* Overridable per server via {@link SocketServerOptions.maxLiveSockets}.
|
|
24
|
+
*/
|
|
25
|
+
export declare const DEFAULT_MAX_LIVE_SOCKETS = 64;
|
|
10
26
|
export interface SocketServerOptions {
|
|
11
27
|
/** Session ID (used for socket filename) */
|
|
12
28
|
sessionId: string;
|
|
@@ -16,9 +32,61 @@ export interface SocketServerOptions {
|
|
|
16
32
|
cwd: string;
|
|
17
33
|
/** Maximum number of concurrent clients */
|
|
18
34
|
maxClients?: number;
|
|
35
|
+
/**
|
|
36
|
+
* Maximum number of live attachable sockets this host may hold, counted after
|
|
37
|
+
* the start-time sweep (default: {@link DEFAULT_MAX_LIVE_SOCKETS}).
|
|
38
|
+
*/
|
|
39
|
+
maxLiveSockets?: number;
|
|
19
40
|
/** Whether to echo input to all clients (tmux-style) */
|
|
20
41
|
broadcastInputEcho?: boolean;
|
|
21
42
|
}
|
|
43
|
+
/**
|
|
44
|
+
* Thrown when another live process already owns the socket for this session id.
|
|
45
|
+
*
|
|
46
|
+
* Taking the socket over would silently steal attachments from a running session,
|
|
47
|
+
* so the second process refuses to bind instead.
|
|
48
|
+
*/
|
|
49
|
+
export declare class SocketSessionBusyError extends Error {
|
|
50
|
+
readonly sessionId: string;
|
|
51
|
+
/** PID of the owning process, or null when the lock exists but names no readable PID. */
|
|
52
|
+
readonly ownerPid: number | null;
|
|
53
|
+
readonly socketPath: string;
|
|
54
|
+
constructor(sessionId: string, ownerPid: number | null, socketPath: string);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Thrown when this host already holds as many live attachable sockets as it may.
|
|
58
|
+
*
|
|
59
|
+
* Names both the cap and the count that hit it, so an operator can tell a cap
|
|
60
|
+
* from a bug without reading the source. Exported deliberately and by name: the
|
|
61
|
+
* default-on start path branches on `error instanceof SocketCapReachedError` to
|
|
62
|
+
* pick the one refusal message that must never be confused with a broken sockets
|
|
63
|
+
* directory. A cap-hit is not a reason to refuse to START a session — that
|
|
64
|
+
* decision belongs to the caller, and this class exists so the caller can make it.
|
|
65
|
+
*/
|
|
66
|
+
export declare class SocketCapReachedError extends Error {
|
|
67
|
+
readonly sessionId: string;
|
|
68
|
+
/** The cap that was enforced. */
|
|
69
|
+
readonly cap: number;
|
|
70
|
+
/** Live sockets counted, after debris was reaped. */
|
|
71
|
+
readonly liveCount: number;
|
|
72
|
+
readonly socketDir: string;
|
|
73
|
+
constructor(sessionId: string, cap: number, liveCount: number, socketDir: string);
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Thrown when the sockets directory is not a directory this user owns privately.
|
|
77
|
+
*
|
|
78
|
+
* The 0700 mode was the ONLY same-owner protection that existed, and nothing
|
|
79
|
+
* asserted it: there is not one `getuid()` call in the whole of coding-agent,
|
|
80
|
+
* geist-core or the gateway. A world-writable directory holding a 0666 socket and
|
|
81
|
+
* a lock naming root's pid 1 was listed as a live attachable session and would
|
|
82
|
+
* have been dialled. Refusing is the point — silently `chmod`ing a directory this
|
|
83
|
+
* process does not own would either fail with EPERM or, worse, succeed on a
|
|
84
|
+
* directory somebody else planted.
|
|
85
|
+
*/
|
|
86
|
+
export declare class SocketDirectoryUnsafeError extends Error {
|
|
87
|
+
readonly socketDir: string;
|
|
88
|
+
constructor(socketDir: string, reason: string);
|
|
89
|
+
}
|
|
22
90
|
/**
|
|
23
91
|
* SocketServer manages a Unix domain socket for a single draht session.
|
|
24
92
|
*
|
|
@@ -30,13 +98,24 @@ export declare class SocketServer {
|
|
|
30
98
|
constructor(options: SocketServerOptions);
|
|
31
99
|
/**
|
|
32
100
|
* Start the socket server.
|
|
33
|
-
* Creates socket directory, binds Unix socket, and
|
|
101
|
+
* Creates socket directory, claims the session lock, binds the Unix socket, and listens.
|
|
102
|
+
*
|
|
103
|
+
* @throws {SocketSessionBusyError} When another live process already owns this session's socket.
|
|
104
|
+
* @throws {SocketDirectoryUnsafeError} When the sockets directory is not a private directory of ours.
|
|
105
|
+
* @throws {SocketCapReachedError} When this host already holds the maximum number of live sockets.
|
|
34
106
|
*/
|
|
35
107
|
start(): Promise<void>;
|
|
36
108
|
/**
|
|
37
109
|
* Stop the socket server and clean up.
|
|
38
110
|
*/
|
|
39
111
|
stop(): Promise<void>;
|
|
112
|
+
/**
|
|
113
|
+
* Stop the socket server from a synchronous exit path.
|
|
114
|
+
*
|
|
115
|
+
* `process.on("exit")` and signal handlers cannot await, so this does the same
|
|
116
|
+
* teardown as {@link stop} without yielding to the event loop.
|
|
117
|
+
*/
|
|
118
|
+
stopSync(): void;
|
|
40
119
|
/**
|
|
41
120
|
* Broadcast output to all connected clients.
|
|
42
121
|
*
|
|
@@ -44,14 +123,86 @@ export declare class SocketServer {
|
|
|
44
123
|
* @param stream - Output stream (stdout or stderr)
|
|
45
124
|
*/
|
|
46
125
|
broadcastOutput(data: string, stream?: "stdout" | "stderr"): void;
|
|
126
|
+
/**
|
|
127
|
+
* Broadcast an error to all connected clients.
|
|
128
|
+
*/
|
|
129
|
+
broadcastError(message: string, code?: string): void;
|
|
130
|
+
/**
|
|
131
|
+
* Send an error to one specific client, if it is still connected.
|
|
132
|
+
*/
|
|
133
|
+
sendErrorToClient(clientId: string, message: string, code?: string): void;
|
|
134
|
+
/**
|
|
135
|
+
* Send a permission ask to one client, if it is still connected and may have it.
|
|
136
|
+
*
|
|
137
|
+
* Silently does nothing for a client that is gone, read-only, or never
|
|
138
|
+
* declared {@link PERMISSION_RELAY_CAPABILITY}: not being asked is the
|
|
139
|
+
* correct outcome for all three, and none of them is an error the asker can
|
|
140
|
+
* act on.
|
|
141
|
+
*/
|
|
142
|
+
sendPermissionRequest(clientId: string, message: PermissionRequestMessage): void;
|
|
143
|
+
/**
|
|
144
|
+
* Broadcast a permission ask to every client that may answer it.
|
|
145
|
+
*
|
|
146
|
+
* @returns the ids that were actually sent the ask — the asker needs to know
|
|
147
|
+
* whether anybody at all can answer, and an empty result is the
|
|
148
|
+
* honest answer "nobody remote is listening".
|
|
149
|
+
*/
|
|
150
|
+
broadcastPermissionRequest(message: PermissionRequestMessage): string[];
|
|
151
|
+
/**
|
|
152
|
+
* Broadcast the outcome of a permission ask.
|
|
153
|
+
*
|
|
154
|
+
* Gated exactly like the ask itself: a client that could not have been asked
|
|
155
|
+
* is not told how somebody else's ask ended, and a client that never declared
|
|
156
|
+
* the capability is never sent a frame it cannot decode.
|
|
157
|
+
*/
|
|
158
|
+
broadcastPermissionResolved(message: PermissionResolvedMessage): void;
|
|
159
|
+
/**
|
|
160
|
+
* How many attached clients could answer a permission ask RIGHT NOW.
|
|
161
|
+
*
|
|
162
|
+
* Gated by exactly the predicate emission is gated by, so the count and the
|
|
163
|
+
* fan-out can never disagree. This is what `ExtensionRunner.hasUI()` becomes
|
|
164
|
+
* for a headless attachable session, and it must therefore stay honest in
|
|
165
|
+
* both directions: reporting a client that cannot be asked turns today's loud
|
|
166
|
+
* "no UI available to request approval" block into an instant `false` that
|
|
167
|
+
* the permission gate reports as "User denied approval" — a user action in
|
|
168
|
+
* the transcript that no user took.
|
|
169
|
+
*/
|
|
170
|
+
get permissionCapableClientCount(): number;
|
|
47
171
|
/**
|
|
48
172
|
* Set callback for input received from clients.
|
|
49
173
|
*/
|
|
50
174
|
onInput(callback: (data: string, clientId: string) => void): void;
|
|
175
|
+
/**
|
|
176
|
+
* Set callback for a permission answer received from a client.
|
|
177
|
+
*/
|
|
178
|
+
onPermissionResponse(callback: (message: PermissionResponseMessage, clientId: string) => void): void;
|
|
179
|
+
/**
|
|
180
|
+
* Set callback fired right after a client has been sent `session_metadata`,
|
|
181
|
+
* for the clients that could actually be sent a permission frame.
|
|
182
|
+
*
|
|
183
|
+
* See the attach case for the gate and for what does — and does not —
|
|
184
|
+
* authenticate the peer being replayed to.
|
|
185
|
+
*/
|
|
186
|
+
onAttachReplay(callback: (clientId: string) => void): void;
|
|
187
|
+
/**
|
|
188
|
+
* Set callback fired when an attached client's connection ends, however it
|
|
189
|
+
* ended — a graceful `detach`, a closed socket, or a socket error.
|
|
190
|
+
*
|
|
191
|
+
* Per-connection bookkeeping outside this class needs the same signal the
|
|
192
|
+
* `client_left` broadcast carries, and it needs it for the same reason: a
|
|
193
|
+
* client that reconnects under the same id is a NEW connection with nothing
|
|
194
|
+
* on its screen. Whatever tracked what that client had already been shown has
|
|
195
|
+
* to forget it here, or the reconnecting peer is never shown it again.
|
|
196
|
+
*/
|
|
197
|
+
onClientDisconnect(callback: (clientId: string) => void): void;
|
|
51
198
|
/**
|
|
52
199
|
* Get socket path for this session.
|
|
53
200
|
*/
|
|
54
201
|
get socketPath(): string;
|
|
202
|
+
/**
|
|
203
|
+
* Get the session id this socket is bound to.
|
|
204
|
+
*/
|
|
205
|
+
get sessionId(): string;
|
|
55
206
|
/**
|
|
56
207
|
* Get number of connected clients.
|
|
57
208
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"socket-server.d.ts","sourceRoot":"","sources":["../../../src/core/socket-server/socket-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;
|
|
1
|
+
{"version":3,"file":"socket-server.d.ts","sourceRoot":"","sources":["../../../src/core/socket-server/socket-server.ts"],"names":[],"mappings":"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"}
|