@skillful-ai/skai-sdk 1.0.2

package/src/utils/skai-helpers.d.ts

@@ -0,0 +1,19 @@
+import { FastifyBaseLogger } from 'fastify';
+import { SkaiAgentsClient, SkaiAgentsClientConfig } from '../clients/agents-client';
+import { SkaiAdminClient, SkaiAdminClientConfig } from '../clients/admin-client';
+import { Logger } from '../clients/base-client';
+/**
+ * Factory function to create a SKAI Agents client instance
+ */
+export declare function createSkaiAgentsClient(log: FastifyBaseLogger | Logger, config: SkaiAgentsClientConfig): SkaiAgentsClient;
+/**
+ * Factory function to create a SKAI Admin client instance
+ */
+export declare function createSkaiAdminClient(log: FastifyBaseLogger | Logger, config: SkaiAdminClientConfig): SkaiAdminClient;
+/**
+ * SKAI API connection status checker for a given base URL
+ */
+export declare function checkSkaiApiStatus(log: FastifyBaseLogger | Logger, baseUrl: string): Promise<{
+    isHealthy: boolean;
+    error?: string;
+}>;

package/src/utils/skai-helpers.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkaiAgentsClient = createSkaiAgentsClient;
+exports.createSkaiAdminClient = createSkaiAdminClient;
+exports.checkSkaiApiStatus = checkSkaiApiStatus;
+const tslib_1 = require("tslib");
+const agents_client_1 = require("../clients/agents-client");
+const admin_client_1 = require("../clients/admin-client");
+const logger_adapter_1 = require("./logger-adapter");
+/**
+ * Factory function to create a SKAI Agents client instance
+ */
+function createSkaiAgentsClient(log, config) {
+    const logger = 'info' in log ? log : (0, logger_adapter_1.createFastifyLoggerAdapter)(log);
+    return new agents_client_1.SkaiAgentsClient(logger, config);
+}
+/**
+ * Factory function to create a SKAI Admin client instance
+ */
+function createSkaiAdminClient(log, config) {
+    const logger = 'info' in log ? log : (0, logger_adapter_1.createFastifyLoggerAdapter)(log);
+    return new admin_client_1.SkaiAdminClient(logger, config);
+}
+/**
+ * SKAI API connection status checker for a given base URL
+ */
+function checkSkaiApiStatus(log, baseUrl) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        try {
+            const logger = 'info' in log ? log : (0, logger_adapter_1.createFastifyLoggerAdapter)(log);
+            // Create a minimal client just for health checking
+            const response = yield fetch(`${baseUrl}/api/health`);
+            const isHealthy = response.ok;
+            return { isHealthy };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const logger = 'info' in log ? log : (0, logger_adapter_1.createFastifyLoggerAdapter)(log);
+            logger.error({ error: errorMessage }, 'SKAI API health check failed');
+            return {
+                isHealthy: false,
+                error: errorMessage,
+            };
+        }
+    });
+}
+//# sourceMappingURL=skai-helpers.js.map

package/src/utils/skai-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skai-helpers.js","sourceRoot":"","sources":["../../../../../../packages/custom/skai-sdk/src/utils/skai-helpers.ts"],"names":[],"mappings":";;AASA,wDAMC;AAKD,sDAMC;AAKD,gDAyBC;;AAvDD,4DAAmF;AACnF,0DAAgF;AAEhF,qDAA6D;AAE7D;;GAEG;AACH,SAAgB,sBAAsB,CAClC,GAA+B,EAC/B,MAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,2CAA0B,EAAC,GAAG,CAAC,CAAA;IACpE,OAAO,IAAI,gCAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACjC,GAA+B,EAC/B,MAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,2CAA0B,EAAC,GAAG,CAAC,CAAA;IACpE,OAAO,IAAI,8BAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC9C,CAAC;AAED;;GAEG;AACH,SAAsB,kBAAkB,CACpC,GAA+B,EAC/B,OAAe;;QAKf,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,2CAA0B,EAAC,GAAG,CAAC,CAAA;YAEpE,mDAAmD;YACnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,aAAa,CAAC,CAAA;YACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAA;YAE7B,OAAO,EAAE,SAAS,EAAE,CAAA;QACxB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;YAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,2CAA0B,EAAC,GAAG,CAAC,CAAA;YACpE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,8BAA8B,CAAC,CAAA;YACrE,OAAO;gBACH,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,YAAY;aACtB,CAAA;QACL,CAAC;IACL,CAAC;CAAA"}

package/src/utils/stream-metrics.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SKAI Stream Metrics Tracker
+ */
+import { SkaiStreamMetrics, SkaiStreamValidationResult } from '../types/streaming';
+/**
+ * Stream metrics tracker class
+ */
+export declare class SkaiStreamMetricsTracker {
+    private metrics;
+    constructor(startTime?: number);
+    /**
+     * Record a chunk being received
+     */
+    recordChunk(chunkSize: number): void;
+    /**
+     * Record a content token being processed
+     */
+    recordToken(tokenContent: string): void;
+    /**
+     * Record stream completion
+     */
+    recordCompletion(): void;
+    /**
+     * Get current metrics snapshot
+     */
+    getMetrics(): Readonly<SkaiStreamMetrics>;
+    /**
+     * Get stream duration in milliseconds
+     */
+    getDuration(): number;
+    /**
+     * Get stream duration in seconds
+     */
+    getDurationSeconds(): number;
+    /**
+     * Get average bytes per chunk
+     */
+    getAverageBytesPerChunk(): number;
+    /**
+     * Get time since last activity
+     */
+    getTimeSinceLastActivity(): number;
+    /**
+     * Check if stream is considered inactive
+     */
+    isInactive(timeoutMs: number): boolean;
+    /**
+     * Validate stream completion and return result
+     */
+    validateCompletion(expectedContent?: boolean): SkaiStreamValidationResult;
+    /**
+     * Generate debug log object for stream metrics
+     */
+    toLogObject(): Record<string, unknown>;
+}

package/src/utils/stream-metrics.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * SKAI Stream Metrics Tracker
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkaiStreamMetricsTracker = void 0;
+/**
+ * Stream metrics tracker class
+ */
+class SkaiStreamMetricsTracker {
+    constructor(startTime = Date.now()) {
+        this.metrics = {
+            startTime,
+            endTime: 0,
+            totalChunks: 0,
+            totalBytes: 0,
+            totalTokens: 0,
+            contentLength: 0,
+            firstChunkTime: null,
+            lastActivityTime: startTime,
+        };
+    }
+    /**
+     * Record a chunk being received
+     */
+    recordChunk(chunkSize) {
+        this.metrics.totalChunks++;
+        this.metrics.totalBytes += chunkSize;
+        this.metrics.lastActivityTime = Date.now();
+        if (this.metrics.firstChunkTime === null) {
+            this.metrics.firstChunkTime = Date.now() - this.metrics.startTime;
+        }
+    }
+    /**
+     * Record a content token being processed
+     */
+    recordToken(tokenContent) {
+        this.metrics.totalTokens++;
+        this.metrics.contentLength += tokenContent.length;
+        this.metrics.lastActivityTime = Date.now();
+    }
+    /**
+     * Record stream completion
+     */
+    recordCompletion() {
+        this.metrics.endTime = Date.now();
+    }
+    /**
+     * Get current metrics snapshot
+     */
+    getMetrics() {
+        return Object.assign({}, this.metrics);
+    }
+    /**
+     * Get stream duration in milliseconds
+     */
+    getDuration() {
+        const endTime = this.metrics.endTime || Date.now();
+        return endTime - this.metrics.startTime;
+    }
+    /**
+     * Get stream duration in seconds
+     */
+    getDurationSeconds() {
+        return Number((this.getDuration() / 1000).toFixed(2));
+    }
+    /**
+     * Get average bytes per chunk
+     */
+    getAverageBytesPerChunk() {
+        return this.metrics.totalChunks > 0
+            ? Math.round(this.metrics.totalBytes / this.metrics.totalChunks)
+            : 0;
+    }
+    /**
+     * Get time since last activity
+     */
+    getTimeSinceLastActivity() {
+        return Date.now() - this.metrics.lastActivityTime;
+    }
+    /**
+     * Check if stream is considered inactive
+     */
+    isInactive(timeoutMs) {
+        return this.getTimeSinceLastActivity() > timeoutMs;
+    }
+    /**
+     * Validate stream completion and return result
+     */
+    validateCompletion(expectedContent = true) {
+        const metrics = this.getMetrics();
+        // Check if we received any content
+        if (expectedContent && metrics.totalTokens === 0 && metrics.contentLength === 0) {
+            return {
+                isValid: false,
+                errorMessage: 'Stream completed but no response content was generated',
+                metrics,
+            };
+        }
+        // Check if stream actually completed (not just timed out)
+        if (metrics.endTime === 0) {
+            return {
+                isValid: false,
+                errorMessage: 'Stream did not complete normally',
+                metrics,
+            };
+        }
+        return {
+            isValid: true,
+            metrics,
+        };
+    }
+    /**
+     * Generate debug log object for stream metrics
+     */
+    toLogObject() {
+        const metrics = this.getMetrics();
+        return {
+            totalChunks: metrics.totalChunks,
+            totalBytes: metrics.totalBytes,
+            totalTokens: metrics.totalTokens,
+            contentLength: metrics.contentLength,
+            durationMs: this.getDuration(),
+            durationSeconds: this.getDurationSeconds(),
+            firstChunkTimeMs: metrics.firstChunkTime,
+            avgBytesPerChunk: this.getAverageBytesPerChunk(),
+            timeSinceLastActivityMs: this.getTimeSinceLastActivity(),
+        };
+    }
+}
+exports.SkaiStreamMetricsTracker = SkaiStreamMetricsTracker;
+//# sourceMappingURL=stream-metrics.js.map

package/src/utils/stream-metrics.js.map

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

package/src/utils/stream-parser.d.ts

@@ -0,0 +1,49 @@
+/**
+ * SKAI Stream Parser Utilities
+ */
+import { SkaiMetadataToken, SkaiStreamLineParseResult, SkaiStreamParsingResult } from '../types/streaming';
+/**
+ * Custom errors for SKAI streaming
+ */
+export declare class SkaiStreamError extends Error {
+    readonly tokenData?: unknown;
+    constructor(message: string, tokenData?: unknown);
+}
+export declare class SkaiStreamTimeoutError extends Error {
+    constructor(inactivityMs: number);
+}
+export declare class SkaiStreamValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a streaming line and determine its type
+ */
+export declare function parseStreamLine(line: string): SkaiStreamLineParseResult;
+/**
+ * Parse and validate metadata token content
+ */
+export declare function parseMetadataToken(tokenJson: string): SkaiMetadataToken[];
+/**
+ * Check if metadata token indicates an error condition
+ */
+export declare function checkForErrorToken(token: SkaiMetadataToken): string | null;
+/**
+ * Process content token and extract text
+ */
+export declare function processContentToken(tokenJson: string): string;
+/**
+ * Process a batch of streaming lines
+ */
+export declare function processStreamLines(lines: string[]): SkaiStreamParsingResult;
+/**
+ * Create a preview of content for logging
+ */
+export declare function createContentPreview(content: string, maxLength?: number): string;
+/**
+ * Check if stream has been inactive for too long
+ */
+export declare function checkStreamTimeout(lastActivityTime: number, currentTime?: number): void;
+/**
+ * Validate stream completion
+ */
+export declare function validateStreamCompletion(tokens: number, contentLength: number): void;

package/src/utils/stream-parser.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * SKAI Stream Parser Utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkaiStreamValidationError = exports.SkaiStreamTimeoutError = exports.SkaiStreamError = void 0;
+exports.parseStreamLine = parseStreamLine;
+exports.parseMetadataToken = parseMetadataToken;
+exports.checkForErrorToken = checkForErrorToken;
+exports.processContentToken = processContentToken;
+exports.processStreamLines = processStreamLines;
+exports.createContentPreview = createContentPreview;
+exports.checkStreamTimeout = checkStreamTimeout;
+exports.validateStreamCompletion = validateStreamCompletion;
+const streaming_1 = require("../types/streaming");
+/**
+ * Custom errors for SKAI streaming
+ */
+class SkaiStreamError extends Error {
+    constructor(message, tokenData) {
+        super(`SKAI Agent Error: ${message}`);
+        this.tokenData = tokenData;
+        this.name = 'SkaiStreamError';
+    }
+}
+exports.SkaiStreamError = SkaiStreamError;
+class SkaiStreamTimeoutError extends Error {
+    constructor(inactivityMs) {
+        super(`SKAI Agent stream timeout: No activity for ${Math.round(inactivityMs / 1000)} seconds`);
+        this.name = 'SkaiStreamTimeoutError';
+    }
+}
+exports.SkaiStreamTimeoutError = SkaiStreamTimeoutError;
+class SkaiStreamValidationError extends Error {
+    constructor(message) {
+        super(`SKAI Agent Error: ${message}`);
+        this.name = 'SkaiStreamValidationError';
+    }
+}
+exports.SkaiStreamValidationError = SkaiStreamValidationError;
+/**
+ * Parse a streaming line and determine its type
+ */
+function parseStreamLine(line) {
+    if (line.startsWith(`${streaming_1.SkaiTokenType.CONTENT}:`)) {
+        return { type: streaming_1.SkaiStreamLineType.CONTENT, content: line.substring(2) };
+    }
+    if (line.startsWith(`${streaming_1.SkaiTokenType.METADATA}:`)) {
+        return { type: streaming_1.SkaiStreamLineType.METADATA, content: line.substring(2) };
+    }
+    return { type: streaming_1.SkaiStreamLineType.UNKNOWN };
+}
+/**
+ * Parse and validate metadata token content
+ */
+function parseMetadataToken(tokenJson) {
+    try {
+        const parsed = JSON.parse(tokenJson);
+        return Array.isArray(parsed) ? parsed : [parsed];
+    }
+    catch (error) {
+        throw new Error(`Failed to parse metadata token: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Check if metadata token indicates an error condition
+ */
+function checkForErrorToken(token) {
+    var _a;
+    // Direct error token
+    if (token.type === streaming_1.SkaiMetadataType.ERROR) {
+        const errorData = token.data;
+        return (errorData === null || errorData === void 0 ? void 0 : errorData.message) || 'Unknown agent error';
+    }
+    // Exception event token
+    if (token.type === streaming_1.SkaiMetadataType.EVENTS) {
+        const eventsData = token.data;
+        const title = ((_a = eventsData === null || eventsData === void 0 ? void 0 : eventsData.title) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || '';
+        for (const keyword of streaming_1.SKAI_STREAM_CONFIG.EXCEPTION_KEYWORDS) {
+            if (title.includes(keyword)) {
+                return (eventsData === null || eventsData === void 0 ? void 0 : eventsData.title) || `Exception detected: ${keyword}`;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Process content token and extract text
+ */
+function processContentToken(tokenJson) {
+    try {
+        return JSON.parse(tokenJson);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse content token: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Process a batch of streaming lines
+ */
+function processStreamLines(lines) {
+    const result = {
+        content: '',
+        tokens: 0,
+        isComplete: false,
+        hasErrors: false,
+        errors: [],
+    };
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        const parsedLine = parseStreamLine(line);
+        switch (parsedLine.type) {
+            case streaming_1.SkaiStreamLineType.CONTENT:
+                try {
+                    if (parsedLine.content) {
+                        const contentText = processContentToken(parsedLine.content);
+                        result.content += contentText;
+                        result.tokens++;
+                    }
+                }
+                catch (error) {
+                    result.errors.push(error instanceof Error ? error.message : 'Content parsing error');
+                }
+                break;
+            case streaming_1.SkaiStreamLineType.METADATA:
+                try {
+                    if (parsedLine.content) {
+                        const tokens = parseMetadataToken(parsedLine.content);
+                        for (const token of tokens) {
+                            const errorMessage = checkForErrorToken(token);
+                            if (errorMessage) {
+                                result.hasErrors = true;
+                                result.errors.push(errorMessage);
+                                throw new SkaiStreamError(errorMessage, token);
+                            }
+                        }
+                    }
+                }
+                catch (error) {
+                    if (error instanceof SkaiStreamError) {
+                        throw error; // Re-throw SKAI errors
+                    }
+                    result.errors.push(error instanceof Error ? error.message : 'Metadata parsing error');
+                }
+                break;
+            case streaming_1.SkaiStreamLineType.UNKNOWN:
+            default:
+                // Ignore unknown line types
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Create a preview of content for logging
+ */
+function createContentPreview(content, maxLength = streaming_1.SKAI_STREAM_CONFIG.TOKEN_PREVIEW_LENGTH) {
+    if (content.length <= maxLength) {
+        return content;
+    }
+    return content.substring(0, maxLength) + '...';
+}
+/**
+ * Check if stream has been inactive for too long
+ */
+function checkStreamTimeout(lastActivityTime, currentTime = Date.now()) {
+    const inactivityMs = currentTime - lastActivityTime;
+    if (inactivityMs > streaming_1.SKAI_STREAM_CONFIG.INACTIVITY_TIMEOUT_MS) {
+        throw new SkaiStreamTimeoutError(inactivityMs);
+    }
+}
+/**
+ * Validate stream completion
+ */
+function validateStreamCompletion(tokens, contentLength) {
+    if (tokens === 0 && contentLength === 0) {
+        throw new SkaiStreamValidationError('Stream completed but no response content was generated');
+    }
+}
+//# sourceMappingURL=stream-parser.js.map

package/src/utils/stream-parser.js.map

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