lua-cli 3.46.0 → 3.48.0

package/dist/api-exports.d.ts

@@ -374,6 +374,8 @@ declare interface AgentInvocationMeter {
      * to force the heavy tier (`hasDocProcessingTool`), so the workflow price must see them too.
      */
     toolNames?: string[];
+    /** The per-step prompt components the usage event's `contextSteps` carries — the prompt-size tier reads them. */
+    contextSteps?: LlmContextStep[];
     byok?: boolean;
     chargedCredits?: boolean;
     /**
@@ -1884,10 +1886,37 @@ export declare enum BasketStatus {
  * Overrides platform-wide env var defaults for this specific agent.
  */
 export declare interface BatchingConfig {
-    /** Hold first message N ms before processing, to allow rapid follow-ups to batch together. 0 = disabled. */
+    /**
+     * Fixed hold applied to the first message of a turn before processing, so rapid
+     * follow-ups can join it. 0 = disabled.
+     *
+     * This is a tax on EVERY turn, including single-message ones: `10000` delays every
+     * reply by 10s whether or not the user sends a second message. Keep it small
+     * (a few hundred ms to ~2s) unless your users routinely send bursts.
+     */
     firstMessageDelayMs?: number;
-    /** Window to collect subsequent messages while one is in-flight (ms). 0 = batching disabled. */
+    /**
+     * Quiet period (ms) that collects subsequent messages while one is in-flight. 0 = batching disabled.
+     *
+     * The window SLIDES: every new message in the batch restarts it, so the reply goes out
+     * `debounceWindowMs` after the user's LAST message. `30000` means a user who keeps typing
+     * waits 30s after their final message. Larger values batch long bursts better but add
+     * latency; pair a large value with `maxWaitMs` to bound the wait.
+     */
     debounceWindowMs?: number;
+    /**
+     * Hard cap (ms) on how long a sliding debounce batch can be held, measured from batch
+     * creation (the arrival of the message that formed the batch, not from the
+     * `firstMessageDelayMs` hold). The batch fires on the quiet period OR this cap, whichever
+     * comes first, so a continuous stream of messages cannot postpone the reply indefinitely.
+     *
+     * Optional; absent or 0 = no cap (the window slides until `maxBatchMessages` or silence).
+     * If smaller than `debounceWindowMs`, the cap still applies from batch creation.
+     * Per-agent only, no platform-wide default. Bounds the debounce wait only; the serialize-mode
+     * wait for an in-flight turn is not covered. Measure the effect with
+     * `lua_chat_stage_duration_seconds{stage="batch_wait"}`.
+     */
+    maxWaitMs?: number;
     /** Maximum messages collected in a single batch. */
     maxBatchMessages?: number;
     /**
@@ -2371,6 +2400,8 @@ export declare interface ChatHistoryMessage {
         agentId: string;
         name?: string;
     };
+    /** On a user message: the id the client gave the turn when it sent it, so it can tell which of its sends arrived. */
+    clientTurnId?: string;
     /**
      * Permanent recording for a voice-note turn (Lua Desktop). Populated by the
      * admin threads history endpoint from the row's `content.metadata.audio` — a
@@ -2392,6 +2423,20 @@ export declare type ChatMessage = TextMessage | ImageMessage | FileMessage;
 /** wave 2 U33 — the typed refusal `Integrations.checkAsUser` raises outside a live chat turn. */
 export declare function checkAsUserRequiresUser(): Error;
 
+export declare interface ChoiceAnswer<L extends string = string> {
+    type: 'choice';
+    choice: L;
+    confidence: number;
+    probabilities: Record<L, number>;
+    uncertain: boolean;
+}
+
+export declare interface ChoiceQuestion<L extends string = string> {
+    type: 'choice';
+    instructions: string;
+    options: Record<L, string>;
+}
+
 /**
  * U6 (wave 2) — connection inspection, account pinning and capability checks; U33 — the same checks run
  * with the CONVERSATION USER's principal. Owner: U6 (catalogue, list, pin, check, cleanup); U33 owns only
@@ -2986,6 +3031,137 @@ export declare class DataEntryInstance {
 
 export { DatasetRef }
 
+declare const DECISION_ERROR_CODES: {
+    readonly INVALID: "decision_invalid";
+    readonly TIMEOUT: "decision_timeout";
+    readonly REJECTED: "decision_rejected";
+    readonly UNAVAILABLE: "decision_unavailable";
+    readonly DISABLED: "decision_disabled";
+    readonly INSUFFICIENT_CREDITS: "decision_insufficient_credits";
+    readonly NOT_FOUND: "decision_not_found";
+};
+
+declare const DECISION_PROVIDERS: readonly ["jev", "openai"];
+
+declare const DECISION_ROUTING_RULES: readonly ["pinned", "images", "region", "zero_retention", "default", "fallback"];
+
+export declare type DecisionAnswer = OddsAnswer | ChoiceAnswer | ScoreAnswer | RefusedAnswer;
+
+export declare type DecisionAnswerFor<Q extends DecisionQuestion> = Q extends ChoiceQuestion<infer L> ? ChoiceAnswer<L> | RefusedAnswer : Q extends ScoreQuestion ? ScoreAnswer | RefusedAnswer : OddsAnswer | RefusedAnswer;
+
+export declare type DecisionAnswers<Q extends DecisionQuestions> = {
+    [K in keyof Q]: DecisionAnswerFor<Q[K]>;
+};
+
+export declare interface DecisionDefinition<Q extends DecisionQuestions = DecisionQuestions> extends DecisionOptions {
+    name: string;
+    description?: string;
+    questions: Q;
+}
+
+export declare interface DecisionError extends Error {
+    readonly code: DecisionErrorFields['code'];
+    readonly provider?: DecisionProvider;
+    readonly upstreamStatus?: number;
+}
+
+export declare const DecisionError: new (message: string, fields: DecisionErrorFields) => DecisionError;
+
+export declare type DecisionErrorCode = (typeof DECISION_ERROR_CODES)[keyof typeof DECISION_ERROR_CODES];
+
+export declare interface DecisionErrorFields {
+    code: DecisionErrorCode | (string & {});
+    provider?: DecisionProvider;
+    upstreamStatus?: number;
+}
+
+declare type DecisionFallback = DecisionProvider | 'none';
+
+declare interface DecisionFallbackInfo {
+    from: DecisionProvider;
+    reason: string;
+}
+
+declare interface DecisionImage {
+    data: string;
+    mimeType: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
+}
+
+declare type DecisionLogState = 'summary' | 'full' | 'none';
+
+export declare interface DecisionOptions {
+    provider?: DecisionProviderChoice;
+    model?: string;
+    fallback?: DecisionFallback;
+    region?: DecisionRegion;
+    zeroRetention?: boolean;
+    minConfidence?: number;
+    timeoutMs?: number;
+    cache?: {
+        ttlSeconds: number;
+    };
+    logState?: DecisionLogState;
+}
+
+export declare type DecisionProvider = (typeof DECISION_PROVIDERS)[number];
+
+declare type DecisionProviderChoice = DecisionProvider | 'auto';
+
+export declare type DecisionQuestion = OddsQuestion | ChoiceQuestion | ScoreQuestion;
+
+export declare type DecisionQuestions = Record<string, DecisionQuestion>;
+
+declare type DecisionRegion = 'eu';
+
+export declare interface DecisionRequest<Q extends DecisionQuestions = DecisionQuestions> extends DecisionOptions {
+    state: DecisionState;
+    images?: DecisionImage[];
+    questions: Q;
+}
+
+export declare interface DecisionResult<Q extends DecisionQuestions = DecisionQuestions> {
+    decisionId: string;
+    answers: DecisionAnswers<Q>;
+    provider: DecisionProvider;
+    model: string;
+    rule: DecisionRoutingRule;
+    usage: DecisionUsage;
+    durationMs: number;
+    cached: boolean;
+    fallback?: DecisionFallbackInfo;
+}
+
+declare type DecisionRoutingRule = (typeof DECISION_ROUTING_RULES)[number];
+
+export declare type DecisionRunOptions = Omit<DecisionRunRequest, 'name' | 'state'>;
+
+declare interface DecisionRunRequest extends DecisionOptions {
+    name: string;
+    state: DecisionState;
+    images?: DecisionImage[];
+}
+
+export declare const Decisions: DecisionsApi;
+
+export declare interface DecisionsApi {
+    ask<Q extends DecisionQuestions>(request: DecisionRequest<Q>): Promise<DecisionResult<Q>>;
+    ask<Q extends DecisionQuestion>(state: DecisionState, question: Q, options?: DecisionOptions): Promise<DecisionAnswerFor<Q>>;
+    run<Q extends DecisionQuestions = DecisionQuestions>(name: string, state: DecisionState, options?: DecisionRunOptions): Promise<DecisionResult<Q>>;
+    odds(instructions: string, criteria?: OddsQuestion['criteria']): OddsQuestion;
+    choice<L extends string>(instructions: string, options: Record<L, string>): ChoiceQuestion<L>;
+    score(instructions: string, levels: ReadonlyArray<string | ScoreLevel>): ScoreQuestion;
+}
+
+export declare type DecisionState = string | string[] | {
+    [key: string]: unknown;
+};
+
+declare interface DecisionUsage {
+    inputTokens: number | null;
+}
+
+export declare function defineDecision<Q extends DecisionQuestions>(config: LuaDecisionConfig<Q>): LuaDecision<Q>;
+
 /**
  * Define a device that an agent can communicate with.
  *
@@ -3914,6 +4090,11 @@ declare abstract class HttpClient {
      * @protected
      */
     protected httpDelete<T>(url: string, headers?: Record<string, string>, overrides?: RequestOverrides): Promise<ApiResponse<T>>;
+    /**
+     * A DELETE with a JSON body, sent once (no retries): for a destructive call that carries a
+     * single-use secret (a confirmation code), where a blind retry could only spend it again.
+     */
+    protected httpDeleteOnce<T>(url: string, data?: any, headers?: Record<string, string>, overrides?: RequestOverrides): Promise<ApiResponse<T>>;
     /**
      * Performs an HTTP PATCH request
      * @param url - The relative URL path to request (will be appended to baseUrl)
@@ -4352,6 +4533,8 @@ declare interface Job {
     updatedAt: string;
     dynamic?: boolean;
     userId?: string;
+    /** The full chat thread id (base[:suffix]) the job was created in, set by the platform when Jobs.create ran inside a chat turn. Read-only; absent for jobs created outside a chat turn and for every earlier job. */
+    originThreadId?: string;
     metadata?: Record<string, any>;
     versions: JobVersion[];
     lastExecution?: JobExecution;
@@ -4839,6 +5022,42 @@ export declare const lit: <const V extends string | number | boolean | null>(v:
 
 export { Literal }
 
+/**
+ * LUA-724 (PR 7) — the billed turn's pricing inputs, exactly as chat's settlement event carries
+ * them (`chat.service.trackLlmInferenceUsage`): the model that ACTUALLY served the turn (the
+ * resolver's code, not the caller's pin), the de-paged `contextInputTokens` (largest single
+ * step's prompt — never the whole-turn sum), the tool-call COUNT, and whether the turn ran on
+ * the org's own key. `chargedCredits` echoes the gate's answer (true ⇒ the legacy pool deducted
+ * in real time; false ⇒ seat org / free turn — settlement meters it).
+ *
+ * Stamped by the serving pod ONLY on internal-auth turns that carry a billing `operationId`
+ * (the workflow agent-step loopback), as the enumerable `luaMeter` top-level field of the
+ * generate envelope — never on a Bearer turn, so the public wire is byte-identical. The
+ * workflow executor prices the step's `run.budget.spent` from it with `priceModelCall`.
+ */
+/**
+ * WJB-B1 (BAC-668, decision D1) — one ReAct step's prompt components, as the provider reported them:
+ * `inputTokens` the step's UNCACHED prompt, `cacheReadTokens` the tokens served from cache,
+ * `cacheCreationTokens` the flat write total with `cacheCreationTokens5m` / `cacheCreationTokens1h` its TTL
+ * split when the provider exposed one (the streaming chat path usually does not — a weighted chat step then
+ * weights READS alone). Names mirror `LlmUsageData`'s turn-level members, so one vocabulary describes the
+ * turn and its steps.
+ *
+ * DECLARED HERE, not in `@lua/shared-schemas`, deliberately. The chat hot-path util that builds these
+ * (`lua-core/src/utils/turn-signals.util.ts`) must not take a Nest-bearing runtime import: shared-schemas'
+ * dist requires `@nestjs/mongoose` at load, and nine `chat.controller.*.spec.ts` suites partially mock
+ * `@nestjs/common`, so importing the VALUE below from there turned them into
+ * `common_1.Module is not a function`. `@lua/shared-types` requires no Nest at all; shared-schemas
+ * re-exports both members, so `LlmUsageData.contextSteps` still reads as a member of that file.
+ */
+declare interface LlmContextStep {
+    inputTokens: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+    cacheCreationTokens5m?: number;
+    cacheCreationTokens1h?: number;
+}
+
 /**
  * Structured logging: `log.debug/info/warn/error(message, fields?)`.
  *
@@ -4966,6 +5185,7 @@ export declare class LuaAgent {
     private readonly devices;
     private readonly deviceTriggers;
     private readonly voices?;
+    private readonly decisions;
     private readonly batching?;
     private readonly governance?;
     private readonly browser?;
@@ -5006,6 +5226,7 @@ export declare class LuaAgent {
     getBatching(): BatchingConfig | undefined;
     getDevices(): LuaDevice[];
     getVoices(): LuaVoice[] | undefined;
+    getDecisions(): LuaDecision[];
 }
 
 export declare interface LuaAgentConfig {
@@ -5063,6 +5284,7 @@ export declare interface LuaAgentConfig {
      * single-element array — `voices: [supportVoice]`.
      */
     voices?: LuaVoice[];
+    decisions?: LuaDecision[];
     /** Per-agent message batching/debounce configuration. Overrides platform env var defaults. */
     batching?: BatchingConfig;
     /** Governance policy configuration. When set, tool calls, preprocessors, and postprocessors are governed. */
@@ -5101,6 +5323,26 @@ export declare type LuaAgentModel = string | ((request: LuaRequest) => string |
 /** The signed-in person a route runs for (never an API key, never anonymous). */
 export declare type LuaAuth = WebRouteAuth;
 
+export declare class LuaDecision<Q extends DecisionQuestions = DecisionQuestions> {
+    readonly name: string;
+    readonly description?: string;
+    readonly questions: Q;
+    readonly provider?: DecisionProviderChoice;
+    readonly model?: string;
+    readonly fallback?: DecisionFallback;
+    readonly region?: DecisionRegion;
+    readonly zeroRetention?: boolean;
+    readonly minConfidence?: number;
+    readonly timeoutMs?: number;
+    readonly cache?: {
+        ttlSeconds: number;
+    };
+    readonly logState?: DecisionLogState;
+    constructor(config: LuaDecisionConfig<Q>);
+}
+
+export declare type LuaDecisionConfig<Q extends DecisionQuestions = DecisionQuestions> = DecisionDefinition<Q>;
+
 /**
  * LuaDevice class — represents an external device that an agent can communicate with.
  *
@@ -5943,15 +6185,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }, {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -5964,14 +6206,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     }, {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -5984,13 +6226,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
-    }, {
         kind: "realtime";
+    }, {
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     }>]>;
     stt: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -6009,15 +6251,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }, {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -6030,14 +6272,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     }, {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -6050,13 +6292,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
-    }, {
         kind: "realtime";
+    }, {
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     }>]>>;
     tts: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"inference">;
@@ -6075,15 +6317,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }, {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"plugin">;
         provider: z.ZodEnum<["deepgram", "elevenlabs"]>;
@@ -6096,14 +6338,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     }, {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -6116,13 +6358,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
-    }, {
         kind: "realtime";
+    }, {
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     }>]>>;
     vad: z.ZodOptional<z.ZodString>;
     vadOptions: z.ZodOptional<z.ZodObject<{
@@ -6281,52 +6523,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     llm: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6375,52 +6617,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }, {
     llm: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6469,52 +6711,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }>, {
     llm: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6563,52 +6805,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }, {
     llm: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
-        options?: Record<string, unknown> | undefined;
+        kind: "inference";
         voice?: string | undefined;
+        options?: Record<string, unknown> | undefined;
     } | {
-        kind: "plugin";
         options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
     } | {
-        kind: "realtime";
         options: Record<string, unknown>;
         provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -7436,6 +7678,20 @@ export declare const notExists: (ref: TypedRef<unknown>) => LuaPredicate;
 
 export declare const notIn: <T extends string | number | boolean | null>(v: TypedRef<T>, set: T[]) => LuaPredicate;
 
+export declare interface OddsAnswer {
+    type: 'odds';
+    odds: number;
+}
+
+export declare interface OddsQuestion {
+    type: 'odds';
+    instructions: string;
+    criteria?: {
+        yes?: string;
+        no?: string;
+    };
+}
+
 export declare const or: (...args: LuaPredicate[]) => LuaPredicate;
 
 /**
@@ -8420,6 +8676,10 @@ declare const REASONING_EFFORT_VALUES: readonly ["off", "minimal", "low", "mediu
 
 declare type ReasoningEffort = (typeof REASONING_EFFORT_VALUES)[number];
 
+export declare interface RefusedAnswer {
+    type: 'refused';
+}
+
 export declare type ReplyChannel = 'whatsapp' | 'sms' | 'email' | 'webchat' | 'slack';
 
 declare interface RequestCredential {
@@ -8553,6 +8813,26 @@ declare interface ScopedPromoteFields {
     agentVersion?: number;
 }
 
+export declare interface ScoreAnswer {
+    type: 'score';
+    score: number;
+    level: string;
+    confidence: number;
+    probabilities: Record<string, number>;
+    uncertain: boolean;
+}
+
+export declare interface ScoreLevel {
+    label: string;
+    description: string;
+}
+
+export declare interface ScoreQuestion {
+    type: 'score';
+    instructions: string;
+    levels: ReadonlyArray<string | ScoreLevel>;
+}
+
 /**
  * Response from product search.
  */
@@ -9366,7 +9646,7 @@ export declare const Templates: {
 };
 
 /** Recorded effect kinds (DOC2 §7 seam table; `fetch` is sandbox egress record mode, §9.1). */
-declare const TEST_EFFECT_KINDS: readonly ["channel.send", "whatsapp.template", "whatsapp.reaction", "whatsapp.phone_request", "email.send", "inbox.push", "voice.call", "passthrough", "mcp.tool", "supervision.write", "user.update_name", "browser.action", "jobs.create", "fetch", "refused", "metrics.record", "threads.open", "threads.follow_up", "secrets.request", "connection_request.create", "connection_request.reconnect", "connection_request.cancel", "ai.generate"];
+declare const TEST_EFFECT_KINDS: readonly ["channel.send", "whatsapp.template", "whatsapp.reaction", "whatsapp.phone_request", "email.send", "inbox.push", "voice.call", "passthrough", "mcp.tool", "supervision.write", "user.update_name", "browser.action", "jobs.create", "fetch", "refused", "metrics.record", "threads.open", "threads.follow_up", "secrets.request", "connection_request.create", "connection_request.reconnect", "connection_request.cancel", "ai.generate", "decisions.ask"];
 
 declare type TestEffectKind = (typeof TEST_EFFECT_KINDS)[number];
 
@@ -9827,6 +10107,10 @@ declare interface UserDataAPI {
         set?: Record<string, any>;
         unset?: string[];
     }): Promise<any>;
+    /** Publishes the user's My work list (LUA-1028), replacing the previous one. */
+    setWorkItems(items: WorkItem[]): Promise<any>;
+    /** Removes the user's My work list. */
+    clearWorkItems(): Promise<any>;
     /**
      * Clears user data.
      * @returns Promise resolving when data is cleared
@@ -9883,7 +10167,23 @@ export declare class UserDataInstance {
     }): Promise<any>;
     unset(...fields: string[]): Promise<any>;
     /**
-     * Clears all user data for the current user
+     * Publishes this user's My work list (LUA-1028): the open work they see in Frontline's "My work",
+     * replacing the previous list. Publish whenever the work changes, for everyone it affects.
+     * @param items - At most 100 items; each `action` is the message sent when the user taps it
+     * @throws Error naming the first invalid item (nothing is sent), or if the write fails
+     *
+     * @example
+     * const technician = await User.get({ phone: '+254700000000' });
+     * await technician?.setWorkItems([
+     *   { id: 'MNT-00123', title: 'MNT-00123 · Fryer not heating', group: 'Assigned to you',
+     *     status: 'In progress', updatedAt: new Date(), action: 'Show MNT-00123' },
+     * ]);
+     */
+    setWorkItems(items: WorkItem[]): Promise<void>;
+    /** Removes this user's My work list. */
+    clearWorkItems(): Promise<void>;
+    /**
+     * Clears all user data for the current user (the My work list included)
      * @returns Promise resolving to `{ success: true }` if clearing was successful
      * @throws Error if the clear operation fails
      */
@@ -11267,6 +11567,27 @@ declare type WorkflowTier = (typeof WORKFLOW_TIERS)[number];
 
 export declare type WorkflowWorkspaceBackend = 'ebs' | 'efs' | 's3';
 
+/** One item as an agent publishes it. */
+export declare interface WorkItem {
+    /** Stable id within the list (e.g. a ticket number). */
+    id: string;
+    /** One line the user recognises, e.g. "MNT-00123 · Fryer not heating". */
+    title: string;
+    /** Display group chosen by the agent, e.g. "Waiting on you", "Your tickets". */
+    group: string;
+    /** The user's own action is needed (a fix to confirm, an approval to give); listed first. */
+    needsAction?: boolean;
+    /** Short status label, e.g. "In progress". */
+    status?: string;
+    /** When the work last changed. */
+    updatedAt: string | Date;
+    /**
+     * The message the user's client sends when the item is tapped. A show/open request
+     * ("Show MNT-00123"), never a decision: decisions are made in the conversation.
+     */
+    action: string;
+}
+
 export declare type WorkspaceSpec = {
     kind: 'git';
     repo: string | TemplateBinding;