@codex-ultra/cxu 0.2.19 → 0.2.21

package/dist/shared-types.d.ts

@@ -91,8 +91,9 @@ export interface SaVmToolsConfig {
     getDiagnostics?: boolean;
     organizeImports?: boolean;
     analyzeScope?: boolean;
+    codeGraph?: boolean;
 }
-export declare const ENHANCE_TOOLS_KEYS: readonly ["readFiles", "fastSearch", "editFiles", "applyPatch", "fileOutline", "findDefinition", "renameSymbol", "extractToFile", "moveWithImports", "addImport", "getDiagnostics", "organizeImports", "analyzeScope", "findReferences", "clearToolHistory"];
+export declare const ENHANCE_TOOLS_KEYS: readonly ["readFiles", "fastSearch", "editFiles", "applyPatch", "fileOutline", "codeGraph", "findDefinition", "renameSymbol", "extractToFile", "moveWithImports", "addImport", "getDiagnostics", "organizeImports", "analyzeScope", "findReferences", "clearToolHistory"];
 export type EnhanceToolKey = typeof ENHANCE_TOOLS_KEYS[number];
 export declare function hasEnhanceToolsEnabled(tools?: SaVmToolsConfig | null): boolean;
 export declare function countActiveEnhanceTools(tools?: SaVmToolsConfig | null): number;

package/dist/vendor/saVmCodeGraph.d.ts

@@ -0,0 +1,92 @@
+import type { SaVmPolicyConfig } from "../shared-types.js";
+import { type NormalizedSaVmPolicy } from "./saVmPolicy.js";
+import type { SaVmRunResult } from "./saVmResultKind.js";
+export type CodeGraphEdgeKind = "extends" | "implements" | "owns" | "imports" | "calls";
+export interface CodeGraphNode {
+    id: string;
+    label: string;
+    kind: "class" | "interface" | "module" | "function" | "unknown";
+    file?: string;
+    line?: number;
+}
+export interface CodeGraphEdge {
+    source: string;
+    target: string;
+    kind: CodeGraphEdgeKind;
+    label?: string;
+}
+export interface ExtractedClassInfo {
+    name: string;
+    bases: string[];
+    interfaces: string[];
+    fields: Array<{
+        name: string;
+        type?: string;
+    }>;
+    methods: Array<{
+        name: string;
+        calls: string[];
+    }>;
+    line: number;
+}
+export interface ExtractedImportInfo {
+    specifier: string;
+    symbols: Array<{
+        imported: string;
+        local: string;
+    }>;
+    isDefault?: boolean;
+    isNamespace?: boolean;
+}
+export interface ExtractedFileInfo {
+    filePath: string;
+    classes: ExtractedClassInfo[];
+    imports: ExtractedImportInfo[];
+    functions: Array<{
+        name: string;
+        calls: string[];
+        line: number;
+    }>;
+}
+export type CodeGraphMode = "symbol_hierarchy" | "module_dependency" | "module_deps" | "call_flow";
+export interface CodeGraphOptions {
+    target: string;
+    mode?: CodeGraphMode;
+    depth?: number;
+    direction?: "upstream" | "downstream" | "both";
+    format?: "dot" | "py_stub" | "networkx";
+    max_nodes?: number;
+    max_tokens?: number;
+    output_file?: string;
+    candidate_files?: string[];
+    files?: string[];
+    timeout_ms?: number;
+}
+export declare function extractFileInfo(filePath: string, content: string): Promise<ExtractedFileInfo>;
+export declare function resolveImportFilePath(importerAbsPath: string, specifier: string, _cwd?: string): string | null;
+export declare function findProjectSourceFiles(dir: string, maxFiles?: number): string[];
+export declare function buildScopedCodeGraph(options: CodeGraphOptions, policy: NormalizedSaVmPolicy, cwd: string): Promise<{
+    nodes: CodeGraphNode[];
+    edges: CodeGraphEdge[];
+    rootId: string;
+    truncated: boolean;
+}>;
+export declare function formatAsDot(graph: {
+    nodes: CodeGraphNode[];
+    edges: CodeGraphEdge[];
+    rootId: string;
+    truncated: boolean;
+}, title?: string): string;
+export declare function formatAsPyStub(graph: {
+    nodes: CodeGraphNode[];
+    edges: CodeGraphEdge[];
+    rootId: string;
+    truncated: boolean;
+}): string;
+export declare function formatAsNetworkX(graph: {
+    nodes: CodeGraphNode[];
+    edges: CodeGraphEdge[];
+    rootId: string;
+    truncated: boolean;
+}): string;
+export declare function nativeCodeGraph(rawInput: Record<string, any>, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;

package/dist/vendor/saVmPolicy.d.ts

@@ -70,6 +70,7 @@ export type NormalizedSaVmPolicy = {
         getDiagnostics?: boolean;
         organizeImports?: boolean;
         analyzeScope?: boolean;
+        codeGraph?: boolean;
     };
     contextSavings?: SaVmContextSavingsConfig;
 };

package/dist/vendor/saVmTool.d.ts

@@ -9,7 +9,7 @@ export type SaVmNetCapability = {
     url: string;
     methods?: string[];
 };
-export type SaVmActionType = "read" | "read_file" | "read_lines" | "read_file_tail" | "tail_file" | "tail" | "read_many" | "read_files" | "find" | "find_files" | "list_files" | "write" | "write_file" | "edit" | "edit_file" | "apply_patch" | "patch" | "delete" | "delete_file" | "remove_file" | "safe_delete" | "move" | "move_file" | "rename" | "rename_file" | "copy" | "copy_file" | "stat" | "file_info" | "test_path" | "file_exists" | "exists" | "ensure_dir" | "mkdir" | "vm-read" | "vm_read" | "count_lines" | "line_count" | "list_dir" | "grep" | "grep_search" | "grep_async" | "grep_search_async" | "async_grep" | "http_fetch" | "fetch" | "run_js" | "exec_js" | "run_py" | "run_python" | "exec_py" | "clear_tool_history" | "prune_tool_history" | "find_references" | "find_all_references" | "find_implementations" | "find_impl" | "implementations" | "file_outline" | "outline" | "workspace_outline" | "outline_many" | "project_outline" | "repo_map" | "repo-map" | "rename_symbol" | "symbol_rename" | "move_file_with_imports" | "move_with_imports" | "find_definition" | "goto_definition" | "def" | "extract_to_file" | "extract_file" | "extract_module" | "add_import" | "insert_import" | "get_diagnostics" | "diagnostics" | "check_syntax" | "workspace_diagnostics" | "project_diagnostics" | "all_diagnostics" | "organize_imports" | "clean_unused_imports" | "sort_imports" | "analyze_scope" | "scope_analysis" | "verify_loop" | "verify-loop" | "verify_changed" | "git_status" | "git-status" | "git_diff" | "git-diff" | "run_bun" | "run_bun_profile" | "run_project_check" | "project_check" | "run_host" | "exec_host" | "host" | "save_note" | "add_note" | "read_notes" | "read_note" | "list_notes" | "delete_note" | "remove_note" | "clear_notes" | "write_stdin" | "stdin" | "input_stdin" | "session_status" | "read_session" | "poll_session" | "kill_session" | "kill_process" | "stop_session" | "list_sessions" | "local_checkpoint" | "checkpoint" | "git_checkpoint" | "restore_checkpoint" | "restore_git_checkpoint";
+export type SaVmActionType = "read" | "read_file" | "read_lines" | "read_file_tail" | "tail_file" | "tail" | "read_many" | "read_files" | "find" | "find_files" | "list_files" | "write" | "write_file" | "edit" | "edit_file" | "apply_patch" | "patch" | "delete" | "delete_file" | "remove_file" | "safe_delete" | "move" | "move_file" | "rename" | "rename_file" | "copy" | "copy_file" | "stat" | "file_info" | "test_path" | "file_exists" | "exists" | "ensure_dir" | "mkdir" | "vm-read" | "vm_read" | "count_lines" | "line_count" | "list_dir" | "grep" | "grep_search" | "grep_async" | "grep_search_async" | "async_grep" | "http_fetch" | "fetch" | "run_js" | "exec_js" | "run_py" | "run_python" | "exec_py" | "clear_tool_history" | "prune_tool_history" | "find_references" | "find_all_references" | "find_implementations" | "find_impl" | "implementations" | "file_outline" | "outline" | "workspace_outline" | "outline_many" | "project_outline" | "repo_map" | "repo-map" | "code_graph" | "relation_graph" | "symbol_graph" | "rename_symbol" | "symbol_rename" | "move_file_with_imports" | "move_with_imports" | "find_definition" | "goto_definition" | "def" | "extract_to_file" | "extract_file" | "extract_module" | "add_import" | "insert_import" | "get_diagnostics" | "diagnostics" | "check_syntax" | "workspace_diagnostics" | "project_diagnostics" | "all_diagnostics" | "organize_imports" | "clean_unused_imports" | "sort_imports" | "analyze_scope" | "scope_analysis" | "verify_loop" | "verify-loop" | "verify_changed" | "git_status" | "git-status" | "git_diff" | "git-diff" | "run_bun" | "run_bun_profile" | "run_project_check" | "project_check" | "run_host" | "exec_host" | "host" | "save_note" | "add_note" | "read_notes" | "read_note" | "list_notes" | "delete_note" | "remove_note" | "clear_notes" | "write_stdin" | "stdin" | "input_stdin" | "session_status" | "read_session" | "poll_session" | "kill_session" | "kill_process" | "stop_session" | "list_sessions" | "local_checkpoint" | "checkpoint" | "git_checkpoint" | "restore_checkpoint" | "restore_git_checkpoint";
 export declare const SA_VM_BUN_PROFILES: readonly SaVmBunProfile[];
 export type { SaVmBunProfile };
 export type SaVmRunInput = {
@@ -19,6 +19,15 @@ export type SaVmRunInput = {
     file?: string;
     dest?: string;
     target?: string;
+    filePath?: string;
+    file_path?: string;
+    targetFile?: string;
+    target_file?: string;
+    filename?: string;
+    fileName?: string;
+    AbsolutePath?: string;
+    absolute_path?: string;
+    uri?: string;
     content?: string;
     profile?: string;
     subcommand?: string;
@@ -60,9 +69,15 @@ export type SaVmRunInput = {
     exclude_comments?: boolean;
     include_declarations?: boolean;
     old_text?: string;
+    oldText?: string;
+    old?: string;
     new_text?: string;
+    newText?: string;
+    new?: string;
     start_line?: number;
+    startLine?: number;
     end_line?: number;
+    endLine?: number;
     offset?: number;
     max_tokens?: number;
     max_token?: number;
@@ -71,20 +86,34 @@ export type SaVmRunInput = {
     tokens_remaining?: number;
     tokens_left?: number;
     max_lines?: number;
+    maxLines?: number;
     max_line_length?: number;
+    maxLineLength?: number;
     numbered?: boolean;
     dir?: string;
+    directory?: string;
+    folder?: string;
+    searchDirectory?: string;
+    SearchDirectory?: string;
     pattern?: string;
+    glob?: string;
+    Pattern?: string;
     type?: "all" | "file" | "directory" | string;
     max_bytes?: number;
+    maxBytes?: number;
     max_entries?: number;
+    maxEntries?: number;
     max_depth?: number;
+    maxDepth?: number;
     depth?: number;
     recursive?: boolean;
     patch?: string;
+    diff?: string;
+    mode?: string;
     from?: string;
     to?: string;
     query?: string;
+    Query?: string;
     queries?: string[];
     path_pattern?: string;
     is_regex?: boolean;

package/dist/vendor/saVmTreeSitter.d.ts

@@ -1,4 +1,4 @@
-import { type Node } from "web-tree-sitter";
+import { Language, type Node } from "web-tree-sitter";
 export type OutlineSymbolKind = "function" | "method" | "class" | "struct" | "interface" | "enum" | "variant" | "trait" | "impl" | "type" | "module" | "constant" | "variable";
 export type OutlineSymbol = {
     name: string;
@@ -35,6 +35,7 @@ export declare function getTreeSitterWasmPath(): string | null;
 export declare function getLanguageWasmPath(langName: string): string | null;
 export declare function initTreeSitter(): Promise<boolean>;
 export declare function getLanguageNameForFile(filePath: string): string | null;
+export declare function loadLanguageForFile(filePath: string): Promise<Language | null>;
 /** Check if an AST node is located inside comments or string literals. */
 export declare function isInsideCommentOrString(node: Node | null): boolean;
 /** Format symbol outline as a compact tree text for LLM. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codex-ultra/cxu",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "codex-ultra workbench launcher: server compiled locally with Bun + web UI (cxu starts it all).",
   "type": "module",
   "main": "dist/index.js",