@alvin0/ai-agent-sdk-core 0.1.3 → 0.1.5

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 (149) hide show
  1. package/README.md +13 -1
  2. package/dist/agent/accounting/ledger.js +1 -1
  3. package/dist/agent/accounting/ledger.js.map +1 -1
  4. package/dist/agent/accounting/report.d.ts +1 -1
  5. package/dist/agent/define/definition.d.ts +27 -6
  6. package/dist/agent/define/definition.d.ts.map +1 -1
  7. package/dist/agent/define/definition.js +1 -1
  8. package/dist/agent/define/definition.js.map +1 -1
  9. package/dist/agent/define/session/accounting.js +1 -1
  10. package/dist/agent/define/session/accounting.js.map +1 -1
  11. package/dist/agent/define/session/model-config.js +1 -1
  12. package/dist/agent/define/session/model-config.js.map +1 -1
  13. package/dist/agent/define/session/types.d.ts +6 -3
  14. package/dist/agent/define/session/types.d.ts.map +1 -1
  15. package/dist/agent/define/session.d.ts +25 -2
  16. package/dist/agent/define/session.d.ts.map +1 -1
  17. package/dist/agent/define/session.js +1 -1
  18. package/dist/agent/define/session.js.map +1 -1
  19. package/dist/agent/loop/admission.js +2 -0
  20. package/dist/agent/loop/admission.js.map +1 -0
  21. package/dist/agent/loop/events.d.ts +4 -0
  22. package/dist/agent/loop/events.d.ts.map +1 -1
  23. package/dist/agent/loop/program.js +2 -0
  24. package/dist/agent/loop/program.js.map +1 -0
  25. package/dist/agent/loop/run-turn.d.ts.map +1 -1
  26. package/dist/agent/loop/run-turn.js +1 -1
  27. package/dist/agent/loop/run-turn.js.map +1 -1
  28. package/dist/agent/loop/schedule.d.ts.map +1 -1
  29. package/dist/agent/loop/schedule.js +2 -2
  30. package/dist/agent/loop/schedule.js.map +1 -1
  31. package/dist/agent/loop/tool-call-support.js +2 -0
  32. package/dist/agent/loop/tool-call-support.js.map +1 -0
  33. package/dist/agent/loop/turn/config.js +1 -1
  34. package/dist/agent/loop/turn/config.js.map +1 -1
  35. package/dist/agent/loop/turn/hooks.js +1 -1
  36. package/dist/agent/loop/turn/hooks.js.map +1 -1
  37. package/dist/agent/loop/turn/model-request-boundary.js +2 -0
  38. package/dist/agent/loop/turn/model-request-boundary.js.map +1 -0
  39. package/dist/agent/loop/turn/model-round.js +1 -1
  40. package/dist/agent/loop/turn/model-round.js.map +1 -1
  41. package/dist/agent/loop/turn/step-projection.js +2 -0
  42. package/dist/agent/loop/turn/step-projection.js.map +1 -0
  43. package/dist/agent/loop/turn/types.d.ts +6 -0
  44. package/dist/agent/loop/turn/types.d.ts.map +1 -1
  45. package/dist/agent/memory/compaction.d.ts.map +1 -1
  46. package/dist/agent/memory/compaction.js +1 -1
  47. package/dist/agent/memory/compaction.js.map +1 -1
  48. package/dist/agent/memory/context-optimizer.d.ts +61 -0
  49. package/dist/agent/memory/context-optimizer.d.ts.map +1 -0
  50. package/dist/agent/memory/context-optimizer.js +4 -0
  51. package/dist/agent/memory/context-optimizer.js.map +1 -0
  52. package/dist/agent/memory/memory.js +1 -1
  53. package/dist/agent/memory/memory.js.map +1 -1
  54. package/dist/agent/mode/run-agent.d.ts +15 -1
  55. package/dist/agent/mode/run-agent.d.ts.map +1 -1
  56. package/dist/agent/mode/run-agent.js +2 -2
  57. package/dist/agent/mode/run-agent.js.map +1 -1
  58. package/dist/agent/skill/provider/snapshot.js +1 -1
  59. package/dist/agent/team/managed.d.ts +33 -64
  60. package/dist/agent/team/managed.d.ts.map +1 -1
  61. package/dist/agent/team/managed.js +6 -3
  62. package/dist/agent/team/managed.js.map +1 -1
  63. package/dist/agent/team/team.d.ts +2 -0
  64. package/dist/agent/team/team.d.ts.map +1 -1
  65. package/dist/agent/team/team.js +1 -1
  66. package/dist/agent/team/team.js.map +1 -1
  67. package/dist/agent/team/types.d.ts +1 -0
  68. package/dist/agent/team/types.d.ts.map +1 -1
  69. package/dist/agent/tool/action-fusion.d.ts +30 -0
  70. package/dist/agent/tool/action-fusion.d.ts.map +1 -0
  71. package/dist/agent/tool/action-fusion.js +2 -0
  72. package/dist/agent/tool/action-fusion.js.map +1 -0
  73. package/dist/agent/tool/capture.js +1 -1
  74. package/dist/agent/tool/capture.js.map +1 -1
  75. package/dist/agent/tool/definition.d.ts +8 -0
  76. package/dist/agent/tool/definition.d.ts.map +1 -1
  77. package/dist/agent/tool/definition.js.map +1 -1
  78. package/dist/agent/tool/evidence-reducer.d.ts +41 -0
  79. package/dist/agent/tool/evidence-reducer.d.ts.map +1 -0
  80. package/dist/agent/tool/evidence-reducer.js +7 -0
  81. package/dist/agent/tool/evidence-reducer.js.map +1 -0
  82. package/dist/agent/tool/nested.d.ts +117 -0
  83. package/dist/agent/tool/nested.d.ts.map +1 -0
  84. package/dist/agent/tool/nested.js +2 -0
  85. package/dist/agent/tool/nested.js.map +1 -0
  86. package/dist/agent/tool/output-budget.d.ts.map +1 -1
  87. package/dist/agent/tool/output-budget.js +2 -2
  88. package/dist/agent/tool/output-budget.js.map +1 -1
  89. package/dist/agent/tool/output-schema.js +2 -0
  90. package/dist/agent/tool/output-schema.js.map +1 -0
  91. package/dist/agent/tool/pipeline.d.ts +7 -0
  92. package/dist/agent/tool/pipeline.d.ts.map +1 -1
  93. package/dist/agent/tool/pipeline.js +2 -2
  94. package/dist/agent/tool/pipeline.js.map +1 -1
  95. package/dist/agent/tool/program-results.js +2 -0
  96. package/dist/agent/tool/program-results.js.map +1 -0
  97. package/dist/agent.d.ts +6 -2
  98. package/dist/agent.js +1 -1
  99. package/dist/composition/agent/definition.js +1 -1
  100. package/dist/composition/agent/definition.js.map +1 -1
  101. package/dist/composition/agent/options.js +1 -1
  102. package/dist/composition/agent/options.js.map +1 -1
  103. package/dist/composition/agent/session.js +1 -1
  104. package/dist/composition/agent/session.js.map +1 -1
  105. package/dist/composition/agent/types.d.ts +17 -10
  106. package/dist/composition/agent/types.d.ts.map +1 -1
  107. package/dist/composition/runtime/owner.js +1 -1
  108. package/dist/composition/runtime/owner.js.map +1 -1
  109. package/dist/composition/runtime/types.d.ts +7 -1
  110. package/dist/composition/runtime/types.d.ts.map +1 -1
  111. package/dist/composition/tool-source/snapshot.js +1 -1
  112. package/dist/contract/adapter.d.ts +1 -1
  113. package/dist/contract/call-config.d.ts +8 -1
  114. package/dist/contract/call-config.d.ts.map +1 -1
  115. package/dist/contract/call-config.js +1 -1
  116. package/dist/contract/call-config.js.map +1 -1
  117. package/dist/contract/generate-options.d.ts +5 -0
  118. package/dist/contract/generate-options.d.ts.map +1 -1
  119. package/dist/contract/model-info.d.ts +26 -7
  120. package/dist/contract/model-info.d.ts.map +1 -1
  121. package/dist/errors/model-error.d.ts +0 -1
  122. package/dist/errors/model-error.d.ts.map +1 -1
  123. package/dist/errors/model-error.js +1 -1
  124. package/dist/errors/model-error.js.map +1 -1
  125. package/dist/index.d.ts +4 -3
  126. package/dist/index.js +1 -1
  127. package/dist/memory.d.ts +2 -1
  128. package/dist/memory.js +1 -1
  129. package/dist/observability/bus.js +1 -1
  130. package/dist/observation/report.d.ts +11 -0
  131. package/dist/observation/report.d.ts.map +1 -1
  132. package/dist/observation/report.js.map +1 -1
  133. package/dist/primitives/version.d.ts +1 -1
  134. package/dist/primitives/version.js +1 -1
  135. package/dist/primitives/version.js.map +1 -1
  136. package/dist/provider.d.ts +1 -1
  137. package/dist/runtime/model-call-handle.js +1 -1
  138. package/dist/runtime/model-call-handle.js.map +1 -1
  139. package/dist/runtime/model-metadata.js +1 -1
  140. package/dist/runtime/model-metadata.js.map +1 -1
  141. package/dist/runtime/model-stream.js +1 -1
  142. package/dist/runtime/model-stream.js.map +1 -1
  143. package/dist/runtime/registry.d.ts +7 -1
  144. package/dist/runtime/registry.d.ts.map +1 -1
  145. package/dist/runtime/registry.js +1 -1
  146. package/dist/runtime/registry.js.map +1 -1
  147. package/dist/tools.d.ts +4 -1
  148. package/dist/tools.js +1 -1
  149. package/package.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"program.js","names":[],"sources":["../../../src/agent/loop/program.ts"],"sourcesContent":["/** Programs: the scheduler-granted port through which one tool calls others. Internal to the loop. */\nimport type { ToolAdmission } from './admission.ts'\nimport {\n emitEvent, errorCode, immutableResult, messageOf, now, raceWithSignal, teardownFailure, withApprovalEvents,\n type ToolCallHost,\n} from './tool-call-support.ts'\nimport { waitForSettlement } from '../../async/index.ts'\nimport { ToolCallId, type JsonValue } from '../../primitives/index.ts'\nimport { snapshotJsonValue } from '../../primitives/json-snapshot.ts'\nimport type { ToolDefinition, ToolExecutionResult } from '../tool/definition.ts'\nimport { TOOL_ERROR_CODES, ToolError } from '../tool/errors.ts'\nimport {\n NESTED_TOOL_ERROR_CODES,\n type NestedCallOptions, type NestedLoadResult, type NestedToolDescriptor, type NestedToolPort,\n type NestedToolResult, type ProgramGrant,\n} from '../tool/nested.ts'\nimport { checkOutputSchema, outputSchemaSupported } from '../tool/output-schema.ts'\nimport {\n authorizeToolCall, dispatchAuthorizedToolCall, finalizeToolCall, prepareToolCall, toolFailure,\n type ToolCallRequest,\n} from '../tool/pipeline.ts'\nimport type { ProgramResultStore } from '../tool/program-results.ts'\nimport { createSpanId, type TraceRef } from '../trace/trace.ts'\n\n/** What every slot of one step shares. */\nexport interface StepRuntime {\n readonly admission: ToolAdmission\n readonly maxDurationMs: number\n readonly teardownTimeoutMs: number\n readonly maxResultBytes: number\n readonly programs: ReadonlyMap<string, ProgramGrant>\n readonly programResults: ProgramResultStore | undefined\n}\n\n/** Largest serialized argument object a program may send to one child. */\nexport const MAX_NESTED_ARGUMENT_BYTES = 64 * 1024\nconst ARGUMENT_LIMITS = Object.freeze({\n maxBytes: MAX_NESTED_ARGUMENT_BYTES, maxDepth: 64, maxNodes: 32_768,\n maxArrayItems: 16_384, maxObjectFields: 16_384, maxKeyBytes: MAX_NESTED_ARGUMENT_BYTES,\n})\n\nexport function validPrograms(programs: ReadonlyMap<string, ProgramGrant> | undefined): ReadonlyMap<string, ProgramGrant> {\n const valid = new Map<string, ProgramGrant>()\n for (const [name, grant] of programs ?? []) {\n if (!Number.isSafeInteger(grant.maxCalls) || grant.maxCalls < 1) {\n throw new RangeError(`program \"${name}\" maxCalls must be a positive safe integer`)\n }\n const allow = Object.freeze([...new Set(grant.allow)])\n for (const target of allow) {\n if (typeof target !== 'string' || target.length === 0) throw new TypeError(`program \"${name}\" grants an invalid tool name`)\n // No recursion and no program-in-program: nested admission is one level.\n if (programs?.has(target) === true) throw new RangeError(`program \"${name}\" may not call program \"${target}\"`)\n }\n valid.set(name, Object.freeze({ allow, maxCalls: grant.maxCalls }))\n }\n return valid\n}\n\n/**\n * One running program: the port its body calls, and the latch that outlives\n * whatever the program does with a refusal.\n *\n * A child goes through the same reservation, policy, approval, checkpoint,\n * execution, post-policy and byte bound as a model-issued call. What it does\n * NOT do is enter history or spill: the program's own result is what the model\n * reads, and that result is bounded like any other.\n */\nexport class ProgramRun {\n readonly port: NestedToolPort\n /** A fatal child failure, rethrown as the outer call's own. */\n fatal: unknown\n private closedCode: string | undefined\n private closedMessage = ''\n private readonly shutdown = new AbortController()\n private inFlight: Promise<NestedToolResult> | undefined\n private requests = 0\n private sequence = 0\n private unbindExecutionSignal: (() => void) | undefined\n /** Definition identity per granted name, captured when the program started. */\n private readonly captured: ReadonlyMap<string, ToolDefinition | undefined>\n\n constructor(\n private readonly options: ToolCallHost,\n private readonly step: StepRuntime,\n private readonly grant: ProgramGrant,\n private readonly outer: { readonly call: ToolCallRequest; readonly trace: TraceRef; readonly signal: AbortSignal },\n ) {\n this.captured = new Map(grant.allow.map(name => [name, options.catalog.get(name)]))\n const descriptors = Object.freeze(grant.allow.flatMap(name => {\n const definition = this.captured.get(name)\n return definition === undefined ? [] : [describe(definition)]\n }))\n this.port = Object.freeze({\n call: (toolName: string, args: JsonValue, callOptions?: NestedCallOptions) => this.request(toolName, args, callOptions?.retain === true),\n catalog: () => descriptors,\n load: (handle: string) => this.load(handle),\n release: (handle: string) => this.step.programResults?.release(handle, this.outer.call.toolName) === true,\n })\n }\n\n /** Stop admitting children and wait for the one in flight, if any. */\n async close(teardownTimeoutMs: number): Promise<boolean> {\n this.unbindExecutionSignal?.()\n this.latch(NESTED_TOOL_ERROR_CODES.CLOSED, 'the program has ended')\n this.shutdown.abort(new Error('program closed'))\n const inFlight = this.inFlight\n return inFlight === undefined || await waitForSettlement(inFlight, teardownTimeoutMs)\n }\n\n /** Stop without waiting; the outer call is already failing. */\n abort(reason: unknown): void {\n this.unbindExecutionSignal?.()\n this.latch(NESTED_TOOL_ERROR_CODES.CLOSED, 'the program was cancelled')\n this.shutdown.abort(reason)\n }\n\n /** The body signal also carries the program tool's own timeout. */\n bindExecutionSignal(signal: AbortSignal): void {\n this.unbindExecutionSignal?.()\n const abort = () => this.abort(signal.reason)\n this.unbindExecutionSignal = () => {\n signal.removeEventListener('abort', abort)\n this.unbindExecutionSignal = undefined\n }\n if (signal.aborted) abort()\n else signal.addEventListener('abort', abort, { once: true })\n }\n\n private load(handle: string): NestedLoadResult {\n const store = this.step.programResults\n if (typeof handle !== 'string' || store === undefined || this.fatal !== undefined || this.closedCode !== undefined) {\n return refuse(NESTED_TOOL_ERROR_CODES.RESULT_UNAVAILABLE, 'no retained result is available')\n }\n // The owner is the program tool, never anything the program says it is.\n let loaded: ReturnType<ProgramResultStore['load']>\n try { loaded = store.load(handle, this.outer.call.toolName, name => this.options.catalog.get(name)) } catch (error) {\n this.fatal ??= ToolError.fatal(messageOf(error), errorCode(error), { cause: error })\n this.latch(NESTED_TOOL_ERROR_CODES.CLOSED, 'retained-result authority could not be checked')\n throw this.fatal\n }\n if (loaded.kind === 'unavailable') {\n return refuse(NESTED_TOOL_ERROR_CODES.RESULT_UNAVAILABLE, `the retained result is ${loaded.reason === 'unknown' ? 'not available to this program' : loaded.reason}`)\n }\n return Object.freeze({ ok: true, value: loaded.value, schema: loaded.schema, provenance: loaded.provenance })\n }\n\n private async request(toolName: string, args: JsonValue, retain = false): Promise<NestedToolResult> {\n if (this.fatal !== undefined || this.closedCode !== undefined) return this.refusal()\n if (this.inFlight !== undefined) {\n return refuse(NESTED_TOOL_ERROR_CODES.CALL_IN_FLIGHT, 'a program may run one tool call at a time')\n }\n this.requests++\n if (this.requests > this.grant.maxCalls) {\n this.latch(NESTED_TOOL_ERROR_CODES.CALL_CAP, `the program reached its limit of ${this.grant.maxCalls} tool calls`)\n return this.refusal()\n }\n let resolve!: (result: NestedToolResult) => void\n let reject!: (error: unknown) => void\n const pending = new Promise<NestedToolResult>((done, fail) => { resolve = done; reject = fail })\n // Hold the port before run() can synchronously call catalog/observation code.\n // Start run synchronously too: arguments are still captured at call time.\n this.inFlight = pending\n void this.run(toolName, args, retain).then(resolve, error => {\n this.fatal ??= ToolError.fatal(messageOf(error), errorCode(error), { cause: error })\n this.latch(NESTED_TOOL_ERROR_CODES.CLOSED, 'an earlier tool call failed fatally')\n reject(error)\n })\n try { return await pending } finally { this.inFlight = undefined }\n }\n\n private async run(toolName: string, args: JsonValue, retain: boolean): Promise<NestedToolResult> {\n if (!this.captured.has(toolName)) {\n return refuse(NESTED_TOOL_ERROR_CODES.NOT_ALLOWED, `the program may not call \"${toolName}\"`)\n }\n if (!this.current(toolName)) return this.stale(toolName)\n const definition = this.captured.get(toolName)\n if (definition === undefined) {\n return refuse(TOOL_ERROR_CODES.UNKNOWN_TOOL, `no tool named \"${toolName}\" is available`)\n }\n let rawArguments: string | undefined\n try { rawArguments = JSON.stringify(snapshotJsonValue(args, ARGUMENT_LIMITS)) } catch { rawArguments = undefined }\n if (rawArguments === undefined || new TextEncoder().encode(rawArguments).byteLength > MAX_NESTED_ARGUMENT_BYTES) {\n return refuse(NESTED_TOOL_ERROR_CODES.INVALID_ARGUMENTS, 'tool arguments must be JSON within the size limit')\n }\n const call: ToolCallRequest = Object.freeze({\n callId: ToolCallId(`${this.outer.call.callId}:${String(++this.sequence)}`), toolName, rawArguments,\n })\n const trace: TraceRef = { traceId: this.outer.trace.traceId, spanId: createSpanId(), parentSpanId: this.outer.trace.spanId }\n const signal = AbortSignal.any([this.outer.signal, this.shutdown.signal])\n await emitEvent(this.options, {\n type: 'span-start', trace, at: now(), name: `execute_tool ${toolName}`, kind: 'execute_tool',\n attributes: {\n 'gen_ai.operation.name': 'execute_tool', 'gen_ai.tool.name': toolName, 'gen_ai.tool.call.id': call.callId,\n 'sdk.tool.parent_call_id': this.outer.call.callId,\n },\n input: rawArguments,\n })\n let result: ToolExecutionResult\n try {\n result = immutableResult(await this.execute(call, definition, trace, signal), this.step.maxResultBytes)\n } catch (error: unknown) {\n // Tool bodies already become results inside the pipeline. What escapes\n // here — a throwing interceptor, a teardown timeout, a fatal ToolError —\n // fails a model-issued call's whole turn, so it fails the program too.\n this.fatal ??= ToolError.fatal(messageOf(error), errorCode(error), { cause: error })\n this.latch(NESTED_TOOL_ERROR_CODES.CLOSED, 'an earlier tool call failed fatally')\n result = toolFailure(messageOf(error), errorCode(error))\n }\n // Authority is checked again at publication: a result produced under a\n // grant that changed while it ran is not handed to the program.\n const publishable = this.current(toolName) && !signal.aborted\n if (!this.current(toolName)) this.latch(NESTED_TOOL_ERROR_CODES.STALE_CATALOG, `\"${toolName}\" changed while the program was running`)\n await emitEvent(this.options, {\n type: 'span-end', trace, at: now(),\n status: signal.aborted ? 'aborted' : result.isError ? 'error' : 'success',\n ...result.isError ? { error: { type: 'ToolError', message: result.error.message, code: result.error.code } } : {},\n })\n if (!publishable) return this.refusal()\n if (result.isError) return refuse(result.error.code, result.error.message)\n // Policy may have removed the value. Rendered text is for the model and is\n // never parsed back into data the policy chose not to release.\n if (result.value === undefined) {\n return refuse(NESTED_TOOL_ERROR_CODES.STRUCTURED_OUTPUT_UNAVAILABLE, `\"${toolName}\" returned no structured value the program may read`)\n }\n const schema = definition.experimentalOutputSchema\n const verdict = schema === undefined ? 'unsupported' : checkOutputSchema(schema, result.value)\n if (verdict === 'invalid') {\n return refuse(NESTED_TOOL_ERROR_CODES.OUTPUT_SCHEMA_MISMATCH, `\"${toolName}\" returned a value outside its declared output schema`)\n }\n const checked = verdict === 'valid' ? 'validated' as const : 'unchecked' as const\n if (!retain) return Object.freeze({ ok: true, value: result.value, schema: checked })\n const saved = this.step.programResults?.save({\n owner: this.outer.call.toolName, value: result.value, definition, schema: checked,\n provenance: { toolName, callId: String(call.callId), parentCallId: String(this.outer.call.callId) },\n }) ?? { refused: 'closed' as const }\n return Object.freeze({\n ok: true, value: result.value, schema: checked,\n ...'handle' in saved ? { handle: saved.handle } : { retainRefused: saved.refused },\n })\n }\n\n private async execute(\n call: ToolCallRequest,\n definition: ToolDefinition,\n trace: TraceRef,\n signal: AbortSignal,\n ): Promise<ToolExecutionResult> {\n const { teardownTimeoutMs } = this.step\n const prepared = prepareToolCall({\n catalog: this.options.catalog, call, position: this.options.position, signal, teardownTimeoutMs,\n parentCallId: this.outer.call.callId,\n ...(this.options.logger === undefined ? {} : { logger: this.options.logger }),\n ...this.options.interceptors === undefined ? {} : { interceptors: this.options.interceptors },\n ...this.options.approvals === undefined ? {} : { approvals: this.options.approvals },\n })\n const ticket = this.step.admission.reserve(definition.budgetExempt === true)\n if (ticket === undefined) {\n const message = 'the turn has spent its tool-call budget'\n this.latch(NESTED_TOOL_ERROR_CODES.BUDGET_EXHAUSTED, message)\n return toolFailure(message, NESTED_TOOL_ERROR_CODES.BUDGET_EXHAUSTED)\n }\n try {\n const authorizing = authorizeToolCall(withApprovalEvents(this.options, prepared, trace))\n let authorization: Awaited<typeof authorizing>\n try {\n authorization = await raceWithSignal(authorizing, signal)\n } catch (error: unknown) {\n if (!signal.aborted) throw error\n if (!await waitForSettlement(authorizing, teardownTimeoutMs)) {\n throw teardownFailure(call.toolName, 'authorization', teardownTimeoutMs, error)\n }\n return toolFailure('the call was cancelled', TOOL_ERROR_CODES.ABORTED)\n }\n if (authorization.kind === 'final') return authorization.result\n try {\n const checkpointing = Promise.resolve(this.options.checkpoint?.({\n kind: 'before-tool-dispatch', call, parentCallId: this.outer.call.callId,\n snapshot: this.options.history.snapshot(), signal,\n ...(this.options.logger === undefined ? {} : { logger: this.options.logger }),\n }))\n try { await raceWithSignal(checkpointing, signal) }\n catch (error: unknown) {\n if (!signal.aborted) throw error\n if (!await waitForSettlement(checkpointing, teardownTimeoutMs)) {\n throw teardownFailure(call.toolName, 'checkpoint', teardownTimeoutMs, error)\n }\n }\n } catch (error: unknown) {\n if (error instanceof ToolError && error.code === TOOL_ERROR_CODES.TEARDOWN_TIMEOUT) throw error\n return toolFailure(`history checkpoint failed: ${messageOf(error)}`, TOOL_ERROR_CODES.CHECKPOINT_FAILED)\n }\n // Approval and checkpoint both await. Whatever changed meanwhile decides.\n if (!this.current(call.toolName)) {\n const message = `\"${call.toolName}\" changed while the program was running`\n this.latch(NESTED_TOOL_ERROR_CODES.STALE_CATALOG, message)\n return toolFailure(message, NESTED_TOOL_ERROR_CODES.STALE_CATALOG)\n }\n if (this.fatal !== undefined || signal.aborted) return toolFailure('the program was cancelled', TOOL_ERROR_CODES.ABORTED)\n ticket.confirm()\n const executing = dispatchAuthorizedToolCall(authorization.call)\n void executing.catch(() => undefined)\n const executed = await settleWithin(executing, signal, teardownTimeoutMs, call.toolName, 'execution')\n const finalized = await settleWithin(\n finalizeToolCall(authorization.call, executed), signal, teardownTimeoutMs, call.toolName, 'finalization',\n )\n return finalized\n } finally {\n ticket.release()\n }\n }\n\n private current(toolName: string): boolean {\n return this.options.catalog.get(toolName) === this.captured.get(toolName)\n }\n\n private stale(toolName: string): NestedToolResult {\n this.latch(NESTED_TOOL_ERROR_CODES.STALE_CATALOG, `\"${toolName}\" changed after the program started`)\n return this.refusal()\n }\n\n private latch(code: string, message: string): void {\n if (this.closedCode !== undefined) return\n this.closedCode = code\n this.closedMessage = message\n }\n\n private refusal(): NestedToolResult {\n return refuse(this.closedCode ?? NESTED_TOOL_ERROR_CODES.CLOSED, this.closedMessage || 'the program is closed')\n }\n}\n\nexport function describe(definition: ToolDefinition): NestedToolDescriptor {\n const schema = definition.experimentalOutputSchema\n return Object.freeze({\n name: definition.name, description: definition.description, parameters: definition.parameters,\n output: schema === undefined ? 'unknown' : outputSchemaSupported(schema) ? 'declared' : 'unsupported',\n ...schema === undefined ? {} : { outputSchema: schema },\n })\n}\n\nexport function refuse(code: string, message: string): { readonly ok: false; readonly code: string; readonly message: string } {\n return Object.freeze({ ok: false, code, message })\n}\n\n/** Wait for one stage; on cancellation, give it the teardown allowance to settle. */\nexport async function settleWithin(\n pending: Promise<ToolExecutionResult>,\n signal: AbortSignal,\n teardownTimeoutMs: number,\n toolName: string,\n stage: string,\n): Promise<ToolExecutionResult> {\n try {\n return await raceWithSignal(pending, signal)\n } catch (error: unknown) {\n if (!signal.aborted) throw error\n if (!await waitForSettlement(pending, teardownTimeoutMs)) throw teardownFailure(toolName, stage, teardownTimeoutMs, error)\n return toolFailure('the call was cancelled', TOOL_ERROR_CODES.ABORTED)\n }\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"run-turn.d.ts","names":[],"sources":["../../../src/agent/loop/run-turn.ts"],"mappings":";;;;iBA0BgB,QAAQ,SAAS,iBAAiB,cAAc"}
1
+ {"version":3,"file":"run-turn.d.ts","names":[],"sources":["../../../src/agent/loop/run-turn.ts"],"mappings":";;;;iBA4BgB,QAAQ,SAAS,iBAAiB,cAAc"}
@@ -1,2 +1,2 @@
1
- import{detachedFrozen as e}from"../../primitives/snapshot.js";import{waitForSettlement as t}from"../../async/settlement.js";import{createSpanId as n,createTraceId as r}from"../../observation/context.js";import{createUserMessage as i}from"../../message/message.js";import{authoritativeTokenUsage as a,budgetTokenTotal as o,summarizeModelCallUsage as s}from"../accounting/usage.js";import{ContextSectionRuntime as c}from"../context/section.js";import{AwaitedEventQueue as l}from"./queue.js";import{runToolCalls as ee}from"./schedule.js";import{positiveFinite as u,resolveBounds as d,snapshotRunTurnOptions as f}from"./turn/config.js";import{codedRuntimeError as p,errorCodeOf as m,messageOf as h,now as g}from"./turn/common.js";import{runHook as te,runOptionalHook as ne}from"./turn/hooks.js";import{emitAssistantContent as _,maintenanceEmitter as v,textOf as y}from"./turn/content.js";import{repeatKey as b,repeatedSuffixCycle as re,toolActionPattern as ie}from"./turn/repetition.js";import{accountingUsageStop as x}from"./turn/usage-stop.js";import{modelRound as S}from"./turn/model-round.js";function C(e){return e.toolChoice===`none`?!1:(e.tools?.names().length??0)>0||(e.nativeTools?.length??0)>0}function w(n){return{async*[Symbol.asyncIterator](){let r=f(n),i=new l,a=new AbortController,o=u(r.teardownTimeoutMs??3e4,`teardownTimeoutMs`),s=T(r,r.signal===void 0?a.signal:AbortSignal.any([r.signal,a.signal]),t=>i.push(e(t))).then(()=>i.close(),e=>i.fail(e));try{for(;;){let e=await i.take();if(e.done)break;yield e.value}await s}finally{if(a.abort(Error(`turn event consumer stopped`)),i.close(),!await t(s,o))throw p(`turn producer ignored cancellation for more than ${o}ms`,`TURN_TEARDOWN_TIMEOUT`,a.signal.reason)}}}}async function T(e,t,l){let u=d(e.bounds),f=u.maxTotalTokens===`auto`?1/0:u.maxTotalTokens,p=u.maxSteps===`auto`?1/0:u.maxSteps,w=e.trace?.traceId??r(),T={traceId:w,spanId:n(),parentSpanId:e.trace?.parentSpanId??null},E=Math.max(1,e.history.entries().filter(e=>e.event.kind===`user`&&e.event.message.source.kind===`user`).length),D=g(),O=0,k=0,ae=[...u.toolBudgetRemindAt].filter(e=>e>0&&e<u.maxToolCalls).sort((e,t)=>t-e),A=0,j=0,M,N=!1,P=0,F=0,I=``,L=[],R,z,B,V=[],H=v(l,T),oe=t=>{let n=i({source:{kind:`app`,producer:`tool-loop-budget-guard`},content:[{type:`text`,text:t}]}),r=M;if(r!==void 0)try{M=e.history.append({kind:`user`,message:n},{op:`replace`,from:r,to:r,targets:[r]}).seq;return}catch{M=void 0}M=e.history.append({kind:`user`,message:n}).seq},U=e.contextSections===void 0||e.contextSections.length===0?void 0:new c({sections:e.contextSections,history:e.history,...e.logger===void 0?{}:{logger:e.logger},guard:(n,r)=>te(n,e,t,r),scope:{agentId:e.trace?.agentId,conversationId:e.trace?.conversationId}}),W=[],G=!1,K=!1,q=C(e),se=e.outputFormat?.type===`json_schema`&&q,J=e.accounting?.startOperation(`turn`,{data:{turn:E,model:e.config.model}}),Y=!1,X,Z=()=>{if(t.aborted)return{kind:`aborted`};let n=x(e.accounting);if(n!==void 0)return n;if(X!==void 0)return X;let r=o(s(L));return r!==void 0&&r>=f?{kind:`budget-exhausted`,budget:`tokens`,forcedFinalAnswer:!1}:void 0};try{await l({type:`span-start`,trace:T,at:D,name:`invoke_agent ${e.trace?.agentId??`agent`}`,kind:`invoke_agent`,attributes:{"gen_ai.operation.name":`invoke_agent`,"gen_ai.agent.id":e.trace?.agentId??`agent`,"gen_ai.agent.name":e.trace?.agentName??e.trace?.agentId??`agent`,"gen_ai.request.model":e.config.model,...e.trace?.conversationId===void 0?{}:{"gen_ai.conversation.id":e.trace.conversationId}}}),G=!0,await l({type:`turn-start`,turn:E,trace:T});turnLifecycle:for(;;){for(;R===void 0&&O<p&&!t.aborted&&(R=Z(),R===void 0);){let n=o(s(L));if(u.maxTotalTokens!==`auto`&&n!==void 0){let t=[.5,.75,.9].filter(e=>n>=f*e).length;if(t>P){P=t;let r=Math.max(0,f-n);e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-token-guard`},content:[{type:`text`,text:`Token budget: ${r} of ${u.maxTotalTokens} aggregate tokens remain. Each request also spends input tokens on the accumulated context. `+(t>=2?`Stop broad exploration. `:`Prioritize outstanding verification and reporting. `)+`Reserve capacity for the required self-check, honest todo reconciliation and substantive final report. State unavailable evidence and unfinished work; do not claim it is verified. No extra model call is allowed after the hard token limit.`}]})})}}!N&&O>0&&p-O<=2&&(N=!0,e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-step-guard`},content:[{type:`text`,text:`${p-O} work steps remain. Finish essential verification, update any task list honestly, and submit the result if required. Summarize findings, evidence, and unfinished work; do not start new exploration.`}]})})),U!==void 0&&(await U.reconcile(O,W,t),W=[]);let r=O+1,a=await S(e,t,l,H,T,E,r,se?`process`:e.outputFormat?.type===`json_schema`?`final`:`standard`);if(O++,a.report!==void 0&&L.push(a.report),a.message!==void 0&&(e.history.append({kind:`assistant`,message:a.message,...a.finish.kind===`aborted`?{interrupted:!0}:{},...a.usage===void 0?{}:{usage:a.usage}}),await l({type:`assistant-message`,message:a.message,trace:a.trace}),await _(a,l),I=y(a.message.content)),X=x(e.accounting)??(a.usageRequired?{kind:`error`,failure:{message:`provider usage is required by the configured run policy`,code:`USAGE_REQUIRED`}}:a.usageUnavailable?{kind:`usage-unavailable`,modelCallId:a.report?.modelCallId??`unknown`}:void 0),t.aborted||a.finish.kind===`aborted`){R={kind:`aborted`};break}if(a.finish.kind===`error`&&X!==void 0){R={kind:`error`,failure:a.finish.failure};break}if(a.usageRequired&&(a.calls.length===0||e.tools===void 0)){R=X;break}if(a.finish.kind===`error`&&!a.usageRequired){if(R=Z(),R!==void 0)break;let n=await ne(e.hooks?.onRequestError,[{turn:E,step:r,failure:a.finish.failure,snapshot:e.history.snapshot(),signal:t,...e.logger===void 0?{}:{logger:e.logger},emit:H}],e,t,`onRequestError`),i=x(e.accounting);if(i!==void 0){R=t.aborted?{kind:`aborted`}:i;break}if(n===`retry`&&O<p)continue;R={kind:`error`,failure:a.finish.failure};break}if(a.finish.kind===`max-tokens`&&!a.usageRequired){R={kind:`max-tokens`};break}if(a.calls.length===0&&a.usageUnavailable){R=x(e.accounting)??{kind:`usage-unavailable`,modelCallId:a.report?.modelCallId??`unknown`};break}if(a.calls.length===0&&se){if(R=Z(),R!==void 0)break;e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`structured-output-finalizer`},content:[{type:`text`,text:`The process phase is complete. Return the final answer now in the requested output format. Do not call tools.`}]})});let n=await S(e,t,l,H,T,E,O+1,`final`);O++,n.report!==void 0&&L.push(n.report),n.message!==void 0&&(e.history.append({kind:`assistant`,message:n.message,...n.usage===void 0?{}:{usage:n.usage}}),await l({type:`assistant-message`,message:n.message,trace:n.trace}),await _(n,l),I=y(n.message.content)),R=n.finish.kind===`aborted`?{kind:`aborted`}:n.finish.kind===`error`?{kind:`error`,failure:n.finish.failure}:n.finish.kind===`max-tokens`?{kind:`max-tokens`}:n.usageRequired?{kind:`error`,failure:{message:`provider usage is required by the configured run policy`,code:`USAGE_REQUIRED`}}:n.usageUnavailable?x(e.accounting)??{kind:`usage-unavailable`,modelCallId:n.report?.modelCallId??`unknown`}:{kind:`completed`};break}if(a.droppedDuplicateCalls!==void 0&&e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-duplicate-guard`},content:[{type:`text`,text:`You reused the tool-call id ${a.droppedDuplicateCalls.map(e=>`'${e}'`).join(`, `)}. A result pairs to exactly one call, so the repeat was not run and only the first call of that id has a result. Give every call its own id, and call again if you still need what the dropped one would have done.`}]})}),a.calls.length===0||e.tools===void 0){R={kind:`completed`};break}let c=a.calls.filter(t=>e.tools?.get(t.toolName)?.budgetExempt!==!0).length,d=Math.max(0,u.maxToolCalls-k),m=B,h=a.calls.map(e=>{let t=b(e),n=m?.key===t?m.count+1:1;return m={key:t,count:n},n}).some(e=>e>=u.repeatToolLimit),g=ie(a.calls),v=re([...V,g],u.maxToolCycleLength),C=v!==void 0&&v.repetitions>=u.toolCycleLimit,w=s(L),D=o(w),M=D!==void 0&&D>=f,z=h||C||M||a.usageRequired,G=M?`tokens`:C?`tool-call-cycle`:h?`repeated-tool-call`:a.usageRequired?`usage-required`:`tool-calls`,K=u.onExhausted!==`continue`,q=await ee({calls:a.calls,catalog:e.tools,history:e.history,position:{turn:E,step:r,...e.accounting===void 0?{}:{runId:e.accounting.runId},...e.trace?.conversationId===void 0?{}:{conversationId:e.trace.conversationId}},signal:t,parentTrace:T,maxParallel:u.maxParallel,dispatchLimit:z?0:K?d:a.calls.length,declineReason:G,maxResultBytes:u.maxToolResultBytes,maxResultTokens:u.maxToolResultTokens,resultOverflow:u.toolResultOverflow,...e.spillStore===void 0?{}:{spillStore:e.spillStore},maxDurationMs:u.maxToolDurationMs,teardownTimeoutMs:u.toolTeardownTimeoutMs,...e.logger===void 0?{}:{logger:e.logger},...e.interceptors===void 0?{}:{interceptors:e.interceptors},...e.approvals===void 0?{}:{approvals:e.approvals},...e.accounting===void 0?{}:{accounting:e.accounting},emit:l,...e.hooks?.checkpoint===void 0?{}:{checkpoint:n=>te(Promise.resolve(e.hooks?.checkpoint?.(n)),e,t,`checkpoint`)}});U!==void 0&&q.results.length===a.calls.length&&W.push(...a.calls.map((e,t)=>({toolName:e.toolName,rawArguments:e.rawArguments,failed:q.results[t]?.isError??!0}))),k+=q.budgeted;let J=Math.max(0,u.maxToolCalls-k),Y=ae.filter(e=>J<=e).length;if(Y>A&&J>0&&(A=Y,oe(`Tool budget: ${J} of ${u.maxToolCalls} calls remain in this turn. Stop broad exploration, make the necessary edits, and reserve calls for`+(K?` verification. When the budget runs out no further work call will run, so finish with what you can still verify.`:` verification. Past the budget you are expected to be wrapping up, not opening new lines of work.`))),!K&&J===0){let e=Math.floor(k/u.maxToolCalls);e>j&&(j=e,oe(`Tool budget spent: ${k} calls made against a budget of ${u.maxToolCalls}. Do not start new substantive work. Finish what is in flight, verify what you can, and answer — stating plainly what is unverified or unfinished.`))}await l({type:`step-end`,turn:E,step:r,trace:a.trace}),V.push(g);let ce=h;for(let t=0;t<a.calls.length;t++){let n=a.calls[t],r=q.results[t];if(n===void 0||r===void 0)continue;F=r.isError?F+1:0;let o=b(n),s=B?.key===o?B.count+1:1;B={key:o,count:s},s===u.repeatToolWarningAt&&e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-repeat-guard`},content:[{type:`text`,text:`You have called ${n.toolName} with the same arguments ${s} consecutive times. Reassess before repeating it.`}]})}),s>=u.repeatToolLimit&&(ce=!0)}if(v?.repetitions===u.toolCycleWarningAt&&e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-cycle-guard`},content:[{type:`text`,text:`Tool-use pattern repeated ${v.repetitions} times across ${v.period} step(s). Reassess the approach and identify concrete new evidence before continuing.`}]})}),q.concluded){R={kind:`concluded-by-tool`,toolName:q.concludedBy??`unknown`};break}if(t.aborted){R={kind:`aborted`};break}if(a.usageRequired){R=X;break}if(a.usageUnavailable){R=x(e.accounting)??{kind:`usage-unavailable`,modelCallId:a.report?.modelCallId??`unknown`};break}let Q,$=u.maxTotalTokens!==`auto`&&u.finalReportReserveTokens>0&&D!==void 0&&D>=f-u.finalReportReserveTokens;if(M||$?Q=`tokens`:C?Q=`tool-call-cycle`:K&&c>d?Q=`tool-calls`:F>=u.maxConsecutiveToolErrors?Q=`consecutive-tool-errors`:ce?Q=`repeated-tool-call`:O>=p&&(Q=`steps`),Q!==void 0){let n=(Q!==`tokens`||$&&!M)&&u.onExhausted!==`stop`&&Z()===void 0;if(n){let n=await S(e,t,l,H,T,E,O+1,`forced-final`);if(O++,n.report!==void 0&&L.push(n.report),n.message!==void 0&&(e.history.append({kind:`assistant`,message:n.message,...n.usage===void 0?{}:{usage:n.usage}}),await l({type:`assistant-message`,message:n.message,trace:n.trace}),await _(n,l),I=y(n.message.content)),n.finish.kind===`aborted`){R={kind:`aborted`};break}if(n.finish.kind===`error`){R={kind:`error`,failure:n.finish.failure};break}if(n.finish.kind===`max-tokens`){R={kind:`max-tokens`};break}if(n.usageRequired){R={kind:`error`,failure:{message:`provider usage is required by the configured run policy`,code:`USAGE_REQUIRED`}};break}if(n.usageUnavailable){R=x(e.accounting)??{kind:`usage-unavailable`,modelCallId:n.report?.modelCallId??`unknown`};break}}R={kind:`budget-exhausted`,budget:Q,forcedFinalAnswer:n,...Q===`tokens`&&$&&!M?{trigger:`report-reserve`}:{}}}}R===void 0&&(R=t.aborted?{kind:`aborted`}:{kind:`budget-exhausted`,budget:`steps`,forcedFinalAnswer:!1});let n=s(L),r=a(n),c={reason:R,text:I,steps:O,usageReport:n,toolCalls:k,traceId:w,...r===void 0?{}:{usage:r}},d=e.history.entries().length,m=R.kind===`completed`&&O<p&&Z()===void 0;if(await ne(e.hooks?.onTurnEnd,[{outcome:c,snapshot:e.history.snapshot(),canContinue:m}],e,t,`onTurnEnd`),m&&e.history.entries().length>d&&!t.aborted){R=void 0;continue turnLifecycle}z=c;break}await l({type:`span-end`,trace:T,at:g(),status:z.reason.kind===`error`?`error`:z.reason.kind===`aborted`?`aborted`:`success`,output:{reason:z.reason,text:I},...z.usage===void 0?{}:{usage:z.usage},...z.reason.kind===`error`?{error:{type:`ModelError`,message:z.reason.failure.message,code:z.reason.failure.code}}:{}}),K=!0,J!==void 0&&(e.accounting?.endOperation(J,z.reason.kind===`error`?`error`:z.reason.kind===`aborted`?`aborted`:`success`,{data:{reason:z.reason.kind,steps:O,toolCalls:k}}),Y=!0),await l({type:`turn-end`,outcome:z,trace:T})}catch(n){let r=m(n);throw G&&!K&&await l({type:`span-end`,trace:T,at:g(),status:t.aborted?`aborted`:`error`,error:{type:n instanceof Error?n.name:`RuntimeError`,message:h(n),...r===void 0?{}:{code:r}}}).catch(()=>void 0),J!==void 0&&!Y&&(e.accounting?.endOperation(J,t.aborted?`aborted`:`error`,{error:n}),Y=!0),n}}export{w as runTurn};
1
+ import{detachedFrozen as e}from"../../primitives/snapshot.js";import{waitForSettlement as t}from"../../async/settlement.js";import{createSpanId as n,createTraceId as r}from"../../observation/context.js";import{createUserMessage as i}from"../../message/message.js";import{authoritativeTokenUsage as a,budgetTokenTotal as o,summarizeModelCallUsage as s}from"../accounting/usage.js";import{ContextSectionRuntime as c}from"../context/section.js";import{AwaitedEventQueue as l}from"./queue.js";import{captureProgramGrants as u}from"../tool/nested.js";import{scheduleToolCalls as ee}from"./schedule.js";import{ProgramResultStore as d}from"../tool/program-results.js";import{positiveFinite as f,resolveBounds as p,snapshotRunTurnOptions as m}from"./turn/config.js";import{codedRuntimeError as h,errorCodeOf as g,messageOf as _,now as v}from"./turn/common.js";import{runHook as y,runOptionalHook as te}from"./turn/hooks.js";import{emitAssistantContent as b,maintenanceEmitter as ne,textOf as x}from"./turn/content.js";import{repeatKey as re,repeatedSuffixCycle as ie,toolActionPattern as ae}from"./turn/repetition.js";import{accountingUsageStop as S}from"./turn/usage-stop.js";import{modelRound as C}from"./turn/model-round.js";function w(e){return e.toolChoice===`none`?!1:(e.tools?.names().length??0)>0||(e.nativeTools?.length??0)>0}function T(n){return{async*[Symbol.asyncIterator](){let r=m(n),i=new l,a=new AbortController,o=f(r.teardownTimeoutMs??3e4,`teardownTimeoutMs`),s=E(r,r.signal===void 0?a.signal:AbortSignal.any([r.signal,a.signal]),t=>i.push(e(t))).then(()=>i.close(),e=>i.fail(e));try{for(;;){let e=await i.take();if(e.done)break;yield e.value}await s}finally{if(a.abort(Error(`turn event consumer stopped`)),i.close(),!await t(s,o))throw h(`turn producer ignored cancellation for more than ${o}ms`,`TURN_TEARDOWN_TIMEOUT`,a.signal.reason)}}}}async function E(e,t,l){let f=p(e.bounds),m=f.maxTotalTokens===`auto`?1/0:f.maxTotalTokens,h=f.maxSteps===`auto`?1/0:f.maxSteps,T=e.trace?.traceId??r(),E={traceId:T,spanId:n(),parentSpanId:e.trace?.parentSpanId??null},D=Math.max(1,e.history.entries().filter(e=>e.event.kind===`user`&&e.event.message.source.kind===`user`).length),O=v(),k=0,A=0,oe=[...f.toolBudgetRemindAt].filter(e=>e>0&&e<f.maxToolCalls).sort((e,t)=>t-e),se=0,j=0,M,N=!1,P=0,F=0,I=``,L=[],R,z,B,ce=[],V=ne(l,E),le=t=>{let n=i({source:{kind:`app`,producer:`tool-loop-budget-guard`},content:[{type:`text`,text:t}]}),r=M;if(r!==void 0)try{M=e.history.append({kind:`user`,message:n},{op:`replace`,from:r,to:r,targets:[r]}).seq;return}catch{M=void 0}M=e.history.append({kind:`user`,message:n}).seq},H=e.contextSections===void 0||e.contextSections.length===0?void 0:new c({sections:e.contextSections,history:e.history,...e.logger===void 0?{}:{logger:e.logger},guard:(n,r)=>y(n,e,t,r),scope:{agentId:e.trace?.agentId,conversationId:e.trace?.conversationId}}),U=[],W=!1,G=!1,K=w(e),q=e.experimentalPrograms===void 0?void 0:u(e.experimentalPrograms),J=q===void 0?void 0:new d,ue=e.outputFormat?.type===`json_schema`&&K,Y=e.accounting?.startOperation(`turn`,{data:{turn:D,model:e.config.model}}),X=!1,Z,Q=()=>{if(t.aborted)return{kind:`aborted`};let n=S(e.accounting);if(n!==void 0)return n;if(Z!==void 0)return Z;let r=o(s(L));return r!==void 0&&r>=m?{kind:`budget-exhausted`,budget:`tokens`,forcedFinalAnswer:!1}:void 0};try{await l({type:`span-start`,trace:E,at:O,name:`invoke_agent ${e.trace?.agentId??`agent`}`,kind:`invoke_agent`,attributes:{"gen_ai.operation.name":`invoke_agent`,"gen_ai.agent.id":e.trace?.agentId??`agent`,"gen_ai.agent.name":e.trace?.agentName??e.trace?.agentId??`agent`,"gen_ai.request.model":e.config.model,...e.trace?.conversationId===void 0?{}:{"gen_ai.conversation.id":e.trace.conversationId}}}),W=!0,await l({type:`turn-start`,turn:D,trace:E});turnLifecycle:for(;;){for(;R===void 0&&k<h&&!t.aborted&&(R=Q(),R===void 0);){let n=o(s(L));if(f.maxTotalTokens!==`auto`&&n!==void 0){let t=[.5,.75,.9].filter(e=>n>=m*e).length;if(t>P){P=t;let r=Math.max(0,m-n);e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-token-guard`},content:[{type:`text`,text:`Token budget: ${r} of ${f.maxTotalTokens} aggregate tokens remain. Each request also spends input tokens on the accumulated context. `+(t>=2?`Stop broad exploration. `:`Prioritize outstanding verification and reporting. `)+`Reserve capacity for the required self-check, honest todo reconciliation and substantive final report. State unavailable evidence and unfinished work; do not claim it is verified. No extra model call is allowed after the hard token limit.`}]})})}}!N&&k>0&&h-k<=2&&(N=!0,e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-step-guard`},content:[{type:`text`,text:`${h-k} work steps remain. Finish essential verification, update any task list honestly, and submit the result if required. Summarize findings, evidence, and unfinished work; do not start new exploration.`}]})})),H!==void 0&&(await H.reconcile(k,U,t),U=[]);let r=k+1,a=await C(e,t,l,V,E,D,r,ue?`process`:e.outputFormat?.type===`json_schema`?`final`:`standard`);if(k++,a.report!==void 0&&L.push(a.report),a.message!==void 0&&(e.history.append({kind:`assistant`,message:a.message,...a.finish.kind===`aborted`?{interrupted:!0}:{},...a.usage===void 0?{}:{usage:a.usage}}),await l({type:`assistant-message`,message:a.message,trace:a.trace}),await b(a,l),I=x(a.message.content)),Z=S(e.accounting)??(a.usageRequired?{kind:`error`,failure:{message:`provider usage is required by the configured run policy`,code:`USAGE_REQUIRED`}}:a.usageUnavailable?{kind:`usage-unavailable`,modelCallId:a.report?.modelCallId??`unknown`}:void 0),t.aborted||a.finish.kind===`aborted`){R={kind:`aborted`};break}if(a.finish.kind===`error`&&Z!==void 0){R={kind:`error`,failure:a.finish.failure};break}if(a.usageRequired&&(a.calls.length===0||e.tools===void 0)){R=Z;break}if(a.finish.kind===`error`&&!a.usageRequired){if(R=Q(),R!==void 0)break;let n=await te(e.hooks?.onRequestError,[{turn:D,step:r,failure:a.finish.failure,snapshot:e.history.snapshot(),signal:t,...e.logger===void 0?{}:{logger:e.logger},emit:V}],e,t,`onRequestError`),i=S(e.accounting);if(i!==void 0){R=t.aborted?{kind:`aborted`}:i;break}if(n===`retry`&&k<h)continue;R={kind:`error`,failure:a.finish.failure};break}if(a.finish.kind===`max-tokens`&&!a.usageRequired){R={kind:`max-tokens`};break}if(a.calls.length===0&&a.usageUnavailable){R=S(e.accounting)??{kind:`usage-unavailable`,modelCallId:a.report?.modelCallId??`unknown`};break}if(a.calls.length===0&&ue){if(R=Q(),R!==void 0)break;e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`structured-output-finalizer`},content:[{type:`text`,text:`The process phase is complete. Return the final answer now in the requested output format. Do not call tools.`}]})});let n=await C(e,t,l,V,E,D,k+1,`final`);k++,n.report!==void 0&&L.push(n.report),n.message!==void 0&&(e.history.append({kind:`assistant`,message:n.message,...n.usage===void 0?{}:{usage:n.usage}}),await l({type:`assistant-message`,message:n.message,trace:n.trace}),await b(n,l),I=x(n.message.content)),R=n.finish.kind===`aborted`?{kind:`aborted`}:n.finish.kind===`error`?{kind:`error`,failure:n.finish.failure}:n.finish.kind===`max-tokens`?{kind:`max-tokens`}:n.usageRequired?{kind:`error`,failure:{message:`provider usage is required by the configured run policy`,code:`USAGE_REQUIRED`}}:n.usageUnavailable?S(e.accounting)??{kind:`usage-unavailable`,modelCallId:n.report?.modelCallId??`unknown`}:{kind:`completed`};break}if(a.droppedDuplicateCalls!==void 0&&e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-duplicate-guard`},content:[{type:`text`,text:`You reused the tool-call id ${a.droppedDuplicateCalls.map(e=>`'${e}'`).join(`, `)}. A result pairs to exactly one call, so the repeat was not run and only the first call of that id has a result. Give every call its own id, and call again if you still need what the dropped one would have done.`}]})}),a.calls.length===0||e.tools===void 0){R={kind:`completed`};break}let c=a.calls.filter(t=>e.tools?.get(t.toolName)?.budgetExempt!==!0).length,u=Math.max(0,f.maxToolCalls-A),d=B,p=a.calls.map(e=>{let t=re(e),n=d?.key===t?d.count+1:1;return d={key:t,count:n},n}).some(e=>e>=f.repeatToolLimit),g=ae(a.calls),_=ie([...ce,g],f.maxToolCycleLength),v=_!==void 0&&_.repetitions>=f.toolCycleLimit,ne=s(L),w=o(ne),T=w!==void 0&&w>=m,O=p||v||T||a.usageRequired,M=T?`tokens`:v?`tool-call-cycle`:p?`repeated-tool-call`:a.usageRequired?`usage-required`:`tool-calls`,z=f.onExhausted!==`continue`,W=await ee({calls:a.calls,catalog:e.tools,history:e.history,position:{turn:D,step:r,...e.accounting===void 0?{}:{runId:e.accounting.runId},...e.trace?.conversationId===void 0?{}:{conversationId:e.trace.conversationId}},signal:t,parentTrace:E,maxParallel:f.maxParallel,dispatchLimit:O?0:z?u:a.calls.length,declineReason:M,maxResultBytes:f.maxToolResultBytes,maxResultTokens:f.maxToolResultTokens,resultOverflow:f.toolResultOverflow,...e.spillStore===void 0?{}:{spillStore:e.spillStore},maxDurationMs:f.maxToolDurationMs,teardownTimeoutMs:f.toolTeardownTimeoutMs,...e.logger===void 0?{}:{logger:e.logger},...e.interceptors===void 0?{}:{interceptors:e.interceptors},...e.approvals===void 0?{}:{approvals:e.approvals},...e.accounting===void 0?{}:{accounting:e.accounting},emit:l,...e.hooks?.checkpoint===void 0?{}:{checkpoint:n=>y(Promise.resolve(e.hooks?.checkpoint?.(n)),e,t,`checkpoint`)}},{admissionLimit:O?0:z?u:`unbounded`,...q===void 0?{}:{programs:q},...J===void 0?{}:{programResults:J}});H!==void 0&&W.results.length===a.calls.length&&U.push(...a.calls.map((e,t)=>({toolName:e.toolName,rawArguments:e.rawArguments,failed:W.results[t]?.isError??!0}))),A+=W.budgeted;let G=Math.max(0,f.maxToolCalls-A),K=oe.filter(e=>G<=e).length;if(K>se&&G>0&&(se=K,le(`Tool budget: ${G} of ${f.maxToolCalls} calls remain in this turn. Stop broad exploration, make the necessary edits, and reserve calls for`+(z?` verification. When the budget runs out no further work call will run, so finish with what you can still verify.`:` verification. Past the budget you are expected to be wrapping up, not opening new lines of work.`))),!z&&G===0){let e=Math.floor(A/f.maxToolCalls);e>j&&(j=e,le(`Tool budget spent: ${A} calls made against a budget of ${f.maxToolCalls}. Do not start new substantive work. Finish what is in flight, verify what you can, and answer — stating plainly what is unverified or unfinished.`))}await l({type:`step-end`,turn:D,step:r,trace:a.trace}),ce.push(g);let Y=p;for(let t=0;t<a.calls.length;t++){let n=a.calls[t],r=W.results[t];if(n===void 0||r===void 0)continue;F=r.isError?F+1:0;let o=re(n),s=B?.key===o?B.count+1:1;B={key:o,count:s},s===f.repeatToolWarningAt&&e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-repeat-guard`},content:[{type:`text`,text:`You have called ${n.toolName} with the same arguments ${s} consecutive times. Reassess before repeating it.`}]})}),s>=f.repeatToolLimit&&(Y=!0)}if(_?.repetitions===f.toolCycleWarningAt&&e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`tool-loop-cycle-guard`},content:[{type:`text`,text:`Tool-use pattern repeated ${_.repetitions} times across ${_.period} step(s). Reassess the approach and identify concrete new evidence before continuing.`}]})}),W.concluded){R={kind:`concluded-by-tool`,toolName:W.concludedBy??`unknown`};break}if(t.aborted){R={kind:`aborted`};break}if(a.usageRequired){R=Z;break}if(a.usageUnavailable){R=S(e.accounting)??{kind:`usage-unavailable`,modelCallId:a.report?.modelCallId??`unknown`};break}let X,$=f.maxTotalTokens!==`auto`&&f.finalReportReserveTokens>0&&w!==void 0&&w>=m-f.finalReportReserveTokens;if(T||$?X=`tokens`:v?X=`tool-call-cycle`:z&&c>u?X=`tool-calls`:F>=f.maxConsecutiveToolErrors?X=`consecutive-tool-errors`:Y?X=`repeated-tool-call`:k>=h&&(X=`steps`),X!==void 0){let n=(X!==`tokens`||$&&!T)&&f.onExhausted!==`stop`&&Q()===void 0;if(n){let n=await C(e,t,l,V,E,D,k+1,`forced-final`);if(k++,n.report!==void 0&&L.push(n.report),n.message!==void 0&&(e.history.append({kind:`assistant`,message:n.message,...n.usage===void 0?{}:{usage:n.usage}}),await l({type:`assistant-message`,message:n.message,trace:n.trace}),await b(n,l),I=x(n.message.content)),n.finish.kind===`aborted`){R={kind:`aborted`};break}if(n.finish.kind===`error`){R={kind:`error`,failure:n.finish.failure};break}if(n.finish.kind===`max-tokens`){R={kind:`max-tokens`};break}if(n.usageRequired){R={kind:`error`,failure:{message:`provider usage is required by the configured run policy`,code:`USAGE_REQUIRED`}};break}if(n.usageUnavailable){R=S(e.accounting)??{kind:`usage-unavailable`,modelCallId:n.report?.modelCallId??`unknown`};break}}R={kind:`budget-exhausted`,budget:X,forcedFinalAnswer:n,...X===`tokens`&&$&&!T?{trigger:`report-reserve`}:{}}}}R===void 0&&(R=t.aborted?{kind:`aborted`}:{kind:`budget-exhausted`,budget:`steps`,forcedFinalAnswer:!1});let n=s(L),r=a(n),c={reason:R,text:I,steps:k,usageReport:n,toolCalls:A,traceId:T,...r===void 0?{}:{usage:r}},u=e.history.entries().length,d=R.kind===`completed`&&k<h&&Q()===void 0;if(await te(e.hooks?.onTurnEnd,[{outcome:c,snapshot:e.history.snapshot(),canContinue:d}],e,t,`onTurnEnd`),d&&e.history.entries().length>u&&!t.aborted){R=void 0;continue turnLifecycle}z=c;break}z.reason.kind===`aborted`&&e.history.append({kind:`user`,message:i({source:{kind:`app`,producer:`turn-interrupted`},content:[{type:`text`,text:`The previous request was interrupted before it finished. Use the next message to determine what to do next.`}]})}),await l({type:`span-end`,trace:E,at:v(),status:z.reason.kind===`error`?`error`:z.reason.kind===`aborted`?`aborted`:`success`,output:{reason:z.reason,text:I},...z.usage===void 0?{}:{usage:z.usage},...z.reason.kind===`error`?{error:{type:`ModelError`,message:z.reason.failure.message,code:z.reason.failure.code}}:{}}),G=!0,Y!==void 0&&(e.accounting?.endOperation(Y,z.reason.kind===`error`?`error`:z.reason.kind===`aborted`?`aborted`:`success`,{data:{reason:z.reason.kind,steps:k,toolCalls:A}}),X=!0),await l({type:`turn-end`,outcome:z,trace:E})}catch(n){let r=g(n);throw W&&!G&&await l({type:`span-end`,trace:E,at:v(),status:t.aborted?`aborted`:`error`,error:{type:n instanceof Error?n.name:`RuntimeError`,message:_(n),...r===void 0?{}:{code:r}}}).catch(()=>void 0),Y!==void 0&&!X&&(e.accounting?.endOperation(Y,t.aborted?`aborted`:`error`,{error:n}),X=!0),n}finally{J?.close()}}export{T as runTurn};
2
2
  //# sourceMappingURL=run-turn.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"run-turn.js","names":[],"sources":["../../../src/agent/loop/run-turn.ts"],"sourcesContent":["import { createUserMessage } from '../../message/index.ts'\nimport { detachedFrozen } from '../../primitives/index.ts'\nimport type { ModelCallReport } from '../../observation/index.ts'\nimport { waitForSettlement } from '../../async/index.ts'\nimport { authoritativeTokenUsage, budgetTokenTotal, summarizeModelCallUsage } from '../accounting/ledger.ts'\nimport { createSpanId, createTraceId, type TraceRef } from '../trace/trace.ts'\nimport type { AgentEvent, ExhaustedBudget, ToolDeclineReason, TurnHooks, TurnOutcome } from './types.ts'\nimport { AwaitedEventQueue } from './queue.ts'\nimport { runToolCalls } from './schedule.ts'\nimport { type RunTurnOptions } from './turn/types.ts'\nimport { resolveBounds, positiveFinite, snapshotRunTurnOptions } from './turn/config.ts'\nimport { codedRuntimeError, messageOf, errorCodeOf, now } from './turn/common.ts'\nimport { runOptionalHook, runHook } from './turn/hooks.ts'\nimport { maintenanceEmitter, emitAssistantContent, textOf } from './turn/content.ts'\nimport { repeatKey, toolActionPattern, repeatedSuffixCycle } from './turn/repetition.ts'\nimport { modelRound } from './turn/model-round.ts'\nimport { accountingUsageStop } from './turn/usage-stop.ts'\nimport { ContextSectionRuntime } from '../context/section.ts'\nimport type { ContextToolTouch } from '../context/types.ts'\n\nfunction hasCallableTools(options: RunTurnOptions): boolean {\n if (options.toolChoice === 'none') return false\n return (options.tools?.names().length ?? 0) > 0 || (options.nativeTools?.length ?? 0) > 0\n}\n\n/** Run one bounded turn as a backpressured event stream. */\nexport function runTurn(options: RunTurnOptions): AsyncIterable<AgentEvent> {\n return {\n async * [Symbol.asyncIterator]() {\n const invocation = snapshotRunTurnOptions(options)\n const queue = new AwaitedEventQueue<AgentEvent>()\n const consumer = new AbortController()\n const teardownTimeoutMs = positiveFinite(invocation.teardownTimeoutMs ?? 30_000, 'teardownTimeoutMs')\n const signal = invocation.signal === undefined\n ? consumer.signal\n : AbortSignal.any([invocation.signal, consumer.signal])\n const task = driveTurn(invocation, signal, event => queue.push(detachedFrozen(event)))\n .then(() => queue.close(), error => queue.fail(error))\n try {\n while (true) {\n const item = await queue.take()\n if (item.done) break\n yield item.value\n }\n await task\n } finally {\n consumer.abort(new Error('turn event consumer stopped'))\n queue.close()\n if (!await waitForSettlement(task, teardownTimeoutMs)) {\n throw codedRuntimeError(\n `turn producer ignored cancellation for more than ${teardownTimeoutMs}ms`,\n 'TURN_TEARDOWN_TIMEOUT',\n consumer.signal.reason,\n )\n }\n }\n },\n }\n}\n\nasync function driveTurn(\n options: RunTurnOptions,\n signal: AbortSignal,\n emit: (event: AgentEvent) => Promise<void>,\n): Promise<void> {\n const bounds = resolveBounds(options.bounds)\n const maxTotalTokens = bounds.maxTotalTokens === 'auto' ? Infinity : bounds.maxTotalTokens\n // Infinity is local control flow only. Public configuration/events retain\n // the serializable 'auto' value, and all other admission guards still apply.\n const maxSteps = bounds.maxSteps === 'auto' ? Infinity : bounds.maxSteps\n const traceId = options.trace?.traceId ?? createTraceId()\n const root: TraceRef = { traceId, spanId: createSpanId(), parentSpanId: options.trace?.parentSpanId ?? null }\n const turn = Math.max(1, options.history.entries().filter(entry =>\n entry.event.kind === 'user' && entry.event.message.source.kind === 'user').length)\n const startedAt = now()\n let steps = 0\n let toolCalls = 0\n // Descending, so \"how many are below the remainder\" counts the crossings.\n const budgetReminders = [...bounds.toolBudgetRemindAt]\n .filter(threshold => threshold > 0 && threshold < bounds.maxToolCalls)\n .sort((left, right) => right - left)\n let budgetRemindersSent = 0\n /** How many full budgets an unwalled turn has spent and been told about. */\n let overBudgetNoticesSent = 0\n /** Sequence of the budget notice currently on the surface, if any. */\n let budgetNoticeSeq: number | undefined\n let stepReminderSent = false\n let tokenRemindersSent = 0\n let consecutiveErrors = 0\n let text = ''\n const modelCallReports: ModelCallReport[] = []\n let reason: TurnOutcome['reason'] | undefined\n let outcome: TurnOutcome\n let lastRepeat: { key: string; count: number } | undefined\n const actionSteps: string[] = []\n const emitMaintenance = maintenanceEmitter(emit, root)\n /**\n * Put the current budget notice on the surface, replacing the previous one.\n *\n * One live notice, never a pile of them. Appending each new remainder leaves\n * \"16 calls remain\" and \"6 calls remain\" both readable, and a model that\n * plans against the older number plans against a budget it no longer has.\n * Codex keeps exactly one `<rollout_budget>` fragment for the same reason\n * (`context/rollout_budget.rs`), replacing it as the number moves.\n * @param text - What the model should read now.\n */\n const appendBudgetNotice = (text: string): void => {\n const message = createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-budget-guard' },\n content: [{ type: 'text', text }],\n })\n const previous = budgetNoticeSeq\n // Replacing is best-effort. Compaction can shadow the earlier notice\n // between steps, and a replace whose target is no longer on the surface is\n // rejected — which must cost the model a reminder, never the turn.\n if (previous !== undefined) {\n try {\n budgetNoticeSeq = options.history.append(\n { kind: 'user', message },\n { op: 'replace', from: previous, to: previous, targets: [previous] },\n ).seq\n return\n } catch {\n budgetNoticeSeq = undefined\n }\n }\n budgetNoticeSeq = options.history.append({ kind: 'user', message }).seq\n }\n const contextSections = options.contextSections === undefined || options.contextSections.length === 0\n ? undefined\n : new ContextSectionRuntime({\n sections: options.contextSections,\n history: options.history,\n ...options.logger === undefined ? {} : { logger: options.logger },\n guard: (pending, name) => runHook(pending, options, signal, name),\n scope: { agentId: options.trace?.agentId, conversationId: options.trace?.conversationId },\n })\n /** Tool calls committed since the last section reconcile. */\n let contextTouches: ContextToolTouch[] = []\n let rootStarted = false\n let rootEnded = false\n const callableTools = hasCallableTools(options)\n const dedicatedFinalOutput = options.outputFormat?.type === 'json_schema' && callableTools\n const turnOperationId = options.accounting?.startOperation('turn', {\n data: { turn, model: options.config.model },\n })\n let turnOperationEnded = false\n let usageStop: TurnOutcome['reason'] | undefined\n // Shared by retries, hook continuations, and both finalizer paths. Finalizers\n // may have a separate step allowance, never a separate token allowance.\n const admissionStop = (): TurnOutcome['reason'] | undefined => {\n if (signal.aborted) return { kind: 'aborted' }\n const mandatoryStop = accountingUsageStop(options.accounting)\n if (mandatoryStop !== undefined) return mandatoryStop\n if (usageStop !== undefined) return usageStop\n const tokens = budgetTokenTotal(summarizeModelCallUsage(modelCallReports))\n return tokens !== undefined && tokens >= maxTotalTokens\n ? { kind: 'budget-exhausted', budget: 'tokens', forcedFinalAnswer: false }\n : undefined\n }\n\n try {\n await emit({\n type: 'span-start', trace: root, at: startedAt,\n name: `invoke_agent ${options.trace?.agentId ?? 'agent'}`, kind: 'invoke_agent',\n attributes: {\n 'gen_ai.operation.name': 'invoke_agent',\n 'gen_ai.agent.id': options.trace?.agentId ?? 'agent',\n 'gen_ai.agent.name': options.trace?.agentName ?? options.trace?.agentId ?? 'agent',\n 'gen_ai.request.model': options.config.model,\n ...options.trace?.conversationId === undefined\n ? {}\n : { 'gen_ai.conversation.id': options.trace.conversationId },\n },\n })\n rootStarted = true\n await emit({ type: 'turn-start', turn, trace: root })\n\n turnLifecycle: while (true) {\n while (reason === undefined && steps < maxSteps && !signal.aborted) {\n reason = admissionStop()\n if (reason !== undefined) break\n // Auto has no step countdown. Warn from the same usage total as admission,\n // before a hard token stop can leave the agent without a reporting call.\n const usedTokens = budgetTokenTotal(summarizeModelCallUsage(modelCallReports))\n if (bounds.maxTotalTokens !== 'auto' && usedTokens !== undefined) {\n const crossed = [0.5, 0.75, 0.9].filter(ratio => usedTokens >= maxTotalTokens * ratio).length\n if (crossed > tokenRemindersSent) {\n tokenRemindersSent = crossed\n const remaining = Math.max(0, maxTotalTokens - usedTokens)\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-token-guard' },\n content: [{ type: 'text', text: `Token budget: ${remaining} of ${bounds.maxTotalTokens} aggregate tokens remain. Each request also spends input tokens on the accumulated context. `\n + (crossed >= 2 ? 'Stop broad exploration. ' : 'Prioritize outstanding verification and reporting. ')\n + 'Reserve capacity for the required self-check, honest todo reconciliation and substantive final report. State unavailable evidence and unfinished work; do not claim it is verified. No extra model call is allowed after the hard token limit.',\n }],\n }) })\n }\n }\n // Leave time to reconcile a plan and submit a result before the final\n // tools-disabled summary. Tool-call reminders do not cover step limits.\n if (!stepReminderSent && steps > 0 && maxSteps - steps <= 2) {\n stepReminderSent = true\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-step-guard' },\n content: [{ type: 'text', text:\n `${maxSteps - steps} work steps remain. Finish essential verification, update any task list honestly, and submit the result if required. Summarize findings, evidence, and unfinished work; do not start new exploration.`,\n }],\n }) })\n }\n // Recomputed before the request that will read it, so a section reacting to\n // the previous step's tool calls is already on the surface.\n if (contextSections !== undefined) {\n await contextSections.reconcile(steps, contextTouches, signal)\n contextTouches = []\n }\n const step = steps + 1\n const round = await modelRound(\n options, signal, emit, emitMaintenance, root, turn, step,\n dedicatedFinalOutput\n ? 'process'\n : options.outputFormat?.type === 'json_schema' ? 'final' : 'standard',\n )\n steps++\n if (round.report !== undefined) modelCallReports.push(round.report)\n if (round.message !== undefined) {\n options.history.append({\n kind: 'assistant', message: round.message,\n ...round.finish.kind === 'aborted' ? { interrupted: true as const } : {},\n ...round.usage === undefined ? {} : { usage: round.usage },\n })\n await emit({ type: 'assistant-message', message: round.message, trace: round.trace })\n await emitAssistantContent(round, emit)\n text = textOf(round.message.content)\n }\n usageStop = accountingUsageStop(options.accounting) ?? (round.usageRequired\n ? { kind: 'error', failure: { message: 'provider usage is required by the configured run policy', code: 'USAGE_REQUIRED' } }\n : round.usageUnavailable\n ? { kind: 'usage-unavailable', modelCallId: round.report?.modelCallId ?? 'unknown' }\n : undefined)\n if (signal.aborted || round.finish.kind === 'aborted') { reason = { kind: 'aborted' }; break }\n // Pair emitted tool calls with declined results even when policy stops the\n // run; never execute those calls or allow a retry hook to override policy.\n if (round.finish.kind === 'error' && usageStop !== undefined) {\n reason = { kind: 'error', failure: round.finish.failure }\n break\n }\n if (round.usageRequired && (round.calls.length === 0 || options.tools === undefined)) { reason = usageStop; break }\n if (round.finish.kind === 'error' && !round.usageRequired) {\n reason = admissionStop()\n if (reason !== undefined) break\n const decision = await runOptionalHook(options.hooks?.onRequestError, [{\n turn, step, failure: round.finish.failure, snapshot: options.history.snapshot(), signal,\n ...(options.logger === undefined ? {} : { logger: options.logger }),\n emit: emitMaintenance,\n }], options, signal, 'onRequestError')\n const maintenanceStop = accountingUsageStop(options.accounting)\n if (maintenanceStop !== undefined) { reason = signal.aborted ? { kind: 'aborted' } : maintenanceStop; break }\n if (decision === 'retry' && steps < maxSteps) continue\n reason = { kind: 'error', failure: round.finish.failure }\n break\n }\n if (round.finish.kind === 'max-tokens' && !round.usageRequired) { reason = { kind: 'max-tokens' }; break }\n if (round.calls.length === 0 && round.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: round.report?.modelCallId ?? 'unknown' }\n break\n }\n if (round.calls.length === 0 && dedicatedFinalOutput) {\n reason = admissionStop()\n if (reason !== undefined) break\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'structured-output-finalizer' },\n content: [{\n type: 'text',\n text: 'The process phase is complete. Return the final answer now in the requested output format. Do not call tools.',\n }],\n }) })\n const final = await modelRound(\n options, signal, emit, emitMaintenance, root, turn, steps + 1, 'final',\n )\n steps++\n if (final.report !== undefined) modelCallReports.push(final.report)\n if (final.message !== undefined) {\n options.history.append({\n kind: 'assistant', message: final.message,\n ...final.usage === undefined ? {} : { usage: final.usage },\n })\n await emit({ type: 'assistant-message', message: final.message, trace: final.trace })\n await emitAssistantContent(final, emit)\n text = textOf(final.message.content)\n }\n if (final.finish.kind === 'aborted') reason = { kind: 'aborted' }\n else if (final.finish.kind === 'error') reason = { kind: 'error', failure: final.finish.failure }\n else if (final.finish.kind === 'max-tokens') reason = { kind: 'max-tokens' }\n else if (final.usageRequired) reason = { kind: 'error', failure: {\n message: 'provider usage is required by the configured run policy',\n code: 'USAGE_REQUIRED',\n } }\n else if (final.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: final.report?.modelCallId ?? 'unknown' }\n } else reason = { kind: 'completed' }\n break\n }\n // A provider that repeated an id had the repeat dropped. Saying so is what\n // keeps the model from reading one result for two calls as a tool that\n // silently ignored it.\n if (round.droppedDuplicateCalls !== undefined) {\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-duplicate-guard' },\n content: [{\n type: 'text',\n text: `You reused the tool-call id ${round.droppedDuplicateCalls.map(id => `'${id}'`).join(', ')}.`\n + ' A result pairs to exactly one call, so the repeat was not run and only the first'\n + ' call of that id has a result. Give every call its own id, and call again if you'\n + ' still need what the dropped one would have done.',\n }],\n }) })\n }\n if (round.calls.length === 0 || options.tools === undefined) { reason = { kind: 'completed' }; break }\n\n // Calls the budget does not govern: submitting, asking, delegating. They\n // are dispatched even when the budget is spent, so the model always has a\n // legal way to finish. See `ToolDefinition.budgetExempt`.\n const budgetedCalls = round.calls\n .filter(call => options.tools?.get(call.toolName)?.budgetExempt !== true).length\n const remaining = Math.max(0, bounds.maxToolCalls - toolCalls)\n let repeatProjection = lastRepeat\n const projectedRepeats = round.calls.map(call => {\n const key = repeatKey(call)\n // Count consecutive calls, not lifetime visits to a source or test command.\n // Distinct intervening work may change its result. Alternating loops are\n // handled separately by the step-cycle guard below.\n const count = repeatProjection?.key === key ? repeatProjection.count + 1 : 1\n repeatProjection = { key, count }\n return count\n })\n const repeatedLimitBeforeDispatch = projectedRepeats.some(count => count >= bounds.repeatToolLimit)\n const actionPattern = toolActionPattern(round.calls)\n const projectedCycle = repeatedSuffixCycle(\n [...actionSteps, actionPattern],\n bounds.maxToolCycleLength,\n )\n const cycleLimitBeforeDispatch = projectedCycle !== undefined\n && projectedCycle.repetitions >= bounds.toolCycleLimit\n const currentUsage = summarizeModelCallUsage(modelCallReports)\n const budgetTokens = budgetTokenTotal(currentUsage)\n const tokenLimitBeforeDispatch = budgetTokens !== undefined\n && budgetTokens >= maxTotalTokens\n const guardDeclined = repeatedLimitBeforeDispatch || cycleLimitBeforeDispatch || tokenLimitBeforeDispatch || round.usageRequired\n // Name the limit that actually declined the call. Reporting a repeat guard\n // as an empty budget teaches the model the wrong lesson, and it repeats the\n // call on the next turn with the budget it was told it lacked.\n const declineReason: ToolDeclineReason = tokenLimitBeforeDispatch\n ? 'tokens'\n : cycleLimitBeforeDispatch\n ? 'tool-call-cycle'\n : repeatedLimitBeforeDispatch\n ? 'repeated-tool-call'\n : round.usageRequired\n ? 'usage-required'\n : 'tool-calls'\n // `continue` takes the wall down: the budget becomes a notice and the turn\n // is bounded by steps, tokens, and the run-level ledger instead. Guards\n // that mean \"this is not working\" still decline, whatever the setting.\n const budgetIsAWall = bounds.onExhausted !== 'continue'\n const scheduled = await runToolCalls({\n calls: round.calls, catalog: options.tools, history: options.history,\n position: { turn, step,\n ...(options.accounting === undefined ? {} : { runId: options.accounting.runId }),\n ...(options.trace?.conversationId === undefined ? {} : { conversationId: options.trace.conversationId }),\n }, signal, parentTrace: root,\n maxParallel: bounds.maxParallel,\n dispatchLimit: guardDeclined ? 0 : budgetIsAWall ? remaining : round.calls.length,\n declineReason,\n maxResultBytes: bounds.maxToolResultBytes,\n maxResultTokens: bounds.maxToolResultTokens,\n resultOverflow: bounds.toolResultOverflow,\n ...options.spillStore === undefined ? {} : { spillStore: options.spillStore },\n maxDurationMs: bounds.maxToolDurationMs,\n teardownTimeoutMs: bounds.toolTeardownTimeoutMs,\n ...(options.logger === undefined ? {} : { logger: options.logger }),\n ...options.interceptors === undefined ? {} : { interceptors: options.interceptors },\n ...options.approvals === undefined ? {} : { approvals: options.approvals },\n ...options.accounting === undefined ? {} : { accounting: options.accounting },\n emit,\n ...options.hooks?.checkpoint === undefined ? {} : {\n checkpoint: (context: Parameters<NonNullable<TurnHooks['checkpoint']>>[0]) => runHook(\n Promise.resolve(options.hooks?.checkpoint?.(context)), options, signal, 'checkpoint',\n ),\n },\n })\n // Results commit in model order, one per requested call, so the pairing\n // holds for declined calls too. A short result list means a sibling failed\n // its contract and the turn is already unwinding; reporting a guessed\n // outcome would be worse than reporting nothing.\n if (contextSections !== undefined && scheduled.results.length === round.calls.length) {\n contextTouches.push(...round.calls.map((call, index) => ({\n toolName: call.toolName,\n rawArguments: call.rawArguments,\n failed: scheduled.results[index]?.isError ?? true,\n })))\n }\n toolCalls += scheduled.budgeted\n const remainingAfterDispatch = Math.max(0, bounds.maxToolCalls - toolCalls)\n // One reminder per threshold crossed, not one per turn.\n //\n // This was a single boolean: the model was told once, at 25% remaining,\n // and then never again however close it came to the end. A model warned at\n // sixteen calls left and still exploring at four has been told nothing\n // since, and runs into the wall with no notice — which is what produces a\n // red \"no remaining tool-call budget\" where an answer should have been.\n //\n // Codex counts thresholds rather than remembering a flag\n // (`rollout_budget.rs`, `reminder_index`): every threshold now below the\n // remaining budget that has not been reported yet gets reported. Crossing\n // several at once collapses into the one that matters, the lowest.\n const crossed = budgetReminders.filter(threshold => remainingAfterDispatch <= threshold).length\n if (crossed > budgetRemindersSent && remainingAfterDispatch > 0) {\n budgetRemindersSent = crossed\n appendBudgetNotice(\n `Tool budget: ${remainingAfterDispatch} of ${bounds.maxToolCalls} calls remain in this turn.`\n + ' Stop broad exploration, make the necessary edits, and reserve calls for'\n + (budgetIsAWall\n ? ' verification. When the budget runs out no further work call will run, so'\n + ' finish with what you can still verify.'\n : ' verification. Past the budget you are expected to be wrapping up, not'\n + ' opening new lines of work.'),\n )\n }\n // Past the budget with the wall down. The turn is not stopped — the model\n // keeps its tools — but it is told, once per further budget spent, that it\n // is now expected to be finishing. This is the shape of Codex's\n // `budget_limit` goal prompt: no new substantive work, wrap up, name what\n // is left.\n if (!budgetIsAWall && remainingAfterDispatch === 0) {\n const windows = Math.floor(toolCalls / bounds.maxToolCalls)\n if (windows > overBudgetNoticesSent) {\n overBudgetNoticesSent = windows\n appendBudgetNotice(\n `Tool budget spent: ${toolCalls} calls made against a budget of ${bounds.maxToolCalls}.`\n + ' Do not start new substantive work. Finish what is in flight, verify what you'\n + ' can, and answer — stating plainly what is unverified or unfinished.',\n )\n }\n }\n await emit({ type: 'step-end', turn, step, trace: round.trace })\n\n actionSteps.push(actionPattern)\n let repeatedLimit = repeatedLimitBeforeDispatch\n for (let index = 0; index < round.calls.length; index++) {\n const call = round.calls[index]\n const result = scheduled.results[index]\n if (call === undefined || result === undefined) continue\n consecutiveErrors = result.isError ? consecutiveErrors + 1 : 0\n const key = repeatKey(call)\n const count = lastRepeat?.key === key ? lastRepeat.count + 1 : 1\n lastRepeat = { key, count }\n if (count === bounds.repeatToolWarningAt) {\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-repeat-guard' },\n content: [{ type: 'text', text: `You have called ${call.toolName} with the same arguments ${count} consecutive times. Reassess before repeating it.` }],\n }) })\n }\n if (count >= bounds.repeatToolLimit) repeatedLimit = true\n }\n if (projectedCycle?.repetitions === bounds.toolCycleWarningAt) {\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-cycle-guard' },\n content: [{\n type: 'text',\n text: `Tool-use pattern repeated ${projectedCycle.repetitions} times across ${projectedCycle.period} step(s). Reassess the approach and identify concrete new evidence before continuing.`,\n }],\n }) })\n }\n if (scheduled.concluded) { reason = { kind: 'concluded-by-tool', toolName: scheduled.concludedBy ?? 'unknown' }; break }\n if (signal.aborted) { reason = { kind: 'aborted' }; break }\n if (round.usageRequired) { reason = usageStop; break }\n if (round.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: round.report?.modelCallId ?? 'unknown' }\n break\n }\n let exhausted: ExhaustedBudget | undefined\n const reportReserveReached = bounds.maxTotalTokens !== 'auto'\n && bounds.finalReportReserveTokens > 0 && budgetTokens !== undefined\n && budgetTokens >= maxTotalTokens - bounds.finalReportReserveTokens\n if (tokenLimitBeforeDispatch) exhausted = 'tokens'\n else if (reportReserveReached) exhausted = 'tokens'\n else if (cycleLimitBeforeDispatch) exhausted = 'tool-call-cycle'\n else if (budgetIsAWall && budgetedCalls > remaining) exhausted = 'tool-calls'\n else if (consecutiveErrors >= bounds.maxConsecutiveToolErrors) exhausted = 'consecutive-tool-errors'\n else if (repeatedLimit) exhausted = 'repeated-tool-call'\n else if (steps >= maxSteps) exhausted = 'steps'\n if (exhausted !== undefined) {\n const forced = (exhausted !== 'tokens' || (reportReserveReached && !tokenLimitBeforeDispatch))\n && bounds.onExhausted !== 'stop'\n && admissionStop() === undefined\n if (forced) {\n const final = await modelRound(\n options, signal, emit, emitMaintenance, root, turn, steps + 1, 'forced-final',\n )\n steps++\n if (final.report !== undefined) modelCallReports.push(final.report)\n if (final.message !== undefined) {\n options.history.append({ kind: 'assistant', message: final.message, ...final.usage === undefined ? {} : { usage: final.usage } })\n await emit({ type: 'assistant-message', message: final.message, trace: final.trace })\n await emitAssistantContent(final, emit)\n text = textOf(final.message.content)\n }\n if (final.finish.kind === 'aborted') {\n reason = { kind: 'aborted' }\n break\n }\n if (final.finish.kind === 'error') {\n reason = { kind: 'error', failure: final.finish.failure }\n break\n }\n if (final.finish.kind === 'max-tokens') {\n reason = { kind: 'max-tokens' }\n break\n }\n if (final.usageRequired) {\n reason = { kind: 'error', failure: {\n message: 'provider usage is required by the configured run policy',\n code: 'USAGE_REQUIRED',\n } }\n break\n }\n if (final.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: final.report?.modelCallId ?? 'unknown' }\n break\n }\n }\n reason = { kind: 'budget-exhausted', budget: exhausted, forcedFinalAnswer: forced,\n ...(exhausted === 'tokens' && reportReserveReached && !tokenLimitBeforeDispatch\n ? { trigger: 'report-reserve' as const } : {}),\n }\n }\n }\n\n if (reason === undefined) {\n reason = signal.aborted\n ? { kind: 'aborted' }\n : { kind: 'budget-exhausted', budget: 'steps', forcedFinalAnswer: false }\n }\n const usageReport = summarizeModelCallUsage(modelCallReports)\n const usage = authoritativeTokenUsage(usageReport)\n const candidate: TurnOutcome = {\n reason, text, steps, usageReport, toolCalls, traceId,\n ...usage === undefined ? {} : { usage },\n }\n const entriesBeforeHook = options.history.entries().length\n const canContinue = reason.kind === 'completed'\n && steps < maxSteps\n && admissionStop() === undefined\n await runOptionalHook(options.hooks?.onTurnEnd, [{\n outcome: candidate,\n snapshot: options.history.snapshot(),\n canContinue,\n }], options, signal, 'onTurnEnd')\n // Hooks object by appending context rather than by returning a veto. Re-run only\n // a normally completed turn; abort/error/budget outcomes remain terminal.\n if (canContinue\n && options.history.entries().length > entriesBeforeHook\n && !signal.aborted) {\n reason = undefined\n continue turnLifecycle\n }\n outcome = candidate\n break\n }\n await emit({\n type: 'span-end', trace: root, at: now(),\n status: outcome.reason.kind === 'error' ? 'error' : outcome.reason.kind === 'aborted' ? 'aborted' : 'success',\n output: { reason: outcome.reason, text },\n ...outcome.usage === undefined ? {} : { usage: outcome.usage },\n ...outcome.reason.kind === 'error' ? { error: { type: 'ModelError', message: outcome.reason.failure.message, code: outcome.reason.failure.code } } : {},\n })\n rootEnded = true\n if (turnOperationId !== undefined) {\n options.accounting?.endOperation(\n turnOperationId,\n outcome.reason.kind === 'error' ? 'error' : outcome.reason.kind === 'aborted' ? 'aborted' : 'success',\n { data: { reason: outcome.reason.kind, steps, toolCalls } },\n )\n turnOperationEnded = true\n }\n await emit({ type: 'turn-end', outcome, trace: root })\n } catch (error: unknown) {\n const code = errorCodeOf(error)\n if (rootStarted && !rootEnded) {\n await emit({\n type: 'span-end', trace: root, at: now(), status: signal.aborted ? 'aborted' : 'error',\n error: {\n type: error instanceof Error ? error.name : 'RuntimeError',\n message: messageOf(error),\n ...code === undefined ? {} : { code },\n },\n }).catch(() => undefined)\n }\n if (turnOperationId !== undefined && !turnOperationEnded) {\n options.accounting?.endOperation(\n turnOperationId,\n signal.aborted ? 'aborted' : 'error',\n { error },\n )\n turnOperationEnded = true\n }\n throw error\n }\n}\n\n\nexport type { RunTurnOptions } from './turn/types.ts'\n"],"mappings":"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"}
1
+ {"version":3,"file":"run-turn.js","names":[],"sources":["../../../src/agent/loop/run-turn.ts"],"sourcesContent":["import { createUserMessage } from '../../message/index.ts'\nimport { detachedFrozen } from '../../primitives/index.ts'\nimport type { ModelCallReport } from '../../observation/index.ts'\nimport { waitForSettlement } from '../../async/index.ts'\nimport { authoritativeTokenUsage, budgetTokenTotal, summarizeModelCallUsage } from '../accounting/ledger.ts'\nimport { createSpanId, createTraceId, type TraceRef } from '../trace/trace.ts'\nimport type { AgentEvent, ExhaustedBudget, ToolDeclineReason, TurnHooks, TurnOutcome } from './types.ts'\nimport { AwaitedEventQueue } from './queue.ts'\nimport { scheduleToolCalls } from './schedule.ts'\nimport { captureProgramGrants } from '../tool/nested.ts'\nimport { ProgramResultStore } from '../tool/program-results.ts'\nimport { type RunTurnOptions } from './turn/types.ts'\nimport { resolveBounds, positiveFinite, snapshotRunTurnOptions } from './turn/config.ts'\nimport { codedRuntimeError, messageOf, errorCodeOf, now } from './turn/common.ts'\nimport { runOptionalHook, runHook } from './turn/hooks.ts'\nimport { maintenanceEmitter, emitAssistantContent, textOf } from './turn/content.ts'\nimport { repeatKey, toolActionPattern, repeatedSuffixCycle } from './turn/repetition.ts'\nimport { modelRound } from './turn/model-round.ts'\nimport { accountingUsageStop } from './turn/usage-stop.ts'\nimport { ContextSectionRuntime } from '../context/section.ts'\nimport type { ContextToolTouch } from '../context/types.ts'\n\nfunction hasCallableTools(options: RunTurnOptions): boolean {\n if (options.toolChoice === 'none') return false\n return (options.tools?.names().length ?? 0) > 0 || (options.nativeTools?.length ?? 0) > 0\n}\n\n/** Run one bounded turn as a backpressured event stream. */\nexport function runTurn(options: RunTurnOptions): AsyncIterable<AgentEvent> {\n return {\n async * [Symbol.asyncIterator]() {\n const invocation = snapshotRunTurnOptions(options)\n const queue = new AwaitedEventQueue<AgentEvent>()\n const consumer = new AbortController()\n const teardownTimeoutMs = positiveFinite(invocation.teardownTimeoutMs ?? 30_000, 'teardownTimeoutMs')\n const signal = invocation.signal === undefined\n ? consumer.signal\n : AbortSignal.any([invocation.signal, consumer.signal])\n const task = driveTurn(invocation, signal, event => queue.push(detachedFrozen(event)))\n .then(() => queue.close(), error => queue.fail(error))\n try {\n while (true) {\n const item = await queue.take()\n if (item.done) break\n yield item.value\n }\n await task\n } finally {\n consumer.abort(new Error('turn event consumer stopped'))\n queue.close()\n if (!await waitForSettlement(task, teardownTimeoutMs)) {\n throw codedRuntimeError(\n `turn producer ignored cancellation for more than ${teardownTimeoutMs}ms`,\n 'TURN_TEARDOWN_TIMEOUT',\n consumer.signal.reason,\n )\n }\n }\n },\n }\n}\n\nasync function driveTurn(\n options: RunTurnOptions,\n signal: AbortSignal,\n emit: (event: AgentEvent) => Promise<void>,\n): Promise<void> {\n const bounds = resolveBounds(options.bounds)\n const maxTotalTokens = bounds.maxTotalTokens === 'auto' ? Infinity : bounds.maxTotalTokens\n // Infinity is local control flow only. Public configuration/events retain\n // the serializable 'auto' value, and all other admission guards still apply.\n const maxSteps = bounds.maxSteps === 'auto' ? Infinity : bounds.maxSteps\n const traceId = options.trace?.traceId ?? createTraceId()\n const root: TraceRef = { traceId, spanId: createSpanId(), parentSpanId: options.trace?.parentSpanId ?? null }\n const turn = Math.max(1, options.history.entries().filter(entry =>\n entry.event.kind === 'user' && entry.event.message.source.kind === 'user').length)\n const startedAt = now()\n let steps = 0\n let toolCalls = 0\n // Descending, so \"how many are below the remainder\" counts the crossings.\n const budgetReminders = [...bounds.toolBudgetRemindAt]\n .filter(threshold => threshold > 0 && threshold < bounds.maxToolCalls)\n .sort((left, right) => right - left)\n let budgetRemindersSent = 0\n /** How many full budgets an unwalled turn has spent and been told about. */\n let overBudgetNoticesSent = 0\n /** Sequence of the budget notice currently on the surface, if any. */\n let budgetNoticeSeq: number | undefined\n let stepReminderSent = false\n let tokenRemindersSent = 0\n let consecutiveErrors = 0\n let text = ''\n const modelCallReports: ModelCallReport[] = []\n let reason: TurnOutcome['reason'] | undefined\n let outcome: TurnOutcome\n let lastRepeat: { key: string; count: number } | undefined\n const actionSteps: string[] = []\n const emitMaintenance = maintenanceEmitter(emit, root)\n /**\n * Put the current budget notice on the surface, replacing the previous one.\n *\n * One live notice, never a pile of them. Appending each new remainder leaves\n * \"16 calls remain\" and \"6 calls remain\" both readable, and a model that\n * plans against the older number plans against a budget it no longer has.\n * Codex keeps exactly one `<rollout_budget>` fragment for the same reason\n * (`context/rollout_budget.rs`), replacing it as the number moves.\n * @param text - What the model should read now.\n */\n const appendBudgetNotice = (text: string): void => {\n const message = createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-budget-guard' },\n content: [{ type: 'text', text }],\n })\n const previous = budgetNoticeSeq\n // Replacing is best-effort. Compaction can shadow the earlier notice\n // between steps, and a replace whose target is no longer on the surface is\n // rejected — which must cost the model a reminder, never the turn.\n if (previous !== undefined) {\n try {\n budgetNoticeSeq = options.history.append(\n { kind: 'user', message },\n { op: 'replace', from: previous, to: previous, targets: [previous] },\n ).seq\n return\n } catch {\n budgetNoticeSeq = undefined\n }\n }\n budgetNoticeSeq = options.history.append({ kind: 'user', message }).seq\n }\n const contextSections = options.contextSections === undefined || options.contextSections.length === 0\n ? undefined\n : new ContextSectionRuntime({\n sections: options.contextSections,\n history: options.history,\n ...options.logger === undefined ? {} : { logger: options.logger },\n guard: (pending, name) => runHook(pending, options, signal, name),\n scope: { agentId: options.trace?.agentId, conversationId: options.trace?.conversationId },\n })\n /** Tool calls committed since the last section reconcile. */\n let contextTouches: ContextToolTouch[] = []\n let rootStarted = false\n let rootEnded = false\n const callableTools = hasCallableTools(options)\n const programs = options.experimentalPrograms === undefined ? undefined : captureProgramGrants(options.experimentalPrograms)\n // Handles programs retain live for this turn only.\n const programResults = programs === undefined ? undefined : new ProgramResultStore()\n const dedicatedFinalOutput = options.outputFormat?.type === 'json_schema' && callableTools\n const turnOperationId = options.accounting?.startOperation('turn', {\n data: { turn, model: options.config.model },\n })\n let turnOperationEnded = false\n let usageStop: TurnOutcome['reason'] | undefined\n // Shared by retries, hook continuations, and both finalizer paths. Finalizers\n // may have a separate step allowance, never a separate token allowance.\n const admissionStop = (): TurnOutcome['reason'] | undefined => {\n if (signal.aborted) return { kind: 'aborted' }\n const mandatoryStop = accountingUsageStop(options.accounting)\n if (mandatoryStop !== undefined) return mandatoryStop\n if (usageStop !== undefined) return usageStop\n const tokens = budgetTokenTotal(summarizeModelCallUsage(modelCallReports))\n return tokens !== undefined && tokens >= maxTotalTokens\n ? { kind: 'budget-exhausted', budget: 'tokens', forcedFinalAnswer: false }\n : undefined\n }\n\n try {\n await emit({\n type: 'span-start', trace: root, at: startedAt,\n name: `invoke_agent ${options.trace?.agentId ?? 'agent'}`, kind: 'invoke_agent',\n attributes: {\n 'gen_ai.operation.name': 'invoke_agent',\n 'gen_ai.agent.id': options.trace?.agentId ?? 'agent',\n 'gen_ai.agent.name': options.trace?.agentName ?? options.trace?.agentId ?? 'agent',\n 'gen_ai.request.model': options.config.model,\n ...options.trace?.conversationId === undefined\n ? {}\n : { 'gen_ai.conversation.id': options.trace.conversationId },\n },\n })\n rootStarted = true\n await emit({ type: 'turn-start', turn, trace: root })\n\n turnLifecycle: while (true) {\n while (reason === undefined && steps < maxSteps && !signal.aborted) {\n reason = admissionStop()\n if (reason !== undefined) break\n // Auto has no step countdown. Warn from the same usage total as admission,\n // before a hard token stop can leave the agent without a reporting call.\n const usedTokens = budgetTokenTotal(summarizeModelCallUsage(modelCallReports))\n if (bounds.maxTotalTokens !== 'auto' && usedTokens !== undefined) {\n const crossed = [0.5, 0.75, 0.9].filter(ratio => usedTokens >= maxTotalTokens * ratio).length\n if (crossed > tokenRemindersSent) {\n tokenRemindersSent = crossed\n const remaining = Math.max(0, maxTotalTokens - usedTokens)\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-token-guard' },\n content: [{ type: 'text', text: `Token budget: ${remaining} of ${bounds.maxTotalTokens} aggregate tokens remain. Each request also spends input tokens on the accumulated context. `\n + (crossed >= 2 ? 'Stop broad exploration. ' : 'Prioritize outstanding verification and reporting. ')\n + 'Reserve capacity for the required self-check, honest todo reconciliation and substantive final report. State unavailable evidence and unfinished work; do not claim it is verified. No extra model call is allowed after the hard token limit.',\n }],\n }) })\n }\n }\n // Leave time to reconcile a plan and submit a result before the final\n // tools-disabled summary. Tool-call reminders do not cover step limits.\n if (!stepReminderSent && steps > 0 && maxSteps - steps <= 2) {\n stepReminderSent = true\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-step-guard' },\n content: [{ type: 'text', text:\n `${maxSteps - steps} work steps remain. Finish essential verification, update any task list honestly, and submit the result if required. Summarize findings, evidence, and unfinished work; do not start new exploration.`,\n }],\n }) })\n }\n // Recomputed before the request that will read it, so a section reacting to\n // the previous step's tool calls is already on the surface.\n if (contextSections !== undefined) {\n await contextSections.reconcile(steps, contextTouches, signal)\n contextTouches = []\n }\n const step = steps + 1\n const round = await modelRound(\n options, signal, emit, emitMaintenance, root, turn, step,\n dedicatedFinalOutput\n ? 'process'\n : options.outputFormat?.type === 'json_schema' ? 'final' : 'standard',\n )\n steps++\n if (round.report !== undefined) modelCallReports.push(round.report)\n if (round.message !== undefined) {\n options.history.append({\n kind: 'assistant', message: round.message,\n ...round.finish.kind === 'aborted' ? { interrupted: true as const } : {},\n ...round.usage === undefined ? {} : { usage: round.usage },\n })\n await emit({ type: 'assistant-message', message: round.message, trace: round.trace })\n await emitAssistantContent(round, emit)\n text = textOf(round.message.content)\n }\n usageStop = accountingUsageStop(options.accounting) ?? (round.usageRequired\n ? { kind: 'error', failure: { message: 'provider usage is required by the configured run policy', code: 'USAGE_REQUIRED' } }\n : round.usageUnavailable\n ? { kind: 'usage-unavailable', modelCallId: round.report?.modelCallId ?? 'unknown' }\n : undefined)\n if (signal.aborted || round.finish.kind === 'aborted') { reason = { kind: 'aborted' }; break }\n // Pair emitted tool calls with declined results even when policy stops the\n // run; never execute those calls or allow a retry hook to override policy.\n if (round.finish.kind === 'error' && usageStop !== undefined) {\n reason = { kind: 'error', failure: round.finish.failure }\n break\n }\n if (round.usageRequired && (round.calls.length === 0 || options.tools === undefined)) { reason = usageStop; break }\n if (round.finish.kind === 'error' && !round.usageRequired) {\n reason = admissionStop()\n if (reason !== undefined) break\n const decision = await runOptionalHook(options.hooks?.onRequestError, [{\n turn, step, failure: round.finish.failure, snapshot: options.history.snapshot(), signal,\n ...(options.logger === undefined ? {} : { logger: options.logger }),\n emit: emitMaintenance,\n }], options, signal, 'onRequestError')\n const maintenanceStop = accountingUsageStop(options.accounting)\n if (maintenanceStop !== undefined) { reason = signal.aborted ? { kind: 'aborted' } : maintenanceStop; break }\n if (decision === 'retry' && steps < maxSteps) continue\n reason = { kind: 'error', failure: round.finish.failure }\n break\n }\n if (round.finish.kind === 'max-tokens' && !round.usageRequired) { reason = { kind: 'max-tokens' }; break }\n if (round.calls.length === 0 && round.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: round.report?.modelCallId ?? 'unknown' }\n break\n }\n if (round.calls.length === 0 && dedicatedFinalOutput) {\n reason = admissionStop()\n if (reason !== undefined) break\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'structured-output-finalizer' },\n content: [{\n type: 'text',\n text: 'The process phase is complete. Return the final answer now in the requested output format. Do not call tools.',\n }],\n }) })\n const final = await modelRound(\n options, signal, emit, emitMaintenance, root, turn, steps + 1, 'final',\n )\n steps++\n if (final.report !== undefined) modelCallReports.push(final.report)\n if (final.message !== undefined) {\n options.history.append({\n kind: 'assistant', message: final.message,\n ...final.usage === undefined ? {} : { usage: final.usage },\n })\n await emit({ type: 'assistant-message', message: final.message, trace: final.trace })\n await emitAssistantContent(final, emit)\n text = textOf(final.message.content)\n }\n if (final.finish.kind === 'aborted') reason = { kind: 'aborted' }\n else if (final.finish.kind === 'error') reason = { kind: 'error', failure: final.finish.failure }\n else if (final.finish.kind === 'max-tokens') reason = { kind: 'max-tokens' }\n else if (final.usageRequired) reason = { kind: 'error', failure: {\n message: 'provider usage is required by the configured run policy',\n code: 'USAGE_REQUIRED',\n } }\n else if (final.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: final.report?.modelCallId ?? 'unknown' }\n } else reason = { kind: 'completed' }\n break\n }\n // A provider that repeated an id had the repeat dropped. Saying so is what\n // keeps the model from reading one result for two calls as a tool that\n // silently ignored it.\n if (round.droppedDuplicateCalls !== undefined) {\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-duplicate-guard' },\n content: [{\n type: 'text',\n text: `You reused the tool-call id ${round.droppedDuplicateCalls.map(id => `'${id}'`).join(', ')}.`\n + ' A result pairs to exactly one call, so the repeat was not run and only the first'\n + ' call of that id has a result. Give every call its own id, and call again if you'\n + ' still need what the dropped one would have done.',\n }],\n }) })\n }\n if (round.calls.length === 0 || options.tools === undefined) { reason = { kind: 'completed' }; break }\n\n // Calls the budget does not govern: submitting, asking, delegating. They\n // are dispatched even when the budget is spent, so the model always has a\n // legal way to finish. See `ToolDefinition.budgetExempt`.\n const budgetedCalls = round.calls\n .filter(call => options.tools?.get(call.toolName)?.budgetExempt !== true).length\n const remaining = Math.max(0, bounds.maxToolCalls - toolCalls)\n let repeatProjection = lastRepeat\n const projectedRepeats = round.calls.map(call => {\n const key = repeatKey(call)\n // Count consecutive calls, not lifetime visits to a source or test command.\n // Distinct intervening work may change its result. Alternating loops are\n // handled separately by the step-cycle guard below.\n const count = repeatProjection?.key === key ? repeatProjection.count + 1 : 1\n repeatProjection = { key, count }\n return count\n })\n const repeatedLimitBeforeDispatch = projectedRepeats.some(count => count >= bounds.repeatToolLimit)\n const actionPattern = toolActionPattern(round.calls)\n const projectedCycle = repeatedSuffixCycle(\n [...actionSteps, actionPattern],\n bounds.maxToolCycleLength,\n )\n const cycleLimitBeforeDispatch = projectedCycle !== undefined\n && projectedCycle.repetitions >= bounds.toolCycleLimit\n const currentUsage = summarizeModelCallUsage(modelCallReports)\n const budgetTokens = budgetTokenTotal(currentUsage)\n const tokenLimitBeforeDispatch = budgetTokens !== undefined\n && budgetTokens >= maxTotalTokens\n const guardDeclined = repeatedLimitBeforeDispatch || cycleLimitBeforeDispatch || tokenLimitBeforeDispatch || round.usageRequired\n // Name the limit that actually declined the call. Reporting a repeat guard\n // as an empty budget teaches the model the wrong lesson, and it repeats the\n // call on the next turn with the budget it was told it lacked.\n const declineReason: ToolDeclineReason = tokenLimitBeforeDispatch\n ? 'tokens'\n : cycleLimitBeforeDispatch\n ? 'tool-call-cycle'\n : repeatedLimitBeforeDispatch\n ? 'repeated-tool-call'\n : round.usageRequired\n ? 'usage-required'\n : 'tool-calls'\n // `continue` takes the wall down: the budget becomes a notice and the turn\n // is bounded by steps, tokens, and the run-level ledger instead. Guards\n // that mean \"this is not working\" still decline, whatever the setting.\n const budgetIsAWall = bounds.onExhausted !== 'continue'\n const scheduled = await scheduleToolCalls({\n calls: round.calls, catalog: options.tools, history: options.history,\n position: { turn, step,\n ...(options.accounting === undefined ? {} : { runId: options.accounting.runId }),\n ...(options.trace?.conversationId === undefined ? {} : { conversationId: options.trace.conversationId }),\n }, signal, parentTrace: root,\n maxParallel: bounds.maxParallel,\n dispatchLimit: guardDeclined ? 0 : budgetIsAWall ? remaining : round.calls.length,\n declineReason,\n maxResultBytes: bounds.maxToolResultBytes,\n maxResultTokens: bounds.maxToolResultTokens,\n resultOverflow: bounds.toolResultOverflow,\n ...options.spillStore === undefined ? {} : { spillStore: options.spillStore },\n maxDurationMs: bounds.maxToolDurationMs,\n teardownTimeoutMs: bounds.toolTeardownTimeoutMs,\n ...(options.logger === undefined ? {} : { logger: options.logger }),\n ...options.interceptors === undefined ? {} : { interceptors: options.interceptors },\n ...options.approvals === undefined ? {} : { approvals: options.approvals },\n ...options.accounting === undefined ? {} : { accounting: options.accounting },\n emit,\n ...options.hooks?.checkpoint === undefined ? {} : {\n checkpoint: (context: Parameters<NonNullable<TurnHooks['checkpoint']>>[0]) => runHook(\n Promise.resolve(options.hooks?.checkpoint?.(context)), options, signal, 'checkpoint',\n ),\n },\n }, {\n admissionLimit: guardDeclined ? 0 : budgetIsAWall ? remaining : 'unbounded',\n ...programs === undefined ? {} : { programs },\n ...programResults === undefined ? {} : { programResults },\n })\n // Results commit in model order, one per requested call, so the pairing\n // holds for declined calls too. A short result list means a sibling failed\n // its contract and the turn is already unwinding; reporting a guessed\n // outcome would be worse than reporting nothing.\n if (contextSections !== undefined && scheduled.results.length === round.calls.length) {\n contextTouches.push(...round.calls.map((call, index) => ({\n toolName: call.toolName,\n rawArguments: call.rawArguments,\n failed: scheduled.results[index]?.isError ?? true,\n })))\n }\n toolCalls += scheduled.budgeted\n const remainingAfterDispatch = Math.max(0, bounds.maxToolCalls - toolCalls)\n // One reminder per threshold crossed, not one per turn.\n //\n // This was a single boolean: the model was told once, at 25% remaining,\n // and then never again however close it came to the end. A model warned at\n // sixteen calls left and still exploring at four has been told nothing\n // since, and runs into the wall with no notice — which is what produces a\n // red \"no remaining tool-call budget\" where an answer should have been.\n //\n // Codex counts thresholds rather than remembering a flag\n // (`rollout_budget.rs`, `reminder_index`): every threshold now below the\n // remaining budget that has not been reported yet gets reported. Crossing\n // several at once collapses into the one that matters, the lowest.\n const crossed = budgetReminders.filter(threshold => remainingAfterDispatch <= threshold).length\n if (crossed > budgetRemindersSent && remainingAfterDispatch > 0) {\n budgetRemindersSent = crossed\n appendBudgetNotice(\n `Tool budget: ${remainingAfterDispatch} of ${bounds.maxToolCalls} calls remain in this turn.`\n + ' Stop broad exploration, make the necessary edits, and reserve calls for'\n + (budgetIsAWall\n ? ' verification. When the budget runs out no further work call will run, so'\n + ' finish with what you can still verify.'\n : ' verification. Past the budget you are expected to be wrapping up, not'\n + ' opening new lines of work.'),\n )\n }\n // Past the budget with the wall down. The turn is not stopped — the model\n // keeps its tools — but it is told, once per further budget spent, that it\n // is now expected to be finishing. This is the shape of Codex's\n // `budget_limit` goal prompt: no new substantive work, wrap up, name what\n // is left.\n if (!budgetIsAWall && remainingAfterDispatch === 0) {\n const windows = Math.floor(toolCalls / bounds.maxToolCalls)\n if (windows > overBudgetNoticesSent) {\n overBudgetNoticesSent = windows\n appendBudgetNotice(\n `Tool budget spent: ${toolCalls} calls made against a budget of ${bounds.maxToolCalls}.`\n + ' Do not start new substantive work. Finish what is in flight, verify what you'\n + ' can, and answer — stating plainly what is unverified or unfinished.',\n )\n }\n }\n await emit({ type: 'step-end', turn, step, trace: round.trace })\n\n actionSteps.push(actionPattern)\n let repeatedLimit = repeatedLimitBeforeDispatch\n for (let index = 0; index < round.calls.length; index++) {\n const call = round.calls[index]\n const result = scheduled.results[index]\n if (call === undefined || result === undefined) continue\n consecutiveErrors = result.isError ? consecutiveErrors + 1 : 0\n const key = repeatKey(call)\n const count = lastRepeat?.key === key ? lastRepeat.count + 1 : 1\n lastRepeat = { key, count }\n if (count === bounds.repeatToolWarningAt) {\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-repeat-guard' },\n content: [{ type: 'text', text: `You have called ${call.toolName} with the same arguments ${count} consecutive times. Reassess before repeating it.` }],\n }) })\n }\n if (count >= bounds.repeatToolLimit) repeatedLimit = true\n }\n if (projectedCycle?.repetitions === bounds.toolCycleWarningAt) {\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'tool-loop-cycle-guard' },\n content: [{\n type: 'text',\n text: `Tool-use pattern repeated ${projectedCycle.repetitions} times across ${projectedCycle.period} step(s). Reassess the approach and identify concrete new evidence before continuing.`,\n }],\n }) })\n }\n if (scheduled.concluded) { reason = { kind: 'concluded-by-tool', toolName: scheduled.concludedBy ?? 'unknown' }; break }\n if (signal.aborted) { reason = { kind: 'aborted' }; break }\n if (round.usageRequired) { reason = usageStop; break }\n if (round.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: round.report?.modelCallId ?? 'unknown' }\n break\n }\n let exhausted: ExhaustedBudget | undefined\n const reportReserveReached = bounds.maxTotalTokens !== 'auto'\n && bounds.finalReportReserveTokens > 0 && budgetTokens !== undefined\n && budgetTokens >= maxTotalTokens - bounds.finalReportReserveTokens\n if (tokenLimitBeforeDispatch) exhausted = 'tokens'\n else if (reportReserveReached) exhausted = 'tokens'\n else if (cycleLimitBeforeDispatch) exhausted = 'tool-call-cycle'\n else if (budgetIsAWall && budgetedCalls > remaining) exhausted = 'tool-calls'\n else if (consecutiveErrors >= bounds.maxConsecutiveToolErrors) exhausted = 'consecutive-tool-errors'\n else if (repeatedLimit) exhausted = 'repeated-tool-call'\n else if (steps >= maxSteps) exhausted = 'steps'\n if (exhausted !== undefined) {\n const forced = (exhausted !== 'tokens' || (reportReserveReached && !tokenLimitBeforeDispatch))\n && bounds.onExhausted !== 'stop'\n && admissionStop() === undefined\n if (forced) {\n const final = await modelRound(\n options, signal, emit, emitMaintenance, root, turn, steps + 1, 'forced-final',\n )\n steps++\n if (final.report !== undefined) modelCallReports.push(final.report)\n if (final.message !== undefined) {\n options.history.append({ kind: 'assistant', message: final.message, ...final.usage === undefined ? {} : { usage: final.usage } })\n await emit({ type: 'assistant-message', message: final.message, trace: final.trace })\n await emitAssistantContent(final, emit)\n text = textOf(final.message.content)\n }\n if (final.finish.kind === 'aborted') {\n reason = { kind: 'aborted' }\n break\n }\n if (final.finish.kind === 'error') {\n reason = { kind: 'error', failure: final.finish.failure }\n break\n }\n if (final.finish.kind === 'max-tokens') {\n reason = { kind: 'max-tokens' }\n break\n }\n if (final.usageRequired) {\n reason = { kind: 'error', failure: {\n message: 'provider usage is required by the configured run policy',\n code: 'USAGE_REQUIRED',\n } }\n break\n }\n if (final.usageUnavailable) {\n reason = accountingUsageStop(options.accounting) ?? { kind: 'usage-unavailable', modelCallId: final.report?.modelCallId ?? 'unknown' }\n break\n }\n }\n reason = { kind: 'budget-exhausted', budget: exhausted, forcedFinalAnswer: forced,\n ...(exhausted === 'tokens' && reportReserveReached && !tokenLimitBeforeDispatch\n ? { trigger: 'report-reserve' as const } : {}),\n }\n }\n }\n\n if (reason === undefined) {\n reason = signal.aborted\n ? { kind: 'aborted' }\n : { kind: 'budget-exhausted', budget: 'steps', forcedFinalAnswer: false }\n }\n const usageReport = summarizeModelCallUsage(modelCallReports)\n const usage = authoritativeTokenUsage(usageReport)\n const candidate: TurnOutcome = {\n reason, text, steps, usageReport, toolCalls, traceId,\n ...usage === undefined ? {} : { usage },\n }\n const entriesBeforeHook = options.history.entries().length\n const canContinue = reason.kind === 'completed'\n && steps < maxSteps\n && admissionStop() === undefined\n await runOptionalHook(options.hooks?.onTurnEnd, [{\n outcome: candidate,\n snapshot: options.history.snapshot(),\n canContinue,\n }], options, signal, 'onTurnEnd')\n // Hooks object by appending context rather than by returning a veto. Re-run only\n // a normally completed turn; abort/error/budget outcomes remain terminal.\n if (canContinue\n && options.history.entries().length > entriesBeforeHook\n && !signal.aborted) {\n reason = undefined\n continue turnLifecycle\n }\n outcome = candidate\n break\n }\n if (outcome.reason.kind === 'aborted') {\n // Without this, the next turn sees an unfinished request and a cancelled\n // tool call, and a model resumes the abandoned work instead of answering\n // the new message (observed live). Codex and Claude Code record the same\n // interruption marker.\n options.history.append({ kind: 'user', message: createUserMessage({\n source: { kind: 'app', producer: 'turn-interrupted' },\n content: [{ type: 'text', text: 'The previous request was interrupted before it finished. Use the next message to determine what to do next.' }],\n }) })\n }\n await emit({\n type: 'span-end', trace: root, at: now(),\n status: outcome.reason.kind === 'error' ? 'error' : outcome.reason.kind === 'aborted' ? 'aborted' : 'success',\n output: { reason: outcome.reason, text },\n ...outcome.usage === undefined ? {} : { usage: outcome.usage },\n ...outcome.reason.kind === 'error' ? { error: { type: 'ModelError', message: outcome.reason.failure.message, code: outcome.reason.failure.code } } : {},\n })\n rootEnded = true\n if (turnOperationId !== undefined) {\n options.accounting?.endOperation(\n turnOperationId,\n outcome.reason.kind === 'error' ? 'error' : outcome.reason.kind === 'aborted' ? 'aborted' : 'success',\n { data: { reason: outcome.reason.kind, steps, toolCalls } },\n )\n turnOperationEnded = true\n }\n await emit({ type: 'turn-end', outcome, trace: root })\n } catch (error: unknown) {\n const code = errorCodeOf(error)\n if (rootStarted && !rootEnded) {\n await emit({\n type: 'span-end', trace: root, at: now(), status: signal.aborted ? 'aborted' : 'error',\n error: {\n type: error instanceof Error ? error.name : 'RuntimeError',\n message: messageOf(error),\n ...code === undefined ? {} : { code },\n },\n }).catch(() => undefined)\n }\n if (turnOperationId !== undefined && !turnOperationEnded) {\n options.accounting?.endOperation(\n turnOperationId,\n signal.aborted ? 'aborted' : 'error',\n { error },\n )\n turnOperationEnded = true\n }\n throw error\n } finally {\n programResults?.close()\n }\n}\n\n\nexport type { RunTurnOptions } from './turn/types.ts'\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"schedule.d.ts","names":[],"sources":["../../../src/agent/loop/schedule.ts"],"mappings":";;;;;;;;;;;UAuBiB;WACN,gBAAgB;WAChB,SAAS;WACT,SAAS;WACT,UAAU;WACV,QAAQ;WACR,SAAS;WACT,aAAa;WACb;;;;;;;WAOA;;WAEA,gBAAgB;;WAEhB;;WAEA,iBAAiB;;WAEjB,aAAa;;WAEb;;WAEA;;WAEA;WACA,wBAAwB;WACxB,YAAY;WACZ,QAAQ,OAAO,eAAe;WAC9B,aAAa;WACb,aAAa;;UAEP;WACN,kBAAkB;WAClB;WACA;WACA;;WAEA;;WAEA;;;iBAmBW,aAAa,SAAS,sBAAsB,QAAQ"}
1
+ {"version":3,"file":"schedule.d.ts","names":[],"sources":["../../../src/agent/loop/schedule.ts"],"mappings":";;;;;;;;;;;UA8BiB;WACN,gBAAgB;WAChB,SAAS;WACT,SAAS;WACT,UAAU;WACV,QAAQ;WACR,SAAS;WACT,aAAa;WACb;;;;;;;WAOA;;WAEA,gBAAgB;;WAEhB;;WAEA,iBAAiB;;WAEjB,aAAa;;WAEb;;WAEA;;WAEA;WACA,wBAAwB;WACxB,YAAY;WACZ,QAAQ,OAAO,eAAe;WAC9B,aAAa;WACb,aAAa;;UAEP;WACN,kBAAkB;WAClB;WACA;WACA;;WAEA;;WAEA;;;iBAgCW,aAAa,SAAS,sBAAsB,QAAQ"}
@@ -1,3 +1,3 @@
1
- import{detachedFrozen as e}from"../../primitives/snapshot.js";import{waitForSettlement as t}from"../../async/settlement.js";import{createSpanId as n}from"../../observation/context.js";import{createToolResultMessage as r,createUserMessage as i}from"../../message/message.js";import{estimateTextBlockTokens as a,previewForSpill as o,truncateMiddleToTokens as s}from"../tool/output-budget.js";import{TOOL_ERROR_CODES as c,ToolError as l,toolErrorDisposition as u}from"../tool/errors.js";import{authorizeToolCall as d,dispatchAuthorizedToolCall as f,finalizeToolCall as p,prepareToolCall as m,toolFailure as h}from"../tool/pipeline.js";async function g(e){let t=M(e.maxParallel??8,`maxParallel`),n=M(e.maxResultBytes??4194304,`maxResultBytes`),r=M(e.maxDurationMs??6e5,`maxDurationMs`),i=M(e.teardownTimeoutMs??3e4,`teardownTimeoutMs`),a=Object.freeze(e.calls.map(T)),o=Math.max(0,e.dispatchLimit??a.length),s=[],c=0,l=0,u=0,d,f=0,p;for(;f<a.length;){let m=a[f];if(m===void 0)break;let h=p??_(e,m);if(p=void 0,h.mode===`exclusive`){let t=await v(e,h,l<o,r,i);c+=+!!t.dispatched,l+=+(t.budgeted===!0),u+=+(t.declined===!0);let a=await S(e,t,n);s.push(a),d===void 0&&!a.isError&&a.concludesTurn&&(d=m.toolName),f++;continue}let g=[],y=new AbortController,b={...e,signal:AbortSignal.any([e.signal,y.signal])},C=h;try{for(;f<a.length&&g.length<t&&a[f]!==void 0;){let e=C;if(e.mode!==`parallel`)break;let n=await v(b,e,l<o,r,i);c+=+!!n.dispatched,l+=+(n.budgeted===!0),u+=+(n.declined===!0),g.push(n),f++;let s=a[f];s!==void 0&&g.length<t&&(C=_(b,s),C.mode!==`parallel`&&(p=C))}}catch(t){throw y.abort(t),await x(e,g,n),t}if(g.length===0)continue;let w,T=!1;for(let t of g)try{let r=await S(e,t,n);s.push(r),d===void 0&&!r.isError&&r.concludesTurn&&(d=t.call.toolName)}catch(e){T||(w=e),T=!0,y.abort(e)}if(T)throw w}return{results:Object.freeze(s),concluded:d!==void 0,...d===void 0?{}:{concludedBy:d},dispatched:c,budgeted:l,declined:u}}function _(e,t){return m({catalog:e.catalog,call:t,position:e.position,signal:e.signal,...e.logger===void 0?{}:{logger:e.logger},...e.interceptors===void 0?{}:{interceptors:e.interceptors},...e.approvals===void 0?{}:{approvals:e.approvals}})}async function v(e,r,i,a,o){let s=AbortSignal.timeout(a),l=AbortSignal.any([e.signal,s]),u={...r,options:{...r.options,signal:l,teardownTimeoutMs:o},context:{...r.context,signal:l}},p=u.options.call,m={traceId:e.parentTrace.traceId,spanId:n(),parentSpanId:e.parentTrace.spanId};e.history.append({kind:`tool-call`,callId:p.callId,name:p.toolName,rawArguments:p.rawArguments}),await j(e,{type:`span-start`,trace:m,at:F(),name:`execute_tool ${p.toolName}`,kind:`execute_tool`,attributes:{"gen_ai.operation.name":`execute_tool`,"gen_ai.tool.name":p.toolName,"gen_ai.tool.call.id":p.callId},input:p.rawArguments}),await j(e,{type:`tool-call`,call:p,trace:m});let g=e.catalog.get(p.toolName)?.budgetExempt===!0;if(!i&&!g)return{call:p,trace:m,signal:l,deadline:s,teardownTimeoutMs:o,dispatched:!1,declined:!0,pending:Promise.resolve(y(e.declineReason??`tool-calls`))};if(e.signal.aborted)return{call:p,trace:m,signal:l,deadline:s,teardownTimeoutMs:o,dispatched:!1,pending:Promise.resolve(h(`the call was cancelled before it started`,c.ABORTED_BEFORE_DISPATCH))};let _,v={...u,options:{...u.options,onApprovalRequest:async t=>{_=e.accounting?.startOperation(`user-input`,{toolCallId:t.callId,data:{action:`approval`,toolName:t.toolName}}),await j(e,{type:`approval-request`,request:t,trace:m})},...e.accounting===void 0?{}:{onApprovalSettled:(t,n)=>{_!==void 0&&(e.accounting?.endOperation(_,t,n===void 0?{}:{error:n}),_=void 0)}}}},b=d(v),x;try{x=await A(b,l)}catch(e){if(!l.aborted)throw e;if(!await t(b,o))throw k(p.toolName,`authorization`,o,e);return{call:p,trace:m,signal:l,deadline:s,teardownTimeoutMs:o,dispatched:!1,pending:Promise.resolve(O(s,a))}}if(x.kind===`final`)return{call:p,trace:m,signal:l,deadline:s,teardownTimeoutMs:o,dispatched:!1,pending:Promise.resolve(x.result)};try{await e.checkpoint?.({kind:`before-tool-dispatch`,call:p,snapshot:e.history.snapshot(),signal:l,...e.logger===void 0?{}:{logger:e.logger}})}catch(e){return{call:p,trace:m,signal:l,deadline:s,teardownTimeoutMs:o,dispatched:!1,pending:Promise.resolve(h(`history checkpoint failed: ${P(e)}`,c.CHECKPOINT_FAILED))}}let S=f(x.call);return S.catch(()=>void 0),{call:p,trace:m,signal:l,deadline:s,teardownTimeoutMs:o,authorized:x.call,dispatched:!0,budgeted:!g,pending:S}}function y(e){return{isError:!1,value:void 0,content:[{type:`text`,text:b(e)}],meta:{declined:!0,reason:e}}}function b(e){let t=` Answer now from what you already have, and say plainly what is unverified or unfinished.`;switch(e){case`tool-calls`:return`This call was not run: the turn has spent its tool-call budget. Further work calls will not run either, so do not retry it.`+t;case`repeated-tool-call`:return`This call was not run: it repeats a call already made with the same arguments, and repeating it cannot produce a new result. Change approach or finish.`+t;case`tool-call-cycle`:return`This call was not run: the same sequence of calls has repeated several times without progress. Break the cycle rather than re-entering it.`+t;case`tokens`:return`This call was not run: the turn has spent its token budget.`+t;case`consecutive-tool-errors`:return`This call was not run: too many calls in a row have failed. Something in the approach is wrong, not the individual call.`+t;case`steps`:return`This call was not run: the turn has no model steps left.`+t;case`usage-required`:return`This call was not run: the run policy requires provider usage reporting that the last model call did not supply.`+t}}async function x(e,t,n){for(let r of t)try{await S(e,r,n)}catch{}}async function S(e,n,a){let o,s,c=!1;try{let r;try{r=await A(n.pending,n.signal)}catch(e){if(!n.signal.aborted)throw e;if(!await t(n.pending,n.teardownTimeoutMs))throw k(n.call.toolName,`execution`,n.teardownTimeoutMs,e);r=O(n.deadline)}let i=r;if(n.authorized!==void 0){let e=p(n.authorized,r);try{i=await A(e,n.signal)}catch(r){if(!n.signal.aborted)throw r;if(!await t(e,n.teardownTimeoutMs))throw k(n.call.toolName,`finalization`,n.teardownTimeoutMs,r);i=O(n.deadline)}}o=E(await C(e,n,i),a)}catch(e){c=u(e)===`fatal`,s=e,o=E(h(P(e),N(e)),a)}let l=r({callId:n.call.callId,content:[...o.content],isError:o.isError});if(e.history.append({kind:`tool-result`,callId:n.call.callId,message:l,result:o}),await j(e,{type:`tool-result`,call:n.call,result:o,trace:n.trace}),await j(e,{type:`span-end`,trace:n.trace,at:F(),status:o.isError?`error`:`success`,output:o.isError?{error:o.error}:o.value,...o.isError?{error:{type:`ToolError`,message:o.error.message,code:o.error.code}}:{}}),o.additionalContext!==void 0&&e.history.append({kind:`user`,message:i({content:[...o.additionalContext],source:{kind:`app`,producer:`tool:${n.call.toolName}`}})}),c)throw s;return o}async function C(e,t,n){let r=e.maxResultTokens,i=e.catalog.get(t.call.toolName)?.maxOutputTokens,c=r===void 0?i:i===void 0?r:Math.min(r,i);if(c===void 0)return n;let l=a(n.content);if(l<=c)return n;let u=n.content.filter(e=>e.type===`text`);if(u.length===0)return n;let d=u.map(e=>e.text).join(`
2
- `),f=e.resultOverflow??`auto`,p=e.spillStore;if(f!==`truncate`&&p!==void 0)try{let e=await p.save(d,{toolName:t.call.toolName,callId:String(t.call.callId)});return w(n,`${o(d,Math.max(1,Math.floor(c*.75)))}\n\n[Output exceeded this call's budget of ${String(c)} estimated tokens. The full ${String(e.bytes)} bytes are saved. ${e.retrieval}]`,{outputSpilled:{locator:e.locator,bytes:e.bytes,estimatedTokens:l}})}catch{}let m=s(d,c);return w(n,m.text+`\n\n[Output was ${String(m.originalTokens)} estimated tokens, over this call's budget of ${String(c)}. Re-run more narrowly if you need the omitted part.]`,{outputTruncated:{estimatedTokens:m.originalTokens,budget:c}})}function w(e,t,n){let r=!1,i=[];for(let n of e.content){if(n.type!==`text`){i.push(n);continue}r||(r=!0,i.push({type:`text`,text:t}))}return{...e,content:i,meta:{...e.meta,...n}}}function T(t){if(typeof t.callId!=`string`||t.callId.length===0||typeof t.toolName!=`string`||t.toolName.length===0||typeof t.rawArguments!=`string`)throw TypeError(`tool call identity, name, and raw arguments must be strings`);return e(t)}function E(t,n){try{if(D(t)>n)return e(h(`tool result exceeds the ${n}-byte retention limit`,c.INVALID_RESULT));let r=e(t);return D(r)>n?e(h(`tool result exceeds the ${n}-byte retention limit`,c.INVALID_RESULT)):r}catch(e){throw l.fatal(`tool result could not be detached as lossless structured data`,c.INVALID_RESULT,{cause:e})}}function D(e){let t=JSON.stringify(e);if(t===void 0)throw TypeError(`tool result is not lossless JSON`);return new TextEncoder().encode(t).byteLength}function O(e,t){let n=t===void 0?`configured time limit`:`${t}ms time limit`;return e.aborted?h(`the tool exceeded its ${n}`,c.TIMEOUT):h(`the call was cancelled`,c.ABORTED)}function k(e,t,n,r){return l.fatal(`tool "${e}" ${t} ignored cancellation for more than ${n}ms; the in-process operation may still be running`,c.TEARDOWN_TIMEOUT,{cause:r})}async function A(e,t){if(t.aborted)throw t.reason??Error(`tool call aborted`);return await new Promise((n,r)=>{let i=()=>{t.removeEventListener(`abort`,i),r(t.reason??Error(`tool call aborted`))};t.addEventListener(`abort`,i,{once:!0}),e.then(e=>{t.removeEventListener(`abort`,i),n(e)},e=>{t.removeEventListener(`abort`,i),r(e)})})}async function j(t,n){await t.emit?.(e(n))}function M(e,t){if(!Number.isInteger(e)||e<1)throw RangeError(`${t} must be a positive integer`);return e}function N(e){return typeof e==`object`&&e&&`code`in e&&typeof e.code==`string`?e.code:c.FAILED}function P(e){return e instanceof Error?e.message:String(e)}function F(){return new Date().toISOString()}export{g as runToolCalls};
1
+ import{detachedFrozen as e}from"../../primitives/snapshot.js";import{waitForSettlement as t}from"../../async/settlement.js";import{createSpanId as n}from"../../observation/context.js";import{createToolResultMessage as r,createUserMessage as i}from"../../message/message.js";import{estimateTextBlockTokens as a,previewForSpill as o,truncateMiddleToTokens as s}from"../tool/output-budget.js";import{TOOL_ERROR_CODES as c,ToolError as l,toolErrorDisposition as u}from"../tool/errors.js";import{NESTED_TOOL_ERROR_CODES as d,attachNestedToolPort as f}from"../tool/nested.js";import{authorizeToolCall as p,dispatchAuthorizedToolCall as m,finalizeToolCall as h,prepareToolCall as g,toolFailure as _}from"../tool/pipeline.js";import{createToolAdmission as v}from"./admission.js";import{emitEvent as y,errorCode as b,immutableResult as x,messageOf as S,now as C,raceWithSignal as w,teardownFailure as T,withApprovalEvents as E}from"./tool-call-support.js";import{ProgramRun as D,validPrograms as O}from"./program.js";async function k(e){return await A(e)}async function A(e,t={}){let n=H(e.maxParallel??8,`maxParallel`),r=H(e.maxResultBytes??4194304,`maxResultBytes`),i=H(e.maxDurationMs??6e5,`maxDurationMs`),a=H(e.teardownTimeoutMs??3e4,`teardownTimeoutMs`),o=Object.freeze(e.calls.map(B)),s=v(t.admissionLimit??Math.max(0,e.dispatchLimit??o.length)),c={admission:s,maxDurationMs:i,teardownTimeoutMs:a,maxResultBytes:r,programs:O(t.programs),programResults:t.programResults},l=[],u=0,d=0,f,p=0,m;for(;p<o.length;){let t=o[p];if(t===void 0)break;let i=m??j(e,t);if(m=void 0,i.mode===`exclusive`){let n=await M(e,i,c);u+=+!!n.dispatched,d+=+(n.declined===!0);let a=await L(e,n,r);l.push(a),f===void 0&&!a.isError&&a.concludesTurn&&(f=t.toolName),p++;continue}let a=[],s=new AbortController,h={...e,signal:AbortSignal.any([e.signal,s.signal])},g=i;try{for(;p<o.length&&a.length<n&&o[p]!==void 0;){let e=g;if(e.mode!==`parallel`)break;let t=await M(h,e,c);u+=+!!t.dispatched,d+=+(t.declined===!0),a.push(t),p++;let r=o[p];r!==void 0&&a.length<n&&(g=j(h,r),g.mode!==`parallel`&&(m=g))}}catch(t){throw s.abort(t),await I(e,a,r),t}if(a.length===0)continue;let _,v=!1;for(let t of a)try{let n=await L(e,t,r);l.push(n),f===void 0&&!n.isError&&n.concludesTurn&&(f=t.call.toolName)}catch(e){v||(_=e),v=!0,s.abort(e)}if(v)throw _}return{results:Object.freeze(l),concluded:f!==void 0,...f===void 0?{}:{concludedBy:f},dispatched:u,budgeted:s.budgeted,declined:d}}function j(e,t){return g({catalog:e.catalog,call:t,position:e.position,signal:e.signal,...e.logger===void 0?{}:{logger:e.logger},...e.interceptors===void 0?{}:{interceptors:e.interceptors},...e.approvals===void 0?{}:{approvals:e.approvals}})}async function M(e,t,r){let{maxDurationMs:i,teardownTimeoutMs:a}=r,o=AbortSignal.timeout(i),s=AbortSignal.any([e.signal,o]),c={...t,options:{...t.options,signal:s,teardownTimeoutMs:a},context:{...t.context,signal:s}},l=c.options.call,u={traceId:e.parentTrace.traceId,spanId:n(),parentSpanId:e.parentTrace.spanId};e.history.append({kind:`tool-call`,callId:l.callId,name:l.toolName,rawArguments:l.rawArguments}),await y(e,{type:`span-start`,trace:u,at:C(),name:`execute_tool ${l.toolName}`,kind:`execute_tool`,attributes:{"gen_ai.operation.name":`execute_tool`,"gen_ai.tool.name":l.toolName,"gen_ai.tool.call.id":l.callId},input:l.rawArguments}),await y(e,{type:`tool-call`,call:l,trace:u});let f=e.catalog.get(l.toolName)?.budgetExempt===!0,p=r.programs.get(l.toolName);if(p!==void 0&&(f||t.mode!==`exclusive`))return{call:l,trace:u,signal:s,deadline:o,teardownTimeoutMs:a,dispatched:!1,pending:Promise.resolve(_(`this program tool must be exclusive and must not be budget-exempt`,d.CONFIGURATION))};let m=r.admission.reserve(f);if(m===void 0)return{call:l,trace:u,signal:s,deadline:o,teardownTimeoutMs:a,dispatched:!1,declined:!0,pending:Promise.resolve(P(e.declineReason??`tool-calls`))};try{return await N(e,c,l,u,s,o,m,r,p)}finally{m.release()}}async function N(e,n,r,i,a,o,s,u,d){let{maxDurationMs:h,teardownTimeoutMs:g}=u;if(e.signal.aborted)return{call:r,trace:i,signal:a,deadline:o,teardownTimeoutMs:g,dispatched:!1,pending:Promise.resolve(_(`the call was cancelled before it started`,c.ABORTED_BEFORE_DISPATCH))};let v=p(E(e,n,i)),y;try{y=await w(v,a)}catch(e){if(!a.aborted)throw e;if(!await t(v,g))throw T(r.toolName,`authorization`,g,e);return{call:r,trace:i,signal:a,deadline:o,teardownTimeoutMs:g,dispatched:!1,pending:Promise.resolve(V(o,h))}}if(y.kind===`final`)return{call:r,trace:i,signal:a,deadline:o,teardownTimeoutMs:g,dispatched:!1,pending:Promise.resolve(y.result)};try{let n=Promise.resolve(e.checkpoint?.({kind:`before-tool-dispatch`,call:r,snapshot:e.history.snapshot(),signal:a,...e.logger===void 0?{}:{logger:e.logger}}));try{await w(n,a)}catch(e){if(!a.aborted)throw e;if(!await t(n,g))throw T(r.toolName,`checkpoint`,g,e)}}catch(e){if(e instanceof l&&e.code===c.TEARDOWN_TIMEOUT)throw e;return{call:r,trace:i,signal:a,deadline:o,teardownTimeoutMs:g,dispatched:!1,pending:Promise.resolve(_(`history checkpoint failed: ${S(e)}`,c.CHECKPOINT_FAILED))}}if(a.aborted)return{call:r,trace:i,signal:a,deadline:o,teardownTimeoutMs:g,dispatched:!1,pending:Promise.resolve(V(o,h))};let b=d===void 0?void 0:new D(e,u,d,{call:r,trace:i,signal:a});b!==void 0&&f(y.call,b.port,e=>b.bindExecutionSignal(e)),s.confirm();let x=m(y.call);return x.catch(()=>void 0),{call:r,trace:i,signal:a,deadline:o,teardownTimeoutMs:g,authorized:y.call,dispatched:!0,...b===void 0?{}:{program:b},pending:x}}function P(e){return{isError:!1,value:void 0,content:[{type:`text`,text:F(e)}],meta:{declined:!0,reason:e}}}function F(e){let t=` Answer now from what you already have, and say plainly what is unverified or unfinished.`;switch(e){case`tool-calls`:return`This call was not run: the turn has spent its tool-call budget. Further work calls will not run either, so do not retry it.`+t;case`repeated-tool-call`:return`This call was not run: it repeats a call already made with the same arguments, and repeating it cannot produce a new result. Change approach or finish.`+t;case`tool-call-cycle`:return`This call was not run: the same sequence of calls has repeated several times without progress. Break the cycle rather than re-entering it.`+t;case`tokens`:return`This call was not run: the turn has spent its token budget.`+t;case`consecutive-tool-errors`:return`This call was not run: too many calls in a row have failed. Something in the approach is wrong, not the individual call.`+t;case`steps`:return`This call was not run: the turn has no model steps left.`+t;case`usage-required`:return`This call was not run: the run policy requires provider usage reporting that the last model call did not supply.`+t}}async function I(e,t,n){for(let r of t)try{await L(e,r,n)}catch{}}async function L(e,n,a){let o,s,c=!1;try{let r;try{r=await w(n.pending,n.signal)}catch(e){if(!n.signal.aborted)throw e;if(!await t(n.pending,n.teardownTimeoutMs))throw T(n.call.toolName,`execution`,n.teardownTimeoutMs,e);r=V(n.deadline)}if(n.program!==void 0){if(!await n.program.close(n.teardownTimeoutMs))throw T(n.call.toolName,`nested call`,n.teardownTimeoutMs,void 0);let e=n.program.fatal;if(e!==void 0)throw u(e)===`fatal`?e:l.fatal(S(e),b(e),{cause:e})}let i=r;if(n.authorized!==void 0){let e=h(n.authorized,r);try{i=await w(e,n.signal)}catch(r){if(!n.signal.aborted)throw r;if(!await t(e,n.teardownTimeoutMs))throw T(n.call.toolName,`finalization`,n.teardownTimeoutMs,r);i=V(n.deadline)}}o=x(await R(e,n,i),a)}catch(e){n.program?.abort(e),c=u(e)===`fatal`,s=e,o=x(_(S(e),b(e)),a)}let d=r({callId:n.call.callId,content:[...o.content],isError:o.isError});if(e.history.append({kind:`tool-result`,callId:n.call.callId,message:d,result:o}),await y(e,{type:`tool-result`,call:n.call,result:o,trace:n.trace}),await y(e,{type:`span-end`,trace:n.trace,at:C(),status:o.isError?`error`:`success`,output:o.isError?{error:o.error}:o.value,...o.isError?{error:{type:`ToolError`,message:o.error.message,code:o.error.code}}:{}}),o.additionalContext!==void 0&&e.history.append({kind:`user`,message:i({content:[...o.additionalContext],source:{kind:`app`,producer:`tool:${n.call.toolName}`}})}),c)throw s;return o}async function R(e,t,n){let r=e.maxResultTokens,i=e.catalog.get(t.call.toolName)?.maxOutputTokens,c=r===void 0?i:i===void 0?r:Math.min(r,i);if(c===void 0)return n;let l=a(n.content);if(l<=c)return n;let u=n.content.filter(e=>e.type===`text`);if(u.length===0)return n;let d=u.map(e=>e.text).join(`
2
+ `),f=e.resultOverflow??`auto`,p=e.spillStore;if(f!==`truncate`&&p!==void 0)try{let e=await p.save(d,{toolName:t.call.toolName,callId:String(t.call.callId)});return z(n,`${o(d,Math.max(1,Math.floor(c*.75)))}\n\n[Output exceeded this call's budget of ${String(c)} estimated tokens. The full ${String(e.bytes)} bytes are saved. ${e.retrieval}]`,{outputSpilled:{locator:e.locator,bytes:e.bytes,estimatedTokens:l}})}catch{}let m=s(d,c);return z(n,m.text+`\n\n[Output was ${String(m.originalTokens)} estimated tokens, over this call's budget of ${String(c)}. Omitted output does not mean the operation failed. Check an existing receipt or current state; repeat the operation only when the host confirms it is safe.]`,{outputTruncated:{estimatedTokens:m.originalTokens,budget:c}})}function z(e,t,n){let r=!1,i=[];for(let n of e.content){if(n.type!==`text`){i.push(n);continue}r||(r=!0,i.push({type:`text`,text:t}))}return{...e,content:i,meta:{...e.meta,...n}}}function B(t){if(typeof t.callId!=`string`||t.callId.length===0||typeof t.toolName!=`string`||t.toolName.length===0||typeof t.rawArguments!=`string`)throw TypeError(`tool call identity, name, and raw arguments must be strings`);return e(t)}function V(e,t){let n=t===void 0?`configured time limit`:`${t}ms time limit`;return e.aborted?_(`the tool exceeded its ${n}`,c.TIMEOUT):_(`the call was cancelled`,c.ABORTED)}function H(e,t){if(!Number.isInteger(e)||e<1)throw RangeError(`${t} must be a positive integer`);return e}export{k as runToolCalls,A as scheduleToolCalls};
3
3
  //# sourceMappingURL=schedule.js.map