lua-cli 3.52.0 → 3.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (21) hide show
  1. package/dist/api-exports.d.ts +99 -19
  2. package/dist/api-exports.js +543 -83
  3. package/dist/api-exports.js.map +1 -1
  4. package/dist/index.js +2650 -795
  5. package/dist/index.js.map +1 -1
  6. package/dist/voice/test/index.d.ts +37 -18
  7. package/dist/workflow-builder.d.ts +19 -0
  8. package/dist/workflow-builder.js +491 -58
  9. package/dist/workflow-builder.js.map +1 -1
  10. package/docs/API_REFERENCE.md +23 -0
  11. package/docs/CLI_REFERENCE.md +14 -0
  12. package/docs/README.md +3 -3
  13. package/docs/api/LuaTool.md +124 -82
  14. package/docs/api/LuaWebhook.md +1 -1
  15. package/package.json +1 -1
  16. package/template/README.md +2 -0
  17. package/template/package.json +1 -1
  18. package/template-web-app/app.ts +5 -0
  19. package/template-web-app/web/package.json +3 -2
  20. package/template-web-app/web/src/index.css +2 -0
  21. package/template-web-app/web/src/main.tsx +5 -1
package/dist/voice/test/index.d.ts CHANGED
@@ -64,6 +64,25 @@ declare interface LuaTool<TInput extends ZodType = ZodType> {
64
64
  name: string;
65
65
  /** Description of what the tool does */
66
66
  description: string;
67
+ /**
68
+ * Optional text the chat shows to the user while this tool runs and after it
69
+ * finishes, instead of the tool's name. Either one text for both moments, or
70
+ * one for each:
71
+ *
72
+ * ```ts
73
+ * label = { running: 'Creating a ticket for {subject}', done: 'Created a ticket for {subject}' };
74
+ * label = 'Checked stock';
75
+ * ```
76
+ *
77
+ * `{argName}` is replaced with that argument's value from the call (string
78
+ * and number arguments only). Don't end the text with "…": the chat adds it
79
+ * while the tool runs. Each text is a string literal (or a const holding one)
80
+ * of at most 80 characters; `lua compile` ignores a computed label.
81
+ */
82
+ label?: string | {
83
+ running: string;
84
+ done: string;
85
+ };
67
86
  /** Zod schema for input validation */
68
87
  inputSchema: TInput;
69
88
  /**
@@ -255,15 +274,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
255
274
  */
256
275
  options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
257
276
  }, "strip", z.ZodTypeAny, {
277
+ class: "LLM" | "STT" | "STTv2" | "TTS";
258
278
  options: Record<string, unknown>;
259
279
  provider: "deepgram" | "elevenlabs";
260
280
  kind: "plugin";
261
- class: "LLM" | "STT" | "STTv2" | "TTS";
262
281
  }, {
282
+ class: "LLM" | "STT" | "STTv2" | "TTS";
263
283
  options: Record<string, unknown>;
264
284
  provider: "deepgram" | "elevenlabs";
265
285
  kind: "plugin";
266
- class: "LLM" | "STT" | "STTv2" | "TTS";
267
286
  }>, z.ZodObject<{
268
287
  kind: z.ZodLiteral<"realtime">;
269
288
  provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -321,15 +340,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
321
340
  */
322
341
  options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
323
342
  }, "strip", z.ZodTypeAny, {
343
+ class: "LLM" | "STT" | "STTv2" | "TTS";
324
344
  options: Record<string, unknown>;
325
345
  provider: "deepgram" | "elevenlabs";
326
346
  kind: "plugin";
327
- class: "LLM" | "STT" | "STTv2" | "TTS";
328
347
  }, {
348
+ class: "LLM" | "STT" | "STTv2" | "TTS";
329
349
  options: Record<string, unknown>;
330
350
  provider: "deepgram" | "elevenlabs";
331
351
  kind: "plugin";
332
- class: "LLM" | "STT" | "STTv2" | "TTS";
333
352
  }>, z.ZodObject<{
334
353
  kind: z.ZodLiteral<"realtime">;
335
354
  provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -387,15 +406,15 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
387
406
  */
388
407
  options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
389
408
  }, "strip", z.ZodTypeAny, {
409
+ class: "LLM" | "STT" | "STTv2" | "TTS";
390
410
  options: Record<string, unknown>;
391
411
  provider: "deepgram" | "elevenlabs";
392
412
  kind: "plugin";
393
- class: "LLM" | "STT" | "STTv2" | "TTS";
394
413
  }, {
414
+ class: "LLM" | "STT" | "STTv2" | "TTS";
395
415
  options: Record<string, unknown>;
396
416
  provider: "deepgram" | "elevenlabs";
397
417
  kind: "plugin";
398
- class: "LLM" | "STT" | "STTv2" | "TTS";
399
418
  }>, z.ZodObject<{
400
419
  kind: z.ZodLiteral<"realtime">;
401
420
  provider: z.ZodEnum<["openai", "google", "xai"]>;
@@ -577,10 +596,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
577
596
  voice?: string | undefined;
578
597
  options?: Record<string, unknown> | undefined;
579
598
  } | {
599
+ class: "LLM" | "STT" | "STTv2" | "TTS";
580
600
  options: Record<string, unknown>;
581
601
  provider: "deepgram" | "elevenlabs";
582
602
  kind: "plugin";
583
- class: "LLM" | "STT" | "STTv2" | "TTS";
584
603
  } | {
585
604
  options: Record<string, unknown>;
586
605
  provider: "openai" | "google" | "xai";
@@ -594,10 +613,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
594
613
  voice?: string | undefined;
595
614
  options?: Record<string, unknown> | undefined;
596
615
  } | {
616
+ class: "LLM" | "STT" | "STTv2" | "TTS";
597
617
  options: Record<string, unknown>;
598
618
  provider: "deepgram" | "elevenlabs";
599
619
  kind: "plugin";
600
- class: "LLM" | "STT" | "STTv2" | "TTS";
601
620
  } | {
602
621
  options: Record<string, unknown>;
603
622
  provider: "openai" | "google" | "xai";
@@ -610,10 +629,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
610
629
  voice?: string | undefined;
611
630
  options?: Record<string, unknown> | undefined;
612
631
  } | {
632
+ class: "LLM" | "STT" | "STTv2" | "TTS";
613
633
  options: Record<string, unknown>;
614
634
  provider: "deepgram" | "elevenlabs";
615
635
  kind: "plugin";
616
- class: "LLM" | "STT" | "STTv2" | "TTS";
617
636
  } | {
618
637
  options: Record<string, unknown>;
619
638
  provider: "openai" | "google" | "xai";
@@ -671,10 +690,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
671
690
  voice?: string | undefined;
672
691
  options?: Record<string, unknown> | undefined;
673
692
  } | {
693
+ class: "LLM" | "STT" | "STTv2" | "TTS";
674
694
  options: Record<string, unknown>;
675
695
  provider: "deepgram" | "elevenlabs";
676
696
  kind: "plugin";
677
- class: "LLM" | "STT" | "STTv2" | "TTS";
678
697
  } | {
679
698
  options: Record<string, unknown>;
680
699
  provider: "openai" | "google" | "xai";
@@ -688,10 +707,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
688
707
  voice?: string | undefined;
689
708
  options?: Record<string, unknown> | undefined;
690
709
  } | {
710
+ class: "LLM" | "STT" | "STTv2" | "TTS";
691
711
  options: Record<string, unknown>;
692
712
  provider: "deepgram" | "elevenlabs";
693
713
  kind: "plugin";
694
- class: "LLM" | "STT" | "STTv2" | "TTS";
695
714
  } | {
696
715
  options: Record<string, unknown>;
697
716
  provider: "openai" | "google" | "xai";
@@ -704,10 +723,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
704
723
  voice?: string | undefined;
705
724
  options?: Record<string, unknown> | undefined;
706
725
  } | {
726
+ class: "LLM" | "STT" | "STTv2" | "TTS";
707
727
  options: Record<string, unknown>;
708
728
  provider: "deepgram" | "elevenlabs";
709
729
  kind: "plugin";
710
- class: "LLM" | "STT" | "STTv2" | "TTS";
711
730
  } | {
712
731
  options: Record<string, unknown>;
713
732
  provider: "openai" | "google" | "xai";
@@ -765,10 +784,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
765
784
  voice?: string | undefined;
766
785
  options?: Record<string, unknown> | undefined;
767
786
  } | {
787
+ class: "LLM" | "STT" | "STTv2" | "TTS";
768
788
  options: Record<string, unknown>;
769
789
  provider: "deepgram" | "elevenlabs";
770
790
  kind: "plugin";
771
- class: "LLM" | "STT" | "STTv2" | "TTS";
772
791
  } | {
773
792
  options: Record<string, unknown>;
774
793
  provider: "openai" | "google" | "xai";
@@ -782,10 +801,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
782
801
  voice?: string | undefined;
783
802
  options?: Record<string, unknown> | undefined;
784
803
  } | {
804
+ class: "LLM" | "STT" | "STTv2" | "TTS";
785
805
  options: Record<string, unknown>;
786
806
  provider: "deepgram" | "elevenlabs";
787
807
  kind: "plugin";
788
- class: "LLM" | "STT" | "STTv2" | "TTS";
789
808
  } | {
790
809
  options: Record<string, unknown>;
791
810
  provider: "openai" | "google" | "xai";
@@ -798,10 +817,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
798
817
  voice?: string | undefined;
799
818
  options?: Record<string, unknown> | undefined;
800
819
  } | {
820
+ class: "LLM" | "STT" | "STTv2" | "TTS";
801
821
  options: Record<string, unknown>;
802
822
  provider: "deepgram" | "elevenlabs";
803
823
  kind: "plugin";
804
- class: "LLM" | "STT" | "STTv2" | "TTS";
805
824
  } | {
806
825
  options: Record<string, unknown>;
807
826
  provider: "openai" | "google" | "xai";
@@ -859,10 +878,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
859
878
  voice?: string | undefined;
860
879
  options?: Record<string, unknown> | undefined;
861
880
  } | {
881
+ class: "LLM" | "STT" | "STTv2" | "TTS";
862
882
  options: Record<string, unknown>;
863
883
  provider: "deepgram" | "elevenlabs";
864
884
  kind: "plugin";
865
- class: "LLM" | "STT" | "STTv2" | "TTS";
866
885
  } | {
867
886
  options: Record<string, unknown>;
868
887
  provider: "openai" | "google" | "xai";
@@ -876,10 +895,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
876
895
  voice?: string | undefined;
877
896
  options?: Record<string, unknown> | undefined;
878
897
  } | {
898
+ class: "LLM" | "STT" | "STTv2" | "TTS";
879
899
  options: Record<string, unknown>;
880
900
  provider: "deepgram" | "elevenlabs";
881
901
  kind: "plugin";
882
- class: "LLM" | "STT" | "STTv2" | "TTS";
883
902
  } | {
884
903
  options: Record<string, unknown>;
885
904
  provider: "openai" | "google" | "xai";
@@ -892,10 +911,10 @@ declare const LuaVoiceConfigSchema: z.ZodEffects<z.ZodObject<{
892
911
  voice?: string | undefined;
893
912
  options?: Record<string, unknown> | undefined;
894
913
  } | {
914
+ class: "LLM" | "STT" | "STTv2" | "TTS";
895
915
  options: Record<string, unknown>;
896
916
  provider: "deepgram" | "elevenlabs";
897
917
  kind: "plugin";
898
- class: "LLM" | "STT" | "STTv2" | "TTS";
899
918
  } | {
900
919
  options: Record<string, unknown>;
901
920
  provider: "openai" | "google" | "xai";
package/dist/workflow-builder.d.ts CHANGED
@@ -276,6 +276,25 @@ declare interface LuaTool<TInput extends ZodType = ZodType> {
276
276
  name: string;
277
277
  /** Description of what the tool does */
278
278
  description: string;
279
+ /**
280
+ * Optional text the chat shows to the user while this tool runs and after it
281
+ * finishes, instead of the tool's name. Either one text for both moments, or
282
+ * one for each:
283
+ *
284
+ * ```ts
285
+ * label = { running: 'Creating a ticket for {subject}', done: 'Created a ticket for {subject}' };
286
+ * label = 'Checked stock';
287
+ * ```
288
+ *
289
+ * `{argName}` is replaced with that argument's value from the call (string
290
+ * and number arguments only). Don't end the text with "…": the chat adds it
291
+ * while the tool runs. Each text is a string literal (or a const holding one)
292
+ * of at most 80 characters; `lua compile` ignores a computed label.
293
+ */
294
+ label?: string | {
295
+ running: string;
296
+ done: string;
297
+ };
279
298
  /** Zod schema for input validation */
280
299
  inputSchema: TInput;
281
300
  /**