pi-provider-litellm 3.2.0 → 3.3.0

package/src/types.ts

@@ -1,5 +1,6 @@
 import type { Model } from "@earendil-works/pi-ai";
 import type { BackendFamily, LITELLM_DISCOVERY_VERSION } from "./backend-identity.js";
+import type { ProxyVersion } from "./proxy-version.js";
 
 export type DiscoverySource = "model_info" | "models_list" | "health";
 
@@ -56,6 +57,9 @@ export type LiteLLMModel = Model<LiteLLMApi> & {
 export interface DiscoveryResult {
   models: DiscoveredModel[];
   source: DiscoverySource;
+  // Present only when a `/model/info` discovery had to read it and the proxy
+  // answered. Absent means unknown, not old: discovery asks only when it must.
+  proxyVersion?: ProxyVersion;
 }
 
 export interface DiscoveryOptions {
@@ -138,6 +142,14 @@ export interface ResolvedCredentials {
   apiKeyFromGcloudAdc?: boolean;
 }
 
+// The boolean MCP tool annotation hints, with the meaning Pi gives `ToolAnnotations`.
+export interface McpToolAnnotations {
+  readOnlyHint?: boolean;
+  destructiveHint?: boolean;
+  idempotentHint?: boolean;
+  openWorldHint?: boolean;
+}
+
 export interface LiteLLMMcpTool {
   name: string;
   server_name: string;
@@ -147,6 +159,10 @@ export interface LiteLLMMcpTool {
   input_schema: Record<string, unknown>;
   // True when the proxy supplied an `inputSchema`/`input_schema` that was not a JSON object.
   input_schema_malformed?: boolean;
+  // Boolean hints from the proxy-supplied `annotations`; every other annotation field is dropped.
+  annotations?: McpToolAnnotations;
+  // `mcp_info.description` of the server, when the proxy supplies one.
+  server_description?: string;
 }
 
 export interface LiteLLMSkill {