@genesislcap/ai-assistant 15.24.2 → 15.26.0

package/dist/esm/components/chat-driver/chat-driver.constants.js

@@ -0,0 +1,72 @@
+/** Tuning constants for the tool loop — caps, retry ceilings, and the two retry nudges. */
+export const DEFAULT_MAX_TOOL_ITERATIONS = 50;
+export const DEFAULT_MAX_FOLD_OPERATIONS = 5;
+// TODO: dedup system prompts in-memory to allow raising this cap much higher.
+// Each TurnSnapshot stores the full resolved `systemPrompt`, so the buffer's
+// memory cost scales with cap × prompt size — a stable agent repeats a multi-KB
+// prompt every turn. `getDebugLog` already dedups identical consecutive prompts
+// at export time (`<repeated — identical to turn N>`); applying the same dedup
+// at capture time (store the prompt only when it changes, back-reference
+// otherwise) would make snapshots nearly as cheap as meta events and let this
+// cap reach thousands for full-session capture without the memory blowup.
+export const DEFAULT_MAX_TURN_SNAPSHOTS = 400;
+export const DEFAULT_MAX_UNKNOWN_TOOL_CALLS = 5;
+// Stale tools (advertised in an earlier state, retired now) and fold-hidden tools are
+// self-correcting — the model drops them once guided — so they get a higher loop-protection
+// ceiling than hallucinated names: a few legitimate stale calls across state transitions must
+// not prematurely end the turn. Still bounded so a genuinely stuck loop terminates.
+export const MAX_STALE_TOOL_CALLS = DEFAULT_MAX_UNKNOWN_TOOL_CALLS * 2;
+// Gemini in particular emits short bursts of MALFORMED_FUNCTION_CALL; allow more CONSECUTIVE
+// retries. These counters reset on any productive response, so this is a consecutive-failure
+// ceiling, not a per-turn total.
+export const MAX_MALFORMED_RETRIES = 5;
+export const MAX_EMPTY_RESPONSE_RETRIES = 3;
+/**
+ * Framed-tail nudge added to a retry after a MALFORMED tool call.
+ *
+ * Exported so tests can assert placement (framed tail, never the system prompt) without pinning
+ * the wording — the copy is a prompt, and a prompt should be free to improve.
+ *
+ * @beta
+ */
+export const MALFORMED_CALL_NUDGE = 'IMPORTANT: Use only the structured function-call API to invoke tools. Do not write Python code or use Python-style syntax to call tools.';
+/**
+ * Framed-tail nudge added to a retry after an EMPTY response.
+ *
+ * Rewritten in GENC-1573. The previous copy ("You must respond to the user's message. Call the
+ * appropriate tool or provide a text response") told a model that had just returned nothing to
+ * respond, without naming the one exit available to an agent that genuinely cannot act: saying so.
+ * Across nine failures in the measured session it changed nothing — all 29 attempts came back at
+ * 8–9 output tokens — and most of those were on a tool-less agent, for which "call the appropriate
+ * tool" is not an option at all. This version names the honest answer explicitly.
+ *
+ * @beta
+ */
+export const EMPTY_RESPONSE_NUDGE = "IMPORTANT: Your previous attempt returned nothing at all, which is never a valid response. Answer the user's last message now, in prose — even if all you can honestly say is that you cannot help with it and why. If a tool is the right way to answer, call it. Do not return an empty response.";
+// Transient throws while building the per-turn tool surface or calling the provider retry the
+// SAME iteration up to this many times before propagating, rather than tearing down the turn.
+export const MAX_SETUP_TRANSPORT_RETRIES = 3;
+/**
+ * Sub-agent meta events worth folding into the parent's debug timeline: the
+ * per-attempt and per-failure signals that do NOT otherwise surface in the
+ * sub-agent's (now hoisted) messages — a retried-away malformed/empty attempt
+ * produces no message, and the stale-vs-hallucinated/streak diagnostics live only
+ * on the event. High-volume, message-derivable events (turn.start/turn.end,
+ * provider.selected, context.updated) are intentionally excluded: read the
+ * sub-agent's hoisted messages for model/tokens/cost and turn-by-turn activity.
+ * See `ChatDriver.invokeSubAgent`.
+ */
+export const HARVESTED_SUBAGENT_EVENTS = new Set([
+    'turn.retry',
+    'turn.error',
+    'tool.failed',
+    'tool.unresolved',
+]);
+/**
+ * Name reserved for the cross-agent handoff tool — injected by OrchestratingDriver.
+ *
+ * @beta
+ */
+export const REQUEST_CONTINUATION_TOOL = 'request_continuation';
+/** Paired in history for each `request_continuation` so tool_calls stay balanced for the provider. */
+export const HANDOFF_TOOL_RESULT_PLACEHOLDER = 'Handoff to another specialist — routing continues on the next turn.';