@promptbook/remote-server 0.81.0 → 0.82.0-2

package/esm/typings/src/_packages/remote-client.index.d.ts

@@ -1,8 +1,18 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
-import type { RemoteLlmExecutionToolsOptions } from '../llm-providers/remote/interfaces/RemoteLlmExecutionToolsOptions';
-import type { RemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
+import { compilePipelineOnRemoteServer } from '../conversion/compilePipelineOnRemoteServer';
 import { RemoteLlmExecutionTools } from '../llm-providers/remote/RemoteLlmExecutionTools';
+import { preparePipelineOnRemoteServer } from '../prepare/preparePipelineOnRemoteServer';
+import type { PromptbookServer_Identification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { PromptbookServer_ApplicationIdentification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { PromptbookServer_AnonymousIdentification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { RemoteClientOptions } from '../remote-server/types/RemoteClientOptions';
+import type { RemoteServerOptions } from '../remote-server/types/RemoteServerOptions';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
-export type { RemoteLlmExecutionToolsOptions };
-export type { RemoteServerOptions };
+export { compilePipelineOnRemoteServer };
 export { RemoteLlmExecutionTools };
+export { preparePipelineOnRemoteServer };
+export type { PromptbookServer_Identification };
+export type { PromptbookServer_ApplicationIdentification };
+export type { PromptbookServer_AnonymousIdentification };
+export type { RemoteClientOptions };
+export type { RemoteServerOptions };

package/esm/typings/src/_packages/remote-server.index.d.ts

@@ -1,6 +1,12 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
-import type { RemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
-import { startRemoteServer } from '../llm-providers/remote/startRemoteServer';
+import type { PromptbookServer_Identification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { PromptbookServer_ApplicationIdentification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { PromptbookServer_AnonymousIdentification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import { startRemoteServer } from '../remote-server/startRemoteServer';
+import type { RemoteServerOptions } from '../remote-server/types/RemoteServerOptions';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
-export type { RemoteServerOptions };
+export type { PromptbookServer_Identification };
+export type { PromptbookServer_ApplicationIdentification };
+export type { PromptbookServer_AnonymousIdentification };
 export { startRemoteServer };
+export type { RemoteServerOptions };

package/esm/typings/src/_packages/types.index.d.ts

@@ -60,21 +60,6 @@ import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-op
 import type { GoogleExecutionToolsOptions } from '../llm-providers/google/GoogleExecutionToolsOptions';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
-import type { PromptbookServer_Error } from '../llm-providers/remote/interfaces/PromptbookServer_Error';
-import type { PromptbookServer_ListModels_Request } from '../llm-providers/remote/interfaces/PromptbookServer_ListModels_Request';
-import type { PromptbookServer_ListModels_CollectionRequest } from '../llm-providers/remote/interfaces/PromptbookServer_ListModels_Request';
-import type { PromptbookServer_ListModels_AnonymousRequest } from '../llm-providers/remote/interfaces/PromptbookServer_ListModels_Request';
-import type { PromptbookServer_ListModels_Response } from '../llm-providers/remote/interfaces/PromptbookServer_ListModels_Response';
-import type { PromptbookServer_Prompt_Progress } from '../llm-providers/remote/interfaces/PromptbookServer_Prompt_Progress';
-import type { PromptbookServer_Prompt_Request } from '../llm-providers/remote/interfaces/PromptbookServer_Prompt_Request';
-import type { PromptbookServer_Prompt_CollectionRequest } from '../llm-providers/remote/interfaces/PromptbookServer_Prompt_Request';
-import type { PromptbookServer_Prompt_AnonymousRequest } from '../llm-providers/remote/interfaces/PromptbookServer_Prompt_Request';
-import type { PromptbookServer_Prompt_Response } from '../llm-providers/remote/interfaces/PromptbookServer_Prompt_Response';
-import type { RemoteLlmExecutionToolsOptions } from '../llm-providers/remote/interfaces/RemoteLlmExecutionToolsOptions';
-import type { RemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
-import type { AnonymousRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
-import type { CollectionRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
-import type { CollectionRemoteServerClientOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { VercelExecutionToolsOptions } from '../llm-providers/vercel/VercelExecutionToolsOptions';
 import type { VercelProvider } from '../llm-providers/vercel/VercelProvider';
 import type { IsPipelineImplementingInterfaceOptions } from '../pipeline/PipelineInterface/isPipelineImplementingInterface';
@@ -102,6 +87,14 @@ import type { SimpleTaskJson } from '../pipeline/PipelineJson/SimpleTaskJson';
 import type { TaskJson } from '../pipeline/PipelineJson/TaskJson';
 import type { PipelineString } from '../pipeline/PipelineString';
 import type { PrepareAndScrapeOptions } from '../prepare/PrepareAndScrapeOptions';
+import type { PromptbookServer_Identification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { PromptbookServer_ApplicationIdentification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { PromptbookServer_AnonymousIdentification } from '../remote-server/socket-types/_subtypes/PromptbookServer_Identification';
+import type { RemoteClientOptions } from '../remote-server/types/RemoteClientOptions';
+import type { RemoteServerOptions } from '../remote-server/types/RemoteServerOptions';
+import type { AnonymousRemoteServerOptions } from '../remote-server/types/RemoteServerOptions';
+import type { ApplicationRemoteServerOptions } from '../remote-server/types/RemoteServerOptions';
+import type { ApplicationRemoteServerClientOptions } from '../remote-server/types/RemoteServerOptions';
 import type { Converter } from '../scrapers/_common/Converter';
 import type { ScraperAndConverterMetadata } from '../scrapers/_common/register/ScraperAndConverterMetadata';
 import type { ScraperConstructor } from '../scrapers/_common/register/ScraperConstructor';
@@ -118,6 +111,8 @@ import type { CompletionModelRequirements } from '../types/ModelRequirements';
 import type { ChatModelRequirements } from '../types/ModelRequirements';
 import type { EmbeddingModelRequirements } from '../types/ModelRequirements';
 import type { ModelVariant } from '../types/ModelVariant';
+import type { NonEmptyArray } from '../types/NonEmptyArray';
+import type { NonEmptyReadonlyArray } from '../types/NonEmptyArray';
 import type { Prompt } from '../types/Prompt';
 import type { CompletionPrompt } from '../types/Prompt';
 import type { ChatPrompt } from '../types/Prompt';
@@ -326,21 +321,6 @@ export type { AzureOpenAiExecutionToolsOptions };
 export type { GoogleExecutionToolsOptions };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiExecutionToolsOptions };
-export type { PromptbookServer_Error };
-export type { PromptbookServer_ListModels_Request };
-export type { PromptbookServer_ListModels_CollectionRequest };
-export type { PromptbookServer_ListModels_AnonymousRequest };
-export type { PromptbookServer_ListModels_Response };
-export type { PromptbookServer_Prompt_Progress };
-export type { PromptbookServer_Prompt_Request };
-export type { PromptbookServer_Prompt_CollectionRequest };
-export type { PromptbookServer_Prompt_AnonymousRequest };
-export type { PromptbookServer_Prompt_Response };
-export type { RemoteLlmExecutionToolsOptions };
-export type { RemoteServerOptions };
-export type { AnonymousRemoteServerOptions };
-export type { CollectionRemoteServerOptions };
-export type { CollectionRemoteServerClientOptions };
 export type { VercelExecutionToolsOptions };
 export type { VercelProvider };
 export type { IsPipelineImplementingInterfaceOptions };
@@ -368,6 +348,14 @@ export type { SimpleTaskJson };
 export type { TaskJson };
 export type { PipelineString };
 export type { PrepareAndScrapeOptions };
+export type { PromptbookServer_Identification };
+export type { PromptbookServer_ApplicationIdentification };
+export type { PromptbookServer_AnonymousIdentification };
+export type { RemoteClientOptions };
+export type { RemoteServerOptions };
+export type { AnonymousRemoteServerOptions };
+export type { ApplicationRemoteServerOptions };
+export type { ApplicationRemoteServerClientOptions };
 export type { Converter };
 export type { ScraperAndConverterMetadata };
 export type { ScraperConstructor };
@@ -384,6 +372,8 @@ export type { CompletionModelRequirements };
 export type { ChatModelRequirements };
 export type { EmbeddingModelRequirements };
 export type { ModelVariant };
+export type { NonEmptyArray };
+export type { NonEmptyReadonlyArray };
 export type { Prompt };
 export type { CompletionPrompt };
 export type { ChatPrompt };

package/esm/typings/src/collection/PipelineCollection.d.ts

@@ -20,6 +20,8 @@ export type PipelineCollection = {
     getPipelineByUrl(url: string_pipeline_url): Promisable<PipelineJson>;
     /**
      * Checks whether given prompt was defined in any pipeline in the collection
+     *
+     * @deprecated Make better mechanism for skimming the remote server
      */
     isResponsibleForPrompt(prompt: Prompt): Promisable<boolean>;
 };

package/esm/typings/src/conversion/compilePipelineOnRemoteServer.d.ts

@@ -0,0 +1,21 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { PipelineString } from '../pipeline/PipelineString';
+import type { RemoteClientOptions } from '../remote-server/types/RemoteClientOptions';
+/**
+ * Compile pipeline from string (markdown) format to JSON format
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
+ *
+ * Note: This function does not validate logic of the pipeline only the parsing
+ * Note: This function acts as compilation process
+ *
+ * @param pipelineString {Promptbook} in string markdown format (.book.md)
+ * @param options - Configuration of the remote server
+ * @returns {Promptbook} compiled in JSON format (.book.json)
+ * @throws {ParseError} if the promptbook string is not valid
+ * @public exported from `@promptbook/remote-client`
+ */
+export declare function compilePipelineOnRemoteServer<TCustomOptions = undefined>(pipelineString: PipelineString, options: RemoteClientOptions<TCustomOptions>): Promise<PipelineJson>;
+/**
+ * TODO: !!!! Do not return Promise<PipelineJson> But PreparePipelineTask
+ */

package/esm/typings/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions.d.ts

@@ -1,6 +1,6 @@
 import type { ClientOptions } from '@anthropic-ai/sdk';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
-import type { RemoteLlmExecutionToolsOptions } from '../remote/interfaces/RemoteLlmExecutionToolsOptions';
+import type { RemoteClientOptions } from '../../remote-server/types/RemoteClientOptions';
 /**
  * Options for `AnthropicClaudeExecutionTools`
  *
@@ -25,7 +25,7 @@ export type AnthropicClaudeExecutionToolsDirectOptions = CommonToolsOptions & Cl
  */
 export type AnthropicClaudeExecutionToolsProxiedOptions = CommonToolsOptions & ClientOptions & {
     isProxied: true;
-} & Pick<RemoteLlmExecutionToolsOptions<undefined>, 'remoteUrl' | 'path'>;
+} & Pick<RemoteClientOptions<undefined>, 'remoteUrl' | 'path'>;
 /**
  * TODO: [🧠][🤺] Pass `userId`
  */

package/esm/typings/src/llm-providers/remote/RemoteLlmExecutionTools.d.ts

@@ -3,13 +3,13 @@ import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { CompletionPromptResult } from '../../execution/PromptResult';
 import type { EmbeddingPromptResult } from '../../execution/PromptResult';
+import type { RemoteClientOptions } from '../../remote-server/types/RemoteClientOptions';
 import type { ChatPrompt } from '../../types/Prompt';
 import type { CompletionPrompt } from '../../types/Prompt';
 import type { EmbeddingPrompt } from '../../types/Prompt';
 import type { string_markdown } from '../../types/typeAliases';
 import type { string_markdown_text } from '../../types/typeAliases';
 import type { string_title } from '../../types/typeAliases';
-import type { RemoteLlmExecutionToolsOptions } from './interfaces/RemoteLlmExecutionToolsOptions';
 /**
  * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
  *
@@ -20,8 +20,8 @@ import type { RemoteLlmExecutionToolsOptions } from './interfaces/RemoteLlmExecu
  * @public exported from `@promptbook/remote-client`
  */
 export declare class RemoteLlmExecutionTools<TCustomOptions = undefined> implements LlmExecutionTools {
-    protected readonly options: RemoteLlmExecutionToolsOptions<TCustomOptions>;
-    constructor(options: RemoteLlmExecutionToolsOptions<TCustomOptions>);
+    protected readonly options: RemoteClientOptions<TCustomOptions>;
+    constructor(options: RemoteClientOptions<TCustomOptions>);
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
     /**
@@ -32,10 +32,6 @@ export declare class RemoteLlmExecutionTools<TCustomOptions = undefined> impleme
      * List all available models that can be used
      */
     listModels(): Promise<ReadonlyArray<AvailableModel>>;
-    /**
-     * Creates a connection to the remote proxy server.
-     */
-    private makeConnection;
     /**
      * Calls remote proxy server to use a chat model
      */

package/esm/typings/src/other/templates/getBookTemplates.d.ts

@@ -1,12 +1,14 @@
+import { SetRequired } from 'type-fest';
 import type { string_formfactor_name } from '../../formfactors/_common/string_formfactor_name';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+import type { NonEmptyReadonlyArray } from '../../types/NonEmptyArray';
 /**
  * @@@
  *
  * @singleton
  * @private internal cache of `getBookTemplate`
  */
-export declare let pipelines: Array<PipelineJson> | null;
+export declare let pipelines: Array<SetRequired<PipelineJson, 'pipelineUrl'>> | null;
 /**
  * Get template for new book
  *
@@ -14,9 +16,9 @@ export declare let pipelines: Array<PipelineJson> | null;
  * @returns list of pipelines
  * @public exported from `@promptbook/templates`
  */
-export declare function getBookTemplates(formfactorName?: string_formfactor_name): ReadonlyArray<PipelineJson>;
+export declare function getBookTemplates(formfactorName?: string_formfactor_name): NonEmptyReadonlyArray<SetRequired<PipelineJson, 'pipelineUrl'>>;
 /**
- * TODO: Unit test
+ * TODO: Unit test + test that what we guarantee - always return non-empty array is true for e
  * TODO: [🧠] Which is the best place for this function
  * TODO: !!6 For GENERIC template ensure at least one pipeline is present for typescript in `getBookTemplates`
  */

package/esm/typings/src/prepare/preparePipeline.d.ts

@@ -2,7 +2,7 @@ import type { ExecutionTools } from '../execution/ExecutionTools';
 import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
 import type { PrepareAndScrapeOptions } from './PrepareAndScrapeOptions';
 /**
- * Prepare pipeline from string (markdown) format to JSON format
+ * Prepare pipeline locally
  *
  * @see https://github.com/webgptorg/promptbook/discussions/196
  *
@@ -13,7 +13,7 @@ import type { PrepareAndScrapeOptions } from './PrepareAndScrapeOptions';
  */
 export declare function preparePipeline(pipeline: PipelineJson, tools: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>, options: PrepareAndScrapeOptions): Promise<PipelineJson>;
 /**
- * TODO: Write tests for `preparePipeline`
+ * TODO: Write tests for `preparePipeline` and `preparePipelineOnRemoteServer`
  * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
  * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
  * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools

package/esm/typings/src/prepare/preparePipelineOnRemoteServer.d.ts

@@ -0,0 +1,17 @@
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { RemoteClientOptions } from '../remote-server/types/RemoteClientOptions';
+/**
+ * Prepare pipeline on remote server
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
+ *
+ * Note: This function does not validate logic of the pipeline
+ * Note: This function acts as part of compilation process
+ * Note: When the pipeline is already prepared, it returns the same pipeline
+ *
+ * @public exported from `@promptbook/remote-client`
+ */
+export declare function preparePipelineOnRemoteServer<TCustomOptions = undefined>(pipeline: PipelineJson, options: RemoteClientOptions<TCustomOptions>): Promise<PipelineJson>;
+/**
+ * TODO: !!!! Do not return Promise<PipelineJson> But PreparePipelineTask
+ */

package/esm/typings/src/remote-server/createRemoteClient.d.ts

@@ -0,0 +1,10 @@
+import type { Socket } from 'socket.io-client';
+import type { RemoteClientOptions } from './types/RemoteClientOptions';
+/**
+ * Creates a connection to the remote proxy server.
+ *
+ * Note: This function creates a connection to the remote server and returns a socket but responsibility of closing the connection is on the caller
+ *
+ * @private internal utility function
+ */
+export declare function createRemoteClient<TCustomOptions = undefined>(options: RemoteClientOptions<TCustomOptions>): Promise<Socket>;

package/esm/typings/src/{llm-providers/remote/interfaces → remote-server/socket-types/_common}/PromptbookServer_Error.d.ts

@@ -1,7 +1,7 @@
 import type { ErrorJson } from '../../../errors/utils/ErrorJson';
 /**
- * Socket.io error for remote text generation
- *
  * This is sent from server to client when error occurs and stops the process
+ *
+ * @private internal type of remote server
  */
 export type PromptbookServer_Error = ErrorJson;

package/esm/typings/src/remote-server/socket-types/_common/PromptbookServer_Progress.d.ts

@@ -0,0 +1,10 @@
+import type { TaskProgress } from '../../../types/TaskProgress';
+/**
+ * This is sent from server to client as indication of prograss arbitrarily and may be sent multiple times
+ *
+ * @private internal type of remote server
+ */
+export type PromptbookServer_Progress = TaskProgress;
+/**
+ * TODO: `PromptbookServer_Progress` is unused for now, but it will be used in the future
+ */

package/esm/typings/src/remote-server/socket-types/_subtypes/PromptbookServer_Identification.d.ts

@@ -0,0 +1,49 @@
+import type { LlmToolsConfiguration } from '../../../llm-providers/_common/register/LlmToolsConfiguration';
+import type { string_user_id } from '../../../types/typeAliases';
+import type { ApplicationRemoteServerClientOptions } from '../../types/RemoteServerOptions';
+/**
+ * Identification of client for Socket.io remote server
+ *
+ * @public exported from `@promptbook/remote-server`
+ * @public exported from `@promptbook/remote-client`
+ */
+export type PromptbookServer_Identification<TCustomOptions> = PromptbookServer_ApplicationIdentification<TCustomOptions> | PromptbookServer_AnonymousIdentification;
+/**
+ * Application mode is @@@!!!
+ *
+ * @public exported from `@promptbook/remote-server`
+ * @public exported from `@promptbook/remote-client`
+ */
+export type PromptbookServer_ApplicationIdentification<TCustomOptions> = ApplicationRemoteServerClientOptions<TCustomOptions> & {
+    /**
+     * Application mode
+     */
+    readonly isAnonymous: false;
+};
+/**
+ * Anonymous mode is @@@!!!
+ *
+ * @public exported from `@promptbook/remote-server`
+ * @public exported from `@promptbook/remote-client`
+ */
+export type PromptbookServer_AnonymousIdentification = {
+    /**
+     * Anonymous mode
+     */
+    readonly isAnonymous: true;
+    /**
+     * Identifier of the end user
+     *
+     * Note: this is passed to the certain model providers to identify misuse
+     * Note: In anonymous mode, there is no need to identify yourself, nor does it change the actual configuration of LLM Tools (unlike in application mode)
+     */
+    readonly userId?: string_user_id;
+    /**
+     * Configuration for the LLM tools
+     */
+    readonly llmToolsConfiguration: LlmToolsConfiguration;
+};
+/**
+ * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
+ * TODO: [🧠][🤺] Maybe allow overriding of `userId` for each prompt - Pass `userId` in `PromptbookServer_ListModels_Request`
+ */

package/esm/typings/src/remote-server/socket-types/listModels/PromptbookServer_ListModels_Request.d.ts

@@ -0,0 +1,17 @@
+import type { PromptbookServer_Identification } from '../_subtypes/PromptbookServer_Identification';
+/**
+ * List models available in the server
+ *
+ * This is a request from client to server
+ *
+ * @private internal type of remote server
+ */
+export type PromptbookServer_ListModels_Request<TCustomOptions> = {
+    /**
+     * Identifier of the end user or application
+     */
+    readonly identification: PromptbookServer_Identification<TCustomOptions>;
+};
+/**
+ * TODO: [🧠] Listing models inanonymous mode does not make sence - keeping only to preserve consistency
+ */

package/esm/typings/src/{llm-providers/remote/interfaces → remote-server/socket-types/listModels}/PromptbookServer_ListModels_Response.d.ts

@@ -1,8 +1,10 @@
 import type { AvailableModel } from '../../../execution/AvailableModel';
 /**
- * Socket.io error for remote text generation
+ * Models available for use in the server
  *
  * This is sent from server to client when models are listed
+ *
+ * @private internal type of remote server
  */
 export type PromptbookServer_ListModels_Response = {
     /**

package/esm/typings/src/remote-server/socket-types/prepare/PromptbookServer_PreparePipeline_Request.d.ts

@@ -0,0 +1,17 @@
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+import type { PromptbookServer_Identification } from '../_subtypes/PromptbookServer_Identification';
+/**
+ * This is a request from client to server to prepare a pipeline
+ *
+ * @private internal type of remote server
+ */
+export type PromptbookServer_PreparePipeline_Request<TCustomOptions> = {
+    /**
+     * Identifier of the end user or application
+     */
+    readonly identification: PromptbookServer_Identification<TCustomOptions>;
+    /**
+     * The Pipeline to prepare
+     */
+    readonly pipeline: PipelineJson;
+};

package/esm/typings/src/remote-server/socket-types/prepare/PromptbookServer_PreparePipeline_Response.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+/**
+ * This is sent from server to client when the pipeline is prepared
+ *
+ * @private internal type of remote server
+ */
+export type PromptbookServer_PreparePipeline_Response = {
+    /**
+     * Prepared pipeline
+     */
+    readonly preparedPipeline: PipelineJson;
+};

package/esm/typings/src/remote-server/socket-types/prompt/PromptbookServer_Prompt_Request.d.ts

@@ -0,0 +1,17 @@
+import type { Prompt } from '../../../types/Prompt';
+import type { PromptbookServer_Identification } from '../_subtypes/PromptbookServer_Identification';
+/**
+ * This is a request from client to server to execute a prompt
+ *
+ * @private internal type of remote server
+ */
+export type PromptbookServer_Prompt_Request<TCustomOptions> = {
+    /**
+     * Identifier of the end user or application
+     */
+    readonly identification: PromptbookServer_Identification<TCustomOptions>;
+    /**
+     * The Prompt to execute
+     */
+    readonly prompt: Prompt;
+};

package/esm/typings/src/{llm-providers/remote/interfaces → remote-server/socket-types/prompt}/PromptbookServer_Prompt_Response.d.ts

@@ -1,8 +1,8 @@
 import type { PromptResult } from '../../../execution/PromptResult';
 /**
- * Socket.io error for remote text generation
- *
  * This is sent from server to client when the generated text is completed
+ *
+ * @private internal type of remote server
  */
 export type PromptbookServer_Prompt_Response = {
     /**

package/esm/typings/src/{llm-providers/remote → remote-server}/startRemoteServer.d.ts

@@ -1,5 +1,5 @@
 import type { IDestroyable } from 'destroyable';
-import type { RemoteServerOptions } from './interfaces/RemoteServerOptions';
+import type { RemoteServerOptions } from './types/RemoteServerOptions';
 /**
  * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
  *
@@ -11,6 +11,7 @@ import type { RemoteServerOptions } from './interfaces/RemoteServerOptions';
  */
 export declare function startRemoteServer<TCustomOptions = undefined>(options: RemoteServerOptions<TCustomOptions>): IDestroyable;
 /**
+ * TODO: Split this file into multiple functions - handler for each request
  * TODO: Maybe use `$exportJson`
  * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
  * TODO: [⚖] Expose the collection to be able to connect to same collection via createCollectionFromUrl
@@ -19,5 +20,5 @@ export declare function startRemoteServer<TCustomOptions = undefined>(options: R
  * TODO: [🗯] Timeout on chat to free up resources
  * TODO: [🃏] Pass here some security token to prevent malitious usage and/or DDoS
  * TODO: [0] Set unavailable models as undefined in `RemoteLlmExecutionTools` NOT throw error here
- * TODO: Constrain anonymous mode for specific models / providers
+ * TODO: Allow to constrain anonymous mode for specific models / providers
  */

package/esm/typings/src/remote-server/types/RemoteClientOptions.d.ts

@@ -0,0 +1,32 @@
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { string_base_url } from '../../types/typeAliases';
+import type { string_uri } from '../../types/typeAliases';
+import type { PromptbookServer_Identification } from '../socket-types/_subtypes/PromptbookServer_Identification';
+/**
+ * Options for `RemoteLlmExecutionTools`
+ *
+ * @public exported from `@promptbook/remote-client`
+ */
+export type RemoteClientOptions<TCustomOptions> = CommonToolsOptions & {
+    /**
+     * URL of the remote server
+     * On this server will be connected to the socket.io server
+     */
+    readonly remoteUrl: string_base_url;
+    /**
+     * Path for the Socket.io server to listen
+     *
+     * @default '/socket.io'
+     * @example '/promptbook/socket.io'
+     */
+    readonly path: string_uri;
+    /**
+     * Identification of client for Socket.io remote server
+     */
+    readonly identification: PromptbookServer_Identification<TCustomOptions>;
+};
+/**
+ * TODO: Pass more options from Socket.io to `RemoteClientOptions` (like `transports`)
+ * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
+ * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
+ */

package/esm/typings/src/{llm-providers/remote/interfaces → remote-server/types}/RemoteServerOptions.d.ts

@@ -1,10 +1,10 @@
 import type { Promisable } from 'type-fest';
-import type { PipelineCollection } from '../../../collection/PipelineCollection';
-import type { CommonToolsOptions } from '../../../execution/CommonToolsOptions';
-import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
-import type { string_app_id } from '../../../types/typeAliases';
-import type { string_uri } from '../../../types/typeAliases';
-import type { string_user_id } from '../../../types/typeAliases';
+import type { PipelineCollection } from '../../collection/PipelineCollection';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { string_app_id } from '../../types/typeAliases';
+import type { string_uri } from '../../types/typeAliases';
+import type { string_user_id } from '../../types/typeAliases';
 /**
  * @@@
  *
@@ -31,14 +31,14 @@ export type RemoteServerOptions<TCustomOptions> = CommonToolsOptions & {
      * @example '/promptbook/socket.io'
      */
     readonly path: string_uri;
-} & (AnonymousRemoteServerOptions | CollectionRemoteServerOptions<TCustomOptions> | (AnonymousRemoteServerOptions & CollectionRemoteServerOptions<TCustomOptions>));
+} & (AnonymousRemoteServerOptions | ApplicationRemoteServerOptions<TCustomOptions> | (AnonymousRemoteServerOptions & ApplicationRemoteServerOptions<TCustomOptions>));
 export type AnonymousRemoteServerOptions = {
     /**
      * Enable anonymous mode
      */
     readonly isAnonymousModeAllowed: true;
 };
-export type CollectionRemoteServerOptions<TCustomOptions> = {
+export type ApplicationRemoteServerOptions<TCustomOptions> = {
     /**
      * Enable application mode
      */
@@ -52,9 +52,9 @@ export type CollectionRemoteServerOptions<TCustomOptions> = {
     /**
      * Creates llm execution tools for each client
      */
-    createLlmExecutionTools(options: CollectionRemoteServerClientOptions<TCustomOptions>): Promisable<LlmExecutionTools>;
+    createLlmExecutionTools(options: ApplicationRemoteServerClientOptions<TCustomOptions>): Promisable<LlmExecutionTools>;
 };
-export type CollectionRemoteServerClientOptions<TCustomOptions> = {
+export type ApplicationRemoteServerClientOptions<TCustomOptions> = {
     /**
      * @@@
      */

package/esm/typings/src/types/Arrayable.d.ts

@@ -5,6 +5,7 @@
  * 2) Undefined represents empty array
  * 3) Array represents itself
  *
+ * @deprecated Use `Arrayable` from `type-fest` instead
  * @private internal type
  */
 export type Arrayable<TItem> = TItem | ReadonlyArray<TItem> | undefined;

package/esm/typings/src/types/NonEmptyArray.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Represents an array that is guaranteed to have at least one element
+ */
+export type NonEmptyArray<TItem> = [TItem, ...TItem[]];
+/**
+ * Represents an array that is guaranteed to have at least one element and is readonly
+ */
+export type NonEmptyReadonlyArray<TItem> = ReadonlyArray<TItem> & NonEmptyArray<TItem>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/remote-server",
-    "version": "0.81.0",
+    "version": "0.82.0-2",
     "description": "It's time for a paradigm shift. The future of software in plain English, French or Latin",
     "--note-0": "    <- [🐊]",
     "private": false,
@@ -54,11 +54,16 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/remote-server.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.81.0"
+        "@promptbook/core": "0.82.0-2"
     },
     "dependencies": {
         "colors": "1.4.0",
+        "crypto-js": "4.2.0",
+        "papaparse": "5.4.1",
+        "prettier": "2.8.1",
         "socket.io": "4.8.1",
-        "spacetrim": "0.11.59"
+        "spacetrim": "0.11.59",
+        "userhome": "1.0.1",
+        "waitasecond": "1.11.83"
     }
 }