@agent-api/sdk 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — @agent-api/sdk
 
+## 1.0.2
+
+### Added
+
+- `user` on create-run params; `input_document` content parts in TypeScript types.
+- `response.requires_action` in streaming event types.
+- `readFile(..., { format: "raw" })` for binary volume files (`VolumeFileRaw` with `ArrayBuffer` content).
+- Route manifest coverage for volume rename, usage reconcile, and directory create/delete.
+
+### Fixed
+
+- README and route manifest now list all volume resource methods implemented since 1.0.1.
+
 ## 1.0.1
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 Production JavaScript/TypeScript SDK for the Managed Agent API.
 
-**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.0.1)
+**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.0.2)
 
 ## Install
 
@@ -59,7 +59,7 @@ src/
 | `client.models` | `list` |
 | `client.presets` | `list` |
 | `client.tools` | `list` |
-| `client.volumes` | `list`, `create`, `retrieve`, `delete`, `listEntries`, `searchEntries`, `readFile`, `writeFile`, `deleteFile` |
+| `client.volumes` | `list`, `create`, `retrieve`, `update`, `delete`, `listEntries`, `searchEntries`, `readFile`, `writeFile`, `deleteFile`, `reconcileUsage`, `createDirectory`, `deleteDirectory` |
 
 ## Durable Volumes
 
@@ -68,6 +68,7 @@ const volume = await client.volumes.create({ name: "research-notes" });
 
 await client.volumes.writeFile(volume.volume_id, "notes/summary.md", "# Summary\n");
 const file = await client.volumes.readFile(volume.volume_id, "notes/summary.md");
+const binary = await client.volumes.readFile(volume.volume_id, "assets/logo.png", { format: "raw" });
 
 const response = await client.agent.create({
   preset: "pro-search",

package/dist/internal/http.d.ts

@@ -14,6 +14,10 @@ export declare class HTTPClient {
     request<T>(method: string, path: string, body?: unknown, options?: RequestOptions): Promise<T>;
     requestRaw<T>(method: string, path: string, body: BodyInit, options?: RequestOptions): Promise<T>;
     requestVoid(method: string, path: string, options?: RequestOptions): Promise<void>;
+    requestBinary(method: string, path: string, options?: RequestOptions): Promise<{
+        body: ArrayBuffer;
+        headers: Headers;
+    }>;
     stream<T>(path: string, body: unknown, options?: RequestOptions): Promise<AsyncIterable<T>>;
     private fetchWithRetry;
     private fetchOnce;

package/dist/internal/http.js

@@ -17,6 +17,10 @@ export class HTTPClient {
     async requestVoid(method, path, options = {}) {
         await this.fetchWithRetry(method, path, undefined, options, false, false);
     }
+    async requestBinary(method, path, options = {}) {
+        const response = await this.fetchWithRetry(method, path, undefined, options, false, false);
+        return { body: await response.arrayBuffer(), headers: response.headers };
+    }
     async stream(path, body, options = {}) {
         const response = await this.fetchWithRetry("POST", path, body, options, true, false);
         return parseSSE(response);

package/dist/resources/volumes.d.ts

@@ -1,16 +1,25 @@
 import type { HTTPClient } from "../internal/http.js";
 import type { RequestOptions } from "../types/common.js";
-import type { CreateVolumeParams, ListVolumeEntriesParams, ListVolumeEntriesResponse, ListVolumesParams, ListVolumesResponse, ReadVolumeFileParams, SearchVolumeEntriesParams, VolumeFileRead, VolumeFileWrite, VolumeInfo } from "../types/volumes.js";
+import type { CreateVolumeParams, ListVolumeEntriesParams, ListVolumeEntriesResponse, ListVolumesParams, ListVolumesResponse, ReadVolumeFileParams, ReadVolumeFileRawParams, SearchVolumeEntriesParams, VolumeFileRead, VolumeFileRaw, VolumeFileWrite, VolumeInfo } from "../types/volumes.js";
 export declare class VolumesResource {
     private readonly http;
     constructor(http: HTTPClient);
     list(params?: ListVolumesParams, options?: RequestOptions): Promise<ListVolumesResponse>;
     create(params?: CreateVolumeParams, options?: RequestOptions): Promise<VolumeInfo>;
     retrieve(volumeID: string, options?: RequestOptions): Promise<VolumeInfo>;
+    update(volumeID: string, params: {
+        name: string;
+    }, options?: RequestOptions): Promise<VolumeInfo>;
     delete(volumeID: string, options?: RequestOptions): Promise<void>;
     listEntries(volumeID: string, params?: ListVolumeEntriesParams, options?: RequestOptions): Promise<ListVolumeEntriesResponse>;
     searchEntries(volumeID: string, params: SearchVolumeEntriesParams, options?: RequestOptions): Promise<ListVolumeEntriesResponse>;
+    readFile(volumeID: string, path: string, params: ReadVolumeFileRawParams, options?: RequestOptions): Promise<VolumeFileRaw>;
     readFile(volumeID: string, path: string, params?: ReadVolumeFileParams, options?: RequestOptions): Promise<VolumeFileRead>;
     writeFile(volumeID: string, path: string, content: string | ArrayBuffer | Blob, options?: RequestOptions): Promise<VolumeFileWrite>;
     deleteFile(volumeID: string, path: string, options?: RequestOptions): Promise<void>;
+    reconcileUsage(volumeID: string, options?: RequestOptions): Promise<VolumeInfo>;
+    createDirectory(volumeID: string, path: string, options?: RequestOptions): Promise<{
+        path: string;
+    }>;
+    deleteDirectory(volumeID: string, path: string, options?: RequestOptions): Promise<void>;
 }

package/dist/resources/volumes.js

@@ -13,6 +13,9 @@ export class VolumesResource {
     retrieve(volumeID, options) {
         return this.http.request("GET", `/v1/volumes/${encodeURIComponent(volumeID)}`, undefined, options);
     }
+    update(volumeID, params, options) {
+        return this.http.request("PATCH", `/v1/volumes/${encodeURIComponent(volumeID)}`, params, options);
+    }
     delete(volumeID, options) {
         return this.http.requestVoid("DELETE", `/v1/volumes/${encodeURIComponent(volumeID)}`, options);
     }
@@ -32,9 +35,20 @@ export class VolumesResource {
         })}`, undefined, options);
     }
     readFile(volumeID, path, params = {}, options) {
-        return this.http.request("GET", `/v1/volumes/${encodeURIComponent(volumeID)}/files/${volumePath(path)}${buildQuery({
+        const url = `/v1/volumes/${encodeURIComponent(volumeID)}/files/${volumePath(path)}${buildQuery({
             max_bytes: params.max_bytes,
-        })}`, undefined, options);
+            format: params.format,
+        })}`;
+        if (params.format === "raw") {
+            return this.http.requestBinary("GET", url, options).then(({ body, headers }) => ({
+                path,
+                size: Number(headers.get("X-Volume-Size") ?? body.byteLength),
+                truncated: headers.get("X-Volume-Truncated") === "true",
+                content: body,
+                content_type: headers.get("Content-Type") ?? undefined,
+            }));
+        }
+        return this.http.request("GET", url, undefined, options);
     }
     writeFile(volumeID, path, content, options) {
         return this.http.requestRaw("PUT", `/v1/volumes/${encodeURIComponent(volumeID)}/files/${volumePath(path)}`, content, options);
@@ -42,6 +56,15 @@ export class VolumesResource {
     deleteFile(volumeID, path, options) {
         return this.http.requestVoid("DELETE", `/v1/volumes/${encodeURIComponent(volumeID)}/files/${volumePath(path)}`, options);
     }
+    reconcileUsage(volumeID, options) {
+        return this.http.request("POST", `/v1/volumes/${encodeURIComponent(volumeID)}/usage/reconcile`, undefined, options);
+    }
+    createDirectory(volumeID, path, options) {
+        return this.http.request("POST", `/v1/volumes/${encodeURIComponent(volumeID)}/directories`, { path }, options);
+    }
+    deleteDirectory(volumeID, path, options) {
+        return this.http.requestVoid("DELETE", `/v1/volumes/${encodeURIComponent(volumeID)}/directories/${volumePath(path)}`, options);
+    }
 }
 function volumePath(path) {
     return path

package/dist/types/input.d.ts

@@ -6,9 +6,12 @@ export interface Annotation {
     end_index?: number;
 }
 export interface ContentPart {
-    type: "input_text" | "output_text" | "input_image";
+    type: "input_text" | "output_text" | "input_image" | "input_document";
     text?: string;
     image_url?: string;
+    mime_type?: string;
+    filename?: string;
+    document_url?: string;
     annotations?: Annotation[];
     logprobs?: unknown[];
 }

package/dist/types/responses.d.ts

@@ -23,6 +23,7 @@ export interface ResponseCreateParamsBase {
     memory?: MemoryOptions;
     plan_mode_preference?: AgentCapabilityPreference;
     sub_agent_preference?: AgentCapabilityPreference;
+    user?: string;
     stream?: boolean;
 }
 export interface ResponseCreateParamsNonStreaming extends ResponseCreateParamsBase {

package/dist/types/streaming.d.ts

@@ -17,7 +17,7 @@ export interface ResponseModelCallEvent {
     model_chain?: string[];
     attempt_count?: number;
 }
-export type ResponseStreamEventType = "response.created" | "response.in_progress" | "response.completed" | "response.failed" | "response.plan.updated" | "response.output_item.added" | "response.output_item.done" | "response.output_text.delta" | "response.output_text.done" | "response.reasoning.started" | "response.reasoning.search_queries" | "response.reasoning.search_results" | "response.reasoning.fetch_url_queries" | "response.reasoning.fetch_url_results" | "response.reasoning.stopped" | "response.tool.invocation.completed" | "response.step.completed" | "response.step.failed" | "response.step.skipped" | "response.model.requested" | "response.model.completed" | "response.model.failed";
+export type ResponseStreamEventType = "response.created" | "response.in_progress" | "response.completed" | "response.failed" | "response.requires_action" | "response.plan.updated" | "response.output_item.added" | "response.output_item.done" | "response.output_text.delta" | "response.output_text.done" | "response.reasoning.started" | "response.reasoning.search_queries" | "response.reasoning.search_results" | "response.reasoning.fetch_url_queries" | "response.reasoning.fetch_url_results" | "response.reasoning.stopped" | "response.tool.invocation.completed" | "response.step.completed" | "response.step.failed" | "response.step.skipped" | "response.model.requested" | "response.model.completed" | "response.model.failed";
 export interface ResponseStreamEvent {
     type: ResponseStreamEventType;
     sequence_number: number;

package/dist/types/volumes.d.ts

@@ -3,6 +3,9 @@ export interface VolumeInfo {
     tenant_id?: string;
     name?: string;
     oss_prefix?: string;
+    bytes_used?: number;
+    object_count?: number;
+    usage_reconciled_at_unix?: number;
     created_at_unix?: number;
     updated_at_unix?: number;
 }
@@ -39,6 +42,11 @@ export interface ListVolumeEntriesResponse {
 }
 export interface ReadVolumeFileParams {
     max_bytes?: number;
+    format?: "json";
+}
+export interface ReadVolumeFileRawParams {
+    max_bytes?: number;
+    format: "raw";
 }
 export interface VolumeFileRead {
     path: string;
@@ -46,6 +54,13 @@ export interface VolumeFileRead {
     truncated: boolean;
     content: string;
 }
+export interface VolumeFileRaw {
+    path: string;
+    size: number;
+    truncated: boolean;
+    content: ArrayBuffer;
+    content_type?: string;
+}
 export interface VolumeFileWrite {
     path: string;
     size: number;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.1";
-export declare const USER_AGENT = "@agent-api/sdk/1.0.1";
+export declare const VERSION = "1.0.2";
+export declare const USER_AGENT = "@agent-api/sdk/1.0.2";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "1.0.1";
+export const VERSION = "1.0.2";
 export const USER_AGENT = `@agent-api/sdk/${VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/sdk",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {