@synergenius/flow-weaver 0.2.1 → 0.3.0

package/dist/mcp/tools-docs.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { listTopics, readTopic, searchDocs } from '../docs/index.js';
+import { makeToolResult, makeErrorResult } from './response-utils.js';
+export function registerDocsTools(mcp) {
+    mcp.tool('fw_docs', 'Browse Flow Weaver documentation and reference guides. Use action="list" to see topics, action="read" to read a topic, action="search" to search across all docs.', {
+        action: z.enum(['list', 'read', 'search']).describe('What to do: list topics, read a topic, or search'),
+        topic: z.string().optional().describe('Topic slug to read (for action="read")'),
+        query: z.string().optional().describe('Search query (for action="search")'),
+        compact: z.boolean().optional().describe('Return compact LLM-friendly version (default: false)'),
+    }, async (args) => {
+        try {
+            switch (args.action) {
+                case 'list': {
+                    const topics = listTopics();
+                    return makeToolResult({
+                        topics: topics.map((t) => ({
+                            slug: t.slug,
+                            name: t.name,
+                            description: t.description,
+                            keywords: t.keywords,
+                        })),
+                    });
+                }
+                case 'read': {
+                    if (!args.topic) {
+                        return makeErrorResult('MISSING_PARAM', 'The "topic" parameter is required for action="read"');
+                    }
+                    const doc = readTopic(args.topic, args.compact ?? false);
+                    if (!doc) {
+                        const available = listTopics().map((t) => t.slug);
+                        return makeErrorResult('TOPIC_NOT_FOUND', `Unknown topic "${args.topic}". Available topics: ${available.join(', ')}`);
+                    }
+                    return makeToolResult({
+                        name: doc.name,
+                        description: doc.description,
+                        content: doc.content,
+                    });
+                }
+                case 'search': {
+                    if (!args.query) {
+                        return makeErrorResult('MISSING_PARAM', 'The "query" parameter is required for action="search"');
+                    }
+                    const results = searchDocs(args.query);
+                    return makeToolResult({
+                        query: args.query,
+                        results: results.slice(0, 20).map((r) => ({
+                            topic: r.topic,
+                            slug: r.slug,
+                            heading: r.heading,
+                            excerpt: r.excerpt,
+                            relevance: r.relevance,
+                        })),
+                    });
+                }
+            }
+        }
+        catch (err) {
+            return makeErrorResult('DOCS_ERROR', `fw_docs failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+//# sourceMappingURL=tools-docs.js.map

package/dist/mcp/tools-editor.js

@@ -114,7 +114,9 @@ export function registerEditorTools(mcp, connection, buffer) {
         const result = await connection.sendCommand(args.action, {});
         return makeToolResult(unwrapAckResult(result));
     });
-    mcp.tool('fw_execute_workflow', 'Run the current workflow with optional parameters and return the result.', {
+    mcp.tool('fw_execute_workflow', 'Run the current workflow with optional parameters and return the result. ' +
+        'Includes per-node execution trace by default (STATUS_CHANGED, VARIABLE_SET events) — ' +
+        'use includeTrace: false to disable.', {
         filePath: z
             .string()
             .optional()

package/dist/mcp/tools-query.js

@@ -128,7 +128,9 @@ export function registerQueryTools(mcp) {
             return makeErrorResult('VALIDATE_ERROR', `fw_validate failed: ${err instanceof Error ? err.message : String(err)}`);
         }
     });
-    mcp.tool('fw_compile', 'Compile a workflow to executable code. Use target=inngest for per-node step.run() durability.', {
+    mcp.tool('fw_compile', 'Compile a workflow to executable code. Only regenerates code inside @flow-weaver-runtime ' +
+        'and @flow-weaver-body marker sections — user code outside markers is preserved. ' +
+        'Set production: true to strip debug instrumentation. Use target=inngest for per-node step.run() durability.', {
         filePath: z.string().describe('Path to the workflow file'),
         write: z.boolean().optional().describe('Whether to write the output file (default: true)'),
         production: z

package/dist/mcp/workflow-executor.js

@@ -5,6 +5,7 @@
 import * as path from 'path';
 import * as fs from 'fs';
 import * as os from 'os';
+import { pathToFileURL } from 'url';
 import ts from 'typescript';
 import { compileWorkflow } from '../api/index.js';
 import { getAvailableWorkflows } from '../api/workflow-file-operations.js';
@@ -81,8 +82,9 @@ export async function executeWorkflowFromFile(filePath, params, options) {
         if (options?.mocks) {
             globalThis.__fw_mocks__ = options.mocks;
         }
-        // Dynamic import (tsx runtime supports .ts imports)
-        const mod = await import(tmpFile);
+        // Dynamic import using file:// URL for cross-platform compatibility
+        // (Windows paths like C:\... break with bare import() — "Received protocol 'c:'")
+        const mod = await import(pathToFileURL(tmpFile).href);
         // Find the target exported function
         const exportedFn = findExportedFunction(mod, options?.workflowName);
         if (!exportedFn) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.2.1",
-  "description": "TypeScript annotation-based workflow compiler for Flow Weaver",
+  "version": "0.3.0",
+  "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -47,6 +47,7 @@
     "postbuild": "npx tsx scripts/postbuild.ts && npm run generate:docs",
     "generate:docs": "tsx scripts/generate-docs.ts",
     "generate:docs:check": "tsx scripts/generate-docs.ts --check",
+    "release": "tsx scripts/release.ts",
     "build:cli": "npx tsx scripts/build-cli.ts",
     "watch": "tsc -p tsconfig.build.json --watch --preserveWatchOutput --incremental",
     "test": "vitest run",
@@ -64,9 +65,14 @@
   "keywords": [
     "flow-weaver",
     "workflow",
+    "ai-agent",
+    "llm",
+    "mcp",
+    "deterministic",
     "typescript",
-    "code-generation",
-    "compiler"
+    "compiler",
+    "inngest",
+    "serverless"
   ],
   "author": "Ricardo José Horta Morais",
   "license": "SEE LICENSE IN LICENSE",