@synergenius/flow-weaver 0.33.1 → 0.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.33.1",
+  "version": "0.44.0",
   "description": "Flow Weaver: deterministic TypeScript workflow compiler. Define workflows with JSDoc annotations, compile to standalone functions with zero runtime dependencies.",
   "private": false,
   "type": "module",
@@ -15,6 +15,10 @@
       "types": "./dist/runtime/index.d.ts",
       "default": "./dist/runtime/index.js"
     },
+    "./compiler": {
+      "types": "./dist/compiler/index.d.ts",
+      "default": "./dist/compiler/index.js"
+    },
     "./built-in-nodes": {
       "types": "./dist/built-in-nodes/index.d.ts",
       "default": "./dist/built-in-nodes/index.js"
@@ -87,9 +91,9 @@
       "types": "./dist/cli/exports.d.ts",
       "default": "./dist/cli/exports.js"
     },
-    "./executor": {
-      "types": "./dist/mcp/workflow-executor.d.ts",
-      "default": "./dist/mcp/workflow-executor.js"
+    "./version": {
+      "types": "./dist/generated-version.d.ts",
+      "default": "./dist/generated-version.js"
     },
     "./context": {
       "types": "./dist/context/index.d.ts",
@@ -98,26 +102,41 @@
     "./agent": {
       "types": "./dist/agent/index.d.ts",
       "default": "./dist/agent/index.js"
+    },
+    "./console": {
+      "types": "./dist/console/index.d.ts",
+      "default": "./dist/console/index.js"
+    },
+    "./coordinator": {
+      "types": "./dist/coordinator/index.d.ts",
+      "default": "./dist/coordinator/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
     }
   },
   "bin": {
-    "flow-weaver": "./dist/cli/flow-weaver.mjs",
-    "fw": "./dist/cli/flow-weaver.mjs"
+    "flow-weaver": "dist/cli/flow-weaver.mjs",
+    "fw": "dist/cli/flow-weaver.mjs"
   },
   "files": [
     "dist",
     "!dist/**/*.map",
     "docs/reference",
-    "scripts/postinstall.cjs",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE"
   ],
   "scripts": {
-    "prebuild": "tsx scripts/generate-version.ts && tsx scripts/generate-built-in-registry.ts",
+    "prebuild": "tsx scripts/generate-version.ts && tsx scripts/generate-inline-engine.ts && tsx scripts/generate-built-in-registry.ts",
+    "generate:engine": "tsx scripts/generate-inline-engine.ts",
+    "generate:engine:check": "tsx scripts/generate-inline-engine.ts --check",
     "generate:registry": "tsx scripts/generate-built-in-registry.ts",
     "generate:registry:check": "tsx scripts/generate-built-in-registry.ts --check",
-    "build": "rimraf dist .tsbuildinfo && tsc -p tsconfig.build.json && npm run build:cli",
-    "postbuild": "npx tsx scripts/postbuild.ts && npm run generate:docs",
+    "build": "rimraf dist .tsbuildinfo && tsc -p tsconfig.build.json && npm run build:cli && npm run build:console && npm run build:lib",
+    "postbuild": "npx tsx scripts/postbuild.ts && npm run generate:docs:check",
+    "build:lib": "npx tsx scripts/build-lib.ts",
     "generate:docs": "tsx scripts/generate-docs.ts",
     "generate:docs:check": "tsx scripts/generate-docs.ts --check",
     "release": "tsx scripts/release.ts",
@@ -127,15 +146,22 @@
     "test:unit": "vitest run tests/unit",
     "test:integration": "vitest run tests/integration",
     "test:watch": "vitest",
-    "lint": "npx eslint src",
+    "test:mutation": "tsx scripts/generate-version.ts && tsx scripts/generate-inline-engine.ts && stryker run",
+    "lint": "npx eslint src && npm run lint:slop && npm run lint:cycles",
     "lint:fix": "npx eslint src --fix",
+    "lint:slop": "tsx scripts/lint-slop.mjs --strict --only=middle-dot && tsx scripts/lint-slop.mjs --strict --only=emoji console-ui/src docs/reference README.md CHANGELOG.md",
+    "lint:dead": "knip --no-progress",
+    "lint:cycles": "madge --circular src",
     "typecheck": "tsc --noEmit -p tsconfig.build.json",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.json",
     "docs": "typedoc && tsx scripts/generate-grammar-docs.ts",
     "docs:serve": "npm run docs && npx http-server docs/api -c-1 -o",
-    "prepare": "npm run build && husky || true",
+    "prepare": "npm run build && (husky || true)",
     "cli": "tsx src/cli/index.ts",
     "diagram": "tsx scripts/generate-diagram.ts",
-    "postinstall": "node scripts/postinstall.cjs"
+    "build:console": "npx tsx scripts/build-console.ts",
+    "typecheck:console": "tsc --noEmit -p console-ui/tsconfig.json",
+    "test:e2e": "playwright test"
   },
   "keywords": [
     "flow-weaver",
@@ -149,61 +175,70 @@
     "typescript",
     "compiler",
     "code-generation",
-    "visual-programming",
-    "node-graph",
     "durable-execution",
-    "inngest",
-    "serverless"
+    "human-in-the-loop"
   ],
   "author": "Ricardo José Horta Morais",
-  "license": "SEE LICENSE IN LICENSE",
-  "homepage": "https://flowweaver.ai",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/synergenius-fw/flow-weaver#readme",
   "bugs": "https://github.com/synergenius-fw/flow-weaver/issues",
   "repository": {
     "type": "git",
-    "url": "https://github.com/synergenius-fw/flow-weaver.git"
+    "url": "git+https://github.com/synergenius-fw/flow-weaver.git"
   },
   "engines": {
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@inquirer/confirm": "^6",
-    "@inquirer/core": "^10",
-    "@inquirer/input": "^5",
-    "@inquirer/select": "^5",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "chevrotain": "^12.0.0",
-    "chokidar": "^4.0.0",
-    "commander": "^11.1.0",
-    "esbuild": "^0.27.2",
+    "@inquirer/confirm": "^6.3.2",
+    "@inquirer/core": "^12.0.3",
+    "@inquirer/input": "^5.1.6",
+    "@inquirer/select": "^5.2.5",
+    "@modelcontextprotocol/sdk": "^1.30.1",
+    "chevrotain": "^13.2.0",
+    "chokidar": "^5.0.0",
+    "commander": "^15.0.0",
+    "esbuild": "^0.28.0",
     "glob": "^13.0.6",
-    "immer": "^10.2.0",
-    "js-yaml": "^4.1.0",
+    "immer": "^11.1.8",
+    "js-yaml": "^5.4.2",
     "picocolors": "^1.1.1",
-    "source-map": "^0.7.6",
-    "ts-morph": "^27.0.2",
-    "ws": "^8.19.0",
-    "zod": "^3.22.4"
+    "source-map": "^0.8.0",
+    "ts-morph": "^28.0.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "@types/react": "^19.0.0",
-    "@types/ws": "^8.18.1",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@eslint/js": "^10.0.1",
+    "@playwright/test": "^1.63.0",
+    "@preact/signals": "^2.0.0",
+    "@stryker-mutator/core": "^10.0.0",
+    "@stryker-mutator/vitest-runner": "^10.0.0",
+    "@types/node": "^22.20.4",
+    "@vitest/coverage-v8": "^5.0.2",
+    "eslint": "^10.11.0",
     "husky": "^9.1.7",
-    "prettier": "^3.1.1",
-    "rimraf": "6.1.2",
-    "ts-node": "^10.9.2",
-    "tsx": "^4.21.0",
-    "typedoc": "^0.28.15",
-    "typescript": "^5.3.3",
-    "vitest": "^4.0.16"
+    "knip": "^5.88.1",
+    "madge": "^8.0.0",
+    "marked": "^18.0.14",
+    "preact": "^10.29.0",
+    "rimraf": "6.1.3",
+    "tsx": "^4.22.4",
+    "typedoc": "^0.28.19",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.1",
+    "vite": "^7.3.6",
+    "vitest": "^5.0.2"
   },
   "peerDependencies": {
-    "typescript": ">=5.0.0"
+    "typescript": ">=5.0.0 <7"
+  },
+  "overrides": {
+    "vite": "$vite",
+    "typescript": "$typescript"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "@synergenius:registry": "https://registry.npmjs.org/"
   }
 }

package/dist/agent/agent-loop.js

@@ -1,156 +0,0 @@
-/**
- * Provider-agnostic agent loop — streams LLM responses, collects tool calls,
- * executes them via a caller-provided executor, and iterates.
- *
- * The loop never touches provider internals. Adding a new provider (Codex,
- * Gemini, etc.) requires zero loop changes — just implement AgentProvider.
- */
-const DEFAULT_MAX_ITERATIONS = 15;
-const TOOL_RESULT_CAP = 10_000; // bytes
-export async function runAgentLoop(provider, tools, executor, messages, options) {
-    const maxIterations = options?.maxIterations ?? DEFAULT_MAX_ITERATIONS;
-    const signal = options?.signal;
-    const onStreamEvent = options?.onStreamEvent;
-    const onToolEvent = options?.onToolEvent;
-    const conversation = [...messages];
-    let totalPromptTokens = 0;
-    let totalCompletionTokens = 0;
-    let totalCacheReadTokens = 0;
-    let totalCacheCreationTokens = 0;
-    let totalCostUsd = 0;
-    let toolCallCount = 0;
-    for (let iteration = 0; iteration < maxIterations; iteration++) {
-        if (signal?.aborted) {
-            return buildResult(false, 'Aborted', conversation, toolCallCount, totalPromptTokens, totalCompletionTokens, totalCacheReadTokens, totalCacheCreationTokens, totalCostUsd);
-        }
-        // Stream from provider
-        let text = '';
-        let finishReason = 'stop';
-        const collectedToolCalls = [];
-        const activeToolNames = new Map();
-        const stream = provider.stream(conversation, tools, {
-            systemPrompt: options?.systemPrompt,
-            model: options?.model,
-            maxTokens: options?.maxTokens,
-            signal,
-            executor,
-            onToolEvent,
-        });
-        for await (const event of stream) {
-            onStreamEvent?.(event);
-            switch (event.type) {
-                case 'text_delta':
-                    text += event.text;
-                    break;
-                case 'tool_use_start':
-                    activeToolNames.set(event.id, event.name);
-                    break;
-                case 'tool_use_delta':
-                    // Partial JSON — tracked by provider, nothing to do here
-                    break;
-                case 'tool_use_end':
-                    collectedToolCalls.push({
-                        id: event.id,
-                        name: activeToolNames.get(event.id) ?? 'unknown',
-                        arguments: event.arguments,
-                    });
-                    activeToolNames.delete(event.id);
-                    break;
-                case 'tool_result':
-                    // CLI handled tool internally via MCP — count it
-                    toolCallCount++;
-                    break;
-                case 'usage':
-                    totalPromptTokens += event.promptTokens;
-                    totalCompletionTokens += event.completionTokens;
-                    totalCacheReadTokens += event.cacheReadTokens ?? 0;
-                    totalCacheCreationTokens += event.cacheCreationTokens ?? 0;
-                    if (event.costUsd != null)
-                        totalCostUsd = event.costUsd; // last value = cumulative from CLI
-                    break;
-                case 'message_stop':
-                    finishReason = event.finishReason;
-                    break;
-            }
-        }
-        // Add assistant message to conversation
-        if (collectedToolCalls.length > 0) {
-            conversation.push({
-                role: 'assistant',
-                content: text || '',
-                toolCalls: collectedToolCalls,
-            });
-        }
-        else if (text) {
-            conversation.push({ role: 'assistant', content: text });
-        }
-        // If no tool calls, we're done
-        if (finishReason !== 'tool_calls' || collectedToolCalls.length === 0) {
-            // Final turn hook
-            if (options?.onTurnEnd) {
-                await options.onTurnEnd({
-                    iteration,
-                    maxIterations,
-                    messages: conversation,
-                    toolCallCount,
-                    usage: { promptTokens: totalPromptTokens, completionTokens: totalCompletionTokens },
-                    isFinalTurn: true,
-                });
-            }
-            return buildResult(finishReason !== 'error', text || 'Task completed', conversation, toolCallCount, totalPromptTokens, totalCompletionTokens, totalCacheReadTokens, totalCacheCreationTokens, totalCostUsd);
-        }
-        // Execute tool calls and add results to conversation
-        for (const tc of collectedToolCalls) {
-            if (signal?.aborted)
-                break;
-            toolCallCount++;
-            onToolEvent?.({ type: 'tool_call_start', name: tc.name, args: tc.arguments });
-            let result;
-            let isError;
-            try {
-                const res = await executor(tc.name, tc.arguments);
-                result = res.result;
-                isError = res.isError;
-            }
-            catch (err) {
-                result = err instanceof Error ? err.message : String(err);
-                isError = true;
-            }
-            onToolEvent?.({ type: 'tool_call_result', name: tc.name, args: tc.arguments, result: result.slice(0, 200), isError });
-            // Add tool result to conversation (cap size to prevent context overflow)
-            conversation.push({
-                role: 'tool',
-                content: result.slice(0, TOOL_RESULT_CAP),
-                toolCallId: tc.id,
-            });
-        }
-        // Between-turns hook — runs after tool execution, before next LLM call
-        if (options?.onTurnEnd) {
-            const turnResult = await options.onTurnEnd({
-                iteration,
-                maxIterations,
-                messages: conversation,
-                toolCallCount,
-                usage: { promptTokens: totalPromptTokens, completionTokens: totalCompletionTokens },
-                isFinalTurn: false,
-            });
-            if (turnResult?.continue === false) {
-                return buildResult(true, turnResult.injectMessage ?? 'Stopped by hook', conversation, toolCallCount, totalPromptTokens, totalCompletionTokens, totalCacheReadTokens, totalCacheCreationTokens, totalCostUsd);
-            }
-            if (turnResult?.injectMessage) {
-                conversation.push({ role: 'user', content: turnResult.injectMessage });
-            }
-        }
-    }
-    return buildResult(false, `Reached max iterations (${maxIterations})`, conversation, toolCallCount, totalPromptTokens, totalCompletionTokens, totalCacheReadTokens, totalCacheCreationTokens, totalCostUsd);
-}
-function buildResult(success, summary, messages, toolCallCount, promptTokens, completionTokens, cacheReadTokens = 0, cacheCreationTokens = 0, costUsd = 0) {
-    return {
-        success,
-        summary,
-        messages,
-        toolCallCount,
-        usage: { promptTokens, completionTokens, cacheReadTokens, cacheCreationTokens, costUsd },
-    };
-}
-//# sourceMappingURL=agent-loop.js.map

package/dist/agent/cli-spawn-config.js

@@ -1,65 +0,0 @@
-/**
- * Centralized CLI spawn configuration — single source of truth for all
- * Claude CLI invocations in automation contexts.
- *
- * RULE: Every automated CLI spawn MUST use getCliBaseArgs() or getCliSessionConfig().
- * Never construct CLI args manually. This ensures:
- * - --tools "" (disable all built-in tools)
- * - --strict-mcp-config (prevent user MCP server leakage)
- * - --dangerously-skip-permissions (no permission prompts in automation)
- *
- * Interactive user sessions (e.g., fw init) are exempt — they're the user's
- * own Claude session, not automated workers.
- */
-/**
- * Base CLI args for ALL automated Claude CLI invocations (one-shot and session).
- * Enforces tool isolation and MCP lockdown.
- */
-export function getCliBaseArgs(options) {
-    const args = [
-        '-p',
-        '--dangerously-skip-permissions',
-        // Disable ALL built-in tools — only pack/MCP tools visible to model
-        '--tools', '',
-        // Prevent user/project MCP servers from leaking into sessions
-        '--strict-mcp-config',
-    ];
-    if (options?.outputFormat) {
-        args.push('--output-format', options.outputFormat);
-    }
-    if (options?.includePartialMessages) {
-        args.push('--include-partial-messages');
-    }
-    if (options?.model) {
-        args.push('--model', options.model);
-    }
-    if (options?.systemPrompt) {
-        args.push('--system-prompt', options.systemPrompt);
-    }
-    if (options?.appendSystemPrompt) {
-        args.push('--append-system-prompt', options.appendSystemPrompt);
-    }
-    if (options?.jsonSchema) {
-        args.push('--json-schema', options.jsonSchema);
-    }
-    return args;
-}
-/**
- * CLI session options for persistent sessions.
- * Merges caller options with mandatory lockdown config.
- */
-export function getCliSessionConfig(options) {
-    return {
-        binPath: options.binPath ?? 'claude',
-        cwd: options.cwd,
-        model: options.model,
-        mcpConfigPath: options.mcpConfigPath,
-        disallowedTools: options.disallowedTools,
-        // Mandatory lockdown — cannot be overridden by callers
-        tools: '',
-        strictMcpConfig: true,
-        appendSystemPrompt: options.appendSystemPrompt,
-        systemPrompt: options.systemPrompt,
-    };
-}
-//# sourceMappingURL=cli-spawn-config.js.map

package/dist/agent/device-connection.d.ts

@@ -1,79 +0,0 @@
-/**
- * Device Connection — WebSocket client for connecting a local machine
- * to the Flow Weaver platform as a mounted device.
- *
- * This is the transport layer. Packs register their own request handlers
- * on top of this connection (e.g., improve status, bot management).
- *
- * The platform relays Studio requests to connected devices and forwards
- * device events to Studio subscribers.
- */
-export interface DeviceInfo {
-    name: string;
-    hostname: string;
-    projectDir: string;
-    platform: string;
-    capabilities: string[];
-    /** Pack names that contributed device handlers (for auto-install on platform) */
-    packs?: string[];
-}
-export interface DeviceConnectionOptions {
-    platformUrl: string;
-    token: string;
-    projectDir: string;
-    deviceName?: string;
-    onConnect?: () => void;
-    onDisconnect?: (code: number) => void;
-    onEvent?: (event: DeviceEvent) => void;
-    logger?: (msg: string) => void;
-}
-export interface DeviceEvent {
-    type: string;
-    data: Record<string, unknown>;
-    timestamp: number;
-}
-type RequestHandler = (method: string, params: Record<string, unknown>) => Promise<unknown>;
-export declare class DeviceConnection {
-    private ws;
-    private heartbeatInterval;
-    private reconnectTimeout;
-    private requestHandlers;
-    private connected;
-    private shouldReconnect;
-    private readonly options;
-    private readonly deviceInfo;
-    private readonly log;
-    constructor(options: DeviceConnectionOptions);
-    /**
-     * Add a capability to advertise to the platform.
-     */
-    addCapability(capability: string): void;
-    /**
-     * Set the list of packs that contributed device handlers.
-     * The platform uses this to auto-install packs in the user's workspace.
-     */
-    setPacks(packs: string[]): void;
-    /**
-     * Register a handler for incoming requests from the platform.
-     */
-    onRequest(method: string, handler: RequestHandler): void;
-    /**
-     * Connect to the platform. Reconnects automatically on disconnect.
-     */
-    connect(): Promise<void>;
-    /**
-     * Emit an event to the platform.
-     */
-    emit(event: DeviceEvent): void;
-    /**
-     * Disconnect from the platform. No auto-reconnect.
-     */
-    disconnect(): void;
-    isConnected(): boolean;
-    getDeviceInfo(): Readonly<DeviceInfo>;
-    private send;
-    private handleMessage;
-    private scheduleReconnect;
-}
-export {};
-//# sourceMappingURL=device-connection.d.ts.map