@genesislcap/ai-assistant 15.61.0 → 15.63.0

package/dist/dts/config/config.d.ts

@@ -580,6 +580,189 @@ interface BaseAgentConfig {
      * @beta
      */
     contextReserve?: ContextReserveInput;
+    /**
+     * The autopilot that may answer this agent's interactions on the user's behalf (GENC-1660). Set by
+     * `defineStatefulAgent`'s `autopilot` option, which binds the config to the agent's live state;
+     * consumed by `AutopilotDriver`. Never routed to or pinned: it is not an agent in the array.
+     *
+     * @beta
+     */
+    autopilot?: AutopilotBinding;
+}
+/**
+ * Whether an autopilot may answer a widget (GENC-1660). `'human-first'` hands it straight to the
+ * person; `'allowed'` lets the autopilot decide. Anything unlisted is `'human-first'`.
+ *
+ * @beta
+ */
+export type AutopilotWidgetPolicy = 'human-first' | 'allowed';
+/**
+ * The words the autopilot UI shows (GENC-1660). Supplied by the autopilot's config, because the
+ * host is platform code and must not carry any one app's wording; every field has a default.
+ *
+ * @beta
+ */
+export interface AutopilotCopy {
+    /** The slim bar's status while running, e.g. "Building from your plan…". */
+    running: string;
+    /** While paused by the user. */
+    paused: string;
+    /** While the autopilot waits on one answer it handed back. */
+    selfPaused: string;
+    /** In front of a hand-back reason, in the widget's banner, e.g. "I need your input on this one:". */
+    handBackLead: string;
+    /** The toggle pill's label and its accessible name, e.g. "Autopilot". */
+    toggleLabel: string;
+    /**
+     * What the autopilot does, in a sentence: in the toggle's tooltip, after what clicking does.
+     * The place to name what it decides from, e.g. "…from your plan".
+     */
+    description: string;
+    /**
+     * What clicking the toggle does while it is on, at the head of its tooltip, e.g. "Pause
+     * autopilot"; also the turn-level hand-back's pause button. The toggle's accessible name is
+     * always `toggleLabel`: it is a pressed/not-pressed toggle, so its name does not change with it.
+     */
+    pauseLabel: string;
+    /** What clicking the toggle does while it is off, at the head of its tooltip, e.g. "Resume autopilot". */
+    resumeLabel: string;
+    /**
+     * What clicking the toggle does while the autopilot waits on a question it handed back, at the
+     * head of its tooltip, e.g. "Resume autopilot and force it to decide this one": resuming forces it
+     * to take the question back and decide it, with no way to hand it back again, so say so.
+     */
+    resumeDecideLabel: string;
+    /** The hand-back banner's button that keeps the autopilot paused after the answer. */
+    keepPausedLabel: string;
+    /** The tooltip on the autopilot mark, beside anything done in autopilot mode. */
+    markLabel: string;
+    /**
+     * The turn-level hand-back's message when the working agent stopped at its call limit, e.g. "I've
+     * done a lot in one go, so I've stopped to check in. Shall I carry on?".
+     */
+    checkInMessage: string;
+    /** The turn-level hand-back's button that carries the working agent on, e.g. "Carry on". */
+    carryOnLabel: string;
+    /** The turn-level hand-back's message when the conversation has grown too long to carry on. */
+    tooLongMessage: string;
+    /** The turn-level hand-back's button that compacts the conversation, then carries on. */
+    compactLabel: string;
+    /** The turn-level hand-back's message when the working agent's turn failed. */
+    failedMessage: string;
+    /** The turn-level hand-back's button that runs the failed step again, e.g. "Try again". */
+    tryAgainLabel: string;
+    /** The turn-level hand-back's button that sends the person's own written answer, e.g. "Send". */
+    sendLabel: string;
+    /** The hand-back reason when a decision passed its spend cap (`maxDecisionCostUsd`). */
+    budgetReason: string;
+    /** The hand-back reason when a decision failed with an error. */
+    errorReason: string;
+    /** The hand-back reason when a decision ended without acting or handing back. */
+    noDecisionReason: string;
+    /** The hand-back reason when the watchdog found the autopilot's work gone quiet (`watchdogMs`). */
+    watchdogReason: string;
+}
+/**
+ * An autopilot definition, generic over the state `S` of the agent it serves (GENC-1660). An
+ * ordinary agent definition run the other way round: it is sent each decision the agent asks of
+ * the user, and answers it, or hands it back.
+ *
+ * `S` appears only as a resolver parameter, so a definition whose resolvers take `unknown` (a
+ * shared const) is assignable to every agent's `AutopilotConfig<S>`. Keep no mutable state in a
+ * shared definition or its closures: one is used by every agent that references it.
+ *
+ * @beta
+ */
+export interface AutopilotConfig<S = unknown> {
+    /**
+     * Whether the autopilot can be switched on right now, given the agent's live state — e.g. "the
+     * brief is approved", for an autopilot grounded in a brief. Default: whenever the agent's flow is
+     * active.
+     */
+    availableWhen?: (ctx: {
+        state: S;
+    }) => boolean;
+    /** Per widget component name; unlisted widgets are `'human-first'`. */
+    widgetPolicy?: Readonly<Record<string, AutopilotWidgetPolicy>>;
+    /** The autopilot's grounding. Keep it byte-stable for the run, so its cache prefix holds. */
+    systemPrompt: string | ((ctx: SystemPromptContext & {
+        state: S;
+    }) => string | Promise<string>);
+    /** What is true now (step guidance, a project snapshot). Rebuilt every call, never stored. */
+    tailContext?: string | ((ctx: SystemPromptContext & {
+        state: S;
+    }) => string | Promise<string>);
+    /** Which registered provider it uses. Defaults to the registry default. */
+    provider?: string | ((ctx: SystemPromptContext & {
+        state: S;
+    }) => string | Promise<string>);
+    /** Read-only tools it may use to check a fact, beside the three the platform adds. */
+    tools?: {
+        definitions: ChatToolDefinition[];
+        handlers: ChatToolHandlers;
+    };
+    /**
+     * How the working agent is told a decision was made for the user, e.g. "Decided on the user's
+     * behalf, from their brief". Must not name the autopilot.
+     */
+    decisionFraming?: string;
+    /**
+     * How the working agent is told that the user finished a widget the autopilot had already
+     * changed, e.g. "Changed on the user's behalf from their brief, before the user answered; the user
+     * then finished it, confirming the changes". Must say the changes came first and that finishing
+     * confirmed them; must not name the autopilot. Defaults to the platform's wording.
+     */
+    editFraming?: string;
+    /** Overrides for the UI's words. */
+    copy?: Partial<AutopilotCopy>;
+    /** Model calls per decision before it is handed back; `> 0`, or the default is used. Default 6. */
+    maxIterationsPerDecision?: number;
+    /**
+     * Written answers (`reply`) allowed per step before `reply` is withdrawn, so refining a proposal
+     * cannot loop with the working agent re-proposing it. `>= 0` (0 never offers one), or the
+     * default is used. Default 2. Enforced by the platform, not asked of the model: past the limit it
+     * can only accept or hand back.
+     */
+    maxRefinements?: number;
+    /**
+     * What counts as one step for {@link AutopilotConfig.maxRefinements}, e.g. the machine's phase
+     * and substate. The count resets when it changes. Default: the widget's component name, which is
+     * coarser but never unsafe.
+     */
+    stepKey?: (ctx: {
+        state: S;
+    }) => string;
+    /**
+     * What one decision may cost, in USD, before it is handed back; `> 0`. Unset (or not `> 0`): no
+     * cap (the session's budget wall still stops everything). Set it from measured decision costs,
+     * e.g. 3x the p95.
+     */
+    maxDecisionCostUsd?: number;
+    /**
+     * How long the autopilot's work on a claimed interaction may go quiet before it is handed back,
+     * in ms; `> 0`, or the default is used. Quiet means either no ready surface and no heartbeat
+     * (`ctx.notify()`), or a decision of its own still running with no model call landing and no
+     * heartbeat — a stalled model call, which has no timeout of its own. A decision handed back this
+     * way is stopped. Must outlast the slowest honest wait, such as a compile. Default 10 minutes.
+     */
+    watchdogMs?: number;
+    /**
+     * How large the autopilot's own history may grow, in characters, before it is rebuilt from a
+     * short-form digest of what the person saw (recent entries verbatim, older answered widgets as
+     * one line, and only the newest entries that fit in half of this). `> 0`, or the default is used.
+     * A safety net, not expected to fire on an ordinary run. Default 120,000 (roughly 30k tokens).
+     */
+    historyBudgetChars?: number;
+}
+/**
+ * An {@link AutopilotConfig} bound to its agent's live state — what `AgentConfig.autopilot` holds
+ * (GENC-1660). `state()` is `undefined` while the agent is not active.
+ *
+ * @beta
+ */
+export interface AutopilotBinding {
+    readonly config: AutopilotConfig<unknown>;
+    state(): unknown;
 }
 /**
  * Configuration for a specialist agent.

package/dist/dts/config/config.d.ts.map

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

package/dist/dts/config/define-stateful-agent.d.ts

@@ -1,5 +1,5 @@
 import type { CachePolicy, ChatMessage, ChatThinkingPolicy, ChatToolChoice, ChatToolDefinition, ChatToolHandlers } from '@genesislcap/foundation-ai';
-import type { AgentConfig, AgentLifecycleContext, AgentPersistenceContext, ChatInputDuringExecutionMode, ContextReserveInput, ManualSelectionConfig, SystemPromptContext, UnresolvedToolContext } from './config';
+import type { AgentConfig, AgentLifecycleContext, AutopilotConfig, AgentPersistenceContext, ChatInputDuringExecutionMode, ContextReserveInput, ManualSelectionConfig, SystemPromptContext, UnresolvedToolContext } from './config';
 /**
  * Context passed to per-turn resolvers on a stateful agent — the standard
  * {@link SystemPromptContext} plus the live `state` value. Used by
@@ -114,6 +114,15 @@ export interface StatefulAgentInit<S> {
      * reached.
      */
     toolHandlers?: (state: S) => ChatToolHandlers | Promise<ChatToolHandlers>;
+    /**
+     * The autopilot that may answer this agent's interactions on the user's behalf (GENC-1660). Its
+     * resolvers receive this agent's live state, typed. Build it with {@link defineAutopilot}; a
+     * shared definition (a const or a factory) works for any agent.
+     *
+     * Only stateful agents take one: an autopilot is scoped to a flow, and only a stateful agent
+     * owns one.
+     */
+    autopilot?: AutopilotConfig<S>;
     /**
      * Which registered AI provider this agent uses, by name. Either a static
      * string or a function resolved each tool-loop iteration with the current
@@ -293,4 +302,25 @@ export declare function restoreMachine(machine: {
  * @beta
  */
 export declare function defineStatefulAgent<S>(opts: StatefulAgentInit<S>): AgentConfig;
+/**
+ * Define an autopilot for a stateful agent whose state is `S` (GENC-1660). An identity function
+ * that exists for its type: the resolvers get `S`, and the result goes on `defineStatefulAgent`'s
+ * `autopilot` option.
+ *
+ * @example
+ * ```ts
+ * defineStatefulAgent<BootstrapState>({
+ *   name: 'bootstrap',
+ *   …,
+ *   autopilot: defineAutopilot<BootstrapState>({
+ *     availableWhen: ({ state }) => briefApproved(state.machine),
+ *     widgetPolicy: { 'planning-question': 'allowed' },
+ *     systemPrompt: ({ state }) => `${AUTOPILOT_BASE}\n<brief>${frozenBrief(state)}</brief>`,
+ *   }),
+ * });
+ * ```
+ *
+ * @beta
+ */
+export declare function defineAutopilot<S = unknown>(config: AutopilotConfig<S>): AutopilotConfig<S>;
 //# sourceMappingURL=define-stateful-agent.d.ts.map

package/dist/dts/config/define-stateful-agent.d.ts.map

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

package/dist/dts/genesis/write-commit.d.ts

@@ -10,13 +10,23 @@ import { type GenesisWriteOutcome } from './write-outcome';
  * reopen the gap the review exists to close: the user approves what they read, and anything
  * re-derived afterwards is something they did not.
  *
- * There is **no pre-write validation pass**. `VALIDATE: true` is accepted and ignored by a
- * Create-generated handler — it declares `onCommit` only, so the platform runs it as a plain
- * event handler and the row is COMMITTED. Asking for a dry run there would write every row the
- * user was still deciding about, then report it as merely checked. What the dry run was buying
- * is already done client-side, before anything is sent: required fields, types, enums, dates
- * and read-only fields are all checked against the same metadata the server's schema validation
- * reads.
+ * There is **no pre-write validation pass** — not because one would write, but because it would
+ * check nothing new. `VALIDATE: true` runs a handler's `onValidate` and stops there: `onCommit`
+ * runs only on a message that is not a validate, after `onValidate` acked (genesis-server
+ * 8.15.29, `TransactionalEventHandlerContainer`; the same from 7.2.28 to 10.0.0-beta4). A
+ * Create-generated handler declares `onCommit` alone, so its `onValidate` is the platform's
+ * default, which acks; on 10.0 a Spring `@EventCommit`-only handler acks a validate without
+ * running at all. Recorded on the showcase: `EVENT_COUNTERPARTY_INSERT`, which has no
+ * `onValidate`, ACKed a `VALIDATE` and wrote nothing.
+ *
+ * So on such a handler a dry run checks the payload's schema and nothing more, and that is
+ * already done client-side, before anything is sent: required fields, types, enums, dates and
+ * read-only fields are all checked against the same metadata the server's schema validation
+ * reads. Where a handler does declare an `onValidate`, the commit runs it first, and its refusal
+ * comes back as that row's answer; a dry run would only hear it before the user approves rather
+ * than after. A dry run is unsafe only on hand-written code that is handed the flag and ignores
+ * it — a class implementing a plain, non-validating `AsyncEventHandler` or `SyncEventHandler`, or
+ * a Spring method taking `@IsValidateOnly` — which nothing on the wire tells apart from the rest.
  */
 export interface GenesisWriteRow {
     /** Position in the model's original list, so an outcome can be matched back to its row. */

package/dist/dts/genesis/write-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-commit.d.ts","sourceRoot":"","sources":["../../../src/genesis/write-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,EAAE,EAAE,UAAU,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,gBAAgB;AAChB,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,SAA6B,EAAE,EAAE,aAAa,GAC/E,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyD7B"}
+{"version":3,"file":"write-commit.d.ts","sourceRoot":"","sources":["../../../src/genesis/write-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,EAAE,EAAE,UAAU,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,gBAAgB;AAChB,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,SAA6B,EAAE,EAAE,aAAa,GAC/E,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyD7B"}

package/dist/dts/index.d.ts

@@ -3,6 +3,7 @@ export * from './main/main.types';
 export * from './main/main.template';
 export * from './components/agent-picker';
 export * from './components/agent-session';
+export * from './autopilot';
 export * from './components/ai-driver';
 export * from './components/chat-driver';
 export type { InteractionCompletedEventDetail, InteractionCostEventDetail, } from './components/chat-interaction-wrapper/chat-interaction-wrapper';
@@ -26,11 +27,14 @@ export type { TurnFailureReason } from './state/debug-event-log';
 export type { TimelineMessage } from './utils/flatten-sub-agent-messages';
 export type { CostSessionModelEntry, CostSessionRecord } from './utils/cost-session-history';
 export type { ResolvedDebugLogNoteConfig } from './utils/resolve-debug-log-note';
-export type { ModelTagAppearance } from '@genesislcap/foundation-ai';
+export type { InteractionEdit, ModelTagAppearance } from '@genesislcap/foundation-ai';
 export type { AiChatInteraction, AiChatWidget } from './types/ai-chat-widget';
-export type { InteractionContext, InteractionHolder } from './types/interaction-context';
-export type { DelegatedDecision, InteractionHold, InteractionInterceptor, InteractionOpened, } from './types/interaction-interceptor';
+export type { InteractionContext, InteractionHolder, PersistedInteractionCheckpoint, } from './types/interaction-context';
+export { runSteps, type Step, type StepCheckpoint, type StepOutcome } from './state/run-steps';
+export type { DelegatedDecision, DelegatedEdits, InteractionHold, InteractionInterceptor, InteractionOpened, } from './types/interaction-interceptor';
 export type { HandlerCapabilityFactory, HandlerCapabilityScope } from './types/handler-capability';
+export type { DecisionAnswer, DecisionOption, DecisionSpec, InteractionSurface, InvokeResult, SurfaceAction, SurfaceActionSpec, SurfaceSpec, } from './types/interaction-surface';
+export { getInteractionRegistration, registerInteraction, type InteractionControllerFactory, type InteractionRegistration, } from './state/interaction-registry';
 export { AiChatMarkdown, MARKDOWN_EXPORTPARTS } from './components/chat-markdown/chat-markdown';
 export type { GenesisChangeRequest, GenesisReviewPayload, GenesisWriteReviewCompletedEventDetail, } from './genesis/review-payload';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,YAAY,EACV,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,gEAAgE,CAAC;AACxE,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAGpC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mCAAmC,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC7F,YAAY,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACzF,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGnG,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAIhG,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,sCAAsC,GACvC,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,YAAY,EACV,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,gEAAgE,CAAC;AACxE,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAGpC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mCAAmC,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC7F,YAAY,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC9E,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/F,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnG,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,WAAW,GACZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,GAC7B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAIhG,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,sCAAsC,GACvC,MAAM,0BAA0B,CAAC"}

package/dist/dts/main/main.d.ts

@@ -2,13 +2,14 @@ import type { AggregateUsage, AIProviderRegistryStatusEntry, AIServiceRefusal, A
 import { AIProviderRegistry } from '@genesislcap/foundation-ai';
 import type { Modal } from '@genesislcap/rapid-design-system';
 import { GenesisElement } from '@genesislcap/web-core';
+import { type AutopilotHost, type AutopilotHostState } from '../autopilot/autopilot-driver';
 import { type SettingsModalTab, type SettingsModalTabsElement } from '../components/settings-modal';
-import type { AgentConfig } from '../config/config';
+import type { AgentConfig, AutopilotCopy } from '../config/config';
 import { AssistantAppSettingsProvider, type AssistantAppSettingsHeading, type AssistantAppSettingsToggle } from '../provider/assistant-app-settings';
 import type { BlockedCause, VendorBudgetFigures } from '../state/ai-assistant-slice';
 import type { DebugLog } from '../state/persistence/diagnostics';
 import type { SessionPersistenceConfig } from '../state/persistence/session-persistence-provider';
-import type { InteractionContext } from '../types/interaction-context';
+import type { InteractionContext, InteractionHolder } from '../types/interaction-context';
 import { type CompactionProjection } from '../utils/context-tokens';
 import type { CostSessionModelEntry, CostSessionRecord } from '../utils/cost-session-history';
 import type { ResolvedContextBudget } from '../utils/resolve-context-budget';
@@ -651,7 +652,7 @@ export declare class FoundationAiAssistant extends GenesisElement {
     private get transcriptBudgetExhaustedMessage();
     /**
      * Name of the agent the user has pinned via the agent picker. `null` means
-     * automatic routing (Auto). Persisted on the session store, so it survives
+     * orchestration: the assistant routes each message. Persisted on the session store, so it survives
      * pop-in/pop-out but resets on page refresh.
      *
      * Only changes on explicit user action (picker click or host's `setAgent`).
@@ -1048,6 +1049,110 @@ export declare class FoundationAiAssistant extends GenesisElement {
     private syncShowHalo;
     /** True when there is a pending (unresolved) interaction. */
     get hasActivePendingInteraction(): boolean;
+    /**
+     * True when the turn is parked on the person: a pending interaction they hold. One a claimant
+     * holds (the autopilot deciding it) is the assistant still working, so the halo and the loading
+     * indicator stay on (GENC-1660 §4.10).
+     */
+    get waitingOnUser(): boolean;
+    /**
+     * An autopilot host supplied from outside, in place of the one this element installs — the
+     * sandbox's stub, or a test's. Without it, the element reads the `AutopilotDriver` it installed
+     * when some agent declares `autopilot`.
+     *
+     * @beta
+     */
+    autopilotHostOverride?: AutopilotHost;
+    /** The autopilot's state and copy, mirrored for the template. Absent with no autopilot. @internal */
+    autopilotState?: AutopilotHostState;
+    /** @internal */
+    autopilotCopy?: AutopilotCopy;
+    /**
+     * A pending interaction being pointed out, after the person opened the collapsed assistant from
+     * its "needs you" badge: its row pulses briefly. @internal
+     */
+    attentionInteractionId?: string;
+    private attentionTimer?;
+    /** Who holds the trailing pending interaction: `'user'` unless a claimant took it. @internal */
+    activeHeldBy: InteractionHolder;
+    private autopilotCleanup?;
+    private heldCleanup?;
+    private heldInteractionId?;
+    /** The autopilot behind the slim bar and the banner, if there is one. */
+    get autopilotHost(): AutopilotHost | undefined;
+    /** Whether the autopilot is available for the current flow, running or paused. @internal */
+    get autopilotAvailable(): boolean;
+    /** Running and not waiting on an answer, so its control pauses it; otherwise it resumes. @internal */
+    get autopilotCanPause(): boolean;
+    /**
+     * What clicking the toggle does, at the head of its tooltip. While it waits on a question it
+     * handed back, Resume is not a plain resume: it takes that question back and decides it, with no
+     * way to hand it back again. @internal
+     */
+    get autopilotToggleAction(): string | undefined;
+    /**
+     * The toggle's tooltip: what clicking does now, then what the autopilot does. The action is here
+     * and not in its accessible name: the toggle is a toggle (`aria-pressed`), so its name stays
+     * `toggleLabel` and its state is announced once, by the pressed state. @internal
+     */
+    get autopilotToggleTitle(): string | undefined;
+    /** Waiting on one answer it handed back. @internal */
+    get autopilotSelfPaused(): boolean;
+    /**
+     * The slim bar takes the composer's place while something is happening and the autopilot runs or
+     * waits on one answer, and otherwise wherever the agent's own rules would hide the composer. Running
+     * but idle — stopped at a wall such as the budget, or at the end of a turn it had nothing to
+     * answer for — shows what those rules show, normally the composer, with the Autopilot pill on among
+     * its pills. It never forces the composer open. A host that hides the built-in composer
+     * (`chatConfig.ui.hideComposer`) has no pills to put it among, so there the slim bar stays up
+     * whenever the autopilot is available, running or paused, idle or not: the person can always see
+     * that it is on, and pause or resume it. @internal
+     */
+    get slimBarVisible(): boolean;
+    /**
+     * What the autopilot's status region announces (GENC-1660 §4.10): the hand-back, with its reason,
+     * while the autopilot waits on an answer; otherwise the slim bar's status while that shows;
+     * otherwise nothing. The region stays mounted and only this text changes, so each change is
+     * announced. @internal
+     */
+    get autopilotAnnouncement(): string;
+    /**
+     * The Autopilot pill among the composer's pills: available, with the composer shown — paused, or
+     * running with nothing happening. Where the host hides the composer, it is in the slim bar
+     * instead (see `slimBarVisible`). @internal
+     */
+    get composerAutopilotVisible(): boolean;
+    autopilotHostOverrideChanged(): void;
+    /** Follow the autopilot host's state, publishing the "needs you" signal for the bubble. */
+    private wireAutopilot;
+    /**
+     * Scroll to the pending interaction that waits on the person, and pulse it, so opening the chat
+     * from the badge lands on it rather than wherever the transcript was left.
+     */
+    private showWaiting;
+    /** How long a pointed-out interaction pulses for. */
+    private static readonly ATTENTION_MS;
+    /**
+     * Follow who holds the trailing pending interaction. A claimant changes it on its context, which
+     * notifies, so the view re-reads it on every notification rather than once (GENC-1660 §4.3).
+     */
+    private syncActiveHold;
+    private readActiveHold;
+    /**
+     * Whether a pending interaction's bubble is drawn at all. A widget registered with
+     * `whileAutopilot: 'hidden'` asks for no chrome while a claimant holds it: the view renders
+     * nothing, so an empty bubble would be left behind. @internal
+     */
+    isHiddenWhileHeld(m: ChatMessage): boolean;
+    /** The hand-back banner's reason, when this interaction is the one the autopilot handed back. @internal */
+    handBackReasonFor(m: ChatMessage): string | undefined;
+    /** Whether to mark a message as done in autopilot mode. @internal */
+    showsDelegateMark(m: ChatMessage): boolean;
+    /** The autopilot mark's tooltip. @internal */
+    get delegateMarkLabel(): string;
+    handleAutopilotPause(): void;
+    handleAutopilotResume(): void;
+    handleKeepPaused(interactionId: string): void;
     showHaloChanged(): void;
     private getActiveToolNames;
     /**
@@ -1217,6 +1322,15 @@ export declare class FoundationAiAssistant extends GenesisElement {
     private syncLoadingIndicator;
     /** Called when the user clicks the popout button. */
     handlePopout(): void;
+    /**
+     * The key this assistant's session is published under (on the activity bus, in the debug log,
+     * in storage): the wired session's once one is active, else the one its attributes imply. Not
+     * always the `session-key` attribute, which can run ahead of a deferred switch and is absent when
+     * the key is derived from `id` and the header title. `undefined` when it has no identity.
+     *
+     * @beta
+     */
+    get stateKey(): string | undefined;
     /** Returns a cache key for this instance, or undefined if the component has no identity. */
     private getStateKey;
     /**
@@ -1596,12 +1710,21 @@ export declare class FoundationAiAssistant extends GenesisElement {
      */
     get pinnedAgentColour(): string | undefined;
     /**
-     * Label beside the composer's agent glyph: `AUTO` while the orchestrator is
-     * routing, otherwise the pinned agent's name. The name is NOT shortened here —
+     * Label beside the composer's agent glyph: the orchestration label (`Orchestration` unless the
+     * host renames it) while the orchestrator is routing, otherwise the pinned agent's name. The name is NOT shortened here —
      * the button truncates with an ellipsis in CSS, so the full name stays
      * available to a screen reader and to the `title` tooltip.
      */
     get agentButtonLabel(): string;
+    /**
+     * The picker's name for orchestration, from `chatConfig.picker.orchestrationLabel`. Not "Auto":
+     * other tools use that for picking a model tier, and here it is the agent that is chosen.
+     */
+    get orchestrationLabel(): string;
+    /** The same choice's name in the picker menu, from `chatConfig.picker.orchestrationMenuLabel`. */
+    get orchestrationMenuLabel(): string;
+    /** What orchestration does, from `chatConfig.picker.orchestrationDescription`. */
+    get orchestrationDescription(): string;
     /**
      * Placeholder shown in the chat input. Substitutes the pinned agent's name
      * when one is selected so the user has a clearer signal of where their