@genesislcap/ai-assistant 15.61.0 → 15.63.0

package/dist/dts/types/interaction-interceptor.d.ts

@@ -1,4 +1,5 @@
 import type { InteractionContext } from './interaction-context';
+import type { InvokeResult } from './interaction-surface';
 /**
  * The handle an interceptor uses to move a pending interaction between the person and itself
  * (GENC-1660): to the person when it hands back or is paused, back to itself when resumed.
@@ -37,14 +38,36 @@ export interface InteractionHold {
      * `heldBy`. Returns `false`, settling nothing, unless this interceptor holds it right now.
      */
     resolve(result: unknown): boolean;
+    /**
+     * Run one of the surface's actions as the claimant (GENC-1660): an option by its id, `select`
+     * with `{ options }`, or `reply` with `{ text }`. It runs the same code the widget's own button
+     * runs, and records the decision for the asking tool — the choice as the person would read it,
+     * and `note`, verbatim, as what they were shown about it — so `recordDecision` is not needed.
+     *
+     * A finishing action settles the interaction AS the claimant, as {@link InteractionHold.resolve}
+     * does, so it is stamped `answeredBy` the claimant.
+     *
+     * Refused, with nothing run, unless this interceptor holds the interaction right now, the
+     * surface has that action, it is enabled and `args` fit it. One action runs at a time: a call
+     * made while an earlier one on the same interaction is still running is refused as `'busy'`, to
+     * be tried again once that one has returned. A refusal lists what is enabled, so the caller can
+     * correct itself. `finished` says whether the interaction settled.
+     *
+     * Handing the interaction to the person (`set('user')`) while a finishing action is still
+     * running does not take that action's credit away: if it settles the interaction, the answer is
+     * the claimant's. If it does not, the interaction is the person's like any other.
+     */
+    invoke(action: string, args?: unknown, options?: {
+        note?: string;
+    }): Promise<InvokeResult>;
 }
 /**
  * What the working agent is told about an interaction an interceptor answered (GENC-1660): added
  * to the result of the tool call that requested it, as `decidedOnUsersBehalf` on an object result
  * or as a line appended to a text one.
  *
- * Built only from what the platform already holds — the claimant's framing, and the choice and
- * narration it recorded — so the text the person saw and the text the agent is told about are the
+ * Built only from what the platform already holds — the claimant's framing, and the choice,
+ * narration and edits it recorded — so the text the person saw and the text the agent is told about are the
  * same string. It never names the claimant, so the agent has nothing to repeat about one.
  *
  * @beta
@@ -56,6 +79,33 @@ export interface DelegatedDecision {
     readonly choice?: string;
     /** What the person was shown about it, verbatim, as the assistant's own words. */
     readonly shownToUser?: string;
+    /**
+     * What the claimant changed in the widget before it decided, in order, each as the claimant
+     * reported it (`InteractionEdit.choice`): present only when it made edits. Lets the agent know
+     * the interaction was altered, not just answered.
+     */
+    readonly edits?: readonly string[];
+}
+/**
+ * What the working agent is told when the PERSON settled an interaction an interceptor had already
+ * changed (GENC-1660): added to the result of the tool call that requested it, as
+ * `editedOnUsersBehalf` on an object result or as a line appended to a text one. The edits were
+ * made on the user's behalf before they answered; the user then confirmed them by finishing it, so
+ * the answer itself is theirs and is not a {@link DelegatedDecision}.
+ *
+ * Built, like a decision, only from what the platform holds — the claimant's framing and the edits
+ * it reported — and never names the claimant.
+ *
+ * @beta
+ */
+export interface DelegatedEdits {
+    /**
+     * The claimant's {@link InteractionInterceptor.editFraming}, e.g. "Changed on the user's behalf
+     * before they answered; the user then finished it, confirming the changes".
+     */
+    readonly framing: string;
+    /** What the claimant changed, in order, each as it reported it (`InteractionEdit.choice`). */
+    readonly edits: readonly string[];
 }
 /**
  * A new interaction, as offered to each installed interceptor (GENC-1660).
@@ -103,6 +153,14 @@ export interface InteractionInterceptor {
      * would say "Decided on the user's behalf, from their brief".
      */
     readonly decisionFraming?: string;
+    /**
+     * How {@link DelegatedEdits} open, as the working agent reads them: the person finished an
+     * interaction this interceptor had changed first. Must say the changes were made on the user's
+     * behalf before they answered, and that finishing it confirmed them; must not name the
+     * interceptor. Defaults to "Changed on the user's behalf before the user answered; the user then
+     * finished it, confirming the changes".
+     */
+    readonly editFraming?: string;
     /** Return `'claim'` to hold the interaction, or nothing to leave it with the person. */
     onInteractionOpened(opened: InteractionOpened): 'claim' | undefined | void;
 }

package/dist/dts/types/interaction-interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction-interceptor.d.ts","sourceRoot":"","sources":["../../../src/types/interaction-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAQ,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,wFAAwF;IACxF,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;CAC5E"}
+{"version":3,"file":"interaction-interceptor.d.ts","sourceRoot":"","sources":["../../../src/types/interaction-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAQ,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAClC;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5F;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wFAAwF;IACxF,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;CAC5E"}

package/dist/dts/types/interaction-surface.d.ts

@@ -0,0 +1,195 @@
+/**
+ * One option of a short-form decision (GENC-1660). A bare string is an option whose id and label are
+ * the same text.
+ *
+ * @beta
+ */
+export type DecisionOption = string | {
+    /**
+     * The stable name of the option's action — what a view passes to `ctx.claimantOwns` to hide
+     * its button. Defaults to `label`.
+     */
+    readonly id?: string;
+    /** The option's text, as the person sees it. */
+    readonly label: string;
+    /**
+     * Whether it can be chosen right now — the button's own guard (e.g. `validated` for a
+     * Continue). Read fresh every time. A disabled option is listed as unavailable and refused.
+     */
+    readonly enabledWhen?: () => boolean;
+};
+/**
+ * What was decided, as handed to a short-form decision's `choose` (GENC-1660).
+ *
+ * @beta
+ */
+export type DecisionAnswer = 
+/** One option, by id. */
+{
+    readonly kind: 'option';
+    readonly option: string;
+}
+/** Several options, by id (a multi-select). */
+ | {
+    readonly kind: 'options';
+    readonly options: readonly string[];
+}
+/** A written answer (`freeText`). */
+ | {
+    readonly kind: 'text';
+    readonly text: string;
+};
+/**
+ * A short-form decision: the surface most widgets need (GENC-1660). Its actions are its options,
+ * all finishing, plus `select` for a multi-select and `reply` for a written answer.
+ *
+ * @beta
+ */
+export interface DecisionSpec {
+    readonly options: readonly DecisionOption[];
+    /** Adds a `select({ options })` action that picks several. */
+    readonly multi?: boolean;
+    /** Adds a `reply({ text })` action: an answer in the chooser's own words. */
+    readonly freeText?: boolean;
+    /**
+     * What a decision needs that the person sees on screen in some other form — e.g.
+     * `{ validated: true }`. A getter, so it is read fresh whenever the decision is described.
+     */
+    readonly facts?: () => Readonly<Record<string, unknown>>;
+    /**
+     * Model-only guidance the person would not see. The decision's own text comes from the
+     * widget's `asText`, which is what the person saw.
+     */
+    readonly prompt?: string;
+    /**
+     * Act on the answer. The SAME method the view's buttons call, so a claimant's answer runs the
+     * code a click runs. Must resolve the interaction (through `ctx.resolve`), now or once its work
+     * is done.
+     */
+    choose(answer: DecisionAnswer): void | Promise<void>;
+}
+/**
+ * One action on a surface, as anyone may read it (GENC-1660).
+ *
+ * @beta
+ */
+export interface SurfaceAction {
+    /** The name to invoke it by: an option's id, or `select` / `reply`. */
+    readonly name: string;
+    /** The text the person sees for it, where it has one. */
+    readonly label?: string;
+    /** Whether running it settles the interaction. Every short-form action does. */
+    readonly finishes: boolean;
+    /** Whether it can be run right now. */
+    readonly enabled: boolean;
+    /**
+     * What its `args` must look like, where it takes any: `options` (a multi-select's picks), `text`
+     * (a written answer) or `fields` (an object, described by `argsSchema`).
+     */
+    readonly args?: 'options' | 'text' | 'fields';
+    /** A full-form action's own description, for the model. Short-form options have none. */
+    readonly description?: string;
+    /** For `fields`: the JSON schema its arguments are checked against. */
+    readonly argsSchema?: Readonly<Record<string, unknown>>;
+}
+/**
+ * One action of a full-form surface (GENC-1660 §4.2): a named thing a claimant can do, which may or
+ * may not settle the interaction.
+ *
+ * @beta
+ */
+export interface SurfaceActionSpec {
+    /** For the model: what it does, and when to use it. */
+    readonly description: string;
+    /** Whether it settles the interaction. An editing action (`edit_rows`) does not. */
+    readonly finishes?: boolean;
+    /** The button's own guard, read fresh: the claimant can never do what the view would refuse. */
+    readonly enabledWhen?: () => boolean;
+    /**
+     * The JSON schema of its arguments, an object. Its `properties` and `required` are checked before
+     * it runs; a mismatch is refused with the reason, so the model can correct itself.
+     */
+    readonly argsSchema?: Readonly<Record<string, unknown>>;
+    /**
+     * Do it — the SAME code the view's control runs. A finishing action resolves the interaction; an
+     * editing one returns what changed (fresh errors, say), which the claimant is shown.
+     *
+     * A finishing action should settle promptly. While one runs asynchronously, the claimant can run
+     * nothing else, and it keeps the claimant's credit even if the interaction is handed to the person
+     * meanwhile, so the view should block its own controls until it ends: a click that lands then
+     * would be credited to the claimant.
+     */
+    run(args: unknown): unknown | Promise<unknown>;
+}
+/**
+ * A full-form surface, for a rich widget (GENC-1660 §4.2): something to describe, views to read,
+ * and named actions, some of which only edit.
+ *
+ * Its actions run one at a time. An asynchronous finishing action should settle promptly, and the
+ * view should block its own controls while one runs (see {@link SurfaceActionSpec.run}).
+ *
+ * @beta
+ */
+export interface SurfaceSpec {
+    /** For the model: what this is, and what good looks like. Read fresh. */
+    describe(): string;
+    /** The names of the views `read` answers, e.g. `['summary', 'rows', 'errors']`. */
+    readonly views?: readonly string[];
+    /**
+     * The widget's state as JSON, by view, so a large widget is read a slice at a time. Called with
+     * no view for the default (shown with the decision, so pick something small).
+     */
+    read(view?: string): unknown;
+    readonly actions: Readonly<Record<string, SurfaceActionSpec>>;
+    /** Model-only guidance, beside `describe`. */
+    readonly prompt?: string;
+}
+/**
+ * What can be read from an interaction's surface (GENC-1660): its actions as they stand now, and
+ * its facts. Present once the controller has exposed one.
+ *
+ * @beta
+ */
+export interface InteractionSurface {
+    /** Model-only guidance, from the decision's `prompt`. */
+    readonly prompt?: string;
+    /** Read fresh on every call. */
+    facts(): Readonly<Record<string, unknown>>;
+    /** A full-form surface's description. Absent on a short-form decision. */
+    describe?(): string;
+    /** A full-form surface's views. */
+    readonly views?: readonly string[];
+    /** Read one view of a full-form surface; absent on a short-form decision. */
+    read?(view?: string): unknown;
+    /** Read fresh on every call: `enabled` reflects each option's guard right now. */
+    actions(): readonly SurfaceAction[];
+    /**
+     * Whether a claimant could act on it now. A short-form decision is ready once one of its options
+     * is enabled; a full-form surface once any of its actions is, since editing comes before
+     * finishing (its Save may be disabled until something is edited).
+     */
+    isReady(): boolean;
+}
+/**
+ * What came of an `InteractionHold.invoke` (GENC-1660). On success, `finished` says whether the
+ * interaction settled and `actions` is what is enabled now; on failure, `error` says why and nothing
+ * ran.
+ *
+ * @beta
+ */
+export type InvokeResult = {
+    readonly ok: true;
+    readonly finished: boolean;
+    readonly actions: readonly SurfaceAction[];
+    /** What an editing action returned (fresh errors, say), for the claimant. */
+    readonly output?: unknown;
+    readonly error?: never;
+    readonly message?: never;
+} | {
+    readonly ok: false;
+    readonly finished?: never;
+    readonly error: 'not-held' | 'no-surface' | 'unknown-action' | 'disabled' | 'invalid-args' | 'threw' | 'busy';
+    readonly message: string;
+    readonly actions?: readonly SurfaceAction[];
+};
+//# sourceMappingURL=interaction-surface.d.ts.map

package/dist/dts/types/interaction-surface.d.ts.map

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

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

@@ -230,6 +230,12 @@ export interface CompactionProjection {
  *
  * The system preamble is carried across unchanged: compaction removes messages,
  * never the system prompt or the tool definitions.
+ *
+ * Besides the summary allowance, the summary carries the covered range's own user
+ * messages word for word (GENC-1660, C2), so those are priced too: a range that
+ * is mostly the user's own pastes reclaims far less than its size suggests. An
+ * earlier summary's kept messages are not carried forward (they fold into the new
+ * paraphrase), so they are reclaimed with the rest of the range.
  */
 export declare function projectCompaction(history: readonly ChatMessage[], cut: number, summaryTokens?: number, preambleTokens?: number): CompactionProjection;
 //# sourceMappingURL=context-tokens.d.ts.map

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;AA6CxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAiBT;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAKvD;AA6SD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAE5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,EAAE,CAEV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAER;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAE7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,cAAc,EAAE,SAAS,WAAW,EAAE,EACtC,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAKR;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,EACzD,cAAc,CAAC,EAAE,MAAM,GACtB,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;AAG9D;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AA6CxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAiBT;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAKvD;AAmTD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAE5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,EAAE,CAEV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAER;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAE7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,cAAc,EAAE,SAAS,WAAW,EAAE,EACtC,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAKR;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;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,MAA0C,EACzD,cAAc,CAAC,EAAE,MAAM,GACtB,oBAAoB,CAsBtB"}

package/dist/dts/utils/delegated-message.d.ts

@@ -39,7 +39,20 @@ export interface SendMessageOptions {
      * {@link DEFAULT_DELEGATE_FRAMING}. Ignored unless `delegate` is set.
      */
     delegateFraming?: string;
+    /**
+     * What producing the message cost outside the working agent's own model calls — e.g. the model
+     * calls the decorator made to write it — booked on the stored message as `externalCostUsd`, so it
+     * reaches the session total. Ignored unless `delegate` is set and it is a positive, finite number.
+     */
+    externalCostUsd?: number;
 }
+/**
+ * The fields a delegated `user` message is stored with, from the options it was sent with: who sent
+ * it, the framing the model reads, and what writing it cost. Empty for the person's own message.
+ *
+ * @internal
+ */
+export declare function delegatedFields(options: SendMessageOptions | undefined): Pick<ChatMessage, 'delegate' | 'delegateFraming' | 'externalCostUsd'>;
 /**
  * A delegated `user` message's content as the model reads it: its framing in brackets, then the
  * text. The one place this string is built, so the first model call (which takes the message as

package/dist/dts/utils/delegated-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegated-message.d.ts","sourceRoot":"","sources":["../../../src/utils/delegated-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,WAAW,KAAG,OAAO,IAAI,gBAC1C,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE1F"}
+{"version":3,"file":"delegated-message.d.ts","sourceRoot":"","sources":["../../../src/utils/delegated-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,WAAW,KAAG,OAAO,IAAI,gBAC1C,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,iBAAiB,GAAG,iBAAiB,CAAC,CAUvE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE1F"}

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,EAEL,KAAK,oBAAoB,EAI1B,MAAM,kBAAkB,CAAC;AAqC1B;;;;;;;;;;;;;;;;;;;;;;;;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,EACnD,cAAc,CAAC,EAAE,MAAM,GACtB,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;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,GAAG,IAAI,CAc7B;AAqCD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,GAAG;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAkBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAkBnF;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,EAEL,KAAK,oBAAoB,EAI1B,MAAM,kBAAkB,CAAC;AAsC1B;;;;;;;;;;;;;;;;;;;;;;;;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,EACnD,cAAc,CAAC,EAAE,MAAM,GACtB,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;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,GAAG,IAAI,CAc7B;AA4CD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,GAAG;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAkBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAuBnF;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAG7D"}

package/dist/dts/utils/preserved-user-messages.d.ts

@@ -0,0 +1,21 @@
+import type { ChatMessage } from '@genesislcap/foundation-ai';
+/** One user message a compaction keeps word for word. */
+export type PreservedUserMessage = NonNullable<NonNullable<ChatMessage['compaction']>['preservedUserMessages']>[number];
+/**
+ * The user messages a compaction of `toCompact` keeps word for word (GENC-1660, critique C2): the
+ * range's own, oldest first, delegated ones still marked as such.
+ *
+ * Only the range's own. An earlier summary in the range is not carried forward: the summariser
+ * reads it with its own kept messages, and folds them into the new paraphrase. So the kept block
+ * never grows past one compaction's worth, at the cost of steering from before the previous
+ * compaction surviving only as paraphrase.
+ */
+export declare function freshUserMessages(toCompact: readonly ChatMessage[]): PreservedUserMessage[];
+/** One kept message as the model reads it: as the user, framed when it was sent on their behalf. */
+export declare const preservedUserLine: (u: PreservedUserMessage) => string;
+/**
+ * The kept user messages as the block that follows a summary on the wire, or `''` when there are
+ * none. The one place it is built, so what is sent and what the context estimate counts agree.
+ */
+export declare function verbatimUserMessagesBlock(preserved: readonly PreservedUserMessage[] | undefined): string;
+//# sourceMappingURL=preserved-user-messages.d.ts.map

package/dist/dts/utils/preserved-user-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preserved-user-messages.d.ts","sourceRoot":"","sources":["../../../src/utils/preserved-user-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAC5C,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAChE,CAAC,MAAM,CAAC,CAAC;AAEV;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,GAAG,oBAAoB,EAAE,CAY3F;AAED,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,GAAI,GAAG,oBAAoB,KAAG,MAC6B,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,oBAAoB,EAAE,GAAG,SAAS,GACrD,MAAM,CAGR"}