@ixo/common 1.1.0

package/dist/services/session-manager/errors.js

@@ -0,0 +1,41 @@
+export var SessionManagerErrorCodes;
+(function (SessionManagerErrorCodes) {
+    SessionManagerErrorCodes["NO_USER_ROOMS_FOUND"] = "NO_USER_ROOMS_FOUND";
+    SessionManagerErrorCodes["ROOM_NOT_FOUND"] = "ROOM_NOT_FOUND";
+    SessionManagerErrorCodes["USER_NOT_IN_ROOM"] = "USER_NOT_IN_ROOM";
+})(SessionManagerErrorCodes || (SessionManagerErrorCodes = {}));
+export class SessionManagerError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+    }
+}
+export class NoUserRoomsFoundError extends SessionManagerError {
+    constructor(did) {
+        super(`No user rooms found for the given did ${did}`, SessionManagerErrorCodes.NO_USER_ROOMS_FOUND);
+    }
+    isNoUserRoomsFoundError(error) {
+        return (error instanceof NoUserRoomsFoundError &&
+            error.code === SessionManagerErrorCodes.NO_USER_ROOMS_FOUND);
+    }
+}
+export class RoomNotFoundError extends SessionManagerError {
+    constructor(roomId) {
+        super(`Room ${roomId} not found`, SessionManagerErrorCodes.ROOM_NOT_FOUND);
+    }
+    isRoomNotFoundError(error) {
+        return (error instanceof RoomNotFoundError &&
+            error.code === SessionManagerErrorCodes.ROOM_NOT_FOUND);
+    }
+}
+export class UserNotInRoomError extends SessionManagerError {
+    constructor(did, roomId) {
+        super(`User ${did} not in room ${roomId}`, SessionManagerErrorCodes.USER_NOT_IN_ROOM);
+    }
+    isUserNotInRoomError(error) {
+        return (error instanceof UserNotInRoomError &&
+            error.code === SessionManagerErrorCodes.USER_NOT_IN_ROOM);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/services/session-manager/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/services/session-manager/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAClC,uEAA2C,CAAA;IAC3C,6DAAiC,CAAA;IACjC,iEAAqC,CAAA;AACvC,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG1B;IAFlB,YACE,OAAe,EACC,IAA8B;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAA0B;IAGhD,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,mBAAmB;IAC5D,YAAY,GAAW;QACrB,KAAK,CACH,yCAAyC,GAAG,EAAE,EAC9C,wBAAwB,CAAC,mBAAmB,CAC7C,CAAC;IACJ,CAAC;IACD,uBAAuB,CAAC,KAAc;QACpC,OAAO,CACL,KAAK,YAAY,qBAAqB;YACtC,KAAK,CAAC,IAAI,KAAK,wBAAwB,CAAC,mBAAmB,CAC5D,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,mBAAmB;IACxD,YAAY,MAAc;QACxB,KAAK,CAAC,QAAQ,MAAM,YAAY,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAC;IAC7E,CAAC;IACD,mBAAmB,CAAC,KAAc;QAChC,OAAO,CACL,KAAK,YAAY,iBAAiB;YAClC,KAAK,CAAC,IAAI,KAAK,wBAAwB,CAAC,cAAc,CACvD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,mBAAmB;IACzD,YAAY,GAAW,EAAE,MAAc;QACrC,KAAK,CACH,QAAQ,GAAG,gBAAgB,MAAM,EAAE,EACnC,wBAAwB,CAAC,gBAAgB,CAC1C,CAAC;IACJ,CAAC;IACD,oBAAoB,CAAC,KAAc;QACjC,OAAO,CACL,KAAK,YAAY,kBAAkB;YACnC,KAAK,CAAC,IAAI,KAAK,wBAAwB,CAAC,gBAAgB,CACzD,CAAC;IACJ,CAAC;CACF"}

package/dist/services/session-manager/index.d.ts

@@ -0,0 +1,4 @@
+export * from './dto.js';
+export * from './errors.js';
+export * from './session-manager.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/session-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/session-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC"}

package/dist/services/session-manager/index.js

@@ -0,0 +1,4 @@
+export * from './dto.js';
+export * from './errors.js';
+export * from './session-manager.service.js';
+//# sourceMappingURL=index.js.map

package/dist/services/session-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/session-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC"}

package/dist/services/session-manager/session-manager.service.d.ts

@@ -0,0 +1,40 @@
+import { MatrixManager } from '@ixo/matrix';
+import { Database } from 'better-sqlite3';
+import { MemoryEngineService } from '../memory-engine/memory-engine.service.js';
+import { type UserContextData } from '../memory-engine/types.js';
+import { type ChatSession, type CreateChatSessionDto, type CreateChatSessionResponseDto, type DeleteChatSessionDto, type ListChatSessionsDto, type ListChatSessionsResponseDto } from './dto.js';
+export interface IDatabaseSyncService {
+    getUserDatabase(userDid: string): Promise<Database>;
+}
+export declare class SessionManagerService {
+    private readonly syncService;
+    readonly matrixManger: MatrixManager;
+    private readonly memoryEngineService?;
+    constructor(syncService: IDatabaseSyncService, matrixManger?: MatrixManager, memoryEngineService?: MemoryEngineService | undefined);
+    getSessionsStateKey({ oracleEntityDid, }: {
+        oracleEntityDid: string;
+    }): `${string}_${string}`;
+    private createMessageTitle;
+    updateLastProcessedCount({ sessionId, did, lastProcessedCount, }: {
+        sessionId: string;
+        did: string;
+        lastProcessedCount: number;
+    }): Promise<void>;
+    syncSessionSet({ sessionId, did, messages, oracleEntityDid, oracleName, roomId: _roomId, lastProcessedCount, oracleDid, userContext, slackThreadTs, }: {
+        sessionId: string;
+        did: string;
+        messages: string[];
+        oracleEntityDid: string;
+        oracleName: string;
+        roomId?: string;
+        lastProcessedCount?: number;
+        oracleDid: string;
+        userContext?: UserContextData;
+        slackThreadTs?: string;
+    }): Promise<ChatSession>;
+    getSession(sessionId: string, did: string, throwOnNotFound?: boolean): Promise<ChatSession | undefined>;
+    listSessions(listSessionsDto: ListChatSessionsDto): Promise<ListChatSessionsResponseDto>;
+    createSession(createSessionDto: CreateChatSessionDto): Promise<CreateChatSessionResponseDto>;
+    deleteSession(deleteSessionDto: DeleteChatSessionDto): Promise<void>;
+}
+//# sourceMappingURL=session-manager.service.d.ts.map

package/dist/services/session-manager/session-manager.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.service.d.ts","sourceRoot":"","sources":["../../../src/services/session-manager/session-manager.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EACjC,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACrD;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW;aACZ,YAAY;IAC5B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAFpB,WAAW,EAAE,oBAAoB,EAClC,YAAY,gBAA8B,EACzC,mBAAmB,CAAC,EAAE,mBAAmB,YAAA;IAGrD,mBAAmB,CAAC,EACzB,eAAe,GAChB,EAAE;QACD,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE;YAIX,kBAAkB;IAsEnB,wBAAwB,CAAC,EACpC,SAAS,EACT,GAAG,EACH,kBAAkB,GACnB,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,kBAAkB,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAQJ,cAAc,CAAC,EAC1B,SAAS,EACT,GAAG,EACH,QAAQ,EACR,eAAe,EACf,UAAU,EACV,MAAM,EAAE,OAAO,EACf,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,aAAa,GACd,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,eAAe,CAAC;QAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwFX,UAAU,CACrB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,OAAc,GAC9B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAuDtB,YAAY,CACvB,eAAe,EAAE,mBAAmB,GACnC,OAAO,CAAC,2BAA2B,CAAC;IAsD1B,aAAa,CACxB,gBAAgB,EAAE,oBAAoB,GACrC,OAAO,CAAC,4BAA4B,CAAC;IAgD3B,aAAa,CACxB,gBAAgB,EAAE,oBAAoB,GACrC,OAAO,CAAC,IAAI,CAAC;CAMjB"}

package/dist/services/session-manager/session-manager.service.js

@@ -0,0 +1,251 @@
+import { Logger } from '@ixo/logger';
+import { MatrixManager } from '@ixo/matrix';
+import { getMatrixHomeServerCroppedForDid } from '@ixo/oracles-chain-client';
+import { getChatOpenAiModel } from '../../ai/index.js';
+export class SessionManagerService {
+    syncService;
+    matrixManger;
+    memoryEngineService;
+    constructor(syncService, matrixManger = MatrixManager.getInstance(), memoryEngineService) {
+        this.syncService = syncService;
+        this.matrixManger = matrixManger;
+        this.memoryEngineService = memoryEngineService;
+    }
+    getSessionsStateKey({ oracleEntityDid, }) {
+        return `${oracleEntityDid}_sessions`;
+    }
+    async createMessageTitle({ messages, }) {
+        if (messages.length === 0) {
+            return 'Untitled';
+        }
+        const llm = getChatOpenAiModel({
+            model: 'meta-llama/llama-3.1-8b-instruct',
+            temperature: 0.3,
+            apiKey: process.env.OPEN_ROUTER_API_KEY,
+            timeout: 20 * 1000 * 60,
+            configuration: {
+                baseURL: 'https://openrouter.ai/api/v1',
+            },
+        });
+        const response = await llm.invoke(`Based on this messages messages, Add a title for this convo and only based on the messages? MAKE SURE TO ONLY RESPOND WITH THE TITLE. 
+      
+      ## RESPONSE FORMAT
+      ONLY RESPOND WITH THE TITLE not anything else that title will be saved to the store directly from your response so generated based on the messages.
+
+      EXample
+
+      Input:
+      <messages>
+      Hello, how are you?
+      I'm good, thank you!
+      did u see the new feature i added?
+      yes but i didn't like it
+      </messages>
+
+      Output:
+      Conversation about a new feature
+
+      ___________________________________________________________
+
+      Input:
+      <messages>
+      What are the store opening hours?
+      We are open from 9am to 5pm, Monday to Friday.
+      </messages>
+
+      Output:
+      Store Opening Hours Information
+___________________________________________________________
+      Input:
+      <messages>
+      Can you help me reset my password?
+      Sure, I can assist you with that.
+      </messages>
+
+      Output:
+      Password Reset Assistance
+
+      ___________________________________________________________
+      # the out put should be only the title not anything else that title will be saved to the store directly from your response so generated based on the messages.
+
+      USER MESSAGES:
+      <messages>
+      ${messages.join('\n\n')}
+      </messages>
+      `);
+        const title = response.content.toString();
+        return title;
+    }
+    async updateLastProcessedCount({ sessionId, did, lastProcessedCount, }) {
+        const db = await this.syncService.getUserDatabase(did);
+        db.prepare('UPDATE sessions SET last_processed_count = ? WHERE session_id = ?').run(lastProcessedCount, sessionId);
+        return;
+    }
+    async syncSessionSet({ sessionId, did, messages, oracleEntityDid, oracleName, roomId: _roomId, lastProcessedCount, oracleDid, userContext, slackThreadTs, }) {
+        const db = await this.syncService.getUserDatabase(did);
+        const selectedSession = await this.getSession(sessionId, did, false);
+        if (!selectedSession) {
+            const session = {
+                sessionId,
+                oracleName,
+                title: await this.createMessageTitle({
+                    messages,
+                }),
+                lastUpdatedAt: new Date().toISOString(),
+                createdAt: new Date().toISOString(),
+                oracleEntityDid,
+                oracleDid,
+                userContext,
+                slackThreadTs,
+            };
+            db.prepare(`
+        INSERT INTO sessions (
+          session_id, title, last_updated_at, created_at, oracle_name, 
+          oracle_did, oracle_entity_did, last_processed_count, 
+          user_context, room_id, slack_thread_ts
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(session.sessionId, session.title ?? null, session.lastUpdatedAt, session.createdAt, session.oracleName, session.oracleDid, session.oracleEntityDid, session.lastProcessedCount ?? null, session.userContext ? JSON.stringify(session.userContext) : null, session.roomId ?? null, session.slackThreadTs ?? null);
+            return session;
+        }
+        const hasEnoughMessages = messages.length >= 2;
+        const needsTitleUpdate = !selectedSession.title ||
+            selectedSession.title.toLowerCase() === 'untitled' ||
+            (selectedSession.title && selectedSession.title.trim() === '');
+        const allowTitleUpdate = hasEnoughMessages && needsTitleUpdate;
+        const title = allowTitleUpdate
+            ? await this.createMessageTitle({
+                messages,
+            })
+            : selectedSession.title;
+        const lastUpdatedAt = new Date().toISOString();
+        const updatedSession = {
+            ...selectedSession,
+            title,
+            lastUpdatedAt,
+            lastProcessedCount,
+            slackThreadTs,
+        };
+        db.prepare(`
+      UPDATE sessions 
+      SET title = ?, last_updated_at = ?, last_processed_count = ?, slack_thread_ts = ?
+      WHERE session_id = ?
+    `).run(updatedSession.title ?? null, lastUpdatedAt, updatedSession.lastProcessedCount ?? null, updatedSession.slackThreadTs ?? null, sessionId);
+        return updatedSession;
+    }
+    async getSession(sessionId, did, throwOnNotFound = true) {
+        const db = await this.syncService.getUserDatabase(did);
+        const row = db
+            .prepare(`SELECT 
+          session_id, title, last_updated_at, created_at, oracle_name,
+          oracle_did, oracle_entity_did, last_processed_count,
+          user_context, room_id, slack_thread_ts
+         FROM sessions 
+         WHERE session_id = ?`)
+            .get(sessionId);
+        const selectedSession = row
+            ? {
+                sessionId: row.session_id,
+                title: row.title ?? undefined,
+                lastUpdatedAt: row.last_updated_at,
+                createdAt: row.created_at,
+                oracleName: row.oracle_name,
+                oracleDid: row.oracle_did,
+                oracleEntityDid: row.oracle_entity_did,
+                lastProcessedCount: row.last_processed_count ?? undefined,
+                userContext: row.user_context
+                    ? JSON.parse(row.user_context)
+                    : undefined,
+                roomId: row.room_id ?? undefined,
+                slackThreadTs: row.slack_thread_ts ?? undefined,
+            }
+            : undefined;
+        if (!selectedSession) {
+            if (throwOnNotFound) {
+                throw new Error('Session not found');
+            }
+            return undefined;
+        }
+        return selectedSession;
+    }
+    async listSessions(listSessionsDto) {
+        const db = await this.syncService.getUserDatabase(listSessionsDto.did);
+        const limit = listSessionsDto.limit ?? 20;
+        const offset = listSessionsDto.offset ?? 0;
+        const rows = db
+            .prepare(`SELECT 
+          session_id, title, last_updated_at, created_at, oracle_name,
+          oracle_did, oracle_entity_did, last_processed_count,
+          user_context, room_id, slack_thread_ts,
+          COUNT(*) OVER() as total
+         FROM sessions 
+         ORDER BY last_updated_at DESC
+         LIMIT ? OFFSET ?`)
+            .all(limit, offset);
+        const total = rows[0]?.total ?? 0;
+        const sessions = rows.map((row) => ({
+            sessionId: row.session_id,
+            title: row.title ?? undefined,
+            lastUpdatedAt: row.last_updated_at,
+            createdAt: row.created_at,
+            oracleName: row.oracle_name,
+            oracleDid: row.oracle_did,
+            oracleEntityDid: row.oracle_entity_did,
+            lastProcessedCount: row.last_processed_count ?? undefined,
+            userContext: row.user_context
+                ? JSON.parse(row.user_context)
+                : undefined,
+            roomId: row.room_id ?? undefined,
+            slackThreadTs: row.slack_thread_ts ?? undefined,
+        }));
+        return { sessions, total };
+    }
+    async createSession(createSessionDto) {
+        const userHomeServer = createSessionDto.homeServer || await getMatrixHomeServerCroppedForDid(createSessionDto.did);
+        const { roomId } = await this.matrixManger.getOracleRoomIdWithHomeServer({
+            userDid: createSessionDto.did,
+            oracleEntityDid: createSessionDto.oracleEntityDid,
+            userHomeServer,
+        });
+        if (!roomId) {
+            throw new Error('Room ID not found');
+        }
+        const eventId = await this.matrixManger.sendMessage({
+            message: 'New Conversation Started',
+            roomId,
+            isOracleAdmin: true,
+        });
+        let userContext;
+        if (this.memoryEngineService) {
+            try {
+                Logger.debug('Gathering user context from Memory Engine');
+                userContext = await this.memoryEngineService.gatherUserContext({
+                    oracleDid: createSessionDto.oracleDid,
+                    userDid: createSessionDto.did,
+                    roomId,
+                });
+            }
+            catch (error) {
+                Logger.error('Failed to gather user context:', error);
+                throw error;
+            }
+        }
+        const session = await this.syncSessionSet({
+            sessionId: eventId,
+            oracleName: createSessionDto.oracleName,
+            did: createSessionDto.did,
+            oracleEntityDid: createSessionDto.oracleEntityDid,
+            oracleDid: createSessionDto.oracleDid,
+            messages: [],
+            roomId,
+            userContext,
+            slackThreadTs: createSessionDto.slackThreadTs,
+        });
+        return session;
+    }
+    async deleteSession(deleteSessionDto) {
+        const db = await this.syncService.getUserDatabase(deleteSessionDto.did);
+        db.prepare('DELETE FROM sessions WHERE session_id = ?').run(deleteSessionDto.sessionId);
+    }
+}
+//# sourceMappingURL=session-manager.service.js.map

package/dist/services/session-manager/session-manager.service.js.map

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

package/dist/utils/get-user-subscription.d.ts

@@ -0,0 +1,21 @@
+export declare const getSubscriptionUrlByNetwork: (network: "mainnet" | "testnet" | "devnet") => string;
+export interface ClaimCollectionsDto {
+    oracleClaimsCollectionId?: string;
+    subscriptionClaimsCollectionId?: string;
+}
+export interface GetMySubscriptionsResponseDto {
+    claimCollections: ClaimCollectionsDto;
+    currentPlan: string;
+    currentPlanName: string;
+    totalCredits: number;
+    planCredits: number;
+    status: 'active' | 'inactive' | 'processing' | 'trial';
+    adminAddress: string;
+}
+export interface GetUserSubscriptionParams {
+    network: 'mainnet' | 'testnet' | 'devnet';
+    bearerToken: string;
+    subscriptionUrl?: string;
+}
+export declare const getUserSubscription: ({ bearerToken, network, subscriptionUrl: _subscriptionUrl, }: GetUserSubscriptionParams) => Promise<GetMySubscriptionsResponseDto | null>;
+//# sourceMappingURL=get-user-subscription.d.ts.map

package/dist/utils/get-user-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-subscription.d.ts","sourceRoot":"","sources":["../../src/utils/get-user-subscription.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,2BAA2B,GACtC,SAAS,SAAS,GAAG,SAAS,GAAG,QAAQ,WAO1C,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,mBAAmB,GAAU,8DAIvC,yBAAyB,KAAG,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAyC1E,CAAC"}

package/dist/utils/get-user-subscription.js

@@ -0,0 +1,44 @@
+import { Logger } from '@ixo/logger';
+export const getSubscriptionUrlByNetwork = (network) => {
+    return {
+        mainnet: 'https://subscriptions-api-mainnet.ixo-api.workers.dev',
+        testnet: 'https://subscriptions-api-testnet.ixo-api.workers.dev',
+        devnet: 'https://subscriptions-api.ixo-api.workers.dev',
+    }[network];
+};
+export const getUserSubscription = async ({ bearerToken, network, subscriptionUrl: _subscriptionUrl, }) => {
+    const subscriptionUrl = _subscriptionUrl ?? getSubscriptionUrlByNetwork(network);
+    try {
+        Logger.debug('Fetching user subscription from:', subscriptionUrl);
+        const response = await fetch(`${subscriptionUrl.endsWith('/') ? subscriptionUrl.slice(0, -1) : subscriptionUrl}/api/v1/subscriptions`, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${bearerToken}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            console.error(`Failed to fetch user subscription: ${response.status} ${response.statusText}`);
+            return null;
+        }
+        const data = await response.json();
+        if (!data) {
+            return null;
+        }
+        const subscription = data;
+        return {
+            claimCollections: subscription.claimCollections,
+            currentPlan: subscription.currentPlan,
+            currentPlanName: subscription.currentPlanName,
+            totalCredits: subscription.totalCredits,
+            planCredits: subscription.planCredits,
+            status: subscription.status,
+            adminAddress: subscription.adminAddress,
+        };
+    }
+    catch (error) {
+        console.error('Error fetching user subscription:', error);
+        return null;
+    }
+};
+//# sourceMappingURL=get-user-subscription.js.map

package/dist/utils/get-user-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-subscription.js","sourceRoot":"","sources":["../../src/utils/get-user-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,OAAyC,EACzC,EAAE;IACF,OAAO;QACL,OAAO,EAAE,uDAAuD;QAChE,OAAO,EAAE,uDAAuD;QAChE,MAAM,EAAE,+CAA+C;KACxD,CAAC,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AA4BF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,EACxC,WAAW,EACX,OAAO,EACP,eAAe,EAAE,gBAAgB,GACP,EAAiD,EAAE;IAC7E,MAAM,eAAe,GACnB,gBAAgB,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,eAAe,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,uBAAuB,EACxG;YACE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,EAAE;gBACtC,cAAc,EAAE,kBAAkB;aACnC;SACF,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CACX,sCAAsC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC/E,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,YAAY,GAAG,IAAmC,CAAC;QACzD,OAAO;YACL,gBAAgB,EAAE,YAAY,CAAC,gBAAgB;YAC/C,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,eAAe,EAAE,YAAY,CAAC,eAAe;YAC7C,YAAY,EAAE,YAAY,CAAC,YAAY;YACvC,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,MAAM,EAAE,YAAY,CAAC,MAAM;YAC3B,YAAY,EAAE,YAAY,CAAC,YAAY;SACxC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './get-user-subscription.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from './get-user-subscription.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/docs/ai-module.md

@@ -0,0 +1,84 @@
+# AI Module Documentation
+
+## Overview
+
+The AI module in `@ixo/common` provides a suite of AI-powered tools and utilities designed to extend the capabilities of ixo oracles. It integrates with OpenAI and LangChain for language model interactions, document processing, semantic routing, and includes various utility functions.
+
+## Components
+
+### 1. Checkpointing
+
+The checkpointing system enables persistence of LangChain graph states using SQLite. Optionally, you can also integrate with Matrix-based checkpointing by importing from `@ixo/matrix`.
+
+```typescript
+import { SqliteSaver } from '@ixo/common/ai';
+
+const checkpointer = new SqliteSaver('./checkpoints');
+const graph = workflow.compile({
+  checkpointer,
+});
+```
+
+### 2. Nodes
+
+#### Find Docs Node
+
+this node to be used to find the most relevant documents from a vector database with langgraph
+
+#### Fake Node
+
+this node is a fake node to pass the state to the next node
+
+### 3. Semantic Routing
+
+The semantic router creates intelligent routing based on content analysis using OpenAI:
+
+```typescript
+import { createSemanticRouter } from '@ixo/common/ai';
+
+const routes = {
+  generateBlog: 'if the intent is blog',
+  generateSocialMediaPost: 'if the intent is post',
+};
+
+const router = createSemanticRouter(routes, ['intent'], 'gpt-4o-mini');
+
+// Use the router
+const nextRoute = await router({
+  intent: 'Create a blog post about AI',
+});
+```
+
+Features:
+
+- Type-safe route creation and validation
+- Supports 'gpt-4o-mini' and 'gpt-4o' models
+- Handles complex routing scenarios
+- Integrated with LangSmith for tracing
+
+### 4. OpenAI Integration
+
+The module provides convenient OpenAI model factories:
+
+```typescript
+import {
+  getChatOpenAiModel,
+  getOpenAiEmbeddings,
+  getOpenAiClient,
+} from '@ixo/common/ai/models';
+
+// Get a ChatOpenAI instance
+const chatModel = getChatOpenAiModel();
+
+// Get embeddings model
+const embeddings = getOpenAiEmbeddings({
+  model: 'text-embedding-3-small',
+});
+
+// Get raw OpenAI client
+const openai = getOpenAiClient();
+```
+
+### 5. Tools & Utilities
+
+For detailed documentation on available tools, please refer to the [Tools Documentation](./tools.md).