@betterlu/agentlu 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -40,7 +40,17 @@ export interface ClientDefaults {
 export interface RunOptions {
     agent?: string;
     model?: string;
-    input: string;
+    input?: string;
+    /**
+     * Image attachments previously uploaded via `upload()`. Prepended to the
+     * user turn as `input_image` parts; `input` becomes the accompanying text.
+     */
+    fileIds?: string[];
+    /** Structured input messages (OpenAI shape) - overrides `input`. */
+    inputMessages?: Array<{
+        role: string;
+        content: string | Array<Record<string, unknown>>;
+    }>;
     instructions?: string;
     tools?: Array<string | {
         type: string;
@@ -55,6 +65,8 @@ export interface RunOptions {
     include?: string[];
     temperature?: number;
     max_output_tokens?: number;
+    /** Caller metadata stored on the response row (console visibility). */
+    metadata?: Record<string, string>;
     /** JSON Schema. When set, `data` on the result is the validated object. */
     schema?: Record<string, unknown>;
     schemaName?: string;
@@ -109,6 +121,13 @@ export declare class AgentLu {
         person?: string | null;
         defaults?: ClientDefaults;
     }): Promise<string>;
+    /**
+     * Upload an image (or document) for use with `run({ fileIds })` /
+     * `input_image`. Returns the `file_id` to reference.
+     */
+    upload(data: Uint8Array | Blob, filename: string, mime?: string): Promise<{
+        id: string;
+    }>;
     me(): Promise<unknown>;
     /**
      * One-shot helper. When `schema` is given, returns the validated object as

package/dist/index.js

@@ -62,6 +62,17 @@ export class AgentLu {
             throw new AgentLuError(500, "internal_error", "register returned no key", true);
         return res.api_key;
     }
+    /**
+     * Upload an image (or document) for use with `run({ fileIds })` /
+     * `input_image`. Returns the `file_id` to reference.
+     */
+    async upload(data, filename, mime) {
+        const form = new FormData();
+        const blob = data instanceof Blob ? data : new Blob([new Uint8Array(data)], { type: mime ?? "application/octet-stream" });
+        form.append("file", blob, filename);
+        const res = await this.raw("POST", "/files", form);
+        return (await res.json());
+    }
     async me() {
         return this.request("GET", "/me");
     }
@@ -71,8 +82,20 @@ export class AgentLu {
      * could not produce matching JSON.
      */
     async run(opts) {
+        let input = opts.inputMessages ?? opts.input;
+        if (opts.fileIds?.length) {
+            input = [
+                {
+                    role: "user",
+                    content: [
+                        ...opts.fileIds.map((file_id) => ({ type: "input_image", file_id })),
+                        { type: "input_text", text: opts.input ?? "" },
+                    ],
+                },
+            ];
+        }
         const body = {
-            input: opts.input,
+            input,
             agent: opts.agent,
             model: opts.model,
             instructions: opts.instructions,
@@ -87,6 +110,7 @@ export class AgentLu {
             temperature: opts.temperature,
             max_output_tokens: opts.max_output_tokens,
             background: opts.background,
+            metadata: opts.metadata,
         };
         if (opts.schema) {
             body.text = {
@@ -200,14 +224,16 @@ export class AgentLu {
     }
     async raw(method, path, body, opts) {
         const headers = {};
-        if (body !== undefined)
+        const isForm = typeof FormData !== "undefined" && body instanceof FormData;
+        if (body !== undefined && !isForm) {
             headers["Content-Type"] = "application/json";
+        }
         if (opts?.auth !== false && this.apiKey)
             headers.Authorization = `Bearer ${this.apiKey}`;
         const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
             method,
             headers,
-            body: body === undefined ? undefined : JSON.stringify(body),
+            body: body === undefined ? undefined : isForm ? body : JSON.stringify(body),
         });
         if (!res.ok) {
             let code = `http_${res.status}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@betterlu/agentlu",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Client for the agentlu service API (/v1). Or just use the openai SDK pointed at http://localhost:8912/v1.",
   "type": "module",
   "main": "./dist/index.js",