@fatagnus/dink-sdk 2.0.3 → 2.3.0

package/dist/introspect-utils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Utility functions for working with introspection data.
+ * These functions provide formatting, validation, and search capabilities
+ * for ServiceDescriptor and MethodDescriptor types.
+ */
+import type { ServiceDescriptor, MethodDescriptor } from './introspect.js';
+/**
+ * Result of searching for methods across services.
+ */
+export interface MethodSearchResult {
+    serviceName: string;
+    serviceVersion: string;
+    method: MethodDescriptor;
+}
+/**
+ * Result of validating a request against a schema.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Format a ServiceDescriptor as LLM-friendly text (llm.txt format).
+ * This format is optimized for AI agent consumption with full documentation.
+ */
+export declare function formatAsLLMTxt(descriptor: ServiceDescriptor): string;
+/**
+ * Format multiple ServiceDescriptors as a combined llm.txt document.
+ */
+export declare function formatMultipleServicesAsLLMTxt(services: ServiceDescriptor[]): string;
+/**
+ * Format a ServiceDescriptor in a minimal token format for AI agents.
+ * This is optimized for context window efficiency while preserving essential information.
+ */
+export declare function formatAsCompactAI(descriptor: ServiceDescriptor): string;
+/**
+ * Validate request data against a method's input schema.
+ * Returns a ValidationResult with valid=true if no schema or validation passes.
+ */
+export declare function validateRequest(method: MethodDescriptor, data: Record<string, unknown>): ValidationResult;
+/**
+ * Generate an example request object from a method's input schema.
+ * Returns an empty object if no schema is defined.
+ */
+export declare function generateExampleRequest(method: MethodDescriptor): Record<string, unknown>;
+/**
+ * Search services for methods matching a query.
+ * The query is matched case-insensitively against:
+ * - Service capabilities
+ * - Method names
+ * - Method descriptions
+ * - Method AI context (when_to_use, why_to_use, how_to_use)
+ */
+export declare function findMethodsFor(services: ServiceDescriptor[], query: string): MethodSearchResult[];
+//# sourceMappingURL=introspect-utils.d.ts.map

package/dist/introspect-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect-utils.d.ts","sourceRoot":"","sources":["../src/introspect-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAoHpE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAUpF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAuCvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAUzG;AAwGD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMxF;AA6CD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAqEjG"}

package/dist/introspect-utils.js

@@ -0,0 +1,372 @@
+/**
+ * Utility functions for working with introspection data.
+ * These functions provide formatting, validation, and search capabilities
+ * for ServiceDescriptor and MethodDescriptor types.
+ */
+/**
+ * Format a ServiceDescriptor as LLM-friendly text (llm.txt format).
+ * This format is optimized for AI agent consumption with full documentation.
+ */
+export function formatAsLLMTxt(descriptor) {
+    const lines = [];
+    // Header
+    lines.push(`# ${descriptor.name} LLM Reference`);
+    lines.push('');
+    // Description as blockquote
+    if (descriptor.description) {
+        lines.push(`> ${descriptor.description}`);
+        lines.push('');
+    }
+    // Service AI Context sections
+    if (descriptor.ai_context) {
+        if (descriptor.ai_context.overview) {
+            lines.push('## When to Use This Service');
+            lines.push('');
+            lines.push(descriptor.ai_context.overview);
+            lines.push('');
+        }
+        if (descriptor.ai_context.capabilities && descriptor.ai_context.capabilities.length > 0) {
+            lines.push('## Capabilities');
+            lines.push('');
+            for (const cap of descriptor.ai_context.capabilities) {
+                lines.push(`- ${cap}`);
+            }
+            lines.push('');
+        }
+        if (descriptor.ai_context.limitations && descriptor.ai_context.limitations.length > 0) {
+            lines.push('## Limitations');
+            lines.push('');
+            for (const lim of descriptor.ai_context.limitations) {
+                lines.push(`- ${lim}`);
+            }
+            lines.push('');
+        }
+    }
+    // Methods section
+    if (descriptor.methods && descriptor.methods.length > 0) {
+        lines.push('## Methods');
+        lines.push('');
+        for (const method of descriptor.methods) {
+            lines.push(`### ${method.name}`);
+            lines.push('');
+            if (method.description) {
+                lines.push(method.description);
+                lines.push('');
+            }
+            if (method.ai_context) {
+                if (method.ai_context.when_to_use) {
+                    lines.push(`**When to use:** ${method.ai_context.when_to_use}`);
+                    lines.push('');
+                }
+                if (method.ai_context.why_to_use) {
+                    lines.push(`**Why:** ${method.ai_context.why_to_use}`);
+                    lines.push('');
+                }
+                if (method.ai_context.how_to_use) {
+                    lines.push(`**How:** ${method.ai_context.how_to_use}`);
+                    lines.push('');
+                }
+                if (method.ai_context.preconditions && method.ai_context.preconditions.length > 0) {
+                    lines.push('**Preconditions:**');
+                    lines.push('');
+                    for (const pre of method.ai_context.preconditions) {
+                        lines.push(`- ${pre}`);
+                    }
+                    lines.push('');
+                }
+                if (method.ai_context.side_effects && method.ai_context.side_effects.length > 0) {
+                    lines.push('**Side Effects:**');
+                    lines.push('');
+                    for (const effect of method.ai_context.side_effects) {
+                        lines.push(`- ${effect}`);
+                    }
+                    lines.push('');
+                }
+                if (method.ai_context.related_methods && method.ai_context.related_methods.length > 0) {
+                    lines.push(`**Related Methods:** ${method.ai_context.related_methods.join(', ')}`);
+                    lines.push('');
+                }
+            }
+            if (method.input_schema && Object.keys(method.input_schema).length > 0) {
+                lines.push('#### Request Schema');
+                lines.push('');
+                lines.push('```json');
+                lines.push(JSON.stringify(method.input_schema, null, 2));
+                lines.push('```');
+                lines.push('');
+            }
+            if (method.output_schema && Object.keys(method.output_schema).length > 0) {
+                lines.push('#### Response Schema');
+                lines.push('');
+                lines.push('```json');
+                lines.push(JSON.stringify(method.output_schema, null, 2));
+                lines.push('```');
+                lines.push('');
+            }
+        }
+    }
+    // Related Services
+    if (descriptor.related_services && descriptor.related_services.length > 0) {
+        lines.push('## Related Services');
+        lines.push('');
+        for (const svc of descriptor.related_services) {
+            lines.push(`- ${svc}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format multiple ServiceDescriptors as a combined llm.txt document.
+ */
+export function formatMultipleServicesAsLLMTxt(services) {
+    if (services.length === 0) {
+        return '';
+    }
+    const parts = [];
+    for (const svc of services) {
+        parts.push(formatAsLLMTxt(svc));
+    }
+    return parts.join('\n---\n\n');
+}
+/**
+ * Format a ServiceDescriptor in a minimal token format for AI agents.
+ * This is optimized for context window efficiency while preserving essential information.
+ */
+export function formatAsCompactAI(descriptor) {
+    const lines = [];
+    // Compact header
+    let header = `${descriptor.name} v${descriptor.version}`;
+    if (descriptor.description) {
+        header += ` - ${descriptor.description}`;
+    }
+    lines.push(header);
+    // Compact AI context (one line each)
+    if (descriptor.ai_context) {
+        if (descriptor.ai_context.overview) {
+            lines.push(`Overview: ${descriptor.ai_context.overview}`);
+        }
+        if (descriptor.ai_context.capabilities && descriptor.ai_context.capabilities.length > 0) {
+            lines.push(`Capabilities: ${descriptor.ai_context.capabilities.join(', ')}`);
+        }
+        if (descriptor.ai_context.limitations && descriptor.ai_context.limitations.length > 0) {
+            lines.push(`Limitations: ${descriptor.ai_context.limitations.join(', ')}`);
+        }
+    }
+    // Compact methods list
+    if (descriptor.methods && descriptor.methods.length > 0) {
+        lines.push('Methods:');
+        for (const m of descriptor.methods) {
+            let methodLine = `  ${m.name}`;
+            if (m.description) {
+                methodLine += `: ${m.description}`;
+            }
+            lines.push(methodLine);
+            if (m.ai_context?.when_to_use) {
+                lines.push(`    When: ${m.ai_context.when_to_use}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Validate request data against a method's input schema.
+ * Returns a ValidationResult with valid=true if no schema or validation passes.
+ */
+export function validateRequest(method, data) {
+    if (!method.input_schema || Object.keys(method.input_schema).length === 0) {
+        return { valid: true, errors: [] };
+    }
+    const errors = validateAgainstSchema(method.input_schema, data, '');
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Internal function to validate data against a JSON schema.
+ */
+function validateAgainstSchema(schema, data, path) {
+    const errors = [];
+    // Check required fields
+    const required = schema.required;
+    if (required && Array.isArray(required)) {
+        for (const fieldName of required) {
+            if (!(fieldName in data)) {
+                const fieldPath = path ? `${path}.${fieldName}` : fieldName;
+                errors.push(`missing required field: ${fieldPath}`);
+            }
+        }
+    }
+    // Check property types
+    const props = schema.properties;
+    if (props && typeof props === 'object') {
+        for (const [fieldName, value] of Object.entries(data)) {
+            const propSchema = props[fieldName];
+            if (!propSchema) {
+                continue;
+            }
+            const fieldPath = path ? `${path}.${fieldName}` : fieldName;
+            const typeErrors = validateType(propSchema, value, fieldPath);
+            errors.push(...typeErrors);
+        }
+    }
+    return errors;
+}
+/**
+ * Internal function to validate a value against its expected type.
+ */
+function validateType(schema, value, path) {
+    const errors = [];
+    const expectedType = schema.type;
+    if (!expectedType) {
+        return errors;
+    }
+    switch (expectedType) {
+        case 'string':
+            if (typeof value !== 'string') {
+                errors.push(`${path}: expected string, got ${typeof value}`);
+            }
+            break;
+        case 'integer':
+            if (typeof value !== 'number' || !Number.isInteger(value)) {
+                errors.push(`${path}: expected integer, got ${typeof value}`);
+            }
+            break;
+        case 'number':
+            if (typeof value !== 'number') {
+                errors.push(`${path}: expected number, got ${typeof value}`);
+            }
+            break;
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                errors.push(`${path}: expected boolean, got ${typeof value}`);
+            }
+            break;
+        case 'object':
+            if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                const nestedErrors = validateAgainstSchema(schema, value, path);
+                errors.push(...nestedErrors);
+            }
+            else {
+                errors.push(`${path}: expected object, got ${typeof value}`);
+            }
+            break;
+        case 'array':
+            if (!Array.isArray(value)) {
+                errors.push(`${path}: expected array, got ${typeof value}`);
+            }
+            break;
+    }
+    return errors;
+}
+/**
+ * Generate an example request object from a method's input schema.
+ * Returns an empty object if no schema is defined.
+ */
+export function generateExampleRequest(method) {
+    if (!method.input_schema || Object.keys(method.input_schema).length === 0) {
+        return {};
+    }
+    return generateFromSchema(method.input_schema);
+}
+/**
+ * Internal function to generate example data from a JSON schema.
+ */
+function generateFromSchema(schema) {
+    const schemaType = schema.type;
+    switch (schemaType) {
+        case 'object': {
+            const result = {};
+            const props = schema.properties;
+            if (props && typeof props === 'object') {
+                for (const [name, propSchema] of Object.entries(props)) {
+                    result[name] = generateFromSchema(propSchema);
+                }
+            }
+            return result;
+        }
+        case 'array': {
+            const items = schema.items;
+            if (items) {
+                return [generateFromSchema(items)];
+            }
+            return [];
+        }
+        case 'string':
+            return 'example';
+        case 'integer':
+            return 0;
+        case 'number':
+            return 0.0;
+        case 'boolean':
+            return false;
+        default:
+            return null;
+    }
+}
+/**
+ * Search services for methods matching a query.
+ * The query is matched case-insensitively against:
+ * - Service capabilities
+ * - Method names
+ * - Method descriptions
+ * - Method AI context (when_to_use, why_to_use, how_to_use)
+ */
+export function findMethodsFor(services, query) {
+    if (!query) {
+        return [];
+    }
+    const lowerQuery = query.toLowerCase();
+    const results = [];
+    for (const svc of services) {
+        // Check if service capabilities match
+        let serviceMatches = false;
+        if (svc.ai_context?.capabilities) {
+            for (const cap of svc.ai_context.capabilities) {
+                if (cap.toLowerCase().includes(lowerQuery)) {
+                    serviceMatches = true;
+                    break;
+                }
+            }
+        }
+        if (!svc.methods) {
+            continue;
+        }
+        for (const method of svc.methods) {
+            let methodMatches = false;
+            // If service capability matches, check if method relates to that capability
+            if (serviceMatches) {
+                if (method.name.toLowerCase().includes(lowerQuery) ||
+                    (method.description?.toLowerCase().includes(lowerQuery) ?? false)) {
+                    methodMatches = true;
+                }
+            }
+            // Check method name
+            if (method.name.toLowerCase().includes(lowerQuery)) {
+                methodMatches = true;
+            }
+            // Check method description
+            if (method.description?.toLowerCase().includes(lowerQuery)) {
+                methodMatches = true;
+            }
+            // Check method AI context
+            if (method.ai_context) {
+                if (method.ai_context.when_to_use?.toLowerCase().includes(lowerQuery) ||
+                    method.ai_context.why_to_use?.toLowerCase().includes(lowerQuery) ||
+                    method.ai_context.how_to_use?.toLowerCase().includes(lowerQuery)) {
+                    methodMatches = true;
+                }
+            }
+            if (methodMatches) {
+                results.push({
+                    serviceName: svc.name,
+                    serviceVersion: svc.version,
+                    method,
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=introspect-utils.js.map

package/dist/introspect-utils.js.map

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

package/dist/introspect.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Service introspection types for AI agent support.
+ * These types match the Go struct definitions in pkg/types/introspect.go
+ * Property names use snake_case to match Go JSON tags for wire compatibility.
+ */
+/**
+ * CodeExample provides a code sample in a specific language.
+ */
+export interface CodeExample {
+    /** Programming language of the example (e.g., 'typescript', 'go', 'python') */
+    language: string;
+    /** The code snippet */
+    code: string;
+    /** Optional description of what the example demonstrates */
+    description?: string;
+}
+/**
+ * MethodAIContext provides AI-specific guidance for understanding and using a method.
+ */
+export interface MethodAIContext {
+    /** When this method should be called */
+    when_to_use?: string;
+    /** Why to use this method over alternatives */
+    why_to_use?: string;
+    /** Instructions on how to use this method correctly */
+    how_to_use?: string;
+    /** Conditions that must be true before calling this method */
+    preconditions?: string[];
+    /** Side effects that occur when calling this method */
+    side_effects?: string[];
+    /** Names of related methods that may be useful */
+    related_methods?: string[];
+}
+/**
+ * ServiceAIContext provides AI-specific guidance for understanding a service.
+ */
+export interface ServiceAIContext {
+    /** High-level description of what this service does */
+    overview?: string;
+    /** List of capabilities this service provides */
+    capabilities?: string[];
+    /** Known limitations of this service */
+    limitations?: string[];
+}
+/**
+ * MethodDescriptor provides complete metadata about a service method for introspection
+ * and AI agent consumption.
+ */
+export interface MethodDescriptor {
+    /** Method name */
+    name: string;
+    /** Human-readable description of what this method does */
+    description?: string;
+    /** JSON Schema describing the input parameters */
+    input_schema?: Record<string, unknown>;
+    /** JSON Schema describing the output */
+    output_schema?: Record<string, unknown>;
+    /** Code examples demonstrating method usage */
+    examples?: CodeExample[];
+    /** Tags for categorization and filtering */
+    tags?: string[];
+    /** AI-specific context for this method */
+    ai_context?: MethodAIContext;
+    /** Additional code examples */
+    code_examples?: CodeExample[];
+}
+/**
+ * ServiceDescriptor provides complete metadata about a service for introspection
+ * and AI agent consumption.
+ */
+export interface ServiceDescriptor {
+    /** Service name */
+    name: string;
+    /** Service version (semver recommended) */
+    version: string;
+    /** Human-readable description of this service */
+    description?: string;
+    /** Methods provided by this service */
+    methods?: MethodDescriptor[];
+    /** AI-specific context for this service */
+    ai_context?: ServiceAIContext;
+    /** Names of related services */
+    related_services?: string[];
+    /** Code examples demonstrating service usage */
+    code_examples?: CodeExample[];
+}
+//# sourceMappingURL=introspect.d.ts.map

package/dist/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../src/introspect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gDAAgD;IAChD,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;CAC/B"}

package/dist/introspect.js

@@ -0,0 +1,7 @@
+/**
+ * Service introspection types for AI agent support.
+ * These types match the Go struct definitions in pkg/types/introspect.go
+ * Property names use snake_case to match Go JSON tags for wire compatibility.
+ */
+export {};
+//# sourceMappingURL=introspect.js.map

package/dist/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../src/introspect.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types.d.ts

@@ -53,4 +53,49 @@ export interface CallOptions {
     retries?: number;
     retryDelay?: number;
 }
+/**
+ * Quality level for connection health assessment.
+ */
+export type ConnectionQualityLevel = 'excellent' | 'good' | 'fair' | 'poor' | 'unknown';
+/**
+ * Connection state for edge/center clients.
+ */
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/**
+ * Connection quality metrics.
+ * Provides real-time information about the health and performance of the connection.
+ */
+export interface ConnectionQuality {
+    /** Current connection state */
+    readonly state: ConnectionState;
+    /** Round-trip latency in milliseconds (from last ping, or null if never measured) */
+    readonly latencyMs: number | null;
+    /** Average latency over the measurement window in milliseconds */
+    readonly avgLatencyMs: number | null;
+    /** Messages sent per second */
+    readonly messagesSentPerSecond: number;
+    /** Messages received per second */
+    readonly messagesReceivedPerSecond: number;
+    /** Total messages sent since connection started */
+    readonly totalMessagesSent: number;
+    /** Total messages received since connection started */
+    readonly totalMessagesReceived: number;
+    /** Timestamp of last successful ping */
+    readonly lastPingAt: number | null;
+    /** Quality assessment based on latency thresholds */
+    readonly qualityLevel: ConnectionQualityLevel;
+}
+/**
+ * Configuration for connection quality monitoring.
+ */
+export interface ConnectionQualityConfig {
+    /** Interval in ms between automatic ping measurements (default: 30000, 0 to disable) */
+    readonly pingIntervalMs?: number;
+    /** Latency threshold in ms for 'excellent' quality (default: 50) */
+    readonly excellentLatencyMs?: number;
+    /** Latency threshold in ms for 'good' quality (default: 150) */
+    readonly goodLatencyMs?: number;
+    /** Latency threshold in ms for 'fair' quality (default: 300) */
+    readonly fairLatencyMs?: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,IAAI,iBAAiB,CAAC;IAChC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3G;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,SAAS,CAAC,GAAG,EAAE,IAAI,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAC5B,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/dink-sdk",
-  "version": "2.0.3",
+  "version": "2.3.0",
   "description": "TypeScript SDK for Dink edge mesh platform",
   "type": "module",
   "main": "dist/index.js",