@terminai/core 0.21.0

package/dist/src/brain/reflectiveCritique.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerativeModelAdapter } from './riskAssessor.js';
+/**
+ * Implements the Verificative (Reflective Critique) framework.
+ * Framework ID: FW_REFLECT
+ */
+export declare class ReflectiveCritique {
+    private readonly model;
+    constructor(model: GenerativeModelAdapter);
+    /**
+     * Generates a solution and then critiques it.
+     * @param task the task to solve
+     * @returns solution and critique
+     */
+    generateAndCritique(task: string): Promise<{
+        solution: string;
+        critique: string;
+    }>;
+    /**
+     * Refines a solution based on a critique.
+     */
+    refine(solution: string, critique: string): Promise<string>;
+}

package/dist/src/brain/reflectiveCritique.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Implements the Verificative (Reflective Critique) framework.
+ * Framework ID: FW_REFLECT
+ */
+export class ReflectiveCritique {
+    model;
+    constructor(model) {
+        this.model = model;
+    }
+    /**
+     * Generates a solution and then critiques it.
+     * @param task the task to solve
+     * @returns solution and critique
+     */
+    async generateAndCritique(task) {
+        const genPrompt = `Generate a solution for: "${task}"`;
+        const genResponse = await this.model.generateContent(genPrompt, {
+            tier: 'flash',
+        });
+        const solution = genResponse.response.text();
+        const critiquePrompt = `Critique this solution for bugs, security risks, and edge cases:
+${solution}`;
+        const critiqueResponse = await this.model.generateContent(critiquePrompt, {
+            tier: 'pro',
+        });
+        const critique = critiqueResponse.response.text();
+        return { solution, critique };
+    }
+    /**
+     * Refines a solution based on a critique.
+     */
+    async refine(solution, critique) {
+        const prompt = `Refine this solution based on the following critique:
+Original Solution:
+${solution}
+
+Critique:
+${critique}
+
+Provide the refined solution.`;
+        const response = await this.model.generateContent(prompt, { tier: 'pro' });
+        return response.response.text();
+    }
+}
+//# sourceMappingURL=reflectiveCritique.js.map

package/dist/src/brain/reflectiveCritique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflectiveCritique.js","sourceRoot":"","sources":["../../../src/brain/reflectiveCritique.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,KAA6B;QAA7B,UAAK,GAAL,KAAK,CAAwB;IAAG,CAAC;IAE9D;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CACvB,IAAY;QAEZ,MAAM,SAAS,GAAG,6BAA6B,IAAI,GAAG,CAAC;QACvD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,EAAE;YAC9D,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE7C,MAAM,cAAc,GAAG;EACzB,QAAQ,EAAE,CAAC;QACT,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,cAAc,EAAE;YACxE,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAElD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,QAAgB;QAC7C,MAAM,MAAM,GAAG;;EAEjB,QAAQ;;;EAGR,QAAQ;;8BAEoB,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;CACF"}

package/dist/src/brain/riskAssessor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Minimal interface for LLM generation, compatible with the adapter built in shell.ts.
+ * This avoids importing GenerativeModel which doesn't exist in @google/genai v1.30+.
+ */
+export interface GenerativeModelAdapter {
+    generateContent: (prompt: string, options?: {
+        abortSignal?: AbortSignal;
+        tier?: 'flash' | 'pro';
+    }) => Promise<{
+        response: {
+            text: () => string;
+        };
+    }>;
+}
+export interface RiskDimensions {
+    uniqueness: number;
+    complexity: number;
+    irreversibility: number;
+    consequences: number;
+    confidence: number;
+    environment: 'dev' | 'staging' | 'prod' | 'unknown';
+}
+export interface RiskAssessment {
+    dimensions: RiskDimensions;
+    overallRisk: 'trivial' | 'normal' | 'elevated' | 'critical';
+    reasoning: string;
+    suggestedStrategy: 'fast-path' | 'preview' | 'iterate' | 'plan-snapshot';
+}
+export declare function assessRiskHeuristic(command: string): Partial<RiskDimensions> | null;
+export declare function calculateOverallRisk(dimensions: RiskDimensions): RiskAssessment['overallRisk'];
+export declare function selectStrategy(risk: RiskAssessment['overallRisk'], env: RiskDimensions['environment']): RiskAssessment['suggestedStrategy'];
+export declare function assessRiskWithLLM(request: string, systemContext: string, model: GenerativeModelAdapter): Promise<RiskDimensions & {
+    reasoning: string;
+}>;
+export declare function assessRisk(request: string, command: string | null, systemContext: string, model?: GenerativeModelAdapter): Promise<RiskAssessment>;

package/dist/src/brain/riskAssessor.js

@@ -0,0 +1,185 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { detectEnvironment } from './environmentDetector.js';
+import { matchCommonPattern } from './patterns.js';
+import { RISK_ASSESSMENT_PROMPT } from './prompts/riskAssessment.js';
+import { getHistoricalContext } from './historyTracker.js';
+const DEFAULT_SCORE = 50;
+function clamp(value, min = 0, max = 100) {
+    if (Number.isNaN(value))
+        return min;
+    return Math.min(Math.max(value, min), max);
+}
+function applyDefaults(partial, environment) {
+    return {
+        uniqueness: clamp(partial.uniqueness ?? DEFAULT_SCORE),
+        complexity: clamp(partial.complexity ?? DEFAULT_SCORE),
+        irreversibility: clamp(partial.irreversibility ?? DEFAULT_SCORE),
+        consequences: clamp(partial.consequences ?? DEFAULT_SCORE),
+        confidence: clamp(partial.confidence ?? DEFAULT_SCORE),
+        environment,
+    };
+}
+export function assessRiskHeuristic(command) {
+    return matchCommonPattern(command);
+}
+export function calculateOverallRisk(dimensions) {
+    const score = (dimensions.irreversibility * 0.35 +
+        dimensions.consequences * 0.35 +
+        dimensions.complexity * 0.15 +
+        dimensions.uniqueness * 0.15) *
+        (1 - dimensions.confidence / 200);
+    if (score < 15)
+        return 'trivial';
+    if (score < 40)
+        return 'normal';
+    if (score < 70)
+        return 'elevated';
+    return 'critical';
+}
+export function selectStrategy(risk, env) {
+    const envMultiplier = env === 'prod' ? 1.5 : env === 'staging' ? 1.2 : 1;
+    if (risk === 'trivial')
+        return 'fast-path';
+    if (risk === 'normal')
+        return envMultiplier > 1.2 ? 'preview' : 'fast-path';
+    if (risk === 'elevated')
+        return 'preview';
+    return 'plan-snapshot';
+}
+function parseResponseText(responseText) {
+    const trimmed = responseText.trim();
+    if (!trimmed) {
+        throw new Error('Empty response');
+    }
+    const tryParse = (candidate) => {
+        try {
+            return JSON.parse(candidate);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse risk assessment response: ${error.message}`);
+        }
+    };
+    // 1) Common case: plain JSON.
+    try {
+        return tryParse(trimmed);
+    }
+    catch {
+        // continue
+    }
+    // 2) JSON in a fenced code block.
+    const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
+    if (fenced?.[1]) {
+        const inner = fenced[1].trim();
+        try {
+            return tryParse(inner);
+        }
+        catch {
+            // continue
+        }
+    }
+    // 3) JSON object embedded in extra text (e.g. preamble + JSON + epilogue).
+    const firstBrace = trimmed.indexOf('{');
+    const lastBrace = trimmed.lastIndexOf('}');
+    if (firstBrace !== -1 && lastBrace !== -1 && lastBrace > firstBrace) {
+        return tryParse(trimmed.slice(firstBrace, lastBrace + 1));
+    }
+    throw new Error('No JSON object found in response');
+}
+function readResponseText(response, fallbackReason) {
+    const rawText = typeof response.response
+        ?.text === 'function'
+        ? response.response.text()
+        : // Some implementations may return the text directly on response
+            response.response?.text;
+    if (!rawText) {
+        return { text: '', reasoning: fallbackReason };
+    }
+    return { text: rawText, reasoning: undefined };
+}
+export async function assessRiskWithLLM(request, systemContext, model) {
+    const prompt = RISK_ASSESSMENT_PROMPT.replace('{request}', request).replace('{systemContext}', systemContext);
+    const result = await model.generateContent(prompt);
+    const { text, reasoning: defaultReasoning } = readResponseText(result, 'LLM returned empty response');
+    const parsed = parseResponseText(text);
+    const reasoning = typeof parsed['reasoning'] === 'string'
+        ? parsed['reasoning']
+        : (defaultReasoning ?? 'LLM risk assessment');
+    return {
+        uniqueness: clamp(Number(parsed['uniqueness'])),
+        complexity: clamp(Number(parsed['complexity'])),
+        irreversibility: clamp(Number(parsed['irreversibility'])),
+        consequences: clamp(Number(parsed['consequences'])),
+        confidence: clamp(Number(parsed['confidence'])),
+        environment: 'unknown',
+        reasoning,
+    };
+}
+function applyHistoricalAdjustment(dimensions, command) {
+    if (!command) {
+        return { dimensions };
+    }
+    const history = getHistoricalContext(command);
+    if (history.confidenceAdjustment !== 0) {
+        dimensions = {
+            ...dimensions,
+            confidence: clamp(dimensions.confidence + history.confidenceAdjustment, 0, 100),
+        };
+    }
+    return {
+        dimensions,
+        historyNote: history.reasoning,
+    };
+}
+function buildReasoning(base, historyNote) {
+    if (historyNote) {
+        return `${base}. ${historyNote}`;
+    }
+    return base;
+}
+export async function assessRisk(request, command, systemContext, model) {
+    const environment = detectEnvironment();
+    const heuristic = command ? assessRiskHeuristic(command) : null;
+    if (heuristic && heuristic.confidence && heuristic.confidence > 80) {
+        const dimensionsWithDefaults = applyDefaults(heuristic, environment);
+        const { dimensions, historyNote } = applyHistoricalAdjustment(dimensionsWithDefaults, command);
+        const overallRisk = calculateOverallRisk(dimensions);
+        return {
+            dimensions,
+            overallRisk,
+            reasoning: buildReasoning('Matched known pattern', historyNote),
+            suggestedStrategy: selectStrategy(overallRisk, dimensions.environment),
+        };
+    }
+    let dimensions;
+    let reasoning = 'Using heuristic fallback';
+    const heuristicFallback = heuristic ?? {};
+    if (model) {
+        try {
+            const llmResult = await assessRiskWithLLM(request, systemContext, model);
+            dimensions = applyDefaults(llmResult, environment);
+            reasoning = llmResult.reasoning;
+        }
+        catch (error) {
+            dimensions = applyDefaults(heuristicFallback, environment);
+            reasoning = `LLM risk assessment failed: ${error.message}. Using heuristic defaults.`;
+        }
+    }
+    else {
+        dimensions = applyDefaults(heuristicFallback, environment);
+        reasoning = 'No model available; using heuristic defaults.';
+    }
+    const historical = applyHistoricalAdjustment(dimensions, command);
+    const overallRisk = calculateOverallRisk(historical.dimensions);
+    return {
+        dimensions: historical.dimensions,
+        overallRisk,
+        reasoning: buildReasoning(reasoning, historical.historyNote),
+        suggestedStrategy: selectStrategy(overallRisk, historical.dimensions.environment),
+    };
+}
+//# sourceMappingURL=riskAssessor.js.map

package/dist/src/brain/riskAssessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"riskAssessor.js","sourceRoot":"","sources":["../../../src/brain/riskAssessor.ts"],"names":[],"mappings":"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"}

package/dist/src/brain/sequentialThinking.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerativeModelAdapter } from './riskAssessor.js';
+/**
+ * Implements the Logic Chain (Sequential Thinking) framework.
+ * Framework ID: FW_SEQUENTIAL
+ */
+export declare class SequentialThinking {
+    private readonly model;
+    constructor(model: GenerativeModelAdapter);
+    /**
+     * Orchestrates a step in the sequential thinking process.
+     * @param task The task being solved
+     * @param history Previous steps and observations
+     * @returns Next hypothesis and action
+     */
+    nextStep(task: string, history: string[]): Promise<{
+        hypothesis: string;
+        test: string;
+    }>;
+}

package/dist/src/brain/sequentialThinking.js

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Implements the Logic Chain (Sequential Thinking) framework.
+ * Framework ID: FW_SEQUENTIAL
+ */
+export class SequentialThinking {
+    model;
+    constructor(model) {
+        this.model = model;
+    }
+    /**
+     * Orchestrates a step in the sequential thinking process.
+     * @param task The task being solved
+     * @param history Previous steps and observations
+     * @returns Next hypothesis and action
+     */
+    async nextStep(task, history) {
+        const prompt = `
+Task: "${task}"
+Progress:
+${history.join('\n')}
+
+Based on the progress so far, provide:
+1. A hypothesis about the current state or root cause.
+2. A diagnostic command or test to verify the hypothesis.
+
+Respond in JSON format:
+{
+  "hypothesis": "your hypothesis",
+  "test": "command to run"
+}
+    `;
+        const response = await this.model.generateContent(prompt);
+        const text = response.response.text();
+        try {
+            const jsonMatch = text.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                return JSON.parse(jsonMatch[0]);
+            }
+        }
+        catch {
+            // Ignore parsing failures
+        }
+        return { hypothesis: 'Checking system state', test: 'ls -R' };
+    }
+}
+//# sourceMappingURL=sequentialThinking.js.map

package/dist/src/brain/sequentialThinking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequentialThinking.js","sourceRoot":"","sources":["../../../src/brain/sequentialThinking.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,KAA6B;QAA7B,UAAK,GAAL,KAAK,CAAwB;IAAG,CAAC;IAE9D;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,OAAiB;QAEjB,MAAM,MAAM,GAAG;SACV,IAAI;;EAEX,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;KAWf,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAC5C,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAChE,CAAC;CACF"}

package/dist/src/brain/stepBackEvaluator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConsensusOrchestrator } from './consensus.js';
+import type { SystemSpec } from './systemSpec.js';
+import type { AdvisorProposal } from './advisors/types.js';
+/**
+ * Evaluates failures and triggers step-back logic.
+ */
+export declare class StepBackEvaluator {
+    private static readonly MAX_FAILURES;
+    /**
+     * Determines if a step-back is required based on failure count.
+     * @param failureCount Current consecutive failures
+     * @returns True if step-back should be triggered
+     */
+    shouldStepBack(failureCount: number): boolean;
+    /**
+     * Logic to handle the step-back by re-routing to the orchestrator.
+     * @param task The user task
+     * @param failedApproach The approach that failed
+     * @param orchestrator The consensus orchestrator to pick a new approach
+     * @param systemSpec Current system spec
+     * @returns A new advisor proposal
+     */
+    handleStepBack(task: string, failedApproach: string, orchestrator: ConsensusOrchestrator, systemSpec: SystemSpec): Promise<AdvisorProposal>;
+}

package/dist/src/brain/stepBackEvaluator.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Evaluates failures and triggers step-back logic.
+ */
+export class StepBackEvaluator {
+    static MAX_FAILURES = 2;
+    /**
+     * Determines if a step-back is required based on failure count.
+     * @param failureCount Current consecutive failures
+     * @returns True if step-back should be triggered
+     */
+    shouldStepBack(failureCount) {
+        return failureCount >= StepBackEvaluator.MAX_FAILURES;
+    }
+    /**
+     * Logic to handle the step-back by re-routing to the orchestrator.
+     * @param task The user task
+     * @param failedApproach The approach that failed
+     * @param orchestrator The consensus orchestrator to pick a new approach
+     * @param systemSpec Current system spec
+     * @returns A new advisor proposal
+     */
+    async handleStepBack(task, failedApproach, orchestrator, systemSpec) {
+        console.log(`Approach "${failedApproach}" failed twice. Re-evaluating strategy...`);
+        // In a more advanced implementation, we could blacklist the failed approach
+        // or pass it as "failed" to the orchestrator to avoid loops.
+        return orchestrator.selectApproach(task, systemSpec);
+    }
+}
+//# sourceMappingURL=stepBackEvaluator.js.map

package/dist/src/brain/stepBackEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepBackEvaluator.js","sourceRoot":"","sources":["../../../src/brain/stepBackEvaluator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAU,YAAY,GAAG,CAAC,CAAC;IAEzC;;;;OAIG;IACH,cAAc,CAAC,YAAoB;QACjC,OAAO,YAAY,IAAI,iBAAiB,CAAC,YAAY,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,IAAY,EACZ,cAAsB,EACtB,YAAmC,EACnC,UAAsB;QAEtB,OAAO,CAAC,GAAG,CACT,aAAa,cAAc,2CAA2C,CACvE,CAAC;QAEF,4EAA4E;QAC5E,6DAA6D;QAC7D,OAAO,YAAY,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC"}

package/dist/src/brain/systemSpec.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Information about a software runtime (e.g., Node.js, Python).
+ */
+export interface RuntimeInfo {
+    version: string;
+    npm?: string;
+    pip?: boolean;
+    venv?: boolean;
+}
+/**
+ * Information about a system binary.
+ */
+export interface BinaryInfo {
+    path: string;
+    version?: string;
+}
+/**
+ * Complete system specification representing machine capabilities.
+ */
+export interface SystemSpec {
+    os: {
+        name: string;
+        version: string;
+        arch: string;
+    };
+    shell: {
+        type: 'bash' | 'zsh' | 'powershell' | 'fish' | 'unknown';
+        version: string;
+    };
+    runtimes: {
+        node?: RuntimeInfo;
+        python?: RuntimeInfo;
+        ruby?: RuntimeInfo;
+        go?: RuntimeInfo;
+        rust?: RuntimeInfo;
+    };
+    binaries: {
+        [name: string]: BinaryInfo;
+    };
+    packageManagers: Array<'apt' | 'brew' | 'dnf' | 'pacman' | 'choco' | 'npm' | 'pip' | 'cargo' | 'go' | 'gem'>;
+    sudoAvailable: boolean;
+    network: {
+        hasInternet: boolean;
+        proxy?: string;
+    };
+    timestamp: number;
+}
+/**
+ * Scans the system for available capabilities (asynchronous).
+ * @returns Complete system specification
+ */
+export declare function scanSystem(): Promise<SystemSpec>;
+/**
+ * Scans the system for available capabilities (synchronous).
+ * @returns Complete system specification
+ */
+export declare function scanSystemSync(): SystemSpec;
+/**
+ * Saves the system spec to the cache file.
+ */
+export declare function saveSystemSpec(spec: SystemSpec): void;
+/**
+ * Loads the system spec from the cache file.
+ */
+export declare function loadSystemSpec(): SystemSpec | null;
+/**
+ * Checks if the system spec is older than 24 hours.
+ */
+export declare function isSpecStale(spec: SystemSpec): boolean;