@octo-cyber/workflow 0.5.0

package/dist/services/push.service.d.ts

@@ -0,0 +1,60 @@
+/**
+ * WebSocket push event types for real-time execution updates.
+ */
+export type PushEventType = 'executionStarted' | 'nodeExecuteBefore' | 'nodeExecuteAfter' | 'executionFinished';
+export interface PushEvent {
+    type: PushEventType;
+    data: unknown;
+}
+/**
+ * Minimal WebSocket interface — compatible with the `ws` library
+ * and the native browser WebSocket.
+ */
+export interface IWebSocket {
+    send(data: string): void;
+    readyState: number;
+    close(): void;
+    /** ws library uses OPEN = 1 */
+    OPEN?: number;
+}
+/**
+ * PushService — manages WebSocket connections and broadcasts
+ * real-time execution events to connected clients.
+ *
+ * Used by WorkflowEngineService to push nodeExecuteBefore/After
+ * and executionStarted/Finished events.
+ */
+export declare class PushService {
+    private readonly connections;
+    private logger;
+    /**
+     * Register a WebSocket connection for a user.
+     * Replaces any existing connection for the same userId.
+     */
+    addConnection(userId: string, ws: IWebSocket): void;
+    /**
+     * Remove a user's WebSocket connection.
+     */
+    removeConnection(userId: string): void;
+    /**
+     * Send a push event to a specific user.
+     */
+    sendToUser(userId: string, type: PushEventType, data: unknown): void;
+    /**
+     * Broadcast a push event to all connected users.
+     */
+    broadcast(type: PushEventType, data: unknown): void;
+    /**
+     * Get the number of active connections.
+     */
+    get connectionCount(): number;
+    /**
+     * Check if a user has an active WebSocket connection.
+     */
+    isConnected(userId: string): boolean;
+    /**
+     * Close all connections and clear the map.
+     */
+    closeAll(): void;
+}
+//# sourceMappingURL=push.service.d.ts.map

package/dist/services/push.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.service.d.ts","sourceRoot":"","sources":["../../src/services/push.service.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,IAAI,IAAI,CAAC;IACd,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;;;;GAMG;AACH,qBACa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAC7D,OAAO,CAAC,MAAM,CAAqD;IAEnE;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI;IAcnD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAiBpE;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAiBnD;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKpC;;OAEG;IACH,QAAQ,IAAI,IAAI;CAWjB"}

package/dist/services/push.service.js

@@ -0,0 +1,121 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushService = void 0;
+const core_1 = require("@octo/core");
+const WS_OPEN = 1;
+/**
+ * PushService — manages WebSocket connections and broadcasts
+ * real-time execution events to connected clients.
+ *
+ * Used by WorkflowEngineService to push nodeExecuteBefore/After
+ * and executionStarted/Finished events.
+ */
+let PushService = class PushService {
+    connections = new Map();
+    logger = core_1.Container.get(core_1.LoggerService).child('PushService');
+    /**
+     * Register a WebSocket connection for a user.
+     * Replaces any existing connection for the same userId.
+     */
+    addConnection(userId, ws) {
+        // Close existing connection if any
+        const existing = this.connections.get(userId);
+        if (existing) {
+            try {
+                existing.close();
+            }
+            catch {
+                // ignore close errors
+            }
+        }
+        this.connections.set(userId, ws);
+        this.logger.debug(`WebSocket connected: user=${userId} (total=${this.connections.size})`);
+    }
+    /**
+     * Remove a user's WebSocket connection.
+     */
+    removeConnection(userId) {
+        this.connections.delete(userId);
+        this.logger.debug(`WebSocket disconnected: user=${userId} (total=${this.connections.size})`);
+    }
+    /**
+     * Send a push event to a specific user.
+     */
+    sendToUser(userId, type, data) {
+        const ws = this.connections.get(userId);
+        if (!ws)
+            return;
+        if (ws.readyState === WS_OPEN) {
+            try {
+                ws.send(JSON.stringify({ type, data }));
+            }
+            catch (err) {
+                this.logger.warn(`Failed to send push event to user=${userId}: ${err}`);
+                this.connections.delete(userId);
+            }
+        }
+        else {
+            // Connection no longer open, clean up
+            this.connections.delete(userId);
+        }
+    }
+    /**
+     * Broadcast a push event to all connected users.
+     */
+    broadcast(type, data) {
+        const message = JSON.stringify({ type, data });
+        for (const [userId, ws] of this.connections) {
+            if (ws.readyState === WS_OPEN) {
+                try {
+                    ws.send(message);
+                }
+                catch (err) {
+                    this.logger.warn(`Failed to broadcast to user=${userId}: ${err}`);
+                    this.connections.delete(userId);
+                }
+            }
+            else {
+                this.connections.delete(userId);
+            }
+        }
+    }
+    /**
+     * Get the number of active connections.
+     */
+    get connectionCount() {
+        return this.connections.size;
+    }
+    /**
+     * Check if a user has an active WebSocket connection.
+     */
+    isConnected(userId) {
+        const ws = this.connections.get(userId);
+        return ws !== undefined && ws.readyState === WS_OPEN;
+    }
+    /**
+     * Close all connections and clear the map.
+     */
+    closeAll() {
+        for (const [, ws] of this.connections) {
+            try {
+                ws.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.connections.clear();
+        this.logger.info('All WebSocket connections closed');
+    }
+};
+exports.PushService = PushService;
+exports.PushService = PushService = __decorate([
+    (0, core_1.Service)()
+], PushService);
+//# sourceMappingURL=push.service.js.map

package/dist/services/push.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.service.js","sourceRoot":"","sources":["../../src/services/push.service.ts"],"names":[],"mappings":"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"}

package/dist/services/workflow-ai.service.d.ts

@@ -0,0 +1,61 @@
+import type { CliToolName } from '@octo/ai';
+interface ConversationMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface WorkflowDesignRequest {
+    /** Natural language description of the desired workflow */
+    prompt: string;
+    /** Existing workflow JSON to modify (optional) */
+    currentWorkflowJson?: string;
+    /** Additional context (available nodes, constraints, etc.) */
+    context?: string;
+    /** Which AI tool to use (default: claude) */
+    tool?: CliToolName;
+    /** Model override */
+    model?: string;
+    /** Previous conversation turns for multi-round dialogue */
+    conversationHistory?: ConversationMessage[];
+    /** Associated session ID for auto-versioning */
+    sessionId?: number;
+}
+export interface WorkflowDesignResult {
+    /** AI-generated explanation of the workflow */
+    explanation: string;
+    /** The n8n-compatible workflow JSON */
+    workflowJson: Record<string, unknown> | null;
+    /** Suggestions for improvement or follow-up */
+    suggestions: string[];
+    /** Whether the AI successfully generated a workflow */
+    success: boolean;
+    /** Error message if generation failed */
+    error?: string;
+    /** Execution duration in ms */
+    durationMs: number;
+}
+/**
+ * WorkflowAiService — uses AI CLI tools to generate n8n workflow JSON
+ * from natural language descriptions.
+ */
+export declare class WorkflowAiService {
+    private readonly logger;
+    /** Default system prompt, used as fallback when database config is unavailable */
+    static readonly DEFAULT_SYSTEM_PROMPT = "You are an n8n workflow designer. Your task is to generate n8n workflow JSON based on user requirements.\n\n## Output Format\nYou MUST respond with a JSON object containing exactly these fields:\n{\n  \"explanation\": \"A brief explanation of what the workflow does\",\n  \"workflow\": { ... },  // n8n workflow JSON\n  \"suggestions\": [\"suggestion 1\", \"suggestion 2\"]\n}\n\n## n8n Workflow JSON Structure\nA valid n8n workflow JSON has this structure:\n{\n  \"name\": \"Workflow Name\",\n  \"nodes\": [\n    {\n      \"parameters\": { ... },\n      \"name\": \"Node Name\",\n      \"type\": \"n8n-nodes-base.httpRequest\",\n      \"typeVersion\": 1,\n      \"position\": [x, y]\n    }\n  ],\n  \"connections\": {\n    \"Source Node Name\": {\n      \"main\": [[{ \"node\": \"Target Node Name\", \"type\": \"main\", \"index\": 0 }]]\n    }\n  }\n}\n\n## Common n8n Node Types\n- n8n-nodes-base.manualTrigger \u2014 Manual execution trigger\n- n8n-nodes-base.scheduleTrigger \u2014 Cron/schedule trigger\n- n8n-nodes-base.webhook \u2014 Webhook trigger\n- n8n-nodes-base.httpRequest \u2014 Make HTTP requests\n- n8n-nodes-base.if \u2014 Conditional branching\n- n8n-nodes-base.code \u2014 Custom JavaScript/Python code\n- n8n-nodes-base.set \u2014 Set/transform data\n- n8n-nodes-base.merge \u2014 Merge multiple inputs\n- n8n-nodes-base.switch \u2014 Multi-way branching\n- n8n-nodes-base.noOp \u2014 No operation (pass-through)\n- n8n-nodes-base.wait \u2014 Wait/delay\n- @n8n/n8n-nodes-langchain.agent \u2014 AI Agent node\n- @n8n/n8n-nodes-langchain.chainLlm \u2014 LLM Chain node\n\n## Rules\n1. Always include a trigger node (manualTrigger if no specific trigger is needed)\n2. Node positions should be spaced at least 250px apart horizontally\n3. Use descriptive node names\n4. Include error handling where appropriate\n5. The workflow field must be valid n8n workflow JSON that can be imported directly";
+    /**
+     * Load the system prompt from system_configs table, falling back to the
+     * hardcoded default if the database read fails or returns null.
+     */
+    getSystemPrompt(): Promise<string>;
+    /**
+     * Generate or modify an n8n workflow based on a natural language prompt.
+     */
+    design(request: WorkflowDesignRequest): Promise<WorkflowDesignResult>;
+    private parseAiResponse;
+    /**
+     * Extract JSON object from AI output that may contain markdown fences
+     * or other text wrapping.
+     */
+    private extractJson;
+}
+export {};
+//# sourceMappingURL=workflow-ai.service.d.ts.map

package/dist/services/workflow-ai.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-ai.service.d.ts","sourceRoot":"","sources":["../../src/services/workflow-ai.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAK5C,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,+CAA+C;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBACa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;IAE3E,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,qBAAqB,g4DAkD8C;IAEnF;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBxC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuE3E,OAAO,CAAC,eAAe;IAyCvB;;;OAGG;IACH,OAAO,CAAC,WAAW;CAsBpB"}

package/dist/services/workflow-ai.service.js

@@ -0,0 +1,219 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var WorkflowAiService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowAiService = void 0;
+const core_1 = require("@octo/core");
+const ai_1 = require("@octo/ai");
+/** SystemConfig key for the AI workflow designer system prompt */
+const SYSTEM_PROMPT_CONFIG_KEY = 'workflow.ai.systemPrompt';
+/**
+ * WorkflowAiService — uses AI CLI tools to generate n8n workflow JSON
+ * from natural language descriptions.
+ */
+let WorkflowAiService = class WorkflowAiService {
+    static { WorkflowAiService_1 = this; }
+    logger = core_1.Container.get(core_1.LoggerService).child('WorkflowAI');
+    /** Default system prompt, used as fallback when database config is unavailable */
+    static DEFAULT_SYSTEM_PROMPT = `You are an n8n workflow designer. Your task is to generate n8n workflow JSON based on user requirements.
+
+## Output Format
+You MUST respond with a JSON object containing exactly these fields:
+{
+  "explanation": "A brief explanation of what the workflow does",
+  "workflow": { ... },  // n8n workflow JSON
+  "suggestions": ["suggestion 1", "suggestion 2"]
+}
+
+## n8n Workflow JSON Structure
+A valid n8n workflow JSON has this structure:
+{
+  "name": "Workflow Name",
+  "nodes": [
+    {
+      "parameters": { ... },
+      "name": "Node Name",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 1,
+      "position": [x, y]
+    }
+  ],
+  "connections": {
+    "Source Node Name": {
+      "main": [[{ "node": "Target Node Name", "type": "main", "index": 0 }]]
+    }
+  }
+}
+
+## Common n8n Node Types
+- n8n-nodes-base.manualTrigger — Manual execution trigger
+- n8n-nodes-base.scheduleTrigger — Cron/schedule trigger
+- n8n-nodes-base.webhook — Webhook trigger
+- n8n-nodes-base.httpRequest — Make HTTP requests
+- n8n-nodes-base.if — Conditional branching
+- n8n-nodes-base.code — Custom JavaScript/Python code
+- n8n-nodes-base.set — Set/transform data
+- n8n-nodes-base.merge — Merge multiple inputs
+- n8n-nodes-base.switch — Multi-way branching
+- n8n-nodes-base.noOp — No operation (pass-through)
+- n8n-nodes-base.wait — Wait/delay
+- @n8n/n8n-nodes-langchain.agent — AI Agent node
+- @n8n/n8n-nodes-langchain.chainLlm — LLM Chain node
+
+## Rules
+1. Always include a trigger node (manualTrigger if no specific trigger is needed)
+2. Node positions should be spaced at least 250px apart horizontally
+3. Use descriptive node names
+4. Include error handling where appropriate
+5. The workflow field must be valid n8n workflow JSON that can be imported directly`;
+    /**
+     * Load the system prompt from system_configs table, falling back to the
+     * hardcoded default if the database read fails or returns null.
+     */
+    async getSystemPrompt() {
+        try {
+            const db = core_1.Container.get(core_1.DatabaseService);
+            const ds = db.getDataSource();
+            const rows = await ds.query('SELECT value FROM system_configs WHERE key = ?', [SYSTEM_PROMPT_CONFIG_KEY]);
+            if (rows.length > 0 && rows[0].value) {
+                return rows[0].value;
+            }
+        }
+        catch (err) {
+            this.logger.warn(`Failed to load system prompt from DB, using default: ${err}`);
+        }
+        return WorkflowAiService_1.DEFAULT_SYSTEM_PROMPT;
+    }
+    /**
+     * Generate or modify an n8n workflow based on a natural language prompt.
+     */
+    async design(request) {
+        const executor = core_1.Container.get(ai_1.CliExecutorService);
+        const tool = request.tool ?? 'claude';
+        // Load system prompt from database (falls back to hardcoded default)
+        const systemPrompt = await this.getSystemPrompt();
+        // Build the full prompt
+        const parts = [systemPrompt];
+        if (request.currentWorkflowJson) {
+            parts.push('\n## Current Workflow (modify this)\n```json\n' +
+                request.currentWorkflowJson +
+                '\n```');
+        }
+        if (request.context) {
+            parts.push(`\n## Additional Context\n${request.context}`);
+        }
+        // Include conversation history for multi-round dialogue
+        if (request.conversationHistory?.length) {
+            parts.push('\n## Conversation History');
+            for (const msg of request.conversationHistory) {
+                const label = msg.role === 'user' ? 'User' : 'Assistant';
+                parts.push(`\n### ${label}\n${msg.content}`);
+            }
+        }
+        parts.push(`\n## User Request\n${request.prompt}`);
+        parts.push('\nRespond with ONLY the JSON object. No markdown fences, no extra text.');
+        const fullPrompt = parts.join('\n');
+        try {
+            const result = await executor.execute({
+                tool,
+                prompt: fullPrompt,
+                model: request.model,
+                timeoutMs: 120_000,
+                jsonOutput: true,
+            });
+            if (!result.success) {
+                return {
+                    explanation: '',
+                    workflowJson: null,
+                    suggestions: [],
+                    success: false,
+                    error: result.error ?? `AI CLI execution failed (exit code ${result.exitCode})`,
+                    durationMs: result.durationMs,
+                };
+            }
+            return this.parseAiResponse(result.output, result.durationMs);
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            this.logger.error(`Workflow AI design failed: ${errorMsg}`);
+            return {
+                explanation: '',
+                workflowJson: null,
+                suggestions: [],
+                success: false,
+                error: errorMsg,
+                durationMs: 0,
+            };
+        }
+    }
+    parseAiResponse(output, durationMs) {
+        // Try to extract JSON from the output
+        const jsonStr = this.extractJson(output);
+        if (!jsonStr) {
+            return {
+                explanation: output,
+                workflowJson: null,
+                suggestions: [],
+                success: false,
+                error: 'AI response did not contain valid JSON',
+                durationMs,
+            };
+        }
+        try {
+            const parsed = JSON.parse(jsonStr);
+            const explanation = parsed.explanation ?? '';
+            const workflow = parsed.workflow ?? null;
+            const suggestions = parsed.suggestions ?? [];
+            return {
+                explanation,
+                workflowJson: workflow,
+                suggestions: Array.isArray(suggestions) ? suggestions : [],
+                success: workflow !== null,
+                durationMs,
+            };
+        }
+        catch {
+            return {
+                explanation: output,
+                workflowJson: null,
+                suggestions: [],
+                success: false,
+                error: 'Failed to parse AI response JSON',
+                durationMs,
+            };
+        }
+    }
+    /**
+     * Extract JSON object from AI output that may contain markdown fences
+     * or other text wrapping.
+     */
+    extractJson(text) {
+        // Try direct parse first
+        const trimmed = text.trim();
+        if (trimmed.startsWith('{')) {
+            return trimmed;
+        }
+        // Try to extract from markdown code block
+        const jsonBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+        if (jsonBlockMatch?.[1]) {
+            return jsonBlockMatch[1].trim();
+        }
+        // Try to find the first { ... } block
+        const firstBrace = trimmed.indexOf('{');
+        const lastBrace = trimmed.lastIndexOf('}');
+        if (firstBrace !== -1 && lastBrace > firstBrace) {
+            return trimmed.slice(firstBrace, lastBrace + 1);
+        }
+        return null;
+    }
+};
+exports.WorkflowAiService = WorkflowAiService;
+exports.WorkflowAiService = WorkflowAiService = WorkflowAiService_1 = __decorate([
+    (0, core_1.Service)()
+], WorkflowAiService);
+//# sourceMappingURL=workflow-ai.service.js.map

package/dist/services/workflow-ai.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-ai.service.js","sourceRoot":"","sources":["../../src/services/workflow-ai.service.ts"],"names":[],"mappings":"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"}

package/dist/services/workflow-context.service.d.ts

@@ -0,0 +1,32 @@
+export interface ApiDocModule {
+    moduleId: string;
+    moduleName: string;
+    docPath: string;
+    contentLength: number;
+}
+export interface AiToolInfo {
+    name: string;
+    displayName: string;
+    isAvailable: boolean;
+    models: string[];
+}
+export interface N8nWorkflowSummary {
+    id: string;
+    name: string;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class WorkflowContextService {
+    private readonly logger;
+    private readonly packagesDir;
+    listAiTools(): Promise<AiToolInfo[]>;
+    listApiDocs(): Promise<ApiDocModule[]>;
+    getApiDocContent(moduleId: string): Promise<string>;
+    listN8nWorkflows(): Promise<N8nWorkflowSummary[]>;
+    getN8nWorkflow(workflowId: string): Promise<Record<string, unknown>>;
+    updateN8nWorkflow(workflowId: string, workflowJson: string): Promise<void>;
+    private getN8nApiUrl;
+    private getN8nHeaders;
+}
+//# sourceMappingURL=workflow-context.service.d.ts.map

package/dist/services/workflow-context.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-context.service.d.ts","sourceRoot":"","sources":["../../src/services/workflow-context.service.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyD;IAChF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;IAEI,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBpC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAmCtC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAenD,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA+BjD,cAAc,CAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiB7B,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAuChB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;CAatB"}