@betterlu/agentlu 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -42,10 +42,12 @@ export interface RunOptions {
     model?: string;
     input?: string;
     /**
-     * Image attachments previously uploaded via `upload()`. Prepended to the
-     * user turn as `input_image` parts; `input` becomes the accompanying text.
-     */
+      * Attachments previously uploaded via `upload()`. Prepended to the user
+      * turn using each file's `kind` (`input_image` / `input_video` / `input_file`).
+      */
     fileIds?: string[];
+    /** Optional kinds aligned with `fileIds` (from `upload()`). Defaults to image. */
+    fileKinds?: Array<"image" | "video" | "text" | "document">;
     /** Structured input messages (OpenAI shape) - overrides `input`. */
     inputMessages?: Array<{
         role: string;
@@ -116,17 +118,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 an image, video, or document for use with `run({ fileIds })`.
+     * Returns the `file_id` and stored `kind`.
      */
     upload(data: Uint8Array | Blob, filename: string, mime?: string): Promise<{
         id: string;
+        kind?: string;
     }>;
     me(): Promise<unknown>;
     /**
@@ -197,4 +204,12 @@ export declare class UseCaseRunner {
         response: ResponseObject;
     }>;
     stream(body: Record<string, unknown>): Promise<AsyncGenerator<Record<string, unknown>, any, any>>;
+    /**
+     * Upload with this use-case's key, so the file is owned by the same
+     * service client that will reference it via `run({ fileIds })`.
+     */
+    upload(data: Uint8Array | Blob, filename: string, mime?: string): Promise<{
+        id: string;
+        kind?: string;
+    }>;
 }

package/dist/index.js

@@ -55,16 +55,21 @@ 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.
+     * Upload an image, video, or document for use with `run({ fileIds })`.
+     * Returns the `file_id` and stored `kind`.
      */
     async upload(data, filename, mime) {
         const form = new FormData();
@@ -88,7 +93,14 @@ export class AgentLu {
                 {
                     role: "user",
                     content: [
-                        ...opts.fileIds.map((file_id) => ({ type: "input_image", file_id })),
+                        ...opts.fileIds.map((file_id, i) => {
+                            const kind = opts.fileKinds?.[i];
+                            if (kind === "video")
+                                return { type: "input_video", file_id };
+                            if (kind === "text" || kind === "document")
+                                return { type: "input_file", file_id };
+                            return { type: "input_image", file_id };
+                        }),
                         { type: "input_text", text: opts.input ?? "" },
                     ],
                 },
@@ -321,6 +333,21 @@ export class UseCaseRunner {
             this.parent.apiKey = parentKey;
         }
     }
+    /**
+     * Upload with this use-case's key, so the file is owned by the same
+     * service client that will reference it via `run({ fileIds })`.
+     */
+    async upload(data, filename, mime) {
+        await this.ensure();
+        const parentKey = this.parent.apiKey;
+        this.parent.apiKey = this.apiKey ?? undefined;
+        try {
+            return await this.parent.upload(data, filename, mime);
+        }
+        finally {
+            this.parent.apiKey = parentKey;
+        }
+    }
 }
 function parseRetryAfter(res) {
     const header = res.headers.get("retry-after");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@betterlu/agentlu",
-  "version": "1.2.0",
+  "version": "1.3.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",
@@ -11,8 +11,12 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist"],
-  "engines": { "node": ">=18" },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "prepublishOnly": "npm run build"
@@ -20,7 +24,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "keywords": ["agentlu", "openai", "responses", "llm", "agent"],
+  "keywords": [
+    "agentlu",
+    "openai",
+    "responses",
+    "llm",
+    "agent"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/betterlu/agentlu.git",