booths 0.1.2 → 1.0.0

package/README.md

@@ -10,12 +10,11 @@ The Booths framework is built around a few key concepts that work together to cr
 
 ```mermaid
 graph TD
-    subgraph User Interface
-        A[Vue.js Component]
+    subgraph Application Layer
+        A[Your Application]
     end
 
     subgraph Booth Service Layer
-        B(useLLMService)
         C(CoreBooth)
     end
 
@@ -26,8 +25,7 @@ graph TD
         G[Plugins]
     end
 
-    A -- "sends user input" --> B
-    B -- "initializes and calls" --> C
+    A -- "initializes and calls" --> C
     C -- "delegates to" --> D
     D -- "uses" --> E
     D -- "uses" --> F
@@ -38,57 +36,47 @@ graph TD
     F -- "manages" --> K{Plugins}
     G -- "hook into" --> D
 
-    style B fill:#f9f,stroke:#333,stroke-width:2px
     style C fill:#f9f,stroke:#333,stroke-width:2px
 ```
 
-1.  **User Interface**: A frontend application (e.g., a Vue component) captures user input and displays the conversation.
-2.  **Service Layer (`useLLMService.ts`)**: This layer acts as a bridge between the UI and the Booths engine. It initializes the `CoreBooth`, manages the conversational state, and exposes methods for sending messages.
-3.  **`CoreBooth`**: The central orchestrator of the system. It is configured with an `LLMAdapter`, and a set of registries for booths, tools, and plugins.
-4.  **`InteractionProcessor`**: The engine that drives the conversation. It takes user input, runs it through the plugin lifecycle, sends it to the LLM (via the adapter), and processes the response.
-5.  **`LLMAdapter`**: A component that handles communication with the specific LLM provider (e.g., OpenAI). It translates requests and responses between the Booths system and the LLM's API.
-6.  **Registries**: These are responsible for managing the different components of the system:
+1.  **Application Layer**: Your application integrates the Booths framework to handle conversational AI interactions.
+2.  **`CoreBooth`**: The framework foundation that provides global functionality, instructions, and infrastructure that applies to all booths. It manages the overall system configuration and coordinates the interaction flow.
+3.  **`InteractionProcessor`**: The engine that drives the conversation. It takes user input, runs it through the plugin lifecycle, sends it to the LLM (via the adapter), and processes the response.
+4.  **`LLMAdapter`**: A component that handles communication with the specific LLM provider (e.g., OpenAI). It translates requests and responses between the Booths system and the LLM's API.
+5.  **Registries**: These are responsible for managing the different components of the system:
     *   `BoothRegistry`: Manages `BoothConfig` objects that define the behavior of different AI agents.
     *   `ToolRegistry`: Manages the tools (functions) that booths can use.
     *   `BoothPluginRegistry`: Manages the plugins that hook into the conversational lifecycle.
-7.  **Plugins**: These are modules that add functionality to the system by hooking into the `InteractionProcessor`'s lifecycle (e.g., managing conversation history, providing context to the LLM, executing tools).
+6.  **Plugins**: These are modules that add functionality to the system by hooking into the `InteractionProcessor`'s lifecycle (e.g., managing conversation history, providing context to the LLM, executing tools).
 
-## Running the Examples
+## Getting Started
 
-The best way to understand the Booths framework is to run the example application provided in the `src/examples` directory.
+The Booths framework is designed as a TypeScript library for building conversational AI systems. This repository contains the core framework implementation.
 
-### Prerequisites
+### Installation
 
--   Node.js and npm installed.
--   An OpenAI API key.
+```bash
+npm install booths
+```
 
-### Setup
+### Prerequisites
 
-1.  **Clone the repository:**
-    ```bash
-    git clone <repository-url>
-    cd booths
-    ```
+-   Node.js and npm installed
+-   An LLM provider API key (e.g., OpenAI)
 
-2.  **Install dependencies:**
-    ```bash
-    npm install
-    ```
+### Development
 
-3.  **Set up your environment variables:**
-    Create a `.env.local` file in the root of the project and add your OpenAI API key:
-    ```
-    VITE_OPENAI_API_KEY=your-openai-api-key
-    ```
+To build the library:
 
-4.  **Run the application:**
-    ```bash
-    npm run dev
-    ```
+```bash
+npm run build
+```
 
-This will start a local development server. Open your browser to the specified address (usually `http://localhost:5173`) to see the chat application in action.
+To check types:
 
-The example application features a collection of pirate-themed booths that demonstrate how to create and manage different conversational agents. You can interact with a "Sea Lore" booth, a "Shipwright" booth, and even a "Duel" booth.
+```bash
+npm run typecheck
+```
 
 ## Quick Start Guide
 
@@ -135,18 +123,18 @@ export const tellPirateJokeTool: ToolModule = {
 The `CoreBooth` requires an `LLMAdapter` to communicate with your chosen language model. Here is a minimal example for OpenAI.
 
 ```typescript
-// in openAIAdapter.ts
+// in OpenAIAdapter.ts
 import type { LLMAdapter, ResponseCreateParamsNonStreaming, Response } from 'booths';
-import openai from 'openai';
+import OpenAI from 'openai';
 
-export class OpenAIAdapter implements LLMAdapter<any> {
-  openai: openai;
+export class OpenAIAdapter implements LLMAdapter<Response> {
+  private openai: OpenAI;
 
   constructor(apiKey: string) {
-    this.openai = new openai({ apiKey, dangerouslyAllowBrowser: true });
+    this.openai = new OpenAI({ apiKey });
   }
 
-  invoke(params: ResponseCreateParamsNonStreaming) {
+  async invoke(params: ResponseCreateParamsNonStreaming): Promise<Response> {
     return this.openai.responses.create({ ...params, model: 'gpt-4o' });
   }
 

package/dist/index.d.ts

@@ -13,6 +13,7 @@ import { ResponseFunctionWebSearch } from 'openai/resources/responses/responses'
 import { ResponseIncludable } from 'openai/resources/responses/responses';
 import { ResponseInput } from 'openai/resources/responses/responses';
 import { ResponseInputItem } from 'openai/resources/responses/responses';
+import { ResponseOutputItem } from 'openai/resources/responses/responses';
 import { ResponseOutputMessage } from 'openai/resources/responses/responses';
 import { ResponsePrompt } from 'openai/resources/responses/responses';
 import { ResponseReasoningItem } from 'openai/resources/responses/responses';
@@ -85,7 +86,7 @@ export declare interface BoothPlugin {
      * @param responseParams - The initial parameters for the response creation.
      * @returns The potentially modified response parameters.
      */
-    onBeforeInteractionLoopStart?: (prepareInitialMessagesArgs: RepositoryUtilities, responseParams: ResponseCreateParamsNonStreaming, initialInput: string) => Promise<ResponseCreateParamsNonStreaming>;
+    onBeforeInteractionLoopStart?: (prepareInitialMessagesArgs: RepositoryUtilities, responseParams: ResponseCreateParamsNonStreaming, initialInput: string | ResponseInput) => Promise<ResponseCreateParamsNonStreaming>;
     /**
      * Called before a message is sent to the AI. This allows for modification
      * of the message or its parameters.
@@ -207,7 +208,7 @@ export declare class BoothPluginRegistry {
      * @param initialInput
      * @returns Modified response parameters after all plugins have processed them
      */
-    runBeforeInteractionLoopStart(prepareArgs: RepositoryUtilities, initialParams: ResponseCreateParamsNonStreaming, initialInput: string): Promise<ResponseCreateParamsNonStreaming>;
+    runBeforeInteractionLoopStart(prepareArgs: RepositoryUtilities, initialParams: ResponseCreateParamsNonStreaming, initialInput: string | ResponseInput): Promise<ResponseCreateParamsNonStreaming>;
     /**
      * Sequentially invokes every plugin's onBeforeMessageSend hook.
      * This is called immediately before sending a message to the LLM,
@@ -372,6 +373,7 @@ export declare class BoothRegistry {
      * @returns Record of all booth configurations indexed by their IDs
      */
     getAllBooths(): Record<string, BoothConfig>;
+    toArray(): BoothConfig[];
     /**
      * Checks if the registry is operating in a multi-booth configuration.
      * @returns {boolean} `true` if there is more than one booth registered, otherwise `false`.
@@ -447,6 +449,11 @@ export declare class ContextProviderPlugin implements BoothPlugin {
  * interaction has access to the full conversation history, enabling contextual responses.
  */
 export declare class ConversationHistoryPlugin implements BoothPlugin {
+    /**
+     * The sessionHistory variable stores the conversation history between the user and the booth system.
+     * It is initialized as an empty array and will be populated with messages exchanged during the interaction.
+     */
+    private sessionHistory;
     /**
      * Unique identifier for this plugin instance.
      * @private
@@ -462,7 +469,23 @@ export declare class ConversationHistoryPlugin implements BoothPlugin {
      * @private
      */
     private readonly plugin_description;
+    /**
+     * Checks if the given response contains a booth change.
+     *
+     * A booth change is determined by examining the response's output for a specific tool call to 'route_to_booth'.
+     * The output can either include a direct function call object or a message containing a list of tool calls.
+     *
+     * @param response - The response objects to be checked. It is expected to contain an `output` property.
+     * @return A boolean indicating whether a booth change is present in the response.
+     */
     private responseContainsBoothChange;
+    /**
+     * Constructs a new instance with the provided session history.
+     *
+     * @param {ResponseInput} [sessionHistory=[]] - An optional array representing the session history. Defaults to an empty array if not provided.
+     * @return {void}
+     */
+    constructor(sessionHistory?: ResponseInput);
     /**
      * Returns the plugin's unique identifier.
      */
@@ -488,7 +511,7 @@ export declare class ConversationHistoryPlugin implements BoothPlugin {
      * Executes after receiving a response from the LLM, adding the response content
      * to the conversation history for future reference.
      *
-     * @param _
+     * @param utilities
      * @param responseParams - Current parameters for the LLM response creation
      * @param response
      * @returns Unmodified response parameters
@@ -585,10 +608,11 @@ export declare class CoreBooth<T> {
      * @param {ToolRegistry} options.tools - Registry containing tool configurations
      */
     constructor(options: {
-        boothPlugins: BoothPluginRegistry;
+        boothPlugins?: BoothPluginRegistry;
         booths: BoothRegistry;
-        tools: ToolRegistry;
+        tools?: ToolRegistry;
         llmAdapter: LLMAdapter<T>;
+        sessionHistory?: ResponseInput;
     });
 }
 
@@ -717,10 +741,10 @@ export declare class InteractionProcessor<T> {
      * @param input The input message to send.
      * @returns The processed response from the LLM.
      */
-    send(input: string): Promise<Response_2>;
+    send(input: string | ResponseInput): Promise<Response_2>;
 }
 
-export declare interface LLMAdapter<LLMResponse> {
+export declare interface LLMAdapter<LLMResponse = any> {
     invoke: (responseParams: ResponseCreateParamsNonStreaming) => Promise<LLMResponse>;
     interpret: (response: LLMResponse) => Promise<Response_2>;
 }
@@ -799,6 +823,7 @@ export declare class ToolExecutorPlugin implements BoothPlugin {
      * @private
      */
     private executeToolCall;
+    static extractFunctionCalls(output: ResponseOutputItem[]): ResponseFunctionToolCall[];
     /**
      * After a response is received from the LLM, this hook checks for tool calls. If any are found,
      * it executes them using the `toolRegistry` and appends their outputs to the response parameters'
@@ -827,7 +852,8 @@ export declare type ToolModule = FunctionTool & {
      * @param input - The input parameters for the tool, typically parsed from a JSON string.
      * @returns A promise that resolves with the result of the tool's execution.
      */
-    execute: (input: any) => Promise<any>;
+    execute?: (input?: any) => Promise<any>;
+    global?: boolean;
 };
 
 /**
@@ -916,12 +942,26 @@ export declare class ToolRegistry {
      * @returns The tool instance if found, undefined otherwise
      */
     getTool(toolName: string): ToolModule;
+    getGlobalTools(): ToolModule[];
     /**
      * Returns all registered tools as an array.
      *
      * @returns Array of all registered Tool instances
      */
-    getAllTools(): ToolModule[];
+    getServerTools(): ToolModule[];
+    /**
+     * Returns local tools. Local tools are distinguished by not having the execute method.
+     */
+    getLocalTools(): ToolModule[];
+    /**
+     * Determines if the specified tool is a local tool.
+     *
+     * A local tool is identified by the `execute` property being undefined.
+     *
+     * @param {string} toolName - The name of the tool to be checked.
+     * @return {boolean} - Returns true if the specified tool is a local tool, false otherwise.
+     */
+    isLocalTool(toolName: string): boolean;
     /**
      * Removes a tool from the registry by its ID.
      * Throws an error if the tool doesn't exist.

package/dist/index.js

@@ -1,13 +1,13 @@
-var _ = Object.defineProperty;
-var B = (i, t, o) => t in i ? _(i, t, { enumerable: !0, configurable: !0, writable: !0, value: o }) : i[t] = o;
-var s = (i, t, o) => B(i, typeof t != "symbol" ? t + "" : t, o);
-class R {
+var T = Object.defineProperty;
+var B = (i, t, o) => t in i ? T(i, t, { enumerable: !0, configurable: !0, writable: !0, value: o }) : i[t] = o;
+var n = (i, t, o) => B(i, typeof t != "symbol" ? t + "" : t, o);
+class d {
   constructor() {
     /**
      * Collection of registered plugins.
      * @private
      */
-    s(this, "plugins", []);
+    n(this, "plugins", []);
   }
   /**
    * Registers a single plugin in the registry.
@@ -70,8 +70,8 @@ class R {
    */
   async runBeforeInteractionLoopStart(t, o, e) {
     let r = o;
-    for (const n of this.plugins)
-      n.onBeforeInteractionLoopStart && (r = await n.onBeforeInteractionLoopStart(t, r, e));
+    for (const s of this.plugins)
+      s.onBeforeInteractionLoopStart && (r = await s.onBeforeInteractionLoopStart(t, r, e));
     return r;
   }
   /**
@@ -101,8 +101,8 @@ class R {
    */
   async runResponseReceived(t, o, e) {
     let r = o;
-    for (const n of this.plugins)
-      n.onResponseReceived && (r = await n.onResponseReceived(t, r, e));
+    for (const s of this.plugins)
+      s.onResponseReceived && (r = await s.onResponseReceived(t, r, e));
     return r;
   }
   /**
@@ -150,8 +150,8 @@ class R {
    */
   async runBeforeToolCall(t, o, e) {
     let r = o;
-    for (const n of this.plugins)
-      n.onBeforeToolCall && (r = await n.onBeforeToolCall(t, r, e));
+    for (const s of this.plugins)
+      s.onBeforeToolCall && (r = await s.onBeforeToolCall(t, r, e));
     return r;
   }
   /**
@@ -166,10 +166,10 @@ class R {
    * @returns Modified result after all plugins have processed it
    */
   async runAfterToolCall(t, o, e, r) {
-    let n = e;
+    let s = e;
     for (const a of this.plugins)
-      a.onAfterToolCall && (n = await a.onAfterToolCall(t, o, n, r));
-    return n;
+      a.onAfterToolCall && (s = await a.onAfterToolCall(t, o, s, r));
+    return s;
   }
   /**
    * Sequentially invokes every plugin's onToolCallError hook.
@@ -183,13 +183,13 @@ class R {
    * @returns Error result or recovery value after all plugins have processed it
    */
   async runToolCallError(t, o, e, r) {
-    let n = `Error: ${e.message}`;
+    let s = `Error: ${e.message}`;
     for (const a of this.plugins)
-      a.onToolCallError && (n = await a.onToolCallError(t, o, e, r));
-    return n;
+      a.onToolCallError && (s = await a.onToolCallError(t, o, e, r));
+    return s;
   }
 }
-class T {
+class v {
   /**
    * Creates a new booth registry with a specified base booth configuration.
    *
@@ -201,12 +201,12 @@ class T {
      * Collection of registered booth configurations, indexed by their IDs.
      * @private
      */
-    s(this, "booths", {});
+    n(this, "booths", {});
     /**
      * The current context booth ID, defaulting to the orchestrator context.
      * @private
      */
-    s(this, "currentContextId");
+    n(this, "currentContextId");
     this.baseBooth = t, this.registerBooth(t), this.currentContextId = o || t.id;
   }
   /**
@@ -297,6 +297,9 @@ class T {
   getAllBooths() {
     return this.booths;
   }
+  toArray() {
+    return Object.values(this.booths);
+  }
   /**
    * Checks if the registry is operating in a multi-booth configuration.
    * @returns {boolean} `true` if there is more than one booth registered, otherwise `false`.
@@ -325,7 +328,7 @@ class E {
    * @param llmAdapter - The adapter for interacting with the LLM.
    */
   constructor(t, o, e, r) {
-    s(this, "loopLimit", 10);
+    n(this, "loopLimit", 10);
     this.boothRegistry = t, this.boothPlugins = o, this.toolRegistry = e, this.llmAdapter = r;
   }
   /**
@@ -336,17 +339,17 @@ class E {
    * @private
    */
   createErrorResponse(t, o) {
-    const e = t instanceof Error ? t.message : "Unknown error occurred while calling LLM", r = t instanceof Error && "code" in t && typeof t.code == "string" ? t.code : "server_error", n = {
+    const e = t instanceof Error ? t.message : "Unknown error occurred while calling LLM", r = t instanceof Error && "code" in t && typeof t.code == "string" ? t.code : "server_error", s = {
       code: "server_error",
       message: e
     };
-    if (r && (n.code = r), o.model === void 0)
+    if (r && (s.code = r), o.model === void 0)
       throw new Error("Model must be specified in response parameters for error handling.");
     return {
       id: `error_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
       created_at: Math.floor(Date.now() / 1e3),
       output_text: "An error occurred while communicating with the language model.",
-      error: n,
+      error: s,
       incomplete_details: null,
       instructions: null,
       metadata: null,
@@ -397,8 +400,8 @@ class E {
    * @private
    */
   async runInteractionLoop(t) {
-    let o = 0, e = t, r, n = !0;
-    for (; n && o < this.loopLimit; )
+    let o = 0, e = t, r, s = !0;
+    for (; s && o < this.loopLimit; )
       o++, e = await this.boothPlugins.runBeforeMessageSend(
         {
           toolRegistry: this.toolRegistry,
@@ -425,7 +428,7 @@ class E {
         },
         e,
         r
-      ) && (n = !1);
+      ) && (s = !1);
     if (!r)
       throw new Error("No response received from LLM");
     return r;
@@ -437,53 +440,55 @@ class E {
    * @returns The processed response from the LLM.
    */
   async send(t) {
-    let o = {
-      input: [
-        {
-          role: "user",
-          content: t
-        }
-      ],
+    let o;
+    typeof t == "string" ? o = [
+      {
+        role: "user",
+        content: t
+      }
+    ] : o = t;
+    let e = {
+      input: o,
       tools: []
     };
-    o = await this.boothPlugins.runBeforeInteractionLoopStart(
+    e = await this.boothPlugins.runBeforeInteractionLoopStart(
       {
         toolRegistry: this.toolRegistry,
         boothRegistry: this.boothRegistry,
         pluginRegistry: this.boothPlugins,
         llmAdapter: this.llmAdapter
       },
-      o,
+      e,
       t
     );
-    let e = await this.runInteractionLoop(o);
-    return e = await this.boothPlugins.runAfterInteractionLoopEnd(
+    let r = await this.runInteractionLoop(e);
+    return r = await this.boothPlugins.runAfterInteractionLoopEnd(
       {
         toolRegistry: this.toolRegistry,
         boothRegistry: this.boothRegistry,
         pluginRegistry: this.boothPlugins,
         llmAdapter: this.llmAdapter
       },
-      e
-    ), e;
+      r
+    ), r;
   }
 }
 const C = {
   id: "summarizer",
   role: 'You are a highly skilled summarization AI. Your task is to read a conversation history and provide a concise, neutral, and objective summary. The summary should capture the key points, decisions made, and any unresolved questions. It must be written from a third-person perspective and should be clear enough for another AI assistant to understand the full context and continue the conversation seamlessly without needing the original transcript. Do not add any conversational fluff or introductory phrases like "Here is the summary:".',
   description: "A specialized booth for summarizing conversation histories."
-}, d = "route_to_booth";
+}, p = "route_to_booth";
 function w(i) {
   const t = i.getAllBooths(), o = Object.values(t).map(
     (r) => `- ${r.id}: ${r.role}
   Examples:
-${(r.examples || []).map((n) => `    - "${n}"`).join(`
+${(r.examples || []).map((s) => `    - "${s}"`).join(`
 `)}`
   ).join(`
 `), e = Object.keys(t);
   return {
     type: "function",
-    name: d,
+    name: p,
     description: `
     Routes the conversation to a specialized booth based on the user's needs. Each booth has a 
     specific role and set of capabilities.
@@ -516,36 +521,56 @@ ${o}
         return i.setCurrentContextId(r), {
           content: `Routed to booth ${r}`
         };
-      } catch (n) {
-        return console.error("[routeToBoothTool] Error routing to booth:", n), {
+      } catch (s) {
+        return console.error("[routeToBoothTool] Error routing to booth:", s), {
           content: `Error: Unable to route to booth ${r}.`
         };
       }
     }
   };
 }
-let c = [];
 class I {
-  constructor() {
+  /**
+   * Constructs a new instance with the provided session history.
+   *
+   * @param {ResponseInput} [sessionHistory=[]] - An optional array representing the session history. Defaults to an empty array if not provided.
+   * @return {void}
+   */
+  constructor(t = []) {
+    /**
+     * The sessionHistory variable stores the conversation history between the user and the booth system.
+     * It is initialized as an empty array and will be populated with messages exchanged during the interaction.
+     */
+    n(this, "sessionHistory", []);
     /**
      * Unique identifier for this plugin instance.
      * @private
      */
-    s(this, "plugin_id", "conversation-history");
+    n(this, "plugin_id", "conversation-history");
     /**
      * Display name for this plugin.
      * @private
      */
-    s(this, "plugin_name", "Conversation History Plugin");
+    n(this, "plugin_name", "Conversation History Plugin");
     /**
      * Brief description of the plugin's purpose and functionality.
      * @private
      */
-    s(this, "plugin_description", "A plugin to manage conversation history in booths.");
+    n(this, "plugin_description", "A plugin to manage conversation history in booths.");
+    this.sessionHistory = t;
   }
+  /**
+   * Checks if the given response contains a booth change.
+   *
+   * A booth change is determined by examining the response's output for a specific tool call to 'route_to_booth'.
+   * The output can either include a direct function call object or a message containing a list of tool calls.
+   *
+   * @param response - The response objects to be checked. It is expected to contain an `output` property.
+   * @return A boolean indicating whether a booth change is present in the response.
+   */
   responseContainsBoothChange(t) {
-    return t.output ? t.output.some((o) => o.type === "function_call" ? o.name === d : o.type === "message" && "tool_calls" in o && Array.isArray(o.tool_calls) ? o.tool_calls.some(
-      (e) => e.type === "function" && e.function.name === d
+    return t.output ? t.output.some((o) => o.type === "function_call" ? o.name === p : o.type === "message" && "tool_calls" in o && Array.isArray(o.tool_calls) ? o.tool_calls.some(
+      (e) => e.type === "function" && e.function.name === p
     ) : !1) : !1;
   }
   /**
@@ -576,37 +601,37 @@ class I {
    */
   async onBeforeInteractionLoopStart(t, o) {
     const { input: e } = o, r = typeof e == "string" ? [{ role: "user", content: e }] : e || [];
-    return c.push(...r), {
+    return this.sessionHistory.push(...r), {
       ...o,
-      input: c
+      input: this.sessionHistory
     };
   }
   /**
    * Executes after receiving a response from the LLM, adding the response content
    * to the conversation history for future reference.
    *
-   * @param _
+   * @param utilities
    * @param responseParams - Current parameters for the LLM response creation
    * @param response
    * @returns Unmodified response parameters
    */
   async onResponseReceived(t, o, e) {
-    let n = [...o.input, ...(e == null ? void 0 : e.output) ?? []];
+    let s = [...o.input, ...(e == null ? void 0 : e.output) ?? []];
     if (this.responseContainsBoothChange(e)) {
       const l = `Please summarize the following conversation history:
 
-${JSON.stringify(c)}`, g = (await S(t.llmAdapter, C).callProcessor.send(l)).output_text, y = n.filter((h) => "role" in h && h.role === "user").pop(), f = {
+${JSON.stringify(this.sessionHistory)}`, c = (await L(t.llmAdapter, C).callProcessor.send(l)).output_text, f = s.filter((h) => "role" in h && h.role === "user").pop(), m = {
         role: "developer",
-        content: `A conversation summary up to this point: ${g}`
-      }, m = n.filter(
+        content: `A conversation summary up to this point: ${c}`
+      }, b = s.filter(
         (h) => "type" in h && h.type === "function_call" || h.type === "function_call_output"
       );
-      c = y ? [...m, f, y] : [...m, f], n = c;
+      this.sessionHistory = f ? [...b, m, f] : [...b, m], s = this.sessionHistory;
     } else
-      c = n;
+      this.sessionHistory = s;
     return {
       ...o,
-      input: n
+      input: s
     };
   }
   /**
@@ -619,23 +644,23 @@ ${JSON.stringify(c)}`, g = (await S(t.llmAdapter, C).callProcessor.send(l)).outp
     return !1;
   }
 }
-class v {
+class A {
   constructor() {
     /**
      * Unique identifier for this plugin instance.
      * @private
      */
-    s(this, "plugin_id", "context-provider");
+    n(this, "plugin_id", "context-provider");
     /**
      * Display the name for this plugin.
      * @private
      */
-    s(this, "plugin_name", "Context Provider Plugin");
+    n(this, "plugin_name", "Context Provider Plugin");
     /**
      * Brief description of the plugin's purpose and functionality.
      * @private
      */
-    s(this, "plugin_description", "A plugin to provide context to booths.");
+    n(this, "plugin_description", "A plugin to provide context to booths.");
   }
   /**
    * Returns the plugin's unique identifier.
@@ -665,16 +690,16 @@ class v {
    */
   async onBeforeMessageSend(t, o) {
     const e = t.boothRegistry;
-    let n = e.baseBoothConfig.description;
+    let s = e.baseBoothConfig.description;
     if (e.isMultiBoothMode) {
       const a = e.orchestratorBoothConfig, l = e.currentContextBoothConfig;
-      n += `
+      s += `
 
- ${a.description}`, l.id !== a.id && (n += `
+ ${a.description}`, l.id !== a.id && (s += `
 
  ${l.description}`);
     }
-    return { ...o, instructions: n };
+    return { ...o, instructions: s };
   }
   /**
    * Determines whether the interaction loop should end.
@@ -686,12 +711,12 @@ class v {
     return !1;
   }
 }
-class A {
+class _ {
   /**
    * Initializes an empty Map to store tools.
    */
   constructor() {
-    s(this, "tools");
+    n(this, "tools");
     this.tools = /* @__PURE__ */ new Map();
   }
   registerTools(t) {
@@ -705,7 +730,9 @@ class A {
    */
   registerTool(t) {
     if (this.tools.has(t.name)) {
-      console.warn(`Tool with ID '${t.name}' is already registered. Duplicate registration ignored.`);
+      console.warn(
+        `Tool with ID '${t.name}' is already registered. Duplicate registration ignored.`
+      );
       return;
     }
     this.tools.set(t.name, t);
@@ -722,13 +749,34 @@ class A {
       throw new Error(`Tool with name ${t} is not registered.`);
     return o;
   }
+  getGlobalTools() {
+    return Array.from(this.tools.values()).filter((t) => t.global);
+  }
   /**
    * Returns all registered tools as an array.
    *
    * @returns Array of all registered Tool instances
    */
-  getAllTools() {
-    return Array.from(this.tools.values());
+  getServerTools() {
+    return Array.from(this.tools.values()).filter((t) => t.execute !== void 0);
+  }
+  /**
+   * Returns local tools. Local tools are distinguished by not having the execute method.
+   */
+  getLocalTools() {
+    return Array.from(this.tools.values()).filter((t) => t.execute === void 0);
+  }
+  /**
+   * Determines if the specified tool is a local tool.
+   *
+   * A local tool is identified by the `execute` property being undefined.
+   *
+   * @param {string} toolName - The name of the tool to be checked.
+   * @return {boolean} - Returns true if the specified tool is a local tool, false otherwise.
+   */
+  isLocalTool(t) {
+    const o = this.tools.get(t);
+    return o ? o.execute === void 0 : !1;
   }
   /**
    * Removes a tool from the registry by its ID.
@@ -743,11 +791,11 @@ class A {
     this.tools.delete(t);
   }
 }
-class P {
+class x {
   constructor() {
-    s(this, "description", "A plugin to aggregate and provide tools from base and context booths.");
-    s(this, "id", "tool-provider");
-    s(this, "name", "Tool Provider Plugin");
+    n(this, "description", "A plugin to aggregate and provide tools from base and context booths.");
+    n(this, "id", "tool-provider");
+    n(this, "name", "Tool Provider Plugin");
   }
   /**
    * Before a message is sent, this hook gathers the tool keys from both the base and context booths,
@@ -758,14 +806,14 @@ class P {
    * @returns The updated response parameters with the aggregated list of tools.
    */
   async onBeforeMessageSend(t, o) {
-    const e = t.boothRegistry.baseBoothConfig, r = t.boothRegistry.currentContextBoothConfig, n = [...e.tools || [], ...(r == null ? void 0 : r.tools) || []], l = [...new Set(n)].map(
+    const e = t.boothRegistry.baseBoothConfig, r = t.boothRegistry.currentContextBoothConfig, l = [...e.tools || [], ...(r == null ? void 0 : r.tools) || []].filter((u, g, c) => c.indexOf(u) === g).map(
       (u) => t.toolRegistry.getTool(u)
     );
     if (e.mcp && l.push(...e.mcp), r != null && r.mcp && l.push(...r.mcp), t.boothRegistry.isMultiBoothMode) {
       const u = w(t.boothRegistry);
       l.push(u);
     }
-    return {
+    return l.push(...t.toolRegistry.getGlobalTools()), {
       ...o,
       tools: l
     };
@@ -779,11 +827,11 @@ class P {
     return !1;
   }
 }
-class x {
+class y {
   constructor() {
-    s(this, "id", "tool-executor");
-    s(this, "name", "Tool Executor");
-    s(this, "description", "Checks for tool calls in the response, executes them, and adds the results to the message history.");
+    n(this, "id", "tool-executor");
+    n(this, "name", "Tool Executor");
+    n(this, "description", "Checks for tool calls in the response, executes them, and adds the results to the message history.");
   }
   /**
    * Executes a single tool call with proper hook integration.
@@ -799,14 +847,20 @@ class x {
         t,
         o,
         e
-      ), n = t.toolRegistry.getTool(r.name);
-      if (!n)
+      ), s = t.toolRegistry.getTool(r.name);
+      if (!s)
         return {
           type: "function_call_output",
           call_id: r.call_id,
           output: `Error: Tool '${r.name}' not found.`
         };
-      const a = await n.execute(JSON.parse(r.arguments)), l = await t.pluginRegistry.runAfterToolCall(
+      if (!s.execute)
+        return {
+          type: "function_call_output",
+          call_id: r.call_id,
+          output: `Error: Tool '${r.name}' does not have an 'execute' method.`
+        };
+      const a = await s.execute(JSON.parse(r.arguments)), l = await t.pluginRegistry.runAfterToolCall(
         t,
         r,
         a,
@@ -819,7 +873,7 @@ class x {
       };
     } catch (r) {
       console.error(`Error executing tool ${o.name}:`, r);
-      const n = await t.pluginRegistry.runToolCallError(
+      const s = await t.pluginRegistry.runToolCallError(
         t,
         o,
         r,
@@ -828,10 +882,15 @@ class x {
       return {
         type: "function_call_output",
         call_id: o.call_id,
-        output: typeof n == "string" ? n : JSON.stringify(n)
+        output: typeof s == "string" ? s : JSON.stringify(s)
       };
     }
   }
+  static extractFunctionCalls(t) {
+    return t.filter(
+      (o) => o.type === "function_call"
+    );
+  }
   /**
    * After a response is received from the LLM, this hook checks for tool calls. If any are found,
    * it executes them using the `toolRegistry` and appends their outputs to the response parameters'
@@ -842,20 +901,21 @@ class x {
    * @returns The updated response parameters, potentially with tool call outputs added to the input.
    */
   async onResponseReceived(t, o, e) {
-    const r = (e == null ? void 0 : e.output) ?? [], n = (r == null ? void 0 : r.filter(
-      (l) => l.type === "function_call"
-    )) ?? [];
-    if (!n.length)
+    const r = (e == null ? void 0 : e.output) ?? [], s = y.extractFunctionCalls(r);
+    if (!s.length)
       return o;
     const a = [];
-    for (let l = 0; l < n.length; l++) {
-      const u = n[l], p = {
+    for (let l = 0; l < s.length; l++) {
+      const u = s[l];
+      if (t.toolRegistry.isLocalTool(u.name))
+        continue;
+      const g = {
         responseParams: o,
         response: e,
         toolCallIndex: l,
-        totalToolCalls: n.length
-      }, g = await this.executeToolCall(t, u, p);
-      a.push(g);
+        totalToolCalls: s.length
+      }, c = await this.executeToolCall(t, u, g);
+      a.push(c);
     }
     return {
       ...o,
@@ -871,11 +931,11 @@ class x {
     return !1;
   }
 }
-class L {
+class P {
   constructor() {
-    s(this, "description", "A plugin to ensure the interaction loop can be finished.");
-    s(this, "id", "finish-turn-plugin");
-    s(this, "name", "Finish Turn Plugin");
+    n(this, "description", "A plugin to ensure the interaction loop can be finished.");
+    n(this, "id", "finish-turn-plugin");
+    n(this, "name", "Finish Turn Plugin");
   }
   /**
    * Before sending a message, this hook adds an instruction to the LLM to include a
@@ -886,14 +946,15 @@ class L {
    */
   async onBeforeMessageSend(t, o) {
     let e = o.instructions || "";
-    return e += `
+    return e = `
     
 
  
     [MUST]
-    - Add the marker "__awaiting_user_response__" to the end of your response when you expect a user response.
-    - This marker indicates that the interaction loop should end and the system should wait for user input.
-    - If the marker is not present, the system will continue to process the response as usual.
+    - Always add the marker "__awaiting_user_response__" at the end of your output when you have finished your part
+    - This marker indicates that the interaction loop should end.
+    
+    ${e}
     `, {
       ...o,
       instructions: e
@@ -910,8 +971,8 @@ class L {
   async shouldEndInteractionLoop(t, o, e) {
     if (!e.output_text)
       return !1;
-    const r = e.output_text.includes("__awaiting_user_response__"), n = e.status === "failed" || e.error !== null;
-    return r || n;
+    const r = e.output_text.includes("__awaiting_user_response__"), s = e.status === "failed" || e.error !== null;
+    return r || s;
   }
   /**
    * After the interaction loop ends, this hook removes the `__awaiting_user_response__` marker
@@ -929,7 +990,7 @@ class L {
     return o;
   }
 }
-const b = {
+const R = {
   id: "orchestrator",
   role: `
     This booth serves as the orchestration layer that analyzes user intent and routes
@@ -964,16 +1025,16 @@ const b = {
     - User: "I need help" → "What specifically would you like help with?" → then route based on response
   `
 };
-function S(i, t) {
-  const o = new T(t), e = new A(), r = new R();
-  return new M({
+function L(i, t) {
+  const o = new v(t), e = new _(), r = new d();
+  return new S({
     llmAdapter: i,
     booths: o,
     tools: e,
     boothPlugins: r
   });
 }
-class M {
+class S {
   /**
    * Initializes a new instance of the CoreBooth class.
    * Sets up the plugin registries, system plugins, and interaction processor.
@@ -994,7 +1055,7 @@ class M {
      *
      * @type {BoothPluginRegistry}
      */
-    s(this, "boothPluginRegistry");
+    n(this, "boothPluginRegistry");
     /**
      * Registry for managing booth configurations across the system.
      * This registry maintains a collection of booth definitions that can be
@@ -1002,7 +1063,7 @@ class M {
      *
      * @type {BoothRegistry}
      */
-    s(this, "boothRegistry");
+    n(this, "boothRegistry");
     /**
      * Primary processor for handling interactions between users and the booth system.
      * Responsible for sending messages to the LLM, processing responses, and managing
@@ -1010,7 +1071,7 @@ class M {
      *
      * @type {InteractionProcessor}
      */
-    s(this, "callProcessor");
+    n(this, "callProcessor");
     /**
      * Registry dedicated to system-level plugins that are always available.
      * This includes core functionality plugins like conversation history and context providers,
@@ -1018,7 +1079,7 @@ class M {
      *
      * @type {BoothPluginRegistry}
      */
-    s(this, "systemPluginsRegistry");
+    n(this, "systemPluginsRegistry");
     /**
      * A variable that represents a registry for managing and maintaining a collection of tools.
      * `toolRegistry` is an instance of the `ToolRegistry` class, which provides functionalities
@@ -1027,18 +1088,18 @@ class M {
      * The `ToolRegistry` class typically serves as a centralized storage or management
      * solution for tools that are used in a specific context or application.
      */
-    s(this, "toolRegistry");
-    if (this.boothPluginRegistry = t.boothPlugins, this.boothRegistry = t.booths, this.toolRegistry = t.tools, this.boothRegistry.isMultiBoothMode) {
-      this.boothRegistry.registerBooth(b), this.boothRegistry.setCurrentContextId(b.id);
+    n(this, "toolRegistry");
+    if (this.boothPluginRegistry = (t == null ? void 0 : t.boothPlugins) ?? new d(), this.boothRegistry = t.booths, this.toolRegistry = (t == null ? void 0 : t.tools) ?? new _(), this.boothRegistry.isMultiBoothMode) {
+      this.boothRegistry.registerBooth(R), this.boothRegistry.setCurrentContextId(R.id);
       const o = w(this.boothRegistry);
       this.toolRegistry.registerTools([o]);
     }
-    this.systemPluginsRegistry = new R(), this.systemPluginsRegistry.registerPlugins([
-      new I(),
-      new v(),
-      new P(),
+    this.systemPluginsRegistry = new d(), this.systemPluginsRegistry.registerPlugins([
+      new I(t.sessionHistory),
+      new A(),
       new x(),
-      new L()
+      new y(),
+      new P()
     ]), this.systemPluginsRegistry.registerPlugins(this.boothPluginRegistry.getPlugins()), this.callProcessor = new E(
       this.boothRegistry,
       this.systemPluginsRegistry,
@@ -1048,16 +1109,16 @@ class M {
   }
 }
 export {
-  R as BoothPluginRegistry,
-  T as BoothRegistry,
-  v as ContextProviderPlugin,
+  d as BoothPluginRegistry,
+  v as BoothRegistry,
+  A as ContextProviderPlugin,
   I as ConversationHistoryPlugin,
-  M as CoreBooth,
-  L as FinishTurnPlugin,
+  S as CoreBooth,
+  P as FinishTurnPlugin,
   E as InteractionProcessor,
-  x as ToolExecutorPlugin,
-  P as ToolProviderPlugin,
-  A as ToolRegistry,
-  S as createCoreBooth,
+  y as ToolExecutorPlugin,
+  x as ToolProviderPlugin,
+  _ as ToolRegistry,
+  L as createCoreBooth,
   w as createRouteToBoothTool
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "booths",
   "private": false,
-  "version": "0.1.2",
+  "version": "1.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -16,27 +16,25 @@
     }
   },
   "scripts": {
-    "dev": "vite",
     "build": "tsc && vite build",
-    "preview": "vite preview",
-    "format": "prettier --write \"src/**/*.{js,ts,vue,json,css,scss,md}\""
+    "format": "prettier --write \"src/**/*.{js,ts,json,css,scss,md}\"",
+    "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
     "@eslint/js": "^9.30.1",
     "@types/node": "^24.0.11",
-    "@vitejs/plugin-vue": "^5.2.4",
-    "@vue/eslint-config-prettier": "^10.2.0",
     "dotenv": "^17.2.0",
     "eslint": "^9.30.1",
     "eslint-config-prettier": "^10.1.5",
+    "nodemon": "^3.1.4",
     "openai": "^5.9.0",
     "prettier": "^3.6.2",
+    "ts-node": "^10.9.2",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.36.0",
     "vite": "^6.3.5",
     "vite-plugin-dts": "^4.5.4",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vue": "^3.5.17"
+    "vite-tsconfig-paths": "^5.1.4"
   },
   "peerDependencies": {
     "openai": "^5.8.2"
@@ -54,8 +52,5 @@
   "bugs": {
     "url": "https://github.com/phoneburner/booths/issues"
   },
-  "homepage": "https://github.com/phoneburner/booths#readme",
-  "dependencies": {
-    "user": "^0.0.0"
-  }
+  "homepage": "https://github.com/phoneburner/booths#readme"
 }