@runflow-ai/sdk 1.0.17 → 1.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.md +14 -4
  2. package/dist/core/agent.d.ts +5 -30
  3. package/dist/core/agent.d.ts.map +1 -1
  4. package/dist/core/agent.js +259 -472
  5. package/dist/core/agent.js.map +1 -1
  6. package/dist/core/context.d.ts.map +1 -1
  7. package/dist/core/context.js +1 -11
  8. package/dist/core/context.js.map +1 -1
  9. package/dist/core/helpers/agent-context.d.ts +23 -0
  10. package/dist/core/helpers/agent-context.d.ts.map +1 -0
  11. package/dist/core/helpers/agent-context.js +90 -0
  12. package/dist/core/helpers/agent-context.js.map +1 -0
  13. package/dist/core/helpers/agent-memory.d.ts +17 -0
  14. package/dist/core/helpers/agent-memory.d.ts.map +1 -0
  15. package/dist/core/helpers/agent-memory.js +194 -0
  16. package/dist/core/helpers/agent-memory.js.map +1 -0
  17. package/dist/core/helpers/agent-rag.d.ts +22 -0
  18. package/dist/core/helpers/agent-rag.d.ts.map +1 -0
  19. package/dist/core/helpers/agent-rag.js +216 -0
  20. package/dist/core/helpers/agent-rag.js.map +1 -0
  21. package/dist/core/helpers/agent-utils.d.ts +13 -0
  22. package/dist/core/helpers/agent-utils.d.ts.map +1 -0
  23. package/dist/core/helpers/agent-utils.js +35 -0
  24. package/dist/core/helpers/agent-utils.js.map +1 -0
  25. package/dist/core/logger.d.ts +22 -0
  26. package/dist/core/logger.d.ts.map +1 -0
  27. package/dist/core/logger.js +91 -0
  28. package/dist/core/logger.js.map +1 -0
  29. package/dist/core/performance-logger.d.ts +45 -0
  30. package/dist/core/performance-logger.d.ts.map +1 -0
  31. package/dist/core/performance-logger.js +140 -0
  32. package/dist/core/performance-logger.js.map +1 -0
  33. package/dist/observability/trace-collector.d.ts.map +1 -1
  34. package/dist/observability/trace-collector.js +0 -16
  35. package/dist/observability/trace-collector.js.map +1 -1
  36. package/dist/types/all-types.d.ts +11 -3
  37. package/dist/types/all-types.d.ts.map +1 -1
  38. package/package.json +3 -1
package/README.md CHANGED
@@ -788,22 +788,32 @@ const results = await knowledge.multiQuery(
788
788
  );
789
789
  ```
790
790
 
791
- #### Knowledge no Agent (Auto-RAG)
791
+ #### Knowledge no Agent (Agentic RAG)
792
792
 
793
793
  ```typescript
794
794
  const agent = new Agent({
795
795
  name: 'Support Agent',
796
- instructions: 'Answer using the knowledge base.',
796
+ instructions: 'You are a helpful support agent.',
797
797
  model: openai('gpt-4o'),
798
798
  rag: {
799
799
  vectorStore: 'support-docs',
800
- autoSearch: true, // Busca automática
801
800
  k: 5,
802
801
  threshold: 0.7,
802
+
803
+ // Prompt customizável - orienta quando buscar
804
+ searchPrompt: `Use searchKnowledge tool when user asks about:
805
+ - Technical problems
806
+ - Process questions
807
+ - Specific information
808
+
809
+ Don't use for greetings or casual chat.`,
810
+
811
+ toolDescription: 'Search in support documentation for solutions',
803
812
  },
804
813
  });
805
814
 
806
- // Agent automaticamente busca contexto relevante
815
+ // Agent tem tool 'searchKnowledge' gerada automaticamente
816
+ // LLM decide quando buscar (não busca sempre - mais eficiente!)
807
817
  const result = await agent.process({
808
818
  message: 'How do I reset my password?',
809
819
  companyId: 'company_123',
@@ -3,7 +3,7 @@ export declare class Agent {
3
3
  private config;
4
4
  private apiClient?;
5
5
  private traceCollector?;
6
- private debugConfig;
6
+ private logger;
7
7
  constructor(config: AgentConfig);
8
8
  _setAPIClient(apiClient: RunflowAPIClient): void;
9
9
  generate(input: string | Array<{
@@ -25,40 +25,15 @@ export declare class Agent {
25
25
  process(input: AgentInput, context?: ExecutionContext): Promise<AgentOutput>;
26
26
  private processMultiAgent;
27
27
  private createSupervisor;
28
- private performRAG;
28
+ /**
29
+ * Resolve o nível de log baseado na configuração de debug
30
+ */
31
+ private resolveLogLevel;
29
32
  get name(): string;
30
33
  get instructions(): string;
31
34
  get model(): import("../types").ModelProvider;
32
35
  get tools(): Record<string, import("../types").RunflowTool>;
33
36
  get isMultiAgent(): boolean;
34
- private getUsedTools;
35
- /**
36
- * Resolver configuração de debug
37
- */
38
- private resolveDebugConfig;
39
- /**
40
- * Generate unique execution ID
41
- */
42
- private generateExecutionId;
43
- /**
44
- * Generate threadId based on input (fallback quando não fornecido)
45
- */
46
- private generateThreadId;
47
- /**
48
- * Infer entityType from input metadata
49
- */
50
- private inferEntityType;
51
- /**
52
- * Infer entityValue from input metadata
53
- */
54
- private inferEntityValue;
55
- /**
56
- * Infer userId from input metadata
57
- */
58
- private inferUserId;
59
- private loadMemory;
60
- private saveToMemory;
61
- private processStreamChunks;
62
37
  processStream(input: AgentInput, context?: ExecutionContext): Promise<AsyncIterable<{
63
38
  text: string;
64
39
  done: boolean;
@@ -1 +1 @@
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;AASpG,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAC,CAAM;IAC7B,OAAO,CAAC,WAAW,CAAM;gBAEb,MAAM,EAAE,WAAW;IAoB/B,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAa1C,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,GAAG,CAAA;KAAC,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAuOjG,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;YA4QpE,iBAAiB;IAiC/B,OAAO,CAAC,gBAAgB;YASV,UAAU;IAkFxB,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;IASpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoC1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,WAAW;YAYL,UAAU;YAsGV,YAAY;YAgFX,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;CAyG5H"}
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;AAsBpG,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAC,CAAM;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,WAAW;IA4C/B,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAa1C,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;IAoD3F,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAgCvF,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAC,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAuRjG,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;YA+TpE,iBAAiB;IAiD/B,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB,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;IAGK,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;CA6H5H"}