@wowok/agent-mcp 2.4.3 → 2.5.0

package/dist/knowledge/machine-context.d.ts

@@ -0,0 +1,160 @@
+import { type MachineScene } from "./machine-ledger.js";
+import { type MachineTemplate } from "./machine-templates.js";
+import { type SemanticToMachineRule, type MachineConstraintRule } from "./machine-translation.js";
+import { type MachineRiskRule, type MachineRiskAssessment, type ProjectContextForRisk } from "./machine-risk.js";
+import { type MachineTopology, type MachineNode, type MachinePair } from "./machine-topology.js";
+import { type MachinePuzzle, type PuzzleCompleteness } from "./machine-puzzle.js";
+import { type ChecklistResult } from "./machine-confirm.js";
+import { type GuardScene } from "./guard-ledger.js";
+export declare const MACHINE_CONTEXT_VERSION = "1.0.0";
+export interface VerificationNote {
+    topic: "bReplace" | "um" | "consensus_repositories" | "namedOperator_assignment" | "cross_machine_dependency";
+    judgment: "YES" | "PARTIAL" | "NO";
+    verified_semantic: string;
+    code_reference: string;
+    affected_modes: ContextInjectionMode[];
+}
+export declare const MACHINE_VERIFICATION_NOTES: VerificationNote[];
+export type ContextInjectionMode = "initial_design" | "mid_design_review" | "pre_publish_check" | "post_publish_runtime" | "intent_match" | "cross_machine" | "guard_integration" | "allocation_integration";
+export interface InjectionOptions {
+    max_templates?: number;
+    max_constraints?: number;
+    max_risks?: number;
+    include_verification_notes?: boolean;
+    include_guard_bridge?: boolean;
+    existing_puzzle?: MachinePuzzle;
+    existing_machine_json?: {
+        nodes: MachineNode[];
+        pairs: MachinePair[];
+        scene_id?: string;
+        template_id?: string;
+    };
+    project_context?: ProjectContextForRisk;
+    filter_execution_mode?: "Sequential" | "Parallel AND" | "Parallel OR" | "Weighted Voting" | "Hybrid";
+    filter_topology?: "Linear" | "ForkMerge" | "Competing";
+}
+export interface GuardBridgeInfo {
+    machine_scene_id: string;
+    guard_scenes: GuardScene[];
+    forward_guard_mapping: Array<{
+        forward_purpose: string;
+        guard_scene_id: string;
+        guard_scene_name: string;
+    }>;
+}
+export interface WorkflowSuggestion {
+    matched_scene: MachineScene | null;
+    confidence: number;
+    suggested_templates: Array<{
+        template: MachineTemplate;
+        rationale: string;
+    }>;
+    initial_puzzle: MachinePuzzle;
+    recommended_pattern: SemanticToMachineRule | null;
+    recommended_topology: string | null;
+    next_step: string;
+}
+export interface MachineContextBundle {
+    mode: ContextInjectionMode;
+    version: string;
+    matched_scene?: MachineScene;
+    suggested_templates: MachineTemplate[];
+    relevant_patterns: SemanticToMachineRule[];
+    relevant_constraints: MachineConstraintRule[];
+    relevant_risks: MachineRiskRule[];
+    puzzle_state?: MachinePuzzle;
+    puzzle_completeness?: PuzzleCompleteness;
+    topology_analysis?: MachineTopology;
+    risk_assessment?: MachineRiskAssessment;
+    progressive_check_result?: ChecklistResult;
+    guard_bridge?: GuardBridgeInfo;
+    prompt_hints: string[];
+    verification_notes: VerificationNote[];
+    recommended_next_action: string;
+}
+export interface MachineContextSnapshot {
+    version: string;
+    modules: {
+        ledger: string;
+        templates: string;
+        translation: string;
+        risk: string;
+        topology: string;
+        puzzle: string;
+        confirm: string;
+    };
+    counts: {
+        scenes: number;
+        templates: number;
+        patterns: number;
+        constraints: number;
+        risk_rules: number;
+        puzzle_dimensions: number;
+        publish_checklist_items: number;
+        confirmation_questions: number;
+        verification_notes: number;
+    };
+    verification_summary: {
+        total_topics: number;
+        verified_yes: number;
+        verified_partial: number;
+        verified_no: number;
+        topics: VerificationNote[];
+    };
+    guard_bridge: {
+        available: boolean;
+        guard_scenes_count: number;
+    };
+    on_chain_limits: {
+        max_node_count: number;
+        max_node_pair_count: number;
+        max_forward_count: number;
+    };
+}
+export declare function getMachineKnowledgeSnapshot(): MachineContextSnapshot;
+export declare function injectMachineContext(intent: string, mode: ContextInjectionMode, options?: InjectionOptions): MachineContextBundle;
+export declare function suggestWorkflow(intent: string): WorkflowSuggestion;
+export declare function buildPromptFromContext(bundle: MachineContextBundle): string;
+export declare function getRelatedGuardScenes(machineSceneId: string): GuardScene[];
+export declare function getVerificationNotes(mode?: ContextInjectionMode): VerificationNote[];
+export interface CrossMachineDependency {
+    machine_a_id: string;
+    machine_b_id: string;
+    machine_b_published: boolean;
+    dependency: {
+        machine_a_forward: string;
+        machine_b_node: string;
+    };
+    guard_query: string;
+}
+export interface GuardResolution {
+    upstream_machine_id: string;
+    upstream_node_name: string;
+    guard_query_description: string;
+}
+export declare function identifyCrossMachineDependency(machineAId: string, machineJson: {
+    nodes: MachineNode[];
+    pairs: MachinePair[];
+}, guardResolutions: Map<string, GuardResolution>, publishedMachineIds?: Set<string>): CrossMachineDependency[];
+export declare function detectCrossMachineCycle(allDependencies: CrossMachineDependency[]): string[][];
+export declare function aggregateProjectDependencies(machines: Array<{
+    machine_id: string;
+    machine_json: {
+        nodes: MachineNode[];
+        pairs: MachinePair[];
+    };
+    guard_resolutions: Map<string, GuardResolution>;
+}>, publishedMachineIds?: Set<string>): CrossMachineDependency[];
+export declare const CONTEXT_PRESETS: {
+    readonly newUserIntent: (intent: string) => MachineContextBundle;
+    readonly midDesignReview: (intent: string, puzzle: MachinePuzzle) => MachineContextBundle;
+    readonly prePublishFull: (intent: string, machineJson: {
+        nodes: MachineNode[];
+        pairs: MachinePair[];
+        scene_id?: string;
+        template_id?: string;
+    }, projectContext: ProjectContextForRisk) => MachineContextBundle;
+    readonly crossMachine: (intent: string) => MachineContextBundle;
+    readonly guardIntegration: (intent: string) => MachineContextBundle;
+    readonly allocationIntegration: (intent: string) => MachineContextBundle;
+};