orkeon-code 0.0.0-stage → 1.0.0-rc.2
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/.orkeon-runtime +10 -0
- package/.orkeon-version +1 -0
- package/LICENSE.md +21 -0
- package/NOTICE.md +17 -0
- package/README.fr.md +163 -0
- package/README.md +156 -2
- package/config/appsettings.anthropic.example.json +77 -0
- package/config/appsettings.example.json +71 -0
- package/config/appsettings.jev.example.json +131 -0
- package/config/appsettings.kev.example.json +133 -0
- package/config/appsettings.liquid.example.json +132 -0
- package/config/appsettings.ollama-whisper.example.json +93 -0
- package/config/appsettings.ollama.example.json +70 -0
- package/config/appsettings.whisper.example.json +32 -0
- package/mcp/whisper/README.md +294 -0
- package/mcp/whisper/pyproject.toml +32 -0
- package/mcp/whisper/uv.lock +1641 -0
- package/mcp/whisper/whisper_mcp.py +1053 -0
- package/orkeon-code +1092 -0
- package/orkeon-code.mjs +71 -0
- package/orkeon-code.ps1 +939 -0
- package/package.json +58 -4
- package/scripts/install.ps1 +156 -0
- package/scripts/install.sh +148 -0
- package/scripts/session-start.ork.ts +90 -0
- package/scripts/session-start.sh +74 -0
- package/scripts/setup-fixture.sh +88 -0
- package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
- package/src/commands/_lib/args.ts +194 -0
- package/src/commands/_lib/dev/dev-batches.ts +366 -0
- package/src/commands/_lib/dev/dev-implement.ts +185 -0
- package/src/commands/_lib/dev/dev-source.ts +61 -0
- package/src/commands/_lib/dev/dev.ts +341 -0
- package/src/commands/_lib/dev/markers.ts +7 -0
- package/src/commands/_lib/dev/messages.ts +112 -0
- package/src/commands/_lib/dev-step.ts +145 -0
- package/src/commands/_lib/dispatch.ts +254 -0
- package/src/commands/_lib/effort.ts +15 -0
- package/src/commands/_lib/git/branch.ts +94 -0
- package/src/commands/_lib/git/commit.ts +90 -0
- package/src/commands/_lib/git/diff.ts +107 -0
- package/src/commands/_lib/git/messages.ts +54 -0
- package/src/commands/_lib/git/review.ts +108 -0
- package/src/commands/_lib/memory/memory-admit.ts +148 -0
- package/src/commands/_lib/memory/memory.ts +52 -0
- package/src/commands/_lib/memory/messages.ts +32 -0
- package/src/commands/_lib/messages.ts +48 -0
- package/src/commands/_lib/pr-context.ts +32 -0
- package/src/commands/_lib/project/analyze.ts +24 -0
- package/src/commands/_lib/project/messages.ts +8 -0
- package/src/commands/_lib/session/export.ts +105 -0
- package/src/commands/_lib/session/messages.ts +87 -0
- package/src/commands/_lib/session/prompts.ts +4 -0
- package/src/commands/_lib/session/resume.ts +151 -0
- package/src/commands/_lib/session/tasks.ts +181 -0
- package/src/commands/_lib/settings/advisor.ts +75 -0
- package/src/commands/_lib/settings/agents.ts +137 -0
- package/src/commands/_lib/settings/choices.ts +8 -0
- package/src/commands/_lib/settings/config.ts +141 -0
- package/src/commands/_lib/settings/effort.ts +147 -0
- package/src/commands/_lib/settings/hooks.ts +50 -0
- package/src/commands/_lib/settings/messages.ts +408 -0
- package/src/commands/_lib/settings/mode.ts +100 -0
- package/src/commands/_lib/settings/model.ts +181 -0
- package/src/commands/_lib/settings/output-style.ts +39 -0
- package/src/commands/_lib/settings/permissions.ts +287 -0
- package/src/commands/_lib/settings/route.ts +63 -0
- package/src/commands/_lib/settings/session-config.ts +49 -0
- package/src/commands/_lib/settings/skills.ts +93 -0
- package/src/commands/_lib/settings/theme.ts +42 -0
- package/src/commands/_lib/speech/messages.ts +58 -0
- package/src/commands/_lib/speech/prompts.ts +4 -0
- package/src/commands/_lib/speech/say.ts +95 -0
- package/src/commands/_lib/speech/transcribe.ts +121 -0
- package/src/commands/_lib/speech/voice.ts +142 -0
- package/src/commands/_lib/status/cache.ts +31 -0
- package/src/commands/_lib/status/context.ts +57 -0
- package/src/commands/_lib/status/doctor.ts +205 -0
- package/src/commands/_lib/status/messages.ts +100 -0
- package/src/commands/_lib/status/meta.ts +24 -0
- package/src/commands/_lib/status/status.ts +128 -0
- package/src/commands/_lib/status/usage-tools.ts +48 -0
- package/src/commands/_lib/status/usage.ts +128 -0
- package/src/commands/_lib/view.ts +34 -0
- package/src/commands/dev/dev-batches.cmd.ts +109 -0
- package/src/commands/dev/dev-learn.cmd.ts +29 -0
- package/src/commands/dev/dev-plan.cmd.ts +51 -0
- package/src/commands/dev/dev-spec.cmd.ts +54 -0
- package/src/commands/dev/dev-status.cmd.ts +16 -0
- package/src/commands/git/branch.cmd.ts +27 -0
- package/src/commands/git/commit.cmd.ts +48 -0
- package/src/commands/git/diff.cmd.ts +26 -0
- package/src/commands/git/review.cmd.ts +36 -0
- package/src/commands/memory/memory.cmd.ts +48 -0
- package/src/commands/project/analyze.cmd.ts +32 -0
- package/src/commands/project/debug-tool-call.cmd.ts +62 -0
- package/src/commands/project/files.cmd.ts +22 -0
- package/src/commands/project/init-verifiers.cmd.ts +14 -0
- package/src/commands/project/init.cmd.ts +14 -0
- package/src/commands/project/verify.cmd.ts +27 -0
- package/src/commands/session/assistant.cmd.ts +40 -0
- package/src/commands/session/btw.cmd.ts +18 -0
- package/src/commands/session/clear.cmd.ts +19 -0
- package/src/commands/session/compact.cmd.ts +16 -0
- package/src/commands/session/copy.cmd.ts +45 -0
- package/src/commands/session/exit.cmd.ts +9 -0
- package/src/commands/session/export.cmd.ts +28 -0
- package/src/commands/session/rename.cmd.ts +18 -0
- package/src/commands/session/resume.cmd.ts +19 -0
- package/src/commands/session/rewind.cmd.ts +25 -0
- package/src/commands/session/summary.cmd.ts +27 -0
- package/src/commands/session/tasks.cmd.ts +46 -0
- package/src/commands/settings/advisor.cmd.ts +38 -0
- package/src/commands/settings/agents.cmd.ts +19 -0
- package/src/commands/settings/config.cmd.ts +19 -0
- package/src/commands/settings/effort.cmd.ts +19 -0
- package/src/commands/settings/fast.cmd.ts +18 -0
- package/src/commands/settings/hooks.cmd.ts +17 -0
- package/src/commands/settings/mode.cmd.ts +20 -0
- package/src/commands/settings/model.cmd.ts +21 -0
- package/src/commands/settings/output-style.cmd.ts +19 -0
- package/src/commands/settings/permissions.cmd.ts +25 -0
- package/src/commands/settings/proactive.cmd.ts +16 -0
- package/src/commands/settings/route.cmd.ts +16 -0
- package/src/commands/settings/skills.cmd.ts +17 -0
- package/src/commands/settings/theme.cmd.ts +14 -0
- package/src/commands/speech/say.cmd.ts +24 -0
- package/src/commands/speech/transcribe.cmd.ts +29 -0
- package/src/commands/speech/voice.cmd.ts +30 -0
- package/src/commands/status/context.cmd.ts +18 -0
- package/src/commands/status/doctor.cmd.ts +27 -0
- package/src/commands/status/release-notes.cmd.ts +9 -0
- package/src/commands/status/status.cmd.ts +25 -0
- package/src/commands/status/usage.cmd.ts +21 -0
- package/src/crews/.orkeon/orkeon.d.ts +4391 -0
- package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
- package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
- package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
- package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
- package/src/crews/advisor/application/messages.ts +4 -0
- package/src/crews/advisor/application/prompts.ts +4 -0
- package/src/crews/advisor/application/run-advisor.ts +41 -0
- package/src/crews/advisor/crew.ork.ts +44 -0
- package/src/crews/advisor/domain/advice.ts +119 -0
- package/src/crews/advisor/domain/messages.ts +8 -0
- package/src/crews/advisor/domain/prompts.ts +26 -0
- package/src/crews/agent-run/application/messages.ts +18 -0
- package/src/crews/agent-run/application/run-agent-run.ts +43 -0
- package/src/crews/agent-run/crew.ork.ts +67 -0
- package/src/crews/analyze/application/messages.ts +27 -0
- package/src/crews/analyze/application/prompts.ts +4 -0
- package/src/crews/analyze/application/run-analyze.ts +120 -0
- package/src/crews/analyze/crew.ork.ts +41 -0
- package/src/crews/analyze/domain/harvest.ts +269 -0
- package/src/crews/analyze/domain/prompts.ts +86 -0
- package/src/crews/code-review/application/lens-material.ts +24 -0
- package/src/crews/code-review/application/messages.ts +17 -0
- package/src/crews/code-review/application/prompts.ts +126 -0
- package/src/crews/code-review/application/review.ts +74 -0
- package/src/crews/code-review/application/run-code-review.ts +121 -0
- package/src/crews/code-review/crew.ork.ts +52 -0
- package/src/crews/code-review/domain/lenses.ts +154 -0
- package/src/crews/code-review/domain/messages.ts +25 -0
- package/src/crews/code-review/domain/prompts.ts +58 -0
- package/src/crews/code-review/domain/report.ts +58 -0
- package/src/crews/code-review/domain/scope.ts +106 -0
- package/src/crews/dev-batches/application/messages.ts +127 -0
- package/src/crews/dev-batches/application/plan-close.ts +181 -0
- package/src/crews/dev-batches/application/prompts.ts +10 -0
- package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
- package/src/crews/dev-batches/application/run-wave.ts +452 -0
- package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
- package/src/crews/dev-batches/crew.ork.ts +146 -0
- package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
- package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
- package/src/crews/dev-batches/domain/batches-log.ts +52 -0
- package/src/crews/dev-batches/domain/markers.ts +5 -0
- package/src/crews/dev-batches/domain/messages.ts +6 -0
- package/src/crews/dev-batches/domain/wave-order.ts +44 -0
- package/src/crews/dev-change/application/change-material.ts +44 -0
- package/src/crews/dev-change/application/evidence.ts +172 -0
- package/src/crews/dev-change/application/messages.ts +81 -0
- package/src/crews/dev-change/application/prompts.ts +101 -0
- package/src/crews/dev-change/application/run-dev-change.ts +324 -0
- package/src/crews/dev-change/crew.ork.ts +114 -0
- package/src/crews/dev-change/domain/change-answer.ts +163 -0
- package/src/crews/dev-change/domain/change-render.ts +77 -0
- package/src/crews/dev-change/domain/markers.ts +28 -0
- package/src/crews/dev-change/domain/messages.ts +16 -0
- package/src/crews/dev-implement/application/close.ts +186 -0
- package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
- package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
- package/src/crews/dev-implement/application/messages.ts +161 -0
- package/src/crews/dev-implement/application/observe.ts +52 -0
- package/src/crews/dev-implement/application/prompts.ts +9 -0
- package/src/crews/dev-implement/application/report-writes.ts +46 -0
- package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
- package/src/crews/dev-implement/application/run-role.ts +27 -0
- package/src/crews/dev-implement/application/suite-job.ts +122 -0
- package/src/crews/dev-implement/application/touched.ts +74 -0
- package/src/crews/dev-implement/crew.ork.ts +69 -0
- package/src/crews/dev-implement/domain/contracts.ts +255 -0
- package/src/crews/dev-implement/domain/correction.ts +103 -0
- package/src/crews/dev-implement/domain/cycles.ts +36 -0
- package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
- package/src/crews/dev-implement/domain/markers.ts +23 -0
- package/src/crews/dev-implement/domain/messages.ts +58 -0
- package/src/crews/dev-implement/domain/prompts.ts +93 -0
- package/src/crews/dev-implement/domain/roles.ts +49 -0
- package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
- package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
- package/src/crews/dev-implement/domain/step-checks.ts +137 -0
- package/src/crews/dev-implement/domain/step-section.ts +129 -0
- package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
- package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
- package/src/crews/dev-learn/application/messages.ts +51 -0
- package/src/crews/dev-learn/application/prompts.ts +99 -0
- package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
- package/src/crews/dev-learn/crew.ork.ts +53 -0
- package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
- package/src/crews/dev-learn/domain/messages.ts +65 -0
- package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
- package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
- package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
- package/src/crews/dev-plan/application/inventory.ts +174 -0
- package/src/crews/dev-plan/application/messages.ts +88 -0
- package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
- package/src/crews/dev-plan/application/prompts.ts +141 -0
- package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
- package/src/crews/dev-plan/crew.ork.ts +112 -0
- package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
- package/src/crews/dev-plan/domain/markers.ts +18 -0
- package/src/crews/dev-plan/domain/messages.ts +118 -0
- package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
- package/src/crews/dev-plan/domain/plan-render.ts +306 -0
- package/src/crews/dev-plan/domain/prompts.ts +44 -0
- package/src/crews/dev-spec/application/messages.ts +30 -0
- package/src/crews/dev-spec/application/prompts.ts +93 -0
- package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
- package/src/crews/dev-spec/application/spec-material.ts +42 -0
- package/src/crews/dev-spec/crew.ork.ts +110 -0
- package/src/crews/dev-spec/domain/markers.ts +30 -0
- package/src/crews/dev-spec/domain/messages.ts +39 -0
- package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
- package/src/crews/dev-spec/domain/spec-render.ts +76 -0
- package/src/crews/dev-verify/application/audit-brief.ts +187 -0
- package/src/crews/dev-verify/application/audit.ts +267 -0
- package/src/crews/dev-verify/application/capture.ts +311 -0
- package/src/crews/dev-verify/application/messages.ts +119 -0
- package/src/crews/dev-verify/application/prompts.ts +209 -0
- package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
- package/src/crews/dev-verify/application/run-gate.ts +204 -0
- package/src/crews/dev-verify/crew.ork.ts +103 -0
- package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
- package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
- package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
- package/src/crews/dev-verify/domain/commands.ts +103 -0
- package/src/crews/dev-verify/domain/gate.ts +131 -0
- package/src/crews/dev-verify/domain/markers.ts +16 -0
- package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
- package/src/crews/dev-verify/domain/messages.ts +92 -0
- package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
- package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
- package/src/crews/dev-verify/domain/text.ts +20 -0
- package/src/crews/dev-verify/domain/verdict.ts +127 -0
- package/src/crews/git-commit/application/draft.ts +133 -0
- package/src/crews/git-commit/application/messages.ts +15 -0
- package/src/crews/git-commit/application/prompts.ts +47 -0
- package/src/crews/git-commit/application/run-git-commit.ts +117 -0
- package/src/crews/git-commit/crew.ork.ts +53 -0
- package/src/crews/git-commit/domain/commit.ts +200 -0
- package/src/crews/git-commit/domain/markers.ts +4 -0
- package/src/crews/git-commit/domain/messages.ts +48 -0
- package/src/crews/init-verifiers/application/authoring.ts +90 -0
- package/src/crews/init-verifiers/application/messages.ts +13 -0
- package/src/crews/init-verifiers/application/prompts.ts +107 -0
- package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
- package/src/crews/init-verifiers/crew.ork.ts +35 -0
- package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
- package/src/crews/init-verifiers/domain/readiness.ts +23 -0
- package/src/crews/main-loop/application/auto-compact.ts +78 -0
- package/src/crews/main-loop/application/context-gather.ts +133 -0
- package/src/crews/main-loop/application/messages.ts +81 -0
- package/src/crews/main-loop/application/prompts.ts +12 -0
- package/src/crews/main-loop/application/run-main-loop.ts +383 -0
- package/src/crews/main-loop/application/turn-context.ts +111 -0
- package/src/crews/main-loop/crew.ork.ts +124 -0
- package/src/crews/main-loop/domain/autocompact.ts +27 -0
- package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
- package/src/crews/main-loop/domain/prompts.ts +336 -0
- package/src/crews/main-loop/domain/turn-chains.ts +130 -0
- package/src/crews/project-init/application/detect.ts +123 -0
- package/src/crews/project-init/application/messages.ts +15 -0
- package/src/crews/project-init/application/prompts.ts +105 -0
- package/src/crews/project-init/application/run-project-init.ts +31 -0
- package/src/crews/project-init/crew.ork.ts +36 -0
- package/src/crews/project-init/domain/conventions.ts +36 -0
- package/src/crews/project-init/domain/existing-files.ts +65 -0
- package/src/crews/project-init/domain/messages.ts +13 -0
- package/src/crews/project-init/domain/package-map.ts +73 -0
- package/src/crews/project-init/domain/prompts.ts +10 -0
- package/src/crews/session-compact/application/prompts.ts +5 -0
- package/src/crews/session-compact/crew.ork.ts +56 -0
- package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
- package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
- package/src/crews/speech/application/messages.ts +3 -0
- package/src/crews/speech/application/prompts.ts +3 -0
- package/src/crews/speech/application/run-speech.ts +26 -0
- package/src/crews/speech/crew.ork.ts +38 -0
- package/src/shared/application/agents/child-agent.ts +259 -0
- package/src/shared/application/agents/messages.ts +35 -0
- package/src/shared/application/agents/route-agent.ts +115 -0
- package/src/shared/application/agents/run-sub-agent.ts +119 -0
- package/src/shared/application/answer-language.ts +14 -0
- package/src/shared/application/attached-skills.ts +36 -0
- package/src/shared/application/compaction/compact-session.ts +242 -0
- package/src/shared/application/compaction/extract-memories.ts +38 -0
- package/src/shared/application/compaction/messages.ts +20 -0
- package/src/shared/application/compaction/prune-context.ts +94 -0
- package/src/shared/application/compaction/pruned-llm.ts +35 -0
- package/src/shared/application/compaction/restore-context.ts +78 -0
- package/src/shared/application/config-store.ts +123 -0
- package/src/shared/application/dev/brief-inventory.ts +115 -0
- package/src/shared/application/dev/close-batch.ts +85 -0
- package/src/shared/application/dev/find-repo-pack.ts +78 -0
- package/src/shared/application/dev/learn-decision.ts +254 -0
- package/src/shared/application/dev/load-dev-context.ts +265 -0
- package/src/shared/application/dev/measure-access-cost.ts +69 -0
- package/src/shared/application/dev/messages.ts +132 -0
- package/src/shared/application/dev/phase-timer.ts +54 -0
- package/src/shared/application/dev/plan-source.ts +116 -0
- package/src/shared/application/dev/preflight.ts +71 -0
- package/src/shared/application/dev/project-files.ts +17 -0
- package/src/shared/application/dev/prompts.ts +34 -0
- package/src/shared/application/dev/question-round.ts +60 -0
- package/src/shared/application/dev/resolve-work-folder.ts +134 -0
- package/src/shared/application/dev/script-tool-slot.ts +27 -0
- package/src/shared/application/dev/settle-questions.ts +57 -0
- package/src/shared/application/dev/source-review.ts +67 -0
- package/src/shared/application/dev/source-step.ts +152 -0
- package/src/shared/application/dev/spend.ts +55 -0
- package/src/shared/application/dev/step-precedents.ts +90 -0
- package/src/shared/application/dev/tool-call-policy.ts +87 -0
- package/src/shared/application/dev/tool-callbacks.ts +262 -0
- package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
- package/src/shared/application/dev/verdict-sources.ts +50 -0
- package/src/shared/application/dev/wrapped-tools.ts +147 -0
- package/src/shared/application/extra-tools.ts +71 -0
- package/src/shared/application/git/batch-worktree.ts +102 -0
- package/src/shared/application/git/commit-files.ts +191 -0
- package/src/shared/application/git/merge-batch.ts +67 -0
- package/src/shared/application/git/messages.ts +75 -0
- package/src/shared/application/git/open-pull-request.ts +52 -0
- package/src/shared/application/host-context.ts +59 -0
- package/src/shared/application/host-layout-store.ts +45 -0
- package/src/shared/application/instructions-file.ts +19 -0
- package/src/shared/application/json-file.ts +34 -0
- package/src/shared/application/llm-profile.ts +36 -0
- package/src/shared/application/messages.ts +14 -0
- package/src/shared/application/permission-rules.ts +169 -0
- package/src/shared/application/ports/approvals.ts +20 -0
- package/src/shared/application/ports/clock.ts +5 -0
- package/src/shared/application/ports/code-index.ts +93 -0
- package/src/shared/application/ports/crew.ts +60 -0
- package/src/shared/application/ports/decision.ts +14 -0
- package/src/shared/application/ports/files.ts +21 -0
- package/src/shared/application/ports/human.ts +38 -0
- package/src/shared/application/ports/llm.ts +83 -0
- package/src/shared/application/ports/memory.ts +30 -0
- package/src/shared/application/ports/progress.ts +23 -0
- package/src/shared/application/ports/runtime.ts +15 -0
- package/src/shared/application/ports/session.ts +74 -0
- package/src/shared/application/ports/shared-memory.ts +26 -0
- package/src/shared/application/ports/shell.ts +40 -0
- package/src/shared/application/ports/telemetry.ts +45 -0
- package/src/shared/application/ports/theme.ts +11 -0
- package/src/shared/application/ports/tools.ts +46 -0
- package/src/shared/application/ports/usage.ts +45 -0
- package/src/shared/application/ports.ts +29 -0
- package/src/shared/application/project-manifests.ts +106 -0
- package/src/shared/application/session-io.ts +85 -0
- package/src/shared/application/session-state.ts +36 -0
- package/src/shared/application/shared-memory/admit-entries.ts +179 -0
- package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
- package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
- package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
- package/src/shared/application/shared-memory/memory-files.ts +111 -0
- package/src/shared/application/shared-memory/memory-settings.ts +94 -0
- package/src/shared/application/shared-memory/messages.ts +63 -0
- package/src/shared/application/shared-memory/push-candidate.ts +149 -0
- package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
- package/src/shared/application/skills/messages.ts +4 -0
- package/src/shared/application/skills/suggest-skills.ts +102 -0
- package/src/shared/application/state-snapshot.ts +38 -0
- package/src/shared/application/workflow/messages.ts +8 -0
- package/src/shared/application/workflow/workflow-state.ts +136 -0
- package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
- package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
- package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
- package/src/shared/domain/agent-policy/messages.ts +66 -0
- package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
- package/src/shared/domain/agent-policy/output-styles.ts +11 -0
- package/src/shared/domain/agent-policy/path-rules.ts +299 -0
- package/src/shared/domain/agent-policy/permission.ts +625 -0
- package/src/shared/domain/agent-policy/prompts.ts +17 -0
- package/src/shared/domain/agent-policy/reasoning.ts +59 -0
- package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
- package/src/shared/domain/agent-policy/tool-access.ts +91 -0
- package/src/shared/domain/agent-registry.ts +143 -0
- package/src/shared/domain/agents/built-in-charters.ts +43 -0
- package/src/shared/domain/agents/chain.ts +30 -0
- package/src/shared/domain/agents/charter.ts +64 -0
- package/src/shared/domain/agents/exclusive.ts +25 -0
- package/src/shared/domain/agents/instances.ts +252 -0
- package/src/shared/domain/agents/messages.ts +39 -0
- package/src/shared/domain/agents/model-route.ts +199 -0
- package/src/shared/domain/agents/prompts.ts +20 -0
- package/src/shared/domain/code-intel-contract.ts +357 -0
- package/src/shared/domain/code-intel-routing.ts +60 -0
- package/src/shared/domain/compact-outcome.ts +46 -0
- package/src/shared/domain/compaction-thresholds.ts +162 -0
- package/src/shared/domain/compaction.ts +288 -0
- package/src/shared/domain/config-schema.ts +434 -0
- package/src/shared/domain/context-prune.ts +176 -0
- package/src/shared/domain/decision/questions.ts +102 -0
- package/src/shared/domain/dev/access-cost.ts +230 -0
- package/src/shared/domain/dev/artefacts.ts +50 -0
- package/src/shared/domain/dev/batches-concurrency.ts +35 -0
- package/src/shared/domain/dev/batches-state.ts +49 -0
- package/src/shared/domain/dev/build-commands.ts +45 -0
- package/src/shared/domain/dev/call-guard.ts +342 -0
- package/src/shared/domain/dev/carried-text.ts +47 -0
- package/src/shared/domain/dev/design-rules.ts +100 -0
- package/src/shared/domain/dev/learn-proposals.ts +176 -0
- package/src/shared/domain/dev/learn-state.ts +94 -0
- package/src/shared/domain/dev/markers.ts +107 -0
- package/src/shared/domain/dev/messages.ts +259 -0
- package/src/shared/domain/dev/path-args.ts +42 -0
- package/src/shared/domain/dev/path-rebase.ts +93 -0
- package/src/shared/domain/dev/phase-timing.ts +50 -0
- package/src/shared/domain/dev/plan-checks.ts +191 -0
- package/src/shared/domain/dev/plan-format.ts +170 -0
- package/src/shared/domain/dev/project-files.ts +29 -0
- package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
- package/src/shared/domain/dev/prompts.ts +251 -0
- package/src/shared/domain/dev/questions.ts +267 -0
- package/src/shared/domain/dev/reading-rule.ts +41 -0
- package/src/shared/domain/dev/repo-pack.ts +240 -0
- package/src/shared/domain/dev/review-answer.ts +173 -0
- package/src/shared/domain/dev/review-brief.ts +54 -0
- package/src/shared/domain/dev/reviewer-charter.ts +35 -0
- package/src/shared/domain/dev/sheet-facts.ts +81 -0
- package/src/shared/domain/dev/spec-format.ts +182 -0
- package/src/shared/domain/dev/step-budget.ts +74 -0
- package/src/shared/domain/dev/step-rules.ts +109 -0
- package/src/shared/domain/dev/test-commands.ts +94 -0
- package/src/shared/domain/dev/test-output.ts +33 -0
- package/src/shared/domain/dev/test-paths.ts +40 -0
- package/src/shared/domain/dev/tool-guards.ts +65 -0
- package/src/shared/domain/dev/trait-pattern.ts +87 -0
- package/src/shared/domain/dev/verdict-format.ts +162 -0
- package/src/shared/domain/dev/whitespace.ts +35 -0
- package/src/shared/domain/dev/work-folder.ts +68 -0
- package/src/shared/domain/dev/yaml-subset.ts +385 -0
- package/src/shared/domain/error-text.ts +13 -0
- package/src/shared/domain/git/close.ts +274 -0
- package/src/shared/domain/git/messages.ts +20 -0
- package/src/shared/domain/git/pull-request.ts +96 -0
- package/src/shared/domain/git/worktree.ts +46 -0
- package/src/shared/domain/host-layout.ts +147 -0
- package/src/shared/domain/host-paths.ts +399 -0
- package/src/shared/domain/index-languages.ts +16 -0
- package/src/shared/domain/instructions-file.ts +18 -0
- package/src/shared/domain/iso-day.ts +4 -0
- package/src/shared/domain/llm-failure.ts +134 -0
- package/src/shared/domain/llm-profile.ts +44 -0
- package/src/shared/domain/marked-message.ts +29 -0
- package/src/shared/domain/markers.ts +30 -0
- package/src/shared/domain/messages.ts +291 -0
- package/src/shared/domain/model-catalog.ts +79 -0
- package/src/shared/domain/permission-modes.ts +99 -0
- package/src/shared/domain/prelude.ts +92 -0
- package/src/shared/domain/project-manifests.ts +84 -0
- package/src/shared/domain/prompts.ts +233 -0
- package/src/shared/domain/search-routing.ts +77 -0
- package/src/shared/domain/secret-patterns.ts +46 -0
- package/src/shared/domain/session-keys.ts +92 -0
- package/src/shared/domain/session-start.ts +61 -0
- package/src/shared/domain/severity.ts +72 -0
- package/src/shared/domain/sha1.ts +61 -0
- package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
- package/src/shared/domain/shared-memory/candidates.ts +40 -0
- package/src/shared/domain/shared-memory/entry.ts +151 -0
- package/src/shared/domain/shared-memory/front-matter.ts +187 -0
- package/src/shared/domain/shared-memory/gate.ts +45 -0
- package/src/shared/domain/shared-memory/harvest.ts +64 -0
- package/src/shared/domain/shared-memory/layout.ts +190 -0
- package/src/shared/domain/shared-memory/markers.ts +9 -0
- package/src/shared/domain/shared-memory/messages.ts +66 -0
- package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
- package/src/shared/domain/shared-memory/prompts.ts +28 -0
- package/src/shared/domain/shared-memory/refused.ts +84 -0
- package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
- package/src/shared/domain/skills/prompts.ts +4 -0
- package/src/shared/domain/skills/shortlist.ts +149 -0
- package/src/shared/domain/snip-turns.ts +33 -0
- package/src/shared/domain/speech.ts +21 -0
- package/src/shared/domain/strip.ts +88 -0
- package/src/shared/domain/tool-trace.ts +120 -0
- package/src/shared/domain/types.ts +67 -0
- package/src/shared/domain/verifiers.ts +33 -0
- package/src/shared/domain/vfs.ts +16 -0
- package/src/shared/domain/workflow/prompts.ts +15 -0
- package/src/shared/domain/workflow/state-file.ts +142 -0
- package/src/shared/infrastructure/globals.ts +57 -0
- package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
- package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
- package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
- package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
- package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
- package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
- package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
- package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
- package/src/shared/infrastructure/orkeon/files.ts +58 -0
- package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
- package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
- package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
- package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
- package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
- package/src/shared/infrastructure/orkeon/llm.ts +164 -0
- package/src/shared/infrastructure/orkeon/markers.ts +6 -0
- package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
- package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
- package/src/shared/infrastructure/orkeon/messages.ts +15 -0
- package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
- package/src/shared/infrastructure/orkeon/progress.ts +24 -0
- package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
- package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
- package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
- package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
- package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
- package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
- package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
- package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
- package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
- package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
- package/src/shared/infrastructure/orkeon/shell.ts +39 -0
- package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
- package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
- package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
- package/src/shared/infrastructure/orkeon/usage.ts +74 -0
- package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
// Session adapter over session_store (buffer, state bag and title), session_snip
|
|
2
|
+
// and token_budget.
|
|
3
|
+
// The runtime hands back either casing (`messages` or `Messages`, `role` or
|
|
4
|
+
// `Role`...); this is the one place that reads them. A failed read is rethrown with
|
|
5
|
+
// the tool's own message, the runtime's wrapping gone (withToolMessage).
|
|
6
|
+
|
|
7
|
+
import type { SessionMsg } from "../../domain/types.ts";
|
|
8
|
+
import type { SessionStore, StoredMessage, TokenBudget, TokenKinds } from "../../application/ports.ts";
|
|
9
|
+
import type { SessionStoreInput } from "./runtime-tools.ts";
|
|
10
|
+
import { asArray, pick, withToolMessage } from "./tool-results.ts";
|
|
11
|
+
import { sessionStoreRefusedAppend } from "./messages.ts";
|
|
12
|
+
|
|
13
|
+
/** The `{ role, content }` view of stored entries, for transcripts and history. */
|
|
14
|
+
function normalizeMessages(stored: StoredMessage[]): SessionMsg[] {
|
|
15
|
+
return stored.map((m) => ({
|
|
16
|
+
role: String(pick(m, "role", "Role") ?? ""),
|
|
17
|
+
content: String(pick(m, "content", "Content") ?? ""),
|
|
18
|
+
}));
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** A reported count, as a number; absent reads as 0. */
|
|
22
|
+
const count = (r: unknown, ...names: string[]): number => Number(pick(r, ...names) ?? 0);
|
|
23
|
+
|
|
24
|
+
export function createSessionStore(
|
|
25
|
+
tools: Pick<OrkeonTools, "sessionStore" | "sessionSnip" | "tokenBudget">,
|
|
26
|
+
): SessionStore {
|
|
27
|
+
// One shape per operation (runtime-tools.ts): a misspelled operation fails here.
|
|
28
|
+
const sessionStore = (input: SessionStoreInput) => tools.sessionStore(input);
|
|
29
|
+
return {
|
|
30
|
+
async readMessages() {
|
|
31
|
+
const resp = await withToolMessage(() => sessionStore({ operation: "read_messages" }));
|
|
32
|
+
// A buffer that is not a list holds no message: the compaction skips it and
|
|
33
|
+
// the commands show an empty session, rather than failing on it.
|
|
34
|
+
const stored: StoredMessage[] = asArray(pick(resp, "messages", "Messages"));
|
|
35
|
+
return { stored, messages: normalizeMessages(stored) };
|
|
36
|
+
},
|
|
37
|
+
async writeMessages(messages) {
|
|
38
|
+
await sessionStore({ operation: "write_messages", messages });
|
|
39
|
+
},
|
|
40
|
+
async appendMessage(role, content) {
|
|
41
|
+
const resp = await sessionStore({ operation: "append_message", role, content });
|
|
42
|
+
// A refused append (a blank role) says so, as a failed write would.
|
|
43
|
+
if (pick(resp, "success", "Success") === false) throw new Error(sessionStoreRefusedAppend(role));
|
|
44
|
+
},
|
|
45
|
+
async reset() {
|
|
46
|
+
return count(await sessionStore({ operation: "reset" }), "removed_count", "removedCount", "RemovedCount");
|
|
47
|
+
},
|
|
48
|
+
async snip(turns) {
|
|
49
|
+
// retain_count counts turns (Orkeon #287); kept_from (where the kept tail began) is not read: nothing uses it.
|
|
50
|
+
const resp = await tools.sessionSnip({ retain_count: turns });
|
|
51
|
+
return {
|
|
52
|
+
removed: count(resp, "removed_count", "removedCount", "RemovedCount"),
|
|
53
|
+
retained: count(resp, "retained_count", "retainedCount", "RetainedCount"),
|
|
54
|
+
};
|
|
55
|
+
},
|
|
56
|
+
async setTitle(title) {
|
|
57
|
+
await sessionStore({ operation: "set_title", title });
|
|
58
|
+
},
|
|
59
|
+
async readState(key) {
|
|
60
|
+
const resp = await withToolMessage(() => sessionStore({ operation: "get_state", key }));
|
|
61
|
+
const v = pick(resp, "value", "Value");
|
|
62
|
+
return v == null ? null : String(v);
|
|
63
|
+
},
|
|
64
|
+
async readStates(keys) {
|
|
65
|
+
if (keys.length === 0) return {};
|
|
66
|
+
const resp = await withToolMessage(() => sessionStore({ operation: "get_state", keys }));
|
|
67
|
+
// A key never set is absent from `values` (the tool pipeline drops nulls): null here.
|
|
68
|
+
const values = pick(resp, "values", "Values");
|
|
69
|
+
const out: Record<string, string | null> = {};
|
|
70
|
+
for (const key of keys) {
|
|
71
|
+
const v = values !== null && typeof values === "object" ? (values as Record<string, unknown>)[key] : undefined;
|
|
72
|
+
out[key] = v == null ? null : String(v);
|
|
73
|
+
}
|
|
74
|
+
return out;
|
|
75
|
+
},
|
|
76
|
+
async writeState(key, value) {
|
|
77
|
+
await sessionStore({ operation: "set_state", key, value });
|
|
78
|
+
},
|
|
79
|
+
async readBudget() {
|
|
80
|
+
const b = await tools.tokenBudget();
|
|
81
|
+
const budget: TokenBudget = {
|
|
82
|
+
used: count(b, "used_tokens", "usedTokens"),
|
|
83
|
+
window: count(b, "context_window_tokens", "contextWindowTokens"),
|
|
84
|
+
};
|
|
85
|
+
// By kind since Orkeon #226; an older host reports none.
|
|
86
|
+
const kinds = pick(b, "used_tokens_by_kind", "usedTokensByKind");
|
|
87
|
+
if (kinds !== undefined && kinds !== null && typeof kinds === "object") {
|
|
88
|
+
const kind = (name: keyof TokenKinds) => count(kinds, name, name[0].toUpperCase() + name.slice(1));
|
|
89
|
+
budget.byKind = { system: kind("system"), user: kind("user"), assistant: kind("assistant"), tool: kind("tool"), other: kind("other") };
|
|
90
|
+
}
|
|
91
|
+
return budget;
|
|
92
|
+
},
|
|
93
|
+
};
|
|
94
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
// SessionSwitch adapter over the command context's `session` service (Orkeon #227): the session
|
|
2
|
+
// saved now, a saved one loaded in place. The service is there while orkeon-repl persists the session
|
|
3
|
+
// per project (Orkeon:Cli:Session:Persist, its default); a host without it leaves the reader nothing to
|
|
4
|
+
// hand out, and /resume says so. Reached through the service locator each command receives.
|
|
5
|
+
|
|
6
|
+
import type { SessionSwitch } from "../../application/ports.ts";
|
|
7
|
+
import type { SessionFacade, ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
|
|
8
|
+
|
|
9
|
+
/** The service name; orkeon-repl registers it while the session is persisted. */
|
|
10
|
+
const SESSION = "session";
|
|
11
|
+
|
|
12
|
+
export function createSessionSwitch(services: Pick<ServiceLocator, "get" | "has">): SessionSwitch | undefined {
|
|
13
|
+
if (!services.has(SESSION)) return undefined;
|
|
14
|
+
const facade = services.get<SessionFacade>(SESSION);
|
|
15
|
+
return {
|
|
16
|
+
async save(path?: string) {
|
|
17
|
+
return String(await (path === undefined ? facade.save() : facade.save(path)));
|
|
18
|
+
},
|
|
19
|
+
async load(path: string) {
|
|
20
|
+
return Number(await facade.load(path));
|
|
21
|
+
},
|
|
22
|
+
};
|
|
23
|
+
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
|
|
2
|
+
// SharedMemory adapter: the RAG index of the shared memory over the runtime's `rag` namespace
|
|
3
|
+
// (retrieve: the passages without a generated answer, so no model call; ingest with prune), and
|
|
4
|
+
// over the rag_search / rag_ingest tools when the host declares no `rag` namespace. A file the
|
|
5
|
+
// index cut into several passages comes back once, with its best score.
|
|
6
|
+
|
|
7
|
+
import type { SharedHit, SharedIngest, SharedMemory } from "../../application/ports.ts";
|
|
8
|
+
import { asArray, pick } from "./tool-results.ts";
|
|
9
|
+
|
|
10
|
+
/** What this adapter calls of the runtime's `rag` namespace. */
|
|
11
|
+
export interface RagApi {
|
|
12
|
+
retrieve(question: string, options: { collection: string; topN?: number }): Promise<{ citations: readonly unknown[] }>;
|
|
13
|
+
ingest(options: {
|
|
14
|
+
collection: string; sources: readonly string[]; chunkingStrategy?: string; prune?: boolean;
|
|
15
|
+
}): Promise<unknown>;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/** The entries are cut on their headings (## Context, ## Content, ## Evidence). */
|
|
19
|
+
export const MEMORY_CHUNKING = "structural";
|
|
20
|
+
|
|
21
|
+
function bestPerSource(citations: readonly unknown[]): SharedHit[] {
|
|
22
|
+
const best = new Map<string, number>();
|
|
23
|
+
for (const c of citations) {
|
|
24
|
+
const sourceId = String(pick(c, "sourceId", "source_id", "SourceId") ?? "");
|
|
25
|
+
const score = Number(pick(c, "score", "Score") ?? 0);
|
|
26
|
+
if (sourceId === "") continue;
|
|
27
|
+
if (!best.has(sourceId) || score > (best.get(sourceId) as number)) best.set(sourceId, score);
|
|
28
|
+
}
|
|
29
|
+
return [...best].map(([sourceId, score]) => ({ sourceId, score })).sort((a, b) => b.score - a.score);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
const count = (report: unknown, ...names: string[]): number => Number(pick(report, ...names) ?? 0);
|
|
33
|
+
|
|
34
|
+
function ingestOf(report: unknown): SharedIngest {
|
|
35
|
+
return {
|
|
36
|
+
added: count(report, "sourcesAdded", "sources_added", "SourcesAdded"),
|
|
37
|
+
reingested: count(report, "sourcesReingested", "sources_reingested", "SourcesReingested"),
|
|
38
|
+
unchanged: count(report, "sourcesUnchanged", "sources_unchanged", "SourcesUnchanged"),
|
|
39
|
+
pruned: count(report, "sourcesPruned", "sources_pruned", "SourcesPruned"),
|
|
40
|
+
errors: asArray(pick(report, "errors", "Errors")).map(String),
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export function createSharedMemory(
|
|
45
|
+
rag: RagApi | undefined, tools: Pick<OrkeonTools, "ragSearch" | "ragIngest">,
|
|
46
|
+
): SharedMemory {
|
|
47
|
+
return {
|
|
48
|
+
async search(collection, query, topN) {
|
|
49
|
+
const citations = rag !== undefined
|
|
50
|
+
? (await rag.retrieve(query, { collection, topN })).citations
|
|
51
|
+
: asArray(pick(await tools.ragSearch({ collection, question: query, top_k: topN }), "citations", "Citations"));
|
|
52
|
+
return bestPerSource(citations);
|
|
53
|
+
},
|
|
54
|
+
async ingest(collection, sources, options) {
|
|
55
|
+
const report = rag !== undefined
|
|
56
|
+
? await rag.ingest({ collection, sources, chunkingStrategy: MEMORY_CHUNKING, prune: options.prune })
|
|
57
|
+
: await tools.ragIngest({ collection, sources: [...sources], chunking_strategy: MEMORY_CHUNKING, prune: options.prune });
|
|
58
|
+
return ingestOf(report);
|
|
59
|
+
},
|
|
60
|
+
};
|
|
61
|
+
}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
// ShellJobs adapter: shell_command's job actions (start_job, job_status, job_tail),
|
|
2
|
+
// pinned to /workspace like the Shell adapter. The runtime's schema asks for
|
|
3
|
+
// `command` on every action: it is always passed (the command itself to start a job,
|
|
4
|
+
// an empty one to read it). A job lives in the running crew's agent run and is
|
|
5
|
+
// stopped when that run ends; a call the runtime refuses throws.
|
|
6
|
+
//
|
|
7
|
+
// The script host has no timer: `wait` runs a small node script that sleeps the
|
|
8
|
+
// given seconds (`.orkeon/dev/bin/wait.mjs`, written at the first wait). Without
|
|
9
|
+
// node or interpreters, that run fails once and every later wait says false at once,
|
|
10
|
+
// so the caller falls back to a blocking run.
|
|
11
|
+
//
|
|
12
|
+
// Given a batch's working root, the jobs run there, as the Shell adapter's commands do; given the host's context,
|
|
13
|
+
// the command's and the tail's disk spellings come back to the VFS as the Shell adapter's do.
|
|
14
|
+
|
|
15
|
+
import type { ShellJobs } from "../../application/ports.ts";
|
|
16
|
+
import type { HostSource } from "../../application/host-context.ts";
|
|
17
|
+
import { textFromRoot, textToRoot } from "../../domain/dev/path-rebase.ts";
|
|
18
|
+
import { commandToVirtual, textToVirtual } from "../../domain/host-paths.ts";
|
|
19
|
+
import { layoutOf } from "./host-context.ts";
|
|
20
|
+
import { pick, shCode } from "./tool-results.ts";
|
|
21
|
+
import { WORKSPACE } from "../../domain/vfs.ts";
|
|
22
|
+
import { SHELL_JOB_NEEDS_COMMAND, noJobIdFor, waitNotWholeSeconds } from "./messages.ts";
|
|
23
|
+
|
|
24
|
+
/** The waiting script, relative to /workspace, and its virtual path. */
|
|
25
|
+
export const WAIT_SCRIPT = ".orkeon/dev/bin/wait.mjs";
|
|
26
|
+
const WAIT_SCRIPT_CONTENT =
|
|
27
|
+
"// Written by Orkeon Code's dev-implement crew: sleeps argv[2] seconds (the script host has no timer).\n" +
|
|
28
|
+
"const seconds = Number(process.argv[2]);\n" +
|
|
29
|
+
"setTimeout(() => {}, Number.isFinite(seconds) && seconds > 0 ? seconds * 1000 : 0);\n";
|
|
30
|
+
/** job_tail's own ceiling. */
|
|
31
|
+
const MAX_TAIL_LINES = 500;
|
|
32
|
+
|
|
33
|
+
export function createShellJobs(tools: Pick<OrkeonTools, "shellCommand" | "fileWrite">, root?: string, host?: HostSource): ShellJobs {
|
|
34
|
+
const cwd = root ?? WORKSPACE;
|
|
35
|
+
let waiter: "unknown" | "ready" | "absent" = "unknown";
|
|
36
|
+
return {
|
|
37
|
+
async start(command) {
|
|
38
|
+
if (command.trim() === "") throw new Error(SHELL_JOB_NEEDS_COMMAND);
|
|
39
|
+
const virtual = commandToVirtual(command, await layoutOf(host));
|
|
40
|
+
const r = await tools.shellCommand({ action: "start_job", command: textToRoot(virtual, root), working_directory: cwd });
|
|
41
|
+
const id = String(pick(r, "job_id", "jobId", "JobId") ?? "");
|
|
42
|
+
if (id === "") throw new Error(noJobIdFor(command));
|
|
43
|
+
return { id, log: String(pick(r, "output_path", "outputPath", "OutputPath") ?? "") };
|
|
44
|
+
},
|
|
45
|
+
async status(id) {
|
|
46
|
+
const r = await tools.shellCommand({ action: "job_status", command: "", job_id: id, working_directory: cwd });
|
|
47
|
+
const status = String(pick(r, "status", "Status") ?? "");
|
|
48
|
+
return { running: status === "running", exitCode: status === "running" ? -1 : shCode(r) };
|
|
49
|
+
},
|
|
50
|
+
async tail(id, lines) {
|
|
51
|
+
const count = Math.max(1, Math.min(MAX_TAIL_LINES, Math.floor(lines)));
|
|
52
|
+
const r = await tools.shellCommand({
|
|
53
|
+
action: "job_tail", command: "", job_id: id, tail_lines: count, working_directory: cwd,
|
|
54
|
+
});
|
|
55
|
+
return textFromRoot(textToVirtual(String(pick(r, "tail", "Tail") ?? ""), await layoutOf(host)), root);
|
|
56
|
+
},
|
|
57
|
+
async wait(seconds) {
|
|
58
|
+
if (!(Number.isInteger(seconds) && seconds >= 1)) {
|
|
59
|
+
throw new Error(waitNotWholeSeconds(seconds));
|
|
60
|
+
}
|
|
61
|
+
if (waiter === "absent") return false;
|
|
62
|
+
try {
|
|
63
|
+
if (waiter === "unknown") {
|
|
64
|
+
await tools.fileWrite({ path: `${cwd}/${WAIT_SCRIPT}`, content: WAIT_SCRIPT_CONTENT });
|
|
65
|
+
}
|
|
66
|
+
const r = await tools.shellCommand({
|
|
67
|
+
command: `node ${WAIT_SCRIPT} ${seconds}`, working_directory: cwd, timeout_seconds: seconds + 30,
|
|
68
|
+
});
|
|
69
|
+
if (shCode(r) !== 0) {
|
|
70
|
+
waiter = "absent";
|
|
71
|
+
return false;
|
|
72
|
+
}
|
|
73
|
+
waiter = "ready";
|
|
74
|
+
return true;
|
|
75
|
+
} catch {
|
|
76
|
+
waiter = "absent";
|
|
77
|
+
return false;
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
};
|
|
81
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
// Shell adapter: shell_command pinned to the /workspace cwd the VFS mounts
|
|
2
|
+
// (SPEC §9.4), its result read once, whatever its casing. A timeout goes to the
|
|
3
|
+
// runtime's own `timeout_seconds`; a result with `completed: false` is read as a
|
|
4
|
+
// command stopped at that timeout (the typings give the field, not its meaning).
|
|
5
|
+
// Given a batch's working root, the command runs there: its `/workspace` paths go
|
|
6
|
+
// onto the root, and the root's paths of its output come back as `/workspace`, so the
|
|
7
|
+
// callers keep naming the checkout `/workspace` (shared/domain/dev/path-rebase.ts). Given the host's context, a
|
|
8
|
+
// path the command spells as the disk does comes back to the VFS before the run, and the disk spellings the process
|
|
9
|
+
// printed come back the same way (shared/domain/host-paths.ts), the host's layer outside the root's.
|
|
10
|
+
|
|
11
|
+
import type { Shell } from "../../application/ports.ts";
|
|
12
|
+
import type { HostSource } from "../../application/host-context.ts";
|
|
13
|
+
import { textFromRoot, textToRoot } from "../../domain/dev/path-rebase.ts";
|
|
14
|
+
import { commandToVirtual, textToVirtual } from "../../domain/host-paths.ts";
|
|
15
|
+
import { layoutOf } from "./host-context.ts";
|
|
16
|
+
import { pick, shCode, shErr, shOut } from "./tool-results.ts";
|
|
17
|
+
import { WORKSPACE } from "../../domain/vfs.ts";
|
|
18
|
+
import { timeoutNotWholeSeconds } from "./messages.ts";
|
|
19
|
+
|
|
20
|
+
export function createShell(tools: Pick<OrkeonTools, "shellCommand">, root?: string, host?: HostSource): Shell {
|
|
21
|
+
const cwd = root ?? WORKSPACE;
|
|
22
|
+
return {
|
|
23
|
+
async run(logical, options) {
|
|
24
|
+
const layout = await layoutOf(host);
|
|
25
|
+
const command = textToRoot(commandToVirtual(logical, layout), root);
|
|
26
|
+
const timeout = options?.timeoutSeconds;
|
|
27
|
+
if (timeout !== undefined && !(Number.isInteger(timeout) && timeout >= 1)) {
|
|
28
|
+
throw new Error(timeoutNotWholeSeconds(timeout));
|
|
29
|
+
}
|
|
30
|
+
const input = timeout === undefined
|
|
31
|
+
? { command, working_directory: cwd }
|
|
32
|
+
: { command, working_directory: cwd, timeout_seconds: timeout };
|
|
33
|
+
const r = await tools.shellCommand(input);
|
|
34
|
+
const back = (text: string) => textFromRoot(textToVirtual(text, layout), root);
|
|
35
|
+
const result = { stdout: back(shOut(r)), stderr: back(shErr(r)), exitCode: shCode(r) };
|
|
36
|
+
return pick(r, "completed", "Completed") === false ? { ...result, timedOut: true } : result;
|
|
37
|
+
},
|
|
38
|
+
};
|
|
39
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
// Telemetry adapter over session_store get_metadata, session_cost and
|
|
2
|
+
// session_stats (its prompt, completion, cache read and write and reasoning tokens summed over by_model_tokens; a
|
|
3
|
+
// count a model did not report is absent or null, left out of the sum, never read as 0). The counters come back snake_case (or camelCase) and the
|
|
4
|
+
// metadata PascalCase from the .NET record: this is the one place that reads
|
|
5
|
+
// either casing, and the one place that turns the values into numbers and strings.
|
|
6
|
+
|
|
7
|
+
import type { SessionCost, SessionMetadata, SessionStats, Telemetry } from "../../application/ports.ts";
|
|
8
|
+
import type { SessionStoreInput } from "./runtime-tools.ts";
|
|
9
|
+
import { normalizeModelList } from "../../domain/model-catalog.ts";
|
|
10
|
+
import { asArray, pick } from "./tool-results.ts";
|
|
11
|
+
|
|
12
|
+
/** A reported number; null and absent both read as unreported. */
|
|
13
|
+
const num = (v: unknown): number | undefined => (v == null ? undefined : Number(v));
|
|
14
|
+
/** A reported string; null and absent both read as unreported. */
|
|
15
|
+
const str = (v: unknown): string | undefined => (v == null ? undefined : String(v));
|
|
16
|
+
|
|
17
|
+
function costOf(r: unknown): SessionCost {
|
|
18
|
+
return {
|
|
19
|
+
costUsd: num(pick(r, "total_cost_usd", "totalCostUsd")),
|
|
20
|
+
totalTokens: num(pick(r, "total_tokens", "totalTokens")),
|
|
21
|
+
totalCalls: num(pick(r, "total_calls", "totalCalls")),
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** The sum of one count over `by_model_tokens`, undefined when no entry reports it. */
|
|
26
|
+
function modelSum(entries: readonly unknown[], ...names: string[]): number | undefined {
|
|
27
|
+
const counts = entries.map((e) => num(pick(e, ...names))).filter((n): n is number => n !== undefined);
|
|
28
|
+
return counts.length > 0 ? counts.reduce((a, b) => a + b, 0) : undefined;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function createTelemetry(tools: Pick<OrkeonTools, "sessionStore" | "sessionCost" | "sessionStats">): Telemetry {
|
|
32
|
+
return {
|
|
33
|
+
async readMetadata(): Promise<SessionMetadata> {
|
|
34
|
+
const md = pick(await tools.sessionStore({ operation: "get_metadata" } satisfies SessionStoreInput), "metadata", "Metadata");
|
|
35
|
+
return {
|
|
36
|
+
title: str(pick(md, "title", "Title")),
|
|
37
|
+
model: str(pick(md, "model", "Model")),
|
|
38
|
+
messageCount: num(pick(md, "messageCount", "MessageCount", "message_count")),
|
|
39
|
+
estimatedTokens: num(pick(md, "estimatedTokens", "EstimatedTokens")),
|
|
40
|
+
availableModels: normalizeModelList(pick(md, "available_models", "availableModels", "AvailableModels")),
|
|
41
|
+
};
|
|
42
|
+
},
|
|
43
|
+
async readCost(): Promise<SessionCost> {
|
|
44
|
+
return costOf(await tools.sessionCost());
|
|
45
|
+
},
|
|
46
|
+
async readStats(): Promise<SessionStats> {
|
|
47
|
+
const s = await tools.sessionStats();
|
|
48
|
+
// The counts per model (RT-12); an older host reported the cache hits alone, in one figure.
|
|
49
|
+
const byModel = asArray(pick(s, "by_model_tokens", "byModelTokens"));
|
|
50
|
+
return {
|
|
51
|
+
...costOf(s),
|
|
52
|
+
messageCount: num(pick(s, "message_count", "messageCount")),
|
|
53
|
+
estimatedTokens: num(pick(s, "estimated_tokens", "estimatedTokens")),
|
|
54
|
+
promptTokens: modelSum(byModel, "prompt_tokens", "promptTokens"),
|
|
55
|
+
completionTokens: modelSum(byModel, "completion_tokens", "completionTokens"),
|
|
56
|
+
cacheHitTokens: modelSum(byModel, "cache_read_tokens", "cacheReadTokens")
|
|
57
|
+
?? num(pick(s, "prompt_cache_hit_tokens", "promptCacheHitTokens", "cache_hit_tokens")),
|
|
58
|
+
cacheWriteTokens: modelSum(byModel, "cache_write_tokens", "cacheWriteTokens"),
|
|
59
|
+
reasoningTokens: modelSum(byModel, "reasoning_tokens", "reasoningTokens"),
|
|
60
|
+
};
|
|
61
|
+
},
|
|
62
|
+
};
|
|
63
|
+
}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
// ToolCatalogue adapter. The names are the registered ones, read from the host's
|
|
2
|
+
// `tools` service (ctx.services.get("tools"): the registered tools, each with its
|
|
3
|
+
// `Name`), and matched case-insensitively, as Orkeon matches an agent's
|
|
4
|
+
// `.tools([...])`. The calls go through the runtime's `tools` namespace, which
|
|
5
|
+
// exposes each tool as a camelCase member (file_read → tools.fileRead): a member
|
|
6
|
+
// cannot give the registered name back (`get-file-contents`, `get_file_contents`
|
|
7
|
+
// and `getFileContents` are all `getFileContents`). `call` passes a result through
|
|
8
|
+
// raw: /debug-tool-call exists to show it as the tool returned it; `callText`
|
|
9
|
+
// decodes it (tool-results.ts), for the callers that read its text.
|
|
10
|
+
|
|
11
|
+
import type { ToolCatalogue } from "../../application/ports.ts";
|
|
12
|
+
import type { ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
|
|
13
|
+
import { asArray, pick, toolOutcome } from "./tool-results.ts";
|
|
14
|
+
import { noRegisteredTool } from "./messages.ts";
|
|
15
|
+
|
|
16
|
+
/** The service that hands out the registered tools. */
|
|
17
|
+
const TOOLS = "tools";
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* `file_read` → `fileRead`: the tools namespace exposes camelCase members, built
|
|
21
|
+
* as the runtime builds them (ToolsNamespaceBinding.ToCamelCase): `_` and `-` are
|
|
22
|
+
* dropped and raise the next letter, the first letter is lowered — so an MCP
|
|
23
|
+
* server's `search-issues` is `searchIssues` too.
|
|
24
|
+
*/
|
|
25
|
+
export function toolMemberName(name: string): string {
|
|
26
|
+
let member = "";
|
|
27
|
+
let raise = false;
|
|
28
|
+
for (const c of name) {
|
|
29
|
+
if (c === "_" || c === "-") {
|
|
30
|
+
raise = member.length > 0;
|
|
31
|
+
continue;
|
|
32
|
+
}
|
|
33
|
+
member += raise ? c.toUpperCase() : c;
|
|
34
|
+
raise = false;
|
|
35
|
+
}
|
|
36
|
+
return member.charAt(0).toLowerCase() + member.slice(1);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** The names of the tools the service hands out (IBaseTool[], each with its `Name`). */
|
|
40
|
+
function registeredNames(services: Pick<ServiceLocator, "get">): string[] {
|
|
41
|
+
return asArray(services.get<unknown>(TOOLS))
|
|
42
|
+
.map((tool) => String(pick(tool, "Name", "name") ?? ""))
|
|
43
|
+
.filter((name) => name.length > 0);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* The calls alone, by registered name, through the tools namespace: what a crew
|
|
48
|
+
* gets, since it has no `tools` service to list the names. The launching command
|
|
49
|
+
* found the registered name already (a ToolCatalogue's `find`).
|
|
50
|
+
*/
|
|
51
|
+
export function createToolCalls(tools: object): Pick<ToolCatalogue, "call" | "callText"> {
|
|
52
|
+
const call = async (name: string, args: Record<string, unknown>): Promise<unknown> => {
|
|
53
|
+
const fn = (tools as Record<string, unknown> | undefined)?.[toolMemberName(name)];
|
|
54
|
+
if (typeof fn !== "function") throw new Error(noRegisteredTool(name));
|
|
55
|
+
return (fn as (input: Record<string, unknown>) => unknown)(args);
|
|
56
|
+
};
|
|
57
|
+
return { call, callText: (name, args) => toolOutcome(() => call(name, args)) };
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
export function createToolCatalogue(tools: object, services: Pick<ServiceLocator, "get">): ToolCatalogue {
|
|
61
|
+
const find = (name: string): string | undefined => {
|
|
62
|
+
const wanted = name.toLowerCase();
|
|
63
|
+
return registeredNames(services).find((registered) => registered.toLowerCase() === wanted);
|
|
64
|
+
};
|
|
65
|
+
const call = async (name: string, args: Record<string, unknown>): Promise<unknown> => {
|
|
66
|
+
const registered = find(name);
|
|
67
|
+
if (registered === undefined) throw new Error(noRegisteredTool(name));
|
|
68
|
+
return createToolCalls(tools).call(registered, args);
|
|
69
|
+
};
|
|
70
|
+
return {
|
|
71
|
+
names: () => registeredNames(services).sort(),
|
|
72
|
+
find,
|
|
73
|
+
call,
|
|
74
|
+
callText: (name, args) => toolOutcome(() => call(name, args)),
|
|
75
|
+
};
|
|
76
|
+
}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
// Normaliser for tool results whose property casing varies — .NET-bridged CLR
|
|
2
|
+
// types come back PascalCase, pure-JS tools camel/snake_case. Centralises the
|
|
3
|
+
// `r.stdout ?? r.Stdout` / `pick(...,"messages","Messages")` dual-casing that
|
|
4
|
+
// was duplicated inline across every crew (git-commit:14-16, code-review:12,
|
|
5
|
+
// project-init:9, session-compact:10, init-verifiers:10). Pure — no IO. The
|
|
6
|
+
// adapters of this folder read every result through it, and the failures of a
|
|
7
|
+
// tool call: the runtime wraps the tool's own message, which is all a user reads.
|
|
8
|
+
//
|
|
9
|
+
// Run tests: node --test src/shared/infrastructure/orkeon/tool-results.test.ts
|
|
10
|
+
|
|
11
|
+
import type { ToolOutcome } from "../../application/ports.ts";
|
|
12
|
+
import { errorText } from "../../domain/prelude.ts";
|
|
13
|
+
|
|
14
|
+
/** First defined property among the given candidate names (any casing). */
|
|
15
|
+
export function pick(obj: any, ...names: string[]): any {
|
|
16
|
+
if (!obj) return undefined;
|
|
17
|
+
for (const n of names) {
|
|
18
|
+
if (obj[n] !== undefined) return obj[n];
|
|
19
|
+
}
|
|
20
|
+
return undefined;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** `stdout` of a shell_command result (snake or Pascal), as a string. */
|
|
24
|
+
export function shOut(r: any): string {
|
|
25
|
+
return String(pick(r, "stdout", "Stdout") ?? "");
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** `stderr` of a shell_command result (snake or Pascal), as a string. */
|
|
29
|
+
export function shErr(r: any): string {
|
|
30
|
+
return String(pick(r, "stderr", "Stderr") ?? "");
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** `exit_code` of a shell_command result (snake/camel/Pascal); -1 if absent. */
|
|
34
|
+
export function shCode(r: any): number {
|
|
35
|
+
return Number(pick(r, "exit_code", "exitCode", "ExitCode") ?? -1);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** `content` / `text` of a file_read result (snake or Pascal), as a string; a
|
|
39
|
+
* result that is itself a string is the content. */
|
|
40
|
+
export function fileContent(r: any): string {
|
|
41
|
+
if (typeof r === "string") return r;
|
|
42
|
+
return String(pick(r, "content", "Content", "text", "Text") ?? "");
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** Coerce a value to an array (returns [] for null/undefined/non-array). */
|
|
46
|
+
export function asArray<T = any>(v: any): T[] {
|
|
47
|
+
return Array.isArray(v) ? (v as T[]) : [];
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Entry names from a directory_read result. The real tool shape is
|
|
52
|
+
* `{ Files: [{Name,Path}], Directories: [{Name,Path}] }`; the older
|
|
53
|
+
* `{ entries|Entries|items }` shape is tolerated too. Names + casing vary.
|
|
54
|
+
*/
|
|
55
|
+
export function entryNames(listing: any): string[] {
|
|
56
|
+
const files = asArray(pick(listing, "files", "Files"));
|
|
57
|
+
const dirs = asArray(pick(listing, "directories", "Directories"));
|
|
58
|
+
const legacy = asArray(pick(listing, "entries", "Entries", "items"));
|
|
59
|
+
return [...files, ...dirs, ...legacy].map((e: any) =>
|
|
60
|
+
String(pick(e, "name", "Name", "path", "Path") ?? e));
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** A tool result as text: a string as it is; else the first string field among
|
|
64
|
+
* text, content and result (either case); else its JSON; nothing for no result. */
|
|
65
|
+
export function resultText(raw: unknown): string {
|
|
66
|
+
if (typeof raw === "string") return raw;
|
|
67
|
+
if (raw === null || raw === undefined) return "";
|
|
68
|
+
if (typeof raw === "object") {
|
|
69
|
+
for (const key of ["text", "content", "result", "Text", "Content", "Result"]) {
|
|
70
|
+
const field = (raw as Record<string, unknown>)[key];
|
|
71
|
+
if (typeof field === "string") return field;
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return JSON.stringify(raw);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* A failed tool call as the tool's own message, every line of it: without what the runtime
|
|
79
|
+
* wraps it in ("One or more errors occurred. (tools.transcribeAudio failed [path=…]: Error
|
|
80
|
+
* executing tool transcribe_audio: …)") nor the host's inner exception (" ---> System.…").
|
|
81
|
+
* Callers that look for "not found" in it read the tool's whole message.
|
|
82
|
+
*/
|
|
83
|
+
export function ownMessage(error: unknown): string {
|
|
84
|
+
let text = (error instanceof Error ? error.message : String(error)).trim();
|
|
85
|
+
const executing = /Error executing tool [\w.-]+:\s*([\s\S]*)$/.exec(text);
|
|
86
|
+
const failed = /tools\.\w+ failed \[[^\]]*\]:\s*([\s\S]*)$/.exec(text);
|
|
87
|
+
if (executing) text = executing[1];
|
|
88
|
+
else if (failed) text = failed[1];
|
|
89
|
+
const inner = text.indexOf("\n --->");
|
|
90
|
+
if (inner >= 0) text = text.slice(0, inner);
|
|
91
|
+
text = text.trim();
|
|
92
|
+
const count = (c: string) => text.split(c).length - 1;
|
|
93
|
+
while (text.endsWith(")") && count(")") > count("(")) text = text.slice(0, -1);
|
|
94
|
+
return text.trim();
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/** A failed tool call as one readable line: the first line of its own message (ownMessage). */
|
|
98
|
+
export function failureText(error: unknown): string {
|
|
99
|
+
return errorText(ownMessage(error));
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/** A call read as text: its result's text, or its failure's own message. Never throws. */
|
|
103
|
+
export async function toolOutcome(call: () => Promise<unknown>): Promise<ToolOutcome> {
|
|
104
|
+
try {
|
|
105
|
+
return { ok: true, text: resultText(await call()) };
|
|
106
|
+
} catch (error) {
|
|
107
|
+
return { ok: false, failure: failureText(error) };
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** A call whose failure is rethrown with the tool's own message, every line kept (ownMessage):
|
|
112
|
+
* a caller tells an absent file by it, and what it shows of it (errorText, the first line)
|
|
113
|
+
* reads the same as a failed tool call. */
|
|
114
|
+
export async function withToolMessage<T>(call: () => Promise<T> | T): Promise<T> {
|
|
115
|
+
try {
|
|
116
|
+
return await call();
|
|
117
|
+
} catch (error) {
|
|
118
|
+
throw new Error(ownMessage(error));
|
|
119
|
+
}
|
|
120
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
// UsageReader adapter over the command context's `usage` service (Orkeon #226): the session's LLM
|
|
2
|
+
// usage, in total and by model and by command, as the host's cost manager accounts it. Reached
|
|
3
|
+
// through the service locator each command receives, like the approvals; a host that keeps no
|
|
4
|
+
// account registers no service and the reader answers nothing. Jint keeps the CLR member names on a
|
|
5
|
+
// host object, so both casings are read, and every count is made a number here. A cache or reasoning count no
|
|
6
|
+
// call reported is null or absent (Orkeon #254): it stays null, never read as 0.
|
|
7
|
+
|
|
8
|
+
import type { CommandUsage, ModelUsage, UsageReader, UsageReport, UsageSpent } from "../../application/ports.ts";
|
|
9
|
+
import type { SessionUsage, ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
|
|
10
|
+
import { asArray, pick } from "./tool-results.ts";
|
|
11
|
+
|
|
12
|
+
/** The service name; orkeon-repl registers it while it keeps a cost manager or command instances. */
|
|
13
|
+
const USAGE = "usage";
|
|
14
|
+
|
|
15
|
+
const field = (r: unknown, name: string): unknown => pick(r, name, name[0].toUpperCase() + name.slice(1));
|
|
16
|
+
|
|
17
|
+
/** A reported count, as a number; absent reads as 0. */
|
|
18
|
+
const count = (r: unknown, name: string): number => Number(field(r, name) ?? 0) || 0;
|
|
19
|
+
|
|
20
|
+
/** A count the host may leave unmeasured: null and absent read as null, a measured 0 as 0. */
|
|
21
|
+
function measured(r: unknown, name: string): number | null {
|
|
22
|
+
const v = field(r, name);
|
|
23
|
+
if (v == null) return null;
|
|
24
|
+
const n = Number(v);
|
|
25
|
+
return Number.isFinite(n) ? n : null;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** A reported cost; null, absent and a non-number all read as unpriced. */
|
|
29
|
+
function costOf(r: unknown): number | null {
|
|
30
|
+
const v = pick(r, "cost", "Cost");
|
|
31
|
+
return typeof v === "number" && Number.isFinite(v) ? v : null;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function spentOf(r: unknown): UsageSpent {
|
|
35
|
+
return {
|
|
36
|
+
promptTokens: count(r, "promptTokens"),
|
|
37
|
+
completionTokens: count(r, "completionTokens"),
|
|
38
|
+
cacheHitTokens: measured(r, "cacheHitTokens"),
|
|
39
|
+
cacheWriteTokens: measured(r, "cacheWriteTokens"),
|
|
40
|
+
reasoningTokens: measured(r, "reasoningTokens"),
|
|
41
|
+
calls: count(r, "calls"),
|
|
42
|
+
unpricedCalls: count(r, "unpricedCalls"),
|
|
43
|
+
cost: costOf(r),
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const text = (r: unknown, name: string): string => String(field(r, name) ?? "");
|
|
48
|
+
|
|
49
|
+
function modelOf(r: unknown): ModelUsage {
|
|
50
|
+
return { ...spentOf(r), model: text(r, "model") };
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function commandOf(r: unknown): CommandUsage {
|
|
54
|
+
return { ...spentOf(r), ticket: text(r, "ticket"), name: text(r, "name"), state: text(r, "state") };
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export function createUsageReader(services: Pick<ServiceLocator, "get" | "has">): UsageReader {
|
|
58
|
+
return {
|
|
59
|
+
report(): UsageReport | undefined {
|
|
60
|
+
try {
|
|
61
|
+
if (!services.has(USAGE)) return undefined;
|
|
62
|
+
const r = services.get<SessionUsage>(USAGE).report();
|
|
63
|
+
return {
|
|
64
|
+
...spentOf(r),
|
|
65
|
+
totalTokens: count(r, "totalTokens"),
|
|
66
|
+
byModel: asArray(pick(r, "byModel", "ByModel")).map(modelOf),
|
|
67
|
+
byCommand: asArray(pick(r, "byCommand", "ByCommand")).map(commandOf),
|
|
68
|
+
};
|
|
69
|
+
} catch {
|
|
70
|
+
return undefined;
|
|
71
|
+
}
|
|
72
|
+
},
|
|
73
|
+
};
|
|
74
|
+
}
|