@hongmaple0820/scale-engine 0.29.0 → 0.38.0

package/dist/runtime/AiOsRuntime.d.ts

@@ -4,6 +4,11 @@ import { type GovernanceMode, type ProgressiveGovernanceReport } from '../govern
 import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
 import { type ContextPack as MemoryContextPack, type MemoryProviderRecallItem } from '../memory/index.js';
 import { type SkillPlan, type SkillTaskLevel } from '../skills/routing/index.js';
+import { type WorkflowProfile } from '../workflow/AdaptiveWorkflowRouter.js';
+import { type GovernanceRoiSummary } from '../workflow/GovernanceRoi.js';
+import { type EvolutionShadowReport } from '../workflow/EvolutionShadowPromoter.js';
+import { type LearningEntry } from '../evolution/SessionLearnings.js';
+import { type SessionPreamble } from '../workflow/SessionPreamble.js';
 export interface AiOsRuntimeInput {
     projectDir?: string;
     scaleDir?: string;
@@ -37,11 +42,67 @@ export interface AiOsMemoryRuntimeSummary {
 }
 export interface AiOsAdaptiveWorkflow {
     strategy: 'risk-adaptive-runtime-v1';
+    profile: WorkflowProfile;
+    escalationReasons: string[];
     mode: GovernanceMode;
     requiredBehaviors: string[];
     gates: string[];
     exitCriteria: string[];
 }
+export type AiOsEvaluatorGateId = 'architecture-critique' | 'root-cause-review' | 'security-threat-model' | 'release-readiness-review' | 'uncertainty-decision-log';
+export interface AiOsEvaluatorGate {
+    id: AiOsEvaluatorGateId;
+    required: boolean;
+    reason: string;
+    evidence: string[];
+}
+export interface AiOsEvaluatorIntelligence {
+    strategy: 'evaluator-intelligence-v1';
+    required: boolean;
+    riskLevel: 'low' | 'medium' | 'high';
+    uncertainty: {
+        score: number;
+        threshold: number;
+        drivers: string[];
+    };
+    gates: AiOsEvaluatorGate[];
+    recommendations: string[];
+}
+export type AiOsToolStrategyRisk = 'low' | 'medium' | 'high';
+export interface AiOsToolStrategyNode {
+    id: string;
+    kind: SkillPlan['executionPlan']['steps'][number]['kind'];
+    required: boolean;
+    cost: {
+        units: number;
+        timeRisk: AiOsToolStrategyRisk;
+        sideEffectRisk: AiOsToolStrategyRisk;
+    };
+    retry: {
+        maxAttempts: number;
+        backoff: 'none' | 'linear' | 'manual-review';
+    };
+    fallback: string;
+    evidence: string[];
+}
+export interface AiOsToolStrategyEdge {
+    from: string;
+    to: string;
+    reason: string;
+}
+export interface AiOsToolStrategyPlan {
+    strategy: 'tool-strategy-v1';
+    nodes: AiOsToolStrategyNode[];
+    edges: AiOsToolStrategyEdge[];
+    summary: {
+        totalSteps: number;
+        requiredSteps: number;
+        highRiskSteps: number;
+        estimatedCostUnits: number;
+        fallbackCoveredSteps: number;
+    };
+    recommendations: string[];
+}
 export interface AiOsRuntimePlan {
     version: string;
     generatedAt: string;
@@ -52,11 +113,16 @@ export interface AiOsRuntimePlan {
         files: string[];
         services: string[];
     };
+    preamble: SessionPreamble;
     governance: ProgressiveGovernanceReport;
     adaptiveWorkflow: AiOsAdaptiveWorkflow;
+    evaluator: AiOsEvaluatorIntelligence;
+    toolStrategy: AiOsToolStrategyPlan;
+    evolutionShadow: EvolutionShadowReport;
     context: BudgetedContextPack;
     memory: AiOsMemoryRuntimeSummary;
     skillPlan: SkillPlan;
+    sessionLearnings: LearningEntry[];
     roi: GovernanceRoiReport;
     recommendations: string[];
 }
@@ -111,6 +177,7 @@ export interface AiOsRunReport {
     artifacts: {
         runReport: string;
     };
+    governanceRoi?: GovernanceRoiSummary;
     nextActions: string[];
 }
 export interface AiOsDashboardInput {
@@ -172,6 +239,7 @@ export interface AiOsBenchmarkScenarioResult {
     task: string;
     level: SkillTaskLevel;
     governanceMode: GovernanceMode;
+    workflowProfile: WorkflowProfile;
     metrics: {
         estimatedTokens: number;
         budget: number;
@@ -180,6 +248,10 @@ export interface AiOsBenchmarkScenarioResult {
         selectedProviders: string[];
         skillSteps: number;
         requiredSkillSteps: number;
+        evaluatorGates: number;
+        toolStrategySteps: number;
+        toolStrategyCostUnits: number;
+        evolutionProposals: number;
         gates: number;
         roiModules: number;
     };
@@ -196,7 +268,12 @@ export interface AiOsBenchmarkReport {
         totalMemoryItems: number;
         totalSkillSteps: number;
         requiredSkillSteps: number;
+        totalEvaluatorGates: number;
+        totalToolStrategySteps: number;
+        totalToolStrategyCostUnits: number;
+        totalEvolutionProposals: number;
         governanceModes: GovernanceMode[];
+        workflowProfiles: WorkflowProfile[];
         averageTokenUtilization: number;
     };
     dashboard: AiOsDashboardReport;
@@ -335,7 +412,7 @@ export interface AiOsStatusReport {
     nextActions: string[];
     warnings: string[];
 }
-export type AiOsIntelligenceSignalId = 'memory-recall' | 'context-savings' | 'skill-routing' | 'benchmark-intelligence';
+export type AiOsIntelligenceSignalId = 'memory-recall' | 'context-savings' | 'skill-routing' | 'evaluator-intelligence' | 'tool-strategy' | 'adaptive-workflow' | 'evolution-shadow' | 'benchmark-intelligence';
 export interface AiOsIntelligenceSignal {
     id: AiOsIntelligenceSignalId;
     status: AiOsClosedLoopStatus;
@@ -353,6 +430,9 @@ export interface AiOsIntelligenceReport {
         selectedProviders: string[];
         memoryQuality: AiOsMemoryQualitySummary;
         contextQuality: AiOsContextQualitySummary;
+        evaluatorQuality: AiOsEvaluatorQualitySummary;
+        toolStrategyQuality: AiOsToolStrategyQualitySummary;
+        evolutionQuality: AiOsEvolutionQualitySummary;
         estimatedTokenSavings: number;
         skillSteps: number;
     };
@@ -374,6 +454,26 @@ export interface AiOsContextQualitySummary {
     highestOmittedTokens: number;
     compressionRisk: 'low' | 'medium' | 'high';
 }
+export interface AiOsEvaluatorQualitySummary {
+    requiredGates: number;
+    highRiskPlans: number;
+    averageUncertainty: number;
+    gateIds: AiOsEvaluatorGateId[];
+}
+export interface AiOsToolStrategyQualitySummary {
+    totalSteps: number;
+    requiredSteps: number;
+    highRiskSteps: number;
+    estimatedCostUnits: number;
+    fallbackCoverage: number;
+}
+export interface AiOsEvolutionQualitySummary {
+    proposals: number;
+    shadowRules: number;
+    candidateHooks: number;
+    approvedBlocking: number;
+    pendingValidation: number;
+}
 export declare function createAiOsPlan(input: AiOsRuntimeInput): Promise<AiOsRuntimePlan>;
 export declare function createAiOsRun(input: AiOsRunInput): Promise<AiOsRunReport>;
 export declare function createAiOsDashboard(input?: AiOsDashboardInput): AiOsDashboardReport;