llm-cli-gateway 2.6.0 → 2.7.0

package/dist/provider-tool-capabilities.d.ts

@@ -0,0 +1,97 @@
+import { type CliInfo } from "./model-registry.js";
+import { type CliType } from "./session-manager.js";
+export interface ProviderToolControl {
+    name?: string;
+    supported: boolean;
+    requestField?: string;
+    cliFlag?: string;
+    behavior: string;
+}
+export type ProviderCapabilityId = CliType | "grok_api";
+export type ProviderKind = "cli" | "api";
+export type UnsupportedInputBehavior = "reject" | "ignored" | "not_supported" | "approval_tracking_only" | "deprecated";
+export type ProviderToolConfidence = "high" | "medium" | "low";
+export type ProviderToolExtractionReason = "exact-tool-section" | "known-tool-name" | "backtick-heuristic" | "low-confidence";
+export interface ProviderSkillCapability {
+    name: string;
+    source: "user" | "bundled";
+    path?: string;
+    description?: string;
+    declaredTools: string[];
+    declaredToolReasons?: Partial<Record<string, ProviderToolExtractionReason>>;
+}
+export interface ProviderNativeToolCapability {
+    name: string;
+    source: string;
+    skillName?: string;
+    path?: string;
+    confidence: ProviderToolConfidence;
+    reason: ProviderToolExtractionReason;
+}
+export interface ProviderConfigSurface {
+    name: string;
+    kind: "file" | "directory" | "env" | "gateway" | "provider";
+    present: boolean;
+    path?: string;
+    entries?: string[];
+    details?: string;
+}
+export interface ProviderUnsupportedInput {
+    input: string;
+    behavior: UnsupportedInputBehavior;
+    details: string;
+}
+export interface ProviderFeatureCapability {
+    supported: boolean;
+    details?: string;
+    values?: string[];
+}
+export type ProviderFeatureMap = Record<string, ProviderFeatureCapability>;
+export interface ProviderCapabilityControls {
+    allowlist: ProviderToolControl;
+    denylist: ProviderToolControl;
+    mcpServers: ProviderToolControl;
+    nativeSkills: ProviderToolControl;
+    [name: string]: ProviderToolControl;
+}
+export interface ProviderToolCapabilities {
+    schemaVersion: "provider-tool-capabilities.v2";
+    generatedAt: string;
+    cli: ProviderCapabilityId;
+    providerKind: ProviderKind;
+    gatewayRequestTools: string[];
+    modelInfo: CliInfo | GrokApiModelInfo;
+    summary: string;
+    controls: ProviderCapabilityControls;
+    features: ProviderFeatureMap;
+    discoveredSkills: ProviderSkillCapability[];
+    discoveredProviderTools: ProviderNativeToolCapability[];
+    configSurfaces: ProviderConfigSurface[];
+    unsupportedInputs: ProviderUnsupportedInput[];
+    warnings: string[];
+    metadata: {
+        deprecatedFields?: Record<string, string>;
+        cacheTtlMs: number;
+    };
+    gatewayRequestTool: string;
+}
+export interface GrokApiModelInfo {
+    description: string;
+    models: Record<string, string>;
+    defaultModel?: string;
+    defaultModelSource?: string;
+    warnings?: string[];
+}
+export interface ProviderCapabilityQuery {
+    cli?: ProviderCapabilityId;
+    includeSkills?: boolean;
+    includeProviderTools?: boolean;
+    includeUnsupported?: boolean;
+    includePaths?: boolean;
+    refresh?: boolean;
+}
+export type ProviderToolCapabilitiesMap = Partial<Record<ProviderCapabilityId, ProviderToolCapabilities>>;
+export declare function getProviderToolCapabilities(queryOrCli?: ProviderCapabilityQuery | ProviderCapabilityId): ProviderToolCapabilitiesMap;
+export declare function getOneProviderToolCapabilities(cli: ProviderCapabilityId, queryOrCli?: ProviderCapabilityQuery | ProviderCapabilityId): ProviderToolCapabilities;
+export declare function clearProviderToolCapabilitiesCache(): void;
+export declare function providerCapabilityIds(): readonly ProviderCapabilityId[];