@falai/agent 2.1.0 → 2.2.0

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 (138) hide show
  1. package/LICENSE +21 -0
  2. package/dist/adapters/SQLiteAdapter.d.ts +3 -3
  3. package/dist/adapters/SQLiteAdapter.d.ts.map +1 -1
  4. package/dist/adapters/index.d.ts +1 -1
  5. package/dist/adapters/index.d.ts.map +1 -1
  6. package/dist/cjs/adapters/SQLiteAdapter.d.ts +3 -3
  7. package/dist/cjs/adapters/SQLiteAdapter.d.ts.map +1 -1
  8. package/dist/cjs/adapters/index.d.ts +1 -1
  9. package/dist/cjs/adapters/index.d.ts.map +1 -1
  10. package/dist/cjs/core/Agent.js +2 -2
  11. package/dist/cjs/core/Agent.js.map +1 -1
  12. package/dist/cjs/core/Flow.d.ts +1 -6
  13. package/dist/cjs/core/Flow.d.ts.map +1 -1
  14. package/dist/cjs/core/Flow.js +0 -7
  15. package/dist/cjs/core/Flow.js.map +1 -1
  16. package/dist/cjs/core/PromptSectionCache.d.ts +2 -11
  17. package/dist/cjs/core/PromptSectionCache.d.ts.map +1 -1
  18. package/dist/cjs/core/PromptSectionCache.js.map +1 -1
  19. package/dist/cjs/core/ResponseModal.d.ts +5 -5
  20. package/dist/cjs/core/ResponseModal.d.ts.map +1 -1
  21. package/dist/cjs/core/ResponseModal.js +38 -182
  22. package/dist/cjs/core/ResponseModal.js.map +1 -1
  23. package/dist/cjs/core/ToolManager.d.ts +1 -33
  24. package/dist/cjs/core/ToolManager.d.ts.map +1 -1
  25. package/dist/cjs/core/ToolManager.js +2 -189
  26. package/dist/cjs/core/ToolManager.js.map +1 -1
  27. package/dist/cjs/index.d.ts +3 -3
  28. package/dist/cjs/index.d.ts.map +1 -1
  29. package/dist/cjs/index.js +2 -4
  30. package/dist/cjs/index.js.map +1 -1
  31. package/dist/cjs/types/agent.d.ts +1 -8
  32. package/dist/cjs/types/agent.d.ts.map +1 -1
  33. package/dist/cjs/types/agent.js +0 -9
  34. package/dist/cjs/types/agent.js.map +1 -1
  35. package/dist/cjs/types/history.d.ts +0 -2
  36. package/dist/cjs/types/history.d.ts.map +1 -1
  37. package/dist/cjs/types/history.js.map +1 -1
  38. package/dist/cjs/types/index.d.ts +1 -6
  39. package/dist/cjs/types/index.d.ts.map +1 -1
  40. package/dist/cjs/types/index.js +1 -20
  41. package/dist/cjs/types/index.js.map +1 -1
  42. package/dist/cjs/types/prompt-cache.d.ts +15 -0
  43. package/dist/cjs/types/prompt-cache.d.ts.map +1 -0
  44. package/dist/cjs/types/prompt-cache.js +6 -0
  45. package/dist/cjs/types/prompt-cache.js.map +1 -0
  46. package/dist/cjs/types/schema.d.ts +0 -7
  47. package/dist/cjs/types/schema.d.ts.map +1 -1
  48. package/dist/cjs/types/tool.d.ts.map +1 -1
  49. package/dist/cjs/utils/history.d.ts +0 -5
  50. package/dist/cjs/utils/history.d.ts.map +1 -1
  51. package/dist/cjs/utils/history.js +0 -8
  52. package/dist/cjs/utils/history.js.map +1 -1
  53. package/dist/cjs/utils/index.d.ts +2 -2
  54. package/dist/cjs/utils/index.d.ts.map +1 -1
  55. package/dist/cjs/utils/index.js +1 -4
  56. package/dist/cjs/utils/index.js.map +1 -1
  57. package/dist/cjs/utils/template.d.ts +0 -2
  58. package/dist/cjs/utils/template.d.ts.map +1 -1
  59. package/dist/cjs/utils/template.js +0 -2
  60. package/dist/cjs/utils/template.js.map +1 -1
  61. package/dist/core/Agent.js +2 -2
  62. package/dist/core/Agent.js.map +1 -1
  63. package/dist/core/Flow.d.ts +1 -6
  64. package/dist/core/Flow.d.ts.map +1 -1
  65. package/dist/core/Flow.js +0 -7
  66. package/dist/core/Flow.js.map +1 -1
  67. package/dist/core/PromptSectionCache.d.ts +2 -11
  68. package/dist/core/PromptSectionCache.d.ts.map +1 -1
  69. package/dist/core/PromptSectionCache.js.map +1 -1
  70. package/dist/core/ResponseModal.d.ts +5 -5
  71. package/dist/core/ResponseModal.d.ts.map +1 -1
  72. package/dist/core/ResponseModal.js +38 -182
  73. package/dist/core/ResponseModal.js.map +1 -1
  74. package/dist/core/ToolManager.d.ts +1 -33
  75. package/dist/core/ToolManager.d.ts.map +1 -1
  76. package/dist/core/ToolManager.js +2 -189
  77. package/dist/core/ToolManager.js.map +1 -1
  78. package/dist/index.d.ts +3 -3
  79. package/dist/index.d.ts.map +1 -1
  80. package/dist/index.js +2 -2
  81. package/dist/index.js.map +1 -1
  82. package/dist/types/agent.d.ts +1 -8
  83. package/dist/types/agent.d.ts.map +1 -1
  84. package/dist/types/agent.js +1 -8
  85. package/dist/types/agent.js.map +1 -1
  86. package/dist/types/history.d.ts +0 -2
  87. package/dist/types/history.d.ts.map +1 -1
  88. package/dist/types/history.js.map +1 -1
  89. package/dist/types/index.d.ts +1 -6
  90. package/dist/types/index.d.ts.map +1 -1
  91. package/dist/types/index.js +0 -4
  92. package/dist/types/index.js.map +1 -1
  93. package/dist/types/prompt-cache.d.ts +15 -0
  94. package/dist/types/prompt-cache.d.ts.map +1 -0
  95. package/dist/types/prompt-cache.js +5 -0
  96. package/dist/types/prompt-cache.js.map +1 -0
  97. package/dist/types/schema.d.ts +0 -7
  98. package/dist/types/schema.d.ts.map +1 -1
  99. package/dist/types/tool.d.ts.map +1 -1
  100. package/dist/utils/history.d.ts +0 -5
  101. package/dist/utils/history.d.ts.map +1 -1
  102. package/dist/utils/history.js +0 -7
  103. package/dist/utils/history.js.map +1 -1
  104. package/dist/utils/index.d.ts +2 -2
  105. package/dist/utils/index.d.ts.map +1 -1
  106. package/dist/utils/index.js +2 -2
  107. package/dist/utils/index.js.map +1 -1
  108. package/dist/utils/template.d.ts +0 -2
  109. package/dist/utils/template.d.ts.map +1 -1
  110. package/dist/utils/template.js +0 -2
  111. package/dist/utils/template.js.map +1 -1
  112. package/package.json +8 -17
  113. package/src/adapters/SQLiteAdapter.ts +3 -3
  114. package/src/adapters/index.ts +1 -1
  115. package/src/core/Agent.ts +3 -3
  116. package/src/core/Flow.ts +0 -9
  117. package/src/core/PromptSectionCache.ts +2 -13
  118. package/src/core/ResponseModal.ts +39 -197
  119. package/src/core/ToolManager.ts +2 -234
  120. package/src/index.ts +2 -3
  121. package/src/types/agent.ts +1 -9
  122. package/src/types/history.ts +0 -4
  123. package/src/types/index.ts +2 -9
  124. package/src/types/prompt-cache.ts +17 -0
  125. package/src/types/schema.ts +0 -8
  126. package/src/types/tool.ts +0 -2
  127. package/src/utils/history.ts +1 -7
  128. package/src/utils/index.ts +0 -3
  129. package/src/utils/template.ts +0 -2
  130. package/dist/cjs/types/routing.d.ts +0 -12
  131. package/dist/cjs/types/routing.d.ts.map +0 -1
  132. package/dist/cjs/types/routing.js +0 -3
  133. package/dist/cjs/types/routing.js.map +0 -1
  134. package/dist/types/routing.d.ts +0 -12
  135. package/dist/types/routing.d.ts.map +0 -1
  136. package/dist/types/routing.js +0 -2
  137. package/dist/types/routing.js.map +0 -1
  138. package/src/types/routing.ts +0 -13
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Prompt section cache configuration types.
3
+ */
4
+
5
+ /** Section type: static sections are cached, dynamic sections recompute every turn */
6
+ export type PromptSectionType = "static" | "dynamic";
7
+
8
+ /** Configuration for prompt section caching behavior */
9
+ export interface PromptCacheConfig {
10
+ /** Whether to enable section memoization (default: true) */
11
+ enabled?: boolean;
12
+ /** Keys of sections that should always recompute every turn, even if registered as static */
13
+ volatileKeys?: string[];
14
+ }
15
+
16
+ /** Compute function that produces a section's content */
17
+ export type SectionCompute = () => string | null | Promise<string | null>;
@@ -13,11 +13,3 @@ export interface StructuredSchema {
13
13
  // Allow provider-specific passthroughs without breaking types
14
14
  [key: string]: unknown;
15
15
  }
16
-
17
- /**
18
- * A small helper describing a named schema (for providers that require a name)
19
- */
20
- export interface NamedSchema {
21
- name?: string;
22
- schema: StructuredSchema;
23
- }
package/src/types/tool.ts CHANGED
@@ -159,8 +159,6 @@ export enum ToolScope {
159
159
 
160
160
 
161
161
 
162
- // --- EnhancedTool (deprecated internal alias — use Tool directly) ---
163
-
164
162
  /**
165
163
  * Result of input validation on a tool call
166
164
  */
@@ -258,13 +258,7 @@ export function eventsToHistory(events: Event[]): History {
258
258
  });
259
259
  }
260
260
 
261
- /**
262
- * Normalize a simplified history array to internal Event array
263
- * @deprecated Use historyToEvents instead
264
- */
265
- export function normalizeHistory(history: History): Event[] {
266
- return historyToEvents(history);
267
- }
261
+
268
262
 
269
263
  /**
270
264
  * Helper function to create a user message
@@ -29,8 +29,6 @@ export {
29
29
  export {
30
30
  render,
31
31
  renderMany,
32
- renderTemplate,
33
- renderTemplateObject,
34
32
  formatKnowledgeBase,
35
33
  createTemplateContext,
36
34
  } from "./template";
@@ -43,7 +41,6 @@ export { getLastMessageFromHistory } from "./event";
43
41
 
44
42
  // History utilities
45
43
  export {
46
- normalizeHistory,
47
44
  historyItemToEvent,
48
45
  historyToEvents,
49
46
  eventToHistoryItem,
@@ -59,7 +59,6 @@ export async function renderMany<TContext = unknown, TData = unknown>(
59
59
  }
60
60
 
61
61
  /**
62
- * @deprecated Use the asynchronous `render` function instead.
63
62
  * Renders template variables in a string using the provided context.
64
63
  * Supports {{variable}} and {{object.property}} syntax for property access.
65
64
  *
@@ -171,7 +170,6 @@ function valueToString(value: unknown): string {
171
170
  }
172
171
 
173
172
  /**
174
- * @deprecated This function does not support async template functions.
175
173
  * Renders template variables in an object recursively.
176
174
  * Handles nested objects and arrays.
177
175
  *
@@ -1,12 +0,0 @@
1
- import type { StructuredSchema } from "./schema";
2
- export interface RoutingDecision {
3
- context: string;
4
- flows: Record<string, number>;
5
- responseDirectives?: string[];
6
- extractions?: unknown;
7
- contextUpdate?: Record<string, unknown>;
8
- }
9
- export interface RoutingSchemaOptions {
10
- extrasSchema?: StructuredSchema;
11
- }
12
- //# sourceMappingURL=routing.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/types/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC"}
@@ -1,3 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- //# sourceMappingURL=routing.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../src/types/routing.ts"],"names":[],"mappings":""}
@@ -1,12 +0,0 @@
1
- import type { StructuredSchema } from "./schema";
2
- export interface RoutingDecision {
3
- context: string;
4
- flows: Record<string, number>;
5
- responseDirectives?: string[];
6
- extractions?: unknown;
7
- contextUpdate?: Record<string, unknown>;
8
- }
9
- export interface RoutingSchemaOptions {
10
- extrasSchema?: StructuredSchema;
11
- }
12
- //# sourceMappingURL=routing.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/types/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC"}
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=routing.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"routing.js","sourceRoot":"","sources":["../../src/types/routing.ts"],"names":[],"mappings":""}
@@ -1,13 +0,0 @@
1
- import type { StructuredSchema } from "./schema";
2
-
3
- export interface RoutingDecision {
4
- context: string;
5
- flows: Record<string, number>;
6
- responseDirectives?: string[];
7
- extractions?: unknown;
8
- contextUpdate?: Record<string, unknown>;
9
- }
10
-
11
- export interface RoutingSchemaOptions {
12
- extrasSchema?: StructuredSchema;
13
- }