@elizaos/plugin-n8n-workflow 1.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-workflow-service.js","sourceRoot":"","sources":["../../src/services/n8n-workflow-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAQxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAC;AAWxD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAmB,SAAQ,OAAO;IAC7C,MAAM,CAAmB,WAAW,GAAG,yBAAyB,CAAC;IAExD,qBAAqB,GAC5B,8EAA8E;QAC9E,0EAA0E,CAAC;IAErE,SAAS,GAAwB,IAAI,CAAC;IACtC,aAAa,GAAoC,IAAI,CAAC;IAE9D;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAsB;QACvC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,kCAAkC,CAAC,CAAC;QAE7F,yBAAyB;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE5C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QAED,0CAA0C;QAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAE/B,CAAC;QACd,MAAM,WAAW,GAAG,WAAW,EAAE,WAAW,CAAC;QAE7C,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,aAAa,GAAG;YACtB,MAAM;YACN,IAAI;YACJ,WAAW;SACZ,CAAC;QAEF,wBAAwB;QACxB,OAAO,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEnD,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,+CAA+C,IAAI,EAAE,CACtD,CAAC;QACF,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,+BAA+B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,kCAAkC,CAAC,CAAC;QAC7F,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,8BAA8B,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,wBAAwB,CAAC,MAAc,EAAE,MAAe;QAC5D,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,0CAA0C,MAAM,IAAI,SAAS,EAAE,CAChE,CAAC;QAEF,IAAI,CAAC;YACH,gDAAgD;YAChD,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,gCAAgC,CAAC,CAAC;YAC5F,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,uBAAuB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7C,CAAC;YAEF,sCAAsC;YACtC,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,mCAAmC,CACpC,CAAC;YACF,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,SAAS,aAAa,CAAC,MAAM,iBAAiB,CAC/C,CAAC;YAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,gJAAgJ,CACjJ,CAAC;YACJ,CAAC;YAED,oDAAoD;YACpD,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,qCAAqC,CACtC,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CACrC,IAAI,CAAC,OAAO,EACZ,MAAM,EACN,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACjC,CAAC;YACF,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,2BAA2B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,QAAQ,CAC/D,CAAC;YAEF,sCAAsC;YACtC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,gCAAgC,CAAC,CAAC;YAC5F,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACpD,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,sBAAsB,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAC;gBACF,MAAM,IAAI,KAAK,CAAC,kCAAkC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,wBAAwB,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;YACJ,CAAC;YAED,mCAAmC;YACnC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,8BAA8B,CAAC,CAAC;YAC1F,MAAM,kBAAkB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAEnD,8BAA8B;YAC9B,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,kCAAkC,CAAC,CAAC;YAC9F,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,MAAM,gBAAgB,GAAG,MAAM,kBAAkB,CAC/C,kBAAkB,EAClB,MAAM,IAAI,EAAE,EACZ,IAAI,CAAC,OAAO,EACZ,MAAM,EACN,MAAM,CACP,CAAC;YAEF,8BAA8B;YAC9B,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,mCAAmC,CACpC,CAAC;YACF,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE/E,wCAAwC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,qCAAqC;oBACrC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC7C,IAAI,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,MAAM,EAAE,CAAC,CAAC;oBAEzE,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC;oBACrD,CAAC;oBAED,yBAAyB;oBACzB,MAAM,MAAM,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;oBAClE,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,mBAAmB,eAAe,CAAC,EAAE,cAAc,MAAM,EAAE,CAC5D,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACpF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,kCAAkC,eAAe,CAAC,EAAE,EAAE,CACvD,CAAC;YAEF,OAAO;gBACL,EAAE,EAAE,eAAe,CAAC,EAAE;gBACtB,IAAI,EAAE,eAAe,CAAC,IAAI;gBAC1B,MAAM,EAAE,eAAe,CAAC,MAAM,IAAI,KAAK;gBACvC,SAAS,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;gBAC7C,kBAAkB,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,QAAQ,CAAC;aACrE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAe;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhC,IAAI,MAAM,EAAE,CAAC;YACX,qBAAqB;YACrB,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,MAAM,EAAE,CAAC,CAAC;YAE3E,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,CAAC,6BAA6B;YAC1C,CAAC;YAED,sCAAsC;YACtC,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;YACvD,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,YAAY,UAAU,YAAY,CAAC,CAAC;IAC/F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,UAAkB;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,YAAY,UAAU,cAAc,CAAC,CAAC;IACjG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAAE,YAAY,UAAU,UAAU,CAAC,CAAC;IAC7F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,kCAAkC,EAAE,EAC3C,YAAY,UAAU,6BAA6B,SAAS,CAAC,EAAE,EAAE,CAClE,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,UAAkB,EAAE,KAAc;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,WAAmB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,313 @@
+export interface N8nWorkflow {
+    name: string;
+    nodes: N8nNode[];
+    connections: N8nConnections;
+    active?: boolean;
+    settings?: {
+        executionOrder?: 'v1' | 'v0';
+        saveExecutionProgress?: boolean;
+        saveManualExecutions?: boolean;
+        saveDataErrorExecution?: 'all' | 'none';
+        saveDataSuccessExecution?: 'all' | 'none';
+        executionTimeout?: number;
+        timezone?: string;
+    };
+    tags?: N8nTag[];
+    meta?: Record<string, unknown>;
+    id?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    /**
+     * Metadata generated by LLM (not sent to n8n API)
+     * Used internally for preview and clarification
+     */
+    _meta?: WorkflowMeta;
+}
+/**
+ * Workflow metadata for internal use
+ * Generated by LLM, used for preview and clarification
+ * NOT sent to n8n API
+ */
+export interface WorkflowMeta {
+    assumptions?: string[];
+    suggestions?: string[];
+    requiresClarification?: string[];
+}
+export interface N8nNode {
+    id?: string;
+    name: string;
+    type: string;
+    typeVersion: number;
+    position: [number, number];
+    parameters: Record<string, unknown>;
+    credentials?: Record<string, N8nCredentialReference>;
+    disabled?: boolean;
+    notes?: string;
+    notesInFlow?: boolean;
+    color?: string;
+    continueOnFail?: boolean;
+    executeOnce?: boolean;
+    alwaysOutputData?: boolean;
+    retryOnFail?: boolean;
+    maxTries?: number;
+    waitBetweenTries?: number;
+    onError?: 'continueErrorOutput' | 'continueRegularOutput' | 'stopWorkflow';
+}
+export interface N8nCredentialReference {
+    id: string;
+    name: string;
+}
+export interface N8nConnections {
+    [nodeName: string]: {
+        [outputType: string]: Array<Array<{
+            node: string;
+            type: string;
+            index: number;
+        }>>;
+    };
+}
+export interface N8nWorkflowResponse extends N8nWorkflow {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    versionId: string;
+}
+export interface N8nCredential {
+    id: string;
+    name: string;
+    type: string;
+    data?: Record<string, unknown>;
+    isResolvable?: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface N8nCredentialSchema {
+    type: 'object';
+    additionalProperties: boolean;
+    properties: Record<string, {
+        type: string;
+        displayName?: string;
+        default?: unknown;
+        required?: boolean;
+        description?: string;
+    }>;
+    required?: string[];
+}
+export interface N8nExecution {
+    id: string;
+    finished: boolean;
+    mode: 'cli' | 'error' | 'integrated' | 'internal' | 'manual' | 'retry' | 'trigger' | 'webhook' | 'evaluation' | 'chat';
+    retryOf?: string | null;
+    retrySuccessId?: string | null;
+    startedAt: string;
+    stoppedAt?: string | null;
+    workflowId: string;
+    status: 'canceled' | 'crashed' | 'error' | 'new' | 'running' | 'success' | 'unknown' | 'waiting';
+    waitTill?: string | null;
+    customData?: Record<string, unknown>;
+    data?: {
+        resultData?: {
+            runData?: Record<string, unknown[]>;
+            lastNodeExecuted?: string;
+            error?: {
+                message: string;
+                stack?: string;
+            };
+        };
+        executionData?: {
+            contextData?: Record<string, unknown>;
+            nodeExecutionStack?: unknown[];
+            waitingExecution?: Record<string, unknown>;
+        };
+    };
+}
+export interface N8nTag {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface NodeDefinition {
+    name: string;
+    displayName: string;
+    description: string;
+    icon?: string;
+    iconUrl?: string;
+    group: string[];
+    version: number;
+    subtitle?: string;
+    defaults: {
+        name: string;
+        color?: string;
+    };
+    inputs: string[];
+    outputs: string[];
+    credentials?: Array<{
+        name: string;
+        required: boolean;
+        displayOptions?: unknown;
+    }>;
+    properties: NodeProperty[];
+    webhooks?: unknown[];
+    polling?: boolean;
+    triggerPanel?: unknown;
+}
+export interface NodeProperty {
+    displayName: string;
+    name: string;
+    type: string;
+    default: unknown;
+    required?: boolean;
+    description?: string;
+    options?: Array<{
+        name: string;
+        value: string | number | boolean;
+        description?: string;
+    }>;
+    displayOptions?: unknown;
+    placeholder?: string;
+    hint?: string;
+    routing?: unknown;
+}
+export interface NodeSearchResult {
+    node: NodeDefinition;
+    score: number;
+    matchReason: string;
+}
+export interface KeywordExtractionResult {
+    keywords: string[];
+}
+export interface WorkflowGenerationContext {
+    prompt: string;
+    keywords: string[];
+    relevantNodes: NodeDefinition[];
+    userId?: string;
+}
+/**
+ * Result of semantic workflow matching
+ */
+export interface WorkflowMatchResult {
+    matchedWorkflowId: string | null;
+    confidence: 'high' | 'medium' | 'low' | 'none';
+    matches: Array<{
+        id: string;
+        name: string;
+        score: number;
+    }>;
+    reason: string;
+}
+export interface WorkflowValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    fixedWorkflow?: N8nWorkflow;
+}
+export interface UserTokens {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: Date;
+    expiresIn?: number;
+    scope?: string;
+    tokenType?: string;
+    apiKey?: string;
+    domain?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Duck-typed OAuth service interface.
+ * Any service with serviceType = "oauth" implementing these methods will work.
+ * Used for cloud mode with automatic OAuth credential injection.
+ */
+export type OAuthService = {
+    /**
+     * Generate OAuth URL for user to authorize app connection
+     */
+    getAuthUrl(userId: string, provider: string, scopes: string[]): Promise<string>;
+    /**
+     * Check if user has connected a specific app
+     */
+    hasConnection(userId: string, credType: string): Promise<boolean>;
+    /**
+     * Get user's OAuth tokens for a credential type
+     */
+    getTokens(userId: string, credType: string): Promise<UserTokens | null>;
+    /**
+     * Get existing n8n credential ID for user + credential type
+     */
+    getN8nCredId(userId: string, credType: string): Promise<string | null>;
+    /**
+     * Store n8n credential ID after creation
+     */
+    setN8nCredId(userId: string, credType: string, credId: string): Promise<void>;
+    /**
+     * Get platform's OAuth app config (clientId, clientSecret) for a provider
+     */
+    getOAuthAppConfig?(provider: string): Promise<{
+        clientId: string;
+        clientSecret: string;
+        scope?: string;
+    }>;
+};
+/**
+ * Type guard to check if a service implements OAuthService interface
+ */
+export declare function isOAuthService(service: unknown): service is OAuthService;
+export interface CredentialResolutionResult {
+    workflow: N8nWorkflow;
+    missingConnections: MissingConnection[];
+    injectedCredentials: Map<string, string>;
+}
+export interface MissingConnection {
+    credType: string;
+    oauthUrl?: string;
+}
+export interface N8nPluginConfig {
+    apiKey: string;
+    host: string;
+    credentials?: Record<string, string>;
+}
+export interface CreateWorkflowParams {
+    prompt: string;
+}
+export interface WorkflowIdParams {
+    workflowId: string;
+}
+export interface GetExecutionsParams {
+    workflowId: string;
+    limit?: number;
+    status?: 'success' | 'error' | 'running' | 'waiting';
+}
+export interface WorkflowCreationResult extends Record<string, unknown> {
+    id: string;
+    name: string;
+    active: boolean;
+    nodeCount: number;
+    missingCredentials: string[];
+}
+export interface WorkflowStatusInfo {
+    id: string;
+    name: string;
+    active: boolean;
+    lastExecution?: {
+        id: string;
+        status: string;
+        startedAt: string;
+        finishedAt?: string;
+        error?: string;
+    };
+    tags: string[];
+}
+export declare class N8nApiError extends Error {
+    statusCode?: number | undefined;
+    response?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined);
+}
+export declare class WorkflowValidationError extends Error {
+    errors: string[];
+    constructor(message: string, errors: string[]);
+}
+export declare class CredentialResolutionError extends Error {
+    missingConnections: MissingConnection[];
+    constructor(message: string, missingConnections: MissingConnection[]);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,43 @@
+// Core n8n workflow types
+/**
+ * Type guard to check if a service implements OAuthService interface
+ */
+export function isOAuthService(service) {
+    if (!service || typeof service !== 'object') {
+        return false;
+    }
+    const s = service;
+    return (typeof s.getAuthUrl === 'function' &&
+        typeof s.hasConnection === 'function' &&
+        typeof s.getTokens === 'function' &&
+        typeof s.getN8nCredId === 'function' &&
+        typeof s.setN8nCredId === 'function');
+}
+// Error types
+export class N8nApiError extends Error {
+    statusCode;
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'N8nApiError';
+    }
+}
+export class WorkflowValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'WorkflowValidationError';
+    }
+}
+export class CredentialResolutionError extends Error {
+    missingConnections;
+    constructor(message, missingConnections) {
+        super(message);
+        this.missingConnections = missingConnections;
+        this.name = 'CredentialResolutionError';
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AA2S1B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,GAAG,OAAkC,CAAC;IAE7C,OAAO,CACL,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU;QAClC,OAAO,CAAC,CAAC,aAAa,KAAK,UAAU;QACrC,OAAO,CAAC,CAAC,SAAS,KAAK,UAAU;QACjC,OAAO,CAAC,CAAC,YAAY,KAAK,UAAU;QACpC,OAAO,CAAC,CAAC,YAAY,KAAK,UAAU,CACrC,CAAC;AACJ,CAAC;AA+DD,cAAc;AAEd,MAAM,OAAO,WAAY,SAAQ,KAAK;IAG3B;IACA;IAHT,YACE,OAAe,EACR,UAAmB,EACnB,QAAkB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAU;QAGzB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAGvC;IAFT,YACE,OAAe,EACR,MAAgB;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,WAAM,GAAN,MAAM,CAAU;QAGvB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGzC;IAFT,YACE,OAAe,EACR,kBAAuC;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,uBAAkB,GAAlB,kBAAkB,CAAqB;QAG9C,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/utils/api.d.ts

@@ -0,0 +1,137 @@
+import { N8nWorkflow, N8nWorkflowResponse, N8nCredential, N8nCredentialSchema, N8nExecution, N8nTag } from '../types/index';
+/**
+ * n8n REST API client
+ * Full coverage of n8n Cloud API for workflow, credential, execution, and tag management
+ * @see https://docs.n8n.io/api/
+ */
+export declare class N8nApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(host: string, apiKey: string);
+    /**
+     * Create a new workflow
+     * @see POST /workflows
+     */
+    createWorkflow(workflow: N8nWorkflow): Promise<N8nWorkflowResponse>;
+    /**
+     * List all workflows
+     * @see GET /workflows
+     */
+    listWorkflows(params?: {
+        active?: boolean;
+        tags?: string[];
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        data: N8nWorkflowResponse[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Get a specific workflow by ID
+     * @see GET /workflows/{id}
+     */
+    getWorkflow(id: string): Promise<N8nWorkflowResponse>;
+    /**
+     * Update a workflow
+     * @see PUT /workflows/{id}
+     */
+    updateWorkflow(id: string, workflow: Partial<N8nWorkflow>): Promise<N8nWorkflowResponse>;
+    /**
+     * Delete a workflow
+     * @see DELETE /workflows/{id}
+     */
+    deleteWorkflow(id: string): Promise<void>;
+    /**
+     * Activate a workflow
+     * @see POST /workflows/{id}/activate
+     */
+    activateWorkflow(id: string): Promise<N8nWorkflowResponse>;
+    /**
+     * Deactivate a workflow
+     * @see POST /workflows/{id}/deactivate
+     */
+    deactivateWorkflow(id: string): Promise<N8nWorkflowResponse>;
+    /**
+     * Manually execute a workflow
+     * @see POST /workflows/{id}/execute
+     */
+    executeWorkflow(id: string): Promise<N8nExecution>;
+    /**
+     * Update workflow tags
+     * @see PUT /workflows/{id}/tags
+     */
+    updateWorkflowTags(id: string, tagIds: string[]): Promise<N8nWorkflowResponse>;
+    /**
+     * Create a credential
+     * @see POST /credentials
+     */
+    createCredential(credential: {
+        name: string;
+        type: string;
+        data: Record<string, unknown>;
+    }): Promise<N8nCredential>;
+    /**
+     * List credentials (filtered by type if provided)
+     * @see GET /credentials
+     */
+    listCredentials(params?: {
+        type?: string;
+    }): Promise<{
+        data: N8nCredential[];
+    }>;
+    /**
+     * Get credential schema for a specific type
+     * @see GET /credentials/schema/{type}
+     */
+    getCredentialSchema(type: string): Promise<N8nCredentialSchema>;
+    /**
+     * Delete a credential
+     * @see DELETE /credentials/{id}
+     */
+    deleteCredential(id: string): Promise<void>;
+    /**
+     * List workflow executions
+     * @see GET /executions
+     */
+    listExecutions(params?: {
+        workflowId?: string;
+        status?: 'success' | 'error' | 'running' | 'waiting';
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        data: N8nExecution[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Get execution details
+     * @see GET /executions/{id}
+     */
+    getExecution(id: string): Promise<N8nExecution>;
+    /**
+     * Delete an execution
+     * @see DELETE /executions/{id}
+     */
+    deleteExecution(id: string): Promise<void>;
+    /**
+     * List all tags
+     * @see GET /tags
+     */
+    listTags(): Promise<{
+        data: N8nTag[];
+    }>;
+    /**
+     * Create a tag
+     * @see POST /tags
+     */
+    createTag(name: string): Promise<N8nTag>;
+    /**
+     * Get or create a tag by name (helper method)
+     * Used for per-user workflow organization
+     */
+    getOrCreateTag(name: string): Promise<N8nTag>;
+    /**
+     * Generic request handler with error handling
+     */
+    private request;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/utils/api.d.ts.map

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