lua-cli 3.47.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;
     /**
@@ -2398,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
@@ -2419,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
@@ -3013,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.
  *
@@ -3941,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)
@@ -4379,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;
@@ -4866,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?)`.
  *
@@ -4993,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?;
@@ -5033,6 +5226,7 @@ export declare class LuaAgent {
     getBatching(): BatchingConfig | undefined;
     getDevices(): LuaDevice[];
     getVoices(): LuaVoice[] | undefined;
+    getDecisions(): LuaDecision[];
 }
 
 export declare interface LuaAgentConfig {
@@ -5090,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. */
@@ -5128,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.
  *
@@ -5970,13 +6185,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "inference";
         model: string;
+        kind: "inference";
         voice?: string | undefined;
         options?: Record<string, unknown> | undefined;
     }, {
-        kind: "inference";
         model: string;
+        kind: "inference";
         voice?: string | undefined;
         options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
@@ -5991,15 +6206,15 @@ 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";
-        options: Record<string, unknown>;
     }, {
-        kind: "plugin";
+        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
-        options: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -6011,13 +6226,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
-    }, {
-        kind: "realtime";
         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">;
@@ -6036,13 +6251,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "inference";
         model: string;
+        kind: "inference";
         voice?: string | undefined;
         options?: Record<string, unknown> | undefined;
     }, {
-        kind: "inference";
         model: string;
+        kind: "inference";
         voice?: string | undefined;
         options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
@@ -6057,15 +6272,15 @@ 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";
-        options: Record<string, unknown>;
     }, {
-        kind: "plugin";
+        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
-        options: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -6077,13 +6292,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
-    }, {
-        kind: "realtime";
         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">;
@@ -6102,13 +6317,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "inference";
         model: string;
+        kind: "inference";
         voice?: string | undefined;
         options?: Record<string, unknown> | undefined;
     }, {
-        kind: "inference";
         model: string;
+        kind: "inference";
         voice?: string | undefined;
         options?: Record<string, unknown> | undefined;
     }>, z.ZodObject<{
@@ -6123,15 +6338,15 @@ 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";
-        options: Record<string, unknown>;
     }, {
-        kind: "plugin";
+        options: Record<string, unknown>;
         provider: "deepgram" | "elevenlabs";
+        kind: "plugin";
         class: "LLM" | "STT" | "STTv2" | "TTS";
-        options: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -6143,13 +6358,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
-    }, {
-        kind: "realtime";
         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<{
@@ -6308,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;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6402,52 +6617,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }, {
     llm: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6496,52 +6711,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }>, {
     llm: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -6590,52 +6805,52 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     excludeTools?: string[] | undefined;
 }, {
     llm: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     };
     name?: string | undefined;
     vad?: string | undefined;
     stt?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     volume?: number | undefined;
     tts?: {
-        kind: "inference";
         model: string;
+        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";
-        options: Record<string, unknown>;
     } | {
-        kind: "realtime";
-        provider: "openai" | "google" | "xai";
         options: Record<string, unknown>;
+        provider: "openai" | "google" | "xai";
+        kind: "realtime";
     } | undefined;
     vadOptions?: {
         minSpeechDuration?: number | undefined;
@@ -7463,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;
 
 /**
@@ -8447,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 {
@@ -8580,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.
  */
@@ -9393,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];