@aigne/aigne-hub 0.10.0-beta → 0.10.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.10.0-beta.1](https://github.com/AIGNE-io/aigne-framework/compare/aigne-hub-v0.10.0-beta...aigne-hub-v0.10.0-beta.1) (2025-09-23)
+
+
+### Features
+
+* add models method to get available models for aigne hub model ([#532](https://github.com/AIGNE-io/aigne-framework/issues/532)) ([3248646](https://github.com/AIGNE-io/aigne-framework/commit/3248646d248aef5419273adc556bb1f13a7b2a02))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/deepseek bumped to 0.7.46-beta.1
+    * @aigne/doubao bumped to 1.1.0-beta.1
+    * @aigne/gemini bumped to 0.14.0-beta.1
+    * @aigne/ollama bumped to 0.7.46-beta.1
+    * @aigne/open-router bumped to 0.7.46-beta.1
+    * @aigne/openai bumped to 0.16.0-beta.1
+    * @aigne/poe bumped to 1.0.26-beta.1
+    * @aigne/transport bumped to 0.15.9-beta.1
+    * @aigne/xai bumped to 0.7.46-beta.1
+
 ## [0.10.0-beta](https://github.com/AIGNE-io/aigne-framework/compare/aigne-hub-v0.9.6...aigne-hub-v0.10.0-beta) (2025-09-22)
 
 

package/lib/cjs/aigne-hub-image-model.d.ts

@@ -4,6 +4,18 @@ import { type AIGNEHubImageModelOptions } from "./utils/type.js";
 export declare class AIGNEHubImageModel extends ImageModel {
     options: AIGNEHubImageModelOptions;
     constructor(options: AIGNEHubImageModelOptions);
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     protected _client?: Promise<BaseClient>;
     get client(): Promise<BaseClient>;
     private _credential?;

package/lib/cjs/aigne-hub-image-model.js

@@ -8,6 +8,7 @@ const base_client_js_1 = require("@aigne/transport/http-client/base-client.js");
 const ufo_1 = require("ufo");
 const blocklet_js_1 = require("./utils/blocklet.js");
 const constants_js_1 = require("./utils/constants.js");
+const hub_js_1 = require("./utils/hub.js");
 const type_js_1 = require("./utils/type.js");
 class AIGNEHubImageModel extends core_1.ImageModel {
     options;
@@ -16,6 +17,9 @@ class AIGNEHubImageModel extends core_1.ImageModel {
         super();
         this.options = options;
     }
+    async models() {
+        return (0, hub_js_1.getModels)({ baseURL: (await this.credential).url, type: "image" });
+    }
     _client;
     get client() {
         this._client ??= this.credential.then(({ url, apiKey, model }) => {
@@ -26,11 +30,7 @@ class AIGNEHubImageModel extends core_1.ImageModel {
     }
     _credential;
     get credential() {
-        this._credential ??= (0, blocklet_js_1.getAIGNEHubMountPoint)(this.options.url ||
-            this.options.baseURL ||
-            process.env.BLOCKLET_AIGNE_API_URL ||
-            process.env.AIGNE_HUB_API_URL ||
-            constants_js_1.AIGNE_HUB_URL, constants_js_1.AIGNE_HUB_BLOCKLET_DID).then((url) => {
+        this._credential ??= (0, blocklet_js_1.getAIGNEHubMountPoint)(this.options.baseURL || (0, constants_js_1.aigneHubBaseUrl)(), constants_js_1.AIGNE_HUB_BLOCKLET_DID).then((url) => {
             const path = "/api/v2/image";
             const rawCredential = process.env.BLOCKLET_AIGNE_API_CREDENTIAL;
             let credentialOptions = {};

package/lib/cjs/aigne-hub-model.d.ts

@@ -4,6 +4,18 @@ import { type AIGNEHubChatModelOptions } from "./utils/type.js";
 export declare class AIGNEHubChatModel extends ChatModel {
     options: AIGNEHubChatModelOptions;
     constructor(options: AIGNEHubChatModelOptions);
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     protected _client?: Promise<BaseClient>;
     get client(): Promise<BaseClient>;
     private _credential?;

package/lib/cjs/aigne-hub-model.js

@@ -8,6 +8,7 @@ const base_client_js_1 = require("@aigne/transport/http-client/base-client.js");
 const ufo_1 = require("ufo");
 const blocklet_js_1 = require("./utils/blocklet.js");
 const constants_js_1 = require("./utils/constants.js");
+const hub_js_1 = require("./utils/hub.js");
 const type_js_1 = require("./utils/type.js");
 class AIGNEHubChatModel extends core_1.ChatModel {
     options;
@@ -16,6 +17,9 @@ class AIGNEHubChatModel extends core_1.ChatModel {
         super();
         this.options = options;
     }
+    async models() {
+        return (0, hub_js_1.getModels)({ baseURL: (await this.credential).url, type: "chat" });
+    }
     _client;
     get client() {
         this._client ??= this.credential.then(({ url, apiKey, model }) => {
@@ -26,11 +30,7 @@ class AIGNEHubChatModel extends core_1.ChatModel {
     }
     _credential;
     get credential() {
-        this._credential ??= (0, blocklet_js_1.getAIGNEHubMountPoint)(this.options.url ||
-            this.options.baseURL ||
-            process.env.BLOCKLET_AIGNE_API_URL ||
-            process.env.AIGNE_HUB_API_URL ||
-            constants_js_1.AIGNE_HUB_URL, constants_js_1.AIGNE_HUB_BLOCKLET_DID).then((url) => {
+        this._credential ??= (0, blocklet_js_1.getAIGNEHubMountPoint)(this.options.baseURL || (0, constants_js_1.aigneHubBaseUrl)(), constants_js_1.AIGNE_HUB_BLOCKLET_DID).then((url) => {
             const path = "/api/v2/chat";
             const rawCredential = process.env.BLOCKLET_AIGNE_API_CREDENTIAL;
             let credentialOptions = {};

package/lib/cjs/index.d.ts

@@ -7,6 +7,30 @@ export * from "./utils/model.js";
 export declare class AIGNEHubChatModel extends ChatModel {
     options: AIGNEHubChatModelOptions;
     static load(options: AIGNEHubChatModelOptions): Promise<AIGNEHubChatModel>;
+    static models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     constructor(options: AIGNEHubChatModelOptions);
     protected client: ChatModel;
     get credential(): import("@aigne/core/utils/type-utils.js").PromiseOrValue<{
@@ -19,6 +43,30 @@ export declare class AIGNEHubChatModel extends ChatModel {
 export declare class AIGNEHubImageModel extends ImageModel {
     options: AIGNEHubImageModelOptions;
     static load(options: AIGNEHubImageModelOptions): Promise<AIGNEHubImageModel>;
+    static models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     constructor(options: AIGNEHubImageModelOptions);
     protected client: ImageModel;
     get credential(): import("@aigne/core/utils/type-utils.js").PromiseOrValue<{

package/lib/cjs/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIGNEHubImageModel = exports.AIGNEHubChatModel = void 0;
 const core_1 = require("@aigne/core");
+const hub_js_1 = require("./utils/hub.js");
 const model_js_1 = require("./utils/model.js");
 __exportStar(require("./utils/blocklet.js"), exports);
 __exportStar(require("./utils/constants.js"), exports);
@@ -25,6 +26,12 @@ class AIGNEHubChatModel extends core_1.ChatModel {
     static async load(options) {
         return new AIGNEHubChatModel(options);
     }
+    static async models() {
+        return (0, hub_js_1.getModels)({ type: "chat" });
+    }
+    models() {
+        return (0, hub_js_1.getModels)({ type: "chat" });
+    }
     constructor(options) {
         let provider = process.env.BLOCKLET_AIGNE_API_PROVIDER;
         if (!provider && options.model) {
@@ -59,6 +66,12 @@ class AIGNEHubImageModel extends core_1.ImageModel {
     static async load(options) {
         return new AIGNEHubImageModel(options);
     }
+    static async models() {
+        return (0, hub_js_1.getModels)({ type: "image" });
+    }
+    models() {
+        return (0, hub_js_1.getModels)({ type: "image" });
+    }
     constructor(options) {
         let provider = process.env.BLOCKLET_AIGNE_API_PROVIDER;
         if (!provider && options.model) {

package/lib/cjs/utils/constants.d.ts

@@ -2,3 +2,4 @@ export declare const AIGNE_HUB_URL = "https://hub.aigne.io/";
 export declare const AIGNE_HUB_BLOCKLET_DID = "z8ia3xzq2tMq8CRHfaXj1BTYJyYnEcHbqP8cJ";
 export declare const AIGNE_HUB_DEFAULT_MODEL = "openai/gpt-5-mini";
 export declare const AIGNE_HUB_IMAGE_MODEL = "openai/gpt-image-1";
+export declare const aigneHubBaseUrl: () => string;

package/lib/cjs/utils/constants.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIGNE_HUB_IMAGE_MODEL = exports.AIGNE_HUB_DEFAULT_MODEL = exports.AIGNE_HUB_BLOCKLET_DID = exports.AIGNE_HUB_URL = void 0;
+exports.aigneHubBaseUrl = exports.AIGNE_HUB_IMAGE_MODEL = exports.AIGNE_HUB_DEFAULT_MODEL = exports.AIGNE_HUB_BLOCKLET_DID = exports.AIGNE_HUB_URL = void 0;
 exports.AIGNE_HUB_URL = "https://hub.aigne.io/";
 exports.AIGNE_HUB_BLOCKLET_DID = "z8ia3xzq2tMq8CRHfaXj1BTYJyYnEcHbqP8cJ";
 exports.AIGNE_HUB_DEFAULT_MODEL = "openai/gpt-5-mini";
 exports.AIGNE_HUB_IMAGE_MODEL = "openai/gpt-image-1";
+const aigneHubBaseUrl = () => process.env.BLOCKLET_AIGNE_API_URL || process.env.AIGNE_HUB_API_URL || exports.AIGNE_HUB_URL;
+exports.aigneHubBaseUrl = aigneHubBaseUrl;

package/lib/cjs/utils/hub.d.ts

@@ -0,0 +1,16 @@
+export interface GetModelsOptions {
+    baseURL?: string;
+    type?: "image" | "chat" | "embedding";
+}
+export declare function getModels(options: GetModelsOptions): Promise<{
+    type: string;
+    model: string;
+    provider: string;
+    input_credits_per_token: number;
+    output_credits_per_token: number;
+    providerDisplayName: string;
+    status?: {
+        available: boolean;
+    } | null | undefined;
+    modelMetadata?: Record<string, unknown> | null | undefined;
+}[]>;

package/lib/cjs/utils/hub.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getModels = getModels;
+const ufo_1 = require("ufo");
+const zod_1 = require("zod");
+const blocklet_js_1 = require("./blocklet.js");
+const constants_js_1 = require("./constants.js");
+const modelsSchema = zod_1.z.array(zod_1.z.object({
+    model: zod_1.z.string(),
+    type: zod_1.z.string(),
+    provider: zod_1.z.string(),
+    input_credits_per_token: zod_1.z.number(),
+    output_credits_per_token: zod_1.z.number(),
+    modelMetadata: zod_1.z.record(zod_1.z.unknown()).nullish(),
+    providerDisplayName: zod_1.z.string(),
+    status: zod_1.z
+        .object({
+        available: zod_1.z.boolean(),
+    })
+        .nullish(),
+}));
+async function getModels(options) {
+    const url = await (0, blocklet_js_1.getAIGNEHubMountPoint)(options.baseURL || (0, constants_js_1.aigneHubBaseUrl)(), constants_js_1.AIGNE_HUB_BLOCKLET_DID);
+    const response = await fetch((0, ufo_1.withQuery)((0, ufo_1.joinURL)(url, "/api/ai/models"), {
+        type: options.type,
+    }));
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`Failed to fetch models: ${response.status} ${response.statusText} ${text}`);
+    }
+    const json = await response.json().catch((error) => {
+        throw new Error(`Failed to parse response as JSON from ${url}: ${error.message}`);
+    });
+    return modelsSchema.parse(json);
+}

package/lib/cjs/utils/type.d.ts

@@ -29,9 +29,9 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     }>>;
     clientOptions: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
 }, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
     url?: string | undefined;
     apiKey?: string | undefined;
-    model?: string | undefined;
     modelOptions?: {
         parallelToolCalls: boolean;
         model?: string | undefined;
@@ -42,9 +42,9 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     } | undefined;
     clientOptions?: {} | undefined;
 }, {
+    model?: string | undefined;
     url?: string | undefined;
     apiKey?: string | undefined;
-    model?: string | undefined;
     modelOptions?: {
         model?: string | undefined;
         temperature?: number | undefined;
@@ -56,7 +56,6 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     clientOptions?: {} | undefined;
 }>;
 export interface AIGNEHubChatModelOptions extends ChatModelOptions {
-    url?: string;
     baseURL?: string;
     apiKey?: string;
     clientOptions?: OpenAIChatModelOptions["clientOptions"] & {

package/lib/dts/aigne-hub-image-model.d.ts

@@ -4,6 +4,18 @@ import { type AIGNEHubImageModelOptions } from "./utils/type.js";
 export declare class AIGNEHubImageModel extends ImageModel {
     options: AIGNEHubImageModelOptions;
     constructor(options: AIGNEHubImageModelOptions);
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     protected _client?: Promise<BaseClient>;
     get client(): Promise<BaseClient>;
     private _credential?;

package/lib/dts/aigne-hub-model.d.ts

@@ -4,6 +4,18 @@ import { type AIGNEHubChatModelOptions } from "./utils/type.js";
 export declare class AIGNEHubChatModel extends ChatModel {
     options: AIGNEHubChatModelOptions;
     constructor(options: AIGNEHubChatModelOptions);
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     protected _client?: Promise<BaseClient>;
     get client(): Promise<BaseClient>;
     private _credential?;

package/lib/dts/index.d.ts

@@ -7,6 +7,30 @@ export * from "./utils/model.js";
 export declare class AIGNEHubChatModel extends ChatModel {
     options: AIGNEHubChatModelOptions;
     static load(options: AIGNEHubChatModelOptions): Promise<AIGNEHubChatModel>;
+    static models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     constructor(options: AIGNEHubChatModelOptions);
     protected client: ChatModel;
     get credential(): import("@aigne/core/utils/type-utils.js").PromiseOrValue<{
@@ -19,6 +43,30 @@ export declare class AIGNEHubChatModel extends ChatModel {
 export declare class AIGNEHubImageModel extends ImageModel {
     options: AIGNEHubImageModelOptions;
     static load(options: AIGNEHubImageModelOptions): Promise<AIGNEHubImageModel>;
+    static models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     constructor(options: AIGNEHubImageModelOptions);
     protected client: ImageModel;
     get credential(): import("@aigne/core/utils/type-utils.js").PromiseOrValue<{

package/lib/dts/utils/constants.d.ts

@@ -2,3 +2,4 @@ export declare const AIGNE_HUB_URL = "https://hub.aigne.io/";
 export declare const AIGNE_HUB_BLOCKLET_DID = "z8ia3xzq2tMq8CRHfaXj1BTYJyYnEcHbqP8cJ";
 export declare const AIGNE_HUB_DEFAULT_MODEL = "openai/gpt-5-mini";
 export declare const AIGNE_HUB_IMAGE_MODEL = "openai/gpt-image-1";
+export declare const aigneHubBaseUrl: () => string;

package/lib/dts/utils/hub.d.ts

@@ -0,0 +1,16 @@
+export interface GetModelsOptions {
+    baseURL?: string;
+    type?: "image" | "chat" | "embedding";
+}
+export declare function getModels(options: GetModelsOptions): Promise<{
+    type: string;
+    model: string;
+    provider: string;
+    input_credits_per_token: number;
+    output_credits_per_token: number;
+    providerDisplayName: string;
+    status?: {
+        available: boolean;
+    } | null | undefined;
+    modelMetadata?: Record<string, unknown> | null | undefined;
+}[]>;

package/lib/dts/utils/type.d.ts

@@ -29,9 +29,9 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     }>>;
     clientOptions: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
 }, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
     url?: string | undefined;
     apiKey?: string | undefined;
-    model?: string | undefined;
     modelOptions?: {
         parallelToolCalls: boolean;
         model?: string | undefined;
@@ -42,9 +42,9 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     } | undefined;
     clientOptions?: {} | undefined;
 }, {
+    model?: string | undefined;
     url?: string | undefined;
     apiKey?: string | undefined;
-    model?: string | undefined;
     modelOptions?: {
         model?: string | undefined;
         temperature?: number | undefined;
@@ -56,7 +56,6 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     clientOptions?: {} | undefined;
 }>;
 export interface AIGNEHubChatModelOptions extends ChatModelOptions {
-    url?: string;
     baseURL?: string;
     apiKey?: string;
     clientOptions?: OpenAIChatModelOptions["clientOptions"] & {

package/lib/esm/aigne-hub-image-model.d.ts

@@ -4,6 +4,18 @@ import { type AIGNEHubImageModelOptions } from "./utils/type.js";
 export declare class AIGNEHubImageModel extends ImageModel {
     options: AIGNEHubImageModelOptions;
     constructor(options: AIGNEHubImageModelOptions);
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     protected _client?: Promise<BaseClient>;
     get client(): Promise<BaseClient>;
     private _credential?;

package/lib/esm/aigne-hub-image-model.js

@@ -4,7 +4,8 @@ import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
 import { BaseClient, } from "@aigne/transport/http-client/base-client.js";
 import { joinURL } from "ufo";
 import { getAIGNEHubMountPoint } from "./utils/blocklet.js";
-import { AIGNE_HUB_BLOCKLET_DID, AIGNE_HUB_IMAGE_MODEL, AIGNE_HUB_URL } from "./utils/constants.js";
+import { AIGNE_HUB_BLOCKLET_DID, AIGNE_HUB_IMAGE_MODEL, aigneHubBaseUrl, } from "./utils/constants.js";
+import { getModels } from "./utils/hub.js";
 import { aigneHubModelOptionsSchema } from "./utils/type.js";
 export class AIGNEHubImageModel extends ImageModel {
     options;
@@ -13,6 +14,9 @@ export class AIGNEHubImageModel extends ImageModel {
         super();
         this.options = options;
     }
+    async models() {
+        return getModels({ baseURL: (await this.credential).url, type: "image" });
+    }
     _client;
     get client() {
         this._client ??= this.credential.then(({ url, apiKey, model }) => {
@@ -23,11 +27,7 @@ export class AIGNEHubImageModel extends ImageModel {
     }
     _credential;
     get credential() {
-        this._credential ??= getAIGNEHubMountPoint(this.options.url ||
-            this.options.baseURL ||
-            process.env.BLOCKLET_AIGNE_API_URL ||
-            process.env.AIGNE_HUB_API_URL ||
-            AIGNE_HUB_URL, AIGNE_HUB_BLOCKLET_DID).then((url) => {
+        this._credential ??= getAIGNEHubMountPoint(this.options.baseURL || aigneHubBaseUrl(), AIGNE_HUB_BLOCKLET_DID).then((url) => {
             const path = "/api/v2/image";
             const rawCredential = process.env.BLOCKLET_AIGNE_API_CREDENTIAL;
             let credentialOptions = {};

package/lib/esm/aigne-hub-model.d.ts

@@ -4,6 +4,18 @@ import { type AIGNEHubChatModelOptions } from "./utils/type.js";
 export declare class AIGNEHubChatModel extends ChatModel {
     options: AIGNEHubChatModelOptions;
     constructor(options: AIGNEHubChatModelOptions);
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     protected _client?: Promise<BaseClient>;
     get client(): Promise<BaseClient>;
     private _credential?;

package/lib/esm/aigne-hub-model.js

@@ -4,7 +4,8 @@ import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
 import { BaseClient, } from "@aigne/transport/http-client/base-client.js";
 import { joinURL } from "ufo";
 import { getAIGNEHubMountPoint } from "./utils/blocklet.js";
-import { AIGNE_HUB_BLOCKLET_DID, AIGNE_HUB_DEFAULT_MODEL, AIGNE_HUB_URL, } from "./utils/constants.js";
+import { AIGNE_HUB_BLOCKLET_DID, AIGNE_HUB_DEFAULT_MODEL, aigneHubBaseUrl, } from "./utils/constants.js";
+import { getModels } from "./utils/hub.js";
 import { aigneHubModelOptionsSchema } from "./utils/type.js";
 export class AIGNEHubChatModel extends ChatModel {
     options;
@@ -13,6 +14,9 @@ export class AIGNEHubChatModel extends ChatModel {
         super();
         this.options = options;
     }
+    async models() {
+        return getModels({ baseURL: (await this.credential).url, type: "chat" });
+    }
     _client;
     get client() {
         this._client ??= this.credential.then(({ url, apiKey, model }) => {
@@ -23,11 +27,7 @@ export class AIGNEHubChatModel extends ChatModel {
     }
     _credential;
     get credential() {
-        this._credential ??= getAIGNEHubMountPoint(this.options.url ||
-            this.options.baseURL ||
-            process.env.BLOCKLET_AIGNE_API_URL ||
-            process.env.AIGNE_HUB_API_URL ||
-            AIGNE_HUB_URL, AIGNE_HUB_BLOCKLET_DID).then((url) => {
+        this._credential ??= getAIGNEHubMountPoint(this.options.baseURL || aigneHubBaseUrl(), AIGNE_HUB_BLOCKLET_DID).then((url) => {
             const path = "/api/v2/chat";
             const rawCredential = process.env.BLOCKLET_AIGNE_API_CREDENTIAL;
             let credentialOptions = {};

package/lib/esm/index.d.ts

@@ -7,6 +7,30 @@ export * from "./utils/model.js";
 export declare class AIGNEHubChatModel extends ChatModel {
     options: AIGNEHubChatModelOptions;
     static load(options: AIGNEHubChatModelOptions): Promise<AIGNEHubChatModel>;
+    static models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     constructor(options: AIGNEHubChatModelOptions);
     protected client: ChatModel;
     get credential(): import("@aigne/core/utils/type-utils.js").PromiseOrValue<{
@@ -19,6 +43,30 @@ export declare class AIGNEHubChatModel extends ChatModel {
 export declare class AIGNEHubImageModel extends ImageModel {
     options: AIGNEHubImageModelOptions;
     static load(options: AIGNEHubImageModelOptions): Promise<AIGNEHubImageModel>;
+    static models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
+    models(): Promise<{
+        type: string;
+        model: string;
+        provider: string;
+        input_credits_per_token: number;
+        output_credits_per_token: number;
+        providerDisplayName: string;
+        status?: {
+            available: boolean;
+        } | null | undefined;
+        modelMetadata?: Record<string, unknown> | null | undefined;
+    }[]>;
     constructor(options: AIGNEHubImageModelOptions);
     protected client: ImageModel;
     get credential(): import("@aigne/core/utils/type-utils.js").PromiseOrValue<{

package/lib/esm/index.js

@@ -1,4 +1,5 @@
 import { ChatModel, ImageModel, } from "@aigne/core";
+import { getModels } from "./utils/hub.js";
 import { findImageModel, findModel, parseModel } from "./utils/model.js";
 export * from "./utils/blocklet.js";
 export * from "./utils/constants.js";
@@ -8,6 +9,12 @@ export class AIGNEHubChatModel extends ChatModel {
     static async load(options) {
         return new AIGNEHubChatModel(options);
     }
+    static async models() {
+        return getModels({ type: "chat" });
+    }
+    models() {
+        return getModels({ type: "chat" });
+    }
     constructor(options) {
         let provider = process.env.BLOCKLET_AIGNE_API_PROVIDER;
         if (!provider && options.model) {
@@ -41,6 +48,12 @@ export class AIGNEHubImageModel extends ImageModel {
     static async load(options) {
         return new AIGNEHubImageModel(options);
     }
+    static async models() {
+        return getModels({ type: "image" });
+    }
+    models() {
+        return getModels({ type: "image" });
+    }
     constructor(options) {
         let provider = process.env.BLOCKLET_AIGNE_API_PROVIDER;
         if (!provider && options.model) {

package/lib/esm/utils/constants.d.ts

@@ -2,3 +2,4 @@ export declare const AIGNE_HUB_URL = "https://hub.aigne.io/";
 export declare const AIGNE_HUB_BLOCKLET_DID = "z8ia3xzq2tMq8CRHfaXj1BTYJyYnEcHbqP8cJ";
 export declare const AIGNE_HUB_DEFAULT_MODEL = "openai/gpt-5-mini";
 export declare const AIGNE_HUB_IMAGE_MODEL = "openai/gpt-image-1";
+export declare const aigneHubBaseUrl: () => string;

package/lib/esm/utils/constants.js

@@ -2,3 +2,4 @@ export const AIGNE_HUB_URL = "https://hub.aigne.io/";
 export const AIGNE_HUB_BLOCKLET_DID = "z8ia3xzq2tMq8CRHfaXj1BTYJyYnEcHbqP8cJ";
 export const AIGNE_HUB_DEFAULT_MODEL = "openai/gpt-5-mini";
 export const AIGNE_HUB_IMAGE_MODEL = "openai/gpt-image-1";
+export const aigneHubBaseUrl = () => process.env.BLOCKLET_AIGNE_API_URL || process.env.AIGNE_HUB_API_URL || AIGNE_HUB_URL;

package/lib/esm/utils/hub.d.ts

@@ -0,0 +1,16 @@
+export interface GetModelsOptions {
+    baseURL?: string;
+    type?: "image" | "chat" | "embedding";
+}
+export declare function getModels(options: GetModelsOptions): Promise<{
+    type: string;
+    model: string;
+    provider: string;
+    input_credits_per_token: number;
+    output_credits_per_token: number;
+    providerDisplayName: string;
+    status?: {
+        available: boolean;
+    } | null | undefined;
+    modelMetadata?: Record<string, unknown> | null | undefined;
+}[]>;

package/lib/esm/utils/hub.js

@@ -0,0 +1,32 @@
+import { joinURL, withQuery } from "ufo";
+import { z } from "zod";
+import { getAIGNEHubMountPoint } from "./blocklet.js";
+import { AIGNE_HUB_BLOCKLET_DID, aigneHubBaseUrl } from "./constants.js";
+const modelsSchema = z.array(z.object({
+    model: z.string(),
+    type: z.string(),
+    provider: z.string(),
+    input_credits_per_token: z.number(),
+    output_credits_per_token: z.number(),
+    modelMetadata: z.record(z.unknown()).nullish(),
+    providerDisplayName: z.string(),
+    status: z
+        .object({
+        available: z.boolean(),
+    })
+        .nullish(),
+}));
+export async function getModels(options) {
+    const url = await getAIGNEHubMountPoint(options.baseURL || aigneHubBaseUrl(), AIGNE_HUB_BLOCKLET_DID);
+    const response = await fetch(withQuery(joinURL(url, "/api/ai/models"), {
+        type: options.type,
+    }));
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`Failed to fetch models: ${response.status} ${response.statusText} ${text}`);
+    }
+    const json = await response.json().catch((error) => {
+        throw new Error(`Failed to parse response as JSON from ${url}: ${error.message}`);
+    });
+    return modelsSchema.parse(json);
+}

package/lib/esm/utils/type.d.ts

@@ -29,9 +29,9 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     }>>;
     clientOptions: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
 }, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
     url?: string | undefined;
     apiKey?: string | undefined;
-    model?: string | undefined;
     modelOptions?: {
         parallelToolCalls: boolean;
         model?: string | undefined;
@@ -42,9 +42,9 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     } | undefined;
     clientOptions?: {} | undefined;
 }, {
+    model?: string | undefined;
     url?: string | undefined;
     apiKey?: string | undefined;
-    model?: string | undefined;
     modelOptions?: {
         model?: string | undefined;
         temperature?: number | undefined;
@@ -56,7 +56,6 @@ export declare const aigneHubModelOptionsSchema: z.ZodObject<{
     clientOptions?: {} | undefined;
 }>;
 export interface AIGNEHubChatModelOptions extends ChatModelOptions {
-    url?: string;
     baseURL?: string;
     apiKey?: string;
     clientOptions?: OpenAIChatModelOptions["clientOptions"] & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/aigne-hub",
-  "version": "0.10.0-beta",
+  "version": "0.10.0-beta.1",
   "description": "AIGNE Hub SDK for integrating with Hub AI models",
   "publishConfig": {
     "access": "public"
@@ -40,19 +40,19 @@
     "ufo": "^1.6.1",
     "zod": "^3.25.67",
     "@aigne/anthropic": "^0.13.5-beta",
-    "@aigne/core": "^1.61.0-beta",
     "@aigne/bedrock": "^0.10.5-beta",
-    "@aigne/deepseek": "^0.7.46-beta",
-    "@aigne/doubao": "^1.1.0-beta",
-    "@aigne/gemini": "^0.14.0-beta",
-    "@aigne/ollama": "^0.7.46-beta",
-    "@aigne/ideogram": "^0.4.0-beta",
-    "@aigne/openai": "^0.16.0-beta",
-    "@aigne/open-router": "^0.7.46-beta",
+    "@aigne/deepseek": "^0.7.46-beta.1",
+    "@aigne/doubao": "^1.1.0-beta.1",
+    "@aigne/core": "^1.61.0-beta",
+    "@aigne/gemini": "^0.14.0-beta.1",
+    "@aigne/ollama": "^0.7.46-beta.1",
+    "@aigne/open-router": "^0.7.46-beta.1",
+    "@aigne/openai": "^0.16.0-beta.1",
     "@aigne/platform-helpers": "^0.6.3-beta",
-    "@aigne/poe": "^1.0.26-beta",
-    "@aigne/xai": "^0.7.46-beta",
-    "@aigne/transport": "^0.15.9-beta"
+    "@aigne/ideogram": "^0.4.0-beta",
+    "@aigne/poe": "^1.0.26-beta.1",
+    "@aigne/transport": "^0.15.9-beta.1",
+    "@aigne/xai": "^0.7.46-beta.1"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",