@agentionai/agents 1.4.0 → 1.5.0

package/README.md

@@ -75,7 +75,7 @@ import { ClaudeAgent, OpenAiAgent } from '@agentionai/agents';
 
 ## Features
 
-- **Multi-Provider, No Lock-in** - Claude, OpenAI, Gemini, Mistral, plus local models via Ollama and llama.cpp—same interface. Switch models with one line.
+- **Multi-Provider, No Lock-in** - Claude, OpenAI, Gemini, Mistral, plus local models via Ollama and llama.cpp—same interface. Switch models with one line. `listModels()` asks any provider what it currently offers, in one shared shape.
 - **Composable Context Management** - Tool result masking (lossless, free) + rolling summarization (auto-firing) + sub-agent delegation (token isolation by architecture).
 - **Streaming** - `executeStream()` on Claude, OpenAI, and all OpenAI-compatible agents. Yields `{ type: "text" | "reasoning" }` chunks; tool calls handled transparently.
 - **Built-In Tools** - Use provider-defined server-side tools (e.g. Anthropic's web search, bash, text editor) alongside your own.

package/dist/agents/BaseAgent.d.ts

@@ -67,6 +67,41 @@ export type TokenUsage = {
      */
     outputTokensPerSecond?: number;
 };
+/**
+ * A model as reported by a provider's models endpoint, in a shape that is the
+ * same on every provider.
+ *
+ * Only `id` — the value you pass as `model` in an agent config — is guaranteed.
+ * Every other field is optional because no two providers report the same set:
+ * Anthropic gives a display name and release date but no context window,
+ * OpenAI gives an owner and a creation timestamp, Mistral and Gemini give
+ * context limits. The provider's own untouched entry is always available on
+ * `raw` for anything not covered here.
+ */
+export type ModelInfo<TRaw = unknown> = {
+    /** Model identifier, as passed to the API in the `model` field. */
+    id: string;
+    /** Human-readable name, where the provider reports one. */
+    displayName?: string;
+    /** Release or creation date, where the provider reports one. */
+    created?: Date;
+    /** Owning organisation, where the provider reports one. */
+    ownedBy?: string;
+    /** Maximum input context in tokens, where the provider reports one. */
+    contextLength?: number;
+    /**
+     * Whether the model is currently held in memory, on servers that distinguish
+     * "offered" from "loaded" — llama.cpp's model router being the case in point,
+     * where an unloaded model is listed but has to be loaded before it answers.
+     *
+     * Undefined wherever the distinction does not exist or is not reported: every
+     * hosted provider, and a single-model `llama-server`, where the one model
+     * listed is by definition the loaded one.
+     */
+    loaded?: boolean;
+    /** The provider's unmodified entry for this model. */
+    raw: TRaw;
+};
 /**
  * The base agent is what the other agents are inheriting from
  * Handles the BaseConfig
@@ -107,6 +142,19 @@ export declare abstract class BaseAgent<TInput = unknown, TOutput = unknown> ext
     protected abstract process(input: TInput): Promise<TOutput>;
     protected abstract handleResponse(response: unknown): Promise<unknown>;
     protected getToolDefinitions(): unknown[];
+    /**
+     * List the models the provider currently offers, straight from its models
+     * endpoint — the live answer, as opposed to the hand-maintained unions in
+     * `model-types.ts`.
+     *
+     * Overridden by every built-in agent; the base implementation throws so that
+     * a custom agent without a models endpoint fails with a clear message rather
+     * than silently returning nothing.
+     *
+     * @throws {ExecutionError} If the provider does not support listing, or the
+     *                          request fails.
+     */
+    listModels(): Promise<ModelInfo[]>;
     /**
      * Add an entry to history
      */

package/dist/agents/BaseAgent.js

@@ -7,6 +7,7 @@ exports.BaseAgent = void 0;
 const events_1 = __importDefault(require("events"));
 const Tool_1 = require("../tools/Tool");
 const History_1 = require("../history/History");
+const AgentError_1 = require("./errors/AgentError");
 /**
  * The base agent is what the other agents are inheriting from
  * Handles the BaseConfig
@@ -49,6 +50,21 @@ class BaseAgent extends events_1.default {
     getToolDefinitions() {
         return Array.from(this.tools.values()).map((tool) => tool.getPrompt());
     }
+    /**
+     * List the models the provider currently offers, straight from its models
+     * endpoint — the live answer, as opposed to the hand-maintained unions in
+     * `model-types.ts`.
+     *
+     * Overridden by every built-in agent; the base implementation throws so that
+     * a custom agent without a models endpoint fails with a clear message rather
+     * than silently returning nothing.
+     *
+     * @throws {ExecutionError} If the provider does not support listing, or the
+     *                          request fails.
+     */
+    async listModels() {
+        throw new AgentError_1.ExecutionError(`listModels() is not implemented for the '${this.vendor}' agent`);
+    }
     /**
      * Add an entry to history
      */

package/dist/agents/anthropic/ClaudeAgent.d.ts

@@ -1,8 +1,8 @@
 import { Anthropic } from "@anthropic-ai/sdk";
-import { Message, ToolUnion, Usage } from "@anthropic-ai/sdk/resources";
+import { Message, type ModelInfo as AnthropicModelInfo, ToolUnion, Usage } from "@anthropic-ai/sdk/resources";
 import { type ToolDefinition } from "../../tools/Tool";
 import { type BuiltInTool } from "../../tools/BuiltInTool";
-import { BaseAgent, BaseAgentConfig, TokenUsage } from "../BaseAgent";
+import { BaseAgent, BaseAgentConfig, ModelInfo, TokenUsage } from "../BaseAgent";
 import { History, MessageContent } from "../../history/History";
 import { StreamChunk } from "../openai-compatible/OpenAICompatibleAgent";
 import { ClaudeModel } from "../model-types";
@@ -55,6 +55,14 @@ export declare class ClaudeAgent extends BaseAgent {
     private currentToolCallCount;
     constructor(config: Omit<AgentConfig, "vendor">, history?: History);
     protected getToolDefinitions(): ToolDefinition[];
+    /**
+     * List the models available to this API key, newest first.
+     *
+     * Anthropic reports a display name and release date but no context window,
+     * so `contextLength` is always undefined here. The result is fully
+     * paginated — the endpoint pages at 1000 models.
+     */
+    listModels(): Promise<ModelInfo<AnthropicModelInfo>[]>;
     /**
      * Combine locally-executed tool definitions with provider-defined
      * (server-side) built-in tools, in the shape Anthropic's API expects.

package/dist/agents/anthropic/ClaudeAgent.js

@@ -62,6 +62,30 @@ class ClaudeAgent extends BaseAgent_1.BaseAgent {
     getToolDefinitions() {
         return Array.from(this.tools.values()).map((tool) => tool.getPrompt());
     }
+    /**
+     * List the models available to this API key, newest first.
+     *
+     * Anthropic reports a display name and release date but no context window,
+     * so `contextLength` is always undefined here. The result is fully
+     * paginated — the endpoint pages at 1000 models.
+     */
+    async listModels() {
+        try {
+            const models = [];
+            for await (const model of this.client.models.list({ limit: 1000 })) {
+                models.push({
+                    id: model.id,
+                    displayName: model.display_name,
+                    created: new Date(model.created_at),
+                    raw: model,
+                });
+            }
+            return models;
+        }
+        catch (error) {
+            throw new AgentError_1.ExecutionError(`Failed to list Anthropic models: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
     /**
      * Combine locally-executed tool definitions with provider-defined
      * (server-side) built-in tools, in the shape Anthropic's API expects.

package/dist/agents/google/GeminiAgent.d.ts

@@ -1,7 +1,29 @@
 import { FunctionDeclarationsTool, GenerateContentResult, Schema } from "@google/generative-ai";
-import { BaseAgent, BaseAgentConfig, TokenUsage } from "../BaseAgent";
+import { BaseAgent, BaseAgentConfig, ModelInfo, TokenUsage } from "../BaseAgent";
 import { History, MessageContent } from "../../history/History";
 import { GeminiModel } from "../model-types";
+/**
+ * One entry from the Generative Language API's `models.list` response.
+ *
+ * Declared here rather than imported: `@google/generative-ai` only covers
+ * content generation and ships no type for the models endpoint.
+ */
+export type GeminiModelCard = {
+    /** Resource name, e.g. `"models/gemini-flash-latest"`. */
+    name: string;
+    baseModelId?: string;
+    version?: string;
+    displayName?: string;
+    description?: string;
+    inputTokenLimit?: number;
+    outputTokenLimit?: number;
+    /** e.g. `["generateContent", "countTokens"]` — an embedding model has neither. */
+    supportedGenerationMethods?: string[];
+    temperature?: number;
+    maxTemperature?: number;
+    topP?: number;
+    topK?: number;
+};
 type AgentConfig = BaseAgentConfig & {
     apiKey: string;
     model?: GeminiModel;
@@ -34,6 +56,18 @@ export declare class GeminiAgent extends BaseAgent {
     /** Count of tool calls in current execution */
     private currentToolCallCount;
     constructor(config: Omit<AgentConfig, "vendor">, history?: History);
+    /**
+     * List the models available to this API key.
+     *
+     * Issued as a direct request to `/v1beta/models`: `@google/generative-ai`
+     * exposes no models endpoint, so there is no client method to call. Every
+     * page is followed, and the `"models/"` prefix is stripped from `id` so the
+     * value can be passed straight back as an agent's `model`.
+     *
+     * The list includes embedding models; filter on
+     * `raw.supportedGenerationMethods` for the ones this agent can drive.
+     */
+    listModels(): Promise<ModelInfo<GeminiModelCard>[]>;
     protected getToolDefinitionsForGemini(): FunctionDeclarationsTool | undefined;
     /**
      * Convert JSON Schema to Gemini's FunctionDeclarationSchema format

package/dist/agents/google/GeminiAgent.js

@@ -8,6 +8,8 @@ const AgentError_1 = require("../errors/AgentError");
 const transformers_1 = require("../../history/transformers");
 const VizReporter_1 = require("../../viz/VizReporter");
 const VizConfig_1 = require("../../viz/VizConfig");
+/** Base URL of the Generative Language API, matching the SDK's own default. */
+const GEMINI_API_BASE = "https://generativelanguage.googleapis.com";
 /**
  * Agent for Google Gemini models.
  *
@@ -45,12 +47,60 @@ class GeminiAgent extends BaseAgent_1.BaseAgent {
             candidateCount,
             responseMimeType,
             responseSchema,
+            defaultHeaders: config.defaultHeaders,
         };
         // Initialize the model
         this.generativeModel = this.client.getGenerativeModel({ model: this.config.model }, config.defaultHeaders ? { customHeaders: config.defaultHeaders } : undefined);
         // Add system message to history (skips if already exists with same content)
         this.addSystemMessage(this.getSystemMessage());
     }
+    /**
+     * List the models available to this API key.
+     *
+     * Issued as a direct request to `/v1beta/models`: `@google/generative-ai`
+     * exposes no models endpoint, so there is no client method to call. Every
+     * page is followed, and the `"models/"` prefix is stripped from `id` so the
+     * value can be passed straight back as an agent's `model`.
+     *
+     * The list includes embedding models; filter on
+     * `raw.supportedGenerationMethods` for the ones this agent can drive.
+     */
+    async listModels() {
+        try {
+            const models = [];
+            let pageToken;
+            do {
+                const url = new URL(`${GEMINI_API_BASE}/v1beta/models`);
+                url.searchParams.set("pageSize", "1000");
+                if (pageToken) {
+                    url.searchParams.set("pageToken", pageToken);
+                }
+                const response = await fetch(url, {
+                    headers: {
+                        "x-goog-api-key": this.config.apiKey,
+                        ...this.config.defaultHeaders,
+                    },
+                });
+                if (!response.ok) {
+                    throw new Error(`${response.status} ${response.statusText}: ${await response.text()}`);
+                }
+                const body = (await response.json());
+                for (const model of body.models ?? []) {
+                    models.push({
+                        id: model.name.replace(/^models\//, ""),
+                        displayName: model.displayName,
+                        contextLength: model.inputTokenLimit,
+                        raw: model,
+                    });
+                }
+                pageToken = body.nextPageToken;
+            } while (pageToken);
+            return models;
+        }
+        catch (error) {
+            throw new AgentError_1.ExecutionError(`Failed to list Gemini models: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
     getToolDefinitionsForGemini() {
         const tools = Array.from(this.tools.values());
         if (tools.length === 0) {

package/dist/agents/llamacpp/LlamaCppAgent.d.ts

@@ -1,6 +1,56 @@
+import { Model } from "openai/resources/models";
 import { History } from "../../history/History";
+import { ModelInfo } from "../BaseAgent";
 import { OpenAICompatibleAgent, OpenAICompatibleConfig } from "../openai-compatible/OpenAICompatibleAgent";
 import { LlamaCppModel } from "../model-types";
+/**
+ * The GGUF details `llama-server` reports for a model it has loaded. Absent
+ * from the listing for a model the router knows about but has not loaded.
+ */
+export type LlamaCppModelMeta = {
+    vocab_type?: number;
+    n_vocab?: number;
+    /** Context the model was actually loaded with (`--ctx-size`). */
+    n_ctx?: number;
+    /** Context the model was trained with — its ceiling, not its current size. */
+    n_ctx_train?: number;
+    n_embd?: number;
+    n_params?: number;
+    /** On-disk size in bytes. */
+    size?: number;
+    /** Quantization, e.g. `"Q6_K"`. */
+    ftype?: string;
+};
+/**
+ * One entry from a llama.cpp server's `/v1/models`.
+ *
+ * Everything past the OpenAI-standard fields is optional because it depends on
+ * how the server was started: a single-model `llama-server` reports `meta` for
+ * the model it is serving and nothing else, while a server in model-router mode
+ * lists every model it can serve, each with a `status` saying whether it is
+ * currently loaded. Verified against llama.cpp b10148.
+ */
+export type LlamaCppModelCard = Model & {
+    /** Alternative ids that resolve to this model. */
+    aliases?: string[];
+    tags?: string[];
+    /** Router mode only: whether the model is in memory, and how it is launched. */
+    status?: {
+        value: "loaded" | "unloaded" | (string & {});
+        /** The `llama-server` argv the router uses to bring this model up. */
+        args?: string[];
+        /** The preset block backing this model, as INI text. */
+        preset?: string;
+    };
+    architecture?: {
+        input_modalities?: string[];
+        output_modalities?: string[];
+    };
+    /** Where the router got the model — a config preset or the local HF cache. */
+    source?: "preset" | "cache" | (string & {});
+    can_remove?: boolean;
+    meta?: LlamaCppModelMeta;
+};
 type LlamaCppConfig = Omit<OpenAICompatibleConfig, "baseURL" | "model" | "vendor"> & {
     /** Base URL of the llama.cpp server's OpenAI-compatible API (default: `http://localhost:8080/v1`) */
     baseURL?: string;
@@ -32,6 +82,20 @@ type LlamaCppConfig = Omit<OpenAICompatibleConfig, "baseURL" | "model" | "vendor
 export declare class LlamaCppAgent extends OpenAICompatibleAgent {
     constructor(config: LlamaCppConfig, history?: History);
     protected getVendorName(): string;
+    /**
+     * List the models the server offers, adding the two things llama.cpp reports
+     * beyond the OpenAI-standard fields:
+     *
+     * - `loaded` — in model-router mode a listed model is not necessarily in
+     *   memory; an unloaded one has to be loaded before it answers. Left
+     *   undefined by a single-model server, which reports no status at all.
+     * - `contextLength` — `meta.n_ctx`, the context the model was actually loaded
+     *   with, falling back to the trained ceiling `n_ctx_train`. Only loaded
+     *   models carry `meta`.
+     *
+     * The rest — launch args, presets, modalities, quantization — is on `raw`.
+     */
+    listModels(): Promise<ModelInfo<LlamaCppModelCard>[]>;
 }
 export {};
 //# sourceMappingURL=LlamaCppAgent.d.ts.map

package/dist/agents/llamacpp/LlamaCppAgent.js

@@ -39,6 +39,29 @@ class LlamaCppAgent extends OpenAICompatibleAgent_1.OpenAICompatibleAgent {
     getVendorName() {
         return "llama.cpp";
     }
+    /**
+     * List the models the server offers, adding the two things llama.cpp reports
+     * beyond the OpenAI-standard fields:
+     *
+     * - `loaded` — in model-router mode a listed model is not necessarily in
+     *   memory; an unloaded one has to be loaded before it answers. Left
+     *   undefined by a single-model server, which reports no status at all.
+     * - `contextLength` — `meta.n_ctx`, the context the model was actually loaded
+     *   with, falling back to the trained ceiling `n_ctx_train`. Only loaded
+     *   models carry `meta`.
+     *
+     * The rest — launch args, presets, modalities, quantization — is on `raw`.
+     */
+    async listModels() {
+        const models = (await super.listModels());
+        return models.map((model) => ({
+            ...model,
+            loaded: model.raw.status
+                ? model.raw.status.value === "loaded"
+                : undefined,
+            contextLength: model.raw.meta?.n_ctx ?? model.raw.meta?.n_ctx_train,
+        }));
+    }
 }
 exports.LlamaCppAgent = LlamaCppAgent;
 //# sourceMappingURL=LlamaCppAgent.js.map

package/dist/agents/mistral/MistralAgent.d.ts

@@ -1,7 +1,13 @@
-import { BaseAgent, BaseAgentConfig, TokenUsage } from "../BaseAgent";
+import { BaseAgent, BaseAgentConfig, ModelInfo, TokenUsage } from "../BaseAgent";
 import { History, MessageContent } from "../../history/History";
-import { ChatCompletionResponse, Tool, UsageInfo } from "@mistralai/mistralai/models/components";
+import { ChatCompletionResponse, ModelList, Tool, UsageInfo } from "@mistralai/mistralai/models/components";
 import { MistralModel } from "../model-types";
+/**
+ * One entry from Mistral's `/v1/models` response — a base model card or a
+ * fine-tuned one. Derived from the SDK's `ModelList` rather than imported
+ * directly, since the SDK exports the union under the unhelpful name `Data`.
+ */
+export type MistralModelCard = NonNullable<ModelList["data"]>[number];
 type AgentConfig = BaseAgentConfig & {
     apiKey: string;
     model?: MistralModel;
@@ -44,6 +50,13 @@ export declare class MistralAgent extends BaseAgent {
     /** Count of tool calls in current execution */
     private currentToolCallCount;
     constructor(config: Omit<AgentConfig, "vendor">, history?: History);
+    /**
+     * List the models available to this API key, base and fine-tuned alike.
+     *
+     * Mistral reports a context window, which lands on `contextLength`; the
+     * per-model `capabilities` flags (function calling, vision, …) are on `raw`.
+     */
+    listModels(): Promise<ModelInfo<MistralModelCard>[]>;
     protected getToolDefinitions(): Tool[];
     protected process(_input: string): Promise<string>;
     execute(input: string | MessageContent[]): Promise<string>;

package/dist/agents/mistral/MistralAgent.js

@@ -80,6 +80,28 @@ class MistralAgent extends BaseAgent_1.BaseAgent {
         // Add system message to history (skips if already exists with same content)
         this.addSystemMessage(this.getSystemMessage());
     }
+    /**
+     * List the models available to this API key, base and fine-tuned alike.
+     *
+     * Mistral reports a context window, which lands on `contextLength`; the
+     * per-model `capabilities` flags (function calling, vision, …) are on `raw`.
+     */
+    async listModels() {
+        try {
+            const response = await this.client.models.list();
+            return (response.data ?? []).map((model) => ({
+                id: model.id,
+                displayName: model.name ?? undefined,
+                created: model.created ? new Date(model.created * 1000) : undefined,
+                ownedBy: model.ownedBy,
+                contextLength: model.maxContextLength,
+                raw: model,
+            }));
+        }
+        catch (error) {
+            throw new AgentError_1.ExecutionError(`Failed to list Mistral models: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
     getToolDefinitions() {
         return Array.from(this.tools.values()).map((tool) => ({
             type: components_1.ToolTypes.Function,

package/dist/agents/ollama/OllamaAgent.d.ts

@@ -1,4 +1,4 @@
-import { BaseAgent, BaseAgentConfig, TokenUsage } from "../BaseAgent";
+import { BaseAgent, BaseAgentConfig, ModelInfo, TokenUsage } from "../BaseAgent";
 import { History, MessageContent } from "../../history/History";
 import { OllamaModel } from "../model-types";
 type AgentConfig = BaseAgentConfig & {
@@ -56,8 +56,12 @@ export declare class OllamaAgent extends BaseAgent {
     private getClient;
     /**
      * List the models currently available on the Ollama server.
+     *
+     * `id` is the tag to pass as `model` (e.g. `"llama3.2:latest"`) and `created`
+     * carries the local `modified_at` timestamp — Ollama reports when a model was
+     * last pulled or changed on this machine, not when it was released.
      */
-    listModels(): Promise<OllamaModelInfo[]>;
+    listModels(): Promise<ModelInfo<OllamaModelInfo>[]>;
     protected getToolDefinitions(): OllamaToolDefinition[];
     protected process(_input: string): Promise<string>;
     execute(input: string | MessageContent[]): Promise<string>;

package/dist/agents/ollama/OllamaAgent.js

@@ -113,12 +113,21 @@ class OllamaAgent extends BaseAgent_1.BaseAgent {
     }
     /**
      * List the models currently available on the Ollama server.
+     *
+     * `id` is the tag to pass as `model` (e.g. `"llama3.2:latest"`) and `created`
+     * carries the local `modified_at` timestamp — Ollama reports when a model was
+     * last pulled or changed on this machine, not when it was released.
      */
     async listModels() {
         try {
             const client = await this.getClient();
             const response = await client.list();
-            return response.models;
+            return response.models.map((model) => ({
+                id: model.model,
+                displayName: model.name,
+                created: model.modified_at ? new Date(model.modified_at) : undefined,
+                raw: model,
+            }));
         }
         catch (error) {
             throw new AgentError_1.ExecutionError(`Failed to list Ollama models: ${error instanceof Error ? error.message : "Unknown error"}`);

package/dist/agents/openai/OpenAiAgent.d.ts

@@ -1,6 +1,7 @@
-import { BaseAgent, BaseAgentConfig, TokenUsage } from "../BaseAgent";
+import { BaseAgent, BaseAgentConfig, ModelInfo, TokenUsage } from "../BaseAgent";
 import { History, MessageContent } from "../../history/History";
 import { Tool, Response, ResponseUsage } from "openai/resources/responses/responses";
+import type { Model as OpenAIModelCard } from "openai/resources/models";
 import { OpenAIModel, ReasoningEffort, ReasoningEffortFor } from "../model-types";
 import { StreamChunk } from "../openai-compatible/OpenAICompatibleAgent";
 type AgentConfig<M extends OpenAIModel = OpenAIModel> = BaseAgentConfig & {
@@ -67,6 +68,14 @@ export declare class OpenAiAgent<M extends OpenAIModel = OpenAIModel> extends Ba
     /** Count of tool calls in current execution */
     private currentToolCallCount;
     constructor(config: Omit<AgentConfig<M>, "vendor">, history?: History);
+    /**
+     * List the models available to this API key.
+     *
+     * The list covers everything the key can reach — chat, embedding, audio and
+     * image models alike — so filter by `id` if you only want the ones this
+     * agent can drive.
+     */
+    listModels(): Promise<ModelInfo<OpenAIModelCard>[]>;
     protected getToolDefinitions(): Tool[];
     /**
      * Build the `reasoning` field for a Responses API request, as an object to

package/dist/agents/openai/OpenAiAgent.js

@@ -87,6 +87,27 @@ class OpenAiAgent extends BaseAgent_1.BaseAgent {
         // Add system message to history (skips if already exists with same content)
         this.addSystemMessage(this.getSystemMessage());
     }
+    /**
+     * List the models available to this API key.
+     *
+     * The list covers everything the key can reach — chat, embedding, audio and
+     * image models alike — so filter by `id` if you only want the ones this
+     * agent can drive.
+     */
+    async listModels() {
+        try {
+            const page = await this.client.models.list();
+            return page.data.map((model) => ({
+                id: model.id,
+                created: model.created ? new Date(model.created * 1000) : undefined,
+                ownedBy: model.owned_by,
+                raw: model,
+            }));
+        }
+        catch (error) {
+            throw new AgentError_1.ExecutionError(`Failed to list OpenAI models: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
     getToolDefinitions() {
         return Array.from(this.tools.values()).map((tool) => {
             const prompt = tool.getPrompt();

package/dist/agents/openai-compatible/OpenAICompatibleAgent.d.ts

@@ -1,7 +1,7 @@
 import OpenAI from "openai";
 import { ChatCompletion, ChatCompletionTool } from "openai/resources/chat/completions";
 import { Model } from "openai/resources/models";
-import { BaseAgent, BaseAgentConfig, TokenUsage } from "../BaseAgent";
+import { BaseAgent, BaseAgentConfig, ModelInfo, TokenUsage } from "../BaseAgent";
 import { AgentVendor } from "../AgentConfig";
 import { History, MessageContent } from "../../history/History";
 /**
@@ -43,8 +43,11 @@ export declare abstract class OpenAICompatibleAgent extends BaseAgent {
     protected buildExtraRequestParams(): Record<string, unknown>;
     /**
      * List the models available on the server via the `/v1/models` endpoint.
+     *
+     * Local servers vary in how much they fill in — llama.cpp reports little
+     * beyond the id — so most fields other than `id` are typically undefined.
      */
-    listModels(): Promise<Model[]>;
+    listModels(): Promise<ModelInfo<Model>[]>;
     protected getToolDefinitions(): ChatCompletionTool[];
     protected process(_input: string): Promise<string>;
     execute(input: string | MessageContent[]): Promise<string>;

package/dist/agents/openai-compatible/OpenAICompatibleAgent.js

@@ -50,11 +50,19 @@ class OpenAICompatibleAgent extends BaseAgent_1.BaseAgent {
     }
     /**
      * List the models available on the server via the `/v1/models` endpoint.
+     *
+     * Local servers vary in how much they fill in — llama.cpp reports little
+     * beyond the id — so most fields other than `id` are typically undefined.
      */
     async listModels() {
         try {
             const page = await this.client.models.list();
-            return page.data;
+            return page.data.map((model) => ({
+                id: model.id,
+                created: model.created ? new Date(model.created * 1000) : undefined,
+                ownedBy: model.owned_by,
+                raw: model,
+            }));
         }
         catch (error) {
             throw new AgentError_1.ExecutionError(`Failed to list ${this.getVendorName()} models: ${error instanceof Error ? error.message : "Unknown error"}`);

package/dist/gemini.d.ts

@@ -1,4 +1,5 @@
 export * from "./core";
 export { GeminiAgent } from "./agents/google/GeminiAgent";
+export type { GeminiModelCard } from "./agents/google/GeminiAgent";
 export { geminiTransformer } from "./history/transformers";
 //# sourceMappingURL=gemini.d.ts.map

package/dist/index.d.ts

@@ -2,9 +2,13 @@ export * from "./agents/BaseAgent";
 export * from "./agents/anthropic/ClaudeAgent";
 export { OpenAiAgent } from "./agents/openai/OpenAiAgent";
 export { MistralAgent } from "./agents/mistral/MistralAgent";
+export type { MistralModelCard } from "./agents/mistral/MistralAgent";
 export { GeminiAgent } from "./agents/google/GeminiAgent";
+export type { GeminiModelCard } from "./agents/google/GeminiAgent";
 export { OllamaAgent } from "./agents/ollama/OllamaAgent";
+export type { OllamaModelInfo } from "./agents/ollama/OllamaAgent";
 export { LlamaCppAgent } from "./agents/llamacpp/LlamaCppAgent";
+export type { LlamaCppModelCard, LlamaCppModelMeta, } from "./agents/llamacpp/LlamaCppAgent";
 export { OpenAICompatibleAgent } from "./agents/openai-compatible/OpenAICompatibleAgent";
 export type { OpenAICompatibleConfig, StreamChunk } from "./agents/openai-compatible/OpenAICompatibleAgent";
 export * from "./agents/model-types";

package/dist/llamacpp.d.ts

@@ -1,5 +1,6 @@
 export * from "./core";
 export { LlamaCppAgent } from "./agents/llamacpp/LlamaCppAgent";
+export type { LlamaCppModelCard, LlamaCppModelMeta, } from "./agents/llamacpp/LlamaCppAgent";
 export { OpenAICompatibleAgent } from "./agents/openai-compatible/OpenAICompatibleAgent";
 export type { OpenAICompatibleConfig, StreamChunk } from "./agents/openai-compatible/OpenAICompatibleAgent";
 export { chatCompletionsTransformer } from "./history/transformers";

package/dist/mistral.d.ts

@@ -1,4 +1,5 @@
 export * from "./core";
 export { MistralAgent } from "./agents/mistral/MistralAgent";
+export type { MistralModelCard } from "./agents/mistral/MistralAgent";
 export { mistralTransformer } from "./history/transformers";
 //# sourceMappingURL=mistral.d.ts.map

package/dist/ollama.d.ts

@@ -1,4 +1,5 @@
 export * from "./core";
 export { OllamaAgent } from "./agents/ollama/OllamaAgent";
+export type { OllamaModelInfo } from "./agents/ollama/OllamaAgent";
 export { ollamaTransformer } from "./history/transformers";
 //# sourceMappingURL=ollama.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentionai/agents",
   "author": "Laurent Zuijdwijk",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Agent Library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",