orkeon-code 1.0.0-rc.1 → 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 -1
- package/NOTICE.md +1 -1
- package/README.fr.md +16 -22
- package/README.md +16 -22
- package/config/appsettings.jev.example.json +4 -1
- package/config/appsettings.kev.example.json +4 -1
- package/config/appsettings.liquid.example.json +4 -1
- package/config/appsettings.ollama-whisper.example.json +1 -0
- package/config/appsettings.whisper.example.json +1 -0
- package/mcp/whisper/README.md +2 -1
- package/orkeon-code +206 -11
- package/orkeon-code.ps1 +109 -7
- package/package.json +2 -1
- package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
- package/src/commands/_lib/args.ts +5 -4
- package/src/commands/_lib/dev/dev-batches.ts +34 -36
- package/src/commands/_lib/dev/dev-implement.ts +11 -14
- package/src/commands/_lib/dev/dev-source.ts +7 -11
- package/src/commands/_lib/dev/dev.ts +34 -37
- 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 +16 -13
- package/src/commands/_lib/dispatch.ts +62 -39
- package/src/commands/_lib/git/branch.ts +9 -10
- package/src/commands/_lib/git/commit.ts +9 -13
- package/src/commands/_lib/git/diff.ts +22 -12
- package/src/commands/_lib/git/messages.ts +54 -0
- package/src/commands/_lib/git/review.ts +9 -10
- package/src/commands/_lib/memory/memory-admit.ts +19 -21
- package/src/commands/_lib/memory/memory.ts +3 -2
- package/src/commands/_lib/memory/messages.ts +32 -0
- package/src/commands/_lib/messages.ts +48 -0
- package/src/commands/_lib/project/messages.ts +8 -0
- package/src/commands/_lib/session/export.ts +3 -2
- 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 +15 -24
- package/src/commands/_lib/session/tasks.ts +20 -23
- package/src/commands/_lib/settings/advisor.ts +11 -16
- package/src/commands/_lib/settings/agents.ts +18 -28
- package/src/commands/_lib/settings/choices.ts +8 -0
- package/src/commands/_lib/settings/config.ts +43 -43
- package/src/commands/_lib/settings/effort.ts +147 -0
- package/src/commands/_lib/settings/hooks.ts +12 -20
- package/src/commands/_lib/settings/messages.ts +408 -0
- package/src/commands/_lib/settings/mode.ts +33 -24
- package/src/commands/_lib/settings/model.ts +71 -36
- package/src/commands/_lib/settings/output-style.ts +39 -0
- package/src/commands/_lib/settings/permissions.ts +71 -93
- package/src/commands/_lib/settings/route.ts +63 -0
- package/src/commands/_lib/settings/skills.ts +53 -11
- 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 +9 -10
- package/src/commands/_lib/speech/transcribe.ts +14 -23
- package/src/commands/_lib/speech/voice.ts +14 -18
- package/src/commands/_lib/status/doctor.ts +47 -28
- package/src/commands/_lib/status/messages.ts +100 -0
- package/src/commands/_lib/status/meta.ts +3 -24
- package/src/commands/_lib/status/status.ts +10 -11
- package/src/commands/_lib/status/usage-tools.ts +2 -3
- package/src/commands/_lib/status/usage.ts +7 -18
- package/src/commands/_lib/view.ts +6 -1
- package/src/commands/dev/dev-batches.cmd.ts +4 -3
- package/src/commands/dev/dev-learn.cmd.ts +3 -3
- package/src/commands/dev/dev-plan.cmd.ts +6 -7
- package/src/commands/dev/dev-spec.cmd.ts +6 -7
- package/src/commands/git/commit.cmd.ts +3 -3
- package/src/commands/git/review.cmd.ts +3 -3
- package/src/commands/memory/memory.cmd.ts +2 -2
- package/src/commands/project/analyze.cmd.ts +3 -3
- package/src/commands/project/debug-tool-call.cmd.ts +4 -9
- package/src/commands/project/init-verifiers.cmd.ts +3 -3
- package/src/commands/project/init.cmd.ts +3 -3
- package/src/commands/project/verify.cmd.ts +2 -2
- package/src/commands/session/assistant.cmd.ts +2 -2
- package/src/commands/session/compact.cmd.ts +1 -1
- package/src/commands/session/copy.cmd.ts +8 -7
- package/src/commands/session/rename.cmd.ts +3 -2
- package/src/commands/session/rewind.cmd.ts +3 -4
- package/src/commands/session/summary.cmd.ts +3 -3
- package/src/commands/session/tasks.cmd.ts +4 -2
- package/src/commands/settings/config.cmd.ts +4 -2
- package/src/commands/settings/effort.cmd.ts +10 -31
- package/src/commands/settings/fast.cmd.ts +2 -1
- package/src/commands/settings/mode.cmd.ts +3 -3
- package/src/commands/settings/model.cmd.ts +3 -2
- package/src/commands/settings/output-style.cmd.ts +9 -38
- package/src/commands/settings/permissions.cmd.ts +2 -2
- package/src/commands/settings/proactive.cmd.ts +2 -1
- package/src/commands/settings/route.cmd.ts +16 -0
- package/src/commands/settings/skills.cmd.ts +3 -3
- package/src/commands/settings/theme.cmd.ts +14 -0
- package/src/commands/speech/say.cmd.ts +2 -2
- package/src/commands/speech/transcribe.cmd.ts +2 -2
- package/src/commands/status/release-notes.cmd.ts +1 -1
- package/src/crews/.orkeon/orkeon.d.ts +538 -93
- package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
- package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
- package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
- package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
- 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 +2 -1
- package/src/crews/advisor/crew.ork.ts +5 -4
- package/src/crews/advisor/domain/advice.ts +7 -23
- 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 +5 -4
- package/src/crews/agent-run/crew.ork.ts +3 -3
- 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 +16 -14
- package/src/crews/analyze/crew.ork.ts +5 -4
- package/src/crews/analyze/domain/harvest.ts +33 -65
- 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 +10 -17
- package/src/crews/code-review/application/review.ts +4 -1
- package/src/crews/code-review/application/run-code-review.ts +13 -15
- package/src/crews/code-review/crew.ork.ts +5 -4
- package/src/crews/code-review/domain/lenses.ts +6 -45
- 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 +5 -6
- package/src/crews/code-review/domain/scope.ts +6 -12
- package/src/crews/dev-batches/application/messages.ts +127 -0
- package/src/crews/dev-batches/application/plan-close.ts +12 -12
- package/src/crews/dev-batches/application/prompts.ts +10 -0
- package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
- package/src/crews/dev-batches/application/run-wave.ts +24 -22
- package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
- package/src/crews/dev-batches/crew.ork.ts +12 -9
- package/src/crews/dev-batches/domain/batches-log.ts +1 -3
- 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 +3 -2
- package/src/crews/dev-change/application/change-material.ts +44 -0
- package/src/crews/dev-change/application/evidence.ts +25 -22
- package/src/crews/dev-change/application/messages.ts +81 -0
- package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
- package/src/crews/dev-change/application/run-dev-change.ts +43 -34
- package/src/crews/dev-change/crew.ork.ts +11 -9
- package/src/crews/dev-change/domain/change-answer.ts +24 -20
- package/src/crews/dev-change/domain/change-render.ts +13 -15
- 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 +21 -18
- package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
- package/src/crews/dev-implement/application/messages.ts +161 -0
- package/src/crews/dev-implement/application/observe.ts +4 -2
- package/src/crews/dev-implement/application/prompts.ts +9 -0
- package/src/crews/dev-implement/application/report-writes.ts +14 -9
- package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
- package/src/crews/dev-implement/application/suite-job.ts +15 -11
- package/src/crews/dev-implement/crew.ork.ts +2 -1
- package/src/crews/dev-implement/domain/contracts.ts +59 -60
- package/src/crews/dev-implement/domain/correction.ts +16 -15
- package/src/crews/dev-implement/domain/cycles.ts +2 -1
- 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 +3 -7
- package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
- package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
- package/src/crews/dev-implement/domain/step-checks.ts +17 -16
- package/src/crews/dev-implement/domain/step-section.ts +6 -4
- 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/{learn-prompt.ts → prompts.ts} +24 -65
- package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
- package/src/crews/dev-learn/crew.ork.ts +4 -3
- package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
- package/src/crews/dev-learn/domain/messages.ts +65 -0
- package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
- package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
- package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
- package/src/crews/dev-plan/application/inventory.ts +17 -13
- 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/{plan-prompt.ts → prompts.ts} +37 -55
- package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
- package/src/crews/dev-plan/crew.ork.ts +11 -8
- package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
- 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 +118 -103
- package/src/crews/dev-plan/domain/plan-render.ts +30 -31
- 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/{spec-prompt.ts → prompts.ts} +42 -47
- package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
- package/src/crews/dev-spec/application/spec-material.ts +42 -0
- package/src/crews/dev-spec/crew.ork.ts +11 -9
- 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 +46 -47
- package/src/crews/dev-spec/domain/spec-render.ts +18 -18
- package/src/crews/dev-verify/application/audit-brief.ts +187 -0
- package/src/crews/dev-verify/application/audit.ts +38 -30
- package/src/crews/dev-verify/application/capture.ts +34 -26
- 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 +60 -46
- package/src/crews/dev-verify/application/run-gate.ts +11 -9
- package/src/crews/dev-verify/crew.ork.ts +6 -6
- package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
- package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
- package/src/crews/dev-verify/domain/commands.ts +3 -3
- package/src/crews/dev-verify/domain/gate.ts +21 -16
- package/src/crews/dev-verify/domain/markers.ts +16 -0
- package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
- package/src/crews/dev-verify/domain/messages.ts +92 -0
- package/src/crews/dev-verify/domain/verdict.ts +4 -4
- package/src/crews/git-commit/application/draft.ts +16 -37
- 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 +13 -12
- package/src/crews/git-commit/crew.ork.ts +5 -4
- package/src/crews/git-commit/domain/commit.ts +15 -35
- 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 +2 -1
- package/src/crews/init-verifiers/application/messages.ts +13 -0
- package/src/crews/init-verifiers/application/prompts.ts +5 -1
- package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
- package/src/crews/init-verifiers/crew.ork.ts +5 -4
- package/src/crews/main-loop/application/auto-compact.ts +2 -1
- 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 +63 -30
- package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
- package/src/crews/main-loop/crew.ork.ts +12 -7
- package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
- package/src/crews/main-loop/domain/prompts.ts +336 -0
- package/src/crews/main-loop/domain/turn-chains.ts +10 -9
- package/src/crews/project-init/application/detect.ts +5 -4
- package/src/crews/project-init/application/messages.ts +15 -0
- package/src/crews/project-init/application/prompts.ts +11 -7
- package/src/crews/project-init/crew.ork.ts +5 -4
- package/src/crews/project-init/domain/existing-files.ts +6 -4
- package/src/crews/project-init/domain/messages.ts +13 -0
- package/src/crews/project-init/domain/package-map.ts +3 -3
- 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 +5 -4
- package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
- package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
- 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 +2 -1
- package/src/crews/speech/crew.ork.ts +2 -1
- package/src/shared/application/agents/child-agent.ts +11 -7
- 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 +31 -8
- package/src/shared/application/compaction/compact-session.ts +19 -14
- 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/dev/brief-inventory.ts +6 -4
- package/src/shared/application/dev/close-batch.ts +9 -7
- package/src/shared/application/dev/find-repo-pack.ts +4 -3
- package/src/shared/application/dev/learn-decision.ts +20 -18
- package/src/shared/application/dev/load-dev-context.ts +7 -8
- package/src/shared/application/dev/measure-access-cost.ts +5 -4
- 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 +12 -8
- package/src/shared/application/dev/preflight.ts +8 -8
- package/src/shared/application/dev/prompts.ts +34 -0
- package/src/shared/application/dev/question-round.ts +25 -17
- package/src/shared/application/dev/resolve-work-folder.ts +4 -3
- package/src/shared/application/dev/settle-questions.ts +4 -2
- package/src/shared/application/dev/source-review.ts +12 -8
- package/src/shared/application/dev/source-step.ts +12 -10
- package/src/shared/application/dev/spend.ts +17 -4
- package/src/shared/application/dev/step-precedents.ts +2 -1
- package/src/shared/application/dev/tool-call-policy.ts +9 -11
- package/src/shared/application/dev/tool-callbacks.ts +52 -5
- package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
- package/src/shared/application/dev/verdict-sources.ts +5 -3
- package/src/shared/application/dev/wrapped-tools.ts +4 -2
- package/src/shared/application/extra-tools.ts +2 -1
- package/src/shared/application/git/batch-worktree.ts +22 -17
- package/src/shared/application/git/commit-files.ts +24 -19
- package/src/shared/application/git/merge-batch.ts +11 -7
- package/src/shared/application/git/messages.ts +75 -0
- package/src/shared/application/git/open-pull-request.ts +4 -3
- package/src/shared/application/host-context.ts +59 -0
- package/src/shared/application/host-layout-store.ts +45 -0
- package/src/shared/application/llm-profile.ts +4 -3
- package/src/shared/application/messages.ts +14 -0
- package/src/shared/application/permission-rules.ts +10 -0
- package/src/shared/application/ports/decision.ts +14 -0
- package/src/shared/application/ports/human.ts +25 -0
- package/src/shared/application/ports/llm.ts +32 -3
- package/src/shared/application/ports/memory.ts +1 -1
- package/src/shared/application/ports/theme.ts +11 -0
- package/src/shared/application/ports.ts +4 -2
- package/src/shared/application/session-io.ts +2 -1
- package/src/shared/application/shared-memory/admit-entries.ts +16 -14
- package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
- package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
- package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
- package/src/shared/application/shared-memory/memory-files.ts +2 -1
- package/src/shared/application/shared-memory/memory-settings.ts +2 -1
- package/src/shared/application/shared-memory/messages.ts +63 -0
- package/src/shared/application/shared-memory/push-candidate.ts +14 -11
- package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
- package/src/shared/application/skills/messages.ts +4 -0
- package/src/shared/application/skills/suggest-skills.ts +102 -0
- package/src/shared/application/workflow/messages.ts +8 -0
- package/src/shared/application/workflow/workflow-state.ts +7 -6
- package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
- package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
- package/src/shared/domain/agent-policy/messages.ts +66 -0
- package/src/shared/domain/agent-policy/path-rules.ts +299 -0
- package/src/shared/domain/agent-policy/permission.ts +20 -18
- 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 +18 -14
- package/src/shared/domain/agent-policy/tool-access.ts +17 -3
- package/src/shared/domain/agent-registry.ts +6 -5
- package/src/shared/domain/agents/chain.ts +2 -2
- package/src/shared/domain/agents/charter.ts +8 -5
- package/src/shared/domain/agents/exclusive.ts +2 -1
- package/src/shared/domain/agents/instances.ts +18 -15
- 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 +5 -4
- package/src/shared/domain/code-intel-routing.ts +8 -61
- package/src/shared/domain/compact-outcome.ts +5 -3
- package/src/shared/domain/compaction-thresholds.ts +2 -1
- package/src/shared/domain/compaction.ts +22 -113
- package/src/shared/domain/config-schema.ts +94 -81
- 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 +19 -15
- package/src/shared/domain/dev/batches-concurrency.ts +5 -6
- package/src/shared/domain/dev/build-commands.ts +5 -4
- package/src/shared/domain/dev/call-guard.ts +29 -28
- package/src/shared/domain/dev/carried-text.ts +3 -5
- package/src/shared/domain/dev/learn-proposals.ts +5 -4
- package/src/shared/domain/dev/learn-state.ts +3 -2
- package/src/shared/domain/dev/markers.ts +107 -0
- package/src/shared/domain/dev/messages.ts +259 -0
- package/src/shared/domain/dev/phase-timing.ts +50 -0
- package/src/shared/domain/dev/plan-checks.ts +24 -23
- package/src/shared/domain/dev/plan-format.ts +14 -24
- package/src/shared/domain/dev/project-files.ts +1 -15
- package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
- package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
- package/src/shared/domain/dev/questions.ts +33 -15
- package/src/shared/domain/dev/repo-pack.ts +12 -9
- package/src/shared/domain/dev/review-answer.ts +40 -17
- package/src/shared/domain/dev/review-brief.ts +54 -0
- package/src/shared/domain/dev/reviewer-charter.ts +4 -0
- package/src/shared/domain/dev/sheet-facts.ts +2 -4
- package/src/shared/domain/dev/spec-format.ts +13 -14
- package/src/shared/domain/dev/step-budget.ts +4 -2
- package/src/shared/domain/dev/step-rules.ts +3 -4
- package/src/shared/domain/dev/test-commands.ts +14 -10
- package/src/shared/domain/dev/tool-guards.ts +4 -3
- package/src/shared/domain/dev/trait-pattern.ts +14 -10
- package/src/shared/domain/dev/verdict-format.ts +14 -21
- package/src/shared/domain/dev/whitespace.ts +3 -2
- package/src/shared/domain/dev/work-folder.ts +4 -3
- package/src/shared/domain/dev/yaml-subset.ts +8 -26
- package/src/shared/domain/error-text.ts +13 -0
- package/src/shared/domain/git/close.ts +5 -4
- package/src/shared/domain/git/messages.ts +20 -0
- package/src/shared/domain/git/pull-request.ts +5 -5
- package/src/shared/domain/host-layout.ts +147 -0
- package/src/shared/domain/host-paths.ts +399 -0
- package/src/shared/domain/llm-failure.ts +35 -7
- package/src/shared/domain/llm-profile.ts +22 -3
- package/src/shared/domain/marked-message.ts +1 -5
- package/src/shared/domain/markers.ts +30 -0
- package/src/shared/domain/messages.ts +291 -0
- package/src/shared/domain/model-catalog.ts +2 -9
- package/src/shared/domain/permission-modes.ts +4 -8
- package/src/shared/domain/prelude.ts +2 -2
- package/src/shared/domain/project-manifests.ts +3 -2
- package/src/shared/domain/prompts.ts +233 -0
- package/src/shared/domain/search-routing.ts +3 -11
- package/src/shared/domain/secret-patterns.ts +3 -2
- package/src/shared/domain/session-keys.ts +7 -0
- package/src/shared/domain/session-start.ts +3 -2
- package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
- package/src/shared/domain/shared-memory/candidates.ts +3 -4
- package/src/shared/domain/shared-memory/entry.ts +26 -20
- package/src/shared/domain/shared-memory/front-matter.ts +17 -13
- package/src/shared/domain/shared-memory/gate.ts +4 -3
- package/src/shared/domain/shared-memory/harvest.ts +9 -6
- package/src/shared/domain/shared-memory/layout.ts +11 -8
- 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 +4 -15
- package/src/shared/domain/shared-memory/prompts.ts +28 -0
- package/src/shared/domain/shared-memory/refused.ts +3 -3
- 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 +2 -14
- package/src/shared/domain/speech.ts +2 -1
- package/src/shared/domain/tool-trace.ts +5 -7
- package/src/shared/domain/verifiers.ts +7 -11
- package/src/shared/domain/vfs.ts +8 -1
- package/src/shared/domain/workflow/prompts.ts +15 -0
- package/src/shared/domain/workflow/state-file.ts +14 -12
- package/src/shared/infrastructure/globals.ts +7 -2
- package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
- package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
- package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
- package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
- package/src/shared/infrastructure/orkeon/files.ts +24 -6
- package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
- package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
- package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
- package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
- package/src/shared/infrastructure/orkeon/llm.ts +85 -30
- package/src/shared/infrastructure/orkeon/markers.ts +6 -0
- package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
- package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
- package/src/shared/infrastructure/orkeon/messages.ts +15 -0
- package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
- package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
- package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
- package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
- package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
- package/src/shared/infrastructure/orkeon/shell.ts +13 -5
- package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
- package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
- package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
- package/src/shared/domain/session-summary.ts +0 -13
|
@@ -8,6 +8,11 @@
|
|
|
8
8
|
|
|
9
9
|
import { policyFor } from "./mode-policy.ts";
|
|
10
10
|
import type { ToolClass } from "./mode-policy.ts";
|
|
11
|
+
import {
|
|
12
|
+
argumentsNotKnown, hasNoArgument, modeDoesNotOffer, noToolARuleMayName, offeredToEveryAct, PLAN_IGNORES_ALLOW_RULES,
|
|
13
|
+
takesNoArgument,
|
|
14
|
+
} from "./messages.ts";
|
|
15
|
+
import { MAY_ACT_CLAUSE, READ_ONLY_CLAUSE } from "./prompts.ts";
|
|
11
16
|
|
|
12
17
|
/** Read-side tools (inspection + the read-only RaggableTree index queries). */
|
|
13
18
|
export const READ_TOOLS = [
|
|
@@ -54,11 +59,14 @@ export const READ_TOOLS = [
|
|
|
54
59
|
* agent's own list; it never enters the DI catalogue the scripting bridge draws
|
|
55
60
|
* from. "Framework-registered and auto-bridged" holds for http_api, not for it.
|
|
56
61
|
*
|
|
62
|
+
* `firefox` (Orkeon #293) is filed here whatever its action: its reads load pages, and a page load is an outbound
|
|
63
|
+
* request, so `plan` and `dontAsk` go without it although the runtime lets its reads pass in plan.
|
|
64
|
+
*
|
|
57
65
|
* `spawn_agent` is the script host's own tool, appended to every act whatever
|
|
58
66
|
* `.tools([...])` names (naming it there fails the act): it is ruleable
|
|
59
67
|
* (ACT_TOOLS) and never named in a catalogue.
|
|
60
68
|
*/
|
|
61
|
-
export const NETWORK_READ_TOOLS = ["http_api", "web_scrape", "scrape_element"];
|
|
69
|
+
export const NETWORK_READ_TOOLS = ["http_api", "web_scrape", "scrape_element", "firefox"];
|
|
62
70
|
|
|
63
71
|
/** The built-in tools of each class a mode policy grants: each tool is named
|
|
64
72
|
* once, here or in the lists above, and every other list derives from this table. */
|
|
@@ -117,10 +125,7 @@ export function toolsetFor(mode: string, extras: readonly ExtraTool[] = []): str
|
|
|
117
125
|
|
|
118
126
|
/** The permission clause appended to the act() prompt. */
|
|
119
127
|
export function permissionNote(mode: string): string {
|
|
120
|
-
const clause = isReadOnly(mode)
|
|
121
|
-
? "Read-only: read and search the project, but MUST NOT modify files, run commands or fetch anything over the " +
|
|
122
|
-
"network; answer with an assessment or a plan."
|
|
123
|
-
: "You may edit files, run shell commands and fetch over the network; the host may ask the user before a call.";
|
|
128
|
+
const clause = isReadOnly(mode) ? READ_ONLY_CLAUSE : MAY_ACT_CLAUSE;
|
|
124
129
|
return `(Permission mode: ${mode}. ${clause})`;
|
|
125
130
|
}
|
|
126
131
|
|
|
@@ -255,6 +260,7 @@ export const TOOL_ARGUMENTS: Readonly<Record<string, readonly string[]>> = {
|
|
|
255
260
|
http_api: ["url", "method", "headers", "body", "content_type"],
|
|
256
261
|
web_scrape: ["url", "selector", "cached", "chunk_size"],
|
|
257
262
|
scrape_element: ["url", "css_selector", "extract_attributes", "include_html", "max_elements"],
|
|
263
|
+
firefox: ["action", "url", "node_id", "kind", "name", "query", "text", "key", "script", "save_to_path", "max_nodes", "offset", "tab", "profile"],
|
|
258
264
|
file_write: ["path", "content", "encoding", "append", "create_backup"],
|
|
259
265
|
shell_command: ["command", "working_directory", "timeout_seconds", "action", "job_id", "tail_lines"],
|
|
260
266
|
// The tools of Orkeon #180, each with the depth-1 keys of its input (orkeon.d.ts, OrkeonBuiltInTools).
|
|
@@ -271,7 +277,7 @@ export const TOOL_ARGUMENTS: Readonly<Record<string, readonly string[]>> = {
|
|
|
271
277
|
// - batch_anchors.a and .b are {fqns, files}, for action "overlap"; "closure" takes fqns or files.
|
|
272
278
|
// - arrays or objects: rag_ingest.sources, access_cost.*, affected_tests.changed_files,
|
|
273
279
|
// sub_graph.seeds|edge_kinds|node_kinds, edge_list.edge_kinds, structural_search.paths|rule,
|
|
274
|
-
// count_pattern.patterns, statement_query.kinds|parent_fqns, incremental_reindex.changed_files
|
|
280
|
+
// count_pattern.patterns, statement_query.kinds|parent_fqns, incremental_reindex.changed_files.
|
|
275
281
|
glob: ["max_results", "path", "pattern"],
|
|
276
282
|
grep: ["case_insensitive", "glob", "max_files", "max_results", "output_mode", "path", "pattern"],
|
|
277
283
|
list_mounts: [],
|
|
@@ -283,7 +289,7 @@ export const TOOL_ARGUMENTS: Readonly<Record<string, readonly string[]>> = {
|
|
|
283
289
|
documented_in: ["fqn"],
|
|
284
290
|
documents_of: ["path"],
|
|
285
291
|
structural_search: ["glob", "language", "max_files", "max_results", "paths", "pattern", "rule", "rule_file"],
|
|
286
|
-
incremental_reindex: ["changed_files", "
|
|
292
|
+
incremental_reindex: ["changed_files", "from_commit", "root_path", "to_commit"],
|
|
287
293
|
count_pattern: ["distinct_matches", "include_matches", "max_matches_returned", "multiline", "path", "patterns"],
|
|
288
294
|
statement_query: ["kinds", "parent_fqns", "semantic_query", "top_k"],
|
|
289
295
|
complexity_report: ["metric", "root_fqn", "top_n"],
|
|
@@ -352,14 +358,12 @@ function inertReason(mode: string, rule: PermissionRule, offered: readonly strin
|
|
|
352
358
|
// The gate reads no allow rule in plan (ModePermissionGate): plan's promise of a
|
|
353
359
|
// turn that changes nothing outranks the session's rules.
|
|
354
360
|
if (mode === "plan") {
|
|
355
|
-
return
|
|
356
|
-
"and refuses the rest. Switch mode instead.";
|
|
361
|
+
return PLAN_IGNORES_ALLOW_RULES;
|
|
357
362
|
}
|
|
358
363
|
// An ACT_TOOLS tool reaches the gate from every act whatever the catalogue: the gate reads an allow
|
|
359
364
|
// rule on it in every other mode, dontAsk included.
|
|
360
365
|
if (!offered.includes(rule.tool) && !isActTool(rule.tool)) {
|
|
361
|
-
return
|
|
362
|
-
"it does not hand a tool over. Switch mode instead.";
|
|
366
|
+
return modeDoesNotOffer(mode, rule.tool);
|
|
363
367
|
}
|
|
364
368
|
return undefined;
|
|
365
369
|
}
|
|
@@ -466,7 +470,7 @@ export function checkRule(text: unknown, extraNames: readonly string[] = []): Ru
|
|
|
466
470
|
const tool = ruleableTool(read.tool, extraNames);
|
|
467
471
|
if (tool === undefined) {
|
|
468
472
|
const tools = [...RULEABLE_TOOLS, ...extraNames].join(", ");
|
|
469
|
-
return { ok: false, reason:
|
|
473
|
+
return { ok: false, reason: noToolARuleMayName(read.tool, tools) };
|
|
470
474
|
}
|
|
471
475
|
const rule = { ...read, tool };
|
|
472
476
|
// The gate reads an allow rule on an ACT_TOOLS tool in every mode but plan: say so, refuse nothing.
|
|
@@ -474,8 +478,7 @@ export function checkRule(text: unknown, extraNames: readonly string[] = []): Ru
|
|
|
474
478
|
? {
|
|
475
479
|
ok: true,
|
|
476
480
|
rule,
|
|
477
|
-
warning:
|
|
478
|
-
"dontAsk too.",
|
|
481
|
+
warning: offeredToEveryAct(tool),
|
|
479
482
|
}
|
|
480
483
|
: { ok: true, rule };
|
|
481
484
|
if (rule.argument === undefined) return accepted;
|
|
@@ -484,16 +487,15 @@ export function checkRule(text: unknown, extraNames: readonly string[] = []): Ru
|
|
|
484
487
|
return {
|
|
485
488
|
ok: true,
|
|
486
489
|
rule,
|
|
487
|
-
warning:
|
|
488
|
-
`matches a call only if '${tool}' takes an argument named exactly '${rule.argument}'.`,
|
|
490
|
+
warning: argumentsNotKnown(tool, rule.argument),
|
|
489
491
|
};
|
|
490
492
|
}
|
|
491
493
|
if (known.includes(rule.argument)) return accepted;
|
|
492
494
|
return {
|
|
493
495
|
ok: false,
|
|
494
496
|
reason: known.length === 0
|
|
495
|
-
?
|
|
496
|
-
:
|
|
497
|
+
? takesNoArgument(tool)
|
|
498
|
+
: hasNoArgument(tool, rule.argument, known),
|
|
497
499
|
};
|
|
498
500
|
}
|
|
499
501
|
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
// The prompts of shared/domain/agent-policy: the text the model reads (ADR 0026).
|
|
2
|
+
|
|
3
|
+
/** The permission clause of a read-only mode, and of the others. */
|
|
4
|
+
export const READ_ONLY_CLAUSE =
|
|
5
|
+
"Read-only: read and search the project, but MUST NOT modify files, run commands or fetch anything over the " +
|
|
6
|
+
"network; answer with an assessment or a plan.";
|
|
7
|
+
export const MAY_ACT_CLAUSE =
|
|
8
|
+
"You may edit files, run shell commands and fetch over the network; the host may ask the user before a call.";
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Appended to the task block (last, with the request) rather than added as its
|
|
12
|
+
* own context block: it is an instruction about the ANSWER's shape, and the
|
|
13
|
+
* furthest thing from the task is the easiest for a model to lose.
|
|
14
|
+
*/
|
|
15
|
+
export const PROACTIVE_CLAUSE =
|
|
16
|
+
"(Proactive mode: after the answer, suggest at most three concrete next steps under " +
|
|
17
|
+
"'Next steps'; leave the list out when the work is self-contained.)";
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
// What a model takes for reasoning and what becomes of an effort asked, as the runtime judges them (Orkeon #359,
|
|
2
|
+
// #360): the capability table of the host, the provider's own levels, the model's entry. Nothing here repeats that
|
|
3
|
+
// rule: these are the shapes the runtime answers with, read from whatever object it hands over. Pure.
|
|
4
|
+
import { isEffortLevel } from "./behavior-flags.ts";
|
|
5
|
+
import type { EffortLevel } from "./behavior-flags.ts";
|
|
6
|
+
|
|
7
|
+
/** What the session's turns run on: the session's `llm.profile`, else the /model override, else the host's own
|
|
8
|
+
* model. A profile wins over the model, as it does in the main loop. */
|
|
9
|
+
export interface ReasoningTarget {
|
|
10
|
+
profile: string | null;
|
|
11
|
+
model: string;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
/** What a provider and one of its models take for reasoning. */
|
|
15
|
+
export interface ReasoningCapabilities {
|
|
16
|
+
model: string;
|
|
17
|
+
/** Whether the capability table knows the model; when it does not, an effort is sent unchecked. */
|
|
18
|
+
known: boolean;
|
|
19
|
+
/** The levels sent as asked, in order; empty when the model takes no effort. */
|
|
20
|
+
efforts: readonly EffortLevel[];
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export const EFFORT_NOTICES = ["lowered", "dropped", "unchecked"] as const;
|
|
24
|
+
export type EffortNotice = (typeof EFFORT_NOTICES)[number];
|
|
25
|
+
|
|
26
|
+
/** What the runtime does with an effort asked. */
|
|
27
|
+
export interface EffortReport {
|
|
28
|
+
model: string;
|
|
29
|
+
asked: EffortLevel;
|
|
30
|
+
/** What the provider receives; null when no effort goes out. */
|
|
31
|
+
sent: string | null;
|
|
32
|
+
/** Null when the effort goes as asked on a model the table knows. */
|
|
33
|
+
notice: EffortNotice | null;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function fieldsOf(raw: unknown): Record<string, unknown> | null {
|
|
37
|
+
return raw !== null && typeof raw === "object" ? (raw as Record<string, unknown>) : null;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** The capabilities the runtime answered; null when it answered none, or something that names no model. */
|
|
41
|
+
export function capabilitiesOf(raw: unknown): ReasoningCapabilities | null {
|
|
42
|
+
const fields = fieldsOf(raw);
|
|
43
|
+
if (fields === null || typeof fields.model !== "string") return null;
|
|
44
|
+
const efforts = Array.isArray(fields.efforts) ? fields.efforts.filter((level): level is EffortLevel => isEffortLevel(level)) : [];
|
|
45
|
+
return { model: fields.model, known: fields.known === true, efforts };
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** The report the runtime answered; null when it answered none (no effort asked, no provider), or one whose asked
|
|
49
|
+
* level is not a level. */
|
|
50
|
+
export function effortReportOf(raw: unknown): EffortReport | null {
|
|
51
|
+
const fields = fieldsOf(raw);
|
|
52
|
+
if (fields === null || typeof fields.model !== "string" || !isEffortLevel(fields.asked)) return null;
|
|
53
|
+
return {
|
|
54
|
+
model: fields.model,
|
|
55
|
+
asked: fields.asked,
|
|
56
|
+
sent: typeof fields.sent === "string" ? fields.sent : null,
|
|
57
|
+
notice: EFFORT_NOTICES.find((notice) => notice === fields.notice) ?? null,
|
|
58
|
+
};
|
|
59
|
+
}
|
|
@@ -10,6 +10,10 @@
|
|
|
10
10
|
import { gateLine, sameCalls } from "./permission.ts";
|
|
11
11
|
import type { PermissionRule } from "./permission.ts";
|
|
12
12
|
import { WORKSPACE, workspaceRelative } from "../vfs.ts";
|
|
13
|
+
import {
|
|
14
|
+
GIT_READONLY_TITLE, INLINE_INTERPRETERS_TITLE, patternClimbsOut, patternOutside, patternWholeProject,
|
|
15
|
+
READ_NOISE_TITLE, rootClimbsOut, rootHoldsStar, rootOutside, rootWholeProject, SECRETS_TITLE, STATE_FILES_TITLE,
|
|
16
|
+
} from "./messages.ts";
|
|
13
17
|
|
|
14
18
|
export type RuleSetId = "git-readonly" | "inline-interpreters" | "read-noise" | "secrets" | "state-files";
|
|
15
19
|
|
|
@@ -215,7 +219,7 @@ export const OPERATION_TOOLS: Readonly<Record<string, string>> = {
|
|
|
215
219
|
};
|
|
216
220
|
|
|
217
221
|
/** A deny on every call of each tool. */
|
|
218
|
-
function denyWhole(tools: readonly string[]): PermissionRule[] {
|
|
222
|
+
export function denyWhole(tools: readonly string[]): PermissionRule[] {
|
|
219
223
|
return tools.map((tool): PermissionRule => ({ effect: "deny", tool }));
|
|
220
224
|
}
|
|
221
225
|
|
|
@@ -229,14 +233,14 @@ const STATE_ENTRIES: readonly string[] = [
|
|
|
229
233
|
"dev", "memory", "agent", "sessions", "hooks", "shared", "repo", "config", "state", "orkeon", "ORKEON_", "forge", "rag",
|
|
230
234
|
];
|
|
231
235
|
|
|
232
|
-
function denyEach(tools: readonly string[], argument: string, patterns: readonly string[]): PermissionRule[] {
|
|
236
|
+
export function denyEach(tools: readonly string[], argument: string, patterns: readonly string[]): PermissionRule[] {
|
|
233
237
|
return tools.flatMap((tool) => denyAll(tool, argument, patterns));
|
|
234
238
|
}
|
|
235
239
|
|
|
236
240
|
export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
|
|
237
241
|
"git-readonly": {
|
|
238
242
|
id: "git-readonly",
|
|
239
|
-
title:
|
|
243
|
+
title: GIT_READONLY_TITLE,
|
|
240
244
|
rules: denyAll("shell_command", "command", [
|
|
241
245
|
...GIT_MUTATING_VERBS.flatMap(gitPatterns),
|
|
242
246
|
// `-c key=value` sets a config for one command, and core.pager or core.sshCommand run a program.
|
|
@@ -245,7 +249,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
|
|
|
245
249
|
},
|
|
246
250
|
"inline-interpreters": {
|
|
247
251
|
id: "inline-interpreters",
|
|
248
|
-
title:
|
|
252
|
+
title: INLINE_INTERPRETERS_TITLE,
|
|
249
253
|
// `*sh -c*` covers bash, sh, zsh, dash, ksh and fish behind a path or an `env`; `*sh -*c *` a flag cluster
|
|
250
254
|
// (bash -xc), `*sh -* -c*` a flag before `-c`; the same for the other interpreters. `ssh -c <cipher>` is
|
|
251
255
|
// refused too, a side effect of matching any word ending with `sh`. `python3.*` names a versioned python
|
|
@@ -261,7 +265,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
|
|
|
261
265
|
},
|
|
262
266
|
"read-noise": {
|
|
263
267
|
id: "read-noise",
|
|
264
|
-
title:
|
|
268
|
+
title: READ_NOISE_TITLE,
|
|
265
269
|
// Each folder twice: inside a path, and as the start of a path relative to the project.
|
|
266
270
|
rules: denyEach(PATH_READ_TOOLS, "path", [
|
|
267
271
|
"*/bin/*", "bin/*", "*/obj/*", "obj/*", "*/.git/*", ".git/*", "*/node_modules/*", "node_modules/*",
|
|
@@ -269,7 +273,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
|
|
|
269
273
|
},
|
|
270
274
|
secrets: {
|
|
271
275
|
id: "secrets",
|
|
272
|
-
title:
|
|
276
|
+
title: SECRETS_TITLE,
|
|
273
277
|
// The prefixes of SECRET_PATTERNS (secret-patterns.ts) a whole-content pattern can hold without refusing
|
|
274
278
|
// ordinary text; the others need a check of the content itself. edit_batch's texts sit in its
|
|
275
279
|
// operations, which the crews' callback reads as node_replace, node_insert or node_ensure texts.
|
|
@@ -284,7 +288,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
|
|
|
284
288
|
},
|
|
285
289
|
"state-files": {
|
|
286
290
|
id: "state-files",
|
|
287
|
-
title:
|
|
291
|
+
title: STATE_FILES_TITLE,
|
|
288
292
|
// Batch logs, batch states, verdicts and audit captures; the state folder's entries; the harness's deployed files.
|
|
289
293
|
rules: [
|
|
290
294
|
...denyEach(PATH_WRITE_TOOLS, "path", [
|
|
@@ -320,10 +324,10 @@ function normaliseRoot(raw: string): string {
|
|
|
320
324
|
}
|
|
321
325
|
|
|
322
326
|
function rootProblem(raw: string, root: string): string | undefined {
|
|
323
|
-
if (root === "") return
|
|
324
|
-
if (root.startsWith("/")) return
|
|
325
|
-
if (root.split("/").includes("..")) return
|
|
326
|
-
if (root.includes("*")) return
|
|
327
|
+
if (root === "") return rootWholeProject(raw);
|
|
328
|
+
if (root.startsWith("/")) return rootOutside(raw, WORKSPACE);
|
|
329
|
+
if (root.split("/").includes("..")) return rootClimbsOut(raw);
|
|
330
|
+
if (root.includes("*")) return rootHoldsStar(raw);
|
|
327
331
|
return undefined;
|
|
328
332
|
}
|
|
329
333
|
|
|
@@ -381,9 +385,9 @@ export function patternWriteRules(patterns: readonly string[]): PathRules {
|
|
|
381
385
|
const seen = new Set<string>();
|
|
382
386
|
for (const raw of patterns) {
|
|
383
387
|
const pattern = normaliseRoot(raw);
|
|
384
|
-
if (pattern === "" || pattern === "*") { problems.push(
|
|
385
|
-
if (pattern.startsWith("/")) { problems.push(
|
|
386
|
-
if (pattern.split("/").includes("..")) { problems.push(
|
|
388
|
+
if (pattern === "" || pattern === "*") { problems.push(patternWholeProject(raw)); continue; }
|
|
389
|
+
if (pattern.startsWith("/")) { problems.push(patternOutside(raw, WORKSPACE)); continue; }
|
|
390
|
+
if (pattern.split("/").includes("..")) { problems.push(patternClimbsOut(raw)); continue; }
|
|
387
391
|
if (seen.has(pattern)) continue;
|
|
388
392
|
seen.add(pattern);
|
|
389
393
|
rules.push(...denyEach(PATH_WRITE_TOOLS, "path", [`${WORKSPACE}/${pattern}`, pattern]));
|
|
@@ -3,7 +3,9 @@
|
|
|
3
3
|
// reads for `list_issues`, `get_pr`, `search_repos` and `get_repo`, executes for `create_issue`, `create_pr` and an
|
|
4
4
|
// unknown or missing action; `http_api` reads for `GET`, `HEAD`, `OPTIONS` and a missing method, executes for any
|
|
5
5
|
// other method and for a read method that carries a body or a method-override header; `web_search` reads whatever
|
|
6
|
-
// the call
|
|
6
|
+
// the call; `firefox` reads for the actions that only look (FIREFOX_READ_ACTIONS), executes for any other and for a
|
|
7
|
+
// missing one, its `screenshot` included: Orkeon declares that one an edit, which this table has no word for, and
|
|
8
|
+
// execute is the answer that lets no more through. The arguments are read as Orkeon reads them: a key matched case aside (`Method`, `BODY`), the action
|
|
7
9
|
// trimmed and compared case aside, the method compared case aside (an empty one is no read method), a body present
|
|
8
10
|
// whatever its content, an empty string included, and the headers' names taken from an object or from a JSON string
|
|
9
11
|
// holding one. `rag_eval` declares an edit whatever the call (it ingests its corpus and writes its reports), the
|
|
@@ -18,6 +20,11 @@ export type ToolAccess = "read" | "execute";
|
|
|
18
20
|
/** The `github` actions Orkeon reads for. */
|
|
19
21
|
export const GITHUB_READ_ACTIONS: readonly string[] = ["list_issues", "get_pr", "search_repos", "get_repo"];
|
|
20
22
|
|
|
23
|
+
/** The `firefox` actions Orkeon reads for. */
|
|
24
|
+
export const FIREFOX_READ_ACTIONS: readonly string[] = [
|
|
25
|
+
"navigate", "back", "snapshot", "read", "find", "search", "tabs", "new_tab", "switch_tab",
|
|
26
|
+
];
|
|
27
|
+
|
|
21
28
|
/** The `http_api` methods Orkeon reads for; a missing method is a GET. */
|
|
22
29
|
export const HTTP_READ_METHODS: readonly string[] = ["GET", "HEAD", "OPTIONS"];
|
|
23
30
|
|
|
@@ -59,12 +66,19 @@ const carriesMethodOverride = (headers: unknown): boolean => {
|
|
|
59
66
|
return headerNames(headers).some((name) => overrides.includes(name.toLowerCase()));
|
|
60
67
|
};
|
|
61
68
|
|
|
69
|
+
/** The tools whose access follows their `action`, with the actions that read. */
|
|
70
|
+
const READ_ACTIONS_OF: Readonly<Record<string, readonly string[]>> = {
|
|
71
|
+
github: GITHUB_READ_ACTIONS,
|
|
72
|
+
firefox: FIREFOX_READ_ACTIONS,
|
|
73
|
+
};
|
|
74
|
+
|
|
62
75
|
/** The access Orkeon declares for this call; null when the tool declares one access whatever the call, as its class says. */
|
|
63
76
|
export function declaredAccess(tool: string, input: unknown): ToolAccess | null {
|
|
64
77
|
if (READ_WHATEVER_THE_CALL.includes(tool)) return "read";
|
|
65
|
-
|
|
78
|
+
const readActions = READ_ACTIONS_OF[tool];
|
|
79
|
+
if (readActions) {
|
|
66
80
|
const action = field(input, "action");
|
|
67
|
-
return typeof action === "string" &&
|
|
81
|
+
return typeof action === "string" && readActions.includes(action.trim().toLowerCase()) ? "read" : "execute";
|
|
68
82
|
}
|
|
69
83
|
if (tool === "http_api") {
|
|
70
84
|
const method = field(input, "method");
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
// directory by the host, so listing them from a stored copy would go stale the
|
|
11
11
|
// moment a crew is added or renamed — the command merges the two at read time and
|
|
12
12
|
// labels which is which.
|
|
13
|
+
import { agentNeedsGoal, agentNeedsRole, DISCOVERED_IN_CREWS, invalidAgentName, shadowedByCrew } from "./messages.ts";
|
|
13
14
|
|
|
14
15
|
/** A saved agent definition. Deliberately small: the fields an agent needs to run. */
|
|
15
16
|
export interface SavedAgent {
|
|
@@ -42,13 +43,13 @@ export function validateSavedAgent(raw: {
|
|
|
42
43
|
if (!NAME_RE.test(name)) {
|
|
43
44
|
return {
|
|
44
45
|
ok: false,
|
|
45
|
-
reason:
|
|
46
|
+
reason: invalidAgentName(String(raw?.name ?? "")),
|
|
46
47
|
};
|
|
47
48
|
}
|
|
48
49
|
const role = String(raw?.role ?? "").trim();
|
|
49
50
|
const goal = String(raw?.goal ?? "").trim();
|
|
50
|
-
if (role.length === 0) return { ok: false, reason:
|
|
51
|
-
if (goal.length === 0) return { ok: false, reason:
|
|
51
|
+
if (role.length === 0) return { ok: false, reason: agentNeedsRole(name) };
|
|
52
|
+
if (goal.length === 0) return { ok: false, reason: agentNeedsGoal(name) };
|
|
52
53
|
|
|
53
54
|
const tools = Array.isArray(raw?.tools)
|
|
54
55
|
? [...new Set(raw.tools.map((t: unknown) => String(t ?? "").trim()).filter((t: string) => t.length > 0))]
|
|
@@ -127,14 +128,14 @@ export function describeAgentRows(
|
|
|
127
128
|
const rows = [...crews].sort().map((c) => ({
|
|
128
129
|
name: c,
|
|
129
130
|
kind: "crew (built-in)",
|
|
130
|
-
detail:
|
|
131
|
+
detail: DISCOVERED_IN_CREWS,
|
|
131
132
|
}));
|
|
132
133
|
for (const a of agents) {
|
|
133
134
|
rows.push({
|
|
134
135
|
name: a.name,
|
|
135
136
|
kind: "saved agent",
|
|
136
137
|
detail: crewNames.has(a.name.toLowerCase())
|
|
137
|
-
?
|
|
138
|
+
? shadowedByCrew(a.role)
|
|
138
139
|
: `${a.role} — ${a.goal}${a.tools.length > 0 ? ` [tools: ${a.tools.join(", ")}]` : ""}`,
|
|
139
140
|
});
|
|
140
141
|
}
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
// unexplained throw: the limit the host is configured with, never a default copied here. A driver that
|
|
7
7
|
// relaunches its own work passes `{ chain: "continue" }` to the launch (CrewLaunchOptions) and never meets
|
|
8
8
|
// the refusal. Pure.
|
|
9
|
+
import { chainLimitReached } from "./messages.ts";
|
|
9
10
|
|
|
10
11
|
const REFUSAL = /chain depth (\d+) reached \(MaxChainDepth (\d+)(?:, \/([^\s)]+))?\)/i;
|
|
11
12
|
|
|
@@ -25,6 +26,5 @@ export function chainDepthRefusal(error: unknown): ChainDepthRefusal | null {
|
|
|
25
26
|
/** The line a command shows for a refused hop. */
|
|
26
27
|
export function chainDepthLine(crew: string, refusal: ChainDepthRefusal): string {
|
|
27
28
|
const of = refusal.command === undefined ? "" : ` of /${refusal.command}`;
|
|
28
|
-
return
|
|
29
|
-
"Orkeon:Cli:ScriptCommands:MaxChainDepth); type the next step yourself.";
|
|
29
|
+
return chainLimitReached(crew, of, refusal.depth, refusal.limit);
|
|
30
30
|
}
|
|
@@ -6,6 +6,9 @@
|
|
|
6
6
|
import type { PermissionMode } from "../permission-modes.ts";
|
|
7
7
|
import { catalogueFor } from "../agent-policy/permission.ts";
|
|
8
8
|
import { policyFor } from "../agent-policy/mode-policy.ts";
|
|
9
|
+
import {
|
|
10
|
+
charterIterations, charterModeCanWrite, charterNameNotKebab, charterNoToolLeft, charterToolNotOffered,
|
|
11
|
+
} from "./messages.ts";
|
|
9
12
|
|
|
10
13
|
/** A check's outcome: the value, or what is wrong with it. */
|
|
11
14
|
export type Checked<T> = { ok: true; value: T } | { ok: false; problems: string[] };
|
|
@@ -43,19 +46,19 @@ export function charterCatalogue(charter: Charter): string[] {
|
|
|
43
46
|
export function charterProblems(charter: Charter): string[] {
|
|
44
47
|
const { name, mode, maxIterations } = charter;
|
|
45
48
|
const problems: string[] = [];
|
|
46
|
-
if (!CHARTER_NAME.test(name)) problems.push(
|
|
49
|
+
if (!CHARTER_NAME.test(name)) problems.push(charterNameNotKebab(name));
|
|
47
50
|
if (!policyFor(mode).readOnly) {
|
|
48
|
-
problems.push(
|
|
51
|
+
problems.push(charterModeCanWrite(name, mode));
|
|
49
52
|
}
|
|
50
53
|
const offered = new Set(offeredIn(mode));
|
|
51
54
|
for (const tool of charter.tools) {
|
|
52
|
-
if (!offered.has(tool)) problems.push(
|
|
55
|
+
if (!offered.has(tool)) problems.push(charterToolNotOffered(name, tool, mode));
|
|
53
56
|
}
|
|
54
57
|
if (charterCatalogue(charter).length === 0) {
|
|
55
|
-
problems.push(
|
|
58
|
+
problems.push(charterNoToolLeft(name));
|
|
56
59
|
}
|
|
57
60
|
if (!(Number.isInteger(maxIterations) && maxIterations >= 1 && maxIterations <= MAX_CHARTER_ITERATIONS)) {
|
|
58
|
-
problems.push(
|
|
61
|
+
problems.push(charterIterations(name, maxIterations));
|
|
59
62
|
}
|
|
60
63
|
return problems;
|
|
61
64
|
}
|
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
// ended: completed, failed, or stopped at its next cooperative checkpoint after a cancel (Orkeon #266), so a relaunch
|
|
6
6
|
// right after a cancel may still be refused. A command reads the crew and the ticket off the refusal through
|
|
7
7
|
// exclusiveRefusal and shows exclusiveLine, rather than failing on an unexplained throw. Pure.
|
|
8
|
+
import { alreadyRunning } from "./messages.ts";
|
|
8
9
|
|
|
9
10
|
const REFUSAL = /crew '([^']+)' already running \(ticket ([^\s)]+)\)/i;
|
|
10
11
|
|
|
@@ -20,5 +21,5 @@ export function exclusiveRefusal(error: unknown): ExclusiveRefusal | null {
|
|
|
20
21
|
|
|
21
22
|
/** The line a command shows for a crew refused because it already runs. */
|
|
22
23
|
export function exclusiveLine(refusal: ExclusiveRefusal): string {
|
|
23
|
-
return
|
|
24
|
+
return alreadyRunning(refusal.crew, refusal.ticket);
|
|
24
25
|
}
|
|
@@ -6,6 +6,11 @@
|
|
|
6
6
|
|
|
7
7
|
import { AGENT_INSTANCES_STATE_PREFIX, AGENT_REQUEST_STATE_PREFIX } from "../session-keys.ts";
|
|
8
8
|
import { MAX_BRIEF_CHARS } from "./charter.ts";
|
|
9
|
+
import {
|
|
10
|
+
namesAnInstanceOf, noAgentInstance, nothingToStop, RUN_STOPPED_ANSWERING, RUNNING_NO_LONGER_ANSWERING,
|
|
11
|
+
RUNNING_NOT_ANSWERING, RUNNING_STOP_ASKED, runNoLongerAnswers, runOfStarted, sendRefusedWhileRunning,
|
|
12
|
+
} from "./messages.ts";
|
|
13
|
+
import { CUT_MARK, noReport, REPAIR_INSTRUCTION, repairOpening } from "./prompts.ts";
|
|
9
14
|
|
|
10
15
|
export const INSTANCE_STATES = ["running", "completed", "failed", "stopped"] as const;
|
|
11
16
|
export type InstanceState = (typeof INSTANCE_STATES)[number];
|
|
@@ -124,7 +129,7 @@ export function settleSnapshot(s: RunSnapshot, now: Date): RunSnapshot {
|
|
|
124
129
|
if (!s.open || (Number.isFinite(age) && age <= SNAPSHOT_STALE_MS)) return s;
|
|
125
130
|
return {
|
|
126
131
|
...s, serving: false, open: false,
|
|
127
|
-
instances: s.instances.map((r) => r.state !== "running" ? r : { ...r, state: "failed", error:
|
|
132
|
+
instances: s.instances.map((r) => r.state !== "running" ? r : { ...r, state: "failed", error: RUN_STOPPED_ANSWERING }),
|
|
128
133
|
};
|
|
129
134
|
}
|
|
130
135
|
|
|
@@ -159,11 +164,11 @@ export function locateInstance(snapshots: readonly RunSnapshot[], ref: string):
|
|
|
159
164
|
? []
|
|
160
165
|
: snapshot.instances.filter((r) => r.id === id && id !== "").map((record) => ({ snapshot, record })));
|
|
161
166
|
if (found.length === 1) return { ok: true, found: found[0] };
|
|
162
|
-
if (found.length === 0) return { ok: false, text:
|
|
167
|
+
if (found.length === 0) return { ok: false, text: noAgentInstance(ref) };
|
|
163
168
|
return {
|
|
164
169
|
ok: false,
|
|
165
|
-
text:
|
|
166
|
-
.map((f) => `${f.snapshot.crew}:${id}`).join(" or ")
|
|
170
|
+
text: namesAnInstanceOf(ref, found.map((f) => f.snapshot.crew).join(" and "),
|
|
171
|
+
found.map((f) => `${f.snapshot.crew}:${id}`).join(" or ")),
|
|
167
172
|
};
|
|
168
173
|
}
|
|
169
174
|
|
|
@@ -171,8 +176,8 @@ const label = (l: Located): string => `${l.snapshot.crew}:${l.record.id}`;
|
|
|
171
176
|
|
|
172
177
|
/** Whether /tasks may ask the crew to stop the instance: only a running one, of a run still answering. */
|
|
173
178
|
export function stopVerdict(l: Located): { ok: true } | { ok: false; text: string } {
|
|
174
|
-
if (l.record.state !== "running") return { ok: false, text:
|
|
175
|
-
if (!l.snapshot.serving) return { ok: false, text:
|
|
179
|
+
if (l.record.state !== "running") return { ok: false, text: nothingToStop(label(l), l.record.state) };
|
|
180
|
+
if (!l.snapshot.serving) return { ok: false, text: runNoLongerAnswers(label(l)) };
|
|
176
181
|
return { ok: true };
|
|
177
182
|
}
|
|
178
183
|
|
|
@@ -183,13 +188,11 @@ export function stopVerdict(l: Located): { ok: true } | { ok: false; text: strin
|
|
|
183
188
|
*/
|
|
184
189
|
export function sendVerdict(l: Located): { kind: "refused"; text: string } | { kind: "repair" } {
|
|
185
190
|
if (l.record.state === "running") {
|
|
186
|
-
return { kind: "refused", text:
|
|
191
|
+
return { kind: "refused", text: sendRefusedWhileRunning(label(l), l.record.id) };
|
|
187
192
|
}
|
|
188
193
|
return { kind: "repair" };
|
|
189
194
|
}
|
|
190
195
|
|
|
191
|
-
const CUT_MARK = "[… the start is left out]\n";
|
|
192
|
-
|
|
193
196
|
/** The tail of `s` within `max` characters, the cut said in front. */
|
|
194
197
|
function tail(s: string, max: number): string {
|
|
195
198
|
if (s.length <= max) return s;
|
|
@@ -203,8 +206,8 @@ function tail(s: string, max: number): string {
|
|
|
203
206
|
*/
|
|
204
207
|
export function buildRepairBrief(record: InstanceRecord, message: string): string {
|
|
205
208
|
const head = [
|
|
206
|
-
|
|
207
|
-
|
|
209
|
+
repairOpening(record.charter, record.id || "?"),
|
|
210
|
+
REPAIR_INSTRUCTION,
|
|
208
211
|
"",
|
|
209
212
|
"## Operator's message",
|
|
210
213
|
message.trim(),
|
|
@@ -212,7 +215,7 @@ export function buildRepairBrief(record: InstanceRecord, message: string): strin
|
|
|
212
215
|
"## Previous report",
|
|
213
216
|
"",
|
|
214
217
|
].join("\n");
|
|
215
|
-
const report = record.reply ??
|
|
218
|
+
const report = record.reply ?? noReport(record.state, record.error ? `: ${record.error}` : "");
|
|
216
219
|
const briefHeading = "\n\n## Previous brief\n";
|
|
217
220
|
const forReport = MAX_BRIEF_CHARS - head.length - briefHeading.length;
|
|
218
221
|
const keptReport = tail(report, Math.max(0, forReport));
|
|
@@ -228,9 +231,9 @@ export function instanceRows(snapshots: readonly RunSnapshot[]): Array<Record<st
|
|
|
228
231
|
id: r.id || "?",
|
|
229
232
|
crew: s.crew,
|
|
230
233
|
agent: r.agent,
|
|
231
|
-
state: r.stopRequested && r.state === "running" ?
|
|
234
|
+
state: r.stopRequested && r.state === "running" ? RUNNING_STOP_ASKED : r.state,
|
|
232
235
|
task: r.task,
|
|
233
|
-
run: s.serving ? "answering" : s.open ?
|
|
236
|
+
run: s.serving ? "answering" : s.open ? RUNNING_NOT_ANSWERING : "ended",
|
|
234
237
|
})));
|
|
235
238
|
}
|
|
236
239
|
|
|
@@ -241,7 +244,7 @@ export function describeInstance(l: Located): string[] {
|
|
|
241
244
|
`${label(l)} — ${r.agent} (${r.charter}), ${r.state}${r.stopRequested && r.state === "running" ? ", stop asked" : ""}`,
|
|
242
245
|
`task: ${r.task}`,
|
|
243
246
|
`started ${r.startedAt}${r.endedAt ? `, ended ${r.endedAt}` : ""}${r.effort ? `, effort ${r.effort}` : ""}`,
|
|
244
|
-
|
|
247
|
+
runOfStarted(s.crew, s.startedAt, s.serving ? "answering /tasks" : s.open ? RUNNING_NO_LONGER_ANSWERING : "ended"),
|
|
245
248
|
];
|
|
246
249
|
if (r.error) lines.push(`error: ${r.error}`);
|
|
247
250
|
if (r.reply) lines.push("report:", r.reply);
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
// The text the agents and crews show the user: a refused launch, the problems of a charter, the answers of
|
|
2
|
+
// /tasks about an instance.
|
|
3
|
+
|
|
4
|
+
// ── Refused launches ────────────────────────────────────────────────────
|
|
5
|
+
|
|
6
|
+
export const chainLimitReached = (crew: string, of: string, depth: number, limit: number): string =>
|
|
7
|
+
`${crew} not launched: the chain of crews${of} reached its limit (depth ${depth}, limit ${limit}, ` +
|
|
8
|
+
"Orkeon:Cli:ScriptCommands:MaxChainDepth); type the next step yourself.";
|
|
9
|
+
export const alreadyRunning = (crew: string, ticket: string | number): string =>
|
|
10
|
+
`${crew} not launched: it is already running (ticket ${ticket}); wait for its result, then type the line again.`;
|
|
11
|
+
|
|
12
|
+
// ── The problems of a charter ───────────────────────────────────────────
|
|
13
|
+
|
|
14
|
+
export const charterNameNotKebab = (name: string): string => `charter name '${name}' is not a kebab-case name of 2 to 40 characters`;
|
|
15
|
+
export const charterModeCanWrite = (name: string, mode: string): string =>
|
|
16
|
+
`charter ${name}: mode ${mode} can write; a sub-agent runs read-only (plan or dontAsk) for now`;
|
|
17
|
+
export const charterToolNotOffered = (name: string, tool: string, mode: string): string =>
|
|
18
|
+
`charter ${name}: ${tool} is not offered in mode ${mode}`;
|
|
19
|
+
export const charterNoToolLeft = (name: string): string => `charter ${name}: no tool left once the mode and the disallowed list apply`;
|
|
20
|
+
export const charterIterations = (name: string, maxIterations: number): string =>
|
|
21
|
+
`charter ${name}: maxIterations ${maxIterations} is not between 1 and 80`;
|
|
22
|
+
|
|
23
|
+
// ── /tasks and the agent instances ──────────────────────────────────────
|
|
24
|
+
|
|
25
|
+
export const RUN_STOPPED_ANSWERING = "its run stopped answering";
|
|
26
|
+
export const noAgentInstance = (ref: string): string => `no agent instance '${ref}': /tasks lists them`;
|
|
27
|
+
export const namesAnInstanceOf = (ref: string, crews: string, choices: string): string =>
|
|
28
|
+
`'${ref}' names an instance of ${crews}: write ${choices}`;
|
|
29
|
+
export const nothingToStop = (label: string, state: string): string => `${label} is ${state}: there is nothing to stop`;
|
|
30
|
+
export const runNoLongerAnswers = (label: string): string => `${label}: its run no longer answers; it ends with the run`;
|
|
31
|
+
export const sendRefusedWhileRunning = (label: string, id: string): string =>
|
|
32
|
+
`${label} is running: a send is refused until it ends (/tasks stop ${id} ends it)`;
|
|
33
|
+
export const RUNNING_STOP_ASKED = "running (stop asked)";
|
|
34
|
+
export const RUNNING_NOT_ANSWERING = "running, not answering";
|
|
35
|
+
export const RUNNING_NO_LONGER_ANSWERING = "running, no longer answering";
|
|
36
|
+
export const runOfStarted = (crew: string, startedAt: string, state: string): string => `run of ${crew} started ${startedAt}: ${state}`;
|
|
37
|
+
export const ladderNeedsTwo = (value: string): string =>
|
|
38
|
+
`'${value}' is no ladder: name at least two profiles of the host, cheapest first, separated by commas (small,large)`;
|
|
39
|
+
export const ladderRepeats = (value: string): string => `'${value}' names a profile twice`;
|