lua-cli 3.17.0 → 3.17.2

package/dist/api-exports.d.ts

@@ -78,6 +78,36 @@ declare interface AgentInvocationOutput {
     threadId?: string;
 }
 
+/**
+ * Per-agent LLM call settings. Maps directly onto Mastra's
+ * `agent.stream({ modelSettings })` / `agent.generate({ modelSettings })`,
+ * which in turn maps onto the AI SDK's `CallSettings`. Pass-through:
+ * we don't validate ranges here; the provider will reject invalid combos
+ * (e.g. topP > 1, presencePenalty out of provider range).
+ *
+ * Deliberately excludes `abortSignal` (not serializable), `headers`
+ * (security — could exfiltrate credentials), and `maxRetries` (platform
+ * concern, not customer-tunable).
+ */
+export declare interface AgentModelSettings {
+    /** Sampling temperature. Range depends on provider (typically 0..2 for Anthropic/OpenAI). */
+    temperature?: number;
+    /** Nucleus sampling. 0..1. Recommended: set either `temperature` or `topP`, not both. */
+    topP?: number;
+    /** Top-K sampling. Advanced. */
+    topK?: number;
+    /** Maximum tokens to generate. */
+    maxOutputTokens?: number;
+    /** Presence penalty. -2..2 (OpenAI); not all providers support. */
+    presencePenalty?: number;
+    /** Frequency penalty. -2..2 (OpenAI); not all providers support. */
+    frequencyPenalty?: number;
+    /** Stop sequences. Generation halts when the model emits one of these. */
+    stopSequences?: string[];
+    /** Random seed for deterministic sampling (provider support varies). */
+    seed?: number;
+}
+
 export declare const Agents: AgentsApi;
 
 /**
@@ -158,7 +188,7 @@ export declare interface AiApi {
  * Serializable subset of AI SDK `generateText` parameters.
  * `messages` is untyped over HTTP; callers typically send AI SDK `ModelMessage[]`.
  */
-declare interface AiGenerateInput {
+export declare interface AiGenerateInput {
     model?: string;
     system?: string;
     prompt?: string;
@@ -178,14 +208,14 @@ declare interface AiGenerateInput {
  * Kept as `Record<string, unknown>` to avoid pulling `@types/json-schema` into the
  * published lua-cli surface; callers typically produce this via `zodToJsonSchema`.
  */
-declare type AiGenerateJsonSchema = Record<string, unknown>;
+export declare type AiGenerateJsonSchema = Record<string, unknown>;
 
 /**
  * Wire-format output from `AI.generate` / `POST .../generate`.
  * Fields mirror AI SDK `GenerateTextResult` — uses AI SDK types where exported.
  * See https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text
  */
-declare interface AiGenerateOutput {
+export declare interface AiGenerateOutput {
     text: string;
     /** AI SDK `FinishReason` */
     finishReason: FinishReason;
@@ -214,7 +244,7 @@ declare interface AiGenerateOutput {
  * URL source from Google Search grounding.
  * Mirrors `LanguageModelV2Source` (AI SDK `Source` type — not exported from `ai` as of v5).
  */
-declare interface AiGenerateSource {
+export declare interface AiGenerateSource {
     sourceType: 'url';
     id: string;
     url: string;
@@ -225,7 +255,7 @@ declare interface AiGenerateSource {
  * Structured-output spec. Maps to AI SDK `output: Output.object({ schema })` on `generateText`.
  * Result lands on `AiGenerateOutput.output`.
  */
-declare interface AiGenerateStructuredOutput {
+export declare interface AiGenerateStructuredOutput {
     /** JSON Schema 7 describing the expected object shape. */
     schema: AiGenerateJsonSchema;
 }
@@ -234,7 +264,7 @@ declare interface AiGenerateStructuredOutput {
  * Serializable tool call. Mirrors `TypedToolCall` without generics.
  * `input` matches the AI SDK field name (renamed from `args` in v5).
  */
-declare interface AiGenerateToolCall {
+export declare interface AiGenerateToolCall {
     type: 'tool-call';
     toolCallId: string;
     toolName: string;
@@ -245,7 +275,7 @@ declare interface AiGenerateToolCall {
  * Serializable tool result. Mirrors `TypedToolResult` without generics.
  * `output` matches the AI SDK field name.
  */
-declare interface AiGenerateToolResult {
+export declare interface AiGenerateToolResult {
     type: 'tool-result';
     toolCallId: string;
     toolName: string;
@@ -1796,6 +1826,7 @@ export declare class LuaAgent {
     private readonly name;
     private readonly persona;
     private readonly model?;
+    private readonly modelSettings?;
     private readonly skills;
     private readonly webhooks;
     private readonly jobs;
@@ -1827,6 +1858,7 @@ export declare class LuaAgent {
     getName(): string;
     getPersona(): PersonaText;
     getModel(): LuaAgentModel | undefined;
+    getModelSettings(): AgentModelSettings | undefined;
     getSkills(): LuaSkill[];
     getWebhooks(): LuaWebhook[];
     getJobs(): LuaJob[];
@@ -1845,6 +1877,15 @@ export declare interface LuaAgentConfig {
     persona: PersonaText;
     /** LLM model to use — 'provider/model' string or resolver function */
     model?: LuaAgentModel;
+    /**
+     * Per-call sampling settings (temperature, topP, maxOutputTokens, etc.).
+     * Passed straight through to Mastra / AI SDK on every `chat/stream` and
+     * `chat/generate`. Undefined leaves provider defaults in place.
+     *
+     * @example
+     * modelSettings: { temperature: 0.2, maxOutputTokens: 4096 }
+     */
+    modelSettings?: AgentModelSettings;
     /** Array of skills (each with tools) */
     skills?: LuaSkill[];
     /** Array of webhooks */
@@ -2824,6 +2865,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     volume: z.ZodOptional<z.ZodNumber>;
     pronunciations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     persistTranscript: z.ZodOptional<z.ZodBoolean>;
+    onToolFailureSay: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     vad?: string;
     stt?: {
@@ -2916,6 +2958,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }, {
     vad?: string;
     stt?: {
@@ -3008,6 +3051,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }>, {
     vad?: string;
     stt?: {
@@ -3100,6 +3144,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }, {
     vad?: string;
     stt?: {
@@ -3192,6 +3237,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }>;
 
 /**
@@ -3307,6 +3353,21 @@ export declare interface LuaVoiceToolCtx {
             mode?: 'bridge' | 'refer';
             announce?: string;
         }): Promise<void>;
+        /**
+         * End the live call. When `announce` is set, the agent speaks it and
+         * waits for playout before closing the session — useful for a sign-off
+         * like "Thanks for calling, goodbye." Without `announce`, the session
+         * closes immediately (any in-flight TTS finishes via the SDK's
+         * graceful `close()`).
+         *
+         * @example
+         * ```typescript
+         * await ctx.voice?.endCall({ announce: 'Thanks for calling. Goodbye.' });
+         * ```
+         */
+        endCall?(opts?: {
+            announce?: string;
+        }): Promise<void>;
         /**
          * @experimental Reserved for Phase 5 (BAC-213). Optional because
          * unimplemented — the actual "lock the assistant's current

package/dist/api-exports.js

@@ -27,7 +27,7 @@ var init_baskets = __esm({
 // src/config/constants.ts
 import { join } from "path";
 import { homedir } from "os";
-var CLI_CONFIG_DIR, VERSION_CHECK_FILE, TELEMETRY_FILE, CLI_CACHE_FILE, BASE_URLS, CREDENTIALS_FILE, SANDBOX_STORAGE_FILE;
+var CLI_CONFIG_DIR, VERSION_CHECK_FILE, TELEMETRY_FILE, CLI_CACHE_FILE, BASE_URLS, CREDENTIALS_FILE, SANDBOX_STORAGE_FILE, AUTH_STORAGE_FILE;
 var init_constants = __esm({
   "src/config/constants.ts"() {
     "use strict";
@@ -44,6 +44,7 @@ var init_constants = __esm({
     };
     CREDENTIALS_FILE = join(CLI_CONFIG_DIR, "credentials");
     SANDBOX_STORAGE_FILE = join(CLI_CONFIG_DIR, "sandbox.json");
+    AUTH_STORAGE_FILE = join(CLI_CONFIG_DIR, "auth.json");
   }
 });
 
@@ -788,7 +789,14 @@ Feel free to add, remove, or rename sections. Your persona can be a single parag
       // `Data.get('call:<sessionId>')` to drive post-call analytics, follow-ups,
       // or QA workflows. Defaults to false — most calls don't need to keep
       // a transcript copy.
-      persistTranscript: z.boolean().optional()
+      persistTranscript: z.boolean().optional(),
+      // Spoken acknowledgement played when a tool call fails. When a tool
+      // throws, times out, or returns an unsupported result, the adapter calls
+      // `session.say(text)` once per failed call before surfacing the error
+      // to the LLM as a ToolError — fills the 2–3s gap before the LLM's own
+      // recovery response. Persona-specific (keep it short and on-brand);
+      // absent → no spoken fallback (the LLM's recovery is the only signal).
+      onToolFailureSay: z.string().min(1).max(200).optional()
     });
     LuaVoiceConfigSchema = LuaVoiceConfigInnerSchema.superRefine((cfg, ctx) => {
       const isRealtime = cfg.llm.kind === "realtime";
@@ -5662,6 +5670,38 @@ var LuaMCPServer = class {
     return base;
   }
 };
+function validateModelSettings(settings) {
+  const finiteNumberKeys = [
+    "temperature",
+    "topP",
+    "topK",
+    "maxOutputTokens",
+    "presencePenalty",
+    "frequencyPenalty",
+    "seed"
+  ];
+  for (const key of finiteNumberKeys) {
+    const value = settings[key];
+    if (value !== void 0 && (typeof value !== "number" || !Number.isFinite(value))) {
+      throw new Error(`Agent modelSettings.${key} must be a finite number`);
+    }
+  }
+  if (settings.temperature !== void 0 && (settings.temperature < 0 || settings.temperature > 2)) {
+    throw new Error("Agent modelSettings.temperature must be between 0 and 2");
+  }
+  if (settings.topP !== void 0 && (settings.topP < 0 || settings.topP > 1)) {
+    throw new Error("Agent modelSettings.topP must be between 0 and 1");
+  }
+  if (settings.maxOutputTokens !== void 0 && settings.maxOutputTokens < 1) {
+    throw new Error("Agent modelSettings.maxOutputTokens must be >= 1");
+  }
+  if (settings.stopSequences !== void 0) {
+    if (!Array.isArray(settings.stopSequences) || !settings.stopSequences.every((v) => typeof v === "string")) {
+      throw new Error("Agent modelSettings.stopSequences must be a string array");
+    }
+  }
+}
+__name(validateModelSettings, "validateModelSettings");
 var LuaAgent = class {
   static {
     __name(this, "LuaAgent");
@@ -5669,6 +5709,7 @@ var LuaAgent = class {
   name;
   persona;
   model;
+  modelSettings;
   skills;
   webhooks;
   jobs;
@@ -5700,6 +5741,10 @@ var LuaAgent = class {
     this.name = config.name;
     this.persona = config.persona;
     this.model = config.model;
+    if (config.modelSettings !== void 0) {
+      validateModelSettings(config.modelSettings);
+    }
+    this.modelSettings = config.modelSettings;
     if (typeof this.persona === "object") {
       if (!this.persona.base && !this.persona.voice && !this.persona.text) {
         throw new Error("Agent persona object must have at least one of: base, voice, text");
@@ -5726,6 +5771,9 @@ var LuaAgent = class {
   getModel() {
     return this.model;
   }
+  getModelSettings() {
+    return this.modelSettings;
+  }
   getSkills() {
     return this.skills;
   }