@intella/sdk 0.0.4 → 0.0.6

package/dist/utils/id.util.js

@@ -0,0 +1,71 @@
+// utils/id.util.ts
+import { monotonicFactory, decodeTime } from 'ulid';
+import { UUIDtoULID, ULIDtoUUID } from "ulid-uuid-converter";
+export class IdGenerator {
+    static ulid = monotonicFactory();
+    /**
+     * Generate a ULID and convert it to UUID format.
+     * This method creates a new ULID and its corresponding UUID.
+     *
+     * @returns {[string, string]} A tuple containing the generated ULID and UUID.
+     *
+     * @example
+     * const [ulid, uuid] = IdGenerator.generateIds();
+     * console.log(ulid); // Example output: "01F8MECHZX3TBZ7C8F8M8F8M8F"
+     * console.log(uuid); // Example output: "550e8400-e29b-41d4-a716-446655440000"
+     */
+    static generateIds() {
+        const ulid = this.ulid();
+        const uuid = this.ulidToUuid(ulid);
+        return [ulid, uuid];
+    }
+    static generatePrefixUlid(prefix) {
+        const ulid = this.ulid();
+        return `${prefix}_${ulid}`;
+    }
+    /**
+     * Convert a ULID to UUID format.
+     * This method takes a ULID string and converts it into its corresponding UUID representation.
+     *
+     * @param ulid - The ULID string to be converted.
+     * @returns {string} The UUID string corresponding to the provided ULID.
+     *
+     * @example
+     * const uuid = IdGenerator.ulidToUuid("01F8MECHZX3TBZ7C8F8M8F8M8F");
+     * console.log(uuid); // Example output: "550e8400-e29b-41d4-a716-446655440000"
+     */
+    static ulidToUuid(ulid) {
+        const uuid = ULIDtoUUID(ulid);
+        return uuid;
+    }
+    /**
+     * Convert a UUID to ULID format.
+     * This method takes a UUID string and converts it into its corresponding ULID representation.
+     *
+     * @param uuid - The UUID string to be converted.
+     * @returns {string} The ULID string corresponding to the provided UUID.
+     *
+     * @example
+     * const ulid = IdGenerator.uuidToUlid("550e8400-e29b-41d4-a716-446655440000");
+     * console.log(ulid); // Example output: "01F8MECHZX3TBZ7C8F8M8F8M8F"
+     */
+    static uuidToUlid(uuid) {
+        const ulid = UUIDtoULID(uuid);
+        return ulid;
+    }
+    /**
+     * Get timestamp from ULID.
+     * This method extracts the timestamp from a given ULID string, returning the time in milliseconds since the Unix epoch.
+     *
+     * @param ulid - The ULID string from which to extract the timestamp.
+     * @returns {number} The timestamp in milliseconds.
+     *
+     * @example
+     * const timestamp = IdGenerator.getTimestampFromUlid("01F8MECHZX3TBZ7C8F8M8F8M8F");
+     * console.log(timestamp); // Example output: 1622547800000
+     */
+    static getTimestampFromUlid(ulid) {
+        return decodeTime(ulid);
+    }
+}
+//# sourceMappingURL=id.util.js.map

package/dist/utils/id.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.util.js","sourceRoot":"","sources":["../../src/utils/id.util.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,OAAO,WAAW;IACd,MAAM,CAAC,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,MAAc;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAA;IAC5B,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAY;QACtC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC"}

package/dist/utils/redis-stream.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Redis Stream utilities for sandbox command execution
+ * Provides reusable methods for publishing commands, chunks, and waiting for results
+ */
+import { type RedisClientType } from 'redis';
+import type { TaskRequest, AgentType } from '../types.js';
+export declare let client: RedisClientType | null;
+/**
+ * Get Redis client from URL
+ */
+export declare function getRedisClient(redisUrl?: string): Promise<RedisClientType>;
+/**
+ * Command to publish to sandbox stream
+ */
+export interface SandboxCommand {
+    id?: string;
+    type: 'session:init' | 'session:end' | 'agent:execute' | 'ping';
+    sessionId?: string;
+    agentType?: AgentType | string;
+    prompt?: string;
+    taskRequest?: TaskRequest;
+    history?: unknown[];
+    model?: string;
+    streamAgentResult?: boolean;
+    apiKeys?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Result from sandbox stream
+ */
+export interface SandboxRedisResult {
+    commandId: string;
+    type: 'success' | 'error' | 'chunk' | 'done';
+    sessionId?: string;
+    data?: unknown;
+    error?: string;
+    timestamp: number;
+}
+/**
+ * Chunk data to publish
+ */
+export interface ChunkData {
+    chunkId?: string;
+    chunk?: string;
+    segmentId?: string;
+    isDone?: boolean;
+    type?: string;
+    senderType?: string;
+    timestamp?: number;
+    data?: unknown;
+}
+/**
+ * Publish a command to sandbox-specific Redis stream
+ * @param sandboxId - Sandbox ID
+ * @param command - Command to publish
+ * @param redisUrl - Optional Redis URL (defaults to REDIS_URL env var)
+ */
+export declare function publishCommand(sandboxId: string, command: SandboxCommand, redisUrl?: string): Promise<string>;
+/**
+ * Publish a chunk to sandbox-specific Redis stream
+ * @param sandboxId - Sandbox ID
+ * @param chunk - Chunk data to publish
+ * @param redisUrl - Optional Redis URL (defaults to REDIS_URL env var)
+ */
+export declare function publishChunk(sandboxId: string, chunk: ChunkData, redisUrl?: string): Promise<void>;
+/**
+ * Publish a chunk to session-specific Redis stream
+ * @param sessionId - Session ID
+ * @param chunk - Chunk data to publish
+ * @param redisUrl - Optional Redis URL (defaults to REDIS_URL env var)
+ */
+export declare function publishChunkToSession(sessionId: string, chunk: ChunkData, redisUrl?: string): Promise<void>;
+/**
+ * Generic stream reading options
+ */
+export interface ReadFromStreamOptions {
+    /** Redis URL (defaults to REDIS_URL env var) */
+    redisUrl?: string;
+    /** Maximum time to wait in milliseconds (default: 10 minutes) */
+    timeout?: number;
+    /** Consumer group name (auto-generated if not provided) */
+    groupName?: string;
+    /** Consumer name (auto-generated if not provided) */
+    consumerName?: string;
+    /** Filter by commandId (for sandbox streams) */
+    commandId?: string;
+    /** Filter function to determine if message should be processed */
+    filter?: (message: Record<string, string>) => boolean;
+    /** Transform function to convert message to result type */
+    transform?: (message: Record<string, string>) => any;
+    /** Whether to stop on 'done' or 'error' type messages (default: true) */
+    stopOnDone?: boolean;
+    /** Block time in milliseconds for XREADGROUP (default: 1000) */
+    blockTime?: number;
+    /** Count of messages to read per batch (default: 100) */
+    count?: number;
+}
+/**
+ * Generic function to read from any Redis stream (async generator)
+ * @param streamKey - Redis stream key
+ * @param options - Configuration options
+ */
+export declare function readFromStream<T = Record<string, any>>(streamKey: string, options?: ReadFromStreamOptions): AsyncGenerator<T, void, unknown>;
+/**
+ * Read results from sandbox stream (convenience function)
+ * @param sandboxId - Sandbox ID
+ * @param commandId - Command ID to filter by
+ * @param options - Additional options
+ */
+export declare function readFromSandbox(sandboxId: string, commandId: string, options?: Omit<ReadFromStreamOptions, 'commandId'>): AsyncGenerator<SandboxRedisResult, void, unknown>;
+/**
+ * Session stream chunk data (matches StreamChunkData from apps)
+ */
+export interface SessionStreamChunk {
+    chunkId?: string;
+    chunk?: string;
+    segmentId?: string | null;
+    isDone?: boolean;
+    type?: string;
+    senderType?: string;
+    timestamp?: number;
+    data?: unknown;
+}
+/**
+ * Read chunks from session stream (convenience function)
+ * @param sessionId - Session ID
+ * @param options - Additional options
+ */
+export declare function readFromSession(sessionId: string, options?: ReadFromStreamOptions): AsyncGenerator<SessionStreamChunk, void, unknown>;
+/**
+ * Wait for a success result for a specific command
+ * @param sandboxId - Sandbox ID
+ * @param commandId - Command ID to wait for
+ * @param redisUrl - Optional Redis URL (defaults to REDIS_URL env var)
+ * @param timeout - Timeout in milliseconds (default: 10 minutes)
+ * @returns Promise that resolves when success is received
+ * @throws Error if timeout or error result is received
+ */
+export declare function waitForSuccess(sandboxId: string, commandId: string, redisUrl?: string, timeout?: number): Promise<SandboxRedisResult>;
+/**
+ * Wait for an error result for a specific command
+ * @param sandboxId - Sandbox ID
+ * @param commandId - Command ID to wait for
+ * @param redisUrl - Optional Redis URL (defaults to REDIS_URL env var)
+ * @param timeout - Timeout in milliseconds (default: 10 minutes)
+ * @returns Promise that resolves with error result
+ * @throws Error if timeout
+ */
+export declare function waitForError(sandboxId: string, commandId: string, redisUrl?: string, timeout?: number): Promise<SandboxRedisResult>;
+/**
+ * Wait for a done or error result for a specific command (returns full result data)
+ * @param sandboxId - Sandbox ID
+ * @param commandId - Command ID to wait for
+ * @param redisUrl - Optional Redis URL (defaults to REDIS_URL env var)
+ * @param timeout - Timeout in milliseconds (default: 10 minutes)
+ * @returns Promise that resolves with done or error result
+ * @throws Error if timeout
+ */
+export declare function waitForResult(sandboxId: string, commandId: string, redisUrl?: string, timeout?: number): Promise<SandboxRedisResult>;
+//# sourceMappingURL=redis-stream.d.ts.map

package/dist/utils/redis-stream.d.ts.map

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