thoth-agents 0.6.0 → 0.8.0

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.
Files changed (85) hide show
  1. package/README.md +7 -1
  2. package/dist/agents/prompt-dialects.d.ts +3 -1
  3. package/dist/{chunk-OW6I7ZUU.js → chunk-4DZSWTUM.js} +337 -155
  4. package/dist/{chunk-7YCSKK2X.js → chunk-5LW4CNA5.js} +4053 -2989
  5. package/dist/{chunk-U7FNFTM5.js → chunk-P7R4GDSO.js} +39 -38
  6. package/dist/{chunk-MRFCA3U2.js → chunk-ZLEMG37R.js} +2 -1
  7. package/dist/cli/codex-config-io.d.ts +34 -2
  8. package/dist/cli/codex-hook-consent.d.ts +5 -0
  9. package/dist/cli/codex-hook-trust.d.ts +23 -0
  10. package/dist/cli/codex-install.d.ts +21 -6
  11. package/dist/cli/codex-lifecycle.d.ts +13 -0
  12. package/dist/cli/codex-plugin-install.d.ts +21 -0
  13. package/dist/cli/index.js +538 -43
  14. package/dist/cli/managed-state-io.d.ts +19 -0
  15. package/dist/cli/operations/codex.d.ts +2 -0
  16. package/dist/cli/operations/types.d.ts +1 -1
  17. package/dist/cli/pi-install.d.ts +1 -0
  18. package/dist/cli/safe-atomic-write.d.ts +2 -0
  19. package/dist/cli/tui/index.js +56 -5
  20. package/dist/cli/tui/operations.d.ts +3 -1
  21. package/dist/cli/types.d.ts +4 -1
  22. package/dist/config/constants.d.ts +30 -3
  23. package/dist/config/schema.d.ts +4 -0
  24. package/dist/harness/adapters/claude-code.d.ts +1 -1
  25. package/dist/harness/adapters/codex-legacy-agents.d.ts +31 -0
  26. package/dist/harness/adapters/codex-surfaces.d.ts +1 -1
  27. package/dist/harness/adapters/codex.d.ts +3 -1
  28. package/dist/harness/codex-hook-script.d.ts +2 -0
  29. package/dist/harness/core/agent-pack.d.ts +8 -2
  30. package/dist/harness/core/result-contract.d.ts +366 -0
  31. package/dist/harness/core/sdd.d.ts +1 -1
  32. package/dist/harness/writers/codex-plugin-package.d.ts +7 -0
  33. package/dist/harness/writers/pi-agent.d.ts +1 -0
  34. package/dist/index.js +2 -2
  35. package/dist/pi.js +2 -2
  36. package/package.json +5 -3
  37. package/pi/.thoth-agents-assets.json +5 -5
  38. package/pi/agents/thoth-designer.md +15 -20
  39. package/pi/agents/thoth-explorer.md +15 -19
  40. package/pi/agents/thoth-librarian.md +15 -19
  41. package/pi/agents/thoth-oracle.md +30 -22
  42. package/pi/agents/thoth-worker.md +13 -18
  43. package/plugin/.claude-plugin/.thoth-agents-plugin-assets.json +6 -6
  44. package/plugin/.claude-plugin/plugin.json +1 -1
  45. package/plugin/.codex-plugin/.thoth-agents-plugin-assets.json +48 -0
  46. package/plugin/.codex-plugin/plugin.json +3 -2
  47. package/plugin/agents/designer.md +9 -14
  48. package/plugin/agents/explorer.md +10 -14
  49. package/plugin/agents/librarian.md +9 -13
  50. package/plugin/agents/oracle.md +24 -18
  51. package/plugin/agents/orchestrator.md +38 -61
  52. package/plugin/agents/worker.md +9 -14
  53. package/plugin/codex-hooks/context.cjs +22 -0
  54. package/plugin/codex-hooks/hooks.json +32 -0
  55. package/plugin/codex-hooks/payloads/designer.md +72 -0
  56. package/plugin/codex-hooks/payloads/explorer.md +76 -0
  57. package/plugin/codex-hooks/payloads/librarian.md +76 -0
  58. package/plugin/codex-hooks/payloads/oracle.md +83 -0
  59. package/plugin/codex-hooks/payloads/root.md +105 -0
  60. package/plugin/codex-hooks/payloads/worker.md +72 -0
  61. package/plugin/skills/plan-reviewer/SKILL.md +16 -8
  62. package/plugin/skills/thoth-archive/SKILL.md +2 -1
  63. package/plugin/skills/thoth-constitution/SKILL.md +1 -1
  64. package/plugin/skills/thoth-constitution/templates/constitution.md +1 -1
  65. package/plugin/skills/thoth-init/SKILL.md +1 -1
  66. package/plugin/skills/thoth-sdd/SKILL.md +67 -2
  67. package/plugin/skills/thoth-sdd/references/phases/verify.md +11 -1
  68. package/plugin/skills/thoth-sdd/scripts/result-contract.json +210 -0
  69. package/plugin/skills/thoth-sdd/scripts/validate-result.d.mts +47 -0
  70. package/plugin/skills/thoth-sdd/scripts/validate-result.mjs +390 -0
  71. package/plugin/skills/thoth-sdd/scripts/validate.mjs +213 -8
  72. package/plugin/skills/thoth-sdd/templates/change.md +8 -0
  73. package/skills/plan-reviewer/SKILL.md +16 -8
  74. package/skills/thoth-archive/SKILL.md +2 -1
  75. package/skills/thoth-constitution/SKILL.md +1 -1
  76. package/skills/thoth-constitution/templates/constitution.md +1 -1
  77. package/skills/thoth-init/SKILL.md +1 -1
  78. package/skills/thoth-sdd/SKILL.md +67 -2
  79. package/skills/thoth-sdd/references/phases/verify.md +11 -1
  80. package/skills/thoth-sdd/scripts/result-contract.json +210 -0
  81. package/skills/thoth-sdd/scripts/validate-result.d.mts +47 -0
  82. package/skills/thoth-sdd/scripts/validate-result.mjs +390 -0
  83. package/skills/thoth-sdd/scripts/validate.mjs +213 -8
  84. package/skills/thoth-sdd/templates/change.md +8 -0
  85. package/thoth-agents.schema.json +14 -0
package/README.md CHANGED
@@ -90,7 +90,12 @@ lists, including registered active and inactive extension and MCP tools. Thoth
90
90
  supplies managed-specialist validation and reset defaults through an optional adapter. Globs (including `*`) are
91
91
  manual advanced selections over all registered root tools; the panel preserves
92
92
  them read-only. Edit `disallowed_tools` manually for injected tools and trimming
93
- globs; only Oracle denies `ask_orchestrator` by default. See
93
+ globs; only Oracle denies `ask_orchestrator` by default, while all five roles keep
94
+ `notify_orchestrator`. Child `ask_orchestrator({ message })` carries blocking
95
+ questions only; `notify_orchestrator({ message })` records one-way progress or
96
+ checkpoints and returns immediately without a root turn. Both are `model-only`
97
+ direct calls, independently controlled by `enable_ask_orchestrator` and
98
+ `enable_notify_orchestrator` (default true, global/project cascade) and denials. See
94
99
  [tool selection controls](docs/installation.md#configure-specialist-tools-inside-pi).
95
100
 
96
101
  Pi setup currently supports the default `~/.pi/agent` root. See the
@@ -203,6 +208,7 @@ uncertainty, and risk and selects the fitting specialist.
203
208
 
204
209
  | Designer | Worker |
205
210
  | :---: | :---: |
211
+ | <img src="img/agents/designer.webp" width="150" alt="Hathor as the Designer"> | <img src="img/agents/worker.webp" width="150" alt="Ptah as the Worker"> |
206
212
  | **Makes interfaces work well.** Owns material UI/UX, accessibility, interaction, and visual quality. | **Implements changes.** Owns delegated implementation, including coupled behavior, edge cases, migrations, and correctness-critical work. |
207
213
 
208
214
  Research and review specialists are read-only. Implementation work has one
@@ -1,7 +1,8 @@
1
- import type { AgentDispatchMethod, AgentRoleName } from '../harness/core/agent-pack';
1
+ import { type AgentDispatchMethod, type AgentRoleName } from '../harness/core/agent-pack';
2
2
  import type { HarnessCapabilities, HarnessId } from '../harness/types';
3
3
  export type AgentPromptRole = AgentRoleName;
4
4
  export interface LifecycleNomenclature {
5
+ rootInstructions?: string;
5
6
  freshDelegation: string;
6
7
  sameAssignmentContinuation: string;
7
8
  independentContext: string;
@@ -18,6 +19,7 @@ export interface ToolNomenclature {
18
19
  backgroundWaitInstruction?: string;
19
20
  userQuestionTool: string;
20
21
  progressTool?: string;
22
+ progressStatusInstruction?: string;
21
23
  hostStatusSurface?: string;
22
24
  lifecycle: LifecycleNomenclature;
23
25
  roleReference(role: AgentPromptRole): string;