lua-cli 3.44.0 → 3.45.0

package/dist/api-exports.d.ts

@@ -720,6 +720,15 @@ export declare interface AgentsApi {
         promote(version: number, opts: {
             expectActive: number | null;
         }): Promise<unknown>;
+        /**
+         * WD — restore `version`, a version that was ACTIVE before, is OLDER than the active one and was active within the
+         * last 7 days (`supervision:rollback`, held only by a WATCHDOG grant; only from a workflow step the grant names).
+         * Compare-and-swap: refused (409 `supervision_rollback_conflict`) unless `expectActive` is the active version.
+         * Other refusals: `supervision_rollback_never_active`, `supervision_rollback_not_older`, `supervision_rollback_too_old`.
+         */
+        rollback(version: number, opts: {
+            expectActive: number;
+        }): Promise<unknown>;
         /**
          * Soft-delete `version` (`supervision:release`; only from a named workflow step). Refused
          * (409 `supervision_version_not_superseded`) unless the version is `superseded` — never the
@@ -788,10 +797,12 @@ export declare interface AgentsApi {
          * Publish workflow `version` (a semver). Compare-and-swap: refused (409 `WORKFLOW_DEPLOY_CONFLICT`, the
          * message names the live version) unless `expectActive` is the workflow's live version ID (null = none live).
          * A deploy also records a new active agent version, so a later `versions.promote` needs a fresh
-         * `expectActive`.
+         * `expectActive`. `commitHash` is the optional source commit the deployed version was built from; it is
+         * forwarded unchanged, and when omitted the platform decides what to record.
          */
         deploy(workflowId: string, version: string, opts: {
             expectActive: string | null;
+            commitHash?: string;
         }): Promise<unknown>;
     };
     persona(agentId: string): {
@@ -825,6 +836,17 @@ export declare interface AgentsApi {
             keys: string[];
         }>;
     };
+    /**
+     * What the agent serves RIGHT NOW (`supervision:observe`): its live skills (each with its tools), the published
+     * persona, its pre/postprocessors and its `model`, read from each primitive's live pointer, never the latest push. Each
+     * `versionId` means what an agent version snapshot's does (skill = semver, processor = version id, persona =
+     * persona version id with the same `contentHash`), so you can diff live against a staged version even when the
+     * agent has no promoted agent version (`activeAgentVersion: null`). `model` is the model the agent runs now (`''`
+     * when unset, as in a snapshot): a promote applies the version's model, so compare it with the snapshot's. Metadata and hashes only: read code with
+     * `source(agentId).get(path)` and persona text with `persona(agentId).versions()`. Platform only: offline
+     * (`lua test` / `lua dev`) it throws `supervision_offline_unsupported`.
+     */
+    deployed(agentId: string): Promise<DeployedPrimitives>;
     /**
      * Supervision events of the target (`supervision:observe`). Each event of a subscribed kind
      * (`governance.blocked`, `workflow.run_failed`, `workflow.run_gated`, `connection.unhealthy`, …)
@@ -1201,6 +1223,12 @@ declare interface AgentToolScope_2 {
     connectionIds?: string[];
     /** Allowlisted skill ids (from the agent's `subAgent.skills`). */
     skillIds?: string[];
+    /**
+     * Allowlisted tool ids, as a workflow agent step's `toolScope.toolIds` declares them. Today the runtime applies
+     * it to device tools only: when it names at least one `device__<device>__<command>` tool, only the named device
+     * tools are offered; otherwise (absent, empty, or no device tool named) device tools are unaffected.
+     */
+    toolIds?: string[];
 }
 
 export declare const AI: AiApi;
@@ -1960,9 +1988,9 @@ export declare const CDN: {
 /**
  * Channel type.
  * Represents the communication channel through which a request originated.
- * Known channels are typed as string literals, unrecognized channels are unknown.
+ * Known channels are typed as string literals; unrecognised channels fall through as plain strings.
  */
-export declare type Channel = 'web' | 'whatsapp' | 'facebook' | 'instagram' | 'slack' | 'teams' | 'front' | 'messagebird' | 'api' | 'dev' | 'email' | string;
+export declare type Channel = 'web' | 'pop' | 'phone' | 'meeting' | 'whatsapp' | 'facebook' | 'instagram' | 'slack' | 'teams' | 'front' | 'messagebird' | 'api' | 'dev' | 'email' | 'rcs' | 'sms' | 'mms' | 'imessage' | 'device' | string;
 
 /** Channels accepted by the v1 unified send. Warm-only channels (teams,
  * instagram, messenger) require a prior inbound conversation. */
@@ -2972,8 +3000,8 @@ export { DatasetRef }
  *     paper_low: {
  *       description: 'Fired when paper level drops below threshold',
  *       payloadSchema: z.object({ level: z.number() }),
- *       execute: async (payload, { agent }) => {
- *         await agent.chat(\`Printer paper low: \${payload.level}%\`);
+ *       execute: async (payload, { device, trigger }) => {
+ *         return { device: device.name, trigger: trigger.name, level: payload.level };
  *       },
  *     },
  *   },
@@ -2998,8 +3026,8 @@ export declare function defineDevice(config: LuaDeviceConfig): LuaDevice;
  *   name: 'paper-low',
  *   description: 'Fired when printer paper drops below threshold',
  *   payloadSchema: z.object({ level: z.number() }),
- *   execute: async (payload, { agent, device }) => {
- *     await agent.chat(\`Printer \${device.name} paper low: \${payload.level}%\`);
+ *   execute: async (payload, { device, trigger }) => {
+ *     return { device: device.name, trigger: trigger.name, level: payload.level };
  *   },
  * });
  * ```
@@ -3193,6 +3221,69 @@ export declare interface DeliveryView {
     failedAt?: string;
 }
 
+declare interface DeployedPersona {
+    versionId: string;
+    version?: number;
+    /** The same hash an agent version snapshot stores for its persona. */
+    contentHash: string;
+}
+
+/**
+ * SV (LUA-1080) — `primitives.deployed` / `Agents.deployed(id)`: the target's CURRENTLY DEPLOYED primitives, read from
+ * each primitive's live pointer (never the latest push). An agent whose live state was deployed primitive by
+ * primitive, with no promoted agent version, answers the same shape, so a supervisor can diff it against a staged
+ * version.
+ *
+ * `versionId` follows the agent version snapshot's semantics entry by entry: a skill's is its semver, a processor's
+ * the version document id, the persona's the PersonaVersion id with the same `contentHash`. Never code, tool source
+ * or persona text: read those with `source.get` and `persona.versions`.
+ */
+declare interface DeployedPrimitives {
+    agentId: string;
+    /** The promoted (`active`) agent version, or null when the live state is not a promoted version. */
+    activeAgentVersion: number | null;
+    /**
+     * The model the agent runs now (`SubAgent.model`), with the agent version snapshot's meaning: a promote writes
+     * `snapshot.model` here, and an unset model reads `''` as it does in a snapshot, so `model === snapshot.model`
+     * holds exactly when the release would leave the model unchanged.
+     */
+    model: string;
+    skills: DeployedSkill[];
+    /** The served (`published`) persona, or null when none is published. */
+    persona: DeployedPersona | null;
+    preprocessors: DeployedProcessor[];
+    postprocessors: DeployedProcessor[];
+}
+
+declare interface DeployedProcessor {
+    id: string;
+    name?: string;
+    /** The live version document id (`activeVersionId`). */
+    versionId: string;
+    version: string;
+    codeHash?: string;
+}
+
+declare interface DeployedSkill {
+    skillId: string;
+    name?: string;
+    /** The live semver (`Skills.activeVersionId`), as an agent version snapshot pins it. */
+    versionId: string;
+    version: string;
+    /** Where the skill came from: `cli`, `marketplace`, `manual` or `template`. */
+    origin?: string;
+    /** The deployed version's tools. Equal skill `versionId` ⇒ equal tools. */
+    tools: DeployedTool[];
+}
+
+declare interface DeployedTool {
+    name: string;
+    /** The uploaded bundle's content hash, when the version stores one. */
+    codeHash?: string;
+    /** Whether the author's TypeScript source is attached to this version. */
+    hasSource: boolean;
+}
+
 declare type Depth = [never, 0, 1, 2, 3, 4];
 
 /** Configuration for a single device command (agent → device) */
@@ -3218,13 +3309,20 @@ export declare interface DeviceTriggerConfig {
     payloadSchema?: ZodType;
     /**
      * Handler that runs on lua-core when the device fires this trigger.
-     * Has full access to agent context (can call agent.chat(), use tools, etc.)
+     * Receives `(payload, { device, trigger })`; the returned value is the trigger result.
      */
-    execute?: (payload: any, context: {
-        agent: any;
-        device: any;
-        trigger: any;
-    }) => Promise<any>;
+    execute?: (payload: any, context: DeviceTriggerContext) => Promise<any>;
+}
+
+/** Context a device-trigger handler receives; mirrors what lua-core (execute.device-trigger.service.ts) and sandbox-runtime (wrapper-templates.ts) pass. */
+export declare interface DeviceTriggerContext {
+    device: {
+        name: string;
+    };
+    trigger: {
+        name: string;
+        triggerId: string;
+    };
 }
 
 /** A matched org member and their shareable channel targets (empty when none shared). */
@@ -5030,8 +5128,8 @@ export declare class LuaDevice {
  *     paper_low: {
  *       description: 'Fired when paper level drops below threshold',
  *       payloadSchema: z.object({ level: z.number(), threshold: z.number() }),
- *       execute: async (payload, { agent }) => {
- *         await agent.chat(\`Printer paper low: \${payload.level}%\`);
+ *       execute: async (payload, { device, trigger }) => {
+ *         return { device: device.name, trigger: trigger.name, level: payload.level };
  *       },
  *     },
  *   },
@@ -5063,12 +5161,7 @@ export declare class LuaDeviceTrigger {
     readonly name: string;
     readonly description: string;
     readonly payloadSchema?: ZodType;
-    readonly execute: (payload: any, context: {
-        agent: any;
-        device: {
-            name: string;
-        };
-    }) => Promise<any>;
+    readonly execute: (payload: any, context: DeviceTriggerContext) => Promise<any>;
     constructor(config: LuaDeviceTriggerConfig);
 }
 
@@ -5089,8 +5182,8 @@ export declare class LuaDeviceTrigger {
  *   name: 'paper-low',
  *   description: 'Fired when printer paper drops below threshold',
  *   payloadSchema: z.object({ level: z.number() }),
- *   execute: async (payload, { agent, device }) => {
- *     await agent.chat(`Printer ${device.name} paper low: ${payload.level}%`);
+ *   execute: async (payload, { device, trigger }) => {
+ *     return { device: device.name, trigger: trigger.name, level: payload.level };
  *   },
  * });
  * ```
@@ -5103,12 +5196,7 @@ export declare interface LuaDeviceTriggerConfig {
     /** Zod schema for trigger payload validation */
     payloadSchema?: ZodType;
     /** Function that executes when the trigger fires */
-    execute: (payload: any, context: {
-        agent: any;
-        device: {
-            name: string;
-        };
-    }) => Promise<any>;
+    execute: (payload: any, context: DeviceTriggerContext) => Promise<any>;
 }
 
 /**
@@ -5859,14 +5947,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }, {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -5925,14 +6013,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }, {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -5991,14 +6079,14 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
          */
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }, {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"realtime">;
@@ -6183,9 +6271,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6199,9 +6287,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6214,9 +6302,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6277,9 +6365,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6293,9 +6381,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6308,9 +6396,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6371,9 +6459,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6387,9 +6475,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6402,9 +6490,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6465,9 +6553,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6481,9 +6569,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6496,9 +6584,9 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
         model?: string;
         options?: Record<string, unknown>;
     } | {
+        class?: "LLM" | "STT" | "STTv2" | "TTS";
         kind?: "plugin";
         provider?: "deepgram" | "elevenlabs";
-        class?: "LLM" | "STT" | "STTv2" | "TTS";
         options?: Record<string, unknown>;
     } | {
         kind?: "realtime";
@@ -6954,7 +7042,11 @@ export declare type LuaWorkflowBuildCode = 'duplicate-step-id' | 'unknown-step-r
 */
 | 'approval-inside-container' | 'node-type-unsupported-in-container' | 'empty-graph' | 'ephemeral-role-too-long' | 'role-ref-and-inline' | 'approver-excludes-only-candidate' | 'four-eyes-requires-editable' | 'escalation-chain-not-terminal' | 'escalation-chain-too-long'
 /** LUA-973: `remindAfterHours` is not a number of hours in 1..720 (`validateApprovalReminder`). */
-| 'remind-after-invalid' | 'editable-path-invalid' | 'env-template-secret-key' | 'invalid-envelope' | 'invalid-step' | 'invalid-step-id' | 'invalid-workflow-name' | 'schedule-input-required' | 'schedule-input-invalid' | 'hitl-duration-defaulted' | 'WORKFLOW_UNPLACED_STEP';
+| 'remind-after-invalid'
+/** BAC-2062: the builder mirror of the BAC-619 validator codes: a `waitForSignal` name a delivery refuses. */
+| 'signal-name-invalid'
+/** BAC-2062: a numeric approval / waitForSignal `timeoutHours` outside 1..720. */
+| 'timeout-hours-out-of-range' | 'editable-path-invalid' | 'env-template-secret-key' | 'invalid-envelope' | 'invalid-step' | 'invalid-step-id' | 'invalid-workflow-name' | 'schedule-input-required' | 'schedule-input-invalid' | 'hitl-duration-defaulted' | 'WORKFLOW_UNPLACED_STEP';
 
 export declare interface LuaWorkflowBuilder {
     then(step: StepRef): this;
@@ -10783,9 +10875,6 @@ export declare const Workflows: WorkflowsApi;
  *
  * - `start` options are checked: an option key it does not know throws
  *   `WorkflowApiError{ code:'VALIDATION_FAILED' }` naming it — never silently dropped.
- *
- * `startBatch`, `signalByKey`, `raiseBudget`, `setGoal` and `goals.*` are part of the
- * frozen member list and throw `WORKFLOWS_API_UNAVAILABLE` until their routes ship.
  */
 export declare interface WorkflowsApi {
     start(nameOrId: string, input?: unknown, opts?: {
@@ -10883,6 +10972,11 @@ export declare interface WorkflowsApi {
             code?: string;
         }>;
     }>;
+    /**
+     * Raise a parked or in-flight run's caps (increases only). Only the run's creator/holder or an
+     * org admin may raise it. Refusals are typed `WorkflowApiError`s: 400 `VALIDATION_FAILED` /
+     * `CAP_EXCEEDED`, 403 `NOT_RUN_CREATOR`, 404 `RUN_NOT_FOUND`, 409 `BUDGET_NOT_RAISABLE`.
+     */
     raiseBudget(runId: string, patch: {
         maxCredits?: number;
         maxSteps?: number;
@@ -10897,6 +10991,7 @@ export declare interface WorkflowsApi {
     } | {
         raised: false;
         reason: 'already_raised';
+        runStatus?: WorkflowRunStatus;
     }>;
     setGoal(agentId: string, goal: Record<string, unknown>): Promise<Record<string, unknown>>;
     goals: {