@reveldigital/mcp-graphql-proxy 1.0.0

package/dist/types/cache.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Caching Types
+ *
+ * Cache configuration, entries, and statistics interfaces.
+ */
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    /** Enable caching */
+    enabled: boolean;
+    /** Cache storage backend */
+    storage: CacheStorageType;
+    /** Default TTL in seconds */
+    defaultTtlSeconds: number;
+    /** Maximum cache size in MB */
+    maxSizeMb: number;
+    /** Maximum number of entries */
+    maxEntries?: number;
+    /** Per-operation TTL overrides */
+    operationTtl: OperationTtlConfig;
+    /** Cache key strategy */
+    keyStrategy: CacheKeyStrategy;
+    /** Operations to cache (whitelist) */
+    cacheableOperations: string[];
+    /** Operations to never cache (blacklist) */
+    excludedOperations: string[];
+    /** Redis options if storage is 'redis' */
+    redisOptions?: RedisCacheOptions;
+    /** SQLite options if storage is 'sqlite' */
+    sqliteOptions?: SqliteCacheOptions;
+}
+/**
+ * Cache storage backend types
+ */
+export type CacheStorageType = 'memory' | 'redis' | 'sqlite';
+/**
+ * Per-operation TTL configuration
+ */
+export interface OperationTtlConfig {
+    /** TTL for resource list operations */
+    'resources/list'?: number;
+    /** TTL for resource read operations */
+    'resources/read'?: number;
+    /** TTL for tool list operations */
+    'tools/list'?: number;
+    /** TTL for prompt list operations */
+    'prompts/list'?: number;
+    /** Custom operation TTLs */
+    [operation: string]: number | undefined;
+}
+/**
+ * Cache key generation strategies
+ */
+export type CacheKeyStrategy = 'full-request' | 'method-params' | 'custom';
+/**
+ * Redis cache storage options
+ */
+export interface RedisCacheOptions {
+    /** Redis host */
+    host: string;
+    /** Redis port */
+    port: number;
+    /** Redis password */
+    password?: string;
+    /** Redis database number */
+    db?: number;
+    /** Key prefix for cache data */
+    keyPrefix?: string;
+    /** Connection timeout in milliseconds */
+    connectTimeout?: number;
+}
+/**
+ * SQLite cache storage options
+ */
+export interface SqliteCacheOptions {
+    /** Path to SQLite database file */
+    path: string;
+    /** WAL mode enabled */
+    walMode?: boolean;
+}
+/**
+ * Cache entry structure
+ */
+export interface CacheEntry<T = unknown> {
+    /** Cache key */
+    key: string;
+    /** Cached value */
+    value: T;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Expiration timestamp */
+    expiresAt: Date;
+    /** Hit count for analytics */
+    hitCount: number;
+    /** Last access timestamp */
+    lastAccessedAt: Date;
+    /** Size in bytes */
+    sizeBytes: number;
+    /** Tags for cache invalidation */
+    tags: string[];
+    /** Tenant ID if multi-tenant */
+    tenantId?: string;
+    /** MCP method associated */
+    method?: string;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /** Total cache hits */
+    hits: number;
+    /** Total cache misses */
+    misses: number;
+    /** Hit rate percentage (0-100) */
+    hitRate: number;
+    /** Current entry count */
+    entryCount: number;
+    /** Current size in bytes */
+    sizeBytes: number;
+    /** Maximum size in bytes */
+    maxSizeBytes: number;
+    /** Eviction count */
+    evictions: number;
+    /** Oldest entry timestamp */
+    oldestEntry?: Date;
+    /** Newest entry timestamp */
+    newestEntry?: Date;
+}
+/**
+ * Cache operation result
+ */
+export interface CacheResult<T = unknown> {
+    /** Was the value found in cache? */
+    hit: boolean;
+    /** Cached value if hit */
+    value?: T;
+    /** Cache entry metadata if hit */
+    entry?: CacheEntry<T>;
+    /** Time to retrieve in milliseconds */
+    retrievalTimeMs: number;
+}
+/**
+ * Cache invalidation request
+ */
+export interface CacheInvalidationRequest {
+    /** Invalidation type */
+    type: 'key' | 'pattern' | 'tag' | 'tenant' | 'all';
+    /** Key for 'key' type */
+    key?: string;
+    /** Pattern for 'pattern' type (glob-style) */
+    pattern?: string;
+    /** Tags for 'tag' type */
+    tags?: string[];
+    /** Tenant ID for 'tenant' type */
+    tenantId?: string;
+}
+/**
+ * Default cache configuration
+ */
+export declare const DEFAULT_CACHE_CONFIG: CacheConfig;
+//# sourceMappingURL=cache.d.ts.map

package/dist/types/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/types/cache.ts"],"names":[],"mappings":"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"}

package/dist/types/cache.js

@@ -0,0 +1,34 @@
+/**
+ * Caching Types
+ *
+ * Cache configuration, entries, and statistics interfaces.
+ */
+/**
+ * Default cache configuration
+ */
+export const DEFAULT_CACHE_CONFIG = {
+    enabled: true,
+    storage: 'memory',
+    defaultTtlSeconds: 300, // 5 minutes
+    maxSizeMb: 100,
+    maxEntries: 10000,
+    operationTtl: {
+        'tools/list': 600, // 10 minutes - tool list rarely changes
+        'prompts/list': 600, // 10 minutes
+        'resources/list': 300, // 5 minutes
+        'resources/read': 60, // 1 minute - resource content may change
+    },
+    keyStrategy: 'method-params',
+    cacheableOperations: [
+        'tools/list',
+        'prompts/list',
+        'prompts/get',
+        'resources/list',
+        'resources/read',
+        'resources/templates/list',
+    ],
+    excludedOperations: [
+        'tools/call', // Never cache tool calls - they have side effects
+    ],
+};
+//# sourceMappingURL=cache.js.map

package/dist/types/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/types/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgNH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,QAAQ;IACjB,iBAAiB,EAAE,GAAG,EAAE,YAAY;IACpC,SAAS,EAAE,GAAG;IACd,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE;QACZ,YAAY,EAAE,GAAG,EAAO,wCAAwC;QAChE,cAAc,EAAE,GAAG,EAAK,aAAa;QACrC,gBAAgB,EAAE,GAAG,EAAG,YAAY;QACpC,gBAAgB,EAAE,EAAE,EAAI,yCAAyC;KAClE;IACD,WAAW,EAAE,eAAe;IAC5B,mBAAmB,EAAE;QACnB,YAAY;QACZ,cAAc;QACd,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,0BAA0B;KAC3B;IACD,kBAAkB,EAAE;QAClB,YAAY,EAAE,kDAAkD;KACjE;CACF,CAAC"}

package/dist/types/config.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Core Configuration Types
+ *
+ * Main proxy configuration interfaces defining server, upstream, and feature settings.
+ */
+import type { AuthConfig } from './auth.js';
+import type { CacheConfig } from './cache.js';
+import type { RateLimitConfig } from './rate-limit.js';
+import type { LoggingConfig } from './logging.js';
+import type { MetricsConfig } from './metrics.js';
+import type { TransformationConfig } from './transformation.js';
+import type { TenantConfig } from './tenant.js';
+/**
+ * Main proxy configuration
+ */
+export interface ProxyConfig {
+    /** Proxy server identification */
+    server: ServerConfig;
+    /** Upstream MCP server configuration */
+    upstream: UpstreamConfig;
+    /** Authentication configuration */
+    auth: AuthConfig;
+    /** Caching configuration */
+    cache: CacheConfig;
+    /** Rate limiting configuration */
+    rateLimit: RateLimitConfig;
+    /** Logging configuration */
+    logging: LoggingConfig;
+    /** Metrics configuration */
+    metrics: MetricsConfig;
+    /** Request transformation rules */
+    transformations: TransformationConfig;
+    /** Multi-tenant configuration */
+    tenants: TenantConfig;
+}
+/**
+ * Server identification and transport configuration
+ */
+export interface ServerConfig {
+    /** Proxy name for identification */
+    name: string;
+    /** Proxy version */
+    version: string;
+    /** Transport mode: 'stdio' | 'sse' | 'http' */
+    transport: TransportMode;
+    /** Port for HTTP/SSE modes */
+    port?: number;
+    /** Host binding for HTTP/SSE modes */
+    host?: string;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+}
+/**
+ * Upstream MCP server connection configuration
+ */
+export interface UpstreamConfig {
+    /** Path to reveldigital-mcp-server executable */
+    command: string;
+    /** Command arguments */
+    args: string[];
+    /** Environment variables for upstream process */
+    env: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout: number;
+    /** Retry configuration */
+    retry: RetryConfig;
+    /** Health check configuration */
+    healthCheck: HealthCheckConfig;
+}
+/**
+ * Retry behavior configuration with exponential backoff
+ */
+export interface RetryConfig {
+    /** Maximum retry attempts */
+    maxAttempts: number;
+    /** Initial delay in milliseconds */
+    initialDelayMs: number;
+    /** Maximum delay in milliseconds */
+    maxDelayMs: number;
+    /** Delay multiplier for exponential backoff */
+    multiplier: number;
+    /** Jitter factor (0-1) for randomizing delays */
+    jitterFactor?: number;
+}
+/**
+ * Health check configuration for upstream monitoring
+ */
+export interface HealthCheckConfig {
+    /** Enable health checks */
+    enabled: boolean;
+    /** Check interval in milliseconds */
+    intervalMs: number;
+    /** Timeout for health check */
+    timeoutMs: number;
+    /** Number of failures before marking unhealthy */
+    failureThreshold?: number;
+    /** Number of successes before marking healthy */
+    successThreshold?: number;
+}
+/**
+ * Supported transport modes
+ */
+export type TransportMode = 'stdio' | 'sse' | 'http';
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Partial<ProxyConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,MAAM,EAAE,YAAY,CAAC;IAErB,wCAAwC;IACxC,QAAQ,EAAE,cAAc,CAAC;IAEzB,mCAAmC;IACnC,IAAI,EAAE,UAAU,CAAC;IAEjB,4BAA4B;IAC5B,KAAK,EAAE,WAAW,CAAC;IAEnB,kCAAkC;IAClC,SAAS,EAAE,eAAe,CAAC;IAE3B,4BAA4B;IAC5B,OAAO,EAAE,aAAa,CAAC;IAEvB,4BAA4B;IAC5B,OAAO,EAAE,aAAa,CAAC;IAEvB,mCAAmC;IACnC,eAAe,EAAE,oBAAoB,CAAC;IAEtC,iCAAiC;IACjC,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,SAAS,EAAE,aAAa,CAAC;IAEzB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,KAAK,EAAE,WAAW,CAAC;IAEnB,iCAAiC;IACjC,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,WAAW,CA2B/C,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,37 @@
+/**
+ * Core Configuration Types
+ *
+ * Main proxy configuration interfaces defining server, upstream, and feature settings.
+ */
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    server: {
+        name: 'reveldigital-mcp-proxy',
+        version: '1.0.0',
+        transport: 'stdio',
+        requestTimeout: 30000,
+    },
+    upstream: {
+        command: 'npx',
+        args: ['@reveldigital/reveldigital-mcp-server'],
+        env: {},
+        timeout: 30000,
+        retry: {
+            maxAttempts: 3,
+            initialDelayMs: 1000,
+            maxDelayMs: 10000,
+            multiplier: 2,
+            jitterFactor: 0.1,
+        },
+        healthCheck: {
+            enabled: true,
+            intervalMs: 30000,
+            timeoutMs: 5000,
+            failureThreshold: 3,
+            successThreshold: 1,
+        },
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB;IAClD,MAAM,EAAE;QACN,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,OAAO;QAClB,cAAc,EAAE,KAAK;KACtB;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,uCAAuC,CAAC;QAC/C,GAAG,EAAE,EAAE;QACP,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACL,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,IAAI;YACpB,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,GAAG;SAClB;QACD,WAAW,EAAE;YACX,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,IAAI;YACf,gBAAgB,EAAE,CAAC;YACnB,gBAAgB,EAAE,CAAC;SACpB;KACF;CACF,CAAC"}

package/dist/types/graphql-proxy.d.ts

@@ -0,0 +1,243 @@
+/**
+ * GraphQL Proxy Types
+ *
+ * Simple types for the GraphQL proxy implementation.
+ * These are separate from the enterprise proxy types.
+ */
+import { z } from 'zod';
+/**
+ * Simple proxy configuration for GraphQL endpoint
+ */
+export interface GraphQLProxyConfig {
+    /** GraphQL endpoint URL */
+    endpoint: string;
+    /** Auth token for Authorization: Bearer header authentication */
+    authToken?: string;
+    /** Request timeout in milliseconds */
+    timeout: number;
+    /** Enable response caching */
+    enableCache: boolean;
+    /** Cache TTL in seconds */
+    cacheTtl: number;
+    /** Maximum response size for context optimization */
+    maxResponseSize: number;
+    /** Enable debug logging */
+    debug: boolean;
+}
+/**
+ * Default configuration values
+ */
+export declare const defaultGraphQLProxyConfig: GraphQLProxyConfig;
+/**
+ * GraphQL request structure
+ */
+export interface GraphQLRequest {
+    query: string;
+    variables?: Record<string, unknown>;
+    operationName?: string;
+}
+/**
+ * GraphQL response structure
+ */
+export interface GraphQLResponse<T = unknown> {
+    data?: T;
+    errors?: GraphQLError[];
+}
+/**
+ * GraphQL error structure
+ */
+export interface GraphQLError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: Array<string | number>;
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Simple cache entry for GraphQL responses
+ */
+export interface GraphQLCacheEntry<T = unknown> {
+    data: T;
+    timestamp: number;
+    ttl: number;
+    queryHash: string;
+}
+/**
+ * Simple cache statistics
+ */
+export interface GraphQLCacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    entries: number;
+}
+/**
+ * MCP Tool result structure
+ */
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Create a successful tool result
+ */
+export declare function createToolResult(data: unknown, pretty?: boolean): ToolResult;
+/**
+ * Create an error tool result
+ */
+export declare function createErrorResult(error: string | Error): ToolResult;
+/**
+ * Schema for execute_query tool arguments
+ */
+export declare const ExecuteQuerySchema: z.ZodObject<{
+    query: z.ZodString;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    operationName: z.ZodOptional<z.ZodString>;
+    useCache: z.ZodDefault<z.ZodBoolean>;
+    authHeader: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    useCache: boolean;
+    variables?: Record<string, unknown> | undefined;
+    operationName?: string | undefined;
+    authHeader?: string | undefined;
+}, {
+    query: string;
+    variables?: Record<string, unknown> | undefined;
+    operationName?: string | undefined;
+    useCache?: boolean | undefined;
+    authHeader?: string | undefined;
+}>;
+/**
+ * Schema for build_query tool arguments
+ */
+export declare const BuildQuerySchema: z.ZodObject<{
+    operation: z.ZodEnum<["device", "media", "schedule", "audienceMetrics", "playLogs"]>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    preset: z.ZodOptional<z.ZodEnum<["basic", "detailed", "location", "metrics", "minimal"]>>;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    orderBy: z.ZodOptional<z.ZodString>;
+    orderDirection: z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    deviceId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+}, "strip", z.ZodTypeAny, {
+    operation: "device" | "media" | "schedule" | "audienceMetrics" | "playLogs";
+    filter?: Record<string, unknown> | undefined;
+    fields?: string[] | undefined;
+    preset?: "basic" | "detailed" | "location" | "metrics" | "minimal" | undefined;
+    orderBy?: string | undefined;
+    orderDirection?: "ASC" | "DESC" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    deviceId?: string | string[] | undefined;
+}, {
+    operation: "device" | "media" | "schedule" | "audienceMetrics" | "playLogs";
+    filter?: Record<string, unknown> | undefined;
+    fields?: string[] | undefined;
+    preset?: "basic" | "detailed" | "location" | "metrics" | "minimal" | undefined;
+    orderBy?: string | undefined;
+    orderDirection?: "ASC" | "DESC" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    deviceId?: string | string[] | undefined;
+}>;
+/**
+ * Schema for introspect_schema tool arguments
+ */
+export declare const IntrospectSchemaSchema: z.ZodObject<{
+    typeName: z.ZodOptional<z.ZodString>;
+    includeFields: z.ZodDefault<z.ZodBoolean>;
+    includeDescriptions: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includeFields: boolean;
+    includeDescriptions: boolean;
+    typeName?: string | undefined;
+}, {
+    typeName?: string | undefined;
+    includeFields?: boolean | undefined;
+    includeDescriptions?: boolean | undefined;
+}>;
+/**
+ * Schema for quick_query tool arguments
+ */
+export declare const QuickQuerySchema: z.ZodObject<{
+    queryType: z.ZodEnum<["devices_status", "online_devices", "offline_devices", "recent_media", "active_schedules", "play_logs"]>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    authHeader: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    queryType: "devices_status" | "online_devices" | "offline_devices" | "recent_media" | "active_schedules" | "play_logs";
+    authHeader?: string | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}, {
+    queryType: "devices_status" | "online_devices" | "offline_devices" | "recent_media" | "active_schedules" | "play_logs";
+    authHeader?: string | undefined;
+    limit?: number | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}>;
+/**
+ * Schema for manage_cache tool arguments
+ */
+export declare const ManageCacheSchema: z.ZodObject<{
+    action: z.ZodEnum<["stats", "clear", "cleanup"]>;
+}, "strip", z.ZodTypeAny, {
+    action: "stats" | "clear" | "cleanup";
+}, {
+    action: "stats" | "clear" | "cleanup";
+}>;
+/**
+ * Schema for set_auth tool arguments
+ */
+export declare const SetAuthSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    bearerToken: z.ZodOptional<z.ZodString>;
+    clear: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    clear?: boolean | undefined;
+    apiKey?: string | undefined;
+    bearerToken?: string | undefined;
+}, {
+    clear?: boolean | undefined;
+    apiKey?: string | undefined;
+    bearerToken?: string | undefined;
+}>;
+/**
+ * Schema for optimize_response tool arguments
+ */
+export declare const OptimizeResponseSchema: z.ZodObject<{
+    data: z.ZodUnknown;
+    maxSize: z.ZodOptional<z.ZodNumber>;
+    strategy: z.ZodOptional<z.ZodEnum<["truncate", "summarize", "paginate"]>>;
+}, "strip", z.ZodTypeAny, {
+    data?: unknown;
+    maxSize?: number | undefined;
+    strategy?: "truncate" | "summarize" | "paginate" | undefined;
+}, {
+    data?: unknown;
+    maxSize?: number | undefined;
+    strategy?: "truncate" | "summarize" | "paginate" | undefined;
+}>;
+export type ExecuteQueryArgs = z.infer<typeof ExecuteQuerySchema>;
+export type BuildQueryArgs = z.infer<typeof BuildQuerySchema>;
+export type IntrospectSchemaArgs = z.infer<typeof IntrospectSchemaSchema>;
+export type QuickQueryArgs = z.infer<typeof QuickQuerySchema>;
+export type ManageCacheArgs = z.infer<typeof ManageCacheSchema>;
+export type SetAuthArgs = z.infer<typeof SetAuthSchema>;
+export type OptimizeResponseArgs = z.infer<typeof OptimizeResponseSchema>;
+//# sourceMappingURL=graphql-proxy.d.ts.map

package/dist/types/graphql-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-proxy.d.ts","sourceRoot":"","sources":["../../src/types/graphql-proxy.ts"],"names":[],"mappings":"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"}