@lotics/cli 0.43.0 → 0.44.1

package/dist/app_commands.d.ts

@@ -1,15 +1,18 @@
 import { LoticsClient } from "./client.js";
 /**
  * Manifest declaration for one workflow alias:
- *   `"alias": { workflow_id, inputs?: { key: { type, … } } }`
+ *   `"alias": { workflow_id, inputs?: { key: { type, … } }, outputs?: { key: { type, … } } }`
  *
  * When `inputs` is declared, the CLI codegen emits a typed `AppWorkflows[alias]`
- * entry and the server validates payloads against it at execute time. Omit
- * `inputs` for workflows that accept no typed inputs.
+ * entry and the server validates payloads against it at execute time. When
+ * `outputs` is declared, codegen emits a typed `AppWorkflowResults[alias]` so the
+ * app reads a typed `result.data`. Omit either for workflows that take no typed
+ * inputs / return no structured data.
  */
 export type AppWorkflowDeclaration = {
     workflow_id: string;
     inputs?: Record<string, unknown>;
+    outputs?: Record<string, unknown>;
 };
 /**
  * Manifest declaration for one named query:

package/dist/generate_app_workflows_dts.d.ts

@@ -27,4 +27,11 @@ export declare function generateAppWorkflowsDts(workflows: Record<string, AppWor
  * catches structurally-invalid declarations before they reach us.
  */
 export declare function inputsToType(inputs: Record<string, unknown>): string;
+/**
+ * Map an output `fields` map (also the top-level `outputs`) to a TS object type.
+ * Mirrors the backend `outputObjectToTsType`; recursive for nested object/array.
+ * Zero-dep like `inputsToType` — pattern-matches on `type`, falls through to
+ * `unknown` for shapes the server's schema parse rejects before we see them.
+ */
+export declare function objectFieldsToType(fields: Record<string, unknown>): string;
 export declare function isValidIdentifier(name: string): boolean;

package/dist/generate_app_workflows_dts.js

@@ -34,22 +34,32 @@ declare module "@lotics/app-sdk" {
     }
     // Sort alphabetically for deterministic output across regenerations.
     entries.sort(([a], [b]) => a.localeCompare(b));
-    const lines = [];
+    const inputLines = [];
+    const resultLines = [];
     for (const [alias, declaration] of entries) {
-        // declaration is always `{ workflow_id, inputs? }` per manifest schema.
-        // Workflows with no typed inputs omit `inputs:` and get an untyped
-        // `Record<string, unknown>` callable surface.
+        // declaration is `{ workflow_id, inputs?, outputs? }` per manifest schema.
+        // No typed inputs ⇒ untyped `Record<string, unknown>` callable. An alias with
+        // declared `outputs` also gets an `AppWorkflowResults` entry → typed result.data.
         const valueType = declaration.inputs
             ? inputsToType(declaration.inputs)
             : "Record<string, unknown>";
         const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
-        lines.push(`    ${aliasKey}: ${valueType};`);
+        inputLines.push(`    ${aliasKey}: ${valueType};`);
+        if (declaration.outputs) {
+            resultLines.push(`    ${aliasKey}: ${objectFieldsToType(declaration.outputs)};`);
+        }
     }
+    const resultsBlock = resultLines.length > 0
+        ? `
+  interface AppWorkflowResults {
+${resultLines.join("\n")}
+  }`
+        : "";
     return `${HEADER}
 declare module "@lotics/app-sdk" {
   interface AppWorkflows {
-${lines.join("\n")}
-  }
+${inputLines.join("\n")}
+  }${resultsBlock}
 }
 `;
 }
@@ -119,6 +129,68 @@ function inputDeclToTsType(decl) {
             return "unknown";
     }
 }
+/**
+ * Map an output `fields` map (also the top-level `outputs`) to a TS object type.
+ * Mirrors the backend `outputObjectToTsType`; recursive for nested object/array.
+ * Zero-dep like `inputsToType` — pattern-matches on `type`, falls through to
+ * `unknown` for shapes the server's schema parse rejects before we see them.
+ */
+export function objectFieldsToType(fields) {
+    const parts = [];
+    for (const [key, decl] of Object.entries(fields)) {
+        if (decl === null || typeof decl !== "object")
+            continue;
+        const d = decl;
+        const optional = d.required === false ? "?" : "";
+        const fieldKey = isValidIdentifier(key) ? key : JSON.stringify(key);
+        parts.push(`${fieldKey}${optional}: ${outputDeclToTsType(d)}`);
+    }
+    if (parts.length === 0)
+        return "Record<string, never>";
+    return `{ ${parts.join("; ")} }`;
+}
+function outputDeclToTsType(decl) {
+    const type = decl.type;
+    switch (type) {
+        case "text":
+        case "email":
+        case "date":
+        case "datetime":
+            return "string";
+        case "number":
+            return "number";
+        case "boolean":
+            return "boolean";
+        case "record_link":
+            return decl.multi === true ? "ReadonlyArray<string>" : "string";
+        case "select": {
+            const options = Array.isArray(decl.options) ? decl.options : [];
+            const literals = options
+                .map((o) => o !== null && typeof o === "object" && "value" in o && typeof o.value === "string"
+                ? JSON.stringify(o.value)
+                : null)
+                .filter((v) => v !== null);
+            const inner = literals.length > 0 ? literals.join(" | ") : "string";
+            return decl.multi === true ? `ReadonlyArray<${inner}>` : inner;
+        }
+        case "object": {
+            const fields = decl.fields !== null && typeof decl.fields === "object"
+                ? decl.fields
+                : {};
+            return objectFieldsToType(fields);
+        }
+        case "array": {
+            const items = decl.items !== null && typeof decl.items === "object"
+                ? decl.items
+                : null;
+            return items ? `ReadonlyArray<${outputDeclToTsType(items)}>` : "ReadonlyArray<unknown>";
+        }
+        case "json":
+            return "unknown";
+        default:
+            return "unknown";
+    }
+}
 const IDENTIFIER_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 export function isValidIdentifier(name) {
     return IDENTIFIER_REGEX.test(name);

package/dist/generate_app_workflows_dts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/generate_app_workflows_dts.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { generateAppWorkflowsDts } from "./generate_app_workflows_dts.js";
+describe("generateAppWorkflowsDts", () => {
+    it("emits no AppWorkflowResults block when no alias declares outputs", () => {
+        const dts = generateAppWorkflowsDts({
+            issue: { workflow_id: "wfl_1", inputs: { record_id: { type: "text" } } },
+        });
+        expect(dts).toContain("interface AppWorkflows {");
+        expect(dts).toContain("issue: {\n      record_id: string;\n    };");
+        expect(dts).not.toContain("AppWorkflowResults");
+    });
+    it("emits a typed AppWorkflowResults entry for an alias with a nested outputs schema", () => {
+        const dts = generateAppWorkflowsDts({
+            computeQuote: {
+                workflow_id: "wfl_2",
+                outputs: {
+                    total: { type: "number" },
+                    note: { type: "text", required: false },
+                    lines: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            fields: { name: { type: "text" }, amount: { type: "number" } },
+                        },
+                    },
+                },
+            },
+        });
+        expect(dts).toContain("interface AppWorkflowResults {");
+        // Nested array-of-object + optional field render correctly.
+        expect(dts).toContain("computeQuote: { total: number; note?: string; lines: ReadonlyArray<{ name: string; amount: number }> };");
+        // No declared inputs → untyped callable in AppWorkflows.
+        expect(dts).toContain("computeQuote: Record<string, unknown>;");
+    });
+    it("maps record_link/select outputs the same way as inputs", () => {
+        const dts = generateAppWorkflowsDts({
+            lookup: {
+                workflow_id: "wfl_3",
+                outputs: {
+                    owner: { type: "record_link", table_id: "tbl_x" },
+                    tags: { type: "select", options: [{ label: "A", value: "a" }, { label: "B", value: "b" }], multi: true },
+                },
+            },
+        });
+        expect(dts).toContain('owner: string; tags: ReadonlyArray<"a" | "b">');
+    });
+});

package/dist/src/cli.js

@@ -30179,7 +30179,7 @@ import { spawn as spawn2 } from "node:child_process";
 import { tmpdir } from "node:os";
 
 // src/starter_template.ts
-var STARTER_FALLBACK_UI_VERSION = "1.8.0";
+var STARTER_FALLBACK_UI_VERSION = "2.0.0";
 var STARTER_FALLBACK_SDK_VERSION = "0.11.0";
 var STARTER_REACT_NATIVE_VERSION = "0.85.3";
 function buildStarterTemplate(args) {
@@ -30322,13 +30322,14 @@ export default defineConfig({
     dedupe: ["react", "react-dom", "react-native-web"],
   },
   optimizeDeps: {
-    // \`recharts\` (used by @lotics/ui chart_* + sparkline) imports
-    // \`es-toolkit/compat/get\` as a default-export CJS module. Vite's dev
-    // server treats \`compat/*\` as ESM and won't synthesize a default,
-    // so \`import get from "es-toolkit/compat/get"\` fails to resolve.
-    // Pre-bundling forces Vite to convert it to an ESM shim with a default
-    // export. Production build (rollup) handles it correctly without this.
-    include: ["recharts", "es-toolkit", "es-toolkit/compat"],
+    // Force-prebundle react-native-web: it does \`import normalizeColor from
+    // "@react-native/normalize-colors"\` (a nested CJS module). Un-prebundled,
+    // Vite's dev server serves that as ESM with no default export \u2192 "does not
+    // provide an export named 'default'" and a blank iframe the moment a
+    // colour-touching RN-Web component (DatePicker, Picker) mounts under
+    // \`lotics app dev\`. Prebundling folds its CJS deps into one interop'd chunk.
+    // The rollup build handles the interop on its own, so this is dev-only.
+    include: ["react-native-web"],
     // The dep optimizer pre-bundles deps with a SEPARATE esbuild pass that
     // top-level \`define\` doesn't always reach, so a pre-bundled RN dep can
     // still hit \`__DEV__ is not defined\` under \`lotics app dev\`. Define it
@@ -30359,6 +30360,25 @@ export default defineConfig({
   },
   test: {
     environment: "jsdom",
+    // RN packages ship Flow (\`import typeof\`) in their native source, reached
+    // transitively by RN-Web components (pickers, calendars, anything touching
+    // Animated). Vitest's web optimizer is OFF by default and ignores the
+    // \`optimizeDeps.resolveExtensions\` above, so it pre-bundles the native
+    // \`.js\` / \`src\` Flow files and esbuild can't parse them. Enable it with the
+    // same \`.web.js\`-first resolution so it bundles the compiled web variants
+    // (Picker.web.js, RN-Web dist) \u2014 without this, any test that renders a tree
+    // pulling a Picker / DatePicker fails with "Unexpected token 'typeof'".
+    deps: {
+      optimizer: {
+        web: {
+          enabled: true,
+          include: ["react-native", "react-native-web", "@react-native-picker/picker"],
+          esbuildOptions: {
+            resolveExtensions: [".web.tsx", ".web.ts", ".web.js", ".tsx", ".ts", ".jsx", ".js", ".json"],
+          },
+        },
+      },
+    },
   },
 });
 `
@@ -31085,17 +31105,25 @@ declare module "@lotics/app-sdk" {
 `;
   }
   entries.sort(([a], [b]) => a.localeCompare(b));
-  const lines = [];
+  const inputLines = [];
+  const resultLines = [];
   for (const [alias, declaration] of entries) {
     const valueType = declaration.inputs ? inputsToType(declaration.inputs) : "Record<string, unknown>";
     const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
-    lines.push(`    ${aliasKey}: ${valueType};`);
+    inputLines.push(`    ${aliasKey}: ${valueType};`);
+    if (declaration.outputs) {
+      resultLines.push(`    ${aliasKey}: ${objectFieldsToType(declaration.outputs)};`);
+    }
   }
+  const resultsBlock = resultLines.length > 0 ? `
+  interface AppWorkflowResults {
+${resultLines.join("\n")}
+  }` : "";
   return `${HEADER}
 declare module "@lotics/app-sdk" {
   interface AppWorkflows {
-${lines.join("\n")}
-  }
+${inputLines.join("\n")}
+  }${resultsBlock}
 }
 `;
 }
@@ -31152,6 +31180,54 @@ function inputDeclToTsType(decl) {
       return "unknown";
   }
 }
+function objectFieldsToType(fields) {
+  const parts = [];
+  for (const [key, decl] of Object.entries(fields)) {
+    if (decl === null || typeof decl !== "object") continue;
+    const d = decl;
+    const optional = d.required === false ? "?" : "";
+    const fieldKey = isValidIdentifier(key) ? key : JSON.stringify(key);
+    parts.push(`${fieldKey}${optional}: ${outputDeclToTsType(d)}`);
+  }
+  if (parts.length === 0) return "Record<string, never>";
+  return `{ ${parts.join("; ")} }`;
+}
+function outputDeclToTsType(decl) {
+  const type = decl.type;
+  switch (type) {
+    case "text":
+    case "email":
+    case "date":
+    case "datetime":
+      return "string";
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "record_link":
+      return decl.multi === true ? "ReadonlyArray<string>" : "string";
+    case "select": {
+      const options = Array.isArray(decl.options) ? decl.options : [];
+      const literals = options.map(
+        (o) => o !== null && typeof o === "object" && "value" in o && typeof o.value === "string" ? JSON.stringify(o.value) : null
+      ).filter((v) => v !== null);
+      const inner = literals.length > 0 ? literals.join(" | ") : "string";
+      return decl.multi === true ? `ReadonlyArray<${inner}>` : inner;
+    }
+    case "object": {
+      const fields = decl.fields !== null && typeof decl.fields === "object" ? decl.fields : {};
+      return objectFieldsToType(fields);
+    }
+    case "array": {
+      const items = decl.items !== null && typeof decl.items === "object" ? decl.items : null;
+      return items ? `ReadonlyArray<${outputDeclToTsType(items)}>` : "ReadonlyArray<unknown>";
+    }
+    case "json":
+      return "unknown";
+    default:
+      return "unknown";
+  }
+}
 var IDENTIFIER_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 function isValidIdentifier(name) {
   return IDENTIFIER_REGEX.test(name);

package/dist/starter_template.d.ts

@@ -39,7 +39,7 @@ export interface StarterFile {
  * scaffolds resolve the live version via `fetchLatestNpmVersion` and only
  * fall back here when the lookup fails.
  */
-export declare const STARTER_FALLBACK_UI_VERSION = "1.8.0";
+export declare const STARTER_FALLBACK_UI_VERSION = "2.0.0";
 export declare const STARTER_FALLBACK_SDK_VERSION = "0.11.0";
 /**
  * react-native pin for scaffolded apps. Matches the monorepo frontend's pin so

package/dist/starter_template.js

@@ -35,7 +35,7 @@
  * scaffolds resolve the live version via `fetchLatestNpmVersion` and only
  * fall back here when the lookup fails.
  */
-export const STARTER_FALLBACK_UI_VERSION = "1.8.0";
+export const STARTER_FALLBACK_UI_VERSION = "2.0.0";
 export const STARTER_FALLBACK_SDK_VERSION = "0.11.0";
 /**
  * react-native pin for scaffolded apps. Matches the monorepo frontend's pin so
@@ -184,13 +184,14 @@ export default defineConfig({
     dedupe: ["react", "react-dom", "react-native-web"],
   },
   optimizeDeps: {
-    // \`recharts\` (used by @lotics/ui chart_* + sparkline) imports
-    // \`es-toolkit/compat/get\` as a default-export CJS module. Vite's dev
-    // server treats \`compat/*\` as ESM and won't synthesize a default,
-    // so \`import get from "es-toolkit/compat/get"\` fails to resolve.
-    // Pre-bundling forces Vite to convert it to an ESM shim with a default
-    // export. Production build (rollup) handles it correctly without this.
-    include: ["recharts", "es-toolkit", "es-toolkit/compat"],
+    // Force-prebundle react-native-web: it does \`import normalizeColor from
+    // "@react-native/normalize-colors"\` (a nested CJS module). Un-prebundled,
+    // Vite's dev server serves that as ESM with no default export → "does not
+    // provide an export named 'default'" and a blank iframe the moment a
+    // colour-touching RN-Web component (DatePicker, Picker) mounts under
+    // \`lotics app dev\`. Prebundling folds its CJS deps into one interop'd chunk.
+    // The rollup build handles the interop on its own, so this is dev-only.
+    include: ["react-native-web"],
     // The dep optimizer pre-bundles deps with a SEPARATE esbuild pass that
     // top-level \`define\` doesn't always reach, so a pre-bundled RN dep can
     // still hit \`__DEV__ is not defined\` under \`lotics app dev\`. Define it
@@ -221,6 +222,25 @@ export default defineConfig({
   },
   test: {
     environment: "jsdom",
+    // RN packages ship Flow (\`import typeof\`) in their native source, reached
+    // transitively by RN-Web components (pickers, calendars, anything touching
+    // Animated). Vitest's web optimizer is OFF by default and ignores the
+    // \`optimizeDeps.resolveExtensions\` above, so it pre-bundles the native
+    // \`.js\` / \`src\` Flow files and esbuild can't parse them. Enable it with the
+    // same \`.web.js\`-first resolution so it bundles the compiled web variants
+    // (Picker.web.js, RN-Web dist) — without this, any test that renders a tree
+    // pulling a Picker / DatePicker fails with "Unexpected token 'typeof'".
+    deps: {
+      optimizer: {
+        web: {
+          enabled: true,
+          include: ["react-native", "react-native-web", "@react-native-picker/picker"],
+          esbuildOptions: {
+            resolveExtensions: [".web.tsx", ".web.ts", ".web.js", ".tsx", ".ts", ".jsx", ".js", ".json"],
+          },
+        },
+      },
+    },
   },
 });
 `,

package/dist/starter_template.test.js

@@ -8,14 +8,23 @@ function fileNamed(files, path) {
 }
 describe("buildStarterTemplate", () => {
     const baseArgs = { app_name: "Demo", app_id: "app_test", workspace_id: "wsp_test" };
-    test("vite.config.ts pre-bundles recharts / es-toolkit for the dev server", () => {
+    test("vite.config.ts pre-bundles RN deps with __DEV__ + .web.js for the dev server", () => {
         const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
-        // Without this, `lotics app dev` crashes on `es-toolkit/compat/get` no
-        // default export when the app imports any @lotics/ui chart component.
+        // The optimizer runs a SEPARATE esbuild pass that ignores `resolve.extensions`
+        // and the top-level `define`, so `__DEV__` + `.web.js` must be repeated here —
+        // else a pre-bundled RN dep (e.g. react-native-svg, which @lotics/ui charts
+        // use) resolves to its native build and `__DEV__` is undefined.
         expect(config).toMatch(/optimizeDeps:\s*\{/);
-        expect(config).toContain('"recharts"');
-        expect(config).toContain('"es-toolkit"');
-        expect(config).toContain('"es-toolkit/compat"');
+        expect(config).toContain('__DEV__: "false"');
+        expect(config).toContain('".web.js"');
+    });
+    test("vite.config.ts force-prebundles react-native-web (else a DatePicker/Picker blanks the dev iframe)", () => {
+        // RN-Web does `import normalizeColor from "@react-native/normalize-colors"`
+        // (nested CJS). Un-prebundled, the dev server serves it as ESM with no
+        // default → "does not provide an export named 'default'" + blank iframe the
+        // moment a colour-touching component mounts. Prebundling interops it.
+        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
+        expect(config).toMatch(/include:\s*\[[^\]]*"react-native-web"/);
     });
     test("vite.config.ts defines the RN __DEV__ global (else the bundle throws at load → blank iframe)", () => {
         // `__DEV__` is a Metro-injected global that RN-ecosystem deps reference at
@@ -30,6 +39,18 @@ describe("buildStarterTemplate", () => {
         // deps under `lotics app dev`).
         expect(config).toMatch(/esbuildOptions:\s*\{\s*define:\s*\{\s*__DEV__:\s*"false"/);
     });
+    test("vite.config.ts enables the vitest web optimizer with .web.js resolution (else tests rendering a Picker/DatePicker fail on Flow)", () => {
+        // Vitest pre-bundles deps with its OWN esbuild optimizer, which is OFF by
+        // default and ignores the top-level `optimizeDeps.resolveExtensions`. Without
+        // it enabled + given `.web.js` first, it grabs react-native's native `.js` /
+        // src Flow files (`import typeof`) that esbuild can't parse — so any test that
+        // renders a tree pulling a Picker/DatePicker dies with "Unexpected token 'typeof'".
+        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
+        expect(config).toMatch(/test:\s*\{[\s\S]*environment:\s*"jsdom"/);
+        expect(config).toMatch(/optimizer:\s*\{\s*web:\s*\{\s*enabled:\s*true/);
+        // The web optimizer carries the same `.web.js`-first resolution as the build.
+        expect(config).toMatch(/web:\s*\{[\s\S]*resolveExtensions:[\s\S]*"\.web\.js"/);
+    });
     test("vite.config.ts maps the RN `global` to globalThis (else rn-web Animated throws when a spring is torn down)", () => {
         // react-native-web's Animated reads `global.cancelAnimationFrame` (free var)
         // when a spring animation is interrupted — e.g. toggling @lotics/ui's Switch.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.43.0",
+  "version": "0.44.1",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {