@ouro.bot/cli 0.1.0-alpha.866 → 0.1.0-alpha.867

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.json CHANGED
@@ -1,6 +1,13 @@
1
1
  {
2
2
  "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
3
3
  "versions": [
4
+ {
5
+ "version": "0.1.0-alpha.867",
6
+ "changes": [
7
+ "Butler awaits can now ask the owner to decide: resolve_await accepts verdict ask_owner with a plain-words question and 2 to 4 choices, which closes the await as asked_owner (once per await instance, at most 3 per requester per day) and sends the question to the owner's own Telegram chat as the Butler, instead of an await tick repeating verdict no forever on a confirmed dead download.",
8
+ "Butler awaits can now ask the owner to decide: resolve_await accepts verdict ask_owner with a plain-words question and 2 to 4 choices, which closes the await as asked_owner (once per await instance, at most 3 per non-owner requester per day) and sends the question to the owner's own Telegram chat as the Butler, instead of an await tick repeating verdict no forever on a confirmed dead download."
9
+ ]
10
+ },
4
11
  {
5
12
  "version": "0.1.0-alpha.866",
6
13
  "changes": [
@@ -1,5 +1,5 @@
1
1
  {
2
- "runtimeVersion": "0.1.0-alpha.866",
2
+ "runtimeVersion": "0.1.0-alpha.867",
3
3
  "bundleSchemaVersion": 3,
4
4
  "lastUpdated": "2026-09-03T00:00:00.000Z"
5
5
  }
@@ -1,7 +1,7 @@
1
1
  <?xml version="1.0"?>
2
2
  <Container version="2">
3
3
  <Name>ouro-butler</Name>
4
- <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.866</Repository>
4
+ <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.867</Repository>
5
5
  <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
6
6
  <Network>host</Network>
7
7
  <Shell>sh</Shell>
@@ -112,8 +112,10 @@ function isReplayWindowOpen(agentRoot, friendId, now = Date.now(), trustedUid =
112
112
  : Number.NaN;
113
113
  return Number.isFinite(expiresAt) && expiresAt > now && expiresAt <= now + exports.REPLAY_WINDOW_MAX_MS;
114
114
  }
115
- /** Appends one notice to the sink; throws when it cannot be written, so the caller refuses exactly as a failed Telegram send does. */
115
+ /** Appends one notice to the sink, once per notice id and friend (a retry after a crash adds nothing); throws when it cannot be written, so the caller refuses exactly as a failed Telegram send does. */
116
116
  function appendReplayNotice(agentRoot, notice, now = Date.now()) {
117
+ if (replayNoticeRecorded(agentRoot, notice.noticeId, notice.friendId))
118
+ return;
117
119
  fs.mkdirSync(replayDir(agentRoot), { recursive: true });
118
120
  const line = JSON.stringify({ at: new Date(now).toISOString(), ...notice });
119
121
  fs.appendFileSync(replaySinkPath(agentRoot), `${line}\n`, { mode: 0o600 });
@@ -33,7 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
33
33
  };
34
34
  })();
35
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.askedOwnerText = askedOwnerText;
36
37
  exports.createA2AAwaitOwnerDeliverer = createA2AAwaitOwnerDeliverer;
38
+ exports.defaultNotifyOwner = defaultNotifyOwner;
37
39
  const path = __importStar(require("path"));
38
40
  const friends_1 = require("@ouro.bot/friends");
39
41
  const identity_1 = require("../identity");
@@ -46,6 +48,13 @@ const runtime_1 = require("../../nerves/runtime");
46
48
  * sent as the owner or to the peer, and the notice id is the await's delivery id, so a retry cannot double-send.
47
49
  */
48
50
  const NOTICE_ID_MAX_BYTES = 512;
51
+ /** A question for the owner reads as the owner's own question, with a pointer to the request it is about; every other outcome is a follow-up report. */
52
+ function askedOwnerText(question, about) {
53
+ return `${question}\n\n(about the request from ${about})`;
54
+ }
55
+ function ownerNoticeText(request, from) {
56
+ return request.noticeKind === "asked_owner" ? askedOwnerText(request.content, from) : `Follow-up on a request from ${from}: ${request.content}`;
57
+ }
49
58
  function createA2AAwaitOwnerDeliverer(agentName, notifyOwner = defaultNotifyOwner(agentName)) {
50
59
  return async (request) => {
51
60
  if (!request.deliveryId || Buffer.byteLength(request.deliveryId) > NOTICE_ID_MAX_BYTES) {
@@ -54,12 +63,12 @@ function createA2AAwaitOwnerDeliverer(agentName, notifyOwner = defaultNotifyOwne
54
63
  try {
55
64
  const peer = await new friends_1.FileFriendStore(path.join((0, identity_1.getAgentRoot)(agentName), "friends")).get(request.friendId);
56
65
  const agentRoot = (0, identity_1.getAgentRoot)(agentName);
66
+ const from = peer?.name ?? "a connected agent";
57
67
  if ((0, replay_harness_1.isReplayWindowOpen)(agentRoot, request.friendId)) {
58
- (0, replay_harness_1.appendReplayNotice)(agentRoot, { noticeId: request.deliveryId, text: request.content, friendId: request.friendId });
68
+ (0, replay_harness_1.appendReplayNotice)(agentRoot, { noticeId: request.deliveryId, text: request.noticeKind === "asked_owner" ? ownerNoticeText(request, from) : request.content, friendId: request.friendId });
59
69
  return { status: "delivered_now", detail: "written to the replay sink (replay window open for this peer)" };
60
70
  }
61
- const from = peer?.name ?? "a connected agent";
62
- await notifyOwner({ noticeId: request.deliveryId, text: `Follow-up on a request from ${from}: ${request.content}` });
71
+ await notifyOwner({ noticeId: request.deliveryId, text: ownerNoticeText(request, from) });
63
72
  return { status: "delivered_now", detail: "sent to the owner's Telegram chat as the agent" };
64
73
  }
65
74
  catch (error) {
@@ -74,6 +74,9 @@ function resolveAlertKey(agentRoot, friendId, channel) {
74
74
  function buildAlertContent(awaitFile, reason, observation) {
75
75
  const condition = awaitFile.condition ?? awaitFile.name;
76
76
  const obs = readNonEmpty(observation);
77
+ if (reason === "asked_owner") {
78
+ return obs ? `${condition} — ${obs}` : `${condition} — I have asked the owner how to proceed.`;
79
+ }
77
80
  if (reason === "resolved") {
78
81
  return obs ? `${condition} — ready. ${obs}` : `${condition} — ready.`;
79
82
  }
@@ -120,14 +123,15 @@ async function deliverAwaitAlert(options) {
120
123
  });
121
124
  return { attempted: false, skipped: "no session key" };
122
125
  }
123
- const content = buildAlertContent(awaitFile, reason, observation);
126
+ const content = options.content ?? buildAlertContent(awaitFile, reason, observation);
124
127
  const delivery = await (0, cross_chat_delivery_1.deliverCrossChatMessage)({
125
128
  friendId,
126
129
  channel,
127
130
  key,
128
131
  content,
129
132
  ...(awaitFile.request_id ? { requestId: awaitFile.request_id } : {}),
130
- deliveryId: `await:${awaitFile.name}:${reason}`,
133
+ deliveryId: options.deliveryId ?? `await:${awaitFile.name}:${reason}`,
134
+ ...(reason === "asked_owner" ? { noticeKind: "asked_owner" } : {}),
131
135
  intent: "generic_outreach",
132
136
  }, deliveryDeps);
133
137
  (0, runtime_1.emitNervesEvent)({
@@ -39,7 +39,7 @@ const path = __importStar(require("path"));
39
39
  const frontmatter_1 = require("../../util/frontmatter");
40
40
  const runtime_1 = require("../../nerves/runtime");
41
41
  function isAwaitStatus(value) {
42
- return value === "pending" || value === "resolved" || value === "expired" || value === "canceled";
42
+ return value === "pending" || value === "resolved" || value === "expired" || value === "canceled" || value === "asked_owner";
43
43
  }
44
44
  function isAwaitMode(value) {
45
45
  return value === "full" || value === "quick";
@@ -121,6 +121,9 @@ function parseAwaitFile(content, filePath) {
121
121
  last_observation_at_expiry: nonEmptyString(frontmatter.last_observation_at_expiry),
122
122
  canceled_at: nonEmptyString(frontmatter.canceled_at),
123
123
  cancel_reason: nonEmptyString(frontmatter.cancel_reason),
124
+ ...(nonEmptyString(frontmatter.asked_at) ? { asked_at: nonEmptyString(frontmatter.asked_at) } : {}),
125
+ ...(nonEmptyString(frontmatter.ask_question) ? { ask_question: nonEmptyString(frontmatter.ask_question) } : {}),
126
+ ...(nonEmptyString(frontmatter.ask_choices) ? { ask_choices: nonEmptyString(frontmatter.ask_choices) } : {}),
124
127
  };
125
128
  }
126
129
  function formatFrontmatterValue(value) {
@@ -53,6 +53,7 @@ const session_events_1 = require("../heart/session-events");
53
53
  const runtime_1 = require("../nerves/runtime");
54
54
  const await_parser_1 = require("../heart/awaiting/await-parser");
55
55
  const await_alert_1 = require("../heart/awaiting/await-alert");
56
+ const friends_1 = require("@ouro.bot/friends");
56
57
  const a2a_await_delivery_1 = require("../heart/awaiting/a2a-await-delivery");
57
58
  const pending_1 = require("../mind/pending");
58
59
  const router_1 = require("../heart/external-events/router");
@@ -97,6 +98,15 @@ function relationshipScopeFor(ctx, awaitName) {
97
98
  }
98
99
  return { session: ctx.currentSession, requestId: ctx.relationshipAuthorization?.requestId };
99
100
  }
101
+ function readAwaitDoneDefinition(agentRoot, name) {
102
+ const filePath = awaitDoneFilePath(agentRoot, name);
103
+ try {
104
+ return (0, await_parser_1.parseAwaitFile)(fs.readFileSync(filePath, "utf-8"), filePath);
105
+ }
106
+ catch {
107
+ return null;
108
+ }
109
+ }
100
110
  function readAwaitDefinition(agentRoot, name) {
101
111
  const filePath = awaitFilePath(agentRoot, name);
102
112
  try {
@@ -135,6 +145,169 @@ function resolveDeliveryDeps(agentName) {
135
145
  const deps = injected.buildDeliveryDeps ? injected.buildDeliveryDeps(agentName) : defaultDeliveryDeps(agentName);
136
146
  return { ...deps, deliverers: { a2a: (0, a2a_await_delivery_1.createA2AAwaitOwnerDeliverer)(agentName), ...deps.deliverers } };
137
147
  }
148
+ const ASK_OWNER_MIN_CHOICES = 2;
149
+ const ASK_OWNER_MAX_CHOICES = 4;
150
+ function oneLine(value) {
151
+ return value.replace(/\s+/gu, " ").trim();
152
+ }
153
+ /**
154
+ * Validates an ask_owner request. The question and choices are collapsed to single lines because they are archived as
155
+ * frontmatter, and choices may not contain "|" because the archive joins them with " | ".
156
+ */
157
+ function parseAskOwner(question, choices) {
158
+ const cleanQuestion = typeof question === "string" ? oneLine(question) : "";
159
+ if (!cleanQuestion)
160
+ return { ok: false, error: "question is required for ask_owner: put the decision to the owner in plain words" };
161
+ if (!Array.isArray(choices) || choices.length < ASK_OWNER_MIN_CHOICES || choices.length > ASK_OWNER_MAX_CHOICES) {
162
+ return { ok: false, error: `ask_owner needs ${ASK_OWNER_MIN_CHOICES} to ${ASK_OWNER_MAX_CHOICES} choices` };
163
+ }
164
+ const cleanChoices = choices.map((choice) => typeof choice === "string" ? oneLine(choice) : "");
165
+ if (cleanChoices.some((choice) => !choice))
166
+ return { ok: false, error: "every ask_owner choice must be a non-empty string" };
167
+ if (cleanChoices.some((choice) => choice.includes("|")))
168
+ return { ok: false, error: 'ask_owner choices must not contain "|"' };
169
+ return { ok: true, question: cleanQuestion, choices: cleanChoices };
170
+ }
171
+ function formatOwnerQuestion(question, choices) {
172
+ return `${question}\n\n${choices.map((choice) => `- ${choice}`).join("\n")}`;
173
+ }
174
+ function failedAskOwner(agentName, name, error) {
175
+ const detail = error instanceof Error ? error.message : String(error);
176
+ (0, runtime_1.emitNervesEvent)({ level: "error", component: "repertoire", event: "repertoire.await_ask_owner_error", message: "ask_owner could not reach the owner", meta: { agent: agentName, name, error: detail } });
177
+ return JSON.stringify({ error: `the owner message could not be sent (${detail}); the await is still pending, so ask_owner can be retried` });
178
+ }
179
+ /** At most this many ask_owner closures per requester in a rolling day, so one requester cannot make the Butler pester the owner. */
180
+ const ASK_OWNER_DAILY_LIMIT = 3;
181
+ const ASK_OWNER_WINDOW_MS = 24 * 60 * 60 * 1000;
182
+ function askLedgerPath(agentRoot) {
183
+ return path.join(awaitingDir(agentRoot), ".asks.jsonl");
184
+ }
185
+ /** Every ask_owner closure is appended here, because the archive is overwritten when an await name is reused. */
186
+ function recordAsk(agentRoot, entry) {
187
+ fs.mkdirSync(awaitingDir(agentRoot), { recursive: true });
188
+ fs.appendFileSync(askLedgerPath(agentRoot), `${JSON.stringify(entry)}\n`, "utf-8");
189
+ }
190
+ function recentAskCount(agentRoot, filer, now) {
191
+ let raw;
192
+ try {
193
+ raw = fs.readFileSync(askLedgerPath(agentRoot), "utf-8");
194
+ }
195
+ catch {
196
+ return 0;
197
+ }
198
+ return raw.split("\n").filter((line) => {
199
+ try {
200
+ const entry = JSON.parse(line);
201
+ return (entry.filer ?? null) === filer && typeof entry.at === "string" && now - Date.parse(entry.at) < ASK_OWNER_WINDOW_MS;
202
+ }
203
+ catch {
204
+ return false;
205
+ }
206
+ }).length;
207
+ }
208
+ const askOwnerInFlight = new Set();
209
+ /** A friend store that cannot be read makes the filer unknown, which is never the owner; it must not fail the ask. */
210
+ async function lookupFiler(agentRoot, friendId) {
211
+ try {
212
+ const friend = friendId ? await new friends_1.FileFriendStore(path.join(agentRoot, "friends")).get(friendId) : null;
213
+ return { isOwner: Boolean(friend && friend.admissionState === "active" && friend.trustLevel === "family" && friend.capabilityProfileId === "sanctuary-owner"), name: friend?.name ?? null };
214
+ }
215
+ catch {
216
+ return { isOwner: false, name: null };
217
+ }
218
+ }
219
+ function delivered(alert) {
220
+ return alert?.delivery?.status === "delivered_now" || alert?.delivery?.status === "queued_for_later";
221
+ }
222
+ /**
223
+ * The await's condition cannot be met without the owner deciding. The owner is asked once, as the agent, in the
224
+ * owner's own chat, and only then is the await archived as asked_owner. One notice id per await instance ties every
225
+ * path together: the A2A owner delivery, the direct owner message and the replay sink all dedupe on it, so a retry after
226
+ * a crash between send and archive sends nothing twice. An await filed from A2A goes through the A2A owner delivery,
227
+ * which writes the owner notice (or the replay sink during a replay window); the direct notice is only the fallback
228
+ * when that path blocked or failed. When someone other than the owner filed the await, the text says whose request it is
229
+ * about, and a non-A2A filer is also told that the owner was asked (the obligation stays open if that could not be said).
230
+ */
231
+ async function askOwnerTool(name, observation, question, choices, existing, agentRoot, agentName) {
232
+ const parsed = parseAskOwner(question, choices);
233
+ if (!parsed.ok)
234
+ return JSON.stringify({ error: parsed.error });
235
+ const inFlightKey = `${agentRoot}\0${name}`;
236
+ if (askOwnerInFlight.has(inFlightKey))
237
+ return JSON.stringify({ error: `await "${name}" is already being asked; wait for the owner's reply instead of asking again` });
238
+ askOwnerInFlight.add(inFlightKey);
239
+ try {
240
+ const filerId = existing.filed_for_friend_id ?? null;
241
+ const filer = await lookupFiler(agentRoot, filerId);
242
+ if (!filer.isOwner && recentAskCount(agentRoot, filerId, Date.now()) >= ASK_OWNER_DAILY_LIMIT) {
243
+ return JSON.stringify({ error: `ask_owner limit reached: this requester has already had my owner asked ${ASK_OWNER_DAILY_LIMIT} times in the last day; do not retry ask_owner, resolve with verdict 'no' with an observation and keep polling` });
244
+ }
245
+ const isA2A = existing.filed_from === "a2a";
246
+ const noticeId = `await:${name}:asked_owner:${String(existing.created_at)}`;
247
+ const question = formatOwnerQuestion(parsed.question, parsed.choices);
248
+ const ownerText = filer.isOwner ? question : (0, a2a_await_delivery_1.askedOwnerText)(question, filer.name ?? (isA2A ? "a connected agent" : "a friend"));
249
+ let alert = null;
250
+ let sent = false;
251
+ if (isA2A) {
252
+ try {
253
+ alert = await (0, await_alert_1.deliverAwaitAlert)({ awaitFile: { ...existing, alert: "a2a" }, reason: "asked_owner", observation: question, content: question, deliveryId: noticeId, agentRoot, agentName, deliveryDeps: resolveDeliveryDeps(agentName) });
254
+ }
255
+ catch (error) {
256
+ (0, runtime_1.emitNervesEvent)({ level: "error", component: "repertoire", event: "repertoire.await_alert_error", message: "await alert delivery threw", meta: { agent: agentName, name, error: error instanceof Error ? error.message : String(error) } });
257
+ }
258
+ sent = delivered(alert);
259
+ }
260
+ if (!sent) {
261
+ try {
262
+ await (injected.notifyOwner ? injected.notifyOwner(agentName) : (0, a2a_await_delivery_1.defaultNotifyOwner)(agentName))({ noticeId, text: ownerText });
263
+ }
264
+ catch (error) {
265
+ return failedAskOwner(agentName, name, error);
266
+ }
267
+ }
268
+ let friendNotice = null;
269
+ const tellsFriend = !isA2A && !filer.isOwner && Boolean(filerId);
270
+ if (tellsFriend) {
271
+ try {
272
+ friendNotice = await (0, await_alert_1.deliverAwaitAlert)({ awaitFile: existing, reason: "asked_owner", observation: observation.trim(), content: `About "${existing.condition ?? name}": I have asked the owner how to proceed and will let you know what they decide.`, deliveryId: `${noticeId}:filer`, agentRoot, agentName, deliveryDeps: resolveDeliveryDeps(agentName) });
273
+ }
274
+ catch (error) {
275
+ (0, runtime_1.emitNervesEvent)({ level: "error", component: "repertoire", event: "repertoire.await_alert_error", message: "await alert delivery threw", meta: { agent: agentName, name, error: error instanceof Error ? error.message : String(error) } });
276
+ }
277
+ }
278
+ const askedAt = new Date().toISOString();
279
+ const archive = archiveAwait(agentRoot, name, {
280
+ status: "asked_owner",
281
+ asked_at: askedAt,
282
+ ask_question: parsed.question,
283
+ ask_choices: parsed.choices.join(" | "),
284
+ resolution_observation: observation.trim(),
285
+ });
286
+ /* v8 ignore next -- defensive: archiveAwait only fails on the file-disappears-mid-call race already covered by v8 ignore inside archiveAwait @preserve */
287
+ if (!archive.ok)
288
+ return JSON.stringify({ error: archive.error });
289
+ recordAsk(agentRoot, { filer: filerId, name, at: askedAt });
290
+ if (!tellsFriend || delivered(friendNotice))
291
+ fulfillAwaitObligation(agentRoot, archive.file);
292
+ (0, runtime_1.emitNervesEvent)({
293
+ component: "repertoire",
294
+ event: "repertoire.await_asked_owner",
295
+ message: "await closed by asking the owner",
296
+ meta: { agent: agentName, name, choices: parsed.choices.length },
297
+ });
298
+ const summary = (result) => result ? { attempted: result.attempted, status: result.delivery?.status ?? null, skipped: result.skipped ?? null } : null;
299
+ return JSON.stringify({
300
+ verdict: "ask_owner",
301
+ asked: true,
302
+ archived: awaitDoneFilePath(agentRoot, name),
303
+ alert: summary(alert),
304
+ ...(tellsFriend ? { filerNotice: summary(friendNotice) } : {}),
305
+ });
306
+ }
307
+ finally {
308
+ askOwnerInFlight.delete(inFlightKey);
309
+ }
310
+ }
138
311
  function fileAwait(args, agentRoot, agentName, sessionFriendId, sessionChannel, sessionKey, requestId) {
139
312
  const nameError = validateName(args.name);
140
313
  if (nameError)
@@ -245,23 +418,28 @@ function fulfillAwaitObligation(agentRoot, awaitFile) {
245
418
  if (awaitFile.obligation_id)
246
419
  (0, obligations_1.fulfillObligation)(agentRoot, awaitFile.obligation_id);
247
420
  }
248
- async function resolveAwaitTool(name, verdict, observation, agentRoot, agentName) {
421
+ async function resolveAwaitTool(name, verdict, observation, agentRoot, agentName, ask) {
249
422
  const nameError = validateName(name);
250
423
  if (nameError)
251
424
  return JSON.stringify({ error: nameError });
252
425
  const existing = readAwaitDefinition(agentRoot, name);
253
426
  if (!existing) {
427
+ if (verdict === "ask_owner" && readAwaitDoneDefinition(agentRoot, name)?.status === "asked_owner") {
428
+ return JSON.stringify({ error: `await "${name}" has already asked the owner and is closed; wait for the owner's reply instead of asking again` });
429
+ }
254
430
  return JSON.stringify({ error: `await "${name}" not found in awaiting/` });
255
431
  }
256
432
  if (existing.status !== "pending") {
257
433
  return JSON.stringify({ error: `await "${name}" is not pending (status: ${existing.status})` });
258
434
  }
259
- if (verdict !== "yes" && verdict !== "no") {
260
- return JSON.stringify({ error: `verdict must be exactly "yes" or "no" (got ${JSON.stringify(verdict)}); use "no" with an observation while still waiting` });
435
+ if (verdict !== "yes" && verdict !== "no" && verdict !== "ask_owner") {
436
+ return JSON.stringify({ error: `verdict must be exactly "yes", "no", or "ask_owner" (got ${JSON.stringify(verdict)}); use "no" with an observation while still waiting` });
261
437
  }
262
438
  if (!observation || !observation.trim()) {
263
439
  return JSON.stringify({ error: "observation is required" });
264
440
  }
441
+ if (verdict === "ask_owner")
442
+ return askOwnerTool(name, observation, ask?.question, ask?.choices, existing, agentRoot, agentName);
265
443
  if (verdict === "no") {
266
444
  // Update runtime state via recordAwaitCheck-style write
267
445
  const { recordAwaitCheck } = await Promise.resolve().then(() => __importStar(require("../heart/awaiting/await-runtime-state")));
@@ -535,13 +713,15 @@ exports.awaitingToolDefinitions = [
535
713
  type: "function",
536
714
  function: {
537
715
  name: "resolve_await",
538
- description: "Resolve a pending await with a verdict. verdict='yes' archives and fires the alert. verdict='no' records the observation and continues polling; still pending is always 'no'.",
716
+ description: "Resolve a pending await with a verdict. verdict='yes' archives and fires the alert. verdict='no' records the observation and continues polling; still pending is always 'no'. verdict='ask_owner' (with question and choices) closes the await and asks my owner to decide, exactly once: use it when the condition cannot be met without the owner deciding, for example a confirmed dead download. Never use ask_owner for \"not yet\" or a merely suspected problem; that is 'no'.",
539
717
  parameters: {
540
718
  type: "object",
541
719
  properties: {
542
720
  name: { type: "string", description: "Await name (filename stem)." },
543
- verdict: { type: "string", enum: ["yes", "no"], description: "Exactly 'yes' if the condition is met. Exactly 'no' for anything else, including still pending, not yet, or unable to tell: send 'no' with an observation and polling continues." },
721
+ verdict: { type: "string", enum: ["yes", "no", "ask_owner"], description: "Exactly 'yes' if the condition is met. Exactly 'no' for anything else, including still pending, not yet, or unable to tell: send 'no' with an observation and polling continues. 'ask_owner' only when the condition cannot be met without the owner deciding; it needs question and choices." },
544
722
  observation: { type: "string", description: "One-line summary of what I saw this tick." },
723
+ question: { type: "string", description: "Only for ask_owner: the decision I need from my owner, in plain words." },
724
+ choices: { type: "array", items: { type: "string" }, minItems: 2, maxItems: 4, description: "Only for ask_owner: 2 to 4 short options the owner can pick from." },
545
725
  },
546
726
  required: ["name", "verdict", "observation"],
547
727
  },
@@ -575,7 +755,7 @@ exports.awaitingToolDefinitions = [
575
755
  if (!binding?.active)
576
756
  return JSON.stringify({ error: "resolve_await is limited to the current relationship request or bound external event" });
577
757
  }
578
- return resolveAwaitTool(a.name, a.verdict, a.observation, agentRoot, agentName);
758
+ return resolveAwaitTool(a.name, a.verdict, a.observation, agentRoot, agentName, { question: a.question, choices: a.choices });
579
759
  },
580
760
  riskProfile: {
581
761
  mutates: ["durable_state_write", "external_side_effect"],
@@ -54,5 +54,6 @@ function buildAwaitTurnMessage(options) {
54
54
  }
55
55
  lines.push("");
56
56
  lines.push("look around and decide. if the condition is met, call resolve_await with verdict='yes' and a one-line observation. otherwise call resolve_await with verdict='no' and a one-line observation of what i saw this tick.");
57
+ lines.push("verdicts: 'yes' (condition met), 'no' (not yet or unsure), 'ask_owner' (only when the condition cannot be met without my owner deciding, e.g. a confirmed dead download; give a plain question and 2-4 choices).");
57
58
  return lines.join("\n");
58
59
  }
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@ouro.bot/cli",
3
- "version": "0.1.0-alpha.866",
3
+ "version": "0.1.0-alpha.867",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@ouro.bot/cli",
9
- "version": "0.1.0-alpha.866",
9
+ "version": "0.1.0-alpha.867",
10
10
  "dependencies": {
11
11
  "@anthropic-ai/sdk": "^0.78.0",
12
12
  "@azure/identity": "^4.13.0",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ouro.bot/cli",
3
- "version": "0.1.0-alpha.866",
3
+ "version": "0.1.0-alpha.867",
4
4
  "engines": {
5
5
  "node": ">=22"
6
6
  },