@thready-web/dsh-bot-plugin 0.1.0-beta.2 → 0.1.0-beta.4

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.
@@ -17,7 +17,7 @@ const OUTPUT = {
17
17
  */
18
18
  export function workToolDefinitions(work, engine) {
19
19
  return [
20
- tool('foundations_dispatch', 'Hand a long job to a worker session. Available only on a bot. status=accepted means received, not yet dispatched. status=enqueued means it entered the execution queue, not that it has started. The return value is never started. ownerSessionId is ignored.', {
20
+ tool('foundations_dispatch', 'Hand a non-trivial job to a worker session. Prefer this over doing the work with bash, write, edit, or an official subagent in the main session. Available only on a bot. status=accepted means received, and may wait for an execution slot. status=enqueued means it entered the execution queue, not that it has started. queued=true means it is waiting for a slot and will start automatically when one is free. The return value is never started. A BUDGET error means both the slot cap and the queue cap are full; do not start the job in the main session. ownerSessionId is ignored.', {
21
21
  type: 'object',
22
22
  properties: {
23
23
  briefing: { type: 'string' },
@@ -65,7 +65,7 @@ export function workToolDefinitions(work, engine) {
65
65
  ownerSessionId: { type: 'string', description: 'Ignored.' },
66
66
  },
67
67
  }, (args, hostId) => work.cancelTicket(hostId, args), 'bot'),
68
- tool('foundations_grant', 'Grant more time or tokens to an unfinished ticket. wallMs and maxTokens are amounts to add, not a new total. A budget-exhausted notice is not a failure. deny=true refuses the grant and stops this round.', {
68
+ tool('foundations_grant', 'Grant more active runtime or tokens to an unfinished ticket. wallMs and maxTokens are amounts to ADD, not totals. Exhausted workers wait at the next safe loop boundary without expiry. Use current usage/required totals and headroom in the notice/result: insufficient grants remain paused, host ceilings cannot be raised. deny=true stops this round; do not redispatch a replacement.', {
69
69
  type: 'object',
70
70
  properties: {
71
71
  ticketId: { type: 'string' },