lua-cli 3.35.0 → 3.36.0

package/dist/voice/test/index.d.ts

@@ -246,13 +246,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     }, {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -312,13 +312,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     }, {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -378,13 +378,13 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     }, {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
         provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -570,8 +570,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -586,8 +586,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -601,8 +601,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -664,8 +664,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -680,8 +680,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -695,8 +695,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -758,8 +758,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -774,8 +774,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -789,8 +789,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -852,8 +852,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -868,8 +868,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";
@@ -883,8 +883,8 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
     } | {
         provider?: "deepgram" | "elevenlabs";
         kind?: "plugin";
-        options?: Record<string, unknown>;
         class?: "LLM" | "STT" | "STTv2" | "TTS";
+        options?: Record<string, unknown>;
     } | {
         provider?: "google" | "xai" | "openai";
         kind?: "realtime";

package/dist/workflow-builder.d.ts

@@ -48,6 +48,30 @@ export declare interface AgentStepOptions {
      */
     maxMessages?: number;
     maxInputTokens?: number;
+    /**
+     * What this step DOES: `classify` | `extract` | `transform` | `draft` | `research` | `reason` | `code` |
+     * `judge`. On a PUSHED definition it must come with a `model` — a static `taskClass` with none is refused
+     * `task-class-without-model`, because nothing maps a task class to a model at dispatch.
+     */
+    taskClass?: WorkflowTaskClass;
+    /**
+     * Traits the chosen model must have: `vision` | `structured` | `largeContext` | `codeExecution`. Write these
+     * rather than pinning a code that may retire. A step with an `outputSchema` needs `structured`; one reading
+     * images needs `vision`.
+     */
+    requires?: WorkflowModelTrait[];
+    /** One line on why this class or pin was chosen — at most 160 characters, plain text, never parsed. */
+    modelReason?: string;
+    /**
+     * Reasoning effort for this step: `low` for fast work and tool-heavy orchestration, `high` for `reason` and
+     * `code`, `medium` otherwise. Inert on rows whose ladder is toggle-only.
+     *
+     * COMPATIBILITY: writing it changes nothing on its own. A plain `lua push` keeps the envelope at
+     * `luaWorkflow: 1`, and the executor forwards effort only when the run's frozen snapshot says 2 — opted into
+     * by `lua push --apply-effort` or by a new compose while assignment is on (plan 6.4, "The effort marker").
+     * Until then the value is carried and estimated, never applied.
+     */
+    effort?: WorkflowAgentEffort;
 }
 
 export declare interface AgentToolScope {
@@ -614,6 +638,9 @@ export declare interface WaitForSignalOptions {
     acceptedSources?: Array<'webhook' | 'api' | 'user' | 'agent'>;
 }
 
+/** `agent.effort` — the reasoning-effort hint a graph agent node may carry (lua-core's envelope member). */
+declare const WORKFLOW_AGENT_EFFORTS: readonly ["low", "medium", "high"];
+
 /** `approval.onDeny` (§6.4.11 deny-as-data): `'fail'` fails the step on a denial; default `'continue'`. */
 declare const WORKFLOW_APPROVAL_ON_DENY: readonly ["fail", "continue"];
 
@@ -627,6 +654,13 @@ declare const WORKFLOW_JOB_HARNESSES: readonly ["claude-code", "generic"];
 /** `jobResources` (05 §5.17): the Job-tier pod size class. Default `'small'` at spawn. */
 declare const WORKFLOW_JOB_RESOURCES: readonly ["small", "medium", "large"];
 
+/**
+ * Required traits — capabilities the chosen model MUST have (`AgentNode.requires`), so a composed step can
+ * say "needs vision" without pinning a code that may retire. Derived from the catalog row's `media`,
+ * `structuredOutput`, `contextWindow` and `tools.codeExecution` (plan 6.2).
+ */
+declare const WORKFLOW_MODEL_TRAITS: readonly ["vision", "structured", "largeContext", "codeExecution"];
+
 /** What the FINAL failure of a step does to the run: `'park'` → the §06 §6.3.5 exception gate. Default `'fail'`. */
 declare const WORKFLOW_ON_ERROR: readonly ["fail", "continue", "park"];
 
@@ -639,9 +673,18 @@ declare const WORKFLOW_SIDE_EFFECTS: readonly ["none", "external"];
 /** `waitForSignal.onTimeout`: default `'fail'`; `'continue'` ⇒ output `{received:false, timedOut:true}`. */
 declare const WORKFLOW_SIGNAL_ON_TIMEOUT: readonly ["fail", "continue"];
 
+/**
+ * Task class — what a step DOES, the composer's primary output for model choice (`AgentNode.taskClass`).
+ * The platform maps a task class to a model class (plan 6.3's default `classMap`; an org may override it),
+ * so a composer never has to reason about concrete models. Eight values to start.
+ */
+declare const WORKFLOW_TASK_CLASSES: readonly ["classify", "extract", "transform", "draft", "research", "reason", "code", "judge"];
+
 /** The only tier a node may DECLARE (`tier:'job'`, implied by `workspace`); the worker tier is the absence. */
 declare const WORKFLOW_TIERS: readonly ["job"];
 
+declare type WorkflowAgentEffort = (typeof WORKFLOW_AGENT_EFFORTS)[number];
+
 declare type WorkflowApprovalOnDeny = (typeof WORKFLOW_APPROVAL_ON_DENY)[number];
 
 export declare type WorkflowApproverSpec = 'creator' | 'org-admins' | {
@@ -750,6 +793,8 @@ export declare interface WorkflowMergePolicy {
     onConflict: 'fail' | 'agent';
 }
 
+declare type WorkflowModelTrait = (typeof WORKFLOW_MODEL_TRAITS)[number];
+
 declare type WorkflowOnError = (typeof WORKFLOW_ON_ERROR)[number];
 
 export declare interface WorkflowOutputVisibility {
@@ -974,6 +1019,8 @@ export declare type WorkflowSuspendTimeoutChainMember = 'deny' | 'cancel-run' |
     timeoutHours: number;
 };
 
+declare type WorkflowTaskClass = (typeof WORKFLOW_TASK_CLASSES)[number];
+
 declare type WorkflowTier = (typeof WORKFLOW_TIERS)[number];
 
 export declare type WorkflowWorkspaceBackend = 'ebs' | 'efs' | 's3';