@falai/agent 1.2.7 → 2.0.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.
- package/README.md +40 -886
- package/dist/adapters/MemoryAdapter.js +2 -2
- package/dist/adapters/MemoryAdapter.js.map +1 -1
- package/dist/adapters/MongoAdapter.js +2 -2
- package/dist/adapters/MongoAdapter.js.map +1 -1
- package/dist/adapters/OpenSearchAdapter.d.ts.map +1 -1
- package/dist/adapters/OpenSearchAdapter.js +9 -7
- package/dist/adapters/OpenSearchAdapter.js.map +1 -1
- package/dist/adapters/PostgreSQLAdapter.d.ts +14 -0
- package/dist/adapters/PostgreSQLAdapter.d.ts.map +1 -1
- package/dist/adapters/PostgreSQLAdapter.js +25 -9
- package/dist/adapters/PostgreSQLAdapter.js.map +1 -1
- package/dist/adapters/PrismaAdapter.js +5 -5
- package/dist/adapters/PrismaAdapter.js.map +1 -1
- package/dist/adapters/RedisAdapter.js +2 -2
- package/dist/adapters/RedisAdapter.js.map +1 -1
- package/dist/adapters/SQLiteAdapter.d.ts +17 -0
- package/dist/adapters/SQLiteAdapter.d.ts.map +1 -1
- package/dist/adapters/SQLiteAdapter.js +30 -11
- package/dist/adapters/SQLiteAdapter.js.map +1 -1
- package/dist/cjs/adapters/MemoryAdapter.js +2 -2
- package/dist/cjs/adapters/MemoryAdapter.js.map +1 -1
- package/dist/cjs/adapters/MongoAdapter.js +2 -2
- package/dist/cjs/adapters/MongoAdapter.js.map +1 -1
- package/dist/cjs/adapters/OpenSearchAdapter.d.ts.map +1 -1
- package/dist/cjs/adapters/OpenSearchAdapter.js +9 -7
- package/dist/cjs/adapters/OpenSearchAdapter.js.map +1 -1
- package/dist/cjs/adapters/PostgreSQLAdapter.d.ts +14 -0
- package/dist/cjs/adapters/PostgreSQLAdapter.d.ts.map +1 -1
- package/dist/cjs/adapters/PostgreSQLAdapter.js +25 -9
- package/dist/cjs/adapters/PostgreSQLAdapter.js.map +1 -1
- package/dist/cjs/adapters/PrismaAdapter.js +5 -5
- package/dist/cjs/adapters/PrismaAdapter.js.map +1 -1
- package/dist/cjs/adapters/RedisAdapter.js +2 -2
- package/dist/cjs/adapters/RedisAdapter.js.map +1 -1
- package/dist/cjs/adapters/SQLiteAdapter.d.ts +17 -0
- package/dist/cjs/adapters/SQLiteAdapter.d.ts.map +1 -1
- package/dist/cjs/adapters/SQLiteAdapter.js +30 -11
- package/dist/cjs/adapters/SQLiteAdapter.js.map +1 -1
- package/dist/cjs/constants/index.d.ts +0 -9
- package/dist/cjs/constants/index.d.ts.map +1 -1
- package/dist/cjs/constants/index.js +2 -11
- package/dist/cjs/constants/index.js.map +1 -1
- package/dist/cjs/core/Agent.d.ts +119 -153
- package/dist/cjs/core/Agent.d.ts.map +1 -1
- package/dist/cjs/core/Agent.js +471 -324
- package/dist/cjs/core/Agent.js.map +1 -1
- package/dist/cjs/core/AutoChainExecutor.d.ts +107 -0
- package/dist/cjs/core/AutoChainExecutor.d.ts.map +1 -0
- package/dist/cjs/core/AutoChainExecutor.js +297 -0
- package/dist/cjs/core/AutoChainExecutor.js.map +1 -0
- package/dist/cjs/core/BranchEvaluator.d.ts +54 -0
- package/dist/cjs/core/BranchEvaluator.d.ts.map +1 -0
- package/dist/cjs/core/BranchEvaluator.js +130 -0
- package/dist/cjs/core/BranchEvaluator.js.map +1 -0
- package/dist/cjs/core/DirectiveBus.d.ts +88 -0
- package/dist/cjs/core/DirectiveBus.d.ts.map +1 -0
- package/dist/cjs/core/DirectiveBus.js +196 -0
- package/dist/cjs/core/DirectiveBus.js.map +1 -0
- package/dist/cjs/core/DirectiveChainTracker.d.ts +49 -0
- package/dist/cjs/core/DirectiveChainTracker.d.ts.map +1 -0
- package/dist/cjs/core/DirectiveChainTracker.js +121 -0
- package/dist/cjs/core/DirectiveChainTracker.js.map +1 -0
- package/dist/cjs/core/Flow.d.ts +186 -0
- package/dist/cjs/core/Flow.d.ts.map +1 -0
- package/dist/cjs/core/Flow.js +550 -0
- package/dist/cjs/core/Flow.js.map +1 -0
- package/dist/cjs/core/FlowRouter.d.ts +182 -0
- package/dist/cjs/core/FlowRouter.d.ts.map +1 -0
- package/dist/cjs/core/{RoutingEngine.js → FlowRouter.js} +323 -306
- package/dist/cjs/core/FlowRouter.js.map +1 -0
- package/dist/cjs/core/PersistenceManager.d.ts +2 -2
- package/dist/cjs/core/PersistenceManager.d.ts.map +1 -1
- package/dist/cjs/core/PersistenceManager.js +7 -7
- package/dist/cjs/core/PersistenceManager.js.map +1 -1
- package/dist/cjs/core/PromptComposer.d.ts +21 -8
- package/dist/cjs/core/PromptComposer.d.ts.map +1 -1
- package/dist/cjs/core/PromptComposer.js +182 -105
- package/dist/cjs/core/PromptComposer.js.map +1 -1
- package/dist/cjs/core/PromptSectionCache.d.ts +1 -1
- package/dist/cjs/core/PromptSectionCache.js +1 -1
- package/dist/cjs/core/ResponseEngine.d.ts +18 -8
- package/dist/cjs/core/ResponseEngine.d.ts.map +1 -1
- package/dist/cjs/core/ResponseEngine.js +38 -36
- package/dist/cjs/core/ResponseEngine.js.map +1 -1
- package/dist/cjs/core/ResponseModal.d.ts +73 -56
- package/dist/cjs/core/ResponseModal.d.ts.map +1 -1
- package/dist/cjs/core/ResponseModal.js +1196 -1015
- package/dist/cjs/core/ResponseModal.js.map +1 -1
- package/dist/cjs/core/ResponsePipeline.d.ts +124 -26
- package/dist/cjs/core/ResponsePipeline.d.ts.map +1 -1
- package/dist/cjs/core/ResponsePipeline.js +524 -134
- package/dist/cjs/core/ResponsePipeline.js.map +1 -1
- package/dist/cjs/core/SignalEvaluator.d.ts +86 -0
- package/dist/cjs/core/SignalEvaluator.d.ts.map +1 -0
- package/dist/cjs/core/SignalEvaluator.js +333 -0
- package/dist/cjs/core/SignalEvaluator.js.map +1 -0
- package/dist/cjs/core/SignalProcessor.d.ts +152 -0
- package/dist/cjs/core/SignalProcessor.d.ts.map +1 -0
- package/dist/cjs/core/SignalProcessor.js +562 -0
- package/dist/cjs/core/SignalProcessor.js.map +1 -0
- package/dist/cjs/core/Step.d.ts +43 -32
- package/dist/cjs/core/Step.d.ts.map +1 -1
- package/dist/cjs/core/Step.js +221 -126
- package/dist/cjs/core/Step.js.map +1 -1
- package/dist/cjs/core/StreamingToolExecutor.d.ts +2 -2
- package/dist/cjs/core/StreamingToolExecutor.d.ts.map +1 -1
- package/dist/cjs/core/StreamingToolExecutor.js.map +1 -1
- package/dist/cjs/core/ToolManager.d.ts +44 -13
- package/dist/cjs/core/ToolManager.d.ts.map +1 -1
- package/dist/cjs/core/ToolManager.js +174 -91
- package/dist/cjs/core/ToolManager.js.map +1 -1
- package/dist/cjs/core/createAgent.d.ts +35 -0
- package/dist/cjs/core/createAgent.d.ts.map +1 -0
- package/dist/cjs/core/createAgent.js +39 -0
- package/dist/cjs/core/createAgent.js.map +1 -0
- package/dist/cjs/core/flow-namespace.d.ts +49 -0
- package/dist/cjs/core/flow-namespace.d.ts.map +1 -0
- package/dist/cjs/core/flow-namespace.js +171 -0
- package/dist/cjs/core/flow-namespace.js.map +1 -0
- package/dist/cjs/index.d.ts +11 -14
- package/dist/cjs/index.d.ts.map +1 -1
- package/dist/cjs/index.js +18 -22
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/providers/GeminiProvider.d.ts +3 -3
- package/dist/cjs/providers/GeminiProvider.d.ts.map +1 -1
- package/dist/cjs/providers/GeminiProvider.js +16 -14
- package/dist/cjs/providers/GeminiProvider.js.map +1 -1
- package/dist/cjs/types/agent.d.ts +183 -54
- package/dist/cjs/types/agent.d.ts.map +1 -1
- package/dist/cjs/types/agent.js +0 -6
- package/dist/cjs/types/agent.js.map +1 -1
- package/dist/cjs/types/ai.d.ts +3 -3
- package/dist/cjs/types/ai.d.ts.map +1 -1
- package/dist/cjs/types/errors.d.ts +15 -0
- package/dist/cjs/types/errors.d.ts.map +1 -0
- package/dist/cjs/types/errors.js +22 -0
- package/dist/cjs/types/errors.js.map +1 -0
- package/dist/cjs/types/flow.d.ts +513 -0
- package/dist/cjs/types/flow.d.ts.map +1 -0
- package/dist/cjs/types/{route.js → flow.js} +2 -2
- package/dist/cjs/types/flow.js.map +1 -0
- package/dist/cjs/types/index.d.ts +7 -6
- package/dist/cjs/types/index.d.ts.map +1 -1
- package/dist/cjs/types/index.js +6 -2
- package/dist/cjs/types/index.js.map +1 -1
- package/dist/cjs/types/persistence.d.ts +11 -7
- package/dist/cjs/types/persistence.d.ts.map +1 -1
- package/dist/cjs/types/routing.d.ts +1 -1
- package/dist/cjs/types/routing.d.ts.map +1 -1
- package/dist/cjs/types/session.d.ts +24 -23
- package/dist/cjs/types/session.d.ts.map +1 -1
- package/dist/cjs/types/signals.d.ts +248 -0
- package/dist/cjs/types/signals.d.ts.map +1 -0
- package/dist/cjs/types/signals.js +11 -0
- package/dist/cjs/types/signals.js.map +1 -0
- package/dist/cjs/types/template.d.ts +2 -8
- package/dist/cjs/types/template.d.ts.map +1 -1
- package/dist/cjs/types/tool.d.ts +36 -29
- package/dist/cjs/types/tool.d.ts.map +1 -1
- package/dist/cjs/types/tool.js +1 -1
- package/dist/cjs/types/tool.js.map +1 -1
- package/dist/cjs/utils/condition.d.ts +7 -1
- package/dist/cjs/utils/condition.d.ts.map +1 -1
- package/dist/cjs/utils/condition.js.map +1 -1
- package/dist/cjs/utils/id.d.ts +13 -5
- package/dist/cjs/utils/id.d.ts.map +1 -1
- package/dist/cjs/utils/id.js +24 -10
- package/dist/cjs/utils/id.js.map +1 -1
- package/dist/cjs/utils/index.d.ts +2 -2
- package/dist/cjs/utils/index.d.ts.map +1 -1
- package/dist/cjs/utils/index.js +7 -3
- package/dist/cjs/utils/index.js.map +1 -1
- package/dist/cjs/utils/session.d.ts +44 -5
- package/dist/cjs/utils/session.d.ts.map +1 -1
- package/dist/cjs/utils/session.js +197 -38
- package/dist/cjs/utils/session.js.map +1 -1
- package/dist/constants/index.d.ts +0 -9
- package/dist/constants/index.d.ts.map +1 -1
- package/dist/constants/index.js +3 -9
- package/dist/constants/index.js.map +1 -1
- package/dist/core/Agent.d.ts +119 -153
- package/dist/core/Agent.d.ts.map +1 -1
- package/dist/core/Agent.js +472 -325
- package/dist/core/Agent.js.map +1 -1
- package/dist/core/AutoChainExecutor.d.ts +107 -0
- package/dist/core/AutoChainExecutor.d.ts.map +1 -0
- package/dist/core/AutoChainExecutor.js +293 -0
- package/dist/core/AutoChainExecutor.js.map +1 -0
- package/dist/core/BranchEvaluator.d.ts +54 -0
- package/dist/core/BranchEvaluator.d.ts.map +1 -0
- package/dist/core/BranchEvaluator.js +126 -0
- package/dist/core/BranchEvaluator.js.map +1 -0
- package/dist/core/DirectiveBus.d.ts +88 -0
- package/dist/core/DirectiveBus.d.ts.map +1 -0
- package/dist/core/DirectiveBus.js +192 -0
- package/dist/core/DirectiveBus.js.map +1 -0
- package/dist/core/DirectiveChainTracker.d.ts +49 -0
- package/dist/core/DirectiveChainTracker.d.ts.map +1 -0
- package/dist/core/DirectiveChainTracker.js +117 -0
- package/dist/core/DirectiveChainTracker.js.map +1 -0
- package/dist/core/Flow.d.ts +186 -0
- package/dist/core/Flow.d.ts.map +1 -0
- package/dist/core/Flow.js +546 -0
- package/dist/core/Flow.js.map +1 -0
- package/dist/core/FlowRouter.d.ts +182 -0
- package/dist/core/FlowRouter.d.ts.map +1 -0
- package/dist/core/{RoutingEngine.js → FlowRouter.js} +322 -305
- package/dist/core/FlowRouter.js.map +1 -0
- package/dist/core/PersistenceManager.d.ts +2 -2
- package/dist/core/PersistenceManager.d.ts.map +1 -1
- package/dist/core/PersistenceManager.js +7 -7
- package/dist/core/PersistenceManager.js.map +1 -1
- package/dist/core/PromptComposer.d.ts +21 -8
- package/dist/core/PromptComposer.d.ts.map +1 -1
- package/dist/core/PromptComposer.js +183 -106
- package/dist/core/PromptComposer.js.map +1 -1
- package/dist/core/PromptSectionCache.d.ts +1 -1
- package/dist/core/PromptSectionCache.js +1 -1
- package/dist/core/ResponseEngine.d.ts +18 -8
- package/dist/core/ResponseEngine.d.ts.map +1 -1
- package/dist/core/ResponseEngine.js +38 -36
- package/dist/core/ResponseEngine.js.map +1 -1
- package/dist/core/ResponseModal.d.ts +73 -56
- package/dist/core/ResponseModal.d.ts.map +1 -1
- package/dist/core/ResponseModal.js +1198 -1017
- package/dist/core/ResponseModal.js.map +1 -1
- package/dist/core/ResponsePipeline.d.ts +124 -26
- package/dist/core/ResponsePipeline.d.ts.map +1 -1
- package/dist/core/ResponsePipeline.js +524 -135
- package/dist/core/ResponsePipeline.js.map +1 -1
- package/dist/core/SignalEvaluator.d.ts +86 -0
- package/dist/core/SignalEvaluator.d.ts.map +1 -0
- package/dist/core/SignalEvaluator.js +326 -0
- package/dist/core/SignalEvaluator.js.map +1 -0
- package/dist/core/SignalProcessor.d.ts +152 -0
- package/dist/core/SignalProcessor.d.ts.map +1 -0
- package/dist/core/SignalProcessor.js +555 -0
- package/dist/core/SignalProcessor.js.map +1 -0
- package/dist/core/Step.d.ts +43 -32
- package/dist/core/Step.d.ts.map +1 -1
- package/dist/core/Step.js +220 -126
- package/dist/core/Step.js.map +1 -1
- package/dist/core/StreamingToolExecutor.d.ts +2 -2
- package/dist/core/StreamingToolExecutor.d.ts.map +1 -1
- package/dist/core/StreamingToolExecutor.js.map +1 -1
- package/dist/core/ToolManager.d.ts +44 -13
- package/dist/core/ToolManager.d.ts.map +1 -1
- package/dist/core/ToolManager.js +174 -91
- package/dist/core/ToolManager.js.map +1 -1
- package/dist/core/createAgent.d.ts +35 -0
- package/dist/core/createAgent.d.ts.map +1 -0
- package/dist/core/createAgent.js +36 -0
- package/dist/core/createAgent.js.map +1 -0
- package/dist/core/flow-namespace.d.ts +49 -0
- package/dist/core/flow-namespace.d.ts.map +1 -0
- package/dist/core/flow-namespace.js +168 -0
- package/dist/core/flow-namespace.js.map +1 -0
- package/dist/index.d.ts +11 -14
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -12
- package/dist/index.js.map +1 -1
- package/dist/providers/GeminiProvider.d.ts +3 -3
- package/dist/providers/GeminiProvider.d.ts.map +1 -1
- package/dist/providers/GeminiProvider.js +16 -14
- package/dist/providers/GeminiProvider.js.map +1 -1
- package/dist/types/agent.d.ts +183 -54
- package/dist/types/agent.d.ts.map +1 -1
- package/dist/types/agent.js +0 -6
- package/dist/types/agent.js.map +1 -1
- package/dist/types/ai.d.ts +3 -3
- package/dist/types/ai.d.ts.map +1 -1
- package/dist/types/errors.d.ts +15 -0
- package/dist/types/errors.d.ts.map +1 -0
- package/dist/types/errors.js +18 -0
- package/dist/types/errors.js.map +1 -0
- package/dist/types/flow.d.ts +513 -0
- package/dist/types/flow.d.ts.map +1 -0
- package/dist/types/flow.js +5 -0
- package/dist/types/flow.js.map +1 -0
- package/dist/types/index.d.ts +7 -6
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js +4 -1
- package/dist/types/index.js.map +1 -1
- package/dist/types/persistence.d.ts +11 -7
- package/dist/types/persistence.d.ts.map +1 -1
- package/dist/types/routing.d.ts +1 -1
- package/dist/types/routing.d.ts.map +1 -1
- package/dist/types/session.d.ts +24 -23
- package/dist/types/session.d.ts.map +1 -1
- package/dist/types/signals.d.ts +248 -0
- package/dist/types/signals.d.ts.map +1 -0
- package/dist/types/signals.js +10 -0
- package/dist/types/signals.js.map +1 -0
- package/dist/types/template.d.ts +2 -8
- package/dist/types/template.d.ts.map +1 -1
- package/dist/types/tool.d.ts +36 -29
- package/dist/types/tool.d.ts.map +1 -1
- package/dist/types/tool.js +1 -1
- package/dist/types/tool.js.map +1 -1
- package/dist/utils/condition.d.ts +7 -1
- package/dist/utils/condition.d.ts.map +1 -1
- package/dist/utils/condition.js.map +1 -1
- package/dist/utils/id.d.ts +13 -5
- package/dist/utils/id.d.ts.map +1 -1
- package/dist/utils/id.js +22 -9
- package/dist/utils/id.js.map +1 -1
- package/dist/utils/index.d.ts +2 -2
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/index.js +2 -2
- package/dist/utils/index.js.map +1 -1
- package/dist/utils/session.d.ts +44 -5
- package/dist/utils/session.d.ts.map +1 -1
- package/dist/utils/session.js +193 -37
- package/dist/utils/session.js.map +1 -1
- package/docs/README.md +15 -202
- package/docs/concepts/architecture.md +281 -0
- package/docs/concepts/directives.md +400 -0
- package/docs/concepts/pipeline.md +399 -0
- package/docs/guides/branching.md +263 -0
- package/docs/guides/compaction.md +163 -0
- package/docs/guides/conditions.md +167 -0
- package/docs/guides/error-handling.md +176 -0
- package/docs/guides/flow-control.md +409 -0
- package/docs/guides/instructions.md +210 -0
- package/docs/guides/persistence.md +182 -0
- package/docs/guides/streaming.md +137 -0
- package/docs/migration/README.md +15 -0
- package/docs/migration/route-to-flow.md +560 -0
- package/docs/migration/v1-to-v2.md +909 -0
- package/docs/reference/adapters.md +481 -0
- package/docs/reference/branches.md +241 -0
- package/docs/reference/create-agent.md +186 -0
- package/docs/reference/directive.md +243 -0
- package/docs/reference/errors.md +122 -0
- package/docs/reference/flow.md +238 -0
- package/docs/reference/instruction.md +177 -0
- package/docs/reference/pre-directive.md +131 -0
- package/docs/reference/providers.md +227 -0
- package/docs/reference/signals.md +356 -0
- package/docs/reference/step.md +339 -0
- package/docs/reference/tool.md +269 -0
- package/docs/start/01-install.md +81 -0
- package/docs/start/02-first-agent.md +196 -0
- package/docs/start/03-collect-data.md +222 -0
- package/docs/start/04-add-tools.md +276 -0
- package/docs/start/05-go-to-production.md +216 -0
- package/examples/01-quickstart.ts +20 -0
- package/examples/02-data-extraction.ts +90 -0
- package/examples/03-tools.ts +136 -0
- package/examples/04-instructions.ts +100 -0
- package/examples/05-branching.ts +140 -0
- package/examples/06-flow-control.ts +103 -0
- package/examples/07-streaming.ts +69 -0
- package/examples/08-persistence.ts +98 -0
- package/examples/09-signals.ts +144 -0
- package/examples/tsconfig.json +30 -0
- package/package.json +2 -1
- package/src/adapters/MemoryAdapter.ts +3 -3
- package/src/adapters/MongoAdapter.ts +3 -3
- package/src/adapters/OpenSearchAdapter.ts +10 -8
- package/src/adapters/PostgreSQLAdapter.ts +26 -10
- package/src/adapters/PrismaAdapter.ts +6 -6
- package/src/adapters/RedisAdapter.ts +3 -3
- package/src/adapters/SQLiteAdapter.ts +31 -12
- package/src/constants/index.ts +2 -10
- package/src/core/Agent.ts +585 -374
- package/src/core/AutoChainExecutor.ts +440 -0
- package/src/core/BranchEvaluator.ts +167 -0
- package/src/core/DirectiveBus.ts +248 -0
- package/src/core/DirectiveChainTracker.ts +144 -0
- package/src/core/Flow.ts +666 -0
- package/src/core/{RoutingEngine.ts → FlowRouter.ts} +385 -365
- package/src/core/PersistenceManager.ts +8 -8
- package/src/core/PromptComposer.ts +209 -140
- package/src/core/PromptSectionCache.ts +1 -1
- package/src/core/ResponseEngine.ts +61 -46
- package/src/core/ResponseModal.ts +1458 -1241
- package/src/core/ResponsePipeline.ts +675 -173
- package/src/core/SignalEvaluator.ts +420 -0
- package/src/core/SignalProcessor.ts +723 -0
- package/src/core/Step.ts +279 -176
- package/src/core/StreamingToolExecutor.ts +4 -4
- package/src/core/ToolManager.ts +200 -97
- package/src/core/createAgent.ts +40 -0
- package/src/core/flow-namespace.ts +219 -0
- package/src/index.ts +42 -36
- package/src/providers/GeminiProvider.ts +17 -15
- package/src/types/agent.ts +182 -53
- package/src/types/ai.ts +3 -3
- package/src/types/errors.ts +18 -0
- package/src/types/flow.ts +590 -0
- package/src/types/index.ts +43 -16
- package/src/types/persistence.ts +12 -8
- package/src/types/routing.ts +1 -1
- package/src/types/session.ts +26 -23
- package/src/types/signals.ts +321 -0
- package/src/types/template.ts +3 -11
- package/src/types/tool.ts +50 -42
- package/src/utils/condition.ts +13 -4
- package/src/utils/id.ts +27 -9
- package/src/utils/index.ts +6 -2
- package/src/utils/session.ts +238 -42
- package/dist/cjs/core/BatchExecutor.d.ts +0 -359
- package/dist/cjs/core/BatchExecutor.d.ts.map +0 -1
- package/dist/cjs/core/BatchExecutor.js +0 -861
- package/dist/cjs/core/BatchExecutor.js.map +0 -1
- package/dist/cjs/core/BatchPromptBuilder.d.ts +0 -89
- package/dist/cjs/core/BatchPromptBuilder.d.ts.map +0 -1
- package/dist/cjs/core/BatchPromptBuilder.js +0 -223
- package/dist/cjs/core/BatchPromptBuilder.js.map +0 -1
- package/dist/cjs/core/Route.d.ts +0 -180
- package/dist/cjs/core/Route.d.ts.map +0 -1
- package/dist/cjs/core/Route.js +0 -542
- package/dist/cjs/core/Route.js.map +0 -1
- package/dist/cjs/core/RoutingEngine.d.ts +0 -185
- package/dist/cjs/core/RoutingEngine.d.ts.map +0 -1
- package/dist/cjs/core/RoutingEngine.js.map +0 -1
- package/dist/cjs/types/route.d.ts +0 -336
- package/dist/cjs/types/route.d.ts.map +0 -1
- package/dist/cjs/types/route.js.map +0 -1
- package/dist/core/BatchExecutor.d.ts +0 -359
- package/dist/core/BatchExecutor.d.ts.map +0 -1
- package/dist/core/BatchExecutor.js +0 -856
- package/dist/core/BatchExecutor.js.map +0 -1
- package/dist/core/BatchPromptBuilder.d.ts +0 -89
- package/dist/core/BatchPromptBuilder.d.ts.map +0 -1
- package/dist/core/BatchPromptBuilder.js +0 -219
- package/dist/core/BatchPromptBuilder.js.map +0 -1
- package/dist/core/Route.d.ts +0 -180
- package/dist/core/Route.d.ts.map +0 -1
- package/dist/core/Route.js +0 -538
- package/dist/core/Route.js.map +0 -1
- package/dist/core/RoutingEngine.d.ts +0 -185
- package/dist/core/RoutingEngine.d.ts.map +0 -1
- package/dist/core/RoutingEngine.js.map +0 -1
- package/dist/types/route.d.ts +0 -336
- package/dist/types/route.d.ts.map +0 -1
- package/dist/types/route.js +0 -5
- package/dist/types/route.js.map +0 -1
- package/docs/CONTRIBUTING.md +0 -521
- package/docs/api/README.md +0 -3299
- package/docs/api/overview.md +0 -1410
- package/docs/architecture/data-extraction-flow.md +0 -360
- package/docs/architecture/multi-step-execution.md +0 -277
- package/docs/core/agent/README.md +0 -938
- package/docs/core/agent/context-management.md +0 -796
- package/docs/core/agent/rules-and-prohibitions.md +0 -113
- package/docs/core/agent/session-management.md +0 -693
- package/docs/core/ai-integration/prompt-composition.md +0 -355
- package/docs/core/ai-integration/providers.md +0 -515
- package/docs/core/ai-integration/response-processing.md +0 -433
- package/docs/core/conversation-flows/data-collection.md +0 -772
- package/docs/core/conversation-flows/route-dsl.md +0 -509
- package/docs/core/conversation-flows/routes.md +0 -249
- package/docs/core/conversation-flows/step-transitions.md +0 -731
- package/docs/core/conversation-flows/steps.md +0 -268
- package/docs/core/error-handling.md +0 -830
- package/docs/core/persistence/adapters.md +0 -255
- package/docs/core/persistence/session-storage.md +0 -656
- package/docs/core/routing/intelligent-routing.md +0 -470
- package/docs/core/tools/enhanced-tool.md +0 -186
- package/docs/core/tools/streaming-execution.md +0 -161
- package/docs/core/tools/tool-definition.md +0 -970
- package/docs/core/tools/tool-scoping.md +0 -819
- package/docs/guides/advanced-patterns/publishing.md +0 -186
- package/docs/guides/context-compaction.md +0 -96
- package/docs/guides/error-handling-patterns.md +0 -578
- package/docs/guides/getting-started/README.md +0 -795
- package/docs/guides/migration/README.md +0 -101
- package/docs/guides/migration/flexible-routing-conditions.md +0 -375
- package/docs/guides/migration/multi-step-execution.md +0 -393
- package/docs/guides/migration/response-modal-refactor.md +0 -518
- package/docs/guides/prompt-optimization.md +0 -164
- package/examples/advanced-patterns/context-compaction.ts +0 -223
- package/examples/advanced-patterns/knowledge-based-agent.ts +0 -735
- package/examples/advanced-patterns/persistent-onboarding.ts +0 -728
- package/examples/advanced-patterns/route-lifecycle-hooks.ts +0 -556
- package/examples/advanced-patterns/streaming-responses.ts +0 -656
- package/examples/ai-providers/anthropic-integration.ts +0 -388
- package/examples/ai-providers/openai-integration.ts +0 -228
- package/examples/condition-patterns/function-only-conditions.ts +0 -365
- package/examples/condition-patterns/mixed-array-conditions.ts +0 -477
- package/examples/condition-patterns/route-skipif-patterns.ts +0 -468
- package/examples/condition-patterns/step-skipif-patterns.ts +0 -0
- package/examples/condition-patterns/string-only-conditions.ts +0 -296
- package/examples/conversation-flows/completion-transitions.ts +0 -318
- package/examples/core-concepts/basic-agent.ts +0 -503
- package/examples/core-concepts/modern-streaming-api.ts +0 -309
- package/examples/core-concepts/schema-driven-extraction.ts +0 -332
- package/examples/core-concepts/session-management.ts +0 -494
- package/examples/integrations/database-integration.ts +0 -631
- package/examples/integrations/healthcare-integration.ts +0 -595
- package/examples/integrations/search-integration.ts +0 -530
- package/examples/integrations/server-session-management.ts +0 -307
- package/examples/persistence/custom-adapter.ts +0 -526
- package/examples/persistence/database-persistence.ts +0 -583
- package/examples/persistence/memory-sessions.ts +0 -495
- package/examples/persistence/prisma-schema.example.prisma +0 -74
- package/examples/persistence/redis-persistence.ts +0 -488
- package/examples/tools/basic-tools.ts +0 -765
- package/examples/tools/data-enrichment-tools.ts +0 -593
- package/examples/tools/enhanced-tool-metadata.ts +0 -268
- package/examples/tools/streaming-tool-execution.ts +0 -283
- package/src/core/BatchExecutor.ts +0 -1187
- package/src/core/BatchPromptBuilder.ts +0 -299
- package/src/core/Route.ts +0 -678
- package/src/types/route.ts +0 -392
package/dist/cjs/core/Agent.d.ts
CHANGED
|
@@ -1,14 +1,15 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Core Agent implementation
|
|
3
3
|
*/
|
|
4
|
-
import type { AgentOptions, Term,
|
|
5
|
-
import {
|
|
4
|
+
import type { AgentOptions, Term, Instruction, Tool, FlowOptions, SessionState, Template, AgentResponseStreamChunk, AgentResponse, StructuredSchema, ValidationResult, AiProvider, CompactionOptions, Directive } from "../types";
|
|
5
|
+
import type { Signal } from "../types/signals";
|
|
6
|
+
import { SignalProcessor } from "./SignalProcessor";
|
|
6
7
|
import type { StreamOptions, GenerateOptions, RespondParams } from "./ResponseModal";
|
|
7
|
-
import {
|
|
8
|
+
import { Flow } from "./Flow";
|
|
8
9
|
import { Step } from "./Step";
|
|
9
10
|
import { PersistenceManager } from "./PersistenceManager";
|
|
10
11
|
import { SessionManager } from "./SessionManager";
|
|
11
|
-
import {
|
|
12
|
+
import { FlowRouter } from "./FlowRouter";
|
|
12
13
|
import { PromptSectionCache } from "./PromptSectionCache";
|
|
13
14
|
import { ToolManager } from "./ToolManager";
|
|
14
15
|
/**
|
|
@@ -17,11 +18,9 @@ import { ToolManager } from "./ToolManager";
|
|
|
17
18
|
export declare class Agent<TContext = any, TData = any> {
|
|
18
19
|
private options;
|
|
19
20
|
private _terms;
|
|
20
|
-
private
|
|
21
|
+
private _instructions;
|
|
21
22
|
private _tools;
|
|
22
|
-
private
|
|
23
|
-
private _rules;
|
|
24
|
-
private _prohibitions;
|
|
23
|
+
private _flows;
|
|
25
24
|
private _context;
|
|
26
25
|
private _persistenceManager;
|
|
27
26
|
private _routingEngine;
|
|
@@ -32,6 +31,17 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
32
31
|
private _collectedData;
|
|
33
32
|
private _compactionOptions?;
|
|
34
33
|
private _promptSectionCache;
|
|
34
|
+
/** Signals: typed event detectors that run around the LLM turn. */
|
|
35
|
+
private _signals;
|
|
36
|
+
/**
|
|
37
|
+
* Signal processor instance. Undefined when no signals are configured.
|
|
38
|
+
* Constructed only when `options.signals` is non-empty (Requirement 2.3).
|
|
39
|
+
*/
|
|
40
|
+
signalProcessor: SignalProcessor<TContext, TData> | undefined;
|
|
41
|
+
/** Maximum consecutive auto-steps allowed in a single turn before throwing. */
|
|
42
|
+
readonly maxAutoStepsPerTurn: number;
|
|
43
|
+
/** Maximum chained directives allowed in a single turn before throwing. */
|
|
44
|
+
readonly maxDirectiveChain: number;
|
|
35
45
|
/** Public session manager for easy session management */
|
|
36
46
|
session: SessionManager<TData>;
|
|
37
47
|
/** Public tool manager for simplified tool creation and management */
|
|
@@ -42,6 +52,29 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
42
52
|
* @private
|
|
43
53
|
*/
|
|
44
54
|
private validateSchema;
|
|
55
|
+
/**
|
|
56
|
+
* Walk every flow's steps and resolve deferred string `then` values in branches
|
|
57
|
+
* against the agent's flow registry. Strings that match neither a local step id
|
|
58
|
+
* nor any flow id/title throw FlowConfigurationError.
|
|
59
|
+
* @private
|
|
60
|
+
*/
|
|
61
|
+
private validateBranchReferences;
|
|
62
|
+
/**
|
|
63
|
+
* Validate branch `then` string references for a single flow against the agent's
|
|
64
|
+
* flow registry. Throws FlowConfigurationError for unresolved references.
|
|
65
|
+
* @private
|
|
66
|
+
*/
|
|
67
|
+
private validateFlowBranchReferences;
|
|
68
|
+
/**
|
|
69
|
+
* Validate that every step's `collect` fields in a flow reference valid keys
|
|
70
|
+
* from the agent-level schema. Throws FlowConfigurationError at construction
|
|
71
|
+
* time if any collect field is not a valid schema key.
|
|
72
|
+
*
|
|
73
|
+
* This enforces Requirement 14.5: generic inference is preserved AND every
|
|
74
|
+
* `collect` field reference is a valid key of the inferred TData.
|
|
75
|
+
* @private
|
|
76
|
+
*/
|
|
77
|
+
private validateFlowCollectFields;
|
|
45
78
|
/**
|
|
46
79
|
* Validate data against the agent-level schema
|
|
47
80
|
*/
|
|
@@ -69,13 +102,13 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
69
102
|
*/
|
|
70
103
|
set name(value: string);
|
|
71
104
|
/**
|
|
72
|
-
* Get agent
|
|
105
|
+
* Get agent persona
|
|
73
106
|
*/
|
|
74
|
-
get
|
|
107
|
+
get persona(): Template<TContext> | undefined;
|
|
75
108
|
/**
|
|
76
|
-
* Set agent
|
|
109
|
+
* Set agent persona
|
|
77
110
|
*/
|
|
78
|
-
set
|
|
111
|
+
set persona(value: Template<TContext> | undefined);
|
|
79
112
|
/**
|
|
80
113
|
* Get agent goal
|
|
81
114
|
*/
|
|
@@ -84,22 +117,6 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
84
117
|
* Set agent goal
|
|
85
118
|
*/
|
|
86
119
|
set goal(value: string | undefined);
|
|
87
|
-
/**
|
|
88
|
-
* Get agent identity
|
|
89
|
-
*/
|
|
90
|
-
get identity(): Template<TContext> | undefined;
|
|
91
|
-
/**
|
|
92
|
-
* Set agent identity
|
|
93
|
-
*/
|
|
94
|
-
set identity(value: Template<TContext> | undefined);
|
|
95
|
-
/**
|
|
96
|
-
* Get agent personality
|
|
97
|
-
*/
|
|
98
|
-
get personality(): Template<TContext> | undefined;
|
|
99
|
-
/**
|
|
100
|
-
* Set agent personality
|
|
101
|
-
*/
|
|
102
|
-
set personality(value: Template<TContext> | undefined);
|
|
103
120
|
/**
|
|
104
121
|
* Get whether debug mode is enabled
|
|
105
122
|
*/
|
|
@@ -117,67 +134,34 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
117
134
|
*/
|
|
118
135
|
set provider(value: AiProvider);
|
|
119
136
|
/**
|
|
120
|
-
* Get the
|
|
121
|
-
*/
|
|
122
|
-
get compositionMode(): CompositionMode;
|
|
123
|
-
/**
|
|
124
|
-
* Set the composition mode
|
|
125
|
-
*/
|
|
126
|
-
set compositionMode(value: CompositionMode);
|
|
127
|
-
/**
|
|
128
|
-
* Get the route switch margin
|
|
137
|
+
* Get the flow switch margin
|
|
129
138
|
* @default 15
|
|
130
139
|
*/
|
|
131
|
-
get
|
|
140
|
+
get flowSwitchMargin(): number;
|
|
132
141
|
/**
|
|
133
|
-
* Set the
|
|
142
|
+
* Set the flow switch margin
|
|
134
143
|
*/
|
|
135
|
-
set
|
|
144
|
+
set flowSwitchMargin(value: number);
|
|
136
145
|
/**
|
|
137
146
|
* Get the prompt section cache instance
|
|
138
147
|
*/
|
|
139
148
|
get promptSectionCache(): PromptSectionCache;
|
|
140
|
-
/**
|
|
141
|
-
* Get the maximum steps per batch
|
|
142
|
-
* @default 1
|
|
143
|
-
*/
|
|
144
|
-
get maxStepsPerBatch(): number;
|
|
145
|
-
/**
|
|
146
|
-
* Set the maximum steps per batch
|
|
147
|
-
*/
|
|
148
|
-
set maxStepsPerBatch(value: number);
|
|
149
149
|
/**
|
|
150
150
|
* Get all terms
|
|
151
151
|
*/
|
|
152
152
|
get terms(): Term<TContext, TData>[];
|
|
153
153
|
/**
|
|
154
|
-
* Get all
|
|
154
|
+
* Get all instructions
|
|
155
155
|
*/
|
|
156
|
-
get
|
|
156
|
+
get instructions(): Instruction<TContext, TData>[];
|
|
157
157
|
/**
|
|
158
158
|
* Get all tools
|
|
159
159
|
*/
|
|
160
160
|
get tools(): Tool<TContext, TData>[];
|
|
161
161
|
/**
|
|
162
|
-
* Get all
|
|
163
|
-
*/
|
|
164
|
-
get routes(): Route<TContext, TData>[];
|
|
165
|
-
/**
|
|
166
|
-
* Get agent-level rules
|
|
162
|
+
* Get all flows
|
|
167
163
|
*/
|
|
168
|
-
get
|
|
169
|
-
/**
|
|
170
|
-
* Set agent-level rules
|
|
171
|
-
*/
|
|
172
|
-
set rules(value: Template<TContext, TData>[]);
|
|
173
|
-
/**
|
|
174
|
-
* Get agent-level prohibitions
|
|
175
|
-
*/
|
|
176
|
-
get prohibitions(): Template<TContext, TData>[];
|
|
177
|
-
/**
|
|
178
|
-
* Set agent-level prohibitions
|
|
179
|
-
*/
|
|
180
|
-
set prohibitions(value: Template<TContext, TData>[]);
|
|
164
|
+
get flows(): Flow<TContext, TData>[];
|
|
181
165
|
/**
|
|
182
166
|
* Get current schema
|
|
183
167
|
*/
|
|
@@ -186,6 +170,10 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
186
170
|
* Set schema (validates structure)
|
|
187
171
|
*/
|
|
188
172
|
set schema(value: StructuredSchema | undefined);
|
|
173
|
+
/**
|
|
174
|
+
* Get the configured signals.
|
|
175
|
+
*/
|
|
176
|
+
get signals(): Signal<TContext, TData, any>[];
|
|
189
177
|
/**
|
|
190
178
|
* Get the agent's knowledge base
|
|
191
179
|
*/
|
|
@@ -203,67 +191,27 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
203
191
|
* Set to undefined to clear the current session
|
|
204
192
|
*/
|
|
205
193
|
set currentSession(value: SessionState | undefined);
|
|
194
|
+
/**
|
|
195
|
+
* Get all flows
|
|
196
|
+
*/
|
|
197
|
+
getFlows(): Flow<TContext, TData>[];
|
|
206
198
|
/**
|
|
207
199
|
* Get all terms
|
|
208
|
-
* @deprecated Use `agent.terms` instead
|
|
209
200
|
*/
|
|
210
201
|
getTerms(): Term<TContext, TData>[];
|
|
211
202
|
/**
|
|
212
203
|
* Get all tools
|
|
213
|
-
* @deprecated Use `agent.tools` instead
|
|
214
204
|
*/
|
|
215
205
|
getTools(): Tool<TContext, TData>[];
|
|
216
206
|
/**
|
|
217
|
-
* Get all
|
|
218
|
-
* @deprecated Use `agent.guidelines` instead
|
|
207
|
+
* Get all instructions
|
|
219
208
|
*/
|
|
220
|
-
|
|
209
|
+
getInstructions(): Instruction<TContext, TData>[];
|
|
221
210
|
/**
|
|
222
|
-
*
|
|
223
|
-
*
|
|
211
|
+
* Invalidate flow-dependent prompt cache sections.
|
|
212
|
+
* Called automatically when the active flow changes.
|
|
224
213
|
*/
|
|
225
|
-
|
|
226
|
-
/**
|
|
227
|
-
* Get agent-level rules
|
|
228
|
-
* @deprecated Use `agent.rules` instead
|
|
229
|
-
*/
|
|
230
|
-
getRules(): Template<TContext, TData>[];
|
|
231
|
-
/**
|
|
232
|
-
* Get agent-level prohibitions
|
|
233
|
-
* @deprecated Use `agent.prohibitions` instead
|
|
234
|
-
*/
|
|
235
|
-
getProhibitions(): Template<TContext, TData>[];
|
|
236
|
-
/**
|
|
237
|
-
* Get current schema
|
|
238
|
-
* @deprecated Use `agent.schema` instead
|
|
239
|
-
*/
|
|
240
|
-
getSchema(): StructuredSchema | undefined;
|
|
241
|
-
/**
|
|
242
|
-
* Get the agent's knowledge base
|
|
243
|
-
* @deprecated Use `agent.knowledgeBase` instead
|
|
244
|
-
*/
|
|
245
|
-
getKnowledgeBase(): Record<string, unknown>;
|
|
246
|
-
/**
|
|
247
|
-
* Get the current session (if set)
|
|
248
|
-
* @deprecated Use `agent.currentSession` instead
|
|
249
|
-
*/
|
|
250
|
-
getCurrentSession(): SessionState | undefined;
|
|
251
|
-
/**
|
|
252
|
-
* Set the current session for convenience methods
|
|
253
|
-
* @deprecated Use `agent.currentSession = session` instead
|
|
254
|
-
* @param session - Session step to use for subsequent calls
|
|
255
|
-
*/
|
|
256
|
-
setCurrentSession(session: SessionState): void;
|
|
257
|
-
/**
|
|
258
|
-
* Clear the current session
|
|
259
|
-
* @deprecated Use `agent.currentSession = undefined` instead
|
|
260
|
-
*/
|
|
261
|
-
clearCurrentSession(): void;
|
|
262
|
-
/**
|
|
263
|
-
* Invalidate route-dependent prompt cache sections.
|
|
264
|
-
* Called automatically when the active route changes.
|
|
265
|
-
*/
|
|
266
|
-
invalidateRouteSections(): void;
|
|
214
|
+
invalidateFlowSections(): void;
|
|
267
215
|
/**
|
|
268
216
|
* Get the persistence manager (if configured)
|
|
269
217
|
*/
|
|
@@ -277,39 +225,34 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
277
225
|
*/
|
|
278
226
|
getCompactionOptions(): CompactionOptions | undefined;
|
|
279
227
|
/**
|
|
280
|
-
* Create a new
|
|
228
|
+
* Create a new flow (journey) using agent-level data type
|
|
281
229
|
*/
|
|
282
|
-
|
|
230
|
+
createFlow(options: FlowOptions<TContext, TData>): Flow<TContext, TData>;
|
|
283
231
|
/**
|
|
284
232
|
* Create a domain term for the glossary
|
|
285
233
|
*/
|
|
286
234
|
createTerm(term: Term<TContext, TData>): this;
|
|
287
235
|
/**
|
|
288
|
-
* Create
|
|
236
|
+
* Create an instruction (unified behavioral primitive).
|
|
289
237
|
*/
|
|
290
|
-
|
|
238
|
+
createInstruction(instruction: Instruction<TContext, TData>): this;
|
|
291
239
|
/**
|
|
292
240
|
* Add a tool to the agent using the unified Tool interface
|
|
293
|
-
* Creates and adds the tool to agent scope in one operation
|
|
241
|
+
* Creates and adds the tool to agent scope in one operation
|
|
294
242
|
*/
|
|
295
243
|
addTool<TResult = any>(tool: Tool<TContext, TData, TResult>): this;
|
|
296
|
-
/**
|
|
297
|
-
* Register a tool at the agent level (legacy method for backward compatibility)
|
|
298
|
-
* @deprecated Use addTool() with Tool interface instead
|
|
299
|
-
*/
|
|
300
|
-
createTool<TResult = any>(tool: Tool<TContext, TData, TResult>): this;
|
|
301
244
|
/**
|
|
302
245
|
* Register multiple tools at the agent level
|
|
303
246
|
*/
|
|
304
247
|
registerTools<TResult = any>(tools: Tool<TContext, TData, TResult>[]): this;
|
|
305
248
|
/**
|
|
306
249
|
* Update the agent's context
|
|
307
|
-
* Triggers both agent-level and
|
|
250
|
+
* Triggers both agent-level and flow-specific onContextUpdate lifecycle hooks if configured
|
|
308
251
|
*/
|
|
309
252
|
updateContext(updates: Partial<TContext>): Promise<void>;
|
|
310
253
|
/**
|
|
311
254
|
* Update collected data in session with lifecycle hook support
|
|
312
|
-
* Triggers both agent-level and
|
|
255
|
+
* Triggers both agent-level and flow-specific onDataUpdate lifecycle hooks if configured
|
|
313
256
|
* @internal
|
|
314
257
|
*/
|
|
315
258
|
private updateData;
|
|
@@ -331,25 +274,20 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
331
274
|
*/
|
|
332
275
|
getAgentOptions(): AgentOptions<TContext, TData>;
|
|
333
276
|
/**
|
|
334
|
-
* Get
|
|
277
|
+
* Get flow router
|
|
335
278
|
* @internal Used by ResponseModal
|
|
336
279
|
*/
|
|
337
|
-
|
|
280
|
+
getFlowRouter(): FlowRouter<TContext, TData>;
|
|
338
281
|
/**
|
|
339
282
|
* Get the updateData method bound to this agent
|
|
340
283
|
* @internal Used by ResponseModal
|
|
341
284
|
*/
|
|
342
285
|
getUpdateDataMethod(): (session: SessionState<TData>, dataUpdate: Partial<TData>) => Promise<SessionState<TData>>;
|
|
343
|
-
/**
|
|
344
|
-
* Evaluate and match active guidelines based on their conditions
|
|
345
|
-
* Returns guidelines that should be active given the current context
|
|
346
|
-
*/
|
|
347
|
-
evaluateGuidelines(context?: TContext, session?: SessionState<TData>, history?: Event[]): Promise<GuidelineMatch<TContext, TData>[]>;
|
|
348
286
|
/**
|
|
349
287
|
* Execute a prepare or finalize function/tool
|
|
350
288
|
* @internal Used by ResponseModal
|
|
351
289
|
*/
|
|
352
|
-
executePrepareFinalize(prepareOrFinalize: string | Tool<TContext, TData> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>) | undefined, context: TContext, data?: Partial<TData>,
|
|
290
|
+
executePrepareFinalize(prepareOrFinalize: string | Tool<TContext, TData> | ((context: TContext, data?: Partial<TData>) => void | Promise<void>) | undefined, context: TContext, data?: Partial<TData>, flow?: Flow<TContext, TData>, step?: Step<TContext, TData>): Promise<void>;
|
|
353
291
|
/**
|
|
354
292
|
* Sync session data to agent collected data
|
|
355
293
|
* @internal Used to keep agent and session data in sync
|
|
@@ -357,28 +295,56 @@ export declare class Agent<TContext = any, TData = any> {
|
|
|
357
295
|
private syncSessionDataToCollectedData;
|
|
358
296
|
/**
|
|
359
297
|
* Get collected data from current session or agent-level collected data
|
|
360
|
-
* @param routeId - Optional route ID to get data for (uses current route if not provided)
|
|
361
298
|
* @returns The collected data from the current session or agent-level data
|
|
362
299
|
*/
|
|
363
300
|
getData(): Partial<TData>;
|
|
364
301
|
/**
|
|
365
|
-
*
|
|
366
|
-
* Sets
|
|
302
|
+
* Dispatch a directive (or a flow shorthand) into a session.
|
|
303
|
+
* Sets `pendingDirective` on the session without triggering a `respond()` call.
|
|
304
|
+
* The directive will be applied at the start of the next turn.
|
|
305
|
+
*
|
|
306
|
+
* String form desugars to `{ goTo: target }`.
|
|
367
307
|
*
|
|
368
|
-
* @param
|
|
369
|
-
* @param session - Session
|
|
370
|
-
* @
|
|
371
|
-
*
|
|
308
|
+
* @param target - Flow ID/title string (desugars to `{ goTo: target }`) or a full Directive
|
|
309
|
+
* @param session - Session to update (uses current session if not provided)
|
|
310
|
+
* @returns Updated session with `pendingDirective` set
|
|
311
|
+
*
|
|
312
|
+
* @throws FlowConfigurationError if the string target doesn't match any flow
|
|
313
|
+
* @throws FlowConfigurationError if the directive fails validation
|
|
314
|
+
*
|
|
315
|
+
* @example
|
|
316
|
+
* // String shorthand — desugars to { goTo: 'Feedback' }
|
|
317
|
+
* const updated = await agent.dispatch('Feedback', session);
|
|
372
318
|
*
|
|
373
319
|
* @example
|
|
374
|
-
* //
|
|
375
|
-
*
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
*
|
|
380
|
-
|
|
381
|
-
|
|
320
|
+
* // Full directive
|
|
321
|
+
* const updated = await agent.dispatch({ goTo: 'Billing', reply: 'Transferring you now.' }, session);
|
|
322
|
+
*/
|
|
323
|
+
dispatch(target: string | Directive<TContext, TData>, session?: SessionState<TData>): Promise<SessionState<TData>>;
|
|
324
|
+
/**
|
|
325
|
+
* Apply a directive synchronously to a session without invoking `respond()`.
|
|
326
|
+
* Performs in-place application: updates flow/step position, merges state writes.
|
|
327
|
+
*
|
|
328
|
+
* This is the synchronous counterpart to `dispatch` — it applies immediately
|
|
329
|
+
* rather than deferring to the next turn.
|
|
330
|
+
*
|
|
331
|
+
* @param directive - The directive to apply
|
|
332
|
+
* @param session - The session to apply the directive to
|
|
333
|
+
* @returns The updated session with the directive applied
|
|
334
|
+
*/
|
|
335
|
+
applyDirective(directive: Directive<TContext, TData>, session: SessionState<TData>): SessionState<TData>;
|
|
336
|
+
/**
|
|
337
|
+
* Validate a directive for structural correctness.
|
|
338
|
+
* Throws FlowConfigurationError for invalid combinations.
|
|
339
|
+
* @private
|
|
340
|
+
*/
|
|
341
|
+
private validateDirective;
|
|
342
|
+
/**
|
|
343
|
+
* Strip PreDirective-only fields (appendPrompt, injectTools, halt) from a directive.
|
|
344
|
+
* These fields are transient (one-turn lifetime) and must not be persisted.
|
|
345
|
+
* @private
|
|
346
|
+
*/
|
|
347
|
+
private stripPreDirectiveFields;
|
|
382
348
|
/**
|
|
383
349
|
* Simplified respond method using SessionManager
|
|
384
350
|
* Automatically manages conversation history through the session
|
|
@@ -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,
|
|
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,WAAW,EACX,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAEhB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,SAAS,EACV,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWrF,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAwD,MAAM,QAAQ,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAuB5C;;GAEG;AAEH,qBAAa,KAAK,CAAC,QAAQ,GAAG,GAAG,EAAE,KAAK,GAAG,GAAG;IAsChC,OAAO,CAAC,OAAO;IArC3B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,mBAAmB,CAAwC;IACnE,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,eAAe,CAAC,CAAsB;IAC9C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,OAAO,CAAC,CAAmB;IACnC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,kBAAkB,CAAC,CAAoB;IAC/C,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,mEAAmE;IAEnE,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;;OAGG;IACI,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC;IAErE,+EAA+E;IAC/E,SAAgB,mBAAmB,EAAE,MAAM,CAAC;IAE5C,2EAA2E;IAC3E,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAE1C,yDAAyD;IAClD,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtC,sEAAsE;IAC/D,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAEtB,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;IA0P1D;;;OAGG;IACH,OAAO,CAAC,cAAc;IAyBtB;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;;;OAIG;IACH,OAAO,CAAC,4BAA4B;IA4BpC;;;;;;;;OAQG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,gBAAgB;IA4CpD;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,OAAO;IAS/C;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,KAAK,CAAC;IAMlC;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDjE;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,SAAS,CAE5C;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,SAAS,EAEhD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED;;OAEG;IACH,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEjC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAGvB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,UAAU,CAEzB;IAED;;OAEG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,UAAU,EAE7B;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAEjC;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,kBAAkB,CAE3C;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAEnC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAEjD;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAEnC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAEnC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,gBAAgB,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAI,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAK7C;IAED;;OAEG;IAEH,IAAI,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAE5C;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE3C;IAED;;OAEG;IACH,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAE/C;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,YAAY,GAAG,SAAS,CAE7C;IAED;;;OAGG;IACH,IAAI,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAGjD;IAED;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;IAInC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;IAInC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;IAInC;;OAEG;IACH,eAAe,IAAI,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;IAIjD;;;OAGG;IACH,sBAAsB,IAAI,IAAI;IAM9B;;OAEG;IACH,qBAAqB,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG,SAAS;IAI9D;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,oBAAoB,IAAI,iBAAiB,GAAG,SAAS;IAQrD;;OAEG;IACH,UAAU,CACR,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,GACpC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC;IA0CxB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,IAAI;IAK7C;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,IAAI;IAYlE;;;OAGG;IAEH,OAAO,CAAC,OAAO,GAAG,GAAG,EACnB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,GACnC,IAAI;IAYP;;OAEG;IAEH,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAY3E;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC9D;;;;OAIG;YACW,UAAU;IAwCxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAUjD;;OAEG;IACK,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAK9G;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAKpF;;;OAGG;IACH,eAAe,IAAI,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;IAIhD;;;OAGG;IACH,aAAa,IAAI,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC;IAI5C;;;OAGG;IACH,mBAAmB,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAIjH;;;OAGG;IACG,sBAAsB,CAC1B,iBAAiB,EACb,MAAM,GACN,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GACrB,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACpE,SAAS,EACb,OAAO,EAAE,QAAQ,EACjB,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,EACrB,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAC5B,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC;IAmDhB;;;OAGG;IACH,OAAO,CAAC,8BAA8B;IAQtC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAezB;;;;;;;;;;;;;;;;;;;;;OAqBG;IAEG,QAAQ,CACZ,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,EAC3C,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,GAC5B,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAmE/B;;;;;;;;;;OAUG;IACH,cAAc,CACZ,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,EACrC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B,YAAY,CAAC,KAAK,CAAC;IA+ItB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;;OAGG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAKhC;;;OAGG;IACK,MAAM,CACZ,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,GAChC,cAAc,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;CAQnD"}
|