@promptbook/remote-server 0.105.0-23 → 0.105.0-26

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

@@ -9,6 +9,7 @@ import { isValidCsvString } from '../formats/csv/utils/isValidCsvString';
 import { isValidJsonString } from '../formats/json/utils/isValidJsonString';
 import { jsonParse } from '../formats/json/utils/jsonParse';
 import { isValidXmlString } from '../formats/xml/utils/isValidXmlString';
+import { PromptString } from '../pipeline/prompt-notation';
 import { prompt } from '../pipeline/prompt-notation';
 import { promptTemplate } from '../pipeline/prompt-notation';
 import { $detectRuntimeEnvironment } from '../utils/environment/$detectRuntimeEnvironment';
@@ -99,6 +100,7 @@ export { isValidCsvString };
 export { isValidJsonString };
 export { jsonParse };
 export { isValidXmlString };
+export { PromptString };
 export { prompt };
 export { promptTemplate };
 export { $detectRuntimeEnvironment };

package/esm/typings/src/book-components/Chat/Chat/ChatMessageItem.d.ts

@@ -43,12 +43,7 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
      * Optional metadata about teammates for team tool calls
      * Maps tool name to agent information
      */
-    teammates?: Record<string, {
-        url: string;
-        label?: string;
-        instructions?: string;
-        toolName: string;
-    }>;
+    teammates?: TeammatesMap;
     /**
      * Called when a tool call chiplet is clicked.
      */
@@ -58,6 +53,19 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
      */
     onCitationClick?: (citation: ParsedCitation) => void;
 };
+/**
+ * Metadata for a teammate agent tool.
+ */
+type TeammateMetadata = {
+    url: string;
+    label?: string;
+    instructions?: string;
+    toolName: string;
+};
+/**
+ * Lookup map of teammate metadata by tool name.
+ */
+type TeammatesMap = Record<string, TeammateMetadata>;
 /**
  * Renders a single chat message item with avatar, content, buttons, and rating.
  *

package/esm/typings/src/book-components/Chat/utils/createTeamToolNameFromUrl.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Builds a TEAM tool name from a teammate agent URL.
+ *
+ * @private utility of chat components
+ */
+export declare function createTeamToolNameFromUrl(url: string): string;
+/**
+ * Checks whether a tool name belongs to a TEAM tool.
+ *
+ * @private utility of chat components
+ */
+export declare function isTeamToolName(name: string): boolean;

package/esm/typings/src/book-components/Chat/utils/loadAgentProfile.d.ts

@@ -0,0 +1,69 @@
+import type { string_url, string_url_image } from '../../../types/typeAliases';
+/**
+ * Input data for resolving agent profiles.
+ * @private
+ */
+export type AgentProfileInput = {
+    url: string_url;
+    label?: string;
+    imageUrl?: string_url_image;
+    publicUrl?: string_url;
+};
+/**
+ * Resolved agent profile data for UI usage.
+ * @private
+ */
+export type AgentProfileData = {
+    label: string;
+    imageUrl: string_url_image | null;
+};
+/**
+ * Extracts agent name from URL.
+ * @private
+ */
+export declare function extractAgentNameFromUrl(url: string): string;
+/**
+ * Determines whether a label looks like an autogenerated identifier.
+ * @private
+ */
+export declare function isLikelyGeneratedId(label: string): boolean;
+/**
+ * Resolves the initial label for an agent without exposing generated IDs.
+ * @private
+ */
+export declare function resolveInitialAgentLabel(agent: AgentProfileInput): string;
+/**
+ * Picks the best available label from profile data without exposing IDs.
+ * @private
+ */
+export declare function resolvePreferredAgentLabel(candidates: Array<string | undefined>, fallback: string): string;
+/**
+ * Resolves the agents server base URL from the agent URL or provided public URL.
+ * @private
+ */
+export declare function resolveAgentsServerUrl(agentUrl: string, publicUrl?: string_url): string | null;
+/**
+ * Resolves the profile image URL, handling relative URLs when needed.
+ * @private
+ */
+export declare function resolveProfileImageUrl(profileImageUrl: string_url_image | undefined, agentUrl: string_url, publicUrl?: string_url): string_url_image | null;
+/**
+ * Builds a placeholder image URL for the agent when no profile image is available.
+ * @private
+ */
+export declare function resolvePlaceholderImageUrl(agent: AgentProfileInput): string_url_image | null;
+/**
+ * Returns true when a profile fetch would likely improve the label or image.
+ * @private
+ */
+export declare function shouldFetchAgentProfile(agent: AgentProfileInput): boolean;
+/**
+ * Resolves fallback profile data without fetching remote metadata.
+ * @private
+ */
+export declare function resolveAgentProfileFallback(agent: AgentProfileInput): AgentProfileData;
+/**
+ * Loads agent profile data from the agent profile endpoint when needed.
+ * @private
+ */
+export declare function loadAgentProfile(agent: AgentProfileInput): Promise<AgentProfileData>;

package/esm/typings/src/book-components/icons/EmailIcon.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Props for the EmailIcon component.
+ */
+type EmailIconProps = {
+    size?: number;
+    color?: string;
+};
+/**
+ * Renders an email/envelope icon.
+ *
+ * @param props - SVG properties augmented with an optional `size`
+ * @private internal subcomponent used by various components
+ */
+export declare function EmailIcon({ size, color }: EmailIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/commitments/USE_EMAIL/USE_EMAIL.d.ts

@@ -38,7 +38,8 @@ export declare class UseEmailCommitmentDefinition extends BaseCommitmentDefiniti
     getToolTitles(): Record<string_javascript_name, string>;
     /**
      * Gets the `send_email` tool function implementation.
-     * Note: This is a placeholder - the actual implementation is provided by the agent server.
+     *
+     * Note: [??] This function has implementation both for browser and node, this is the proxied one for browser.
      */
     getToolFunctions(): Record<string_javascript_name, ToolFunction>;
 }

package/esm/typings/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.d.ts

@@ -0,0 +1,11 @@
+import type { ToolFunction } from '../../_packages/types.index';
+/**
+ * Resolves the server-side implementation of the send_email tool for Node.js environments.
+ *
+ * This uses a lazy require so the core package can still load even if the Agents Server
+ * module is unavailable. When the server tool cannot be resolved, a fallback implementation
+ * throws a helpful error message.
+ *
+ * @private internal utility for USE EMAIL commitment
+ */
+export declare function resolveSendEmailToolForNode(): ToolFunction;

package/esm/typings/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Client-side safe wrapper for sending emails.
+ *
+ * This function proxies requests to the Agents Server API endpoint for email queuing,
+ * making it safe to use in browser environments.
+ *
+ * @param args Email payload containing recipients, subject, and body
+ * @param agentsServerUrl The base URL of the agents server (defaults to current origin)
+ * @returns Result string from the server-side send_email tool
+ *
+ * @private internal utility for USE EMAIL commitment
+ */
+export declare function sendEmailViaBrowser(args: {
+    to: string[];
+    cc?: string[];
+    subject: string;
+    body: string;
+}, agentsServerUrl?: string): Promise<string>;

package/esm/typings/src/commitments/_common/commitmentToolFunctions.d.ts

@@ -0,0 +1,26 @@
+import { ToolFunction } from '../../_packages/types.index';
+import { string_javascript_name } from '../../types/typeAliases';
+/**
+ * Map of tool functions keyed by function name.
+ *
+ * @private internal helper for commitment tool registry
+ */
+export type CommitmentToolFunctions = Record<string_javascript_name, ToolFunction>;
+/**
+ * Collects tool functions from all commitment definitions.
+ *
+ * @returns Map of tool function implementations.
+ * @private internal helper for commitment tool registry
+ */
+export declare function collectCommitmentToolFunctions(): CommitmentToolFunctions;
+/**
+ * Creates a proxy that resolves tool functions on demand.
+ *
+ * @param getFunctions - Provider of current tool functions.
+ * @returns Proxy exposing tool functions as properties.
+ * @private internal helper for commitment tool registry
+ */
+export declare function createToolFunctionsProxy(getFunctions: () => CommitmentToolFunctions): CommitmentToolFunctions;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/_common/getAllCommitmentsToolFunctionsForBrowser.d.ts

@@ -1,5 +1,4 @@
-import { ToolFunction } from '../../_packages/types.index';
-import { string_javascript_name } from '../../types/typeAliases';
+import type { CommitmentToolFunctions } from './commitmentToolFunctions';
 /**
  * Gets all function implementations provided by all commitments
  *
@@ -7,4 +6,4 @@ import { string_javascript_name } from '../../types/typeAliases';
  *
  * @public exported from `@promptbook/browser`
  */
-export declare function getAllCommitmentsToolFunctionsForBrowser(): Record<string_javascript_name, ToolFunction>;
+export declare function getAllCommitmentsToolFunctionsForBrowser(): CommitmentToolFunctions;

package/esm/typings/src/commitments/_common/getAllCommitmentsToolFunctionsForNode.d.ts

@@ -1,5 +1,4 @@
-import { ToolFunction } from '../../_packages/types.index';
-import { string_javascript_name } from '../../types/typeAliases';
+import { type CommitmentToolFunctions } from './commitmentToolFunctions';
 /**
  * Gets all function implementations provided by all commitments
  *
@@ -7,8 +6,8 @@ import { string_javascript_name } from '../../types/typeAliases';
  *
  * @public exported from `@promptbook/node`
  */
-export declare function getAllCommitmentsToolFunctionsForNode(): Record<string_javascript_name, ToolFunction>;
+export declare function getAllCommitmentsToolFunctionsForNode(): CommitmentToolFunctions;
 /**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
+ * Note: [??] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [??] Unite `xxxForServer` and `xxxForNode` naming
  */

package/esm/typings/src/constants.d.ts

@@ -116,6 +116,10 @@ export declare const LIMITS: {
  * @public exported from `@promptbook/core`
  */
 export declare const TIME_INTERVALS: {
+    /**
+         * Hundred milliseconds
+         */
+    readonly HUNDRED_MILLISECONDS: 100;
     /**
      * One second in milliseconds
      */

package/esm/typings/src/pipeline/prompt-notation.d.ts

@@ -1,4 +1,28 @@
 import type { string_prompt } from '../types/typeAliases';
+import type { really_unknown } from '../utils/organization/really_unknown';
+/**
+ * Prompt string wrapper to retain prompt context across interpolations.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare class PromptString extends String {
+    /**
+     * @param value Prompt content.
+     */
+    constructor(value: string_prompt);
+    /**
+     * Returns the prompt as a primitive string.
+     */
+    toString(): string_prompt;
+    /**
+     * Returns the prompt as a primitive string for implicit coercion.
+     */
+    valueOf(): string_prompt;
+    /**
+     * Ensures template literal coercion returns the raw string.
+     */
+    [Symbol.toPrimitive](): string_prompt;
+}
 /**
  * Tag function for notating a prompt as template literal
  *
@@ -9,10 +33,10 @@ import type { string_prompt } from '../types/typeAliases';
  *
  * @param strings
  * @param values
- * @returns the prompt string
+ * @returns prompt content wrapped as a PromptString
  * @public exported from `@promptbook/utils`
  */
-export declare function prompt(strings: TemplateStringsArray, ...values: Array<string>): string_prompt;
+export declare function prompt(strings: TemplateStringsArray, ...values: Array<really_unknown>): PromptString;
 /**
  * Tag function for notating a prompt as template literal
  *
@@ -26,6 +50,7 @@ export declare function prompt(strings: TemplateStringsArray, ...values: Array<s
  */
 export declare const promptTemplate: typeof prompt;
 /**
+ * TODO: Maybe split into multiple files
  * TODO: [🧠][🈴] Where is the best location for this file
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/pipeline/prompt-notation.test.d.ts

@@ -1,4 +1,4 @@
 export {};
 /**
- * TODO: [🧠][🈴] Where is the best location for this file
+ * TODO: [??][??] Where is the best location for this file
  */

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.105.0-22`).
+ * It follows semantic versioning (e.g., `0.105.0-25`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/remote-server",
-    "version": "0.105.0-23",
+    "version": "0.105.0-26",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -95,10 +95,11 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/remote-server.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.105.0-23"
+        "@promptbook/core": "0.105.0-26"
     },
     "dependencies": {
         "@mozilla/readability": "0.6.0",
+        "bottleneck": "2.19.5",
         "colors": "1.4.0",
         "crypto": "1.0.1",
         "crypto-js": "4.2.0",
@@ -106,6 +107,7 @@
         "express-openapi-validator": "5.4.9",
         "jsdom": "25.0.1",
         "moment": "2.30.1",
+        "openai": "4.63.0",
         "papaparse": "5.4.1",
         "react": "18.2.0",
         "rxjs": "7.8.2",