@falai/agent 0.9.0-alpha-1 → 0.9.0-alpha-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.
- package/README.md +34 -22
- package/dist/cjs/src/core/Agent.d.ts +52 -24
- package/dist/cjs/src/core/Agent.d.ts.map +1 -1
- package/dist/cjs/src/core/Agent.js +266 -39
- package/dist/cjs/src/core/Agent.js.map +1 -1
- package/dist/cjs/src/core/PersistenceManager.d.ts.map +1 -1
- package/dist/cjs/src/core/PersistenceManager.js +48 -25
- package/dist/cjs/src/core/PersistenceManager.js.map +1 -1
- package/dist/cjs/src/core/PromptComposer.d.ts +1 -1
- package/dist/cjs/src/core/PromptComposer.d.ts.map +1 -1
- package/dist/cjs/src/core/PromptComposer.js.map +1 -1
- package/dist/cjs/src/core/ResponseEngine.d.ts +13 -12
- package/dist/cjs/src/core/ResponseEngine.d.ts.map +1 -1
- package/dist/cjs/src/core/ResponseEngine.js +4 -4
- package/dist/cjs/src/core/ResponseEngine.js.map +1 -1
- package/dist/cjs/src/core/ResponsePipeline.d.ts +66 -38
- package/dist/cjs/src/core/ResponsePipeline.d.ts.map +1 -1
- package/dist/cjs/src/core/ResponsePipeline.js +71 -3
- package/dist/cjs/src/core/ResponsePipeline.js.map +1 -1
- package/dist/cjs/src/core/Route.d.ts +24 -5
- package/dist/cjs/src/core/Route.d.ts.map +1 -1
- package/dist/cjs/src/core/Route.js +45 -1
- package/dist/cjs/src/core/Route.js.map +1 -1
- package/dist/cjs/src/core/RoutingEngine.d.ts +31 -6
- package/dist/cjs/src/core/RoutingEngine.d.ts.map +1 -1
- package/dist/cjs/src/core/RoutingEngine.js +113 -9
- package/dist/cjs/src/core/RoutingEngine.js.map +1 -1
- package/dist/cjs/src/core/SessionManager.d.ts +14 -4
- package/dist/cjs/src/core/SessionManager.d.ts.map +1 -1
- package/dist/cjs/src/core/SessionManager.js +25 -5
- package/dist/cjs/src/core/SessionManager.js.map +1 -1
- package/dist/cjs/src/core/Step.d.ts +10 -10
- package/dist/cjs/src/core/Step.d.ts.map +1 -1
- package/dist/cjs/src/core/Step.js.map +1 -1
- package/dist/cjs/src/core/ToolExecutor.d.ts +4 -2
- package/dist/cjs/src/core/ToolExecutor.d.ts.map +1 -1
- package/dist/cjs/src/core/ToolExecutor.js +13 -3
- package/dist/cjs/src/core/ToolExecutor.js.map +1 -1
- package/dist/cjs/src/types/agent.d.ts +41 -21
- package/dist/cjs/src/types/agent.d.ts.map +1 -1
- package/dist/cjs/src/types/agent.js.map +1 -1
- package/dist/cjs/src/types/index.d.ts +1 -1
- package/dist/cjs/src/types/index.d.ts.map +1 -1
- package/dist/cjs/src/types/index.js.map +1 -1
- package/dist/cjs/src/types/persistence.d.ts +0 -1
- package/dist/cjs/src/types/persistence.d.ts.map +1 -1
- package/dist/cjs/src/types/route.d.ts +22 -16
- package/dist/cjs/src/types/route.d.ts.map +1 -1
- package/dist/cjs/src/types/session.d.ts +6 -11
- package/dist/cjs/src/types/session.d.ts.map +1 -1
- package/dist/cjs/src/types/tool.d.ts +12 -6
- package/dist/cjs/src/types/tool.d.ts.map +1 -1
- package/dist/cjs/src/utils/session.d.ts +2 -2
- package/dist/cjs/src/utils/session.d.ts.map +1 -1
- package/dist/cjs/src/utils/session.js +6 -26
- package/dist/cjs/src/utils/session.js.map +1 -1
- package/dist/src/core/Agent.d.ts +52 -24
- package/dist/src/core/Agent.d.ts.map +1 -1
- package/dist/src/core/Agent.js +266 -39
- package/dist/src/core/Agent.js.map +1 -1
- package/dist/src/core/PersistenceManager.d.ts.map +1 -1
- package/dist/src/core/PersistenceManager.js +48 -25
- package/dist/src/core/PersistenceManager.js.map +1 -1
- package/dist/src/core/PromptComposer.d.ts +1 -1
- package/dist/src/core/PromptComposer.d.ts.map +1 -1
- package/dist/src/core/PromptComposer.js.map +1 -1
- package/dist/src/core/ResponseEngine.d.ts +13 -12
- package/dist/src/core/ResponseEngine.d.ts.map +1 -1
- package/dist/src/core/ResponseEngine.js +4 -4
- package/dist/src/core/ResponseEngine.js.map +1 -1
- package/dist/src/core/ResponsePipeline.d.ts +66 -38
- package/dist/src/core/ResponsePipeline.d.ts.map +1 -1
- package/dist/src/core/ResponsePipeline.js +71 -3
- package/dist/src/core/ResponsePipeline.js.map +1 -1
- package/dist/src/core/Route.d.ts +24 -5
- package/dist/src/core/Route.d.ts.map +1 -1
- package/dist/src/core/Route.js +45 -1
- package/dist/src/core/Route.js.map +1 -1
- package/dist/src/core/RoutingEngine.d.ts +31 -6
- package/dist/src/core/RoutingEngine.d.ts.map +1 -1
- package/dist/src/core/RoutingEngine.js +113 -9
- package/dist/src/core/RoutingEngine.js.map +1 -1
- package/dist/src/core/SessionManager.d.ts +14 -4
- package/dist/src/core/SessionManager.d.ts.map +1 -1
- package/dist/src/core/SessionManager.js +25 -5
- package/dist/src/core/SessionManager.js.map +1 -1
- package/dist/src/core/Step.d.ts +10 -10
- package/dist/src/core/Step.d.ts.map +1 -1
- package/dist/src/core/Step.js.map +1 -1
- package/dist/src/core/ToolExecutor.d.ts +4 -2
- package/dist/src/core/ToolExecutor.d.ts.map +1 -1
- package/dist/src/core/ToolExecutor.js +13 -3
- package/dist/src/core/ToolExecutor.js.map +1 -1
- package/dist/src/types/agent.d.ts +41 -21
- package/dist/src/types/agent.d.ts.map +1 -1
- package/dist/src/types/agent.js.map +1 -1
- package/dist/src/types/index.d.ts +1 -1
- package/dist/src/types/index.d.ts.map +1 -1
- package/dist/src/types/index.js.map +1 -1
- package/dist/src/types/persistence.d.ts +0 -1
- package/dist/src/types/persistence.d.ts.map +1 -1
- package/dist/src/types/route.d.ts +22 -16
- package/dist/src/types/route.d.ts.map +1 -1
- package/dist/src/types/session.d.ts +6 -11
- package/dist/src/types/session.d.ts.map +1 -1
- package/dist/src/types/tool.d.ts +12 -6
- package/dist/src/types/tool.d.ts.map +1 -1
- package/dist/src/utils/session.d.ts +2 -2
- package/dist/src/utils/session.d.ts.map +1 -1
- package/dist/src/utils/session.js +6 -26
- package/dist/src/utils/session.js.map +1 -1
- package/docs/README.md +3 -3
- package/docs/api/README.md +35 -4
- package/docs/api/overview.md +166 -12
- package/docs/core/agent/README.md +162 -17
- package/docs/core/agent/context-management.md +39 -15
- package/docs/core/agent/session-management.md +49 -16
- package/docs/core/ai-integration/prompt-composition.md +38 -14
- package/docs/core/ai-integration/response-processing.md +28 -17
- package/docs/core/conversation-flows/data-collection.md +103 -25
- package/docs/core/conversation-flows/route-dsl.md +45 -22
- package/docs/core/conversation-flows/routes.md +74 -18
- package/docs/core/conversation-flows/step-transitions.md +3 -3
- package/docs/core/conversation-flows/steps.md +39 -15
- package/docs/core/routing/intelligent-routing.md +18 -9
- package/docs/core/tools/tool-definition.md +8 -8
- package/docs/core/tools/tool-execution.md +26 -26
- package/docs/core/tools/tool-scoping.md +5 -5
- package/docs/guides/getting-started/README.md +54 -32
- package/examples/advanced-patterns/knowledge-based-agent.ts +37 -28
- package/examples/advanced-patterns/persistent-onboarding.ts +70 -41
- package/examples/advanced-patterns/route-lifecycle-hooks.ts +28 -2
- package/examples/advanced-patterns/streaming-responses.ts +28 -23
- package/examples/ai-providers/anthropic-integration.ts +40 -33
- package/examples/ai-providers/openai-integration.ts +25 -25
- package/examples/conversation-flows/completion-transitions.ts +36 -32
- package/examples/core-concepts/basic-agent.ts +76 -78
- package/examples/core-concepts/schema-driven-extraction.ts +20 -16
- package/examples/core-concepts/session-management.ts +65 -53
- package/examples/integrations/database-integration.ts +49 -34
- package/examples/integrations/healthcare-integration.ts +96 -91
- package/examples/integrations/search-integration.ts +79 -82
- package/examples/integrations/server-session-management.ts +25 -17
- package/examples/persistence/database-persistence.ts +61 -45
- package/examples/persistence/memory-sessions.ts +52 -63
- package/examples/persistence/redis-persistence.ts +81 -95
- package/examples/tools/basic-tools.ts +73 -62
- package/examples/tools/data-enrichment-tools.ts +52 -44
- package/package.json +1 -1
- package/src/core/Agent.ts +418 -128
- package/src/core/PersistenceManager.ts +51 -27
- package/src/core/PromptComposer.ts +1 -1
- package/src/core/ResponseEngine.ts +21 -19
- package/src/core/ResponsePipeline.ts +174 -59
- package/src/core/Route.ts +58 -6
- package/src/core/RoutingEngine.ts +174 -27
- package/src/core/SessionManager.ts +32 -8
- package/src/core/Step.ts +20 -12
- package/src/core/ToolExecutor.ts +19 -5
- package/src/types/agent.ts +46 -23
- package/src/types/index.ts +2 -0
- package/src/types/persistence.ts +0 -1
- package/src/types/route.ts +22 -16
- package/src/types/session.ts +6 -12
- package/src/types/tool.ts +15 -9
- package/src/utils/session.ts +6 -31
package/README.md
CHANGED
|
@@ -288,46 +288,58 @@ interface HotelBookingData {
|
|
|
288
288
|
guests: number;
|
|
289
289
|
}
|
|
290
290
|
|
|
291
|
-
// 2️⃣ Create your agent
|
|
292
|
-
const agent = new Agent({
|
|
291
|
+
// 2️⃣ Create your agent with centralized data schema
|
|
292
|
+
const agent = new Agent<{}, HotelBookingData>({
|
|
293
293
|
name: "BookingBot",
|
|
294
294
|
description: "A hotel booking assistant that collects information.",
|
|
295
295
|
provider: new OpenAIProvider({
|
|
296
296
|
apiKey: process.env.OPENAI_API_KEY,
|
|
297
297
|
model: "gpt-4", // or your preferred model
|
|
298
298
|
}),
|
|
299
|
+
|
|
300
|
+
// Agent-level schema defines all possible data fields
|
|
301
|
+
schema: {
|
|
302
|
+
type: "object",
|
|
303
|
+
properties: {
|
|
304
|
+
hotelName: { type: "string", description: "The name of the hotel." },
|
|
305
|
+
date: { type: "string", description: "The desired booking date." },
|
|
306
|
+
guests: { type: "number", description: "The number of guests." },
|
|
307
|
+
},
|
|
308
|
+
required: ["hotelName", "date", "guests"],
|
|
309
|
+
},
|
|
310
|
+
|
|
311
|
+
// Agent-level data validation and enrichment
|
|
312
|
+
hooks: {
|
|
313
|
+
onDataUpdate: async (data, previousData) => {
|
|
314
|
+
// Auto-validate and enrich data
|
|
315
|
+
if (data.guests && data.guests > 10) {
|
|
316
|
+
throw new Error("Maximum 10 guests allowed");
|
|
317
|
+
}
|
|
318
|
+
return data;
|
|
319
|
+
}
|
|
320
|
+
}
|
|
299
321
|
});
|
|
300
322
|
|
|
301
|
-
// 3️⃣ Define a tool that uses the collected data
|
|
323
|
+
// 3️⃣ Define a tool that uses the agent-level collected data
|
|
302
324
|
const bookHotel: Tool<unknown, [], string, HotelBookingData> = {
|
|
303
325
|
id: "book_hotel",
|
|
304
326
|
description: "Books a hotel once all information is collected.",
|
|
305
327
|
parameters: { type: "object", properties: {} },
|
|
306
328
|
handler: ({ data }) => {
|
|
307
|
-
|
|
308
|
-
// Logic to book the hotel...
|
|
329
|
+
// Tool receives complete agent data
|
|
309
330
|
return {
|
|
310
|
-
data: `Booking confirmed for ${
|
|
331
|
+
data: `Booking confirmed for ${data.guests} guests at ${data.hotelName} on ${data.date}!`,
|
|
311
332
|
};
|
|
312
333
|
},
|
|
313
334
|
};
|
|
314
335
|
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
properties: {
|
|
318
|
-
hotelName: { type: "string", description: "The name of the hotel." },
|
|
319
|
-
date: { type: "string", description: "The desired booking date." },
|
|
320
|
-
guests: { type: "number", description: "The number of guests." },
|
|
321
|
-
},
|
|
322
|
-
required: ["hotelName", "date", "guests"],
|
|
323
|
-
};
|
|
324
|
-
|
|
325
|
-
// 4️⃣ Create a data-driven route with sequential steps
|
|
326
|
-
agent.createRoute<HotelBookingData>({
|
|
336
|
+
// 4️⃣ Create a route with required fields specification
|
|
337
|
+
agent.createRoute({
|
|
327
338
|
title: "Book Hotel",
|
|
328
339
|
description: "Guides the user through the hotel booking process.",
|
|
329
340
|
conditions: ["User wants to book a hotel"],
|
|
330
|
-
|
|
341
|
+
requiredFields: ["hotelName", "date", "guests"], // Required for route completion
|
|
342
|
+
|
|
331
343
|
// 5️⃣ Define the flow to collect data step-by-step
|
|
332
344
|
steps: [
|
|
333
345
|
{
|
|
@@ -342,7 +354,7 @@ agent.createRoute<HotelBookingData>({
|
|
|
342
354
|
description: "Ask for the booking date",
|
|
343
355
|
prompt: "What date would you like to book for?",
|
|
344
356
|
collect: ["date"],
|
|
345
|
-
requires: ["hotelName"],
|
|
357
|
+
requires: ["hotelName"], // Prerequisites from agent data
|
|
346
358
|
skipIf: (data: Partial<HotelBookingData>) => !!data.date,
|
|
347
359
|
},
|
|
348
360
|
{
|
|
@@ -350,14 +362,14 @@ agent.createRoute<HotelBookingData>({
|
|
|
350
362
|
description: "Ask for the number of guests",
|
|
351
363
|
prompt: "How many guests will be staying?",
|
|
352
364
|
collect: ["guests"],
|
|
353
|
-
requires: ["hotelName", "date"],
|
|
365
|
+
requires: ["hotelName", "date"], // Prerequisites from agent data
|
|
354
366
|
skipIf: (data: Partial<HotelBookingData>) => data.guests !== undefined,
|
|
355
367
|
},
|
|
356
368
|
{
|
|
357
369
|
id: "confirm_booking",
|
|
358
370
|
description: "Confirm and book the hotel",
|
|
359
371
|
prompt: "Let me confirm your booking details.",
|
|
360
|
-
tools: [bookHotel],
|
|
372
|
+
tools: [bookHotel], // Tool accesses complete agent data
|
|
361
373
|
requires: ["hotelName", "date", "guests"],
|
|
362
374
|
},
|
|
363
375
|
],
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Core Agent implementation
|
|
3
3
|
*/
|
|
4
|
-
import type { AgentOptions, Term, Guideline, Tool, Event, RouteOptions, SessionState, Template, StepRef, History, AgentResponseStreamChunk, AgentResponse } from "../types";
|
|
4
|
+
import type { AgentOptions, Term, Guideline, Tool, Event, RouteOptions, SessionState, Template, StepRef, History, AgentResponseStreamChunk, AgentResponse, StructuredSchema, ValidationResult } from "../types";
|
|
5
5
|
import { Route } from "./Route";
|
|
6
6
|
import { PersistenceManager } from "./PersistenceManager";
|
|
7
7
|
import { SessionManager } from "./SessionManager";
|
|
8
8
|
/**
|
|
9
|
-
* Main Agent class with generic context support
|
|
9
|
+
* Main Agent class with generic context and data support
|
|
10
10
|
*/
|
|
11
|
-
export declare class Agent<TContext =
|
|
11
|
+
export declare class Agent<TContext = any, TData = any> {
|
|
12
12
|
private readonly options;
|
|
13
13
|
private terms;
|
|
14
14
|
private guidelines;
|
|
@@ -21,9 +21,34 @@ export declare class Agent<TContext = unknown> {
|
|
|
21
21
|
private responsePipeline;
|
|
22
22
|
private currentSession?;
|
|
23
23
|
private knowledgeBase;
|
|
24
|
+
private schema?;
|
|
25
|
+
private collectedData;
|
|
24
26
|
/** Public session manager for easy session management */
|
|
25
|
-
session: SessionManager<
|
|
26
|
-
constructor(options: AgentOptions<TContext>);
|
|
27
|
+
session: SessionManager<TData>;
|
|
28
|
+
constructor(options: AgentOptions<TContext, TData>);
|
|
29
|
+
/**
|
|
30
|
+
* Validate the agent-level schema structure
|
|
31
|
+
* @private
|
|
32
|
+
*/
|
|
33
|
+
private validateSchema;
|
|
34
|
+
/**
|
|
35
|
+
* Validate data against the agent-level schema
|
|
36
|
+
*/
|
|
37
|
+
validateData(data: Partial<TData>): ValidationResult;
|
|
38
|
+
/**
|
|
39
|
+
* Check if a field is valid according to the agent schema
|
|
40
|
+
* @param field - The field key to validate
|
|
41
|
+
* @returns true if field exists in schema or no schema is defined, false otherwise
|
|
42
|
+
*/
|
|
43
|
+
isValidSchemaField(field: keyof TData): boolean;
|
|
44
|
+
/**
|
|
45
|
+
* Get the current collected data
|
|
46
|
+
*/
|
|
47
|
+
getCollectedData(): Partial<TData>;
|
|
48
|
+
/**
|
|
49
|
+
* Update collected data with validation
|
|
50
|
+
*/
|
|
51
|
+
updateCollectedData(updates: Partial<TData>): Promise<void>;
|
|
27
52
|
/**
|
|
28
53
|
* Get agent name
|
|
29
54
|
*/
|
|
@@ -41,26 +66,25 @@ export declare class Agent<TContext = unknown> {
|
|
|
41
66
|
*/
|
|
42
67
|
get identity(): Template<TContext> | undefined;
|
|
43
68
|
/**
|
|
44
|
-
* Create a new route (journey)
|
|
45
|
-
* @template TData - Type of data collected throughout the route
|
|
69
|
+
* Create a new route (journey) using agent-level data type
|
|
46
70
|
*/
|
|
47
|
-
createRoute
|
|
71
|
+
createRoute(options: RouteOptions<TContext, TData>): Route<TContext, TData>;
|
|
48
72
|
/**
|
|
49
73
|
* Create a domain term for the glossary
|
|
50
74
|
*/
|
|
51
|
-
createTerm(term: Term<TContext>): this;
|
|
75
|
+
createTerm(term: Term<TContext, TData>): this;
|
|
52
76
|
/**
|
|
53
77
|
* Create a behavioral guideline
|
|
54
78
|
*/
|
|
55
|
-
createGuideline(guideline: Guideline<TContext>): this;
|
|
79
|
+
createGuideline(guideline: Guideline<TContext, TData>): this;
|
|
56
80
|
/**
|
|
57
81
|
* Register a tool at the agent level
|
|
58
82
|
*/
|
|
59
|
-
createTool(tool: Tool<TContext, unknown[], unknown
|
|
83
|
+
createTool(tool: Tool<TContext, TData, unknown[], unknown>): this;
|
|
60
84
|
/**
|
|
61
85
|
* Register multiple tools at the agent level
|
|
62
86
|
*/
|
|
63
|
-
registerTools(tools: Tool<TContext, unknown[], unknown
|
|
87
|
+
registerTools(tools: Tool<TContext, TData, unknown[], unknown>[]): this;
|
|
64
88
|
/**
|
|
65
89
|
* Update the agent's context
|
|
66
90
|
* Triggers both agent-level and route-specific onContextUpdate lifecycle hooks if configured
|
|
@@ -76,10 +100,14 @@ export declare class Agent<TContext = unknown> {
|
|
|
76
100
|
* Get current context (fetches from provider if configured)
|
|
77
101
|
*/
|
|
78
102
|
getContext(): Promise<TContext | undefined>;
|
|
103
|
+
/**
|
|
104
|
+
* Get current schema
|
|
105
|
+
*/
|
|
106
|
+
getSchema(): StructuredSchema | undefined;
|
|
79
107
|
/**
|
|
80
108
|
* Generate a response based on history and context as a stream
|
|
81
109
|
*/
|
|
82
|
-
respondStream
|
|
110
|
+
respondStream(params: {
|
|
83
111
|
history: History;
|
|
84
112
|
step?: StepRef;
|
|
85
113
|
session?: SessionState<TData>;
|
|
@@ -89,7 +117,7 @@ export declare class Agent<TContext = unknown> {
|
|
|
89
117
|
/**
|
|
90
118
|
* Generate a response based on history and context
|
|
91
119
|
*/
|
|
92
|
-
respond
|
|
120
|
+
respond(params: {
|
|
93
121
|
history: History;
|
|
94
122
|
step?: StepRef;
|
|
95
123
|
session?: SessionState<TData>;
|
|
@@ -99,15 +127,15 @@ export declare class Agent<TContext = unknown> {
|
|
|
99
127
|
/**
|
|
100
128
|
* Get all routes
|
|
101
129
|
*/
|
|
102
|
-
getRoutes(): Route<TContext,
|
|
130
|
+
getRoutes(): Route<TContext, TData>[];
|
|
103
131
|
/**
|
|
104
132
|
* Get all terms
|
|
105
133
|
*/
|
|
106
|
-
getTerms(): Term<TContext>[];
|
|
134
|
+
getTerms(): Term<TContext, TData>[];
|
|
107
135
|
/**
|
|
108
136
|
* Get all tools
|
|
109
137
|
*/
|
|
110
|
-
getTools(): Tool<TContext, unknown[], unknown
|
|
138
|
+
getTools(): Tool<TContext, TData, unknown[], unknown>[];
|
|
111
139
|
/**
|
|
112
140
|
* Find an available tool by name for the given route
|
|
113
141
|
* Route-level tools take precedence over agent-level tools
|
|
@@ -127,7 +155,7 @@ export declare class Agent<TContext = unknown> {
|
|
|
127
155
|
/**
|
|
128
156
|
* Get all guidelines
|
|
129
157
|
*/
|
|
130
|
-
getGuidelines(): Guideline<TContext>[];
|
|
158
|
+
getGuidelines(): Guideline<TContext, TData>[];
|
|
131
159
|
/**
|
|
132
160
|
* Get the agent's knowledge base
|
|
133
161
|
*/
|
|
@@ -140,7 +168,7 @@ export declare class Agent<TContext = unknown> {
|
|
|
140
168
|
/**
|
|
141
169
|
* Get the persistence manager (if configured)
|
|
142
170
|
*/
|
|
143
|
-
getPersistenceManager(): PersistenceManager | undefined;
|
|
171
|
+
getPersistenceManager(): PersistenceManager<TData> | undefined;
|
|
144
172
|
/**
|
|
145
173
|
* Check if persistence is enabled
|
|
146
174
|
*/
|
|
@@ -159,11 +187,11 @@ export declare class Agent<TContext = unknown> {
|
|
|
159
187
|
*/
|
|
160
188
|
clearCurrentSession(): void;
|
|
161
189
|
/**
|
|
162
|
-
* Get collected data from current session
|
|
190
|
+
* Get collected data from current session or agent-level collected data
|
|
163
191
|
* @param routeId - Optional route ID to get data for (uses current route if not provided)
|
|
164
|
-
* @returns The collected data from the current session
|
|
192
|
+
* @returns The collected data from the current session or agent-level data
|
|
165
193
|
*/
|
|
166
|
-
getData
|
|
194
|
+
getData(): Partial<TData>;
|
|
167
195
|
/**
|
|
168
196
|
* Manually transition to a different route
|
|
169
197
|
* Sets a pending transition that will be executed on the next respond() call
|
|
@@ -181,12 +209,12 @@ export declare class Agent<TContext = unknown> {
|
|
|
181
209
|
* const nextResponse = await agent.respond({ history, session: updatedSession });
|
|
182
210
|
* }
|
|
183
211
|
*/
|
|
184
|
-
nextStepRoute(routeIdOrTitle: string, session?: SessionState
|
|
212
|
+
nextStepRoute(routeIdOrTitle: string, session?: SessionState<TData>, condition?: Template<TContext, TData>, history?: Event[]): Promise<SessionState<TData>>;
|
|
185
213
|
/**
|
|
186
214
|
* Simplified respond method using SessionManager
|
|
187
215
|
* Automatically manages conversation history through the session
|
|
188
216
|
*/
|
|
189
|
-
chat
|
|
217
|
+
chat(message?: string, options?: {
|
|
190
218
|
history?: History;
|
|
191
219
|
contextOverride?: Partial<TContext>;
|
|
192
220
|
signal?: AbortSignal;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../../src/core/Agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,YAAY,EAEZ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,wBAAwB,EACxB,aAAa,
|
|
1
|
+
{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../../src/core/Agent.ts"],"names":[],"mappings":"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"}
|