@agent-api/sdk 1.3.1 → 1.3.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @agent-api/sdk
 
+## 1.3.2
+
+### Added
+
+- Added volume image asset helpers for normalizing private volume paths and checking supported image paths/content types.
+
 ## 1.3.1
 
 ### Fixed

package/dist/index.d.ts

@@ -6,5 +6,6 @@ export * from "./types/index.js";
 export { functionCallOutputInput, pendingFunctionCalls, runLocalFunctionHandlers, } from "./local-functions.js";
 export type { LocalFunctionHandler, LocalFunctionHandlers } from "./local-functions.js";
 export { mergeTools, publicToolToRequestTool, resolvePresetTools, resolvePresetToolsFromCatalog, } from "./preset-tools.js";
+export { isSupportedVolumeImageContentType, isSupportedVolumeImagePath, normalizeVolumeAssetPath, } from "./volume-assets.js";
 export type { PresetToolCatalogClient, ResolvePresetToolsOptions, ResolvePresetToolsResult, UnknownPresetToolBehavior, } from "./preset-tools.js";
 export { AuthResource, DeviceAuthFlowError, browserAuthSessionExpiresWithin } from "./resources/auth.js";

package/dist/index.js

@@ -4,4 +4,5 @@ export { APIError, APIConnectionError, APIStatusError, AuthenticationError, BadR
 export * from "./types/index.js";
 export { functionCallOutputInput, pendingFunctionCalls, runLocalFunctionHandlers, } from "./local-functions.js";
 export { mergeTools, publicToolToRequestTool, resolvePresetTools, resolvePresetToolsFromCatalog, } from "./preset-tools.js";
+export { isSupportedVolumeImageContentType, isSupportedVolumeImagePath, normalizeVolumeAssetPath, } from "./volume-assets.js";
 export { AuthResource, DeviceAuthFlowError, browserAuthSessionExpiresWithin } from "./resources/auth.js";

package/dist/version.d.ts

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

package/dist/version.js

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

package/dist/volume-assets.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeVolumeAssetPath(src: string | null | undefined): string;
+export declare function isSupportedVolumeImagePath(src: string | null | undefined): boolean;
+export declare function isSupportedVolumeImageContentType(contentType: string | null | undefined): boolean;

package/dist/volume-assets.js

@@ -0,0 +1,37 @@
+const SUPPORTED_VOLUME_IMAGE_EXTENSIONS = new Set([
+    ".avif",
+    ".bmp",
+    ".gif",
+    ".jpeg",
+    ".jpg",
+    ".png",
+    ".svg",
+    ".webp",
+]);
+export function normalizeVolumeAssetPath(src) {
+    const value = src?.trim() ?? "";
+    if (!value)
+        return "";
+    if (isExternalAssetTarget(value))
+        return "";
+    let path = value.split("#", 1)[0]?.split("?", 1)[0]?.trim() ?? "";
+    path = path.replace(/^\/agent-volume\/+/i, "");
+    path = path.replace(/^\/+/, "");
+    path = path.replace(/\/+/g, "/");
+    if (!path || path === "." || path.includes(".."))
+        return "";
+    return path;
+}
+export function isSupportedVolumeImagePath(src) {
+    const path = normalizeVolumeAssetPath(src).toLowerCase();
+    if (!path)
+        return false;
+    const dot = path.lastIndexOf(".");
+    return dot >= 0 && SUPPORTED_VOLUME_IMAGE_EXTENSIONS.has(path.slice(dot));
+}
+export function isSupportedVolumeImageContentType(contentType) {
+    return (contentType ?? "").split(";", 1)[0]?.trim().toLowerCase().startsWith("image/") ?? false;
+}
+function isExternalAssetTarget(src) {
+    return /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(src);
+}

package/dist-cjs/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.browserAuthSessionExpiresWithin = exports.DeviceAuthFlowError = exports.AuthResource = exports.resolvePresetToolsFromCatalog = exports.resolvePresetTools = exports.publicToolToRequestTool = exports.mergeTools = exports.runLocalFunctionHandlers = exports.pendingFunctionCalls = exports.functionCallOutputInput = exports.parseResponseError = exports.isRetryableStatus = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.BadRequestError = exports.AuthenticationError = exports.APIStatusError = exports.APIConnectionError = exports.APIError = exports.collectPage = exports.Page = exports.VERSION = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_STREAM_TIMEOUT_MS = exports.DEFAULT_MAX_RETRIES = exports.AgentAPI = void 0;
+exports.browserAuthSessionExpiresWithin = exports.DeviceAuthFlowError = exports.AuthResource = exports.normalizeVolumeAssetPath = exports.isSupportedVolumeImagePath = exports.isSupportedVolumeImageContentType = exports.resolvePresetToolsFromCatalog = exports.resolvePresetTools = exports.publicToolToRequestTool = exports.mergeTools = exports.runLocalFunctionHandlers = exports.pendingFunctionCalls = exports.functionCallOutputInput = exports.parseResponseError = exports.isRetryableStatus = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.BadRequestError = exports.AuthenticationError = exports.APIStatusError = exports.APIConnectionError = exports.APIError = exports.collectPage = exports.Page = exports.VERSION = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_STREAM_TIMEOUT_MS = exports.DEFAULT_MAX_RETRIES = exports.AgentAPI = void 0;
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "AgentAPI", { enumerable: true, get: function () { return client_js_1.AgentAPI; } });
 Object.defineProperty(exports, "DEFAULT_MAX_RETRIES", { enumerable: true, get: function () { return client_js_1.DEFAULT_MAX_RETRIES; } });
@@ -46,6 +46,10 @@ Object.defineProperty(exports, "mergeTools", { enumerable: true, get: function (
 Object.defineProperty(exports, "publicToolToRequestTool", { enumerable: true, get: function () { return preset_tools_js_1.publicToolToRequestTool; } });
 Object.defineProperty(exports, "resolvePresetTools", { enumerable: true, get: function () { return preset_tools_js_1.resolvePresetTools; } });
 Object.defineProperty(exports, "resolvePresetToolsFromCatalog", { enumerable: true, get: function () { return preset_tools_js_1.resolvePresetToolsFromCatalog; } });
+var volume_assets_js_1 = require("./volume-assets.js");
+Object.defineProperty(exports, "isSupportedVolumeImageContentType", { enumerable: true, get: function () { return volume_assets_js_1.isSupportedVolumeImageContentType; } });
+Object.defineProperty(exports, "isSupportedVolumeImagePath", { enumerable: true, get: function () { return volume_assets_js_1.isSupportedVolumeImagePath; } });
+Object.defineProperty(exports, "normalizeVolumeAssetPath", { enumerable: true, get: function () { return volume_assets_js_1.normalizeVolumeAssetPath; } });
 var auth_js_1 = require("./resources/auth.js");
 Object.defineProperty(exports, "AuthResource", { enumerable: true, get: function () { return auth_js_1.AuthResource; } });
 Object.defineProperty(exports, "DeviceAuthFlowError", { enumerable: true, get: function () { return auth_js_1.DeviceAuthFlowError; } });

package/dist-cjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.USER_AGENT = exports.VERSION = void 0;
-exports.VERSION = "1.3.1";
+exports.VERSION = "1.3.2";
 exports.USER_AGENT = `@agent-api/sdk/${exports.VERSION}`;

package/dist-cjs/volume-assets.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeVolumeAssetPath = normalizeVolumeAssetPath;
+exports.isSupportedVolumeImagePath = isSupportedVolumeImagePath;
+exports.isSupportedVolumeImageContentType = isSupportedVolumeImageContentType;
+const SUPPORTED_VOLUME_IMAGE_EXTENSIONS = new Set([
+    ".avif",
+    ".bmp",
+    ".gif",
+    ".jpeg",
+    ".jpg",
+    ".png",
+    ".svg",
+    ".webp",
+]);
+function normalizeVolumeAssetPath(src) {
+    const value = src?.trim() ?? "";
+    if (!value)
+        return "";
+    if (isExternalAssetTarget(value))
+        return "";
+    let path = value.split("#", 1)[0]?.split("?", 1)[0]?.trim() ?? "";
+    path = path.replace(/^\/agent-volume\/+/i, "");
+    path = path.replace(/^\/+/, "");
+    path = path.replace(/\/+/g, "/");
+    if (!path || path === "." || path.includes(".."))
+        return "";
+    return path;
+}
+function isSupportedVolumeImagePath(src) {
+    const path = normalizeVolumeAssetPath(src).toLowerCase();
+    if (!path)
+        return false;
+    const dot = path.lastIndexOf(".");
+    return dot >= 0 && SUPPORTED_VOLUME_IMAGE_EXTENSIONS.has(path.slice(dot));
+}
+function isSupportedVolumeImageContentType(contentType) {
+    return (contentType ?? "").split(";", 1)[0]?.trim().toLowerCase().startsWith("image/") ?? false;
+}
+function isExternalAssetTarget(src) {
+    return /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(src);
+}

package/package.json

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