@minionry/minion 0.7.36
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/LICENSE +14 -0
- package/PRIVACY.md +357 -0
- package/README.md +57 -0
- package/THIRD_PARTY_NOTICES.md +245 -0
- package/bin/branding.js +4 -0
- package/bin/commands/browser-install.js +483 -0
- package/bin/commands/create-sandbox.js +542 -0
- package/bin/commands/fingerprint.js +101 -0
- package/bin/commands/login.js +400 -0
- package/bin/commands/logout.js +93 -0
- package/bin/commands/minions.js +211 -0
- package/bin/commands/sandboxes.js +309 -0
- package/bin/commands/status.js +298 -0
- package/bin/commands/whoami.js +153 -0
- package/bin/launch-env.js +35 -0
- package/bin/machine-identity.js +221 -0
- package/bin/machine-layout.js +200 -0
- package/bin/minion.js +839 -0
- package/bin/platform-endpoints.js +8 -0
- package/bin/postinstall.js +52 -0
- package/bin/pty-doctor.js +326 -0
- package/bin/pty-locator.js +110 -0
- package/bin/pty-provision.js +186 -0
- package/bin/sandbox/Dockerfile +78 -0
- package/bin/sandbox/entrypoint.sh +14 -0
- package/bin/sandbox/install-repo.sh +53 -0
- package/bin/sandbox/seccomp-userns.json +883 -0
- package/bin/sandbox-config.js +306 -0
- package/dist/bin/machine-identity.js +221 -0
- package/dist/bin/machine-layout.js +200 -0
- package/dist/electron-host/agent-lease.js +141 -0
- package/dist/electron-host/dom-driver.js +642 -0
- package/dist/electron-host/ipc-protocol.js +89 -0
- package/dist/electron-host/js-driver.js +216 -0
- package/dist/electron-host/view-manager.js +254 -0
- package/dist/server/cli/engine-resume.js +49 -0
- package/dist/server/cli/eta-estimator.js +278 -0
- package/dist/server/cli/headless/background-activity.js +109 -0
- package/dist/server/cli/headless/claude-invoker-process.js +614 -0
- package/dist/server/cli/headless/claude-invoker-stall.js +150 -0
- package/dist/server/cli/headless/claude-invoker-stream.js +555 -0
- package/dist/server/cli/headless/claude-invoker-tools.js +148 -0
- package/dist/server/cli/headless/claude-invoker.js +151 -0
- package/dist/server/cli/headless/engine-availability.js +92 -0
- package/dist/server/cli/headless/engine-notice.js +185 -0
- package/dist/server/cli/headless/haiku-assessments.js +293 -0
- package/dist/server/cli/headless/headless-logger.js +75 -0
- package/dist/server/cli/headless/index.js +9 -0
- package/dist/server/cli/headless/mcp-config.js +314 -0
- package/dist/server/cli/headless/native-timeout-detector.js +72 -0
- package/dist/server/cli/headless/output-utils.js +71 -0
- package/dist/server/cli/headless/prompt-utils.js +82 -0
- package/dist/server/cli/headless/resilient-runner.js +326 -0
- package/dist/server/cli/headless/retry-strategies.js +292 -0
- package/dist/server/cli/headless/runner.js +245 -0
- package/dist/server/cli/headless/stall-assessor.js +295 -0
- package/dist/server/cli/headless/tool-watchdog.js +447 -0
- package/dist/server/cli/headless/types.js +18 -0
- package/dist/server/cli/history-portability.js +85 -0
- package/dist/server/cli/improvisation-attachments.js +99 -0
- package/dist/server/cli/improvisation-history-store.js +121 -0
- package/dist/server/cli/improvisation-movements.js +137 -0
- package/dist/server/cli/improvisation-output-queue.js +34 -0
- package/dist/server/cli/improvisation-retry.js +8 -0
- package/dist/server/cli/improvisation-session-manager.js +1016 -0
- package/dist/server/cli/improvisation-types.js +31 -0
- package/dist/server/cli/plan-lifecycle.js +72 -0
- package/dist/server/cli/prompt-builders.js +371 -0
- package/dist/server/cli/retry/retry-best-result.js +28 -0
- package/dist/server/cli/retry/retry-context-loss.js +75 -0
- package/dist/server/cli/retry/retry-recovery-strategies.js +213 -0
- package/dist/server/cli/retry/retry-resume-strategy.js +20 -0
- package/dist/server/cli/retry/retry-runner-factory.js +92 -0
- package/dist/server/cli/retry/retry-tool-results.js +22 -0
- package/dist/server/cli/retry/retry-types.js +3 -0
- package/dist/server/engines/EngineEvent.js +57 -0
- package/dist/server/engines/claude/ClaudeCodeEngine.js +316 -0
- package/dist/server/engines/claude/claude-command.js +32 -0
- package/dist/server/engines/codex/CodexEngine.js +469 -0
- package/dist/server/engines/codex/codex-auth.js +203 -0
- package/dist/server/engines/codex/codex-invoker.js +205 -0
- package/dist/server/engines/codex/codex-provision.js +215 -0
- package/dist/server/engines/credentials/credential-probe.js +88 -0
- package/dist/server/engines/credentials/model-profiles.js +249 -0
- package/dist/server/engines/credentials/provider-credentials.js +146 -0
- package/dist/server/engines/engine-event-stream.js +52 -0
- package/dist/server/engines/execution/engine-session.js +380 -0
- package/dist/server/engines/factory.js +42 -0
- package/dist/server/engines/hermes/HermesEngine.js +628 -0
- package/dist/server/engines/hermes/hermes-auth.js +159 -0
- package/dist/server/engines/hermes/hermes-gateway-home.js +271 -0
- package/dist/server/engines/hermes/hermes-invoker.js +350 -0
- package/dist/server/engines/hermes/hermes-provision.js +318 -0
- package/dist/server/engines/read-only.js +20 -0
- package/dist/server/engines/types.js +27 -0
- package/dist/server/handlers/company-execution-registry.js +67 -0
- package/dist/server/handlers/company-handlers.js +514 -0
- package/dist/server/handlers/company-triggers.js +189 -0
- package/dist/server/handlers/company-types.js +3 -0
- package/dist/server/index.js +244 -0
- package/dist/server/mcp/app-tools-bridge.js +110 -0
- package/dist/server/mcp/app-tools-mcp-server.js +99 -0
- package/dist/server/mcp/bouncer-integration.js +744 -0
- package/dist/server/mcp/browser-mcp-server.js +915 -0
- package/dist/server/mcp/browser-redaction.js +103 -0
- package/dist/server/mcp/classifier/BouncerClassifier.js +3 -0
- package/dist/server/mcp/classifier/ClaudeBouncerClassifier.js +212 -0
- package/dist/server/mcp/classifier/factory.js +124 -0
- package/dist/server/mcp/classifier/health.js +54 -0
- package/dist/server/mcp/classifier/telemetry.js +0 -0
- package/dist/server/mcp/company-patterns.js +104 -0
- package/dist/server/mcp/department-profiles.js +133 -0
- package/dist/server/mcp/quality-bridge.js +153 -0
- package/dist/server/mcp/quality-mcp-server.js +105 -0
- package/dist/server/mcp/security-analysis.js +384 -0
- package/dist/server/mcp/security-audit.js +152 -0
- package/dist/server/mcp/security-patterns.js +314 -0
- package/dist/server/mcp/server.js +194 -0
- package/dist/server/mcp/test-utils/agent-simulator.js +301 -0
- package/dist/server/mcp/test-utils/e2e-agent.js +103 -0
- package/dist/server/mcp/test-utils/e2e-capture.js +92 -0
- package/dist/server/mcp/test-utils/e2e-client.js +116 -0
- package/dist/server/mcp/test-utils/e2e-fixtures.js +87 -0
- package/dist/server/mcp/test-utils/e2e-gating.js +8 -0
- package/dist/server/mcp/test-utils/e2e-harness.js +8 -0
- package/dist/server/mcp/test-utils/e2e-scenarios.js +105 -0
- package/dist/server/routes/files.js +18 -0
- package/dist/server/routes/improvise.js +64 -0
- package/dist/server/routes/index.js +7 -0
- package/dist/server/routes/instances.js +41 -0
- package/dist/server/routes/internal.js +900 -0
- package/dist/server/routes/notifications.js +110 -0
- package/dist/server/server-setup.js +282 -0
- package/dist/server/services/agent-push.js +148 -0
- package/dist/server/services/analytics.js +197 -0
- package/dist/server/services/apps/build.js +249 -0
- package/dist/server/services/apps/greenlight.js +199 -0
- package/dist/server/services/apps/install.js +101 -0
- package/dist/server/services/apps/layout.js +35 -0
- package/dist/server/services/apps/serve.js +665 -0
- package/dist/server/services/apps/space-apps.js +248 -0
- package/dist/server/services/auth.js +48 -0
- package/dist/server/services/browser/chrome-sandbox.js +245 -0
- package/dist/server/services/browser/chromium-launch-spec.js +51 -0
- package/dist/server/services/browser/claude-reasoner.js +669 -0
- package/dist/server/services/browser/debug-log.js +3 -0
- package/dist/server/services/browser/driver-state.js +546 -0
- package/dist/server/services/browser/electron-provision.js +256 -0
- package/dist/server/services/browser/host-internal.js +245 -0
- package/dist/server/services/browser/host-mock.js +334 -0
- package/dist/server/services/browser/host-types.js +3 -0
- package/dist/server/services/browser/host.js +1067 -0
- package/dist/server/services/browser/index.js +4 -0
- package/dist/server/services/browser/ipc-client.js +354 -0
- package/dist/server/services/browser/pipewire-sink.js +199 -0
- package/dist/server/services/browser/preflight.js +590 -0
- package/dist/server/services/browser/reasoning-agent.js +659 -0
- package/dist/server/services/browser/sandbox-policy.js +169 -0
- package/dist/server/services/browser/stderr-noise-filter.js +26 -0
- package/dist/server/services/browser/telemetry.js +107 -0
- package/dist/server/services/browser/xvfb-supervisor.js +139 -0
- package/dist/server/services/browser-frame-policy.js +56 -0
- package/dist/server/services/client-id.js +32 -0
- package/dist/server/services/collab/registry.js +408 -0
- package/dist/server/services/collab/session.js +489 -0
- package/dist/server/services/collab/text-diff.js +28 -0
- package/dist/server/services/collab/types.js +19 -0
- package/dist/server/services/e2ee-group-key.js +197 -0
- package/dist/server/services/e2ee-identity.js +203 -0
- package/dist/server/services/file-explorer-ops.js +328 -0
- package/dist/server/services/file-transfer-zip.js +188 -0
- package/dist/server/services/files.js +111 -0
- package/dist/server/services/git/branch-ops.js +62 -0
- package/dist/server/services/git/command.js +68 -0
- package/dist/server/services/git/commit-message.js +74 -0
- package/dist/server/services/git/diff-ops.js +56 -0
- package/dist/server/services/git/haiku.js +76 -0
- package/dist/server/services/git/head-watcher.js +226 -0
- package/dist/server/services/git/index.js +17 -0
- package/dist/server/services/git/log-ops.js +98 -0
- package/dist/server/services/git/merge-ops.js +314 -0
- package/dist/server/services/git/parsers.js +401 -0
- package/dist/server/services/git/remote-ops.js +192 -0
- package/dist/server/services/git/status-ops.js +105 -0
- package/dist/server/services/git/suggestion-ops.js +80 -0
- package/dist/server/services/git/tag-ops.js +36 -0
- package/dist/server/services/git/types.js +4 -0
- package/dist/server/services/git/worktree-ops.js +114 -0
- package/dist/server/services/instances.js +337 -0
- package/dist/server/services/model-catalog.js +247 -0
- package/dist/server/services/observability/posthog.js +153 -0
- package/dist/server/services/pathUtils.js +114 -0
- package/dist/server/services/plan/agent-loader.js +97 -0
- package/dist/server/services/plan/agent-manager.js +363 -0
- package/dist/server/services/plan/agent-resolver.js +74 -0
- package/dist/server/services/plan/agents/assess-stall.md +33 -0
- package/dist/server/services/plan/agents/browser-planner.md +53 -0
- package/dist/server/services/plan/agents/browser-reasoner.md +114 -0
- package/dist/server/services/plan/agents/check-injection.md +95 -0
- package/dist/server/services/plan/agents/classify-error.md +30 -0
- package/dist/server/services/plan/agents/code-review.md +142 -0
- package/dist/server/services/plan/agents/commit-message.md +28 -0
- package/dist/server/services/plan/agents/detect-context-loss.md +30 -0
- package/dist/server/services/plan/agents/execute-issue.md +58 -0
- package/dist/server/services/plan/agents/fix-quality.md +25 -0
- package/dist/server/services/plan/agents/plan-coordinator.md +72 -0
- package/dist/server/services/plan/agents/pr-description.md +29 -0
- package/dist/server/services/plan/agents/retry-task.md +27 -0
- package/dist/server/services/plan/agents/review-code.md +38 -0
- package/dist/server/services/plan/agents/review-quality.md +45 -0
- package/dist/server/services/plan/agents/triage-findings.md +78 -0
- package/dist/server/services/plan/agents/verify-review.md +57 -0
- package/dist/server/services/plan/approval-evaluator.js +143 -0
- package/dist/server/services/plan/board-archive.js +102 -0
- package/dist/server/services/plan/board-config.js +108 -0
- package/dist/server/services/plan/board-export.js +214 -0
- package/dist/server/services/plan/composer-prompt.js +115 -0
- package/dist/server/services/plan/composer.js +664 -0
- package/dist/server/services/plan/config-installer.js +103 -0
- package/dist/server/services/plan/dependency-resolver.js +137 -0
- package/dist/server/services/plan/executor.js +696 -0
- package/dist/server/services/plan/front-matter.js +43 -0
- package/dist/server/services/plan/issue-classification.js +10 -0
- package/dist/server/services/plan/issue-effort.js +182 -0
- package/dist/server/services/plan/issue-loader.js +35 -0
- package/dist/server/services/plan/issue-prompt-builder.js +152 -0
- package/dist/server/services/plan/issue-retry.js +42 -0
- package/dist/server/services/plan/issue-writer.js +102 -0
- package/dist/server/services/plan/metrics-collector.js +272 -0
- package/dist/server/services/plan/output-manager.js +77 -0
- package/dist/server/services/plan/parser-core.js +435 -0
- package/dist/server/services/plan/parser-migration.js +108 -0
- package/dist/server/services/plan/parser.js +258 -0
- package/dist/server/services/plan/plan-runner-factory.js +68 -0
- package/dist/server/services/plan/pm-timeline.js +320 -0
- package/dist/server/services/plan/progress-log.js +101 -0
- package/dist/server/services/plan/prompt-builder.js +142 -0
- package/dist/server/services/plan/quality-delta.js +274 -0
- package/dist/server/services/plan/readiness-planner.js +34 -0
- package/dist/server/services/plan/review-gate.js +409 -0
- package/dist/server/services/plan/review-report.js +134 -0
- package/dist/server/services/plan/review-verdict-stream.js +161 -0
- package/dist/server/services/plan/state-reconciler.js +238 -0
- package/dist/server/services/plan/template-diff.js +175 -0
- package/dist/server/services/plan/template-instantiator.js +516 -0
- package/dist/server/services/plan/template-manifest.js +56 -0
- package/dist/server/services/plan/template-types.js +3 -0
- package/dist/server/services/plan/trigger-evaluator.js +211 -0
- package/dist/server/services/plan/types.js +3 -0
- package/dist/server/services/plan/watcher.js +73 -0
- package/dist/server/services/platform-credentials.js +56 -0
- package/dist/server/services/platform-e2ee.js +421 -0
- package/dist/server/services/platform-envelope.js +102 -0
- package/dist/server/services/platform-heartbeat.js +88 -0
- package/dist/server/services/platform-reconnect.js +60 -0
- package/dist/server/services/platform-token-lifecycle.js +95 -0
- package/dist/server/services/platform-url.js +17 -0
- package/dist/server/services/platform.js +656 -0
- package/dist/server/services/runtime-info.js +9 -0
- package/dist/server/services/schedule/agent-schedule-store.js +232 -0
- package/dist/server/services/schedule/agent-scheduler.js +323 -0
- package/dist/server/services/schedule/daily-timing.js +105 -0
- package/dist/server/services/schedule/quality-schedule-launch.js +11 -0
- package/dist/server/services/schedule/quality-schedule-store.js +211 -0
- package/dist/server/services/schedule/quality-scheduler.js +215 -0
- package/dist/server/services/schedule/run-bootstrap.js +329 -0
- package/dist/server/services/schedule/schedule-store.js +238 -0
- package/dist/server/services/schedule/schedule-wire.js +77 -0
- package/dist/server/services/schedule/scheduler.js +310 -0
- package/dist/server/services/schedule/template-source.js +97 -0
- package/dist/server/services/sdk/agent-sessions.js +264 -0
- package/dist/server/services/sdk/agents.js +557 -0
- package/dist/server/services/sdk/app-endpoints.js +48 -0
- package/dist/server/services/sdk/app-tools.js +303 -0
- package/dist/server/services/sdk/audit.js +48 -0
- package/dist/server/services/sdk/browser-transport.js +188 -0
- package/dist/server/services/sdk/browser.js +605 -0
- package/dist/server/services/sdk/composer.js +129 -0
- package/dist/server/services/sdk/connect.js +273 -0
- package/dist/server/services/sdk/consent-cooldown.js +31 -0
- package/dist/server/services/sdk/endpoint-url.js +141 -0
- package/dist/server/services/sdk/endpoints.js +314 -0
- package/dist/server/services/sdk/file-change-notify.js +36 -0
- package/dist/server/services/sdk/files-app.js +163 -0
- package/dist/server/services/sdk/files-search.js +131 -0
- package/dist/server/services/sdk/files-transfer.js +279 -0
- package/dist/server/services/sdk/files-workspace.js +233 -0
- package/dist/server/services/sdk/git.js +520 -0
- package/dist/server/services/sdk/grant-store.js +318 -0
- package/dist/server/services/sdk/host-ops.js +84 -0
- package/dist/server/services/sdk/inference-claude.js +214 -0
- package/dist/server/services/sdk/inference.js +247 -0
- package/dist/server/services/sdk/live-registry.js +42 -0
- package/dist/server/services/sdk/local-app-bindings.js +71 -0
- package/dist/server/services/sdk/pipeline.js +190 -0
- package/dist/server/services/sdk/pm-execute.js +228 -0
- package/dist/server/services/sdk/pm-planning-tap.js +29 -0
- package/dist/server/services/sdk/pm-schedule.js +165 -0
- package/dist/server/services/sdk/pm.js +634 -0
- package/dist/server/services/sdk/quality-change-notify.js +20 -0
- package/dist/server/services/sdk/quality-schedule.js +165 -0
- package/dist/server/services/sdk/quality.js +602 -0
- package/dist/server/services/sdk/rate-limits.js +198 -0
- package/dist/server/services/sdk/registry.js +597 -0
- package/dist/server/services/sdk/revoke.js +86 -0
- package/dist/server/services/sdk/run-profile.js +41 -0
- package/dist/server/services/sdk/sandbox.js +89 -0
- package/dist/server/services/sdk/storage.js +110 -0
- package/dist/server/services/sdk/streams.js +147 -0
- package/dist/server/services/sdk/terminal.js +201 -0
- package/dist/server/services/sdk/test-utils/workshop-browser-app.js +466 -0
- package/dist/server/services/sentry.js +99 -0
- package/dist/server/services/settings.js +374 -0
- package/dist/server/services/snippets/expander.js +87 -0
- package/dist/server/services/snippets/index.js +6 -0
- package/dist/server/services/snippets/loader.js +119 -0
- package/dist/server/services/snippets/parser.js +52 -0
- package/dist/server/services/snippets/types.js +3 -0
- package/dist/server/services/snippets/watcher.js +60 -0
- package/dist/server/services/space-layout.js +80 -0
- package/dist/server/services/system-prompts.js +219 -0
- package/dist/server/services/terminal/pty-manager.js +206 -0
- package/dist/server/services/terminal/pty-utils.js +150 -0
- package/dist/server/services/timeline/assembler.js +890 -0
- package/dist/server/services/timeline/contract.js +196 -0
- package/dist/server/services/timeline/index.js +4 -0
- package/dist/server/services/websocket/agent-schedule-handlers.js +217 -0
- package/dist/server/services/websocket/apps-handlers.js +399 -0
- package/dist/server/services/websocket/ask-user-question-bridge.js +112 -0
- package/dist/server/services/websocket/autocomplete-index.js +415 -0
- package/dist/server/services/websocket/autocomplete-match.js +243 -0
- package/dist/server/services/websocket/autocomplete.js +407 -0
- package/dist/server/services/websocket/browser-agent-runtime.js +208 -0
- package/dist/server/services/websocket/browser-device-profile.js +46 -0
- package/dist/server/services/websocket/browser-handlers.js +377 -0
- package/dist/server/services/websocket/browser-host-broadcast.js +179 -0
- package/dist/server/services/websocket/browser-ice-config.js +121 -0
- package/dist/server/services/websocket/browser-payloads.js +222 -0
- package/dist/server/services/websocket/browser-viewer-lifecycle.js +84 -0
- package/dist/server/services/websocket/browser-viewer-registry.js +118 -0
- package/dist/server/services/websocket/collab-broadcast.js +11 -0
- package/dist/server/services/websocket/collab-handlers.js +116 -0
- package/dist/server/services/websocket/commit-suggestion-service.js +132 -0
- package/dist/server/services/websocket/debug-log.js +38 -0
- package/dist/server/services/websocket/dispatch-util.js +10 -0
- package/dist/server/services/websocket/engine-auth-handlers.js +323 -0
- package/dist/server/services/websocket/engine-credential-watcher.js +83 -0
- package/dist/server/services/websocket/engine-profile-handlers.js +92 -0
- package/dist/server/services/websocket/file-definition-handlers.js +180 -0
- package/dist/server/services/websocket/file-download-handler.js +291 -0
- package/dist/server/services/websocket/file-explorer-handlers.js +291 -0
- package/dist/server/services/websocket/file-search-handlers.js +267 -0
- package/dist/server/services/websocket/file-share-handlers.js +328 -0
- package/dist/server/services/websocket/file-transfer-http.js +361 -0
- package/dist/server/services/websocket/file-upload-handler.js +267 -0
- package/dist/server/services/websocket/file-utils.js +346 -0
- package/dist/server/services/websocket/git-branch-handlers.js +90 -0
- package/dist/server/services/websocket/git-diff-handlers.js +59 -0
- package/dist/server/services/websocket/git-handlers.js +212 -0
- package/dist/server/services/websocket/git-head-watcher.js +85 -0
- package/dist/server/services/websocket/git-log-handlers.js +104 -0
- package/dist/server/services/websocket/git-pr-handlers.js +56 -0
- package/dist/server/services/websocket/git-tag-handlers.js +53 -0
- package/dist/server/services/websocket/git-utils.js +11 -0
- package/dist/server/services/websocket/git-worktree-handlers.js +521 -0
- package/dist/server/services/websocket/handler-context.js +113 -0
- package/dist/server/services/websocket/handler.js +1197 -0
- package/dist/server/services/websocket/index.js +5 -0
- package/dist/server/services/websocket/movement-written-files.js +26 -0
- package/dist/server/services/websocket/msg-id-tracker.js +48 -0
- package/dist/server/services/websocket/plan-board-handlers.js +410 -0
- package/dist/server/services/websocket/plan-execution-handlers.js +244 -0
- package/dist/server/services/websocket/plan-handlers.js +67 -0
- package/dist/server/services/websocket/plan-helpers.js +161 -0
- package/dist/server/services/websocket/plan-issue-handlers.js +168 -0
- package/dist/server/services/websocket/plan-sprint-handlers.js +190 -0
- package/dist/server/services/websocket/plan-transfer-handlers.js +310 -0
- package/dist/server/services/websocket/pm-timeline-broadcast.js +28 -0
- package/dist/server/services/websocket/post-session-scan.js +132 -0
- package/dist/server/services/websocket/prompt-queue-handlers.js +96 -0
- package/dist/server/services/websocket/quality-agent-cost.js +229 -0
- package/dist/server/services/websocket/quality-agent-notes.js +113 -0
- package/dist/server/services/websocket/quality-change-activity.js +187 -0
- package/dist/server/services/websocket/quality-complexity.js +345 -0
- package/dist/server/services/websocket/quality-dependencies.js +445 -0
- package/dist/server/services/websocket/quality-duplication.js +162 -0
- package/dist/server/services/websocket/quality-eta.js +65 -0
- package/dist/server/services/websocket/quality-fingerprint.js +104 -0
- package/dist/server/services/websocket/quality-grading.js +575 -0
- package/dist/server/services/websocket/quality-handlers.js +48 -0
- package/dist/server/services/websocket/quality-linting.js +270 -0
- package/dist/server/services/websocket/quality-operations.js +54 -0
- package/dist/server/services/websocket/quality-persistence.js +410 -0
- package/dist/server/services/websocket/quality-review-agent.js +526 -0
- package/dist/server/services/websocket/quality-run.js +220 -0
- package/dist/server/services/websocket/quality-secrets.js +0 -0
- package/dist/server/services/websocket/quality-service.js +775 -0
- package/dist/server/services/websocket/quality-tools.js +383 -0
- package/dist/server/services/websocket/quality-triage-agent.js +101 -0
- package/dist/server/services/websocket/quality-types.js +149 -0
- package/dist/server/services/websocket/recommended-answers.js +28 -0
- package/dist/server/services/websocket/schedule-handlers.js +197 -0
- package/dist/server/services/websocket/sdk-agent-host.js +569 -0
- package/dist/server/services/websocket/sdk-browser-host.js +459 -0
- package/dist/server/services/websocket/sdk-composer-host.js +10 -0
- package/dist/server/services/websocket/sdk-git-host.js +115 -0
- package/dist/server/services/websocket/sdk-handlers.js +242 -0
- package/dist/server/services/websocket/sdk-pm-execution-host.js +63 -0
- package/dist/server/services/websocket/sdk-pm-schedule-host.js +21 -0
- package/dist/server/services/websocket/sdk-quality-schedule-host.js +34 -0
- package/dist/server/services/websocket/sdk-terminal-host.js +140 -0
- package/dist/server/services/websocket/session-handlers.js +565 -0
- package/dist/server/services/websocket/session-history.js +335 -0
- package/dist/server/services/websocket/session-initialization.js +315 -0
- package/dist/server/services/websocket/session-registry.js +340 -0
- package/dist/server/services/websocket/session-role-directory.js +39 -0
- package/dist/server/services/websocket/settings-handlers.js +276 -0
- package/dist/server/services/websocket/skill-handlers.js +324 -0
- package/dist/server/services/websocket/skill-watcher.js +83 -0
- package/dist/server/services/websocket/snippet-handlers.js +261 -0
- package/dist/server/services/websocket/tab-broadcast.js +35 -0
- package/dist/server/services/websocket/tab-event-buffer.js +110 -0
- package/dist/server/services/websocket/tab-event-replay.js +47 -0
- package/dist/server/services/websocket/tab-handlers.js +211 -0
- package/dist/server/services/websocket/terminal-handlers.js +268 -0
- package/dist/server/services/websocket/types.js +96 -0
- package/dist/server/types/company-messages.js +102 -0
- package/dist/server/utils/agent-manager.js +202 -0
- package/dist/server/utils/console-timestamps.js +24 -0
- package/dist/server/utils/file-store.js +112 -0
- package/dist/server/utils/paths.js +28 -0
- package/dist/server/utils/port-manager.js +43 -0
- package/dist/server/utils/port.js +204 -0
- package/electron-host/dist/agent-lease.js +141 -0
- package/electron-host/dist/capture-recovery.js +77 -0
- package/electron-host/dist/codec-policy.js +37 -0
- package/electron-host/dist/controller-channel.js +60 -0
- package/electron-host/dist/controller-handlers.js +153 -0
- package/electron-host/dist/device-emulator.js +106 -0
- package/electron-host/dist/dom-driver.js +642 -0
- package/electron-host/dist/domain-registry.js +159 -0
- package/electron-host/dist/domain-validators.js +308 -0
- package/electron-host/dist/editable-focus-reporter.js +143 -0
- package/electron-host/dist/fake-peer.test-util.js +105 -0
- package/electron-host/dist/host-log.js +31 -0
- package/electron-host/dist/host-wire.js +11 -0
- package/electron-host/dist/input-router.js +421 -0
- package/electron-host/dist/ipc-protocol.js +89 -0
- package/electron-host/dist/ipc-server.js +193 -0
- package/electron-host/dist/js-driver.js +216 -0
- package/electron-host/dist/main-guards.js +70 -0
- package/electron-host/dist/main.js +716 -0
- package/electron-host/dist/roster-sync.js +87 -0
- package/electron-host/dist/rpc-context.js +1 -0
- package/electron-host/dist/rpc-tab-methods.js +138 -0
- package/electron-host/dist/rpc-webrtc-methods.js +121 -0
- package/electron-host/dist/screen-capture-cache.js +147 -0
- package/electron-host/dist/sdk-injector.js +166 -0
- package/electron-host/dist/sdp.js +102 -0
- package/electron-host/dist/session-surface.js +78 -0
- package/electron-host/dist/surface-sizing.js +59 -0
- package/electron-host/dist/view-manager.js +254 -0
- package/electron-host/dist/viewer-registry.js +46 -0
- package/electron-host/dist/viewer-session.js +288 -0
- package/electron-host/dist/webrtc-channels.js +14 -0
- package/electron-host/dist/webrtc-controller.js +57 -0
- package/electron-host/dist/webrtc-ice-filter.js +13 -0
- package/electron-host/dist/webrtc-peer.js +45 -0
- package/electron-host/package.json +12 -0
- package/electron-host/tsconfig.json +23 -0
- package/electron-host/webrtc-controller-preload.cjs +3 -0
- package/electron-host/webrtc-controller.html +14 -0
- package/package.json +85 -0
- package/vendor/e2ee/LICENSE +14 -0
- package/vendor/e2ee/package.json +14 -0
- package/vendor/e2ee/src/index.js +310 -0
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
// Copyright (c) 2025-present Minionry, Inc.
|
|
2
|
+
// SPDX-License-Identifier: LicenseRef-Minionry-Software
|
|
3
|
+
import { hlog } from '../../cli/headless/headless-logger.js';
|
|
4
|
+
function asRecord(value) {
|
|
5
|
+
return typeof value === 'object' && value !== null
|
|
6
|
+
? value
|
|
7
|
+
: undefined;
|
|
8
|
+
}
|
|
9
|
+
function asString(value) {
|
|
10
|
+
return typeof value === 'string' ? value : undefined;
|
|
11
|
+
}
|
|
12
|
+
function asNumber(value) {
|
|
13
|
+
return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
|
|
14
|
+
}
|
|
15
|
+
function asResultString(value) {
|
|
16
|
+
if (typeof value === 'string')
|
|
17
|
+
return value;
|
|
18
|
+
if (value === undefined || value === null)
|
|
19
|
+
return '';
|
|
20
|
+
const partsText = contentPartsText(value);
|
|
21
|
+
if (partsText !== undefined)
|
|
22
|
+
return partsText;
|
|
23
|
+
try {
|
|
24
|
+
return JSON.stringify(value);
|
|
25
|
+
}
|
|
26
|
+
catch {
|
|
27
|
+
return String(value);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
function contentPartsText(value) {
|
|
31
|
+
if (!Array.isArray(value) || value.length === 0)
|
|
32
|
+
return undefined;
|
|
33
|
+
const texts = [];
|
|
34
|
+
for (const part of value) {
|
|
35
|
+
const text = asString(asRecord(part)?.text);
|
|
36
|
+
if (text === undefined)
|
|
37
|
+
return undefined;
|
|
38
|
+
texts.push(text);
|
|
39
|
+
}
|
|
40
|
+
return texts.join('');
|
|
41
|
+
}
|
|
42
|
+
function asTokenCount(value) {
|
|
43
|
+
const count = asNumber(value);
|
|
44
|
+
return count === undefined ? undefined : Math.max(0, count);
|
|
45
|
+
}
|
|
46
|
+
function parseToolArguments(value) {
|
|
47
|
+
const record = asRecord(value);
|
|
48
|
+
if (record)
|
|
49
|
+
return record;
|
|
50
|
+
const str = asString(value);
|
|
51
|
+
if (!str)
|
|
52
|
+
return {};
|
|
53
|
+
try {
|
|
54
|
+
return asRecord(JSON.parse(str)) ?? {};
|
|
55
|
+
}
|
|
56
|
+
catch {
|
|
57
|
+
return {};
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
export const HERMES_TRANSPORT_CAPABILITIES = {
|
|
61
|
+
transport: 'responses-sse',
|
|
62
|
+
reportsUsage: true,
|
|
63
|
+
usageGranularity: 'per-turn',
|
|
64
|
+
produces: {
|
|
65
|
+
'message.delta': true,
|
|
66
|
+
'message.thinking': true,
|
|
67
|
+
'tool.start': true,
|
|
68
|
+
'tool.end': true,
|
|
69
|
+
'usage.update': true,
|
|
70
|
+
'session.idle': true,
|
|
71
|
+
'engine.error': true,
|
|
72
|
+
},
|
|
73
|
+
declaredAbsent: {
|
|
74
|
+
'permission.request': true,
|
|
75
|
+
'question.request': true,
|
|
76
|
+
streamingToolInput: true,
|
|
77
|
+
},
|
|
78
|
+
};
|
|
79
|
+
export class HermesEventMapper {
|
|
80
|
+
sessionId;
|
|
81
|
+
now;
|
|
82
|
+
usage;
|
|
83
|
+
_lastResponseId;
|
|
84
|
+
pendingTools = new Map();
|
|
85
|
+
startedTools = new Set();
|
|
86
|
+
endedTools = new Set();
|
|
87
|
+
syntheticToolCounter = 0;
|
|
88
|
+
constructor(options) {
|
|
89
|
+
this.sessionId = options.sessionId;
|
|
90
|
+
this.now = options.now ?? Date.now;
|
|
91
|
+
this.usage = {
|
|
92
|
+
inputTokens: 0,
|
|
93
|
+
outputTokens: 0,
|
|
94
|
+
cacheCreationTokens: 0,
|
|
95
|
+
cacheReadTokens: 0,
|
|
96
|
+
lastUpdatedAt: this.now(),
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
get lastResponseId() {
|
|
100
|
+
return this._lastResponseId;
|
|
101
|
+
}
|
|
102
|
+
getUsage() {
|
|
103
|
+
return { ...this.usage };
|
|
104
|
+
}
|
|
105
|
+
ingestFrame(frame) {
|
|
106
|
+
const parsed = parseSseFrame(frame);
|
|
107
|
+
if (!parsed) {
|
|
108
|
+
if (carriesPayload(frame))
|
|
109
|
+
hlog(`[hermes] skipping malformed SSE frame: ${frame.slice(0, 120)}`);
|
|
110
|
+
return [];
|
|
111
|
+
}
|
|
112
|
+
const { type, data } = parsed;
|
|
113
|
+
switch (type) {
|
|
114
|
+
case 'response.created':
|
|
115
|
+
this.captureResponseId(data);
|
|
116
|
+
return [];
|
|
117
|
+
case 'response.output_text.delta':
|
|
118
|
+
return this.mapTextDelta(data);
|
|
119
|
+
case 'response.reasoning_text.delta':
|
|
120
|
+
case 'response.reasoning_summary_text.delta':
|
|
121
|
+
return this.mapThinkingDelta(data);
|
|
122
|
+
case 'response.output_item.added':
|
|
123
|
+
case 'response.output_item.done':
|
|
124
|
+
return this.mapOutputItem(asRecord(data.item));
|
|
125
|
+
case 'response.completed':
|
|
126
|
+
case 'response.incomplete':
|
|
127
|
+
return this.mapCompleted(data);
|
|
128
|
+
case 'response.failed':
|
|
129
|
+
return this.mapFailed(data);
|
|
130
|
+
case 'error':
|
|
131
|
+
return [this.errorEvent(data)];
|
|
132
|
+
case 'response.in_progress':
|
|
133
|
+
case 'response.output_text.done':
|
|
134
|
+
case 'response.content_part.added':
|
|
135
|
+
case 'response.content_part.done':
|
|
136
|
+
return [];
|
|
137
|
+
default:
|
|
138
|
+
hlog(`[hermes] dropping unmapped SSE event type: ${type ?? '(none)'}`);
|
|
139
|
+
return [];
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
stampSessionId() {
|
|
143
|
+
return this.sessionId;
|
|
144
|
+
}
|
|
145
|
+
captureResponseId(data) {
|
|
146
|
+
const id = asString(asRecord(data.response)?.id) ?? asString(data.id);
|
|
147
|
+
if (id)
|
|
148
|
+
this._lastResponseId = id;
|
|
149
|
+
}
|
|
150
|
+
mapTextDelta(data) {
|
|
151
|
+
const text = asString(data.delta) ?? asString(data.text);
|
|
152
|
+
if (!text)
|
|
153
|
+
return [];
|
|
154
|
+
return [
|
|
155
|
+
{ kind: 'message.delta', sessionId: this.stampSessionId(), timestamp: this.now(), text },
|
|
156
|
+
];
|
|
157
|
+
}
|
|
158
|
+
mapThinkingDelta(data) {
|
|
159
|
+
const text = asString(data.delta) ?? asString(data.text);
|
|
160
|
+
if (!text)
|
|
161
|
+
return [];
|
|
162
|
+
return [
|
|
163
|
+
{ kind: 'message.thinking', sessionId: this.stampSessionId(), timestamp: this.now(), text },
|
|
164
|
+
];
|
|
165
|
+
}
|
|
166
|
+
mapOutputItem(item) {
|
|
167
|
+
if (!item)
|
|
168
|
+
return [];
|
|
169
|
+
const itemType = asString(item.type);
|
|
170
|
+
if (itemType === 'function_call')
|
|
171
|
+
return this.startTool(item);
|
|
172
|
+
if (itemType === 'function_call_output')
|
|
173
|
+
return this.endTool(item);
|
|
174
|
+
return [];
|
|
175
|
+
}
|
|
176
|
+
startTool(item) {
|
|
177
|
+
const callId = asString(item.call_id) ?? asString(item.id) ?? `hermes-tool-${++this.syntheticToolCounter}`;
|
|
178
|
+
const toolName = asString(item.name) ?? 'function_call';
|
|
179
|
+
const input = parseToolArguments(item.arguments);
|
|
180
|
+
const startedAt = this.pendingTools.get(callId)?.startedAt ?? this.now();
|
|
181
|
+
this.pendingTools.set(callId, { toolName, input, startedAt });
|
|
182
|
+
if (this.startedTools.has(callId))
|
|
183
|
+
return [];
|
|
184
|
+
this.startedTools.add(callId);
|
|
185
|
+
return [
|
|
186
|
+
{
|
|
187
|
+
kind: 'tool.start',
|
|
188
|
+
sessionId: this.stampSessionId(),
|
|
189
|
+
timestamp: startedAt,
|
|
190
|
+
toolCallId: callId,
|
|
191
|
+
toolName,
|
|
192
|
+
input,
|
|
193
|
+
},
|
|
194
|
+
];
|
|
195
|
+
}
|
|
196
|
+
endTool(item) {
|
|
197
|
+
const callId = asString(item.call_id) ?? asString(item.id) ?? `hermes-tool-${++this.syntheticToolCounter}`;
|
|
198
|
+
if (this.endedTools.has(callId))
|
|
199
|
+
return [];
|
|
200
|
+
this.endedTools.add(callId);
|
|
201
|
+
const pending = this.pendingTools.get(callId);
|
|
202
|
+
const toolName = pending?.toolName ?? asString(item.name) ?? 'function_call';
|
|
203
|
+
const input = pending?.input ?? {};
|
|
204
|
+
const timestamp = this.now();
|
|
205
|
+
const durationMs = Math.max(0, timestamp - (pending?.startedAt ?? timestamp));
|
|
206
|
+
const isError = item.error !== undefined || asString(item.status) === 'failed';
|
|
207
|
+
const events = [];
|
|
208
|
+
if (!this.startedTools.has(callId)) {
|
|
209
|
+
this.startedTools.add(callId);
|
|
210
|
+
events.push({
|
|
211
|
+
kind: 'tool.start',
|
|
212
|
+
sessionId: this.stampSessionId(),
|
|
213
|
+
timestamp,
|
|
214
|
+
toolCallId: callId,
|
|
215
|
+
toolName,
|
|
216
|
+
input,
|
|
217
|
+
});
|
|
218
|
+
}
|
|
219
|
+
events.push({
|
|
220
|
+
kind: 'tool.end',
|
|
221
|
+
sessionId: this.stampSessionId(),
|
|
222
|
+
timestamp,
|
|
223
|
+
toolCallId: callId,
|
|
224
|
+
toolName,
|
|
225
|
+
input,
|
|
226
|
+
result: asResultString(item.output ?? item.result ?? item.error),
|
|
227
|
+
isError,
|
|
228
|
+
durationMs,
|
|
229
|
+
});
|
|
230
|
+
this.pendingTools.delete(callId);
|
|
231
|
+
return events;
|
|
232
|
+
}
|
|
233
|
+
mapCompleted(data) {
|
|
234
|
+
const resp = asRecord(data.response) ?? data;
|
|
235
|
+
this.captureResponseId(data);
|
|
236
|
+
const events = this.mapUsage(resp, data);
|
|
237
|
+
const status = asString(resp.status);
|
|
238
|
+
const notice = status === 'incomplete' ? incompleteNotice(resp) : undefined;
|
|
239
|
+
events.push({
|
|
240
|
+
kind: 'session.idle',
|
|
241
|
+
sessionId: this.stampSessionId(),
|
|
242
|
+
timestamp: this.now(),
|
|
243
|
+
stopReason: status ?? 'end_turn',
|
|
244
|
+
...(notice ? { notice } : {}),
|
|
245
|
+
raw: data,
|
|
246
|
+
});
|
|
247
|
+
return events;
|
|
248
|
+
}
|
|
249
|
+
mapFailed(data) {
|
|
250
|
+
const resp = asRecord(data.response) ?? data;
|
|
251
|
+
this.captureResponseId(data);
|
|
252
|
+
return [
|
|
253
|
+
...this.mapUsage(resp, data),
|
|
254
|
+
this.errorEvent(data),
|
|
255
|
+
{
|
|
256
|
+
kind: 'session.idle',
|
|
257
|
+
sessionId: this.stampSessionId(),
|
|
258
|
+
timestamp: this.now(),
|
|
259
|
+
stopReason: 'error',
|
|
260
|
+
raw: data,
|
|
261
|
+
},
|
|
262
|
+
];
|
|
263
|
+
}
|
|
264
|
+
errorEvent(data) {
|
|
265
|
+
const errObj = asRecord(data.error) ?? asRecord(asRecord(data.response)?.error);
|
|
266
|
+
return {
|
|
267
|
+
kind: 'engine.error',
|
|
268
|
+
sessionId: this.stampSessionId(),
|
|
269
|
+
timestamp: this.now(),
|
|
270
|
+
code: 'HERMES_STREAM_ERROR',
|
|
271
|
+
message: asString(errObj?.message) ?? asString(data.message) ?? 'Hermes reported an error',
|
|
272
|
+
fatal: false,
|
|
273
|
+
raw: data,
|
|
274
|
+
};
|
|
275
|
+
}
|
|
276
|
+
mapUsage(resp, data) {
|
|
277
|
+
if (!this.foldUsage(asRecord(resp.usage) ?? asRecord(data.usage)))
|
|
278
|
+
return [];
|
|
279
|
+
return [
|
|
280
|
+
{
|
|
281
|
+
kind: 'usage.update',
|
|
282
|
+
sessionId: this.stampSessionId(),
|
|
283
|
+
timestamp: this.now(),
|
|
284
|
+
inputTokens: this.usage.inputTokens,
|
|
285
|
+
outputTokens: this.usage.outputTokens,
|
|
286
|
+
cacheCreationTokens: this.usage.cacheCreationTokens,
|
|
287
|
+
cacheReadTokens: this.usage.cacheReadTokens,
|
|
288
|
+
},
|
|
289
|
+
];
|
|
290
|
+
}
|
|
291
|
+
foldUsage(usage) {
|
|
292
|
+
if (!usage)
|
|
293
|
+
return false;
|
|
294
|
+
const input = asTokenCount(usage.input_tokens) ??
|
|
295
|
+
asTokenCount(usage.prompt_tokens) ??
|
|
296
|
+
asTokenCount(usage.inputTokens);
|
|
297
|
+
const output = asTokenCount(usage.output_tokens) ??
|
|
298
|
+
asTokenCount(usage.completion_tokens) ??
|
|
299
|
+
asTokenCount(usage.outputTokens);
|
|
300
|
+
const cacheRead = asTokenCount(usage.cached_input_tokens) ?? asTokenCount(usage.cacheReadTokens);
|
|
301
|
+
if (input === undefined && output === undefined && cacheRead === undefined) {
|
|
302
|
+
return false;
|
|
303
|
+
}
|
|
304
|
+
const cur = this.usage;
|
|
305
|
+
this.usage = {
|
|
306
|
+
inputTokens: cur.inputTokens + (input ?? 0),
|
|
307
|
+
outputTokens: cur.outputTokens + (output ?? 0),
|
|
308
|
+
cacheCreationTokens: cur.cacheCreationTokens,
|
|
309
|
+
cacheReadTokens: (cur.cacheReadTokens ?? 0) + (cacheRead ?? 0),
|
|
310
|
+
lastUpdatedAt: this.now(),
|
|
311
|
+
};
|
|
312
|
+
return true;
|
|
313
|
+
}
|
|
314
|
+
}
|
|
315
|
+
function carriesPayload(frame) {
|
|
316
|
+
return frame
|
|
317
|
+
.split('\n')
|
|
318
|
+
.some((line) => line.startsWith('data:') && line.slice('data:'.length).trim() !== '[DONE]');
|
|
319
|
+
}
|
|
320
|
+
function incompleteNotice(resp) {
|
|
321
|
+
const reason = asString(asRecord(resp.incomplete_details)?.reason);
|
|
322
|
+
return reason ? `The run stopped early: ${reason}.` : 'The run stopped early at a limit.';
|
|
323
|
+
}
|
|
324
|
+
export function parseSseFrame(frame) {
|
|
325
|
+
let eventType;
|
|
326
|
+
const dataLines = [];
|
|
327
|
+
for (const rawLine of frame.split('\n')) {
|
|
328
|
+
const line = rawLine.replace(/\r$/, '');
|
|
329
|
+
if (line.startsWith(':'))
|
|
330
|
+
continue;
|
|
331
|
+
if (line.startsWith('event:')) {
|
|
332
|
+
eventType = line.slice('event:'.length).trim();
|
|
333
|
+
}
|
|
334
|
+
else if (line.startsWith('data:')) {
|
|
335
|
+
dataLines.push(line.slice('data:'.length).replace(/^ /, ''));
|
|
336
|
+
}
|
|
337
|
+
}
|
|
338
|
+
const dataStr = dataLines.join('\n').trim();
|
|
339
|
+
if (!dataStr || dataStr === '[DONE]')
|
|
340
|
+
return undefined;
|
|
341
|
+
try {
|
|
342
|
+
const data = asRecord(JSON.parse(dataStr));
|
|
343
|
+
if (!data)
|
|
344
|
+
return undefined;
|
|
345
|
+
return { type: eventType ?? asString(data.type), data };
|
|
346
|
+
}
|
|
347
|
+
catch {
|
|
348
|
+
return undefined;
|
|
349
|
+
}
|
|
350
|
+
}
|
|
@@ -0,0 +1,318 @@
|
|
|
1
|
+
// Copyright (c) 2025-present Minionry, Inc.
|
|
2
|
+
// SPDX-License-Identifier: LicenseRef-Minionry-Software
|
|
3
|
+
import { spawn } from 'node:child_process';
|
|
4
|
+
import { existsSync, mkdtempSync, rmSync } from 'node:fs';
|
|
5
|
+
import { homedir, tmpdir } from 'node:os';
|
|
6
|
+
import { delimiter, join } from 'node:path';
|
|
7
|
+
import { getSettings } from '../../services/settings.js';
|
|
8
|
+
import { HERMES_ALL_TOOLSETS, hermesAppRunBaseEnv } from './hermes-gateway-home.js';
|
|
9
|
+
export const HERMES_INSTALL_URL = 'https://hermes-agent.nousresearch.com/install.sh';
|
|
10
|
+
export const HERMES_INSTALL_COMMAND = `curl -fsSL ${HERMES_INSTALL_URL} | bash`;
|
|
11
|
+
export const MINIMUM_HERMES_VERSION = '0.19.0';
|
|
12
|
+
export const MINIMUM_HERMES_APP_RUN_VERSION = '0.20.5';
|
|
13
|
+
const HERMES_EXE = process.platform === 'win32' ? 'hermes.exe' : 'hermes';
|
|
14
|
+
function defaultResolveHermesBinary(pathExists, pathValue, home) {
|
|
15
|
+
const dirs = [];
|
|
16
|
+
for (const dir of pathValue.split(delimiter)) {
|
|
17
|
+
if (dir.trim().length > 0)
|
|
18
|
+
dirs.push(dir);
|
|
19
|
+
}
|
|
20
|
+
dirs.push(join(home, '.local', 'bin'));
|
|
21
|
+
dirs.push(join(home, '.hermes', 'bin'));
|
|
22
|
+
for (const dir of dirs) {
|
|
23
|
+
const candidate = join(dir, HERMES_EXE);
|
|
24
|
+
if (pathExists(candidate))
|
|
25
|
+
return candidate;
|
|
26
|
+
}
|
|
27
|
+
return null;
|
|
28
|
+
}
|
|
29
|
+
function defaultHasInstallConsent() {
|
|
30
|
+
if (process.env.HERMES_INSTALL_CONSENT === '1')
|
|
31
|
+
return true;
|
|
32
|
+
try {
|
|
33
|
+
const settings = getSettings();
|
|
34
|
+
return settings.hermesInstallConsent === true;
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return false;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
const defaultSpawn = (cmd, args, opts) => new Promise((resolveExit) => {
|
|
41
|
+
const child = spawn(cmd, args, {
|
|
42
|
+
cwd: opts.cwd,
|
|
43
|
+
stdio: ['ignore', 'pipe', 'pipe'],
|
|
44
|
+
env: opts.env ?? process.env,
|
|
45
|
+
windowsHide: true,
|
|
46
|
+
});
|
|
47
|
+
let tail = '';
|
|
48
|
+
const TAIL_CAP = 4_000;
|
|
49
|
+
const append = (chunk) => {
|
|
50
|
+
const text = chunk.toString('utf8');
|
|
51
|
+
tail = (tail + text).slice(-TAIL_CAP);
|
|
52
|
+
if (opts.onLine) {
|
|
53
|
+
for (const line of text.split('\n')) {
|
|
54
|
+
if (line.trim().length > 0)
|
|
55
|
+
opts.onLine(line);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
};
|
|
59
|
+
child.stdout?.on('data', append);
|
|
60
|
+
child.stderr?.on('data', append);
|
|
61
|
+
child.on('error', (err) => {
|
|
62
|
+
tail = `${tail}\nspawn error: ${err.message}`.slice(-TAIL_CAP);
|
|
63
|
+
resolveExit({ ok: false, code: null, tail });
|
|
64
|
+
});
|
|
65
|
+
child.on('exit', (code) => resolveExit({ ok: code === 0, code, tail }));
|
|
66
|
+
});
|
|
67
|
+
export function parseHermesVersion(output) {
|
|
68
|
+
const m = output.match(/(\d+)\.(\d+)\.(\d+)/);
|
|
69
|
+
return m ? `${m[1]}.${m[2]}.${m[3]}` : null;
|
|
70
|
+
}
|
|
71
|
+
export function isHermesVersionTooOld(version, minimum) {
|
|
72
|
+
const v = parseHermesVersion(version);
|
|
73
|
+
const min = parseHermesVersion(minimum);
|
|
74
|
+
if (!v || !min)
|
|
75
|
+
return false;
|
|
76
|
+
const [va, vb, vc] = v.split('.').map(Number);
|
|
77
|
+
const [ma, mb, mc] = min.split('.').map(Number);
|
|
78
|
+
if (va !== ma)
|
|
79
|
+
return va < ma;
|
|
80
|
+
if (vb !== mb)
|
|
81
|
+
return vb < mb;
|
|
82
|
+
return vc < mc;
|
|
83
|
+
}
|
|
84
|
+
export class HermesRuntimeProvisioner {
|
|
85
|
+
resolveHermesBinary;
|
|
86
|
+
pathExists;
|
|
87
|
+
probeVersion;
|
|
88
|
+
spawnFn;
|
|
89
|
+
hasInstallConsent;
|
|
90
|
+
env;
|
|
91
|
+
home;
|
|
92
|
+
constructor(deps = {}) {
|
|
93
|
+
this.env = deps.env ?? process.env;
|
|
94
|
+
this.home = deps.home ?? homedir();
|
|
95
|
+
this.pathExists = deps.pathExists ?? existsSync;
|
|
96
|
+
this.spawnFn = deps.spawn ?? defaultSpawn;
|
|
97
|
+
this.hasInstallConsent = deps.hasInstallConsent ?? defaultHasInstallConsent;
|
|
98
|
+
const pathValue = deps.pathValue ?? this.env.PATH ?? this.env.Path ?? '';
|
|
99
|
+
this.resolveHermesBinary =
|
|
100
|
+
deps.resolveHermesBinary ??
|
|
101
|
+
(() => defaultResolveHermesBinary(this.pathExists, pathValue, this.home));
|
|
102
|
+
this.probeVersion = deps.probeVersion ?? ((binary) => this.defaultProbeVersion(binary));
|
|
103
|
+
}
|
|
104
|
+
async defaultProbeVersion(binary) {
|
|
105
|
+
const r = await this.spawnFn(binary, ['--version'], { cwd: this.home, env: this.env });
|
|
106
|
+
if (!r.ok)
|
|
107
|
+
return null;
|
|
108
|
+
return parseHermesVersion(r.tail);
|
|
109
|
+
}
|
|
110
|
+
async detect() {
|
|
111
|
+
const binaryPath = this.resolveHermesBinary();
|
|
112
|
+
if (!binaryPath) {
|
|
113
|
+
return { provisioned: false, binaryPath: null, version: null, state: 'missing' };
|
|
114
|
+
}
|
|
115
|
+
const version = await this.probeVersion(binaryPath);
|
|
116
|
+
if (version && isHermesVersionTooOld(version, MINIMUM_HERMES_VERSION)) {
|
|
117
|
+
return { provisioned: false, binaryPath, version, state: 'too-old' };
|
|
118
|
+
}
|
|
119
|
+
return { provisioned: true, binaryPath, version, state: 'ok' };
|
|
120
|
+
}
|
|
121
|
+
async provision(onLine) {
|
|
122
|
+
const log = onLine ?? (() => { });
|
|
123
|
+
const before = await this.detect();
|
|
124
|
+
if (before.state === 'ok') {
|
|
125
|
+
return { ok: true, status: before, action: 'noop' };
|
|
126
|
+
}
|
|
127
|
+
if (!this.hasInstallConsent()) {
|
|
128
|
+
return { ok: false, status: before, action: 'offered', error: this.describeOffer(before) };
|
|
129
|
+
}
|
|
130
|
+
await this.runInstaller(log);
|
|
131
|
+
const after = await this.detect();
|
|
132
|
+
if (after.state === 'ok') {
|
|
133
|
+
return { ok: true, status: after, action: 'installed' };
|
|
134
|
+
}
|
|
135
|
+
return { ok: false, status: after, action: 'failed', error: this.describeFailure(after) };
|
|
136
|
+
}
|
|
137
|
+
async runInstaller(log) {
|
|
138
|
+
log(`Installing Hermes via the official installer: ${HERMES_INSTALL_COMMAND}`);
|
|
139
|
+
const r = await this.spawnFn('bash', ['-c', HERMES_INSTALL_COMMAND], {
|
|
140
|
+
cwd: this.home,
|
|
141
|
+
onLine: log,
|
|
142
|
+
env: this.env,
|
|
143
|
+
});
|
|
144
|
+
if (!r.ok) {
|
|
145
|
+
log(`Hermes installer exited with code ${r.code ?? 'null'}.`);
|
|
146
|
+
}
|
|
147
|
+
return r;
|
|
148
|
+
}
|
|
149
|
+
describeOffer(status) {
|
|
150
|
+
if (status.state === 'too-old') {
|
|
151
|
+
return (`Hermes ${status.version ?? '(unknown)'} is installed but Minionry requires ` +
|
|
152
|
+
`v${MINIMUM_HERMES_VERSION} or newer. Update it with the official installer:\n ` +
|
|
153
|
+
`${HERMES_INSTALL_COMMAND}`);
|
|
154
|
+
}
|
|
155
|
+
return (`Hermes is not installed. Install it with the official installer:\n ` +
|
|
156
|
+
`${HERMES_INSTALL_COMMAND}\n` +
|
|
157
|
+
`Then retry, or set HERMES_COMMAND to an existing hermes binary.`);
|
|
158
|
+
}
|
|
159
|
+
describeFailure(status) {
|
|
160
|
+
if (status.state === 'too-old') {
|
|
161
|
+
return (`Hermes is still on ${status.version ?? '(unknown)'} after running the installer ` +
|
|
162
|
+
`(requires v${MINIMUM_HERMES_VERSION}+). Update it manually:\n ${HERMES_INSTALL_COMMAND}`);
|
|
163
|
+
}
|
|
164
|
+
return (`The Hermes installer ran but no usable \`hermes\` binary could be found afterward. ` +
|
|
165
|
+
`Install it manually:\n ${HERMES_INSTALL_COMMAND}\n` +
|
|
166
|
+
`Then set HERMES_COMMAND if it is not on PATH.`);
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
let inFlight = null;
|
|
170
|
+
let lastFailureAt = 0;
|
|
171
|
+
let lastFailureResult = null;
|
|
172
|
+
export const PROVISION_FAILURE_COOLDOWN_MS = 60_000;
|
|
173
|
+
export function ensureHermesProvisioned(onLine, deps) {
|
|
174
|
+
if (inFlight)
|
|
175
|
+
return inFlight;
|
|
176
|
+
if (lastFailureResult && now() - lastFailureAt < PROVISION_FAILURE_COOLDOWN_MS) {
|
|
177
|
+
return Promise.resolve(lastFailureResult);
|
|
178
|
+
}
|
|
179
|
+
const run = new HermesRuntimeProvisioner(deps)
|
|
180
|
+
.provision(onLine)
|
|
181
|
+
.then((result) => {
|
|
182
|
+
if (result.action === 'failed') {
|
|
183
|
+
lastFailureResult = result;
|
|
184
|
+
lastFailureAt = now();
|
|
185
|
+
}
|
|
186
|
+
else {
|
|
187
|
+
lastFailureResult = null;
|
|
188
|
+
}
|
|
189
|
+
return result;
|
|
190
|
+
})
|
|
191
|
+
.finally(() => {
|
|
192
|
+
inFlight = null;
|
|
193
|
+
});
|
|
194
|
+
inFlight = run;
|
|
195
|
+
return run;
|
|
196
|
+
}
|
|
197
|
+
export async function resolveHermesCommand(onLine, deps) {
|
|
198
|
+
const override = process.env.HERMES_COMMAND;
|
|
199
|
+
if (override && override.trim().length > 0) {
|
|
200
|
+
return override;
|
|
201
|
+
}
|
|
202
|
+
const result = await ensureHermesProvisioned(onLine, deps);
|
|
203
|
+
if (result.ok && result.status.binaryPath) {
|
|
204
|
+
return result.status.binaryPath;
|
|
205
|
+
}
|
|
206
|
+
throw new Error(result.error ??
|
|
207
|
+
`Hermes is not installed and could not be provisioned. Install it with:\n ` +
|
|
208
|
+
`${HERMES_INSTALL_COMMAND}\nThen set HERMES_COMMAND if it is not on PATH.`);
|
|
209
|
+
}
|
|
210
|
+
export function isHermesProvisioning() {
|
|
211
|
+
return inFlight !== null;
|
|
212
|
+
}
|
|
213
|
+
export const HERMES_AVAILABILITY_TTL_MS = 60_000;
|
|
214
|
+
let availabilityCache = null;
|
|
215
|
+
export function parseHermesToolsetNames(output) {
|
|
216
|
+
const names = [];
|
|
217
|
+
for (const line of output.split('\n')) {
|
|
218
|
+
const match = line.match(/^\s*\S+\s+(?:enabled|disabled)\s+(\S+)/);
|
|
219
|
+
if (match)
|
|
220
|
+
names.push(match[1]);
|
|
221
|
+
}
|
|
222
|
+
return names;
|
|
223
|
+
}
|
|
224
|
+
async function defaultListToolsets(binary, spawnFn, env) {
|
|
225
|
+
let home;
|
|
226
|
+
try {
|
|
227
|
+
home = mkdtempSync(join(tmpdir(), 'minionry-hermes-tools-'));
|
|
228
|
+
}
|
|
229
|
+
catch {
|
|
230
|
+
return null;
|
|
231
|
+
}
|
|
232
|
+
try {
|
|
233
|
+
const lines = [];
|
|
234
|
+
const result = await spawnFn(binary, ['tools', 'list', '--platform', 'api_server'], {
|
|
235
|
+
cwd: home,
|
|
236
|
+
env: { ...hermesAppRunBaseEnv(env), HERMES_HOME: home },
|
|
237
|
+
onLine: (line) => lines.push(line),
|
|
238
|
+
});
|
|
239
|
+
if (!result.ok)
|
|
240
|
+
return null;
|
|
241
|
+
return parseHermesToolsetNames(lines.join('\n'));
|
|
242
|
+
}
|
|
243
|
+
finally {
|
|
244
|
+
rmSync(home, { recursive: true, force: true });
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
async function computeHermesAvailability(deps) {
|
|
248
|
+
const env = deps.env ?? process.env;
|
|
249
|
+
const override = env.HERMES_COMMAND?.trim();
|
|
250
|
+
const provisioner = new HermesRuntimeProvisioner({
|
|
251
|
+
...deps,
|
|
252
|
+
...(override ? { resolveHermesBinary: () => override } : {}),
|
|
253
|
+
});
|
|
254
|
+
const detected = await provisioner.detect();
|
|
255
|
+
const base = { binaryPath: detected.binaryPath, version: detected.version, unknownToolsets: [] };
|
|
256
|
+
if (!detected.binaryPath) {
|
|
257
|
+
return {
|
|
258
|
+
...base,
|
|
259
|
+
available: false,
|
|
260
|
+
state: 'missing',
|
|
261
|
+
reason: `Hermes is not installed. Install it with the official installer:\n ${HERMES_INSTALL_COMMAND}`,
|
|
262
|
+
};
|
|
263
|
+
}
|
|
264
|
+
if (!detected.version || isHermesVersionTooOld(detected.version, MINIMUM_HERMES_APP_RUN_VERSION)) {
|
|
265
|
+
return {
|
|
266
|
+
...base,
|
|
267
|
+
available: false,
|
|
268
|
+
state: 'too-old',
|
|
269
|
+
reason: `Hermes ${detected.version ?? '(unknown version)'} cannot run app sessions; ` +
|
|
270
|
+
`v${MINIMUM_HERMES_APP_RUN_VERSION} or newer is required. Update it with:\n ${HERMES_INSTALL_COMMAND}`,
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
const spawnFn = deps.spawn ?? defaultSpawn;
|
|
274
|
+
const listed = await (deps.listToolsets ?? ((binary) => defaultListToolsets(binary, spawnFn, env)))(detected.binaryPath);
|
|
275
|
+
if (!listed || listed.length === 0) {
|
|
276
|
+
return {
|
|
277
|
+
...base,
|
|
278
|
+
available: false,
|
|
279
|
+
state: 'unknown-toolsets',
|
|
280
|
+
reason: 'Hermes did not list its toolsets, so an app session cannot be confirmed tool-free.',
|
|
281
|
+
};
|
|
282
|
+
}
|
|
283
|
+
const known = new Set(HERMES_ALL_TOOLSETS);
|
|
284
|
+
const unknownToolsets = [...new Set(listed.filter((name) => !known.has(name)))];
|
|
285
|
+
if (unknownToolsets.length > 0) {
|
|
286
|
+
return {
|
|
287
|
+
...base,
|
|
288
|
+
unknownToolsets,
|
|
289
|
+
available: false,
|
|
290
|
+
state: 'unknown-toolsets',
|
|
291
|
+
reason: `Hermes lists toolsets an app session cannot disable yet: ${unknownToolsets.join(', ')}.`,
|
|
292
|
+
};
|
|
293
|
+
}
|
|
294
|
+
return { ...base, available: true, state: 'ok' };
|
|
295
|
+
}
|
|
296
|
+
export function hermesAvailability(deps = {}) {
|
|
297
|
+
const at = now();
|
|
298
|
+
if (availabilityCache && at - availabilityCache.at < HERMES_AVAILABILITY_TTL_MS) {
|
|
299
|
+
return availabilityCache.result;
|
|
300
|
+
}
|
|
301
|
+
const result = computeHermesAvailability(deps);
|
|
302
|
+
const entry = { at, result };
|
|
303
|
+
availabilityCache = entry;
|
|
304
|
+
result.catch(() => {
|
|
305
|
+
if (availabilityCache === entry)
|
|
306
|
+
availabilityCache = null;
|
|
307
|
+
});
|
|
308
|
+
return result;
|
|
309
|
+
}
|
|
310
|
+
function now() {
|
|
311
|
+
return Date.now();
|
|
312
|
+
}
|
|
313
|
+
export function resetHermesProvisionStateForTests() {
|
|
314
|
+
inFlight = null;
|
|
315
|
+
lastFailureAt = 0;
|
|
316
|
+
lastFailureResult = null;
|
|
317
|
+
availabilityCache = null;
|
|
318
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
// Copyright (c) 2025-present Minionry, Inc.
|
|
2
|
+
// SPDX-License-Identifier: LicenseRef-Minionry-Software
|
|
3
|
+
import { WORKSPACE_WRITE_TOOLS } from '../services/sdk/run-profile.js';
|
|
4
|
+
export function sessionIsReadOnly(options) {
|
|
5
|
+
const disallowed = options.disallowedTools ?? [];
|
|
6
|
+
return WORKSPACE_WRITE_TOOLS.some((tool) => disallowed.includes(tool));
|
|
7
|
+
}
|
|
8
|
+
export function readOnlyDisallowedTools() {
|
|
9
|
+
return [...WORKSPACE_WRITE_TOOLS];
|
|
10
|
+
}
|
|
11
|
+
export const READ_ONLY_UNSUPPORTED = 'READ_ONLY_UNSUPPORTED';
|
|
12
|
+
export const HERMES_READ_ONLY_REFUSAL = 'Hermes cannot run a read-only session: its file tools can always write. Choose Claude Code or Codex for this.';
|
|
13
|
+
const READ_ONLY_REFUSALS = {
|
|
14
|
+
'claude-code': null,
|
|
15
|
+
codex: null,
|
|
16
|
+
hermes: HERMES_READ_ONLY_REFUSAL,
|
|
17
|
+
};
|
|
18
|
+
export function readOnlyRefusal(engineId) {
|
|
19
|
+
return READ_ONLY_REFUSALS[engineId] ?? null;
|
|
20
|
+
}
|