@lotics/cli 0.28.0 → 0.29.0

package/dist/src/client.d.ts

@@ -129,6 +129,36 @@ export declare class LoticsClient {
      * Mirrors POST /v1/apps/{app_id}/workflows/{alias}/execute.
      */
     appWorkflow(app_id: string, alias: string, inputs: unknown): Promise<unknown>;
+    /**
+     * Mint a presigned URL for uploading a file into an app. Mirrors
+     * POST /v1/apps/{app_id}/files/upload-url.
+     */
+    appRequestFileUpload(app_id: string, body: {
+        filename: string;
+        mime_type: string;
+        file_size: number;
+    }): Promise<{
+        file_id: string;
+        file_storage_key: string;
+        upload_url: string;
+    }>;
+    /**
+     * Finalize a presigned upload once the bytes are in storage. Mirrors
+     * POST /v1/apps/{app_id}/files/complete.
+     */
+    appCompleteFileUpload(app_id: string, body: {
+        file_id: string;
+        file_storage_key: string;
+        filename: string;
+    }): Promise<{
+        file: {
+            id: string;
+            filename: string;
+            mime_type: string;
+            url?: string;
+            thumbnail_url?: string;
+        };
+    }>;
     deployAppVersion(args: {
         app_id: string;
         source_archive: Buffer;

package/dist/src/client.js

@@ -175,6 +175,20 @@ export class LoticsClient {
     async appWorkflow(app_id, alias, inputs) {
         return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/workflows/${encodeURIComponent(alias)}/execute`, { inputs });
     }
+    /**
+     * Mint a presigned URL for uploading a file into an app. Mirrors
+     * POST /v1/apps/{app_id}/files/upload-url.
+     */
+    async appRequestFileUpload(app_id, body) {
+        return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/files/upload-url`, body);
+    }
+    /**
+     * Finalize a presigned upload once the bytes are in storage. Mirrors
+     * POST /v1/apps/{app_id}/files/complete.
+     */
+    async appCompleteFileUpload(app_id, body) {
+        return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/files/complete`, body);
+    }
     async deployAppVersion(args) {
         const formData = new FormData();
         // Wrap Buffers as Uint8Array views so the Blob constructor accepts them

package/dist/src/dev/rpc_handler.d.ts

@@ -6,7 +6,7 @@
  * { message }. Same shape as the production iframe-host's error path.
  */
 import { LoticsClient } from "../client.js";
-export type RpcOp = "query" | "workflow";
+export type RpcOp = "query" | "workflow" | "upload_url" | "upload_complete";
 export interface RpcRequest {
     app_id: string;
     op: RpcOp;

package/dist/src/dev/rpc_handler.js

@@ -5,7 +5,12 @@
  * Errors are thrown — the HTTP server caller serializes them to a 500 with
  * { message }. Same shape as the production iframe-host's error path.
  */
-const SUPPORTED_OPS = new Set(["query", "workflow"]);
+const SUPPORTED_OPS = new Set([
+    "query",
+    "workflow",
+    "upload_url",
+    "upload_complete",
+]);
 export async function dispatchRpc(client, body) {
     if (!body || typeof body.app_id !== "string" || typeof body.op !== "string") {
         throw new Error("RPC envelope must include app_id and op");
@@ -28,6 +33,34 @@ export async function dispatchRpc(client, body) {
             }
             return client.appWorkflow(body.app_id, p.alias, p.inputs);
         }
+        case "upload_url": {
+            const p = body.payload;
+            if (!p ||
+                typeof p.filename !== "string" ||
+                typeof p.mime_type !== "string" ||
+                typeof p.file_size !== "number") {
+                throw new Error("upload_url payload must include filename, mime_type, file_size");
+            }
+            return client.appRequestFileUpload(body.app_id, {
+                filename: p.filename,
+                mime_type: p.mime_type,
+                file_size: p.file_size,
+            });
+        }
+        case "upload_complete": {
+            const p = body.payload;
+            if (!p ||
+                typeof p.file_id !== "string" ||
+                typeof p.file_storage_key !== "string" ||
+                typeof p.filename !== "string") {
+                throw new Error("upload_complete payload must include file_id, file_storage_key, filename");
+            }
+            return client.appCompleteFileUpload(body.app_id, {
+                file_id: p.file_id,
+                file_storage_key: p.file_storage_key,
+                filename: p.filename,
+            });
+        }
         default: {
             // Unreachable — SUPPORTED_OPS gates above.
             throw new Error(`Unhandled RPC op: ${body.op}`);

package/dist/src/dev/wrapper_page.js

@@ -59,24 +59,59 @@ export function buildWrapperPage(args) {
       const APP_ID = ${JSON.stringify(app_id)};
       const iframe = document.getElementById("app");
 
+      async function rpc(op, payload) {
+        const res = await fetch("/_rpc", {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ app_id: APP_ID, op: op, payload: payload }),
+        });
+        const text = await res.text();
+        if (!res.ok) {
+          let detail = text;
+          try { detail = JSON.parse(text).message ?? text; } catch (_) {}
+          throw new Error(detail || ("HTTP " + res.status));
+        }
+        return JSON.parse(text);
+      }
+
+      // The iframe SDK sends one "upload" op carrying a File. A File can't
+      // cross the JSON /_rpc hop, so the upload runs here in the browser:
+      // mint a presigned URL, PUT the bytes to storage, then finalize.
+      async function handleUpload(payload) {
+        const file = payload && payload.file;
+        if (!(file instanceof File)) {
+          throw new Error("upload payload must include a File");
+        }
+        const init = await rpc("upload_url", {
+          filename: file.name,
+          mime_type: file.type,
+          file_size: file.size,
+        });
+        const putRes = await fetch(init.upload_url, {
+          method: "PUT",
+          body: file,
+          headers: { "Content-Type": file.type },
+        });
+        if (!putRes.ok) {
+          throw new Error("Storage upload failed (" + putRes.status + ")");
+        }
+        const completed = await rpc("upload_complete", {
+          file_id: init.file_id,
+          file_storage_key: init.file_storage_key,
+          filename: file.name,
+        });
+        return completed.file;
+      }
+
       window.addEventListener("message", async function (event) {
         if (event.source !== iframe.contentWindow) return;
         const msg = event.data;
         if (!msg || typeof msg.id !== "number" || typeof msg.op !== "string") return;
         const startedAt = performance.now();
         try {
-          const res = await fetch("/_rpc", {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({ app_id: APP_ID, op: msg.op, payload: msg.payload }),
-          });
-          const text = await res.text();
-          if (!res.ok) {
-            let detail = text;
-            try { detail = JSON.parse(text).message ?? text; } catch (_) {}
-            throw new Error(detail || ("HTTP " + res.status));
-          }
-          const data = JSON.parse(text);
+          const data = msg.op === "upload"
+            ? await handleUpload(msg.payload)
+            : await rpc(msg.op, msg.payload);
           const ms = Math.round(performance.now() - startedAt);
           console.debug("[lotics-dev] " + msg.op + " " + ms + "ms", data);
           iframe.contentWindow.postMessage({ id: msg.id, type: "result", data: data }, "*");

package/dist/src/starter_template.d.ts

@@ -10,8 +10,10 @@
  *
  * Conventions (locked decisions):
  *   - Vite + React + TypeScript (strict mode).
- *   - Entry: src/App.tsx with `export default`. main.tsx wires `mount(<App/>)`
- *     and imports @lotics/ui/index.css (base style reset) + @lotics/ui/fonts.css
+ *   - Entry: src/App.tsx with `export default`. main.tsx wires
+ *     `mount(<PortalHost><App/></PortalHost>)` — PortalHost is the render
+ *     target @lotics/ui overlays (Popover/Tooltip/Dialog) need — and imports
+ *     @lotics/ui/index.css (base style reset) + @lotics/ui/fonts.css
  *     (path-independent Inter @font-face bundle — Text renders unstyled without it).
  *   - Vite default `base: "/"` so emitted asset URLs are absolute; the render
  *     endpoint rewrites root-relative paths to `/v1/apps/{id}/asset/...`.

package/dist/src/starter_template.js

@@ -10,8 +10,10 @@
  *
  * Conventions (locked decisions):
  *   - Vite + React + TypeScript (strict mode).
- *   - Entry: src/App.tsx with `export default`. main.tsx wires `mount(<App/>)`
- *     and imports @lotics/ui/index.css (base style reset) + @lotics/ui/fonts.css
+ *   - Entry: src/App.tsx with `export default`. main.tsx wires
+ *     `mount(<PortalHost><App/></PortalHost>)` — PortalHost is the render
+ *     target @lotics/ui overlays (Popover/Tooltip/Dialog) need — and imports
+ *     @lotics/ui/index.css (base style reset) + @lotics/ui/fonts.css
  *     (path-independent Inter @font-face bundle — Text renders unstyled without it).
  *   - Vite default `base: "/"` so emitted asset URLs are absolute; the render
  *     endpoint rewrites root-relative paths to `/v1/apps/{id}/asset/...`.
@@ -48,7 +50,7 @@ export function buildStarterTemplate(args) {
                     test: "vitest run",
                 },
                 dependencies: {
-                    "@lotics/app-sdk": "^0.5.0",
+                    "@lotics/app-sdk": "^0.6.0",
                     "@lotics/ui": "^1.3.0",
                     "@react-native-picker/picker": "^2.7.0",
                     "expo-image": "~3.0.9",
@@ -194,10 +196,17 @@ export default defineConfig({
             path: "src/main.tsx",
             content: `import "@lotics/ui/index.css";
 import "@lotics/ui/fonts.css";
+import { PortalHost } from "@lotics/ui/portal";
 import { mount } from "@lotics/app-sdk";
 import App from "./App";
 
-mount(<App />);
+// PortalHost is the render target for @lotics/ui overlays (Popover, Tooltip,
+// Dialog). Without it, Portal renders nothing — keep it wrapping the app.
+mount(
+  <PortalHost>
+    <App />
+  </PortalHost>,
+);
 `,
         },
         {

package/package.json

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