@10et/cli 1.0.0

package/dist/lib/stratus-client.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Stratus X1 Reasoning API Client
+ *
+ * Provides reasoning-based analysis and synthesis capabilities
+ * for Context Hub journal entries and project documentation.
+ * Extended with world model dynamics prediction support.
+ *
+ * @purpose Client for calling Stratus X1 reasoning API to synthesize context and predict dynamics
+ */
+import type { WorldState, AgentAction, PredictionResult, StateTransition, CounterfactualScenario } from "../types/world-model.js";
+/**
+ * Response from Stratus API
+ */
+export interface StratusResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: string;
+            content: string;
+        };
+        finish_reason: string;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    stratus?: {
+        model: string;
+        execution_llm: string;
+        confidence: number;
+        planning_time_ms: number;
+        execution_time_ms: number;
+    };
+}
+interface JournalEntry {
+    v?: number;
+    ts?: string;
+    session?: string;
+    type?: string;
+    status?: string;
+    title?: string;
+    summary?: string;
+    detail?: string;
+    files?: string[];
+    decision?: string;
+    incomplete?: string[];
+    next?: string;
+    learned?: string[];
+}
+interface SynthesisResult {
+    summary: string;
+    decisions: Array<{
+        decision: string;
+        rationale: string;
+    }>;
+    problemsSolved: Array<{
+        problem: string;
+        solution: string;
+    }>;
+    incompleteItems: string[];
+    nextSteps: string[];
+    rawResponse: string;
+    confidence?: number;
+    executionTime?: number;
+}
+export declare class StratusClient {
+    private baseUrl;
+    private apiKey;
+    private model;
+    private timeout;
+    private circuitBreaker;
+    /**
+     * Check if circuit breaker is open (should skip Stratus calls)
+     */
+    isCircuitOpen(): boolean;
+    /**
+     * Record a failure for circuit breaker
+     */
+    private recordFailure;
+    /**
+     * Record a success for circuit breaker
+     */
+    private recordSuccess;
+    private readDotenv;
+    constructor(options?: {
+        baseUrl?: string;
+        apiKey?: string;
+        model?: string;
+        timeout?: number;
+    });
+    /**
+     * Call Stratus reasoning API with a prompt
+     */
+    reason(prompt: string, options?: {
+        temperature?: number;
+        maxTokens?: number;
+        featureContext?: string;
+    }): Promise<StratusResponse>;
+    /**
+     * Synthesize journal entries into structured summary
+     */
+    synthesizeJournalEntries(entries: JournalEntry[], options?: {
+        focus?: "decisions" | "problems" | "progress" | "all";
+    }): Promise<SynthesisResult>;
+    /**
+     * Parse Stratus response into structured format
+     */
+    private parseStructuredSummary;
+    /**
+     * Format synthesis result as human-readable text
+     */
+    formatSynthesis(synthesis: SynthesisResult): string;
+    /**
+     * Predict the outcome of an action given the current state
+     * Used by dynamics-model.ts when historical aggregation isn't sufficient
+     *
+     * NOTE: Uses temperature=0 for prediction consistency per refinements doc.
+     * Circuit-breaker: if Stratus fails 3x in 5 min, returns fallback immediately.
+     *
+     * @param state - Current world state
+     * @param action - Action to predict outcome for
+     * @param context - Optional similar historical transitions for context
+     * @returns Predicted outcome with confidence and reasoning
+     */
+    predictOutcome(state: WorldState, action: AgentAction, context?: StateTransition[]): Promise<PredictionResult>;
+    /**
+     * Validate prediction response structure
+     */
+    private validatePredictionResponse;
+    /**
+     * Generate counterfactual scenarios for a completed transition
+     *
+     * @param transition - The actual transition that occurred
+     * @param alternativeActions - Alternative actions to evaluate
+     * @returns Array of counterfactual scenarios
+     */
+    generateCounterfactuals(transition: StateTransition, alternativeActions: AgentAction[]): Promise<CounterfactualScenario[]>;
+    /**
+     * Simulate a multi-step trajectory from a starting state
+     *
+     * @param state - Starting state
+     * @param actionSequence - Sequence of actions to simulate
+     * @param maxSteps - Maximum steps to simulate
+     * @returns Simulated trajectory of state transitions
+     */
+    simulateTrajectory(state: WorldState, actionSequence: AgentAction[], maxSteps?: number): Promise<StateTransition[]>;
+    /**
+     * Format WorldState for prompt
+     */
+    private formatWorldStateForPrompt;
+    /**
+     * Format AgentAction for prompt
+     */
+    private formatActionForPrompt;
+    /**
+     * Format WorldOutcome for prompt
+     */
+    private formatOutcomeForPrompt;
+    /**
+     * Format historical transitions for context
+     */
+    private formatContextTransitions;
+    /**
+     * Determine counterfactual type
+     */
+    private determineCounterfactualType;
+    /**
+     * Parse JSON from LLM response (handles markdown code blocks)
+     */
+    private parseJsonFromResponse;
+}
+export {};
+//# sourceMappingURL=stratus-client.d.ts.map

package/dist/lib/stratus-client.d.ts.map

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