@mojir/dvala 0.0.7 → 0.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojir/dvala",
-  "version": "0.0.7",
+  "version": "0.0.10",
   "description": "dvala",
   "author": "Albert Mojir",
   "license": "MIT",
@@ -111,7 +111,8 @@
   "iife": "dist/dvala.iife.js",
   "types": "dist/src/index.d.ts",
   "bin": {
-    "dvala": "dist/cli/cli.js"
+    "dvala": "dist/cli/cli.js",
+    "dvala-mcp": "dist/mcp-server/server.js"
   },
   "files": [
     "dist"
@@ -121,20 +122,27 @@
     "vitest": "vitest",
     "lint": "eslint . --fix",
     "lint:no-fix": "eslint .",
-    "typecheck": "tsc -p ./tsconfig.compile.json --noEmit",
-    "check": "npm run lint && npm run typecheck && npm run test && npm run build",
+    "typecheck": "tsc -p ./tsconfig.compile.json --noEmit && tsc -p vscode-dvala/tsconfig.json --noEmit",
+    "check": "npm install && npm run lint && npm run typecheck && npm run test && npm run build",
     "check:no-fix": "npm run lint:no-fix && npm run typecheck && npm run test",
     "clean": "npm run clean-dvala && npm run clean-playground",
     "clean-dvala": "rm -rf dist build",
     "clean-playground": "rm -rf playground-builder/build playground-www/build",
-    "build": "npm run build-dvala && npm run build-cli && npm run build-playground",
+    "build": "npm run build-dvala && npm run build-cli && npm run build-mcp && npm run build-playground && npm run build-vscode-ext",
+    "build-vscode-ext": "node vscode-dvala/build.mjs",
     "build-dvala": "npm run clean-dvala && rollup -c",
     "build-playground": "npm run clean-playground && rollup -c rollup.config.playground-builder.js && rollup -c rollup.config.playground-www.js && node ./playground-builder/build/buildPlaygroundSite.js",
     "build-cli": "rollup -c rollup.config.cli.js",
+    "build-mcp": "rollup -c rollup.config.mcp-server.js",
     "dvala": "node ./dist/cli/cli.js",
     "dev": "npx serve docs -p 9901",
     "test:e2e": "npx playwright test",
-    "lcov": "open-cli ./coverage/index.html"
+    "lcov": "open-cli ./coverage/index.html",
+    "mcp:inspect": "npx @modelcontextprotocol/inspector node ./dist/mcp-server/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@antfu/eslint-config": "2.21.1",
@@ -145,7 +153,10 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/node": "22.7.6",
+    "@types/vscode": "^1.75.0",
     "@vitest/coverage-v8": "1.6.0",
+    "@vscode/vsce": "^3.0.0",
+    "esbuild": "^0.25.0",
     "open-cli": "8.0.0",
     "rollup": "4.18.0",
     "serve": "^14.2.4",

package/dist/cli/src/Dvala/Dvala.d.ts

@@ -1,63 +0,0 @@
-import type { Context } from '../evaluator/interface';
-import type { Any } from '../interface';
-import type { Ast, DvalaFunction } from '../parser/types';
-import type { TokenStream } from '../tokenizer/tokenize';
-import { AutoCompleter } from '../AutoCompleter/AutoCompleter';
-import type { DvalaModule } from '../builtin/modules/interface';
-import type { DvalaBundle } from '../bundler/interface';
-import type { MaybePromise } from '../utils/maybePromise';
-import type { Handlers } from '../evaluator/effectTypes';
-import { Cache } from './Cache';
-export interface DvalaRuntimeInfo {
-    astCache: Cache | null;
-    astCacheSize: number | null;
-    debug: boolean;
-}
-export interface ContextParams {
-    globalContext?: Context;
-    contexts?: Context[];
-    bindings?: Record<string, unknown>;
-    handlers?: Handlers;
-    globalModuleScope?: boolean;
-}
-export interface MinifyParams {
-    minify?: boolean;
-}
-export interface FilePathParams {
-    filePath?: string;
-}
-export interface PureParams {
-    pure?: boolean;
-}
-interface DvalaConfig {
-    initialCache?: Record<string, Ast>;
-    astCacheSize?: number | null;
-    debug?: boolean;
-    modules?: DvalaModule[];
-}
-export declare class Dvala {
-    private astCache;
-    private astCacheSize;
-    private debug;
-    private modules;
-    constructor(config?: DvalaConfig);
-    getRuntimeInfo(): DvalaRuntimeInfo;
-    readonly async: {
-        run: (programOrBundle: string | DvalaBundle, params?: ContextParams & FilePathParams & PureParams) => Promise<unknown>;
-        apply: (fn: DvalaFunction, fnParams: unknown[], params?: ContextParams & PureParams) => Promise<unknown>;
-    };
-    run(programOrBundle: string | DvalaBundle, params?: ContextParams & FilePathParams & PureParams): unknown;
-    private runBundle;
-    getUndefinedSymbols(programOrAst: string | Ast, params?: ContextParams): Set<string>;
-    tokenize(program: string, tokenizeParams?: FilePathParams & MinifyParams): TokenStream;
-    parse(tokenStream: TokenStream): Ast;
-    private evaluate;
-    private evaluateAsync;
-    transformSymbols(tokenStream: TokenStream, transformer: (symbol: string) => string): TokenStream;
-    untokenize(tokenStream: TokenStream): string;
-    apply(fn: DvalaFunction, fnParams: unknown[], params?: ContextParams & PureParams): MaybePromise<Any>;
-    private generateApplyFunctionCall;
-    private generateAst;
-    getAutoCompleter(program: string, position: number, params?: ContextParams): AutoCompleter;
-}
-export {};

package/dist/modules/src/Dvala/Dvala.d.ts

@@ -1,63 +0,0 @@
-import type { Context } from '../evaluator/interface';
-import type { Any } from '../interface';
-import type { Ast, DvalaFunction } from '../parser/types';
-import type { TokenStream } from '../tokenizer/tokenize';
-import { AutoCompleter } from '../AutoCompleter/AutoCompleter';
-import type { DvalaModule } from '../builtin/modules/interface';
-import type { DvalaBundle } from '../bundler/interface';
-import type { MaybePromise } from '../utils/maybePromise';
-import type { Handlers } from '../evaluator/effectTypes';
-import { Cache } from './Cache';
-export interface DvalaRuntimeInfo {
-    astCache: Cache | null;
-    astCacheSize: number | null;
-    debug: boolean;
-}
-export interface ContextParams {
-    globalContext?: Context;
-    contexts?: Context[];
-    bindings?: Record<string, unknown>;
-    handlers?: Handlers;
-    globalModuleScope?: boolean;
-}
-export interface MinifyParams {
-    minify?: boolean;
-}
-export interface FilePathParams {
-    filePath?: string;
-}
-export interface PureParams {
-    pure?: boolean;
-}
-interface DvalaConfig {
-    initialCache?: Record<string, Ast>;
-    astCacheSize?: number | null;
-    debug?: boolean;
-    modules?: DvalaModule[];
-}
-export declare class Dvala {
-    private astCache;
-    private astCacheSize;
-    private debug;
-    private modules;
-    constructor(config?: DvalaConfig);
-    getRuntimeInfo(): DvalaRuntimeInfo;
-    readonly async: {
-        run: (programOrBundle: string | DvalaBundle, params?: ContextParams & FilePathParams & PureParams) => Promise<unknown>;
-        apply: (fn: DvalaFunction, fnParams: unknown[], params?: ContextParams & PureParams) => Promise<unknown>;
-    };
-    run(programOrBundle: string | DvalaBundle, params?: ContextParams & FilePathParams & PureParams): unknown;
-    private runBundle;
-    getUndefinedSymbols(programOrAst: string | Ast, params?: ContextParams): Set<string>;
-    tokenize(program: string, tokenizeParams?: FilePathParams & MinifyParams): TokenStream;
-    parse(tokenStream: TokenStream): Ast;
-    private evaluate;
-    private evaluateAsync;
-    transformSymbols(tokenStream: TokenStream, transformer: (symbol: string) => string): TokenStream;
-    untokenize(tokenStream: TokenStream): string;
-    apply(fn: DvalaFunction, fnParams: unknown[], params?: ContextParams & PureParams): MaybePromise<Any>;
-    private generateApplyFunctionCall;
-    private generateAst;
-    getAutoCompleter(program: string, position: number, params?: ContextParams): AutoCompleter;
-}
-export {};

package/dist/modules/src/effects.d.ts

@@ -1,110 +0,0 @@
-/**
- * Algebraic effects — host-facing API.
- *
- * Top-level standalone functions for running Dvala programs with effect handlers.
- *
- * Three levels of use:
- * 1. `runSync(source, options?)` — pure computation, sync JS functions in bindings.
- * 2. `run(source, options?)` — async effects with handlers, always completes or suspends.
- * 3. `resume(snapshot, value, options?)` — resume a suspended continuation.
- *
- * Effect handlers are JavaScript functions that receive an `EffectContext` and must
- * call exactly one of `resume(value)`, `suspend(meta?)`, `fail(msg?)`, or `next()`:
- *
- * ```typescript
- * handlers: {
- *   'llm.complete': async ({ args, signal, resume }) => {
- *     resume(await callLLM(args[0], signal))
- *   },
- *   'dvala.*': async ({ effectName, args, next }) => {
- *     console.log(`[${effectName}]`, ...args)
- *     next()  // pass to next matching handler
- *   }
- * }
- * ```
- */
-import type { Any } from './interface';
-import type { DvalaModule } from './builtin/modules/interface';
-import type { Handlers, RunResult, Snapshot } from './evaluator/effectTypes';
-export type { EffectContext, EffectHandler, Snapshot } from './evaluator/effectTypes';
-export { SuspensionSignal, isSuspensionSignal } from './evaluator/effectTypes';
-export type { Handlers, RunResult } from './evaluator/effectTypes';
-/**
- * Options for `run()` — async execution with effect handlers.
- * `bindings` are plain values only (no JS functions).
- * All host interaction goes through `handlers`.
- */
-export interface RunOptions {
-    bindings?: Record<string, Any>;
-    handlers?: Handlers;
-    modules?: DvalaModule[];
-    maxSnapshots?: number;
-}
-/**
- * Options for `runSync()` — synchronous pure computation.
- */
-export interface RunSyncOptions {
-    bindings?: Record<string, unknown>;
-    modules?: DvalaModule[];
-}
-/**
- * Options for `resume()` — resume a suspended continuation.
- * `bindings` are plain values only (no JS functions).
- * All host interaction goes through `handlers`.
- * `modules` must be provided again (they are not in the blob).
- */
-export interface ResumeOptions {
-    bindings?: Record<string, Any>;
-    handlers?: Handlers;
-    modules?: DvalaModule[];
-    maxSnapshots?: number;
-}
-/**
- * Level 1: Pure synchronous computation.
- *
- * Throws if an async operation or effect is encountered.
- *
- * ```typescript
- * const value = runSync('[1, 2, 3] |> map(_, -> $ * $)')
- * ```
- */
-export declare function runSync(source: string, options?: RunSyncOptions): Any;
-/**
- * Level 2 & 3: Async execution with effect handler support.
- *
- * `bindings` are plain values only (no JS functions).
- * All host interaction goes through `handlers`.
- * Always resolves — never rejects. Errors are in `RunResult`.
- *
- * ```typescript
- * const result = await run(source, {
- *   handlers: {
- *     'llm.complete': async ({ args, resume }) => {
- *       resume(await callLLM(args[0]))
- *     }
- *   }
- * })
- * ```
- */
-export declare function run(source: string, options?: RunOptions): Promise<RunResult>;
-/**
- * Level 3: Resume a suspended continuation.
- *
- * Takes a `Snapshot` from a previous `RunResult` of type `'suspended'`, a
- * resume value, and optional handlers/bindings. Re-enters the trampoline at
- * the point of suspension with the provided value.
- *
- * `bindings` are plain values only (no JS functions). They are re-injected
- * into the deserialized ContextStacks so that host-bound values remain
- * accessible after resume. `modules` must be provided again if the Dvala
- * program uses `import`.
- *
- * Always resolves — never rejects. May return `completed`, `suspended`
- * (if another suspend is hit), or `error`.
- *
- * ```typescript
- * const { snapshot } = suspendedResult
- * const next = await resume(snapshot, humanDecision, { handlers })
- * ```
- */
-export declare function resume(snapshot: Snapshot, value: Any, options?: ResumeOptions): Promise<RunResult>;

package/dist/src/Dvala/Dvala.d.ts

@@ -1,63 +0,0 @@
-import type { Context } from '../evaluator/interface';
-import type { Any } from '../interface';
-import type { Ast, DvalaFunction } from '../parser/types';
-import type { TokenStream } from '../tokenizer/tokenize';
-import { AutoCompleter } from '../AutoCompleter/AutoCompleter';
-import type { DvalaModule } from '../builtin/modules/interface';
-import type { DvalaBundle } from '../bundler/interface';
-import type { MaybePromise } from '../utils/maybePromise';
-import type { Handlers } from '../evaluator/effectTypes';
-import { Cache } from './Cache';
-export interface DvalaRuntimeInfo {
-    astCache: Cache | null;
-    astCacheSize: number | null;
-    debug: boolean;
-}
-export interface ContextParams {
-    globalContext?: Context;
-    contexts?: Context[];
-    bindings?: Record<string, unknown>;
-    handlers?: Handlers;
-    globalModuleScope?: boolean;
-}
-export interface MinifyParams {
-    minify?: boolean;
-}
-export interface FilePathParams {
-    filePath?: string;
-}
-export interface PureParams {
-    pure?: boolean;
-}
-interface DvalaConfig {
-    initialCache?: Record<string, Ast>;
-    astCacheSize?: number | null;
-    debug?: boolean;
-    modules?: DvalaModule[];
-}
-export declare class Dvala {
-    private astCache;
-    private astCacheSize;
-    private debug;
-    private modules;
-    constructor(config?: DvalaConfig);
-    getRuntimeInfo(): DvalaRuntimeInfo;
-    readonly async: {
-        run: (programOrBundle: string | DvalaBundle, params?: ContextParams & FilePathParams & PureParams) => Promise<unknown>;
-        apply: (fn: DvalaFunction, fnParams: unknown[], params?: ContextParams & PureParams) => Promise<unknown>;
-    };
-    run(programOrBundle: string | DvalaBundle, params?: ContextParams & FilePathParams & PureParams): unknown;
-    private runBundle;
-    getUndefinedSymbols(programOrAst: string | Ast, params?: ContextParams): Set<string>;
-    tokenize(program: string, tokenizeParams?: FilePathParams & MinifyParams): TokenStream;
-    parse(tokenStream: TokenStream): Ast;
-    private evaluate;
-    private evaluateAsync;
-    transformSymbols(tokenStream: TokenStream, transformer: (symbol: string) => string): TokenStream;
-    untokenize(tokenStream: TokenStream): string;
-    apply(fn: DvalaFunction, fnParams: unknown[], params?: ContextParams & PureParams): MaybePromise<Any>;
-    private generateApplyFunctionCall;
-    private generateAst;
-    getAutoCompleter(program: string, position: number, params?: ContextParams): AutoCompleter;
-}
-export {};

package/dist/src/effects.d.ts

@@ -1,110 +0,0 @@
-/**
- * Algebraic effects — host-facing API.
- *
- * Top-level standalone functions for running Dvala programs with effect handlers.
- *
- * Three levels of use:
- * 1. `runSync(source, options?)` — pure computation, sync JS functions in bindings.
- * 2. `run(source, options?)` — async effects with handlers, always completes or suspends.
- * 3. `resume(snapshot, value, options?)` — resume a suspended continuation.
- *
- * Effect handlers are JavaScript functions that receive an `EffectContext` and must
- * call exactly one of `resume(value)`, `suspend(meta?)`, `fail(msg?)`, or `next()`:
- *
- * ```typescript
- * handlers: {
- *   'llm.complete': async ({ args, signal, resume }) => {
- *     resume(await callLLM(args[0], signal))
- *   },
- *   'dvala.*': async ({ effectName, args, next }) => {
- *     console.log(`[${effectName}]`, ...args)
- *     next()  // pass to next matching handler
- *   }
- * }
- * ```
- */
-import type { Any } from './interface';
-import type { DvalaModule } from './builtin/modules/interface';
-import type { Handlers, RunResult, Snapshot } from './evaluator/effectTypes';
-export type { EffectContext, EffectHandler, Snapshot } from './evaluator/effectTypes';
-export { SuspensionSignal, isSuspensionSignal } from './evaluator/effectTypes';
-export type { Handlers, RunResult } from './evaluator/effectTypes';
-/**
- * Options for `run()` — async execution with effect handlers.
- * `bindings` are plain values only (no JS functions).
- * All host interaction goes through `handlers`.
- */
-export interface RunOptions {
-    bindings?: Record<string, Any>;
-    handlers?: Handlers;
-    modules?: DvalaModule[];
-    maxSnapshots?: number;
-}
-/**
- * Options for `runSync()` — synchronous pure computation.
- */
-export interface RunSyncOptions {
-    bindings?: Record<string, unknown>;
-    modules?: DvalaModule[];
-}
-/**
- * Options for `resume()` — resume a suspended continuation.
- * `bindings` are plain values only (no JS functions).
- * All host interaction goes through `handlers`.
- * `modules` must be provided again (they are not in the blob).
- */
-export interface ResumeOptions {
-    bindings?: Record<string, Any>;
-    handlers?: Handlers;
-    modules?: DvalaModule[];
-    maxSnapshots?: number;
-}
-/**
- * Level 1: Pure synchronous computation.
- *
- * Throws if an async operation or effect is encountered.
- *
- * ```typescript
- * const value = runSync('[1, 2, 3] |> map(_, -> $ * $)')
- * ```
- */
-export declare function runSync(source: string, options?: RunSyncOptions): Any;
-/**
- * Level 2 & 3: Async execution with effect handler support.
- *
- * `bindings` are plain values only (no JS functions).
- * All host interaction goes through `handlers`.
- * Always resolves — never rejects. Errors are in `RunResult`.
- *
- * ```typescript
- * const result = await run(source, {
- *   handlers: {
- *     'llm.complete': async ({ args, resume }) => {
- *       resume(await callLLM(args[0]))
- *     }
- *   }
- * })
- * ```
- */
-export declare function run(source: string, options?: RunOptions): Promise<RunResult>;
-/**
- * Level 3: Resume a suspended continuation.
- *
- * Takes a `Snapshot` from a previous `RunResult` of type `'suspended'`, a
- * resume value, and optional handlers/bindings. Re-enters the trampoline at
- * the point of suspension with the provided value.
- *
- * `bindings` are plain values only (no JS functions). They are re-injected
- * into the deserialized ContextStacks so that host-bound values remain
- * accessible after resume. `modules` must be provided again if the Dvala
- * program uses `import`.
- *
- * Always resolves — never rejects. May return `completed`, `suspended`
- * (if another suspend is hit), or `error`.
- *
- * ```typescript
- * const { snapshot } = suspendedResult
- * const next = await resume(snapshot, humanDecision, { handlers })
- * ```
- */
-export declare function resume(snapshot: Snapshot, value: Any, options?: ResumeOptions): Promise<RunResult>;