@theoremjs/agents 0.3.5-next.930.gfb5cd40 → 0.3.5-next.932.g295cc67
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.
|
@@ -82,10 +82,16 @@ export interface StageResult {
|
|
|
82
82
|
abort?: boolean | {
|
|
83
83
|
reason?: string;
|
|
84
84
|
};
|
|
85
|
-
/**
|
|
85
|
+
/**
|
|
86
|
+
* `pre_tool`: refuse the call. `post_tool`: replace the result with this failure.
|
|
87
|
+
* `details`, a JSON object, become `failure.details`: the model reads them, and the guardrails
|
|
88
|
+
* read them first. Details that are not a JSON object are a `deny_invalid` warning, and the call
|
|
89
|
+
* is still refused, without details.
|
|
90
|
+
*/
|
|
86
91
|
deny?: {
|
|
87
92
|
code?: string;
|
|
88
93
|
message?: string;
|
|
94
|
+
details?: Record<string, unknown>;
|
|
89
95
|
};
|
|
90
96
|
/** `pre_tool` only — request a confirm/permission gate. */
|
|
91
97
|
confirm?: true | {
|
|
@@ -166,6 +172,7 @@ export interface StageApplyOutput {
|
|
|
166
172
|
deny?: {
|
|
167
173
|
code: string;
|
|
168
174
|
message: string;
|
|
175
|
+
details?: Record<string, unknown>;
|
|
169
176
|
};
|
|
170
177
|
confirm?: {
|
|
171
178
|
summary?: string;
|
package/esm/src/kernel/stages.js
CHANGED
|
@@ -191,7 +191,19 @@ function applyDenyField(result, stage, out) {
|
|
|
191
191
|
const message = typeof result.deny.message === 'string' && result.deny.message.trim()
|
|
192
192
|
? result.deny.message.trim()
|
|
193
193
|
: 'Tool execution not authorized'; // labels-exempt: developer contract / internal diagnostic — not end-user or model copy (P2)
|
|
194
|
-
|
|
194
|
+
const details = result.deny.details;
|
|
195
|
+
if (details === undefined) {
|
|
196
|
+
out.deny = { code, message };
|
|
197
|
+
}
|
|
198
|
+
else if (isRecord(details) && jsonValueSchema.safeParse(details).success) {
|
|
199
|
+
out.deny = { code, message, details };
|
|
200
|
+
}
|
|
201
|
+
else {
|
|
202
|
+
// why: A refusal stands even when its details are bad; only the details are dropped.
|
|
203
|
+
out.deny = { code, message };
|
|
204
|
+
// labels-exempt: developer contract / internal diagnostic — not end-user or model copy (P2)
|
|
205
|
+
warn(out.warnings, 'deny_invalid', 'deny', 'deny.details must be a JSON object');
|
|
206
|
+
}
|
|
195
207
|
}
|
|
196
208
|
}
|
|
197
209
|
function applyLabelFailedField(result, stage, out) {
|
|
@@ -215,6 +215,7 @@ function* reviseAfterStages(post, guard, reproject, failure) {
|
|
|
215
215
|
code: post.deny.code,
|
|
216
216
|
kind: 'blocked',
|
|
217
217
|
message: post.deny.message,
|
|
218
|
+
...(post.deny.details ? { details: post.deny.details } : {}),
|
|
218
219
|
});
|
|
219
220
|
}
|
|
220
221
|
if (post.mutate && 'details' in post.mutate) {
|
|
@@ -139,7 +139,12 @@ async function* runPreToolStages(args) {
|
|
|
139
139
|
return {
|
|
140
140
|
ok: false,
|
|
141
141
|
kind: 'failed',
|
|
142
|
-
failure: {
|
|
142
|
+
failure: {
|
|
143
|
+
code: applied.deny.code,
|
|
144
|
+
kind: 'blocked',
|
|
145
|
+
message: applied.deny.message,
|
|
146
|
+
...(applied.deny.details ? { details: applied.deny.details } : {}),
|
|
147
|
+
},
|
|
143
148
|
denied: true,
|
|
144
149
|
};
|
|
145
150
|
}
|
|
@@ -1262,6 +1262,16 @@ export interface TurnWiring {
|
|
|
1262
1262
|
* image and speech turns run through it.
|
|
1263
1263
|
*/
|
|
1264
1264
|
prepare?: (turn: NormalizedTurnRequest) => TurnRequest | Promise<TurnRequest>;
|
|
1265
|
+
/**
|
|
1266
|
+
* Whether a wake may run: a reply to background results that no person asked for. Your limit on
|
|
1267
|
+
* those replies, such as a cap or quiet hours. `host` is the turn's `host`, and `conversation` is
|
|
1268
|
+
* the conversation reference the wake was posted with. A wake you refuse is not tried again for
|
|
1269
|
+
* the same results; the next message reads them. Unset, every wake runs.
|
|
1270
|
+
*/
|
|
1271
|
+
authorizeWake?: (wake: {
|
|
1272
|
+
host: unknown;
|
|
1273
|
+
conversation: string;
|
|
1274
|
+
}) => boolean | Promise<boolean>;
|
|
1265
1275
|
}
|
|
1266
1276
|
/** A profile projected for a client, with its secrets and server-only fields removed. */
|
|
1267
1277
|
export interface ProjectedProfile extends ProfileModelFields {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@theoremjs/agents",
|
|
3
|
-
"version": "0.3.5-next.
|
|
3
|
+
"version": "0.3.5-next.932.g295cc67",
|
|
4
4
|
"description": "A flat TypeScript agent kernel for typed profiles, deterministic turn execution, registered tools, provider adapters, guardrails, and host-injected traces.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agent",
|