thoth-agents 0.2.10 → 0.3.0

package/dist/cli/operations/opencode.d.ts

@@ -1,3 +1,4 @@
+import type { ProviderEvidenceInput } from '../../harness/types';
 import type { HarnessAction, HarnessStatusReport, ModelConfigInput, OperationApplyResult, OperationContext, OperationPlan } from './types';
 export declare const opencodeOperationAdapter: {
     readonly id: "opencode";
@@ -6,7 +7,7 @@ export declare const opencodeOperationAdapter: {
     readonly description: "OpenCode plugin and configuration surfaces.";
     readonly actions: HarnessAction[];
 };
-export declare function getOpenCodeStatus(context?: OperationContext): HarnessStatusReport;
+export declare function getOpenCodeStatus(context?: OperationContext, evidence?: ProviderEvidenceInput): HarnessStatusReport;
 export declare function buildOpenCodeUpdatePlan(_context?: OperationContext): OperationPlan;
 export declare function buildOpenCodeSyncPlan(_context?: OperationContext): OperationPlan;
 export declare function buildOpenCodeInstallPlan(_context?: OperationContext): OperationPlan;

package/dist/cli/operations/types.d.ts

@@ -1,4 +1,4 @@
-import type { HarnessId } from '../../harness/types';
+import type { HarnessId, ProviderCapabilityEvidence, ProviderEvidenceInput } from '../../harness/types';
 import type { EffortSelection } from '../model-effort';
 export type ManagedState = 'installed' | 'missing' | 'drift' | 'outdated' | 'unknown';
 export type OperationActionKind = 'status' | 'list' | 'install' | 'update' | 'sync' | 'repair' | 'model-config';
@@ -53,8 +53,16 @@ export interface HarnessStatusReport {
     targets: ManagedTarget[];
     diagnostics: OperationWarning[];
     actions: HarnessAction[];
+    /** Ephemeral provider evidence, kept separate from consumer-managed state. */
+    providerCapability?: ProviderCapabilityEvidence;
     disclaimers?: OperationDisclaimer[];
 }
+/**
+ * Classifies only evidence explicitly supplied by the caller. This function is
+ * intentionally pure: it performs no discovery, probing, persistence, setup,
+ * health checking, acquisition, migration, or fallback.
+ */
+export declare function classifyProviderCapabilityEvidence(input?: ProviderEvidenceInput): ProviderCapabilityEvidence;
 export type BackupStrategy = 'none' | 'managed-backup-file' | 'existing-helper' | 'external';
 export interface BackupExpectation {
     required: boolean;
@@ -80,6 +88,7 @@ export interface OperationPlan {
     dryRun: boolean;
     canApply: boolean;
     targets: ManagedTarget[];
+    blockerTargets?: ManagedTarget[];
     surfaces: ManagedSurface[];
     backup: BackupExpectation;
     items: OperationPlanItem[];
@@ -108,6 +117,7 @@ export interface OperationApplyResult {
     applied: boolean;
     summary: string;
     changedTargets: ManagedTarget[];
+    diagnosticTargets?: ManagedTarget[];
     backups: OperationPath[];
     warnings: OperationWarning[];
     disclaimers: OperationDisclaimer[];

package/dist/cli/package-root.d.ts

@@ -0,0 +1 @@
+export declare function findPackageRoot(startDir: string): string | null;

package/dist/cli/providers.d.ts

@@ -1,121 +1,11 @@
 import type { InstallConfig } from './types';
 export declare const THOTH_AGENTS_CONFIG_SCHEMA_URL = "https://unpkg.com/thoth-agents@latest/thoth-agents.schema.json";
+type ModelMapping = {
+    model: string;
+    variant?: string;
+};
 export declare const MODEL_MAPPINGS: {
-    readonly openai: {
-        readonly orchestrator: {
-            readonly model: "openai/gpt-5.4";
-        };
-        readonly oracle: {
-            readonly model: "openai/gpt-5.6-sol";
-            readonly variant: "high";
-        };
-        readonly librarian: {
-            readonly model: "openai/gpt-5.6-luna";
-            readonly variant: "low";
-        };
-        readonly explorer: {
-            readonly model: "openai/gpt-5.6-luna";
-            readonly variant: "low";
-        };
-        readonly designer: {
-            readonly model: "openai/gpt-5.6-terra";
-            readonly variant: "high";
-        };
-        readonly quick: {
-            readonly model: "openai/gpt-5.6-luna";
-            readonly variant: "medium";
-        };
-        readonly deep: {
-            readonly model: "openai/gpt-5.6-terra";
-            readonly variant: "xhigh";
-        };
-    };
-    readonly kimi: {
-        readonly orchestrator: {
-            readonly model: "kimi-for-coding/k2p5";
-        };
-        readonly oracle: {
-            readonly model: "kimi-for-coding/k2p5";
-            readonly variant: "high";
-        };
-        readonly librarian: {
-            readonly model: "kimi-for-coding/k2p5";
-            readonly variant: "low";
-        };
-        readonly explorer: {
-            readonly model: "kimi-for-coding/k2p5";
-            readonly variant: "low";
-        };
-        readonly designer: {
-            readonly model: "kimi-for-coding/k2p5";
-            readonly variant: "medium";
-        };
-        readonly quick: {
-            readonly model: "kimi-for-coding/k2p5";
-            readonly variant: "low";
-        };
-        readonly deep: {
-            readonly model: "kimi-for-coding/k2p5";
-            readonly variant: "high";
-        };
-    };
-    readonly copilot: {
-        readonly orchestrator: {
-            readonly model: "github-copilot/claude-opus-4.6";
-        };
-        readonly oracle: {
-            readonly model: "github-copilot/claude-opus-4.6";
-            readonly variant: "high";
-        };
-        readonly librarian: {
-            readonly model: "github-copilot/grok-code-fast-1";
-            readonly variant: "low";
-        };
-        readonly explorer: {
-            readonly model: "github-copilot/grok-code-fast-1";
-            readonly variant: "low";
-        };
-        readonly designer: {
-            readonly model: "github-copilot/gemini-3.1-pro-preview";
-            readonly variant: "medium";
-        };
-        readonly quick: {
-            readonly model: "github-copilot/claude-sonnet-4.6";
-            readonly variant: "low";
-        };
-        readonly deep: {
-            readonly model: "github-copilot/claude-opus-4.6";
-            readonly variant: "high";
-        };
-    };
-    readonly 'zai-plan': {
-        readonly orchestrator: {
-            readonly model: "zai-coding-plan/glm-5";
-        };
-        readonly oracle: {
-            readonly model: "zai-coding-plan/glm-5";
-            readonly variant: "high";
-        };
-        readonly librarian: {
-            readonly model: "zai-coding-plan/glm-5";
-            readonly variant: "low";
-        };
-        readonly explorer: {
-            readonly model: "zai-coding-plan/glm-5";
-            readonly variant: "low";
-        };
-        readonly designer: {
-            readonly model: "zai-coding-plan/glm-5";
-            readonly variant: "medium";
-        };
-        readonly quick: {
-            readonly model: "zai-coding-plan/glm-5";
-            readonly variant: "low";
-        };
-        readonly deep: {
-            readonly model: "zai-coding-plan/glm-5";
-            readonly variant: "high";
-        };
-    };
+    readonly openai: Record<string, ModelMapping>;
 };
 export declare function generateLiteConfig(installConfig: InstallConfig): Record<string, unknown>;
+export {};

package/dist/cli/skills.d.ts

@@ -1,43 +1,30 @@
-/**
- * A recommended skill to install via `npx skills add`.
- */
-export interface RecommendedSkill {
-    /** Human-readable name for prompts */
+export type SkillInstallHarness = 'opencode' | 'codex' | 'claude';
+/** An external skill required by every supported thoth-agents harness. */
+export interface RequiredSkill {
     name: string;
-    /** GitHub repo URL for `npx skills add` */
     repo: string;
-    /** Skill name within the repo (--skill flag) */
     skillName: string;
-    /** Description shown to user during install */
     description: string;
-    /** Optional commands to run after the skill is added */
-    postInstallCommands?: string[];
 }
-export type RecommendedSkillInstallStatus = 'installed' | 'already-installed' | 'failed';
-export interface RecommendedSkillInstallResult {
-    skill: RecommendedSkill;
-    status: RecommendedSkillInstallStatus;
+export type RequiredSkillInstallStatus = 'installed' | 'already-installed' | 'failed';
+export interface RequiredSkillInstallResult {
+    skill: RequiredSkill;
+    harness: SkillInstallHarness;
+    status: RequiredSkillInstallStatus;
     skillPath: string;
     error?: unknown;
 }
-interface InstallRecommendedSkillOptions {
+interface InstallRequiredSkillOptions {
     homeDir?: string;
 }
-/**
- * List of recommended skills.
- * Add new skills here to include them in the installation flow.
- */
-export declare const RECOMMENDED_SKILLS: RecommendedSkill[];
-export declare function getRecommendedSkillPath(skill: RecommendedSkill, homeDir?: string): string;
-export declare function isRecommendedSkillInstalled(skill: RecommendedSkill, options?: InstallRecommendedSkillOptions): boolean;
-/**
- * Install a recommended OpenCode skill with idempotent semantics.
- */
-export declare function installRecommendedSkill(skill: RecommendedSkill, options?: InstallRecommendedSkillOptions): RecommendedSkillInstallResult;
-/**
- * Install a skill using `npx skills add`.
- * @param skill - The skill to install
- * @returns True if installation succeeded, false otherwise
- */
-export declare function installSkill(skill: RecommendedSkill): boolean;
+export declare const REQUIRED_SKILLS: readonly RequiredSkill[];
+export declare function getRequiredSkillPath(skill: RequiredSkill, harness: SkillInstallHarness, homeDir?: string): string;
+export declare function isRequiredSkillInstalled(skill: RequiredSkill, harness: SkillInstallHarness, options?: InstallRequiredSkillOptions): boolean;
+export declare function getRequiredSkillInstallCommand(skill: RequiredSkill, harness: SkillInstallHarness): {
+    command: 'npx';
+    args: string[];
+};
+/** Install one mandatory skill into the selected harness's global skill root. */
+export declare function installRequiredSkill(skill: RequiredSkill, harness: SkillInstallHarness, options?: InstallRequiredSkillOptions): RequiredSkillInstallResult;
+export declare function installRequiredSkills(harness: SkillInstallHarness, options?: InstallRequiredSkillOptions): RequiredSkillInstallResult[];
 export {};

package/dist/cli/thoth-mem-install.d.ts

@@ -0,0 +1,45 @@
+import type { InstallAgent } from './types';
+export declare const THOTH_MEM_SETUP_TIMEOUT_MS = 120000;
+export type ThothMemSetupStatus = 'complete' | 'failed' | 'partial' | 'requires_user_action';
+export type ThothMemSetupOutcome = 'planned' | 'skipped' | 'confirmed' | 'failed' | 'unavailable';
+export interface ThothMemSetupStep {
+    name: string;
+    outcome: ThothMemSetupOutcome;
+}
+export interface ThothMemCommandResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    error?: unknown;
+}
+export type ThothMemCommandExecutor = (command: string, args: readonly string[], options: {
+    cwd?: string;
+    timeoutMs: number;
+}) => ThothMemCommandResult;
+export interface ThothMemSetupOptions {
+    harness: InstallAgent;
+    dryRun?: boolean;
+    cwd?: string;
+    commandExecutor?: ThothMemCommandExecutor;
+}
+export interface ThothMemSetupResult {
+    success: boolean;
+    evidenceValid: boolean;
+    status: ThothMemSetupStatus | 'invalid';
+    changed: boolean;
+    harness: InstallAgent;
+    target?: string;
+    steps: ThothMemSetupStep[];
+    diagnostics: string[];
+    manualActions: string[];
+    receipt: string | null;
+    command: 'npx';
+    args: string[];
+    exitCode: number | null;
+    error?: string;
+}
+export declare function getThothMemSetupCommand(harness: InstallAgent, dryRun: boolean): {
+    command: 'npx';
+    args: string[];
+};
+export declare function runThothMemSetup(options: ThothMemSetupOptions): ThothMemSetupResult;

package/dist/cli/tui/components/StatusView.d.ts

@@ -1,7 +1,18 @@
+import type { ProviderCapabilityEvidence } from '../../../harness/types';
 import type { HarnessStatusReport } from '../../operations';
 export type StatusSection = 'targets' | 'warnings' | 'disclaimers';
 interface StatusViewProps {
     report: HarnessStatusReport;
+    providerEvidence?: ProviderCapabilityEvidence;
+    providerEvidenceLoading?: boolean;
+    providerEvidenceError?: string;
 }
-export declare function StatusView({ report }: StatusViewProps): import("react/jsx-runtime").JSX.Element;
+interface ProviderCapabilityViewProps {
+    evidence?: ProviderCapabilityEvidence;
+    loading?: boolean;
+    error?: string;
+    showHeading?: boolean;
+}
+export declare function ProviderCapabilityView({ evidence, loading, error, showHeading, }: ProviderCapabilityViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatusView({ report, providerEvidence, providerEvidenceLoading, providerEvidenceError, }: StatusViewProps): import("react/jsx-runtime").JSX.Element;
 export {};