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,338 @@
|
|
|
1
|
+
// Prompt assembly for the main-loop act() turn — pure, no IO.
|
|
2
|
+
// Assembles the three messages of a turn. The static header (behaviour rules, tools,
|
|
3
|
+
// search playbook, the project's instructions file) is the SYSTEM prompt
|
|
4
|
+
// (`ActOptions.system`, a real `role:"system"` message). The volatile blocks
|
|
5
|
+
// (preferences, skills, memory, hooks, environment, history, gauge) are the CONTEXT
|
|
6
|
+
// (`ActOptions.context`, a user message of its own, Orkeon #276), in a fixed order;
|
|
7
|
+
// the request with its permission note is the prompt, the last user message. The
|
|
8
|
+
// system prompt is the absolute request prefix a provider caches, so it must be
|
|
9
|
+
// byte-identical turn after turn — no timestamps, no counters, no gauges; everything
|
|
10
|
+
// volatile goes in the context.
|
|
11
|
+
//
|
|
12
|
+
// The text of every block is written from the behaviour specification in
|
|
13
|
+
// docs/turn.md, "Prompt assembly" (ADR 0003).
|
|
14
|
+
//
|
|
15
|
+
// Run tests: node --test tests/crews/main-loop/domain/prompt-assembly.test.ts
|
|
16
|
+
|
|
17
|
+
import type { SessionMsg } from "../../../shared/domain/types.ts";
|
|
18
|
+
import { MEMORY_CATEGORIES } from "../../../shared/domain/agent-policy/memory-categories.ts";
|
|
19
|
+
import { isOutputStyle } from "../../../shared/domain/agent-policy/output-styles.ts";
|
|
20
|
+
import { pressureTier } from "../../../shared/domain/compaction-thresholds.ts";
|
|
21
|
+
import type { InstructionsFile } from "../../../shared/domain/instructions-file.ts";
|
|
22
|
+
import { isCompactBoundary } from "../../../shared/domain/compaction.ts";
|
|
23
|
+
import { isMarkedMessage } from "../../../shared/domain/marked-message.ts";
|
|
24
|
+
|
|
25
|
+
/** Sliding window over the session history (what exceeds it is the compaction's job). */
|
|
26
|
+
export const HISTORY_WINDOW = 50;
|
|
27
|
+
|
|
28
|
+
/** Cap per memory category in the prompt block. */
|
|
29
|
+
export const MAX_MEMORY_ENTRIES_PER_CATEGORY = 10;
|
|
30
|
+
|
|
31
|
+
import { describeSearchRouting } from "../../../shared/domain/search-routing.ts";
|
|
32
|
+
import { describeCodeIntelRouting } from "../../../shared/domain/code-intel-routing.ts";
|
|
33
|
+
import { NETWORK_READ_TOOLS } from "../../../shared/domain/agent-policy/permission.ts";
|
|
34
|
+
import {
|
|
35
|
+
answerLanguageLine, ASKING_BLOCK, CARE_BLOCK, FINISHING_BLOCK, gaugeLine, gitStatusLine, historyBlock, hooksBlock,
|
|
36
|
+
IDENTITY_BLOCK, memoryBlock, outputStyleLine, PRESSURE_DIRECTIVES, projectInstructionsBlock, REPORTING_BLOCK,
|
|
37
|
+
SCOPE_BLOCK, searchPlaybook, sessionBlock, skillsBlock, suggestedSkillsBlock, TONE_BLOCK, toolRealities, toolsBlock, trustBlock,
|
|
38
|
+
VERIFICATION_BLOCK,
|
|
39
|
+
} from "./prompts.ts";
|
|
40
|
+
|
|
41
|
+
/** Ceiling on the authored part of the static header (the instructions file not
|
|
42
|
+
* counted): every rule costs tokens on every request, so a new rule has to fit or
|
|
43
|
+
* replace an older one. Raised from 9 000 when the catalogue gained the tools of
|
|
44
|
+
* Orkeon #180 (their names alone take some 330 characters), then from 9 500 for the
|
|
45
|
+
* question-to-tool routing of code-intel-routing.ts: without it the model answered
|
|
46
|
+
* "every base class" with a shell script of regular expressions instead of the index, then
|
|
47
|
+
* from 10 500 for the rules the prompt audit of 2026-11-01 found missing: `edit_file`, the
|
|
48
|
+
* reads of a turn in one message, `grep` for an exact text outside the code. */
|
|
49
|
+
export const MAX_STATIC_HEADER_CHARS = 10_800;
|
|
50
|
+
|
|
51
|
+
/** What the session lets the turn deliver — chosen from the catalogue, so stable per mode. */
|
|
52
|
+
function describeSession(tools: readonly string[]): string {
|
|
53
|
+
return sessionBlock(tools.includes("file_write"));
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** Where instructions come from, and how a request to remember is kept. The shared lessons tool, when the session
|
|
57
|
+
* offers it, is named as not the place for that fact: it files lessons for every session, not this user's note. */
|
|
58
|
+
function describeTrust(tools: readonly string[]): string {
|
|
59
|
+
return trustBlock(tools.includes("memory_push"));
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** The tools that reach the web: the project's own sources come before them. */
|
|
63
|
+
const WEB_TOOLS: readonly string[] = ["web_search", ...NETWORK_READ_TOOLS];
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* What the offered tools can and cannot do. Conditional on the catalogue, like the
|
|
67
|
+
* search playbook: a read-only mode is not told how to write, and the line about the
|
|
68
|
+
* shell appears only where the shell is offered. Stable per mode, so the cache holds.
|
|
69
|
+
*/
|
|
70
|
+
function describeToolRealities(tools: readonly string[]): string {
|
|
71
|
+
return toolRealities({
|
|
72
|
+
fileRead: tools.includes("file_read"),
|
|
73
|
+
editFile: tools.includes("edit_file"),
|
|
74
|
+
fileWrite: tools.includes("file_write"),
|
|
75
|
+
shell: tools.includes("shell_command"),
|
|
76
|
+
web: WEB_TOOLS.some((tool) => tools.includes(tool)),
|
|
77
|
+
});
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* The search playbook — static per mode, so it sits above the cache boundary.
|
|
82
|
+
*
|
|
83
|
+
* Without it the model has a tool list and no policy: it reaches for shell grep
|
|
84
|
+
* because grep is familiar, paying a process spawn per probe and reading stale
|
|
85
|
+
* text the index has already parsed. The playbook states the order of preference
|
|
86
|
+
* and the one fact the model cannot guess: results are already fresh — the tools
|
|
87
|
+
* reindex edited files before answering, so it must never spend a call on
|
|
88
|
+
* index_codebase again "just in case". The last resort depends on the catalogue:
|
|
89
|
+
* the shell where it is offered, a plain read where it is not.
|
|
90
|
+
*/
|
|
91
|
+
function describeSearchPlaybook(tools: readonly string[]): string {
|
|
92
|
+
return searchPlaybook({
|
|
93
|
+
searchRouting: describeSearchRouting(tools),
|
|
94
|
+
codeIntelRouting: describeCodeIntelRouting(tools),
|
|
95
|
+
shell: tools.includes("shell_command"),
|
|
96
|
+
ragIngest: tools.includes("rag_ingest"),
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Static header — the turn's SYSTEM prompt. MUST be byte-stable across turns
|
|
102
|
+
* for a given mode: the behaviour rules, the sorted tool names with what those
|
|
103
|
+
* tools can do, the search playbook when it applies, and the project's
|
|
104
|
+
* instructions file verbatim (block omitted entirely when absent). Never put
|
|
105
|
+
* numbers-of-the-day in here — as the absolute prefix of every request it is the
|
|
106
|
+
* cache anchor, and (being a real system message) it carries system-level
|
|
107
|
+
* authority over anything user-side, tool results included.
|
|
108
|
+
*/
|
|
109
|
+
export function buildStaticHeader(opts: {
|
|
110
|
+
toolNames: readonly string[];
|
|
111
|
+
/** The script tools of the session (`memory_recall`, `memory_push`): offered apart from the catalogue, so not
|
|
112
|
+
* listed under Tools, but the rules that name one read them. Stable per mode, as the catalogue is. */
|
|
113
|
+
scriptTools?: readonly string[];
|
|
114
|
+
instructions?: InstructionsFile;
|
|
115
|
+
}): string {
|
|
116
|
+
// Sorted so a differently-ordered catalogue still yields the same bytes.
|
|
117
|
+
const tools = [...opts.toolNames].sort();
|
|
118
|
+
const parts = [
|
|
119
|
+
IDENTITY_BLOCK, describeSession(tools), REPORTING_BLOCK, TONE_BLOCK, SCOPE_BLOCK,
|
|
120
|
+
FINISHING_BLOCK, ASKING_BLOCK, VERIFICATION_BLOCK, CARE_BLOCK, describeTrust([...tools, ...(opts.scriptTools ?? [])]),
|
|
121
|
+
];
|
|
122
|
+
if (tools.length > 0) {
|
|
123
|
+
parts.push(toolsBlock(tools, describeToolRealities(tools)));
|
|
124
|
+
}
|
|
125
|
+
// The playbook only makes sense when the search tools are actually granted
|
|
126
|
+
// (plan/dontAsk keep them; a hypothetical catalogue without codebase_search
|
|
127
|
+
// must not advertise it).
|
|
128
|
+
if (tools.includes("codebase_search")) {
|
|
129
|
+
parts.push(describeSearchPlaybook(tools));
|
|
130
|
+
}
|
|
131
|
+
const instructions = opts.instructions;
|
|
132
|
+
if (instructions !== undefined && instructions.content.trim().length > 0) {
|
|
133
|
+
parts.push(projectInstructionsBlock(instructions.file, instructions.content.trim()));
|
|
134
|
+
}
|
|
135
|
+
return parts.join("\n\n");
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** Memory block — fixed category order, empty categories omitted, capped. */
|
|
139
|
+
export function buildMemoryBlock(byCategory: Partial<Record<string, string[]>>): string {
|
|
140
|
+
const sections: string[] = [];
|
|
141
|
+
for (const category of MEMORY_CATEGORIES) {
|
|
142
|
+
const entries = (byCategory[category] ?? []).filter((e) => e.trim().length > 0);
|
|
143
|
+
if (entries.length === 0) continue;
|
|
144
|
+
const capped = entries.slice(0, MAX_MEMORY_ENTRIES_PER_CATEGORY);
|
|
145
|
+
sections.push(`### ${category}\n` + capped.map((e) => `- ${e}`).join("\n"));
|
|
146
|
+
}
|
|
147
|
+
return sections.length === 0 ? "" : memoryBlock(sections.join("\n"));
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/** Volatile environment block (cwd, date, git status) — always below the cache boundary. */
|
|
151
|
+
export function buildUserContextBlock(c: { cwd: string; date?: string; gitStatus?: string }): string {
|
|
152
|
+
const lines = [`## Environment`, `cwd: ${c.cwd}`];
|
|
153
|
+
if (c.date !== undefined && c.date.trim().length > 0) lines.push(`date: ${c.date.trim()}`);
|
|
154
|
+
if (c.gitStatus !== undefined && c.gitStatus.trim().length > 0) {
|
|
155
|
+
lines.push(gitStatusLine(c.gitStatus.trimEnd()));
|
|
156
|
+
}
|
|
157
|
+
return lines.join("\n");
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
/** Keep the LAST `max` requests and answers (sliding window), with the marked messages ([tools], [turn-context],
|
|
161
|
+
* [compacted]) that sit between them and those just before the oldest one kept (its [turn-context], the summary of
|
|
162
|
+
* the compacted turns): a turn that called a tool takes as much of the window as one that did not.
|
|
163
|
+
* NB: the default is resolved in the body, NOT as a default parameter —
|
|
164
|
+
* `max = HISTORY_WINDOW` in the signature trips a Jint NRE when the bundled
|
|
165
|
+
* call resumes from an await (identifier lookup in default-param position). */
|
|
166
|
+
export function windowHistory(messages: SessionMsg[], max?: number): SessionMsg[] {
|
|
167
|
+
const limit = max ?? HISTORY_WINDOW;
|
|
168
|
+
if (limit <= 0) return [];
|
|
169
|
+
let counted = 0;
|
|
170
|
+
for (let i = messages.length - 1; i >= 0; i--) {
|
|
171
|
+
if (!countsInWindow(messages[i])) continue;
|
|
172
|
+
counted += 1;
|
|
173
|
+
if (counted === limit) {
|
|
174
|
+
let start = i;
|
|
175
|
+
while (start > 0 && isMarkedMessage(String(messages[start - 1].content ?? ""))) start -= 1;
|
|
176
|
+
return messages.slice(start);
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
return messages;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/** A request or an answer: what the window counts. */
|
|
183
|
+
function countsInWindow(m: SessionMsg): boolean {
|
|
184
|
+
return (m.role === "user" || m.role === "assistant") && !isMarkedMessage(String(m.content ?? ""));
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* The buffer without the request being answered.
|
|
189
|
+
*
|
|
190
|
+
* The loop appends the user's message before it assembles the prompt, so the
|
|
191
|
+
* buffer ends with the very request the task block carries: rendered as is, every
|
|
192
|
+
* turn would send it twice. Only that trailing entry goes; an earlier identical
|
|
193
|
+
* request is history.
|
|
194
|
+
*/
|
|
195
|
+
export function withoutCurrentRequest(messages: SessionMsg[], request: string): SessionMsg[] {
|
|
196
|
+
const last = messages[messages.length - 1];
|
|
197
|
+
const isRequest = last !== undefined && last.role === "user" && String(last.content).trim() === request.trim();
|
|
198
|
+
return isRequest ? messages.slice(0, -1) : messages;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/** Render the windowed history as a transcript block ("" when empty). The
|
|
202
|
+
* compaction boundary is bookkeeping for the host (counting compactions), left
|
|
203
|
+
* out: the summary message that follows it says what it stands for. */
|
|
204
|
+
export function buildHistoryBlock(messages: SessionMsg[]): string {
|
|
205
|
+
const shown = messages.filter((m) => !isCompactBoundary(m));
|
|
206
|
+
if (shown.length === 0) return "";
|
|
207
|
+
return historyBlock(shown.map((m) => `${m.role}: ${m.content}`).join("\n"));
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
// ── Session preferences and registries ──────────────────────────────────
|
|
211
|
+
//
|
|
212
|
+
// Every block below is VOLATILE and therefore below the cache boundary: a session
|
|
213
|
+
// preference in the static header would break the provider's prefix cache on the
|
|
214
|
+
// first /output-style, which is the one property the header's tests defend.
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* Session preferences as a `<system-reminder>` — output style and language.
|
|
218
|
+
*
|
|
219
|
+
* `<system-reminder>` marks the text as coming from the environment rather than
|
|
220
|
+
* from the user: a preference the operator set with /output-style or
|
|
221
|
+
* `answer.language` is not part of the request being answered.
|
|
222
|
+
*
|
|
223
|
+
* Returns "" for the default style with no language, so an unconfigured
|
|
224
|
+
* session's prompt carries no preference block at all.
|
|
225
|
+
*/
|
|
226
|
+
export function buildPreferencesBlock(p: { outputStyle?: string; language?: string }): string {
|
|
227
|
+
const lines: string[] = [];
|
|
228
|
+
const style = isOutputStyle(p.outputStyle) ? String(p.outputStyle) : "default";
|
|
229
|
+
if (style !== "default") {
|
|
230
|
+
lines.push(outputStyleLine(style));
|
|
231
|
+
}
|
|
232
|
+
const language = String(p.language ?? "").trim();
|
|
233
|
+
if (language.length > 0) {
|
|
234
|
+
lines.push(answerLanguageLine(language));
|
|
235
|
+
}
|
|
236
|
+
if (lines.length === 0) return "";
|
|
237
|
+
return "<system-reminder>\n" + lines.join("\n") + "\n</system-reminder>";
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* Declared hooks — what is declared, and the fact that nothing runs it yet.
|
|
242
|
+
*
|
|
243
|
+
* `/hooks` stores declarations; the engine that would run them is missing (it
|
|
244
|
+
* waits on the runtime). Telling the model a hook exists while it never runs would
|
|
245
|
+
* make it reason about a guarantee it does not have, so the block states the status.
|
|
246
|
+
*/
|
|
247
|
+
export function buildHooksBlock(hooks: ReadonlyArray<{ event?: string; command?: string }>): string {
|
|
248
|
+
const valid = (hooks ?? []).filter((h) => String(h?.event ?? "").length > 0);
|
|
249
|
+
if (valid.length === 0) return "";
|
|
250
|
+
const rows = valid.map((h) => `- ${h.event}: ${String(h.command ?? "").trim()}`);
|
|
251
|
+
return hooksBlock(rows.join("\n"));
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* Attached skills as PROMPT FRAGMENTS.
|
|
256
|
+
*
|
|
257
|
+
* Each entry is `{ path, content }` — the path alone would tell the model a
|
|
258
|
+
* playbook exists without letting it read one, which is worse than silence.
|
|
259
|
+
* Content is capped per skill so one long playbook cannot crowd out the task.
|
|
260
|
+
*/
|
|
261
|
+
export const MAX_SKILL_FRAGMENT_CHARS = 4_000;
|
|
262
|
+
|
|
263
|
+
/** The sections of the skills that have content, each under its path and capped. */
|
|
264
|
+
function skillSections(skills: ReadonlyArray<{ path: string; content: string }>): string {
|
|
265
|
+
const usable = (skills ?? []).filter((s) => String(s?.content ?? "").trim().length > 0);
|
|
266
|
+
return usable.map((s) => {
|
|
267
|
+
const body = String(s.content).trim().slice(0, MAX_SKILL_FRAGMENT_CHARS);
|
|
268
|
+
const truncated = String(s.content).trim().length > MAX_SKILL_FRAGMENT_CHARS;
|
|
269
|
+
return `### ${s.path}\n${body}${truncated ? "\n… (truncated)" : ""}`;
|
|
270
|
+
}).join("\n\n");
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
export function buildSkillsBlock(skills: ReadonlyArray<{ path: string; content: string }>): string {
|
|
274
|
+
const sections = skillSections(skills);
|
|
275
|
+
return sections.length === 0 ? "" : skillsBlock(sections);
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/** The skills suggested for the turn, in a block of their own: not the operator's word (suggestedSkillsBlock). */
|
|
279
|
+
export function buildSuggestedSkillsBlock(skills: ReadonlyArray<{ path: string; content: string }>): string {
|
|
280
|
+
const sections = skillSections(skills);
|
|
281
|
+
return sections.length === 0 ? "" : suggestedSkillsBlock(sections);
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/** Budget/cost gauge — a <system-reminder>, tail of the volatile zone, with the
|
|
285
|
+
* conduct the pressure tier calls for (the tiers of shared/domain/compaction-thresholds.ts). */
|
|
286
|
+
export function buildGaugeBlock(g: {
|
|
287
|
+
usedTokens: number;
|
|
288
|
+
contextWindow: number;
|
|
289
|
+
costUsd: number;
|
|
290
|
+
totalTokens: number;
|
|
291
|
+
totalCalls: number;
|
|
292
|
+
}): string {
|
|
293
|
+
const lines = [gaugeLine(g)];
|
|
294
|
+
const tier = pressureTier(g.usedTokens, g.contextWindow);
|
|
295
|
+
if (tier !== "ok") lines.push(PRESSURE_DIRECTIVES[tier]);
|
|
296
|
+
return "<system-reminder>\n" + lines.join("\n") + "\n</system-reminder>";
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/** The parts of a turn's context, in cache-safe order: the user message `act` sends before the request
|
|
300
|
+
* (`ActOptions.context`, Orkeon #276). The static header is NOT here: it travels as the system prompt
|
|
301
|
+
* (`ActOptions.system`). The request is not here either: it is the prompt, the last user message alone,
|
|
302
|
+
* the one a decision profile's guard and route stages judge. */
|
|
303
|
+
export interface ContextParts {
|
|
304
|
+
/** Session preferences (<system-reminder>) — first, they shape the answer. */
|
|
305
|
+
preferences?: string;
|
|
306
|
+
/** Attached skill fragments — instructions the operator opted into. */
|
|
307
|
+
skills?: string;
|
|
308
|
+
memory?: string;
|
|
309
|
+
/** Declared hooks, with their not-running status. */
|
|
310
|
+
hooks?: string;
|
|
311
|
+
userContext?: string;
|
|
312
|
+
history?: string;
|
|
313
|
+
gauge?: string;
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
/**
|
|
317
|
+
* Join the context's parts in fixed order, skipping empty blocks.
|
|
318
|
+
*
|
|
319
|
+
* Order, and why: from the most stable to the most volatile, so a provider's prefix
|
|
320
|
+
* cache reaches as far into the context as it can. Preferences and skills change only
|
|
321
|
+
* when the operator acts and govern HOW the rest is answered; memory and hooks are
|
|
322
|
+
* standing context; the history only grows between compactions; the environment
|
|
323
|
+
* (date, git status) can change every turn; the gauge changes every turn. The request
|
|
324
|
+
* follows in a message of its own, the place a model is least likely to lose and the
|
|
325
|
+
* one a decision guard judges without the context diluting it. A session that sets
|
|
326
|
+
* nothing renders none of the optional blocks.
|
|
327
|
+
*
|
|
328
|
+
* No block lists the MCP servers: the tools they serve already join the catalogue
|
|
329
|
+
* (`tools.extra`), and a section announcing servers the model cannot address
|
|
330
|
+
* directly would be noise.
|
|
331
|
+
*/
|
|
332
|
+
export function assembleContext(p: ContextParts): string {
|
|
333
|
+
const blocks = [
|
|
334
|
+
p.preferences, p.skills, p.memory, p.hooks,
|
|
335
|
+
p.history, p.userContext, p.gauge,
|
|
336
|
+
];
|
|
337
|
+
return blocks.filter((b): b is string => b !== undefined && b.length > 0).join("\n\n");
|
|
338
|
+
}
|