@node-i3x/mcp 0.11.2 → 0.12.0

package/dist/in-process.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/similarity.ts","../src/bindings/rest-binding.ts","../src/bindings/connector-binding.ts"],"sourcesContent":["/**\n * Computes a normalized similarity score between two strings (0.0 to 1.0)\n * using Levenshtein edit distance and substring matching.\n */\nexport function computeSimilarity(a: string, b: string): number {\n  const s1 = a.toLowerCase().trim();\n  const s2 = b.toLowerCase().trim();\n\n  if (s1 === s2) return 1.0;\n  if (!s1 || !s2) return 0.0;\n\n  // Exact substring boost\n  if (s1.includes(s2) || s2.includes(s1)) {\n    const ratio = Math.min(s1.length, s2.length) / Math.max(s1.length, s2.length);\n    return Math.max(0.7, ratio);\n  }\n\n  // Levenshtein distance calculation\n  const m = s1.length;\n  const n = s2.length;\n  const dp: number[] = Array.from({ length: n + 1 }, (_, i) => i);\n\n  for (let i = 1; i <= m; i++) {\n    let prev = dp[0]!;\n    dp[0] = i;\n    for (let j = 1; j <= n; j++) {\n      const temp = dp[j]!;\n      const cost = s1[i - 1] === s2[j - 1] ? 0 : 1;\n      dp[j] = Math.min(dp[j]! + 1, dp[j - 1]! + 1, prev + cost);\n      prev = temp;\n    }\n  }\n\n  const distance = dp[n]!;\n  const maxLen = Math.max(m, n);\n  return Math.max(0, 1 - distance / maxLen);\n}\n\n/**\n * Ranks candidate strings by similarity against a target query,\n * returning the top N matches with score >= minScore.\n */\nexport function rankSuggestions(\n  query: string,\n  candidates: string[],\n  topN = 5,\n  minScore = 0.4,\n): string[] {\n  return candidates\n    .map((candidate) => ({\n      candidate,\n      score: computeSimilarity(query, candidate),\n    }))\n    .filter((item) => item.score >= minScore)\n    .sort((a, b) => b.score - a.score)\n    .slice(0, topN)\n    .map((item) => item.candidate);\n}\n\n/** Longer queries are not ids or names someone typed: no fuzzy matching (O(n·m) each). */\nexport const MAX_FUZZY_QUERY_LENGTH = 128;\n\n/**\n * computeSimilarity, or 0 without running Levenshtein when the length difference\n * alone keeps the score under `minScore` (distance >= |m - n|) and neither string\n * contains the other.\n */\nfunction boundedSimilarity(query: string, candidate: string, minScore: number): number {\n  const q = query.toLowerCase().trim();\n  const c = candidate.toLowerCase().trim();\n  if (!q || !c) return 0;\n  if (q.includes(c) || c.includes(q)) return computeSimilarity(q, c);\n  const lengthBound = 1 - Math.abs(q.length - c.length) / Math.max(q.length, c.length);\n  return lengthBound < minScore ? 0 : computeSimilarity(q, c);\n}\n\n/**\n * Ranks objects against a query by the better of their elementId and displayName\n * scores: elementIds are often opaque hashes, so names are what users type.\n */\nexport function rankObjectSuggestions(\n  query: string,\n  objects: ReadonlyArray<{ elementId: string; displayName?: string }>,\n  topN = 5,\n  minScore = 0.4,\n): Array<{ elementId: string; displayName?: string }> {\n  if (query.trim().length > MAX_FUZZY_QUERY_LENGTH) return [];\n  return objects\n    .map(({ elementId, displayName }) => ({\n      elementId,\n      displayName,\n      score: Math.max(\n        boundedSimilarity(query, elementId, minScore),\n        displayName ? boundedSimilarity(query, displayName, minScore) : 0,\n      ),\n    }))\n    .filter((item) => item.score >= minScore)\n    .sort((a, b) => b.score - a.score)\n    .slice(0, topN)\n    .map(({ elementId, displayName }) => ({ elementId, displayName }));\n}\n","import type {\n  BulkResponse,\n  BulkResultItem,\n  CurrentValueResult,\n  HistoricalValueResult,\n  Namespace,\n  ObjectInstanceResponse,\n  ObjectType,\n  RelatedObjectResult,\n  RelationshipType,\n  ServerInfo,\n  SuccessResponse,\n} from '@node-i3x/core';\nimport { MAX_FUZZY_QUERY_LENGTH, rankObjectSuggestions } from '../utils/similarity.js';\nimport type { ElementResult, I3XClientBinding, Suggestion } from './types.js';\n\n/** How long the full object list used for suggestions is reused. */\nconst OBJECT_CACHE_TTL_MS = 60_000;\n\nexport class RestClientBinding implements I3XClientBinding {\n  private readonly baseUrl: string;\n  private readonly headers: Record<string, string>;\n  private readonly requestTimeoutMs: number;\n  private readonly fetchImpl?: typeof fetch;\n  private readonly token?: string;\n  private objectCache?: { at: number; objects: Promise<ObjectInstanceResponse[]> };\n\n  /**\n   * @param fetchImpl - replaces the global fetch, e.g. to route requests into an\n   *   in-process server (see InProcessConnectorBinding).\n   */\n  constructor(\n    baseUrl = 'http://localhost:3000',\n    token?: string,\n    timeoutMs = 15_000,\n    fetchImpl?: typeof fetch,\n  ) {\n    let cleanUrl = baseUrl.trim().replace(/\\/+$/, '');\n    if (!cleanUrl.startsWith('http://') && !cleanUrl.startsWith('https://')) {\n      cleanUrl = `http://${cleanUrl}`;\n    }\n    // i3X base URLs are usually given with the /v1 suffix; every path below adds it.\n    cleanUrl = cleanUrl.replace(/\\/v1$/i, '');\n    this.baseUrl = cleanUrl;\n    this.requestTimeoutMs = timeoutMs;\n    this.fetchImpl = fetchImpl;\n    this.token = token;\n    this.headers = {\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n    };\n    if (token) {\n      this.headers.Authorization = `Bearer ${token}`;\n    }\n  }\n\n  /** Normalized base URL, without a trailing /v1. */\n  getBaseUrl(): string {\n    return this.baseUrl;\n  }\n\n  get hasToken(): boolean {\n    return Boolean(this.token);\n  }\n\n  /**\n   * A binding to `baseUrl`. Without `token`, the current token is kept when the URL\n   * is this binding's own (re-connecting must not silently drop the configured token).\n   */\n  connectTo(baseUrl: string, token?: string): RestClientBinding {\n    // No fetchImpl: a connect targets the network, even from an in-process binding.\n    const next = new RestClientBinding(baseUrl, token, this.requestTimeoutMs);\n    if (token !== undefined || next.baseUrl !== this.baseUrl || !this.token) return next;\n    return new RestClientBinding(baseUrl, this.token, this.requestTimeoutMs);\n  }\n\n  private async request<T>(path: string, options: RequestInit = {}): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const signal = options.signal || AbortSignal.timeout(this.requestTimeoutMs);\n\n    try {\n      const response = await (this.fetchImpl ?? fetch)(url, {\n        ...options,\n        signal,\n        headers: {\n          ...this.headers,\n          ...(options.headers || {}),\n        },\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        const truncated =\n          errorText.length > 300 ? `${errorText.slice(0, 300)}...` : errorText;\n        throw new Error(`HTTP ${response.status} from ${path}: ${truncated}`);\n      }\n\n      return (await response.json()) as T;\n    } catch (err) {\n      if ((err as Error).name === 'TimeoutError') {\n        throw new Error(\n          `i3X Gateway request timed out after ${this.requestTimeoutMs}ms for ${path}`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  /** Unwrap a `{ success, result }` envelope; a `success: false` envelope becomes an error. */\n  private async get<T>(path: string): Promise<T> {\n    const res = await this.request<Partial<SuccessResponse<T>> & ErrorEnvelope>(path);\n    if (res?.success !== true || !('result' in res)) {\n      throw new Error(`i3X request ${path} failed: ${describeFailure(res)}`);\n    }\n    return res.result as T;\n  }\n\n  /**\n   * POST a bulk request and return its `results` items, one per requested elementId.\n   * `success` is false on the envelope as soon as one item failed, so items are\n   * returned as they are; only a body without `results` is an error here.\n   */\n  private async postBulk<T>(path: string, body: unknown): Promise<BulkResultItem<T>[]> {\n    const res = await this.request<Partial<BulkResponse<T>> & ErrorEnvelope>(path, {\n      method: 'POST',\n      body: JSON.stringify(body),\n    });\n    if (!Array.isArray(res?.results)) {\n      throw new Error(`i3X request ${path} failed: ${describeFailure(res)}`);\n    }\n    return res.results;\n  }\n\n  /** Bulk items as per-element results: a failed item keeps its elementId and error. */\n  private async postBulkPerElement<T>(\n    path: string,\n    elementIds: string[],\n    body: Record<string, unknown>,\n  ): Promise<ElementResult<T>[]> {\n    const items = await this.postBulk<T>(path, { elementIds, ...body });\n    return items.map((item, idx) => {\n      const elementId = item.elementId ?? elementIds[idx] ?? `element_${idx}`;\n      if (!item.success) return { elementId, error: describeFailure(item) };\n      // A success without a result would otherwise read as \"no data\" with no warning.\n      if (item.result == null) return { elementId, error: 'Server returned no result' };\n      return { elementId, result: item.result as T };\n    });\n  }\n\n  /** The single item of a one-element bulk request. */\n  private async postBulkOne<T>(\n    path: string,\n    body: { elementIds: [string] } & Record<string, unknown>,\n  ): Promise<BulkResultItem<T>> {\n    const [item] = await this.postBulk<T>(path, body);\n    if (!item) throw new Error(`i3X request ${path} returned no result`);\n    return item;\n  }\n\n  async getInfo(): Promise<ServerInfo> {\n    return this.get<ServerInfo>('/v1/info');\n  }\n\n  async getNamespaces(): Promise<Namespace[]> {\n    return this.get<Namespace[]>('/v1/namespaces');\n  }\n\n  async getObjectTypes(namespaceUri?: string): Promise<ObjectType[]> {\n    const query = namespaceUri ? `?namespaceUri=${encodeURIComponent(namespaceUri)}` : '';\n    return this.get<ObjectType[]>(`/v1/objecttypes${query}`);\n  }\n\n  async getRelationshipTypes(): Promise<RelationshipType[]> {\n    return this.get<RelationshipType[]>('/v1/relationshiptypes');\n  }\n\n  async getObjects(options?: {\n    rootOnly?: boolean;\n    typeElementId?: string;\n  }): Promise<ObjectInstanceResponse[]> {\n    const params = new URLSearchParams();\n    if (options?.rootOnly) params.set('root', 'true');\n    if (options?.typeElementId) params.set('typeElementId', options.typeElementId);\n\n    const query = params.toString() ? `?${params.toString()}` : '';\n    return this.get<ObjectInstanceResponse[]>(`/v1/objects${query}`);\n  }\n\n  /** `null` only when the server reports the element as not found (404). */\n  async getObjectById(elementId: string): Promise<ObjectInstanceResponse | null> {\n    const path = '/v1/objects/list';\n    const item = await this.postBulkOne<ObjectInstanceResponse>(path, {\n      elementIds: [elementId],\n    });\n    if (item.success) return item.result ?? null;\n    if (item.responseDetail?.status === 404) return null;\n    throw new Error(\n      `i3X request ${path} failed for '${elementId}': ${describeFailure(item)}`,\n    );\n  }\n\n  async getRelatedObjects(\n    elementId: string,\n    relationshipType?: string,\n  ): Promise<RelatedObjectResult[]> {\n    const path = '/v1/objects/related';\n    const body: { elementIds: [string] } & Record<string, unknown> = {\n      elementIds: [elementId],\n    };\n    if (relationshipType) body.relationshipType = relationshipType;\n\n    const item = await this.postBulkOne<RelatedObjectResult[]>(path, body);\n    if (!item.success) {\n      throw new Error(\n        `i3X request ${path} failed for '${elementId}': ${describeFailure(item)}`,\n      );\n    }\n    // Servers may ignore relationshipType, so filter here as well.\n    return (item.result ?? []).filter(\n      (r) => !relationshipType || r.sourceRelationship === relationshipType,\n    );\n  }\n\n  async getRelatedObjectsBulk(\n    elementIds: string[],\n  ): Promise<ElementResult<RelatedObjectResult[]>[]> {\n    return this.postBulkPerElement<RelatedObjectResult[]>(\n      '/v1/objects/related',\n      elementIds,\n      {},\n    );\n  }\n\n  async getObjectValues(\n    elementIds: string[],\n    maxDepth = 1,\n  ): Promise<ElementResult<CurrentValueResult>[]> {\n    return this.postBulkPerElement<CurrentValueResult>('/v1/objects/value', elementIds, {\n      maxDepth,\n    });\n  }\n\n  async getHistoricalValues(\n    elementIds: string[],\n    startTime: string,\n    endTime: string,\n    maxDepth = 1,\n  ): Promise<ElementResult<HistoricalValueResult>[]> {\n    return this.postBulkPerElement<HistoricalValueResult>(\n      '/v1/objects/history',\n      elementIds,\n      { startTime, endTime, maxDepth },\n    );\n  }\n\n  /** Closest objects by elementId or displayName; a failure to list objects propagates. */\n  async findSuggestions(query: string): Promise<Suggestion[]> {\n    if (query.trim().length > MAX_FUZZY_QUERY_LENGTH) return [];\n    const now = Date.now();\n    if (!this.objectCache || now - this.objectCache.at > OBJECT_CACHE_TTL_MS) {\n      const objects = this.getObjects();\n      this.objectCache = { at: now, objects };\n      objects.catch(() => {\n        if (this.objectCache?.objects === objects) this.objectCache = undefined;\n      });\n    }\n    return rankObjectSuggestions(query, await this.objectCache.objects);\n  }\n}\n\ninterface ErrorEnvelope {\n  success?: boolean;\n  responseDetail?: { title?: string; status?: number; detail?: string } | null;\n}\n\nfunction describeFailure(res: ErrorEnvelope | null | undefined): string {\n  const d = res?.responseDetail;\n  if (d) return [d.status, d.title, d.detail].filter(Boolean).join(' ');\n  return `unexpected response ${JSON.stringify(res)?.slice(0, 200)}`;\n}\n","import type { RestServerDeps } from '@node-i3x/rest-server';\nimport { RestClientBinding } from './rest-binding.js';\n\ntype InjectableApp = Awaited<\n  ReturnType<typeof import('@node-i3x/rest-server').createApp>\n>;\n\n/**\n * Binding to an i3X stack running in this process.\n *\n * Requests go through the real rest-server routes (Fastify `inject()`, no socket),\n * so in-process answers are exactly what a remote node-i3x server would send:\n * same parentId, roots, related objects, values and server info.\n */\nexport class InProcessConnectorBinding extends RestClientBinding {\n  constructor(deps: RestServerDeps) {\n    super('http://in-process', undefined, 15_000, injectFetch(deps));\n  }\n}\n\n/** A fetch that answers from an in-process rest-server instead of the network. */\nexport function injectFetch(deps: RestServerDeps): typeof fetch {\n  let app: Promise<InjectableApp> | undefined;\n  return async (input, init) => {\n    // Loaded lazily so the REST-only CLI never pulls in Fastify. No request logging:\n    // Fastify logs to stdout, which is the MCP stdio channel.\n    app ??= import('@node-i3x/rest-server').then(({ createApp }) =>\n      createApp({ ...deps, requireAuth: false }, { logger: false }),\n    );\n    const url = new URL(String(input));\n    const res = await (await app).inject({\n      method: (init?.method ?? 'GET') as 'GET' | 'POST',\n      url: `${url.pathname}${url.search}`,\n      headers: init?.headers as Record<string, string> | undefined,\n      payload: typeof init?.body === 'string' ? init.body : undefined,\n    });\n    return new Response(res.body, {\n      status: res.statusCode,\n      headers: {\n        'content-type': String(res.headers['content-type'] ?? 'application/json'),\n      },\n    });\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,106 +1,19 @@
+import { I as I3XClientBinding, S as Suggestion, H as HierarchyNode, E as ElementResult } from './rest-binding-DPjLoyyg.js';
+export { A as AssetDiagnosticReport, R as RestClientBinding, T as TelemetrySummary } from './rest-binding-DPjLoyyg.js';
 import * as _node_i3x_core from '@node-i3x/core';
-import { ServerInfo, Namespace, ObjectType, RelationshipType, ObjectInstanceResponse, CurrentValueResult, HistoricalValueResult, I3xStack } from '@node-i3x/core';
 import { z } from 'zod';
 
-interface AssetDiagnosticReport {
-    elementId: string;
-    displayName?: string;
-    description?: string;
-    typeElementId?: string;
-    typeSchema?: Record<string, unknown>;
-    parentId?: string;
-    subComponents?: Array<{
-        elementId: string;
-        displayName?: string;
-        relationshipType?: string;
-    }>;
-    currentValues?: Record<string, {
-        value: unknown;
-        quality: string;
-        timestamp: string;
-    }>;
-    diagnosticTips?: string[];
-}
-interface HierarchyNode {
-    elementId: string;
-    displayName?: string;
-    typeElementId?: string;
-    children?: HierarchyNode[];
-}
-interface TelemetrySummary {
-    elementId: string;
-    values: Array<{
-        timestamp: string;
-        value: unknown;
-        quality: string;
-    }>;
-    statistics?: {
-        min?: number;
-        max?: number;
-        mean?: number;
-        count: number;
-        badQualityCount: number;
-    };
-}
-interface I3XClientBinding {
-    getInfo(): Promise<ServerInfo>;
-    getNamespaces(): Promise<Namespace[]>;
-    getObjectTypes(namespaceUri?: string): Promise<ObjectType[]>;
-    getRelationshipTypes(): Promise<RelationshipType[]>;
-    getObjects(options?: {
-        rootOnly?: boolean;
-        typeElementId?: string;
-    }): Promise<ObjectInstanceResponse[]>;
-    getObjectById(elementId: string): Promise<ObjectInstanceResponse | null>;
-    getRelatedObjects(elementId: string, relationshipType?: string): Promise<ObjectInstanceResponse[]>;
-    getObjectValues(elementIds: string[], maxDepth?: number): Promise<CurrentValueResult[]>;
-    getHistoricalValues(elementIds: string[], startTime: string, endTime: string, maxDepth?: number): Promise<HistoricalValueResult[]>;
-    findSuggestions(unknownId: string): Promise<string[]>;
-}
-
-declare class InProcessConnectorBinding implements I3XClientBinding {
-    private readonly stack;
-    constructor(stack: I3xStack);
-    getInfo(): Promise<ServerInfo>;
-    getNamespaces(): Promise<Namespace[]>;
-    getObjectTypes(namespaceUri?: string): Promise<ObjectType[]>;
-    getRelationshipTypes(): Promise<RelationshipType[]>;
-    getObjects(options?: {
-        rootOnly?: boolean;
-        typeElementId?: string;
-    }): Promise<ObjectInstanceResponse[]>;
-    getObjectById(elementId: string): Promise<ObjectInstanceResponse | null>;
-    getRelatedObjects(elementId: string): Promise<ObjectInstanceResponse[]>;
-    getObjectValues(elementIds: string[], maxDepth?: number): Promise<CurrentValueResult[]>;
-    getHistoricalValues(elementIds: string[], startTime: string, endTime: string, maxDepth?: number): Promise<HistoricalValueResult[]>;
-    findSuggestions(unknownId: string): Promise<string[]>;
-}
-
-declare class RestClientBinding implements I3XClientBinding {
-    private readonly baseUrl;
-    private readonly headers;
-    private readonly requestTimeoutMs;
-    constructor(baseUrl?: string, token?: string, timeoutMs?: number);
-    private request;
-    getInfo(): Promise<ServerInfo>;
-    getNamespaces(): Promise<Namespace[]>;
-    getObjectTypes(namespaceUri?: string): Promise<ObjectType[]>;
-    getRelationshipTypes(): Promise<RelationshipType[]>;
-    getObjects(options?: {
-        rootOnly?: boolean;
-        typeElementId?: string;
-    }): Promise<ObjectInstanceResponse[]>;
-    getObjectById(elementId: string): Promise<ObjectInstanceResponse | null>;
-    getRelatedObjects(elementId: string, relationshipType?: string): Promise<ObjectInstanceResponse[]>;
-    getObjectValues(elementIds: string[], maxDepth?: number): Promise<CurrentValueResult[]>;
-    getHistoricalValues(elementIds: string[], startTime: string, endTime: string, maxDepth?: number): Promise<HistoricalValueResult[]>;
-    findSuggestions(unknownId: string): Promise<string[]>;
-}
-
 declare class NodeI3xMcpServer {
     private readonly server;
     private binding;
-    constructor(binding?: I3XClientBinding);
+    private readonly maxResultChars;
+    /**
+     * @param options.maxResultChars - cap on a serialized tool result (default
+     *   I3X_MCP_MAX_RESULT_CHARS, else 100 000 characters).
+     */
+    constructor(binding?: I3XClientBinding, options?: {
+        maxResultChars?: number;
+    });
     setBinding(binding: I3XClientBinding): void;
     getBinding(): I3XClientBinding;
     private setupHandlers;
@@ -151,17 +64,20 @@ declare function handleDiscoverTypes(binding: I3XClientBinding, args: z.infer<ty
 declare const exploreHierarchySchema: z.ZodObject<{
     rootElementId: z.ZodOptional<z.ZodString>;
     maxDepth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxNodes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 declare function handleExploreHierarchy(binding: I3XClientBinding, args: z.infer<typeof exploreHierarchySchema>): Promise<{
     error: string;
-    suggestions: string[];
-    totalRoots?: undefined;
-    traversalDepth?: undefined;
-    plantTopology?: undefined;
+    suggestions: Suggestion[];
 } | {
-    totalRoots: number;
-    traversalDepth: number;
     plantTopology: HierarchyNode[];
+    truncated?: {
+        maxNodes: number;
+        hint: string;
+    } | undefined;
+    totalRoots: number;
+    traversalDepth: string | number;
+    nodeCount: number;
     error?: undefined;
     suggestions?: undefined;
 }>;
@@ -170,34 +86,52 @@ declare const inspectAssetSchema: z.ZodObject<{
     elementId: z.ZodString;
     includeValues: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     includeSchema: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxDepth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 declare function handleInspectAsset(binding: I3XClientBinding, args: z.infer<typeof inspectAssetSchema>): Promise<Record<string, unknown>>;
 
 declare const monitorEventsSchema: z.ZodObject<{
-    elementIds: z.ZodArray<z.ZodString>;
-    condition: z.ZodOptional<z.ZodString>;
+    elementIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+    maxDepth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
+/**
+ * One-shot health snapshot: current values plus every series whose quality is not Good.
+ * It does not subscribe: MCP tool calls are request/response, so call it again to re-check.
+ */
 declare function handleMonitorEvents(binding: I3XClientBinding, args: z.infer<typeof monitorEventsSchema>): Promise<{
+    snapshot: ElementResult<_node_i3x_core.CurrentValueResult>[];
+    note: string;
+    alertsOmitted?: number | undefined;
     status: string;
-    monitoredAssets: string[];
-    alertCondition: string;
-    initialSnapshot: _node_i3x_core.CurrentValueResult[];
-    instructions: string;
+    checkedAt: string;
+    summary: {
+        bad: number;
+        uncertain: number;
+        readErrors: number;
+    };
+    alerts: {
+        elementId: string;
+        quality?: string;
+        error?: string;
+    }[];
 }>;
 
 declare const queryTelemetrySchema: z.ZodObject<{
-    elementIds: z.ZodArray<z.ZodString>;
+    elementIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
     mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         current: "current";
         history: "history";
     }>>>;
     startTime: z.ZodOptional<z.ZodString>;
     endTime: z.ZodOptional<z.ZodString>;
+    maxDepth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     aggregateStats: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
+/** ISO 8601 or relative ('-2h') time to ISO; an unparseable value is an error, not a default. */
+declare function parseTime(input: string | undefined, fallback: Date, name: string): string;
 declare function handleQueryTelemetry(binding: I3XClientBinding, args: z.infer<typeof queryTelemetrySchema>): Promise<{
     mode: string;
-    telemetry: _node_i3x_core.CurrentValueResult[];
+    telemetry: ElementResult<_node_i3x_core.CurrentValueResult>[];
     timeRange?: undefined;
     history?: undefined;
     telemetryReports?: undefined;
@@ -207,7 +141,7 @@ declare function handleQueryTelemetry(binding: I3XClientBinding, args: z.infer<t
         startTime: string;
         endTime: string;
     };
-    history: _node_i3x_core.HistoricalValueResult[];
+    history: ElementResult<_node_i3x_core.HistoricalValueResult>[];
     telemetry?: undefined;
     telemetryReports?: undefined;
 } | {
@@ -221,5 +155,4 @@ declare function handleQueryTelemetry(binding: I3XClientBinding, args: z.infer<t
     history?: undefined;
 }>;
 
-export { InProcessConnectorBinding, NodeI3xMcpServer, RestClientBinding, discoverTypesSchema, exploreHierarchySchema, handleDiscoverTypes, handleExploreHierarchy, handleInspectAsset, handleMonitorEvents, handleQueryTelemetry, inspectAssetSchema, monitorEventsSchema, queryTelemetrySchema };
-export type { AssetDiagnosticReport, HierarchyNode, I3XClientBinding, TelemetrySummary };
+export { ElementResult, HierarchyNode, I3XClientBinding, NodeI3xMcpServer, Suggestion, discoverTypesSchema, exploreHierarchySchema, handleDiscoverTypes, handleExploreHierarchy, handleInspectAsset, handleMonitorEvents, handleQueryTelemetry, inspectAssetSchema, monitorEventsSchema, parseTime, queryTelemetrySchema };