@falai/agent 2.2.0 → 2.2.2

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 (81) hide show
  1. package/dist/cjs/core/BranchEvaluator.d.ts +2 -2
  2. package/dist/cjs/core/BranchEvaluator.js +2 -2
  3. package/dist/cjs/core/BranchEvaluator.js.map +1 -1
  4. package/dist/cjs/core/Flow.d.ts +2 -1
  5. package/dist/cjs/core/Flow.d.ts.map +1 -1
  6. package/dist/cjs/core/Flow.js +2 -1
  7. package/dist/cjs/core/Flow.js.map +1 -1
  8. package/dist/cjs/core/FlowRouter.js +2 -2
  9. package/dist/cjs/core/FlowRouter.js.map +1 -1
  10. package/dist/cjs/core/PromptComposer.d.ts.map +1 -1
  11. package/dist/cjs/core/PromptComposer.js +8 -20
  12. package/dist/cjs/core/PromptComposer.js.map +1 -1
  13. package/dist/cjs/core/Step.d.ts +2 -1
  14. package/dist/cjs/core/Step.d.ts.map +1 -1
  15. package/dist/cjs/core/Step.js +2 -1
  16. package/dist/cjs/core/Step.js.map +1 -1
  17. package/dist/cjs/index.d.ts +2 -0
  18. package/dist/cjs/index.d.ts.map +1 -1
  19. package/dist/cjs/index.js +4 -2
  20. package/dist/cjs/index.js.map +1 -1
  21. package/dist/cjs/providers/DeepSeekProvider.d.ts +61 -0
  22. package/dist/cjs/providers/DeepSeekProvider.d.ts.map +1 -0
  23. package/dist/cjs/providers/DeepSeekProvider.js +450 -0
  24. package/dist/cjs/providers/DeepSeekProvider.js.map +1 -0
  25. package/dist/cjs/providers/index.d.ts +2 -0
  26. package/dist/cjs/providers/index.d.ts.map +1 -1
  27. package/dist/cjs/providers/index.js +3 -1
  28. package/dist/cjs/providers/index.js.map +1 -1
  29. package/dist/cjs/types/agent.d.ts +5 -3
  30. package/dist/cjs/types/agent.d.ts.map +1 -1
  31. package/dist/cjs/types/flow.d.ts +4 -4
  32. package/dist/core/BranchEvaluator.d.ts +2 -2
  33. package/dist/core/BranchEvaluator.js +2 -2
  34. package/dist/core/BranchEvaluator.js.map +1 -1
  35. package/dist/core/Flow.d.ts +2 -1
  36. package/dist/core/Flow.d.ts.map +1 -1
  37. package/dist/core/Flow.js +2 -1
  38. package/dist/core/Flow.js.map +1 -1
  39. package/dist/core/FlowRouter.js +2 -2
  40. package/dist/core/FlowRouter.js.map +1 -1
  41. package/dist/core/PromptComposer.d.ts.map +1 -1
  42. package/dist/core/PromptComposer.js +8 -20
  43. package/dist/core/PromptComposer.js.map +1 -1
  44. package/dist/core/Step.d.ts +2 -1
  45. package/dist/core/Step.d.ts.map +1 -1
  46. package/dist/core/Step.js +2 -1
  47. package/dist/core/Step.js.map +1 -1
  48. package/dist/index.d.ts +2 -0
  49. package/dist/index.d.ts.map +1 -1
  50. package/dist/index.js +1 -0
  51. package/dist/index.js.map +1 -1
  52. package/dist/providers/DeepSeekProvider.d.ts +61 -0
  53. package/dist/providers/DeepSeekProvider.d.ts.map +1 -0
  54. package/dist/providers/DeepSeekProvider.js +443 -0
  55. package/dist/providers/DeepSeekProvider.js.map +1 -0
  56. package/dist/providers/index.d.ts +2 -0
  57. package/dist/providers/index.d.ts.map +1 -1
  58. package/dist/providers/index.js +1 -0
  59. package/dist/providers/index.js.map +1 -1
  60. package/dist/types/agent.d.ts +5 -3
  61. package/dist/types/agent.d.ts.map +1 -1
  62. package/dist/types/flow.d.ts +4 -4
  63. package/docs/guides/branching.md +3 -1
  64. package/docs/guides/conditions.md +9 -8
  65. package/docs/guides/instructions.md +7 -7
  66. package/docs/reference/branches.md +2 -2
  67. package/docs/reference/flow.md +1 -1
  68. package/docs/reference/instruction.md +7 -5
  69. package/docs/reference/providers.md +48 -2
  70. package/docs/reference/step.md +2 -2
  71. package/package.json +11 -11
  72. package/src/core/BranchEvaluator.ts +4 -4
  73. package/src/core/Flow.ts +2 -1
  74. package/src/core/FlowRouter.ts +2 -2
  75. package/src/core/PromptComposer.ts +9 -20
  76. package/src/core/Step.ts +2 -1
  77. package/src/index.ts +2 -0
  78. package/src/providers/DeepSeekProvider.ts +666 -0
  79. package/src/providers/index.ts +3 -0
  80. package/src/types/agent.ts +5 -3
  81. package/src/types/flow.ts +4 -4
package/src/types/flow.ts CHANGED
@@ -25,7 +25,7 @@ export type ConditionIf<TContext = unknown, TData = unknown> =
25
25
  | ConditionPredicate<TContext, TData>[];
26
26
 
27
27
  /**
28
- * The `when` field shape: a single AI-evaluated string or array of strings (AND semantics).
28
+ * The `when` field shape: a single AI-evaluated string or array of strings (OR semantics).
29
29
  * Functions are NOT allowed on `when` — they belong on `if` only.
30
30
  */
31
31
  export type ConditionWhen = string | string[];
@@ -196,7 +196,7 @@ export type BranchPredicate<TContext = unknown, TData = unknown> = (
196
196
  */
197
197
  export interface BranchEntry<TContext = unknown, TData = unknown> {
198
198
  /**
199
- * AI-evaluated condition. String or array of strings (AND semantics).
199
+ * AI-evaluated condition. String or array of strings (OR semantics).
200
200
  * Costs LLM tokens. Reuses the same machinery as `step.when`.
201
201
  * Only evaluated if `if` passes (or is absent) — code-first short-circuit.
202
202
  */
@@ -324,7 +324,7 @@ export interface FlowOptions<TContext = unknown, TData = unknown> {
324
324
  description?: string;
325
325
 
326
326
  /**
327
- * AI-evaluated activation condition(s). String or array of strings (AND semantics).
327
+ * AI-evaluated activation condition(s). String or array of strings (OR semantics).
328
328
  * Costs LLM tokens. Functions are NOT allowed here — use `if` for code predicates.
329
329
  */
330
330
  when?: ConditionWhen;
@@ -498,7 +498,7 @@ export interface StepOptions<TContext = unknown, TData = unknown> {
498
498
  */
499
499
  requires?: (keyof TData)[];
500
500
  /**
501
- * AI-evaluated activation condition(s). String or array of strings (AND semantics).
501
+ * AI-evaluated activation condition(s). String or array of strings (OR semantics).
502
502
  * Costs LLM tokens. Functions are NOT allowed here — use `if` for code predicates.
503
503
  */
504
504
  when?: ConditionWhen;