@ariaflowagents/core 0.7.0 → 0.8.1
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 +90 -1
- package/dist/agents/Agent.d.ts +188 -9
- package/dist/agents/Agent.d.ts.map +1 -1
- package/dist/agents/Agent.js +246 -24
- package/dist/agents/Agent.js.map +1 -1
- package/dist/agents/CompositeAgent.d.ts +4 -3
- package/dist/agents/CompositeAgent.d.ts.map +1 -1
- package/dist/agents/CompositeAgent.js +19 -9
- package/dist/agents/CompositeAgent.js.map +1 -1
- package/dist/agents/FlowAgent.d.ts +3 -2
- package/dist/agents/FlowAgent.d.ts.map +1 -1
- package/dist/agents/FlowAgent.js +16 -6
- package/dist/agents/FlowAgent.js.map +1 -1
- package/dist/agents/TriageAgent.d.ts +8 -2
- package/dist/agents/TriageAgent.d.ts.map +1 -1
- package/dist/agents/TriageAgent.js +39 -6
- package/dist/agents/TriageAgent.js.map +1 -1
- package/dist/agents/index.d.ts +1 -1
- package/dist/agents/index.d.ts.map +1 -1
- package/dist/agents/index.js +0 -1
- package/dist/agents/index.js.map +1 -1
- package/dist/flows/FlowManager.d.ts +8 -0
- package/dist/flows/FlowManager.d.ts.map +1 -1
- package/dist/flows/FlowManager.js +38 -4
- package/dist/flows/FlowManager.js.map +1 -1
- package/dist/flows/template.d.ts +2 -2
- package/dist/flows/template.d.ts.map +1 -1
- package/dist/flows/template.js +13 -0
- package/dist/flows/template.js.map +1 -1
- package/dist/foundation/AgentDefinition.d.ts +18 -0
- package/dist/foundation/AgentDefinition.d.ts.map +1 -0
- package/dist/foundation/AgentDefinition.js +2 -0
- package/dist/foundation/AgentDefinition.js.map +1 -0
- package/dist/foundation/AgentStateController.d.ts +26 -0
- package/dist/foundation/AgentStateController.d.ts.map +1 -0
- package/dist/foundation/AgentStateController.js +2 -0
- package/dist/foundation/AgentStateController.js.map +1 -0
- package/dist/foundation/ConversationEventLog.d.ts +72 -0
- package/dist/foundation/ConversationEventLog.d.ts.map +1 -0
- package/dist/foundation/ConversationEventLog.js +2 -0
- package/dist/foundation/ConversationEventLog.js.map +1 -0
- package/dist/foundation/ConversationState.d.ts +31 -0
- package/dist/foundation/ConversationState.d.ts.map +1 -0
- package/dist/foundation/ConversationState.js +2 -0
- package/dist/foundation/ConversationState.js.map +1 -0
- package/dist/foundation/DefaultAgentStateController.d.ts +24 -0
- package/dist/foundation/DefaultAgentStateController.d.ts.map +1 -0
- package/dist/foundation/DefaultAgentStateController.js +49 -0
- package/dist/foundation/DefaultAgentStateController.js.map +1 -0
- package/dist/foundation/DefaultConversationEventLog.d.ts +28 -0
- package/dist/foundation/DefaultConversationEventLog.d.ts.map +1 -0
- package/dist/foundation/DefaultConversationEventLog.js +195 -0
- package/dist/foundation/DefaultConversationEventLog.js.map +1 -0
- package/dist/foundation/DefaultConversationState.d.ts +34 -0
- package/dist/foundation/DefaultConversationState.d.ts.map +1 -0
- package/dist/foundation/DefaultConversationState.js +100 -0
- package/dist/foundation/DefaultConversationState.js.map +1 -0
- package/dist/foundation/DefaultToolExecutor.d.ts +58 -0
- package/dist/foundation/DefaultToolExecutor.d.ts.map +1 -0
- package/dist/foundation/DefaultToolExecutor.js +128 -0
- package/dist/foundation/DefaultToolExecutor.js.map +1 -0
- package/dist/foundation/ToolExecutor.d.ts +44 -0
- package/dist/foundation/ToolExecutor.d.ts.map +1 -0
- package/dist/foundation/ToolExecutor.js +2 -0
- package/dist/foundation/ToolExecutor.js.map +1 -0
- package/dist/foundation/createFoundation.d.ts +33 -0
- package/dist/foundation/createFoundation.d.ts.map +1 -0
- package/dist/foundation/createFoundation.js +34 -0
- package/dist/foundation/createFoundation.js.map +1 -0
- package/dist/foundation/index.d.ts +15 -0
- package/dist/foundation/index.d.ts.map +1 -0
- package/dist/foundation/index.js +8 -0
- package/dist/foundation/index.js.map +1 -0
- package/dist/hooks/HookRunner.d.ts +2 -0
- package/dist/hooks/HookRunner.d.ts.map +1 -1
- package/dist/hooks/HookRunner.js +4 -0
- package/dist/hooks/HookRunner.js.map +1 -1
- package/dist/index.d.ts +13 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/memory/MemoryService.d.ts +40 -0
- package/dist/memory/MemoryService.d.ts.map +1 -0
- package/dist/memory/MemoryService.js +2 -0
- package/dist/memory/MemoryService.js.map +1 -0
- package/dist/memory/index.d.ts +5 -0
- package/dist/memory/index.d.ts.map +1 -0
- package/dist/memory/index.js +3 -0
- package/dist/memory/index.js.map +1 -0
- package/dist/memory/preloadMemory.d.ts +17 -0
- package/dist/memory/preloadMemory.d.ts.map +1 -0
- package/dist/memory/preloadMemory.js +62 -0
- package/dist/memory/preloadMemory.js.map +1 -0
- package/dist/memory/stores/InMemoryMemoryService.d.ts +20 -0
- package/dist/memory/stores/InMemoryMemoryService.d.ts.map +1 -0
- package/dist/memory/stores/InMemoryMemoryService.js +92 -0
- package/dist/memory/stores/InMemoryMemoryService.js.map +1 -0
- package/dist/memory/types.d.ts +49 -0
- package/dist/memory/types.d.ts.map +1 -0
- package/dist/memory/types.js +8 -0
- package/dist/memory/types.js.map +1 -0
- package/dist/prompts/AgentPrompt.d.ts +110 -0
- package/dist/prompts/AgentPrompt.d.ts.map +1 -0
- package/dist/prompts/AgentPrompt.js +373 -0
- package/dist/prompts/AgentPrompt.js.map +1 -0
- package/dist/prompts/PromptAssembly.d.ts +119 -0
- package/dist/prompts/PromptAssembly.d.ts.map +1 -0
- package/dist/prompts/PromptAssembly.js +150 -0
- package/dist/prompts/PromptAssembly.js.map +1 -0
- package/dist/prompts/PromptBuilder.d.ts +22 -3
- package/dist/prompts/PromptBuilder.d.ts.map +1 -1
- package/dist/prompts/PromptBuilder.js +242 -13
- package/dist/prompts/PromptBuilder.js.map +1 -1
- package/dist/prompts/PromptRenderer.d.ts +43 -0
- package/dist/prompts/PromptRenderer.d.ts.map +1 -0
- package/dist/prompts/PromptRenderer.js +114 -0
- package/dist/prompts/PromptRenderer.js.map +1 -0
- package/dist/prompts/brandVoice.d.ts +10 -0
- package/dist/prompts/brandVoice.d.ts.map +1 -0
- package/dist/prompts/brandVoice.js +87 -0
- package/dist/prompts/brandVoice.js.map +1 -0
- package/dist/prompts/index.d.ts +11 -4
- package/dist/prompts/index.d.ts.map +1 -1
- package/dist/prompts/index.js +7 -2
- package/dist/prompts/index.js.map +1 -1
- package/dist/prompts/security.d.ts +5 -0
- package/dist/prompts/security.d.ts.map +1 -0
- package/dist/prompts/security.js +52 -0
- package/dist/prompts/security.js.map +1 -0
- package/dist/prompts/types.d.ts +65 -1
- package/dist/prompts/types.d.ts.map +1 -1
- package/dist/prompts/types.js +26 -0
- package/dist/prompts/types.js.map +1 -1
- package/dist/runtime/ContextBudget.d.ts +57 -0
- package/dist/runtime/ContextBudget.d.ts.map +1 -0
- package/dist/runtime/ContextBudget.js +103 -0
- package/dist/runtime/ContextBudget.js.map +1 -0
- package/dist/runtime/ContextManager.d.ts +8 -5
- package/dist/runtime/ContextManager.d.ts.map +1 -1
- package/dist/runtime/ContextManager.js +47 -14
- package/dist/runtime/ContextManager.js.map +1 -1
- package/dist/runtime/FlowExecutor.d.ts +16 -11
- package/dist/runtime/FlowExecutor.d.ts.map +1 -1
- package/dist/runtime/FlowExecutor.js +32 -138
- package/dist/runtime/FlowExecutor.js.map +1 -1
- package/dist/runtime/Runtime.d.ts +31 -78
- package/dist/runtime/Runtime.d.ts.map +1 -1
- package/dist/runtime/Runtime.js +225 -1406
- package/dist/runtime/Runtime.js.map +1 -1
- package/dist/runtime/SessionCache.d.ts +16 -0
- package/dist/runtime/SessionCache.d.ts.map +1 -0
- package/dist/runtime/SessionCache.js +49 -0
- package/dist/runtime/SessionCache.js.map +1 -0
- package/dist/runtime/SessionMutex.d.ts +37 -0
- package/dist/runtime/SessionMutex.d.ts.map +1 -0
- package/dist/runtime/SessionMutex.js +59 -0
- package/dist/runtime/SessionMutex.js.map +1 -0
- package/dist/runtime/StreamEmitter.d.ts +34 -0
- package/dist/runtime/StreamEmitter.d.ts.map +1 -0
- package/dist/runtime/StreamEmitter.js +91 -0
- package/dist/runtime/StreamEmitter.js.map +1 -0
- package/dist/runtime/handoffFilters.d.ts +60 -0
- package/dist/runtime/handoffFilters.d.ts.map +1 -0
- package/dist/runtime/handoffFilters.js +95 -0
- package/dist/runtime/handoffFilters.js.map +1 -0
- package/dist/runtime/pipeline/AgentExecuteStage.d.ts +22 -0
- package/dist/runtime/pipeline/AgentExecuteStage.d.ts.map +1 -0
- package/dist/runtime/pipeline/AgentExecuteStage.js +889 -0
- package/dist/runtime/pipeline/AgentExecuteStage.js.map +1 -0
- package/dist/runtime/pipeline/ContextAssembleStage.d.ts +26 -0
- package/dist/runtime/pipeline/ContextAssembleStage.d.ts.map +1 -0
- package/dist/runtime/pipeline/ContextAssembleStage.js +253 -0
- package/dist/runtime/pipeline/ContextAssembleStage.js.map +1 -0
- package/dist/runtime/pipeline/ContextGatherStage.d.ts +21 -0
- package/dist/runtime/pipeline/ContextGatherStage.d.ts.map +1 -0
- package/dist/runtime/pipeline/ContextGatherStage.js +161 -0
- package/dist/runtime/pipeline/ContextGatherStage.js.map +1 -0
- package/dist/runtime/pipeline/IntakeStage.d.ts +25 -0
- package/dist/runtime/pipeline/IntakeStage.d.ts.map +1 -0
- package/dist/runtime/pipeline/IntakeStage.js +126 -0
- package/dist/runtime/pipeline/IntakeStage.js.map +1 -0
- package/dist/runtime/pipeline/PostStreamStage.d.ts +26 -0
- package/dist/runtime/pipeline/PostStreamStage.d.ts.map +1 -0
- package/dist/runtime/pipeline/PostStreamStage.js +129 -0
- package/dist/runtime/pipeline/PostStreamStage.js.map +1 -0
- package/dist/runtime/pipeline/TurnPipeline.d.ts +54 -0
- package/dist/runtime/pipeline/TurnPipeline.d.ts.map +1 -0
- package/dist/runtime/pipeline/TurnPipeline.js +15 -0
- package/dist/runtime/pipeline/TurnPipeline.js.map +1 -0
- package/dist/runtime/pipeline/TurnServices.d.ts +48 -0
- package/dist/runtime/pipeline/TurnServices.d.ts.map +1 -0
- package/dist/runtime/pipeline/TurnServices.js +2 -0
- package/dist/runtime/pipeline/TurnServices.js.map +1 -0
- package/dist/runtime/pipeline/agentTypeGuards.d.ts +4 -0
- package/dist/runtime/pipeline/agentTypeGuards.d.ts.map +1 -0
- package/dist/runtime/pipeline/agentTypeGuards.js +7 -0
- package/dist/runtime/pipeline/agentTypeGuards.js.map +1 -0
- package/dist/runtime/pipeline/index.d.ts +11 -0
- package/dist/runtime/pipeline/index.d.ts.map +1 -0
- package/dist/runtime/pipeline/index.js +13 -0
- package/dist/runtime/pipeline/index.js.map +1 -0
- package/dist/runtime/pipeline/outputProcessing.d.ts +23 -0
- package/dist/runtime/pipeline/outputProcessing.d.ts.map +1 -0
- package/dist/runtime/pipeline/outputProcessing.js +63 -0
- package/dist/runtime/pipeline/outputProcessing.js.map +1 -0
- package/dist/runtime/pipeline/sessionUtils.d.ts +12 -0
- package/dist/runtime/pipeline/sessionUtils.d.ts.map +1 -0
- package/dist/runtime/pipeline/sessionUtils.js +73 -0
- package/dist/runtime/pipeline/sessionUtils.js.map +1 -0
- package/dist/tools/Tool.d.ts +7 -0
- package/dist/tools/Tool.d.ts.map +1 -1
- package/dist/tools/Tool.js +12 -3
- package/dist/tools/Tool.js.map +1 -1
- package/dist/tools/memory.d.ts +26 -0
- package/dist/tools/memory.d.ts.map +1 -0
- package/dist/tools/memory.js +51 -0
- package/dist/tools/memory.js.map +1 -0
- package/dist/types/index.d.ts +177 -6
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js.map +1 -1
- package/guides/AGENTS.md +173 -0
- package/guides/README.md +12 -0
- package/guides/TOOLS.md +93 -27
- package/package.json +12 -4
- package/dist/agents/LLMAgent.d.ts +0 -11
- package/dist/agents/LLMAgent.d.ts.map +0 -1
- package/dist/agents/LLMAgent.js +0 -31
- package/dist/agents/LLMAgent.js.map +0 -1
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { SessionWorkingMemory } from '../runtime/WorkingMemory.js';
|
|
2
|
+
import { normalizeModelMessage } from '../utils/messageNormalization.js';
|
|
3
|
+
/** Internal working memory key for turn tracking. */
|
|
4
|
+
const SESSION_TURN_KEY = '__ariaSessionTurn';
|
|
5
|
+
/**
|
|
6
|
+
* Default conversation state implementation extracted from Runtime.
|
|
7
|
+
*
|
|
8
|
+
* Handles:
|
|
9
|
+
* - Session load/create/save/delete via SessionStore
|
|
10
|
+
* - Message appending with normalization
|
|
11
|
+
* - Turn counting
|
|
12
|
+
* - Working memory access
|
|
13
|
+
*/
|
|
14
|
+
export class DefaultConversationState {
|
|
15
|
+
sessionStore;
|
|
16
|
+
defaultAgentId;
|
|
17
|
+
constructor(config) {
|
|
18
|
+
this.sessionStore = config.sessionStore;
|
|
19
|
+
this.defaultAgentId = config.defaultAgentId;
|
|
20
|
+
}
|
|
21
|
+
async load(sessionId, userId) {
|
|
22
|
+
const existing = await this.sessionStore.get(sessionId);
|
|
23
|
+
if (existing) {
|
|
24
|
+
return existing;
|
|
25
|
+
}
|
|
26
|
+
return this.createSession(sessionId, this.defaultAgentId, userId);
|
|
27
|
+
}
|
|
28
|
+
async save(session) {
|
|
29
|
+
this.touchSession(session);
|
|
30
|
+
await this.sessionStore.save(session);
|
|
31
|
+
}
|
|
32
|
+
async delete(sessionId) {
|
|
33
|
+
await this.sessionStore.delete(sessionId);
|
|
34
|
+
}
|
|
35
|
+
workingMemory(session) {
|
|
36
|
+
return new SessionWorkingMemory(session);
|
|
37
|
+
}
|
|
38
|
+
appendUserMessage(session, text) {
|
|
39
|
+
const message = {
|
|
40
|
+
role: 'user',
|
|
41
|
+
content: [{ type: 'text', text }],
|
|
42
|
+
};
|
|
43
|
+
this.appendMessage(session, message);
|
|
44
|
+
}
|
|
45
|
+
appendAssistantMessage(session, text) {
|
|
46
|
+
const message = {
|
|
47
|
+
role: 'assistant',
|
|
48
|
+
content: [{ type: 'text', text }],
|
|
49
|
+
};
|
|
50
|
+
this.appendMessage(session, message);
|
|
51
|
+
}
|
|
52
|
+
appendMessage(session, message) {
|
|
53
|
+
const normalized = normalizeModelMessage(message);
|
|
54
|
+
if (normalized) {
|
|
55
|
+
session.messages.push(normalized);
|
|
56
|
+
this.touchSession(session);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
getSessionTurn(session) {
|
|
60
|
+
const value = session.workingMemory[SESSION_TURN_KEY];
|
|
61
|
+
return typeof value === 'number' && Number.isFinite(value) ? value : 0;
|
|
62
|
+
}
|
|
63
|
+
bumpSessionTurn(session) {
|
|
64
|
+
const next = this.getSessionTurn(session) + 1;
|
|
65
|
+
session.workingMemory[SESSION_TURN_KEY] = next;
|
|
66
|
+
this.touchSession(session);
|
|
67
|
+
return next;
|
|
68
|
+
}
|
|
69
|
+
touchSession(session) {
|
|
70
|
+
const now = new Date();
|
|
71
|
+
session.updatedAt = now;
|
|
72
|
+
if (session.metadata) {
|
|
73
|
+
session.metadata.lastActiveAt = now;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
createSession(id, defaultAgentId, userId) {
|
|
77
|
+
const now = new Date();
|
|
78
|
+
return {
|
|
79
|
+
id,
|
|
80
|
+
userId,
|
|
81
|
+
messages: [],
|
|
82
|
+
createdAt: now,
|
|
83
|
+
updatedAt: now,
|
|
84
|
+
workingMemory: {},
|
|
85
|
+
currentAgent: defaultAgentId,
|
|
86
|
+
activeAgentId: defaultAgentId,
|
|
87
|
+
state: {},
|
|
88
|
+
metadata: {
|
|
89
|
+
createdAt: now,
|
|
90
|
+
lastActiveAt: now,
|
|
91
|
+
totalTokens: 0,
|
|
92
|
+
totalSteps: 0,
|
|
93
|
+
handoffHistory: [],
|
|
94
|
+
},
|
|
95
|
+
agentStates: {},
|
|
96
|
+
handoffHistory: [],
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=DefaultConversationState.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"DefaultConversationState.js","sourceRoot":"","sources":["../../src/foundation/DefaultConversationState.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { Session, ToolCallRecord } from '../types/index.js';
|
|
2
|
+
import type { ToolExecutor, ExecutableTool } from './ToolExecutor.js';
|
|
3
|
+
import type { ToolEnforcer } from '../guards/ToolEnforcer.js';
|
|
4
|
+
import type { HookRunner } from '../hooks/HookRunner.js';
|
|
5
|
+
import type { MemoryService } from '../memory/MemoryService.js';
|
|
6
|
+
export interface DefaultToolExecutorConfig {
|
|
7
|
+
enforcer: ToolEnforcer;
|
|
8
|
+
hookRunner: HookRunner;
|
|
9
|
+
memoryService?: MemoryService;
|
|
10
|
+
/** Default timeout in milliseconds for tool execution. Defaults to 30000 (30s). */
|
|
11
|
+
defaultToolTimeoutMs?: number;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Error thrown when a tool execution exceeds the configured timeout.
|
|
15
|
+
*/
|
|
16
|
+
export declare class ToolTimeoutError extends Error {
|
|
17
|
+
readonly toolName: string;
|
|
18
|
+
readonly timeoutMs: number;
|
|
19
|
+
constructor(toolName: string, timeoutMs: number);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Default tool executor extracted from Runtime.wrapToolsWithEnforcement().
|
|
23
|
+
*
|
|
24
|
+
* Handles:
|
|
25
|
+
* - Enforcement checks via ToolEnforcer
|
|
26
|
+
* - Idempotency key generation
|
|
27
|
+
* - Context enrichment (experimental_context)
|
|
28
|
+
* - Error propagation via HookRunner
|
|
29
|
+
*/
|
|
30
|
+
export declare class DefaultToolExecutor implements ToolExecutor {
|
|
31
|
+
private enforcer;
|
|
32
|
+
private hookRunner;
|
|
33
|
+
private memoryService?;
|
|
34
|
+
private defaultToolTimeoutMs?;
|
|
35
|
+
constructor(config: DefaultToolExecutorConfig);
|
|
36
|
+
execute(args: {
|
|
37
|
+
session: Session;
|
|
38
|
+
userId?: string;
|
|
39
|
+
agentId: string;
|
|
40
|
+
toolName: string;
|
|
41
|
+
tool: ExecutableTool;
|
|
42
|
+
input: unknown;
|
|
43
|
+
toolCallId?: string;
|
|
44
|
+
abortSignal?: AbortSignal;
|
|
45
|
+
step?: number;
|
|
46
|
+
turn?: number;
|
|
47
|
+
toolCallHistory?: ToolCallRecord[];
|
|
48
|
+
}): Promise<unknown>;
|
|
49
|
+
buildIdempotencyKey(args: {
|
|
50
|
+
sessionId: string;
|
|
51
|
+
agentId: string;
|
|
52
|
+
step: number;
|
|
53
|
+
toolName: string;
|
|
54
|
+
toolCallId: string;
|
|
55
|
+
}): string;
|
|
56
|
+
private withToolExecutionMetadata;
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=DefaultToolExecutor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"DefaultToolExecutor.d.ts","sourceRoot":"","sources":["../../src/foundation/DefaultToolExecutor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAsB,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMhD;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,oBAAoB,CAAC,CAAS;gBAE1B,MAAM,EAAE,yBAAyB;IAOvC,OAAO,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,cAAc,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;KACpC,GAAG,OAAO,CAAC,OAAO,CAAC;IAuFpB,mBAAmB,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM;IAIV,OAAO,CAAC,yBAAyB;CAmClC"}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import crypto from 'node:crypto';
|
|
2
|
+
import { isRecord } from '../utils/isRecord.js';
|
|
3
|
+
/**
|
|
4
|
+
* Error thrown when a tool execution exceeds the configured timeout.
|
|
5
|
+
*/
|
|
6
|
+
export class ToolTimeoutError extends Error {
|
|
7
|
+
toolName;
|
|
8
|
+
timeoutMs;
|
|
9
|
+
constructor(toolName, timeoutMs) {
|
|
10
|
+
super(`Tool "${toolName}" timeout after ${timeoutMs}ms`);
|
|
11
|
+
this.name = 'ToolTimeoutError';
|
|
12
|
+
this.toolName = toolName;
|
|
13
|
+
this.timeoutMs = timeoutMs;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Default tool executor extracted from Runtime.wrapToolsWithEnforcement().
|
|
18
|
+
*
|
|
19
|
+
* Handles:
|
|
20
|
+
* - Enforcement checks via ToolEnforcer
|
|
21
|
+
* - Idempotency key generation
|
|
22
|
+
* - Context enrichment (experimental_context)
|
|
23
|
+
* - Error propagation via HookRunner
|
|
24
|
+
*/
|
|
25
|
+
export class DefaultToolExecutor {
|
|
26
|
+
enforcer;
|
|
27
|
+
hookRunner;
|
|
28
|
+
memoryService;
|
|
29
|
+
defaultToolTimeoutMs;
|
|
30
|
+
constructor(config) {
|
|
31
|
+
this.enforcer = config.enforcer;
|
|
32
|
+
this.hookRunner = config.hookRunner;
|
|
33
|
+
this.memoryService = config.memoryService;
|
|
34
|
+
this.defaultToolTimeoutMs = config.defaultToolTimeoutMs;
|
|
35
|
+
}
|
|
36
|
+
async execute(args) {
|
|
37
|
+
const { session, agentId, toolName, tool, input, step = 0, turn = 0, toolCallHistory = [], } = args;
|
|
38
|
+
const toolCallId = args.toolCallId ?? crypto.randomUUID();
|
|
39
|
+
const idempotencyKey = this.buildIdempotencyKey({
|
|
40
|
+
sessionId: session.id,
|
|
41
|
+
agentId,
|
|
42
|
+
step,
|
|
43
|
+
toolName,
|
|
44
|
+
toolCallId,
|
|
45
|
+
});
|
|
46
|
+
const callRecord = {
|
|
47
|
+
toolCallId,
|
|
48
|
+
toolName,
|
|
49
|
+
args: input,
|
|
50
|
+
idempotencyKey,
|
|
51
|
+
success: true,
|
|
52
|
+
timestamp: Date.now(),
|
|
53
|
+
};
|
|
54
|
+
// Enforcement check
|
|
55
|
+
const enforcement = await this.enforcer.check(callRecord, {
|
|
56
|
+
previousCalls: toolCallHistory,
|
|
57
|
+
currentStep: step,
|
|
58
|
+
sessionState: session.state ?? {},
|
|
59
|
+
});
|
|
60
|
+
if (!enforcement.allowed) {
|
|
61
|
+
const reason = enforcement.reason ?? 'Tool call blocked by enforcement';
|
|
62
|
+
callRecord.success = false;
|
|
63
|
+
callRecord.error = new Error(reason);
|
|
64
|
+
toolCallHistory.push(callRecord);
|
|
65
|
+
const runContext = {
|
|
66
|
+
session,
|
|
67
|
+
agentId,
|
|
68
|
+
stepCount: step,
|
|
69
|
+
totalTokens: 0,
|
|
70
|
+
handoffStack: [],
|
|
71
|
+
startTime: Date.now(),
|
|
72
|
+
consecutiveErrors: 0,
|
|
73
|
+
toolCallHistory,
|
|
74
|
+
};
|
|
75
|
+
await this.hookRunner.onToolError(runContext, callRecord, callRecord.error);
|
|
76
|
+
throw callRecord.error;
|
|
77
|
+
}
|
|
78
|
+
// Build enriched options for the tool's execute function
|
|
79
|
+
if (!('execute' in tool) || typeof tool.execute !== 'function') {
|
|
80
|
+
throw new Error(`Tool "${toolName}" does not have an execute function`);
|
|
81
|
+
}
|
|
82
|
+
const enrichedOptions = this.withToolExecutionMetadata(undefined, { session, agentId, step, turn, toolName, toolCallId, idempotencyKey });
|
|
83
|
+
try {
|
|
84
|
+
const timeoutMs = tool.timeout ?? this.defaultToolTimeoutMs ?? 30_000;
|
|
85
|
+
const exec = tool.execute.bind(tool);
|
|
86
|
+
const result = await Promise.race([
|
|
87
|
+
exec(input, enrichedOptions),
|
|
88
|
+
new Promise((_, reject) => {
|
|
89
|
+
const timer = setTimeout(() => reject(new ToolTimeoutError(toolName, timeoutMs)), timeoutMs);
|
|
90
|
+
if (typeof timer === 'object' && 'unref' in timer)
|
|
91
|
+
timer.unref();
|
|
92
|
+
}),
|
|
93
|
+
]);
|
|
94
|
+
return result;
|
|
95
|
+
}
|
|
96
|
+
catch (error) {
|
|
97
|
+
console.error(`[ToolExecutor] Tool execution failed for ${toolName}:`, error);
|
|
98
|
+
throw error;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
buildIdempotencyKey(args) {
|
|
102
|
+
return `${args.sessionId}:${args.agentId}:${args.step}:${args.toolName}:${args.toolCallId}`;
|
|
103
|
+
}
|
|
104
|
+
withToolExecutionMetadata(options, ctx) {
|
|
105
|
+
const baseOptions = options ?? {};
|
|
106
|
+
const baseAsAny = baseOptions;
|
|
107
|
+
const existingContext = isRecord(baseAsAny.experimental_context)
|
|
108
|
+
? baseAsAny.experimental_context
|
|
109
|
+
: {};
|
|
110
|
+
return {
|
|
111
|
+
...baseOptions,
|
|
112
|
+
toolCallId: ctx.toolCallId,
|
|
113
|
+
experimental_context: {
|
|
114
|
+
...existingContext,
|
|
115
|
+
session: ctx.session,
|
|
116
|
+
sessionId: ctx.session.id,
|
|
117
|
+
agentId: ctx.agentId,
|
|
118
|
+
step: ctx.step,
|
|
119
|
+
turn: ctx.turn,
|
|
120
|
+
toolName: ctx.toolName,
|
|
121
|
+
toolCallId: ctx.toolCallId,
|
|
122
|
+
idempotencyKey: ctx.idempotencyKey,
|
|
123
|
+
memoryService: this.memoryService,
|
|
124
|
+
},
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
//# sourceMappingURL=DefaultToolExecutor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"DefaultToolExecutor.js","sourceRoot":"","sources":["../../src/foundation/DefaultToolExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAOjC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAUhD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,QAAQ,CAAS;IACjB,SAAS,CAAS;IAE3B,YAAY,QAAgB,EAAE,SAAiB;QAC7C,KAAK,CAAC,SAAS,QAAQ,mBAAmB,SAAS,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACtB,QAAQ,CAAe;IACvB,UAAU,CAAa;IACvB,aAAa,CAAiB;IAC9B,oBAAoB,CAAU;IAEtC,YAAY,MAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAYb;QACC,MAAM,EACJ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,IAAI,GAAG,CAAC,EACR,IAAI,GAAG,CAAC,EACR,eAAe,GAAG,EAAE,GACrB,GAAG,IAAI,CAAC;QAET,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC;YAC9C,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,OAAO;YACP,IAAI;YACJ,QAAQ;YACR,UAAU;SACX,CAAC,CAAC;QAEH,MAAM,UAAU,GAAmB;YACjC,UAAU;YACV,QAAQ;YACR,IAAI,EAAE,KAAK;YACX,cAAc;YACd,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,oBAAoB;QACpB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE;YACxD,aAAa,EAAE,eAAe;YAC9B,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,kCAAkC,CAAC;YACxE,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,UAAU,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEjC,MAAM,UAAU,GAAG;gBACjB,OAAO;gBACP,OAAO;gBACP,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,EAAE;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,iBAAiB,EAAE,CAAC;gBACpB,eAAe;aAChB,CAAC;YACF,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,UAAU,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,yDAAyD;QACzD,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,qCAAqC,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,yBAAyB,CACpD,SAAS,EACT,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,CACvE,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,SAAS,GAAI,IAAY,CAAC,OAAO,IAAI,IAAI,CAAC,oBAAoB,IAAI,MAAM,CAAC;YAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC;gBAC5B,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC/B,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,EACvD,SAAS,CACV,CAAC;oBACF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK;wBAAG,KAAa,CAAC,KAAK,EAAE,CAAC;gBAC5E,CAAC,CAAC;aACH,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,IAMnB;QACC,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9F,CAAC;IAEO,yBAAyB,CAC/B,OAA2C,EAC3C,GAQC;QAED,MAAM,WAAW,GAAG,OAAO,IAAI,EAA4B,CAAC;QAC5D,MAAM,SAAS,GAAG,WAAiD,CAAC;QACpE,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC,oBAAoB,CAAC;YAC9D,CAAC,CAAC,SAAS,CAAC,oBAA+C;YAC3D,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,GAAG,WAAW;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,oBAAoB,EAAE;gBACpB,GAAG,eAAe;gBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE;gBACzB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,cAAc,EAAE,GAAG,CAAC,cAAc;gBAClC,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC;SACwB,CAAC;IAC9B,CAAC;CACF"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { Session, ToolCallRecord } from '../types/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* Minimal tool shape required by the executor.
|
|
4
|
+
* Compatible with AI SDK `Tool`, VoiceToolDef, and plain `{ execute }` objects.
|
|
5
|
+
*/
|
|
6
|
+
export interface ExecutableTool {
|
|
7
|
+
execute: (args: any, options?: any) => Promise<unknown>;
|
|
8
|
+
description?: string;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Encapsulates tool execution with enforcement, idempotency, and context enrichment.
|
|
12
|
+
* Shared by Runtime (text path) and VoiceEngine (audio path).
|
|
13
|
+
*/
|
|
14
|
+
export interface ToolExecutor {
|
|
15
|
+
/**
|
|
16
|
+
* Execute a single tool call with enforcement checks and context enrichment.
|
|
17
|
+
* Returns the tool's result or throws if blocked/failed.
|
|
18
|
+
*/
|
|
19
|
+
execute(args: {
|
|
20
|
+
session: Session;
|
|
21
|
+
userId?: string;
|
|
22
|
+
agentId: string;
|
|
23
|
+
toolName: string;
|
|
24
|
+
tool: ExecutableTool;
|
|
25
|
+
input: unknown;
|
|
26
|
+
toolCallId?: string;
|
|
27
|
+
abortSignal?: AbortSignal;
|
|
28
|
+
step?: number;
|
|
29
|
+
turn?: number;
|
|
30
|
+
/** Full tool call history for enforcement context. */
|
|
31
|
+
toolCallHistory?: ToolCallRecord[];
|
|
32
|
+
}): Promise<unknown>;
|
|
33
|
+
/**
|
|
34
|
+
* Build a deterministic idempotency key for external side-effect deduplication.
|
|
35
|
+
*/
|
|
36
|
+
buildIdempotencyKey(args: {
|
|
37
|
+
sessionId: string;
|
|
38
|
+
agentId: string;
|
|
39
|
+
step: number;
|
|
40
|
+
toolName: string;
|
|
41
|
+
toolCallId: string;
|
|
42
|
+
}): string;
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=ToolExecutor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../src/foundation/ToolExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,cAAc,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,sDAAsD;QACtD,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;KACpC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErB;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM,CAAC;CACZ"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolExecutor.js","sourceRoot":"","sources":["../../src/foundation/ToolExecutor.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { SessionStore } from '../session/SessionStore.js';
|
|
2
|
+
import type { MemoryService } from '../memory/MemoryService.js';
|
|
3
|
+
import type { EnforcementRule, HarnessHooks } from '../types/index.js';
|
|
4
|
+
import type { ToolExecutor } from './ToolExecutor.js';
|
|
5
|
+
import type { ConversationState } from './ConversationState.js';
|
|
6
|
+
import type { ConversationEventLog } from './ConversationEventLog.js';
|
|
7
|
+
import type { AgentStateController } from './AgentStateController.js';
|
|
8
|
+
/**
|
|
9
|
+
* Configuration for creating a foundation service bundle.
|
|
10
|
+
*/
|
|
11
|
+
export interface FoundationConfig {
|
|
12
|
+
sessionStore?: SessionStore;
|
|
13
|
+
defaultAgentId?: string;
|
|
14
|
+
enforcementRules?: EnforcementRule[];
|
|
15
|
+
hooks?: HarnessHooks;
|
|
16
|
+
memoryService?: MemoryService;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Bundle of all foundation services. Both Runtime and VoiceEngine
|
|
20
|
+
* compose this to share operational logic.
|
|
21
|
+
*/
|
|
22
|
+
export interface Foundation {
|
|
23
|
+
toolExecutor: ToolExecutor;
|
|
24
|
+
conversationState: ConversationState;
|
|
25
|
+
eventLog: ConversationEventLog;
|
|
26
|
+
agentState: AgentStateController;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Create a foundation service bundle with default implementations.
|
|
30
|
+
* Services can be individually overridden if needed.
|
|
31
|
+
*/
|
|
32
|
+
export declare function createFoundation(config?: FoundationConfig): Foundation;
|
|
33
|
+
//# sourceMappingURL=createFoundation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createFoundation.d.ts","sourceRoot":"","sources":["../../src/foundation/createFoundation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAUtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,gBAAqB,GAAG,UAAU,CAqB1E"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { DefaultToolExecutor } from './DefaultToolExecutor.js';
|
|
2
|
+
import { DefaultConversationState } from './DefaultConversationState.js';
|
|
3
|
+
import { DefaultConversationEventLog } from './DefaultConversationEventLog.js';
|
|
4
|
+
import { DefaultAgentStateController } from './DefaultAgentStateController.js';
|
|
5
|
+
import { ToolEnforcer } from '../guards/ToolEnforcer.js';
|
|
6
|
+
import { defaultEnforcementRules } from '../guards/rules.js';
|
|
7
|
+
import { HookRunner } from '../hooks/HookRunner.js';
|
|
8
|
+
import { MemoryStore } from '../session/stores/MemoryStore.js';
|
|
9
|
+
/**
|
|
10
|
+
* Create a foundation service bundle with default implementations.
|
|
11
|
+
* Services can be individually overridden if needed.
|
|
12
|
+
*/
|
|
13
|
+
export function createFoundation(config = {}) {
|
|
14
|
+
const sessionStore = config.sessionStore ?? new MemoryStore();
|
|
15
|
+
const defaultAgentId = config.defaultAgentId ?? 'default';
|
|
16
|
+
const enforcer = new ToolEnforcer(config.enforcementRules ?? defaultEnforcementRules);
|
|
17
|
+
const hookRunner = new HookRunner(config.hooks);
|
|
18
|
+
return {
|
|
19
|
+
toolExecutor: new DefaultToolExecutor({
|
|
20
|
+
enforcer,
|
|
21
|
+
hookRunner,
|
|
22
|
+
memoryService: config.memoryService,
|
|
23
|
+
}),
|
|
24
|
+
conversationState: new DefaultConversationState({
|
|
25
|
+
sessionStore,
|
|
26
|
+
defaultAgentId,
|
|
27
|
+
}),
|
|
28
|
+
eventLog: new DefaultConversationEventLog({
|
|
29
|
+
sessionStore,
|
|
30
|
+
}),
|
|
31
|
+
agentState: new DefaultAgentStateController(),
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=createFoundation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createFoundation.js","sourceRoot":"","sources":["../../src/foundation/createFoundation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAwB/D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA2B,EAAE;IAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,WAAW,EAAE,CAAC;IAC9D,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,SAAS,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,gBAAgB,IAAI,uBAAuB,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhD,OAAO;QACL,YAAY,EAAE,IAAI,mBAAmB,CAAC;YACpC,QAAQ;YACR,UAAU;YACV,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;QACF,iBAAiB,EAAE,IAAI,wBAAwB,CAAC;YAC9C,YAAY;YACZ,cAAc;SACf,CAAC;QACF,QAAQ,EAAE,IAAI,2BAA2B,CAAC;YACxC,YAAY;SACb,CAAC;QACF,UAAU,EAAE,IAAI,2BAA2B,EAAE;KAC9C,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
export type { AgentDefinition } from './AgentDefinition.js';
|
|
2
|
+
export type { ToolExecutor, ExecutableTool } from './ToolExecutor.js';
|
|
3
|
+
export type { ConversationState } from './ConversationState.js';
|
|
4
|
+
export type { ConversationEventLog, ConversationEvent } from './ConversationEventLog.js';
|
|
5
|
+
export type { AgentStateController } from './AgentStateController.js';
|
|
6
|
+
export { DefaultToolExecutor, ToolTimeoutError } from './DefaultToolExecutor.js';
|
|
7
|
+
export type { DefaultToolExecutorConfig } from './DefaultToolExecutor.js';
|
|
8
|
+
export { DefaultConversationState } from './DefaultConversationState.js';
|
|
9
|
+
export type { DefaultConversationStateConfig } from './DefaultConversationState.js';
|
|
10
|
+
export { DefaultConversationEventLog } from './DefaultConversationEventLog.js';
|
|
11
|
+
export type { DefaultConversationEventLogConfig } from './DefaultConversationEventLog.js';
|
|
12
|
+
export { DefaultAgentStateController } from './DefaultAgentStateController.js';
|
|
13
|
+
export { createFoundation } from './createFoundation.js';
|
|
14
|
+
export type { Foundation, FoundationConfig } from './createFoundation.js';
|
|
15
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundation/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzF,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
// Default implementations
|
|
2
|
+
export { DefaultToolExecutor, ToolTimeoutError } from './DefaultToolExecutor.js';
|
|
3
|
+
export { DefaultConversationState } from './DefaultConversationState.js';
|
|
4
|
+
export { DefaultConversationEventLog } from './DefaultConversationEventLog.js';
|
|
5
|
+
export { DefaultAgentStateController } from './DefaultAgentStateController.js';
|
|
6
|
+
// Factory
|
|
7
|
+
export { createFoundation } from './createFoundation.js';
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundation/index.ts"],"names":[],"mappings":"AAOA,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
|
|
@@ -5,6 +5,8 @@ export declare class HookRunner {
|
|
|
5
5
|
private hooks;
|
|
6
6
|
private errorHandler;
|
|
7
7
|
constructor(hooks?: HarnessHooks, errorHandler?: HookErrorHandler);
|
|
8
|
+
/** Check if a specific hook is configured. */
|
|
9
|
+
has(hookName: string): boolean;
|
|
8
10
|
run<K extends keyof HarnessHooks>(hookName: K, ...args: NonNullable<HarnessHooks[K]> extends (...args: infer P) => any ? P : never): Promise<void>;
|
|
9
11
|
onStart(context: RunContext): Promise<void>;
|
|
10
12
|
onEnd(context: RunContext, result: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"HookRunner.d.ts","sourceRoot":"","sources":["../../src/hooks/HookRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,KAAK,gBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAOjE,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,YAAY,CAAmB;gBAE3B,KAAK,GAAE,YAAiB,EAAE,YAAY,CAAC,EAAE,gBAAgB;
|
|
1
|
+
{"version":3,"file":"HookRunner.d.ts","sourceRoot":"","sources":["../../src/hooks/HookRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,KAAK,gBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAOjE,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,YAAY,CAAmB;gBAE3B,KAAK,GAAE,YAAiB,EAAE,YAAY,CAAC,EAAE,gBAAgB;IAKrE,8CAA8C;IAC9C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxB,GAAG,CAAC,CAAC,SAAS,MAAM,YAAY,EACpC,QAAQ,EAAE,CAAC,EACX,GAAG,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,GAClF,OAAO,CAAC,IAAI,CAAC;IAWV,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAItF,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAInF,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,KAAK,CAAC,eAAe,EAAE,YAAY,GAAG,IAAI;IAiB1C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAInC,QAAQ,IAAI,YAAY;CAGzB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,YAAY,EACpB,YAAY,CAAC,EAAE,gBAAgB,GAC9B,UAAU,CAEZ"}
|
package/dist/hooks/HookRunner.js
CHANGED
|
@@ -8,6 +8,10 @@ export class HookRunner {
|
|
|
8
8
|
this.hooks = hooks;
|
|
9
9
|
this.errorHandler = errorHandler ?? defaultErrorHandler;
|
|
10
10
|
}
|
|
11
|
+
/** Check if a specific hook is configured. */
|
|
12
|
+
has(hookName) {
|
|
13
|
+
return Boolean(this.hooks[hookName]);
|
|
14
|
+
}
|
|
11
15
|
async run(hookName, ...args) {
|
|
12
16
|
const hook = this.hooks[hookName];
|
|
13
17
|
if (!hook)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"HookRunner.js","sourceRoot":"","sources":["../../src/hooks/HookRunner.ts"],"names":[],"mappings":"AAMA,MAAM,mBAAmB,GAAqB,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;IAChE,OAAO,CAAC,KAAK,CAAC,sBAAsB,QAAQ,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,OAAO,UAAU;IACb,KAAK,CAAe;IACpB,YAAY,CAAmB;IAEvC,YAAY,QAAsB,EAAE,EAAE,YAA+B;QACnE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,mBAAmB,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,GAAG,CACP,QAAW,EACX,GAAG,IAAgF;QAEnF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,CAAC;YACH,MAAO,IAA8C,CAAC,GAAG,IAAI,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAc,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAmB;QAC/B,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAmB,EAAE,MAA2C;QAC1E,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAmB,EAAE,IAAY;QACjD,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAmB,EAAE,IAAY,EAAE,MAAkB;QACnE,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAmB,EAAE,IAAoB;QACxD,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAmB,EAAE,IAAoB;QAC1D,MAAM,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAmB,EAAE,IAAoB,EAAE,KAAY;QACvE,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAmB,EAAE,OAAe;QACrD,MAAM,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAmB,EAAE,OAAe;QACnD,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAmB,EAAE,IAAY,EAAE,EAAU,EAAE,MAAc;QAC3E,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAmB,EAAE,KAAY;QAC7C,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAmB,EAAE,OAAqB;QACxD,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAmB,EAAE,IAAuB;QAC7D,MAAM,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,eAA6B;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAgC,CAAC;QACpD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAA4B,CAAC;YACvD,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;oBACzC,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;oBACxB,MAAO,IAAoB,CAAC,GAAG,IAAI,CAAC,CAAC;gBACvC,CAAC,CAAgB,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,IAAmB,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,KAAmB;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAoB,EACpB,YAA+B;IAE/B,OAAO,IAAI,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC"}
|
|
1
|
+
{"version":3,"file":"HookRunner.js","sourceRoot":"","sources":["../../src/hooks/HookRunner.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { Agent } from './agents/Agent.js';
|
|
2
|
-
export {
|
|
2
|
+
export type { AgentConstructorConfig, GenerateOptions, GenerateResult, AsToolConfig, } from './agents/Agent.js';
|
|
3
3
|
export { FlowAgent } from './agents/FlowAgent.js';
|
|
4
4
|
export { TriageAgent } from './agents/TriageAgent.js';
|
|
5
5
|
export { CompositeAgent } from './agents/CompositeAgent.js';
|
|
@@ -15,7 +15,7 @@ export { MemoryStore } from './session/stores/MemoryStore.js';
|
|
|
15
15
|
export { Runtime, createRuntime } from './runtime/Runtime.js';
|
|
16
16
|
export { InjectionQueue, createInjectionQueue, commonInjections, policyProfiles, getPolicyProfileInjections, } from './runtime/InjectionQueue.js';
|
|
17
17
|
export { SessionWorkingMemory } from './runtime/WorkingMemory.js';
|
|
18
|
-
export { createContextManager, createSummarizingContextManager, type ContextManager, type ContextManagerOptions, } from './runtime/ContextManager.js';
|
|
18
|
+
export { createContextManager, createSummarizingContextManager, type ContextManager, type ContextManagerContext, type ContextManagerOptions, } from './runtime/ContextManager.js';
|
|
19
19
|
export type { Tool, ToolSet, ToolDefinition, ToolWithFiller, ToolExecutionOptions, ToolExecutionContext, } from './tools/Tool.js';
|
|
20
20
|
export { createTool, createToolWithFiller } from './tools/Tool.js';
|
|
21
21
|
export { createHandoffTool, isHandoffResult } from './tools/handoff.js';
|
|
@@ -23,6 +23,7 @@ export type { HandoffResult } from './tools/handoff.js';
|
|
|
23
23
|
export { isFinalResult } from './tools/final.js';
|
|
24
24
|
export type { FinalResult } from './tools/final.js';
|
|
25
25
|
export { createHttpTool } from './tools/http.js';
|
|
26
|
+
export { createLoadMemoryTool } from './tools/memory.js';
|
|
26
27
|
export type { HttpToolConfig, HttpToolResult, HttpParam, ParamType, HttpMethod, AuthConfig, } from './tools/http.types.js';
|
|
27
28
|
export { PromptTemplateBuilder, PromptBuilder, createPromptTemplate, SUPPORT_AGENT_TEMPLATE, SALES_AGENT_TEMPLATE, TRIAGE_AGENT_TEMPLATE, createSupportAgentTemplate, DEFAULT_HANDOFF_INSTRUCTION, } from './prompts/index.js';
|
|
28
29
|
export type { PromptSection, PromptTemplate, ToolGuideline } from './prompts/index.js';
|
|
@@ -41,5 +42,15 @@ export { createDateParser, parseDate, parseDateRange, formatDateForSpeech, forma
|
|
|
41
42
|
export type { DateParserOptions, ParsedDateResult } from './utils/index.js';
|
|
42
43
|
export { getTemplate, registerTemplate, listTemplates, getAllTemplates } from './prompts/index.js';
|
|
43
44
|
export type { GlossaryTerm, VoiceRulesConfig } from './prompts/index.js';
|
|
45
|
+
export type { MemoryService } from './memory/index.js';
|
|
46
|
+
export type { MemoryEntry, SearchMemoryRequest, SearchMemoryResponse, MemoryIngestionOptions, } from './memory/index.js';
|
|
47
|
+
export { InMemoryMemoryService } from './memory/index.js';
|
|
48
|
+
export { preloadMemoryContext } from './memory/index.js';
|
|
49
|
+
export { DEFAULT_CONTEXT_BUDGET, computeMessageHistoryBudget, truncateToTokenBudget, formatMemoryWithBudget, estimateTokenCount, } from './runtime/ContextBudget.js';
|
|
50
|
+
export type { ContextBudgetConfig } from './runtime/ContextBudget.js';
|
|
51
|
+
export { handoffFilters, removeToolHistory, keepRecentMessages, removeKeys, composeFilters, } from './runtime/handoffFilters.js';
|
|
52
|
+
export type { HandoffInputFilter, HandoffInputData, HandoffInputResult, } from './runtime/handoffFilters.js';
|
|
53
|
+
export { DefaultToolExecutor, DefaultConversationState, DefaultConversationEventLog, DefaultAgentStateController, createFoundation, } from './foundation/index.js';
|
|
54
|
+
export type { ToolExecutor, ConversationState, ConversationEventLog, ConversationEvent, AgentStateController, Foundation, FoundationConfig, } from './foundation/index.js';
|
|
44
55
|
export type * from './types/index.js';
|
|
45
56
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
export { Agent } from './agents/Agent.js';
|
|
2
|
-
export { LLMAgent } from './agents/LLMAgent.js';
|
|
3
2
|
export { FlowAgent } from './agents/FlowAgent.js';
|
|
4
3
|
export { TriageAgent } from './agents/TriageAgent.js';
|
|
5
4
|
export { CompositeAgent } from './agents/CompositeAgent.js';
|
|
@@ -18,6 +17,7 @@ export { createTool, createToolWithFiller } from './tools/Tool.js';
|
|
|
18
17
|
export { createHandoffTool, isHandoffResult } from './tools/handoff.js';
|
|
19
18
|
export { isFinalResult } from './tools/final.js';
|
|
20
19
|
export { createHttpTool } from './tools/http.js';
|
|
20
|
+
export { createLoadMemoryTool } from './tools/memory.js';
|
|
21
21
|
export { PromptTemplateBuilder, PromptBuilder, createPromptTemplate, SUPPORT_AGENT_TEMPLATE, SALES_AGENT_TEMPLATE, TRIAGE_AGENT_TEMPLATE, createSupportAgentTemplate, DEFAULT_HANDOFF_INSTRUCTION, } from './prompts/index.js';
|
|
22
22
|
export { HookRunner, createHookRunner } from './hooks/HookRunner.js';
|
|
23
23
|
export { loggingHooks, createLoggingHooks } from './hooks/builtin/logging.js';
|
|
@@ -32,4 +32,12 @@ export * as EnforcementRules from './guards/rules.js';
|
|
|
32
32
|
export { createDateParser, parseDate, parseDateRange, formatDateForSpeech, formatTimeForSpeech, dateParser, commonDateExpressions, } from './utils/index.js';
|
|
33
33
|
// Prompt templates and registry
|
|
34
34
|
export { getTemplate, registerTemplate, listTemplates, getAllTemplates } from './prompts/index.js';
|
|
35
|
+
export { InMemoryMemoryService } from './memory/index.js';
|
|
36
|
+
export { preloadMemoryContext } from './memory/index.js';
|
|
37
|
+
// Context Budget
|
|
38
|
+
export { DEFAULT_CONTEXT_BUDGET, computeMessageHistoryBudget, truncateToTokenBudget, formatMemoryWithBudget, estimateTokenCount, } from './runtime/ContextBudget.js';
|
|
39
|
+
// Handoff Filters
|
|
40
|
+
export { handoffFilters, removeToolHistory, keepRecentMessages, removeKeys, composeFilters, } from './runtime/handoffFilters.js';
|
|
41
|
+
// Foundation (shared primitives for Runtime + VoiceEngine)
|
|
42
|
+
export { DefaultToolExecutor, DefaultConversationState, DefaultConversationEventLog, DefaultAgentStateController, createFoundation, } from './foundation/index.js';
|
|
35
43
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|