@runflow-ai/sdk 1.0.67 → 1.0.68

package/README.md

@@ -13,7 +13,7 @@ Runflow SDK is a comprehensive, type-safe framework for building AI agents, comp
 
 - 🤖 **Intelligent Agents** - Create agents with LLM, tools, memory, and RAG capabilities
 - 🔧 **Type-Safe Tools** - Build custom tools with Zod schema validation
-- 🔌 **Built-in Connectors** - HubSpot, Twilio, Email, Slack integrations out of the box
+- 🔌 **Dynamic Connectors** - Connect to any API with runtime schema loading
 - 🌊 **Workflows** - Orchestrate complex multi-step processes with conditional logic
 - 🧠 **Memory Management** - Persistent conversation history with automatic summarization
 - 📚 **Agentic RAG** - LLM-driven semantic search in vector knowledge bases
@@ -768,8 +768,7 @@ const createTicketTool = createTool({
     // Use connector
     const ticket = await runflow.connector(
       'hubspot',
-      'tickets',
-      'create',
+      'create-ticket',  // resource slug
       {
         subject: context.subject,
         content: context.description,
@@ -2691,8 +2690,7 @@ Complete, production-ready examples showcasing the platform's potential.
 A sophisticated support agent that searches documentation, remembers context, and creates tickets in HubSpot.
 
 ```typescript
-import { Agent, openai, createTool } from '@runflow-ai/sdk';
-import { hubspotConnector } from '@runflow-ai/sdk/connectors';
+import { Agent, openai, createTool, createConnectorTool } from '@runflow-ai/sdk';
 import { z } from 'zod';
 
 // Create a support agent with memory and RAG
@@ -2714,7 +2712,7 @@ const supportAgent = new Agent({
   },
 
   // Search in documentation
-  knowledge: {
+  rag: {
     vectorStore: 'support-docs',
     k: 5,
     threshold: 0.7,
@@ -2722,7 +2720,11 @@ const supportAgent = new Agent({
 
   // Available tools
   tools: {
-    createTicket: hubspotConnector.tickets.create,
+    createTicket: createConnectorTool({
+      connector: 'hubspot',
+      resource: 'create-ticket',
+      description: 'Create a support ticket in HubSpot',
+    }),
     searchOrders: createTool({
       id: 'search-orders',
       description: 'Search customer orders',
@@ -2730,7 +2732,7 @@ const supportAgent = new Agent({
         customerId: z.string(),
       }),
       execute: async ({ context }) => {
-        const orders = await fetchOrders(context.input.customerId);
+        const orders = await fetchOrders(context.customerId);
         return { orders };
       },
     }),
@@ -2754,7 +2756,6 @@ Automate lead qualification, deal creation, and team notifications using workflo
 
 ```typescript
 import { createWorkflow, Agent, openai } from '@runflow-ai/sdk';
-import { hubspotConnector, slackConnector } from '@runflow-ai/sdk/connectors';
 import { z } from 'zod';
 
 // Qualification agent
@@ -2896,8 +2897,7 @@ console.log('Workflow completed:', result);
 Automate debt collection with personalized WhatsApp messages using context-aware AI.
 
 ```typescript
-import { Agent, openai, Runflow } from '@runflow-ai/sdk';
-import { twilioConnector } from '@runflow-ai/sdk/connectors';
+import { Agent, openai, Runflow, createTool, createConnectorTool } from '@runflow-ai/sdk';
 import { z } from 'zod';
 
 // Collections agent with empathy and context
@@ -2916,7 +2916,11 @@ const collectionsAgent = new Agent({
   },
 
   tools: {
-    sendWhatsApp: twilioConnector.whatsapp.send,
+    sendWhatsApp: createConnectorTool({
+      connector: 'twilio',
+      resource: 'send-whatsapp',
+      description: 'Send WhatsApp message via Twilio',
+    }),
     getPaymentHistory: createTool({
       id: 'get-payment-history',
       description: 'Get customer payment history',
@@ -2924,7 +2928,7 @@ const collectionsAgent = new Agent({
         customerId: z.string(),
       }),
       execute: async ({ context }) => {
-        const history = await fetchPaymentHistory(context.input.customerId);
+        const history = await fetchPaymentHistory(context.customerId);
         return { history };
       },
     }),
@@ -2966,8 +2970,8 @@ for (const invoice of overdueInvoices) {
 Guide new users through onboarding with an interactive, multi-turn conversation.
 
 ```typescript
-import { Agent, openai } from '@runflow-ai/sdk';
-import { emailConnector, slackConnector } from '@runflow-ai/sdk/connectors';
+import { Agent, openai, createTool, createConnectorTool } from '@runflow-ai/sdk';
+import { z } from 'zod';
 
 const onboardingAgent = new Agent({
   name: 'Onboarding Assistant',
@@ -2986,14 +2990,22 @@ const onboardingAgent = new Agent({
     summarizePrompt: 'Summarize onboarding progress, completed steps, and next actions',
   },
 
-  knowledge: {
+  rag: {
     vectorStore: 'onboarding-docs',
     k: 3,
   },
 
   tools: {
-    sendEmail: emailConnector.messages.send,
-    notifyTeam: slackConnector.messages.send,
+    sendEmail: createConnectorTool({
+      connector: 'email',
+      resource: 'send-message',
+      description: 'Send email to user',
+    }),
+    notifyTeam: createConnectorTool({
+      connector: 'slack',
+      resource: 'send-message',
+      description: 'Notify team on Slack',
+    }),
     markStepComplete: createTool({
       id: 'mark-step-complete',
       description: 'Mark an onboarding step as complete',
@@ -3003,8 +3015,8 @@ const onboardingAgent = new Agent({
       }),
       execute: async ({ context }) => {
         await updateOnboardingProgress(
-          context.input.userId,
-          context.input.stepName
+          context.userId,
+          context.stepName
         );
         return { success: true };
       },
@@ -3038,7 +3050,6 @@ Collect customer feedback, analyze sentiment, and create actionable tickets.
 
 ```typescript
 import { createWorkflow, Agent, openai } from '@runflow-ai/sdk';
-import { hubspotConnector, slackConnector } from '@runflow-ai/sdk/connectors';
 import { z } from 'zod';
 
 // Sentiment analyzer
@@ -3157,7 +3168,7 @@ const supportAgent = new Agent({
   name: 'Technical Support',
   instructions: 'You are a technical support expert. Help with technical issues.',
   model: openai('gpt-4o'),
-  knowledge: { vectorStore: 'tech-docs', k: 5 },
+  rag: { vectorStore: 'tech-docs', k: 5 },
 });
 
 const billingAgent = new Agent({
@@ -3381,7 +3392,7 @@ import type { MemoryProvider, KnowledgeProvider, LLMProvider } from '@runflow-ai
 ```typescript
 interface AgentInput {
   message: string;
-  companyId: string;
+  companyId?: string;
   userId?: string;
   sessionId?: string;
   executionId?: string;
@@ -3389,6 +3400,7 @@ interface AgentInput {
   entityType?: string;
   entityValue?: string;
   channel?: string;
+  file?: MediaFile;
   messages?: Message[];
   metadata?: Record<string, any>;
 }
@@ -3400,16 +3412,18 @@ interface AgentOutput {
 
 interface AgentConfig {
   name: string;
-  instructions: string;
+  instructions: string | PromptRef;  // Accepts string or loadPrompt() reference
   model: ModelProvider;
   modelConfig?: ModelConfig;
   tools?: Record<string, RunflowTool>;
   maxToolIterations?: number;
   rag?: RAGConfig;
   memory?: MemoryConfig;
+  media?: MediaConfig;
   streaming?: StreamingConfig;
   agents?: Record<string, AgentConfig>;
   debug?: boolean | DebugConfig;
+  observability?: ObservabilityMode | ObservabilityConfig;
 }
 
 interface ModelConfig {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runflow-ai/sdk",
-  "version": "1.0.67",
+  "version": "1.0.68",
   "description": "Runflow SDK - Multi-agent AI framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",