@runflow-ai/sdk 1.0.5 → 1.0.7

package/dist/connectors/connector-creator.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare function createConnectorTool(connector: string, resource: string, action: string, parameters: ConnectorParameters, options?: ConnectorToolOptions): import("..").RunflowTool;
+export type ConnectorParameters = Record<string, ConnectorParameter>;
+export type ConnectorParameter = 'string' | 'string?' | 'number' | 'number?' | 'boolean' | 'boolean?' | 'email' | 'email?' | 'url' | 'url?' | 'date' | 'date?' | {
+    enum: string[];
+} | {
+    array: ConnectorParameter;
+};
+export interface ConnectorToolOptions {
+    id?: string;
+    description?: string;
+    outputSchema?: z.ZodSchema;
+}
+export declare const hubspot: {
+    createContact: () => import("..").RunflowTool;
+    getContact: () => import("..").RunflowTool;
+    createTicket: () => import("..").RunflowTool;
+};
+export declare const twilio: {
+    sendWhatsApp: () => import("..").RunflowTool;
+    sendSMS: () => import("..").RunflowTool;
+};
+export declare const email: {
+    send: () => import("..").RunflowTool;
+};
+export declare const slack: {
+    sendMessage: () => import("..").RunflowTool;
+};
+//# sourceMappingURL=connector-creator.d.ts.map

package/dist/connectors/connector-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-creator.d.ts","sourceRoot":"","sources":["../../src/connectors/connector-creator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,mBAAmB,EAC/B,OAAO,CAAC,EAAE,oBAAoB,4BAc/B;AAMD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAErE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,GACP,QAAQ,GACR,KAAK,GACL,MAAM,GACN,MAAM,GACN,OAAO,GACP;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAClB;IAAE,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAElC,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;CAC5B;AAmED,eAAO,MAAM,OAAO;;;;CAmBnB,CAAC;AAEF,eAAO,MAAM,MAAM;;;CAWlB,CAAC;AAEF,eAAO,MAAM,KAAK;;CASjB,CAAC;AAEF,eAAO,MAAM,KAAK;;CAOjB,CAAC"}

package/dist/connectors/connector-creator.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slack = exports.email = exports.twilio = exports.hubspot = void 0;
+exports.createConnectorTool = createConnectorTool;
+const zod_1 = require("zod");
+const tool_creator_1 = require("../tools/tool-creator");
+// ============================================================================
+// DYNAMIC CONNECTOR TOOL CREATOR
+// ============================================================================
+function createConnectorTool(connector, resource, action, parameters, options) {
+    const toolId = options?.id || `${connector}-${resource}-${action}`;
+    const description = options?.description || `${action} ${resource} in ${connector}`;
+    return (0, tool_creator_1.createTool)({
+        id: toolId,
+        description,
+        inputSchema: parametersToZodSchema(parameters),
+        outputSchema: options?.outputSchema,
+        execute: async ({ context, runflow }) => {
+            return runflow.connector(connector, resource, action, context);
+        },
+    });
+}
+// ============================================================================
+// PARAMETER TO ZOD CONVERSION
+// ============================================================================
+function parametersToZodSchema(parameters) {
+    const shape = {};
+    for (const [key, param] of Object.entries(parameters)) {
+        shape[key] = parameterToZodField(param);
+    }
+    return zod_1.z.object(shape);
+}
+function parameterToZodField(param) {
+    if (typeof param === 'string') {
+        const isOptional = param.endsWith('?');
+        const baseType = isOptional ? param.slice(0, -1) : param;
+        let schema;
+        switch (baseType) {
+            case 'string':
+                schema = zod_1.z.string();
+                break;
+            case 'number':
+                schema = zod_1.z.number();
+                break;
+            case 'boolean':
+                schema = zod_1.z.boolean();
+                break;
+            case 'email':
+                schema = zod_1.z.string().email();
+                break;
+            case 'url':
+                schema = zod_1.z.string().url();
+                break;
+            case 'date':
+                schema = zod_1.z.string().datetime();
+                break;
+            default:
+                schema = zod_1.z.string();
+        }
+        return isOptional ? schema.optional() : schema;
+    }
+    if (typeof param === 'object') {
+        if ('enum' in param) {
+            return zod_1.z.enum(param.enum);
+        }
+        if ('array' in param) {
+            return zod_1.z.array(parameterToZodField(param.array));
+        }
+    }
+    return zod_1.z.string();
+}
+// ============================================================================
+// BUILT-IN CONNECTOR SHORTCUTS (OPTIONAL)
+// ============================================================================
+// Clientes podem usar shortcuts ou criar seus próprios
+exports.hubspot = {
+    createContact: () => createConnectorTool('hubspot', 'contacts', 'create', {
+        email: 'email',
+        firstName: 'string?',
+        lastName: 'string?',
+        company: 'string?',
+        phone: 'string?',
+    }),
+    getContact: () => createConnectorTool('hubspot', 'contacts', 'get', {
+        email: 'email',
+    }),
+    createTicket: () => createConnectorTool('hubspot', 'tickets', 'create', {
+        subject: 'string',
+        content: 'string',
+        priority: { enum: ['low', 'medium', 'high'] },
+        contactEmail: 'email?',
+    }),
+};
+exports.twilio = {
+    sendWhatsApp: () => createConnectorTool('twilio', 'messages', 'send-whatsapp', {
+        to: 'string',
+        message: 'string',
+        mediaUrl: 'url?',
+    }),
+    sendSMS: () => createConnectorTool('twilio', 'messages', 'send-sms', {
+        to: 'string',
+        message: 'string',
+    }),
+};
+exports.email = {
+    send: () => createConnectorTool('email', 'messages', 'send', {
+        to: 'email',
+        subject: 'string',
+        body: 'string',
+        html: 'boolean?',
+        cc: { array: 'email' },
+        bcc: { array: 'email' },
+    }),
+};
+exports.slack = {
+    sendMessage: () => createConnectorTool('slack', 'messages', 'send', {
+        channel: 'string',
+        message: 'string',
+        username: 'string?',
+        iconEmoji: 'string?',
+    }),
+};
+//# sourceMappingURL=connector-creator.js.map

package/dist/connectors/connector-creator.js.map

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

package/dist/connectors/index.d.ts

@@ -0,0 +1,3 @@
+export { createConnectorTool, hubspot, twilio, email, slack, } from './connector-creator';
+export type { ConnectorParameters, ConnectorParameter, ConnectorToolOptions } from './connector-creator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,OAAO,EACP,MAAM,EACN,KAAK,EACL,KAAK,GACN,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC"}

package/dist/connectors/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slack = exports.email = exports.twilio = exports.hubspot = exports.createConnectorTool = void 0;
+// Connector exports
+var connector_creator_1 = require("./connector-creator");
+Object.defineProperty(exports, "createConnectorTool", { enumerable: true, get: function () { return connector_creator_1.createConnectorTool; } });
+Object.defineProperty(exports, "hubspot", { enumerable: true, get: function () { return connector_creator_1.hubspot; } });
+Object.defineProperty(exports, "twilio", { enumerable: true, get: function () { return connector_creator_1.twilio; } });
+Object.defineProperty(exports, "email", { enumerable: true, get: function () { return connector_creator_1.email; } });
+Object.defineProperty(exports, "slack", { enumerable: true, get: function () { return connector_creator_1.slack; } });
+//# sourceMappingURL=index.js.map

package/dist/connectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":";;;AAAA,oBAAoB;AACpB,yDAM6B;AAL3B,wHAAA,mBAAmB,OAAA;AACnB,4GAAA,OAAO,OAAA;AACP,2GAAA,MAAM,OAAA;AACN,0GAAA,KAAK,OAAA;AACL,0GAAA,KAAK,OAAA"}

package/dist/core/agent.d.ts

@@ -0,0 +1,42 @@
+import { AgentConfig, AgentInput, AgentOutput, RunflowAPIClient, ExecutionContext } from '../types';
+export declare class Agent {
+    private config;
+    private apiClient?;
+    private traceCollector?;
+    constructor(config: AgentConfig);
+    _setAPIClient(apiClient: RunflowAPIClient): void;
+    generate(input: string | Array<{
+        role: string;
+        content: string;
+    }>): Promise<{
+        text: string;
+    }>;
+    generateStream(prompt: string): Promise<AsyncIterable<{
+        text: string;
+        done: boolean;
+    }>>;
+    generateWithTools(input: string | Array<{
+        role: string;
+        content: string;
+    }>): Promise<{
+        text: string;
+    }>;
+    process(input: AgentInput, context?: ExecutionContext): Promise<AgentOutput>;
+    private processMultiAgent;
+    private createSupervisor;
+    private performRAG;
+    get name(): string;
+    get instructions(): string;
+    get model(): import("../types").ModelProvider;
+    get tools(): Record<string, import("../types").RunflowTool>;
+    get isMultiAgent(): boolean;
+    private getUsedTools;
+    private loadMemory;
+    private saveToMemory;
+    private processStreamChunks;
+    processStream(input: AgentInput, context?: ExecutionContext): Promise<AsyncIterable<{
+        text: string;
+        done: boolean;
+    }>>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/core/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAQpG,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAC,CAAM;gBAEjB,MAAM,EAAE,WAAW;IAe/B,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAW1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IA2C3F,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAyBvF,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAkCpG,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;YA4MpE,iBAAiB;IAiC/B,OAAO,CAAC,gBAAgB;YASV,UAAU;IA0BxB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,KAAK,qCAER;IAED,IAAI,KAAK,mDAER;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAGD,OAAO,CAAC,YAAY;YAUN,UAAU;YAoDV,YAAY;YAqCX,mBAAmB;IAc5B,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAsE5H"}