lua-cli 3.14.0 → 3.15.0

package/node_modules/@lua/shared-types/src/persona-text.type.ts

@@ -0,0 +1,92 @@
+/**
+ * Polymorphic shape used by `LuaAgent.persona`. String form is the legacy
+ * single-channel persona; object form lets the customer split prose per
+ * channel (`base` always rendered; `voice` appended on voice; `text`
+ * appended on text channels).
+ */
+export type PersonaText = string | { base?: string; voice?: string; text?: string };
+
+/**
+ * Same shape as `PersonaText`, exported separately because skill `context`
+ * and agent `persona` play different semantic roles. Sharing the structural
+ * shape today keeps the runtime lean; future divergence is a one-line change.
+ */
+export type SkillContextText = string | { base?: string; voice?: string; text?: string };
+
+export function isPersonaTextObject(value: unknown): value is { base?: string; voice?: string; text?: string } {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;
+  const obj = value as Record<string, unknown>;
+  for (const k of Object.keys(obj)) {
+    if (k !== 'base' && k !== 'voice' && k !== 'text') return false;
+    if (obj[k] !== undefined && typeof obj[k] !== 'string') return false;
+  }
+  return true;
+}
+
+/**
+ * Flatten `PersonaText` or `SkillContextText` to a plain string suitable for
+ * LLM prompt injection. `base` is always emitted; `voice` is appended on
+ * voice channels and `text` on text channels. Strict — missing channel keys
+ * render nothing (no cross-channel fallback).
+ */
+export function flattenPersonaText(input: PersonaText | SkillContextText | null | undefined, isVoice = false): string {
+  if (input == null) return '';
+  if (typeof input === 'string') return input;
+  const parts: string[] = [];
+  if (input.base) parts.push(input.base);
+  const channelText = isVoice ? input.voice : input.text;
+  if (channelText) parts.push(channelText);
+  return parts.join('\n\n');
+}
+
+/**
+ * Channel-agnostic flatten — concatenates every non-empty channel's content
+ * (base + voice + text) for paths that aren't a render-time prompt injection,
+ * e.g. AI persona enhancement (storytelling, instructions, website-derived).
+ * Use this whenever the call has no channel context but still wants the full
+ * persona content — `flattenPersonaText` would silently drop voice or text
+ * branches because it defaults to text-channel rendering.
+ */
+export function flattenPersonaTextAll(input: PersonaText | SkillContextText | null | undefined): string {
+  if (input == null) return '';
+  if (typeof input === 'string') return input;
+  const parts: string[] = [];
+  if (input.base) parts.push(input.base);
+  if (input.voice) parts.push(input.voice);
+  if (input.text) parts.push(input.text);
+  return parts.join('\n\n');
+}
+
+/**
+ * True when the persona has ANY non-empty content on any channel. Used at
+ * push/skip boundaries where channel context is not yet known.
+ */
+export function hasPersonaTextContent(input: PersonaText | SkillContextText | null | undefined): boolean {
+  if (input == null) return false;
+  if (typeof input === 'string') return input.trim().length > 0;
+  return Boolean(input.base?.trim() || input.voice?.trim() || input.text?.trim());
+}
+
+/**
+ * Convert a PersonaText into a TypeScript source-code literal suitable
+ * for ts-morph setInitializer or template rendering.
+ *
+ * - String form → `"..."` (double-quoted) or template literal (when newlines present)
+ * - Object form → `{ base: ..., voice: ..., text: ... }` with same per-key rule
+ */
+export function personaToLiteral(persona: PersonaText): string {
+  const formatValue = (v: string): string => {
+    if (v.includes('\n')) {
+      return '`' + v.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$/g, '\\$') + '`';
+    }
+    return '"' + v.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+  };
+
+  if (typeof persona === 'string') return formatValue(persona);
+
+  const parts: string[] = [];
+  if (persona.base !== undefined) parts.push(`base: ${formatValue(persona.base)}`);
+  if (persona.voice !== undefined) parts.push(`voice: ${formatValue(persona.voice)}`);
+  if (persona.text !== undefined) parts.push(`text: ${formatValue(persona.text)}`);
+  return `{ ${parts.join(', ')} }`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.14.0",
+  "version": "3.15.0",
   "description": "Build, test, and deploy AI agents with custom tools, webhooks, and scheduled jobs. Features LuaAgent unified configuration, streaming chat, and batch deployment.",
   "readmeFilename": "README.md",
   "main": "dist/api-exports.js",

package/template/package.json

@@ -20,7 +20,7 @@
     "inquirer": "^12.9.6",
     "stripe": "^17.5.0",
     "js-yaml": "^4.1.0",
-    "lua-cli": "^3.14.0",
+    "lua-cli": "^3.15.0",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"