@genesislcap/ai-assistant 15.21.0 → 15.22.0

package/dist/dts/components/orchestrating-driver/orchestrating-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrating-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/orchestrating-driver/orchestrating-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrating-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/orchestrating-driver/orchestrating-driver.ts"],"names":[],"mappings":"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"}

package/dist/dts/config/fallback-agents.d.ts

@@ -14,6 +14,13 @@ export declare const friendlyFallbackAgent: FallbackAgentConfig;
  * elaboration. The `{{agents}}` placeholder is replaced at runtime by
  * `OrchestratingDriver` with the generated specialist list.
  *
+ * The `{{unroutable}}` placeholder positions `UNROUTABLE_INSTRUCTION` — the framework's
+ * instruction for a substantive request no specialist covers, which is otherwise APPENDED to a
+ * string-form prompt. Positioned rather than appended for one reason: this preset's whole point is
+ * brevity, and appended text would be the last thing the model reads. Putting the block above the
+ * brevity rule leaves "a single short sentence" with the recency, so the two compose instead of
+ * competing. A prompt whose tone rules matter should do the same.
+ *
  * @beta
  */
 export declare const strictFallbackAgent: FallbackAgentConfig;

package/dist/dts/config/fallback-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallback-agents.d.ts","sourceRoot":"","sources":["../../../src/config/fallback-agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAInC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAIjC,CAAC"}
+{"version":3,"file":"fallback-agents.d.ts","sourceRoot":"","sources":["../../../src/config/fallback-agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAInC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAQjC,CAAC"}

package/dist/dts/state/debug-event-log.d.ts

@@ -28,7 +28,7 @@ import type { TurnFailureReason } from '@genesislcap/foundation-ai';
  * Catalogue of meta event names. This is the documented surface — extend it as
  * new events are wired in (Tier 2/3 lifecycle, interaction, provider events).
  */
-export type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'interaction.external-cost' | 'interaction.external-cost-dropped' | 'external-diagnostics.folded' | 'context.updated' | 'context.threshold-crossed' | 'context.compacted' | 'context.condensed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed' | 'session.cleared' | 'session.switched' | 'session.switch-deferred' | 'persistence.toggled' | 'persistence.saved' | 'persistence.save-failed' | 'persistence.suppressed' | 'persistence.not-resumable' | 'persistence.restored' | 'persistence.restore-orphan';
+export type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'routing.decided' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'interaction.external-cost' | 'interaction.external-cost-dropped' | 'external-diagnostics.folded' | 'context.updated' | 'context.threshold-crossed' | 'context.compacted' | 'context.condensed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed' | 'session.cleared' | 'session.switched' | 'session.switch-deferred' | 'persistence.toggled' | 'persistence.saved' | 'persistence.save-failed' | 'persistence.suppressed' | 'persistence.not-resumable' | 'persistence.restored' | 'persistence.restore-orphan';
 /**
  * How much a reader should care about an event — lets a consumer (or an AI
  * agent) filter the timeline: skip `low` UI/bookkeeping noise, skim `normal`

package/dist/dts/state/debug-event-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug-event-log.d.ts","sourceRoot":"","sources":["../../../src/state/debug-event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAErB,qBAAqB,GACrB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,GAEjB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAEhB,eAAe,GACf,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GAEjB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GAEnB,uBAAuB,GACvB,sBAAsB,GACtB,2BAA2B,GAC3B,mCAAmC,GAEnC,6BAA6B,GAE7B,iBAAiB,GACjB,2BAA2B,GAC3B,mBAAmB,GACnB,mBAAmB,GAEnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GAEpB,iBAAiB,GACjB,kBAAkB,GAClB,yBAAyB,GACzB,qBAAqB,GACrB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,GACxB,2BAA2B,GAC3B,sBAAsB,GACtB,4BAA4B,CAAC;AAEjC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAqD5E,CAAC;AAEF,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,mBAAmB,CAAC;IAChC,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAmBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAyBN;AAED;;;;;;;;GAQG;AACH,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CA0BrF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAmB7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
+{"version":3,"file":"debug-event-log.d.ts","sourceRoot":"","sources":["../../../src/state/debug-event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAErB,qBAAqB,GACrB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,GAEjB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAEhB,eAAe,GACf,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GAEjB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GAEnB,uBAAuB,GACvB,sBAAsB,GACtB,2BAA2B,GAC3B,mCAAmC,GAEnC,6BAA6B,GAE7B,iBAAiB,GACjB,2BAA2B,GAC3B,mBAAmB,GACnB,mBAAmB,GAEnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GAEpB,iBAAiB,GACjB,kBAAkB,GAClB,yBAAyB,GACzB,qBAAqB,GACrB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,GACxB,2BAA2B,GAC3B,sBAAsB,GACtB,4BAA4B,CAAC;AAEjC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAwD5E,CAAC;AAEF,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,mBAAmB,CAAC;IAChC,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAmBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAyBN;AAED;;;;;;;;GAQG;AACH,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAEN;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CA0BrF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAqB7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/dts/utils/context-tokens.d.ts

@@ -32,10 +32,32 @@ export declare const COMPACTION_SUMMARY_TOKEN_ESTIMATE = 1200;
  * `assistant(toolCalls)` and its results must not be mistaken for a safe split.
  *
  * Mirrors what the request-build chokepoint and the transports actually send:
- * `system-event` / `synthetic-user` are display-only rows, and the
+ * `system-event` / `synthetic-user` are display-only rows, the
  * reasoning/narration splits (GENC-1410, plus the legacy `thinking` flag they
- * superseded) are skipped when building the request. Counting any of them would
- * inflate every estimate against a prompt that never carries them.
+ * superseded) are skipped when building the request, and `excludeFromProvider`
+ * marks prose the driver wrote rather than the model (GENC-1573). Counting any
+ * of them would inflate every estimate against a prompt that never carries
+ * them.
+ *
+ * Keep this list aligned with the skip block in `toAnthropicMessages` /
+ * `toGeminiContents` — it exists to predict them.
+ *
+ * SCOPED TO WHAT CANONICAL HISTORY CARRIES, though, which is less than the wire
+ * decides. This runs against stored history, whereas `transformHistoryForAgent`
+ * is applied later and only at the request-build site — so neither of the things
+ * that transform does is visible here: the `excludeFromProvider` it stamps on
+ * another agent's `toolResult`, nor the foreign `tool_use` blocks it flattens to
+ * prose. In the session quoted in its docblock that is 389 `tool_use` + 313
+ * `tool_result` payloads still counted in full against a prompt that no longer
+ * carries them. So for `excludeFromProvider` this predicate is exact only for the
+ * driver-authored notices that carry the flag in stored history.
+ *
+ * The divergence predates the flag — masking already emptied `args` after
+ * estimation — and is left as is deliberately: the estimator over-counts, which
+ * errs towards compacting early rather than towards an over-limit request. Noted
+ * because the next person to trust this as an exact mirror will be debugging a
+ * multi-agent session that compacts sooner than they expect. Reviewer catch on
+ * #2496.
  */
 export declare function reachesProvider(m: ChatMessage): boolean;
 /**

package/dist/dts/utils/context-tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-tokens.d.ts","sourceRoot":"","sources":["../../../src/utils/context-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAexC;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAIvD;AAmGD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAE5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,EAAE,CAmC/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAO9E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAK7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,cAAc,EAAE,SAAS,WAAW,EAAE,GACrC,MAAM,CAaR;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,MAA0C,GACxD,oBAAoB,CAkBtB"}
+{"version":3,"file":"context-tokens.d.ts","sourceRoot":"","sources":["../../../src/utils/context-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAexC;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAKvD;AAmGD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAE5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,EAAE,CAmC/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAO9E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAK7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,cAAc,EAAE,SAAS,WAAW,EAAE,GACrC,MAAM,CAaR;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,MAA0C,GACxD,oBAAoB,CAkBtB"}

package/dist/dts/utils/history-transform.d.ts

@@ -1,9 +1,29 @@
 import type { ChatMessage } from '@genesislcap/foundation-ai';
 import { type CompactionProjection } from './context-tokens';
 /**
- * Prepares history for the LLM only: masks tool call args and results from other
- * agents so the active specialist is not confused by tools it does not have.
- * Canonical history in `ChatDriver` stays unmasked for UI and logging.
+ * Prepares history for the LLM only: another agent's tool traffic becomes prose, so the active
+ * specialist sees THAT work happened without being handed calls it cannot make or results it
+ * cannot use. Canonical history in `ChatDriver` stays untouched for UI and logging.
+ *
+ * Why prose rather than masked-in-place blocks (GENC-1573). Masking used to clear a foreign
+ * call's `args` and stub its result's content, but leave both as real `tool_use`/`tool_result`
+ * blocks on the wire. That put a large, wholly uninformative structure in front of every routed
+ * agent — in the measured session the fallback's requests carried 389 `tool_use` and 313
+ * `tool_result` blocks, every one of them another agent's, the args emptied to `{}` and the
+ * results reduced to the same placeholder sentence repeated 313 times. It cost tokens on every
+ * turn, told the model nothing, and asked a tool-less agent to make sense of a tool transcript.
+ *
+ * A foreign result is dropped rather than rendered: its content was already replaced by a
+ * placeholder, so the only thing left to say is "a result came back", which the call line
+ * already implies. It is dropped via `excludeFromProvider` rather than by filtering the array,
+ * so index-aligned callers and the token estimator see the same list they always did.
+ *
+ * Pairs are flattened together, keyed on tool-call id rather than per message, because a
+ * half-flattened pair is a rejected request: an orphaned `tool_result` has no `tool_use` to
+ * answer. Both halves of a pair normally carry the same `agentName` — `appendToHistory` stamps
+ * the active agent on the call and its result alike — but a session restored from before that
+ * stamping, or appended with no agent active, can hold one half unattributed, and per-message
+ * flattening would then split it.
  */
 export declare function transformHistoryForAgent(history: ChatMessage[], agentName: string): ChatMessage[];
 /**

package/dist/dts/utils/history-transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history-transform.d.ts","sourceRoot":"","sources":["../../../src/utils/history-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,KAAK,oBAAoB,EAI1B,MAAM,kBAAkB,CAAC;AA0B1B;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAKjG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAG3F;AAID;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CASvF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,eAAe,GAAE,MAAkC,GAClD,MAAM,GAAG,IAAI,CAkBf;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,GAAG,IAAI,CAS7B;AAkCD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,GAAG;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAYA;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAanF;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAG7D"}
+{"version":3,"file":"history-transform.d.ts","sourceRoot":"","sources":["../../../src/utils/history-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,KAAK,oBAAoB,EAI1B,MAAM,kBAAkB,CAAC;AAoC1B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAsBjG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAG3F;AAID;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CASvF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,eAAe,GAAE,MAAkC,GAClD,MAAM,GAAG,IAAI,CAkBf;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,GAAG,IAAI,CAS7B;AAkCD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,GAAG;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAYA;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAanF;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAG7D"}

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

@@ -92,6 +92,28 @@ const MAX_STALE_TOOL_CALLS = DEFAULT_MAX_UNKNOWN_TOOL_CALLS * 2;
 // ceiling, not a per-turn total.
 const MAX_MALFORMED_RETRIES = 5;
 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.
 const MAX_SETUP_TRANSPORT_RETRIES = 3;
@@ -520,7 +542,7 @@ export class ChatDriver extends EventTarget {
             spentUsd: e.spentUsd,
             isSubAgent: this.isSubAgent,
         });
-        this.appendToHistory({ role: 'assistant', content: this.budgetExhaustedBubble(e) });
+        this.appendDriverNotice(this.budgetExhaustedBubble(e));
         return this.turnDone('budget-exhausted', budgetDetailOf(e));
     }
     /**
@@ -558,7 +580,7 @@ export class ChatDriver extends EventTarget {
             upstreamType: e.upstreamType,
             isSubAgent: this.isSubAgent,
         });
-        this.appendToHistory({ role: 'assistant', content: this.providerRefusedBubble() });
+        this.appendDriverNotice(this.providerRefusedBubble());
         return this.turnDone('provider-refused', undefined, detail);
     }
     /** The typed failure reason on a loop result, or `undefined` for a clean turn / handoff. */
@@ -1216,12 +1238,12 @@ export class ChatDriver extends EventTarget {
             }
             catch (e) {
                 logger.warn(`ChatDriver: compaction summary failed: ${e instanceof Error ? e.message : e}`);
-                this.appendToHistory({ role: 'assistant', content: failMessage });
+                this.appendDriverNotice(failMessage);
                 return null;
             }
             if (!summaryText) {
                 logger.warn('ChatDriver: compaction summary was empty; leaving history untouched');
-                this.appendToHistory({ role: 'assistant', content: failMessage });
+                this.appendDriverNotice(failMessage);
                 return null;
             }
             let tokensBefore;
@@ -1630,10 +1652,7 @@ export class ChatDriver extends EventTarget {
                     name: e instanceof Error ? e.name : undefined,
                     message: e instanceof Error ? e.message : String(e),
                 });
-                this.appendToHistory({
-                    role: 'assistant',
-                    content: 'Sorry, something went wrong on my end. Please try again in a moment.',
-                });
+                this.appendDriverNotice('Sorry, something went wrong on my end. Please try again in a moment.');
                 result = this.turnDone('exception');
                 return result;
             }
@@ -2011,10 +2030,7 @@ export class ChatDriver extends EventTarget {
                     name: e instanceof Error ? e.name : undefined,
                     message: e instanceof Error ? e.message : String(e),
                 });
-                this.appendToHistory({
-                    role: 'assistant',
-                    content: 'Sorry, something went wrong on my end. Please try again in a moment.',
-                });
+                this.appendDriverNotice('Sorry, something went wrong on my end. Please try again in a moment.');
                 result = this.turnDone('exception');
                 return result;
             }
@@ -2254,7 +2270,7 @@ export class ChatDriver extends EventTarget {
                         this.failSubAgent('provider_refused', undefined, this.providerRefusedDetail);
                     }
                     else {
-                        this.appendToHistory({ role: 'assistant', content: this.providerRefusedBubble() });
+                        this.appendDriverNotice(this.providerRefusedBubble());
                     }
                     return this.turnDone('provider-refused', undefined, this.providerRefusedDetail);
                 }
@@ -2284,10 +2300,7 @@ export class ChatDriver extends EventTarget {
                         // arrived as a sub-agent's failure payload — `budgetWallDetail`, first
                         // attribution wins — and an unattributable child wall (detail
                         // undefined) composes the neutral default.
-                        this.appendToHistory({
-                            role: 'assistant',
-                            content: this.budgetExhaustedBubble(this.budgetWallDetail),
-                        });
+                        this.appendDriverNotice(this.budgetExhaustedBubble(this.budgetWallDetail));
                     }
                     // Carried onto the result so `loopEndDetail` publishes the refusing
                     // vendor rather than falling through to `lastResolvedProvider`, and the
@@ -2355,9 +2368,9 @@ export class ChatDriver extends EventTarget {
                 // byte-stable for every agent.
                 const foldSuffix = this.buildFoldSystemPromptSuffix();
                 const retryNudge = malformedAttempts > 0
-                    ? '\n\nIMPORTANT: Use only the structured function-call API to invoke tools. Do not write Python code or use Python-style syntax to call tools.'
+                    ? `\n\n${MALFORMED_CALL_NUDGE}`
                     : emptyResponseAttempts > 0
-                        ? "\n\nIMPORTANT: You must respond to the user's message. Call the appropriate tool or provide a text response — do not return an empty response."
+                        ? `\n\n${EMPTY_RESPONSE_NUDGE}`
                         : '';
                 const frameworkSystemSuffix = `${foldSuffix}${retryNudge}`;
                 // Normalize the primer at the same chokepoint as the driver's own history
@@ -2523,11 +2536,8 @@ export class ChatDriver extends EventTarget {
                         this.failSubAgent('context_exhausted');
                     }
                     else {
-                        this.appendToHistory({
-                            role: 'assistant',
-                            content: 'I had to stop here — this conversation has filled the available context. ' +
-                                'Compact it to free up room, then ask me to continue.',
-                        });
+                        this.appendDriverNotice('I had to stop here — this conversation has filled the available context. ' +
+                            'Compact it to free up room, then ask me to continue.');
                     }
                     return this.turnDone('context-exhausted');
                 }
@@ -2564,10 +2574,7 @@ export class ChatDriver extends EventTarget {
                             this.failSubAgent('malformed_tool_call');
                         }
                         else {
-                            this.appendToHistory({
-                                role: 'assistant',
-                                content: 'While working on your request, I repeatedly called my tools incorrectly. This often works on a second try — would you like me to try again? If it happens again, try breaking your request into smaller steps.',
-                            });
+                            this.appendDriverNotice('While working on your request, I repeatedly called my tools incorrectly. This often works on a second try — would you like me to try again? If it happens again, try breaking your request into smaller steps.');
                         }
                         return this.turnDone('malformed-function-call');
                     }
@@ -2593,10 +2600,7 @@ export class ChatDriver extends EventTarget {
                             this.failSubAgent('response_truncated');
                         }
                         else {
-                            this.appendToHistory({
-                                role: 'assistant',
-                                content: 'My response was cut off because a single step reached the model output limit. This usually means one step tried to produce too much at once — try breaking your request into smaller steps.',
-                            });
+                            this.appendDriverNotice('My response was cut off because a single step reached the model output limit. This usually means one step tried to produce too much at once — try breaking your request into smaller steps.');
                         }
                         return this.turnDone('response-truncated');
                     }
@@ -2642,10 +2646,7 @@ export class ChatDriver extends EventTarget {
                             this.failSubAgent('context_exhausted');
                         }
                         else {
-                            this.appendToHistory({
-                                role: 'assistant',
-                                content: DEFAULT_CONTEXT_OVERFLOW_MESSAGE,
-                            });
+                            this.appendDriverNotice(DEFAULT_CONTEXT_OVERFLOW_MESSAGE);
                         }
                         return this.turnDone('context-exhausted');
                     }
@@ -2721,10 +2722,7 @@ export class ChatDriver extends EventTarget {
                             this.failSubAgent('timeout');
                         }
                         else {
-                            this.appendToHistory({
-                                role: 'assistant',
-                                content: 'The request timed out. You can ask me to try again, or break this into a smaller step.',
-                            });
+                            this.appendDriverNotice('The request timed out. You can ask me to try again, or break this into a smaller step.');
                         }
                         // Recorded as `exception` above (there is no separate `timeout` member of
                         // TurnFailureReason for the main turn); surface the same reason here.
@@ -2800,7 +2798,12 @@ export class ChatDriver extends EventTarget {
                     emptyResponseAttempts += 1;
                     if (!isRefusal && emptyResponseAttempts < MAX_EMPTY_RESPONSE_RETRIES) {
                         logger.warn(`ChatDriver: empty model response, retrying (${emptyResponseAttempts}/${MAX_EMPTY_RESPONSE_RETRIES})`);
-                        recordTurnRetry(this.sessionKey, 'empty-response', Object.assign({ agent: this.activeAgentName, provider: this.lastResolvedProviderName, attempt: emptyResponseAttempts, maxAttempts: MAX_EMPTY_RESPONSE_RETRIES }, response.responseMeta));
+                        recordTurnRetry(this.sessionKey, 'empty-response', Object.assign({ agent: this.activeAgentName, provider: this.lastResolvedProviderName, attempt: emptyResponseAttempts, maxAttempts: MAX_EMPTY_RESPONSE_RETRIES, 
+                            // How many tools the agent was holding. Every empty response in the session that
+                            // motivated this (GENC-1573) came from an agent with ZERO — a tool-less agent asked
+                            // something its prompt gives it no instruction for has nothing it is allowed to do,
+                            // and reads as a model fault unless this number is on the record.
+                            toolCount: this.toolDefinitions.length }, response.responseMeta));
                         iterations -= 1;
                         continue;
                     }
@@ -2808,17 +2811,17 @@ export class ChatDriver extends EventTarget {
                     logger.error(isRefusal
                         ? 'ChatDriver: model refused the request (safety decline) — not retrying'
                         : 'ChatDriver: empty model response after all retries');
-                    recordTurnError(this.sessionKey, failureReason, Object.assign({ agent: this.activeAgentName, provider: this.lastResolvedProviderName, attempts: emptyResponseAttempts, isSubAgent: this.isSubAgent }, response.responseMeta));
+                    recordTurnError(this.sessionKey, failureReason, Object.assign({ agent: this.activeAgentName, provider: this.lastResolvedProviderName, attempts: emptyResponseAttempts, 
+                        // See the retry above: a zero here says the agent had no tools, which is most of the
+                        // explanation for a blank turn and is otherwise invisible.
+                        toolCount: this.toolDefinitions.length, isSubAgent: this.isSubAgent }, response.responseMeta));
                     if (this.isSubAgent) {
                         this.failSubAgent(isRefusal ? 'refusal' : 'empty_response');
                     }
                     else {
-                        this.appendToHistory({
-                            role: 'assistant',
-                            content: isRefusal
-                                ? 'This request was declined. Try rephrasing it, or breaking it into smaller steps.'
-                                : 'While working on your request, I repeatedly generated a blank response. This often works on a second try — would you like me to try again? If it happens again, try breaking your request into smaller steps.',
-                        });
+                        this.appendDriverNotice(isRefusal
+                            ? 'This request was declined. Try rephrasing it, or breaking it into smaller steps.'
+                            : 'While working on your request, I repeatedly generated a blank response. This often works on a second try — would you like me to try again? If it happens again, try breaking your request into smaller steps.');
                     }
                     return this.turnDone(failureReason);
                 }
@@ -3168,10 +3171,7 @@ export class ChatDriver extends EventTarget {
                         this.failSubAgent('unknown_tool_limit');
                     }
                     else {
-                        this.appendToHistory({
-                            role: 'assistant',
-                            content: "I'm sorry, I repeatedly tried to use tools that aren't available to me, so I couldn't complete that. If a 'Download agent log' option appears in the Settings (cog) menu, you can download the log and share it with whoever set up this assistant to help fix the issue.",
-                        });
+                        this.appendDriverNotice("I'm sorry, I repeatedly tried to use tools that aren't available to me, so I couldn't complete that. If a 'Download agent log' option appears in the Settings (cog) menu, you can download the log and share it with whoever set up this assistant to help fix the issue.");
                     }
                     return this.turnDone('unknown-tool-limit');
                 }
@@ -3202,16 +3202,32 @@ export class ChatDriver extends EventTarget {
                     this.failSubAgent('max_iterations');
                 }
                 else {
-                    this.appendToHistory({
-                        role: 'assistant',
-                        content: "I've reached my limit for this response. You can ask me to continue and I'll pick up where I left off.",
-                    });
+                    this.appendDriverNotice("I've reached my limit for this response. You can ask me to continue and I'll pick up where I left off.");
                 }
                 failureReason = 'max-iterations';
             }
             return this.turnDone(failureReason);
         });
     }
+    /**
+     * Append prose the DRIVER wrote rather than the model — a failure notice, a limit explanation,
+     * the budget wall. Renders as an ordinary assistant bubble and is flagged
+     * `excludeFromProvider`, so it never re-enters the next request.
+     *
+     * Every such notice must go through here. Written as one funnel rather than a flag repeated at
+     * eleven call sites because the failure mode is silent: a notice that keeps the flag reads
+     * identically in the transcript to one that loses it, and the damage only shows up a turn later
+     * as the model echoing its own error message. Measured (GENC-1573): with the empty-response
+     * notice in history, the next turn reproduced it verbatim in 45 output tokens — succeeding,
+     * with no retry and no `turn.error`, while still showing the user a failure. From there the
+     * loop sustains itself whether or not the model answers, which is why "try again" never worked.
+     *
+     * Not for anything the model produced, and not for a widget/interaction message: those are real
+     * turn content and the model must keep seeing them.
+     */
+    appendDriverNotice(content) {
+        this.appendToHistory({ role: 'assistant', content, excludeFromProvider: true });
+    }
     appendToHistory(message) {
         var _a;
         const tagged = Object.assign(Object.assign(Object.assign({}, message), { 

package/dist/esm/components/orchestrating-driver/index.js

@@ -1 +1 @@
-export { OrchestratingDriver } from './orchestrating-driver';
+export { OrchestratingDriver, UNROUTABLE_INSTRUCTION, UNROUTABLE_PLACEHOLDER, } from './orchestrating-driver';