@synergenius/flow-weaver 0.2.0

package/dist/cli/templates/providers/index.js

@@ -0,0 +1,239 @@
+/**
+ * LLM Provider Code Generators
+ * Generate provider implementation code for different LLM services
+ */
+export function generateOpenAIProvider(opts) {
+    const model = opts.model || 'gpt-4o';
+    const apiKey = opts.apiKeyEnvVar || 'OPENAI_API_KEY';
+    return `
+/* ============================================================
+ * OPENAI PROVIDER
+ * Set ${apiKey} environment variable before running
+ * ============================================================ */
+
+const ${apiKey} = process.env.${apiKey};
+if (!${apiKey}) {
+  throw new Error('Missing ${apiKey} environment variable');
+}
+
+const _defaultLlmProvider: LLMProvider = {
+  async chat(messages, options) {
+    const response = await fetch('https://api.openai.com/v1/chat/completions', {
+      method: 'POST',
+      headers: {
+        'Authorization': \`Bearer \${${apiKey}}\`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        model: options?.model ?? '${model}',
+        messages: messages.map(m => ({
+          role: m.role,
+          content: m.content,
+          ...(m.toolCallId && { tool_call_id: m.toolCallId }),
+        })),
+        tools: options?.tools?.map(t => ({
+          type: 'function',
+          function: { name: t.name, description: t.description, parameters: t.parameters },
+        })),
+        temperature: options?.temperature,
+        max_tokens: options?.maxTokens,
+      }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(\`OpenAI API error: \${response.status} \${error}\`);
+    }
+
+    const data = await response.json();
+    const choice = data.choices[0];
+
+    return {
+      content: choice.message.content,
+      toolCalls: choice.message.tool_calls?.map((tc: any) => ({
+        id: tc.id,
+        name: tc.function.name,
+        arguments: JSON.parse(tc.function.arguments),
+      })) ?? [],
+      finishReason: choice.finish_reason === 'tool_calls' ? 'tool_calls' : 'stop',
+    };
+  },
+};
+
+const llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? _defaultLlmProvider;
+`;
+}
+export function generateAnthropicProvider(opts) {
+    const model = opts.model || 'claude-3-5-sonnet-20241022';
+    const apiKey = opts.apiKeyEnvVar || 'ANTHROPIC_API_KEY';
+    return `
+/* ============================================================
+ * ANTHROPIC PROVIDER
+ * Set ${apiKey} environment variable before running
+ * ============================================================ */
+
+const ${apiKey} = process.env.${apiKey};
+if (!${apiKey}) {
+  throw new Error('Missing ${apiKey} environment variable');
+}
+
+const _defaultLlmProvider: LLMProvider = {
+  async chat(messages, options) {
+    // Separate system message (Anthropic handles it differently)
+    const systemMessage = messages.find(m => m.role === 'system');
+    const chatMessages = messages.filter(m => m.role !== 'system');
+
+    const response = await fetch('https://api.anthropic.com/v1/messages', {
+      method: 'POST',
+      headers: {
+        'x-api-key': ${apiKey},
+        'anthropic-version': '2023-06-01',
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        model: options?.model ?? '${model}',
+        max_tokens: options?.maxTokens ?? 4096,
+        system: systemMessage?.content ?? options?.systemPrompt,
+        messages: chatMessages.map(m => {
+          if (m.role === 'tool') {
+            return {
+              role: 'user',
+              content: [{ type: 'tool_result', tool_use_id: m.toolCallId, content: m.content }],
+            };
+          }
+          return { role: m.role, content: m.content };
+        }),
+        tools: options?.tools?.map(t => ({
+          name: t.name,
+          description: t.description,
+          input_schema: { type: 'object', properties: t.parameters.properties, required: t.parameters.required },
+        })),
+      }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(\`Anthropic API error: \${response.status} \${error}\`);
+    }
+
+    const data = await response.json();
+
+    let content: string | null = null;
+    const toolCalls: LLMToolCall[] = [];
+
+    for (const block of data.content) {
+      if (block.type === 'text') content = block.text;
+      if (block.type === 'tool_use') {
+        toolCalls.push({ id: block.id, name: block.name, arguments: block.input });
+      }
+    }
+
+    return {
+      content,
+      toolCalls,
+      finishReason: data.stop_reason === 'tool_use' ? 'tool_calls' : 'stop',
+    };
+  },
+};
+
+const llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? _defaultLlmProvider;
+`;
+}
+export function generateOllamaProvider(opts) {
+    const model = opts.model || 'llama3.2';
+    return `
+/* ============================================================
+ * OLLAMA PROVIDER (Local)
+ * Ensure Ollama is running: ollama serve
+ * Pull model first: ollama pull ${model}
+ * ============================================================ */
+
+const OLLAMA_BASE_URL = process.env.OLLAMA_BASE_URL ?? 'http://localhost:11434';
+
+const _defaultLlmProvider: LLMProvider = {
+  async chat(messages, options) {
+    const response = await fetch(\`\${OLLAMA_BASE_URL}/api/chat\`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        model: options?.model ?? '${model}',
+        messages: messages.map(m => ({ role: m.role, content: m.content })),
+        stream: false,
+        options: {
+          temperature: options?.temperature,
+          num_predict: options?.maxTokens,
+        },
+      }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(\`Ollama error: \${response.status} \${error}\`);
+    }
+
+    const data = await response.json();
+
+    return {
+      content: data.message?.content ?? null,
+      toolCalls: [], // Ollama tool support varies by model
+      finishReason: 'stop',
+    };
+  },
+};
+
+const llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? _defaultLlmProvider;
+`;
+}
+export function generateMockProvider() {
+    return `
+/* ============================================================
+ * MOCK PROVIDER (For Testing)
+ * Replace with real provider for production use
+ * ============================================================ */
+
+const _defaultLlmProvider: LLMProvider = {
+  async chat(messages, options) {
+    const last = messages[messages.length - 1];
+
+    // Simulate tool call if message contains "search"
+    if (options?.tools && last.content.toLowerCase().includes('search')) {
+      return {
+        content: null,
+        toolCalls: [{
+          id: 'call_' + Date.now(),
+          name: 'search',
+          arguments: { query: last.content },
+        }],
+        finishReason: 'tool_calls',
+      };
+    }
+
+    return {
+      content: '[Mock response] ' + last.content,
+      toolCalls: [],
+      finishReason: 'stop',
+    };
+  },
+};
+
+const llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? _defaultLlmProvider;
+`;
+}
+export function getProviderCode(provider, model) {
+    const opts = { model: model || '' };
+    switch (provider) {
+        case 'openai':
+            return generateOpenAIProvider({ ...opts, model: model || 'gpt-4o' });
+        case 'anthropic':
+            return generateAnthropicProvider({
+                ...opts,
+                model: model || 'claude-3-5-sonnet-20241022',
+            });
+        case 'ollama':
+            return generateOllamaProvider({ ...opts, model: model || 'llama3.2' });
+        case 'mock':
+        default:
+            return generateMockProvider();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/templates/shared/approval-types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared Approval type definitions for human-approval template code generation.
+ *
+ * These strings are embedded into generated node code by the human-approval template.
+ * They provide the common type system for approval workflows.
+ */
+/** Core approval types — embedded in generated human-approval nodes */
+export declare const APPROVAL_TYPES = "interface ApprovalRequest {\n  /** Unique identifier for this approval request */\n  id: string;\n  /** Human-readable prompt describing what needs approval */\n  prompt: string;\n  /** Additional context for the reviewer */\n  context?: Record<string, unknown>;\n  /** Timeout duration (e.g. \"7d\", \"1h\") */\n  timeout?: string;\n}\n\ninterface ApprovalResult {\n  /** Whether the request was approved */\n  approved: boolean;\n  /** Reviewer's response text */\n  response?: string;\n  /** Reviewer identifier */\n  reviewer?: string;\n}\n\ninterface ApprovalProvider {\n  requestApproval(request: ApprovalRequest): Promise<ApprovalResult>;\n}";
+//# sourceMappingURL=approval-types.d.ts.map

package/dist/cli/templates/shared/approval-types.js

@@ -0,0 +1,31 @@
+/**
+ * Shared Approval type definitions for human-approval template code generation.
+ *
+ * These strings are embedded into generated node code by the human-approval template.
+ * They provide the common type system for approval workflows.
+ */
+/** Core approval types — embedded in generated human-approval nodes */
+export const APPROVAL_TYPES = `interface ApprovalRequest {
+  /** Unique identifier for this approval request */
+  id: string;
+  /** Human-readable prompt describing what needs approval */
+  prompt: string;
+  /** Additional context for the reviewer */
+  context?: Record<string, unknown>;
+  /** Timeout duration (e.g. "7d", "1h") */
+  timeout?: string;
+}
+
+interface ApprovalResult {
+  /** Whether the request was approved */
+  approved: boolean;
+  /** Reviewer's response text */
+  response?: string;
+  /** Reviewer identifier */
+  reviewer?: string;
+}
+
+interface ApprovalProvider {
+  requestApproval(request: ApprovalRequest): Promise<ApprovalResult>;
+}`;
+//# sourceMappingURL=approval-types.js.map

package/dist/cli/templates/shared/llm-types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared LLM type definitions for AI template code generation.
+ *
+ * These strings are embedded into generated workflow code by the AI templates.
+ * They provide the common type system that all AI workflows need.
+ */
+/** Core LLM types — embedded in all AI templates */
+export declare const LLM_CORE_TYPES = "interface LLMMessage {\n  role: 'system' | 'user' | 'assistant' | 'tool';\n  content: string;\n  toolCallId?: string;\n}\n\ninterface LLMResponse {\n  content: string | null;\n  toolCalls: LLMToolCall[];\n  finishReason: 'stop' | 'tool_calls' | 'length' | 'error';\n}\n\ninterface LLMToolCall {\n  id: string;\n  name: string;\n  arguments: Record<string, unknown>;\n}\n\ninterface LLMTool {\n  name: string;\n  description: string;\n  parameters: {\n    type: 'object';\n    properties: Record<string, { type: string }>;\n    required?: string[];\n  };\n}\n\ninterface LLMProvider {\n  chat(\n    messages: LLMMessage[],\n    options?: { tools?: LLMTool[]; systemPrompt?: string; model?: string; temperature?: number; maxTokens?: number }\n  ): Promise<LLMResponse>;\n}";
+/** Simplified LLM types — for templates that don't need tool calling */
+export declare const LLM_SIMPLE_TYPES = "interface LLMMessage {\n  role: 'system' | 'user' | 'assistant' | 'tool';\n  content: string;\n  toolCallId?: string;\n}\n\ninterface LLMToolCall {\n  id: string;\n  name: string;\n  arguments: Record<string, unknown>;\n}\n\ninterface LLMResponse {\n  content: string | null;\n  toolCalls: LLMToolCall[];\n  finishReason: 'stop' | 'tool_calls' | 'length' | 'error';\n}\n\ninterface LLMProvider {\n  chat(messages: LLMMessage[], options?: { systemPrompt?: string; model?: string; temperature?: number; maxTokens?: number }): Promise<LLMResponse>;\n}";
+/** Mock provider factory code */
+export declare const LLM_MOCK_PROVIDER = "const createMockProvider = (): LLMProvider => ({\n  async chat(messages) {\n    const lastMessage = messages[messages.length - 1];\n    return {\n      content: `[Mock response to: ${lastMessage.content.slice(0, 50)}...]`,\n      toolCalls: [],\n      finishReason: 'stop',\n    };\n  },\n});\n\nconst llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? createMockProvider();";
+/** Mock provider with tool calling support (for ai-agent) */
+export declare const LLM_MOCK_PROVIDER_WITH_TOOLS = "const createMockProvider = (): LLMProvider => ({\n  async chat(messages, options) {\n    const last = messages[messages.length - 1];\n    if (options?.tools && last.content.toLowerCase().includes('search')) {\n      return {\n        content: null,\n        toolCalls: [\n          {\n            id: 'call_' + Date.now(),\n            name: 'search',\n            arguments: { query: last.content },\n          },\n        ],\n        finishReason: 'tool_calls',\n      };\n    }\n\n    return {\n      content: '[Mock answer] ' + last.content,\n      toolCalls: [],\n      finishReason: 'stop',\n    };\n  },\n});\n\nconst llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? createMockProvider();";
+//# sourceMappingURL=llm-types.d.ts.map

package/dist/cli/templates/shared/llm-types.js

@@ -0,0 +1,104 @@
+/**
+ * Shared LLM type definitions for AI template code generation.
+ *
+ * These strings are embedded into generated workflow code by the AI templates.
+ * They provide the common type system that all AI workflows need.
+ */
+/** Core LLM types — embedded in all AI templates */
+export const LLM_CORE_TYPES = `interface LLMMessage {
+  role: 'system' | 'user' | 'assistant' | 'tool';
+  content: string;
+  toolCallId?: string;
+}
+
+interface LLMResponse {
+  content: string | null;
+  toolCalls: LLMToolCall[];
+  finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+}
+
+interface LLMToolCall {
+  id: string;
+  name: string;
+  arguments: Record<string, unknown>;
+}
+
+interface LLMTool {
+  name: string;
+  description: string;
+  parameters: {
+    type: 'object';
+    properties: Record<string, { type: string }>;
+    required?: string[];
+  };
+}
+
+interface LLMProvider {
+  chat(
+    messages: LLMMessage[],
+    options?: { tools?: LLMTool[]; systemPrompt?: string; model?: string; temperature?: number; maxTokens?: number }
+  ): Promise<LLMResponse>;
+}`;
+/** Simplified LLM types — for templates that don't need tool calling */
+export const LLM_SIMPLE_TYPES = `interface LLMMessage {
+  role: 'system' | 'user' | 'assistant' | 'tool';
+  content: string;
+  toolCallId?: string;
+}
+
+interface LLMToolCall {
+  id: string;
+  name: string;
+  arguments: Record<string, unknown>;
+}
+
+interface LLMResponse {
+  content: string | null;
+  toolCalls: LLMToolCall[];
+  finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+}
+
+interface LLMProvider {
+  chat(messages: LLMMessage[], options?: { systemPrompt?: string; model?: string; temperature?: number; maxTokens?: number }): Promise<LLMResponse>;
+}`;
+/** Mock provider factory code */
+export const LLM_MOCK_PROVIDER = `const createMockProvider = (): LLMProvider => ({
+  async chat(messages) {
+    const lastMessage = messages[messages.length - 1];
+    return {
+      content: \`[Mock response to: \${lastMessage.content.slice(0, 50)}...]\`,
+      toolCalls: [],
+      finishReason: 'stop',
+    };
+  },
+});
+
+const llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? createMockProvider();`;
+/** Mock provider with tool calling support (for ai-agent) */
+export const LLM_MOCK_PROVIDER_WITH_TOOLS = `const createMockProvider = (): LLMProvider => ({
+  async chat(messages, options) {
+    const last = messages[messages.length - 1];
+    if (options?.tools && last.content.toLowerCase().includes('search')) {
+      return {
+        content: null,
+        toolCalls: [
+          {
+            id: 'call_' + Date.now(),
+            name: 'search',
+            arguments: { query: last.content },
+          },
+        ],
+        finishReason: 'tool_calls',
+      };
+    }
+
+    return {
+      content: '[Mock answer] ' + last.content,
+      toolCalls: [],
+      finishReason: 'stop',
+    };
+  },
+});
+
+const llmProvider: LLMProvider = (globalThis as unknown as { __fw_llm_provider__?: LLMProvider }).__fw_llm_provider__ ?? createMockProvider();`;
+//# sourceMappingURL=llm-types.js.map

package/dist/cli/templates/workflows/aggregator.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Aggregator Template
+ * Combine multiple inputs into a single output
+ */
+import type { WorkflowTemplate } from "../index.js";
+export declare const aggregatorTemplate: WorkflowTemplate;
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/cli/templates/workflows/aggregator.js

@@ -0,0 +1,104 @@
+/**
+ * Aggregator Template
+ * Combine multiple inputs into a single output
+ */
+export const aggregatorTemplate = {
+    id: "aggregator",
+    name: "Aggregator",
+    description: "Combine multiple data sources into one output",
+    category: "data-processing",
+    generate: (opts) => {
+        const { workflowName, async: isAsync } = opts;
+        const asyncKeyword = isAsync ? "async " : "";
+        const returnType = isAsync
+            ? "Promise<{ onSuccess: boolean; onFailure: boolean; aggregated: any }>"
+            : "{ onSuccess: boolean; onFailure: boolean; aggregated: any }";
+        return `
+// Use @expression for pure functions, normal mode for branching
+
+/**
+ * Fetches data from source A
+ *
+ * @flowWeaver nodeType
+ * @expression
+ * @label Fetch Source A
+ * @input query [order:0] - Query parameters
+ * @output data [order:0] - Data from source A
+ */
+function fetchSourceA(query: any): { data: any } {
+  // TODO: Fetch from source A
+  return { data: { source: "A", items: [] } };
+}
+
+/**
+ * Fetches data from source B
+ *
+ * @flowWeaver nodeType
+ * @expression
+ * @label Fetch Source B
+ * @input query [order:0] - Query parameters
+ * @output data [order:0] - Data from source B
+ */
+function fetchSourceB(query: any): { data: any } {
+  // TODO: Fetch from source B
+  return { data: { source: "B", items: [] } };
+}
+
+/**
+ * Combines data from multiple sources
+ *
+ * @flowWeaver nodeType
+ * @expression
+ * @label Combine Data
+ * @input dataA [order:0] - Data from source A
+ * @input dataB [order:1] - Data from source B
+ * @output aggregated [order:0] - Combined data
+ */
+function combineData(dataA: any, dataB: any): { aggregated: any } {
+  // TODO: Implement aggregation logic
+  return {
+    aggregated: {
+      sources: [dataA?.source, dataB?.source],
+      totalItems: (dataA?.items?.length || 0) + (dataB?.items?.length || 0),
+      items: [...(dataA?.items || []), ...(dataB?.items || [])],
+      aggregatedAt: new Date().toISOString()
+    }
+  };
+}
+
+/**
+ * @flowWeaver workflow
+ * @node sourceA fetchSourceA
+ * @node sourceB fetchSourceB
+ * @node combiner combineData
+ * @position Start -450 0
+ * @position sourceA -180 -90
+ * @position sourceB -180 90
+ * @position combiner 90 0
+ * @position Exit 360 0
+ * @connect Start.execute -> sourceA.execute
+ * @connect Start.execute -> sourceB.execute
+ * @connect Start.query -> sourceA.query
+ * @connect Start.query -> sourceB.query
+ * @connect sourceA.onSuccess -> combiner.execute
+ * @connect sourceA.data -> combiner.dataA
+ * @connect sourceB.data -> combiner.dataB
+ * @connect combiner.aggregated -> Exit.aggregated
+ * @connect combiner.onSuccess -> Exit.onSuccess
+ * @connect combiner.onFailure -> Exit.onFailure
+ * @param execute [order:0] - Execute
+ * @param query [order:1] - Query parameters for fetching
+ * @returns onSuccess [order:0] - On Success
+ * @returns onFailure [order:1] - On Failure
+ * @returns aggregated [order:2] - Combined data from all sources
+ */
+export ${asyncKeyword}function ${workflowName}(
+  execute: boolean,
+  params: { query: any }
+): ${returnType} {
+  throw new Error("Compile with: flow-weaver compile <file>");
+}
+`.trim();
+    },
+};
+//# sourceMappingURL=aggregator.js.map

package/dist/cli/templates/workflows/ai-agent-durable.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Durable AI Agent Template
+ * Linear agent pipeline with durability annotations for Inngest compilation.
+ * Each node maps to a checkpointed step when compiled with: fw export --target inngest
+ */
+import type { WorkflowTemplate } from '../index.js';
+export declare const aiAgentDurableTemplate: WorkflowTemplate;
+//# sourceMappingURL=ai-agent-durable.d.ts.map