@betterlu/agentlu 1.1.1 → 1.2.1

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;
@@ -106,11 +116,22 @@ export declare class AgentLu {
         person?: string | null;
         defaults?: ClientDefaults;
     }): UseCaseRunner;
-    /** Register a use-case client and resolve to its api key. */
+    /**
+     * Register a use-case client and resolve to its api key. The key is cached
+     * on this instance (same semantics as `register`), so a following
+     * `responses.create` is authorized.
+     */
     useCaseClient(name: string, opts?: {
         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

@@ -55,13 +55,29 @@ export class AgentLu {
     useCase(name, opts) {
         return new UseCaseRunner(this, name, opts);
     }
-    /** Register a use-case client and resolve to its api key. */
+    /**
+     * Register a use-case client and resolve to its api key. The key is cached
+     * on this instance (same semantics as `register`), so a following
+     * `responses.create` is authorized.
+     */
     async useCaseClient(name, opts) {
         const res = await this.request("POST", "/clients", { name, ...opts }, { auth: false });
         if (!res.api_key)
             throw new AgentLuError(500, "internal_error", "register returned no key", true);
+        this.apiKey = res.api_key;
         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 +87,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,
@@ -201,14 +229,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.1",
+  "version": "1.2.1",
   "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",