thoth-agents 0.2.11 → 0.3.1

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 (149) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/.claude-plugin/marketplace.json +21 -0
  3. package/README.md +301 -311
  4. package/dist/agents/configured-role-prompt.d.ts +9 -0
  5. package/dist/agents/prompt-sections.d.ts +8 -4
  6. package/dist/agents/prompt-utils.d.ts +0 -4
  7. package/dist/{chunk-ASKXWU6E.js → chunk-2MZ5C2RN.js} +1078 -1725
  8. package/dist/chunk-XO74DXBZ.js +1781 -0
  9. package/dist/{chunk-6BNAV534.js → chunk-YUCGIJPP.js} +12 -30
  10. package/dist/cli/claude-code-install.d.ts +24 -26
  11. package/dist/cli/claude-code-paths.d.ts +0 -28
  12. package/dist/cli/codex-install.d.ts +2 -2
  13. package/dist/cli/codex-paths.d.ts +0 -2
  14. package/dist/cli/index.js +279 -119
  15. package/dist/cli/install.d.ts +5 -1
  16. package/dist/cli/model-catalog/cache.d.ts +1 -1
  17. package/dist/cli/operations/claude-code.d.ts +6 -3
  18. package/dist/cli/operations/codex.d.ts +2 -1
  19. package/dist/cli/operations/opencode.d.ts +2 -1
  20. package/dist/cli/operations/types.d.ts +9 -1
  21. package/dist/cli/package-root.d.ts +1 -0
  22. package/dist/cli/providers.d.ts +6 -116
  23. package/dist/cli/skills.d.ts +19 -32
  24. package/dist/cli/thoth-mem-install.d.ts +45 -0
  25. package/dist/cli/tui/components/StatusView.d.ts +12 -1
  26. package/dist/cli/tui/index.js +256 -142
  27. package/dist/cli/tui/operations.d.ts +4 -3
  28. package/dist/cli/types.d.ts +0 -10
  29. package/dist/config/constants.d.ts +20 -16
  30. package/dist/config/index.d.ts +0 -1
  31. package/dist/config/loader.d.ts +1 -1
  32. package/dist/config/schema.d.ts +2 -38
  33. package/dist/config/utils.d.ts +1 -2
  34. package/dist/harness/adapters/codex-surfaces.d.ts +3 -3
  35. package/dist/harness/core/agent-pack.d.ts +37 -29
  36. package/dist/harness/core/memory-governance.d.ts +24 -48
  37. package/dist/harness/core/sdd.d.ts +364 -131
  38. package/dist/harness/generate-integration-packages.d.ts +20 -0
  39. package/dist/harness/opencode-init-command.d.ts +11 -0
  40. package/dist/harness/types.d.ts +14 -1
  41. package/dist/harness/writers/claude-code-subagent.d.ts +3 -1
  42. package/dist/hooks/index.d.ts +0 -5
  43. package/dist/index.js +562 -1314
  44. package/dist/mcp/index.d.ts +1 -2
  45. package/package.json +17 -12
  46. package/plugin/.claude-plugin/.thoth-agents-plugin-assets.json +50 -0
  47. package/plugin/.claude-plugin/plugin.json +8 -0
  48. package/plugin/.codex-plugin/.thoth-agents-plugin-assets.json +16 -0
  49. package/plugin/.codex-plugin/plugin.json +7 -0
  50. package/plugin/.mcp.json +19 -0
  51. package/plugin/agents/deep.md +89 -0
  52. package/plugin/agents/designer.md +89 -0
  53. package/plugin/agents/explorer.md +90 -0
  54. package/plugin/agents/librarian.md +90 -0
  55. package/plugin/agents/oracle.md +92 -0
  56. package/plugin/agents/orchestrator.md +128 -0
  57. package/plugin/agents/quick.md +89 -0
  58. package/plugin/codex.mcp.json +17 -0
  59. package/plugin/settings.json +3 -0
  60. package/plugin/skills/thoth-archive/SKILL.md +40 -0
  61. package/plugin/skills/thoth-archive/scripts/archive.mjs +748 -0
  62. package/plugin/skills/thoth-constitution/SKILL.md +45 -0
  63. package/plugin/skills/thoth-constitution/scripts/validate.mjs +167 -0
  64. package/plugin/skills/thoth-constitution/templates/constitution.md +54 -0
  65. package/plugin/skills/thoth-init/SKILL.md +30 -0
  66. package/plugin/skills/thoth-init/scripts/init.mjs +141 -0
  67. package/plugin/skills/thoth-sdd/SKILL.md +83 -0
  68. package/plugin/skills/thoth-sdd/references/phases/analyze.md +21 -0
  69. package/plugin/skills/thoth-sdd/references/phases/checklist.md +20 -0
  70. package/plugin/skills/thoth-sdd/references/phases/clarify.md +15 -0
  71. package/plugin/skills/thoth-sdd/references/phases/converge.md +14 -0
  72. package/plugin/skills/thoth-sdd/references/phases/explore.md +10 -0
  73. package/plugin/skills/thoth-sdd/references/phases/implement.md +19 -0
  74. package/plugin/skills/thoth-sdd/references/phases/plan.md +15 -0
  75. package/plugin/skills/thoth-sdd/references/phases/specify.md +21 -0
  76. package/plugin/skills/thoth-sdd/references/phases/tasks.md +20 -0
  77. package/plugin/skills/thoth-sdd/references/phases/verify.md +22 -0
  78. package/plugin/skills/thoth-sdd/scripts/validate.mjs +1117 -0
  79. package/plugin/skills/thoth-sdd/templates/archive-report.md +25 -0
  80. package/plugin/skills/thoth-sdd/templates/checklist.md +27 -0
  81. package/plugin/skills/thoth-sdd/templates/plan.md +38 -0
  82. package/plugin/skills/thoth-sdd/templates/spec.md +54 -0
  83. package/plugin/skills/thoth-sdd/templates/tasks.md +29 -0
  84. package/plugin/skills/thoth-sdd/templates/verify-report.md +28 -0
  85. package/skills/README.md +12 -0
  86. package/skills/thoth-archive/SKILL.md +40 -0
  87. package/skills/thoth-archive/scripts/archive.mjs +748 -0
  88. package/skills/thoth-constitution/SKILL.md +45 -0
  89. package/skills/thoth-constitution/scripts/validate.mjs +167 -0
  90. package/skills/thoth-constitution/templates/constitution.md +54 -0
  91. package/skills/thoth-init/SKILL.md +30 -0
  92. package/skills/thoth-init/scripts/init.mjs +141 -0
  93. package/skills/thoth-sdd/SKILL.md +83 -0
  94. package/skills/thoth-sdd/references/phases/analyze.md +21 -0
  95. package/skills/thoth-sdd/references/phases/checklist.md +20 -0
  96. package/skills/thoth-sdd/references/phases/clarify.md +15 -0
  97. package/skills/thoth-sdd/references/phases/converge.md +14 -0
  98. package/skills/thoth-sdd/references/phases/explore.md +10 -0
  99. package/skills/thoth-sdd/references/phases/implement.md +19 -0
  100. package/skills/thoth-sdd/references/phases/plan.md +15 -0
  101. package/skills/thoth-sdd/references/phases/specify.md +21 -0
  102. package/skills/thoth-sdd/references/phases/tasks.md +20 -0
  103. package/skills/thoth-sdd/references/phases/verify.md +22 -0
  104. package/skills/thoth-sdd/scripts/validate.mjs +1117 -0
  105. package/skills/thoth-sdd/templates/archive-report.md +25 -0
  106. package/skills/thoth-sdd/templates/checklist.md +27 -0
  107. package/skills/thoth-sdd/templates/plan.md +38 -0
  108. package/skills/thoth-sdd/templates/spec.md +54 -0
  109. package/skills/thoth-sdd/templates/tasks.md +29 -0
  110. package/skills/thoth-sdd/templates/verify-report.md +28 -0
  111. package/thoth-agents.schema.json +0 -39
  112. package/dist/chunk-OZE7JVGS.js +0 -2344
  113. package/dist/cli/custom-skills.d.ts +0 -49
  114. package/dist/cli/skill-manifest.d.ts +0 -32
  115. package/dist/harness/core/skills.d.ts +0 -211
  116. package/dist/harness/generate-codex-plugin.d.ts +0 -9
  117. package/dist/harness/writers/claude-code-skill-layout.d.ts +0 -16
  118. package/dist/harness/writers/fs-skill-collect.d.ts +0 -7
  119. package/dist/harness/writers/skill-layout.d.ts +0 -16
  120. package/dist/hooks/chat-headers.d.ts +0 -16
  121. package/dist/hooks/phase-reminder/index.d.ts +0 -28
  122. package/dist/hooks/post-read-nudge/index.d.ts +0 -18
  123. package/dist/hooks/skill-sync.d.ts +0 -10
  124. package/dist/hooks/thoth-mem/index.d.ts +0 -46
  125. package/dist/hooks/thoth-mem/protocol.d.ts +0 -7
  126. package/dist/mcp/thoth.d.ts +0 -3
  127. package/dist/sdd/artifact-governance/artifact-loader.d.ts +0 -130
  128. package/dist/sdd/artifact-governance/index.d.ts +0 -6
  129. package/dist/sdd/artifact-governance/tasks-validator.d.ts +0 -17
  130. package/dist/sdd/artifact-governance/types.d.ts +0 -52
  131. package/dist/thoth/client.d.ts +0 -14
  132. package/dist/thoth/index.d.ts +0 -2
  133. package/src/skills/_shared/openspec-convention.md +0 -350
  134. package/src/skills/_shared/persistence-contract.md +0 -163
  135. package/src/skills/_shared/thoth-mem-convention.md +0 -123
  136. package/src/skills/executing-plans/SKILL.md +0 -288
  137. package/src/skills/plan-reviewer/SKILL.md +0 -219
  138. package/src/skills/requirements-interview/SKILL.md +0 -233
  139. package/src/skills/sdd-apply/SKILL.md +0 -89
  140. package/src/skills/sdd-archive/SKILL.md +0 -92
  141. package/src/skills/sdd-clarify/SKILL.md +0 -105
  142. package/src/skills/sdd-constitution/SKILL.md +0 -107
  143. package/src/skills/sdd-design/SKILL.md +0 -155
  144. package/src/skills/sdd-init/SKILL.md +0 -233
  145. package/src/skills/sdd-propose/SKILL.md +0 -101
  146. package/src/skills/sdd-spec/SKILL.md +0 -136
  147. package/src/skills/sdd-tasks/SKILL.md +0 -232
  148. package/src/skills/sdd-verify/SKILL.md +0 -131
  149. package/src/skills/thoth-mem-agents/SKILL.md +0 -210
@@ -1,121 +1,11 @@
1
1
  import type { InstallConfig } from './types';
2
2
  export declare const THOTH_AGENTS_CONFIG_SCHEMA_URL = "https://unpkg.com/thoth-agents@latest/thoth-agents.schema.json";
3
+ type ModelMapping = {
4
+ model: string;
5
+ variant?: string;
6
+ };
3
7
  export declare const MODEL_MAPPINGS: {
4
- readonly openai: {
5
- readonly orchestrator: {
6
- readonly model: "openai/gpt-5.4";
7
- };
8
- readonly oracle: {
9
- readonly model: "openai/gpt-5.6-sol";
10
- readonly variant: "high";
11
- };
12
- readonly librarian: {
13
- readonly model: "openai/gpt-5.6-luna";
14
- readonly variant: "low";
15
- };
16
- readonly explorer: {
17
- readonly model: "openai/gpt-5.6-luna";
18
- readonly variant: "low";
19
- };
20
- readonly designer: {
21
- readonly model: "openai/gpt-5.6-terra";
22
- readonly variant: "high";
23
- };
24
- readonly quick: {
25
- readonly model: "openai/gpt-5.6-luna";
26
- readonly variant: "medium";
27
- };
28
- readonly deep: {
29
- readonly model: "openai/gpt-5.6-terra";
30
- readonly variant: "xhigh";
31
- };
32
- };
33
- readonly kimi: {
34
- readonly orchestrator: {
35
- readonly model: "kimi-for-coding/k2p5";
36
- };
37
- readonly oracle: {
38
- readonly model: "kimi-for-coding/k2p5";
39
- readonly variant: "high";
40
- };
41
- readonly librarian: {
42
- readonly model: "kimi-for-coding/k2p5";
43
- readonly variant: "low";
44
- };
45
- readonly explorer: {
46
- readonly model: "kimi-for-coding/k2p5";
47
- readonly variant: "low";
48
- };
49
- readonly designer: {
50
- readonly model: "kimi-for-coding/k2p5";
51
- readonly variant: "medium";
52
- };
53
- readonly quick: {
54
- readonly model: "kimi-for-coding/k2p5";
55
- readonly variant: "low";
56
- };
57
- readonly deep: {
58
- readonly model: "kimi-for-coding/k2p5";
59
- readonly variant: "high";
60
- };
61
- };
62
- readonly copilot: {
63
- readonly orchestrator: {
64
- readonly model: "github-copilot/claude-opus-4.6";
65
- };
66
- readonly oracle: {
67
- readonly model: "github-copilot/claude-opus-4.6";
68
- readonly variant: "high";
69
- };
70
- readonly librarian: {
71
- readonly model: "github-copilot/grok-code-fast-1";
72
- readonly variant: "low";
73
- };
74
- readonly explorer: {
75
- readonly model: "github-copilot/grok-code-fast-1";
76
- readonly variant: "low";
77
- };
78
- readonly designer: {
79
- readonly model: "github-copilot/gemini-3.1-pro-preview";
80
- readonly variant: "medium";
81
- };
82
- readonly quick: {
83
- readonly model: "github-copilot/claude-sonnet-4.6";
84
- readonly variant: "low";
85
- };
86
- readonly deep: {
87
- readonly model: "github-copilot/claude-opus-4.6";
88
- readonly variant: "high";
89
- };
90
- };
91
- readonly 'zai-plan': {
92
- readonly orchestrator: {
93
- readonly model: "zai-coding-plan/glm-5";
94
- };
95
- readonly oracle: {
96
- readonly model: "zai-coding-plan/glm-5";
97
- readonly variant: "high";
98
- };
99
- readonly librarian: {
100
- readonly model: "zai-coding-plan/glm-5";
101
- readonly variant: "low";
102
- };
103
- readonly explorer: {
104
- readonly model: "zai-coding-plan/glm-5";
105
- readonly variant: "low";
106
- };
107
- readonly designer: {
108
- readonly model: "zai-coding-plan/glm-5";
109
- readonly variant: "medium";
110
- };
111
- readonly quick: {
112
- readonly model: "zai-coding-plan/glm-5";
113
- readonly variant: "low";
114
- };
115
- readonly deep: {
116
- readonly model: "zai-coding-plan/glm-5";
117
- readonly variant: "high";
118
- };
119
- };
8
+ readonly openai: Record<string, ModelMapping>;
120
9
  };
121
10
  export declare function generateLiteConfig(installConfig: InstallConfig): Record<string, unknown>;
11
+ export {};
@@ -1,43 +1,30 @@
1
- /**
2
- * A recommended skill to install via `npx skills add`.
3
- */
4
- export interface RecommendedSkill {
5
- /** Human-readable name for prompts */
1
+ export type SkillInstallHarness = 'opencode' | 'codex' | 'claude';
2
+ /** An external skill required by every supported thoth-agents harness. */
3
+ export interface RequiredSkill {
6
4
  name: string;
7
- /** GitHub repo URL for `npx skills add` */
8
5
  repo: string;
9
- /** Skill name within the repo (--skill flag) */
10
6
  skillName: string;
11
- /** Description shown to user during install */
12
7
  description: string;
13
- /** Optional commands to run after the skill is added */
14
- postInstallCommands?: string[];
15
8
  }
16
- export type RecommendedSkillInstallStatus = 'installed' | 'already-installed' | 'failed';
17
- export interface RecommendedSkillInstallResult {
18
- skill: RecommendedSkill;
19
- status: RecommendedSkillInstallStatus;
9
+ export type RequiredSkillInstallStatus = 'installed' | 'already-installed' | 'failed';
10
+ export interface RequiredSkillInstallResult {
11
+ skill: RequiredSkill;
12
+ harness: SkillInstallHarness;
13
+ status: RequiredSkillInstallStatus;
20
14
  skillPath: string;
21
15
  error?: unknown;
22
16
  }
23
- interface InstallRecommendedSkillOptions {
17
+ interface InstallRequiredSkillOptions {
24
18
  homeDir?: string;
25
19
  }
26
- /**
27
- * List of recommended skills.
28
- * Add new skills here to include them in the installation flow.
29
- */
30
- export declare const RECOMMENDED_SKILLS: RecommendedSkill[];
31
- export declare function getRecommendedSkillPath(skill: RecommendedSkill, homeDir?: string): string;
32
- export declare function isRecommendedSkillInstalled(skill: RecommendedSkill, options?: InstallRecommendedSkillOptions): boolean;
33
- /**
34
- * Install a recommended OpenCode skill with idempotent semantics.
35
- */
36
- export declare function installRecommendedSkill(skill: RecommendedSkill, options?: InstallRecommendedSkillOptions): RecommendedSkillInstallResult;
37
- /**
38
- * Install a skill using `npx skills add`.
39
- * @param skill - The skill to install
40
- * @returns True if installation succeeded, false otherwise
41
- */
42
- export declare function installSkill(skill: RecommendedSkill): boolean;
20
+ export declare const REQUIRED_SKILLS: readonly RequiredSkill[];
21
+ export declare function getRequiredSkillPath(skill: RequiredSkill, harness: SkillInstallHarness, homeDir?: string): string;
22
+ export declare function isRequiredSkillInstalled(skill: RequiredSkill, harness: SkillInstallHarness, options?: InstallRequiredSkillOptions): boolean;
23
+ export declare function getRequiredSkillInstallCommand(skill: RequiredSkill, harness: SkillInstallHarness): {
24
+ command: 'npx';
25
+ args: string[];
26
+ };
27
+ /** Install one mandatory skill into the selected harness's global skill root. */
28
+ export declare function installRequiredSkill(skill: RequiredSkill, harness: SkillInstallHarness, options?: InstallRequiredSkillOptions): RequiredSkillInstallResult;
29
+ export declare function installRequiredSkills(harness: SkillInstallHarness, options?: InstallRequiredSkillOptions): RequiredSkillInstallResult[];
43
30
  export {};
@@ -0,0 +1,45 @@
1
+ import type { InstallAgent } from './types';
2
+ export declare const THOTH_MEM_SETUP_TIMEOUT_MS = 120000;
3
+ export type ThothMemSetupStatus = 'complete' | 'failed' | 'partial' | 'requires_user_action';
4
+ export type ThothMemSetupOutcome = 'planned' | 'skipped' | 'confirmed' | 'failed' | 'unavailable';
5
+ export interface ThothMemSetupStep {
6
+ name: string;
7
+ outcome: ThothMemSetupOutcome;
8
+ }
9
+ export interface ThothMemCommandResult {
10
+ exitCode: number | null;
11
+ stdout: string;
12
+ stderr: string;
13
+ error?: unknown;
14
+ }
15
+ export type ThothMemCommandExecutor = (command: string, args: readonly string[], options: {
16
+ cwd?: string;
17
+ timeoutMs: number;
18
+ }) => ThothMemCommandResult;
19
+ export interface ThothMemSetupOptions {
20
+ harness: InstallAgent;
21
+ dryRun?: boolean;
22
+ cwd?: string;
23
+ commandExecutor?: ThothMemCommandExecutor;
24
+ }
25
+ export interface ThothMemSetupResult {
26
+ success: boolean;
27
+ evidenceValid: boolean;
28
+ status: ThothMemSetupStatus | 'invalid';
29
+ changed: boolean;
30
+ harness: InstallAgent;
31
+ target?: string;
32
+ steps: ThothMemSetupStep[];
33
+ diagnostics: string[];
34
+ manualActions: string[];
35
+ receipt: string | null;
36
+ command: 'npx';
37
+ args: string[];
38
+ exitCode: number | null;
39
+ error?: string;
40
+ }
41
+ export declare function getThothMemSetupCommand(harness: InstallAgent, dryRun: boolean): {
42
+ command: 'npx';
43
+ args: string[];
44
+ };
45
+ export declare function runThothMemSetup(options: ThothMemSetupOptions): ThothMemSetupResult;
@@ -1,7 +1,18 @@
1
+ import type { ProviderCapabilityEvidence } from '../../../harness/types';
1
2
  import type { HarnessStatusReport } from '../../operations';
2
3
  export type StatusSection = 'targets' | 'warnings' | 'disclaimers';
3
4
  interface StatusViewProps {
4
5
  report: HarnessStatusReport;
6
+ providerEvidence?: ProviderCapabilityEvidence;
7
+ providerEvidenceLoading?: boolean;
8
+ providerEvidenceError?: string;
5
9
  }
6
- export declare function StatusView({ report }: StatusViewProps): import("react/jsx-runtime").JSX.Element;
10
+ interface ProviderCapabilityViewProps {
11
+ evidence?: ProviderCapabilityEvidence;
12
+ loading?: boolean;
13
+ error?: string;
14
+ showHeading?: boolean;
15
+ }
16
+ export declare function ProviderCapabilityView({ evidence, loading, error, showHeading, }: ProviderCapabilityViewProps): import("react/jsx-runtime").JSX.Element;
17
+ export declare function StatusView({ report, providerEvidence, providerEvidenceLoading, providerEvidenceError, }: StatusViewProps): import("react/jsx-runtime").JSX.Element;
7
18
  export {};