@llmguard/opencode 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/MANUAL-TEST-G.md +167 -0
  2. package/README.md +334 -2
  3. package/RELEASE.md +122 -0
  4. package/bin/darwin-amd64/helper +0 -0
  5. package/bin/darwin-arm64/helper +0 -0
  6. package/bin/linux-amd64/helper +0 -0
  7. package/bin/linux-arm64/helper +0 -0
  8. package/bin/manifest.json +51 -0
  9. package/bin/windows-amd64/helper.exe +0 -0
  10. package/bin/windows-arm64/helper.exe +0 -0
  11. package/bridge/client.d.ts +55 -0
  12. package/bridge/client.js +425 -0
  13. package/bridge/framing.d.ts +19 -0
  14. package/bridge/framing.js +110 -0
  15. package/bridge/process.d.ts +38 -0
  16. package/bridge/process.js +378 -0
  17. package/bridge/protocol.d.ts +184 -0
  18. package/bridge/protocol.js +683 -0
  19. package/connection-catalog.d.ts +69 -0
  20. package/connection-catalog.js +287 -0
  21. package/connections-tui.d.ts +11 -0
  22. package/connections-tui.js +394 -0
  23. package/demasking.d.ts +2 -0
  24. package/demasking.js +445 -0
  25. package/gui-experimental.cjs +33 -0
  26. package/hook-trace.d.ts +2 -0
  27. package/hook-trace.js +35 -0
  28. package/index.d.ts +1 -0
  29. package/index.js +1 -0
  30. package/licenses/Go-LICENSE +27 -0
  31. package/messages.d.ts +230 -0
  32. package/messages.js +231 -0
  33. package/native/index.d.ts +1 -0
  34. package/native/index.js +1 -0
  35. package/native/tui.d.ts +1 -0
  36. package/native/tui.js +1 -0
  37. package/package.json +49 -4
  38. package/plugin-runtime.d.ts +3 -0
  39. package/plugin-runtime.js +3 -0
  40. package/plugin-settings.d.ts +77 -0
  41. package/plugin-settings.js +487 -0
  42. package/plugin.d.ts +41 -0
  43. package/plugin.js +10 -0
  44. package/response-diagnostics.d.ts +13 -0
  45. package/response-diagnostics.js +142 -0
  46. package/runtime/attachments.d.ts +4 -0
  47. package/runtime/attachments.js +19 -0
  48. package/runtime/errors.d.ts +18 -0
  49. package/runtime/errors.js +26 -0
  50. package/runtime/json.d.ts +14 -0
  51. package/runtime/json.js +243 -0
  52. package/runtime/limits.d.ts +2 -0
  53. package/runtime/limits.js +3 -0
  54. package/runtime/native-edit.d.ts +14 -0
  55. package/runtime/native-edit.js +73 -0
  56. package/runtime/runtime.d.ts +43 -0
  57. package/runtime/runtime.js +345 -0
  58. package/runtime/session-state.d.ts +13 -0
  59. package/runtime/session-state.js +73 -0
  60. package/runtime/text-layout.d.ts +9 -0
  61. package/runtime/text-layout.js +47 -0
  62. package/server.d.ts +1 -0
  63. package/server.js +1 -0
  64. package/settings-rpc.d.ts +511 -0
  65. package/settings-rpc.js +197 -0
  66. package/tui-messages.d.ts +1 -0
  67. package/tui-messages.js +84 -0
  68. package/tui.d.ts +17 -0
  69. package/tui.js +427 -0
  70. package/v1/hooks.d.ts +81 -0
  71. package/v1/hooks.js +97 -0
  72. package/v1/projection.d.ts +32 -0
  73. package/v1/projection.js +217 -0
  74. package/v1.d.ts +2 -0
  75. package/v1.js +2 -0
  76. package/v2/projection.d.ts +36 -0
  77. package/v2/projection.js +374 -0
  78. package/v2/server.d.ts +6 -0
  79. package/v2/server.js +633 -0
package/tui.js ADDED
@@ -0,0 +1,427 @@
1
+ import { registerConnectionsTUI } from "./connections-tui.js";
2
+ import { settingsRPC } from "./settings-rpc.js";
3
+ export function registerSettingsTUI(context, api) {
4
+ let open = false;
5
+ let disposed = false;
6
+ let draft;
7
+ function sameConnection(a, b) {
8
+ return (a.baseURL === b.baseURL &&
9
+ a.projectSID === b.projectSID &&
10
+ a.allowLoopbackHTTP === b.allowLoopbackHTTP);
11
+ }
12
+ function notify(message, variant = "info") {
13
+ if (!disposed) {
14
+ context.ui.toast.show({ title: "LLMGuard", message, variant });
15
+ }
16
+ }
17
+ async function panel() {
18
+ if (open || disposed) {
19
+ return;
20
+ }
21
+ open = true;
22
+ let current;
23
+ try {
24
+ while (!disposed) {
25
+ let status;
26
+ try {
27
+ status = (await api.status());
28
+ }
29
+ catch {
30
+ if (disposed) {
31
+ return;
32
+ }
33
+ const retry = await context.ui.dialog.confirm({
34
+ title: "Статус LLMGuard недоступен",
35
+ message: "Не удалось связаться с серверным плагином. Состояние защиты неизвестно. Проверьте подключение и обновите статус.",
36
+ label: { confirm: "Обновить статус", cancel: "Закрыть" },
37
+ });
38
+ if (disposed || !retry) {
39
+ return;
40
+ }
41
+ continue;
42
+ }
43
+ if (disposed) {
44
+ return;
45
+ }
46
+ // Attachment settings are optional; a failed read hides the item only.
47
+ let files;
48
+ try {
49
+ files = api.files ? (await api.files()) : undefined;
50
+ }
51
+ catch {
52
+ files = undefined;
53
+ }
54
+ const suggested = !status.baseURL || !status.projectSID
55
+ ? status.environmentOverride
56
+ ? "status"
57
+ : "configure"
58
+ : !status.tokenPresent
59
+ ? "key"
60
+ : !status.configured
61
+ ? "status"
62
+ : !status.enabled
63
+ ? "test"
64
+ : "status";
65
+ if ((current === "configure" && status.environmentOverride) ||
66
+ (current === "test" && !status.configured) ||
67
+ (current === "toggle" && !status.enabled && !status.configured)) {
68
+ current = undefined;
69
+ }
70
+ const choice = await context.ui.dialog.select({
71
+ title: `LLMGuard — ${status.enabled ? (status.configured ? "защита включена" : "операции блокируются") : "защита выключена"}`,
72
+ placeholder: "Выберите действие",
73
+ current: current ?? suggested,
74
+ options: [
75
+ {
76
+ title: status.enabled ? "Выключить защиту" : "Включить защиту",
77
+ value: "toggle",
78
+ disabled: !status.enabled && !status.configured,
79
+ description: !status.configured
80
+ ? "Сначала настройте подключение и ключ"
81
+ : status.enabled
82
+ ? "Запросы будут проходить без проверки Guard"
83
+ : "Проверка выбранных текстовых полей во всех сессиях",
84
+ },
85
+ {
86
+ title: "Статус подключения",
87
+ value: "status",
88
+ description: status.baseURL || "URL не задан",
89
+ },
90
+ {
91
+ title: draft
92
+ ? "Продолжить настройку подключения"
93
+ : "Настроить подключение",
94
+ value: "configure",
95
+ disabled: status.environmentOverride,
96
+ description: status.environmentOverride
97
+ ? "URL и проект заданы окружением сервера"
98
+ : "URL, SID и протокол. Защита выключится только при сохранении",
99
+ },
100
+ {
101
+ title: "Ключ Guard",
102
+ value: "key",
103
+ description: status.tokenPresent
104
+ ? status.tokenSource === "session"
105
+ ? "Сохранён локально"
106
+ : "Задан в окружении сервера"
107
+ : "Не задан. Нужен для включения защиты",
108
+ },
109
+ ...(draft
110
+ ? [
111
+ {
112
+ title: "Отменить черновик подключения",
113
+ value: "discard",
114
+ description: "Сохранённые настройки и защита останутся без изменений",
115
+ },
116
+ ]
117
+ : []),
118
+ ...(files
119
+ ? [
120
+ {
121
+ title: files.inspect
122
+ ? files.allowUninspectable
123
+ ? "Вложения: проверять, непроверяемые пропускать"
124
+ : "Вложения: проверять, непроверяемые блокировать"
125
+ : "Вложения: не проверять",
126
+ value: "files",
127
+ description: files.source === "env"
128
+ ? "Задано переменными окружения сервера"
129
+ : files.damaged
130
+ ? "Файл настроек повреждён: действует строгий режим"
131
+ : "Файлы и изображения в запросах к модели",
132
+ },
133
+ ]
134
+ : []),
135
+ {
136
+ title: "Проверить связь с Guard",
137
+ value: "test",
138
+ disabled: !status.configured,
139
+ description: "Сохранённые настройки; только фиксированный тестовый текст",
140
+ },
141
+ ],
142
+ });
143
+ if (disposed || choice === undefined) {
144
+ return;
145
+ }
146
+ current = choice;
147
+ try {
148
+ if (choice === "toggle") {
149
+ if (!status.enabled && !status.configured) {
150
+ continue;
151
+ }
152
+ await api.setEnabled({ enabled: !status.enabled });
153
+ notify(status.enabled ? "Защита выключена" : "Защита включена", "success");
154
+ }
155
+ else if (choice === "files" && files && api.setFiles) {
156
+ if (files.source === "env") {
157
+ await context.ui.dialog.alert({
158
+ title: "Вложения",
159
+ message: "Проверка вложений задана переменными LLMGUARD_FILE_INSPECTION и LLMGUARD_FILE_UNINSPECTABLE; меню их не меняет.",
160
+ });
161
+ continue;
162
+ }
163
+ const mode = !files.inspect
164
+ ? "off"
165
+ : files.allowUninspectable
166
+ ? "allow"
167
+ : "block";
168
+ const next = await context.ui.dialog.select({
169
+ title: "Вложения",
170
+ placeholder: "Проверка файлов и изображений",
171
+ current: mode,
172
+ options: [
173
+ {
174
+ title: "Не проверять",
175
+ value: "off",
176
+ description: "Файлы и изображения проходят как раньше",
177
+ },
178
+ {
179
+ title: "Проверять, непроверяемые блокировать",
180
+ value: "block",
181
+ description: "Проблемный файл или срабатывание правила отклоняет запрос",
182
+ },
183
+ {
184
+ title: "Проверять, непроверяемые пропускать",
185
+ value: "allow",
186
+ description: "Неподдерживаемые типы, ссылки и идентификаторы файлов уходят без проверки",
187
+ },
188
+ ],
189
+ });
190
+ if (disposed || next === undefined || next === mode) {
191
+ continue;
192
+ }
193
+ await api.setFiles({
194
+ inspect: next !== "off",
195
+ allowUninspectable: next === "allow" ||
196
+ (next === "off" && files.allowUninspectable),
197
+ });
198
+ notify("Настройки вложений сохранены", "success");
199
+ }
200
+ else if (choice === "discard") {
201
+ draft = undefined;
202
+ current = "configure";
203
+ notify("Черновик удалён. Сохранённые настройки не изменены.");
204
+ }
205
+ else if (choice === "status") {
206
+ await context.ui.dialog.alert({
207
+ title: "LLMGuard — сохранённые настройки",
208
+ message: [
209
+ `Защита: ${status.enabled ? (status.configured ? "включена" : "операции блокируются — требуется настройка") : "выключена"}`,
210
+ `URL: ${status.baseURL || "не задан"}`,
211
+ `Проект: ${status.projectSID || "не задан"}`,
212
+ `Ключ: ${status.tokenPresent ? "задан" : "не задан"}`,
213
+ `Источник URL/проекта: ${status.environmentOverride ? "окружение сервера" : "профиль плагина"}`,
214
+ "Маскирование: выбранные текстовые поля; прочие поля проходят без изменений.",
215
+ ].join("\n"),
216
+ });
217
+ }
218
+ else if (choice === "key") {
219
+ let token = await context.ui.dialog.prompt({
220
+ title: "Новый ключ Guard",
221
+ description: "Внимание: ключ виден при вводе. Он сохраняется локально на сервере OpenCode. Пустое поле или отмена сохраняют текущий ключ и состояние защиты.",
222
+ placeholder: "Ключ проекта LLMGuard",
223
+ });
224
+ if (disposed || !token?.trim()) {
225
+ continue;
226
+ }
227
+ const confirmed = await context.ui.dialog.confirm({
228
+ title: "Применить новый ключ Guard?",
229
+ message: "Текущий ключ будет заменён. Перед заменой защита выключится. Ключ не записывается в чат и сохраняется локально на сервере OpenCode. После проверки связи включите защиту в меню.",
230
+ label: { confirm: "Применить ключ", cancel: "Отмена" },
231
+ });
232
+ if (disposed || !confirmed) {
233
+ token = undefined;
234
+ continue;
235
+ }
236
+ const latest = (await api.status());
237
+ if (disposed) {
238
+ return;
239
+ }
240
+ if (latest.enabled) {
241
+ await api.setEnabled({ enabled: false });
242
+ }
243
+ if (disposed) {
244
+ return;
245
+ }
246
+ const value = token.trim();
247
+ token = undefined;
248
+ await api.setKey({ token: value });
249
+ notify("Ключ применён. Проверьте связь и включите защиту в меню.", "success");
250
+ current =
251
+ !latest.baseURL || !latest.projectSID ? undefined : "test";
252
+ }
253
+ else if (choice === "configure") {
254
+ if (status.environmentOverride) {
255
+ continue;
256
+ }
257
+ const original = status;
258
+ const initial = draft ?? status;
259
+ const baseURL = await context.ui.dialog.prompt({
260
+ title: "Подключение · 1/3 — URL Guard",
261
+ description: "Изменения применяются только после подтверждения. Отмена не меняет защиту.",
262
+ value: initial.baseURL,
263
+ placeholder: "https://guard.example.com",
264
+ });
265
+ if (disposed || baseURL === undefined) {
266
+ continue;
267
+ }
268
+ draft = {
269
+ baseURL: baseURL.trim(),
270
+ projectSID: initial.projectSID,
271
+ allowLoopbackHTTP: initial.allowLoopbackHTTP,
272
+ };
273
+ const projectSID = await context.ui.dialog.prompt({
274
+ title: "Подключение · 2/3 — SID проекта",
275
+ value: draft.projectSID,
276
+ placeholder: "UUID проекта из LLMGuard",
277
+ });
278
+ if (disposed || projectSID === undefined) {
279
+ continue;
280
+ }
281
+ draft = { ...draft, projectSID: projectSID.trim() };
282
+ const transport = await context.ui.dialog.select({
283
+ title: "Подключение · 3/3 — протокол",
284
+ current: draft.allowLoopbackHTTP ? "local" : "tls",
285
+ options: [
286
+ {
287
+ title: "HTTPS",
288
+ value: "tls",
289
+ description: "Соединение с TLS",
290
+ },
291
+ {
292
+ title: "Разрешить HTTP",
293
+ value: "local",
294
+ description: "Guard без TLS; соединение не шифруется",
295
+ },
296
+ ],
297
+ });
298
+ if (disposed || transport === undefined) {
299
+ continue;
300
+ }
301
+ draft = { ...draft, allowLoopbackHTTP: transport === "local" };
302
+ if (sameConnection(draft, status)) {
303
+ draft = undefined;
304
+ notify("Подключение не изменилось. Состояние защиты сохранено.");
305
+ continue;
306
+ }
307
+ const confirmed = await context.ui.dialog.confirm({
308
+ title: "Сохранить подключение?",
309
+ message: [
310
+ `URL: ${draft.baseURL}`,
311
+ `Проект: ${draft.projectSID}`,
312
+ `Протокол: ${draft.allowLoopbackHTTP ? "HTTP разрешён (без TLS)" : "HTTPS"}`,
313
+ "Сохранение выключит защиту для всех сессий этого сервера. После проверки связи включите её в меню.",
314
+ ].join("\n"),
315
+ label: {
316
+ confirm: "Сохранить подключение",
317
+ cancel: "Назад в меню",
318
+ },
319
+ });
320
+ if (disposed || !confirmed) {
321
+ continue;
322
+ }
323
+ const latest = (await api.status());
324
+ if (disposed) {
325
+ return;
326
+ }
327
+ if (sameConnection(draft, latest)) {
328
+ draft = undefined;
329
+ notify("Подключение уже сохранено. Состояние защиты не изменено.");
330
+ continue;
331
+ }
332
+ if (latest.environmentOverride ||
333
+ !sameConnection(original, latest)) {
334
+ notify("Другой клиент изменил подключение. Черновик сохранён в этом меню; проверьте настройки перед повторным сохранением.", "error");
335
+ continue;
336
+ }
337
+ if (latest.enabled) {
338
+ await api.setEnabled({ enabled: false });
339
+ }
340
+ if (disposed) {
341
+ return;
342
+ }
343
+ await api.save(draft);
344
+ draft = undefined;
345
+ notify("Подключение сохранено. Проверьте связь и включите защиту в меню.", "success");
346
+ current = latest.tokenPresent ? "test" : "key";
347
+ }
348
+ else if (choice === "test") {
349
+ if (!status.configured) {
350
+ continue;
351
+ }
352
+ notify("Проверка сохранённого подключения к Guard…");
353
+ const result = (await api.test());
354
+ if (disposed) {
355
+ return;
356
+ }
357
+ await context.ui.dialog.alert({
358
+ title: "Проверка сохранённого подключения",
359
+ message: result.connected
360
+ ? `Guard доступен. Решение для тестового текста: ${result.decision}. Проверка не включает защиту.`
361
+ : result.code === "timeout"
362
+ ? "Guard не ответил вовремя. Проверьте доступность сервера и повторите проверку."
363
+ : "Связь с Guard не подтверждена. Проверьте сохранённые адрес, проект и ключ.",
364
+ });
365
+ if (result.connected && !status.enabled) {
366
+ current = "toggle";
367
+ }
368
+ }
369
+ }
370
+ catch {
371
+ // A mutation may have committed. Re-read status; never retry the write automatically.
372
+ notify("Результат действия неизвестен. Меню обновит статус; проверьте его перед повтором.", "error");
373
+ }
374
+ }
375
+ }
376
+ catch {
377
+ notify("Не удалось открыть диалог LLMGuard. Откройте меню заново.", "error");
378
+ }
379
+ finally {
380
+ open = false;
381
+ draft = undefined;
382
+ }
383
+ }
384
+ context.keymap.layer(() => ({
385
+ mode: "global",
386
+ commands: [
387
+ {
388
+ id: "llmguard.settings",
389
+ title: "LLMGuard: настройки и статус",
390
+ group: "LLMGuard",
391
+ palette: true,
392
+ slash: { name: "llmguard" },
393
+ run: panel,
394
+ },
395
+ ],
396
+ }));
397
+ return () => {
398
+ disposed = true;
399
+ if (open) {
400
+ context.ui.dialog.clear();
401
+ }
402
+ };
403
+ }
404
+ export default {
405
+ id: "llmguard.tui",
406
+ setup(context) {
407
+ const client = context.client.rpc(settingsRPC);
408
+ const location = context.location ?? context.data.location.default();
409
+ const abort = new AbortController();
410
+ const options = (timeout = 10000) => ({
411
+ location,
412
+ signal: AbortSignal.any([abort.signal, AbortSignal.timeout(timeout)]),
413
+ });
414
+ const cleanup = registerConnectionsTUI(context, {
415
+ connections: () => client.connections({}, options()),
416
+ saveConnection: (input) => client.saveConnection(input, options()),
417
+ testConnection: (input) => client.testConnection(input, options(190000)),
418
+ connect: (input) => client.connect(input, options(190000)),
419
+ setEnabled: (input) => client.setEnabled(input, options()),
420
+ });
421
+ // UI lifetime does not own server enforcement: other clients may share it.
422
+ return () => {
423
+ abort.abort();
424
+ cleanup();
425
+ };
426
+ },
427
+ };
package/v1/hooks.d.ts ADDED
@@ -0,0 +1,81 @@
1
+ import { createOpenCodeRuntime, type PluginOptions, type ToolInput } from "../runtime/runtime.js";
2
+ import type { JsonValue } from "../runtime/json.js";
3
+ import { type Message } from "./projection.js";
4
+ export declare function createOpenCodeHooks(options: PluginOptions): {
5
+ checkModelTexts: (name: string, texts: string[], session: string | null, sourcePayload?: Record<string, JsonValue>) => Promise<string[]>;
6
+ "experimental.chat.messages.transform": (_input: object, output: {
7
+ messages: Message[];
8
+ }) => Promise<void>;
9
+ "experimental.chat.system.transform": (input: {
10
+ sessionID?: string;
11
+ }, output: {
12
+ system: string[];
13
+ }) => Promise<void>;
14
+ "tool.execute.before": (input: ToolInput, output: {
15
+ args: unknown;
16
+ }) => Promise<undefined>;
17
+ "tool.execute.after": (input: ToolInput, output: {
18
+ output: string;
19
+ title: string;
20
+ metadata: unknown;
21
+ }) => Promise<void>;
22
+ "experimental.text.complete": (input: {
23
+ sessionID: string;
24
+ }, output: {
25
+ text: string;
26
+ }) => Promise<void>;
27
+ hasRestoration: (session: string) => boolean;
28
+ restoreText: (session: string, text: string) => string;
29
+ observeToolAfter: (tool: ToolInput, output: string) => Promise<void>;
30
+ demaskResponse: (session: string | null, response: Response, trace?: (reason: string) => void) => Promise<Response>;
31
+ event: ({ event, }: {
32
+ event: {
33
+ type: string;
34
+ properties?: {
35
+ info?: {
36
+ id?: string;
37
+ };
38
+ };
39
+ };
40
+ }) => Promise<void>;
41
+ dispose: () => Promise<void>;
42
+ };
43
+ export declare function createV1Hooks(runtime: ReturnType<typeof createOpenCodeRuntime>): {
44
+ checkModelTexts: (name: string, texts: string[], session: string | null, sourcePayload?: Record<string, JsonValue>) => Promise<string[]>;
45
+ "experimental.chat.messages.transform": (_input: object, output: {
46
+ messages: Message[];
47
+ }) => Promise<void>;
48
+ "experimental.chat.system.transform": (input: {
49
+ sessionID?: string;
50
+ }, output: {
51
+ system: string[];
52
+ }) => Promise<void>;
53
+ "tool.execute.before": (input: ToolInput, output: {
54
+ args: unknown;
55
+ }) => Promise<undefined>;
56
+ "tool.execute.after": (input: ToolInput, output: {
57
+ output: string;
58
+ title: string;
59
+ metadata: unknown;
60
+ }) => Promise<void>;
61
+ "experimental.text.complete": (input: {
62
+ sessionID: string;
63
+ }, output: {
64
+ text: string;
65
+ }) => Promise<void>;
66
+ hasRestoration: (session: string) => boolean;
67
+ restoreText: (session: string, text: string) => string;
68
+ observeToolAfter: (tool: ToolInput, output: string) => Promise<void>;
69
+ demaskResponse: (session: string | null, response: Response, trace?: (reason: string) => void) => Promise<Response>;
70
+ event: ({ event, }: {
71
+ event: {
72
+ type: string;
73
+ properties?: {
74
+ info?: {
75
+ id?: string;
76
+ };
77
+ };
78
+ };
79
+ }) => Promise<void>;
80
+ dispose: () => Promise<void>;
81
+ };
package/v1/hooks.js ADDED
@@ -0,0 +1,97 @@
1
+ import { createOpenCodeRuntime, } from "../runtime/runtime.js";
2
+ import { blocked } from "../runtime/errors.js";
3
+ import { snapshotObject, applyArgumentStrings, } from "../runtime/native-edit.js";
4
+ import { object } from "../runtime/errors.js";
5
+ import { messageProjection } from "./projection.js";
6
+ import { attachmentsForCheck } from "../runtime/attachments.js";
7
+ // Compatibility API for the v1 hook protocol; v2 calls the runtime directly.
8
+ export function createOpenCodeHooks(options) {
9
+ // A legacy Checker argument must never become a quiet TS-core bypass.
10
+ if (arguments.length !== 1) {
11
+ blocked();
12
+ }
13
+ return createV1Hooks(createOpenCodeRuntime(options));
14
+ }
15
+ // Internal assembly seam: tests exercise these hooks using an actual bridge
16
+ // and helper + mock Guard, never a Checker injected into the public facade.
17
+ export function createV1Hooks(runtime) {
18
+ return {
19
+ checkModelTexts: (name, texts, session, sourcePayload) => runtime.checkModelTexts(name, texts, session, sourcePayload),
20
+ "experimental.chat.messages.transform": async (_input, output) => {
21
+ const deadline = runtime.deadline();
22
+ const projection = messageProjection(output);
23
+ // Attachments are inspected only when the helper's policy says so.
24
+ const attachments = projection.attachments.length
25
+ ? await attachmentsForCheck(runtime, projection.attachments, deadline)
26
+ : undefined;
27
+ if (!projection.texts.length && !attachments) {
28
+ return;
29
+ }
30
+ await runtime.checkModelTexts("experimental.chat.messages.transform", projection.texts, projection.session, projection.sourcePayload, (candidate, replacements) => {
31
+ if (!projection.unchanged()) {
32
+ blocked();
33
+ }
34
+ projection.apply(candidate, replacements);
35
+ }, deadline, attachments);
36
+ },
37
+ "experimental.chat.system.transform": async (input, output) => {
38
+ const deadline = runtime.deadline();
39
+ const original = output.system;
40
+ const snapshot = [...original];
41
+ const texts = original.length ? [...original] : [""];
42
+ const session = input.sessionID;
43
+ await runtime.checkModelTexts("experimental.chat.system.transform", texts, session ?? null, undefined, (candidate) => {
44
+ if (output.system !== original ||
45
+ input.sessionID !== session ||
46
+ original.length !== snapshot.length ||
47
+ !original.every((text, i) => text === snapshot[i])) {
48
+ blocked();
49
+ }
50
+ // Preserve the public system-array replacement behavior, after all
51
+ // destinations have been checked and before bindings are published.
52
+ const descriptor = Object.getOwnPropertyDescriptor(output, "system");
53
+ if (!descriptor || !("value" in descriptor) || !descriptor.writable) {
54
+ blocked();
55
+ }
56
+ output.system = candidate;
57
+ }, deadline);
58
+ },
59
+ "tool.execute.before": async (input, output) => {
60
+ const deadline = runtime.deadline();
61
+ const original = object(output.args);
62
+ const unchanged = snapshotObject(original);
63
+ const tool = { ...input };
64
+ await runtime.checkToolArguments(tool, original, (candidate) => {
65
+ if (output.args !== original ||
66
+ !unchanged() ||
67
+ input.sessionID !== tool.sessionID ||
68
+ input.callID !== tool.callID ||
69
+ input.tool !== tool.tool) {
70
+ blocked();
71
+ }
72
+ applyArgumentStrings(original, candidate);
73
+ }, deadline);
74
+ // Preserve the v1 hook's Promise<undefined> public signature.
75
+ return undefined;
76
+ },
77
+ "tool.execute.after": async (input, output) => {
78
+ // Execution has happened. Guard only records the original result here;
79
+ // masking happens in the next model request. Deny cannot roll back the
80
+ // executed action and failures never withhold or throw.
81
+ await runtime.observeToolAfter(input, output.output);
82
+ },
83
+ "experimental.text.complete": async (input, output) => {
84
+ output.text = runtime.restoreText(input.sessionID, output.text);
85
+ },
86
+ hasRestoration: runtime.hasRestoration,
87
+ restoreText: runtime.restoreText,
88
+ observeToolAfter: runtime.observeToolAfter,
89
+ demaskResponse: runtime.demaskResponse,
90
+ event: async ({ event, }) => {
91
+ if (event.type === "session.deleted" && event.properties?.info?.id) {
92
+ await runtime.forgetSession(event.properties.info.id);
93
+ }
94
+ },
95
+ dispose: runtime.dispose,
96
+ };
97
+ }
@@ -0,0 +1,32 @@
1
+ import { type RecordValue } from "../runtime/errors.js";
2
+ import type { JsonValue } from "../runtime/json.js";
3
+ import type { AttachmentParam } from "../bridge/protocol.js";
4
+ export type Message = {
5
+ info: {
6
+ sessionID: string;
7
+ role?: unknown;
8
+ model?: unknown;
9
+ modelID?: unknown;
10
+ providerID?: unknown;
11
+ };
12
+ parts: RecordValue[];
13
+ };
14
+ export declare function messageProjection(output: {
15
+ messages: Message[];
16
+ }): {
17
+ texts: string[];
18
+ attachments: AttachmentParam[];
19
+ replaceAttachments(replacements: {
20
+ index: number;
21
+ data: Buffer;
22
+ }[]): void;
23
+ session: string | null;
24
+ sourcePayload: {
25
+ [key: string]: JsonValue;
26
+ } | undefined;
27
+ unchanged: () => boolean;
28
+ apply: (candidate: string[], replacements?: {
29
+ index: number;
30
+ data: Buffer;
31
+ }[]) => void;
32
+ };