dyna-ai-gateway 0.0.1-beta.7 → 0.0.13-beta.9
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/CHANGELOG.md +52 -1
- package/README.md +294 -19
- package/dist/AIGateway.d.ts +1 -1
- package/dist/contracts/types.d.ts +29 -1
- package/dist/contracts/types.d.ts.map +1 -1
- package/dist/index.js +188 -98
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +190 -99
- package/dist/index.mjs.map +1 -1
- package/dist/internal/ai-profile-store/types.d.ts +1 -1
- package/dist/internal/context-assembler/ContextAssembler.d.ts +1 -1
- package/dist/internal/context-assembler/types.d.ts +3 -3
- package/dist/internal/context-assembler/types.d.ts.map +1 -1
- package/dist/internal/human-gate/makeAskUserQuestionTool.d.ts +1 -3
- package/dist/internal/human-gate/makeAskUserQuestionTool.d.ts.map +1 -1
- package/dist/internal/human-gate/types.d.ts +3 -3
- package/dist/internal/human-gate/types.d.ts.map +1 -1
- package/dist/internal/human-gate/utils/makePauseEnvelopeDraft.d.ts +2 -2
- package/dist/internal/human-gate/utils/makePauseEnvelopeDraft.d.ts.map +1 -1
- package/dist/internal/run-store/types.d.ts +1 -1
- package/dist/internal/run-store/types.d.ts.map +1 -1
- package/dist/internal/skill-registry/SkillRegistry.d.ts +7 -7
- package/dist/internal/skill-registry/SkillRegistry.d.ts.map +1 -1
- package/dist/internal/skill-registry/index.d.ts +0 -1
- package/dist/internal/skill-registry/index.d.ts.map +1 -1
- package/dist/internal/skill-registry/types.d.ts +7 -7
- package/dist/internal/skill-registry/types.d.ts.map +1 -1
- package/dist/internal/tool-policy/ToolPolicy.d.ts +1 -1
- package/dist/internal/tool-policy/ToolPolicy.d.ts.map +1 -1
- package/dist/internal/tool-policy/types.d.ts +1 -1
- package/dist/internal/tool-registry/assertAppToolNames.d.ts +27 -0
- package/dist/internal/tool-registry/assertAppToolNames.d.ts.map +1 -0
- package/dist/internal/tool-registry/index.d.ts +1 -0
- package/dist/internal/tool-registry/index.d.ts.map +1 -1
- package/dist/internal/user-memory-store/UserMemoryStore.d.ts +2 -2
- package/dist/internal/user-memory-store/makeUserMemoryTools.d.ts +3 -8
- package/dist/internal/user-memory-store/makeUserMemoryTools.d.ts.map +1 -1
- package/dist/internal/user-memory-store/types.d.ts +5 -5
- package/dist/orchestration/createGatewayDeps.d.ts +2 -2
- package/dist/orchestration/createGatewayDeps.d.ts.map +1 -1
- package/dist/orchestration/getBuiltInToolNames.d.ts +3 -3
- package/dist/orchestration/getBuiltInToolNames.d.ts.map +1 -1
- package/dist/orchestration/prepareCall.d.ts +1 -1
- package/dist/orchestration/splitRunTools.d.ts +3 -2
- package/dist/orchestration/splitRunTools.d.ts.map +1 -1
- package/dist/types.d.ts +2 -2
- package/package.json +1 -1
- package/dist/internal/skill-registry/constants.d.ts +0 -3
- package/dist/internal/skill-registry/constants.d.ts.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,57 @@ what breaks, the migration, and an AI prompt that performs the migration in your
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [0.0.13-beta.9] - 2026-11-10
|
|
10
|
+
|
|
11
|
+
### Breaking changes
|
|
12
|
+
|
|
13
|
+
- **The built-in tools are renamed `dyna_aigw_<name>`**: `dyna_aigw_ask_user_question`, `dyna_aigw_remember_user_fact`,
|
|
14
|
+
`dyna_aigw_forget_user_fact`, `dyna_aigw_load_skill`. The prefix `dyna_aigw_` is reserved: an application tool whose
|
|
15
|
+
name starts with it is a 400, in `toolRegistry.tools` when the gateway is constructed and in `additionalTools` when
|
|
16
|
+
the call starts. Affected: a host that compares a tool name with an old literal (a renderer of tool parts, a reader of
|
|
17
|
+
stored tool results or the trace, a test), and a host whose own tool name starts with `dyna_aigw_`. A run paused before
|
|
18
|
+
the upgrade whose stored tools use an old name cannot be resumed: `resume` is a 400 (code `5387318840411`, the names in
|
|
19
|
+
`data.legacyTools`) and the run stays paused; start a new run.
|
|
20
|
+
|
|
21
|
+
Migration: compare with the exported `BUILT_IN_TOOL_NAMES`, never with a literal.
|
|
22
|
+
|
|
23
|
+
```ts
|
|
24
|
+
// before
|
|
25
|
+
if (part.toolName === "ask_user_question") renderQuestionForm(part.input);
|
|
26
|
+
|
|
27
|
+
// after
|
|
28
|
+
import {BUILT_IN_TOOL_NAMES} from "dyna-ai-gateway";
|
|
29
|
+
|
|
30
|
+
if (part.toolName === BUILT_IN_TOOL_NAMES.ASK_USER_QUESTION) renderQuestionForm(part.input);
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
An application tool named `ask_user_question` (or another old built-in name) is no longer a collision: it is the
|
|
34
|
+
application's tool.
|
|
35
|
+
|
|
36
|
+
AI prompt that performs the migration:
|
|
37
|
+
|
|
38
|
+
```text
|
|
39
|
+
Migrate this codebase to the next dyna-ai-gateway release, which renames its built-in tools. Search for the string
|
|
40
|
+
literals "ask_user_question", "remember_user_fact", "forget_user_fact" and "load_skill".
|
|
41
|
+
1. Where a literal names the gateway's built-in tool (compared with a tool name, a toolName of a tool part or of a
|
|
42
|
+
stored tool result, an expected value in a test), replace it with the constant exported by "dyna-ai-gateway":
|
|
43
|
+
BUILT_IN_TOOL_NAMES.ASK_USER_QUESTION, .REMEMBER_USER_FACT, .FORGET_USER_FACT, .LOAD_SKILL
|
|
44
|
+
(their values are "dyna_aigw_ask_user_question", "dyna_aigw_remember_user_fact", "dyna_aigw_forget_user_fact",
|
|
45
|
+
"dyna_aigw_load_skill"). Leave a literal that names the application's own tool unchanged.
|
|
46
|
+
2. Search for "dyna_aigw_" in the names of the application's own tools (defineTool({name}), toolRegistry.tools,
|
|
47
|
+
additionalTools). Rename each one: the prefix is reserved and the gateway refuses it with a 400.
|
|
48
|
+
3. Where the code calls resume(), handle a 400 with code 5387318840411: the run was paused before the upgrade and
|
|
49
|
+
cannot continue; tell the user to start again.
|
|
50
|
+
Verify: `tsc` passes and the tests pass.
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## [0.0.13-beta.8] - 2026-11-09
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
### Fixed
|
|
57
|
+
|
|
58
|
+
- Fix readme links
|
|
59
|
+
|
|
9
60
|
## [0.0.1-beta.7] - 2026-11-09
|
|
10
61
|
|
|
11
62
|
### Added
|
|
@@ -218,4 +269,4 @@ what breaks, the migration, and an AI prompt that performs the migration in your
|
|
|
218
269
|
- The shipped `CHAT_MAIN` template puts its stable layers first: the base text, the output format and the profile addendum,
|
|
219
270
|
then the per-call "Today is … locale … timezone" line, the call's instructions and context, the memory and the knowledge
|
|
220
271
|
base. The same layers, one of them moved: a prompt cache can now match the prefix across calls. A tenant's own stored
|
|
221
|
-
`CHAT_MAIN` version is not touched. See `docs/architecture/System prompt production layers.md`.
|
|
272
|
+
`CHAT_MAIN` version is not touched. See `docs/architecture/System prompt production layers.md`.
|
package/README.md
CHANGED
|
@@ -1,31 +1,306 @@
|
|
|
1
|
+

|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="https://aneldev.github.io/dyna-ai-gateway/"><strong>Documentation</strong></a>
|
|
5
|
+
·
|
|
6
|
+
<a href="https://aneldev.github.io/dyna-ai-gateway/docs/getting-started/README">Getting started</a>
|
|
7
|
+
·
|
|
8
|
+
<a href="https://aneldev.github.io/dyna-ai-gateway/docs/api/index/classes/AIGateway">API reference</a>
|
|
9
|
+
·
|
|
10
|
+
<a href="https://www.npmjs.com/package/dyna-ai-gateway">npm</a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
<p align="center">
|
|
14
|
+
<a href="https://www.npmjs.com/package/dyna-ai-gateway"><img alt="npm version" src="https://img.shields.io/npm/v/dyna-ai-gateway"></a>
|
|
15
|
+
<a href="https://aneldev.github.io/dyna-ai-gateway/"><img alt="docs" src="https://img.shields.io/badge/docs-aneldev.github.io-blue"></a>
|
|
16
|
+
<a href="https://github.com/aneldev/dyna-ai-gateway/blob/main/LICENSE"><img alt="license: MIT" src="https://img.shields.io/badge/license-MIT-green"></a>
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
|
|
1
20
|
# dyna-ai-gateway
|
|
2
21
|
|
|
3
|
-
Provider-agnostic AI gateway for Node.js (server-only): `ask` (grounded answers) and `run` (agent runs with tools, a human
|
|
4
|
-
approval gate and an optional review of the answer), knowledge base (RAG), thread and user memory, usage control by the application, guardrails, traces and streaming, on top of the
|
|
5
|
-
[Vercel AI SDK](https://ai-sdk.dev). Persistence is behind repository/adapter contracts; in-memory adapters are included.
|
|
6
22
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
23
|
+
A server-side TypeScript library that puts a language model inside a business application. The application calls
|
|
24
|
+
`ask()` for an answer or `run()` for an agent with tools; the gateway does the rest: prompt assembly, conversation
|
|
25
|
+
history, memory, knowledge base, tool policies, human approval, usage control, guardrails and tracing. Every provider is reached
|
|
26
|
+
through the [Vercel AI SDK](https://ai-sdk.dev); every store is behind an interface, with in-memory implementations
|
|
27
|
+
included.
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
Application / Agent dyna-ai-gateway LLM providers
|
|
31
|
+
┌──────────────────┐ ask() ┌───────────────────────────────────────┐ ┌─────────────┐
|
|
32
|
+
│ business logic │ run() │ prompt assembly · history · memory │ AI │ OpenAI │
|
|
33
|
+
│ HTTP, UI, jobs │ ────────▶ │ knowledge base · tools · policies │ SDK │ Anthropic │
|
|
34
|
+
│ │ ◀──────── │ human gate · usage · guardrails │ ─────▶ │ Google │
|
|
35
|
+
│ userContext │ events │ trace │ │ Mistral │
|
|
36
|
+
│ (authenticated) │ response └──────────────────┬────────────────────┘ │ Bedrock │
|
|
37
|
+
└──────────────────┘ │ repository / adapter └─────────────┘
|
|
38
|
+
▼ interfaces
|
|
39
|
+
in-memory · MongoDB · PostgreSQL · S3
|
|
10
40
|
```
|
|
11
41
|
|
|
12
|
-
|
|
13
|
-
|
|
42
|
+
**No weirdos!**
|
|
43
|
+
|
|
44
|
+
> Nothing here is invented. It is the code every application around a model has to write anyway, written once and
|
|
45
|
+
> tested.
|
|
46
|
+
|
|
47
|
+
**Status: beta.** The API is considered stable and keeps improving; the documentation is being completed. Versions follow
|
|
48
|
+
[semver](https://semver.org); while the version is `0.x` a release may contain a breaking change, listed under *Breaking
|
|
49
|
+
changes* in the package's `CHANGELOG.md` with what breaks, the migration and an AI prompt that performs it. Every exported
|
|
50
|
+
symbol carries its JSDoc, so the editor shows the contract of each option.
|
|
14
51
|
|
|
15
|
-
|
|
52
|
+
| Quality | |
|
|
53
|
+
|---------------------|--------------------------------------------------------------------|
|
|
54
|
+
| Deterministic tests | 1000+, on a scripted model, no key needed |
|
|
55
|
+
| Real-provider tests | 30+, against OpenAI, Anthropic, Google, Mistral and Amazon Bedrock |
|
|
56
|
+
| Types | `tsc` over sources and tests; non-null assertions are a lint error |
|
|
16
57
|
|
|
17
|
-
|
|
18
|
-
- Peer dependency: `zod` 4
|
|
58
|
+
## Before you adopt it
|
|
19
59
|
|
|
20
|
-
|
|
60
|
+
| Question | Answer |
|
|
61
|
+
|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
62
|
+
| Am I locked into one provider? | No. Five providers; the model is chosen per call through the profile, so a thread can switch model between two calls. |
|
|
63
|
+
| Where does my data live? | In your database. Every store is an interface (`IAIGatewayConfig.<store>.repository`); in-memory implementations are included. |
|
|
64
|
+
| How does the model reach my code? | `defineTool`: a function with a zod schema and a policy that allows, denies or holds each call on its parsed input. |
|
|
65
|
+
| Can a human step in? | Yes. A run pauses on a tool call or on the final answer; `resume()` takes approve, edit or reject. |
|
|
66
|
+
| How do I control the spend? | In your code. The gateway asks your usage adapter before every model call, with the tenant, user, profile, model, purpose and a token estimate, and reports what the call used after it. It holds no budget, plan or quota of its own. |
|
|
67
|
+
| Can I test without a real model? | Yes. The agent loop runs on a scripted model; 1,086 of the tests do exactly that. |
|
|
68
|
+
| Does it fit my auth and tenants? | The call carries the `userContext` your host authenticated; every store is keyed by its `tenantId`. |
|
|
69
|
+
|
|
70
|
+
Every part of the gateway is a class with one job, held behind an interface. The second constructor argument takes your
|
|
71
|
+
own instance in place of any of them: a knowledge-base retriever on your search engine, a trace that writes to your
|
|
72
|
+
observability stack, a scripted model in a test. The rest of the gateway does not notice the swap.
|
|
73
|
+
|
|
74
|
+
```ts
|
|
75
|
+
const gateway = new AIGateway(config, {kbRetriever: new MyKbRetriever()});
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
The seams: [Live adjustment and dependency injection](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/60-architecture/50-live-adjustment-and-dependency-injection.md).
|
|
79
|
+
|
|
80
|
+
## Install
|
|
21
81
|
|
|
22
82
|
```bash
|
|
23
|
-
pnpm
|
|
24
|
-
pnpm test-no-coverage # real-provider tests run only when their keys are in .env (see .env.sample)
|
|
25
|
-
pnpm lint
|
|
26
|
-
pnpm typecheck # tsc over sources and tests (tsconfig.tests.json)
|
|
27
|
-
pnpm build # lint + typecheck + dist/index.js (CJS) + dist/index.mjs (ESM) + .d.ts; dist/vercel-ui.js / .mjs for the subpath
|
|
83
|
+
pnpm add dyna-ai-gateway zod
|
|
28
84
|
```
|
|
29
85
|
|
|
30
|
-
|
|
31
|
-
|
|
86
|
+
Node.js 24 or newer. `zod` 4 is a peer dependency: the tools and the structured answers are typed with it.
|
|
87
|
+
|
|
88
|
+
## Ask: an answer on the application's data
|
|
89
|
+
|
|
90
|
+
The application hands the gateway what the user asked and what the screen knows; the answer comes back as text or as a
|
|
91
|
+
typed object.
|
|
92
|
+
|
|
93
|
+
```ts
|
|
94
|
+
import {z} from "zod";
|
|
95
|
+
import {AIGateway, EGatewayResponseKind} from "dyna-ai-gateway";
|
|
96
|
+
|
|
97
|
+
const gateway = new AIGateway(config); // the config: next section
|
|
98
|
+
|
|
99
|
+
const {response} = gateway.ask({
|
|
100
|
+
userContext: {tenantId: "acme", userId: "u-17", permissions: [], locale: "en-GB", timezone: "Europe/Oslo", now: new Date()},
|
|
101
|
+
profileId: "accounting",
|
|
102
|
+
prompt: "Which lines of this invoice are missing a VAT code?",
|
|
103
|
+
context: JSON.stringify(invoice), // what the user is looking at
|
|
104
|
+
outputSchema: z.object({lines: z.array(z.object({lineNo: z.number(), reason: z.string()}))}),
|
|
105
|
+
kbFilters: {libraryIds: ["vat-rules"], bookIds: []}, // the knowledge base this call may search
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
const result = await response;
|
|
109
|
+
if (result.kind === EGatewayResponseKind.ANSWER) {
|
|
110
|
+
result.structured; // {lines: [...]}, validated against the schema
|
|
111
|
+
result.citations; // the ids of the knowledge-base chunks the model was given
|
|
112
|
+
result.threadId; // pass it on the next call to continue the conversation
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
A call that should stream reads `events` before awaiting `response`: text deltas, tool calls and results, the pause of a
|
|
117
|
+
human gate. The application owns the transport.
|
|
118
|
+
|
|
119
|
+
### The configuration
|
|
120
|
+
|
|
121
|
+
One object: the stores, the providers and the switches. The in-memory stores ship with the package; a database adapter
|
|
122
|
+
implements the same interface.
|
|
123
|
+
|
|
124
|
+
```ts
|
|
125
|
+
import {
|
|
126
|
+
IAIGatewayConfig,
|
|
127
|
+
IAIProfile,
|
|
128
|
+
EModelProvider,
|
|
129
|
+
InMemoryAIProfileRepository,
|
|
130
|
+
InMemoryBlobAdapter,
|
|
131
|
+
InMemoryModelRegistryRepository,
|
|
132
|
+
InMemoryPromptTemplateRepository,
|
|
133
|
+
InMemoryRunRepository,
|
|
134
|
+
InMemoryThreadRepository,
|
|
135
|
+
InMemoryTraceRepository,
|
|
136
|
+
InMemoryUsageAdapter,
|
|
137
|
+
InMemoryUserMemoryRepository,
|
|
138
|
+
InMemoryVectorIndexAdapter,
|
|
139
|
+
} from "dyna-ai-gateway";
|
|
140
|
+
|
|
141
|
+
const config: IAIGatewayConfig = {
|
|
142
|
+
llmClient: {providers: {[EModelProvider.OPENAI]: {apiKey: process.env.OPENAI_API_KEY ?? ""}}},
|
|
143
|
+
modelRegistry: {repository: new InMemoryModelRegistryRepository({models: [gpt5Mini, textEmbedding3Small]})},
|
|
144
|
+
aiProfileStore: {repository: new InMemoryAIProfileRepository({profiles: [accountingProfile]})},
|
|
145
|
+
promptTemplateStore: {repository: new InMemoryPromptTemplateRepository()},
|
|
146
|
+
threadStore: {repository: new InMemoryThreadRepository()},
|
|
147
|
+
fileStore: {adapter: new InMemoryBlobAdapter(), path: "ai-files"},
|
|
148
|
+
workingMemory: {enabled: true},
|
|
149
|
+
userMemoryStore: {repository: new InMemoryUserMemoryRepository(), enabled: true},
|
|
150
|
+
embedder: {embeddingModelId: "text-embedding-3-small", dimensions: 1536},
|
|
151
|
+
vectorStore: {adapter: new InMemoryVectorIndexAdapter({embeddingModelId: "text-embedding-3-small", dimensions: 1536})},
|
|
152
|
+
queryRewriter: {enabled: true},
|
|
153
|
+
runStore: {repository: new InMemoryRunRepository()},
|
|
154
|
+
humanGate: {userQuestions: {enabled: true}},
|
|
155
|
+
usageGuard: {adapter: new InMemoryUsageAdapter()},
|
|
156
|
+
contextAssembler: {promptCaching: true, sharePromptCacheAcrossTenants: false},
|
|
157
|
+
trace: {repository: new InMemoryTraceRepository()},
|
|
158
|
+
defaultCheapModelId: "gpt-5-mini",
|
|
159
|
+
};
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
A **model** (`IModelInfo`) is registered with its provider, its capabilities and its price. A **profile** (`IAIProfile`) is
|
|
163
|
+
what a tenant's use case runs on: the model, the tools it may call, the approvals, a prompt addendum and the limits.
|
|
164
|
+
Each call names its profile, so one thread can switch model between two calls. Both are data in a store and can be changed
|
|
165
|
+
while the server runs.
|
|
166
|
+
|
|
167
|
+
```ts
|
|
168
|
+
const accountingProfile: IAIProfile = {
|
|
169
|
+
id: "accounting",
|
|
170
|
+
tenantId: "acme",
|
|
171
|
+
name: "Accounting assistant",
|
|
172
|
+
modelId: "gpt-5-mini",
|
|
173
|
+
promptAddendum: "You assist the accounting team of a Norwegian company. Amounts are in NOK.",
|
|
174
|
+
allowedTools: ["get_invoice", "post_credit_note"],
|
|
175
|
+
approvals: [],
|
|
176
|
+
limits: {maxStepsPerRun: 6, maxOutputTokens: 2_000},
|
|
177
|
+
};
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
## Agent: tools, a policy per tool, a human in the loop
|
|
181
|
+
|
|
182
|
+
A tool is a function with a zod input schema and a policy. The policy decides, on the parsed input of each call, whether
|
|
183
|
+
the tool runs, is denied, or waits for a human. The application does not write a loop: `run()` is the loop.
|
|
184
|
+
|
|
185
|
+
```ts
|
|
186
|
+
import {z} from "zod";
|
|
187
|
+
import {defineTool, EToolCallVerdict, EGatewayResponseKind, EResumeAction} from "dyna-ai-gateway";
|
|
188
|
+
|
|
189
|
+
const getInvoice = defineTool({
|
|
190
|
+
name: "get_invoice",
|
|
191
|
+
description: "Returns an invoice by its number.",
|
|
192
|
+
inputSchema: z.object({invoiceNo: z.string()}),
|
|
193
|
+
tags: ["billing"],
|
|
194
|
+
execute: async ({input, userContext}) => invoices.load(userContext.tenantId, input.invoiceNo),
|
|
195
|
+
});
|
|
196
|
+
|
|
197
|
+
const postCreditNote = defineTool({
|
|
198
|
+
name: "post_credit_note",
|
|
199
|
+
description: "Posts a credit note against an invoice.",
|
|
200
|
+
inputSchema: z.object({invoiceNo: z.string(), amount: z.number(), reason: z.string()}),
|
|
201
|
+
tags: ["billing"],
|
|
202
|
+
// Small amounts post at once; above the threshold the run pauses until a human decides
|
|
203
|
+
policy: ({input}) => ({verdict: input.amount > 5_000 ? EToolCallVerdict.NEEDS_APPROVAL : EToolCallVerdict.ALLOW}),
|
|
204
|
+
execute: async ({input, userContext}) => ledger.postCreditNote(userContext.tenantId, input),
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
const gateway = new AIGateway({...config, toolRegistry: {tools: [getInvoice, postCreditNote]}});
|
|
208
|
+
|
|
209
|
+
const paused = await gateway.run({
|
|
210
|
+
userContext,
|
|
211
|
+
profileId: "accounting",
|
|
212
|
+
prompt: "Credit invoice 2024-1187 in full, the goods came back damaged.",
|
|
213
|
+
kbFilters: {libraryIds: [], bookIds: []},
|
|
214
|
+
}).response;
|
|
215
|
+
|
|
216
|
+
// paused.kind === EGatewayResponseKind.PAUSED: the model read the invoice, then asked to post 12 400 NOK.
|
|
217
|
+
// The application shows the card to an approver; nothing has been posted. Later, from another request:
|
|
218
|
+
if (paused.kind === EGatewayResponseKind.PAUSED) {
|
|
219
|
+
const done = await gateway.resume({
|
|
220
|
+
userContext: approverContext,
|
|
221
|
+
runId: paused.envelopes[0].runId,
|
|
222
|
+
pauseId: paused.pauseId,
|
|
223
|
+
decisions: [{action: EResumeAction.APPROVE}], // or EDIT with a new input, or REJECT with a reason the model reads
|
|
224
|
+
}).response;
|
|
225
|
+
}
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
What else a run gives: tools for one call only, a tool that ends the run, a tool offered only after another one ran, a
|
|
229
|
+
question the model asks the user as a form, a review of the final answer by a human before the user sees it, timeouts and
|
|
230
|
+
output caps per tool, a cap on steps and daily tokens per tenant. A paused run survives a restart of the server.
|
|
231
|
+
|
|
232
|
+
## A chat screen in one module
|
|
233
|
+
|
|
234
|
+
`dyna-ai-gateway/vercel-ui` speaks the UI message protocol of the Vercel AI SDK's `useChat`: the approval cards, the
|
|
235
|
+
history of a thread and the resume of a paused run included.
|
|
236
|
+
|
|
237
|
+
```ts
|
|
238
|
+
import {AIGatewayVercelUi} from "dyna-ai-gateway/vercel-ui";
|
|
239
|
+
|
|
240
|
+
const supportChat = new AIGatewayVercelUi({
|
|
241
|
+
mode: "run",
|
|
242
|
+
userContext: async ({request}) => sessionOf(request), // the application's authentication
|
|
243
|
+
call: {profileId: "support", kbFilters: {libraryIds: ["help-center"], bookIds: []}},
|
|
244
|
+
}, {gateway});
|
|
245
|
+
|
|
246
|
+
export const POST = (request: Request): Promise<Response> => supportChat.chat({request});
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
The guide: [Vercel chat client](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/10-getting-started/50-vercel-chat-client.md).
|
|
250
|
+
|
|
251
|
+
## What is inside
|
|
252
|
+
|
|
253
|
+
| | |
|
|
254
|
+
|-------------------|-------------------------------------------------------------------------------------------------------------------------------|
|
|
255
|
+
| Calls | `ask()`, `run()`, `resume()`; text or structured answer; streaming; `abortSignal` and `timeoutMs` on every call |
|
|
256
|
+
| Knowledge base | Markdown documents chunked, embedded and searched per tenant, library and book; query rewrite; citations |
|
|
257
|
+
| Memory | The thread's summary and facts, the user's facts across threads; both optional, both editable |
|
|
258
|
+
| Files | Images and PDFs sent to a model that reads them |
|
|
259
|
+
| Skills | Instructions the model loads only when a task needs them, on the profile or on the call; inlined in an `ask()` |
|
|
260
|
+
| Human in the loop | Approval of a tool call, the model's questions as a form, review of the answer, expiry of unanswered pauses |
|
|
261
|
+
| Guardrails | Built-in input and output rules, the application's own rules with evidence, a judge on the cheap model |
|
|
262
|
+
| Usage and trace | Your adapter asked before every model call and told what it used after it; one trace entry per model call with usage and cost |
|
|
263
|
+
| Operations | Graceful shutdown, recovery of the runs a crashed server left behind, deletion or anonymisation of a user's data |
|
|
264
|
+
| Providers | OpenAI, Anthropic, Google, Mistral, Amazon Bedrock |
|
|
265
|
+
|
|
266
|
+
## Design
|
|
267
|
+
|
|
268
|
+
- **The application keeps control.** The gateway knows no HTTP route, no UI and no session: it receives a `userContext`
|
|
269
|
+
the host authenticated and returns events and a response.
|
|
270
|
+
- **Data is passed, services are injected.** A call loads its profile, memory and history once and hands them on as plain
|
|
271
|
+
data; only the stores and the provider client are injected. One class per job.
|
|
272
|
+
- **Nothing is hidden in the model.** Every decision a tool policy, a guardrail or the usage adapter makes is code the
|
|
273
|
+
application wrote, logged in the trace.
|
|
274
|
+
- **Persistence is a contract.** Every store is an interface; in-memory for tests and small deployments, MongoDB,
|
|
275
|
+
PostgreSQL and S3 adapters as separate packages.
|
|
276
|
+
|
|
277
|
+
The reasons behind each behaviour: [Decisions](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/60-architecture/90-decisions.md). The composition of the classes:
|
|
278
|
+
[Architecture and trade-offs](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/60-architecture/10-architecture-and-trade-offs.md).
|
|
279
|
+
|
|
280
|
+
## Documentation
|
|
281
|
+
|
|
282
|
+
| | |
|
|
283
|
+
|---------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
284
|
+
| [Docs site](https://aneldev.github.io/dyna-ai-gateway/) | these docs and the API reference from the JSDoc, with navigation |
|
|
285
|
+
| [Getting started](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/10-getting-started/00-README.md) | first steps, the examples, the [FAQ](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/10-getting-started/90-faq.md), the [Vercel chat client](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/10-getting-started/50-vercel-chat-client.md) |
|
|
286
|
+
| [Roadmap](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/70-roadmap.md) | what works today, what is planned, what is not |
|
|
287
|
+
| [Terminology](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/90-terminology.md) | the terms of the docs and where they come from |
|
|
288
|
+
| [Architecture](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/60-architecture/90-decisions.md) | the composition, the trade-offs, one chapter of decisions per class |
|
|
289
|
+
| [Practices](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/50-ai-best-practices/index.md) | how to apply the library well |
|
|
290
|
+
| [Workspace](https://github.com/aneldev/dyna-ai-gateway/blob/main/docs/85-workspace.md) | building and testing the packages of this repository |
|
|
291
|
+
|
|
292
|
+
## Packages
|
|
293
|
+
|
|
294
|
+
| Package | What | Status |
|
|
295
|
+
|---------------------------------------------------------------------------|--------------------------------------------------------|---------|
|
|
296
|
+
| [`dyna-ai-gateway`](https://github.com/aneldev/dyna-ai-gateway/blob/main/packages/dyna-ai-gateway) | the gateway, in-memory stores included | beta |
|
|
297
|
+
| [`dyna-ai-gateway-mongodb`](https://github.com/aneldev/dyna-ai-gateway/blob/main/packages/dyna-ai-gateway-mongodb/README.md) | MongoDB repositories and the Atlas Vector Search index | planned |
|
|
298
|
+
| [`dyna-ai-gateway-postgres`](https://github.com/aneldev/dyna-ai-gateway/blob/main/packages/dyna-ai-gateway-postgres/README.md) | PostgreSQL repositories | planned |
|
|
299
|
+
| [`dyna-ai-gateway-s3`](https://github.com/aneldev/dyna-ai-gateway/blob/main/packages/dyna-ai-gateway-s3/README.md) | S3 blob store for the files | planned |
|
|
300
|
+
|
|
301
|
+
## About
|
|
302
|
+
|
|
303
|
+
Built by [Anel](http://anel.co), a small Norwegian software company working in accounting, billing, payments and AI
|
|
304
|
+
integration in complex environments. The gateway is the piece those systems share.
|
|
305
|
+
|
|
306
|
+
MIT license.
|
package/dist/AIGateway.d.ts
CHANGED
|
@@ -201,7 +201,7 @@ export declare class AIGateway {
|
|
|
201
201
|
* - The run continues on its profile as it is now, or on `profileId` (D65): the model, the output cap, the tools and the
|
|
202
202
|
* limits come from that profile; the system prompt and the messages so far stay. The review of the answer and the
|
|
203
203
|
* approvals are those of both profiles (D113): a switch never skips a guard the run started under. The skills the run
|
|
204
|
-
* kept (D124) and the profile's are offered again through a rebuilt `
|
|
204
|
+
* kept (D124) and the profile's are offered again through a rebuilt `dyna_aigw_load_skill`; the system prompt keeps the list of
|
|
205
205
|
* the start.
|
|
206
206
|
* - The free text of an ANSWER goes through the input rules like a prompt (D71): an ERROR returns FAILED and the run
|
|
207
207
|
* stays paused, so the user can answer again; WARNINGs travel on the response.
|
|
@@ -189,6 +189,34 @@ export interface IUsage {
|
|
|
189
189
|
export declare const DEFAULT_TOOL_REJECTION_TEXT = "The user declined this tool call. It was not executed and nothing happened. Do not call it again unless the user asks; tell the user it was not done and ask how to proceed.";
|
|
190
190
|
/** Sent to the model as a tool's output when the tool's `policy` denies the call (D87); the policy's reason is appended. */
|
|
191
191
|
export declare const DEFAULT_TOOL_DENIAL_TEXT = "The application's policy refused this tool call. It was not executed and nothing happened. Do not call it again with the same input; tell the user it was not done and ask how to proceed.";
|
|
192
|
+
/**
|
|
193
|
+
* Prefix of every built-in tool name.
|
|
194
|
+
*
|
|
195
|
+
* > Keeps the gateway's own tools apart from the application's.
|
|
196
|
+
*
|
|
197
|
+
* Reserved: an application tool whose name starts with it, registered or passed as `additionalTools`, is a 400.
|
|
198
|
+
*/
|
|
199
|
+
export declare const BUILT_IN_TOOL_NAME_PREFIX = "dyna_aigw_";
|
|
200
|
+
/**
|
|
201
|
+
* Names of the gateway's built-in tools, as the model and the thread see them.
|
|
202
|
+
*
|
|
203
|
+
* > A host that renders tool calls or reads the stored tool results tells the built-ins apart by these names.
|
|
204
|
+
*
|
|
205
|
+
* `ASK_USER_QUESTION` when `humanGate.userQuestions` is enabled, `REMEMBER_USER_FACT` / `FORGET_USER_FACT` when the user
|
|
206
|
+
* memory is, `LOAD_SKILL` in a `run()` whose profile or call has skills.
|
|
207
|
+
*
|
|
208
|
+
* @example BUILT_IN_TOOL_NAMES.ASK_USER_QUESTION - the tool part of a user question in the thread
|
|
209
|
+
*/
|
|
210
|
+
export declare const BUILT_IN_TOOL_NAMES: {
|
|
211
|
+
/** The model asks the user; its call pauses the run with a USER_QUESTION. */
|
|
212
|
+
readonly ASK_USER_QUESTION: "dyna_aigw_ask_user_question";
|
|
213
|
+
/** The model loads the instructions of one skill. */
|
|
214
|
+
readonly LOAD_SKILL: "dyna_aigw_load_skill";
|
|
215
|
+
/** The model stores a lasting fact the user stated about themselves. */
|
|
216
|
+
readonly REMEMBER_USER_FACT: "dyna_aigw_remember_user_fact";
|
|
217
|
+
/** The model removes a stored fact the user asked to forget. */
|
|
218
|
+
readonly FORGET_USER_FACT: "dyna_aigw_forget_user_fact";
|
|
219
|
+
};
|
|
192
220
|
/** What a tool's `policy` can say about one call (D87). */
|
|
193
221
|
export declare enum EToolCallVerdict {
|
|
194
222
|
/** The call runs now, without a human. The same as a tool without `policy`. */
|
|
@@ -290,7 +318,7 @@ export type TToolVisibleWhenHandler = (args: {
|
|
|
290
318
|
* Instructions the model loads when a task needs them, instead of reading them on every call (D124).
|
|
291
319
|
*
|
|
292
320
|
* Attached to a profile (`IAIProfile.skills`) or to one call (`IGatewayAskInput.skills`). In `run()` the system prompt lists
|
|
293
|
-
* every skill's `name` and `description`, and the model fetches a `body` with the built-in `
|
|
321
|
+
* every skill's `name` and `description`, and the model fetches a `body` with the built-in `dyna_aigw_load_skill` tool when a task
|
|
294
322
|
* matches; in `ask()` the bodies are in the prompt (no tool loop there). A long rule that applies to few calls (a refund
|
|
295
323
|
* policy, an onboarding script, an escalation procedure) belongs here; a rule for every call belongs in `promptAddendum`.
|
|
296
324
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"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"}
|