@lotics/cli 0.69.0 → 0.70.0

package/dist/generate_app_workflows_dts.d.ts

@@ -26,7 +26,9 @@ export declare function generateAppWorkflowsDts(workflows: Record<string, AppWor
  * to `unknown` rather than throwing — the server's deploy-time schema parse
  * catches structurally-invalid declarations before they reach us.
  */
-export declare function inputsToType(inputs: Record<string, unknown>): string;
+export declare function inputsToType(inputs: Record<string, unknown>, opts?: {
+    nullableOptional?: boolean;
+}): 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.

package/dist/generate_app_workflows_dts.js

@@ -41,7 +41,7 @@ declare module "@lotics/app-sdk" {
         // 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)
+            ? inputsToType(declaration.inputs, { nullableOptional: true })
             : "Record<string, unknown>";
         const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
         inputLines.push(`    ${aliasKey}: ${valueType};`);
@@ -74,16 +74,27 @@ ${inputLines.join("\n")}
  * to `unknown` rather than throwing — the server's deploy-time schema parse
  * catches structurally-invalid declarations before they reach us.
  */
-export function inputsToType(inputs) {
+export function inputsToType(inputs, opts) {
+    // A WORKFLOW optional input also accepts `null` — the diff-write "clear this
+    // field" signal (the backend validates it, the body forwards it to
+    // `update_records({ set: { fld: null } })`). So `useWorkflow` call sites can
+    // pass `null` to unset a field without a loose `Record<string, unknown>` cast.
+    // Query params + agent inputs have no "clear", so they stay `T` (the caller
+    // omits the flag). Only the TOP level is nullable: a nested object's optional
+    // field mirrors the backend's plain `.optional()` (the recursive call below
+    // omits the flag), so the type never claims a nested clear the server rejects.
+    const nullableOptional = opts?.nullableOptional === true;
     const fields = [];
     for (const [key, decl] of Object.entries(inputs)) {
         if (decl === null || typeof decl !== "object")
             continue;
         const d = decl;
         const tsType = inputDeclToTsType(d);
-        const optional = d.required === false ? "?" : "";
+        const isOptional = d.required === false;
+        const fieldType = isOptional && nullableOptional ? `${tsType} | null` : tsType;
+        const optional = isOptional ? "?" : "";
         const fieldKey = isValidIdentifier(key) ? key : JSON.stringify(key);
-        fields.push(`      ${fieldKey}${optional}: ${tsType};`);
+        fields.push(`      ${fieldKey}${optional}: ${fieldType};`);
     }
     if (fields.length === 0)
         return "Record<string, never>";

package/dist/generate_app_workflows_dts.test.js

@@ -58,6 +58,32 @@ describe("generateAppWorkflowsDts", () => {
         expect(dts).toContain("note?: string;");
         expect(dts).toContain("ref: string;");
     });
+    it("types a TOP-LEVEL optional workflow input as `T | null` (the diff-write clear signal), required stays `T`, nested stays plain optional", () => {
+        const dts = generateAppWorkflowsDts({
+            updateTask: {
+                workflow_id: "wfl_u",
+                inputs: {
+                    record_id: { type: "record_link", table_id: "tbl_x" },
+                    due: { type: "date", required: false },
+                    status: { type: "select", required: false, options: [{ label: "Done", value: "opt_done" }] },
+                    tags: { type: "select", multi: true, required: false, options: [{ label: "A", value: "opt_a" }] },
+                    meta: {
+                        type: "object",
+                        required: false,
+                        fields: { note: { type: "text", required: false } },
+                    },
+                },
+            },
+        });
+        expect(dts).toContain("record_id: string;"); // required → NOT nullable
+        expect(dts).toContain("due?: string | null;"); // optional scalar → clearable
+        expect(dts).toContain('status?: "opt_done" | null;');
+        expect(dts).toContain('tags?: ReadonlyArray<"opt_a"> | null;'); // optional multi
+        // The object itself is a top-level optional → nullable; its NESTED optional
+        // field mirrors the backend's plain `.optional()` (no `| null`).
+        expect(dts).toContain("note?: string;");
+        expect(dts).not.toContain("note?: string | null;");
+    });
     it("maps record_link/select outputs the same way as inputs", () => {
         const dts = generateAppWorkflowsDts({
             lookup: {

package/dist/src/cli.js

@@ -31759,7 +31759,7 @@ declare module "@lotics/app-sdk" {
   const inputLines = [];
   const resultLines = [];
   for (const [alias, declaration] of entries) {
-    const valueType = declaration.inputs ? inputsToType(declaration.inputs) : "Record<string, unknown>";
+    const valueType = declaration.inputs ? inputsToType(declaration.inputs, { nullableOptional: true }) : "Record<string, unknown>";
     const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
     inputLines.push(`    ${aliasKey}: ${valueType};`);
     if (declaration.outputs) {
@@ -31778,15 +31778,18 @@ ${inputLines.join("\n")}
 }
 `;
 }
-function inputsToType(inputs) {
+function inputsToType(inputs, opts) {
+  const nullableOptional = opts?.nullableOptional === true;
   const fields = [];
   for (const [key, decl] of Object.entries(inputs)) {
     if (decl === null || typeof decl !== "object") continue;
     const d = decl;
     const tsType = inputDeclToTsType(d);
-    const optional = d.required === false ? "?" : "";
+    const isOptional = d.required === false;
+    const fieldType = isOptional && nullableOptional ? `${tsType} | null` : tsType;
+    const optional = isOptional ? "?" : "";
     const fieldKey = isValidIdentifier(key) ? key : JSON.stringify(key);
-    fields.push(`      ${fieldKey}${optional}: ${tsType};`);
+    fields.push(`      ${fieldKey}${optional}: ${fieldType};`);
   }
   if (fields.length === 0) return "Record<string, never>";
   return `{

package/package.json

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