lua-cli 3.16.2 → 3.17.1

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).
+ */
+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;
 
 /**
@@ -165,8 +195,21 @@ declare interface AiGenerateInput {
     messages?: unknown[];
     temperature?: number;
     maxOutputTokens?: number;
+    /**
+     * When set, constrains the response to match the JSON Schema. The parsed result
+     * lands on `AiGenerateOutput.output`. Mirrors AI SDK `Output.object({ schema })`.
+     * Object-mode only in this version — array/choice modes are future extensions.
+     */
+    structuredOutput?: AiGenerateStructuredOutput;
 }
 
+/**
+ * JSON Schema 7-shaped object describing the structured output the model must return.
+ * 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>;
+
 /**
  * Wire-format output from `AI.generate` / `POST .../generate`.
  * Fields mirror AI SDK `GenerateTextResult` — uses AI SDK types where exported.
@@ -188,6 +231,11 @@ declare interface AiGenerateOutput {
     toolCalls?: AiGenerateToolCall[];
     /** Tool results from generation */
     toolResults?: AiGenerateToolResult[];
+    /**
+     * Parsed structured result when `AiGenerateInput.structuredOutput` was set.
+     * Shape conforms to the supplied JSON Schema. Mirrors AI SDK `result.output`.
+     */
+    output?: unknown;
     /** Provider warnings (e.g. unsupported settings) — AI SDK `CallWarning[]` */
     warnings?: CallWarning[];
 }
@@ -203,6 +251,15 @@ declare interface AiGenerateSource {
     title?: string;
 }
 
+/**
+ * Structured-output spec. Maps to AI SDK `output: Output.object({ schema })` on `generateText`.
+ * Result lands on `AiGenerateOutput.output`.
+ */
+declare interface AiGenerateStructuredOutput {
+    /** JSON Schema 7 describing the expected object shape. */
+    schema: AiGenerateJsonSchema;
+}
+
 /**
  * Serializable tool call. Mirrors `TypedToolCall` without generics.
  * `input` matches the AI SDK field name (renamed from `args` in v5).
@@ -255,6 +312,7 @@ declare interface ApiResponse<T = any> {
     data?: T;
     error?: {
         message: string;
+        code?: string;
         statusCode?: number;
         error?: string;
     };
@@ -1768,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;
@@ -1799,6 +1858,7 @@ export declare class LuaAgent {
     getName(): string;
     getPersona(): PersonaText;
     getModel(): LuaAgentModel | undefined;
+    getModelSettings(): AgentModelSettings | undefined;
     getSkills(): LuaSkill[];
     getWebhooks(): LuaWebhook[];
     getJobs(): LuaJob[];
@@ -1817,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 */
@@ -2796,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?: {
@@ -2888,6 +2958,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }, {
     vad?: string;
     stt?: {
@@ -2980,6 +3051,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }>, {
     vad?: string;
     stt?: {
@@ -3072,6 +3144,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }, {
     vad?: string;
     stt?: {
@@ -3164,6 +3237,7 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     pronunciations?: Record<string, string>;
     persistTranscript?: boolean;
+    onToolFailureSay?: string;
 }>;
 
 /**
@@ -3279,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,13 +27,14 @@ 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, 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";
     CLI_CONFIG_DIR = join(homedir(), ".lua-cli");
     VERSION_CHECK_FILE = join(CLI_CONFIG_DIR, "version-check.json");
     TELEMETRY_FILE = join(CLI_CONFIG_DIR, "telemetry.json");
+    CLI_CACHE_FILE = join(CLI_CONFIG_DIR, "cache.json");
     BASE_URLS = {
       API: process.env.LUA_API_URL || "https://api.heylua.ai",
       AUTH: process.env.LUA_AUTH_URL || "https://auth.heylua.ai",
@@ -43,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");
   }
 });
 
@@ -787,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";
@@ -5661,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");
@@ -5668,6 +5709,7 @@ var LuaAgent = class {
   name;
   persona;
   model;
+  modelSettings;
   skills;
   webhooks;
   jobs;
@@ -5699,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");
@@ -5725,6 +5771,9 @@ var LuaAgent = class {
   getModel() {
     return this.model;
   }
+  getModelSettings() {
+    return this.modelSettings;
+  }
   getSkills() {
     return this.skills;
   }