@isdk/ai-tool 0.7.0 → 0.8.0

package/dist/{index-BCco-g_I.d.ts → index-BLW3R7VS.d.ts}

@@ -3,7 +3,6 @@ import { AdvancePropertyManager } from 'property-manager';
 import { AbilityOptions } from 'custom-ability';
 import { CommonError } from '@isdk/common-error';
 import { Cache, ICacheOptions } from 'secondary-cache';
-import { IncomingMessage, ServerResponse } from 'http';
 
 /**
  * Represents the data type of a function parameter as a string (e.g., `'string'`, `'number'`).
@@ -681,9 +680,8 @@ interface RemoteFuncItem extends BaseFuncItem {
      */
     action?: ActionName;
     /**
-     * Options to be passed to the underlying `fetch` call in an HTTP transport.
+     * Addtional options to be passed to the underlying `fetch` call in a transport.
      * @type {any}
-     * @deprecated Use `transport` instead.
      */
     fetchOptions?: any;
 }
@@ -1210,8 +1208,8 @@ declare class ClientTools extends ToolFunc {
     static action?: ActionName | string;
     private static _transport;
     /**
-     * @deprecated This property is now mainly for informational purposes.
-     * The actual endpoint is managed by the transport.
+     * Gets the root URL for API endpoints from the configured transport.
+     * This is used as the base for constructing request URLs.
      */
     static get apiRoot(): string;
     /**
@@ -1234,11 +1232,11 @@ declare class ClientTools extends ToolFunc {
     static loadFromSync(items: Funcs): void;
     static fetch(name: string, objParam?: any, ...args: any[]): Promise<any>;
     /**
-     * @deprecated This property is now mainly for informational purposes.
-     * The actual endpoint is managed by the transport.
+     * Gets the root URL for API endpoints from the configured transport.
+     * This is used as the base for constructing request URLs.
      */
     get apiRoot(): string;
-    fetch(objParam?: any, act?: ActionName, subName?: any): Promise<any>;
+    fetch(objParam?: any, act?: ActionName, subName?: any, fetchOptions?: any): Promise<any>;
     /**
      * The core implementation for a client-side tool. When a `ClientTools` instance
      * is "run", this `func` method is executed. It delegates the call to the
@@ -1391,11 +1389,17 @@ interface RpcMethodsClientFuncParams {
     [name: string]: any;
 }
 declare class RpcMethodsClientTool extends ClientTools {
-    fetch(options: RpcMethodsClientFuncParams, action: ActionName, subName?: any): Promise<any>;
-    _func(action: ActionName, options: RpcMethodsClientFuncParams): Promise<any>;
+    fetch(options: RpcMethodsClientFuncParams, action: ActionName, subName?: any, fetchOptions?: any): Promise<any>;
+    _func(action: ActionName, options: RpcMethodsClientFuncParams, fetchOptions?: any): Promise<any>;
     func(options: RpcMethodsClientFuncParams): Promise<any>;
     assignMethods(methods: string[]): void;
 }
+declare const RpcMethodsClientToolSchema: {
+    methods: {
+        type: string;
+        assign(value: string[], dest: RpcMethodsClientTool, src?: any, name?: string, options?: any): void;
+    };
+};
 
 interface ResClientFuncParams extends RpcMethodsClientFuncParams {
     id?: string | number;
@@ -1408,7 +1412,7 @@ interface ResClientTools {
     list?(options?: ResClientFuncParams): any;
 }
 declare class ResClientTools extends RpcMethodsClientTool {
-    fetch(options: ResClientFuncParams, action: ActionName): Promise<any>;
+    fetch(options: ResClientFuncParams, action: ActionName, ...args: any[]): Promise<any>;
 }
 
 type PubSubCtx<T = any> = {
@@ -1428,6 +1432,12 @@ type PubSubCtx<T = any> = {
  * and managing the connection state.
  */
 interface PubSubClientStream {
+    /**
+     * A unique identifier for this specific stream instance.
+     * This ID is typically generated by the client transport and sent to the
+     * server to establish a stable session identity.
+     */
+    clientId: string;
     /**
      * The protocol being used for this stream (e.g., 'sse', 'ws', 'ipc').
      */
@@ -1485,12 +1495,12 @@ interface PubSubClientStream {
 interface IPubSubClientTransport {
     /**
      * Establishes a connection to a server endpoint.
-     * @param url The URL of the server's PubSub endpoint.
+     * @param url The full URL of the endpoint, or a path relative to the `apiRoot` that may have been configured on the transport.
      * @param params Optional parameters for the connection, which might include
      *   things like authentication tokens, initial subscription topics, or a client ID.
      * @returns A `PubSubClientStream` instance that represents the active connection.
      */
-    connect: (url: string, params?: Record<string, any>) => PubSubClientStream;
+    connect: (url: string, params?: any) => PubSubClientStream | Promise<PubSubClientStream>;
     /**
      * Optional. Disconnects a given stream.
      * While the `close` method exists on the stream itself, placing `disconnect`
@@ -1499,6 +1509,13 @@ interface IPubSubClientTransport {
      * @param stream The stream to disconnect.
      */
     disconnect?: (stream: PubSubClientStream) => void;
+    /**
+     * Optional. Configures the transport with a base URL.
+     * If implemented, this allows the transport to resolve relative paths
+     * passed to the `connect` method.
+     * @param apiRoot The base URL for the API.
+     */
+    setApiRoot?: (apiRoot: string) => void;
 }
 
 /**
@@ -1506,21 +1523,6 @@ interface IPubSubClientTransport {
  * This ID is used for targeted message publishing.
  */
 type PubSubClientId = string;
-/**
- * Represents a client as seen by the transport layer after a subscription is made.
- * It contains the client's ID and can hold other transport-specific metadata.
- */
-interface PubSubClient {
-    /**
-     * The unique identifier for this client.
-     * This can be assigned by the client during connection or generated by the server.
-     */
-    clientId?: PubSubClientId;
-    /**
-     * Allows for storing additional, transport-specific properties about the client.
-     */
-    [k: string]: any;
-}
 /**
  * Represents an active client connection session on the server.
  * This object provides a standardized way for the `EventServer` to interact
@@ -1575,37 +1577,44 @@ interface IPubSubServerTransport {
      */
     readonly protocol: 'sse' | 'ws' | 'ipc' | string;
     /**
-     * Optional method to mount or register the transport's endpoint with an HTTP
-     * server or framework. This is typically required for protocols like SSE or
-     * WebSockets that need to handle incoming HTTP requests at a specific path.
-     *
-     * @param path The URL path to handle (e.g., '/api/events').
-     * @param options Additional options for mounting, specific to the framework.
-     */
-    mount?: (path: string, options?: Record<string, any>) => void;
-    /**
-     * Establishes a connection with a client and subscribes it to an event stream.
+     * Connects a client, establishing a persistent communication channel.
      *
      * This method is designed to be generic. Transport-specific details, such as
-     * HTTP request/response objects or connection handles, should be passed
-     * inside the `options` parameter to avoid polluting the abstraction layer.
+     * HTTP request/response objects, are passed inside the `options` parameter.
+     * For protocols like SSE, initial events can be passed to be subscribed to at connection time.
      *
-     * @param events Optional array of event names to initially subscribe the client to.
-     * @param options A container for transport-specific parameters.
-     * @param options.req The underlying request object (e.g., `http.IncomingMessage`).
-     * @param options.res The underlying response object (e.g., `http.ServerResponse`).
-     * @param options.clientId An optional ID provided by the client. If not provided,
-     *   the transport should generate one.
-     * @param options.headers HTTP headers from the client request.
-     * @returns A `PubSubClient` object representing the newly connected client.
-     */
-    subscribe: (events?: string[], options?: {
-        req?: any;
-        res?: any;
+     * @param options A container for transport-specific parameters, including optional initial events.
+     * @returns A `PubSubServerSession` object representing the newly connected client session.
+     */
+    connect: (options?: {
+        req: any;
+        res: any;
         clientId?: PubSubClientId;
-        headers?: Record<string, string>;
+        events?: string[];
         [k: string]: any;
-    }) => PubSubClient;
+    }) => PubSubServerSession;
+    /**
+     * Subscribes a client session to one or more events.
+     *
+     * Note: Not all transports may support subscribing to new events after the
+     * initial connection. For transports like SSE, this might be a no-op or
+     * throw an error.
+     *
+     * @param session The `PubSubServerSession` of the client.
+     * @param events An array of event names to subscribe to.
+     */
+    subscribe: (session: PubSubServerSession, events: string[]) => void;
+    /**
+     * Unsubscribes a client session from one or more events.
+     *
+     * Note: Not all transports may support unsubscribing from events after the
+     * initial connection. For transports like SSE, this might be a no-op or
+     * throw an error.
+     *
+     * @param session The `PubSubServerSession` of the client.
+     * @param events An array of event names to unsubscribe from.
+     */
+    unsubscribe: (session: PubSubServerSession, events: string[]) => void;
     /**
      * Publishes an event from the server to connected clients.
      *
@@ -1642,6 +1651,14 @@ interface IPubSubServerTransport {
      * @param cb The callback function that receives the session, event name, data, and context.
      */
     onMessage?: (cb: (session: PubSubServerSession, event: string, data: any, ctx?: PubSubCtx) => void) => void;
+    /**
+     * Optional. Finds and returns a session based on a request object.
+     * This is used by higher-level tools to find the correct session
+     * for operations like adding a subscription via a generic RPC call.
+     * @param req The request object (e.g., http.IncomingMessage or Electron.IpcMainEvent).
+     * @returns The corresponding session, or undefined if not found.
+     */
+    getSessionFromReq?: (req: any) => PubSubServerSession | undefined;
 }
 
 interface EventClientFuncParams {
@@ -1658,20 +1675,21 @@ declare class EventClient extends ResClientTools {
     _streamEvents: string[] | undefined;
     _sseListeners: Record<string, (data: any, ctx?: PubSubCtx) => void>;
     _forwardEvents: Set<string>;
-    get evtSource(): PubSubClientStream;
+    get clientId(): string | undefined;
+    getEvtSource(): Promise<PubSubClientStream>;
     get active(): boolean;
-    set active(v: boolean);
+    setActive(v: boolean): Promise<void>;
     description: string;
-    initEventStream(events?: string | string[]): PubSubClientStream;
+    initEventStream(events?: string | string[]): Promise<PubSubClientStream>;
     esListener(evtType: string, data: any, ctx?: PubSubCtx): void;
-    ebListener: (this: Event, ...data: any[]) => Promise<void>;
+    ebListener: (this: Event, ...args: any[]) => Promise<void>;
     /**
-     * subscribe server sent event(SSE)
+     * subscribe server event
      * @param events
      */
     subscribe(events: string | string[]): Promise<any>;
     /**
-     * unsubscribe server sent event(SSE)
+     * unsubscribe server event
      * @param events
      */
     unsubscribe(events: string | string[]): Promise<any>;
@@ -1715,6 +1733,11 @@ declare class RpcMethodsServerTool extends ServerTools {
     castParams(params: RpcMethodsServerFuncParams): RpcMethodsServerFuncParams;
     func(params: RpcMethodsServerFuncParams): any;
 }
+declare const RpcMethodsServerToolSchema: {
+    methods: {
+        type: string;
+    };
+};
 
 interface ResServerFuncParams extends RpcMethodsServerFuncParams {
     id?: string | number;
@@ -1736,12 +1759,19 @@ declare class ResServerTools extends RpcMethodsServerTool {
     castParams(params: RpcMethodsServerFuncParams): RpcMethodsServerFuncParams;
 }
 
+declare const ClientEventPrefix = "client:";
 interface EventServerFuncParams extends ServerFuncParams {
     event?: string | string[];
     data?: any;
     act?: 'sub' | 'pub' | 'unsub';
+    clientId?: string;
 }
 declare class EventServer extends ResServerTools {
+    /**
+     * Controls whether the client-published events are auto-emitted on server's localBus.
+     * Defaults to false for security. Must be explicitly enabled for 'client:' prefixed events to be emitted.
+     */
+    static autoInjectToLocalBus: boolean;
     private static _boundEbListener?;
     static _pubSubTransport: IPubSubServerTransport | undefined;
     static setPubSubTransport(t?: IPubSubServerTransport): void;
@@ -1752,25 +1782,40 @@ declare class EventServer extends ResServerTools {
         "event-bus": EventToolFunc;
     };
     get pubSubTransport(): IPubSubServerTransport | undefined;
-    static publish(data: any, event: string, target?: {
+    static publish(event: string, data: any, target?: {
         clientId?: string | string[];
     }): void | undefined;
     static ebListener(eventType: string, ...data: any[]): void;
-    static subscribe(req: IncomingMessage, res: ServerResponse, events?: string[], options?: any): PubSubClient | undefined;
     static alreadyForward(event: string): true | undefined;
-    publishSSE(data: any, event: string): any;
-    subscribeSSE(req: IncomingMessage, res: ServerResponse, events?: string | string[]): any;
+    publishServerEvent(event: string, data: any): any;
     forward(events: string | string[]): void;
     unforward(events: string | string[]): void;
-    list({ _req, _res, event }: EventServerFuncParams): void;
-    $sub({ event }: EventServerFuncParams): {
+    list({ _req, _res, event }: EventServerFuncParams): PubSubServerSession;
+    $sub({ event, _req }: EventServerFuncParams): {
+        forward: boolean;
+        subscribed: boolean;
         event: string | string[];
+        clientId: any;
+    } | {
+        forward: boolean;
+        event: string | string[];
+        subscribed?: undefined;
+        clientId?: undefined;
     };
-    $unsub({ event }: EventServerFuncParams): {
+    $unsub({ event, _req }: EventServerFuncParams): {
+        forward: boolean;
+        subscribed: boolean;
+        event: string | string[];
+        clientId: any;
+    } | {
+        forward: boolean;
         event: string | string[];
+        subscribed?: undefined;
+        clientId?: undefined;
     };
-    $publish({ event: events, data }: EventServerFuncParams): {
+    $publish({ event: events, data, _req }: EventServerFuncParams): {
         event: string[];
+        senderId: any;
     };
     isStream(params: ServerFuncParams): boolean;
 }
@@ -1778,4 +1823,4 @@ declare const eventServer: EventServer;
 
 declare function registerCoreTools(): void;
 
-export { funcGetMeta as $, type AsyncTaskId as A, type BinarySemaphoreOptions as B, ClientToolTransport as C, DefaultAsyncSemaphoreCapacity as D, TaskAbortController as E, type Funcs as F, type TaskAbortControllers as G, type TaskPromise as H, type IPubSubServerTransport as I, CancelableAbility as J, makeToolFuncCancelable as K, type FuncParamType as L, type FuncParam as M, type FuncParams as N, type TFunc as O, type PubSubClientId as P, type BaseFuncItem as Q, RemoteToolFuncSchema as R, ServerTools as S, ToolTransport as T, type FuncItem as U, type BaseFunc as V, type ToolFuncPackage as W, ToolFunc as X, ToolFuncSchema as Y, FuncMetaSymbol as Z, funcWithMeta as _, type AIModelNameRules as a, ClientTools as a0, type ClientFuncItem as a1, ClientToolFuncSchema as a2, type ServerFuncParams as a3, type ServerFuncItem as a4, ServerToolFuncSchema as a5, registerCoreTools as a6, EventToolFunc as a7, event as a8, SecondaryCache as a9, _lrucache as aa, createLRUCache as ab, lrucache as ac, type EventClientFuncParams as ad, EventClient as ae, eventClient as af, type EventServerFuncParams as ag, EventServer as ah, eventServer as ai, type ResClientFuncParams as aj, ResClientTools as ak, type ResServerFuncParams as al, ResServerTools as am, type RpcMethodHandler as an, type IClientToolTransport as ao, type PubSubCtx as ap, type PubSubClient as aq, type PubSubServerSession as b, type IPubSubClientTransport as c, type PubSubClientStream as d, type IToolTransport as e, type ActionName as f, PASSING_SCORE as g, ActionNames as h, type AIModelNameRuleFn as i, type AIModelNameRule as j, type RemoteFuncItem as k, type SemaphoreIsReadyFuncType as l, type BinarySemaphoreAcquireOptions as m, type BinarySemaphoreReleaseOptions as n, type BinarySemaphoreReleaserFunc as o, type SemaphoreOptions as p, type SemaphoreTaskItem as q, BinarySemaphore as r, Semaphore as s, RateLimit as t, ToolAsyncMultiTaskBit as u, ToolAsyncCancelableBit as v, ToolAsyncPriorityBit as w, AsyncFeatureBits as x, AsyncFeatures as y, type CancelableAbilityOptions as z };
+export { funcGetMeta as $, type AsyncTaskId as A, type BinarySemaphoreOptions as B, ClientToolTransport as C, DefaultAsyncSemaphoreCapacity as D, TaskAbortController as E, type Funcs as F, type TaskAbortControllers as G, type TaskPromise as H, type IPubSubServerTransport as I, CancelableAbility as J, makeToolFuncCancelable as K, type FuncParamType as L, type FuncParam as M, type FuncParams as N, type TFunc as O, type PubSubServerSession as P, type BaseFuncItem as Q, RemoteToolFuncSchema as R, ServerTools as S, ToolTransport as T, type FuncItem as U, type BaseFunc as V, type ToolFuncPackage as W, ToolFunc as X, ToolFuncSchema as Y, FuncMetaSymbol as Z, funcWithMeta as _, type AIModelNameRules as a, ClientTools as a0, type ClientFuncItem as a1, ClientToolFuncSchema as a2, type ServerFuncParams as a3, type ServerFuncItem as a4, ServerToolFuncSchema as a5, registerCoreTools as a6, EventToolFunc as a7, event as a8, SecondaryCache as a9, _lrucache as aa, createLRUCache as ab, lrucache as ac, type EventClientFuncParams as ad, EventClient as ae, eventClient as af, ClientEventPrefix as ag, type EventServerFuncParams as ah, EventServer as ai, eventServer as aj, type RpcMethodsClientFuncParams as ak, RpcMethodsClientTool as al, RpcMethodsClientToolSchema as am, type RpcMethodsServerFuncParams as an, RpcMethodsServerTool as ao, RpcMethodsServerToolSchema as ap, type ResClientFuncParams as aq, ResClientTools as ar, type ResServerFuncParams as as, ResServerTools as at, type RpcMethodHandler as au, type IClientToolTransport as av, type PubSubCtx as aw, type PubSubClientId as b, type IPubSubClientTransport as c, type PubSubClientStream as d, type IToolTransport as e, type ActionName as f, PASSING_SCORE as g, ActionNames as h, type AIModelNameRuleFn as i, type AIModelNameRule as j, type RemoteFuncItem as k, type SemaphoreIsReadyFuncType as l, type BinarySemaphoreAcquireOptions as m, type BinarySemaphoreReleaseOptions as n, type BinarySemaphoreReleaserFunc as o, type SemaphoreOptions as p, type SemaphoreTaskItem as q, BinarySemaphore as r, Semaphore as s, RateLimit as t, ToolAsyncMultiTaskBit as u, ToolAsyncCancelableBit as v, ToolAsyncPriorityBit as w, AsyncFeatureBits as x, AsyncFeatures as y, type CancelableAbilityOptions as z };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import * as custom_ability from 'custom-ability';
 export { createAbilityInjector } from 'custom-ability';
 export { toRegExp } from 'util-ex';
-import { A as AsyncTaskId, a as AIModelNameRules, I as IPubSubServerTransport, P as PubSubClientId, b as PubSubServerSession, c as IPubSubClientTransport, d as PubSubClientStream, e as IToolTransport, S as ServerTools, T as ToolTransport, C as ClientToolTransport, F as Funcs, f as ActionName } from './index-BCco-g_I.mjs';
-export { j as AIModelNameRule, i as AIModelNameRuleFn, h as ActionNames, x as AsyncFeatureBits, y as AsyncFeatures, V as BaseFunc, Q as BaseFuncItem, r as BinarySemaphore, m as BinarySemaphoreAcquireOptions, B as BinarySemaphoreOptions, n as BinarySemaphoreReleaseOptions, o as BinarySemaphoreReleaserFunc, J as CancelableAbility, z as CancelableAbilityOptions, a1 as ClientFuncItem, a2 as ClientToolFuncSchema, a0 as ClientTools, D as DefaultAsyncSemaphoreCapacity, ae as EventClient, ad as EventClientFuncParams, ah as EventServer, ag as EventServerFuncParams, a7 as EventToolFunc, U as FuncItem, Z as FuncMetaSymbol, M as FuncParam, L as FuncParamType, N as FuncParams, ao as IClientToolTransport, g as PASSING_SCORE, aq as PubSubClient, ap as PubSubCtx, t as RateLimit, k as RemoteFuncItem, R as RemoteToolFuncSchema, aj as ResClientFuncParams, ak as ResClientTools, al as ResServerFuncParams, am as ResServerTools, an as RpcMethodHandler, a9 as SecondaryCache, s as Semaphore, l as SemaphoreIsReadyFuncType, p as SemaphoreOptions, q as SemaphoreTaskItem, a4 as ServerFuncItem, a3 as ServerFuncParams, a5 as ServerToolFuncSchema, O as TFunc, E as TaskAbortController, G as TaskAbortControllers, H as TaskPromise, v as ToolAsyncCancelableBit, u as ToolAsyncMultiTaskBit, w as ToolAsyncPriorityBit, X as ToolFunc, W as ToolFuncPackage, Y as ToolFuncSchema, aa as _lrucache, ab as createLRUCache, a8 as event, af as eventClient, ai as eventServer, $ as funcGetMeta, _ as funcWithMeta, ac as lrucache, K as makeToolFuncCancelable, a6 as registerCoreTools } from './index-BCco-g_I.mjs';
+import { A as AsyncTaskId, a as AIModelNameRules, I as IPubSubServerTransport, P as PubSubServerSession, b as PubSubClientId, c as IPubSubClientTransport, d as PubSubClientStream, e as IToolTransport, S as ServerTools, T as ToolTransport, C as ClientToolTransport, F as Funcs, f as ActionName } from './index-BLW3R7VS.mjs';
+export { j as AIModelNameRule, i as AIModelNameRuleFn, h as ActionNames, x as AsyncFeatureBits, y as AsyncFeatures, V as BaseFunc, Q as BaseFuncItem, r as BinarySemaphore, m as BinarySemaphoreAcquireOptions, B as BinarySemaphoreOptions, n as BinarySemaphoreReleaseOptions, o as BinarySemaphoreReleaserFunc, J as CancelableAbility, z as CancelableAbilityOptions, ag as ClientEventPrefix, a1 as ClientFuncItem, a2 as ClientToolFuncSchema, a0 as ClientTools, D as DefaultAsyncSemaphoreCapacity, ae as EventClient, ad as EventClientFuncParams, ai as EventServer, ah as EventServerFuncParams, a7 as EventToolFunc, U as FuncItem, Z as FuncMetaSymbol, M as FuncParam, L as FuncParamType, N as FuncParams, av as IClientToolTransport, g as PASSING_SCORE, aw as PubSubCtx, t as RateLimit, k as RemoteFuncItem, R as RemoteToolFuncSchema, aq as ResClientFuncParams, ar as ResClientTools, as as ResServerFuncParams, at as ResServerTools, au as RpcMethodHandler, ak as RpcMethodsClientFuncParams, al as RpcMethodsClientTool, am as RpcMethodsClientToolSchema, an as RpcMethodsServerFuncParams, ao as RpcMethodsServerTool, ap as RpcMethodsServerToolSchema, a9 as SecondaryCache, s as Semaphore, l as SemaphoreIsReadyFuncType, p as SemaphoreOptions, q as SemaphoreTaskItem, a4 as ServerFuncItem, a3 as ServerFuncParams, a5 as ServerToolFuncSchema, O as TFunc, E as TaskAbortController, G as TaskAbortControllers, H as TaskPromise, v as ToolAsyncCancelableBit, u as ToolAsyncMultiTaskBit, w as ToolAsyncPriorityBit, X as ToolFunc, W as ToolFuncPackage, Y as ToolFuncSchema, aa as _lrucache, ab as createLRUCache, a8 as event, af as eventClient, aj as eventServer, $ as funcGetMeta, _ as funcWithMeta, ac as lrucache, K as makeToolFuncCancelable, a6 as registerCoreTools } from './index-BLW3R7VS.mjs';
 import * as _isdk_common_error from '@isdk/common-error';
 import { BaseError } from '@isdk/common-error';
 export { AbortError, AbortErrorCode, AlreadyExistsError, AlreadyExistsErrorCode, BaseError, CommonError, ErrorCode, InternalErrorCode, NotFoundError, NotFoundErrorCode, NotImplementationError, NotImplementedErrorCode, createError, throwError } from '@isdk/common-error';
@@ -11,6 +11,9 @@ export { EnvStringTemplate as EnvPromptTemplate, FStringTemplate as FStringPromp
 import { Event, EventEmitter } from 'events-ex';
 export { EventEmitter, states as EventStates, eventable, wrapEventEmitter } from 'events-ex';
 import http, { IncomingMessage, ServerResponse } from 'http';
+export { nanoid } from 'nanoid';
+import { v1, v4, v5, v6, v7 } from 'uuid';
+export { NIL as uuidNIL, parse as uuidParse, stringify as uuidStringify, validate as uuidValidate, version as uuidVersion, v1 as uuidv1, v4 as uuidv4, v5 as uuidv5, v6 as uuidv6, v7 as uuidv7 } from 'uuid';
 import * as _base32768 from 'base32768';
 import { IDataType } from 'hash-wasm';
 export { ConfigFile, FilenameReservedRegex, SanitizeFilenameOptions, WindowsReservedNameRegex, extNameLevel, getMultiLevelExtname, isValidFilename, isValidFilepath, parseYaml, registerYamlTag, sanitizeFilename, sanitizeFilepath, stringifyYaml } from '@isdk/util';
@@ -18,7 +21,6 @@ import * as fs from 'fs';
 import _memoize, { Options } from 'memoizee';
 export { f as findPort } from './find-port-qS1CZ9c-.mjs';
 import { PreTrainedTokenizer } from '@huggingface/transformers';
-export { NIL as uuidNIL, parse as uuidParse, stringify as uuidStringify, validate as uuidValidate, version as uuidVersion, v1 as uuidv1, v4 as uuidv4, v5 as uuidv5 } from 'uuid';
 export { canonicalize } from 'json-canonicalize';
 export { mimeType } from 'mime-type/with-db';
 export { add as addDate, formatISO, parse as parseDateFormat, parseISO, toDate } from 'date-fns';
@@ -374,7 +376,9 @@ declare const EventName = "event";
 declare const EventBusName = "event-bus";
 type EventListenerFn = (this: Event, name: string, ...args: any) => any;
 type EventErrorListenerFn = (this: Event, err: Error, name: string, ...args: any) => any;
-declare function getEventableClass(Backend: any): {
+declare function getEventableClass(Backend: any, options?: {
+    eventBusName?: string;
+}): {
     new (): {
         name: string;
         _events: any;
@@ -395,7 +399,7 @@ type Events = (string | RegExp)[];
 /**
  * Represents a client connected to the SSE channel.
  */
-type Client = {
+type SSEClient = {
     /** The incoming HTTP request from the client. */
     req: IncomingMessage;
     /** The server response object used to send events to the client. */
@@ -404,9 +408,8 @@ type Client = {
     events?: Events;
     /**
      * A unique identifier for the client.
-     * If not provided during subscription, it defaults to `remoteAddress:remotePort`.
      */
-    clientId?: string;
+    clientId: string;
 };
 declare const SSEChannelAlreadyClosedErrCode = 498;
 /**
@@ -417,16 +420,27 @@ declare const SSEChannelAlreadyClosedErrCode = 498;
  */
 declare class SSEChannel {
     _active: boolean;
-    clients: Set<Client>;
+    clients: Map<string, SSEClient>;
     messages: Record<string, any>[];
     nextID: number;
     options: Record<string, any>;
     pingTimer?: NodeJS.Timeout;
+    /**
+     * Gets the active status of the channel.
+     * @returns True if the channel is active, false otherwise.
+     */
     get active(): boolean;
     set active(v: boolean);
     /**
      * Creates a new SSE channel.
      * @param options - The options for the SSE channel.
+     * @param options.pingInterval - Interval in milliseconds to send ping messages (default: 3000).
+     * @param options.maxStreamDuration - Maximum duration of a client connection in milliseconds (default: 30000).
+     * @param options.clientRetryInterval - Interval in milliseconds for clients to retry connection (default: 1000).
+     * @param options.startId - Starting ID for messages (default: 1).
+     * @param options.historySize - Maximum number of messages to keep in history (default: 100).
+     * @param options.rewind - Number of historical messages to send to new clients (default: 0).
+     * @param options.cors - Whether to enable CORS headers (default: false).
      */
     constructor(options?: Record<string, any>);
     /**
@@ -442,21 +456,44 @@ declare class SSEChannel {
         clientId?: string | string[];
     }): number | undefined;
     /**
-     * Subscribes a client to the SSE channel.
+     * Adds event subscriptions to an active client.
+     * @param clientId The ID of the client to modify.
+     * @param events An array of event names or patterns to add.
+     * @returns `true` if the client was found and updated, otherwise `false`.
+     */
+    subscribe(clientId: string, events: Events): boolean;
+    /**
+     * Removes event subscriptions from an active client.
+     * @param clientId The ID of the client to modify.
+     * @param events An array of event names or patterns to remove.
+     * @returns `true` if the client was found and updated, otherwise `false`.
+     */
+    unsubscribe(clientId: string, events: Events): boolean;
+    /**
+     * Finds a client instance by its unique ID.
+     * @param clientId The unique ID of the client.
+     * @returns The matching SSEClient, or undefined if not found.
+     */
+    getClient(clientId: string): SSEClient | undefined;
+    /**
+     * Establishes a new SSE connection with a client and adds it to the channel.
      *
-     * @param req The incoming HTTP request.
-     * @param res The server response.
-     * @param events An array of event names or patterns to subscribe to.
-     * @param clientId An optional unique ID for the client. If not provided, it defaults to `remoteAddress:remotePort`.
-     * @returns The newly created client object.
-     * @throws An error if the channel is closed.
+     * @param req The incoming HTTP request from the client.
+     * @param res The server response object used to send events to the client.
+     * @param events An array of event names or patterns that the client wants to subscribe to.
+     * @param clientId An optional unique identifier for the client. If not provided, one will be generated based on the client's IP and port.
+     * @returns The newly created client object representing the connected client.
+     * @throws An error if the channel is closed or if a client ID cannot be determined.
      */
-    subscribe(req: IncomingMessage, res: ServerResponse, events?: Events, clientId?: string): Client;
+    connect(req: IncomingMessage, res: ServerResponse, events?: Events, clientId?: string): SSEClient;
     /**
-     * Unsubscribes a client from the SSE channel.
-     * @param c - The client to unsubscribe.
+     * Disconnects a client from the SSE channel and cleans up resources.
+     * @param c - The client to disconnect.
+     */
+    disconnect(c: SSEClient): void;
+    /**
+     * Disconnects all clients from the SSE channel.
      */
-    unsubscribe(c: Client): void;
     clearClients(): void;
     /**
      * Lists the clients connected to the SSE channel grouped by IP address.
@@ -589,7 +626,26 @@ interface StreamCallbacksAndOptions<I = any, O = any> {
 */
 declare function createCallbacksTransformer<I = any, O = any>(cb: StreamCallbacksAndOptions<I, O> | undefined): TransformStream<I, O>;
 
-declare function uuid(ver?: 1 | 4 | 5, encode?: boolean): string;
+declare const uuids: {
+    1: typeof v1;
+    4: typeof v4;
+    5: typeof v5;
+    6: typeof v6;
+    7: typeof v7;
+};
+type UUIDVersions = keyof typeof uuids;
+/**
+ * Generates a UUID (Universally Unique Identifier) based on the specified version and encoding options.
+ *
+ * @param encode - Whether to encode the generated UUID using Base32768 encoding. Defaults to `false`.
+ *
+ * @returns A string representing the generated UUID. If `encode` is `true`, the UUID will be encoded in Base32768 format.
+ *
+ * @example
+ * // Generate an encoded UUID version 1 using Base32768
+ * const encodedUuid1 = uuid(true);
+ */
+declare function uuid(encode?: boolean): string;
 
 declare enum HashAlgorithm {
     md5 = 1,
@@ -2304,28 +2360,28 @@ declare function splitWords(input: string): string[];
 
 /**
  * Utility to serialize an object into a URL query parameter string.
- * @param {any} objParam - The parameter object.
- * @returns {string} The URL-encoded query string or an empty string.
+ * @param objParam The parameter object.
+ * @param omitQuestionMark If true, omits the leading '?' from the result. Defaults to false.
+ * @returns The URL-encoded query string or an empty string.
  */
-declare function genUrlParamsStr(objParam: any): string;
+declare function genUrlParamsStr(objParam: any, omitQuestionMark?: boolean): string;
 
 declare class SseServerPubSubTransport implements IPubSubServerTransport {
     readonly name = "sse";
     readonly protocol: "sse";
     private channel;
+    private sessions;
     private onConn?;
     private onDis?;
-    mount?(): void;
-    subscribe(events?: string[], options?: {
-        req?: IncomingMessage;
-        res?: ServerResponse;
-        clientId?: string;
-    }): {
+    connect(options?: {
         req: IncomingMessage;
         res: ServerResponse;
-        events?: (string | RegExp)[];
         clientId?: string;
-    };
+        events?: string[];
+    }): PubSubServerSession;
+    getSessionFromReq(req: IncomingMessage): PubSubServerSession | undefined;
+    subscribe(session: PubSubServerSession, events: string[]): void;
+    unsubscribe(session: PubSubServerSession, events: string[]): void;
     publish(event: string, data: any, target?: {
         clientId?: PubSubClientId | PubSubClientId[];
     }): void;
@@ -2334,7 +2390,9 @@ declare class SseServerPubSubTransport implements IPubSubServerTransport {
 }
 
 declare class SseClientPubSubTransport implements IPubSubClientTransport {
-    connect(url: string, params?: Record<string, any>): PubSubClientStream;
+    private apiRoot;
+    setApiRoot(apiRoot: string): void;
+    connect(url: string, params?: any): Promise<PubSubClientStream>;
     disconnect(stream: PubSubClientStream): void;
 }
 
@@ -2345,9 +2403,15 @@ declare class SseClientPubSubTransport implements IPubSubClientTransport {
 interface IServerToolTransport extends IToolTransport {
     /**
      * Mounts the ServerTools registry, creating the necessary API routes.
-     * @param serverTools The ServerTools class.
-     * @param apiPrefix An optional prefix for all API routes.
-     * @param options Additional options for the transport start.
+     *
+     * This method is responsible for integrating the tool-handling logic with a
+     * running server instance.
+     *
+     * @param serverTools The ServerTools class containing the tool definitions.
+     * @param apiPrefix An optional prefix for all API routes (e.g., '/api').
+     * @param options A container for transport-specific options. For example,
+     *   an HTTP-based transport would expect an `{ server: http.Server }` object
+     *   to attach its route handlers to.
      */
     mount(serverTools: typeof ServerTools, apiPrefix?: string, options?: any): void;
     /**
@@ -2389,7 +2453,6 @@ declare abstract class ServerToolTransport extends ToolTransport implements ISer
 declare class HttpServerToolTransport extends ServerToolTransport {
     server: http.Server;
     private discoveryHandlerInfo;
-    private rpcHandlerInfo;
     constructor(options?: http.ServerOptions);
     private requestListener;
     addDiscoveryHandler(apiPrefix: string, handler: () => any): void;
@@ -2400,7 +2463,7 @@ declare class HttpServerToolTransport extends ServerToolTransport {
         port: number;
         host?: string;
     }): Promise<void>;
-    stop(): Promise<void>;
+    stop(force?: boolean): Promise<void>;
     getRaw(): http.Server;
 }
 
@@ -2424,4 +2487,4 @@ declare class HttpClientToolTransport extends ClientToolTransport {
     toObject(res: any, args?: any): Promise<any>;
 }
 
-export { AIArgProcessor, type AIChatAssistantMessageParam, type AIChatContentPart, type AIChatContentPartImage, type AIChatContentPartText, type AIChatMessageParam, type AIChatMessageParamBase, type AIChatMessageToolCall, type AIChatRole, AIChatRoles, type AIChatSystemMessageParam, type AIChatToolChoiceFuncObject, type AIChatToolChoiceObject, type AIChatToolChoiceParam, type AIChatToolFunc, type AIChatToolFuncParam, type AIChatToolMessageParam, type AIChatToolParam, type AIChatToolTypeObject, type AIChatUserMessageParam, type AIChoiceConfig, type AIMessageType, AIMessageTypes, AIModelNameRules, type AIResult, AIStream, type AIStreamParser, type AIStreamParserOptions, type AITextGenerationFinishReason, AITextGenerationFinishReasons, ActionName, ArrayMergeWay, ArrayMergeWaySymbol, AsyncTaskId, type BeforeShutdownListener, ChoiceArgProcessor, ClientToolTransport, DEFAULT_CONFIG_NAME, DefaultDateFormat, EventBusName, type EventErrorListenerFn, type EventListenerFn, EventName, FewShotPromptTemplate, type FewShotPromptTemplateOptions, Funcs, type HashAlgoParams, HashAlgorithm, HttpClientToolTransport, HttpServerToolTransport, type IFileMetaInfo, IPubSubClientTransport, IPubSubServerTransport, type IReadTextFileChunksOptions, type IServerToolTransport, IToolTransport, type ITruncateToTokenLimitOptions, IntSet, type JsonFilter, LLM_TOKENIZER_NAMES, LLM_TOKENIZER_NAMES_MAP, ObjectArgsToArgsInfo, type ParseObjectArgumentOptions, type ProbabilityItem, PromptExampleSelector, type PromptExampleSelectorOptions, type PromptExamples, PubSubClientId, PubSubClientStream, PubSubServerSession, RStreamErrCode, ReadableStreamError, type ReplacePlacehoderOptions, ResponseRStreamErrCode, SHUTDOWN_SIGNALS, SSEChannel, SSEChannelAlreadyClosedErrCode, type SectionStringOptions, ServerToolTransport, ServerTools, SignalGate, type SplitSentenceOptions, SseClientPubSubTransport, SseServerPubSubTransport, StrangeHumanName, type StreamCallbacksAndOptions, TemplateArgProcessor, ToolTransport, YamlTypeBaseObject, assignDirs, backendEventable, base32768, beforeShutdown, calcPerplexity, calcPerplexitySimple, completeSentences, concatText, countLLMTokens, countRegexMatches, createCallbacksTransformer, createEmptyReadableStream, createEndWithRepetitionDetector, createEventStreamTransformer, createYamlObjectTag, dateToText, decodeCharset, defaultsWithConcat, detectCharset, encodeLLMTokens, ensureQuoted, expandConfig, expandPath, expandPathInObject, expandPaths, fileIsExists, filterValidFnScope, findIndexNonEmptyFrom, formatTextWithSpace, genUrlParamsStr, getAllEnumKeys, getConfigFileNames, getConfigs, getFileMetaInfo, getHashAlgoBySize, getKeysPath, getLLMTokenizer, getPackageDir, getRealFilepath, getResponseErrorReadableStream, getXDGConfigs, hasDirectoryIn, hash, hashFile, hashObject, hashStream, initShutdown, isLangUsingSpaces, isListItemString, isModelNameMatched, isPunctuationChar, isQuoted, isRegExp, isSameString, isSectionString, isSentenceEnding, isSepLineString, isStrWrapped, isSubdirectory, isTitleString, isWebStream, joinSplitWords, jsonFilterToWhere, jsonToMarkdownStr, loadAIConfig, loadConfig, loadConfigFile, loadFileFromPaths, loadTextFromPaths, matchUrlProtocol, memoize, mergeArray, messagesToText, normalizePath, paramsSizeToScaleStr, parseCommand, parseJsJson, parseJsJsonSimpleSync, parseObjectArgInfo, parseObjectArgumentInfos, parseObjectArguments, parseObjectArgumentsAsArgInfos, pruneSubdirectories, pruneSubdirectoriesInPlace, quoteStr, readFilenamesRecursiveSync, readTextFileChunks, readTextFileChunksEx, readableFromAsyncIterable, removeMarkdownBold, removeMarkdownBoldAndItalic, removeMarkdownItalic, replaceWithPlaceholder, restoreFromPlacehoders, saveConfigFile, scaleStrToParamsSize, shutdown, simplifyObjectArguments, sleep, sortedValues, splitChunks, splitParagraph, splitSentence, splitWords, stripConsoleColor, textToDate, toDateTime, trimStartOfStreamHelper, truncTo, truncateByToken, truncateToTokenLimit, truncateToTokenLimitEx, uuid, wait, xxhash, xxhash32, xxhash64, xxhashAsStr, yieldExec };
+export { AIArgProcessor, type AIChatAssistantMessageParam, type AIChatContentPart, type AIChatContentPartImage, type AIChatContentPartText, type AIChatMessageParam, type AIChatMessageParamBase, type AIChatMessageToolCall, type AIChatRole, AIChatRoles, type AIChatSystemMessageParam, type AIChatToolChoiceFuncObject, type AIChatToolChoiceObject, type AIChatToolChoiceParam, type AIChatToolFunc, type AIChatToolFuncParam, type AIChatToolMessageParam, type AIChatToolParam, type AIChatToolTypeObject, type AIChatUserMessageParam, type AIChoiceConfig, type AIMessageType, AIMessageTypes, AIModelNameRules, type AIResult, AIStream, type AIStreamParser, type AIStreamParserOptions, type AITextGenerationFinishReason, AITextGenerationFinishReasons, ActionName, ArrayMergeWay, ArrayMergeWaySymbol, AsyncTaskId, type BeforeShutdownListener, ChoiceArgProcessor, ClientToolTransport, DEFAULT_CONFIG_NAME, DefaultDateFormat, EventBusName, type EventErrorListenerFn, type EventListenerFn, EventName, FewShotPromptTemplate, type FewShotPromptTemplateOptions, Funcs, type HashAlgoParams, HashAlgorithm, HttpClientToolTransport, HttpServerToolTransport, type IFileMetaInfo, IPubSubClientTransport, IPubSubServerTransport, type IReadTextFileChunksOptions, type IServerToolTransport, IToolTransport, type ITruncateToTokenLimitOptions, IntSet, type JsonFilter, LLM_TOKENIZER_NAMES, LLM_TOKENIZER_NAMES_MAP, ObjectArgsToArgsInfo, type ParseObjectArgumentOptions, type ProbabilityItem, PromptExampleSelector, type PromptExampleSelectorOptions, type PromptExamples, PubSubClientId, PubSubClientStream, PubSubServerSession, RStreamErrCode, ReadableStreamError, type ReplacePlacehoderOptions, ResponseRStreamErrCode, SHUTDOWN_SIGNALS, SSEChannel, SSEChannelAlreadyClosedErrCode, type SSEClient, type SectionStringOptions, ServerToolTransport, ServerTools, SignalGate, type SplitSentenceOptions, SseClientPubSubTransport, SseServerPubSubTransport, StrangeHumanName, type StreamCallbacksAndOptions, TemplateArgProcessor, ToolTransport, type UUIDVersions, YamlTypeBaseObject, assignDirs, backendEventable, base32768, beforeShutdown, calcPerplexity, calcPerplexitySimple, completeSentences, concatText, countLLMTokens, countRegexMatches, createCallbacksTransformer, createEmptyReadableStream, createEndWithRepetitionDetector, createEventStreamTransformer, createYamlObjectTag, dateToText, decodeCharset, defaultsWithConcat, detectCharset, encodeLLMTokens, ensureQuoted, expandConfig, expandPath, expandPathInObject, expandPaths, fileIsExists, filterValidFnScope, findIndexNonEmptyFrom, formatTextWithSpace, genUrlParamsStr, getAllEnumKeys, getConfigFileNames, getConfigs, getFileMetaInfo, getHashAlgoBySize, getKeysPath, getLLMTokenizer, getPackageDir, getRealFilepath, getResponseErrorReadableStream, getXDGConfigs, hasDirectoryIn, hash, hashFile, hashObject, hashStream, initShutdown, isLangUsingSpaces, isListItemString, isModelNameMatched, isPunctuationChar, isQuoted, isRegExp, isSameString, isSectionString, isSentenceEnding, isSepLineString, isStrWrapped, isSubdirectory, isTitleString, isWebStream, joinSplitWords, jsonFilterToWhere, jsonToMarkdownStr, loadAIConfig, loadConfig, loadConfigFile, loadFileFromPaths, loadTextFromPaths, matchUrlProtocol, memoize, mergeArray, messagesToText, normalizePath, paramsSizeToScaleStr, parseCommand, parseJsJson, parseJsJsonSimpleSync, parseObjectArgInfo, parseObjectArgumentInfos, parseObjectArguments, parseObjectArgumentsAsArgInfos, pruneSubdirectories, pruneSubdirectoriesInPlace, quoteStr, readFilenamesRecursiveSync, readTextFileChunks, readTextFileChunksEx, readableFromAsyncIterable, removeMarkdownBold, removeMarkdownBoldAndItalic, removeMarkdownItalic, replaceWithPlaceholder, restoreFromPlacehoders, saveConfigFile, scaleStrToParamsSize, shutdown, simplifyObjectArguments, sleep, sortedValues, splitChunks, splitParagraph, splitSentence, splitWords, stripConsoleColor, textToDate, toDateTime, trimStartOfStreamHelper, truncTo, truncateByToken, truncateToTokenLimit, truncateToTokenLimitEx, uuid, wait, xxhash, xxhash32, xxhash64, xxhashAsStr, yieldExec };