windows-exe-decompiler-mcp-server 0.1.0

package/dist/tools/code-function-explain-prepare.d.ts

@@ -0,0 +1,535 @@
+import { z } from 'zod';
+import type { ToolArgs, ToolDefinition, WorkerResult } from '../types.js';
+import type { WorkspaceManager } from '../workspace-manager.js';
+import type { DatabaseManager } from '../database.js';
+import type { CacheManager } from '../cache-manager.js';
+export declare const codeFunctionExplainPrepareInputSchema: z.ZodEffects<z.ZodObject<{
+    sample_id: z.ZodString;
+    address: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    topk: z.ZodDefault<z.ZodNumber>;
+    max_functions: z.ZodDefault<z.ZodNumber>;
+    include_resolved: z.ZodDefault<z.ZodBoolean>;
+    analysis_goal: z.ZodDefault<z.ZodString>;
+    persist_artifact: z.ZodDefault<z.ZodBoolean>;
+    session_tag: z.ZodOptional<z.ZodString>;
+    evidence_scope: z.ZodDefault<z.ZodEnum<["all", "latest", "session"]>>;
+    evidence_session_tag: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sample_id: string;
+    evidence_scope: "all" | "latest" | "session";
+    topk: number;
+    analysis_goal: string;
+    include_resolved: boolean;
+    max_functions: number;
+    persist_artifact: boolean;
+    symbol?: string | undefined;
+    address?: string | undefined;
+    session_tag?: string | undefined;
+    evidence_session_tag?: string | undefined;
+}, {
+    sample_id: string;
+    symbol?: string | undefined;
+    address?: string | undefined;
+    session_tag?: string | undefined;
+    evidence_scope?: "all" | "latest" | "session" | undefined;
+    topk?: number | undefined;
+    evidence_session_tag?: string | undefined;
+    analysis_goal?: string | undefined;
+    include_resolved?: boolean | undefined;
+    max_functions?: number | undefined;
+    persist_artifact?: boolean | undefined;
+}>, {
+    sample_id: string;
+    evidence_scope: "all" | "latest" | "session";
+    topk: number;
+    analysis_goal: string;
+    include_resolved: boolean;
+    max_functions: number;
+    persist_artifact: boolean;
+    symbol?: string | undefined;
+    address?: string | undefined;
+    session_tag?: string | undefined;
+    evidence_session_tag?: string | undefined;
+}, {
+    sample_id: string;
+    symbol?: string | undefined;
+    address?: string | undefined;
+    session_tag?: string | undefined;
+    evidence_scope?: "all" | "latest" | "session" | undefined;
+    topk?: number | undefined;
+    evidence_session_tag?: string | undefined;
+    analysis_goal?: string | undefined;
+    include_resolved?: boolean | undefined;
+    max_functions?: number | undefined;
+    persist_artifact?: boolean | undefined;
+}>;
+export declare const codeFunctionExplainPrepareOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        sample_id: z.ZodString;
+        analysis_goal: z.ZodString;
+        prepared_count: z.ZodNumber;
+        prompt_name: z.ZodLiteral<"reverse.function_explanation_review">;
+        prompt_arguments: z.ZodObject<{
+            analysis_goal: z.ZodString;
+            prepared_bundle_json: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            prepared_bundle_json: string;
+            analysis_goal: string;
+        }, {
+            prepared_bundle_json: string;
+            analysis_goal: string;
+        }>;
+        task_prompt: z.ZodString;
+        prepared_bundle: z.ZodObject<{
+            schema_version: z.ZodLiteral<1>;
+            sample_id: z.ZodString;
+            analysis_goal: z.ZodString;
+            generated_at: z.ZodString;
+            selection: z.ZodObject<{
+                address: z.ZodNullable<z.ZodString>;
+                symbol: z.ZodNullable<z.ZodString>;
+                topk: z.ZodNumber;
+                max_functions: z.ZodNumber;
+                include_resolved: z.ZodBoolean;
+                evidence_scope: z.ZodEnum<["all", "latest", "session"]>;
+                evidence_session_tag: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            }, {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            }>;
+            output_contract: z.ZodObject<{
+                output_root: z.ZodLiteral<"explanations">;
+                required_fields: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                output_root: "explanations";
+                required_fields: string[];
+            }, {
+                output_root: "explanations";
+                required_fields: string[];
+            }>;
+            functions: z.ZodArray<z.ZodObject<{
+                function: z.ZodString;
+                address: z.ZodString;
+                confidence: z.ZodNumber;
+                validated_name: z.ZodNullable<z.ZodString>;
+                resolution_source: z.ZodNullable<z.ZodString>;
+                semantic_summary: z.ZodString;
+                confidence_profile: z.ZodOptional<z.ZodAny>;
+                runtime_confidence_profile: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+                naming_confidence_profile: z.ZodOptional<z.ZodAny>;
+                behavior_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                xref_signals: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+                call_relationships: z.ZodOptional<z.ZodAny>;
+                runtime_context: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+                semantic_evidence: z.ZodOptional<z.ZodAny>;
+                source_like_snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                assembly_excerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                gaps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }, {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sample_id: string;
+            schema_version: 1;
+            functions: {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }[];
+            analysis_goal: string;
+            generated_at: string;
+            selection: {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            };
+            output_contract: {
+                output_root: "explanations";
+                required_fields: string[];
+            };
+        }, {
+            sample_id: string;
+            schema_version: 1;
+            functions: {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }[];
+            analysis_goal: string;
+            generated_at: string;
+            selection: {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            };
+            output_contract: {
+                output_root: "explanations";
+                required_fields: string[];
+            };
+        }>;
+        artifact: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"semantic_explanation_prepare_bundle">;
+            path: z.ZodString;
+            sha256: z.ZodString;
+            mime: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            type: "semantic_explanation_prepare_bundle";
+            id: string;
+            sha256: string;
+            mime?: string | undefined;
+        }, {
+            path: string;
+            type: "semantic_explanation_prepare_bundle";
+            id: string;
+            sha256: string;
+            mime?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        sample_id: string;
+        analysis_goal: string;
+        prepared_count: number;
+        prompt_name: "reverse.function_explanation_review";
+        prompt_arguments: {
+            prepared_bundle_json: string;
+            analysis_goal: string;
+        };
+        task_prompt: string;
+        prepared_bundle: {
+            sample_id: string;
+            schema_version: 1;
+            functions: {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }[];
+            analysis_goal: string;
+            generated_at: string;
+            selection: {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            };
+            output_contract: {
+                output_root: "explanations";
+                required_fields: string[];
+            };
+        };
+        artifact?: {
+            path: string;
+            type: "semantic_explanation_prepare_bundle";
+            id: string;
+            sha256: string;
+            mime?: string | undefined;
+        } | undefined;
+    }, {
+        sample_id: string;
+        analysis_goal: string;
+        prepared_count: number;
+        prompt_name: "reverse.function_explanation_review";
+        prompt_arguments: {
+            prepared_bundle_json: string;
+            analysis_goal: string;
+        };
+        task_prompt: string;
+        prepared_bundle: {
+            sample_id: string;
+            schema_version: 1;
+            functions: {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }[];
+            analysis_goal: string;
+            generated_at: string;
+            selection: {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            };
+            output_contract: {
+                output_root: "explanations";
+                required_fields: string[];
+            };
+        };
+        artifact?: {
+            path: string;
+            type: "semantic_explanation_prepare_bundle";
+            id: string;
+            sha256: string;
+            mime?: string | undefined;
+        } | undefined;
+    }>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    artifacts: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        elapsed_ms: z.ZodNumber;
+        tool: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        elapsed_ms: number;
+        tool: string;
+    }, {
+        elapsed_ms: number;
+        tool: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
+    data?: {
+        sample_id: string;
+        analysis_goal: string;
+        prepared_count: number;
+        prompt_name: "reverse.function_explanation_review";
+        prompt_arguments: {
+            prepared_bundle_json: string;
+            analysis_goal: string;
+        };
+        task_prompt: string;
+        prepared_bundle: {
+            sample_id: string;
+            schema_version: 1;
+            functions: {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }[];
+            analysis_goal: string;
+            generated_at: string;
+            selection: {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            };
+            output_contract: {
+                output_root: "explanations";
+                required_fields: string[];
+            };
+        };
+        artifact?: {
+            path: string;
+            type: "semantic_explanation_prepare_bundle";
+            id: string;
+            sha256: string;
+            mime?: string | undefined;
+        } | undefined;
+    } | undefined;
+    warnings?: string[] | undefined;
+    errors?: string[] | undefined;
+    artifacts?: any[] | undefined;
+}, {
+    ok: boolean;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
+    data?: {
+        sample_id: string;
+        analysis_goal: string;
+        prepared_count: number;
+        prompt_name: "reverse.function_explanation_review";
+        prompt_arguments: {
+            prepared_bundle_json: string;
+            analysis_goal: string;
+        };
+        task_prompt: string;
+        prepared_bundle: {
+            sample_id: string;
+            schema_version: 1;
+            functions: {
+                function: string;
+                address: string;
+                confidence: number;
+                semantic_summary: string;
+                validated_name: string | null;
+                resolution_source: string | null;
+                gaps?: string[] | undefined;
+                xref_signals?: any[] | undefined;
+                call_relationships?: any;
+                runtime_context?: any;
+                semantic_evidence?: any;
+                confidence_profile?: any;
+                runtime_confidence_profile?: any;
+                naming_confidence_profile?: any;
+                behavior_tags?: string[] | undefined;
+                source_like_snippet?: string | null | undefined;
+                assembly_excerpt?: string | null | undefined;
+            }[];
+            analysis_goal: string;
+            generated_at: string;
+            selection: {
+                symbol: string | null;
+                address: string | null;
+                evidence_scope: "all" | "latest" | "session";
+                topk: number;
+                evidence_session_tag: string | null;
+                include_resolved: boolean;
+                max_functions: number;
+            };
+            output_contract: {
+                output_root: "explanations";
+                required_fields: string[];
+            };
+        };
+        artifact?: {
+            path: string;
+            type: "semantic_explanation_prepare_bundle";
+            id: string;
+            sha256: string;
+            mime?: string | undefined;
+        } | undefined;
+    } | undefined;
+    warnings?: string[] | undefined;
+    errors?: string[] | undefined;
+    artifacts?: any[] | undefined;
+}>;
+export declare const codeFunctionExplainPrepareToolDefinition: ToolDefinition;
+interface CodeFunctionExplainPrepareDependencies {
+    reconstructHandler?: (args: ToolArgs) => Promise<WorkerResult>;
+}
+export declare function createCodeFunctionExplainPrepareHandler(workspaceManager: WorkspaceManager, database: DatabaseManager, cacheManager: CacheManager, dependencies?: CodeFunctionExplainPrepareDependencies): (args: ToolArgs) => Promise<WorkerResult>;
+export {};
+//# sourceMappingURL=code-function-explain-prepare.d.ts.map