@codex-ultra/cxu 0.2.12 → 0.2.17

package/dist/vendor/saVmTool.d.ts

@@ -1,3 +1,4 @@
+import { spawn } from "node:child_process";
 import type { SaVmPolicyConfig } from "../shared-types.js";
 import { type SaVmBunProfile } from "../shared-types.js";
 export type SaVmFsCapability = {
@@ -8,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" | "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" | "run_bun" | "run_bun_profile" | "run_project_check" | "project_check" | "run_host" | "exec_host" | "host";
+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 declare const SA_VM_BUN_PROFILES: readonly SaVmBunProfile[];
 export type { SaVmBunProfile };
 export type SaVmRunInput = {
@@ -26,6 +27,11 @@ export type SaVmRunInput = {
     keep_last_n_turns?: number;
     filter_tools?: string[];
     reason?: string;
+    key?: string;
+    all?: boolean;
+    fact?: string;
+    level?: NotePriorityLevel | string;
+    priority?: NotePriorityLevel | string;
     symbol?: string;
     old_name?: string;
     new_name?: string;
@@ -95,12 +101,20 @@ export type SaVmRunInput = {
     lines?: number;
     tail?: boolean;
     max_matches?: number;
+    repo?: string;
+    short?: boolean;
+    untracked?: "normal" | "no" | "all" | string;
+    staged?: boolean;
+    stat_only?: boolean;
+    statOnly?: boolean;
+    context?: number;
     url?: string;
     method?: string;
     headers?: Record<string, string>;
     body?: string;
     timeout_ms?: number;
     timeout?: number;
+    format?: string;
     source?: string;
     language?: "js" | "javascript" | "bun" | "ts" | "typescript" | "node" | "py" | "python" | "sa" | "sla";
     exe?: string;
@@ -125,17 +139,36 @@ export type SaVmRunInput = {
     policy?: SaVmPolicyConfig;
     parallel?: Array<Omit<SaVmRunInput, "parallel">>;
     concurrency?: number;
+    yield_time_ms?: number;
+    yield_ms?: number;
+    yieldTimeMs?: number;
+    session_id?: string;
+    sessionId?: string;
+    session?: string;
+    input?: string;
+    close_stdin?: boolean;
+    drain?: boolean;
+    commit?: string;
+    message?: string;
 };
 export declare function expandSaVmActionInput(input: SaVmRunInput): SaVmRunInput;
 export type SaVmRunResult = {
     ok: boolean;
-    kind: "success" | "sa_error" | "capability_denied" | "fuel_exhausted" | "timeout" | "mem_quota" | "policy_invalid" | "stack_overflow" | "crashed" | "unavailable";
+    kind: "success" | "sa_error" | "capability_denied" | "fuel_exhausted" | "timeout" | "mem_quota" | "policy_invalid" | "stack_overflow" | "crashed" | "unavailable" | "running";
     exitCode: number | null;
     stdout: string;
     stderr: string;
     saVmEvents: Array<Record<string, unknown>>;
     saVmViolation: Record<string, unknown> | null;
     durationMs: number;
+    session_id?: string;
+    sessionId?: string;
+    pid?: number;
+    status?: string;
+    message?: string;
+    commit?: string;
+    created?: boolean;
+    [key: string]: unknown;
 };
 declare const DEFAULT_LIMITS: {
     fuel: number;
@@ -257,6 +290,7 @@ export declare function nativeFindImplementations(rawSymbol: string | undefined,
     timeout_ms?: number;
     timeout?: number;
 }, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function collectWorkspaceSourceFiles(baseDir: string, maxFiles?: number, timeoutMs?: number, startedAt?: number): Promise<string[]>;
 export declare function nativeFileOutline(rawPath: string, options: {
     detail?: boolean;
     max_tokens?: number;
@@ -276,6 +310,45 @@ export declare function nativeWorkspaceOutline(rawDir: string, options: {
     timeout_ms?: number;
     timeout?: number;
 }, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function nativeRepoMap(rawDir: string, options: {
+    pattern?: string;
+    path_pattern?: string;
+    is_regex?: boolean;
+    regex?: boolean;
+    max_files?: number;
+    max_symbols_per_file?: number;
+    max_tokens?: number;
+    max_file_bytes?: number;
+    exclude_dirs?: string[];
+    include_used_by?: boolean;
+    timeout_ms?: number;
+    timeout?: number;
+}, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function nativeVerifyLoop(rawTarget: string, options: {
+    files?: string[];
+    pattern?: string;
+    max_files?: number;
+    max_errors?: number;
+    max_tokens?: number;
+    timeout_ms?: number;
+    timeout?: number;
+}, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export type NotePriorityLevel = "low" | "normal" | "important" | "critical";
+export type WorkspaceNoteItem = {
+    key: string;
+    content: string;
+    level: NotePriorityLevel;
+    updated_at: number;
+};
+export type WorkspaceNotesDocument = {
+    workspace: string;
+    updated_at: number;
+    notes: WorkspaceNoteItem[];
+};
+export declare function resolveWorkspaceMemoryFilePath(workspaceDir: string): string;
+export declare function nativeSaveNote(keyInput: string | undefined, contentInput: string | undefined, levelInput: string | undefined, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function nativeReadNotes(keyInput: string | undefined, maxTokensInput: number | undefined, remainingTokensInput: number | undefined, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function nativeDeleteNote(keyInput: string | undefined, all: boolean | undefined, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
 export declare function nativeReadMany(files: string[], options: {
     start_line?: number;
     end_line?: number;
@@ -334,13 +407,62 @@ export declare function nativeApplyPatch(patchText: string, policy: SaVmPolicyCo
 export declare function nativeCopyFile(fromPath: string, toPath: string, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
 export declare function nativeFileInfo(filePath: string, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
 export declare function nativeCountLines(filePath: string, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function nativeGitStatus(startPath: string, opts: {
+    short?: boolean;
+    untracked?: string;
+    max_entries?: number;
+    max_bytes?: number;
+    max_tokens?: number;
+    max_token?: number;
+    maxtoken?: number;
+    remaining_tokens?: number;
+    tokens_remaining?: number;
+    tokens_left?: number;
+    timeout_ms?: number;
+    timeout?: number;
+}, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function nativeGitDiff(startPath: string, opts: {
+    pathspec?: string;
+    staged?: boolean;
+    stat_only?: boolean;
+    context?: number;
+    max_files?: number;
+    max_bytes?: number;
+    max_tokens?: number;
+    max_token?: number;
+    maxtoken?: number;
+    remaining_tokens?: number;
+    tokens_remaining?: number;
+    tokens_left?: number;
+    timeout_ms?: number;
+    timeout?: number;
+}, policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
 export declare function nativeHttpFetch(url: string, method?: string, headers?: Record<string, string>, body?: string, policy?: SaVmPolicyConfig, cwd?: string, startedAt?: number, timeoutOpts?: {
     timeout_ms?: number;
     timeout?: number;
 }): Promise<SaVmRunResult>;
 export declare const ALLOWED_HOST_SHORT_NAMES: Set<string>;
+export declare const ALLOWED_CARGO_SUBCOMMANDS: Set<string>;
+export declare const ALLOWED_GO_SUBCOMMANDS: Set<string>;
 export declare const FORBIDDEN_HOST_SUBCOMMANDS: Set<string>;
 export declare const ALLOWED_HOST_ENV_KEYS: Set<string>;
+export interface SaVmProcessSession {
+    id: string;
+    child: ReturnType<typeof spawn>;
+    pid: number | undefined;
+    exe: string;
+    args: string[];
+    cwd: string;
+    startedAt: number;
+    stdoutChunks: string[];
+    stderrChunks: string[];
+    exitCode: number | null;
+    status: "running" | "exited" | "killed" | "timed_out" | "crashed";
+    closed: boolean;
+    maxBufferBytes: number;
+    autoKillTimer?: ReturnType<typeof setTimeout>;
+}
+export declare const saVmActiveSessions: Map<string, SaVmProcessSession>;
 interface RunHostCacheEntry {
     stdout: string;
     stderr: string;
@@ -368,6 +490,12 @@ export declare function sliceAndFilterOutput(rawStdout: string, options: {
     max_token?: number;
 }): string;
 export declare function nativeRunHost(rawInput: SaVmRunInput, _policy: SaVmPolicyConfig | undefined, cwd: string, startedAt: number): Promise<SaVmRunResult>;
+export declare function nativeWriteStdin(rawInput: SaVmRunInput, _cwd: string, startedAt: number): SaVmRunResult;
+export declare function nativeSessionStatus(rawInput: SaVmRunInput, _cwd: string, startedAt: number): SaVmRunResult;
+export declare function nativeKillSession(rawInput: SaVmRunInput, _cwd: string, startedAt: number): SaVmRunResult;
+export declare function nativeListSessions(startedAt: number): SaVmRunResult;
+export declare function nativeLocalCheckpoint(rawInput: SaVmRunInput, cwd: string, startedAt: number): SaVmRunResult;
+export declare function nativeRestoreCheckpoint(rawInput: SaVmRunInput, cwd: string, startedAt: number): SaVmRunResult;
 export declare function detectBatchDependencyViolation(tasks: SaVmRunInput[], cwd: string): {
     conflictedPath: string;
     writeTaskIndex: number;

package/package.json

@@ -1,68 +1,68 @@
-{
-  "name": "@codex-ultra/cxu",
-  "version": "0.2.12",
-  "description": "codex-ultra workbench launcher: server compiled locally with Bun + web UI (cxu starts it all).",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "bin": {
-    "cxu": "dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "wasm",
-    "web-dist",
-    "server-bundle",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "vendor": "node scripts/vendor-sa-vm.mjs",
-    "build": "node scripts/build.mjs",
-    "build:bun": "bun scripts/build.mjs",
-    "obfuscate": "node scripts/obfuscate.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "postinstall": "node dist/postinstall.js",
-    "prepack": "npm run build && npm run obfuscate",
-    "test": "bun test test/ 2>/dev/null || node --test test/*.test.mjs"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "tree-sitter-wasms": "^0.1.13",
-    "web-tree-sitter": "0.25.10"
-  },
-  "devDependencies": {
-    "esbuild": "^0.25.12",
-    "javascript-obfuscator": "^5.5.0",
-    "typescript": "^5.9.3"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "license": "MIT",
-  "homepage": "https://github.com/layola13/codex-ultra#readme",
-  "bugs": {
-    "url": "https://github.com/layola13/codex-ultra/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/layola13/codex-ultra.git",
-    "directory": "packages/cxu"
-  },
-  "keywords": [
-    "codex",
-    "vm-tools",
-    "ast",
-    "tree-sitter",
-    "typescript",
-    "cross-platform"
-  ]
-}
+{
+  "name": "@codex-ultra/cxu",
+  "version": "0.2.17",
+  "description": "codex-ultra workbench launcher: server compiled locally with Bun + web UI (cxu starts it all).",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "cxu": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "wasm",
+    "web-dist",
+    "server-bundle",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "vendor": "node scripts/vendor-sa-vm.mjs",
+    "build": "node scripts/build.mjs",
+    "build:bun": "bun scripts/build.mjs",
+    "obfuscate": "node scripts/obfuscate.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "postinstall": "node dist/postinstall.js",
+    "prepack": "npm run build && npm run obfuscate",
+    "test": "bun test test/ 2>/dev/null || node --test test/*.test.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "tree-sitter-wasms": "^0.1.13",
+    "web-tree-sitter": "0.25.10"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.12",
+    "javascript-obfuscator": "^5.5.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/layola13/codex-ultra#readme",
+  "bugs": {
+    "url": "https://github.com/layola13/codex-ultra/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/layola13/codex-ultra.git",
+    "directory": "packages/cxu"
+  },
+  "keywords": [
+    "codex",
+    "vm-tools",
+    "ast",
+    "tree-sitter",
+    "typescript",
+    "cross-platform"
+  ]
+}